Struct ToolResultToState 

pub struct ToolResultToState { /* private fields */ }

Promotes a named tool’s result into a state event.

A tool whose job is to produce state — load_document, set_filters — otherwise forces the agent to emit the result and then publish the state by hand. This transformer does it: when tool_name returns, its JSON content becomes a STATE_SNAPSHOT or a STATE_DELTA.

The result event is kept by default so the client still sees the tool completed; replacing drops it instead. Content that is not JSON of the expected shape is left alone — a malformed result must not take down the run.

let mut promote = ToolResultToState::snapshot("load_document").replacing();
promote.transform(Event::tool_call_start("c1", "load_document"));
let out = promote.transform(Event::tool_call_result("m1", "c1", r#"{"title":"Notes"}"#));
assert_eq!(out, vec![Event::state_snapshot(serde_json::json!({"title": "Notes"}))]);

Implementations

impl ToolResultToState

pub fn snapshot(tool_name: impl Into<String>) -> Self

Turns tool_name’s result into a STATE_SNAPSHOT.

pub fn delta(tool_name: impl Into<String>) -> Self

Turns tool_name’s result into a STATE_DELTA. The result content must be a JSON array of RFC 6902 operations.

pub fn replacing(self) -> Self

Drops the TOOL_CALL_RESULT instead of emitting it alongside the state event.

Trait Implementations

impl Clone for ToolResultToState

fn clone(&self) -> ToolResultToState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolResultToState

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

Formats the value using the given formatter.

impl StreamTransformer for ToolResultToState

fn transform(&mut self, event: Event) -> Vec<Event>

Rewrites one event into zero or more events.