Enum KernelError 

#[non_exhaustive]
pub enum KernelError {
    LlmApi(String),
    RateLimited(u64),
    Http {
        status: u16,
        message: String,
    },
    Timeout(u64),
    Config(String),
    Store(String),
    Vault(String),
    Io(Error),
    Search(String),
    Embedding(String),
    Discovery(String),
    Serialization(Error),
}

Errors that can occur when using llm-kernel.

#[non_exhaustive]: new variants may be added in any minor release. External matches must include a _ => arm; prefer matching only the variants you act on (e.g. KernelError::RateLimited / KernelError::Http for retry).

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.

LlmApi(String)

An LLM API returned an error response.

RateLimited(u64)

The LLM API rate-limited the request.

Http

An HTTP error occurred (non-200 status with code).

Fields

status: u16

HTTP status code.

message: String

Error message from the response body.

Timeout(u64)

A request timed out.

Config(String)

A configuration error (missing field, bad format, etc.).

Store(String)

A store (SQLite) error.

Vault(String)

A secrets vault error.

Io(Error)

An I/O error.

Search(String)

A search backend error.

Embedding(String)

An embedding provider or vector-index error.

Discovery(String)

A model-discovery error.

Serialization(Error)

A serialization/deserialization error.

Available whenever any feature that pulls in serde_json is enabled — not just provider. Add new serde_json-using features to this any(...) list so a ?-conversion into KernelError keeps compiling everywhere serde_json is available.

Implementations

impl KernelError

pub fn embedding(e: impl Display) -> Self

Construct an KernelError::Embedding from any displayable error.

Convenience for mapping external errors (HTTP clients, ONNX runtimes) at ? sites: .map_err(KernelError::embedding)?.

pub fn discovery(e: impl Display) -> Self

Construct an KernelError::Discovery from any displayable error.

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.