Tianyi Cui
2faeabb05a
Name the runnable leaf for the line-oriented front door it owns, matching the existing tui-agent and acp-agent organization. Move the complete config, Code Mode overlay, tests, metadata, and generated composition graph together, then update every loader path and repository reference. Keep the shared model identity independent of its terminal front door by phrasing the persona as a coding-agent role rather than retaining the retired leaf name. Regenerate graph and tool catalogs and re-record each affected bilingual pair so derived documentation cannot point at the removed path.
2.3 KiB
echo-agent
Runnable demo: stdin chat with a scripted mock model and an echo tool. The all-mock skeleton — "swap the backend, keep the app".
What it shows
This example is just a leaf cordis.yml: it loads the @deepseek-ai/dsh-stdio-demo app (which bundles the whole @deepseek-ai/dsh-agent-spine-demo spine, JSONL persistence, the TTY-selected dsh-tui/dsh-stdio front doors, and a pre-created main agent), and swaps in two example-local backends plus hmr:
mock-llm.ts— a mockLlmAdapterthat streams scripted responses and calls theechotool when the user types "echo ". Registered withctx.llm.registerAdapter(['mock-echo'], …).echo-tool.ts— a tool registered viactx.tools.register(defineTool(…))with typedexecuteargs; echoes text back uppercased.
Swapping mock-llm for the real llm-deepseek adapter is all that separates this from repl-agent — the same app, a different backend.
Plugin files
| File | Role | Key patterns demonstrated |
|---|---|---|
src/mock-llm.ts |
LlmAdapter registration |
ctx.llm.registerAdapter(['mock-echo'], …), streaming chunks with the proper block-start/block-end protocol |
src/echo-tool.ts |
Tool registration | ctx.tools.register(defineTool(…)) with typed execute args, returning ContentBlock[] |
cordis.yml |
Leaf wiring | the two backends + hmr + one @deepseek-ai/dsh-stdio-demo entry carrying the app config |
The spine, UI, persistence, and boot glue all live in @deepseek-ai/dsh-stdio-demo and the bundle it loads — this folder holds only the demo-specific mocks and the leaf wiring.
Run
pnpm run demo:echo
# or:
node --expose-internals --import tsx packages/examples/stdio-demo/src/bin.ts examples/echo-agent/cordis.yml
Type a message and press Enter. "echo " triggers a tool call round-trip (the mock model requests the echo tool, which echoes the text uppercased, and the next model step acknowledges it).
The session is persisted under .sessions/ relative to the directory you launch the demo from. pnpm run demo:echo runs from the repo root, so the logs land in <repo-root>/.sessions/cwd-<hash>/ (one .jsonl log per session). Clean up with: rm -rf .sessions