Enum CompletionOutcome 

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

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

The input was abandoned before completing, carrying typed failure metadata so every surface sees the same structured turn error the sibling AbandonedWithError carries.

Fields

reason: String

error: TurnErrorMetadata

AbandonedWithError

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

Fields

reason: String

error: TurnErrorMetadata

CompletedWithFinalizationFailure

The turn produced output, but a later runtime finalization step (the durable commit) failed, so the run is NOT durably terminal. The produced result is deliberately NOT carried on this outcome: a finalization failure must be treated as failure by every surface, never surfaced as a usable success result (that would be a false belief of success).

Fields

error: TurnErrorMetadata

RuntimeTerminated

The runtime was stopped or destroyed while the input was pending, carrying typed failure metadata describing the termination cause.

Fields

reason: String

error: TurnErrorMetadata

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.