Enum ToolTelemetryEvent 

pub enum ToolTelemetryEvent {
    ToolExecutionStarted {
        tool_name: String,
        has_args: bool,
    },
    ToolExecutionCompleted {
        tool_name: String,
        duration: Duration,
        output_size_bytes: usize,
    },
    ToolExecutionFailed {
        tool_name: String,
        error_type: String,
        duration: Duration,
    },
    ToolFallbackDetected {
        from_tool: String,
        to_tool: String,
        reason: String,
        affected_file: Option<String>,
    },
    ToolBlocked {
        tool_name: String,
        policy_reason: String,
    },
    ToolTimeoutWarning {
        tool_name: String,
        elapsed: Duration,
        ceiling: Duration,
        percentage: u8,
    },
    DestructiveOperationWarning {
        tool_name: String,
        operation_type: String,
        affected_files: Vec<String>,
        has_backup: bool,
    },
}

Telemetry events emitted during tool execution

Variants

ToolExecutionStarted

A tool execution was attempted

Fields

tool_name: String

has_args: bool

ToolExecutionCompleted

A tool execution completed successfully

Fields

tool_name: String

duration: Duration

output_size_bytes: usize

ToolExecutionFailed

A tool execution failed

Fields

tool_name: String

error_type: String

duration: Duration

ToolFallbackDetected

A tool fell back to a different implementation or strategy

This is particularly important for detecting cascading delete/recreate sequences as identified in the Codex issue review.

Fields

from_tool: String

The original tool that was attempted

to_tool: String

The fallback tool or strategy used

reason: String

Reason for the fallback

affected_file: Option<String>

Optional file path affected by the fallback

ToolBlocked

A tool operation was blocked by policy

Fields

tool_name: String

policy_reason: String

ToolTimeoutWarning

A tool operation exceeded its timeout threshold

Fields

tool_name: String

elapsed: Duration

ceiling: Duration

percentage: u8

DestructiveOperationWarning

A destructive operation is about to be performed

Fields

tool_name: String

operation_type: String

affected_files: Vec<String>

has_backup: bool

Implementations

impl ToolTelemetryEvent

pub fn edit_to_patch_fallback( file_path: impl Into<String>, reason: impl Into<String>, ) -> Self

Create a tool fallback event for edit_file -> apply_patch transition

pub fn delete_and_recreate_warning( tool_name: impl Into<String>, files: Vec<String>, has_backup: bool, ) -> Self

Create a destructive operation warning for delete-and-recreate patterns

Trait Implementations

impl Clone for ToolTelemetryEvent

fn clone(&self) -> ToolTelemetryEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolTelemetryEvent

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

Formats the value using the given formatter.

impl Eq for ToolTelemetryEvent

impl PartialEq for ToolTelemetryEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ToolTelemetryEvent