Enum MemoryError 

#[non_exhaustive]
pub enum MemoryError {
    Sqlx(SqlxError),
    Db(DbError),
    Qdrant(Box<QdrantError>),
    VectorStore(VectorStoreError),
    Llm(LlmError),
    Json(Error),
    IntConversion(TryFromIntError),
    Snapshot(String),
    Io(Error),
    GraphStore(String),
    InvalidInput(String),
    LockPoisoned(String),
    Other(String),
    Timeout(String),
    SupersedeCycle(i64),
    SupersedeDepthExceeded(i64),
    Promotion(String),
    Ingest(String),
    ValidationRejected(String),
}

Top-level error type for all zeph-memory operations.

Wraps database, vector-store, LLM, and serialization errors into a single type consumed by callers in zeph-core.

Examples

use zeph_memory::MemoryError;

fn demo(e: MemoryError) -> String {
    e.to_string()
}

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.

Sqlx(SqlxError)

Db(DbError)

Qdrant(Box<QdrantError>)

VectorStore(VectorStoreError)

Llm(LlmError)

Json(Error)

IntConversion(TryFromIntError)

Snapshot(String)

Io(Error)

GraphStore(String)

InvalidInput(String)

LockPoisoned(String)

A mutex or RwLock was poisoned by a panicking thread.

This indicates a programming error (a thread panicked while holding the lock). The inner string describes which lock was poisoned.

Other(String)

Catch-all for errors that do not yet have a specific typed variant.

Deprecation

Prefer adding a typed variant over using Other. This variant exists for backward compatibility and will be removed once all callsites are migrated.

Timeout(String)

SupersedeCycle(i64)

Returned when inserting a supersede pointer would form a cycle in the chain.

SupersedeDepthExceeded(i64)

Returned when the supersede chain depth would exceed crate::graph::conflict::SUPERSEDE_DEPTH_CAP.

Promotion(String)

A promotion-scan or promote error (Feature A, #3305).

Wraps errors from clustering, skill generation, evaluator calls, or disk writes.

Ingest(String)

An error during zeph knowledge ingest (spec-067).

Covers path-validation failures, unsupported source kinds, and per-file ingest errors reported by the notes-sink pipeline.

ValidationRejected(String)

The post-extract validator rejected this extraction result.

Returned by extract_and_store when the post_extract_validator callback returns Err. The caller (ingest_documents) converts this into DocOutcome::Rejected so the document is counted separately from hard failures.

Implementations

impl MemoryError

pub fn is_foreign_key_violation(&self) -> bool

Returns true when this error is a database foreign-key constraint violation.

Used to distinguish silent-drop-worthy edge/entity write failures (e.g. a stale cross-database entity id) from ordinary transient DB errors, so callers can log the former at WARN instead of DEBUG (#5801).

Trait Implementations

impl Debug for MemoryError

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

Formats the value using the given formatter.

impl Display for MemoryError

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

Formats the value using the given formatter.

impl Error for MemoryError

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<Box<QdrantError>> for MemoryError

fn from(source: Box<QdrantError>) -> Self

Converts to this type from the input type.

impl From<DbError> for MemoryError

fn from(source: DbError) -> Self

Converts to this type from the input type.

impl From<Error> for MemoryError

fn from(source: SqlxError) -> Self

Converts to this type from the input type.

impl From<Error> for MemoryError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MemoryError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<LlmError> for MemoryError

fn from(source: LlmError) -> Self

Converts to this type from the input type.

impl From<MemoryError> for DocumentError

fn from(source: MemoryError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for MemoryError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.

impl From<VectorStoreError> for MemoryError

fn from(source: VectorStoreError) -> Self

Converts to this type from the input type.