Enum Error 

pub enum Error {
    InvalidTransition {
        from: JobState,
        to: JobState,
    },
    SchemaValidationFailed(String),
    CapabilityNotFound(String),
    ExecutionFailed(String),
    CapabilityExecutionFailed {
        msg: String,
        variant: &'static str,
        code: i32,
    },
    WalError(String),
    BackupError(String),
    SessionError(String),
    ResourceLimitExceeded(String),
    TelemetryError(String),
    CognitiveSafetyViolation(String),
}

Error types for runtimo-core.

Covers all failure modes: state transitions, schema validation, capability execution, WAL/backup errors, resource limits, and telemetry.

Variants

InvalidTransition

Invalid job state transition attempted.

Fields

from: JobState

to: JobState

SchemaValidationFailed(String)

JSON schema validation failed for capability arguments.

CapabilityNotFound(String)

Requested capability not found in registry.

ExecutionFailed(String)

Capability execution failed.

CapabilityExecutionFailed

Execution failed with a structured capability error.

This variant preserves the original CapabilityError variant information that would otherwise be lost to stringification in the blanket impl at capability.rs:431. Clients can match on this variant to programmatically distinguish PermissionDenied from NotFound, InvalidArgs, etc.

Fields

• msg: Human-readable error message (for display/logging)
• variant: Machine-readable variant name (for programmatic handling)
• code: JSON-RPC error code in range -32000 to -32099 (server-defined errors)

Example

match error {
    Error::CapabilityExecutionFailed { code, variant, msg } => {
        eprintln!("Error {}: {} - {}", code, variant, msg);
    }
    _ => {}
}

Fields

msg: String

variant: &'static str

code: i32

WalError(String)

Write-Ahead Log operation failed.

BackupError(String)

Backup/restore operation failed.

SessionError(String)

Session operation failed (create, load, save, list).

ResourceLimitExceeded(String)

System resource limit exceeded (CPU, RAM, or zombie count).

TelemetryError(String)

Telemetry capture failed.

CognitiveSafetyViolation(String)

Cognitive safety violation detected by LLMOSafe.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.