Yichen Jiang
b6f6c58435
# Conflicts: # .agents/notes/implemented/architecture/2026-07-10-after-call-compaction-pressure-and-overflow-recovery.i18n.yaml # .agents/notes/implemented/architecture/2026-07-10-after-call-compaction-pressure-and-overflow-recovery.md # .agents/notes/implemented/architecture/2026-07-10-after-call-compaction-pressure-and-overflow-recovery.zh.md # docs/cordis-catalog/events.md # docs/cordis-catalog/services.md # docs/event-producer-consumer.md # examples/headless-agent/tests/harness.ts # examples/repl-agent/cordis.yml # packages/compact/compact-basic/README.md # packages/compact/compact-basic/src/index.ts # packages/compact/compact-basic/tests/compact-basic.spec.ts # packages/compact/compact-basic/tests/loader-composition.spec.ts # packages/cordis/tool-cordis/src/api-catalog.ts # packages/llm/README.md # packages/llm/llm-deepseek/src/adapter.ts # packages/llm/llm-pi-ai/src/adapter.ts # packages/llm/llm/README.md # packages/llm/llm/src/index.ts # scripts/gen-cordis-catalog.ts # website/zh-CN/api/harness/events.md # website/zh-CN/api/harness/llm.md # website/zh-CN/api/harness/token-meter.md # website/zh-CN/guide/config.md
77 lines
3.9 KiB
Markdown
77 lines
3.9 KiB
Markdown
<!-- Generated by scripts/gen-doc-graphs.ts - do not edit by hand.
|
|
Run `pnpm run gen-doc-graphs` to regenerate. -->
|
|
|
|
# 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<br/>cordis.yml"]
|
|
plugin_headless_llm_deepseek["llm-deepseek<br/>@deepseek-ai/dsh-llm-deepseek"]
|
|
cfg --> plugin_headless_llm_deepseek
|
|
plugin_headless_bash["bash<br/>@deepseek-ai/dsh-bash-local"]
|
|
cfg --> plugin_headless_bash
|
|
plugin_headless_cli_agent["cli-agent<br/>@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<br/>format-pure stdout<br/>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<br/>@deepseek-ai/dsh-token-meter"]
|
|
cfg --> plugin_headless_token_meter
|
|
plugin_headless_compact_basic["compact-basic<br/>@deepseek-ai/dsh-compact-basic"]
|
|
cfg --> plugin_headless_compact_basic
|
|
plugin_headless_subagent["subagent<br/>@deepseek-ai/dsh-subagent"]
|
|
cfg --> plugin_headless_subagent
|
|
plugin_headless_subagent_spawn["subagent-spawn<br/>@deepseek-ai/dsh-subagent-spawn"]
|
|
cfg --> plugin_headless_subagent_spawn
|
|
plugin_headless_subagent_fork["subagent-fork<br/>@deepseek-ai/dsh-subagent-fork"]
|
|
cfg --> plugin_headless_subagent_fork
|
|
plugin_headless_tool_subagent["tool-subagent<br/>@deepseek-ai/dsh-tool-subagent"]
|
|
cfg --> plugin_headless_tool_subagent
|
|
plugin_headless_tool_subagent_fork["tool-subagent-fork<br/>@deepseek-ai/dsh-tool-subagent"]
|
|
cfg --> plugin_headless_tool_subagent_fork
|
|
plugin_headless_workflow_workerthread["workflow-workerthread<br/>@deepseek-ai/dsh-workflow-workerthread"]
|
|
cfg --> plugin_headless_workflow_workerthread
|
|
plugin_headless_tool_workflow["tool-workflow<br/>@deepseek-ai/dsh-tool-workflow"]
|
|
cfg --> plugin_headless_tool_workflow
|
|
plugin_headless_tool_ralph["tool-ralph<br/>@deepseek-ai/dsh-tool-ralph"]
|
|
cfg --> plugin_headless_tool_ralph
|
|
plugin_headless_tool_todo["tool-todo<br/>@deepseek-ai/dsh-tool-todo"]
|
|
cfg --> plugin_headless_tool_todo
|
|
plugin_headless_fs_local["fs-local<br/>@deepseek-ai/dsh-fs-local"]
|
|
cfg --> plugin_headless_fs_local
|
|
plugin_headless_fs_policy["fs-policy<br/>@deepseek-ai/dsh-fs-policy"]
|
|
cfg --> plugin_headless_fs_policy
|
|
plugin_headless_tool_fs["tool-fs<br/>@deepseek-ai/dsh-tool-fs"]
|
|
cfg --> plugin_headless_tool_fs
|
|
```
|
|
|
|
| Plugin id | Package / module |
|
|
| --- | --- |
|
|
| `llm-deepseek` | `@deepseek-ai/dsh-llm-deepseek` |
|
|
| `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` | `@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.
|