alice-core 0.1.3

Core domain types and port traits for the Alice AI agent
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

//! Error types for the memory subsystem.

/// Validation failures for memory inputs.
#[derive(Debug, thiserror::Error, Clone, PartialEq)]
pub enum MemoryValidationError {
    /// Hybrid weights are outside expected range.
    #[error("invalid hybrid weights: bm25={bm25}, vector={vector}")]
    InvalidHybridWeights {
        /// Provided BM25 weight.
        bm25: f32,
        /// Provided vector weight.
        vector: f32,
    },
    /// Recall limit must be positive.
    #[error("recall limit must be greater than zero")]
    InvalidRecallLimit,
    /// Unknown importance level from storage.
    #[error("unknown memory importance level: {0}")]
    InvalidImportance(String),
}

/// Storage adapter failures.
#[derive(Debug, thiserror::Error)]
pub enum MemoryStoreError {
    /// Database operation failed.
    #[error("database error: {0}")]
    Database(String),
    /// Serialization or deserialization failed.
    #[error("serialization error: {0}")]
    Serialization(String),
    /// Input validation failed.
    #[error(transparent)]
    Validation(#[from] MemoryValidationError),
}

/// Memory service failures.
#[derive(Debug, thiserror::Error)]
pub enum MemoryServiceError {
    /// Service-level validation issue.
    #[error(transparent)]
    Validation(#[from] MemoryValidationError),
    /// Store layer failure.
    #[error(transparent)]
    Store(#[from] MemoryStoreError),
}

impl From<serde_json::Error> for MemoryStoreError {
    fn from(value: serde_json::Error) -> Self {
        Self::Serialization(value.to_string())
    }
}