Struct Extensions 

pub struct Extensions { /* private fields */ }

Typed, tamper-evident extension map carried on CallCtx.

This is the substrate-level channel through which a host attaches caller identity / clearance / mandate (e.g. a ClearanceContext from atomr-agents-security) so it flows unmodified to Tool::invoke via InvokeCtx. Two deliberate guarantees:

• Never persisted. CallCtx is not Serialize, and the extension map holds dyn Any values that cannot be serialized, so secrets/clearance attached here never land in a checkpoint, telemetry record, or prompt.
• Not LLM-writable. Values are inserted only by Rust host / runtime code via Extensions::insert / CallCtx::insert_ext; there is no path from an LLM tool argument (raw_args) into this map, so it is tamper-evident with respect to model output.

Stored values are Arc-wrapped so cloning a CallCtx (which the runtime does per tool dispatch) shares — rather than deep-copies — the extensions.

Implementations

impl Extensions

pub fn new() -> Self

An empty extension map.

pub fn insert<T: Any + Send + Sync>(&mut self, value: T)

Insert (or replace) the extension of type T.

pub fn get<T: Any + Send + Sync>(&self) -> Option<&T>

Borrow the extension of type T, if present.

pub fn contains<T: Any + Send + Sync>(&self) -> bool

Whether an extension of type T is present.

pub fn len(&self) -> usize

Number of distinct extension types stored.

pub fn is_empty(&self) -> bool

Whether the map is empty.

Trait Implementations

impl Clone for Extensions

fn clone(&self) -> Extensions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Extensions

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

Formats the value using the given formatter.

impl Default for Extensions

fn default() -> Extensions

Returns the “default value” for a type.