Tianyi Cui 4209e4af3f test(snapshot): use session.jsonl as the only session-log artifact (drop session.golden.jsonl) 3 months ago
..
acp-agent 4209e4af3f test(snapshot): use session.jsonl as the only session-log artifact (drop session.golden.jsonl) 3 months ago
coding-agent d6a2ab30c8 feat(types): brand bash ids + stop brand erosion; extract Branded to dsh-brand 3 months ago
echo-agent 072f97c184 refactor(examples): extract reusable logic into tested packages 3 months ago
AGENTS.md 072f97c184 refactor(examples): extract reusable logic into tested packages 3 months ago
CLAUDE.md 072f97c184 refactor(examples): extract reusable logic into tested packages 3 months ago
README.md dabc2ff411 feat: migrate to pnpm 3 months ago
base-core.yml 679aaacfc4 refactor(examples): DRY the acp-agent configs via base-core.yml + acp-tail.yml 3 months ago
base.yml 679aaacfc4 refactor(examples): DRY the acp-agent configs via base-core.yml + acp-tail.yml 3 months ago

README.md

Examples

Runnable demos (not workspaces) that showcase how the harness is wired.

echo-agent

A mock model + echo tool + stdio UI + JSONL persistence demo. Demonstrates:

  • Loading plugins from a cordis.yml via @cordisjs/plugin-loader + @cordisjs/plugin-include
  • Registering a mock LlmAdapter (streaming scripted responses)
  • Registering a tool via ctx.tools.register()
  • Persisting session events to JSONL via the session/event + session/flush pattern
  • A minimal stdio UI consuming agent/stream-chunk and session events

Run with: pnpm run demo:echo

When prompted, type "echo " to trigger a tool call round-trip.

coding-agent

The real thing: DeepSeek V4 + the bash tool suite + stdio chat + JSONL persistence, wired from cordis.yml. Where echo-agent proves the skeleton with mocks, this is a usable coding assistant.

Run with: pnpm run demo:coding (needs DEEPSEEK_API_KEY in the environment or a gitignored repo-root .env). See coding-agent/README.md for details.