IProgressEvent

NexusLabs.Needlr.AgentFramework

NexusLabs.Needlr.AgentFramework.Progress

IProgressEvent Interface

Base interface for all progress events emitted during agent/workflow execution. Every event carries correlation context enabling hierarchical trace reconstruction.

public interface IProgressEvent

Derived
↳ AgentCompletedEvent
↳ AgentFailedEvent
↳ AgentHandoffEvent
↳ AgentInvokedEvent
↳ BudgetExceededEvent
↳ BudgetUpdatedEvent
↳ LlmCallCompletedEvent
↳ LlmCallFailedEvent
↳ LlmCallStartedEvent
↳ SuperStepCompletedProgressEvent
↳ SuperStepStartedProgressEvent
↳ ToolCallCompletedEvent
↳ ToolCallFailedEvent
↳ ToolCallStartedEvent
↳ WorkflowCompletedEvent
↳ WorkflowStartedEvent

Properties

IProgressEvent.AgentId Property

Which agent emitted this event, or null for workflow-level events.

string? AgentId { get; }

Property Value

System.String

IProgressEvent.Depth Property

Nesting depth: 0 = workflow, 1 = agent, 2 = sub-agent, etc.

int Depth { get; }

Property Value

System.Int32

IProgressEvent.ParentAgentId Property

Parent agent ID for sub-agent runs, enabling tree reconstruction.

string? ParentAgentId { get; }

Property Value

System.String

IProgressEvent.SequenceNumber Property

Globally ordered sequence number for event ordering.

long SequenceNumber { get; }

Property Value

System.Int64

IProgressEvent.Timestamp Property

When the event occurred.

System.DateTimeOffset Timestamp { get; }

Property Value

System.DateTimeOffset

IProgressEvent.WorkflowId Property

Top-level workflow correlation ID.

string WorkflowId { get; }

Property Value

System.String