Skip to main content

velesdb_core/agent/
error.rs

1//! Error types for `AgentMemory` operations.
2
3use super::snapshot::SnapshotError;
4use thiserror::Error;
5
6/// Error variants returned by agent memory operations.
7#[derive(Debug, Error)]
8pub enum AgentMemoryError {
9    /// Returned when a memory subsystem collection cannot be created or opened.
10    #[error("Failed to initialize memory: {0}")]
11    InitializationError(String),
12
13    /// Returned when an underlying collection operation fails.
14    #[error("Collection error: {0}")]
15    CollectionError(String),
16
17    /// Returned when a requested memory entry does not exist.
18    #[error("Item not found: {0}")]
19    NotFound(String),
20
21    /// Returned when a provided embedding dimension does not match the stored dimension.
22    #[error("Invalid embedding dimension: expected {expected}, got {actual}")]
23    DimensionMismatch {
24        /// Expected embedding dimension.
25        expected: usize,
26        /// Actual embedding dimension provided.
27        actual: usize,
28    },
29
30    /// Returned when a core database error propagates from the storage layer.
31    #[error("Database error: {0}")]
32    DatabaseError(#[from] crate::error::Error),
33
34    /// Returned when a snapshot operation fails.
35    #[error("Snapshot error: {0}")]
36    SnapshotError(String),
37
38    /// Returned when an IO error occurs during snapshot persistence.
39    #[error("IO error: {0}")]
40    IoError(String),
41}
42
43impl From<SnapshotError> for AgentMemoryError {
44    fn from(e: SnapshotError) -> Self {
45        Self::SnapshotError(e.to_string())
46    }
47}
48
49impl From<std::io::Error> for AgentMemoryError {
50    fn from(e: std::io::Error) -> Self {
51        Self::IoError(e.to_string())
52    }
53}