@xzzpig/pi-subagents 0.21.0 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +356 -0
- package/README.md +2 -2
- package/agents/evidence-auditor.md +1 -0
- package/agents/oracle.md +1 -0
- package/agents/reviewer.md +1 -0
- package/bundle/agent-management.js +16 -0
- package/bundle/agents.js +41 -0
- package/bundle/background-work.js +16 -0
- package/bundle/capability-ceiling.js +22 -0
- package/bundle/child-tool-plan.js +11 -0
- package/bundle/chunk-355ECEP2.js +1321 -0
- package/bundle/chunk-35GII5EF.js +637 -0
- package/bundle/chunk-3G4JXNZ4.js +4130 -0
- package/bundle/chunk-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -0
- package/bundle/chunk-7K3Z6DM7.js +276 -0
- package/bundle/chunk-BGIYHF2W.js +138 -0
- package/bundle/chunk-CTPAE36Y.js +94 -0
- package/bundle/chunk-D4EHT5SJ.js +14 -0
- package/bundle/chunk-ED55MIC2.js +1681 -0
- package/bundle/chunk-F3NSN7UH.js +7331 -0
- package/bundle/chunk-FJWI64H7.js +490 -0
- package/bundle/chunk-H36HBZB2.js +753 -0
- package/bundle/chunk-ICNYIALB.js +7347 -0
- package/bundle/chunk-KD2IMFN4.js +1310 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LPVUHUZ7.js +5503 -0
- package/bundle/chunk-MYCL5QEJ.js +1372 -0
- package/bundle/chunk-NCWCVJLT.js +1768 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-NTRJDXBC.js +4175 -0
- package/bundle/chunk-OFGSZBHP.js +16924 -0
- package/bundle/chunk-OTLRAB22.js +143 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RK2HDPLK.js +1234 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-T65XRVVM.js +940 -0
- package/bundle/chunk-U4ODUYAG.js +235 -0
- package/bundle/chunk-UFNSLL5D.js +9796 -0
- package/bundle/chunk-UKG4V45O.js +228 -0
- package/bundle/chunk-UQDHXMUG.js +264 -0
- package/bundle/chunk-V2KFIGFH.js +8774 -0
- package/bundle/chunk-VO3G7HI3.js +85 -0
- package/bundle/chunk-WPW4V6HM.js +227 -0
- package/bundle/chunk-WW76JRIX.js +175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/control-channel.js +11 -0
- package/bundle/delegation.js +14 -0
- package/bundle/external-job-provider.js +20 -0
- package/bundle/external-runs.js +21 -0
- package/bundle/index.js +30 -0
- package/bundle/inspectors.js +8 -0
- package/bundle/intercom-bridge.js +11 -0
- package/bundle/preflight.js +468 -0
- package/bundle/project-panes.js +28 -0
- package/bundle/required-child-extensions.js +6 -0
- package/bundle/shared-types.js +8 -0
- package/bundle/supervisor-routing.js +12 -0
- package/bundle/workflow-resources.js +7 -0
- package/docs/agents.md +42 -10
- package/docs/configuration.md +59 -14
- package/docs/extension-api.md +61 -9
- package/docs/fork-supervisor-routing.md +77 -0
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -86
- package/skills/council-mode/SKILL.md +1 -4
- package/skills/pi-subagents/SKILL.md +130 -106
- package/skills/pi-subagents/references/orchestration.md +124 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
- package/src/agents/advertised-agent-prompt.d.ts +13 -0
- package/src/agents/advertised-agent-prompt.js +68 -0
- package/src/agents/agent-eject.d.ts +39 -0
- package/src/agents/agent-eject.js +263 -0
- package/src/agents/agent-management.d.ts +33 -0
- package/src/agents/agent-management.js +1541 -0
- package/src/agents/agent-memory.d.ts +48 -0
- package/src/agents/agent-memory.js +350 -0
- package/src/agents/agent-refinements.d.ts +99 -0
- package/src/agents/agent-refinements.js +568 -0
- package/src/agents/agent-scope.d.ts +3 -0
- package/src/agents/agent-scope.js +8 -0
- package/src/agents/agent-selection.d.ts +2 -0
- package/src/agents/agent-selection.js +22 -0
- package/src/agents/agent-serializer.d.ts +7 -0
- package/src/agents/agent-serializer.js +213 -0
- package/src/agents/agents.d.ts +352 -0
- package/src/agents/agents.js +2817 -0
- package/src/agents/builtin-names.d.ts +1 -0
- package/src/agents/builtin-names.js +16 -0
- package/src/agents/chain-serializer.d.ts +6 -0
- package/src/agents/chain-serializer.js +318 -0
- package/src/agents/frontmatter.d.ts +19 -0
- package/src/agents/frontmatter.js +166 -0
- package/src/agents/global-npm-root.d.ts +6 -0
- package/src/agents/global-npm-root.js +57 -0
- package/src/agents/identity.d.ts +7 -0
- package/src/agents/identity.js +29 -0
- package/src/agents/proactive-skills.d.ts +35 -0
- package/src/agents/proactive-skills.js +155 -0
- package/src/agents/runtime-agent-events.d.ts +26 -0
- package/src/agents/runtime-agent-events.js +52 -0
- package/src/agents/runtime-agent-registry.d.ts +66 -0
- package/src/agents/runtime-agent-registry.js +415 -0
- package/src/agents/runtime-discovery.d.ts +13 -0
- package/src/agents/runtime-discovery.js +27 -0
- package/src/agents/skills.d.ts +34 -0
- package/src/agents/skills.js +718 -0
- package/src/api/agent-management.d.ts +2 -0
- package/src/api/agent-management.js +2 -0
- package/src/api/agents.d.ts +6 -0
- package/src/api/agents.js +3 -0
- package/src/api/background-work.d.ts +41 -0
- package/src/api/background-work.js +171 -0
- package/src/api/capability-ceiling.d.ts +1 -0
- package/src/api/capability-ceiling.js +1 -0
- package/src/api/child-tool-plan.d.ts +1 -0
- package/src/api/child-tool-plan.js +1 -0
- package/src/api/control-channel.d.ts +1 -0
- package/src/api/control-channel.js +1 -0
- package/src/api/delegation.d.ts +132 -0
- package/src/api/delegation.js +8 -0
- package/src/api/external-job-provider.d.ts +57 -0
- package/src/api/external-job-provider.js +139 -0
- package/src/api/external-runs.d.ts +47 -0
- package/src/api/external-runs.js +245 -0
- package/src/api/inspectors.d.ts +20 -0
- package/src/api/inspectors.js +11 -0
- package/src/api/intercom-bridge.d.ts +1 -0
- package/src/api/intercom-bridge.js +1 -0
- package/src/api/preflight.d.ts +183 -0
- package/src/api/preflight.js +455 -0
- package/src/api/project-panes.d.ts +7 -0
- package/src/api/project-panes.js +7 -0
- package/src/api/required-child-extensions.d.ts +1 -0
- package/src/api/required-child-extensions.js +1 -0
- package/src/api/shared-types.d.ts +1 -0
- package/src/api/shared-types.js +1 -0
- package/src/api/supervisor-routing.d.ts +110 -0
- package/src/api/supervisor-routing.js +95 -0
- package/src/api/workflow-resources.d.ts +2 -0
- package/src/api/workflow-resources.js +1 -0
- package/src/extension/active-runs-prompt.d.ts +7 -0
- package/src/extension/active-runs-prompt.js +29 -0
- package/src/extension/config.d.ts +7 -0
- package/src/extension/config.js +290 -0
- package/src/extension/context-injection.d.ts +52 -0
- package/src/extension/context-injection.js +102 -0
- package/src/extension/control-notices.d.ts +18 -0
- package/src/extension/control-notices.js +29 -0
- package/src/extension/declaration-pinning.d.ts +18 -0
- package/src/extension/declaration-pinning.js +167 -0
- package/src/extension/doctor.d.ts +34 -0
- package/src/extension/doctor.js +236 -0
- package/src/extension/fanout-child.d.ts +6 -0
- package/src/extension/fanout-child.js +278 -0
- package/src/extension/herdr-pi-bridge.d.ts +16 -0
- package/src/extension/herdr-pi-bridge.js +261 -0
- package/src/extension/index.d.ts +18 -0
- package/src/extension/index.js +1288 -0
- package/src/extension/public-execution.d.ts +71 -0
- package/src/extension/public-execution.js +214 -0
- package/src/extension/reply-workflow-script.d.ts +11 -0
- package/src/extension/reply-workflow-script.js +71 -0
- package/src/extension/rpc.d.ts +84 -0
- package/src/extension/rpc.js +729 -0
- package/src/extension/schemas.d.ts +276 -0
- package/src/extension/schemas.js +311 -0
- package/src/extension/steering-notices.d.ts +14 -0
- package/src/extension/steering-notices.js +22 -0
- package/src/extension/subagent-guide.d.ts +4 -0
- package/src/extension/subagent-guide.js +114 -0
- package/src/extension/subagent-options.d.ts +7 -0
- package/src/extension/subagent-options.js +64 -0
- package/src/extension/tool-activation.d.ts +7 -0
- package/src/extension/tool-activation.js +185 -0
- package/src/extension/tool-description.d.ts +19 -0
- package/src/extension/tool-description.js +169 -0
- package/src/extension/tool-result.d.ts +9 -0
- package/src/extension/tool-result.js +16 -0
- package/src/extension/upgrade-notice.d.ts +6 -0
- package/src/extension/upgrade-notice.js +42 -0
- package/src/inspectors/actions.d.ts +24 -0
- package/src/inspectors/actions.js +182 -0
- package/src/inspectors/ghostty/actions.d.ts +11 -0
- package/src/inspectors/ghostty/actions.js +62 -0
- package/src/inspectors/ghostty/plugin.d.ts +7 -0
- package/src/inspectors/ghostty/plugin.js +23 -0
- package/src/inspectors/herdr/actions.d.ts +25 -0
- package/src/inspectors/herdr/actions.js +133 -0
- package/src/inspectors/herdr/client.d.ts +41 -0
- package/src/inspectors/herdr/client.js +129 -0
- package/src/inspectors/herdr/focus.d.ts +24 -0
- package/src/inspectors/herdr/focus.js +49 -0
- package/src/inspectors/herdr/plugin.d.ts +6 -0
- package/src/inspectors/herdr/plugin.js +14 -0
- package/src/inspectors/herdr/project-panes.d.ts +136 -0
- package/src/inspectors/herdr/project-panes.js +610 -0
- package/src/inspectors/inspector-runner.d.ts +23 -0
- package/src/inspectors/inspector-runner.js +161 -0
- package/src/inspectors/plugins.d.ts +8 -0
- package/src/inspectors/plugins.js +82 -0
- package/src/inspectors/session-roots-codec.d.ts +15 -0
- package/src/inspectors/session-roots-codec.js +32 -0
- package/src/inspectors/shell-command.d.ts +1 -0
- package/src/inspectors/shell-command.js +16 -0
- package/src/inspectors/tmux/actions.d.ts +25 -0
- package/src/inspectors/tmux/actions.js +181 -0
- package/src/inspectors/tmux/client.d.ts +27 -0
- package/src/inspectors/tmux/client.js +64 -0
- package/src/inspectors/tmux/plugin.d.ts +7 -0
- package/src/inspectors/tmux/plugin.js +14 -0
- package/src/inspectors/types.d.ts +48 -0
- package/src/inspectors/types.js +1 -0
- package/src/integrations/herdr-status.d.ts +47 -0
- package/src/integrations/herdr-status.js +350 -0
- package/src/integrations/pi-web-session-liveness.d.ts +19 -0
- package/src/integrations/pi-web-session-liveness.js +53 -0
- package/src/integrations/program-status.d.ts +30 -0
- package/src/integrations/program-status.js +188 -0
- package/src/intercom/fork-supervisor-routing.d.ts +90 -0
- package/src/intercom/fork-supervisor-routing.js +392 -0
- package/src/intercom/intercom-bridge.d.ts +58 -0
- package/src/intercom/intercom-bridge.js +193 -0
- package/src/intercom/native-supervisor-channel.d.ts +97 -0
- package/src/intercom/native-supervisor-channel.js +1184 -0
- package/src/intercom/result-intercom.d.ts +35 -0
- package/src/intercom/result-intercom.js +376 -0
- package/src/intercom/supervisor-ui.d.ts +29 -0
- package/src/intercom/supervisor-ui.js +49 -0
- package/src/missions/actions.d.ts +54 -0
- package/src/missions/actions.js +400 -0
- package/src/missions/goal-driver.d.ts +16 -0
- package/src/missions/goal-driver.js +171 -0
- package/src/missions/lifecycle.d.ts +50 -0
- package/src/missions/lifecycle.js +388 -0
- package/src/missions/store.d.ts +21 -0
- package/src/missions/store.js +605 -0
- package/src/missions/types.d.ts +169 -0
- package/src/missions/types.js +9 -0
- package/src/missions/workflow-state.d.ts +14 -0
- package/src/missions/workflow-state.js +273 -0
- package/src/policy/authority.d.ts +9 -0
- package/src/policy/authority.js +41 -0
- package/src/profiles/profiles.d.ts +134 -0
- package/src/profiles/profiles.js +526 -0
- package/src/runs/background/active-async-capacity.d.ts +115 -0
- package/src/runs/background/active-async-capacity.js +517 -0
- package/src/runs/background/active-run-index.d.ts +12 -0
- package/src/runs/background/active-run-index.js +157 -0
- package/src/runs/background/async-execution.d.ts +304 -0
- package/src/runs/background/async-execution.js +2206 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +921 -0
- package/src/runs/background/async-resume.d.ts +60 -0
- package/src/runs/background/async-resume.js +707 -0
- package/src/runs/background/async-retention.d.ts +45 -0
- package/src/runs/background/async-retention.js +932 -0
- package/src/runs/background/async-status-snapshot.d.ts +9 -0
- package/src/runs/background/async-status-snapshot.js +26 -0
- package/src/runs/background/async-status.d.ts +177 -0
- package/src/runs/background/async-status.js +710 -0
- package/src/runs/background/auto-drain.d.ts +16 -0
- package/src/runs/background/auto-drain.js +71 -0
- package/src/runs/background/await-async-run.d.ts +26 -0
- package/src/runs/background/await-async-run.js +83 -0
- package/src/runs/background/binary-bootstrap.d.ts +8 -0
- package/src/runs/background/binary-bootstrap.js +69 -0
- package/src/runs/background/boot-id.d.ts +12 -0
- package/src/runs/background/boot-id.js +47 -0
- package/src/runs/background/calendar-schedule.d.ts +26 -0
- package/src/runs/background/calendar-schedule.js +93 -0
- package/src/runs/background/chain-append.d.ts +34 -0
- package/src/runs/background/chain-append.js +299 -0
- package/src/runs/background/chain-root-attachment.d.ts +51 -0
- package/src/runs/background/chain-root-attachment.js +186 -0
- package/src/runs/background/completion-batcher.d.ts +51 -0
- package/src/runs/background/completion-batcher.js +119 -0
- package/src/runs/background/completion-dedupe.d.ts +13 -0
- package/src/runs/background/completion-dedupe.js +48 -0
- package/src/runs/background/completion-replay.d.ts +47 -0
- package/src/runs/background/completion-replay.js +266 -0
- package/src/runs/background/control-channel.d.ts +170 -0
- package/src/runs/background/control-channel.js +610 -0
- package/src/runs/background/fleet-view.d.ts +63 -0
- package/src/runs/background/fleet-view.js +666 -0
- package/src/runs/background/index-segment.d.ts +16 -0
- package/src/runs/background/index-segment.js +58 -0
- package/src/runs/background/inspect-rpc.d.ts +64 -0
- package/src/runs/background/inspect-rpc.js +422 -0
- package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
- package/src/runs/background/interrupted-elsewhere.js +68 -0
- package/src/runs/background/notify.d.ts +214 -0
- package/src/runs/background/notify.js +1001 -0
- package/src/runs/background/owned-process-tree.d.ts +10 -0
- package/src/runs/background/owned-process-tree.js +116 -0
- package/src/runs/background/parallel-groups.d.ts +3 -0
- package/src/runs/background/parallel-groups.js +46 -0
- package/src/runs/background/pid-namespace.d.ts +2 -0
- package/src/runs/background/pid-namespace.js +19 -0
- package/src/runs/background/process-terminal-candidate.d.ts +17 -0
- package/src/runs/background/process-terminal-candidate.js +96 -0
- package/src/runs/background/process-terminal.d.ts +21 -0
- package/src/runs/background/process-terminal.js +227 -0
- package/src/runs/background/result-delivery-ownership.d.ts +14 -0
- package/src/runs/background/result-delivery-ownership.js +38 -0
- package/src/runs/background/result-files.d.ts +63 -0
- package/src/runs/background/result-files.js +629 -0
- package/src/runs/background/result-watcher.d.ts +92 -0
- package/src/runs/background/result-watcher.js +819 -0
- package/src/runs/background/resume-guidance.d.ts +4 -0
- package/src/runs/background/resume-guidance.js +57 -0
- package/src/runs/background/retained-children.d.ts +24 -0
- package/src/runs/background/retained-children.js +128 -0
- package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
- package/src/runs/background/retained-nested-route-tracker.js +90 -0
- package/src/runs/background/run-child-session.d.ts +123 -0
- package/src/runs/background/run-child-session.js +670 -0
- package/src/runs/background/run-id-query.d.ts +3 -0
- package/src/runs/background/run-id-query.js +6 -0
- package/src/runs/background/run-id-resolver.d.ts +22 -0
- package/src/runs/background/run-id-resolver.js +172 -0
- package/src/runs/background/run-status.d.ts +25 -0
- package/src/runs/background/run-status.js +850 -0
- package/src/runs/background/runner-aliases.d.ts +17 -0
- package/src/runs/background/runner-aliases.js +191 -0
- package/src/runs/background/runner-child-launch.d.ts +24 -0
- package/src/runs/background/runner-child-launch.js +72 -0
- package/src/runs/background/runner-child-sessions.d.ts +6 -0
- package/src/runs/background/runner-child-sessions.js +34 -0
- package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
- package/src/runs/background/runner-http-dispatcher.js +115 -0
- package/src/runs/background/runner-startup-failure.d.ts +13 -0
- package/src/runs/background/runner-startup-failure.js +46 -0
- package/src/runs/background/scheduled-runs.d.ts +127 -0
- package/src/runs/background/scheduled-runs.js +1265 -0
- package/src/runs/background/stale-run-reconciler.d.ts +62 -0
- package/src/runs/background/stale-run-reconciler.js +509 -0
- package/src/runs/background/steering.d.ts +51 -0
- package/src/runs/background/steering.js +246 -0
- package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
- package/src/runs/background/subagent-runner-bootstrap.js +283 -0
- package/src/runs/background/subagent-runner.d.ts +210 -0
- package/src/runs/background/subagent-runner.js +4963 -0
- package/src/runs/background/subagent-wait.d.ts +124 -0
- package/src/runs/background/subagent-wait.js +756 -0
- package/src/runs/background/terminal-run-index.d.ts +10 -0
- package/src/runs/background/terminal-run-index.js +209 -0
- package/src/runs/background/top-level-async.d.ts +7 -0
- package/src/runs/background/top-level-async.js +5 -0
- package/src/runs/background/wait-completions.d.ts +28 -0
- package/src/runs/background/wait-completions.js +264 -0
- package/src/runs/background/wait-config.d.ts +8 -0
- package/src/runs/background/wait-config.js +46 -0
- package/src/runs/background/wait-subscriptions.d.ts +26 -0
- package/src/runs/background/wait-subscriptions.js +339 -0
- package/src/runs/background/wait-tool.d.ts +6 -0
- package/src/runs/background/wait-tool.js +48 -0
- package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
- package/src/runs/background/workflow-terminal-proof.js +116 -0
- package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
- package/src/runs/foreground/async-dismiss-action.js +82 -0
- package/src/runs/foreground/async-steering-action.d.ts +31 -0
- package/src/runs/foreground/async-steering-action.js +294 -0
- package/src/runs/foreground/async-stop-action.d.ts +13 -0
- package/src/runs/foreground/async-stop-action.js +213 -0
- package/src/runs/foreground/command-action.d.ts +12 -0
- package/src/runs/foreground/command-action.js +38 -0
- package/src/runs/foreground/execution.d.ts +10 -0
- package/src/runs/foreground/execution.js +2322 -0
- package/src/runs/foreground/foreground-control.d.ts +24 -0
- package/src/runs/foreground/foreground-control.js +138 -0
- package/src/runs/foreground/foreground-history.d.ts +25 -0
- package/src/runs/foreground/foreground-history.js +267 -0
- package/src/runs/foreground/prompt-audit.d.ts +32 -0
- package/src/runs/foreground/prompt-audit.js +138 -0
- package/src/runs/foreground/subagent-executor.d.ts +316 -0
- package/src/runs/foreground/subagent-executor.js +7986 -0
- package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
- package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
- package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
- package/src/runs/foreground/workflow-foreground-steering.js +148 -0
- package/src/runs/shared/abort-recovery.d.ts +26 -0
- package/src/runs/shared/abort-recovery.js +108 -0
- package/src/runs/shared/acceptance.d.ts +144 -0
- package/src/runs/shared/acceptance.js +1616 -0
- package/src/runs/shared/agent-contract.d.ts +5 -0
- package/src/runs/shared/agent-contract.js +35 -0
- package/src/runs/shared/async-status-projection.d.ts +100 -0
- package/src/runs/shared/async-status-projection.js +566 -0
- package/src/runs/shared/background-process-options.d.ts +4 -0
- package/src/runs/shared/background-process-options.js +6 -0
- package/src/runs/shared/capability-ceiling.d.ts +58 -0
- package/src/runs/shared/capability-ceiling.js +179 -0
- package/src/runs/shared/chain-outputs.d.ts +18 -0
- package/src/runs/shared/chain-outputs.js +104 -0
- package/src/runs/shared/child-commands.d.ts +29 -0
- package/src/runs/shared/child-commands.js +254 -0
- package/src/runs/shared/child-hooks.d.ts +31 -0
- package/src/runs/shared/child-hooks.js +173 -0
- package/src/runs/shared/child-identity.d.ts +23 -0
- package/src/runs/shared/child-identity.js +40 -0
- package/src/runs/shared/child-launch-plan.d.ts +70 -0
- package/src/runs/shared/child-launch-plan.js +88 -0
- package/src/runs/shared/child-launch.d.ts +128 -0
- package/src/runs/shared/child-launch.js +262 -0
- package/src/runs/shared/child-lifecycle.d.ts +13 -0
- package/src/runs/shared/child-lifecycle.js +22 -0
- package/src/runs/shared/child-runtime-config.d.ts +111 -0
- package/src/runs/shared/child-runtime-config.js +44 -0
- package/src/runs/shared/child-session.d.ts +178 -0
- package/src/runs/shared/child-session.js +726 -0
- package/src/runs/shared/child-tool-plan.d.ts +101 -0
- package/src/runs/shared/child-tool-plan.js +430 -0
- package/src/runs/shared/claude-code-adapter.d.ts +80 -0
- package/src/runs/shared/claude-code-adapter.js +255 -0
- package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
- package/src/runs/shared/codex-exec-adapter.js +127 -0
- package/src/runs/shared/context-mode.d.ts +12 -0
- package/src/runs/shared/context-mode.js +38 -0
- package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
- package/src/runs/shared/cursor-agent-adapter.js +99 -0
- package/src/runs/shared/dynamic-fanout.d.ts +49 -0
- package/src/runs/shared/dynamic-fanout.js +273 -0
- package/src/runs/shared/effective-system-prompt.d.ts +17 -0
- package/src/runs/shared/effective-system-prompt.js +23 -0
- package/src/runs/shared/extension-bindings.d.ts +25 -0
- package/src/runs/shared/extension-bindings.js +96 -0
- package/src/runs/shared/external-cli-contract.d.ts +29 -0
- package/src/runs/shared/external-cli-contract.js +145 -0
- package/src/runs/shared/external-cli-preflight.d.ts +41 -0
- package/src/runs/shared/external-cli-preflight.js +159 -0
- package/src/runs/shared/external-cli-runner.d.ts +65 -0
- package/src/runs/shared/external-cli-runner.js +425 -0
- package/src/runs/shared/external-job-bridge.d.ts +24 -0
- package/src/runs/shared/external-job-bridge.js +486 -0
- package/src/runs/shared/external-job-runner.d.ts +44 -0
- package/src/runs/shared/external-job-runner.js +352 -0
- package/src/runs/shared/fast-mode-extension.d.ts +3 -0
- package/src/runs/shared/fast-mode-extension.js +8 -0
- package/src/runs/shared/fork-placed-env.d.ts +4 -0
- package/src/runs/shared/fork-placed-env.js +13 -0
- package/src/runs/shared/git-environment.d.ts +2 -0
- package/src/runs/shared/git-environment.js +27 -0
- package/src/runs/shared/herdr-connection.d.ts +79 -0
- package/src/runs/shared/herdr-connection.js +269 -0
- package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
- package/src/runs/shared/herdr-external-adapters.js +404 -0
- package/src/runs/shared/herdr-machine.d.ts +59 -0
- package/src/runs/shared/herdr-machine.js +294 -0
- package/src/runs/shared/herdr-pane-host.d.ts +88 -0
- package/src/runs/shared/herdr-pane-host.js +155 -0
- package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
- package/src/runs/shared/herdr-pi-protocol.js +57 -0
- package/src/runs/shared/herdr-placed-run.d.ts +144 -0
- package/src/runs/shared/herdr-placed-run.js +380 -0
- package/src/runs/shared/host-step-status.d.ts +33 -0
- package/src/runs/shared/host-step-status.js +244 -0
- package/src/runs/shared/lane-metadata.d.ts +23 -0
- package/src/runs/shared/lane-metadata.js +126 -0
- package/src/runs/shared/launch-cwd.d.ts +1 -0
- package/src/runs/shared/launch-cwd.js +16 -0
- package/src/runs/shared/local-machine-access.d.ts +5 -0
- package/src/runs/shared/local-machine-access.js +28 -0
- package/src/runs/shared/long-running-guard.d.ts +34 -0
- package/src/runs/shared/long-running-guard.js +256 -0
- package/src/runs/shared/mcp-config-sources.d.ts +33 -0
- package/src/runs/shared/mcp-config-sources.js +418 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
- package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
- package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
- package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
- package/src/runs/shared/model-resolution-diagnostic.js +116 -0
- package/src/runs/shared/model-resolution.d.ts +109 -0
- package/src/runs/shared/model-resolution.js +411 -0
- package/src/runs/shared/model-scope.d.ts +68 -0
- package/src/runs/shared/model-scope.js +171 -0
- package/src/runs/shared/mutation-evidence.d.ts +18 -0
- package/src/runs/shared/mutation-evidence.js +198 -0
- package/src/runs/shared/nested-events.d.ts +135 -0
- package/src/runs/shared/nested-events.js +1090 -0
- package/src/runs/shared/nested-path.d.ts +8 -0
- package/src/runs/shared/nested-path.js +34 -0
- package/src/runs/shared/nested-render.d.ts +20 -0
- package/src/runs/shared/nested-render.js +115 -0
- package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
- package/src/runs/shared/orca-progress-tabs.js +503 -0
- package/src/runs/shared/parallel-handoff.d.ts +78 -0
- package/src/runs/shared/parallel-handoff.js +783 -0
- package/src/runs/shared/parallel-utils.d.ts +177 -0
- package/src/runs/shared/parallel-utils.js +125 -0
- package/src/runs/shared/partial-output.d.ts +24 -0
- package/src/runs/shared/partial-output.js +35 -0
- package/src/runs/shared/permissions.d.ts +12 -0
- package/src/runs/shared/permissions.js +92 -0
- package/src/runs/shared/pi-spawn.d.ts +31 -0
- package/src/runs/shared/pi-spawn.js +211 -0
- package/src/runs/shared/placed-run-owner.d.ts +49 -0
- package/src/runs/shared/placed-run-owner.js +93 -0
- package/src/runs/shared/placement-host.d.ts +99 -0
- package/src/runs/shared/placement-host.js +157 -0
- package/src/runs/shared/process-signal.d.ts +15 -0
- package/src/runs/shared/process-signal.js +21 -0
- package/src/runs/shared/profile-extensions.d.ts +21 -0
- package/src/runs/shared/profile-extensions.js +122 -0
- package/src/runs/shared/profile-launch-env.d.ts +26 -0
- package/src/runs/shared/profile-launch-env.js +90 -0
- package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
- package/src/runs/shared/readonly-drain-observation.js +50 -0
- package/src/runs/shared/rex-machine.d.ts +25 -0
- package/src/runs/shared/rex-machine.js +83 -0
- package/src/runs/shared/rex-pane-host.d.ts +62 -0
- package/src/runs/shared/rex-pane-host.js +327 -0
- package/src/runs/shared/run-fanout-budget.d.ts +14 -0
- package/src/runs/shared/run-fanout-budget.js +258 -0
- package/src/runs/shared/run-ownership.d.ts +3 -0
- package/src/runs/shared/run-ownership.js +8 -0
- package/src/runs/shared/runner-launcher.d.ts +11 -0
- package/src/runs/shared/runner-launcher.js +24 -0
- package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
- package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
- package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
- package/src/runs/shared/sandbox-profile-guard.js +106 -0
- package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
- package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
- package/src/runs/shared/session-lease.d.ts +69 -0
- package/src/runs/shared/session-lease.js +250 -0
- package/src/runs/shared/single-output.d.ts +90 -0
- package/src/runs/shared/single-output.js +349 -0
- package/src/runs/shared/spawn-budget.d.ts +20 -0
- package/src/runs/shared/spawn-budget.js +93 -0
- package/src/runs/shared/structured-output.d.ts +66 -0
- package/src/runs/shared/structured-output.js +483 -0
- package/src/runs/shared/subagent-control.d.ts +50 -0
- package/src/runs/shared/subagent-control.js +247 -0
- package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
- package/src/runs/shared/subagent-prompt-runtime.js +776 -0
- package/src/runs/shared/tool-availability.d.ts +16 -0
- package/src/runs/shared/tool-availability.js +29 -0
- package/src/runs/shared/tool-budget.d.ts +21 -0
- package/src/runs/shared/tool-budget.js +78 -0
- package/src/runs/shared/tool-timeout.d.ts +31 -0
- package/src/runs/shared/tool-timeout.js +73 -0
- package/src/runs/shared/usage-budget.d.ts +7 -0
- package/src/runs/shared/usage-budget.js +74 -0
- package/src/runs/shared/usage-reconciliation.d.ts +8 -0
- package/src/runs/shared/usage-reconciliation.js +71 -0
- package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
- package/src/runs/shared/workflow-async-child-guidance.js +17 -0
- package/src/runs/shared/workflow-graph.d.ts +31 -0
- package/src/runs/shared/workflow-graph.js +221 -0
- package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
- package/src/runs/shared/worktree-cleanup-apply.js +178 -0
- package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
- package/src/runs/shared/worktree-cleanup-plan.js +803 -0
- package/src/runs/shared/worktree-lock.d.ts +5 -0
- package/src/runs/shared/worktree-lock.js +40 -0
- package/src/runs/shared/worktree-setup-command.d.ts +38 -0
- package/src/runs/shared/worktree-setup-command.js +200 -0
- package/src/runs/shared/worktree.d.ts +181 -0
- package/src/runs/shared/worktree.js +1346 -0
- package/src/shared/accessible-dir.d.ts +11 -0
- package/src/shared/accessible-dir.js +39 -0
- package/src/shared/agent-stream-options.d.ts +5 -0
- package/src/shared/agent-stream-options.js +3 -0
- package/src/shared/artifacts.d.ts +22 -0
- package/src/shared/artifacts.js +272 -0
- package/src/shared/atomic-json.d.ts +19 -0
- package/src/shared/atomic-json.js +61 -0
- package/src/shared/capacity-resilient-json.d.ts +26 -0
- package/src/shared/capacity-resilient-json.js +86 -0
- package/src/shared/child-cache-retention.d.ts +29 -0
- package/src/shared/child-cache-retention.js +40 -0
- package/src/shared/child-session-name.d.ts +8 -0
- package/src/shared/child-session-name.js +40 -0
- package/src/shared/child-transcript.d.ts +37 -0
- package/src/shared/child-transcript.js +225 -0
- package/src/shared/completion-owner.d.ts +7 -0
- package/src/shared/completion-owner.js +13 -0
- package/src/shared/disabled-features.d.ts +93 -0
- package/src/shared/disabled-features.js +120 -0
- package/src/shared/display-text.d.ts +5 -0
- package/src/shared/display-text.js +154 -0
- package/src/shared/edit-distance.d.ts +4 -0
- package/src/shared/edit-distance.js +32 -0
- package/src/shared/extension-context.d.ts +21 -0
- package/src/shared/extension-context.js +39 -0
- package/src/shared/file-coalescer.d.ts +11 -0
- package/src/shared/file-coalescer.js +34 -0
- package/src/shared/file-lease.d.ts +10 -0
- package/src/shared/file-lease.js +106 -0
- package/src/shared/file-system-retry.d.ts +31 -0
- package/src/shared/file-system-retry.js +84 -0
- package/src/shared/fork-context.d.ts +64 -0
- package/src/shared/fork-context.js +185 -0
- package/src/shared/fork-session-cwd.d.ts +2 -0
- package/src/shared/fork-session-cwd.js +23 -0
- package/src/shared/formatters.d.ts +35 -0
- package/src/shared/formatters.js +137 -0
- package/src/shared/jsonl-writer.d.ts +20 -0
- package/src/shared/jsonl-writer.js +67 -0
- package/src/shared/launch-contract.d.ts +65 -0
- package/src/shared/launch-contract.js +145 -0
- package/src/shared/model-info.d.ts +55 -0
- package/src/shared/model-info.js +103 -0
- package/src/shared/model-response-aliases.d.ts +1 -0
- package/src/shared/model-response-aliases.js +15 -0
- package/src/shared/node-executable.d.ts +1 -0
- package/src/shared/node-executable.js +20 -0
- package/src/shared/opencode-session-headers.d.ts +12 -0
- package/src/shared/opencode-session-headers.js +26 -0
- package/src/shared/package-version.d.ts +2 -0
- package/src/shared/package-version.js +14 -0
- package/src/shared/parent-wake.d.ts +26 -0
- package/src/shared/parent-wake.js +68 -0
- package/src/shared/permission-profile.d.ts +26 -0
- package/src/shared/permission-profile.js +49 -0
- package/src/shared/prompt-resources.d.ts +5 -0
- package/src/shared/prompt-resources.js +10 -0
- package/src/shared/provider-diagnostics.d.ts +9 -0
- package/src/shared/provider-diagnostics.js +75 -0
- package/src/shared/pruned-fork.d.ts +34 -0
- package/src/shared/pruned-fork.js +434 -0
- package/src/shared/required-child-extensions.d.ts +34 -0
- package/src/shared/required-child-extensions.js +105 -0
- package/src/shared/runtime-module-path.d.ts +10 -0
- package/src/shared/runtime-module-path.js +16 -0
- package/src/shared/sandbox-profile.d.ts +12 -0
- package/src/shared/sandbox-profile.js +35 -0
- package/src/shared/session-file-trust.d.ts +1 -0
- package/src/shared/session-file-trust.js +20 -0
- package/src/shared/session-identity.d.ts +8 -0
- package/src/shared/session-identity.js +32 -0
- package/src/shared/session-succession.d.ts +4 -0
- package/src/shared/session-succession.js +24 -0
- package/src/shared/session-tokens.d.ts +2 -0
- package/src/shared/session-tokens.js +58 -0
- package/src/shared/settings-file-lease.d.ts +4 -0
- package/src/shared/settings-file-lease.js +38 -0
- package/src/shared/settings.d.ts +146 -0
- package/src/shared/settings.js +247 -0
- package/src/shared/shortcuts.d.ts +1 -0
- package/src/shared/shortcuts.js +17 -0
- package/src/shared/status-format.d.ts +9 -0
- package/src/shared/status-format.js +60 -0
- package/src/shared/thinking-ceiling.d.ts +13 -0
- package/src/shared/thinking-ceiling.js +37 -0
- package/src/shared/types.d.ts +2840 -0
- package/src/shared/types.js +276 -0
- package/src/shared/utf8.d.ts +5 -0
- package/src/shared/utf8.js +12 -0
- package/src/shared/utils.d.ts +83 -0
- package/src/shared/utils.js +612 -0
- package/src/shared/watch-strategy.d.ts +2 -0
- package/src/shared/watch-strategy.js +5 -0
- package/src/shared/workflow-child-permit.d.ts +58 -0
- package/src/shared/workflow-child-permit.js +159 -0
- package/src/slash/delegation-adapters.d.ts +154 -0
- package/src/slash/delegation-adapters.js +316 -0
- package/src/slash/delegation-json.d.ts +10 -0
- package/src/slash/delegation-json.js +117 -0
- package/src/slash/delegation-request.d.ts +12 -0
- package/src/slash/delegation-request.js +174 -0
- package/src/slash/prompt-template-bridge.d.ts +29 -0
- package/src/slash/prompt-template-bridge.js +399 -0
- package/src/slash/prompt-workflows.d.ts +21 -0
- package/src/slash/prompt-workflows.js +274 -0
- package/src/slash/selector.d.ts +47 -0
- package/src/slash/selector.js +117 -0
- package/src/slash/slash-bridge.d.ts +30 -0
- package/src/slash/slash-bridge.js +132 -0
- package/src/slash/slash-commands.d.ts +10 -0
- package/src/slash/slash-commands.js +1059 -0
- package/src/slash/slash-live-state.d.ts +21 -0
- package/src/slash/slash-live-state.js +263 -0
- package/src/slash/subagent-cost.d.ts +29 -0
- package/src/slash/subagent-cost.js +310 -0
- package/src/slash/subagents-admin.d.ts +3 -0
- package/src/slash/subagents-admin.js +481 -0
- package/src/tui/fleet-layout.d.ts +20 -0
- package/src/tui/fleet-layout.js +17 -0
- package/src/tui/fleet-native-transcript.d.ts +53 -0
- package/src/tui/fleet-native-transcript.js +339 -0
- package/src/tui/fleet-status.d.ts +92 -0
- package/src/tui/fleet-status.js +1132 -0
- package/src/tui/fleet-transcript.d.ts +64 -0
- package/src/tui/fleet-transcript.js +544 -0
- package/src/tui/fleet-viewport.d.ts +12 -0
- package/src/tui/fleet-viewport.js +35 -0
- package/src/tui/fleet.d.ts +196 -0
- package/src/tui/fleet.js +1588 -0
- package/src/tui/mouse-events.d.ts +21 -0
- package/src/tui/mouse-events.js +26 -0
- package/src/tui/render-helpers.d.ts +23 -0
- package/src/tui/render-helpers.js +100 -0
- package/src/tui/render.d.ts +66 -0
- package/src/tui/render.js +3707 -0
- package/src/tui/running-tone.d.ts +10 -0
- package/src/tui/running-tone.js +22 -0
- package/src/tui/subagent-messages.d.ts +22 -0
- package/src/tui/subagent-messages.js +270 -0
- package/src/ui-silent-marker.d.ts +20 -0
- package/src/ui-silent-marker.js +25 -0
- package/src/watchdog/change-signature.d.ts +7 -0
- package/src/watchdog/change-signature.js +243 -0
- package/src/watchdog/child-status.d.ts +53 -0
- package/src/watchdog/child-status.js +187 -0
- package/src/watchdog/diff-tool.d.ts +25 -0
- package/src/watchdog/diff-tool.js +104 -0
- package/src/watchdog/emission-guard.d.ts +36 -0
- package/src/watchdog/emission-guard.js +97 -0
- package/src/watchdog/guidance.d.ts +3 -0
- package/src/watchdog/guidance.js +19 -0
- package/src/watchdog/lsp-diagnostics.d.ts +17 -0
- package/src/watchdog/lsp-diagnostics.js +489 -0
- package/src/watchdog/model-selection.d.ts +24 -0
- package/src/watchdog/model-selection.js +167 -0
- package/src/watchdog/permission-arbiter.d.ts +20 -0
- package/src/watchdog/permission-arbiter.js +135 -0
- package/src/watchdog/register-child.d.ts +13 -0
- package/src/watchdog/register-child.js +128 -0
- package/src/watchdog/register-main.d.ts +11 -0
- package/src/watchdog/register-main.js +400 -0
- package/src/watchdog/render.d.ts +3 -0
- package/src/watchdog/render.js +33 -0
- package/src/watchdog/review.d.ts +36 -0
- package/src/watchdog/review.js +319 -0
- package/src/watchdog/rules.d.ts +21 -0
- package/src/watchdog/rules.js +58 -0
- package/src/watchdog/runtime.d.ts +195 -0
- package/src/watchdog/runtime.js +864 -0
- package/src/watchdog/scope.d.ts +14 -0
- package/src/watchdog/scope.js +44 -0
- package/src/watchdog/settings.d.ts +29 -0
- package/src/watchdog/settings.js +480 -0
- package/src/watchdog/tool-actions.d.ts +17 -0
- package/src/watchdog/tool-actions.js +150 -0
- package/src/watchdog/turn-delta.d.ts +15 -0
- package/src/watchdog/turn-delta.js +188 -0
- package/src/watchdog/types.d.ts +141 -0
- package/src/watchdog/types.js +27 -0
- package/src/watchdog/warning-format.d.ts +7 -0
- package/src/watchdog/warning-format.js +59 -0
- package/src/workflows/chat-progress.d.ts +37 -0
- package/src/workflows/chat-progress.js +129 -0
- package/src/workflows/host-command.d.ts +30 -0
- package/src/workflows/host-command.js +227 -0
- package/src/workflows/scripted-workflow.d.ts +204 -0
- package/src/workflows/scripted-workflow.js +1673 -0
- package/src/workflows/structured-workflow-scripts.d.ts +10 -0
- package/src/workflows/structured-workflow-scripts.js +179 -0
- package/src/workflows/workflow-auto-resume.d.ts +32 -0
- package/src/workflows/workflow-auto-resume.js +102 -0
- package/src/workflows/workflow-checklist.d.ts +127 -0
- package/src/workflows/workflow-checklist.js +314 -0
- package/src/workflows/workflow-child-summary.d.ts +24 -0
- package/src/workflows/workflow-child-summary.js +195 -0
- package/src/workflows/workflow-launch-record.d.ts +27 -0
- package/src/workflows/workflow-launch-record.js +48 -0
- package/src/workflows/workflow-preflight.d.ts +58 -0
- package/src/workflows/workflow-preflight.js +288 -0
- package/src/workflows/workflow-receipt.d.ts +34 -0
- package/src/workflows/workflow-receipt.js +454 -0
- package/src/workflows/workflow-resources.d.ts +55 -0
- package/src/workflows/workflow-resources.js +271 -0
- package/src/workflows/workflow-resume-claim.d.ts +82 -0
- package/src/workflows/workflow-resume-claim.js +210 -0
- package/src/workflows/workflow-resume.d.ts +56 -0
- package/src/workflows/workflow-resume.js +106 -0
- package/src/workflows/workflow-reuse.d.ts +61 -0
- package/src/workflows/workflow-reuse.js +186 -0
- package/src/workflows/workflow-revival.d.ts +33 -0
- package/src/workflows/workflow-revival.js +111 -0
- package/src/workflows/workflow-settlement.d.ts +84 -0
- package/src/workflows/workflow-settlement.js +203 -0
- package/src/workflows/workflow-stop-cause.d.ts +6 -0
- package/src/workflows/workflow-stop-cause.js +8 -0
- package/workflow-script-worker.cjs +1342 -0
- package/index.ts +0 -18
- package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
- package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
- package/skills/pi-subagents/references/execution-controls.md +0 -561
- package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
- package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
- package/skills/pi-subagents/references/review-and-validation.md +0 -73
- package/src/agents/advertised-agent-prompt.ts +0 -82
- package/src/agents/agent-eject.ts +0 -339
- package/src/agents/agent-management.ts +0 -1442
- package/src/agents/agent-memory.ts +0 -341
- package/src/agents/agent-refinements.ts +0 -624
- package/src/agents/agent-scope.ts +0 -10
- package/src/agents/agent-selection.ts +0 -25
- package/src/agents/agent-serializer.ts +0 -195
- package/src/agents/agents.ts +0 -3169
- package/src/agents/builtin-names.ts +0 -16
- package/src/agents/chain-serializer.ts +0 -285
- package/src/agents/frontmatter.ts +0 -153
- package/src/agents/global-npm-root.ts +0 -58
- package/src/agents/identity.ts +0 -30
- package/src/agents/proactive-skills.ts +0 -197
- package/src/agents/runtime-agent-events.ts +0 -70
- package/src/agents/runtime-agent-registry.ts +0 -457
- package/src/agents/runtime-discovery.ts +0 -39
- package/src/agents/skills.ts +0 -787
- package/src/api/agent-management.ts +0 -9
- package/src/api/agents.ts +0 -19
- package/src/api/background-work.ts +0 -206
- package/src/api/capability-ceiling.ts +0 -16
- package/src/api/child-tool-plan.ts +0 -5
- package/src/api/control-channel.ts +0 -4
- package/src/api/delegation.ts +0 -131
- package/src/api/external-job-provider.ts +0 -195
- package/src/api/external-runs.ts +0 -282
- package/src/api/inspectors.ts +0 -27
- package/src/api/intercom-bridge.ts +0 -3
- package/src/api/preflight.ts +0 -641
- package/src/api/project-panes.ts +0 -32
- package/src/api/required-child-extensions.ts +0 -6
- package/src/api/shared-types.ts +0 -29
- package/src/api/workflow-resources.ts +0 -6
- package/src/extension/config.ts +0 -262
- package/src/extension/context-injection.ts +0 -123
- package/src/extension/control-notices.ts +0 -53
- package/src/extension/declaration-pinning.ts +0 -164
- package/src/extension/doctor.ts +0 -284
- package/src/extension/fanout-child.ts +0 -282
- package/src/extension/herdr-pi-bridge.ts +0 -166
- package/src/extension/index.ts +0 -1185
- package/src/extension/public-execution.ts +0 -262
- package/src/extension/reply-workflow-script.ts +0 -67
- package/src/extension/rpc.ts +0 -881
- package/src/extension/schemas.ts +0 -337
- package/src/extension/steering-notices.ts +0 -35
- package/src/extension/subagent-guide.ts +0 -127
- package/src/extension/subagent-options.ts +0 -47
- package/src/extension/tool-activation.ts +0 -147
- package/src/extension/tool-description.ts +0 -193
- package/src/extension/tool-result.ts +0 -19
- package/src/extension/upgrade-notice.ts +0 -40
- package/src/inspectors/actions.ts +0 -174
- package/src/inspectors/ghostty/actions.ts +0 -74
- package/src/inspectors/ghostty/plugin.ts +0 -29
- package/src/inspectors/herdr/actions.ts +0 -155
- package/src/inspectors/herdr/client.ts +0 -130
- package/src/inspectors/herdr/focus.ts +0 -55
- package/src/inspectors/herdr/plugin.ts +0 -20
- package/src/inspectors/herdr/project-panes.ts +0 -733
- package/src/inspectors/inspector-runner.ts +0 -153
- package/src/inspectors/plugins.ts +0 -76
- package/src/inspectors/session-roots-codec.ts +0 -31
- package/src/inspectors/shell-command.ts +0 -16
- package/src/inspectors/tmux/actions.ts +0 -204
- package/src/inspectors/tmux/client.ts +0 -85
- package/src/inspectors/tmux/plugin.ts +0 -21
- package/src/inspectors/types.ts +0 -51
- package/src/integrations/herdr-status.ts +0 -385
- package/src/integrations/pi-web-session-liveness.ts +0 -73
- package/src/integrations/program-status.ts +0 -215
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1000
- package/src/intercom/result-intercom.ts +0 -433
- package/src/intercom/supervisor-ui.ts +0 -72
- package/src/missions/actions.ts +0 -433
- package/src/missions/goal-driver.ts +0 -177
- package/src/missions/lifecycle.ts +0 -367
- package/src/missions/store.ts +0 -613
- package/src/missions/types.ts +0 -190
- package/src/missions/workflow-state.ts +0 -281
- package/src/policy/authority.ts +0 -50
- package/src/profiles/profiles.ts +0 -674
- package/src/runs/background/active-async-capacity.ts +0 -548
- package/src/runs/background/active-run-index.ts +0 -155
- package/src/runs/background/async-execution.ts +0 -2479
- package/src/runs/background/async-job-tracker.ts +0 -869
- package/src/runs/background/async-resume.ts +0 -686
- package/src/runs/background/async-retention.ts +0 -953
- package/src/runs/background/async-status-snapshot.ts +0 -46
- package/src/runs/background/async-status.ts +0 -787
- package/src/runs/background/auto-drain.ts +0 -92
- package/src/runs/background/await-async-run.ts +0 -83
- package/src/runs/background/binary-bootstrap.ts +0 -67
- package/src/runs/background/calendar-schedule.ts +0 -90
- package/src/runs/background/chain-append.ts +0 -321
- package/src/runs/background/chain-root-attachment.ts +0 -263
- package/src/runs/background/completion-batcher.ts +0 -168
- package/src/runs/background/completion-dedupe.ts +0 -58
- package/src/runs/background/completion-replay.ts +0 -287
- package/src/runs/background/control-channel.ts +0 -659
- package/src/runs/background/fleet-view.ts +0 -692
- package/src/runs/background/index-segment.ts +0 -59
- package/src/runs/background/inspect-rpc.ts +0 -443
- package/src/runs/background/notify.ts +0 -1083
- package/src/runs/background/owned-process-tree.ts +0 -131
- package/src/runs/background/parallel-groups.ts +0 -45
- package/src/runs/background/pid-namespace.ts +0 -18
- package/src/runs/background/process-terminal-candidate.ts +0 -98
- package/src/runs/background/process-terminal.ts +0 -231
- package/src/runs/background/result-delivery-ownership.ts +0 -45
- package/src/runs/background/result-files.ts +0 -634
- package/src/runs/background/result-watcher.ts +0 -842
- package/src/runs/background/resume-guidance.ts +0 -56
- package/src/runs/background/retained-children.ts +0 -136
- package/src/runs/background/retained-nested-route-tracker.ts +0 -96
- package/src/runs/background/run-child-session.ts +0 -725
- package/src/runs/background/run-id-query.ts +0 -7
- package/src/runs/background/run-id-resolver.ts +0 -183
- package/src/runs/background/run-status.ts +0 -803
- package/src/runs/background/runner-aliases.ts +0 -183
- package/src/runs/background/runner-child-launch.ts +0 -96
- package/src/runs/background/runner-child-sessions.ts +0 -32
- package/src/runs/background/runner-http-dispatcher.ts +0 -122
- package/src/runs/background/runner-startup-failure.ts +0 -56
- package/src/runs/background/scheduled-runs.ts +0 -1222
- package/src/runs/background/stale-run-reconciler.ts +0 -463
- package/src/runs/background/steering.ts +0 -260
- package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
- package/src/runs/background/subagent-runner.ts +0 -5251
- package/src/runs/background/subagent-wait.ts +0 -895
- package/src/runs/background/terminal-run-index.ts +0 -183
- package/src/runs/background/top-level-async.ts +0 -14
- package/src/runs/background/wait-completions.ts +0 -262
- package/src/runs/background/wait-config.ts +0 -50
- package/src/runs/background/wait-subscriptions.ts +0 -354
- package/src/runs/background/wait-tool.ts +0 -57
- package/src/runs/background/workflow-terminal-proof.ts +0 -85
- package/src/runs/foreground/async-dismiss-action.ts +0 -86
- package/src/runs/foreground/async-steering-action.ts +0 -276
- package/src/runs/foreground/async-stop-action.ts +0 -216
- package/src/runs/foreground/command-action.ts +0 -41
- package/src/runs/foreground/execution.ts +0 -2315
- package/src/runs/foreground/foreground-control.ts +0 -157
- package/src/runs/foreground/foreground-history.ts +0 -164
- package/src/runs/foreground/prompt-audit.ts +0 -172
- package/src/runs/foreground/subagent-executor.ts +0 -8227
- package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
- package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
- package/src/runs/shared/abort-recovery.ts +0 -119
- package/src/runs/shared/acceptance.ts +0 -1664
- package/src/runs/shared/agent-contract.ts +0 -38
- package/src/runs/shared/async-status-projection.ts +0 -664
- package/src/runs/shared/background-process-options.ts +0 -9
- package/src/runs/shared/capability-ceiling.ts +0 -214
- package/src/runs/shared/chain-outputs.ts +0 -116
- package/src/runs/shared/child-commands.ts +0 -229
- package/src/runs/shared/child-hooks.ts +0 -175
- package/src/runs/shared/child-identity.ts +0 -62
- package/src/runs/shared/child-launch-plan.ts +0 -163
- package/src/runs/shared/child-launch.ts +0 -389
- package/src/runs/shared/child-lifecycle.ts +0 -28
- package/src/runs/shared/child-runtime-config.ts +0 -136
- package/src/runs/shared/child-session.ts +0 -699
- package/src/runs/shared/child-tool-plan.ts +0 -599
- package/src/runs/shared/claude-code-adapter.ts +0 -288
- package/src/runs/shared/codex-exec-adapter.ts +0 -129
- package/src/runs/shared/context-mode.ts +0 -44
- package/src/runs/shared/cursor-agent-adapter.ts +0 -114
- package/src/runs/shared/dynamic-fanout.ts +0 -297
- package/src/runs/shared/effective-system-prompt.ts +0 -33
- package/src/runs/shared/extension-bindings.ts +0 -103
- package/src/runs/shared/external-cli-contract.ts +0 -177
- package/src/runs/shared/external-cli-preflight.ts +0 -190
- package/src/runs/shared/external-cli-runner.ts +0 -437
- package/src/runs/shared/external-job-bridge.ts +0 -514
- package/src/runs/shared/external-job-runner.ts +0 -389
- package/src/runs/shared/fast-mode-extension.ts +0 -10
- package/src/runs/shared/fork-command-result.ts +0 -10
- package/src/runs/shared/git-environment.ts +0 -29
- package/src/runs/shared/herdr-connection.ts +0 -134
- package/src/runs/shared/herdr-external-adapters.ts +0 -169
- package/src/runs/shared/herdr-machine.ts +0 -279
- package/src/runs/shared/herdr-pi-protocol.ts +0 -59
- package/src/runs/shared/herdr-placed-run.ts +0 -264
- package/src/runs/shared/host-step-status.ts +0 -231
- package/src/runs/shared/lane-metadata.ts +0 -126
- package/src/runs/shared/launch-cwd.ts +0 -16
- package/src/runs/shared/long-running-guard.ts +0 -221
- package/src/runs/shared/mcp-config-sources.ts +0 -426
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
- package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
- package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
- package/src/runs/shared/model-resolution.ts +0 -503
- package/src/runs/shared/model-scope.ts +0 -224
- package/src/runs/shared/mutation-evidence.ts +0 -199
- package/src/runs/shared/nested-events.ts +0 -1125
- package/src/runs/shared/nested-path.ts +0 -38
- package/src/runs/shared/nested-render.ts +0 -127
- package/src/runs/shared/orca-progress-tabs.ts +0 -511
- package/src/runs/shared/parallel-handoff.ts +0 -789
- package/src/runs/shared/parallel-utils.ts +0 -292
- package/src/runs/shared/partial-output.ts +0 -48
- package/src/runs/shared/permissions.ts +0 -86
- package/src/runs/shared/pi-spawn.ts +0 -205
- package/src/runs/shared/process-signal.ts +0 -35
- package/src/runs/shared/profile-extensions.ts +0 -134
- package/src/runs/shared/profile-launch-env.ts +0 -121
- package/src/runs/shared/readonly-drain-observation.ts +0 -42
- package/src/runs/shared/run-fanout-budget.ts +0 -267
- package/src/runs/shared/run-history.ts +0 -288
- package/src/runs/shared/runner-launcher.ts +0 -25
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
- package/src/runs/shared/sandbox-profile-guard.ts +0 -119
- package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
- package/src/runs/shared/session-lease.ts +0 -293
- package/src/runs/shared/single-output.ts +0 -366
- package/src/runs/shared/spawn-budget.ts +0 -128
- package/src/runs/shared/structured-output.ts +0 -463
- package/src/runs/shared/subagent-control.ts +0 -295
- package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
- package/src/runs/shared/tool-availability.ts +0 -37
- package/src/runs/shared/tool-budget.ts +0 -87
- package/src/runs/shared/tool-timeout.ts +0 -93
- package/src/runs/shared/usage-budget.ts +0 -65
- package/src/runs/shared/usage-reconciliation.ts +0 -73
- package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
- package/src/runs/shared/workflow-graph.ts +0 -225
- package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
- package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
- package/src/runs/shared/worktree-lock.ts +0 -29
- package/src/runs/shared/worktree-setup-command.ts +0 -213
- package/src/runs/shared/worktree.ts +0 -1554
- package/src/shared/accessible-dir.ts +0 -47
- package/src/shared/agent-stream-options.ts +0 -5
- package/src/shared/artifacts.ts +0 -281
- package/src/shared/atomic-json.ts +0 -85
- package/src/shared/capacity-resilient-json.ts +0 -102
- package/src/shared/child-cache-retention.ts +0 -43
- package/src/shared/child-session-name.ts +0 -48
- package/src/shared/child-transcript.ts +0 -264
- package/src/shared/completion-owner.ts +0 -14
- package/src/shared/disabled-features.ts +0 -123
- package/src/shared/display-text.ts +0 -150
- package/src/shared/edit-distance.ts +0 -33
- package/src/shared/extension-context.ts +0 -37
- package/src/shared/file-coalescer.ts +0 -49
- package/src/shared/file-lease.ts +0 -74
- package/src/shared/file-system-retry.ts +0 -95
- package/src/shared/fork-context.ts +0 -243
- package/src/shared/fork-session-cwd.ts +0 -27
- package/src/shared/formatters.ts +0 -142
- package/src/shared/jsonl-writer.ts +0 -92
- package/src/shared/launch-contract.ts +0 -206
- package/src/shared/model-info.ts +0 -132
- package/src/shared/model-response-aliases.ts +0 -13
- package/src/shared/node-executable.ts +0 -21
- package/src/shared/opencode-session-headers.ts +0 -30
- package/src/shared/package-version.ts +0 -17
- package/src/shared/parent-wake.ts +0 -79
- package/src/shared/permission-profile.ts +0 -56
- package/src/shared/prompt-resources.ts +0 -11
- package/src/shared/pruned-fork.ts +0 -469
- package/src/shared/required-child-extensions.ts +0 -115
- package/src/shared/runtime-module-path.ts +0 -19
- package/src/shared/sandbox-profile.ts +0 -37
- package/src/shared/session-file-trust.ts +0 -19
- package/src/shared/session-identity.ts +0 -10
- package/src/shared/session-tokens.ts +0 -55
- package/src/shared/settings-file-lease.ts +0 -36
- package/src/shared/settings.ts +0 -412
- package/src/shared/shortcuts.ts +0 -13
- package/src/shared/status-format.ts +0 -55
- package/src/shared/thinking-ceiling.ts +0 -46
- package/src/shared/types.ts +0 -3105
- package/src/shared/utf8.ts +0 -11
- package/src/shared/utils.ts +0 -610
- package/src/shared/watch-strategy.ts +0 -12
- package/src/shared/workflow-child-permit.ts +0 -212
- package/src/slash/delegation-adapters.ts +0 -452
- package/src/slash/delegation-json.ts +0 -108
- package/src/slash/delegation-request.ts +0 -176
- package/src/slash/prompt-template-bridge.ts +0 -434
- package/src/slash/prompt-workflows.ts +0 -298
- package/src/slash/selector.ts +0 -147
- package/src/slash/slash-bridge.ts +0 -192
- package/src/slash/slash-commands.ts +0 -1096
- package/src/slash/slash-live-state.ts +0 -310
- package/src/slash/subagent-cost.ts +0 -317
- package/src/slash/subagents-admin.ts +0 -489
- package/src/tui/fleet-native-transcript.ts +0 -424
- package/src/tui/fleet-status.ts +0 -1139
- package/src/tui/fleet-transcript.ts +0 -591
- package/src/tui/fleet.ts +0 -1618
- package/src/tui/mouse-events.ts +0 -42
- package/src/tui/render-helpers.ts +0 -111
- package/src/tui/render.ts +0 -3824
- package/src/tui/running-tone.ts +0 -28
- package/src/tui/subagent-messages.ts +0 -305
- package/src/ui-silent-marker.ts +0 -32
- package/src/watchdog/change-signature.ts +0 -260
- package/src/watchdog/child-status.ts +0 -225
- package/src/watchdog/diff-tool.ts +0 -112
- package/src/watchdog/emission-guard.ts +0 -125
- package/src/watchdog/guidance.ts +0 -20
- package/src/watchdog/lsp-diagnostics.ts +0 -538
- package/src/watchdog/model-selection.ts +0 -187
- package/src/watchdog/permission-arbiter.ts +0 -154
- package/src/watchdog/register-child.ts +0 -136
- package/src/watchdog/register-main.ts +0 -425
- package/src/watchdog/render.ts +0 -31
- package/src/watchdog/review.ts +0 -362
- package/src/watchdog/rules.ts +0 -70
- package/src/watchdog/runtime.ts +0 -927
- package/src/watchdog/scope.ts +0 -51
- package/src/watchdog/settings.ts +0 -520
- package/src/watchdog/tool-actions.ts +0 -156
- package/src/watchdog/turn-delta.ts +0 -190
- package/src/watchdog/types.ts +0 -186
- package/src/watchdog/warning-format.ts +0 -72
- package/src/workflows/chat-progress.ts +0 -152
- package/src/workflows/host-command.ts +0 -235
- package/src/workflows/scripted-workflow.ts +0 -2733
- package/src/workflows/structured-workflow-scripts.ts +0 -177
- package/src/workflows/workflow-checklist.ts +0 -442
- package/src/workflows/workflow-child-summary.ts +0 -172
- package/src/workflows/workflow-preflight.ts +0 -297
- package/src/workflows/workflow-receipt.ts +0 -390
- package/src/workflows/workflow-resources.ts +0 -275
- package/src/workflows/workflow-reuse.ts +0 -120
- package/src/workflows/workflow-revival.ts +0 -123
- package/src/workflows/workflow-settlement.ts +0 -252
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { stableJsonDigest } from "../shared/launch-contract.js";
|
|
3
|
+
import { createWorkflowResourcePermit, } from "../shared/workflow-child-permit.js";
|
|
4
|
+
import { buildStructuredWorkflowScript, isPlainRecord, TOP_LEVEL_CONTROLS_HINT } from "./structured-workflow-scripts.js";
|
|
5
|
+
const RESOURCE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
|
|
6
|
+
export const MAX_ARGS_BYTES = 16 * 1024;
|
|
7
|
+
export const MAX_ARGS_FIELDS = 16;
|
|
8
|
+
export const MAX_ARGS_ITEMS = 64;
|
|
9
|
+
export const MAX_ARGS_DEPTH = 8;
|
|
10
|
+
const MAX_STRING_BYTES = 16 * 1024;
|
|
11
|
+
function registry() {
|
|
12
|
+
const key = Symbol.for("pi-subagents.workflow-resources.v1");
|
|
13
|
+
const globalObject = globalThis;
|
|
14
|
+
const existing = globalObject[key];
|
|
15
|
+
if (existing === undefined) {
|
|
16
|
+
const created = { version: 1, bySession: new Map() };
|
|
17
|
+
globalObject[key] = created;
|
|
18
|
+
return created;
|
|
19
|
+
}
|
|
20
|
+
if (!isPlainRecord(existing) || existing.version !== 1 || !(existing.bySession instanceof Map))
|
|
21
|
+
throw new Error("Malformed or unsupported workflow resource registry.");
|
|
22
|
+
return existing;
|
|
23
|
+
}
|
|
24
|
+
/** Session ID scopes lookup, not authentication. Dispose on session_shutdown; issued permits remain valid. */
|
|
25
|
+
export function registerWorkflowResource(input) {
|
|
26
|
+
if (!isPlainRecord(input) || Object.keys(input).some((key) => key !== "sessionId" && key !== "definition"))
|
|
27
|
+
throw new Error("Workflow registration requires only sessionId and definition.");
|
|
28
|
+
const { sessionId, definition } = input;
|
|
29
|
+
if (typeof sessionId !== "string" || !sessionId || sessionId.trim() !== sessionId || sessionId.length > 256 || sessionId.includes("\0"))
|
|
30
|
+
throw new Error("Workflow registration requires a non-empty trimmed sessionId of at most 256 characters without NUL.");
|
|
31
|
+
if (!isPlainRecord(definition) || Object.keys(definition).some((key) => !["name", "version", "resolve"].includes(key)))
|
|
32
|
+
throw new Error("Workflow definition requires only name, version and resolve.");
|
|
33
|
+
const { name, version, resolve } = definition;
|
|
34
|
+
if (typeof name !== "string" || !RESOURCE_NAME_PATTERN.test(name))
|
|
35
|
+
throw new Error("Workflow definition requires a safe resource name.");
|
|
36
|
+
if (!Number.isSafeInteger(version) || version < 1)
|
|
37
|
+
throw new Error("Workflow definition version must be a positive safe integer.");
|
|
38
|
+
if (typeof resolve !== "function")
|
|
39
|
+
throw new Error("Workflow definition requires a synchronous resolve function.");
|
|
40
|
+
if (findWorkflowResource(name) || STRUCTURED_WORKFLOW_RESOURCE_NAMES.includes(name))
|
|
41
|
+
throw new Error(`Workflow resource '${name}' is a protected builtin.`);
|
|
42
|
+
const current = registry();
|
|
43
|
+
const bucket = current.bySession.get(sessionId) ?? new Map();
|
|
44
|
+
if (!(bucket instanceof Map))
|
|
45
|
+
throw new Error("Malformed workflow resource session registry.");
|
|
46
|
+
if (bucket.has(name))
|
|
47
|
+
throw new Error(`Workflow resource '${name}' is already registered in this session; dispose it first.`);
|
|
48
|
+
const snapshot = Object.freeze({ name, version, resolve });
|
|
49
|
+
bucket.set(name, snapshot);
|
|
50
|
+
current.bySession.set(sessionId, bucket);
|
|
51
|
+
let disposed = false;
|
|
52
|
+
return {
|
|
53
|
+
dispose() {
|
|
54
|
+
if (disposed)
|
|
55
|
+
return;
|
|
56
|
+
disposed = true;
|
|
57
|
+
if (bucket.get(name) === snapshot)
|
|
58
|
+
bucket.delete(name);
|
|
59
|
+
if (bucket.size === 0 && current.bySession.get(sessionId) === bucket)
|
|
60
|
+
current.bySession.delete(sessionId);
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
function jsonByteLength(value) {
|
|
65
|
+
try {
|
|
66
|
+
const encoded = JSON.stringify(value);
|
|
67
|
+
if (encoded === undefined)
|
|
68
|
+
throw new Error("must contain JSON data");
|
|
69
|
+
return Buffer.byteLength(encoded, "utf8");
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
throw new Error(`must contain plain JSON data: ${error instanceof Error ? error.message : String(error)}`);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
function validatePlainJson(value, path, depth = 0) {
|
|
76
|
+
if (depth > MAX_ARGS_DEPTH)
|
|
77
|
+
throw new Error(`${path} is too deeply nested.`);
|
|
78
|
+
if (value === null || typeof value === "boolean")
|
|
79
|
+
return;
|
|
80
|
+
if (typeof value === "string") {
|
|
81
|
+
if (!value.trim())
|
|
82
|
+
throw new Error(`${path} must not be empty.`);
|
|
83
|
+
if (Buffer.byteLength(value, "utf8") > MAX_STRING_BYTES)
|
|
84
|
+
throw new Error(`${path} exceeds ${MAX_STRING_BYTES} bytes.`);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (typeof value === "number") {
|
|
88
|
+
if (!Number.isFinite(value))
|
|
89
|
+
throw new Error(`${path} must be finite.`);
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
if (Array.isArray(value)) {
|
|
93
|
+
if (value.length > MAX_ARGS_ITEMS)
|
|
94
|
+
throw new Error(`${path} contains too many items.`);
|
|
95
|
+
for (const [index, entry] of value.entries())
|
|
96
|
+
validatePlainJson(entry, `${path}[${index}]`, depth + 1);
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
if (!isPlainRecord(value))
|
|
100
|
+
throw new Error(`${path} must contain plain JSON data.`);
|
|
101
|
+
if (Object.keys(value).length > MAX_ARGS_FIELDS)
|
|
102
|
+
throw new Error(`${path} contains too many fields.`);
|
|
103
|
+
for (const [key, entry] of Object.entries(value)) {
|
|
104
|
+
if (!key.trim())
|
|
105
|
+
throw new Error(`${path} contains an empty field name.`);
|
|
106
|
+
validatePlainJson(entry, `${path}.${key}`, depth + 1);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
export function normalizeWorkflowArgs(value) {
|
|
110
|
+
if (value === undefined)
|
|
111
|
+
return { args: {} };
|
|
112
|
+
if (!isPlainRecord(value))
|
|
113
|
+
return { error: "workflow args must be a plain JSON object." };
|
|
114
|
+
try {
|
|
115
|
+
validatePlainJson(value, "workflow args");
|
|
116
|
+
if (jsonByteLength(value) > MAX_ARGS_BYTES)
|
|
117
|
+
return { error: `workflow args exceed ${MAX_ARGS_BYTES} bytes.` };
|
|
118
|
+
return { args: JSON.parse(JSON.stringify(value)) };
|
|
119
|
+
}
|
|
120
|
+
catch (error) {
|
|
121
|
+
return { error: error instanceof Error ? error.message : String(error) };
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
export function deepFreezeWorkflowArgs(args) {
|
|
125
|
+
deepFreezeWorkflowValue(args);
|
|
126
|
+
return args;
|
|
127
|
+
}
|
|
128
|
+
function deepFreezeWorkflowValue(value) {
|
|
129
|
+
if (!Array.isArray(value) && !isPlainRecord(value))
|
|
130
|
+
return;
|
|
131
|
+
for (const entry of Object.values(value))
|
|
132
|
+
deepFreezeWorkflowValue(entry);
|
|
133
|
+
Object.freeze(value);
|
|
134
|
+
}
|
|
135
|
+
function resolveRunCi(args) {
|
|
136
|
+
const allowed = new Set(["command", "timeoutMs"]);
|
|
137
|
+
const unsupported = Object.keys(args).filter((key) => !allowed.has(key));
|
|
138
|
+
if (unsupported.length > 0)
|
|
139
|
+
return { error: `workflow 'run-ci' args contain unsupported fields: ${unsupported.join(", ")}.` };
|
|
140
|
+
const command = args.command === undefined ? "npm test" : args.command;
|
|
141
|
+
if (command !== "npm test" && command !== "npm run typecheck")
|
|
142
|
+
return { error: "workflow 'run-ci' args.command must be 'npm test' or 'npm run typecheck'." };
|
|
143
|
+
const timeoutMs = args.timeoutMs === undefined ? 120_000 : args.timeoutMs;
|
|
144
|
+
if (typeof timeoutMs !== "number" || !Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 86_400_000)
|
|
145
|
+
return { error: "workflow 'run-ci' args.timeoutMs must be an integer from 1 to 86400000." };
|
|
146
|
+
const params = { kind: "command", command, timeoutMs, role: "ci" };
|
|
147
|
+
return {
|
|
148
|
+
script: `return await runs.host("ci", ${JSON.stringify(params)});`,
|
|
149
|
+
hostCommands: [{ key: "ci", command }],
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
function resolveParallel(args) {
|
|
153
|
+
const unsupported = Object.keys(args).filter((key) => key !== "tasks");
|
|
154
|
+
if (unsupported.length > 0)
|
|
155
|
+
return { error: `workflow 'parallel' args contain unsupported fields: ${unsupported.join(", ")}. Pass args.tasks: [{ agent, task, cwd?, model? }, ...].${TOP_LEVEL_CONTROLS_HINT}` };
|
|
156
|
+
try {
|
|
157
|
+
return { script: buildStructuredWorkflowScript("tasks", args.tasks, undefined) };
|
|
158
|
+
}
|
|
159
|
+
catch (error) {
|
|
160
|
+
return { error: `workflow 'parallel' args.${error instanceof Error ? error.message : String(error)}` };
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
function resolveReview(args) {
|
|
164
|
+
const unsupported = Object.keys(args).filter((key) => key !== "task");
|
|
165
|
+
if (unsupported.length > 0)
|
|
166
|
+
return { error: `workflow 'review' args contain unsupported fields: ${unsupported.join(", ")}.` };
|
|
167
|
+
const task = args.task;
|
|
168
|
+
if (typeof task !== "string" || !task.trim())
|
|
169
|
+
return { error: "workflow 'review' requires a non-empty string args.task." };
|
|
170
|
+
return {
|
|
171
|
+
script: `return (await runs.run("review", { agent: "reviewer", task: ${JSON.stringify(task.trim())} })).output;`,
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
const WORKFLOW_RESOURCES = [
|
|
175
|
+
{ name: "review", version: 1, resolve: resolveReview },
|
|
176
|
+
{ name: "run-ci", version: 1, resolve: resolveRunCi },
|
|
177
|
+
{ name: "parallel", version: 1, resolve: resolveParallel },
|
|
178
|
+
];
|
|
179
|
+
function findWorkflowResource(name) {
|
|
180
|
+
return WORKFLOW_RESOURCES.find((resource) => resource.name === name);
|
|
181
|
+
}
|
|
182
|
+
function listWorkflowResourceNames() {
|
|
183
|
+
return WORKFLOW_RESOURCES.map((resource) => resource.name);
|
|
184
|
+
}
|
|
185
|
+
/** Internal resources for the data-only tasks/chain inputs: reserved against registration, never resolvable or listed by name. */
|
|
186
|
+
const STRUCTURED_WORKFLOW_RESOURCE_NAMES = ["tasks", "chain"];
|
|
187
|
+
const STRUCTURED_WORKFLOW_RESOURCE_VERSION = 1;
|
|
188
|
+
/**
|
|
189
|
+
* Expand data-only `tasks` or `chain` input into a package-owned workflow script with a one-use permit.
|
|
190
|
+
* Only the executor calls this, after its own feature and input checks; public named lookup cannot reach it.
|
|
191
|
+
*/
|
|
192
|
+
export function resolveStructuredWorkflowResource(input) {
|
|
193
|
+
try {
|
|
194
|
+
if (!isPlainRecord(input) || (input.kind !== "tasks" && input.kind !== "chain"))
|
|
195
|
+
return { ok: false, error: "Structured workflow kind must be 'tasks' or 'chain'." };
|
|
196
|
+
const { kind, steps, task } = input;
|
|
197
|
+
if (!Array.isArray(steps) || steps.length === 0)
|
|
198
|
+
return { ok: false, error: `${kind} must be a non-empty array.` };
|
|
199
|
+
validatePlainJson(steps, kind);
|
|
200
|
+
if (task !== undefined) {
|
|
201
|
+
if (typeof task !== "string" || !task.trim())
|
|
202
|
+
return { ok: false, error: "task must be a non-empty string when provided." };
|
|
203
|
+
validatePlainJson(task, "task");
|
|
204
|
+
}
|
|
205
|
+
if (jsonByteLength({ [kind]: steps, task }) > MAX_ARGS_BYTES)
|
|
206
|
+
return { ok: false, error: `${kind} input exceeds ${MAX_ARGS_BYTES} bytes.` };
|
|
207
|
+
const script = buildStructuredWorkflowScript(kind, JSON.parse(JSON.stringify(steps)), task);
|
|
208
|
+
return { ok: true, resource: issueWorkflowResource(kind, STRUCTURED_WORKFLOW_RESOURCE_VERSION, script) };
|
|
209
|
+
}
|
|
210
|
+
catch (error) {
|
|
211
|
+
return { ok: false, error: error instanceof Error ? error.message.slice(0, 4096) : "Structured workflow resolution failed." };
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
/** Resolve only extension-owned resources so policy can distinguish them from raw scripts; caller-provided script text is never consulted. */
|
|
215
|
+
export function resolveWorkflowResource(nameValue, argsValue, sessionId) {
|
|
216
|
+
try {
|
|
217
|
+
const result = resolveResource(nameValue, argsValue, sessionId);
|
|
218
|
+
return result.ok ? result : { ok: false, error: result.error.slice(0, 4096) };
|
|
219
|
+
}
|
|
220
|
+
catch (error) {
|
|
221
|
+
return { ok: false, error: error instanceof Error ? error.message.slice(0, 4096) : "Workflow resource resolution failed." };
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
function resolveResource(nameValue, argsValue, sessionId) {
|
|
225
|
+
if (typeof nameValue !== "string" || !nameValue.trim())
|
|
226
|
+
return { ok: false, error: "workflow must be a non-empty resource name." };
|
|
227
|
+
const name = nameValue.trim();
|
|
228
|
+
if (!RESOURCE_NAME_PATTERN.test(name))
|
|
229
|
+
return { ok: false, error: "workflow must use a safe resource name." };
|
|
230
|
+
const resource = findWorkflowResource(name) ?? (sessionId ? registry().bySession.get(sessionId)?.get(name) : undefined);
|
|
231
|
+
if (!resource)
|
|
232
|
+
return { ok: false, error: `Unknown workflow resource '${name}'. Available resources: ${listWorkflowResourceNames().join(", ")}.` };
|
|
233
|
+
const normalizedArgs = normalizeWorkflowArgs(argsValue);
|
|
234
|
+
if ("error" in normalizedArgs)
|
|
235
|
+
return { ok: false, error: normalizedArgs.error };
|
|
236
|
+
const resolved = resource.resolve(normalizedArgs.args);
|
|
237
|
+
if (resolved && typeof resolved.then === "function") {
|
|
238
|
+
void Promise.resolve(resolved).catch(() => { });
|
|
239
|
+
throw new Error("Workflow resource resolve must be synchronous.");
|
|
240
|
+
}
|
|
241
|
+
if (!isPlainRecord(resolved))
|
|
242
|
+
throw new Error("Workflow resource resolve must return an expansion or error object.");
|
|
243
|
+
if ("error" in resolved) {
|
|
244
|
+
if (Object.keys(resolved).some((key) => key !== "error") || typeof resolved.error !== "string" || !resolved.error.trim())
|
|
245
|
+
throw new Error("Workflow resource returned an invalid error.");
|
|
246
|
+
return { ok: false, error: resolved.error };
|
|
247
|
+
}
|
|
248
|
+
const { script, hostCommands } = resolved;
|
|
249
|
+
if (Object.keys(resolved).some((key) => key !== "script" && key !== "hostCommands") || typeof script !== "string" || !script.trim())
|
|
250
|
+
throw new Error("Workflow resource returned an invalid expansion.");
|
|
251
|
+
return { ok: true, resource: issueWorkflowResource(resource.name, resource.version, script, hostCommands) };
|
|
252
|
+
}
|
|
253
|
+
function issueWorkflowResource(name, version, script, hostCommands) {
|
|
254
|
+
const resourceId = randomUUID();
|
|
255
|
+
const permit = createWorkflowResourcePermit({
|
|
256
|
+
resourceName: name,
|
|
257
|
+
resourceVersion: version,
|
|
258
|
+
resourceId,
|
|
259
|
+
scriptDigest: stableJsonDigest(script),
|
|
260
|
+
authority: { host: hostCommands },
|
|
261
|
+
});
|
|
262
|
+
const provenance = Object.freeze({
|
|
263
|
+
kind: "workflow",
|
|
264
|
+
name,
|
|
265
|
+
version,
|
|
266
|
+
invocation: "named",
|
|
267
|
+
expansion: "resolved",
|
|
268
|
+
id: resourceId,
|
|
269
|
+
});
|
|
270
|
+
return { script, permit, provenance };
|
|
271
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { type PidLiveness, type RecordedPid } from "../runs/background/stale-run-reconciler.ts";
|
|
2
|
+
/**
|
|
3
|
+
* Who continues a stopped workflow run. Claims are generation files `resumed-by.<n>.json` in the
|
|
4
|
+
* stopped run's directory, and the highest n is the current claim. A claimant whose process is dead
|
|
5
|
+
* is superseded by creating the next generation, so a takeover never moves a file another taker
|
|
6
|
+
* may have just created. An owner whose launch did not start renames its own claim to
|
|
7
|
+
* `resumed-by.<n>.json.released-<uuid>`; a released top means no claim, and the next taker creates
|
|
8
|
+
* n+1, so claims below it are never judged again. Only the owner launches; once the claimed new
|
|
9
|
+
* run's status.json exists the claim is permanent.
|
|
10
|
+
*/
|
|
11
|
+
interface WorkflowResumeClaim extends RecordedPid {
|
|
12
|
+
version: 1;
|
|
13
|
+
claimedAt: number;
|
|
14
|
+
newRunId: string;
|
|
15
|
+
trigger: "auto" | "manual" | "reuse";
|
|
16
|
+
}
|
|
17
|
+
interface WorkflowResumeRefusal {
|
|
18
|
+
version: 1;
|
|
19
|
+
reason: string;
|
|
20
|
+
byHand: string;
|
|
21
|
+
newRunId?: string;
|
|
22
|
+
refusedAt: number;
|
|
23
|
+
}
|
|
24
|
+
export type WorkflowResumeClaimOutcome = {
|
|
25
|
+
kind: "owner";
|
|
26
|
+
} | {
|
|
27
|
+
kind: "resumed";
|
|
28
|
+
newRunId: string;
|
|
29
|
+
} | {
|
|
30
|
+
kind: "busy";
|
|
31
|
+
pid: number;
|
|
32
|
+
}
|
|
33
|
+
/** The current claim file exists but cannot be read, so nothing proves its claimant dead. */
|
|
34
|
+
| {
|
|
35
|
+
kind: "unreadable";
|
|
36
|
+
};
|
|
37
|
+
type WorkflowResumeClaimState = {
|
|
38
|
+
kind: "none";
|
|
39
|
+
} | {
|
|
40
|
+
kind: "resumed";
|
|
41
|
+
newRunId: string;
|
|
42
|
+
} | {
|
|
43
|
+
kind: "busy";
|
|
44
|
+
pid: number;
|
|
45
|
+
newRunId: string;
|
|
46
|
+
} | {
|
|
47
|
+
kind: "unreadable";
|
|
48
|
+
};
|
|
49
|
+
type ClaimLiveness = (claim: WorkflowResumeClaim) => PidLiveness;
|
|
50
|
+
export declare function readWorkflowResumeClaim(asyncDir: string): WorkflowResumeClaim | undefined;
|
|
51
|
+
/** True once the run that resumes the run in `sourceAsyncDir` as `newRunId` has written its first status. */
|
|
52
|
+
export declare function resumedRunStarted(sourceAsyncDir: string, newRunId: string): boolean;
|
|
53
|
+
/** Read-only view for reuse readers and auto-resume: a dead, corrupt, or missing claim blocks nothing. */
|
|
54
|
+
export declare function workflowResumeClaimState(asyncDir: string, options?: {
|
|
55
|
+
liveness?: ClaimLiveness;
|
|
56
|
+
}): WorkflowResumeClaimState;
|
|
57
|
+
/**
|
|
58
|
+
* Claims the right to continue the stopped run in `asyncDir` as `newRunId`. A dead claimant is
|
|
59
|
+
* superseded by the next generation file; of several takers, the one whose exclusive create
|
|
60
|
+
* succeeds owns the run, and the others see its live claim on their next read.
|
|
61
|
+
*/
|
|
62
|
+
export declare function claimWorkflowResume(asyncDir: string, input: {
|
|
63
|
+
newRunId: string;
|
|
64
|
+
trigger: WorkflowResumeClaim["trigger"];
|
|
65
|
+
now?: number;
|
|
66
|
+
liveness?: ClaimLiveness;
|
|
67
|
+
}): WorkflowResumeClaimOutcome;
|
|
68
|
+
/** Gives up this process's claim on a launch that did not start, so the run can be continued again. */
|
|
69
|
+
export declare function releaseWorkflowResumeClaim(asyncDir: string, newRunId: string): void;
|
|
70
|
+
export declare function recordWorkflowResumeRefusal(asyncDir: string, refusal: Omit<WorkflowResumeRefusal, "version" | "refusedAt">, now?: number): void;
|
|
71
|
+
export declare function resumeByHandText(runId: string): string;
|
|
72
|
+
export declare function relaunchByHandText(runId: string): string;
|
|
73
|
+
/** `<reason>. <byHand>`; some reasons quote a message that already ends in a period. */
|
|
74
|
+
export declare function refusalSentence(reason: string, byHand: string): string;
|
|
75
|
+
/** A refusal was recorded for this run; the run is not tried again automatically. */
|
|
76
|
+
export declare function hasWorkflowResumeRefusal(asyncDir: string): boolean;
|
|
77
|
+
/**
|
|
78
|
+
* The one line an interrupted workflow's notice carries about what happens next: the recorded
|
|
79
|
+
* auto-resume refusal, else who continues the run, else how to continue it by hand.
|
|
80
|
+
*/
|
|
81
|
+
export declare function describeWorkflowResume(asyncDir: string, runId: string): string;
|
|
82
|
+
export {};
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
import { writeAtomicJson } from "../shared/atomic-json.js";
|
|
5
|
+
import { currentBootId, currentRecordedPid } from "../runs/background/boot-id.js";
|
|
6
|
+
import { currentPidNamespaceScope } from "../runs/background/pid-namespace.js";
|
|
7
|
+
import { checkRecordedPidLiveness, isRecordedPid } from "../runs/background/stale-run-reconciler.js";
|
|
8
|
+
import { readWorkflowLaunchRecord } from "./workflow-launch-record.js";
|
|
9
|
+
const CLAIM_FILE_PATTERN = /^resumed-by\.([1-9][0-9]*)\.json$/;
|
|
10
|
+
const RELEASED_CLAIM_FILE_PATTERN = /^resumed-by\.([1-9][0-9]*)\.json\.released-/;
|
|
11
|
+
const REFUSAL_FILE = "resume-refused.json";
|
|
12
|
+
const MAX_CLAIM_ROUNDS = 8;
|
|
13
|
+
// Claims this process holds, shared by every runtime in the process so a reload keeps them.
|
|
14
|
+
const heldClaimsKey = Symbol.for("pi-subagents.workflow-resume-claims.v1");
|
|
15
|
+
const heldClaimsGlobal = globalThis;
|
|
16
|
+
const heldClaims = heldClaimsGlobal[heldClaimsKey] ?? (heldClaimsGlobal[heldClaimsKey] = new Set());
|
|
17
|
+
function claimFilePath(asyncDir, generation) {
|
|
18
|
+
return path.join(asyncDir, `resumed-by.${generation}.json`);
|
|
19
|
+
}
|
|
20
|
+
function isClaim(value) {
|
|
21
|
+
if (!isRecordedPid(value) || Array.isArray(value))
|
|
22
|
+
return false;
|
|
23
|
+
const claim = value;
|
|
24
|
+
return claim.version === 1
|
|
25
|
+
&& typeof claim.claimedAt === "number"
|
|
26
|
+
&& typeof claim.newRunId === "string" && claim.newRunId.length > 0
|
|
27
|
+
&& (claim.trigger === "auto" || claim.trigger === "manual" || claim.trigger === "reuse");
|
|
28
|
+
}
|
|
29
|
+
function readTopClaim(asyncDir, retries = 3) {
|
|
30
|
+
let generation = 0;
|
|
31
|
+
let releasedGeneration = 0;
|
|
32
|
+
try {
|
|
33
|
+
for (const name of fs.readdirSync(asyncDir)) {
|
|
34
|
+
const live = CLAIM_FILE_PATTERN.exec(name);
|
|
35
|
+
if (live)
|
|
36
|
+
generation = Math.max(generation, Number(live[1]));
|
|
37
|
+
const released = RELEASED_CLAIM_FILE_PATTERN.exec(name);
|
|
38
|
+
if (released)
|
|
39
|
+
releasedGeneration = Math.max(releasedGeneration, Number(released[1]));
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
catch (error) {
|
|
43
|
+
return error.code === "ENOENT" ? { kind: "open", generation: 0 } : { kind: "unreadable" };
|
|
44
|
+
}
|
|
45
|
+
// A live file and a released one with the same n: the live one was created after the release.
|
|
46
|
+
if (releasedGeneration > generation || generation === 0)
|
|
47
|
+
return { kind: "open", generation: Math.max(releasedGeneration, generation) };
|
|
48
|
+
const filePath = claimFilePath(asyncDir, generation);
|
|
49
|
+
let text;
|
|
50
|
+
try {
|
|
51
|
+
text = fs.readFileSync(filePath, "utf-8");
|
|
52
|
+
}
|
|
53
|
+
catch (error) {
|
|
54
|
+
// A release renamed it after the listing: look again.
|
|
55
|
+
if (error.code === "ENOENT" && retries > 0)
|
|
56
|
+
return readTopClaim(asyncDir, retries - 1);
|
|
57
|
+
return { kind: "unreadable" };
|
|
58
|
+
}
|
|
59
|
+
try {
|
|
60
|
+
const value = JSON.parse(text);
|
|
61
|
+
// The file is created whole, so a body that does not parse is corrupt, not half-written.
|
|
62
|
+
return isClaim(value) ? { kind: "claim", generation, filePath, claim: value } : { kind: "open", generation };
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
return { kind: "open", generation };
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
export function readWorkflowResumeClaim(asyncDir) {
|
|
69
|
+
const top = readTopClaim(asyncDir);
|
|
70
|
+
return top.kind === "claim" ? top.claim : undefined;
|
|
71
|
+
}
|
|
72
|
+
/** True once the run that resumes the run in `sourceAsyncDir` as `newRunId` has written its first status. */
|
|
73
|
+
export function resumedRunStarted(sourceAsyncDir, newRunId) {
|
|
74
|
+
return path.basename(newRunId) === newRunId
|
|
75
|
+
&& fs.existsSync(path.join(path.dirname(sourceAsyncDir), newRunId, "status.json"));
|
|
76
|
+
}
|
|
77
|
+
function claimantLiveness(filePath, claim, liveness) {
|
|
78
|
+
// A reload keeps the pid, so this process's own claim counts only while one of its runtimes holds
|
|
79
|
+
// it. The same pid in another pid namespace (a container sharing the temp root) is another process.
|
|
80
|
+
if (claim.pid === process.pid && claim.bootId === currentBootId() && claim.pidNamespaceScope === currentPidNamespaceScope())
|
|
81
|
+
return heldClaims.has(filePath) ? "alive" : "dead";
|
|
82
|
+
return liveness ? liveness(claim) : checkRecordedPidLiveness(claim);
|
|
83
|
+
}
|
|
84
|
+
/** Read-only view for reuse readers and auto-resume: a dead, corrupt, or missing claim blocks nothing. */
|
|
85
|
+
export function workflowResumeClaimState(asyncDir, options = {}) {
|
|
86
|
+
const top = readTopClaim(asyncDir);
|
|
87
|
+
if (top.kind === "unreadable")
|
|
88
|
+
return { kind: "unreadable" };
|
|
89
|
+
if (top.kind !== "claim")
|
|
90
|
+
return { kind: "none" };
|
|
91
|
+
if (resumedRunStarted(asyncDir, top.claim.newRunId))
|
|
92
|
+
return { kind: "resumed", newRunId: top.claim.newRunId };
|
|
93
|
+
return claimantLiveness(top.filePath, top.claim, options.liveness) === "dead" ? { kind: "none" } : { kind: "busy", pid: top.claim.pid, newRunId: top.claim.newRunId };
|
|
94
|
+
}
|
|
95
|
+
/** Creates the claim file only if none exists, with its whole body in place at once. */
|
|
96
|
+
function createClaimFile(filePath, claim) {
|
|
97
|
+
const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
|
|
98
|
+
try {
|
|
99
|
+
fs.writeFileSync(tempPath, JSON.stringify(claim, null, 2), "utf-8");
|
|
100
|
+
fs.linkSync(tempPath, filePath);
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
catch (error) {
|
|
104
|
+
if (error.code === "EEXIST")
|
|
105
|
+
return false;
|
|
106
|
+
throw error;
|
|
107
|
+
}
|
|
108
|
+
finally {
|
|
109
|
+
fs.rmSync(tempPath, { force: true });
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Claims the right to continue the stopped run in `asyncDir` as `newRunId`. A dead claimant is
|
|
114
|
+
* superseded by the next generation file; of several takers, the one whose exclusive create
|
|
115
|
+
* succeeds owns the run, and the others see its live claim on their next read.
|
|
116
|
+
*/
|
|
117
|
+
export function claimWorkflowResume(asyncDir, input) {
|
|
118
|
+
const claim = {
|
|
119
|
+
version: 1,
|
|
120
|
+
...currentRecordedPid(),
|
|
121
|
+
claimedAt: input.now ?? Date.now(),
|
|
122
|
+
newRunId: input.newRunId,
|
|
123
|
+
trigger: input.trigger,
|
|
124
|
+
};
|
|
125
|
+
for (let round = 0; round < MAX_CLAIM_ROUNDS; round++) {
|
|
126
|
+
const top = readTopClaim(asyncDir);
|
|
127
|
+
if (top.kind === "unreadable")
|
|
128
|
+
return { kind: "unreadable" };
|
|
129
|
+
if (top.kind === "claim") {
|
|
130
|
+
// Already claimed for this exact new run, as a resume does before it launches.
|
|
131
|
+
if (top.claim.newRunId === input.newRunId && top.claim.pid === process.pid) {
|
|
132
|
+
heldClaims.add(top.filePath);
|
|
133
|
+
return { kind: "owner" };
|
|
134
|
+
}
|
|
135
|
+
if (resumedRunStarted(asyncDir, top.claim.newRunId))
|
|
136
|
+
return { kind: "resumed", newRunId: top.claim.newRunId };
|
|
137
|
+
if (claimantLiveness(top.filePath, top.claim, input.liveness) !== "dead")
|
|
138
|
+
return { kind: "busy", pid: top.claim.pid };
|
|
139
|
+
}
|
|
140
|
+
const filePath = claimFilePath(asyncDir, top.generation + 1);
|
|
141
|
+
if (createClaimFile(filePath, claim)) {
|
|
142
|
+
heldClaims.add(filePath);
|
|
143
|
+
return { kind: "owner" };
|
|
144
|
+
}
|
|
145
|
+
// Another taker created that generation first: decide again from its claim.
|
|
146
|
+
}
|
|
147
|
+
// Every round lost to another taker; fail closed with whatever claim is there now.
|
|
148
|
+
const top = readTopClaim(asyncDir);
|
|
149
|
+
return top.kind === "claim" ? { kind: "busy", pid: top.claim.pid } : { kind: "unreadable" };
|
|
150
|
+
}
|
|
151
|
+
/** Gives up this process's claim on a launch that did not start, so the run can be continued again. */
|
|
152
|
+
export function releaseWorkflowResumeClaim(asyncDir, newRunId) {
|
|
153
|
+
const top = readTopClaim(asyncDir);
|
|
154
|
+
if (top.kind !== "claim" || top.claim.newRunId !== newRunId || top.claim.pid !== process.pid)
|
|
155
|
+
return;
|
|
156
|
+
// The only rename in the protocol: the owner moves its own claim aside.
|
|
157
|
+
try {
|
|
158
|
+
fs.renameSync(top.filePath, `${top.filePath}.released-${randomUUID()}`);
|
|
159
|
+
}
|
|
160
|
+
catch (error) {
|
|
161
|
+
if (error.code !== "ENOENT")
|
|
162
|
+
throw error;
|
|
163
|
+
}
|
|
164
|
+
heldClaims.delete(top.filePath);
|
|
165
|
+
}
|
|
166
|
+
export function recordWorkflowResumeRefusal(asyncDir, refusal, now = Date.now()) {
|
|
167
|
+
writeAtomicJson(path.join(asyncDir, REFUSAL_FILE), { version: 1, ...refusal, refusedAt: now });
|
|
168
|
+
}
|
|
169
|
+
function readWorkflowResumeRefusal(asyncDir) {
|
|
170
|
+
try {
|
|
171
|
+
const value = JSON.parse(fs.readFileSync(path.join(asyncDir, REFUSAL_FILE), "utf-8"));
|
|
172
|
+
return value?.version === 1 && typeof value.reason === "string" && typeof value.byHand === "string" && typeof value.refusedAt === "number"
|
|
173
|
+
&& (value.newRunId === undefined || typeof value.newRunId === "string")
|
|
174
|
+
? value
|
|
175
|
+
: undefined;
|
|
176
|
+
}
|
|
177
|
+
catch {
|
|
178
|
+
return undefined;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
export function resumeByHandText(runId) {
|
|
182
|
+
return `Resume by hand: subagent({ action: "resume", id: "${runId}" })`;
|
|
183
|
+
}
|
|
184
|
+
export function relaunchByHandText(runId) {
|
|
185
|
+
return `Relaunch it by hand with options: { reuseFrom: "${runId}" }.`;
|
|
186
|
+
}
|
|
187
|
+
/** `<reason>. <byHand>`; some reasons quote a message that already ends in a period. */
|
|
188
|
+
export function refusalSentence(reason, byHand) {
|
|
189
|
+
return `${reason.replace(/\.$/, "")}.${byHand ? ` ${byHand}` : ""}`;
|
|
190
|
+
}
|
|
191
|
+
/** A refusal was recorded for this run; the run is not tried again automatically. */
|
|
192
|
+
export function hasWorkflowResumeRefusal(asyncDir) {
|
|
193
|
+
return fs.existsSync(path.join(asyncDir, REFUSAL_FILE));
|
|
194
|
+
}
|
|
195
|
+
const RESUMED_AS = { auto: "Auto-resumed as", manual: "Resumed as", reuse: "Relaunched as" };
|
|
196
|
+
/**
|
|
197
|
+
* The one line an interrupted workflow's notice carries about what happens next: the recorded
|
|
198
|
+
* auto-resume refusal, else who continues the run, else how to continue it by hand.
|
|
199
|
+
*/
|
|
200
|
+
export function describeWorkflowResume(asyncDir, runId) {
|
|
201
|
+
const claim = readWorkflowResumeClaim(asyncDir);
|
|
202
|
+
const refusal = readWorkflowResumeRefusal(asyncDir);
|
|
203
|
+
if (refusal && (!claim || refusal.newRunId === claim.newRunId)) {
|
|
204
|
+
return `Not auto-resumed: ${refusalSentence(refusal.reason, refusal.byHand)}`;
|
|
205
|
+
}
|
|
206
|
+
if (claim)
|
|
207
|
+
return `${RESUMED_AS[claim.trigger]} ${claim.newRunId}.`;
|
|
208
|
+
const launch = readWorkflowLaunchRecord(asyncDir);
|
|
209
|
+
return launch.ok && launch.record.source !== "structured" ? resumeByHandText(runId) : relaunchByHandText(runId);
|
|
210
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
type WorkflowResumeTrigger = "auto" | "manual";
|
|
2
|
+
export type WorkflowResumeRefusalCode = "not-owned" | "not-interrupted" | "claim-busy" | "claim-resumed" | "launch-missing" | "launch-invalid" | "structured" | "digest" | "authority" | "capacity" | "attempts" | "launch-failed";
|
|
3
|
+
export interface WorkflowResumeRefusalReason {
|
|
4
|
+
code: WorkflowResumeRefusalCode;
|
|
5
|
+
reason: string;
|
|
6
|
+
/** How to continue the run by hand; empty when there is nothing to add. */
|
|
7
|
+
byHand: string;
|
|
8
|
+
}
|
|
9
|
+
export interface PreparedWorkflowResume {
|
|
10
|
+
sourceRunId: string;
|
|
11
|
+
sourceAsyncDir: string;
|
|
12
|
+
newRunId: string;
|
|
13
|
+
trigger: WorkflowResumeTrigger;
|
|
14
|
+
/** Public launch params for executePublic: the saved launch with async, reuseFrom and the source's ceiling. */
|
|
15
|
+
params: Record<string, unknown>;
|
|
16
|
+
expectedScriptDigest: string;
|
|
17
|
+
resumeOrigin: {
|
|
18
|
+
sourceRunId: string;
|
|
19
|
+
attempt: number;
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
type WorkflowResumePreparation = {
|
|
23
|
+
ok: true;
|
|
24
|
+
prepared: PreparedWorkflowResume;
|
|
25
|
+
} | ({
|
|
26
|
+
ok: false;
|
|
27
|
+
} & WorkflowResumeRefusalReason);
|
|
28
|
+
export declare function workflowResumeRefusal(code: WorkflowResumeRefusalCode, reason: string, runId: string): WorkflowResumeRefusalReason;
|
|
29
|
+
/** The tool error for a resume by id; the resume form is not repeated to a caller that just tried it. */
|
|
30
|
+
export declare function manualWorkflowResumeRefusalText(runId: string, refusal: Pick<WorkflowResumeRefusalReason, "reason" | "byHand">): string;
|
|
31
|
+
/**
|
|
32
|
+
* The run id a resume action relaunches: no message, task, chain or index, and an id naming a
|
|
33
|
+
* top-level workflow run. Anything else is a child resume.
|
|
34
|
+
*/
|
|
35
|
+
export declare function workflowResumeTargetId(asyncDirRoot: string, params: {
|
|
36
|
+
id?: unknown;
|
|
37
|
+
runId?: unknown;
|
|
38
|
+
message?: unknown;
|
|
39
|
+
task?: unknown;
|
|
40
|
+
chain?: unknown;
|
|
41
|
+
index?: unknown;
|
|
42
|
+
}): string | undefined;
|
|
43
|
+
/**
|
|
44
|
+
* Checks a stopped workflow run can be resumed and claims it for a new run id. Synchronous and
|
|
45
|
+
* cheap: the launch itself happens in the executor.
|
|
46
|
+
* `newRunId` presets the new run's id: a reload claims a run again under the id of the launch it cancelled.
|
|
47
|
+
*/
|
|
48
|
+
export declare function prepareWorkflowResume(input: {
|
|
49
|
+
asyncDirRoot: string;
|
|
50
|
+
sourceRunId: string;
|
|
51
|
+
trigger: WorkflowResumeTrigger;
|
|
52
|
+
now: number;
|
|
53
|
+
currentSessionId: string;
|
|
54
|
+
newRunId?: string;
|
|
55
|
+
}): WorkflowResumePreparation;
|
|
56
|
+
export {};
|