MathieuPortmann/dsh-agent-flight-recorder
Live loop detection for DSH agents: warns the model and shows you error rate, repetition and a loop-risk estimate while a turn runs.
Watches tool calls as they happen and reports when an agent is going in circles. Its rules look for the same tool called repeatedly in a row even with slightly different arguments (which defeats identical-call detectors), the same error coming back, and a high error rate. It gives the model a runtime_health tool to call when it suspects it is stuck — call counts, error rate, average latency, most used tool, a healthy/warning/critical status, a 0-to-1 loop-risk estimate, the reasons and a recommendation — a roughly 40-token notice appended to a tool result when a threshold is crossed, and a roughly 20-token per-turn summary. For you it adds a runtime-health chip under the composer that opens a panel, a one-line summary under every completed turn, and a per-conversation report with tokens, tool usage and points to verify such as a file written to an unexpected path or sources cited without any search.
Install
dsh plugin --profile web add github:MathieuPortmann/dsh-agent-flight-recorderThe README's GitHub line. Its npm alternative, dsh-agent-flight-recorder, returns 404 from the registry today, so the GitHub form above is the one that resolves. Restart the profile afterwards. Configuration is the agent-flight-recorder row in the profile's cordis.patch.yml and every key is optional. An optional companion recorder, @beibeihk/dsh-agent-observability, is mentioned as useful but is not a dependency.
Compatibility
Node >= 22.6 and DSH 0.2.x, with best-effort maintenance as stated by the author. It only observes and annotates: no network, no shell, no file writes, no blocking. All state is derived from the durable session log, so it survives page reloads and disappears when the plugin is removed. Defaults are a 100-call window, 4 consecutive same-tool calls for a warning and 6 for critical, 2 and 3 repeats of the same normalised error, and error rates of 0.2 and 0.3 after at least 10 calls.
Details
- Repo: MathieuPortmann/dsh-agent-flight-recorder
- Category: Agent Capabilities
- Stars: 0
- Version: not published to npm (registry 404); installs from the GitHub default branch
Alternatives
MiloMMIN/dsh-agent-board · mirelconstantin/dsh-subagents-model · CH4ACKO3/dsh-agent-fleet