Enum AgentRunState 

#[non_exhaustive]
pub enum AgentRunState {
    Done {
        total_turns: u32,
        total_usage: TokenUsage,
    },
    Refusal {
        total_turns: u32,
        total_usage: TokenUsage,
    },
    Error(AgentError),
    AwaitingConfirmation {
        tool_call_id: String,
        tool_name: String,
        display_name: String,
        input: Value,
        description: String,
        continuation: Box<ContinuationEnvelope>,
    },
    Cancelled {
        total_turns: u32,
        total_usage: TokenUsage,
    },
}

Outcome of running the agent loop.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Done

Agent completed successfully.

Fields

total_turns: u32

total_usage: TokenUsage

Refusal

Agent was refused by the model (safety/policy).

Fields

total_turns: u32

total_usage: TokenUsage

Error(AgentError)

Agent encountered an error.

AwaitingConfirmation

Agent is awaiting confirmation for a tool call. The application should present this to the user and call resume.

Fields

tool_call_id: String

ID of the pending tool call (from LLM)

tool_name: String

Tool name string (for LLM protocol)

display_name: String

Human-readable display name

input: Value

Tool input parameters

description: String

Description of what confirmation is needed

continuation: Box<ContinuationEnvelope>

Versioned continuation envelope for resuming.

Cancelled

Agent run was cancelled via a cancellation token.

Fields

total_turns: u32

total_usage: TokenUsage

Trait Implementations

impl Debug for AgentRunState

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.