Enum RuntimeError 

pub enum RuntimeError {
    Replay(ReplayError),
    Store(StoreError),
    Model(Error),
    RequestEncode(Error),
    RecordedResponseDecode(Error),
    RunAlreadyStarted {
        run_id: RunId,
    },
    UnknownRun {
        run_id: RunId,
    },
    NotParked {
        run_id: RunId,
        status: String,
    },
    ResumeInputRejected(String),
    InvalidLabels(String),
    NotReconcilable {
        run_id: RunId,
        status: String,
    },
    AlreadyTerminal {
        run_id: RunId,
        status: String,
    },
}

What can go wrong while driving a run.

Variants

Replay(ReplayError)

The replay layer refused to continue: divergence, a malformed log, or a dangling write intent that needs human reconciliation.

Store(StoreError)

The event store failed to persist or read an event.

Model(Error)

A live model call failed after the client’s own retries. The run’s log is intact (the intent, if any, is recorded), so the run can be recovered later; the model intent will be re-issued safely.

RequestEncode(Error)

A model request could not be serialized to JSON for hashing.

RecordedResponseDecode(Error)

A recorded model response could not be decoded back into a typed response. This means the log holds something this build cannot read, which is a storage or versioning fault, not orchestration divergence.

RunAlreadyStarted

start was called for a run id that already has recorded history.

Fields

run_id: RunId

The run that already exists.

UnknownRun

The named run has no recorded history at all.

Fields

run_id: RunId

The run that was not found.

NotParked

resume was called on a run whose log does not end at a suspension or budget crossing.

Fields

run_id: RunId

The run that was not parked.

status: String

A short description of the status the run was actually in.

ResumeInputRejected(String)

The resume input did not satisfy the recorded suspension schema (or, for a budget crossing, the budget-extension shape).

InvalidLabels(String)

The labels a run is about to be created with violate the sanity bounds (too many, or a key/value over its length cap). See crate::validate_labels. Surfaces only on a genuinely fresh begin; a replayed run never re-checks the labels it already recorded.

NotReconcilable

resolve was called on a run that is not awaiting reconciliation. The hand-recorded completion is only ever appended to a run whose log ends at a dangling write intent; every other state is a caller mistake.

Fields

run_id: RunId

The run that was not awaiting reconciliation.

status: String

A short description of the status the run was actually in.

AlreadyTerminal

abandon was called on a run that already reached a terminal event (completed, failed, or previously abandoned). A terminal run is already at rest; there is nothing left to retire, so the operator action is refused rather than appending a second terminal.

Fields

run_id: RunId

The run that had already finished.

status: String

A short description of the terminal status the run was in.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for RuntimeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ReplayError> for RuntimeError

fn from(source: ReplayError) -> Self

Converts to this type from the input type.

impl From<StoreError> for RuntimeError

fn from(source: StoreError) -> Self

Converts to this type from the input type.