Runtime Agent Framework

Module

Signals

Status

VERIFIED

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

1.9 KiB Raw Blame History