Skip to content

HarnessApprovalRequestedEvent

NexusLabs.Foundry.MicrosoftAgentFramework

NexusLabs.Foundry.MicrosoftAgentFramework.Progress

HarnessApprovalRequestedEvent Class

A tool-approval request surfaced to the caller. Emitted once per distinct request identifier when the composed agent's response contains a ToolApprovalRequestContent item (MAF's approval-required tool-call surface). The MAF content type itself is never exposed; only stable identifiers are carried.

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

Inheritance System.Object 🡒 HarnessApprovalRequestedEvent

Implements IProgressEvent, System.IEquatable<HarnessApprovalRequestedEvent>

Constructors

HarnessApprovalRequestedEvent(DateTimeOffset, string, string, string, int, long, string, string) Constructor

A tool-approval request surfaced to the caller. Emitted once per distinct request identifier when the composed agent's response contains a ToolApprovalRequestContent item (MAF's approval-required tool-call surface). The MAF content type itself is never exposed; only stable identifiers are carried.

public HarnessApprovalRequestedEvent(System.DateTimeOffset Timestamp, string WorkflowId, string? AgentId, string? ParentAgentId, int Depth, long SequenceNumber, string RequestId, string ToolName);

Parameters

Timestamp System.DateTimeOffset

When the event occurred.

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.

RequestId System.String

The stable, caller-visible request identifier the approval response must reference to be bound back to this request (MAF's InputRequestContent.RequestId).

ToolName System.String

The name of the tool the approval request is for.

Properties

HarnessApprovalRequestedEvent.AgentId Property

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

public string? AgentId { get; init; }

Implements AgentId

Property Value

System.String

HarnessApprovalRequestedEvent.Depth Property

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

public int Depth { get; init; }

Implements Depth

Property Value

System.Int32

HarnessApprovalRequestedEvent.ParentAgentId Property

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

public string? ParentAgentId { get; init; }

Implements ParentAgentId

Property Value

System.String

HarnessApprovalRequestedEvent.RequestId Property

The stable, caller-visible request identifier the approval response must reference to be bound back to this request (MAF's InputRequestContent.RequestId).

public string RequestId { get; init; }

Property Value

System.String

HarnessApprovalRequestedEvent.SequenceNumber Property

Globally ordered sequence number for event ordering.

public long SequenceNumber { get; init; }

Implements SequenceNumber

Property Value

System.Int64

HarnessApprovalRequestedEvent.Timestamp Property

When the event occurred.

public System.DateTimeOffset Timestamp { get; init; }

Implements Timestamp

Property Value

System.DateTimeOffset

HarnessApprovalRequestedEvent.ToolName Property

The name of the tool the approval request is for.

public string ToolName { get; init; }

Property Value

System.String

HarnessApprovalRequestedEvent.WorkflowId Property

Top-level workflow correlation ID.

public string WorkflowId { get; init; }

Implements WorkflowId

Property Value

System.String