Struct MemoriesState 

pub struct MemoriesState { /* private fields */ }

Materialized view over the memories log.

Per perf #96, the value type is Arc<Memory> (not Memory). Query reads (execute, find_many, MemoriesQuery::collect) hand back Vec<Arc<Memory>> — each match is an atomic refcount bump instead of a deep Memory clone (which carries String content, Vec<String> tags, String source — 3+ allocations per cloned entry). Mutations route through Arc::make_mut so a unique Arc mutates in place (the common case under the fold’s serial write lock) and a shared Arc (outstanding reader) clones-on-write to preserve the reader’s snapshot.

Serialize / Deserialize are derived so the state can be snapshotted via super::super::CortexAdapter::snapshot and restored via super::super::CortexAdapter::open_from_snapshot. Arc<Memory> serializes transparently with serde’s rc feature (already enabled in this crate’s serde dep).

Implementations

impl MemoriesState

pub fn query(&self) -> MemoriesQuery<'_>

Start a fluent query over this state snapshot.

impl MemoriesState

pub fn new() -> MemoriesState

Create an empty state.

pub fn get(&self, id: u64) -> Option<&Memory>

Look up a memory by id. Returns a borrow into the Arc payload so the common single-read case doesn’t pay a refcount bump; callers that need an owned share can clone the Arc themselves via Self::get_arc.

pub fn get_arc(&self, id: u64) -> Option<Arc<Memory>>

Look up a memory by id and return an Arc share. Cheap (atomic refcount bump) — use when the caller needs to hold the memory past the borrow’s lifetime.

pub fn len(&self) -> usize

Total number of memories currently retained.

pub fn is_empty(&self) -> bool

True if no memories are retained.

pub fn contains(&self, id: u64) -> bool

True if a memory with id exists.

pub fn all(&self) -> impl Iterator<Item = &Memory>

Iterate over every retained memory.

pub fn pinned(&self) -> impl Iterator<Item = &Memory>

Iterate over currently-pinned memories.

pub fn unpinned(&self) -> impl Iterator<Item = &Memory>

Iterate over memories that are NOT pinned.

pub fn find_unique(&self, id: u64) -> Option<&Memory>

Look up a memory by id. Alias of Self::get.

pub fn find_many(&self, filter: &MemoriesFilter) -> Vec<Arc<Memory>>

Collect all memories matching filter, respecting order + limit. Returns Vec<Arc<Memory>> per perf #96 — each match is one atomic refcount bump instead of the legacy deep Memory clone.

pub fn count_where(&self, filter: &MemoriesFilter) -> usize

Count memories matching filter. Ignores limit.

pub fn exists_where(&self, filter: &MemoriesFilter) -> bool

True if any memory matches filter. Short-circuits.

Trait Implementations

impl Clone for MemoriesState

fn clone(&self) -> MemoriesState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoriesState

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

Formats the value using the given formatter.

impl Default for MemoriesState

fn default() -> MemoriesState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MemoriesState

fn deserialize<__D>( __deserializer: __D, ) -> Result<MemoriesState, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoriesState

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.