mirror of https://github.com/deepseek-ai/deepseek-harness.git synced 2026-08-29 04:26:38 +00:00

T

Tianyi Cui e98c1c5d42 Add examples/coding-agent and the docs cookbook

The first real agent wiring: DeepSeek V4 + the bash tool suite + stdio
chat + JSONL persistence, runnable via yarn demo:coding (reads the
gitignored repo-root .env through process.loadEnvFile).

- examples/coding-agent: cordis.yml wiring both real plugin families
  (llm-deepseek with !!js env secrets; bash-local + tool-bash), a
  bash-only coding system prompt, a max-steps-guard plugin (bounds
  runaway turns via the agent/turn-continuation waterfall — abort()
  from step-end is a no-op by then), and a stdio UI with dimmed
  reasoning and exit-on-idle for piped stdin.
- e2e (yarn test:e2e, key-gated): full-loop.e2e.ts runs a real model
  against the real bash tool; coding-task.e2e.ts is the swebench-style
  smoke — the model fixes a buggy add.js in a temp dir and the test
  re-runs node add.test.js itself rather than trusting the agent.
- docs/cookbook: adding-a-package (the verified checklist),
  adding-a-tool (execute() contract, background pattern, seams),
  adding-an-llm-adapter (protocol obligations, mock-server testing,
  e2e policy). AGENTS.md layout/commands/secrets sections updated;
  architecture.md points at both examples and the cookbook.
- vitest.e2e.config.ts: serialize test files + retry twice — parallel
  e2e files trip the shared internal key's concurrency quota.
- fix: the !js YAML tag spelling in docs/JSDoc is actually !!js
  (js-yaml resolves custom tags under tag:yaml.org,2002:js).

2026-06-13 18:30:50 +08:00

.github/workflows

Fix CI: order steps by artifact dependency, resolve fresh-clone builds

2026-06-11 23:10:43 +08:00

docs

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

examples

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

packages

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

scripts

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

vendor

Replace dumble with tsdown for JS bundling

2026-06-11 22:34:43 +08:00

.gitignore

Add bash execution: dsh-bash seam, dsh-bash-local impl, dsh-tool-bash tools

2026-06-13 18:28:10 +08:00

.yarnrc.yml

Set up monorepo infra: Yarn 4 workspaces, tsc -b + dumble build, vitest

2026-06-11 10:52:45 +08:00

AGENTS.md

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

CLAUDE.md

Initialize repo with README, AGENTS.md, and CLAUDE.md symlink

2026-06-10 22:58:56 +08:00

eslint.config.mjs

Replace dumble with tsdown for JS bundling

2026-06-11 22:34:43 +08:00

knip.json

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

lefthook.yml

Add lefthook git hooks with a vendor-manifest guard

2026-06-11 15:07:55 +08:00

LICENSE

Initialize repo with README, AGENTS.md, and CLAUDE.md symlink

2026-06-10 22:58:56 +08:00

package.json

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

README.md

Document the codebase thoroughly and tighten type safety

2026-06-11 13:01:00 +08:00

tsconfig.base.json

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

tsconfig.build.json

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

tsconfig.json

Fix CI: order steps by artifact dependency, resolve fresh-clone builds

2026-06-11 23:10:43 +08:00

tsconfig.test.json

Set up monorepo infra: Yarn 4 workspaces, tsc -b + dumble build, vitest

2026-06-11 10:52:45 +08:00

tsconfig.typecheck.json

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

tsdown.config.ts

Replace dumble with tsdown for JS bundling

2026-06-11 22:34:43 +08:00

vitest.config.ts

Document why vite-tsconfig-paths can't be replaced by resolve.tsconfigPaths

2026-06-11 23:24:41 +08:00

vitest.e2e.config.ts

Add examples/coding-agent and the docs cookbook

2026-06-13 18:30:50 +08:00

yarn.config.cjs

Add repo hygiene gates: knip, publint, yarn constraints

2026-06-11 15:04:50 +08:00

yarn.lock

Add two DeepSeek LLM adapters: dsh-llm-deepseek and dsh-llm-pi-ai

2026-06-13 18:30:03 +08:00

README.md

DeepSeek Harness

Monorepo for the DeepSeek Harness group.

Projects

DeepSeek Code — DeepSeek's coding agent product.

Development

This monorepo is built on the Cordis framework (vendored as source under vendor/), microkernel-style: everything is a plugin.

yarn install
yarn test        # vitest
yarn demo        # runnable echo-agent example

For agent instructions see AGENTS.md. For the architecture design see docs/architecture.md. Each subdirectory has its own README.md with local context: packages/, vendor/.