Struct MemoryManager 

pub struct MemoryManager {
    pub hot_tier: Arc<dyn Memory>,
    pub cold_tier: Arc<dyn Memory>,
}

Combined memory manager for tiered storage

Fields

hot_tier: Arc<dyn Memory>

Hot Storage Layer (e.g. In-memory or fast local cache)

cold_tier: Arc<dyn Memory>

Cold Storage Layer (e.g. SQLite, Vector DB)

Implementations

impl MemoryManager

pub fn new(hot_tier: Arc<dyn Memory>, cold_tier: Arc<dyn Memory>) -> Self

Create a new MemoryManager with specific backends

pub async fn store( &self, user_id: &str, agent_id: Option<&str>, message: Message, ) -> Result<()>

Tiered Storage Store Stores in Hot Tier, then auto-archives to Cold Tier if capacity exceeded

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

Unified Retrieve Fetches from Hot + Cold seamlessly

pub async fn search_unified( &self, user_id: &str, agent_id: Option<&str>, query: &str, limit: usize, ) -> Result<Vec<Document>>

Union Search - searches both Hot and Cold tiers

pub async fn undo( &self, user_id: &str, agent_id: Option<&str>, ) -> Result<Option<Message>>

Undo last message

Trait Implementations

impl Memory for MemoryManager

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 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_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 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

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_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