@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,101 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import { type McpRuntimeSnapshotHost, type ResolvedMcpDirectToolSelection } from "./mcp-direct-tool-allowlist.ts";
|
|
3
|
+
import { type JsonSchemaObject, type LaunchResolvedChildExtensions } from "../../shared/types.ts";
|
|
4
|
+
import type { PermissionRules } from "./permissions.ts";
|
|
5
|
+
import { type RequiredChildExtensionSnapshot } from "../../shared/required-child-extensions.ts";
|
|
6
|
+
import { type ResolvedSubagentCapabilityCeiling, type SubagentCapabilityAudit } from "./capability-ceiling.ts";
|
|
7
|
+
/** True for the extension files pi-subagents itself installs in child sessions. */
|
|
8
|
+
export declare function isSubagentRuntimeExtensionPath(extensionPath: string): boolean;
|
|
9
|
+
export declare function deriveForkPromptCacheKey(parentSessionId: string | undefined): string | undefined;
|
|
10
|
+
export declare function supervisorChannelDir(runId: string, agent: string, childIndex: number): string;
|
|
11
|
+
export declare function applyThinkingSuffix(model: string | undefined, thinking: string | false | undefined, replaceExisting?: boolean): string | undefined;
|
|
12
|
+
export interface ResolvePiLaunchToolPlanInput {
|
|
13
|
+
tools?: string[];
|
|
14
|
+
excludeTools?: string[];
|
|
15
|
+
allowNestedSubagents?: boolean;
|
|
16
|
+
extensions?: string[];
|
|
17
|
+
subagentOnlyExtensions?: string[];
|
|
18
|
+
requiredExtensions?: RequiredChildExtensionSnapshot;
|
|
19
|
+
mcpDirectTools?: string[];
|
|
20
|
+
cwd?: string;
|
|
21
|
+
requireReadTool?: boolean;
|
|
22
|
+
structuredOutput?: boolean | {
|
|
23
|
+
schema: JsonSchemaObject;
|
|
24
|
+
schemaPath: string;
|
|
25
|
+
outputPath: string;
|
|
26
|
+
};
|
|
27
|
+
fast?: boolean;
|
|
28
|
+
model?: string;
|
|
29
|
+
capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
|
|
30
|
+
inheritedCapabilityCeiling?: ResolvedSubagentCapabilityCeiling;
|
|
31
|
+
agentName?: string;
|
|
32
|
+
permissionRules?: PermissionRules;
|
|
33
|
+
runtimeSnapshotHost?: McpRuntimeSnapshotHost;
|
|
34
|
+
/** A validated global pi-sandbox profile selected by the agent definition. */
|
|
35
|
+
sandbox?: string;
|
|
36
|
+
/** A validated global pi-permission-system profile selected by the agent definition. */
|
|
37
|
+
permissionProfile?: string;
|
|
38
|
+
/**
|
|
39
|
+
* When provided, child tool plans intersect known Pi core tool slots with
|
|
40
|
+
* this set. Core tools the agent declares but the host does not provide are
|
|
41
|
+
* omitted with a non-fatal warning (tracked in `unavailableHostBuiltins`).
|
|
42
|
+
* Review/scout lanes fail closed when a requested, still-permitted
|
|
43
|
+
* repository inspection tool is among those host omissions. Intentionally
|
|
44
|
+
* empty or ceiling-restricted allowlists are not a minimum-tool contract.
|
|
45
|
+
* Non-core names remain allowed and are validated in the child's registry.
|
|
46
|
+
*/
|
|
47
|
+
hostAvailableBuiltins?: readonly string[];
|
|
48
|
+
/** The parent's built-in MCP selections; the background runner has no host to resolve selectors against. */
|
|
49
|
+
builtinMcpTools?: ResolvedMcpDirectToolSelection[];
|
|
50
|
+
}
|
|
51
|
+
export interface PiLaunchToolPlan {
|
|
52
|
+
capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
|
|
53
|
+
requestedBuiltinTools: string[];
|
|
54
|
+
declaredBuiltinTools: string[];
|
|
55
|
+
excludeTools: string[];
|
|
56
|
+
toolExtensionPaths: string[];
|
|
57
|
+
resolvedMcpSelections: ResolvedMcpDirectToolSelection[];
|
|
58
|
+
effectiveMcpSelections: ResolvedMcpDirectToolSelection[];
|
|
59
|
+
effectiveMcpTools: string[];
|
|
60
|
+
/** Effective selections granted from Pi's built-in MCP; undefined when the selectors did not resolve against it. */
|
|
61
|
+
builtinMcpTools?: ResolvedMcpDirectToolSelection[];
|
|
62
|
+
explicitToolAllowlist: boolean;
|
|
63
|
+
internalTools: string[];
|
|
64
|
+
effectiveToolAllowlist: string[];
|
|
65
|
+
requiredChildTools: string[];
|
|
66
|
+
fanoutAuthorized: boolean;
|
|
67
|
+
/** Absolute path of the resolved pi-sandbox child extension when a sandbox profile is selected. */
|
|
68
|
+
sandboxExtension?: string;
|
|
69
|
+
runtimeExtensions: string[];
|
|
70
|
+
configuredExtensions: string[];
|
|
71
|
+
requiredExtensions: RequiredChildExtensionSnapshot;
|
|
72
|
+
extensionArgs: string[];
|
|
73
|
+
disableAmbientExtensions: boolean;
|
|
74
|
+
capabilityAudit?: SubagentCapabilityAudit;
|
|
75
|
+
/** Non-fatal launch warnings; they do not change behavior. */
|
|
76
|
+
warnings: string[];
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Children are pi sessions inside the parent or the runner process; a spawned
|
|
80
|
+
* `pi` received extra MCP server definitions as a CLI argument, but a session
|
|
81
|
+
* has no such input. Selecting a server that exists only in pi-mcp-adapter's
|
|
82
|
+
* runtime snapshot therefore cannot work and fails the launch.
|
|
83
|
+
*/
|
|
84
|
+
export declare function formatRuntimeSnapshotMcpServersError(agentName: string | undefined, serverNames: readonly string[]): string;
|
|
85
|
+
/**
|
|
86
|
+
* A child's `tools` list is a complete allowlist. Read as names, Pi's modifier
|
|
87
|
+
* entries would become required tools no child has, or mix with the names the
|
|
88
|
+
* plan adds into a list Pi rejects. The modifier rule is Pi's `isToolModifier`:
|
|
89
|
+
* a `+name` or `-name` entry edits Pi's default tool selection.
|
|
90
|
+
*/
|
|
91
|
+
export declare function assertNoToolModifierEntries(agentName: string | undefined, tools: readonly string[]): void;
|
|
92
|
+
export declare function projectLaunchResolvedChildExtensions(toolPlan: Pick<PiLaunchToolPlan, "runtimeExtensions" | "configuredExtensions" | "requiredExtensions" | "extensionArgs" | "disableAmbientExtensions">): LaunchResolvedChildExtensions;
|
|
93
|
+
/**
|
|
94
|
+
* Resolve the permission-system extension entry point when installed.
|
|
95
|
+
* Returns the absolute path to the extension's main module, or undefined
|
|
96
|
+
* when the package is not installed. Callers can check `autoInject` config
|
|
97
|
+
* to decide whether to include it in child sessions.
|
|
98
|
+
*/
|
|
99
|
+
export declare function resolvePermissionSystemExtension(): string | undefined;
|
|
100
|
+
export declare function resolvePiLaunchToolPlan(input: ResolvePiLaunchToolPlanInput): PiLaunchToolPlan;
|
|
101
|
+
export declare function getHostBuiltinToolNames(pi: Pick<ExtensionAPI, "getAllTools">): string[] | undefined;
|
|
@@ -0,0 +1,430 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Child tool plan: which builtin tools, MCP tools, runtime hooks, and extension
|
|
3
|
+
* files a child launch gets, and how that resolution is reported. Both the
|
|
4
|
+
* foreground path and the async runner build their session launch from this.
|
|
5
|
+
*/
|
|
6
|
+
import { createHash } from "node:crypto";
|
|
7
|
+
import * as fs from "node:fs";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
import { fileURLToPath } from "node:url";
|
|
10
|
+
import { formatUnresolvedBuiltinMcpSelectors, formatUnresolvedMcpDirectToolSelectors, resolveMcpDirectToolResolution, } from "./mcp-direct-tool-allowlist.js";
|
|
11
|
+
import { TEMP_ROOT_DIR, } from "../../shared/types.js";
|
|
12
|
+
import { THINKING_LEVELS } from "../../shared/model-info.js";
|
|
13
|
+
import { getAgentDir } from "../../shared/utils.js";
|
|
14
|
+
import { resolveRuntimeModulePath, RUNTIME_MODULE_EXTENSIONS } from "../../shared/runtime-module-path.js";
|
|
15
|
+
import { resolveProfileExtensions } from "./profile-extensions.js";
|
|
16
|
+
import { snapshotRequiredChildExtensions } from "../../shared/required-child-extensions.js";
|
|
17
|
+
import { capabilityCeilingAgentRestrictionSources, intersectSubagentCapabilityCeilings, isAgentAllowedByCapabilityCeiling, } from "./capability-ceiling.js";
|
|
18
|
+
const MAX_LAUNCH_RESOLVED_EXTENSION_IDS = 32;
|
|
19
|
+
const RUNTIME_EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
20
|
+
const FANOUT_CHILD_EXTENSION_DIR = path.join(RUNTIME_EXTENSION_DIR, "..", "..", "extension");
|
|
21
|
+
const SANDBOX_PROFILE_GUARD_EXTENSION_PATH = path.join(RUNTIME_EXTENSION_DIR, "sandbox-profile-guard.ts");
|
|
22
|
+
const SUBAGENT_RUNTIME_EXTENSION_PATHS = new Set([
|
|
23
|
+
path.join(RUNTIME_EXTENSION_DIR, "subagent-prompt-runtime"),
|
|
24
|
+
path.join(RUNTIME_EXTENSION_DIR, "fast-mode-extension"),
|
|
25
|
+
path.join(FANOUT_CHILD_EXTENSION_DIR, "fanout-child"),
|
|
26
|
+
].flatMap((base) => RUNTIME_MODULE_EXTENSIONS.map((extension) => path.normalize(`${base}${extension}`))));
|
|
27
|
+
/** True for the extension files pi-subagents itself installs in child sessions. */
|
|
28
|
+
export function isSubagentRuntimeExtensionPath(extensionPath) {
|
|
29
|
+
return SUBAGENT_RUNTIME_EXTENSION_PATHS.has(path.normalize(extensionPath));
|
|
30
|
+
}
|
|
31
|
+
const PI_BUILTIN_TOOL_NAMES = new Set(["read", "bash", "powershell", "edit", "write", "grep", "find", "ls"]);
|
|
32
|
+
// Priority tier is an OpenAI-Codex request field; other providers reject or ignore it.
|
|
33
|
+
const FAST_MODE_PROVIDER_PREFIX = "openai-codex/";
|
|
34
|
+
const OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH = 64;
|
|
35
|
+
export function deriveForkPromptCacheKey(parentSessionId) {
|
|
36
|
+
const parent = parentSessionId?.trim();
|
|
37
|
+
if (!parent)
|
|
38
|
+
return undefined;
|
|
39
|
+
const digest = createHash("sha256").update(parent).digest("hex").slice(0, OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH - "pi-fork:".length);
|
|
40
|
+
return `pi-fork:${digest}`;
|
|
41
|
+
}
|
|
42
|
+
function sanitizeSupervisorChannelSegment(value) {
|
|
43
|
+
return (value
|
|
44
|
+
.trim()
|
|
45
|
+
.replace(/[^A-Za-z0-9._-]+/g, "-")
|
|
46
|
+
.replace(/^-+|-+$/g, "") || "unknown");
|
|
47
|
+
}
|
|
48
|
+
export function supervisorChannelDir(runId, agent, childIndex) {
|
|
49
|
+
return path.join(TEMP_ROOT_DIR, "supervisor-channels", `${sanitizeSupervisorChannelSegment(runId)}-${sanitizeSupervisorChannelSegment(agent)}-${childIndex}`);
|
|
50
|
+
}
|
|
51
|
+
export function applyThinkingSuffix(model, thinking, replaceExisting = false) {
|
|
52
|
+
if (!model || !thinking)
|
|
53
|
+
return model;
|
|
54
|
+
const colonIdx = model.lastIndexOf(":");
|
|
55
|
+
if (colonIdx !== -1 &&
|
|
56
|
+
THINKING_LEVELS.some((level) => level === model.substring(colonIdx + 1))) {
|
|
57
|
+
return replaceExisting ? `${model.slice(0, colonIdx)}:${thinking}` : model;
|
|
58
|
+
}
|
|
59
|
+
return `${model}:${thinking}`;
|
|
60
|
+
}
|
|
61
|
+
function stripThinkingSuffix(model) {
|
|
62
|
+
const colonIdx = model.lastIndexOf(":");
|
|
63
|
+
if (colonIdx === -1)
|
|
64
|
+
return model;
|
|
65
|
+
return THINKING_LEVELS.some((level) => level === model.substring(colonIdx + 1))
|
|
66
|
+
? model.slice(0, colonIdx)
|
|
67
|
+
: model;
|
|
68
|
+
}
|
|
69
|
+
function resolveFastModeExtension(input) {
|
|
70
|
+
if (!input.fast)
|
|
71
|
+
return [];
|
|
72
|
+
const candidates = (input.model ? [input.model] : [])
|
|
73
|
+
.map(stripThinkingSuffix);
|
|
74
|
+
if (candidates.length === 0) {
|
|
75
|
+
throw new Error(`fast mode requires an explicit supported native OpenAI-Codex model${input.agentName ? ` for agent '${input.agentName}'` : ""}.`);
|
|
76
|
+
}
|
|
77
|
+
const unsupported = candidates.filter((model) => !model.startsWith(FAST_MODE_PROVIDER_PREFIX));
|
|
78
|
+
if (unsupported.length > 0) {
|
|
79
|
+
throw new Error(`fast mode supports only native ${FAST_MODE_PROVIDER_PREFIX}* models; unsupported model${unsupported.length === 1 ? "" : "s"}: ${unsupported.join(", ")}.`);
|
|
80
|
+
}
|
|
81
|
+
return [resolveRuntimeModulePath(RUNTIME_EXTENSION_DIR, "fast-mode-extension")];
|
|
82
|
+
}
|
|
83
|
+
function extensionIdentifier(value) {
|
|
84
|
+
return `sha256:${createHash("sha256").update(path.normalize(value.trim())).digest("hex").slice(0, 16)}`;
|
|
85
|
+
}
|
|
86
|
+
function boundedExtensionIdentifiers(values) {
|
|
87
|
+
const ids = [...new Set(values.map(extensionIdentifier))];
|
|
88
|
+
return {
|
|
89
|
+
ids: ids.slice(0, MAX_LAUNCH_RESOLVED_EXTENSION_IDS),
|
|
90
|
+
omitted: Math.max(0, ids.length - MAX_LAUNCH_RESOLVED_EXTENSION_IDS),
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
function hasPermissionRules(rules) {
|
|
94
|
+
return rules !== undefined && Object.keys(rules).length > 0;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Children are pi sessions inside the parent or the runner process; a spawned
|
|
98
|
+
* `pi` received extra MCP server definitions as a CLI argument, but a session
|
|
99
|
+
* has no such input. Selecting a server that exists only in pi-mcp-adapter's
|
|
100
|
+
* runtime snapshot therefore cannot work and fails the launch.
|
|
101
|
+
*/
|
|
102
|
+
export function formatRuntimeSnapshotMcpServersError(agentName, serverNames) {
|
|
103
|
+
const subject = agentName ? `Agent '${agentName}'` : "Subagent";
|
|
104
|
+
return `${subject} selects MCP tools from servers that exist only in pi-mcp-adapter's runtime snapshot (${serverNames.join(", ")}). MCP servers from the runtime snapshot cannot be provided to in-process children; MCP tools must come from an ambient adapter extension in a background child (\`async: true\`), so add the server to the adapter's configuration file instead.`;
|
|
105
|
+
}
|
|
106
|
+
/** Path-like entries load extensions instead of naming tools, so Pi never reads them as modifiers. */
|
|
107
|
+
function isToolExtensionPath(entry) {
|
|
108
|
+
return entry.includes("/") || entry.endsWith(".ts") || entry.endsWith(".js");
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* A child's `tools` list is a complete allowlist. Read as names, Pi's modifier
|
|
112
|
+
* entries would become required tools no child has, or mix with the names the
|
|
113
|
+
* plan adds into a list Pi rejects. The modifier rule is Pi's `isToolModifier`:
|
|
114
|
+
* a `+name` or `-name` entry edits Pi's default tool selection.
|
|
115
|
+
*/
|
|
116
|
+
export function assertNoToolModifierEntries(agentName, tools) {
|
|
117
|
+
const entries = tools.filter((entry) => /^[+-]/u.test(entry) && !isToolExtensionPath(entry));
|
|
118
|
+
if (entries.length === 0)
|
|
119
|
+
return;
|
|
120
|
+
const subject = agentName ? `Agent '${agentName}'` : "Subagent";
|
|
121
|
+
throw new Error(`${subject} lists Pi tool modifier ${entries.length === 1 ? "entry" : "entries"} in \`tools\`: ${entries.join(", ")}. A child's \`tools\` list is the complete set of tools it gets, so +name and -name entries are not supported; name every tool the child needs, or omit \`tools\` and use \`excludeTools\` to drop one.`);
|
|
122
|
+
}
|
|
123
|
+
export function projectLaunchResolvedChildExtensions(toolPlan) {
|
|
124
|
+
const runtime = boundedExtensionIdentifiers(toolPlan.runtimeExtensions);
|
|
125
|
+
const configured = boundedExtensionIdentifiers(toolPlan.configuredExtensions);
|
|
126
|
+
const effective = boundedExtensionIdentifiers(toolPlan.extensionArgs);
|
|
127
|
+
return {
|
|
128
|
+
version: 1,
|
|
129
|
+
source: "launch-resolved",
|
|
130
|
+
disableAmbientExtensions: toolPlan.disableAmbientExtensions,
|
|
131
|
+
runtime: runtime.ids,
|
|
132
|
+
configured: configured.ids,
|
|
133
|
+
required: toolPlan.requiredExtensions.map(({ id }) => id),
|
|
134
|
+
effective: effective.ids,
|
|
135
|
+
omitted: {
|
|
136
|
+
runtime: runtime.omitted,
|
|
137
|
+
configured: configured.omitted,
|
|
138
|
+
required: 0,
|
|
139
|
+
effective: effective.omitted,
|
|
140
|
+
},
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Resolve the permission-system extension entry point when installed.
|
|
145
|
+
* Returns the absolute path to the extension's main module, or undefined
|
|
146
|
+
* when the package is not installed. Callers can check `autoInject` config
|
|
147
|
+
* to decide whether to include it in child sessions.
|
|
148
|
+
*/
|
|
149
|
+
export function resolvePermissionSystemExtension() {
|
|
150
|
+
const agentDir = getAgentDir();
|
|
151
|
+
const candidates = [
|
|
152
|
+
// Fork: the @xzzpig fork takes priority so child processes inherit the
|
|
153
|
+
// same permission system the parent session loads from settings.json.
|
|
154
|
+
// When only the upstream package is installed, behavior is unchanged.
|
|
155
|
+
path.join(agentDir, "npm", "node_modules", "@xzzpig", "pi-permission-system"),
|
|
156
|
+
// npm-scoped package (most common)
|
|
157
|
+
path.join(agentDir, "npm", "node_modules", "@gotgenes", "pi-permission-system"),
|
|
158
|
+
// direct extension directory (some layouts)
|
|
159
|
+
path.join(agentDir, "extensions", "pi-permission-system"),
|
|
160
|
+
];
|
|
161
|
+
const errors = [];
|
|
162
|
+
for (const extDir of candidates) {
|
|
163
|
+
if (!fs.existsSync(extDir))
|
|
164
|
+
continue;
|
|
165
|
+
const pkgPath = path.join(extDir, "package.json");
|
|
166
|
+
if (!fs.existsSync(pkgPath)) {
|
|
167
|
+
errors.push(new Error(`Permission-system package manifest is missing at ${pkgPath}.`));
|
|
168
|
+
continue;
|
|
169
|
+
}
|
|
170
|
+
try {
|
|
171
|
+
let pkg;
|
|
172
|
+
const parsed = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
|
|
173
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
174
|
+
throw new Error("manifest root must be an object");
|
|
175
|
+
}
|
|
176
|
+
pkg = parsed;
|
|
177
|
+
const extensions = pkg.pi?.extensions;
|
|
178
|
+
const entry = Array.isArray(extensions) ? extensions[0] : undefined;
|
|
179
|
+
if (typeof entry !== "string" || !entry.trim()) {
|
|
180
|
+
throw new Error(`Permission-system package manifest at ${pkgPath} must declare pi.extensions[0] as a non-empty string.`);
|
|
181
|
+
}
|
|
182
|
+
const resolved = path.resolve(extDir, entry);
|
|
183
|
+
if (fs.existsSync(resolved))
|
|
184
|
+
return resolved;
|
|
185
|
+
throw new Error(`Permission-system extension entry ${JSON.stringify(entry)} in ${pkgPath} does not exist at ${resolved}.`);
|
|
186
|
+
}
|
|
187
|
+
catch (error) {
|
|
188
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
189
|
+
errors.push(message.startsWith("Permission-system") ? new Error(message) : new Error(`Cannot read permission-system package manifest at ${pkgPath}: ${message}`));
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
if (errors.length > 0)
|
|
193
|
+
throw errors[0];
|
|
194
|
+
return undefined;
|
|
195
|
+
}
|
|
196
|
+
export function resolvePiLaunchToolPlan(input) {
|
|
197
|
+
const capabilityCeiling = intersectSubagentCapabilityCeilings(input.capabilityCeiling, input.inheritedCapabilityCeiling);
|
|
198
|
+
const requiredExtensions = snapshotRequiredChildExtensions(input.requiredExtensions ?? []);
|
|
199
|
+
if (requiredExtensions.length > 0 && capabilityCeiling?.denyExtensions) {
|
|
200
|
+
throw new Error(`Capability ceiling from ${capabilityCeiling.sources.join(", ") || "unknown source"} denies extensions but this host requires: ${requiredExtensions.map(({ id }) => id).join(", ")}.`);
|
|
201
|
+
}
|
|
202
|
+
const allowedToolSet = capabilityCeiling?.allowedTools === undefined
|
|
203
|
+
? undefined
|
|
204
|
+
: new Set(capabilityCeiling.allowedTools);
|
|
205
|
+
const requestedBuiltinTools = input.tools?.filter((tool) => !isToolExtensionPath(tool)) ?? [];
|
|
206
|
+
assertNoToolModifierEntries(input.agentName, input.tools ?? []);
|
|
207
|
+
if (input.requireReadTool && allowedToolSet && !allowedToolSet.has("read")) {
|
|
208
|
+
throw new Error(`Capability ceiling from ${capabilityCeiling?.sources.join(", ") || "unknown source"} excludes required tool 'read' for lazy skill loading.`);
|
|
209
|
+
}
|
|
210
|
+
const ceilingFilteredBuiltinTools = input.tools === undefined
|
|
211
|
+
? allowedToolSet
|
|
212
|
+
? [...allowedToolSet].filter((tool) => tool !== "subagent_command")
|
|
213
|
+
: []
|
|
214
|
+
: (input.requireReadTool &&
|
|
215
|
+
requestedBuiltinTools.length > 0 &&
|
|
216
|
+
!requestedBuiltinTools.includes("read") &&
|
|
217
|
+
!allowedToolSet
|
|
218
|
+
? ["read", ...requestedBuiltinTools]
|
|
219
|
+
: requestedBuiltinTools).filter((tool) => !allowedToolSet || allowedToolSet.has(tool));
|
|
220
|
+
const declaredBuiltinTools = ceilingFilteredBuiltinTools;
|
|
221
|
+
const excludeTools = [...new Set((input.excludeTools ?? []).map((tool) => tool.trim()).filter(Boolean))];
|
|
222
|
+
const excludedToolSet = new Set(excludeTools);
|
|
223
|
+
const effectiveDeclaredBuiltinTools = declaredBuiltinTools.filter((tool) => !excludedToolSet.has(tool));
|
|
224
|
+
const fanoutAuthorized = effectiveDeclaredBuiltinTools.includes("subagent") || (input.allowNestedSubagents === true &&
|
|
225
|
+
!excludedToolSet.has("subagent") &&
|
|
226
|
+
(!allowedToolSet || allowedToolSet.has("subagent")));
|
|
227
|
+
if (effectiveDeclaredBuiltinTools.includes("subagent_supervisor") && !fanoutAuthorized) {
|
|
228
|
+
throw new Error("Tool 'subagent_supervisor' requires fanout authorization: include 'subagent' in the effective tools allowlist or enable allowNestedSubagents.");
|
|
229
|
+
}
|
|
230
|
+
const toolExtensionPaths = capabilityCeiling?.denyExtensions
|
|
231
|
+
? []
|
|
232
|
+
: (input.tools ?? []).filter(isToolExtensionPath);
|
|
233
|
+
const mcpResolution = capabilityCeiling?.denyExtensions
|
|
234
|
+
? { selections: [], unresolvedSelectors: [] }
|
|
235
|
+
: input.builtinMcpTools
|
|
236
|
+
// The runner applies the same ceilings again; filtering is idempotent.
|
|
237
|
+
? { selections: input.builtinMcpTools, unresolvedSelectors: [], builtin: true }
|
|
238
|
+
: resolveMcpDirectToolResolution(input.mcpDirectTools, input.cwd, input.runtimeSnapshotHost);
|
|
239
|
+
if (mcpResolution.runtimeServerNames?.length) {
|
|
240
|
+
throw new Error(formatRuntimeSnapshotMcpServersError(input.agentName, mcpResolution.runtimeServerNames));
|
|
241
|
+
}
|
|
242
|
+
if (mcpResolution.unresolvedSelectors.length > 0) {
|
|
243
|
+
throw new Error(mcpResolution.builtin
|
|
244
|
+
? formatUnresolvedBuiltinMcpSelectors(input.agentName, mcpResolution.unresolvedSelectors)
|
|
245
|
+
: formatUnresolvedMcpDirectToolSelectors(mcpResolution.unresolvedSelectors));
|
|
246
|
+
}
|
|
247
|
+
const resolvedMcpSelections = mcpResolution.selections;
|
|
248
|
+
const resolvedMcpNames = new Set(resolvedMcpSelections.map((selection) => selection.name));
|
|
249
|
+
const legacyMcpNameCounts = mcpResolution.builtin ? new Map() : countLegacyUnderscoreMcpToolNames(resolvedMcpSelections);
|
|
250
|
+
const effectiveMcpSelections = resolvedMcpSelections.filter((selection) => !allowedToolSet ||
|
|
251
|
+
allowedToolSet.has(selection.name) ||
|
|
252
|
+
isLegacyUnderscoreMcpToolAllowed(selection, allowedToolSet, resolvedMcpNames, legacyMcpNameCounts)).filter((selection) => !excludedToolSet.has(selection.name));
|
|
253
|
+
const effectiveMcpTools = effectiveMcpSelections.map((selection) => selection.name);
|
|
254
|
+
const builtinMcpTools = mcpResolution.builtin ? effectiveMcpSelections : undefined;
|
|
255
|
+
const explicitToolAllowlist = input.tools !== undefined ||
|
|
256
|
+
(input.mcpDirectTools?.length ?? 0) > 0 ||
|
|
257
|
+
allowedToolSet !== undefined;
|
|
258
|
+
const internalTools = (input.structuredOutput ? ["structured_output"] : []).filter((tool) => !excludedToolSet.has(tool));
|
|
259
|
+
const effectiveToolAllowlist = [
|
|
260
|
+
...new Set([
|
|
261
|
+
...effectiveDeclaredBuiltinTools,
|
|
262
|
+
...effectiveMcpTools,
|
|
263
|
+
...internalTools,
|
|
264
|
+
]),
|
|
265
|
+
];
|
|
266
|
+
// Upward contact stays in the --tools allowlist but is not a strict
|
|
267
|
+
// requirement: children register contact_supervisor at runtime through
|
|
268
|
+
// the native supervisor channel (or pi-intercom). The pre-0.50 bridge always
|
|
269
|
+
// appended intercom alongside contact_supervisor, so that exact pairing is
|
|
270
|
+
// legacy plumbing, not a user demand for an external intercom provider;
|
|
271
|
+
// a lone intercom entry stays strictly required (#1207).
|
|
272
|
+
const legacySupervisorPairing = effectiveDeclaredBuiltinTools.includes("contact_supervisor");
|
|
273
|
+
const requiredChildTools = explicitToolAllowlist
|
|
274
|
+
? [
|
|
275
|
+
...new Set([
|
|
276
|
+
...(input.tools !== undefined ? effectiveDeclaredBuiltinTools : []),
|
|
277
|
+
...(input.mcpDirectTools?.length ? effectiveMcpTools : []),
|
|
278
|
+
...internalTools,
|
|
279
|
+
].filter((tool) => tool !== "contact_supervisor" && (!legacySupervisorPairing || tool !== "intercom"))),
|
|
280
|
+
]
|
|
281
|
+
: [];
|
|
282
|
+
const permSystemExt = capabilityCeiling?.denyExtensions
|
|
283
|
+
? undefined
|
|
284
|
+
: hasPermissionRules(input.permissionRules)
|
|
285
|
+
? resolvePermissionSystemExtension()
|
|
286
|
+
: undefined;
|
|
287
|
+
const { sandboxExtension, effectivePermSystemExt } = resolveProfileExtensions({
|
|
288
|
+
sandbox: input.sandbox,
|
|
289
|
+
permissionProfile: input.permissionProfile,
|
|
290
|
+
capabilityCeiling,
|
|
291
|
+
permSystemExt,
|
|
292
|
+
});
|
|
293
|
+
if (input.fast && capabilityCeiling?.denyExtensions)
|
|
294
|
+
throw new Error("fast mode requires a child runtime extension, but this launch denies extensions.");
|
|
295
|
+
const fastModeExtensions = resolveFastModeExtension({ fast: input.fast, model: input.model, agentName: input.agentName });
|
|
296
|
+
// Resolved per launch: an in-place package update can swap a sibling's .ts for .js.
|
|
297
|
+
const runtimeExtensions = [
|
|
298
|
+
resolveRuntimeModulePath(RUNTIME_EXTENSION_DIR, "subagent-prompt-runtime"),
|
|
299
|
+
...fastModeExtensions,
|
|
300
|
+
...(fanoutAuthorized ? [resolveRuntimeModulePath(FANOUT_CHILD_EXTENSION_DIR, "fanout-child")] : []),
|
|
301
|
+
...(effectivePermSystemExt ? [effectivePermSystemExt] : []),
|
|
302
|
+
...(sandboxExtension ? [sandboxExtension, SANDBOX_PROFILE_GUARD_EXTENSION_PATH] : []),
|
|
303
|
+
];
|
|
304
|
+
const disableAmbientExtensions = capabilityCeiling?.denyExtensions === true ||
|
|
305
|
+
input.extensions !== undefined;
|
|
306
|
+
const warnings = [];
|
|
307
|
+
// An explicit empty list disables ambient extensions, including model providers.
|
|
308
|
+
if (capabilityCeiling?.denyExtensions !== true && Array.isArray(input.extensions) && input.extensions.length === 0) {
|
|
309
|
+
const agentLabel = input.agentName ? ` for agent '${input.agentName}'` : "";
|
|
310
|
+
warnings.push(`extensions: [] override${agentLabel} disables ALL ambient extensions for this child (not just "adds nothing"), `
|
|
311
|
+
+ "including any model-provider extension needed to resolve a provider-qualified model. "
|
|
312
|
+
+ "List the extensions this child actually needs instead of an empty array.");
|
|
313
|
+
}
|
|
314
|
+
const configuredExtensions = capabilityCeiling?.denyExtensions
|
|
315
|
+
? []
|
|
316
|
+
: [
|
|
317
|
+
...toolExtensionPaths,
|
|
318
|
+
...(input.extensions ?? []),
|
|
319
|
+
...(input.subagentOnlyExtensions ?? []),
|
|
320
|
+
];
|
|
321
|
+
const ordinaryExtensionArgs = disableAmbientExtensions
|
|
322
|
+
? [...new Set([...runtimeExtensions, ...configuredExtensions])]
|
|
323
|
+
: [
|
|
324
|
+
...new Set([
|
|
325
|
+
...runtimeExtensions,
|
|
326
|
+
...toolExtensionPaths,
|
|
327
|
+
...(input.subagentOnlyExtensions ?? []),
|
|
328
|
+
]),
|
|
329
|
+
];
|
|
330
|
+
// Host-required paths have final precedence and cannot be removed by agent defaults or overrides.
|
|
331
|
+
const extensionArgs = [...new Set([...ordinaryExtensionArgs, ...requiredExtensions.map(({ path }) => path)])];
|
|
332
|
+
const requestedToolNames = input.tools !== undefined
|
|
333
|
+
? [
|
|
334
|
+
...new Set([
|
|
335
|
+
...requestedBuiltinTools,
|
|
336
|
+
...resolvedMcpSelections.map((selection) => selection.name),
|
|
337
|
+
]),
|
|
338
|
+
]
|
|
339
|
+
: undefined;
|
|
340
|
+
const capabilityAudit = capabilityCeiling
|
|
341
|
+
? {
|
|
342
|
+
ceiling: capabilityCeiling,
|
|
343
|
+
...(requestedToolNames ? { requestedTools: requestedToolNames } : {}),
|
|
344
|
+
effectiveTools: effectiveToolAllowlist,
|
|
345
|
+
...(excludeTools.length > 0 ? { excludeTools } : {}),
|
|
346
|
+
removedTools: requestedToolNames?.filter((tool) => !effectiveToolAllowlist.includes(tool)) ?? [],
|
|
347
|
+
internalTools,
|
|
348
|
+
extensionsDenied: capabilityCeiling.denyExtensions,
|
|
349
|
+
removedExtensionCount: capabilityCeiling.denyExtensions
|
|
350
|
+
? (input.extensions?.length ?? 0) +
|
|
351
|
+
(input.subagentOnlyExtensions?.length ?? 0) +
|
|
352
|
+
(input.tools ?? []).filter(isToolExtensionPath).length
|
|
353
|
+
: 0,
|
|
354
|
+
requestedMcpToolCount: input.mcpDirectTools?.length ?? 0,
|
|
355
|
+
effectiveMcpTools,
|
|
356
|
+
agentAllowed: input.agentName === undefined
|
|
357
|
+
? true
|
|
358
|
+
: isAgentAllowedByCapabilityCeiling(input.agentName, capabilityCeiling),
|
|
359
|
+
...(capabilityCeilingAgentRestrictionSources(capabilityCeiling)
|
|
360
|
+
? {
|
|
361
|
+
agentRestrictionSources: capabilityCeilingAgentRestrictionSources(capabilityCeiling),
|
|
362
|
+
}
|
|
363
|
+
: {}),
|
|
364
|
+
}
|
|
365
|
+
: undefined;
|
|
366
|
+
return {
|
|
367
|
+
...(capabilityCeiling ? { capabilityCeiling } : {}),
|
|
368
|
+
requestedBuiltinTools,
|
|
369
|
+
declaredBuiltinTools,
|
|
370
|
+
excludeTools,
|
|
371
|
+
toolExtensionPaths,
|
|
372
|
+
resolvedMcpSelections,
|
|
373
|
+
effectiveMcpSelections,
|
|
374
|
+
effectiveMcpTools,
|
|
375
|
+
builtinMcpTools,
|
|
376
|
+
explicitToolAllowlist,
|
|
377
|
+
internalTools,
|
|
378
|
+
effectiveToolAllowlist,
|
|
379
|
+
requiredChildTools,
|
|
380
|
+
fanoutAuthorized,
|
|
381
|
+
...(sandboxExtension ? { sandboxExtension } : {}),
|
|
382
|
+
runtimeExtensions,
|
|
383
|
+
configuredExtensions,
|
|
384
|
+
requiredExtensions,
|
|
385
|
+
extensionArgs,
|
|
386
|
+
disableAmbientExtensions,
|
|
387
|
+
warnings,
|
|
388
|
+
...(capabilityAudit ? { capabilityAudit } : {}),
|
|
389
|
+
};
|
|
390
|
+
}
|
|
391
|
+
// Capability ceilings persisted before #1685 may still name hyphenated MCP server prefixes with underscores.
|
|
392
|
+
function countLegacyUnderscoreMcpToolNames(selections) {
|
|
393
|
+
const counts = new Map();
|
|
394
|
+
for (const selection of selections) {
|
|
395
|
+
const legacyName = legacyUnderscoreMcpToolName(selection);
|
|
396
|
+
if (legacyName !== selection.name)
|
|
397
|
+
counts.set(legacyName, (counts.get(legacyName) ?? 0) + 1);
|
|
398
|
+
}
|
|
399
|
+
return counts;
|
|
400
|
+
}
|
|
401
|
+
function isLegacyUnderscoreMcpToolAllowed(selection, allowedToolSet, resolvedMcpNames, legacyMcpNameCounts) {
|
|
402
|
+
const legacyName = legacyUnderscoreMcpToolName(selection);
|
|
403
|
+
return legacyMcpNameCounts.get(legacyName) === 1 && !resolvedMcpNames.has(legacyName) && allowedToolSet.has(legacyName);
|
|
404
|
+
}
|
|
405
|
+
function legacyUnderscoreMcpToolName(selection) {
|
|
406
|
+
const slash = selection.selector.indexOf("/");
|
|
407
|
+
if (slash < 1)
|
|
408
|
+
return selection.name;
|
|
409
|
+
const toolName = selection.selector.slice(slash + 1);
|
|
410
|
+
const suffix = `_${toolName}`;
|
|
411
|
+
if (!selection.name.endsWith(suffix))
|
|
412
|
+
return selection.name;
|
|
413
|
+
const prefix = selection.name.slice(0, -suffix.length);
|
|
414
|
+
return `${prefix.replace(/-/g, "_")}${suffix}`;
|
|
415
|
+
}
|
|
416
|
+
export function getHostBuiltinToolNames(pi) {
|
|
417
|
+
try {
|
|
418
|
+
const builtins = pi
|
|
419
|
+
.getAllTools()
|
|
420
|
+
.filter((tool) => {
|
|
421
|
+
const source = tool.sourceInfo?.source;
|
|
422
|
+
return source === "builtin" || PI_BUILTIN_TOOL_NAMES.has(tool.name);
|
|
423
|
+
})
|
|
424
|
+
.map((tool) => tool.name);
|
|
425
|
+
return builtins.length > 0 ? builtins : undefined;
|
|
426
|
+
}
|
|
427
|
+
catch {
|
|
428
|
+
return undefined;
|
|
429
|
+
}
|
|
430
|
+
}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { type ExternalCliParser } from "./external-cli-runner.ts";
|
|
2
|
+
import type { ExternalCliPreflightSpec } from "./external-cli-preflight.ts";
|
|
3
|
+
import { type ThinkingLevel } from "../../shared/model-info.ts";
|
|
4
|
+
import { type ResolvedModelScope } from "./model-scope.ts";
|
|
5
|
+
export declare const CLAUDE_CODE_ADAPTER_ID: "claude-code";
|
|
6
|
+
export declare const CLAUDE_CODE_WRITER_ADAPTER_ID: "claude-code-writer";
|
|
7
|
+
/** True for the two code-owned adapters that launch the Claude Code CLI. */
|
|
8
|
+
export declare function isClaudeCodeAdapterId(value: unknown): value is typeof CLAUDE_CODE_ADAPTER_ID | typeof CLAUDE_CODE_WRITER_ADAPTER_ID;
|
|
9
|
+
export declare const CLAUDE_CODE_WRITER_TOOLS: "Read,Write,Edit,Glob,Grep";
|
|
10
|
+
export declare const CLAUDE_CODE_ENV_ALLOWLIST: readonly ["PATH", "HOME", "USERPROFILE", "USER", "LOGNAME", "TMPDIR", "CLAUDE_CONFIG_DIR", "ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN", "ANTHROPIC_BASE_URL", "CLAUDE_CODE_OAUTH_TOKEN", "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY", "AWS_PROFILE", "AWS_REGION", "AWS_DEFAULT_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_BEARER_TOKEN_BEDROCK", "GOOGLE_APPLICATION_CREDENTIALS", "CLOUD_ML_REGION", "ANTHROPIC_VERTEX_PROJECT_ID", "HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY", "http_proxy", "https_proxy", "no_proxy", "SSL_CERT_FILE", "SSL_CERT_DIR"];
|
|
11
|
+
export interface ClaudeCodeOverride {
|
|
12
|
+
/** Tokens appended after the adapter's fixed argv. */
|
|
13
|
+
args: string[];
|
|
14
|
+
/** Model id the launch pins, when it pins one. */
|
|
15
|
+
model?: string;
|
|
16
|
+
}
|
|
17
|
+
/** The agent-config fields that can pin a model, structurally typed to avoid importing them. */
|
|
18
|
+
export interface ClaudeCodeAgentModel {
|
|
19
|
+
model?: string | false;
|
|
20
|
+
modelSource?: {
|
|
21
|
+
type?: string;
|
|
22
|
+
model?: string;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Resolve an explicit model and thinking level for a code-owned Claude Code
|
|
27
|
+
* adapter. Returns undefined when neither was requested, so the CLI falls back
|
|
28
|
+
* to its own configured default.
|
|
29
|
+
*
|
|
30
|
+
* The level travels as the same `:level` suffix Pi children use:
|
|
31
|
+
* `model: "claude-opus-5.5:high"` pins the model and the effort, and a bare
|
|
32
|
+
* `model: ":high"` takes the effort alone on the agent's own model. A suffix
|
|
33
|
+
* wins over the frontmatter `thinking` value, which is the precedence Pi
|
|
34
|
+
* children already use.
|
|
35
|
+
*
|
|
36
|
+
* Values are validated here because this module owns the adapter's argv: every
|
|
37
|
+
* returned token is passed as its own argv element, and an unusable value is a
|
|
38
|
+
* rejected launch rather than a silently different model. The ceiling is checked
|
|
39
|
+
* against the requested level, not against the effort it maps to.
|
|
40
|
+
*/
|
|
41
|
+
export declare function resolveClaudeCodeOverride(input: {
|
|
42
|
+
model?: string;
|
|
43
|
+
agent?: ClaudeCodeAgentModel;
|
|
44
|
+
thinking?: string;
|
|
45
|
+
thinkingCeiling?: ThinkingLevel;
|
|
46
|
+
agentName?: string;
|
|
47
|
+
runId?: string;
|
|
48
|
+
}): ClaudeCodeOverride | undefined;
|
|
49
|
+
/**
|
|
50
|
+
* A Claude Code launch pins a model the Pi registry does not know, so an enforced
|
|
51
|
+
* model scope can only be honored by checking the id the CLI will actually run.
|
|
52
|
+
* A launch that pins nothing cannot be checked at all, and an enforced scope must
|
|
53
|
+
* not be bypassed by staying silent.
|
|
54
|
+
*/
|
|
55
|
+
export declare function assertClaudeCodeModelScope(input: {
|
|
56
|
+
scopes: readonly ResolvedModelScope[];
|
|
57
|
+
model?: string;
|
|
58
|
+
agent: string;
|
|
59
|
+
runId?: string;
|
|
60
|
+
}): void;
|
|
61
|
+
export declare function createClaudeCodeJsonlParser(): ExternalCliParser;
|
|
62
|
+
export declare function resolveClaudeCodeLaunch(input: {
|
|
63
|
+
adapter: typeof CLAUDE_CODE_ADAPTER_ID | typeof CLAUDE_CODE_WRITER_ADAPTER_ID;
|
|
64
|
+
command: string;
|
|
65
|
+
/** Test-only executable prefix for a fake Claude Code process. */
|
|
66
|
+
commandPrefixArgs?: readonly string[];
|
|
67
|
+
/** Trailing argv for an explicit model/thinking request, built by resolveClaudeCodeOverride. */
|
|
68
|
+
overrideArgs?: readonly string[];
|
|
69
|
+
}): {
|
|
70
|
+
command: string;
|
|
71
|
+
args: string[];
|
|
72
|
+
finalOutputPath?: undefined;
|
|
73
|
+
promptFilePath?: undefined;
|
|
74
|
+
temporaryDirectories?: undefined;
|
|
75
|
+
environment: {
|
|
76
|
+
allowlist: readonly string[];
|
|
77
|
+
};
|
|
78
|
+
preflight: ExternalCliPreflightSpec;
|
|
79
|
+
parser: ExternalCliParser;
|
|
80
|
+
};
|