Struct MemoryApi 

pub struct MemoryApi { /* private fields */ }

Memory subsystem facade.

Provides high-level memory operations without exposing the internal MemoryManager directly. This is the 14th typed API in KernelHandle (alongside A2aApi, AgentApi, etc.).

Implementations

impl MemoryApi

pub fn new(memory_manager: Arc<MemoryManager>) -> Self

Create a new MemoryApi.

pub fn set_hnsw_index(&mut self, index: Arc<HnswMemoryIndex>)

Attach an HNSW index for fast semantic search.

pub async fn remember(&self, entry: MemoryEntry) -> Result<String>

Store a memory entry. Returns the entry’s ID.

pub async fn search( &self, query: &str, memory_type: Option<MemoryType>, limit: usize, ) -> Result<Vec<MemoryEntry>>

Search memory by text query.

pub async fn recall(&self, query: &str) -> Result<Vec<MemoryEntry>>

Recall memory by query (semantic if HNSW available, else keyword).

pub async fn get( &self, id: &str, memory_type: MemoryType, ) -> Result<Option<MemoryEntry>>

Get a specific memory entry by ID and type.

pub async fn forget(&self, id: &str, memory_type: MemoryType) -> Result<bool>

Forget (delete) a memory entry.

pub async fn list( &self, memory_type: MemoryType, limit: usize, ) -> Result<Vec<MemoryEntry>>

List memories of a given type.

pub async fn search_semantic( &self, query: &str, limit: usize, ) -> Result<Vec<SemanticHit>>

Search memory using semantic similarity (returns SemanticHits). Falls back to keyword search if no HNSW index.

pub async fn stats(&self) -> (usize, usize)

Get memory statistics: (total_entries, vector_index_size).

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

Rebuild the HNSW index from current memory state. Returns the number of vectors indexed.

pub fn manager(&self) -> &Arc<MemoryManager>

Access the underlying memory manager. For advanced operations not yet exposed via this facade.