Struct ToolRunMetadata 

pub struct ToolRunMetadata {

    pub detail: ToolMetadata,
    pub line_count: Option<usize>,
    pub byte_count: Option<usize>,
    pub result_count: Option<usize>,
    pub duration_secs: Option<f64>,
    pub process: Option<ManagedProcess>,
    pub display_diff: Option<String>,
    pub diff_truncated: bool,
    pub lines_added: usize,
    pub lines_removed: usize,
    pub artifacts: Vec<ToolArtifact>,
    pub token_usage: Option<TokenUsage>,
    pub plan_file_written: bool,
}

Structured metadata extracted from a completed tool run.

Fields

detail: ToolMetadata

line_count: Option<usize>

byte_count: Option<usize>

result_count: Option<usize>

duration_secs: Option<f64>

process: Option<ManagedProcess>

display_diff: Option<String>

User-facing display diff for file mutations. This is captured at tool execution time so whole-file writes can compare against the pre-write contents even after the file has been overwritten.

diff_truncated: bool

lines_added: usize

Exact line-change counts for file mutations. Carried separately from display_diff because that string is capped at MAX_DISPLAY_DIFF_LINES — recounting it would undercount large writes. handle_tool_finished folds these into the per-run totals behind the end-of-run +N/-M summary.

lines_removed: usize

artifacts: Vec<ToolArtifact>

token_usage: Option<TokenUsage>

Provider token usage the tool itself consumed (today: a subagent’s cumulative child-session usage). handle_tool_finished folds it into the parent session’s totals so the footer and the end-of-run summary count the whole tree, not just the parent’s own model calls.

plan_file_written: bool

This call wrote the plan file while planning — the FACT the doom-loop breaker disarms on.

Recorded at the boundary that actually knows it (the policy gate approved the write, or the file mutator targeted the plan path) rather than inferred from the tool name. Inferring it missed the shell spelling entirely: the escalated corrective tells the model “a shell redirect writing ONLY that file works too”, and when the model complied the breaker stayed armed and kept re-injecting “the plan file does not exist until you write it” at a model that had just written it.

Trait Implementations

impl Clone for ToolRunMetadata

fn clone(&self) -> ToolRunMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolRunMetadata

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

Formats the value using the given formatter.

impl Default for ToolRunMetadata

fn default() -> ToolRunMetadata

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ToolRunMetadata

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolRunMetadata

fn eq(&self, other: &ToolRunMetadata) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ToolRunMetadata

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolRunMetadata