deepseek-harness/packages/bundle/README.md

bundle/ — profile plugin bundles

English | 中文

Profile bundles: npm packages whose manifest declares "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }, making them installable patch layers for dsh --profile compositions (profile contract). A bundle's substance is its patch list; some also ship runtime glue plugins their patch mounts.

The manifest declaration, not this directory, defines Bundle identity. Domain packages can carry their own optional Profile layer; the Codex and Claude Code subagent packages are directly installable examples.

Package	Role	ctx key
base/	The shared dsh core every profile applies first	— (patch only)
web-app/	Browser surface: web patch layer + runtime glue plugin	mounts rows
headless/	Direct one-shot task mode over base, with no Host or Web layer	mounts headless-runner

In-box bundles resolve from the dsh installation; out-of-tree bundles install into a profile through dsh plugin --profile <name> add <package>.