Enum RunStatus 

pub enum RunStatus {
    NotStarted,
    Running,
    AwaitingModel,
    AwaitingTool,
    Suspended {
        reason: String,
        input_schema: Value,
    },
    BudgetExceeded {
        budget: Budget,
        observed: f64,
    },
    NeedsReconciliation,
    Completed {
        output: Value,
    },
    Failed {
        error: String,
    },
    Abandoned {
        reason: Option<String>,
        unresolved_write: Option<UnresolvedWrite>,
    },
}

Where a run stands, as derived from its log alone.

Variants

NotStarted

The log is empty: nothing has been recorded yet.

Running

The run is between recorded steps and can continue.

AwaitingModel

A model call intent is recorded with no completion. The call can be re-issued.

AwaitingTool

A read or idempotent tool intent is recorded with no completion. The call can be re-executed (reads freely, idempotent calls under their recorded key).

Suspended

The run parked awaiting input. Carries what a resume needs: why it parked and the schema the input must satisfy.

Fields

reason: String

The recorded suspension reason.

input_schema: Value

The JSON Schema the resume input is validated against.

BudgetExceeded

A declared budget was crossed and the run parked. A human can raise the limit and resume.

Fields

budget: Budget

The budget that was crossed.

observed: f64

The observed value, in the units of the budget’s kind.

NeedsReconciliation

A write intent is recorded with no completion. The write may or may not have happened; only a human may decide what happens next. Never derived as retryable, by design.

Completed

The run finished with this output.

Fields

output: Value

The recorded final output.

Failed

The run failed with this error.

Fields

error: String

The recorded failure description.

Abandoned

The run was abandoned by an operator: a terminal resting state in its own right, distinct from RunStatus::Failed. Abandonment is a deliberate retirement, not a failure, so it reads as its own muted terminal everywhere downstream rather than borrowing the failure ink.

Fields

reason: Option<String>

The operator’s optional note for why the run was abandoned.

unresolved_write: Option<UnresolvedWrite>

The write intent left unsettled when a needs-reconciliation run was abandoned, when there was one. Present only for a run abandoned from RunStatus::NeedsReconciliation; the abandonment records it so the terminal state never claims the write question was answered.

Trait Implementations

impl Clone for RunStatus

fn clone(&self) -> RunStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunStatus

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

Formats the value using the given formatter.

impl PartialEq for RunStatus

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RunStatus