Struct RepeatToolLimitMiddleware 

pub struct RepeatToolLimitMiddleware { /* private fields */ }

Break poll loops — repeated identical tool calls — hard.

Session 20260914_50cf809d: a root spawned two sub-agents, then polled list_agents 124 times over 15 minutes (57% of wall clock, interleaved with real work) instead of ending its turn to receive the pushed reports. The system prompt forbade polling; the model did it anyway, and no mechanism stopped it. This middleware is that mechanism.

Counting is cumulative per run, not consecutive: the incident’s polls were interleaved with read_file etc., so a consecutive-counter would reset forever and never fire. The fingerprint is tool name + canonical (key-sorted) arguments — a model legitimately reading 51 different files never accumulates a fingerprint.

Two-stage response, mirroring existing middleware precedents:

• at nudge_after (once per fingerprint): follow_up_message nudge (soft, like MaxTurnsNudgeMiddleware);
• at block_after (and every attempt beyond): pending tool_calls are discarded and a follow-up forces a summary (hard, like TurnToolLimitMiddleware).

State is per-session and reset by on_user_message — a run’s counts must not leak into the next run (the middleware instance is process-long in phimint). Clearing all pending calls on block (not just the offending one) follows the TurnToolLimitMiddleware precedent: the breaker only trips after block_after identical calls, so collateral is negligible.

Implementations

impl RepeatToolLimitMiddleware

pub fn new(config: RepeatToolLimitConfig) -> Self

Trait Implementations

impl Middleware for RepeatToolLimitMiddleware

fn on_user_message<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut UserMessageCtx, ) -> Pin<Box<dyn Future<Output = AgentResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn on_post_llm<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut PostLlmCtx, ) -> Pin<Box<dyn Future<Output = AgentResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn on_pre_llm<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut PreLlmCtx, ) -> Pin<Box<dyn Future<Output = AgentResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,