Enum TurnOutcome 

pub enum TurnOutcome {
    Success {
        response: String,
        iterations: usize,
        tool_calls_count: usize,
        stop_reason: TurnStopReason,
    },
    Failed {
        error: String,
        iterations: usize,
        stop_reason: TurnStopReason,
    },
    MaxIterationsReached {
        response: String,
        iterations: usize,
        tool_calls_count: usize,
    },
    Sealed {
        reason: SealReason,
        response: String,
        iterations: usize,
        tool_calls_count: usize,
    },
}

Final outcome of a turn.

Variants

Success

Turn completed successfully

Fields

response: String

Final text response from the agent

iterations: usize

Number of reasoning iterations

tool_calls_count: usize

Total tool calls made

stop_reason: TurnStopReason

Structured reason the final generation stopped.

Failed

Turn failed due to an error

Fields

error: String

Error message

iterations: usize

Iterations completed before failure

stop_reason: TurnStopReason

Structured reason the turn failed.

MaxIterationsReached

Turn stopped due to max iterations limit

Fields

response: String

Final response at time of limit

iterations: usize

Number of iterations (equals max_iterations)

tool_calls_count: usize

Total tool calls made

Sealed

Turn was deliberately sealed to prevent further waste (EVE-534).

Distinct from Success (work finished) and Failed (an error ended the turn): Sealed means the engine chose to stop a turn that would otherwise keep consuming resources without progressing. Sealed turns are terminal and non-retryable — the durable task is routed to the DLQ rather than requeued, and a turn.sealed event is emitted.

Fields

reason: SealReason

Why the turn was sealed.

response: String

Final response at time of sealing (may be empty).

iterations: usize

Iterations completed before sealing.

tool_calls_count: usize

Total tool calls made before sealing.

Implementations

impl TurnOutcome

pub fn is_success(&self) -> bool

Check if the turn completed successfully

pub fn is_sealed(&self) -> bool

Check if the turn was deliberately sealed (EVE-534).

pub fn seal_reason(&self) -> Option<SealReason>

Get the seal reason, if the turn was sealed.

pub fn stop_reason(&self) -> TurnStopReason

Return the stable reason this outcome stopped.

pub fn response(&self) -> Option<&str>

Get the final response, if any

pub fn error(&self) -> Option<&str>

Get the error message, if any

pub fn iterations(&self) -> usize

Get the number of iterations

Trait Implementations

impl Clone for TurnOutcome

fn clone(&self) -> TurnOutcome

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TurnOutcome

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

Formats the value using the given formatter.