Enum KernelError 

pub enum KernelError {
    AgentNotFound {
        id: AgentId,
    },
    PermissionDenied {
        reason: String,
    },
    ProgramNotFound {
        name: String,
    },
    ProgramAlreadyExists {
        name: String,
    },
    InvalidConfig {
        detail: String,
    },
    SeedNotFound {
        id: String,
    },
    SessionNotFound {
        id: String,
    },
    StateStore(Error),
    Internal(Error),
    Memory {
        reason: String,
    },
    Timeout {
        context: String,
    },
    RateLimited {
        context: String,
    },
}

Oxios kernel error type.

Variants

AgentNotFound

Requested agent was not found.

Fields

id: AgentId

The agent identifier.

PermissionDenied

Permission denied for the requested operation.

Fields

reason: String

Why permission was denied.

ProgramNotFound

Requested program was not found.

Fields

name: String

Program name.

ProgramAlreadyExists

A program with this name is already installed.

Fields

name: String

Program name.

InvalidConfig

Invalid configuration value.

Fields

detail: String

What’s invalid.

SeedNotFound

Requested seed was not found.

Fields

id: String

Seed identifier.

SessionNotFound

Requested session was not found.

Fields

id: String

Session identifier.

StateStore(Error)

I/O error from the state store.

Internal(Error)

An internal error wrapped from anyhow.

Memory

Memory subsystem error (HNSW index, embedding, etc.).

Fields

reason: String

Detailed error reason.

Timeout

Operation timed out.

Fields

context: String

Context describing what timed out.

RateLimited

Rate limit exceeded.

Fields

context: String

Context describing what was rate limited.

Implementations

impl KernelError

pub fn http_status(&self) -> HttpStatus

Map this error to an HTTP-compatible status code.

Returns a framework-agnostic HttpStatus that consumers can convert to their web framework’s status type.

impl KernelError

pub fn category(&self) -> ErrorCategory

Classify this error into a category.

Useful for error monitoring, alerting, and retry decisions.

pub fn is_retryable(&self) -> bool

Whether this error is retryable.

Timeout and rate limit errors are retryable after backoff. Infrastructure errors may be retryable.

Trait Implementations

impl Debug for KernelError

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

Formats the value using the given formatter.

impl Display for KernelError

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

Formats the value using the given formatter.

impl Error for KernelError

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<Error> for KernelError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for KernelError

fn from(source: Error) -> Self

Converts to this type from the input type.