Enum RunEnd 

pub enum RunEnd {
    Success {
        result: Option<Value>,
    },
    Interrupted {
        interrupts: Vec<Interrupt>,
    },
    Failed {
        message: String,
        code: Option<String>,
    },
}

How a run ended.

Exhaustive, unlike Update and unlike every error in this workspace: a run ends in one of three ways because the protocol says so — RUN_FINISHED with a success outcome, RUN_FINISHED with an interrupt outcome, or RUN_ERROR (which the truncated-stream case is reported as). A fourth would be a wire-contract change, and docs/DESIGN.md explains why those are meant to be compile errors for consumers rather than something a _ arm swallows. This is the match a front-end most wants the compiler’s help with — it decides whether the input goes live again.

Variants

Success

The agent finished.

Meaning “the agent said the run succeeded”, not “nothing went wrong”. The two come apart: a protocol violation the verifier caught, or a state patch that would not apply, arrives as an Update::Error and the run carries on to end here — those are the client’s diagnostics, and the agent is neither told nor asked. A view that routes on Update::Done alone will call such a run clean; track the errors as they arrive if the difference matters to you.

Fields

result: Option<Value>

The agent’s return value, if it sent one.

Interrupted

The agent paused for human input. The same interrupts arrived individually as Update::Interrupt, and are on Session::interrupts until the next run.

Fields

interrupts: Vec<Interrupt>

What the agent is waiting for.

Failed

The run failed, or the transport stopped before it could finish. The matching Update::Error came first.

Fields

message: String

What went wrong, for a human.

code: Option<String>

The machine-readable code, when the agent sent one.

Trait Implementations

impl Clone for RunEnd

fn clone(&self) -> RunEnd

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunEnd

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

Formats the value using the given formatter.

impl PartialEq for RunEnd

fn eq(&self, other: &RunEnd) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RunEnd