editing-cordis-compositions

Editing Cordis compositions

Agent presets are ordinary @deepseek-ai/dsh-agent-preset declarations carried by bundle patches. Nothing edits a declaration in place: a preset is created or changed by installing a bundle whose patch declares or overrides it. This file states the declaration format; when it leaves a question open, read the @deepseek-ai/dsh-agent-preset README and lib/types declarations under the packageDir that cordis_inspect_query Config.listConfigs returns when queried with a preset-<id> row's entry id, or packages/preset/agent-preset/src in a source checkout.

Where declarations live

The shipped Web presets are presets/<id>.patch.yml files of the @deepseek-ai/dsh-web-app bundle, ids standard, ptc, minimal and cordis. Installed, the bundle resolves from the dsh installation, not the profile; querying Config.listConfigs with the entry id of any preset-<id> row it declares returns that packageDir. In a source checkout of DSH it is packages/bundle/web-app/. Read one file with the file-read tool when you need a template; minimal.patch.yml is the shortest. In Desktop the bundle sits inside app.asar, which shell commands cannot open. Load cordis-composition-reference for the patch dialect and the list of plugin packages a preset can mount.

A declaration row has these config fields: id (required, lowercase letters, digits and hyphens), plugins (required Cordis entry list), and optional name, description and order (roster position). The Loader row id is preset-<id> by convention.

Create a preset

Write a bundle directory in the workspace with exactly two files, then install it.

review-preset/package.json:

{
  "name": "@local/dsh-review-preset",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
}

review-preset/cordis.patch.yml:

- insert:
    - id: preset-review
      name: '@deepseek-ai/dsh-agent-preset'
      config:
        id: review
        name: Review
        description: Reviews changes with the shell only.
        order: 10
        plugins:
          - id: persona
            name: '@deepseek-ai/dsh-persona'
            config:
              prefix: You review software changes.
          - id: tool-bash
            name: '@deepseek-ai/dsh-tool-bash'