kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
deepseek-harness/examples
History
Tianyi Cui 605587e79c docs(rfc): classify RFCs by kind via path-encoded subdirectories 
Add a second axis to every RFC — its class (feature, bug-fix,
simplification, architecture, process, testing) — encoded in the path
as docs/rfc/{lifecycle}/{class}/file.md. The folder is the label, so
the closed set is enforced by structure rather than a parsed field.

Two new doc-sync gates back it:
- verify-rfc-classification: every RFC sits in a valid class folder and
  the README index lists it under the matching lifecycle→class heading.
- verify-doc-refs: every docs/*.md path cited in a packages|examples TS
  comment resolves — closes a drift class verify-md-links can't see, and
  catches the four comment refs this reorg moved.

The README gains a Classification section explaining the taxonomy and
per-class index sub-sections. A self-referential process RFC records why
the scheme is path-encoded and gated.
2026-06-20 22:29:45 +08:00
..
acp-agent docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
coding-agent feat(acp): dispose each session's agent on disconnect/teardown 2026-06-20 06:44:58 +08:00
echo-agent refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
AGENTS.md refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
base-core.yml refactor(examples): DRY the acp-agent configs via base-core.yml + acp-tail.yml 2026-06-19 09:41:10 +08:00
base.yml refactor(examples): DRY the acp-agent configs via base-core.yml + acp-tail.yml 2026-06-19 09:41:10 +08:00
CLAUDE.md refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
README.md feat: migrate to pnpm 2026-06-16 14:55:37 +08:00

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.