deepseek-harness/examples/plan-acp-agent/composition.md

Plan-Mode ACP Agent App Composition

The plan-mode demo composes session modes onto the ACP server: the editor mode picker drives plan mode, and the model exits through the user-reviewed exit_plan_mode tool.

flowchart LR
  cfg["examples/plan-acp-agent<br/>cordis.yml"]
  plugin_plan-acp_llm_deepseek["llm-deepseek<br/>@deepseek-ai/dsh-llm-deepseek"]
  cfg --> plugin_plan-acp_llm_deepseek
  plugin_plan-acp_acp_agent["acp-agent<br/>@deepseek-ai/dsh-acp-demo"]
  cfg --> plugin_plan-acp_acp_agent
  plugin_plan-acp_acp_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-spine-demo"]
  plugin_plan-acp_acp_agent --> bundle_jsonl["@deepseek-ai/dsh-session-persistence-jsonl"]
  plugin_plan-acp_acp_agent --> frontdoor_acp["@deepseek-ai/dsh-acp<br/>JSON-RPC stdio bridge<br/>sessions created by client"]
  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_plan-acp_mode["mode<br/>@deepseek-ai/dsh-mode"]
  cfg --> plugin_plan-acp_mode
  plugin_plan-acp_sandbox["sandbox<br/>@deepseek-ai/dsh-sandbox-local"]
  cfg --> plugin_plan-acp_sandbox
  plugin_plan-acp_sandbox_policy["sandbox-policy<br/>@deepseek-ai/dsh-sandbox-policy"]
  cfg --> plugin_plan-acp_sandbox_policy
  plugin_plan-acp_bash["bash<br/>@deepseek-ai/dsh-bash-sandbox"]
  cfg --> plugin_plan-acp_bash
  plugin_plan-acp_approval["approval<br/>@deepseek-ai/dsh-user-approval"]
  cfg --> plugin_plan-acp_approval
  plugin_plan-acp_permission["permission<br/>@deepseek-ai/dsh-permission"]
  cfg --> plugin_plan-acp_permission
  plugin_plan-acp_tool_ask_user["tool-ask-user<br/>@deepseek-ai/dsh-tool-ask-user"]
  cfg --> plugin_plan-acp_tool_ask_user
  plugin_plan-acp_fs_sandbox["fs-sandbox<br/>@deepseek-ai/dsh-fs-sandbox"]
  cfg --> plugin_plan-acp_fs_sandbox
  plugin_plan-acp_fs_policy["fs-policy<br/>@deepseek-ai/dsh-fs-policy"]
  cfg --> plugin_plan-acp_fs_policy
  plugin_plan-acp_tool_fs["tool-fs<br/>@deepseek-ai/dsh-tool-fs"]
  cfg --> plugin_plan-acp_tool_fs
  plugin_plan-acp_tool_todo["tool-todo<br/>@deepseek-ai/dsh-tool-todo"]
  cfg --> plugin_plan-acp_tool_todo

Plugin id	Package / module
llm-deepseek	@deepseek-ai/dsh-llm-deepseek
acp-agent	@deepseek-ai/dsh-acp-demo
mode	@deepseek-ai/dsh-mode
sandbox	@deepseek-ai/dsh-sandbox-local
sandbox-policy	@deepseek-ai/dsh-sandbox-policy
bash	@deepseek-ai/dsh-bash-sandbox
approval	@deepseek-ai/dsh-user-approval
permission	@deepseek-ai/dsh-permission
tool-ask-user	@deepseek-ai/dsh-tool-ask-user
fs-sandbox	@deepseek-ai/dsh-fs-sandbox
fs-policy	@deepseek-ai/dsh-fs-policy
tool-fs	@deepseek-ai/dsh-tool-fs
tool-todo	@deepseek-ai/dsh-tool-todo

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

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