Tianyi Cui
29638ccf2d
The two-stage real-stack workflow test still expected an empty parent catalog after the caller-delivery discovery fix. That obsolete assertion fails deterministically in both Linux and Windows coverage jobs: the two local children now correctly leave continuable membership records. Compare catalog identities and modes with independently observed workflow agent-start identities. Keep the assertions that neither parent followup nor steer was called, and that both child Agents reached disposal. This checks the intended separation between durable discovery and result notification rather than restoring the old missing-navigation behavior. Validation: all three workflow integration cases pass. The original empty catalog assertion is the exact failure in both current-head coverage logs.
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 orchestration scripts that delegate work to subagents and return a final value. The workflow tool supports scripted fan-out; the opt-in ralph tool runs a fixed sequence of fresh agents. Scripts use the shared PTC Node process runtime under the calling Session's file policy. Workflow hooks and child lifecycle remain owned by the workflow engine.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
workflow |
Runs a model-written orchestration script that fans out subagents | ctx.workflowEngine |
workflow-ptc |
Runs workflow scripts through the shared sandboxed PTC Node process runtime | 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.
- historical Dynamic workflows Agent Note — the seam design and its decisions.
- Harness-level goal-based execution reference — the fixed fresh-agent loop design and deferred work.
Dev Note
Working context for maintainers — click to expand
None.