Struct AutoMemory 

pub struct AutoMemory {
    pub entries: Vec<MemoryEntry>,
    pub config: MemoryConfig,
    pub max_entries: usize,
    pub min_importance: f64,
    pub enabled: bool,
    /* private fields */
}

Manager for automatic memory accumulation.

Fields

entries: Vec<MemoryEntry>

All memory entries.

config: MemoryConfig

Configuration for memory management.

max_entries: usize

Legacy fields for backward compatibility (deprecated).

min_importance: f64

enabled: bool

Implementations

impl AutoMemory

pub fn new() -> Self

Create a new auto memory manager.

pub fn rebuild_index(&mut self)

Rebuild search index.

pub fn with_config(config: MemoryConfig) -> Self

Create with custom configuration.

pub fn minimal() -> Self

Create a minimal memory manager (low-memory environments).

pub fn archival() -> Self

Create an archival memory manager (long-term storage).

pub fn add(&mut self, entry: MemoryEntry)

Add a new memory entry.

pub fn add_memory( &mut self, category: MemoryCategory, content: String, source_session: Option<String>, )

Add memory from detected content.

pub fn has_similar(&self, content: &str) -> bool

Check if similar content already exists. Uses minimum length threshold to prevent short words from matching everything.

pub fn prune(&mut self)

Remove low-importance entries when exceeding max_entries. Strategy: preserve manual entries + high importance entries, sorted by importance.

pub fn by_category(&self, category: MemoryCategory) -> Vec<&MemoryEntry>

Get entries by category.

pub fn by_category_fast( &mut self, category: MemoryCategory, ) -> Vec<&MemoryEntry>

Get entries by category using index (faster).

pub fn top_n(&self, n: usize) -> Vec<&MemoryEntry>

Get top N most important entries.

pub fn top_n_fast(&mut self, n: usize) -> Vec<&MemoryEntry>

Get top N using index (faster).

pub fn search(&self, query: &str) -> Vec<&MemoryEntry>

Search entries by content or tags.

pub fn search_with_limit( &self, query: &str, limit: Option<usize>, ) -> Vec<&MemoryEntry>

Search entries with result limit.

pub fn search_fast( &mut self, query: &str, limit: Option<usize>, ) -> Vec<&MemoryEntry>

Search using index (faster).

pub fn search_multi(&self, keywords: &[&str]) -> Vec<&MemoryEntry>

Multi-keyword search (matches any keyword).

pub fn search_multi_fast(&mut self, keywords: &[&str]) -> Vec<&MemoryEntry>

Multi-keyword search using index (faster).

pub fn add_batch(&mut self, entries: Vec<MemoryEntry>)

Batch add multiple entries efficiently. Only prunes once at the end instead of after each entry.

pub fn update_references(&mut self, messages: &[Message])

Mark entries as referenced if they appear in the conversation. Optimized: pre-computes lowercase versions to avoid repeated conversions.

pub fn generate_prompt_summary(&self, max_entries: usize) -> String

Generate summary for system prompt.

pub fn generate_contextual_summary( &self, context: &str, max_entries: usize, ) -> String

Generate context-aware summary for system prompt.

Unlike generate_prompt_summary which always returns top N by importance, this method selects memories that are relevant to the current conversation context.

Strategy:

1. Always include manual entries (user explicitly added)
2. Include entries whose content overlaps with recent conversation keywords
3. Fill remaining slots with top importance entries

pub fn generate_contextual_summary_with_keywords( &self, context_keywords: &[String], max_entries: usize, ) -> String

Generate context-aware summary with pre-extracted keywords. More efficient when keywords are already extracted (e.g., by AI).

pub async fn generate_contextual_summary_async( &self, context: &str, max_entries: usize, fast_provider: Option<&dyn Provider>, ) -> String

Generate context-aware summary with AI-enhanced keyword extraction.

This is the async version that uses AI to extract keywords when rule-based extraction produces insufficient results.

pub fn format_all(&self) -> String

Format all entries for display.

pub fn generate_statistics(&self) -> MemoryStatistics

Generate statistics summary for display.

pub fn clear(&mut self)

Clear all memories.

pub fn remove(&mut self, id: &str) -> bool

Remove a specific memory by ID.

pub fn apply_time_decay(&mut self)

Apply time decay to memory importance. Entries that haven’t been referenced recently will have their importance reduced.

impl AutoMemory

Extended AutoMemory with AI-enhanced operations.

pub async fn add_memory_with_ai_conflict( &mut self, category: MemoryCategory, content: String, source_session: Option<String>, processor: Option<&AiMemoryProcessor>, ) -> Result<()>

Add memory with AI conflict detection.

pub async fn assess_quality_with_ai( &mut self, processor: &AiMemoryProcessor, config: &AiMemoryConfig, ) -> Result<usize>

Assess and filter memories by quality using AI.

pub async fn merge_similar_with_ai( &mut self, processor: &AiMemoryProcessor, config: &AiMemoryConfig, ) -> Result<usize>

Merge similar memories using AI.

pub async fn generate_ai_summary( &self, max_entries: usize, processor: Option<&AiMemoryProcessor>, config: Option<&AiMemoryConfig>, ) -> Result<String>

Generate AI-enhanced summary for prompt.

Trait Implementations

impl Clone for AutoMemory

fn clone(&self) -> AutoMemory

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AutoMemory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AutoMemory

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AutoMemory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AutoMemory

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.