Enum ReplayError 

pub enum ReplayError {
    Divergence {
        position: SequenceNumber,
        recorded: Box<LoggedStep>,
        requested: Box<RequestedStep>,
    },
    NeedsReconciliation {
        position: SequenceNumber,
        tool: String,
        input: Value,
        idempotency_key: Option<String>,
    },
    MalformedLog {
        position: SequenceNumber,
        detail: String,
    },
}

Why replay could not continue.

Variants

Divergence

Orchestration produced a step that does not match the recorded event at this position. Replay assumes deterministic orchestration; this error is that assumption failing loudly instead of silently resuming a different run than the one recorded.

Fields

position: SequenceNumber

The log position where the mismatch occurred. For a request made after the recorded run already ended, this is the position the extra step would have occupied.

recorded: Box<LoggedStep>

What the log holds at that position. Boxed to keep the error type small on the happy path; it carries a full event.

requested: Box<RequestedStep>

What orchestration produced instead. Boxed for the same reason.

NeedsReconciliation

The log records a Effect::Write intent with no completion. The write may or may not have reached the provider, so the runtime refuses to guess: no retry, no re-execution, a human resolves it. The recorded intent is carried in full as the evidence that human needs.

Fields

position: SequenceNumber

The log position of the dangling write intent.

tool: String

The tool the intent named.

input: Value

The input the intent recorded.

idempotency_key: Option<String>

The idempotency key the intent recorded, if any.

MalformedLog

The log itself is not a well-formed run history (non-contiguous positions, mixed run ids, a completion that does not follow its intent, events after a terminal event). This is storage corruption or a writer bug, not orchestration divergence.

Fields

position: SequenceNumber

The log position where the malformation was noticed.

detail: String

What was wrong.

Trait Implementations

impl Clone for ReplayError

fn clone(&self) -> ReplayError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReplayError

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

Formats the value using the given formatter.

impl Display for ReplayError

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

Formats the value using the given formatter.

impl Error for ReplayError

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 PartialEq for ReplayError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReplayError