Tianyi Cui
9dcc8fa985
Integrate master 78ae4fc2d4d8ecaebb4b674028f781a358b92cc9 after the four independent review fixes. Keep this base update separate from those fixes and from subsequent review changes so the integration is independently reviewable and the observed-master checkpoint remains preserved. Retain activation-owned execution, caller-independent local discovery, and unconditional parent final-answer delivery. Preserve master's preset scoped scheduling tools and all delegated-child schedule deny rules. Move the new scheduling regression from the removed driver package into the surviving subagent package and run it through a real Spawn activation. Preserve master's removal of runtime invariant plugins, dependencies, exports, and test mounts. Keep context disposal before fixture directory cleanup. Combine Python workflow ordering with activation/catalog events without inventing unsupported source-plane import paths. Keep all frozen Agent Note archives byte-for-byte identical to master; do not accept Git's automatic edits to renamed archived notes. Retain current lifecycle and delivery facts in active documentation, repair its links, and regenerate catalogs/persistence schemas from merged source. All 62 master persistence roots remain; only subagent/catalog gains the PR's external membership extension. Keep master's third-party lock graph and update only workspace dependency changes. Validation before this checkpoint: 683 focused tests passed, seven Windows-only cases skipped; 2,772 archived artifacts verified. Generated catalog and active-pair checks passed. Fresh artifact build and remaining build-dependent documentation checks continue before publication.
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.