Struct SharedState 

pub struct SharedState { /* private fields */ }

A shared string key-value store for sub-agent communication.

Cheaply cloneable (wraps Arc). Delegates all operations to a pluggable SharedStateBackend.

Implementations

impl SharedState

pub fn new() -> Self

Create a new in-memory store with the default 10 MB capacity.

pub fn with_max_bytes(max_bytes: usize) -> Self

Create a new in-memory store with a custom byte capacity.

pub fn with_backend(backend: impl SharedStateBackend + 'static) -> Self

Create a store backed by a custom backend.

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

Get a value by key. Returns None if the key doesn’t exist.

pub async fn set( &self, key: &str, value: String, ) -> Result<(), SharedStateError>

Store a value. Returns Err if the backend rejects it (capacity, I/O, etc.).

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

Remove a key. Returns true if the key existed.

pub async fn keys(&self) -> Vec<String>

List all keys (sorted).

pub async fn summary(&self) -> String

Human-readable summary of stored variables (key names + byte sizes). Suitable for injecting into a system prompt.

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 Default for SharedState

fn default() -> Self

Returns the “default value” for a type.