Yichen Jiang
e5d5d16dd2
# Conflicts: # docs/event-producer-consumer.i18n.yaml # docs/event-producer-consumer.md # docs/event-producer-consumer.zh.md # packages/api/session-controller/src/client/sessions/session.ts # packages/extensions/cordis-client-runner/src/client/api-catalog.ts # packages/extensions/tool-cordis/src/api-catalog.ts # packages/host/apiproxy/src/api/rpc.schema.ts # packages/session/session-projection-cache/tests/cache.spec.ts # packages/shell/tool-bash/tests/observe.spec.ts # packages/shell/tool-pwsh/tests/observe.spec.ts # snapshots/web/approval-composer/session.jsonl # snapshots/web/code-mode-round/session.jsonl # snapshots/web/cordis-tool-round/session.jsonl # snapshots/web/feedback-command/session.jsonl # snapshots/web/fresh-round-trip/session.jsonl # snapshots/web/goal-multi-turn-actions/session.jsonl # snapshots/web/lifecycle-chrome/session.jsonl # snapshots/web/live-interactions/session.jsonl # snapshots/web/minimal-preset/session.jsonl # snapshots/web/permission-policy-context/session.jsonl # snapshots/web/plan-review/session.jsonl # snapshots/web/question-composer/session.jsonl # snapshots/web/steering/session.jsonl # snapshots/web/turn-tail-actions/session.jsonl # snapshots/web/web-search-round/session.jsonl
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 |
Related documentation
- Workflow subsystem — the seam's types, start request, and
workflow/*events. - Generated tool catalog — the
workflowtool schema the model receives. - Generated tool catalog — the
ralphtool schema the model receives. - Generated configuration catalog — every accepted engine config field.
- Dynamic workflows Agent Note — the seam design and its decisions.
- Ralph tool Agent Note — the fixed fresh-agent loop design and deferred work.
Dev Note
Working context for maintainers — click to expand
None.