Struct MemoryStore 

pub struct MemoryStore { /* private fields */ }

In-memory state store backed by a HashMap behind a RwLock.

Suitable for testing, prototyping, and single-process use cases where persistence across restarts is not required.

Create an unbounded store with MemoryStore::new or a capacity-limited LRU store with MemoryStore::bounded.

Implementations

impl MemoryStore

pub fn new() -> Self

Create a new empty in-memory store with no eviction limit.

pub fn bounded(capacity: usize) -> Self

Create a bounded in-memory store that evicts least-recently-used entries when the entry count exceeds capacity.

Reads and writes both count as “use” for LRU ordering. Pinned scope entries (written via write_hinted with Lifetime::Durable) are never evicted.

Trait Implementations

impl Default for MemoryStore

fn default() -> Self

Returns the “default value” for a type.

impl StateStore for MemoryStore

fn read<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, scope: &'life1 Scope, key: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Value>, StateError>> + Send + 'async_trait>>

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

Read a value by key within a scope. Returns None if the key doesn’t exist.

fn write<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, scope: &'life1 Scope, key: &'life2 str, value: Value, ) -> Pin<Box<dyn Future<Output = Result<(), StateError>> + Send + 'async_trait>>

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

Write a value. Creates or overwrites.

fn delete<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, scope: &'life1 Scope, key: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), StateError>> + Send + 'async_trait>>

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

Delete a value. No-op if key doesn’t exist.

fn list<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, scope: &'life1 Scope, prefix: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, StateError>> + Send + 'async_trait>>

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

List keys under a prefix within a scope.

fn search<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, scope: &'life1 Scope, query: &'life2 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<SearchResult>, StateError>> + Send + 'async_trait>>

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

Semantic search within a scope. Returns matching keys with relevance scores. Implementations that don’t support search return an empty vec (not an error).

fn write_hinted<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, scope: &'life1 Scope, key: &'life2 str, value: Value, options: &'life3 StoreOptions, ) -> Pin<Box<dyn Future<Output = Result<(), StateError>> + Send + 'async_trait>>

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

Write a value with advisory options. Backends may ignore options.

fn clear_transient(&self)

Clear all transient-lifetime entries from the store.

fn read_hinted<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, scope: &'life1 Scope, key: &'life2 str, _options: &'life3 StoreOptions, ) -> Pin<Box<dyn Future<Output = Result<Option<Value>, StateError>> + Send + 'async_trait>>

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

Read a value with advisory options. Backends may ignore options.

fn link<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _scope: &'life1 Scope, _link: &'life2 MemoryLink, ) -> Pin<Box<dyn Future<Output = Result<(), StateError>> + Send + 'async_trait>>

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

Create a link between two memory entries.

fn unlink<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, _scope: &'life1 Scope, _from_key: &'life2 str, _to_key: &'life3 str, _relation: &'life4 str, ) -> Pin<Box<dyn Future<Output = Result<(), StateError>> + Send + 'async_trait>>

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

Remove a link between two memory entries.

fn traverse<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _scope: &'life1 Scope, _from_key: &'life2 str, _relation: Option<&'life3 str>, _max_depth: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, StateError>> + Send + 'async_trait>>

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

Traverse links from a starting key.

fn search_hinted<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, scope: &'life1 Scope, query: &'life2 str, limit: usize, _options: &'life3 SearchOptions, ) -> Pin<Box<dyn Future<Output = Result<Vec<SearchResult>, StateError>> + Send + 'async_trait>>

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

Enhanced search with advisory options.