Struct StateReconstructor 

pub struct StateReconstructor { /* private fields */ }

Reconstructs agent state from AG-UI events.

This struct tracks the current agent state and message history, updating them as events are received. It handles both snapshot and delta events for efficient state synchronization.

Implementations

impl StateReconstructor

pub fn new() -> Self

Creates a new state reconstructor with empty initial state.

pub fn with_state(initial: JsonValue) -> Self

Creates a new state reconstructor with initial state.

pub fn current(&self) -> &JsonValue

Returns a reference to the current state.

pub fn into_state(self) -> JsonValue

Returns the current state, consuming the reconstructor.

pub fn messages(&self) -> &[Message]

Returns a reference to the message history.

pub fn run_id(&self) -> Option<&str>

Returns the current run ID, if any.

pub fn is_run_active(&self) -> bool

Returns whether a run is currently active.

pub fn apply_event(&mut self, event: &Event<JsonValue>) -> Result<()>

Applies an event to update the state.

This method processes the event and updates the internal state accordingly. State snapshots replace the entire state, while deltas are applied as JSON Patches.

pub fn apply_delta(&mut self, delta: &[JsonValue]) -> Result<()>

Applies a JSON Patch delta to the current state.

pub fn apply_patch(&mut self, patch: &Patch) -> Result<()>

Applies a Patch directly to the current state.

pub fn reset(&mut self, state: JsonValue)

Resets the state to a new value.

pub fn clear(&mut self)

Clears all state and message history.

pub fn get(&self, path: &str) -> Option<&JsonValue>

Gets a value from the state by JSON pointer path.

Example

let count = state.get("/count");
let nested = state.get("/user/name");

pub fn get_as<T: DeserializeOwned>(&self, path: &str) -> Option<T>

Gets a typed value from the state by JSON pointer path.

Returns None if the path doesn’t exist or the value can’t be deserialized to the target type.

Trait Implementations

impl Clone for StateReconstructor

fn clone(&self) -> StateReconstructor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateReconstructor

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

Formats the value using the given formatter.

impl Default for StateReconstructor

fn default() -> Self

Returns the “default value” for a type.