@royenheart/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.
