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.
Install
dsh plugin --profile web add dsh-tool-governorCopied 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
- Repo: George-Java/dsh-tool-governor
- Category: Tools & Capabilities
- Stars: 0
- Version: 0 stars, JavaScript, MIT, created 2026-10-17; install source is npm (dsh-tool-governor, latest 1.0.1, registry repository field resolves back to this repo, with dsh-tool-governor@1.0.1 and the github: form documented as alternates); English README, no translation.
- Last push: 2026-10-17
- First seen: 2026-10-17
Alternatives
lilyco-42/dsh-tool-nu · NEAZ71eve/dsh-tool-github · vibeinging/dsh-tool-search