Trait Observer 

pub trait Observer: Send + Sync {
    // Provided methods
    fn on_step(&self, step_index: usize, step: &ReActStep) { ... }
    fn on_tool_call(&self, tool_name: &str, args: &Value) { ... }
    fn on_action_blocked(&self, tool_name: &str, args: &Value) { ... }
    fn on_loop_start(&self, prompt: &str) { ... }
    fn on_loop_end(&self, step_count: usize) { ... }
}

Hook trait for observing agent loop events.

All methods have no-op default implementations so you only override what you care about.

Provided Methods

fn on_step(&self, step_index: usize, step: &ReActStep)

Called when a ReAct step completes.

fn on_tool_call(&self, tool_name: &str, args: &Value)

Called when a tool is about to be dispatched.

fn on_action_blocked(&self, tool_name: &str, args: &Value)

Called when an action hook blocks a tool call before dispatch.

tool_name is the name of the blocked tool; args are the arguments that were passed to the hook. This is called instead of on_tool_call.

fn on_loop_start(&self, prompt: &str)

Called when the loop starts.

fn on_loop_end(&self, step_count: usize)

Called when the loop finishes (success or error).

Implementors