Struct AgentMemory 

pub struct AgentMemory { /* private fields */ }

Three-tier agent memory: working, short-term (session), and long-term (persisted).

Implementations

impl AgentMemory

pub fn new(store: Arc<dyn MemoryStore>) -> Self

Create a new agent memory system with default configuration

pub fn with_config(store: Arc<dyn MemoryStore>, config: MemoryConfig) -> Self

Create a new agent memory system with custom configuration.

If config.prune_policy is Some, a background Tokio task is spawned that periodically calls store.prune() at the configured interval.

pub async fn remember(&self, item: MemoryItem) -> Result<()>

Store a memory in long-term storage and add to short-term

pub async fn remember_success( &self, prompt: &str, tools_used: &[String], result: &str, ) -> Result<()>

Remember a successful pattern

pub async fn remember_failure( &self, prompt: &str, error: &str, attempted_tools: &[String], ) -> Result<()>

Remember a failure to avoid repeating

pub async fn recall_similar( &self, prompt: &str, limit: usize, ) -> Result<Vec<MemoryItem>>

Recall similar past experiences

pub async fn recall_by_tags( &self, tags: &[String], limit: usize, ) -> Result<Vec<MemoryItem>>

Recall by tags

pub async fn get_recent(&self, limit: usize) -> Result<Vec<MemoryItem>>

Get recent memories

pub async fn add_to_working(&self, item: MemoryItem) -> Result<()>

Add to working memory (auto-trims by relevance if over capacity)

pub async fn get_working(&self) -> Vec<MemoryItem>

Get working memory

pub async fn clear_working(&self)

Clear working memory

pub async fn get_short_term(&self) -> Vec<MemoryItem>

Get short-term memory

pub async fn clear_short_term(&self)

Clear short-term memory

pub async fn stats(&self) -> Result<MemoryStats>

Get memory statistics

pub fn store(&self) -> &Arc<dyn MemoryStore>

Get access to the underlying store

pub async fn working_count(&self) -> usize

Get working memory count

pub async fn short_term_count(&self) -> usize

Get short-term memory count

Trait Implementations

impl Clone for AgentMemory

fn clone(&self) -> AgentMemory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentMemory

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

Formats the value using the given formatter.