mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
1d43ea3cd5
A new capability family at packages/workflow/ in the bash seam shape,
modeled on Claude Code's dynamic workflows: the model writes a JavaScript
orchestration script (export const meta = {...} + plain-JS body), a runtime
executes it, and the script — not the conversation — holds the loop, the
branching, and the intermediate results.
- dsh-workflow (ctx.workflows): abstract WorkflowService + run vocabulary
(WorkflowRun whose result NEVER rejects) + observe-only workflow/* events
carrying data snapshots (id + meta, never the live run), per-listener
contained like subagent/*.
- dsh-workflow-vm: in-process node:vm engine. Meta extraction via a
string/comment-aware scanner (template interpolation rejected; literal
evaluated alone in an empty timed context; statement blanked line-
preservingly so stacks keep script line numbers). Hooks: agent(prompt,
{label, phase, schema, model}) over ctx.subagents, parallel(), pipeline()
(no cross-stage barrier), phase(), log(), args. Fatal-vs-null discipline:
hook misuse (unknown/deferred options, bad arguments, unsupported
schemas, tripped caps, seam start failures, cancellation) throws fatal
WorkflowErrors the combinators RE-THROW — never dissolved into the
per-item null reserved for child failures. Realm boundary: inbound values
materialized by descriptor walks that never invoke accessors (defineProperty
copies, __proto__-safe); outbound values rebuilt in-realm via the
context's own JSON.parse. Determinism bans (Date.now/Math.random/argless
new Date) kept so future resume support cannot break scripts. Caps and
timeouts are validated Config. Every hook promise carries a no-op
rejection consumer (app-boot exits on unhandled rejections).
- dsh-tool-workflow: the model-facing workflow tool, synchronous like
dsh-tool-subagent (start → await → try/finally dispose; abort bridged;
non-completed → isError). Generic render card titled by a textual
meta.name sniff. The tool description carries the authoring contract.
Wired into examples/{coding-agent,acp-agent} with explicit-ask-only
guidance. Coverage at every tier: unit (meta scanner, materializer incl.
counting-getter and __proto__ regressions, combinator semantics,
concurrency ceiling, caps, cancellation, no-unhandled-rejection abandon),
integration over the real spawn stack, with-key e2e (real two-phase run +
the tool through the registry pipeline), and a recorded ACP snapshot
scenario (workflow-run, 1 child session). RFC:
docs/rfc/implemented/feature/2026-07-05-dynamic-workflows.md (deferred
work explicitly listed). AGENTS.md budget 1575 → 1590 for the new group's
layout line.
196 lines
6.0 KiB
Markdown
196 lines
6.0 KiB
Markdown
<!-- Generated by scripts/gen-module-graph.ts — do not edit by hand.
|
|
Run `pnpm run gen-module-graph` to regenerate. -->
|
|
|
|
# Module dependency graph
|
|
|
|
Inter-package dependencies among the `@deepseek-ai/dsh-*` harness packages, derived from each package's `peerDependencies` (the canonical runtime-dependency signal). An edge `a --> b` means package `a` depends on package `b`. Names have the `@deepseek-ai/dsh-` prefix stripped.
|
|
|
|
```mermaid
|
|
graph TD
|
|
bash --> brand
|
|
llm --> brand
|
|
bash-local --> bash
|
|
fs --> brand
|
|
fs --> llm
|
|
llm-deepseek --> llm
|
|
llm-pi-ai --> llm
|
|
session --> brand
|
|
session --> llm
|
|
system-prompt --> llm
|
|
web --> llm
|
|
agent --> brand
|
|
agent --> llm
|
|
agent --> session
|
|
compact --> llm
|
|
compact --> session
|
|
fs-local --> fs
|
|
fs-policy --> fs
|
|
hook-protocol --> bash
|
|
hook-protocol --> session
|
|
llm-replay --> llm
|
|
llm-replay --> session
|
|
session-persistence --> session
|
|
web-fetch-local --> web
|
|
web-search-deepseek --> web
|
|
web-search-exa --> web
|
|
web-search-perplexity --> web
|
|
compact-basic --> agent
|
|
compact-basic --> compact
|
|
compact-basic --> llm
|
|
compact-basic --> session
|
|
invariants --> agent
|
|
invariants --> llm
|
|
invariants --> session
|
|
session-persistence-jsonl --> session
|
|
session-persistence-jsonl --> session-persistence
|
|
session-persistence-sqlite --> session
|
|
session-persistence-sqlite --> session-persistence
|
|
tools --> agent
|
|
tools --> llm
|
|
tools --> system-prompt
|
|
workflow --> agent
|
|
workflow --> brand
|
|
workflow --> llm
|
|
acp --> agent
|
|
acp --> llm
|
|
acp --> session
|
|
acp --> session-persistence
|
|
acp --> tools
|
|
agent-loop --> agent
|
|
agent-loop --> llm
|
|
agent-loop --> session
|
|
agent-loop --> session-persistence
|
|
agent-loop --> system-prompt
|
|
agent-loop --> tools
|
|
hooks-codex --> agent
|
|
hooks-codex --> hook-protocol
|
|
hooks-codex --> llm
|
|
hooks-codex --> session
|
|
hooks-codex --> tools
|
|
subagent --> agent
|
|
subagent --> llm
|
|
subagent --> tools
|
|
tool-bash --> agent
|
|
tool-bash --> bash
|
|
tool-bash --> llm
|
|
tool-bash --> tools
|
|
tool-fs --> fs
|
|
tool-fs --> llm
|
|
tool-fs --> session
|
|
tool-fs --> system-prompt
|
|
tool-fs --> tools
|
|
tool-todo --> agent
|
|
tool-todo --> session
|
|
tool-todo --> tools
|
|
tool-web --> llm
|
|
tool-web --> system-prompt
|
|
tool-web --> tools
|
|
tool-web --> web
|
|
tool-workflow --> agent
|
|
tool-workflow --> llm
|
|
tool-workflow --> tools
|
|
tool-workflow --> workflow
|
|
agent-core --> agent
|
|
agent-core --> agent-loop
|
|
agent-core --> invariants
|
|
agent-core --> llm
|
|
agent-core --> session
|
|
agent-core --> system-prompt
|
|
agent-core --> tool-bash
|
|
agent-core --> tools
|
|
hooks-claude --> agent
|
|
hooks-claude --> hook-protocol
|
|
hooks-claude --> llm
|
|
hooks-claude --> session
|
|
hooks-claude --> subagent
|
|
hooks-claude --> tools
|
|
subagent-acp --> agent
|
|
subagent-acp --> llm
|
|
subagent-acp --> subagent
|
|
subagent-inprocess --> agent
|
|
subagent-inprocess --> llm
|
|
subagent-inprocess --> session
|
|
subagent-inprocess --> subagent
|
|
subagent-inprocess --> tools
|
|
subagent-mock --> agent
|
|
subagent-mock --> llm
|
|
subagent-mock --> subagent
|
|
tool-subagent --> agent
|
|
tool-subagent --> llm
|
|
tool-subagent --> subagent
|
|
tool-subagent --> tools
|
|
workflow-vm --> agent
|
|
workflow-vm --> brand
|
|
workflow-vm --> llm
|
|
workflow-vm --> subagent
|
|
workflow-vm --> tools
|
|
workflow-vm --> workflow
|
|
acp-agent --> acp
|
|
acp-agent --> agent-core
|
|
acp-agent --> app-boot
|
|
acp-agent --> session-persistence-jsonl
|
|
stdio-agent --> agent
|
|
stdio-agent --> agent-core
|
|
stdio-agent --> app-boot
|
|
stdio-agent --> llm
|
|
stdio-agent --> session
|
|
stdio-agent --> session-persistence-jsonl
|
|
subagent-fork --> agent
|
|
subagent-fork --> session
|
|
subagent-fork --> subagent
|
|
subagent-fork --> subagent-inprocess
|
|
subagent-spawn --> subagent
|
|
subagent-spawn --> subagent-inprocess
|
|
```
|
|
|
|
| Package | Depends on |
|
|
| --- | --- |
|
|
| `app-boot` | — |
|
|
| `brand` | — |
|
|
| `bash` | `brand` |
|
|
| `llm` | `brand` |
|
|
| `bash-local` | `bash` |
|
|
| `fs` | `brand`, `llm` |
|
|
| `llm-deepseek` | `llm` |
|
|
| `llm-pi-ai` | `llm` |
|
|
| `session` | `brand`, `llm` |
|
|
| `system-prompt` | `llm` |
|
|
| `web` | `llm` |
|
|
| `agent` | `brand`, `llm`, `session` |
|
|
| `compact` | `llm`, `session` |
|
|
| `fs-local` | `fs` |
|
|
| `fs-policy` | `fs` |
|
|
| `hook-protocol` | `bash`, `session` |
|
|
| `llm-replay` | `llm`, `session` |
|
|
| `session-persistence` | `session` |
|
|
| `web-fetch-local` | `web` |
|
|
| `web-search-deepseek` | `web` |
|
|
| `web-search-exa` | `web` |
|
|
| `web-search-perplexity` | `web` |
|
|
| `compact-basic` | `agent`, `compact`, `llm`, `session` |
|
|
| `invariants` | `agent`, `llm`, `session` |
|
|
| `session-persistence-jsonl` | `session`, `session-persistence` |
|
|
| `session-persistence-sqlite` | `session`, `session-persistence` |
|
|
| `tools` | `agent`, `llm`, `system-prompt` |
|
|
| `workflow` | `agent`, `brand`, `llm` |
|
|
| `acp` | `agent`, `llm`, `session`, `session-persistence`, `tools` |
|
|
| `agent-loop` | `agent`, `llm`, `session`, `session-persistence`, `system-prompt`, `tools` |
|
|
| `hooks-codex` | `agent`, `hook-protocol`, `llm`, `session`, `tools` |
|
|
| `subagent` | `agent`, `llm`, `tools` |
|
|
| `tool-bash` | `agent`, `bash`, `llm`, `tools` |
|
|
| `tool-fs` | `fs`, `llm`, `session`, `system-prompt`, `tools` |
|
|
| `tool-todo` | `agent`, `session`, `tools` |
|
|
| `tool-web` | `llm`, `system-prompt`, `tools`, `web` |
|
|
| `tool-workflow` | `agent`, `llm`, `tools`, `workflow` |
|
|
| `agent-core` | `agent`, `agent-loop`, `invariants`, `llm`, `session`, `system-prompt`, `tool-bash`, `tools` |
|
|
| `hooks-claude` | `agent`, `hook-protocol`, `llm`, `session`, `subagent`, `tools` |
|
|
| `subagent-acp` | `agent`, `llm`, `subagent` |
|
|
| `subagent-inprocess` | `agent`, `llm`, `session`, `subagent`, `tools` |
|
|
| `subagent-mock` | `agent`, `llm`, `subagent` |
|
|
| `tool-subagent` | `agent`, `llm`, `subagent`, `tools` |
|
|
| `workflow-vm` | `agent`, `brand`, `llm`, `subagent`, `tools`, `workflow` |
|
|
| `acp-agent` | `acp`, `agent-core`, `app-boot`, `session-persistence-jsonl` |
|
|
| `stdio-agent` | `agent`, `agent-core`, `app-boot`, `llm`, `session`, `session-persistence-jsonl` |
|
|
| `subagent-fork` | `agent`, `session`, `subagent`, `subagent-inprocess` |
|
|
| `subagent-spawn` | `subagent`, `subagent-inprocess` |
|