@xzzpig/pi-subagents 0.22.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 +346 -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/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 -87
- 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/supervisor-routing.ts +0 -196
- 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 -1212
- 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/fork-supervisor-routing.ts +0 -533
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1066
- 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 -8252
- 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 -435
- 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,262 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Builds the in-process launch for one child: the tool plan, the typed child
|
|
3
|
+
* runtime config the hooks read, and the session launch input. Foreground
|
|
4
|
+
* children are built in the parent process; background children are built in
|
|
5
|
+
* the detached runner from the step it received in its config.
|
|
6
|
+
*/
|
|
7
|
+
import * as fs from "node:fs";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
import { intersectThinkingCeilings } from "../../shared/thinking-ceiling.js";
|
|
10
|
+
import { resolveChildDepth, } from "../../shared/types.js";
|
|
11
|
+
import { extensionOnlyMcpServers } from "./mcp-direct-tool-allowlist.js";
|
|
12
|
+
import { encodeExtensionBindings, PI_SUBAGENT_EXTENSION_BINDINGS_ENV } from "./extension-bindings.js";
|
|
13
|
+
import { intersectSubagentCapabilityCeilings } from "./capability-ceiling.js";
|
|
14
|
+
import { buildProfileLaunchEnv } from "./profile-launch-env.js";
|
|
15
|
+
import { isSubagentRuntimeExtensionPath, projectLaunchResolvedChildExtensions, resolvePiLaunchToolPlan, supervisorChannelDir, } from "./child-tool-plan.js";
|
|
16
|
+
import { createCapturedChildHooks, withChildSessionErrorReporting } from "./child-hooks.js";
|
|
17
|
+
import { resolveRequiredChildExtensions } from "../../shared/required-child-extensions.js";
|
|
18
|
+
/** Environment variable pi-mcp-adapter reads for the tools a child may expose. */
|
|
19
|
+
export const MCP_DIRECT_TOOLS_ENV = "MCP_DIRECT_TOOLS";
|
|
20
|
+
export function inheritedChildRuntime(config) {
|
|
21
|
+
if (!config)
|
|
22
|
+
return undefined;
|
|
23
|
+
return {
|
|
24
|
+
depth: config.depth,
|
|
25
|
+
...(config.maxDepth !== undefined ? { maxDepth: config.maxDepth } : {}),
|
|
26
|
+
...(config.nestedRoute ? { nestedRoute: config.nestedRoute } : {}),
|
|
27
|
+
...(config.nestedParent ? { nestedParent: config.nestedParent } : {}),
|
|
28
|
+
...(config.capabilityCeiling ? { capabilityCeiling: config.capabilityCeiling } : {}),
|
|
29
|
+
...(config.thinkingCeiling ? { thinkingCeiling: config.thinkingCeiling } : {}),
|
|
30
|
+
...(config.runFanoutBudget ? { runFanoutBudget: config.runFanoutBudget } : {}),
|
|
31
|
+
...(config.requiredExtensions ? { requiredExtensions: config.requiredExtensions } : {}),
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
/** Actual host create-input boundary. Evidence remains explicitly opt-in and dormant in production. */
|
|
35
|
+
export function createReportedChildSessionInput(launch, transcriptWriter) {
|
|
36
|
+
return withChildSessionErrorReporting(launch.session, transcriptWriter);
|
|
37
|
+
}
|
|
38
|
+
/** Escape XML-significant characters in a string for safe attribute interpolation. */
|
|
39
|
+
function escapeXmlAttr(value) {
|
|
40
|
+
return value
|
|
41
|
+
.replace(/&/g, "&")
|
|
42
|
+
.replace(/"/g, """)
|
|
43
|
+
.replace(/</g, "<")
|
|
44
|
+
.replace(/>/g, ">");
|
|
45
|
+
}
|
|
46
|
+
function inheritedCapabilityCeiling(inherited) {
|
|
47
|
+
return inherited?.capabilityCeiling;
|
|
48
|
+
}
|
|
49
|
+
/** Environment values external child extensions read, including fork-selected profiles. */
|
|
50
|
+
function childProcessEnv(input, toolPlan, sandboxEnv) {
|
|
51
|
+
const env = {};
|
|
52
|
+
env[PI_SUBAGENT_EXTENSION_BINDINGS_ENV] = encodeExtensionBindings(input.extensionBindings);
|
|
53
|
+
// Selectors resolved against Pi's built-in MCP never reach an adapter.
|
|
54
|
+
if (toolPlan.builtinMcpTools)
|
|
55
|
+
env[MCP_DIRECT_TOOLS_ENV] = "__none__";
|
|
56
|
+
else if (!toolPlan.capabilityCeiling && input.mcpDirectTools?.length)
|
|
57
|
+
env[MCP_DIRECT_TOOLS_ENV] = input.mcpDirectTools.join(",");
|
|
58
|
+
else if (toolPlan.capabilityCeiling && toolPlan.effectiveMcpSelections.length && !toolPlan.capabilityCeiling.denyExtensions) {
|
|
59
|
+
env[MCP_DIRECT_TOOLS_ENV] = toolPlan.effectiveMcpSelections.map((selection) => selection.selector).join(",");
|
|
60
|
+
}
|
|
61
|
+
else
|
|
62
|
+
env[MCP_DIRECT_TOOLS_ENV] = "__none__";
|
|
63
|
+
return sandboxEnv ? { ...env, ...sandboxEnv } : env;
|
|
64
|
+
}
|
|
65
|
+
function childStorage(input) {
|
|
66
|
+
if (input.sessionFile) {
|
|
67
|
+
fs.mkdirSync(path.dirname(input.sessionFile), { recursive: true });
|
|
68
|
+
return { kind: "file", sessionFile: input.sessionFile };
|
|
69
|
+
}
|
|
70
|
+
if (!input.sessionEnabled)
|
|
71
|
+
return { kind: "memory" };
|
|
72
|
+
if (input.sessionDir) {
|
|
73
|
+
fs.mkdirSync(input.sessionDir, { recursive: true });
|
|
74
|
+
return { kind: "dir", sessionDir: input.sessionDir };
|
|
75
|
+
}
|
|
76
|
+
return { kind: "default" };
|
|
77
|
+
}
|
|
78
|
+
export function buildInProcessChildLaunch(input) {
|
|
79
|
+
const requiredExtensions = input.requiredExtensions ?? input.inherited?.requiredExtensions ?? resolveRequiredChildExtensions(input.parentSessionId);
|
|
80
|
+
const agentCapabilityCeiling = input.descendantAllowedAgents === undefined
|
|
81
|
+
? undefined
|
|
82
|
+
: { version: 1, allowedAgents: [...input.descendantAllowedAgents], denyExtensions: false, sources: [`agent:${input.childAgentName}`] };
|
|
83
|
+
const inheritedCeiling = inheritedCapabilityCeiling(input.inherited);
|
|
84
|
+
const capabilityCeilingForPlanning = agentCapabilityCeiling && !input.capabilityCeiling && !inheritedCeiling
|
|
85
|
+
? { version: 1, denyExtensions: false, sources: [] }
|
|
86
|
+
: input.capabilityCeiling;
|
|
87
|
+
const toolPlan = resolvePiLaunchToolPlan({
|
|
88
|
+
tools: input.tools,
|
|
89
|
+
excludeTools: input.excludeTools,
|
|
90
|
+
allowNestedSubagents: input.allowNestedSubagents,
|
|
91
|
+
extensions: input.extensions,
|
|
92
|
+
subagentOnlyExtensions: input.subagentOnlyExtensions,
|
|
93
|
+
requiredExtensions,
|
|
94
|
+
mcpDirectTools: input.mcpDirectTools,
|
|
95
|
+
builtinMcpTools: input.builtinMcpTools,
|
|
96
|
+
cwd: input.cwd,
|
|
97
|
+
requireReadTool: input.requireReadTool,
|
|
98
|
+
structuredOutput: Boolean(input.structuredOutput),
|
|
99
|
+
fast: input.fast,
|
|
100
|
+
model: input.model,
|
|
101
|
+
capabilityCeiling: capabilityCeilingForPlanning,
|
|
102
|
+
inheritedCapabilityCeiling: inheritedCeiling,
|
|
103
|
+
agentName: input.childAgentName,
|
|
104
|
+
permissionRules: input.permissionRules,
|
|
105
|
+
runtimeSnapshotHost: input.runtimeSnapshotHost,
|
|
106
|
+
sandbox: input.sandbox,
|
|
107
|
+
permissionProfile: input.permissionProfile,
|
|
108
|
+
hostAvailableBuiltins: input.hostAvailableBuiltins,
|
|
109
|
+
});
|
|
110
|
+
// Foreground children load no ambient extensions, so an extension's registerMcpServer() never runs in them.
|
|
111
|
+
if (input.host === "parent" && input.runtimeSnapshotHost && toolPlan.builtinMcpTools?.length) {
|
|
112
|
+
// Pi treats a session without a trust decision as trusted.
|
|
113
|
+
const servers = extensionOnlyMcpServers(toolPlan.effectiveMcpSelections, input.runtimeSnapshotHost, input.cwd, input.projectTrusted !== false);
|
|
114
|
+
if (servers.length)
|
|
115
|
+
throw new Error(`Agent '${input.childAgentName}' selects MCP tools from servers that extensions registered (${servers.join(", ")}). Only background children (async: true) load those extensions; run the agent in the background or add the server to the global mcp.json or a trusted project's .pi/mcp.json.`);
|
|
116
|
+
}
|
|
117
|
+
toolPlan.capabilityCeiling = intersectSubagentCapabilityCeilings(toolPlan.capabilityCeiling, agentCapabilityCeiling);
|
|
118
|
+
if (toolPlan.capabilityAudit && toolPlan.capabilityCeiling) {
|
|
119
|
+
toolPlan.capabilityAudit = { ...toolPlan.capabilityAudit, ceiling: toolPlan.capabilityCeiling };
|
|
120
|
+
}
|
|
121
|
+
// Profile env construction (ack/diagnostics paths, sandbox and permission
|
|
122
|
+
// profile keys, the pinned profile, and the transient host key list) lives
|
|
123
|
+
// in the fork-only profile-launch-env module.
|
|
124
|
+
const { childEnv, profilePin, transientProcessEnv, sandboxDiagnosticsPath } = buildProfileLaunchEnv(input, toolPlan);
|
|
125
|
+
const inherited = input.inherited;
|
|
126
|
+
const fanout = toolPlan.fanoutAuthorized;
|
|
127
|
+
const inheritedRoute = inherited?.nestedRoute;
|
|
128
|
+
const parentRunId = input.runId ?? inherited?.nestedParent?.parentRunId ?? "";
|
|
129
|
+
const parentChildIndex = input.childIndex;
|
|
130
|
+
const parentDepth = inheritedRoute && inherited?.nestedParent ? inherited.nestedParent.depth + 1 : 1;
|
|
131
|
+
const parentPath = [
|
|
132
|
+
...(inherited?.nestedParent?.path ?? []),
|
|
133
|
+
...(parentRunId ? [{ runId: parentRunId, stepIndex: parentChildIndex, agent: input.childAgentName }] : []),
|
|
134
|
+
];
|
|
135
|
+
const nestedRoute = fanout ? (input.nestedRoute ?? inheritedRoute) : undefined;
|
|
136
|
+
const childDepth = resolveChildDepth(input.maxSubagentDepth, inherited);
|
|
137
|
+
const permissions = input.permissionRules && Object.keys(input.permissionRules).length > 0
|
|
138
|
+
? { rules: input.permissionRules, ...(input.permissionAuditPath ? { auditPath: input.permissionAuditPath } : {}) }
|
|
139
|
+
: undefined;
|
|
140
|
+
let supervisorDir;
|
|
141
|
+
if (input.orchestratorIntercomTarget && input.parentSessionId && input.runId) {
|
|
142
|
+
supervisorDir = supervisorChannelDir(input.runId, input.childAgentName, input.childIndex);
|
|
143
|
+
fs.mkdirSync(path.join(supervisorDir, "requests"), { recursive: true });
|
|
144
|
+
fs.mkdirSync(path.join(supervisorDir, "replies"), { recursive: true });
|
|
145
|
+
}
|
|
146
|
+
const thinkingCeiling = intersectThinkingCeilings(input.thinkingCeiling, inherited?.thinkingCeiling);
|
|
147
|
+
let structuredValue;
|
|
148
|
+
let structuredAcceptanceReport;
|
|
149
|
+
let structuredCalled = false;
|
|
150
|
+
let structuredAcceptanceProvided = false;
|
|
151
|
+
const structuredTerminalState = { captured: false };
|
|
152
|
+
const config = {
|
|
153
|
+
cwd: input.cwd,
|
|
154
|
+
...(input.runId ? { runId: input.runId } : {}),
|
|
155
|
+
agent: input.childAgentName,
|
|
156
|
+
childIndex: input.childIndex,
|
|
157
|
+
fanoutChild: fanout,
|
|
158
|
+
...(input.sessionName?.trim() ? { sessionName: input.sessionName.trim() } : {}),
|
|
159
|
+
...(input.intercomSessionName ? { intercomSessionName: input.intercomSessionName } : {}),
|
|
160
|
+
...(input.orchestratorIntercomTarget ? { orchestratorTarget: input.orchestratorIntercomTarget } : {}),
|
|
161
|
+
...(input.parentSessionId ? { orchestratorSessionId: input.parentSessionId, parentSessionId: input.parentSessionId } : {}),
|
|
162
|
+
...(supervisorDir ? { supervisorChannelDir: supervisorDir } : {}),
|
|
163
|
+
...(nestedRoute ? { nestedRoute } : {}),
|
|
164
|
+
...(fanout && parentRunId ? { nestedParent: { parentRunId, parentChildIndex, depth: parentDepth, path: parentPath } } : {}),
|
|
165
|
+
...(fanout && (input.runFanoutBudget ?? inherited?.runFanoutBudget) ? { runFanoutBudget: input.runFanoutBudget ?? inherited?.runFanoutBudget } : {}),
|
|
166
|
+
depth: childDepth.depth,
|
|
167
|
+
maxDepth: childDepth.maxDepth,
|
|
168
|
+
...(toolPlan.capabilityCeiling ? { capabilityCeiling: toolPlan.capabilityCeiling } : {}),
|
|
169
|
+
...(thinkingCeiling ? { thinkingCeiling } : {}),
|
|
170
|
+
...(toolPlan.requiredExtensions.length > 0 ? { requiredExtensions: toolPlan.requiredExtensions } : {}),
|
|
171
|
+
inheritProjectContext: input.inheritProjectContext,
|
|
172
|
+
inheritGlobalContext: input.inheritGlobalContext,
|
|
173
|
+
inheritSkills: input.inheritSkills,
|
|
174
|
+
...(input.forkCacheKey?.trim() ? { forkCacheKey: input.forkCacheKey.trim() } : {}),
|
|
175
|
+
...(permissions ? { permissions } : {}),
|
|
176
|
+
...(input.toolBudget ? { toolBudget: input.toolBudget } : {}),
|
|
177
|
+
...(input.childWatchdog ? { childWatchdog: input.childWatchdog } : {}),
|
|
178
|
+
...(input.watchdogStatus ? { watchdogStatus: input.watchdogStatus } : {}),
|
|
179
|
+
waitTool: {
|
|
180
|
+
enabled: input.waitToolEnabled ?? true,
|
|
181
|
+
...(input.waitToolDefaultTimeoutMs !== undefined ? { defaultTimeoutMs: input.waitToolDefaultTimeoutMs } : {}),
|
|
182
|
+
},
|
|
183
|
+
...(input.structuredOutput
|
|
184
|
+
? {
|
|
185
|
+
structuredOutput: {
|
|
186
|
+
schema: input.structuredOutput.schema,
|
|
187
|
+
terminalState: structuredTerminalState,
|
|
188
|
+
...(input.structuredOutput.acceptanceReportPath
|
|
189
|
+
? { acceptanceReport: input.structuredOutput.acceptanceReportRequired ? "required" : "optional" }
|
|
190
|
+
: {}),
|
|
191
|
+
capture: (value, acceptanceReport) => {
|
|
192
|
+
structuredCalled = true;
|
|
193
|
+
structuredValue = value;
|
|
194
|
+
structuredAcceptanceProvided = acceptanceReport !== undefined;
|
|
195
|
+
structuredAcceptanceReport = acceptanceReport;
|
|
196
|
+
structuredTerminalState.captured = true;
|
|
197
|
+
},
|
|
198
|
+
},
|
|
199
|
+
}
|
|
200
|
+
: {}),
|
|
201
|
+
...(toolPlan.requiredChildTools.length > 0 ? { requiredTools: toolPlan.requiredChildTools } : {}),
|
|
202
|
+
...(toolPlan.effectiveMcpTools.length > 0 ? { mcpDirectTools: toolPlan.effectiveMcpTools } : {}),
|
|
203
|
+
fast: input.fast === true,
|
|
204
|
+
};
|
|
205
|
+
const capturedHooks = createCapturedChildHooks(config);
|
|
206
|
+
const extensionPaths = toolPlan.extensionArgs.filter((extensionPath) => !isSubagentRuntimeExtensionPath(extensionPath));
|
|
207
|
+
const ambientExtensions = input.host === "runner" && !toolPlan.disableAmbientExtensions;
|
|
208
|
+
const launchResolvedExtensions = projectLaunchResolvedChildExtensions({
|
|
209
|
+
runtimeExtensions: toolPlan.runtimeExtensions,
|
|
210
|
+
configuredExtensions: toolPlan.configuredExtensions,
|
|
211
|
+
extensionArgs: toolPlan.extensionArgs,
|
|
212
|
+
disableAmbientExtensions: !ambientExtensions,
|
|
213
|
+
requiredExtensions: toolPlan.requiredExtensions,
|
|
214
|
+
});
|
|
215
|
+
const taggedPrompt = input.systemPrompt !== undefined && input.systemPrompt !== null
|
|
216
|
+
? `<active_agent name="${escapeXmlAttr(input.childAgentName)}"/>\n\n${input.systemPrompt}`
|
|
217
|
+
: undefined;
|
|
218
|
+
const session = {
|
|
219
|
+
cwd: input.cwd,
|
|
220
|
+
...(input.machine ? { machine: input.machine } : {}),
|
|
221
|
+
...(input.projectTrusted !== undefined ? { projectTrusted: input.projectTrusted } : {}),
|
|
222
|
+
...(input.machine ? { remoteResources: { agent: input.childAgentName, ...(input.remoteSkillNames ? { skills: input.remoteSkillNames } : {}), ...(input.remoteReads !== undefined ? { reads: input.remoteReads } : {}), ...(toolPlan.explicitToolAllowlist ? { toolCeiling: [...toolPlan.effectiveToolAllowlist] } : toolPlan.capabilityCeiling?.allowedTools ? { toolCeiling: [...toolPlan.capabilityCeiling.allowedTools] } : {}) } } : {}),
|
|
223
|
+
storage: childStorage(input),
|
|
224
|
+
...(input.parentSessionFile ? { parentSessionFile: input.parentSessionFile } : {}),
|
|
225
|
+
...(input.model ? { model: input.model } : {}),
|
|
226
|
+
...(toolPlan.explicitToolAllowlist ? { tools: toolPlan.effectiveToolAllowlist } : {}),
|
|
227
|
+
...(toolPlan.builtinMcpTools?.length ? { builtinMcpTools: toolPlan.builtinMcpTools } : {}),
|
|
228
|
+
...(!toolPlan.explicitToolAllowlist && toolPlan.excludeTools.length > 0 ? { excludeTools: toolPlan.excludeTools } : {}),
|
|
229
|
+
extensionPaths,
|
|
230
|
+
requiredExtensions: toolPlan.requiredExtensions,
|
|
231
|
+
ambientExtensions,
|
|
232
|
+
hooks: capturedHooks.hooks,
|
|
233
|
+
// Foreground children must receive their own bindings (or clear inherited
|
|
234
|
+
// bindings), while retaining the fork's pinned profile selections.
|
|
235
|
+
...(input.host === "runner" || childEnv
|
|
236
|
+
? { processEnv: { ...childProcessEnv(input, toolPlan, childEnv), ...profilePin } }
|
|
237
|
+
: { processEnv: { ...profilePin, [PI_SUBAGENT_EXTENSION_BINDINGS_ENV]: encodeExtensionBindings(input.extensionBindings) } }),
|
|
238
|
+
transientProcessEnv,
|
|
239
|
+
...(input.host === "parent" ? { restoreProcessEnv: true } : {}),
|
|
240
|
+
runtime: config,
|
|
241
|
+
noSkills: !input.inheritSkills,
|
|
242
|
+
noContextFiles: !input.inheritProjectContext,
|
|
243
|
+
...(taggedPrompt !== undefined
|
|
244
|
+
? input.systemPromptMode === "replace" ? { systemPrompt: taggedPrompt } : { appendSystemPrompt: taggedPrompt }
|
|
245
|
+
: {}),
|
|
246
|
+
};
|
|
247
|
+
return {
|
|
248
|
+
toolPlan,
|
|
249
|
+
config,
|
|
250
|
+
session,
|
|
251
|
+
capture: {
|
|
252
|
+
structuredOutput: () => ({ called: structuredCalled, value: structuredValue, acceptanceReport: structuredAcceptanceReport, acceptanceReportProvided: structuredAcceptanceProvided }),
|
|
253
|
+
toolDiagnostic: capturedHooks.toolDiagnostic,
|
|
254
|
+
runtimeAcknowledgedExtensions: capturedHooks.runtimeAcknowledgedExtensions,
|
|
255
|
+
finalDrainHeld: capturedHooks.finalDrainHeld,
|
|
256
|
+
},
|
|
257
|
+
launchResolvedExtensions,
|
|
258
|
+
warnings: toolPlan.warnings,
|
|
259
|
+
...(toolPlan.capabilityAudit ? { capabilityAudit: toolPlan.capabilityAudit } : {}),
|
|
260
|
+
...(sandboxDiagnosticsPath ? { sandboxDiagnosticsPath } : {}),
|
|
261
|
+
};
|
|
262
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Child lifecycle projection: when the observed child session events mean
|
|
3
|
+
* the run is settling and the observer may start (or must cancel) its final
|
|
4
|
+
* drain window.
|
|
5
|
+
*/
|
|
6
|
+
export type ChildLifecycleAction = "start-drain" | "cancel-drain" | "none";
|
|
7
|
+
export interface ChildLifecycleState {
|
|
8
|
+
compactionRetryActive: boolean;
|
|
9
|
+
}
|
|
10
|
+
export declare function projectChildLifecycle(event: {
|
|
11
|
+
type?: string;
|
|
12
|
+
willRetry?: unknown;
|
|
13
|
+
}, terminalAssistantStop?: boolean, state?: ChildLifecycleState): ChildLifecycleAction;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export function projectChildLifecycle(event, terminalAssistantStop = false, state) {
|
|
2
|
+
if (event.type === "compaction_end") {
|
|
3
|
+
if (state)
|
|
4
|
+
state.compactionRetryActive = event.willRetry === true;
|
|
5
|
+
return event.willRetry === true ? "cancel-drain" : "none";
|
|
6
|
+
}
|
|
7
|
+
if (event.type === "agent_start" || event.type === "auto_retry_start" || event.type === "turn_start") {
|
|
8
|
+
if (state)
|
|
9
|
+
state.compactionRetryActive = false;
|
|
10
|
+
return "cancel-drain";
|
|
11
|
+
}
|
|
12
|
+
if (event.type === "agent_end") {
|
|
13
|
+
if (event.willRetry !== true && state)
|
|
14
|
+
state.compactionRetryActive = false;
|
|
15
|
+
return "cancel-drain";
|
|
16
|
+
}
|
|
17
|
+
if (event.type === "agent_settled")
|
|
18
|
+
return state?.compactionRetryActive ? "none" : "start-drain";
|
|
19
|
+
if (terminalAssistantStop)
|
|
20
|
+
return "start-drain";
|
|
21
|
+
return "none";
|
|
22
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import type { JsonSchemaObject, ResolvedToolBudget, RunFanoutBudgetDescriptor, SubagentState } from "../../shared/types.ts";
|
|
2
|
+
import type { ThinkingLevel } from "../../shared/model-info.ts";
|
|
3
|
+
import type { NestedPathEntry } from "./nested-path.ts";
|
|
4
|
+
import type { PermissionRules } from "./permissions.ts";
|
|
5
|
+
import type { ChildWatchdogConfig, ChildWatchdogStatusEvent } from "../../watchdog/child-status.ts";
|
|
6
|
+
import type { ResolvedWaitToolConfig } from "../background/wait-config.ts";
|
|
7
|
+
import type { ChildToolDiagnostic } from "./tool-availability.ts";
|
|
8
|
+
import type { ResolvedSubagentCapabilityCeiling } from "./capability-ceiling.ts";
|
|
9
|
+
import type { RequiredChildExtensionSnapshot } from "../../shared/required-child-extensions.ts";
|
|
10
|
+
/**
|
|
11
|
+
* Set in processes that host child sessions (the async runner). The extension
|
|
12
|
+
* entry point registers nothing when it sees it, so an ambient copy of
|
|
13
|
+
* pi-subagents loaded into a child session stays inert.
|
|
14
|
+
*/
|
|
15
|
+
export declare const SUBAGENT_CHILD_ENV = "PI_SUBAGENT_CHILD";
|
|
16
|
+
/**
|
|
17
|
+
* Pid of the async runner, set by the runner itself. A session's extensions
|
|
18
|
+
* can compare it with process.pid to tell that the process outlives the
|
|
19
|
+
* session. Descendants inherit the value but have their own pid.
|
|
20
|
+
*/
|
|
21
|
+
export declare const SUBAGENT_RUNNER_PID_ENV = "PI_SUBAGENT_RUNNER_PID";
|
|
22
|
+
/** Root parent session id the parent publishes for pi-permission-system ask forwarding. */
|
|
23
|
+
export declare const SUBAGENT_PARENT_SESSION_ENV = "PI_SUBAGENT_PARENT_SESSION";
|
|
24
|
+
export interface ChildNestedRoute {
|
|
25
|
+
rootRunId: string;
|
|
26
|
+
eventSink: string;
|
|
27
|
+
controlInbox: string;
|
|
28
|
+
capabilityToken: string;
|
|
29
|
+
}
|
|
30
|
+
export interface ChildNestedParent {
|
|
31
|
+
parentRunId: string;
|
|
32
|
+
parentChildIndex?: number;
|
|
33
|
+
depth: number;
|
|
34
|
+
path: NestedPathEntry[];
|
|
35
|
+
}
|
|
36
|
+
export interface ChildPermissions {
|
|
37
|
+
rules: PermissionRules;
|
|
38
|
+
auditPath?: string;
|
|
39
|
+
}
|
|
40
|
+
export interface ChildStructuredOutput {
|
|
41
|
+
schema: JsonSchemaObject;
|
|
42
|
+
acceptanceReport?: "optional" | "required";
|
|
43
|
+
/** Authoritative child-local state set only after validated capture succeeds. */
|
|
44
|
+
terminalState?: {
|
|
45
|
+
captured: boolean;
|
|
46
|
+
};
|
|
47
|
+
/** Receives the validated value; `acceptanceReport` is undefined when the child omitted it. */
|
|
48
|
+
capture: (value: unknown, acceptanceReport: unknown | undefined) => void;
|
|
49
|
+
}
|
|
50
|
+
export interface ChildSupervisorMetadata {
|
|
51
|
+
channelDir: string;
|
|
52
|
+
runId: string;
|
|
53
|
+
agent: string;
|
|
54
|
+
childIndex: number;
|
|
55
|
+
orchestratorTarget?: string;
|
|
56
|
+
orchestratorSessionId: string;
|
|
57
|
+
childTarget?: string;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Everything the child-side hooks need to know about the launch. The process
|
|
61
|
+
* that hosts the child session builds it and passes it to the hooks directly.
|
|
62
|
+
*/
|
|
63
|
+
export interface ChildRuntimeConfig {
|
|
64
|
+
cwd?: string;
|
|
65
|
+
runId?: string;
|
|
66
|
+
agent?: string;
|
|
67
|
+
childIndex?: number;
|
|
68
|
+
fanoutChild: boolean;
|
|
69
|
+
sessionName?: string;
|
|
70
|
+
intercomSessionName?: string;
|
|
71
|
+
orchestratorTarget?: string;
|
|
72
|
+
orchestratorSessionId?: string;
|
|
73
|
+
parentSessionId?: string;
|
|
74
|
+
supervisorChannelDir?: string;
|
|
75
|
+
/** Route the child reports nested runs on; set only for fanout-authorized children. */
|
|
76
|
+
nestedRoute?: ChildNestedRoute;
|
|
77
|
+
nestedParent?: ChildNestedParent;
|
|
78
|
+
runFanoutBudget?: RunFanoutBudgetDescriptor;
|
|
79
|
+
/** Nesting depth of this child (1 for a top-level parent's child). */
|
|
80
|
+
depth: number;
|
|
81
|
+
maxDepth?: number;
|
|
82
|
+
capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
|
|
83
|
+
/** Immutable root-parent host policy propagated to nested native launches. */
|
|
84
|
+
requiredExtensions?: RequiredChildExtensionSnapshot;
|
|
85
|
+
thinkingCeiling?: ThinkingLevel;
|
|
86
|
+
inheritProjectContext?: boolean;
|
|
87
|
+
inheritGlobalContext?: boolean;
|
|
88
|
+
inheritSkills?: boolean;
|
|
89
|
+
forkCacheKey?: string;
|
|
90
|
+
permissions?: ChildPermissions;
|
|
91
|
+
toolBudget?: ResolvedToolBudget;
|
|
92
|
+
childWatchdog?: ChildWatchdogConfig;
|
|
93
|
+
/** Receives child watchdog status events. */
|
|
94
|
+
watchdogStatus?: (event: ChildWatchdogStatusEvent) => void;
|
|
95
|
+
waitTool: ResolvedWaitToolConfig;
|
|
96
|
+
runtimeState?: SubagentState;
|
|
97
|
+
holdFinalDrain?: (held: boolean) => void;
|
|
98
|
+
/** Installation-local downward owner-channel barrier; never inherited or serialized into descendants. */
|
|
99
|
+
hasPendingSupervisorRequest?: () => boolean;
|
|
100
|
+
structuredOutput?: ChildStructuredOutput;
|
|
101
|
+
requiredTools?: string[];
|
|
102
|
+
mcpDirectTools?: string[];
|
|
103
|
+
/** Receives the tool-availability diagnostic at every agent start; undefined when every required tool is present. */
|
|
104
|
+
toolDiagnostic?: (diagnostic: ChildToolDiagnostic | undefined) => void;
|
|
105
|
+
/** Receives the runtime-acknowledged extension ids when the child run ends. */
|
|
106
|
+
runtimeAcknowledgements?: (ids: string[]) => void;
|
|
107
|
+
fast: boolean;
|
|
108
|
+
}
|
|
109
|
+
export declare function childSupervisorMetadata(config: ChildRuntimeConfig): ChildSupervisorMetadata | undefined;
|
|
110
|
+
/** Compute the child tool-availability diagnostic; undefined when every required tool is present. */
|
|
111
|
+
export declare function evaluateChildToolDiagnostic(config: Pick<ChildRuntimeConfig, "agent" | "requiredTools" | "mcpDirectTools">, availableTools: string[]): ChildToolDiagnostic | undefined;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Set in processes that host child sessions (the async runner). The extension
|
|
3
|
+
* entry point registers nothing when it sees it, so an ambient copy of
|
|
4
|
+
* pi-subagents loaded into a child session stays inert.
|
|
5
|
+
*/
|
|
6
|
+
export const SUBAGENT_CHILD_ENV = "PI_SUBAGENT_CHILD";
|
|
7
|
+
/**
|
|
8
|
+
* Pid of the async runner, set by the runner itself. A session's extensions
|
|
9
|
+
* can compare it with process.pid to tell that the process outlives the
|
|
10
|
+
* session. Descendants inherit the value but have their own pid.
|
|
11
|
+
*/
|
|
12
|
+
export const SUBAGENT_RUNNER_PID_ENV = "PI_SUBAGENT_RUNNER_PID";
|
|
13
|
+
/** Root parent session id the parent publishes for pi-permission-system ask forwarding. */
|
|
14
|
+
export const SUBAGENT_PARENT_SESSION_ENV = "PI_SUBAGENT_PARENT_SESSION";
|
|
15
|
+
export function childSupervisorMetadata(config) {
|
|
16
|
+
if (!config.supervisorChannelDir || !config.runId || !config.agent || !config.orchestratorSessionId || config.childIndex === undefined)
|
|
17
|
+
return undefined;
|
|
18
|
+
return {
|
|
19
|
+
channelDir: config.supervisorChannelDir,
|
|
20
|
+
runId: config.runId,
|
|
21
|
+
agent: config.agent,
|
|
22
|
+
childIndex: config.childIndex,
|
|
23
|
+
...(config.orchestratorTarget ? { orchestratorTarget: config.orchestratorTarget } : {}),
|
|
24
|
+
orchestratorSessionId: config.orchestratorSessionId,
|
|
25
|
+
...(config.intercomSessionName ? { childTarget: config.intercomSessionName } : {}),
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/** Compute the child tool-availability diagnostic; undefined when every required tool is present. */
|
|
29
|
+
export function evaluateChildToolDiagnostic(config, availableTools) {
|
|
30
|
+
if (!config.requiredTools)
|
|
31
|
+
return undefined;
|
|
32
|
+
const available = new Set(availableTools);
|
|
33
|
+
const missing = config.requiredTools.filter((name) => !available.has(name));
|
|
34
|
+
if (missing.length === 0)
|
|
35
|
+
return undefined;
|
|
36
|
+
const missingMcpDirectTools = config.mcpDirectTools?.length ? missing.filter((name) => config.mcpDirectTools.includes(name)) : [];
|
|
37
|
+
return {
|
|
38
|
+
...(config.agent ? { agent: config.agent } : {}),
|
|
39
|
+
required: config.requiredTools,
|
|
40
|
+
available: availableTools,
|
|
41
|
+
missing,
|
|
42
|
+
...(missingMcpDirectTools.length > 0 ? { missingMcpDirectTools } : {}),
|
|
43
|
+
};
|
|
44
|
+
}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import type { AgentMessage } from "@earendil-works/pi-agent-core";
|
|
2
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
3
|
+
import type { ChildRuntimeConfig } from "./child-runtime-config.ts";
|
|
4
|
+
import type { RequiredChildExtensionSnapshot } from "../../shared/required-child-extensions.ts";
|
|
5
|
+
import type { PlacementMachineReference, HerdrRemoteGitStatus } from "../../shared/types.ts";
|
|
6
|
+
export interface ChildSessionEvent {
|
|
7
|
+
type: string;
|
|
8
|
+
[key: string]: unknown;
|
|
9
|
+
}
|
|
10
|
+
/** Mirror pi's JSON event projection: `message_update` drops the partial message. */
|
|
11
|
+
export declare function projectChildSessionEventForJson(event: ChildSessionEvent): unknown;
|
|
12
|
+
export interface ChildSessionExtensionError {
|
|
13
|
+
extensionPath: string;
|
|
14
|
+
event: string;
|
|
15
|
+
error: unknown;
|
|
16
|
+
}
|
|
17
|
+
export interface ChildHookExtension {
|
|
18
|
+
name: string;
|
|
19
|
+
factory: (pi: ExtensionAPI) => void;
|
|
20
|
+
}
|
|
21
|
+
export type ChildSessionStorage = {
|
|
22
|
+
kind: "file";
|
|
23
|
+
sessionFile: string;
|
|
24
|
+
} | {
|
|
25
|
+
kind: "dir";
|
|
26
|
+
sessionDir: string;
|
|
27
|
+
} | {
|
|
28
|
+
kind: "default";
|
|
29
|
+
} | {
|
|
30
|
+
kind: "memory";
|
|
31
|
+
};
|
|
32
|
+
export interface ChildSessionLaunch {
|
|
33
|
+
cwd: string;
|
|
34
|
+
/** Resolved pane-native placement. Local launches omit this field. */
|
|
35
|
+
machine?: PlacementMachineReference;
|
|
36
|
+
/** The launching session's project trust; undefined keeps Pi's default for hosts without trust. */
|
|
37
|
+
projectTrusted?: boolean;
|
|
38
|
+
/** Process-local provider source owned by the invoking foreground parent. */
|
|
39
|
+
parentProviderRegistry?: ParentProviderRegistry;
|
|
40
|
+
/** Logical names resolved only by the remote ambient package. */
|
|
41
|
+
remoteResources?: {
|
|
42
|
+
agent: string;
|
|
43
|
+
skills?: string[];
|
|
44
|
+
toolCeiling?: string[];
|
|
45
|
+
reads?: string[] | false;
|
|
46
|
+
};
|
|
47
|
+
storage: ChildSessionStorage;
|
|
48
|
+
/** The launching session's file, recorded as the new child session's `parentSession` header like Pi's forks. */
|
|
49
|
+
parentSessionFile?: string;
|
|
50
|
+
/** Model reference as the agent config names it (`provider/id`, optionally `:thinking`). */
|
|
51
|
+
model?: string;
|
|
52
|
+
/** Explicit tool allowlist; undefined keeps pi's defaults. */
|
|
53
|
+
tools?: string[];
|
|
54
|
+
/** Tools of Pi's built-in MCP extension the child must declare to its model directly, with the `mcp:` selector that granted each; `tools` names them too. */
|
|
55
|
+
builtinMcpTools?: Array<{
|
|
56
|
+
name: string;
|
|
57
|
+
selector: string;
|
|
58
|
+
}>;
|
|
59
|
+
/** Cancels startup before a child exists to receive abort(), including its MCP connection wait. */
|
|
60
|
+
signal?: AbortSignal;
|
|
61
|
+
excludeTools?: string[];
|
|
62
|
+
/** Extension files loaded for this child in addition to the inline hooks. */
|
|
63
|
+
extensionPaths: string[];
|
|
64
|
+
/** Canonical required paths and safe evidence identities for fail-closed loading. */
|
|
65
|
+
requiredExtensions?: RequiredChildExtensionSnapshot;
|
|
66
|
+
/**
|
|
67
|
+
* Discover the ambient extensions (agent dir, project, settings) the way a
|
|
68
|
+
* `pi` process would. False loads only `extensionPaths` and `hooks`.
|
|
69
|
+
*/
|
|
70
|
+
ambientExtensions: boolean;
|
|
71
|
+
hooks: ChildHookExtension[];
|
|
72
|
+
noSkills: boolean;
|
|
73
|
+
noContextFiles: boolean;
|
|
74
|
+
systemPrompt?: string;
|
|
75
|
+
appendSystemPrompt?: string;
|
|
76
|
+
/**
|
|
77
|
+
* Environment values that extensions loaded into the child read from
|
|
78
|
+
* `process.env`. Applied to the hosting process while the session is created
|
|
79
|
+
* and its extensions load and start; launches in one process take that
|
|
80
|
+
* window one at a time. An undefined value removes the variable.
|
|
81
|
+
*/
|
|
82
|
+
processEnv?: Record<string, string | undefined>;
|
|
83
|
+
/** Profile env keys restored even when a runner retains other child env. */
|
|
84
|
+
transientProcessEnv?: string[];
|
|
85
|
+
/** Restore all launch env after startup, including failed launches. */
|
|
86
|
+
restoreProcessEnv?: boolean;
|
|
87
|
+
/** The typed runtime config the hooks were built from; informational for factories. */
|
|
88
|
+
runtime: ChildRuntimeConfig;
|
|
89
|
+
onExtensionError?: (error: ChildSessionExtensionError) => void;
|
|
90
|
+
}
|
|
91
|
+
export interface ChildSession {
|
|
92
|
+
subscribe(listener: (event: ChildSessionEvent) => void): () => void;
|
|
93
|
+
/** Resolves when the run ends, including after abort. */
|
|
94
|
+
prompt(text: string): Promise<void>;
|
|
95
|
+
steer(text: string): Promise<void>;
|
|
96
|
+
followUp(text: string): Promise<void>;
|
|
97
|
+
abort(): Promise<void>;
|
|
98
|
+
/** Emits `session_shutdown` to the child's extensions and disposes the session; resolves once that shutdown work is done. */
|
|
99
|
+
dispose(): Promise<void>;
|
|
100
|
+
/** Final settlement check for commands owned by this child; unfinished commands are cancelled and reject completion. */
|
|
101
|
+
finishCommands?(): Promise<void>;
|
|
102
|
+
/** True while Pi still has steering or follow-up input that has not started a turn. */
|
|
103
|
+
hasQueuedMessages?(): boolean;
|
|
104
|
+
readonly messages: readonly AgentMessage[];
|
|
105
|
+
readonly sessionFile: string | undefined;
|
|
106
|
+
readonly sessionId: string;
|
|
107
|
+
readonly modelId: string | undefined;
|
|
108
|
+
/** Provider id of the selected model when this child inherited that provider from the parent's registry instead of loading its extension. */
|
|
109
|
+
readonly inheritedProvider?: string;
|
|
110
|
+
/** Provider id of the selected model when an extension in this child's model runtime registered that provider, at load or later (e.g. on `session_start`). */
|
|
111
|
+
readonly claimedProvider?: string;
|
|
112
|
+
/** Live provider/id of the selected model when Pi marks it virtual (`api === "pi-virtual"`); assistant messages then name the dispatched physical model. */
|
|
113
|
+
readonly virtualModelId?: string;
|
|
114
|
+
readonly contextWindow?: number;
|
|
115
|
+
readonly machineEvidence?: {
|
|
116
|
+
provider: PlacementMachineReference["provider"];
|
|
117
|
+
machineId: string;
|
|
118
|
+
initial?: HerdrRemoteGitStatus;
|
|
119
|
+
final?: HerdrRemoteGitStatus;
|
|
120
|
+
};
|
|
121
|
+
/** Event-updated pane-native status; reading it performs no network work. */
|
|
122
|
+
readonly placementSnapshot?: unknown;
|
|
123
|
+
/** Set by the foreground host once the run detached; `factory.dispose()` leaves such children running. */
|
|
124
|
+
detached?: boolean;
|
|
125
|
+
/** Set by `factory.dispose()` before it aborts the child, so the host can report the stop truthfully. */
|
|
126
|
+
shutDown?: boolean;
|
|
127
|
+
}
|
|
128
|
+
export declare function childSessionHasQueuedMessages(session: ChildSession | undefined): boolean;
|
|
129
|
+
export interface ChildSessionFactory {
|
|
130
|
+
create(launch: ChildSessionLaunch): Promise<ChildSession>;
|
|
131
|
+
/** Abort and dispose every live attached child; detached children keep running and hold the shared runtime. */
|
|
132
|
+
dispose(): Promise<void>;
|
|
133
|
+
}
|
|
134
|
+
export type PiCodingAgentModule = typeof import("@earendil-works/pi-coding-agent");
|
|
135
|
+
export interface DefaultChildSessionFactoryOptions {
|
|
136
|
+
/**
|
|
137
|
+
* Loads the pi package the sessions are created from. The parent process
|
|
138
|
+
* uses the host's in-process module; the detached runner imports the
|
|
139
|
+
* installed package by absolute path.
|
|
140
|
+
*/
|
|
141
|
+
loadPiCodingAgent?: () => Promise<PiCodingAgentModule>;
|
|
142
|
+
/** Upper bound on a disposed child's `session_shutdown` handlers before the session is dropped anyway. */
|
|
143
|
+
shutdownTimeoutMs?: number;
|
|
144
|
+
}
|
|
145
|
+
type ModelRuntimeInstance = Awaited<ReturnType<PiCodingAgentModule["ModelRuntime"]["create"]>>;
|
|
146
|
+
export type ParentProviderRegistry = Pick<ModelRuntimeInstance, "getRegisteredProviderIds" | "getRegisteredProviderConfig" | "getRegisteredNativeProvider">;
|
|
147
|
+
/**
|
|
148
|
+
* Load the host-owned pi-coding-agent module by absolute package entry so a
|
|
149
|
+
* child cannot resolve an extension-owned copy. SDK and CLI root precedence is
|
|
150
|
+
* shared through resolveHostPiPackageRoot. Once any root is selected, its manifest,
|
|
151
|
+
* package identity, entry, and import must all succeed; the bare specifier is used
|
|
152
|
+
* only when no root resolves.
|
|
153
|
+
*/
|
|
154
|
+
export declare function loadHostPiCodingAgent(): Promise<PiCodingAgentModule>;
|
|
155
|
+
/**
|
|
156
|
+
* Default factory: detached/background sessions retain the existing shared
|
|
157
|
+
* runtime; each parent-bound foreground launch gets an isolated runtime.
|
|
158
|
+
*/
|
|
159
|
+
export declare function createDefaultChildSessionFactory(options?: DefaultChildSessionFactoryOptions): ChildSessionFactory;
|
|
160
|
+
/** The process-wide factory foreground runs use unless a run passes its own. */
|
|
161
|
+
export declare function childSessionFactory(): ChildSessionFactory;
|
|
162
|
+
/** Default factory including pane-native placement; detached runners use the same boundary. */
|
|
163
|
+
export declare function createPlacementChildSessionFactory(options?: DefaultChildSessionFactoryOptions): ChildSessionFactory;
|
|
164
|
+
/**
|
|
165
|
+
* Replace the process-wide factory. Tests install a scripted factory; passing
|
|
166
|
+
* undefined restores the default on next use.
|
|
167
|
+
*/
|
|
168
|
+
export declare function setChildSessionFactory(factory: ChildSessionFactory | undefined): void;
|
|
169
|
+
/**
|
|
170
|
+
* Module path the detached background runner imports its child session factory
|
|
171
|
+
* from. Tests point it at a scripted factory; production launches leave it
|
|
172
|
+
* unset and the runner creates real sessions from the installed pi package.
|
|
173
|
+
*/
|
|
174
|
+
export declare function childSessionFactoryModule(): string | undefined;
|
|
175
|
+
export declare function setChildSessionFactoryModule(modulePath: string | undefined): void;
|
|
176
|
+
/** Abort and dispose every live in-process child and release the shared runtime. */
|
|
177
|
+
export declare function disposeChildSessions(): Promise<void>;
|
|
178
|
+
export {};
|