Skip to content

HarnessArtifactOffloadDecisionEvent

NexusLabs.Foundry.MicrosoftAgentFramework

NexusLabs.Foundry.MicrosoftAgentFramework.Progress

HarnessArtifactOffloadDecisionEvent Class

One explicit tool-result offload decision made by the shared, caller-agnostic offload transform. Emitted exactly once per Transform call that produces a decision — including an Inline decision, so threshold behavior remains inspectable even when nothing is written to the workspace. Never emitted when the transform throws before reaching a decision (for example a pre-canceled token or a stale execution binding), because no decision was made in that case.

public sealed record HarnessArtifactOffloadDecisionEvent : NexusLabs.Foundry.MicrosoftAgentFramework.Progress.IProgressEvent, System.IEquatable<NexusLabs.Foundry.MicrosoftAgentFramework.Progress.HarnessArtifactOffloadDecisionEvent>

Inheritance System.Object 🡒 HarnessArtifactOffloadDecisionEvent

Implements IProgressEvent, System.IEquatable<HarnessArtifactOffloadDecisionEvent>

Constructors

HarnessArtifactOffloadDecisionEvent(DateTimeOffset, string, string, string, int, long, HarnessArtifactDiagnostics) Constructor

One explicit tool-result offload decision made by the shared, caller-agnostic offload transform. Emitted exactly once per Transform call that produces a decision — including an Inline decision, so threshold behavior remains inspectable even when nothing is written to the workspace. Never emitted when the transform throws before reaching a decision (for example a pre-canceled token or a stale execution binding), because no decision was made in that case.

public HarnessArtifactOffloadDecisionEvent(System.DateTimeOffset Timestamp, string WorkflowId, string? AgentId, string? ParentAgentId, int Depth, long SequenceNumber, NexusLabs.Foundry.MicrosoftAgentFramework.Diagnostics.HarnessArtifactDiagnostics Diagnostics);

Parameters

Timestamp System.DateTimeOffset

When the decision was made.

WorkflowId System.String

Top-level workflow correlation ID.

AgentId System.String

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

ParentAgentId System.String

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

Depth System.Int32

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

SequenceNumber System.Int64

Globally ordered sequence number for event ordering.

Diagnostics HarnessArtifactDiagnostics

The privacy-safe, structured evidence for this decision. The identical instance is also attached to the internal offload outcome this decision produced.

Properties

HarnessArtifactOffloadDecisionEvent.AgentId Property

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

public string? AgentId { get; init; }

Implements AgentId

Property Value

System.String

HarnessArtifactOffloadDecisionEvent.Depth Property

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

public int Depth { get; init; }

Implements Depth

Property Value

System.Int32

HarnessArtifactOffloadDecisionEvent.Diagnostics Property

The privacy-safe, structured evidence for this decision. The identical instance is also attached to the internal offload outcome this decision produced.

public NexusLabs.Foundry.MicrosoftAgentFramework.Diagnostics.HarnessArtifactDiagnostics Diagnostics { get; init; }

Property Value

HarnessArtifactDiagnostics

HarnessArtifactOffloadDecisionEvent.ParentAgentId Property

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

public string? ParentAgentId { get; init; }

Implements ParentAgentId

Property Value

System.String

HarnessArtifactOffloadDecisionEvent.SequenceNumber Property

Globally ordered sequence number for event ordering.

public long SequenceNumber { get; init; }

Implements SequenceNumber

Property Value

System.Int64

HarnessArtifactOffloadDecisionEvent.Timestamp Property

When the decision was made.

public System.DateTimeOffset Timestamp { get; init; }

Implements Timestamp

Property Value

System.DateTimeOffset

HarnessArtifactOffloadDecisionEvent.WorkflowId Property

Top-level workflow correlation ID.

public string WorkflowId { get; init; }

Implements WorkflowId

Property Value

System.String