Enum VshError 

#[non_exhaustive]
pub enum VshError {
    DataDirectory(DataDirectoryError),
    Blob(BlobStoreError),
    Commit(CommitError),
    Execution(ExecutionError),
    Vfs(VfsError),
    Store(TransactionStoreError),
    Approval(ApprovalGrantError),
    CommitPlan(CommitPlanError),
    Artifact(ArtifactError),
    ResultCompatibility(ResultCompatibilityError),
    UnsafeDataDirectory {
        workspace_root: PathBuf,
        data_directory: PathBuf,
    },
    ArtifactBinding {
        requested: TransactionId,
        decoded: TransactionId,
    },
    RecoveryConflicts(Box<RecoveryReport>),
    MissingPending {
        transaction: TransactionId,
    },
    DuplicatePending {
        transaction: TransactionId,
    },
    EphemeralCapacity {
        entries: usize,
        max_entries: usize,
        attempted_bytes: usize,
        max_bytes: usize,
    },
    PendingPoisoned,
    HookRequired(Box<RequestEvent>),
    HookHandler(HookHandlerError),
    HookStateChanged {
        transaction: TransactionId,
        prepared: TransactionState,
        actual: TransactionState,
    },
    HookConfigurationChanged {
        transaction: TransactionId,
    },
    HookEventMismatch {
        transaction: TransactionId,
    },
    UnexpectedHookDecision {
        transaction: TransactionId,
    },
    HookNotActionable {
        transaction: TransactionId,
        actual: TransactionState,
    },
    HookReasonLimit {
        observed: usize,
        maximum: usize,
    },
    HookApprovalWindow {
        transaction: TransactionId,
    },
    IncompleteHookEvidence {
        transaction: TransactionId,
    },
}

Stable native error surface shared with the Python exception mapper.

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.

DataDirectory(DataDirectoryError)

The durable data-directory capability could not be established safely.

Blob(BlobStoreError)

Immutable blob storage failed.

Commit(CommitError)

Capability-rooted commit or recovery failed.

Execution(ExecutionError)

Monty compilation, execution, or a hard execution budget failed.

Vfs(VfsError)

Virtual filesystem integrity or canonical diff generation failed.

Store(TransactionStoreError)

Atomic transaction-state operation failed.

Approval(ApprovalGrantError)

An approval grant had an invalid time window.

CommitPlan(CommitPlanError)

The internal commit artifact did not match its binding.

Artifact(ArtifactError)

Durable pending-artifact encoding or validation failed.

ResultCompatibility(ResultCompatibilityError)

The selected SDK surface cannot faithfully project the Monty result.

UnsafeDataDirectory

A caller-selected data directory overlaps the untrusted workspace.

Fields

workspace_root: PathBuf

Host workspace capability root.

data_directory: PathBuf

Rejected caller-selected durable directory.

ArtifactBinding

A content-addressed artifact decoded to another transaction identity.

Fields

requested: TransactionId

Transaction requested by the caller and state store.

decoded: TransactionId

Transaction recomputed from decoded artifact contents.

RecoveryConflicts(Box<RecoveryReport>)

Startup recovery found ownership it could not prove and left it untouched.

MissingPending

The transaction record has no durable exact artifact.

Fields

transaction: TransactionId

Requested transaction.

DuplicatePending

A duplicate exact artifact attempted to occupy the pending map.

Fields

transaction: TransactionId

Duplicate transaction.

EphemeralCapacity

Process-local preview retention reached its configured hard bound.

Fields

entries: usize

Number of previews retained before this attempt.

max_entries: usize

Maximum previews retained by one runtime.

attempted_bytes: usize

Total encoded bytes that retaining this preview would require.

max_bytes: usize

Maximum encoded bytes retained by one runtime.

PendingPoisoned

The short-lived pending-artifact mutex was poisoned by a panic.

HookRequired(Box<RequestEvent>)

Direct commit was blocked because a configured hook must decide first.

HookHandler(HookHandlerError)

The external hook handler failed after fail-closed state was applied.

HookStateChanged

Durable state changed after the event was prepared.

Fields

transaction: TransactionId

Exact transaction represented by the preparation.

prepared: TransactionState

State captured while preparing the hook event.

actual: TransactionState

State observed when resolving the hook decision.

HookConfigurationChanged

Hook configuration no longer matches the prepared transaction evidence.

Fields

transaction: TransactionId

Transaction whose bound hook configuration changed.

HookEventMismatch

The event supplied for resolution was not the exact regenerated event.

Fields

transaction: TransactionId

Transaction whose regenerated event did not match.

UnexpectedHookDecision

A handler decision was supplied when no handler was requested.

Fields

transaction: TransactionId

Transaction that did not request a hook decision.

HookNotActionable

The selected transaction state cannot accept a hook decision.

Fields

transaction: TransactionId

Transaction rejected by the hook state guard.

actual: TransactionState

Non-actionable state observed by the resolver.

HookReasonLimit

Hook feedback exceeded its configured hard UTF-8 bound.

Fields

observed: usize

Observed UTF-8 byte length.

maximum: usize

Configured maximum UTF-8 byte length.

HookApprovalWindow

Hook approval expiry overflowed or did not advance host time.

Fields

transaction: TransactionId

Transaction whose approval window was invalid.

IncompleteHookEvidence

Legacy or truncated evidence cannot be approved by an automated hook.

Fields

transaction: TransactionId

Transaction without complete hook evidence.

Trait Implementations

impl Debug for VshError

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

Formats the value using the given formatter.

impl Display for VshError

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

Formats the value using the given formatter.

impl Error for VshError

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<ApprovalGrantError> for VshError

fn from(source: ApprovalGrantError) -> Self

Converts to this type from the input type.

impl From<ArtifactError> for VshError

fn from(source: ArtifactError) -> Self

Converts to this type from the input type.

impl From<BlobStoreError> for VshError

fn from(source: BlobStoreError) -> Self

Converts to this type from the input type.

impl From<CommitError> for VshError

fn from(source: CommitError) -> Self

Converts to this type from the input type.

impl From<CommitPlanError> for VshError

fn from(source: CommitPlanError) -> Self

Converts to this type from the input type.

impl From<DataDirectoryError> for VshError

fn from(source: DataDirectoryError) -> Self

Converts to this type from the input type.

impl From<ExecutionError> for VshError

fn from(source: ExecutionError) -> Self

Converts to this type from the input type.

impl From<ResultCompatibilityError> for VshError

fn from(source: ResultCompatibilityError) -> Self

Converts to this type from the input type.

impl From<TransactionStoreError> for VshError

fn from(source: TransactionStoreError) -> Self

Converts to this type from the input type.

impl From<VfsError> for VshError

fn from(source: VfsError) -> Self

Converts to this type from the input type.