# Runtime Agent Framework

## Module
Signals

## Status
IMPLEMENTED

## Description
Full runtime agent framework with IRuntimeAgent interface, .NET EventPipe agent, CLR method resolution, agent registration, health/heartbeat, runtime method events, and facts ingestion is implemented.

## Implementation Details
- **Modules**: `src/Signals/StellaOps.Signals.RuntimeAgent/`
- **Key Classes**:
  - `RuntimeAgentBase` (`src/Signals/StellaOps.Signals.RuntimeAgent/RuntimeAgentBase.cs`) - abstract base class for runtime agents
  - `DotNetEventPipeAgent` (`src/Signals/StellaOps.Signals.RuntimeAgent/DotNetEventPipeAgent.cs`) - .NET EventPipe-based runtime agent for method-level tracing
  - `ClrMethodResolver` (`src/Signals/StellaOps.Signals.RuntimeAgent/ClrMethodResolver.cs`) - resolves CLR method tokens to fully qualified method names
  - `AgentRegistrationService` (`src/Signals/StellaOps.Signals.RuntimeAgent/AgentRegistrationService.cs`) - handles agent registration and health/heartbeat
  - `RuntimeFactsIngestService` (`src/Signals/StellaOps.Signals.RuntimeAgent/RuntimeFactsIngestService.cs`) - ingests runtime method events as reachability facts
  - `RuntimeAgentController` (`src/Signals/StellaOps.Signals/Api/RuntimeAgentController.cs`) - API controller for agent management
- **Interfaces**: `IRuntimeAgent`, `IAgentRegistrationService`, `IRuntimeFactsIngest`
- **Source**: Feature matrix scan

## E2E Test Plan
- [ ] Register a runtime agent via `AgentRegistrationService` and verify it appears in the registry
- [ ] Start `DotNetEventPipeAgent` and verify it captures method-level events from a target process
- [ ] Verify `ClrMethodResolver` resolves method tokens to fully qualified names
- [ ] Verify `RuntimeFactsIngestService` processes runtime events and produces reachability facts
- [ ] Verify agent heartbeat: confirm the agent sends periodic health signals
- [ ] Manage agents via `RuntimeAgentController` API endpoints