Enum CompletionOutcome 

pub enum CompletionOutcome {
    Completed(Box<RunResult>),
    CompletedWithoutResult,
    CallbackPending {
        tool_name: String,
        args: Value,
    },
    Cancelled,
    Abandoned(String),
    AbandonedWithError {
        reason: String,
        error: TurnErrorMetadata,
    },
    CompletedWithFinalizationFailure {
        result: Box<RunResult>,
        error: TurnErrorMetadata,
    },
    RuntimeTerminated(String),
}

Outcome delivered to a completion waiter.

Variants

Completed(Box<RunResult>)

The input was successfully consumed and produced a result.

CompletedWithoutResult

The input was consumed but produced no RunResult (e.g. context-append ops).

CallbackPending

The input reached a callback boundary and requires external tool fulfillment before the turn can continue.

Fields

tool_name: String

args: Value

Cancelled

The input reached the canonical cancellation terminal.

Abandoned(String)

The input was abandoned before completing.

AbandonedWithError

The input was abandoned before completing, with typed failure metadata.

Fields

reason: String

error: TurnErrorMetadata

CompletedWithFinalizationFailure

The turn produced a valid result, but a later runtime finalization step failed. Consumers can use the result while handling the mechanics error.

Fields

result: Box<RunResult>

error: TurnErrorMetadata

RuntimeTerminated(String)

The runtime was stopped or destroyed while the input was pending.

Implementations

impl CompletionOutcome

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

pub fn error_metadata(&self) -> Option<&TurnErrorMetadata>

Trait Implementations

impl Debug for CompletionOutcome

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

Formats the value using the given formatter.