# Headless Agent App Composition
The headless demo combines the real DeepSeek adapter and coding capabilities with the one-shot app package, format-pure stdout, and one fresh persisted top-level session.
```mermaid
flowchart LR
cfg["examples/headless-agent
cordis.yml"]
plugin_headless_settings["settings
@deepseek-ai/dsh-settings-local"]
cfg --> plugin_headless_settings
plugin_headless_credentials["credentials
@deepseek-ai/dsh-credentials-local"]
cfg --> plugin_headless_credentials
plugin_headless_llm_deepseek["llm-deepseek
@deepseek-ai/dsh-llm-deepseek"]
cfg --> plugin_headless_llm_deepseek
plugin_headless_subprocess["subprocess
@deepseek-ai/dsh-subprocess-local"]
cfg --> plugin_headless_subprocess
plugin_headless_bash["bash
@deepseek-ai/dsh-bash-local"]
cfg --> plugin_headless_bash
plugin_headless_cli_agent["cli-agent
@deepseek-ai/dsh-cli-demo"]
cfg --> plugin_headless_cli_agent
plugin_headless_cli_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-spine-demo"]
plugin_headless_cli_agent --> bundle_jsonl["@deepseek-ai/dsh-session-persistence-jsonl"]
plugin_headless_cli_agent --> frontdoor_cli["one-shot driver
format-pure stdout
fresh top-level 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_headless_token_meter["token-meter
@deepseek-ai/dsh-token-meter"]
cfg --> plugin_headless_token_meter
plugin_headless_compact_basic["compact-basic
@deepseek-ai/dsh-compact-basic"]
cfg --> plugin_headless_compact_basic
plugin_headless_subagent["subagent
@deepseek-ai/dsh-subagent"]
cfg --> plugin_headless_subagent
plugin_headless_subagent_spawn["subagent-spawn
@deepseek-ai/dsh-subagent-spawn"]
cfg --> plugin_headless_subagent_spawn
plugin_headless_subagent_fork["subagent-fork
@deepseek-ai/dsh-subagent-fork"]
cfg --> plugin_headless_subagent_fork
plugin_headless_tool_subagent_control["tool-subagent-control
@deepseek-ai/dsh-tool-subagent-control"]
cfg --> plugin_headless_tool_subagent_control
plugin_headless_tool_subagent_report["tool-subagent-report
@deepseek-ai/dsh-tool-subagent-report"]
cfg --> plugin_headless_tool_subagent_report
plugin_headless_tool_subagent["tool-subagent
@deepseek-ai/dsh-tool-subagent"]
cfg --> plugin_headless_tool_subagent
plugin_headless_tool_subagent_fork["tool-subagent-fork
@deepseek-ai/dsh-tool-subagent"]
cfg --> plugin_headless_tool_subagent_fork
plugin_headless_workflow_workerthread["workflow-workerthread
@deepseek-ai/dsh-workflow-workerthread"]
cfg --> plugin_headless_workflow_workerthread
plugin_headless_tool_workflow["tool-workflow
@deepseek-ai/dsh-tool-workflow"]
cfg --> plugin_headless_tool_workflow
plugin_headless_tool_ralph["tool-ralph
@deepseek-ai/dsh-tool-ralph"]
cfg --> plugin_headless_tool_ralph
plugin_headless_tool_todo["tool-todo
@deepseek-ai/dsh-tool-todo"]
cfg --> plugin_headless_tool_todo
plugin_headless_fs_local["fs-local
@deepseek-ai/dsh-fs-local"]
cfg --> plugin_headless_fs_local
plugin_headless_fs_policy["fs-policy
@deepseek-ai/dsh-fs-policy"]
cfg --> plugin_headless_fs_policy
plugin_headless_tool_fs["tool-fs
@deepseek-ai/dsh-tool-fs"]
cfg --> plugin_headless_tool_fs
```
| Plugin id | Package / module |
| --- | --- |
| `settings` | `@deepseek-ai/dsh-settings-local` |
| `credentials` | `@deepseek-ai/dsh-credentials-local` |
| `llm-deepseek` | `@deepseek-ai/dsh-llm-deepseek` |
| `subprocess` | `@deepseek-ai/dsh-subprocess-local` |
| `bash` | `@deepseek-ai/dsh-bash-local` |
| `cli-agent` | `@deepseek-ai/dsh-cli-demo` |
| `token-meter` | `@deepseek-ai/dsh-token-meter` |
| `compact-basic` | `@deepseek-ai/dsh-compact-basic` |
| `subagent` | `@deepseek-ai/dsh-subagent` |
| `subagent-spawn` | `@deepseek-ai/dsh-subagent-spawn` |
| `subagent-fork` | `@deepseek-ai/dsh-subagent-fork` |
| `tool-subagent-control` | `@deepseek-ai/dsh-tool-subagent-control` |
| `tool-subagent-report` | `@deepseek-ai/dsh-tool-subagent-report` |
| `tool-subagent` | `@deepseek-ai/dsh-tool-subagent` |
| `tool-subagent-fork` | `@deepseek-ai/dsh-tool-subagent` |
| `workflow-workerthread` | `@deepseek-ai/dsh-workflow-workerthread` |
| `tool-workflow` | `@deepseek-ai/dsh-tool-workflow` |
| `tool-ralph` | `@deepseek-ai/dsh-tool-ralph` |
| `tool-todo` | `@deepseek-ai/dsh-tool-todo` |
| `fs-local` | `@deepseek-ai/dsh-fs-local` |
| `fs-policy` | `@deepseek-ai/dsh-fs-policy` |
| `tool-fs` | `@deepseek-ai/dsh-tool-fs` |
Source config: [`examples/headless-agent/cordis.yml`](cordis.yml).
Maintenance mode: hybrid: the leaf plugin list is parsed from its `cordis.yml`; app package expansion is curated from package source.