dsh-plugin-structured-output

opencode-style json_schema structured output for dsh agents, built entirely on native dsh seams (no dsh source changes):

• visibility is per agent preset (mode) and is opt-in: Settings → 结构化输出工具 / Structured output chooses which modes expose it;
• in enabled modes, /json-schema <json> stores an object-rooted JSON Schema for the receiving session and the StructuredOutput tool is registered;
• the next prompt receives opencode's instruction to return the final answer through StructuredOutput instead of plain text;
• the tool validates the output with the native dsh JSON Schema subset (@deepseek-ai/dsh-tools) and rejects malformed values.

Install

lib/ is generated locally and is not committed. install.py always builds the repository's own toolchain first (npm install when the toolchain is missing, then npm run build) and only reports an error when npm itself is missing.

Install/uninstall idempotently with the bundled script (stdlib-only Python). The package ships its own cordis.patch.yml (id structured-output) and declares dsh.bundle.patch, so the script only links the package into the profile node_modules, adds the link: dependency, and appends the package to dsh.profile.bundles. The profile's own cordis.patch.yml is never modified:

python3 install.py install --profile web          # install
python3 install.py uninstall --profile web        # remove
python3 install.py install --profile web --home "$DSH_HOME"   # explicit home

Manual alternative:

dsh plugin --profile web add link:/path/to/dsh-plugin-structured-output

dsh plugin reconciles dsh.profile.bundles from the installed package's dsh.bundle declaration, so no profile patch edit is needed either.

Per-mode visibility

No mode is enabled by default. After installing, open Settings → 结构化输出工具 (Structured output) and toggle the agent presets that should see StructuredOutput and /json-schema. Disabled modes see neither surface; the choice applies to sessions created after the change.

Usage

/json-schema {"type":"object","properties":{"answer":{"type":"string"}},"required":["answer"],"additionalProperties":false}
What is the answer to life, the universe, and everything?

The model must then call StructuredOutput with a valid object.

Supported schemas follow dsh's enforced JSON Schema subset: any JSON root, object properties/required/boolean additionalProperties, array items, scalar enum/const, and exact-one oneOf. Unsupported keywords are rejected at /json-schema time.