Struct LoopGuard 

pub struct LoopGuard { /* private fields */ }

Prevents runaway agent loops (Jidoka pattern).

Implementations

impl LoopGuard

pub fn new(max_iterations: u32, max_tool_calls: u32, max_cost_usd: f64) -> Self

Create a new guard from resource quotas.

pub fn with_token_budget(self, budget: Option<u64>) -> Self

Set the token budget (input+output cumulative limit).

pub fn check_iteration(&mut self) -> LoopVerdict

Check if another iteration is allowed.

pub fn check_tool_call(&mut self, tool_name: &str, input: &Value) -> LoopVerdict

Check if a tool call is allowed (ping-pong detection).

pub fn record_max_tokens(&mut self) -> LoopVerdict

Record a MaxTokens stop reason. Returns CircuitBreak if consecutive truncations exceed threshold.

pub fn reset_max_tokens(&mut self)

Reset consecutive MaxTokens counter (on EndTurn or ToolUse).

pub fn record_usage(&mut self, usage: &TokenUsage) -> LoopVerdict

Record token usage from a completion. Returns verdict based on token budget (if configured).

pub fn record_cost(&mut self, cost_usd: f64) -> LoopVerdict

Record estimated cost and check budget.

pub fn usage(&self) -> &TokenUsage

Get accumulated usage.

pub fn current_iteration(&self) -> u32

Get current iteration count.

pub fn total_tool_calls(&self) -> u32

Get total tool calls made.