Struct ShortTermMemory 

pub struct ShortTermMemory { /* private fields */ }

Short-term memory - stores recent conversation history Uses a fixed-size ring buffer per user for memory efficiency Persists to disk (JSON) to allow restarts without losing context.

Implementations

impl ShortTermMemory

pub async fn new( max_messages: usize, max_users: usize, path: impl Into<PathBuf>, ) -> Self

Create with custom capacity and persistence path

pub async fn default_capacity() -> Self

Create with default capacity (100 messages per user, 1000 active users)

pub fn message_count(&self, user_id: &str, agent_id: Option<&str>) -> usize

Get current message count for a user/agent pair

pub fn prune_inactive(&self, duration: Duration)

Prune inactive users (older than duration) - Useful for manual cleanup

pub async fn pop_oldest( &self, user_id: &str, agent_id: Option<&str>, count: usize, ) -> Vec<Message>

Pop the oldest N messages for a user

Trait Implementations

impl Memory for ShortTermMemory

fn store<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, message: Message, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Store a message

fn retrieve<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, limit: usize, ) -> Pin<Box<dyn Future<Output = Vec<Message>> + Send + 'async_trait>>

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

Retrieve recent messages

fn store_knowledge<'life0, 'life1, 'life2, 'life3, 'life4, 'life5, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, title: &'life3 str, content: &'life4 str, collection: &'life5 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, 'life5: 'async_trait,

Store a specific piece of knowledge (not just a message)

fn clear<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Clear memory for a user

fn undo<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<Option<Message>>> + Send + 'async_trait>>

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

Undo last message

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

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

Search the memory for relevant content

fn store_batch<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, agent_id: Option<&'life2 str>, messages: Vec<Message>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Store multiple messages efficiently

fn update_summary<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, collection: &'life1 str, path: &'life2 str, summary: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Update summary for a piece of knowledge

fn link_scheduler(&self, _scheduler: Weak<Scheduler>)

Link a scheduler for background tasks

fn fetch_document<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, collection: &'life1 str, path: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Document>>> + Send + 'async_trait>>

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

Fetch a full document by path

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

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

Store an agent session state

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

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

Retrieve an agent session state