Struct RunLocals 

pub struct RunLocals { /* private fields */ }

What a turn tells its tools about who it works for — set on TurnOptions::locals, read back with ToolContext::run_local (ADR-0044). Re-exported under the rule stated on CancellationToken. Values a host attaches to one run, for the tools that run calls to read.

The per-run sibling of Runtime::app_context. An app context is the runtime’s, so every run on it reads the same value — right for a client handle, wrong for who this run works for. A host that serves many callers from one runtime and one toolset has exactly that second kind of fact: a caller’s workspace, a tenant, a trace id. Without a slot here it either opens a toolset per caller or keys a side table by agent id; with one, it attaches the value to the run and the tool reads it back through ToolContext::run_local.

Keyed by type, at most one value per type, as app_context is: a host wraps a bare String in a newtype of its own so two hosts’ strings cannot collide. Values are Arced and the map is copy-on-write, so cloning a RunOptions — which the runner does freely — costs one reference count.

Inherited by RunOptions::child: a delegated run works for the same caller as the run that delegated it, and a tool the child calls has to see the same answer.

Implementations

impl RunLocals

pub fn new() -> RunLocals

pub fn with<T>(self, value: T) -> RunLocals

where T: Any + Send + Sync + 'static,

Attaches value, replacing any value of the same type.

pub fn with_arc<T>(self, value: Arc<T>) -> RunLocals

where T: Any + Send + Sync + 'static,

Attaches a value the host already shares, replacing any value of the same type.

pub fn get<T>(&self) -> Option<Arc<T>>

where T: Any + Send + Sync + 'static,

The value of type T, when one is attached.

pub fn is_empty(&self) -> bool

pub fn layered(self, over: &RunLocals) -> RunLocals

self with every value of over attached on top: where both hold a type, over’s wins.

Trait Implementations

impl Clone for RunLocals

fn clone(&self) -> RunLocals

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunLocals

Names the attached types, not their values: the values are the host’s and need not be Debug.

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

Formats the value using the given formatter.

impl Default for RunLocals

fn default() -> RunLocals

Returns the “default value” for a type.