Struct MemorySystem 

pub struct MemorySystem {
    pub working: WorkingMemory,
    pub short_term: ShortTermMemory,
    pub long_term: LongTermMemory,
    /* private fields */
}

The unified memory system combining all three tiers.

Fields

working: WorkingMemory

short_term: ShortTermMemory

long_term: LongTermMemory

Implementations

impl MemorySystem

pub fn new(window_size: usize) -> Self

pub fn with_search( window_size: usize, search_config: SearchConfig, ) -> Result<Self, SearchError>

Create a memory system with hybrid search enabled.

pub fn with_flusher(self, config: FlushConfig) -> Self

Attach an automatic flusher to this memory system (builder pattern).

pub fn context_messages(&self) -> Vec<Message>

Get all messages for the LLM context.

pub fn add_message(&mut self, message: Message)

Add a message to the conversation.

pub fn add_fact(&mut self, fact: Fact)

Add a fact to long-term memory, also indexing it in the search engine.

pub fn search_facts_hybrid(&self, query: &str) -> Vec<&Fact>

Search facts using the hybrid engine (falls back to keyword search).

pub fn check_auto_flush(&mut self) -> Result<bool, MemoryError>

Check if auto-flush should happen, and flush if needed.

Uses the Option::take() pattern to avoid borrow conflicts.

pub fn force_flush(&mut self) -> Result<(), MemoryError>

Force a flush regardless of triggers.

pub fn flusher_is_dirty(&self) -> bool

Whether the flusher has unflushed data.

pub fn start_new_task(&mut self, goal: impl Into<String>)

Reset working memory for a new task.

pub fn clear_session(&mut self)

Clear everything except long-term memory.

pub fn context_breakdown(&self, context_window: usize) -> ContextBreakdown

Get a breakdown of context usage for the UI.

pub fn pin_message(&mut self, position: usize) -> bool

Pin a message in short-term memory by position.

pub fn unpin_message(&mut self, position: usize) -> bool

Unpin a message in short-term memory by position.

impl MemorySystem

pub fn save_session(&self, path: &Path) -> Result<(), MemoryError>

Save the current memory state to a JSON file.

pub fn load_session(path: &Path) -> Result<Self, MemoryError>

Load a session from a JSON file.