Struct SharedState 

pub struct SharedState(/* private fields */);

A cheaply-cloneable handle to a tool’s shared key-value state store.

ToolContext keeps its state behind this handle so multiple contexts (e.g. successive tool calls within the same agent turn) can read and write the same underlying store. Clone it and hand it to another context via ToolContext::with_shared_state.

The concrete lock and map types are an implementation detail — they differ between std and no_std builds — so they are deliberately not exposed.

Implementations

impl SharedState

pub fn new() -> Self

Create a new, empty shared state store.

pub fn get_state(&self, key: &str, default: Value) -> Value

Retrieve a value from the shared state, returning default if the key is absent or the lock is poisoned.

pub fn set_state(&self, key: &str, value: Value) -> Result<(), ToolError>

Insert or update a value in the shared state.

Errors

Returns ToolError if the lock is poisoned.

pub fn remove_state(&self, key: &str) -> bool

Remove a value from the shared state by key, returning true if it was present.

pub fn clear_state(&self)

Clear all entries from the shared state.

Trait Implementations

impl Clone for SharedState

fn clone(&self) -> SharedState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedState

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

Formats the value using the given formatter.

impl Default for SharedState

fn default() -> Self

Returns the “default value” for a type.