dsh-event-auditor

Writing plugins for DeepSeek Harness revolves around its event stream: agent lifecycle, session flow, tool invocation, subagent dispatch, config changes, and waterfall pass-through nodes like tools/execute, approval/request, and llm/stream. Yet these events are scattered across the source code, and there is no single pane of glass to observe them in one place. dsh-event-auditor aggregates 22 harness emit events and 10 waterfall events into a client-side panel, showing real-time counts grouped by event name and dispatch pattern, a ring buffer of the last 500 raw entries, and a JSON API that supports incremental polling via a since parameter so you can both spot trends at a glance and programmatically retrieve details.

Beyond passive observation, it offers per-group toggles (agent, session, tools, subagent, config, waterfall—config is off by default to cut noise), a settings panel with hot-reload via installSettingsSection so you can flip groups without restarting, and a headless dump mode where setting DSH_EVENT_AUDIT_DUMP exports a full event snapshot in one shot, handy for CI pipelines or remote containers where a browser is not available.

It is built for engineers developing or debugging Harness plugins: when a tool call seems to skip tools/execute, when subagent session lifecycles do not match expectations, or when a config hot-update changes dispatch patterns, the /audit panel gives you an immediate, code-free answer instead of hunting through source for every emit site.