dsh-plugin-structured-output

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