Files
deepseek-harness/packages/workflow
Yichen Jiang 8537b8d5bb refactor(shell,workflow): produce into the job record instead of ctx.activities
bash and pwsh background runs declare record: true and pump their observed
streams straight into the job through observeProcessRecord — the open/end
pairing, outcome mapping, and registry-absent degradation branches are gone,
and the pump's final drain folds into hooks.done so the record holds its
last bytes before settlement closes it. activityPollMs becomes recordPollMs.

tool-workflow drops its foreground activity mirror deliberately: a
foreground run's live phase/log narration had the mirror as its only
carrier, and the transcript keeps the recorded run/member lifecycle events.
Live narration returns with backgrounded runs when workflow gains
run_in_background.
2026-09-01 17:52:42 +08:00
..
2026-08-30 21:19:29 +08:00
2026-08-30 21:19:29 +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.