Files
deepseek-harness/packages/workflow
Yichen Jiang 42858723a6 Merge remote-tracking branch 'origin/worktree/process-plugin-streaming-72f9b3' into worktree/job-kill-delivery
# Conflicts:
#	packages/api/job-controller/README.i18n.yaml
#	packages/api/job-controller/README.md
#	packages/api/job-controller/README.zh.md
#	packages/api/session-controller/README.i18n.yaml
#	packages/api/session-controller/README.md
#	packages/api/session-controller/README.zh.md
#	packages/shell/bash-local/src/index.ts
#	packages/shell/pwsh-local/src/index.ts
#	packages/shell/tool-bash/src/background.ts
#	packages/shell/tool-bash/tests/tools.spec.ts
#	packages/shell/tool-pwsh/src/background.ts
#	packages/shell/tool-pwsh/tests/background.spec.ts
#	snapshots/web/approval-composer/session.v2.jsonl
#	snapshots/web/feedback-command/session.v2.jsonl
#	snapshots/web/fresh-round-trip/session.v2.jsonl
#	snapshots/web/goal-multi-turn-actions/session.jsonl
#	snapshots/web/lifecycle-chrome/session.v2.jsonl
#	snapshots/web/live-interactions/session.v2.jsonl
#	snapshots/web/minimal-preset/session.v2.jsonl
#	snapshots/web/permission-policy-context/session.v2.jsonl
#	snapshots/web/plan-review/session.jsonl
#	snapshots/web/ptc-round/session.v2.jsonl
#	snapshots/web/question-composer/session.v2.jsonl
#	snapshots/web/steering/session.v2.jsonl
#	snapshots/web/turn-tail-actions/session.v2.jsonl
#	snapshots/web/web-search-round/session.v2.jsonl
2026-09-04 13:27:34 +08:00
..
2026-09-03 02:27:19 +08:00
2026-09-03 02:27:19 +08:00

description, kind
description kind
The workflow group map: model-authored orchestration scripts that fan out subagents, for users and maintainers navigating the group. package-group

packages/workflow

English | 中文

Summary

The workflow group lets an agent run a model-authored orchestration script that fans work out across many subagents and returns a final value. The workflow package provides the run service, the worker-thread package executes scripts in isolated threads, and two model-facing tools expose orchestration: the general workflow tool for scripted fan-out and the fixed ralph tool for fresh-agent iterative loops. The script coordinates agents with hooks while the agents do the actual work. The engine keeps a script's synchronous work off the host event loop but is containment, not a security boundary.

Table of Contents


Packages

Package Role ctx key
workflow Runs a model-written orchestration script that fans out subagents ctx.workflowEngine
workflow-worker-thread Executes each workflow script in its own worker thread, off the host event loop registers on ctx.workflowEngine
tool-workflow Gives the model the workflow tool for scripted multi-agent orchestration registers on ctx.tools
tool-ralph Gives the model the ralph tool for fresh-agent iterative loops registers on ctx.tools


Dev Note

Working context for maintainers — click to expand

None.