Packages
August 13, 2026 · View on GitHub
English | 中文
npm scope: @deepseek-ai/dsh-*; Cordis Service subclasses and function plugins contribute through ctx.effect(), ctx.on(), or ctx.waterfall(). Rules: package, root.
Hierarchy
Groups hold packages/<group>/<pkg>/; names stay @deepseek-ai/dsh-<pkg>. Group READMEs own package/ctx-key maps.
| Group | Role | Release expectation |
|---|---|---|
core/ | Product API spine: sessions, prompts, tools, agent services, and the concrete loop | Product — stable API |
api/ | Remote BFF assembly and Typert RPC gateway | Product — stable API |
typert/ | Type graph generation, artifact loading, and runtime registry | Product — stable API |
goal/ | Same-session goal persistence and lifecycle | Product — stable API |
schedule/ | Session-local scheduled follow-ups | Product — stable API |
feedback/ | Human feedback | Product — stable API |
identity/ | Shared anonymous identity | Product — stable API |
llm/ | LLM capability family: the abstract service + provider adapters | Product — stable API |
e2b/ | E2B providers | POC |
subprocess/ | Subprocess capability family: Service Definition + local process-tree provider | Product — stable API |
shell/ | Bash capability family: executor seam, local impl, model-facing tool | Product — stable API |
terminal/ | Persistent PTY capability family: owner-scoped sessions, local implementation, and model-facing tools | Product — stable API |
code-runtime/ | Code-execution capability family: Service Definition + worker-thread provider + Code Mode Consumer | Product — stable API |
sandbox/ | Process-confinement seam; bwrap/Landlock/Seatbelt backends | Product — stable API |
fs/ | Filesystem capability family: seam, local impl, model-facing file tools, bash-backed discovery tools | Product — stable API |
lsp/ | LSP capability family: seam, generic stdio provider, and the lsp tool | Product — stable API |
skill/ | Skill capability family: the provider registry, local provider, and model-facing catalog/loader | Product — stable API |
compaction/ | Compaction capability family: Service Definition + basic provider + command Consumer | Product — stable API |
context/ | Model-visible request context, including workspace instructions and time context | Product — stable API |
subagent/ | Subagent capability family: the provider-registry contract and the model-facing delegation tool | Product — stable API |
jobs/ | Generic background-job runtime and model-facing job_* control tools | Product — stable API |
workflow/ | Workflow seam, worker-thread engine, and model-facing workflow/ralph tools | Product — stable API |
web/ | Web capability family: seam, search/fetch provider impls, and the model-facing web tools | Product — stable API |
attachment/ | Durable attachment identity, validation, local content-addressed storage | Product — stable API |
spill/ | Spill capability family: storage seam, local impl, tool-result spill policy | Product — stable API |
todo/ | The model-facing todo_write tool | Product — stable API |
plan/ | Plan collaboration state with a direct entry command and reviewed exit | Product — stable API |
preset/ | Per-session agent composition from preset cordis.yml files | Product — stable API |
guard/ | Loop-hygiene guards: advisory repeat-call reminders + the tools/execute deadline enforcer | Product — stable API |
bundle/ | Installable dsh --profile patch layers | Product — stable API |
extensions/ | Agent runtime self-modification: live plugin/service inspection and model-written plugin mount/unmount (design) | Product — stable API |
hooks/ | Hook bridges + the shared Claude Code / Codex wire-protocol library | Product — stable API |
session/ | Durable session data plane: persistence seam + JSONL/SQLite backends, projection seam, log-backed titles, session reporting | Product — stable API |
session-query/ | Session retrieval family: logical corpus, bounded reads, lineage, event relationships, semantic filtering, and SQLite full-text search | Product — stable API |
settings/ | User-settings seam + file-backed provider | Product — stable API |
credentials/ | Credential-reference seam + env-over-.env provider | Product — stable API |
storage/ | Non-session storage hub + backends + domain form | Product — stable API |
workspace/ | Workspace entity | Product — stable API |
sdk/ | Out-of-process runtime SDK: JSON-RPC protocol, TypeScript client, and server plugin | Product — stable API |
acp/ | Automation-only Agent Client Protocol server | Product — stable API |
interaction/ | Human-collaboration plane: approval/interaction seams, permission preset, commands, ask-user tool | Product — stable API |
boot/ | Shared app-bin boot glue | Product — stable API |
host/ | Web-GUI host half: API gateway + HTTP route server | Product — stable API |
client/ | Web-GUI browser half: shell, wire, object services, slots, ui-* plugins | Product — stable API |
examples/ | Demo bundles (agent-spine + CLI/ACP/JSON-RPC bins) leaves load | Support — example infra |
test-support/ | Support infrastructure (testkits, invariants, replay, Loader smokes) | Support — lower compatibility expectations |
util/ | Low-level zero-dependency utilities shared across groups (Branded<B>, Harness home/path helpers, timeout, retention) | Support — small, stable, harness-dep-free |
New packages join existing groups; new groups update their README and this table.
Dependencies
The dependency graph is generated: docs/module-graph.md (pnpm run gen-module-graph, freshness-gated in CI).
Extension plugins depend on Service Definitions, never concrete providers. dsh-agent-loop is swappable; UI, hook, and tool plugins use dsh-agent. Composition bundles, including dsh-agent-spine-demo, may depend on spine plugins. Capabilities separate Service Definition / Service Provider / Consumer roles when they evolve independently; see capability seams.
Package READMEs cover purpose, APIs, extension points, and Model Experience unless on the model-agnostic omission allowlist. They also carry ## Known Limitations and Deferred Work or use its allowlist.