Struct HandleRegistry 

pub struct HandleRegistry { /* private fields */ }

Registry that owns all active handles and generates sequential ref-labels.

Implementations

impl HandleRegistry

pub fn new() -> Self

pub fn register( &mut self, item_id: ContextItemId, kind: ContextKind, source_path: &str, summary: &str, view_costs: &ViewCosts, phi: f64, pinned: bool, ) -> &ContextHandle

Register a new context item and assign the next sequential ref-label.

Returns a reference to the newly created handle.

pub fn resolve(&self, ref_label: &str) -> Option<&ContextHandle>

Look up a handle by its ref-label (e.g. “F1”, “S3”).

Accepts labels with or without the leading @.

pub fn resolve_by_item(&self, item_id: &ContextItemId) -> Option<&ContextHandle>

Look up a handle by its underlying item ID.

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

All registered handles, in registration order.

pub fn total_handle_tokens(&self) -> usize

Sum of handle_tokens across all registered handles.

pub fn format_manifest(&self, budget_total: usize, budget_used: usize) -> String

Render the compact handle manifest for inclusion in a system prompt.

Trait Implementations

impl Clone for HandleRegistry

fn clone(&self) -> HandleRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandleRegistry

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

Formats the value using the given formatter.

impl Default for HandleRegistry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HandleRegistry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HandleRegistry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.