Struct ToolExecutionHistory 

pub struct ToolExecutionHistory { /* private fields */ }

Thread-safe execution history for recording tool executions.

Implementations

impl ToolExecutionHistory

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) -> LoopDetectionResult

Detect if the agent is stuck in a loop.

Returns a LoopDetectionResult indicating whether a loop was detected.

impl ToolExecutionHistory

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_successful_by_read_target( &self, tool_name: &str, query_args: &Value, max_age: Duration, ) -> Option<Value>

Find the most recent successful output for a read-only tool call that targets the same file path and compatible read shape. This enables cross-turn dedup only when the cached read covers the new request.

Returns None for non-read-only tools or when no matching path can be extracted from the args.

pub fn invalidate_for_path(&self, target_path: &str)

Invalidate cache records whose read target overlaps the mutated path. Used when a write tool modifies a file: only the records that could contain stale content for that file are dropped, instead of wiping every cached read-only result.

pub fn invalidate_all_reads(&self)

Conservatively drop every cached read-only result.

Used when a mutating shell command produces no identifiable target path (e.g. sed -i), so we cannot know which files may now be stale. A pathless mutation could have touched anything, so no read record can be trusted afterward.

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

Supports both read_file and file_operation read action records.

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

impl ToolExecutionHistory

pub fn task_telemetry_snapshot( &self, task_id: Option<&str>, task_completed_successfully: Option<bool>, ) -> ToolTaskTelemetrySnapshot

Aggregate representative task telemetry from recorded tool calls.

When task_id is Some, only records with the same harness task id are included. When None, the snapshot covers all stored records.

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 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.

Trait Implementations

impl Clone for ToolExecutionHistory

fn clone(&self) -> Self

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.