Struct HandleTable 

pub struct HandleTable { /* private fields */ }

Per-task handle table. M3 makes the context manager’s partitions a view over this.

Implementations

impl HandleTable

pub fn new() -> Self

pub fn insert(&mut self, handle: Handle)

pub fn get(&self, id: HandleId) -> Option<&Handle>

pub fn get_mut(&mut self, id: HandleId) -> Option<&mut Handle>

pub fn all(&self) -> &[Handle]

pub fn all_mut(&mut self) -> &mut [Handle]

pub fn retain(&mut self, keep: impl FnMut(&Handle) -> bool)

Retain only the handles for which keep returns true; drop the rest. The GC primitive the context manager uses to evict handles whose backing message has left working context (archived by compression / dropped on renewal) — bounding the table to the working set instead of growing with total session length.

pub fn residency_for_source(&self, source: &str) -> Option<&Residency>

Residency of the handle anchored to source (e.g. a tool call_id), if any. The renderer uses this to project a tool result without touching the stored message.

pub fn tool_result_handles_mut(&mut self) -> impl Iterator<Item = &mut Handle>

Tool-result handles in insertion (recency) order — oldest first. Used by the residency planner to decide which older results to project out under context pressure.

pub fn resident_tokens(&self) -> u32

Sum of tokens for handles still occupying working context.

pub fn non_resident_tokens(&self) -> u32

Sum of tokens for handles that have left working context (Collapsed / SpooledOut / PagedOut). Their anchored messages still sit in partitions at full weight (collapse is non-destructive), so this is exactly the over-count that the estimate rho path must discount to become paging-aware — see [crate::context::manager::ContextManager::effective_rho].

Trait Implementations

impl Clone for HandleTable

fn clone(&self) -> HandleTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandleTable

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

Formats the value using the given formatter.

impl Default for HandleTable

fn default() -> HandleTable

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HandleTable

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HandleTable

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

where __S: Serializer,

Serialize this value into the given Serde serializer.