Struct TurnTracker 

pub struct TurnTracker {
    pub started_at: Instant,
    pub tool_calls_started: u32,
    pub tool_calls_completed: u32,
    pub tool_errors: u32,
    pub files_read: BTreeSet<String>,
    pub files_written: BTreeSet<String>,
    pub files_created: BTreeSet<String>,
    pub commands_run: Vec<String>,
    pub searches: u32,
    /* private fields */
}

Tracks tool calls, file accesses, and command runs during a single agent turn.

Designed to be reset at AgentStart and queried at any point during or after the turn to drive progress indicators and summaries.

Fields

started_at: Instant

tool_calls_started: u32

tool_calls_completed: u32

tool_errors: u32

files_read: BTreeSet<String>

Unique paths that were read (via the read tool).

files_written: BTreeSet<String>

Unique paths that were written or edited (edit / multi_edit / write).

files_created: BTreeSet<String>

Unique paths that were created by the write tool.

commands_run: Vec<String>

Bash commands that were executed (first 80 chars each).

searches: u32

Number of search-like tool calls (grep / find / probe_search / probe_extract).

Implementations

impl TurnTracker

pub fn new() -> Self

Create a fresh tracker with the clock started now.

pub fn start_now(&mut self)

pub fn clear_counts(&mut self)

pub fn reset(&mut self)

Reset all counters and restart the clock. Called at AgentStart.

pub fn elapsed(&self) -> Duration

Wall-clock time since the turn started (or last reset).

pub fn record_tool_start( &mut self, tool_call_id: &str, name: &str, args: &Value, )

Called at ToolExecutionStart. Records the tool call and classifies it.

The tool_call_id is stored so that record_tool_end can look up the name when the result arrives.

pub fn record_tool_end(&mut self, tool_call_id: &str, is_error: bool)

Called at ToolExecutionEnd. Increments completed / error counters.

Trait Implementations

impl Default for TurnTracker

fn default() -> Self

Returns the “default value” for a type.