Struct ShortTermMemory 

pub struct ShortTermMemory { /* private fields */ }

Bounded in-thread working memory (one FIFO queue per namespace).

Recall ranks by raw scorer similarity. Cloning is cheap when shared via Arc.

Implementations

impl ShortTermMemory

pub fn new(capacity: usize) -> Self

Creates a store with the given per-namespace capacity and the default LexicalScorer.

pub fn with_scorer(capacity: usize, scorer: Arc<dyn SemanticScorer>) -> Self

Creates a store with a custom semantic scorer.

pub fn capacity(&self) -> usize

Per-namespace entry capacity.

Trait Implementations

impl Debug for ShortTermMemory

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

Formats the value using the given formatter.

impl MemoryStore for ShortTermMemory

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

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

Writes/updates an item in the namespace. Re-putting an existing key refreshes its content and access time.

fn get<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, namespace: &'life1 str, key: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<MemoryItem>, MemoryError>> + Send + 'async_trait>>

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

Exact key lookup (None when absent). Counts as an access.

fn search<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, query: &'life1 MemoryQuery<'life2>, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryHit>, MemoryError>> + Send + 'async_trait>>

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

Semantic recall, best score first, capped at query.k.

fn forget<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, namespace: &'life1 str, key: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, MemoryError>> + Send + 'async_trait>>

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

Removes one entry; returns whether it existed.

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

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

Drops every entry in the namespace; returns the number removed.

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

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

Number of entries stored under the namespace.