Struct SemanticStore 

pub struct SemanticStore { /* private fields */ }

Stores semantic (fact-based) knowledge as tagged key-value pairs.

Guarantees

• Thread-safe via Arc<Mutex<_>>
• Retrieval by tag intersection
• Optional vector-based similarity search via stored embeddings

Implementations

impl SemanticStore

pub fn new() -> Self

Create a new empty semantic store.

pub fn store( &self, key: impl Into<String> + Debug, value: impl Into<String> + Debug, tags: Vec<String>, ) -> Result<(), AgentRuntimeError>

Store a key-value pair with associated tags.

pub fn store_with_embedding( &self, key: impl Into<String> + Debug, value: impl Into<String> + Debug, tags: Vec<String>, embedding: Vec<f32>, ) -> Result<(), AgentRuntimeError>

Store a key-value pair with an embedding vector for similarity search.

Errors

Returns Err(AgentRuntimeError::Memory) if embedding is empty or dimension mismatches.

pub fn retrieve( &self, tags: &[&str], ) -> Result<Vec<(String, String)>, AgentRuntimeError>

Retrieve all entries that contain all of the given tags.

If tags is empty, returns all entries.

pub fn retrieve_similar( &self, query_embedding: &[f32], top_k: usize, ) -> Result<Vec<(String, String, f32)>, AgentRuntimeError>

Retrieve top-k entries by cosine similarity to query_embedding.

Only entries that were stored with an embedding (via store_with_embedding) are considered. Returns (key, value, similarity) sorted by descending similarity.

Returns Err(AgentRuntimeError::Memory) if query_embedding dimension mismatches.

pub fn len(&self) -> Result<usize, AgentRuntimeError>

Return the total number of stored entries.

pub fn is_empty(&self) -> Result<bool, AgentRuntimeError>

Return true if no entries have been stored.

Trait Implementations

impl Clone for SemanticStore

fn clone(&self) -> SemanticStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SemanticStore

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

Formats the value using the given formatter.

impl Default for SemanticStore

fn default() -> Self

Returns the “default value” for a type.