Struct ToolExecutionHistory 

pub struct ToolExecutionHistory { /* private fields */ }

Thread-safe execution history for recording tool executions.

Implementations

impl ToolExecutionHistory

pub fn new(max_records: usize) -> Self

Create a new execution history with a maximum record count.

pub fn add_record(&self, record: ToolExecutionRecord)

Add a record to the history.

pub fn set_loop_detection_limits( &self, detect_window: usize, identical_limit: usize, )

Set loop detection parameters.

pub fn set_rate_limit_per_minute(&self, limit: Option<usize>)

Set the rate limit for tool executions per minute.

pub fn get_recent_records(&self, count: usize) -> Vec<ToolExecutionRecord>

Get the most recent records.

pub fn get_recent_failures(&self, count: usize) -> Vec<ToolExecutionRecord>

Get recent failures in chronological order.

pub fn find_recent_spooled_result( &self, tool_name: &str, args: &Value, max_age: Duration, ) -> Option<Value>

Find the most recent spooled output for a tool call with identical args.

pub fn find_recent_successful_result( &self, tool_name: &str, args: &Value, max_age: Duration, ) -> Option<Value>

Find the most recent successful output for a tool call with identical args.

pub fn find_recent_read_file_spool_progress( &self, path: &str, max_age: Duration, ) -> Option<(usize, usize)>

Find continuation info from a recent chunked file-read call for the same path.

Supports both read_file and unified_file read action records.

Returns (next_offset, chunk_limit) when the recent call indicates more chunks are available (spool_chunked=true, has_more=true).

pub fn clear(&self)

Clear all records.

pub fn len(&self) -> usize

Total number of execution records currently stored.

pub fn is_empty(&self) -> bool

Whether no execution records are currently stored.

pub fn loop_limit(&self) -> usize

Get the current loop limit.

pub fn loop_limit_for(&self, tool_name: &str, args: &Value) -> usize

Get the effective loop limit for a specific tool.

pub fn rate_limit_per_minute(&self) -> Option<usize>

Get the rate limit per minute if configured.

pub fn calls_in_window(&self, window: Duration) -> usize

Count calls within a time window.

pub fn detect_loop( &self, tool_name: &str, args: &Value, ) -> (bool, usize, String)

Detect if the agent is stuck in a loop.

Returns (is_loop, repeat_count, tool_name) if a loop is detected.

Trait Implementations

impl Clone for ToolExecutionHistory

fn clone(&self) -> ToolExecutionHistory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ToolExecutionHistory

fn default() -> Self

Returns the “default value” for a type.