shlouai/dsh-debate

dsh-debate is a DSH-native debate plugin for DeepSeek Harness, distributed as an npm bundle named @shlouai/dsh-debate and installed into a dsh profile without modifying the harness installation or its checkout. It exposes exactly three tools that split a formal argument across several model turns: debate_open fixes the motion and round count and returns a debate_id; debate_round spends precisely one round by spawning two fresh, isolated FOR and AGAINST subagents that never see the judging conversation or each other's personas; and debate_verdict is the main agent's single ruling pass, returning a round-by-round review and the winner as pro, con, or draw.

The typical workflow is asking a judgment-prone question such as "should we adopt framework X" or "is this contract clause safe to sign", watching two adversarial children research the workspace and the web, read each other's speeches, and rebut with citations, and finally receiving the judge's reasoning alongside the full transcript. The whole debate is projected into one folded Chat card in the DSH Web UI that fills in round by round, with built-in zh and en dictionaries, and the card survives a page reload because the plugin records its state inside the meta of ordinary tool/result events rather than declaring a custom session event type.

Dependencies are Node ^22.19 || >=24, strict TypeScript, and pnpm; the build runs against a deepseek-harness checkout, so contributors need that source tree locally. Debaters are restricted by tools.restrict() to a read-only allow list that includes read, glob, grep, web_search, and web_fetch, so they cannot write files or run commands; missing or unauthenticated tools degrade by being dropped once and logged. maxRounds defaults to 8 with two to three rounds recommended, the live debate is process-local and cannot be shared across sessions, and version 0.1.0 is explicitly experimental with the tool surface and config schema still subject to change.