Class AgentToolRunState
Namespace: Cephalon.Abstractions.Agentics
Assembly: Cephalon.Abstractions.dll
Describes the latest operator-facing runtime state reported for one agent-tool run.
public sealed record AgentToolRunState : IEquatable<AgentToolRunState>Inheritance
Section titled “Inheritance”Implements
Section titled “Implements”Inherited Members
Section titled “Inherited Members”object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.ReferenceEquals(object?, object?), object.ToString()
Constructors
Section titled “Constructors”AgentToolRunState(string, string, string?, DateTimeOffset?, string?, string?, int, int, int, int, int, int, int, int, string?, string?, IReadOnlyDictionary<string, string>)
Section titled “ AgentToolRunState(string, string, string?, DateTimeOffset?, string?, string?, int, int, int, int, int, int, int, int, string?, string?, IReadOnlyDictionary<string, string>)”Describes the latest operator-facing runtime state reported for one agent-tool run.
public AgentToolRunState(string ToolId, string RunId, string? LastOutcome, DateTimeOffset? LastObservedAtUtc, string? LastActorId, string? LastCorrelationId, int LastAttempt, int StartedCount, int SucceededCount, int FailedCount, int RetryScheduledCount, int SkippedCount, int ApprovalRequiredCount, int DeniedCount, string? LastOutputSummary, string? LastError, IReadOnlyDictionary<string, string> Metadata)Parameters
Section titled “Parameters”ToolId string
The stable tool identifier.
RunId string
The stable run identifier.
LastOutcome string?
The last reported outcome identifier when one exists.
LastObservedAtUtc DateTimeOffset?
The UTC timestamp when the last observation was reported.
LastActorId string?
The actor identifier from the latest observation when one was reported.
LastCorrelationId string?
The correlation identifier from the latest observation when one was reported.
LastAttempt int
The last reported execution attempt number.
StartedCount int
The number of started observations reported so far.
SucceededCount int
The number of succeeded observations reported so far.
FailedCount int
The number of failed observations reported so far.
RetryScheduledCount int
The number of retry-scheduled observations reported so far.
SkippedCount int
The number of skipped observations reported so far.
ApprovalRequiredCount int
The number of approval-required observations reported so far.
DeniedCount int
The number of denied observations reported so far.
LastOutputSummary string?
The latest operator-facing output summary when one was reported.
LastError string?
The latest operator-facing error summary when one was reported.
Metadata IReadOnlyDictionary<string, string>
The operator-facing metadata captured by the latest report.
Properties
Section titled “Properties”ApprovalRequiredCount
Section titled “ ApprovalRequiredCount”The number of approval-required observations reported so far.
public int ApprovalRequiredCount { get; init; }Property Value
Section titled “Property Value”DeniedCount
Section titled “ DeniedCount”The number of denied observations reported so far.
public int DeniedCount { get; init; }Property Value
Section titled “Property Value”DuplicateCompleted
Section titled “ DuplicateCompleted”Gets a value indicating whether the latest report represents a process-local duplicate-completed suppression.
public bool DuplicateCompleted { get; }Property Value
Section titled “Property Value”FailedCount
Section titled “ FailedCount”The number of failed observations reported so far.
public int FailedCount { get; init; }Property Value
Section titled “Property Value”IsTerminal
Section titled “ IsTerminal”Gets a value indicating whether the latest report represents a terminal outcome for this run.
public bool IsTerminal { get; }Property Value
Section titled “Property Value”LastActorId
Section titled “ LastActorId”The actor identifier from the latest observation when one was reported.
public string? LastActorId { get; init; }Property Value
Section titled “Property Value”LastAttempt
Section titled “ LastAttempt”The last reported execution attempt number.
public int LastAttempt { get; init; }Property Value
Section titled “Property Value”LastCorrelationId
Section titled “ LastCorrelationId”The correlation identifier from the latest observation when one was reported.
public string? LastCorrelationId { get; init; }Property Value
Section titled “Property Value”LastError
Section titled “ LastError”The latest operator-facing error summary when one was reported.
public string? LastError { get; init; }Property Value
Section titled “Property Value”LastObservedAtUtc
Section titled “ LastObservedAtUtc”The UTC timestamp when the last observation was reported.
public DateTimeOffset? LastObservedAtUtc { get; init; }Property Value
Section titled “Property Value”LastOutcome
Section titled “ LastOutcome”The last reported outcome identifier when one exists.
public string? LastOutcome { get; init; }Property Value
Section titled “Property Value”LastOutputSummary
Section titled “ LastOutputSummary”The latest operator-facing output summary when one was reported.
public string? LastOutputSummary { get; init; }Property Value
Section titled “Property Value”Metadata
Section titled “ Metadata”The operator-facing metadata captured by the latest report.
public IReadOnlyDictionary<string, string> Metadata { get; init; }Property Value
Section titled “Property Value”IReadOnlyDictionary<string, string>
RequiresApproval
Section titled “ RequiresApproval”Gets a value indicating whether the latest report says explicit approval is required before execution can continue.
public bool RequiresApproval { get; }Property Value
Section titled “Property Value”RetryPending
Section titled “ RetryPending”Gets a value indicating whether the latest report says another process-local attempt is pending.
public bool RetryPending { get; }Property Value
Section titled “Property Value”RetryScheduledCount
Section titled “ RetryScheduledCount”The number of retry-scheduled observations reported so far.
public int RetryScheduledCount { get; init; }Property Value
Section titled “Property Value”The stable run identifier.
public string RunId { get; init; }Property Value
Section titled “Property Value”SkippedCount
Section titled “ SkippedCount”The number of skipped observations reported so far.
public int SkippedCount { get; init; }Property Value
Section titled “Property Value”StartedCount
Section titled “ StartedCount”The number of started observations reported so far.
public int StartedCount { get; init; }Property Value
Section titled “Property Value”SucceededCount
Section titled “ SucceededCount”The number of succeeded observations reported so far.
public int SucceededCount { get; init; }Property Value
Section titled “Property Value”TerminalFailure
Section titled “ TerminalFailure”Gets a value indicating whether the latest report represents a terminal failed outcome for this run.
public bool TerminalFailure { get; }Property Value
Section titled “Property Value”ToolId
Section titled “ ToolId”The stable tool identifier.
public string ToolId { get; init; }Property Value
Section titled “Property Value”TotalReports
Section titled “ TotalReports”Gets the total number of observations reported for this run.
public int TotalReports { get; }