Enum InvokeErrorKind 

#[non_exhaustive]
pub enum InvokeErrorKind {
    Internal,
    Timeout,
    Trap,
    OutputTooLarge,
    InvalidOutput,
    InvalidModel,
    InvalidInput,
    UnsupportedCapability,
    ExecutionFailed,
}

Stable categorisation of invoke failures.

The four guest-reported variants (InvalidModel, InvalidInput, UnsupportedCapability, ExecutionFailed) correspond 1:1 to the WIT handler-error variants. They share the same stable IPC code (handlerInternalError) for backwards compatibility with v1/v2 clients, but carry distinct fixed public messages and are distinguishable host-side for logging and diagnostics.

Marked #[non_exhaustive] so future variants (e.g. for new WIT handler-error entries or host-side failure modes) can be added without breaking downstream exhaustive match arms. This preserves the patch-level version guarantee even though the enum is part of the crate’s public API surface.

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.

Internal

Host-side input serialisation or size check failed.

Timeout

Fuel budget or epoch deadline was hit. Retryable.

Trap

Wasmtime trap (unreachable, OOB, stack overflow, …).

OutputTooLarge

Handler output exceeded MAX_IO_BYTES.

InvalidOutput

Handler output failed JSON deserialisation on the host side.

InvalidModel

Guest reported invalid-model via the WIT handler-error variant. The variant detail is stored in InvokeError::detail for host logs only.

InvalidInput

Guest reported invalid-input via the WIT handler-error variant. The variant detail is stored in InvokeError::detail for host logs only.

UnsupportedCapability

Guest reported unsupported-capability via the WIT handler-error variant. The variant detail is stored in InvokeError::detail for host logs only.

ExecutionFailed

Guest reported execution-failed via the WIT handler-error variant. The variant detail is stored in InvokeError::detail for host logs only.

Trait Implementations

impl Clone for InvokeErrorKind

fn clone(&self) -> InvokeErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InvokeErrorKind

impl Debug for InvokeErrorKind

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

Formats the value using the given formatter.

impl Eq for InvokeErrorKind

impl PartialEq for InvokeErrorKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InvokeErrorKind