ambi-memory 0.1.0

Pluggable 3D memory extension for Ambi: KV state, semantic vector recall, and rolling summary.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Error and result types for the ambi-memory subsystem.
//!
//! Defines specialised error variants for KV storage, semantic search,
//! serialisation, and summary generation backends.

use thiserror::Error;

/// All possible errors that can occur during memory operations.
#[derive(Error, Debug)]
pub enum MemoryError {
    /// An unrecoverable failure in the underlying storage backend.
    #[error("Memory Backend Error: {0}")]
    BackendError(String),

    /// A serialisation or deserialisation failure.
    #[error("Memory Serialization Error: {0}")]
    SerializationError(String),

    /// The requested key does not exist in the store.
    #[error("Memory Key Not Found: {0}")]
    KeyNotFound(String),

    /// An embedding or vector-search operation failed.
    #[error("Embedding or Semantic Search Error: {0}")]
    SemanticError(String),

    /// A summarisation LLM call or compression step failed.
    #[error("Summary Generation Error: {0}")]
    SummaryError(String),
}

/// A specialised `Result` type for memory operations.
pub type Result<T> = std::result::Result<T, MemoryError>;