Enum TurnOutcome 

pub enum TurnOutcome {
    NeedsMoreTurns {
        turn: usize,
        turn_usage: TokenUsage,
        total_usage: TokenUsage,
    },
    Done {
        total_turns: u32,
        input_tokens: u64,
        output_tokens: u64,
    },
    AwaitingConfirmation {
        tool_call_id: String,
        tool_name: String,
        display_name: String,
        input: Value,
        description: String,
        continuation: Box<AgentContinuation>,
    },
    Error(AgentError),
}

Outcome of running a single turn.

This is returned by run_turn to indicate what happened and what to do next.

Variants

NeedsMoreTurns

Turn completed successfully, but more turns are needed.

Tools were executed and their results are stored in the message history. Call run_turn again with AgentInput::Continue to proceed.

Fields

turn: usize

The turn number that just completed

turn_usage: TokenUsage

Token usage for this turn

total_usage: TokenUsage

Cumulative token usage so far

Done

Agent completed successfully (no more tool calls).

Fields

total_turns: u32

Total turns executed

input_tokens: u64

Total input tokens consumed

output_tokens: u64

Total output tokens consumed

AwaitingConfirmation

A tool requires user confirmation.

Present this to the user and call run_turn with AgentInput::Resume to continue.

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<AgentContinuation>

Continuation state for resuming (boxed for enum size efficiency)

Error(AgentError)

An error occurred.

Trait Implementations

impl Debug for TurnOutcome

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

Formats the value using the given formatter.