Files
deepseek-harness/examples/cordis-agent/composition.md
T
Tianyi Cui 0d6bfd8856 refactor(process): split the process manager out of the bash executor
New process/ capability family: @deepseek-ai/dsh-process owns ctx.processes —
abstract ProcessManager.spawn(spec) over a fully-explicit ProcessSpawnSpec —
plus the shared DSH_* managed-environment and CollectedOutput vocabulary;
@deepseek-ai/dsh-process-local carries the former bash-local run.ts plumbing
(detached groups, tail-keep spill-backed output, credential scrub, kill
escalation, kill-and-join disposal) with no config of its own.

dsh-bash-local becomes a consumer: it keeps command defaulting, the fused
deadline timedOut/aborted classification, the model-friendly terminal env
(now merged through the ordinary env channel), and the [stderr]-marked
background read merge, and spawns through ctx.processes. Background-process
lifetime moves to the manager, so an executor reload no longer kills live
background work; a background spawn failure is injected once into the read
path instead of being buffered as fake stderr. dsh-bash re-exports the moved
vocabulary so bash consumers keep one import root; dsh-bash-sandbox only
redeclares the inherited inject.

Every composition loading a bash executor now loads dsh-process-local (CLI,
examples, python bundled runtime, create-sdk bash feature, inline test
configs).
2026-07-26 06:59:01 +08:00

2.6 KiB

Cordis Agent App Composition

The self-referential demo puts @deepseek-ai/dsh-tool-cordis on the coding spine, letting the agent inspect its own runtime and mount/unmount plugins into it.

flowchart LR
  cfg["examples/cordis-agent<br/>cordis.yml"]
  plugin_cordis_hmr["hmr<br/>@cordisjs/plugin-hmr"]
  cfg --> plugin_cordis_hmr
  plugin_cordis_llm_deepseek["llm-deepseek<br/>@deepseek-ai/dsh-llm-deepseek"]
  cfg --> plugin_cordis_llm_deepseek
  plugin_cordis_processes["processes<br/>@deepseek-ai/dsh-process-local"]
  cfg --> plugin_cordis_processes
  plugin_cordis_bash["bash<br/>@deepseek-ai/dsh-bash-local"]
  cfg --> plugin_cordis_bash
  plugin_cordis_fs_local["fs-local<br/>@deepseek-ai/dsh-fs-local"]
  cfg --> plugin_cordis_fs_local
  plugin_cordis_web["web<br/>@deepseek-ai/dsh-web"]
  cfg --> plugin_cordis_web
  plugin_cordis_web_fetch_local["web-fetch-local<br/>@deepseek-ai/dsh-web-fetch-local"]
  cfg --> plugin_cordis_web_fetch_local
  plugin_cordis_token_meter["token-meter<br/>@deepseek-ai/dsh-token-meter"]
  cfg --> plugin_cordis_token_meter
  plugin_cordis_tui_agent["tui-agent<br/>@deepseek-ai/dsh-tui-demo"]
  cfg --> plugin_cordis_tui_agent
  plugin_cordis_tui_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-spine-demo"]
  plugin_cordis_tui_agent --> bundle_jsonl["@deepseek-ai/dsh-session-persistence-jsonl"]
  plugin_cordis_tui_agent --> frontdoor_tui["@deepseek-ai/dsh-tui<br/>pre-created main agent"]
  bundle_agent_core --> spine_llm["ctx.llm"]
  bundle_agent_core --> spine_sessions["ctx.sessions"]
  bundle_agent_core --> spine_tools["ctx.tools + tool-bash"]
  bundle_agent_core --> spine_loop["ctx.agents + ctx.agentLoop"]
  plugin_cordis_tool_cordis["tool-cordis<br/>@deepseek-ai/dsh-tool-cordis"]
  cfg --> plugin_cordis_tool_cordis
Plugin id Package / module
hmr @cordisjs/plugin-hmr
llm-deepseek @deepseek-ai/dsh-llm-deepseek
processes @deepseek-ai/dsh-process-local
bash @deepseek-ai/dsh-bash-local
fs-local @deepseek-ai/dsh-fs-local
web @deepseek-ai/dsh-web
web-fetch-local @deepseek-ai/dsh-web-fetch-local
token-meter @deepseek-ai/dsh-token-meter
tui-agent @deepseek-ai/dsh-tui-demo
tool-cordis @deepseek-ai/dsh-tool-cordis

Source config: examples/cordis-agent/cordis.yml.

Maintenance mode: hybrid: the leaf plugin list is parsed from its cordis.yml; app package expansion is curated from package source.