Enum SystemError 

pub enum SystemError {
    Database(String),
    SessionNotFound(Uuid),
    WorkspaceNotFound(Uuid),
    CheckpointNotFound(Uuid),
    Serialization(String),
    Deserialization(String),
    VectorDimensionMismatch {
        expected: usize,
        actual: usize,
    },
    IndexNotBuilt,
    VectorNotFound(u32),
    ProductQuantization(String),
    EntityExtractionFailed(String),
    UpdateTimeout(u64),
    GraphUpdateFailed(String),
    EmbeddingModel(String),
    VectorizationFailed(String),
    StorageActorDown,
    OperationTimeout(u64),
    CircuitBreakerOpen(String),
    Configuration(String),
    InvalidArgument(String),
    Io(Error),
    TaskJoin(String),
    Internal(String),
}

System-wide error type for Post-Cortex

Variants

Database(String)

Database backend error (RocksDB / SurrealDB)

SessionNotFound(Uuid)

Session lookup failed

WorkspaceNotFound(Uuid)

Workspace lookup failed

CheckpointNotFound(Uuid)

Checkpoint lookup failed

Serialization(String)

Serialization encoding failure

Deserialization(String)

Deserialization decoding failure

VectorDimensionMismatch

Vector embedding dimension mismatch

Fields

expected: usize

Expected vector dimension

actual: usize

Actual vector dimension received

IndexNotBuilt

HNSW index has not been built yet

VectorNotFound(u32)

Vector lookup failed

ProductQuantization(String)

Product quantization compression/decompression error

EntityExtractionFailed(String)

Named entity extraction failure

UpdateTimeout(u64)

Context update processing exceeded its deadline

GraphUpdateFailed(String)

Entity graph mutation failure

EmbeddingModel(String)

Embedding model inference error

VectorizationFailed(String)

Text-to-vector conversion failure

StorageActorDown

Background storage actor terminated unexpectedly

OperationTimeout(u64)

General operation timeout

CircuitBreakerOpen(String)

Circuit breaker is open, rejecting requests

Configuration(String)

Invalid configuration value

InvalidArgument(String)

Caller-supplied input failed validation (referential integrity, missing required field, unknown enum variant, etc.). Transports should map this to their invalid_argument equivalent (Status::invalid_argument for gRPC, structured error for MCP).

Io(Error)

I/O error from the filesystem or network

TaskJoin(String)

Tokio task join failure

Internal(String)

Unspecified internal error for backward compatibility

Trait Implementations

impl Debug for SystemError

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

Formats the value using the given formatter.

impl Display for SystemError

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

Formats the value using the given formatter.

impl Error for SystemError

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<DecodeError> for SystemError

Converts a bincode decode error into a deserialization error

fn from(err: DecodeError) -> SystemError

Converts to this type from the input type.

impl From<EncodeError> for SystemError

Converts a bincode encode error into a serialization error

fn from(err: EncodeError) -> SystemError

Converts to this type from the input type.

impl From<Error> for SystemError

fn from(source: Error) -> SystemError

Converts to this type from the input type.

impl From<Error> for SystemError

Converts an anyhow error into an internal error for gradual migration

fn from(err: Error) -> SystemError

Converts to this type from the input type.

impl From<JoinError> for SystemError

Converts a tokio task join error into a task join error

fn from(err: JoinError) -> SystemError

Converts to this type from the input type.