Replace the TypeScript SDK's public arbitrary command/argv launch surface with the same-version dsh CLI, a named profile, ordered per-launch patches, optional process cwd, and explicit Harness home selection. Installed consumers use the built CLI; clean source checkouts use the package's src/bin.ts through an absolute tsx/esm loader and a source-only patch that omits build-generated Typert loading. Materialize explicit or inherited environments at spawn time, keep profile-internal patches below caller patches, and resolve every caller-relative path before the child starts. The SDK subagent provider validates its optional CLI and patch files at plugin load and requires an isolated absolute child home. Treat JSON-RPC initialize as the Loader-owned readiness point: Loader settlement joins entry imports, fiber lifecycle work, and synchronous effect registration, so the server needs no scheduler tick. A delayed profile entry registers a private adapter before initialize resolves, proving caller-supplied plugin routes are visible without fallback. Update sdk-app ownership, server diagnostics, TypeScript SDK examples, nested-loader coverage, and session-upload replay layering together. The following commit contains only the regenerated SDK transcripts, keeping this API and lifecycle change directly reviewable. |
||
|---|---|---|
| .. | ||
| acp-agent | ||
| headless-agent | ||
| mcp-memory | ||
| python-sdk-agent | ||
| web-cordis | ||
| web-github-review | ||
| web-schedule | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| package.json | ||
| README.i18n.yaml | ||
| README.md | ||
| README.zh.md | ||
Examples
English | 中文
Runnable demonstrations of the main DeepSeek Harness interfaces and extension points. Each child directory owns its configuration, prerequisites, commands, and detailed behavior.
mcp-memory
Optional overlays that connect supported third-party memory servers through the generic MCP client. See the memory example reference.
headless-agent
A non-interactive agent that accepts one task, runs it, and emits a selected machine-readable or human-readable output format. See the headless example reference.
jsonrpc-agent
An unattended coding agent driven through the Python SDK and JSON-RPC. See the JSON-RPC example reference.
web-cordis
A self-referential agent that can inspect and change its in-memory Cordis plugin tree. See the web-cordis example reference.
web-schedule
An opt-in Web overlay for durable, Session-local reminders. It supports positive whole-second after_seconds delays and absolute at targets through schedule_create, schedule_list, and schedule_delete; active reminders persist in the original Session, resume when that Session becomes live again, and do not run while it is cold. Run dsh web --patch examples/web-schedule/cordis.yml; see web-schedule/README.md for absolute-time authority, delivery, and recovery boundaries.
web-github-review
An opt-in Web overlay with a dedicated signed GitHub endpoint and a programmatic pull_request.ready_for_review rule. Matching deliveries create read-only review Sessions beneath the configured local Workspace; see web-github-review/README.md.
acp-agent
An Agent Client Protocol automation server for programmatic clients, with session, permission, and cancellation support. See the ACP example reference.