Struct Session 

pub struct Session<'db> { /* private fields */ }

A scoped conversation session over a Mnemo database.

Created by Mnemo::session. Holds the database mutably until it is closed (or dropped), so all writes for the conversation flow through it.

Implementations

impl<'db> Session<'db>

pub fn id(&self) -> &str

This session’s unique id (a ULID string), stamped on every turn.

pub fn agent(&self) -> &str

The agent this session belongs to.

pub fn turn_ids(&self) -> &[Ulid]

Ids of the turns recorded so far, in order.

pub fn turn_count(&self) -> usize

How many turns have been recorded.

pub fn add_turn(&mut self, turn: Turn) -> Result<Ulid>

Record a conversation turn as a Working memory tagged with this session and agent. The turn’s role is kept in the memory’s metadata. Writes are staged; they reach disk on Session::close (or any later flush of the database).

pub fn recall(&mut self, request: RecallRequest) -> Result<Vec<RecallResult>>

Retrieve memories for context injection, scoped to this session’s agent. The agent filter on request is overridden — a session always recalls within its own agent’s view (its private memories plus shared ones). All other request fields (type filter, weights, top-k) apply.

pub fn close(self) -> Result<usize>

End the session, consolidating its working turns into episodic memory: each turn still typed Working is promoted to Episodic, the store of “what happened”. Returns the number of turns promoted; the database is flushed before returning.

pub fn discard(self) -> Result<usize>

End the session, discarding its working turns instead of consolidating them — every turn this session recorded is deleted. Returns the number removed; the database is flushed before returning.