Struct NeuralMemoryStore 

pub struct NeuralMemoryStore { /* private fields */ }

In-memory store for neural embeddings with index-based retrieval.

Uses a VecDeque for O(1) front eviction instead of Vec::remove(0) which is O(n).

Implementations

impl NeuralMemoryStore

pub fn new(capacity: usize) -> Self

Create a new store with the given capacity.

pub fn store(&mut self, embedding: NeuralEmbedding) -> Result<usize>

Store an embedding, returning its physical index within the deque.

If the store is at capacity, the oldest embedding is evicted. Returns an error if the embedding dimension is inconsistent with previously stored embeddings.

pub fn get(&self, id: usize) -> Option<&NeuralEmbedding>

Get an embedding by its index.

pub fn len(&self) -> usize

Number of embeddings currently stored.

pub fn is_empty(&self) -> bool

Returns true if the store is empty.

pub fn query_nearest( &self, query: &NeuralEmbedding, k: usize, ) -> Vec<(usize, f64)>

Find the k nearest neighbors using brute-force Euclidean distance.

Returns pairs of (index, distance), sorted by ascending distance.

pub fn query_by_state(&self, state: CognitiveState) -> Vec<&NeuralEmbedding>

Query all embeddings matching a given cognitive state.

pub fn query_by_subject(&self, subject_id: &str) -> Vec<&NeuralEmbedding>

Query all embeddings for a given subject.

pub fn query_time_range(&self, start: f64, end: f64) -> Vec<&NeuralEmbedding>

Query embeddings within a timestamp range [start, end].

pub fn embeddings_iter(&self) -> impl Iterator<Item = &NeuralEmbedding>

Access all embeddings (for serialization).

Returns the two slices of the VecDeque as a pair. For contiguous access, callers can use make_contiguous() on a mutable reference, or iterate.

pub fn embeddings(&self) -> Vec<&NeuralEmbedding>

Access all embeddings as a slice pair (VecDeque may be non-contiguous).

pub fn capacity(&self) -> usize

Get the capacity.

Trait Implementations

impl Clone for NeuralMemoryStore

fn clone(&self) -> NeuralMemoryStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NeuralMemoryStore

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

Formats the value using the given formatter.

impl NeuralMemory for NeuralMemoryStore

fn store(&mut self, embedding: &NeuralEmbedding) -> Result<()>

Store an embedding in memory.

fn query_nearest( &self, embedding: &NeuralEmbedding, k: usize, ) -> Result<Vec<NeuralEmbedding>>

Find the k nearest embeddings to the query.

fn query_by_state(&self, state: CognitiveState) -> Result<Vec<NeuralEmbedding>>

Find all stored embeddings matching a cognitive state.