Struct SessionState 

pub struct SessionState { /* private fields */ }

The free-form state bag of an AgentSession, shared by reference across clones.

Upstream’s AgentSession.state is a plain Python dict, and Python sessions are reference types: every holder of the session sees the same dict, including the child session as_tool(propagate_session=True) hands a sub-agent (upstream shares the dict by reference while isolating service_session_id). A by-value HashMap cannot express that, so the state bag is an Arc<Mutex<..>> handle: cloning an AgentSession (or a SessionState) yields a view onto the same bag, and mutations through any clone are visible to all of them.

Implementations

impl SessionState

pub fn new() -> SessionState

A fresh, empty state bag.

pub fn insert(&self, key: impl Into<String>, value: Value) -> Option<Value>

Insert value at key, returning the previous value if any.

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

A clone of the value at key, if present.

pub fn remove(&self, key: &str) -> Option<Value>

Remove and return the value at key, if present.

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

Whether key is present.

pub fn len(&self) -> usize

The number of entries.

pub fn is_empty(&self) -> bool

Whether the bag is empty.

pub fn snapshot(&self) -> HashMap<String, Value>

A point-in-time copy of the whole bag (e.g. for serialization).

pub fn shares_storage_with(&self, other: &SessionState) -> bool

Whether other is a view onto the same underlying bag.

Trait Implementations

impl Clone for SessionState

fn clone(&self) -> SessionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionState

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

Formats the value using the given formatter.

impl Default for SessionState

fn default() -> SessionState

Returns the “default value” for a type.

impl From<HashMap<String, Value>> for SessionState

fn from(map: HashMap<String, Value>) -> SessionState

Converts to this type from the input type.