rexis-rag 0.1.0

Rexis RAG - High-performance Retrieval-Augmented Generation framework with memory-first agents, vector search, and LLM integration
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Memory configuration for agents

use crate::storage::Memory;
use std::sync::Arc;

/// Configuration for agent memory system
#[derive(Clone)]
pub struct MemoryConfig {
    /// Storage backend (InMemoryStorage, DatabaseStorage, etc.)
    pub backend: Arc<dyn Memory>,

    /// Unique agent identifier (for agent-scoped memory)
    pub agent_id: String,

    /// Optional session identifier (for session-scoped memory)
    pub session_id: Option<String>,

    /// Whether to persist conversation history to storage
    pub persist_conversations: bool,

    /// Enable semantic memory (facts/knowledge storage)
    pub enable_semantic: bool,

    /// Enable episodic memory (summarized history)
    pub enable_episodic: bool,

    /// Enable working memory (temporary scratchpad)
    pub enable_working: bool,

    /// Maximum conversation length before pruning
    pub max_conversation_length: usize,

    /// Auto-generate session IDs if not provided
    pub auto_generate_session_id: bool,
}

impl MemoryConfig {
    /// Create a new memory configuration
    pub fn new(backend: Arc<dyn Memory>, agent_id: impl Into<String>) -> Self {
        Self {
            backend,
            agent_id: agent_id.into(),
            session_id: None,
            persist_conversations: false,
            enable_semantic: false,
            enable_episodic: false,
            enable_working: false,
            max_conversation_length: 50,
            auto_generate_session_id: true,
        }
    }

    /// Set session ID
    pub fn with_session_id(mut self, session_id: impl Into<String>) -> Self {
        self.session_id = Some(session_id.into());
        self
    }

    /// Enable conversation persistence
    pub fn with_persistence(mut self, persist: bool) -> Self {
        self.persist_conversations = persist;
        self
    }

    /// Enable semantic memory
    pub fn with_semantic_memory(mut self, enable: bool) -> Self {
        self.enable_semantic = enable;
        self
    }

    /// Enable episodic memory
    pub fn with_episodic_memory(mut self, enable: bool) -> Self {
        self.enable_episodic = enable;
        self
    }

    /// Enable working memory
    pub fn with_working_memory(mut self, enable: bool) -> Self {
        self.enable_working = enable;
        self
    }

    /// Set max conversation length
    pub fn with_max_conversation_length(mut self, length: usize) -> Self {
        self.max_conversation_length = length;
        self
    }

    /// Enable/disable auto session ID generation
    pub fn with_auto_session_id(mut self, auto: bool) -> Self {
        self.auto_generate_session_id = auto;
        self
    }
}

impl Default for MemoryConfig {
    fn default() -> Self {
        use crate::storage::InMemoryStorage;

        Self {
            backend: Arc::new(InMemoryStorage::new()),
            agent_id: "default".to_string(),
            session_id: None,
            persist_conversations: false,
            enable_semantic: false,
            enable_episodic: false,
            enable_working: false,
            max_conversation_length: 50,
            auto_generate_session_id: true,
        }
    }
}