Struct LoopDetector 

pub struct LoopDetector { /* private fields */ }

Tracks repeated tool calls within a time window to detect and throttle agent loops.

Implementations

impl LoopDetector

pub fn new() -> Self

Creates a loop detector with default thresholds.

pub fn with_config(cfg: &LoopDetectionConfig) -> Self

Creates a loop detector with custom thresholds from config. Set blocked_threshold to 0 to disable blocking entirely (LeanCTX philosophy).

pub fn record_call( &mut self, tool: &str, args_fingerprint: &str, ) -> ThrottleResult

Records a tool call and returns the throttle result based on repetition count.

pub fn record_search( &mut self, tool: &str, args_fingerprint: &str, search_pattern: Option<&str>, ) -> ThrottleResult

Record a search-category call and check the cross-tool search group limit. search_pattern is the extracted query/regex the agent is looking for (if available).

pub fn is_search_tool(tool: &str) -> bool

Returns true if the tool name is a known search tool (ctx_search, etc.).

pub fn is_search_shell_command(command: &str) -> bool

Returns true if the shell command starts with a search tool (grep, rg, find, etc.).

pub fn fingerprint(args: &Value) -> String

Computes a deterministic hash fingerprint of JSON tool arguments.

pub fn stats(&self) -> Vec<(String, u32)>

Returns duplicate call entries sorted by count (descending), filtered to count > 1.

pub fn record_read_for_correction( &mut self, path: &str, mode: &str, fresh: bool, )

Records a ctx_read call and detects correction signals:

• fresh=true re-read of a previously cached file
• Mode bounce: map/signatures followed by full within 30s

pub fn record_shell_for_correction(&mut self, command: &str)

Records a ctx_shell command and detects re-runs of the same command within 60s.

pub fn correction_count(&self) -> u32

Returns the number of correction signals in the sliding window.

pub fn correction_rate(&self) -> f64

Returns the correction rate: signals per minute within the window.

pub fn prune_corrections(&mut self)

Prunes expired correction signals and stale read/command entries.

pub fn reset(&mut self)

Clears all tracking state (call history, search patterns, counters).

Trait Implementations

impl Clone for LoopDetector

fn clone(&self) -> LoopDetector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoopDetector

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

Formats the value using the given formatter.

impl Default for LoopDetector

fn default() -> Self

Returns the “default value” for a type.