Struct Contexts 

pub struct Contexts { /* private fields */ }

The in-memory registry of contexts + their durable mirror.

Implementations

impl Contexts

pub fn new(model_window: u64) -> Contexts

pub fn restore(&mut self, envelopes: &[Envelope]) -> Vec<String>

Adopt restored context envelopes.

pub fn get(&self, id: &str) -> Option<&ContextState>

pub fn get_mut(&mut self, id: &str) -> Option<&mut ContextState>

pub fn root(&mut self) -> &mut ContextState

Get or create the root context.

pub fn conversation( &mut self, id: &str, principal: Option<&str>, ) -> &mut ContextState

Get or create a conversation context.

pub fn ids(&self) -> Vec<String>

pub fn len(&self) -> usize

pub fn max_est_tokens(&self) -> u64

The token estimate of the largest live context (for agent_context_tokens).

pub fn is_empty(&self) -> bool

pub fn remove(&mut self, id: &str) -> Option<ContextState>

pub fn checkpoint( &mut self, durable: &Durable, ) -> Result<Vec<String>, StoreError>

Checkpoint every dirty context — called after each turn and after each compaction, which bounds a crash’s loss to the work in flight.

Returns the ids written. A clean context is skipped, so repeated calls are cheap and the write count tracks real change.

pub fn status(&self) -> Value

A status view (agent://conversations).