Struct ScopedMemory 

pub struct ScopedMemory { /* private fields */ }

One conversation’s memory: a MemoryHandle with the conversation already applied, so recall and remember take no conversation argument. Build it with ContextScope::memory. The underlying handle stays reachable through handle for the cross-conversation verbs (durable remember, graph writes).

Implementations

impl ScopedMemory

pub fn recall(&self) -> RecallBuilder<'_>

Recall within this conversation. Chain .semantic/.keyword/.limit and finish with .fetch().await, exactly like the unscoped builder minus the conversation argument.

pub fn remember(&self, payload: impl Into<Vec<u8>>) -> RememberBuilder<'_>

Remember payload in this conversation’s session scope. Chain .kind /.dedup and finish with .send().await.

pub fn with_lineage( self, origin: Option<SourceRef>, producer: Option<ProducerInfo>, ) -> Self

This scope with origin and producer stamped on every remembered item.

pub async fn block( &self, token_budget: Option<usize>, ) -> Result<String, LaserError>

The one-call context altitude: recall this conversation’s most relevant items rendered as one prompt-ready block under an optional token budget.

pub fn search(&self, query: impl Into<String>) -> RecallBuilder<'_>

Keyword recall for query within this conversation, up to 50 items. It needs no Embedder, so it works on the default log-backed memory. Await it directly, or chain .limit(n) and .folded() first. Use recall for semantic or hybrid recall.

pub async fn consolidate( &self, max_items: usize, ) -> Result<ConsolidationReport, LaserError>

One consolidation pass over this conversation, keeping the newest max_items and pruning the rest.

pub async fn consolidate_with( &self, max_items: usize, summarizer: impl Summarizer + Sync, prune_summarized: bool, ) -> Result<ConsolidationReport, LaserError>

consolidate with the summarize pass, see MemoryHandle::consolidate_with.

pub async fn forget(&self, id: MemoryId) -> Result<(), LaserError>

Forget the item id if it was remembered in this conversation. A tombstone for an item of another conversation changes nothing.

pub async fn improve(&self, feedback: Feedback) -> Result<MemoryId, LaserError>

Record feedback on the item it targets. Like forget, it counts only when the item was remembered in this conversation.

pub fn handle(&self) -> &MemoryHandle

The underlying handle, for the cross-conversation verbs this scoped face does not narrow.

pub fn conversation(&self) -> ConversationId

This scoped memory’s conversation id.

pub fn origin(&self) -> Option<&SourceRef>

The origin stamped on every remembered item, if any.

pub fn producer(&self) -> Option<&ProducerInfo>

The producer stamped on every remembered item, if any.