Struct FileMemoryStore 

pub struct FileMemoryStore { /* private fields */ }

File-based memory store.

Stores each memory item as a JSON file with an in-memory index for fast search.

memory_dir/
  index.json           # Compact index for fast search
  items/
    {id}.json          # Individual memory items

Follows the same atomic-write pattern as FileSessionStore: write to .tmp, then rename.

Implementations

impl FileMemoryStore

pub async fn new(dir: impl AsRef<Path>) -> Result<Self>

Create a new file memory store, loading the existing index if present.

pub async fn rebuild_index(&self) -> Result<usize>

Rebuild the index from item files on disk.

Useful for recovery if the index file is corrupted.

Trait Implementations

impl MemoryStore for FileMemoryStore

fn store<'life0, 'async_trait>( &'life0 self, item: MemoryItem, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Store a memory item

fn retrieve<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<MemoryItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve a memory by ID

fn search<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Search memories by query

fn search_by_tags<'life0, 'life1, 'async_trait>( &'life0 self, tags: &'life1 [String], limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Search memories by tags

fn get_recent<'life0, 'async_trait>( &'life0 self, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get recent memories

fn get_important<'life0, 'async_trait>( &'life0 self, threshold: f32, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get important memories

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a memory

fn clear<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear all memories

fn count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get total memory count