Files
deepseek-harness/examples/cordis-agent/composition.md
T
imccyu e51e58e993 chore: register the cordis group across repo gates and docs
Everything outside the package and example that a new top-level group and a
new demo touch: GROUP_ORDER in gen-module-graph and gen-doc-graphs (plus the
tools-service consumers list, the APP_EXAMPLES entry, and the graph-atlas
label/mode rows), the knip e2e entries, the packages/README group row, the
AGENTS.md layout and demo lines, and the regenerated module-graph /
config-catalog / graph-atlas / capability-seams / composition artifacts.
AGENTS.md and examples/AGENTS.md word-budget ceilings rise to current+5%
(1802 / 653): the new group and demo rows are genuine additions to both docs,
not condensable restatements.
2026-07-09 13:57:03 +08:00

1.8 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_bash["bash<br/>@deepseek-ai/dsh-bash-local"]
  cfg --> plugin_cordis_bash
  plugin_cordis_stdio_agent["stdio-agent<br/>@deepseek-ai/dsh-stdio-agent"]
  cfg --> plugin_cordis_stdio_agent
  plugin_cordis_stdio_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-core"]
  plugin_cordis_stdio_agent --> bundle_jsonl["@deepseek-ai/dsh-session-persistence-jsonl"]
  plugin_cordis_stdio_agent --> frontdoor_stdio["readline UI<br/>console logger<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
bash @deepseek-ai/dsh-bash-local
stdio-agent @deepseek-ai/dsh-stdio-agent
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.