@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,273 @@
|
|
|
1
|
+
import { getSingleResultOutput } from "../../shared/utils.js";
|
|
2
|
+
import { validateStructuredOutputValue } from "./structured-output.js";
|
|
3
|
+
export class DynamicFanoutError extends Error {
|
|
4
|
+
}
|
|
5
|
+
const SAFE_OUTPUT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
6
|
+
const ITEM_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
7
|
+
const ITEM_REF_PATTERN = /\{([A-Za-z_][A-Za-z0-9_]*)(?:\.([^{}]+))?\}/g;
|
|
8
|
+
const RESERVED_TEMPLATE_NAMES = new Set(["task", "previous", "chain_dir", "outputs"]);
|
|
9
|
+
const DYNAMIC_STEP_KEYS = new Set(["expand", "parallel", "collect", "concurrency", "failFast", "phase", "label", "acceptance", "agentContract", "gateOn"]);
|
|
10
|
+
const RUNNER_DYNAMIC_STEP_KEYS = new Set([...DYNAMIC_STEP_KEYS, "effectiveAcceptance", "acceptanceInput", "acceptanceRole", "sessionFiles", "thinkingOverrides"]);
|
|
11
|
+
const DYNAMIC_EXPAND_KEYS = new Set(["from", "item", "key", "maxItems", "onEmpty"]);
|
|
12
|
+
const DYNAMIC_EXPAND_FROM_KEYS = new Set(["output", "path"]);
|
|
13
|
+
const DYNAMIC_PARALLEL_KEYS = new Set(["agent", "task", "phase", "label", "outputSchema", "cwd", "machine", "output", "outputMode", "reads", "progress", "skill", "model", "fast", "toolBudget", "acceptance", "agentContract", "gateOn"]);
|
|
14
|
+
const RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([
|
|
15
|
+
...DYNAMIC_PARALLEL_KEYS,
|
|
16
|
+
"runner", "outputName", "structured", "inheritProjectContext", "inheritGlobalContext", "inheritSkills", "skills", "outputPath", "namespaceOutputPath", "maxSubagentDepth", "timeoutMs", "waitToolEnabled", "waitToolDefaultTimeoutMs",
|
|
17
|
+
"structuredOutput", "structuredOutputSchema", "tools", "excludeTools", "allowNestedSubagents", "extensions", "subagentOnlyExtensions", "mcpDirectTools", "builtinMcpTools", "mutationTools", "capabilityCeiling", "systemPrompt",
|
|
18
|
+
"systemPromptMode", "thinking", "requestedModel", "sessionFile", "effectiveAcceptance", "acceptanceInput", "acceptanceRole", "parentSessionId", "parentSessionFile", "requiredExtensions", "launchResolvedExtensions", "requestedCwd", "machineEnv",
|
|
19
|
+
]);
|
|
20
|
+
const DYNAMIC_COLLECT_KEYS = new Set(["as", "outputSchema"]);
|
|
21
|
+
export function isSafeOutputName(name) {
|
|
22
|
+
return SAFE_OUTPUT_NAME_PATTERN.test(name);
|
|
23
|
+
}
|
|
24
|
+
export function assertJsonPointer(pointer, label) {
|
|
25
|
+
if (pointer === "")
|
|
26
|
+
return;
|
|
27
|
+
if (!pointer.startsWith("/")) {
|
|
28
|
+
throw new DynamicFanoutError(`${label} must be a JSON Pointer starting with '/'.`);
|
|
29
|
+
}
|
|
30
|
+
for (const segment of pointer.slice(1).split("/")) {
|
|
31
|
+
if (/~(?![01])/.test(segment)) {
|
|
32
|
+
throw new DynamicFanoutError(`${label} contains invalid JSON Pointer escape.`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
function decodePointerSegment(segment) {
|
|
37
|
+
return segment.replace(/~1/g, "/").replace(/~0/g, "~");
|
|
38
|
+
}
|
|
39
|
+
export function resolveJsonPointer(value, pointer, label) {
|
|
40
|
+
assertJsonPointer(pointer, label);
|
|
41
|
+
if (pointer === "")
|
|
42
|
+
return value;
|
|
43
|
+
let current = value;
|
|
44
|
+
for (const rawSegment of pointer.slice(1).split("/")) {
|
|
45
|
+
const segment = decodePointerSegment(rawSegment);
|
|
46
|
+
if (Array.isArray(current)) {
|
|
47
|
+
if (!/^(0|[1-9][0-9]*)$/.test(segment)) {
|
|
48
|
+
throw new DynamicFanoutError(`${label} segment '${segment}' does not address an array index.`);
|
|
49
|
+
}
|
|
50
|
+
const index = Number(segment);
|
|
51
|
+
if (index >= current.length)
|
|
52
|
+
throw new DynamicFanoutError(`${label} does not exist.`);
|
|
53
|
+
current = current[index];
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
if (!current || typeof current !== "object") {
|
|
57
|
+
throw new DynamicFanoutError(`${label} does not exist.`);
|
|
58
|
+
}
|
|
59
|
+
const record = current;
|
|
60
|
+
if (!Object.prototype.hasOwnProperty.call(record, segment)) {
|
|
61
|
+
throw new DynamicFanoutError(`${label} does not exist.`);
|
|
62
|
+
}
|
|
63
|
+
current = record[segment];
|
|
64
|
+
}
|
|
65
|
+
return current;
|
|
66
|
+
}
|
|
67
|
+
function scalarToKey(value, label) {
|
|
68
|
+
if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
|
|
69
|
+
const key = String(value);
|
|
70
|
+
if (!key.trim())
|
|
71
|
+
throw new DynamicFanoutError(`${label} resolved to an empty key.`);
|
|
72
|
+
if (/[\u0000-\u001F\u007F]/.test(key))
|
|
73
|
+
throw new DynamicFanoutError(`${label} resolved to an unsafe key.`);
|
|
74
|
+
if (key.length > 200)
|
|
75
|
+
throw new DynamicFanoutError(`${label} resolved to a key longer than 200 characters.`);
|
|
76
|
+
return key;
|
|
77
|
+
}
|
|
78
|
+
throw new DynamicFanoutError(`${label} must resolve to a string, number, or boolean.`);
|
|
79
|
+
}
|
|
80
|
+
export function normalizeItemKeyForId(key) {
|
|
81
|
+
const normalized = key
|
|
82
|
+
.toLowerCase()
|
|
83
|
+
.replace(/[^a-z0-9]+/g, "-")
|
|
84
|
+
.replace(/^-+|-+$/g, "")
|
|
85
|
+
.slice(0, 80);
|
|
86
|
+
return normalized || "item";
|
|
87
|
+
}
|
|
88
|
+
function valueToTemplateText(value, reference) {
|
|
89
|
+
if (value === undefined)
|
|
90
|
+
throw new DynamicFanoutError(`Unresolved item reference '${reference}'.`);
|
|
91
|
+
if (typeof value === "string")
|
|
92
|
+
return value;
|
|
93
|
+
if (typeof value === "number" || typeof value === "boolean" || value === null)
|
|
94
|
+
return String(value);
|
|
95
|
+
return JSON.stringify(value);
|
|
96
|
+
}
|
|
97
|
+
function resolveItemPath(item, pathText, reference) {
|
|
98
|
+
if (!pathText)
|
|
99
|
+
return item;
|
|
100
|
+
const pointer = `/${pathText.split(".").map((segment) => segment.replace(/~/g, "~0").replace(/\//g, "~1")).join("/")}`;
|
|
101
|
+
return resolveJsonPointer(item, pointer, reference);
|
|
102
|
+
}
|
|
103
|
+
export function resolveItemTemplate(template, itemName, item) {
|
|
104
|
+
return template.replace(ITEM_REF_PATTERN, (raw, name, pathText) => {
|
|
105
|
+
if (name !== itemName)
|
|
106
|
+
return raw;
|
|
107
|
+
if (pathText !== undefined && (!pathText.trim() || pathText.includes(".."))) {
|
|
108
|
+
throw new DynamicFanoutError(`Invalid item reference '${raw}'.`);
|
|
109
|
+
}
|
|
110
|
+
return valueToTemplateText(resolveItemPath(item, pathText, raw), raw);
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
function assertOnlyKeys(value, allowed, label) {
|
|
114
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
115
|
+
throw new DynamicFanoutError(`${label} must be an object.`);
|
|
116
|
+
for (const key of Object.keys(value)) {
|
|
117
|
+
if (!allowed.has(key))
|
|
118
|
+
throw new DynamicFanoutError(`${label} does not support field '${key}'.`);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
export function assertNoUnresolvedItemReferences(template, itemName, label) {
|
|
122
|
+
for (const match of template.matchAll(/\{([^{}]*)\}/g)) {
|
|
123
|
+
const raw = match[0];
|
|
124
|
+
const reference = match[1];
|
|
125
|
+
if (reference === itemName || reference.startsWith(`${itemName}.`)) {
|
|
126
|
+
if (!ITEM_REF_PATTERN.test(raw) || reference === `${itemName}.` || reference.includes("..")) {
|
|
127
|
+
throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
|
|
128
|
+
}
|
|
129
|
+
ITEM_REF_PATTERN.lastIndex = 0;
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
ITEM_REF_PATTERN.lastIndex = 0;
|
|
133
|
+
const name = reference.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];
|
|
134
|
+
if (name === itemName)
|
|
135
|
+
throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
|
|
136
|
+
if (name && RESERVED_TEMPLATE_NAMES.has(name))
|
|
137
|
+
continue;
|
|
138
|
+
if (name)
|
|
139
|
+
throw new DynamicFanoutError(`Unsupported template reference '${raw}' in ${label}.`);
|
|
140
|
+
}
|
|
141
|
+
ITEM_REF_PATTERN.lastIndex = 0;
|
|
142
|
+
if (template.includes(`{${itemName}.}`) || new RegExp(`\\{${itemName}(?:\\.|$)[^}]*$`).test(template)) {
|
|
143
|
+
throw new DynamicFanoutError(`Invalid item reference in ${label}.`);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
export function hasDynamicFanoutFields(step) {
|
|
147
|
+
return !!step && typeof step === "object" && !Array.isArray(step)
|
|
148
|
+
&& (Object.prototype.hasOwnProperty.call(step, "expand") || Object.prototype.hasOwnProperty.call(step, "collect"));
|
|
149
|
+
}
|
|
150
|
+
export function validateDynamicStepShape(step, stepIndex, config = {}) {
|
|
151
|
+
const prefix = `Dynamic chain step ${stepIndex + 1}`;
|
|
152
|
+
assertOnlyKeys(step, config.allowRunnerFields ? RUNNER_DYNAMIC_STEP_KEYS : DYNAMIC_STEP_KEYS, prefix);
|
|
153
|
+
if (!step.expand || !step.expand.from)
|
|
154
|
+
throw new DynamicFanoutError(`${prefix} requires expand.from.`);
|
|
155
|
+
assertOnlyKeys(step.expand, DYNAMIC_EXPAND_KEYS, `${prefix} expand`);
|
|
156
|
+
assertOnlyKeys(step.expand.from, DYNAMIC_EXPAND_FROM_KEYS, `${prefix} expand.from`);
|
|
157
|
+
if (!isSafeOutputName(step.expand.from.output))
|
|
158
|
+
throw new DynamicFanoutError(`${prefix} has invalid expand.from.output '${step.expand.from.output}'.`);
|
|
159
|
+
assertJsonPointer(step.expand.from.path, `${prefix} expand.from.path`);
|
|
160
|
+
if (step.expand.key !== undefined)
|
|
161
|
+
assertJsonPointer(step.expand.key, `${prefix} expand.key`);
|
|
162
|
+
const itemName = step.expand.item ?? "item";
|
|
163
|
+
if (!ITEM_NAME_PATTERN.test(itemName))
|
|
164
|
+
throw new DynamicFanoutError(`${prefix} has invalid expand.item '${itemName}'.`);
|
|
165
|
+
if (step.expand.maxItems === undefined && config.maxItems === undefined) {
|
|
166
|
+
throw new DynamicFanoutError(`${prefix} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);
|
|
167
|
+
}
|
|
168
|
+
if (step.expand.maxItems !== undefined && (!Number.isInteger(step.expand.maxItems) || step.expand.maxItems < 0)) {
|
|
169
|
+
throw new DynamicFanoutError(`${prefix} expand.maxItems must be an integer >= 0.`);
|
|
170
|
+
}
|
|
171
|
+
if (config.maxItems !== undefined && (!Number.isInteger(config.maxItems) || config.maxItems < 0)) {
|
|
172
|
+
throw new DynamicFanoutError("config.chain.dynamicFanout.maxItems must be an integer >= 0.");
|
|
173
|
+
}
|
|
174
|
+
if (!step.parallel || Array.isArray(step.parallel))
|
|
175
|
+
throw new DynamicFanoutError(`${prefix} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);
|
|
176
|
+
assertOnlyKeys(step.parallel, config.allowRunnerFields ? RUNNER_DYNAMIC_PARALLEL_KEYS : DYNAMIC_PARALLEL_KEYS, `${prefix} parallel`);
|
|
177
|
+
if ("expand" in step.parallel)
|
|
178
|
+
throw new DynamicFanoutError(`${prefix} does not support nested dynamic fanout.`);
|
|
179
|
+
if (!step.parallel.agent)
|
|
180
|
+
throw new DynamicFanoutError(`${prefix} parallel.agent is required.`);
|
|
181
|
+
if (!step.collect?.as || !isSafeOutputName(step.collect.as))
|
|
182
|
+
throw new DynamicFanoutError(`${prefix} requires collect.as with a safe output name.`);
|
|
183
|
+
assertOnlyKeys(step.collect, DYNAMIC_COLLECT_KEYS, `${prefix} collect`);
|
|
184
|
+
for (const [label, template] of [
|
|
185
|
+
["parallel.task", step.parallel.task],
|
|
186
|
+
["parallel.label", step.parallel.label],
|
|
187
|
+
]) {
|
|
188
|
+
if (template)
|
|
189
|
+
assertNoUnresolvedItemReferences(template, itemName, `${prefix} ${label}`);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
export function resolveDynamicFanoutItems(step, outputs, stepIndex, config = {}) {
|
|
193
|
+
validateDynamicStepShape(step, stepIndex, config);
|
|
194
|
+
const sourceName = step.expand.from.output;
|
|
195
|
+
const source = outputs[sourceName];
|
|
196
|
+
if (!source)
|
|
197
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} references unknown output '${sourceName}'.`);
|
|
198
|
+
if (source.structured === undefined)
|
|
199
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires structured output '${sourceName}'.`);
|
|
200
|
+
const value = resolveJsonPointer(source.structured, step.expand.from.path, `Dynamic chain step ${stepIndex + 1} expand.from.path`);
|
|
201
|
+
if (!Array.isArray(value))
|
|
202
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} expand.from.path must resolve to an array.`);
|
|
203
|
+
const maxItems = step.expand.maxItems ?? config.maxItems;
|
|
204
|
+
if (maxItems === undefined)
|
|
205
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires an effective maxItems.`);
|
|
206
|
+
if (value.length > maxItems)
|
|
207
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} resolved ${value.length} items, exceeding maxItems ${maxItems}.`);
|
|
208
|
+
const seen = new Set();
|
|
209
|
+
const seenIds = new Set();
|
|
210
|
+
return value.map((item, index) => {
|
|
211
|
+
const key = step.expand.key === undefined
|
|
212
|
+
? String(index)
|
|
213
|
+
: scalarToKey(resolveJsonPointer(item, step.expand.key, `Dynamic chain step ${stepIndex + 1} expand.key`), `Dynamic chain step ${stepIndex + 1} expand.key`);
|
|
214
|
+
if (seen.has(key))
|
|
215
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced duplicate item key '${key}'.`);
|
|
216
|
+
seen.add(key);
|
|
217
|
+
const idKey = normalizeItemKeyForId(key);
|
|
218
|
+
if (seenIds.has(idKey))
|
|
219
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced colliding item id '${idKey}'.`);
|
|
220
|
+
seenIds.add(idKey);
|
|
221
|
+
return { index, key, idKey, item };
|
|
222
|
+
});
|
|
223
|
+
}
|
|
224
|
+
export function materializeDynamicParallelStep(step, outputs, stepIndex, config = {}) {
|
|
225
|
+
const items = resolveDynamicFanoutItems(step, outputs, stepIndex, config);
|
|
226
|
+
if (items.length === 0) {
|
|
227
|
+
if ((step.expand.onEmpty ?? "skip") === "fail") {
|
|
228
|
+
throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} source array is empty.`);
|
|
229
|
+
}
|
|
230
|
+
return { items, parallel: [], collectedOnEmpty: [] };
|
|
231
|
+
}
|
|
232
|
+
const itemName = step.expand.item ?? "item";
|
|
233
|
+
const parallel = items.map((entry) => {
|
|
234
|
+
const task = resolveItemTemplate(step.parallel.task ?? "{previous}", itemName, entry.item);
|
|
235
|
+
const label = step.parallel.label ? resolveItemTemplate(step.parallel.label, itemName, entry.item) : undefined;
|
|
236
|
+
return {
|
|
237
|
+
...step.parallel,
|
|
238
|
+
task,
|
|
239
|
+
...(label !== undefined ? { label } : {}),
|
|
240
|
+
};
|
|
241
|
+
});
|
|
242
|
+
return { items, parallel };
|
|
243
|
+
}
|
|
244
|
+
export function collectDynamicResults(step, items, results) {
|
|
245
|
+
return items.map((entry, index) => {
|
|
246
|
+
const result = results[index];
|
|
247
|
+
const text = result
|
|
248
|
+
? ("output" in result && typeof result.output === "string" ? result.output : getSingleResultOutput(result))
|
|
249
|
+
: "";
|
|
250
|
+
return {
|
|
251
|
+
key: entry.key,
|
|
252
|
+
index: entry.index,
|
|
253
|
+
item: entry.item,
|
|
254
|
+
agent: result?.agent ?? step.parallel.agent,
|
|
255
|
+
exitCode: result?.exitCode ?? null,
|
|
256
|
+
text,
|
|
257
|
+
...(result?.structuredOutput !== undefined ? { structured: result.structuredOutput } : {}),
|
|
258
|
+
...(result?.error ? { error: result.error } : {}),
|
|
259
|
+
...(result?.timedOut ? { timedOut: true } : {}),
|
|
260
|
+
...(result?.stopped ? { stopped: true } : {}),
|
|
261
|
+
...(result?.savedOutputPath ? { outputPath: result.savedOutputPath } : {}),
|
|
262
|
+
...(result?.artifactPaths ? { artifactPaths: result.artifactPaths } : {}),
|
|
263
|
+
};
|
|
264
|
+
});
|
|
265
|
+
}
|
|
266
|
+
export async function validateDynamicCollection(schema, value) {
|
|
267
|
+
if (!schema)
|
|
268
|
+
return;
|
|
269
|
+
const validation = await validateStructuredOutputValue(schema, value);
|
|
270
|
+
if (validation.status === "invalid") {
|
|
271
|
+
throw new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { AgentConfig } from "../../agents/agents.ts";
|
|
2
|
+
import { buildSkillInjection } from "../../agents/skills.ts";
|
|
3
|
+
export interface EffectiveSystemPromptInput {
|
|
4
|
+
/** Agent as handed to the child, including runtime-declared overlays such as the Intercom bridge. */
|
|
5
|
+
agent: AgentConfig;
|
|
6
|
+
resolvedSkills: Parameters<typeof buildSkillInjection>[0];
|
|
7
|
+
/** Directory that scopes memory and refinement lookups. */
|
|
8
|
+
cwd: string;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Child system prompt in the order preflight and every execution path hash:
|
|
12
|
+
* base prompt, skills, memory, refinement overlay. The per-run output path goes
|
|
13
|
+
* in the task message, so a child resumed with a new output path keeps the same
|
|
14
|
+
* system prompt and its provider prompt cache. Runtime acceptance prose is
|
|
15
|
+
* appended later and stays outside launch identity.
|
|
16
|
+
*/
|
|
17
|
+
export declare function buildEffectiveSystemPrompt(input: EffectiveSystemPromptInput): string;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { buildAgentMemoryInjection } from "../../agents/agent-memory.js";
|
|
2
|
+
import { appendAgentRefinementOverlay } from "../../agents/agent-refinements.js";
|
|
3
|
+
import { buildSkillInjection } from "../../agents/skills.js";
|
|
4
|
+
function appendSection(prompt, section) {
|
|
5
|
+
return prompt ? `${prompt}\n\n${section}` : section;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Child system prompt in the order preflight and every execution path hash:
|
|
9
|
+
* base prompt, skills, memory, refinement overlay. The per-run output path goes
|
|
10
|
+
* in the task message, so a child resumed with a new output path keeps the same
|
|
11
|
+
* system prompt and its provider prompt cache. Runtime acceptance prose is
|
|
12
|
+
* appended later and stays outside launch identity.
|
|
13
|
+
*/
|
|
14
|
+
export function buildEffectiveSystemPrompt(input) {
|
|
15
|
+
let prompt = input.agent.systemPrompt?.trim() ?? "";
|
|
16
|
+
if (input.resolvedSkills.length > 0)
|
|
17
|
+
prompt = appendSection(prompt, buildSkillInjection(input.resolvedSkills));
|
|
18
|
+
const memoryInjection = buildAgentMemoryInjection(input.agent, input.cwd);
|
|
19
|
+
if (memoryInjection)
|
|
20
|
+
prompt = appendSection(prompt, memoryInjection);
|
|
21
|
+
prompt = appendAgentRefinementOverlay(prompt, { cwd: input.cwd, agentName: input.agent.name });
|
|
22
|
+
return prompt;
|
|
23
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export declare const PI_SUBAGENT_EXTENSION_BINDINGS_ENV = "PI_SUBAGENT_EXTENSION_BINDINGS";
|
|
2
|
+
export declare const MAX_EXTENSION_BINDING_NAMESPACES = 16;
|
|
3
|
+
export declare const MAX_EXTENSION_BINDINGS_BYTES: number;
|
|
4
|
+
export declare const MAX_EXTENSION_BINDINGS_DEPTH = 16;
|
|
5
|
+
export declare const MAX_EXTENSION_BINDINGS_PROPERTIES = 256;
|
|
6
|
+
export type ExtensionBindingJson = null | boolean | number | string | ReadonlyArray<ExtensionBindingJson> | {
|
|
7
|
+
readonly [key: string]: ExtensionBindingJson;
|
|
8
|
+
};
|
|
9
|
+
export type ExtensionBindings = Readonly<Record<string, ExtensionBindingJson>>;
|
|
10
|
+
export interface NormalizedExtensionBindings {
|
|
11
|
+
value: ExtensionBindings;
|
|
12
|
+
json: string;
|
|
13
|
+
}
|
|
14
|
+
export declare function normalizeExtensionBindings(input: unknown): NormalizedExtensionBindings | undefined;
|
|
15
|
+
export declare function encodeExtensionBindings(input: ExtensionBindings | undefined): string | undefined;
|
|
16
|
+
export declare function omitExtensionBindingsEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
|
|
17
|
+
/**
|
|
18
|
+
* Drop launcher-owned profile selections from an inherited environment.
|
|
19
|
+
*
|
|
20
|
+
* A runner process must not carry the host session's role selection into the
|
|
21
|
+
* children it launches: each child's own selection is pinned by the child
|
|
22
|
+
* launch, so anything inherited here would silently apply to every step that
|
|
23
|
+
* does not declare one.
|
|
24
|
+
*/
|
|
25
|
+
export declare function omitInheritedProfileEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { SUBAGENT_PERMISSION_PROFILE_ENV, SUBAGENT_PERMISSION_PROFILE_PINNED_ENV } from "../../shared/permission-profile.js";
|
|
2
|
+
import { SUBAGENT_SANDBOX_PROFILE_ENV, SUBAGENT_SANDBOX_PROJECT_TRUST_ENV, } from "../../shared/sandbox-profile.js";
|
|
3
|
+
export const PI_SUBAGENT_EXTENSION_BINDINGS_ENV = "PI_SUBAGENT_EXTENSION_BINDINGS";
|
|
4
|
+
export const MAX_EXTENSION_BINDING_NAMESPACES = 16;
|
|
5
|
+
export const MAX_EXTENSION_BINDINGS_BYTES = 16 * 1024;
|
|
6
|
+
export const MAX_EXTENSION_BINDINGS_DEPTH = 16;
|
|
7
|
+
export const MAX_EXTENSION_BINDINGS_PROPERTIES = 256;
|
|
8
|
+
const EXTENSION_BINDING_NAMESPACE = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,62})\/[1-9][0-9]{0,8}$/;
|
|
9
|
+
function canonicalizeJson(value, path, depth, seen, propertyCount) {
|
|
10
|
+
if (value === null || typeof value === "string" || typeof value === "boolean")
|
|
11
|
+
return value;
|
|
12
|
+
if (typeof value === "number") {
|
|
13
|
+
if (!Number.isFinite(value))
|
|
14
|
+
throw new Error(`${path} must contain only finite JSON numbers.`);
|
|
15
|
+
return value;
|
|
16
|
+
}
|
|
17
|
+
if (typeof value !== "object")
|
|
18
|
+
throw new Error(`${path} must contain only plain JSON values.`);
|
|
19
|
+
if (depth > MAX_EXTENSION_BINDINGS_DEPTH)
|
|
20
|
+
throw new Error(`${path} exceeds the maximum nesting depth of ${MAX_EXTENSION_BINDINGS_DEPTH}.`);
|
|
21
|
+
if (seen.has(value))
|
|
22
|
+
throw new Error(`${path} must not contain cycles.`);
|
|
23
|
+
seen.add(value);
|
|
24
|
+
try {
|
|
25
|
+
if (Array.isArray(value)) {
|
|
26
|
+
const output = [];
|
|
27
|
+
for (let index = 0; index < value.length; index++) {
|
|
28
|
+
if (!Object.prototype.hasOwnProperty.call(value, index))
|
|
29
|
+
throw new Error(`${path} must not contain sparse arrays.`);
|
|
30
|
+
output.push(canonicalizeJson(value[index], `${path}[${index}]`, depth + 1, seen, propertyCount));
|
|
31
|
+
}
|
|
32
|
+
return Object.freeze(output);
|
|
33
|
+
}
|
|
34
|
+
const prototype = Object.getPrototypeOf(value);
|
|
35
|
+
if (prototype !== Object.prototype && prototype !== null)
|
|
36
|
+
throw new Error(`${path} must contain only plain JSON objects.`);
|
|
37
|
+
if (Object.getOwnPropertySymbols(value).length > 0)
|
|
38
|
+
throw new Error(`${path} must not contain symbol keys.`);
|
|
39
|
+
const descriptors = Object.getOwnPropertyDescriptors(value);
|
|
40
|
+
const output = {};
|
|
41
|
+
for (const key of Object.keys(descriptors).sort()) {
|
|
42
|
+
const descriptor = descriptors[key];
|
|
43
|
+
if (!descriptor.enumerable || !("value" in descriptor))
|
|
44
|
+
throw new Error(`${path}.${key} must be an enumerable data property.`);
|
|
45
|
+
propertyCount.value += 1;
|
|
46
|
+
if (propertyCount.value > MAX_EXTENSION_BINDINGS_PROPERTIES)
|
|
47
|
+
throw new Error(`extensionBindings exceeds ${MAX_EXTENSION_BINDINGS_PROPERTIES} total properties.`);
|
|
48
|
+
Object.defineProperty(output, key, { value: canonicalizeJson(descriptor.value, `${path}.${key}`, depth + 1, seen, propertyCount), enumerable: true, writable: false, configurable: false });
|
|
49
|
+
}
|
|
50
|
+
return Object.freeze(output);
|
|
51
|
+
}
|
|
52
|
+
finally {
|
|
53
|
+
seen.delete(value);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
export function normalizeExtensionBindings(input) {
|
|
57
|
+
if (input === undefined)
|
|
58
|
+
return undefined;
|
|
59
|
+
if (!input || typeof input !== "object" || Array.isArray(input))
|
|
60
|
+
throw new Error("extensionBindings must be a plain JSON object.");
|
|
61
|
+
const prototype = Object.getPrototypeOf(input);
|
|
62
|
+
if (prototype !== Object.prototype && prototype !== null)
|
|
63
|
+
throw new Error("extensionBindings must be a plain JSON object.");
|
|
64
|
+
const keys = Object.keys(input);
|
|
65
|
+
if (keys.length > MAX_EXTENSION_BINDING_NAMESPACES)
|
|
66
|
+
throw new Error(`extensionBindings supports at most ${MAX_EXTENSION_BINDING_NAMESPACES} namespaces.`);
|
|
67
|
+
for (const key of keys) {
|
|
68
|
+
if (!EXTENSION_BINDING_NAMESPACE.test(key))
|
|
69
|
+
throw new Error(`extensionBindings namespace '${key}' must use a package-like name followed by '/<positive-version>'.`);
|
|
70
|
+
}
|
|
71
|
+
const value = canonicalizeJson(input, "extensionBindings", 0, new Set(), { value: 0 });
|
|
72
|
+
const json = JSON.stringify(value);
|
|
73
|
+
const bytes = Buffer.byteLength(json, "utf8");
|
|
74
|
+
if (bytes > MAX_EXTENSION_BINDINGS_BYTES)
|
|
75
|
+
throw new Error(`extensionBindings canonical JSON is ${bytes} bytes; maximum is ${MAX_EXTENSION_BINDINGS_BYTES}.`);
|
|
76
|
+
return { value, json };
|
|
77
|
+
}
|
|
78
|
+
export function encodeExtensionBindings(input) {
|
|
79
|
+
return input === undefined ? undefined : normalizeExtensionBindings(input).json;
|
|
80
|
+
}
|
|
81
|
+
export function omitExtensionBindingsEnv(env) {
|
|
82
|
+
const { [PI_SUBAGENT_EXTENSION_BINDINGS_ENV]: _extensionBindings, ...sanitized } = env;
|
|
83
|
+
return sanitized;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Drop launcher-owned profile selections from an inherited environment.
|
|
87
|
+
*
|
|
88
|
+
* A runner process must not carry the host session's role selection into the
|
|
89
|
+
* children it launches: each child's own selection is pinned by the child
|
|
90
|
+
* launch, so anything inherited here would silently apply to every step that
|
|
91
|
+
* does not declare one.
|
|
92
|
+
*/
|
|
93
|
+
export function omitInheritedProfileEnv(env) {
|
|
94
|
+
const { [SUBAGENT_PERMISSION_PROFILE_ENV]: _permissionProfile, [SUBAGENT_PERMISSION_PROFILE_PINNED_ENV]: _permissionProfilePinned, [SUBAGENT_SANDBOX_PROFILE_ENV]: _sandboxProfile, [SUBAGENT_SANDBOX_PROJECT_TRUST_ENV]: _sandboxTrust, ...sanitized } = env;
|
|
95
|
+
return sanitized;
|
|
96
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { ExternalCliReceiptMetadata, ExternalCliCapabilityNarrowing, ExternalCliRunnerStatus, ExternalProcessStatus, HerdrMachineReference } from "../../shared/types.ts";
|
|
2
|
+
export declare const CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS: readonly ["codex-exec", "codex-exec-writer", "claude-code", "claude-code-writer", "cursor-agent", "cursor-agent-writer"];
|
|
3
|
+
export type CodeOwnedExternalCliAdapterId = typeof CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS[number];
|
|
4
|
+
export declare const CODE_OWNED_EXTERNAL_CLI_ADAPTER_LABEL: string;
|
|
5
|
+
export declare function isCodeOwnedExternalCliAdapterId(value: unknown): value is CodeOwnedExternalCliAdapterId;
|
|
6
|
+
export declare function validateCodeOwnedProfileRunner(agent: {
|
|
7
|
+
name: string;
|
|
8
|
+
localName?: string;
|
|
9
|
+
aliases?: readonly string[];
|
|
10
|
+
runner?: {
|
|
11
|
+
type: string;
|
|
12
|
+
adapter?: string;
|
|
13
|
+
};
|
|
14
|
+
}): string | undefined;
|
|
15
|
+
export declare function parseExternalCliCapabilityNarrowing(value: unknown, label: string): ExternalCliCapabilityNarrowing | undefined;
|
|
16
|
+
export declare function resolveExternalCliRunnerStatus(input: {
|
|
17
|
+
adapter?: CodeOwnedExternalCliAdapterId;
|
|
18
|
+
command: string;
|
|
19
|
+
args?: string[];
|
|
20
|
+
promptDelivery?: "stdin";
|
|
21
|
+
capabilities?: ExternalCliCapabilityNarrowing;
|
|
22
|
+
machine?: HerdrMachineReference;
|
|
23
|
+
}): ExternalCliRunnerStatus;
|
|
24
|
+
export declare function normalizeExternalCliRunnerStatus(value: unknown): ExternalCliRunnerStatus | undefined;
|
|
25
|
+
export declare function externalCliReceiptMetadata(input: {
|
|
26
|
+
runner: ExternalCliRunnerStatus;
|
|
27
|
+
externalProcess?: ExternalProcessStatus;
|
|
28
|
+
outputReference?: string;
|
|
29
|
+
}): ExternalCliReceiptMetadata;
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
const UNSUPPORTED = {
|
|
2
|
+
steer: "The one-shot stdin adapter closes input after launch and cannot accept live steer messages.",
|
|
3
|
+
resume: "The one-shot stdin adapter has no durable external session identity.",
|
|
4
|
+
structuredOutput: "The generic external CLI adapter does not parse a trusted structured result.",
|
|
5
|
+
toolEvents: "The generic external CLI adapter treats stdout as untrusted text, not native Pi tool events.",
|
|
6
|
+
supervisor: "The generic external CLI adapter has no trusted supervisor event transport.",
|
|
7
|
+
forkContext: "Native Pi fork context is not available without an adapter-owned handoff artifact.",
|
|
8
|
+
extensionBindings: "Native Pi extension bindings are never passed to external runners.",
|
|
9
|
+
};
|
|
10
|
+
const CAPABILITY_KEYS = new Set(Object.keys(UNSUPPORTED));
|
|
11
|
+
const PROMPT_FILE_UNSUPPORTED = {
|
|
12
|
+
...UNSUPPORTED,
|
|
13
|
+
steer: "The one-shot prompt-file adapter closes input after launch and cannot accept live steer messages.",
|
|
14
|
+
resume: "The one-shot prompt-file adapter does not retain a durable external session identity.",
|
|
15
|
+
};
|
|
16
|
+
export const CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS = [
|
|
17
|
+
"codex-exec",
|
|
18
|
+
"codex-exec-writer",
|
|
19
|
+
"claude-code",
|
|
20
|
+
"claude-code-writer",
|
|
21
|
+
"cursor-agent",
|
|
22
|
+
"cursor-agent-writer",
|
|
23
|
+
];
|
|
24
|
+
const CODE_OWNED_EXTERNAL_CLI_ADAPTER_ID_SET = new Set(CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS);
|
|
25
|
+
export const CODE_OWNED_EXTERNAL_CLI_ADAPTER_LABEL = CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS.map((id) => `'${id}'`).join(", ");
|
|
26
|
+
export function isCodeOwnedExternalCliAdapterId(value) {
|
|
27
|
+
return typeof value === "string" && CODE_OWNED_EXTERNAL_CLI_ADAPTER_ID_SET.has(value);
|
|
28
|
+
}
|
|
29
|
+
const RESERVED_READ_ONLY_ADAPTERS = [
|
|
30
|
+
{ name: "claude-code", writer: "claude-code-writer", access: "file-write" },
|
|
31
|
+
{ name: "codex-exec", writer: "codex-exec-writer", access: "workspace-write" },
|
|
32
|
+
{ name: "cursor-agent", writer: "cursor-agent-writer", access: "workspace-write" },
|
|
33
|
+
];
|
|
34
|
+
export function validateCodeOwnedProfileRunner(agent) {
|
|
35
|
+
const selectionNames = [agent.name, ...(agent.localName ? [agent.localName] : []), ...(agent.aliases ?? [])];
|
|
36
|
+
for (const adapter of RESERVED_READ_ONLY_ADAPTERS) {
|
|
37
|
+
if (selectionNames.includes(adapter.name) && !(agent.runner?.type === "external-cli" && agent.runner.adapter === adapter.name)) {
|
|
38
|
+
return `Selection name '${adapter.name}' is reserved for the read-only '${adapter.name}' adapter. Use '${adapter.writer}' for explicit ${adapter.access} access.`;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
return undefined;
|
|
42
|
+
}
|
|
43
|
+
export function parseExternalCliCapabilityNarrowing(value, label) {
|
|
44
|
+
if (value === undefined)
|
|
45
|
+
return undefined;
|
|
46
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
47
|
+
throw new Error(`${label} must be an object.`);
|
|
48
|
+
const input = value;
|
|
49
|
+
const unknown = Object.keys(input).filter((key) => !CAPABILITY_KEYS.has(key));
|
|
50
|
+
if (unknown.length > 0)
|
|
51
|
+
throw new Error(`${label} has unsupported fields: ${unknown.join(", ")}.`);
|
|
52
|
+
for (const [key, setting] of Object.entries(input)) {
|
|
53
|
+
if (setting !== false)
|
|
54
|
+
throw new Error(`${label}.${key} may only be false; user config cannot widen code-owned external adapter capabilities.`);
|
|
55
|
+
}
|
|
56
|
+
return input;
|
|
57
|
+
}
|
|
58
|
+
export function resolveExternalCliRunnerStatus(input) {
|
|
59
|
+
const codexExec = input.adapter === "codex-exec";
|
|
60
|
+
const codexExecWriter = input.adapter === "codex-exec-writer";
|
|
61
|
+
const claudeCode = input.adapter === "claude-code";
|
|
62
|
+
const claudeCodeWriter = input.adapter === "claude-code-writer";
|
|
63
|
+
const cursorAgent = input.adapter === "cursor-agent";
|
|
64
|
+
const cursorAgentWriter = input.adapter === "cursor-agent-writer";
|
|
65
|
+
const cursor = cursorAgent || cursorAgentWriter;
|
|
66
|
+
const unsupported = cursor ? PROMPT_FILE_UNSUPPORTED : UNSUPPORTED;
|
|
67
|
+
return {
|
|
68
|
+
type: "external-cli",
|
|
69
|
+
command: input.command,
|
|
70
|
+
args: input.args ?? [],
|
|
71
|
+
promptDelivery: cursor ? "prompt-file" : input.promptDelivery ?? "stdin",
|
|
72
|
+
adapter: { id: input.adapter ?? "external-cli", version: 1, executionMode: cursor ? "one-shot-prompt-file" : "one-shot-stdin" },
|
|
73
|
+
...(codexExec ? { safety: { sandbox: "read-only", approvalPolicy: "never", ephemeral: true } } : {}),
|
|
74
|
+
...(codexExecWriter ? { safety: { access: "workspace-write", sandbox: "workspace-write", approvalPolicy: "never", ephemeral: true } } : {}),
|
|
75
|
+
...(claudeCode ? { safety: { access: "read-only", authentication: "existing-cli-required", permissionMode: "plan", tools: "none", mcp: "empty-strict", settingSources: "user", userSettingsTrust: "required", sessionPersistence: false } } : {}),
|
|
76
|
+
...(claudeCodeWriter ? { safety: { access: "workspace-write", authentication: "existing-cli-required", permissionMode: "acceptEdits", tools: "Read,Write,Edit,Glob,Grep", mcp: "empty-strict", settingSources: "user", userSettingsTrust: "required", sessionPersistence: false } } : {}),
|
|
77
|
+
...(cursorAgent ? { safety: { access: "read-only", authentication: "cursor-api-key-or-existing-login", mode: "ask", sandbox: "enabled", workspaceTrust: "existing-required", sessionReuse: false } } : {}),
|
|
78
|
+
...(cursorAgentWriter ? { safety: { access: "workspace-write", authentication: "cursor-api-key-or-existing-login", mode: "print", sandbox: "enabled", workspaceTrust: "existing-required", sessionReuse: false } } : {}),
|
|
79
|
+
...(input.machine ? { machine: input.machine } : {}),
|
|
80
|
+
capabilities: {
|
|
81
|
+
stop: true,
|
|
82
|
+
steer: false,
|
|
83
|
+
resume: false,
|
|
84
|
+
structuredOutput: false,
|
|
85
|
+
toolEvents: false,
|
|
86
|
+
supervisor: "unsupported",
|
|
87
|
+
forkContext: false,
|
|
88
|
+
extensionBindings: false,
|
|
89
|
+
},
|
|
90
|
+
unsupportedReasons: unsupported,
|
|
91
|
+
nonResumableReason: unsupported.resume,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
export function normalizeExternalCliRunnerStatus(value) {
|
|
95
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
96
|
+
return undefined;
|
|
97
|
+
const input = value;
|
|
98
|
+
if (input.type !== "external-cli" || typeof input.command !== "string" || !input.command.trim())
|
|
99
|
+
return undefined;
|
|
100
|
+
const args = Array.isArray(input.args) && input.args.every((arg) => typeof arg === "string")
|
|
101
|
+
? input.args
|
|
102
|
+
: undefined;
|
|
103
|
+
const promptDelivery = input.promptDelivery === "stdin" ? "stdin" : undefined;
|
|
104
|
+
const machine = input.machine && typeof input.machine === "object" && !Array.isArray(input.machine)
|
|
105
|
+
? input.machine
|
|
106
|
+
: undefined;
|
|
107
|
+
const adapterId = input.adapter && typeof input.adapter === "object" && !Array.isArray(input.adapter)
|
|
108
|
+
? input.adapter.id
|
|
109
|
+
: undefined;
|
|
110
|
+
if (adapterId === "grok-build") {
|
|
111
|
+
return {
|
|
112
|
+
type: "external-cli",
|
|
113
|
+
command: input.command,
|
|
114
|
+
...(machine ? { machine } : {}),
|
|
115
|
+
args: args ?? [],
|
|
116
|
+
promptDelivery: "prompt-file",
|
|
117
|
+
adapter: { id: "grok-build", version: 1, executionMode: "one-shot-prompt-file" },
|
|
118
|
+
capabilities: { stop: true, steer: false, resume: false, structuredOutput: false, toolEvents: false, supervisor: "unsupported", forkContext: false, extensionBindings: false },
|
|
119
|
+
unsupportedReasons: PROMPT_FILE_UNSUPPORTED,
|
|
120
|
+
nonResumableReason: PROMPT_FILE_UNSUPPORTED.resume,
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
const adapter = isCodeOwnedExternalCliAdapterId(adapterId) ? adapterId : undefined;
|
|
124
|
+
return resolveExternalCliRunnerStatus({ ...(adapter ? { adapter } : {}), command: input.command, ...(args ? { args } : {}), ...(promptDelivery ? { promptDelivery } : {}), ...(machine ? { machine } : {}) });
|
|
125
|
+
}
|
|
126
|
+
export function externalCliReceiptMetadata(input) {
|
|
127
|
+
const { runner } = input;
|
|
128
|
+
const machine = input.externalProcess?.machine ?? runner.machine;
|
|
129
|
+
return {
|
|
130
|
+
adapter: { ...runner.adapter },
|
|
131
|
+
capabilities: { ...runner.capabilities },
|
|
132
|
+
...(machine ? { machine: { ...machine, ...(machine.remoteGit ? { remoteGit: { ...machine.remoteGit } } : {}) } } : {}),
|
|
133
|
+
...(runner.safety ? { safety: { ...runner.safety } } : {}),
|
|
134
|
+
...(input.externalProcess ? {
|
|
135
|
+
outputArtifacts: {
|
|
136
|
+
stdoutPath: input.externalProcess.stdoutPath,
|
|
137
|
+
stderrPath: input.externalProcess.stderrPath,
|
|
138
|
+
...(input.outputReference || input.externalProcess.finalOutputPath ? { finalOutputPath: input.outputReference ?? input.externalProcess.finalOutputPath } : {}),
|
|
139
|
+
},
|
|
140
|
+
} : input.outputReference ? { outputArtifacts: { finalOutputPath: input.outputReference } } : {}),
|
|
141
|
+
handoff: { mode: "fresh" },
|
|
142
|
+
supervisor: { mode: "unsupported", reason: runner.unsupportedReasons.supervisor },
|
|
143
|
+
nonResumableReason: runner.nonResumableReason,
|
|
144
|
+
};
|
|
145
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
export type ExternalCliPreflightInvalidationReason = "launch" | "auth" | "parser" | "permission";
|
|
2
|
+
export interface ExternalCliPreflightSpec {
|
|
3
|
+
id: string;
|
|
4
|
+
versionArgs: readonly string[];
|
|
5
|
+
helpArgs: readonly string[];
|
|
6
|
+
evidenceArgs?: readonly string[];
|
|
7
|
+
evidenceLabel?: string;
|
|
8
|
+
probeTimeoutMs?: number;
|
|
9
|
+
/** Remote probes include SSH handshakes; values may only narrow the code-owned remote ceiling. */
|
|
10
|
+
remote?: boolean;
|
|
11
|
+
validate?: (result: ExternalCliPreflightResult) => void;
|
|
12
|
+
}
|
|
13
|
+
export interface ExternalCliPreflightResult {
|
|
14
|
+
binaryPath: string;
|
|
15
|
+
binaryMtimeMs: number;
|
|
16
|
+
version: string;
|
|
17
|
+
help: string;
|
|
18
|
+
evidence?: string;
|
|
19
|
+
cacheHit: boolean;
|
|
20
|
+
}
|
|
21
|
+
export type ExternalCliBinaryAvailability = {
|
|
22
|
+
available: true;
|
|
23
|
+
} | {
|
|
24
|
+
available: false;
|
|
25
|
+
unavailableReason: string;
|
|
26
|
+
};
|
|
27
|
+
/** Resolve only the configured command; unlike preflight, this never starts a child process. */
|
|
28
|
+
export declare function resolveExternalCliBinaryAvailability(command: string, env: NodeJS.ProcessEnv): ExternalCliBinaryAvailability;
|
|
29
|
+
export interface ExternalCliSpawn {
|
|
30
|
+
command: string;
|
|
31
|
+
args: readonly string[];
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Node refuses to spawn `.cmd`/`.bat` files without a shell (CVE-2024-27980), and a shell would expand
|
|
35
|
+
* `%` and `!` inside operator- and project-controlled arguments. On Windows, an npm Node shim is launched
|
|
36
|
+
* by running Node on its script directly; every other batch wrapper is rejected.
|
|
37
|
+
*/
|
|
38
|
+
export declare function resolveExternalCliSpawn(command: string, args: readonly string[], env: NodeJS.ProcessEnv, platform?: NodeJS.Platform): ExternalCliSpawn;
|
|
39
|
+
export declare function preflightExternalCli(command: string, spec: ExternalCliPreflightSpec, env: NodeJS.ProcessEnv, cwd?: string): ExternalCliPreflightResult;
|
|
40
|
+
export declare function invalidateExternalCliPreflight(command: string, spec: ExternalCliPreflightSpec, _reason: ExternalCliPreflightInvalidationReason): void;
|
|
41
|
+
export declare function clearExternalCliPreflightCacheForTests(): void;
|