Struct LocalMemoryRetriever 

pub struct LocalMemoryRetriever { /* private fields */ }

The default retriever: local, in-process, no network on the happy path.

Implementations

impl LocalMemoryRetriever

pub fn new( canonical: Arc<IndexHandle>, overlay: Arc<IndexHandle>, config: RetrievalConfig, ) -> Self

Build a retriever over canonical and overlay indexes.

pub fn suppress_windows(&self, windows: HashSet<String>)

Hide canonical records in the given subject|predicate windows.

When the user states something outright mid-conversation, the durable record it contradicts must stop being retrieved now — not after reconciliation. Otherwise B answers a correction by repeating the thing it was just corrected about.

pub fn suppressed_windows(&self) -> HashSet<String>

The windows currently hidden from canonical retrieval.

pub fn semantic(&self) -> Option<&Arc<dyn SemanticFallback>>

The semantic backend, if one was installed.

Exposed so the engine can call SemanticFallback::reconcile after a commit — the vector store has to be told what reconciliation decided, or it keeps answering from the corpus as it was before the correction.

pub fn with_semantic_fallback(self, fallback: Arc<dyn SemanticFallback>) -> Self

Attach a semantic fallback backend.

pub fn invalidate_cache(&self)

Drop cached results — call after any index change.

pub fn cached_len(&self) -> usize

How many cached snapshots are held.

pub async fn retrieve_scoped( &self, query: &str, turn_id: TurnId, budget: RetrievalBudget, kinds: Vec<MemoryKind>, about: Option<String>, attribute: Option<String>, ) -> Result<PreparedMemorySnapshot, MemoryError>

Answer a query directly, restricted to certain memory kinds.

The prepared-snapshot shortcut is deliberately bypassed when a scope is given: the snapshot was built speculatively and knows nothing about the restriction the model asked for, so serving it would answer a different question quickly.

Trait Implementations

impl MemoryRetriever for LocalMemoryRetriever

fn prepare<'life0, 'async_trait>( &'life0 self, request: RetrievalRequest, ) -> Pin<Box<dyn Future<Output = Result<PreparedMemorySnapshot, MemoryError>> + Send + 'async_trait>>

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

Run a plan and produce a snapshot.

fn retrieve_immediate<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, turn_id: TurnId, budget: RetrievalBudget, ) -> Pin<Box<dyn Future<Output = Result<PreparedMemorySnapshot, MemoryError>> + Send + 'async_trait>>

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

Answer a query directly, for when speculation missed.