Enum RuntimeStoreError 

#[non_exhaustive]
pub enum RuntimeStoreError {
    WriteFailed(String),
    ReadFailed(String),
    SessionKeyMismatch {
        expected: SessionId,
        actual: SessionId,
    },
    NotFound(String),
    Unsupported(String),
    PreparedSessionBoundaryRequiresOverride {
        profile: RuntimeSessionPersistenceProfile,
    },
    PreparedRecoveryRequiresAtomicPhysicalHeadCas {
        profile: RuntimeSessionPersistenceProfile,
    },
    HeadCanonicalActivationRequired {
        runtime_id: String,
        state: String,
    },
    SessionPersistenceAuthorityConflict {
        runtime_id: String,
        detail: String,
    },
    OpsLifecycleEpochRetired {
        runtime_id: String,
        epoch_id: RuntimeEpochId,
    },
    UnregisterFinalizationOutcomeUnknown(String),
    TranscriptRevisionConflict {
        expected: String,
        actual: String,
    },
    SessionSnapshotSuperseded {
        runtime_id: String,
    },
    InvalidInputStateBatchCas {
        reason: String,
    },
    InputIdempotencyIndexUncertain {
        runtime_id: String,
        key: String,
        evidence_input_id: String,
        reason: String,
    },
    MachineLifecycleRepairBlocked {
        evidence_digest: Option<String>,
        detail: String,
    },
    SchemaFromTheFuture {
        domain: String,
        found: i64,
        supported: i64,
    },
    MaintenanceFenceHeld {
        path: String,
    },
    InputRowVersionConflict {
        input_id: String,
    },
    RecoveryInputSetConflict {
        runtime_id: String,
    },
    MachineLifecycleVersionConflict {
        runtime_id: String,
    },
    Internal(String),
}

Errors from RuntimeStore operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

WriteFailed(String)

Write failed.

ReadFailed(String)

Read failed.

SessionKeyMismatch

The explicit session-store key does not match the serialized session.

Fields

expected: SessionId

actual: SessionId

NotFound(String)

Not found.

Unsupported(String)

Operation is not supported by this store implementation.

PreparedSessionBoundaryRequiresOverride

A non-whole-blob store declared a profile but did not implement the prepared boundary method required to commit that representation.

Fields

profile: RuntimeSessionPersistenceProfile

PreparedRecoveryRequiresAtomicPhysicalHeadCas

Recovery needs a backend that can CAS both runtime authority and the independently observed physical session head in one transaction.

Fields

profile: RuntimeSessionPersistenceProfile

HeadCanonicalActivationRequired

A head-canonical store encountered durable whole-blob state that has not completed its explicit, observable profile-activation conversion.

Ordinary boundary application must never perform this conversion implicitly: it can be O(document) and may take long enough to require deploy-facing progress reporting. Open the store through its explicit activation seam and retry only after that seam reports completion.

Fields

runtime_id: String

Logical runtime whose frozen predecessor is not activated.

state: String

Durable activation state (not_started, in_progress, or a backend-specific refusal detail).

SessionPersistenceAuthorityConflict

Persisted session authority conflicts with the configured profile, checkpoint, canonical head, frozen legacy BLOB, or mutation shape.

Fields

runtime_id: String

detail: String

OpsLifecycleEpochRetired

A detached producer attempted to persist an ops snapshot after the matching epoch was atomically retired by unregister.

Fields

runtime_id: String

epoch_id: RuntimeEpochId

UnregisterFinalizationOutcomeUnknown(String)

An unregister-finalization commit may have become durable, but the backend could not authoritatively classify its outcome.

Callers must retry the idempotent atomic finalization and must not publish a compensating lifecycle rollback for this error.

TranscriptRevisionConflict

Runtime snapshot CAS rejected a stale transcript rewrite.

Fields

expected: String

actual: String

SessionSnapshotSuperseded

An atomic boundary commit carried a session snapshot that was already superseded by the durable append-only head. Callers must observe this as a failed commit rather than mistaking a no-op for publication.

Fields

runtime_id: String

InvalidInputStateBatchCas

The requested exact input-state batch CAS has an invalid row/key shape.

Fields

reason: String

InputIdempotencyIndexUncertain

The maintained idempotency-key index cannot prove a unique answer while a source input row’s key identity is unindexable.

This is durable corruption evidence, not an authoritative miss and not a transient read failure. Callers must fail closed until the named row is repaired or quarantined through an operator-authorized workflow.

Fields

runtime_id: String

key: String

evidence_input_id: String

reason: String

MachineLifecycleRepairBlocked

A lifecycle record was observed exactly, but replacing it would risk lowering or fabricating durable runtime fencing authority.

This is a permanent reconciliation result for the observed row, not a transport retry. Callers should project RepairBlocked while retaining the evidence digest for operator repair.

Fields

evidence_digest: Option<String>

detail: String

SchemaFromTheFuture

The file’s schema ledger records a version newer than this binary supports: a newer binary migrated the file and this one must refuse it (typed, health-visible refusal — never a crash loop).

Fields

domain: String

found: i64

supported: i64

MaintenanceFenceHeld

The exclusive maintenance fence is held for this database; storage is under offline maintenance.

Fields

path: String

InputRowVersionConflict

An input-state update carried an expected prior row version that no longer matches the stored row. The whole atomic boundary fails stale; nothing is written.

Fields

input_id: String

RecoveryInputSetConflict

The complete set of nonterminal input rows changed after recovery classified it. The whole recovery boundary fails stale; nothing is written.

Fields

runtime_id: String

MachineLifecycleVersionConflict

A machine-lifecycle commit carried an expected prior row version that no longer matches the stored row. The whole atomic boundary fails stale; nothing is written.

Fields

runtime_id: String

Internal(String)

Internal error.

Trait Implementations

impl Clone for RuntimeStoreError

fn clone(&self) -> RuntimeStoreError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeStoreError

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

Formats the value using the given formatter.

impl Display for RuntimeStoreError

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

Formats the value using the given formatter.

impl Error for RuntimeStoreError

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<RuntimeStoreError> for RuntimeDeliveryError

fn from(source: RuntimeStoreError) -> Self

Converts to this type from the input type.

impl From<RuntimeStoreError> for DurableTailRecoveryError

fn from(source: RuntimeStoreError) -> Self

Converts to this type from the input type.