George-Java/dsh-tool-governor

Guards a DSH turn against runaway tool use: a repeat-call breaker, per-turn call and step budgets, a consecutive-failure cutoff, and a monotonic guard that stops downstream layers from re-allowing a denied call.

Guards a DSH turn against runaway tool use through four mechanisms the README names: a repeat-call breaker that denies the same tool plus argument combination after repeatThreshold repeats (default 2), a per-turn budget fuse capping maxToolCallsPerTurn (default 24) and maxStepsPerTurn (default 16), a failure-loop cutoff that pauses a tool after consecutiveFailureThreshold consecutive failures (default 2), and a monotonic ctx.tools.guard that makes earlier denials final so downstream layers cannot re-allow a blocked call. Two more fields exist: denyTools, a list of glob patterns such as ["browser_*"] always denied, and denyMessage, the text injected on denial. All fields are optional and overridden per profile through a cordis.patch.yml row with id: dsh-tool-governor, for example maxToolCallsPerTurn: 12 and repeatThreshold: 1. Ledgers are kept per agent and per turn, keyed by agent id and turn number, with counts taken in tools/post-execute; uninstall is dsh plugin --profile web remove dsh-tool-governor.

Tools & Capabilities ★ 0 updated 2026-10-17
View on GitHub ↗

Install

dsh plugin --profile web add dsh-tool-governor

Copied verbatim from the README's "Install" fenced block, the first of its three commands. package dsh-tool-governor, registry latest 1.0.1, repository field resolving back to github.com/George-Java/dsh-tool-governor — the same 1.0.1 the README's pin example uses.

Compatibility

Declares DSH 0.2.x (tested on 0.2.1-rc.2) on Windows, macOS and Linux with Node ^22.19.0 || >=24.0.0, and the install section says to restart DSH afterwards, offering dsh --profile web --dump-config | findstr dsh-tool-governor to confirm the bundle registered. It hooks tools/pre-execute, tools/post-execute, ctx.tools.guard and agent/pre-step at the profile root, so it needs only the global tools service, and it falls back to agent.currentTurn on 0.1.x. A new turn starts a fresh budget.

Details

Alternatives

lilyco-42/dsh-tool-nu · NEAZ71eve/dsh-tool-github · vibeinging/dsh-tool-search

More plugins in Tools & Capabilities

Browse more in Tools & Capabilities

Guides for Tools & Capabilities plugins