Struct FilterStats 

pub struct FilterStats {
    pub raw_chars: usize,
    pub filtered_chars: usize,
    pub raw_lines: usize,
    pub filtered_lines: usize,
    pub confidence: Option<FilterConfidence>,
    pub command: Option<String>,
    pub kept_lines: Vec<usize>,
}

Cumulative filter statistics for a single tool execution.

Populated by ShellExecutor when output filters are configured. Displayed in the TUI to show how much output was compacted before being sent to the LLM.

Fields

raw_chars: usize

Raw character count before filtering.

filtered_chars: usize

Character count after filtering.

raw_lines: usize

Raw line count before filtering.

filtered_lines: usize

Line count after filtering.

confidence: Option<FilterConfidence>

Worst-case confidence across all applied filters.

command: Option<String>

The shell command that produced this output, for display purposes.

kept_lines: Vec<usize>

Zero-based line indices that were kept after filtering.

Implementations

impl FilterStats

pub fn savings_pct(&self) -> f64

Returns the percentage of characters removed by filtering.

Returns 0.0 when there was no raw output to filter.

pub fn estimated_tokens_saved(&self) -> usize

Estimates the number of LLM tokens saved by filtering.

Uses the 4-chars-per-token approximation. Suitable for logging and metrics, not for billing or exact budget calculations.

pub fn format_inline(&self, tool_name: &str) -> String

Formats a one-line filter summary for log messages and TUI status.

Example

use zeph_tools::FilterStats;

let stats = FilterStats {
    raw_chars: 1000,
    filtered_chars: 400,
    raw_lines: 50,
    filtered_lines: 20,
    command: Some("cargo build".to_owned()),
    ..Default::default()
};
let summary = stats.format_inline("shell");
assert!(summary.contains("60.0% filtered"));

Trait Implementations

impl Clone for FilterStats

fn clone(&self) -> FilterStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilterStats

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

Formats the value using the given formatter.

impl Default for FilterStats

fn default() -> FilterStats

Returns the “default value” for a type.