Skip to content

IAgentDiagnosticsAccessor

NexusLabs.Needlr.AgentFramework

NexusLabs.Needlr.AgentFramework.Diagnostics

IAgentDiagnosticsAccessor Interface

Provides access to the diagnostics captured during the most recent agent run in the current async flow. Uses the mutable-holder System.Threading.AsyncLocal<> pattern so that writes from child async flows (inside middleware) are visible to the parent scope.

public interface IAgentDiagnosticsAccessor

Remarks

Callers wrap agent execution in BeginCapture():

using (diagnosticsAccessor.BeginCapture())
{
    await agent.RunAsync(prompt);
    var diagnostics = diagnosticsAccessor.LastRunDiagnostics;
    // diagnostics contains token usage, tool calls, timing, etc.
}

Properties

IAgentDiagnosticsAccessor.CompletionCollector Property

Gets the IChatCompletionCollector wired by the diagnostics system, or null if diagnostics were not configured. Used as a fallback when LastRunDiagnostics is unavailable (e.g., when AsyncLocal state does not propagate across workflow execution boundaries).

NexusLabs.Needlr.AgentFramework.Diagnostics.IChatCompletionCollector? CompletionCollector { get; }

Property Value

IChatCompletionCollector

IAgentDiagnosticsAccessor.LastRunDiagnostics Property

Gets the diagnostics from the last completed agent run in the current scope, or null if no run has completed yet.

NexusLabs.Needlr.AgentFramework.Diagnostics.IAgentRunDiagnostics? LastRunDiagnostics { get; }

Property Value

IAgentRunDiagnostics

IAgentDiagnosticsAccessor.ToolCallCollector Property

Gets the IToolCallCollector wired by the diagnostics system, or null if diagnostics were not configured. Used as a fallback when LastRunDiagnostics is unavailable (e.g., when AsyncLocal state does not propagate across workflow execution boundaries).

NexusLabs.Needlr.AgentFramework.Diagnostics.IToolCallCollector? ToolCallCollector { get; }

Property Value

IToolCallCollector

Methods

IAgentDiagnosticsAccessor.BeginCapture() Method

Opens a capture scope. Diagnostics written by middleware during agent execution are visible via LastRunDiagnostics after the run completes. Disposing the returned handle restores the previous scope.

System.IDisposable BeginCapture();

Returns

System.IDisposable