Struct MemoryManager 

pub struct MemoryManager { /* private fields */ }

Orchestrates all registered MemoryProviders.

The chat loop interacts exclusively with MemoryManager; individual providers are invisible to the rest of the codebase. Provider errors are caught and logged so one failure never blocks others.

Implementations

impl MemoryManager

pub fn new() -> Self

pub fn add_provider(&mut self, p: impl MemoryProvider + 'static)

Register a provider. Providers are consulted in registration order.

pub async fn initialize_all(&mut self, ctx: &SessionContext)

Initialize all providers. Called once at session start.

pub fn build_system_prompt_additions(&self) -> String

Assemble the frozen system-prompt contribution from all providers. Call once at session start and cache the result.

pub async fn prefetch_all(&self, query: &str) -> String

Collect recalled context from all providers before a turn.

pub fn build_messages( &self, system_prompt: &str, new_task: &str, ) -> Vec<MemMessage>

Build the message list for the next API call.

Uses the first provider that implements build_messages to a non-empty result. Falls back to a minimal [system, user] pair.

pub async fn sync_all( &mut self, user: &str, assistant: &str, metrics: &TurnMetrics, )

Persist a completed turn to all providers.

pub fn reset_all(&mut self)

Clear conversation-local history from every provider.

pub fn restore_turns(&mut self, turns: &[ConversationTurn])

Replace conversation-local history in every provider from durable turns.

pub fn take_compaction_record(&mut self) -> Option<String>

Drain the first pending compaction record from any provider — the TUI’s save site calls this after sync_all and persists the result as a turn record (Step 18.5, #247).

pub async fn on_pre_compress(&self, messages: &[MemMessage]) -> String

Notify all providers before old messages are dropped.

pub async fn on_session_end(&mut self, messages: &[MemMessage])

Notify all providers at session end.

pub fn usage(&self) -> Vec<(String, usize, usize)>

Report usage from all providers.

pub fn add_note(&mut self, fact: &str) -> Result<()>

Add a fact to the first provider that accepts it (first Ok wins).

No name-based special-casing: every provider is offered the note via the trait’s add_note. Providers whose default returns NotesUnsupported are skipped; the first real rejection (e.g. NoteStore’s over-budget curator error) is surfaced if no provider accepts the note.

pub fn replace_note( &mut self, old_substring: &str, new_text: &str, ) -> Result<()>

Replace the single persisted note containing old_substring — same first-note-capable-provider routing as Self::add_note.

pub fn remove_note(&mut self, substring: &str) -> Result<()>

Remove the single persisted note containing substring — same first-note-capable-provider routing as Self::add_note.

Trait Implementations

impl Default for MemoryManager

fn default() -> Self

Returns the “default value” for a type.