mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Tianyi Cui 34aabc4183 test(sdk): snapshot suite over the SDK path; docs for the SDK stack

- examples/jsonrpc-agent gains its first snapshot suite (sdk.snapshot.ts):
  the real dsh-jsonrpc-agent runtime driven through the real dsh-sdk-client,
  keyless llm-replay behind a new cordis.snapshot.yml overlay; three recorded
  scenarios (text turn, bash tool, spawn subagent) pin the notification
  stream, the SDK turn result, and the persisted parent+child session logs.
- Bilingual READMEs for dsh-sdk-protocol / dsh-sdk-client / dsh-subagent-sdk;
  sdk/ and subagent/ group tables extended; dsh-jsonrpc README points at the
  extracted protocol package; Agent Note (en+zh) owns the decision.
- The proposed make-jsonrpc-directional note is updated for the transport's
  new home and its second (client) consumer.
- Model Experience sentence allowlist entries for the two client-side
  packages; module graph + config catalog regenerated; i18n pairings
  recorded. doc-sync passes 24/24.

2026-07-27 04:37:23 +08:00

1.7 KiB

Raw Blame History

SDK packages

English | 中文

Developer tooling for creating, editing, building, and running DeepSeek Harness projects, plus the client SDK stack for driving a harness runtime from another process.

The feature Agent Note owns the developer workflow; the architecture Agent Note owns the package and project-editing boundaries; the TypeScript SDK Agent Note owns the client SDK stack.

Package	Role
`helper`	Project aggregate, edit session, builtin features, project documents, templates, package managers, and prompt abstraction
`scripts`	The `dsh-sdk` launcher: `start`, `dev`, `build`, and interactive `config`
`create-sdk`	The `npm create @deepseek-ai/sdk` initializer
`sdk-protocol`	Shared SDK runtime wire protocol: the newline-delimited JSON-RPC transport + named request/notification types
`sdk-client`	TypeScript client SDK: drive a harness runtime subprocess over stdio JSON-RPC (the Python SDK's design twin)

@deepseek-ai/create-sdk is the one package-name exception to the repository's @deepseek-ai/dsh-* rule: npm's scoped initializer convention requires that name for npm create @deepseek-ai/sdk.

Generated projects keep cordis.yml as the only runtime plugin tree. dsh-sdk dev adds TypeScript and local-workspace resolution around that same file; it does not create a development-only config.

1.7 KiB Raw Blame History

SDK packages

1.7 KiB

Raw Blame History