Struct SessionValues 

pub struct SessionValues { /* private fields */ }

Per-run store of full tool results, addressed by short handles.

Deliberately not thread-shared: the loop is sequential and one store per run is the whole lifetime story. A shared store would raise a question this design does not want to answer — whether one run can read another’s values.

Implementations

impl SessionValues

pub fn new() -> Self

pub fn put(&mut self, value: Value) -> String

Retain value and return its handle.

pub fn get(&self, handle: &str) -> Option<&Value>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn resolve_refs(&self, params: &mut Value) -> Vec<String>

Substitute $rN references in tool arguments with the values they name.

Runs BEFORE parameter validation, which is not an implementation detail: car-validator checks parameters against the tool’s JSON Schema, and "$r3" is a string where the schema may demand an array. Resolving first means the validator sees the real value and its guarantees are unweakened — the alternative, teaching every schema to also admit a reference form, would punch a hole in all of them.

Only whole string values are treated as references. A string that merely contains $r3 is left alone: tool arguments legitimately carry shell snippets and regexes, and interpolating into the middle of one would corrupt commands that have nothing to do with this feature.

An unknown handle is left untouched rather than erased or errored. The model gets the literal string back and the tool’s own validation reports it, which is a better failure than silently substituting null. Returns the handles that were resolved, for logging.

Trait Implementations

impl Debug for SessionValues

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

Formats the value using the given formatter.

impl Default for SessionValues

fn default() -> Self

Returns the “default value” for a type.