Struct SessionState 

pub struct SessionState { /* private fields */ }

Key-value store with change tracking for session-attached structured data.

Tools receive an Arc<RwLock<SessionState>> during execution and can read/write arbitrary typed values. Changes are tracked in a StateDelta that is flushed at the end of each turn.

Implementations

impl SessionState

pub fn new() -> Self

Create a new empty session state.

pub fn with_data(data: HashMap<String, Value>) -> Self

Create session state pre-populated with the given data.

Pre-seeded data does NOT appear in the delta (baseline semantics).

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

Get a typed value by key. Returns None if key is missing or deserialization fails.

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

Get the raw JSON value by key without deserialization.

pub fn set<T: Serialize>(&mut self, key: &str, value: T) -> Result<(), Error>

Set a typed value. Serializes to Value and records in delta.

Returns an error if the value cannot be serialized to JSON.

pub fn remove(&mut self, key: &str)

Remove a key. Records removal in delta. No-op if key absent.

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

Check if a key exists.

pub fn keys(&self) -> impl Iterator<Item = &str>

Iterate over all keys.

pub fn len(&self) -> usize

Number of key-value pairs.

pub fn is_empty(&self) -> bool

True if no key-value pairs.

pub fn clear(&mut self)

Remove all key-value pairs. Records all existing keys as removed in delta.

pub const fn delta(&self) -> &StateDelta

Read-only reference to pending delta.

pub fn flush_delta(&mut self) -> StateDelta

Take the pending delta and reset tracking. Returns the delta.

pub fn snapshot(&self) -> Value

Snapshot the materialized data as a JSON Value (for persistence).

pub fn restore_from_snapshot(snapshot: Value) -> Result<Self, Error>

Restore from a JSON Value snapshot. Returns a new SessionState with empty delta.

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

Formats the value using the given formatter.

impl Default for SessionState

fn default() -> SessionState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.