@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,44 @@
|
|
|
1
|
+
export const RUNTIME_EXTENSION_ACK_EVENT = "subagent:acknowledge-extension";
|
|
2
|
+
export const MAX_RUNTIME_ACKNOWLEDGED_EXTENSION_IDS = 32;
|
|
3
|
+
export const MAX_RUNTIME_ACKNOWLEDGED_EXTENSION_ID_LENGTH = 128;
|
|
4
|
+
export function isRuntimeAcknowledgedExtensionId(value) {
|
|
5
|
+
return typeof value === "string"
|
|
6
|
+
&& value.length > 0
|
|
7
|
+
&& value.length <= MAX_RUNTIME_ACKNOWLEDGED_EXTENSION_ID_LENGTH
|
|
8
|
+
&& /^[A-Za-z0-9._:@+-]+$/.test(value)
|
|
9
|
+
&& !value.includes("..")
|
|
10
|
+
&& !value.includes("/")
|
|
11
|
+
&& !value.includes("\\");
|
|
12
|
+
}
|
|
13
|
+
export function projectRuntimeAcknowledgedExtensions(ids) {
|
|
14
|
+
const unique = [];
|
|
15
|
+
const seen = new Set();
|
|
16
|
+
for (const id of ids) {
|
|
17
|
+
if (!isRuntimeAcknowledgedExtensionId(id) || seen.has(id))
|
|
18
|
+
continue;
|
|
19
|
+
seen.add(id);
|
|
20
|
+
unique.push(id);
|
|
21
|
+
}
|
|
22
|
+
if (unique.length === 0)
|
|
23
|
+
return undefined;
|
|
24
|
+
return {
|
|
25
|
+
version: 1,
|
|
26
|
+
source: "child-runtime",
|
|
27
|
+
ids: unique.slice(0, MAX_RUNTIME_ACKNOWLEDGED_EXTENSION_IDS),
|
|
28
|
+
omitted: Math.max(0, unique.length - MAX_RUNTIME_ACKNOWLEDGED_EXTENSION_IDS),
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function sanitizeRuntimeAcknowledgedExtensions(value) {
|
|
32
|
+
if (!value || typeof value !== "object")
|
|
33
|
+
return undefined;
|
|
34
|
+
const raw = value;
|
|
35
|
+
if (raw.version !== 1 || raw.source !== "child-runtime" || !Array.isArray(raw.ids))
|
|
36
|
+
return undefined;
|
|
37
|
+
const projected = projectRuntimeAcknowledgedExtensions(raw.ids);
|
|
38
|
+
if (!projected)
|
|
39
|
+
return undefined;
|
|
40
|
+
const omitted = typeof raw.omitted === "number" && Number.isFinite(raw.omitted)
|
|
41
|
+
? Math.max(0, Math.floor(raw.omitted))
|
|
42
|
+
: 0;
|
|
43
|
+
return { ...projected, omitted: projected.omitted + omitted };
|
|
44
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
export default function registerSandboxProfileGuard(pi: ExtensionAPI): void;
|
|
3
|
+
export type ProjectScopedProfileKind = "sandbox" | "permission";
|
|
4
|
+
/**
|
|
5
|
+
* [fork] Shared project-trust gate for project-scoped sandbox/permission
|
|
6
|
+
* profile selections. Returns the error message to surface when the selection
|
|
7
|
+
* is not permitted under the current project-trust state, or undefined when
|
|
8
|
+
* the launch may proceed. The messages are byte-identical to the original
|
|
9
|
+
* preflight and executor copies that this helper replaces.
|
|
10
|
+
*/
|
|
11
|
+
export declare function projectScopedProfileTrustError(options: {
|
|
12
|
+
kind: ProjectScopedProfileKind;
|
|
13
|
+
agentName: string;
|
|
14
|
+
profileName: string;
|
|
15
|
+
/** True when the selection is project-scoped (agent source or override scope). */
|
|
16
|
+
projectScoped: boolean;
|
|
17
|
+
/** Resolved trusted project cwd, or undefined when the project is not trusted. */
|
|
18
|
+
trustedCwd: string | undefined;
|
|
19
|
+
/** cwd that must match the trusted project cwd, already in comparison form. */
|
|
20
|
+
effectiveCwd: string;
|
|
21
|
+
/** "preflight" compares raw cwds; "executor" resolves the child cwd and says "child cwd". */
|
|
22
|
+
messageStyle: "preflight" | "executor";
|
|
23
|
+
}): string | undefined;
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { SANDBOX_DIAGNOSTICS_PATH_ENV } from "./sandbox-startup-diagnostics.js";
|
|
4
|
+
const SANDBOX_PROFILE_ENV = "PI_SUBAGENT_SANDBOX_PROFILE";
|
|
5
|
+
const SANDBOX_STARTUP_ACK_PATH_ENV = "PI_SUBAGENT_SANDBOX_STARTUP_ACK_PATH";
|
|
6
|
+
const SANDBOX_STARTUP_ACK_TOKEN_ENV = "PI_SUBAGENT_SANDBOX_STARTUP_ACK_TOKEN";
|
|
7
|
+
const MAX_ACK_BYTES = 4096;
|
|
8
|
+
function startupAcknowledgementError(profile, ackPath, token) {
|
|
9
|
+
if (!ackPath || !token) {
|
|
10
|
+
return `Sandbox profile '${profile}' is missing its required startup acknowledgement channel.`;
|
|
11
|
+
}
|
|
12
|
+
try {
|
|
13
|
+
const stat = fs.lstatSync(ackPath);
|
|
14
|
+
if (!stat.isFile() || stat.isSymbolicLink() || stat.size > MAX_ACK_BYTES) {
|
|
15
|
+
return `Sandbox profile '${profile}' did not produce a valid startup acknowledgement.`;
|
|
16
|
+
}
|
|
17
|
+
const parsed = JSON.parse(fs.readFileSync(ackPath, "utf-8"));
|
|
18
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
19
|
+
return `Sandbox profile '${profile}' did not produce a valid startup acknowledgement.`;
|
|
20
|
+
}
|
|
21
|
+
const acknowledgement = parsed;
|
|
22
|
+
if (acknowledgement.version !== 1 || acknowledgement.profile !== profile || acknowledgement.token !== token) {
|
|
23
|
+
return `Sandbox profile '${profile}' did not acknowledge successful startup.`;
|
|
24
|
+
}
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return `Sandbox profile '${profile}' did not acknowledge successful startup.`;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
export default function registerSandboxProfileGuard(pi) {
|
|
32
|
+
// Env values are captured at registration, inside the launch env window; the
|
|
33
|
+
// host restores transient sandbox keys after the session is created.
|
|
34
|
+
const profile = process.env[SANDBOX_PROFILE_ENV];
|
|
35
|
+
if (!profile)
|
|
36
|
+
return;
|
|
37
|
+
const ackPath = process.env[SANDBOX_STARTUP_ACK_PATH_ENV];
|
|
38
|
+
const token = process.env[SANDBOX_STARTUP_ACK_TOKEN_ENV];
|
|
39
|
+
const diagnosticsPath = process.env[SANDBOX_DIAGNOSTICS_PATH_ENV];
|
|
40
|
+
let validated = false;
|
|
41
|
+
// The guard owns the acknowledgement check, so it is also the component that
|
|
42
|
+
// knows the child was refused before its first turn. Publish that reason for
|
|
43
|
+
// the launcher instead of leaving the caller with an empty session.
|
|
44
|
+
const publishDiagnostic = (reason) => {
|
|
45
|
+
if (!diagnosticsPath)
|
|
46
|
+
return;
|
|
47
|
+
try {
|
|
48
|
+
fs.mkdirSync(path.dirname(diagnosticsPath), { recursive: true, mode: 0o700 });
|
|
49
|
+
fs.writeFileSync(diagnosticsPath, JSON.stringify({ version: 1, profile, reason }), { mode: 0o600 });
|
|
50
|
+
}
|
|
51
|
+
catch {
|
|
52
|
+
// The stderr diagnostic below remains the fallback channel.
|
|
53
|
+
}
|
|
54
|
+
};
|
|
55
|
+
const check = () => {
|
|
56
|
+
if (validated)
|
|
57
|
+
return undefined;
|
|
58
|
+
const failure = startupAcknowledgementError(profile, ackPath, token);
|
|
59
|
+
if (!failure)
|
|
60
|
+
validated = true;
|
|
61
|
+
return failure;
|
|
62
|
+
};
|
|
63
|
+
const clearAcknowledgement = () => {
|
|
64
|
+
if (!ackPath || !validated)
|
|
65
|
+
return;
|
|
66
|
+
try {
|
|
67
|
+
fs.rmSync(ackPath, { force: true });
|
|
68
|
+
}
|
|
69
|
+
catch { /* best effort */ }
|
|
70
|
+
};
|
|
71
|
+
pi.on("input", (_event, ctx) => {
|
|
72
|
+
const failure = check();
|
|
73
|
+
if (failure) {
|
|
74
|
+
process.stderr.write(`pi-subagents: ${failure}\n`);
|
|
75
|
+
publishDiagnostic(failure);
|
|
76
|
+
if (ctx.hasUI)
|
|
77
|
+
ctx.ui.notify(failure, "error");
|
|
78
|
+
else
|
|
79
|
+
process.exitCode = 1;
|
|
80
|
+
return { action: "handled" };
|
|
81
|
+
}
|
|
82
|
+
clearAcknowledgement();
|
|
83
|
+
return undefined;
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* [fork] Shared project-trust gate for project-scoped sandbox/permission
|
|
88
|
+
* profile selections. Returns the error message to surface when the selection
|
|
89
|
+
* is not permitted under the current project-trust state, or undefined when
|
|
90
|
+
* the launch may proceed. The messages are byte-identical to the original
|
|
91
|
+
* preflight and executor copies that this helper replaces.
|
|
92
|
+
*/
|
|
93
|
+
export function projectScopedProfileTrustError(options) {
|
|
94
|
+
if (!options.projectScoped)
|
|
95
|
+
return undefined;
|
|
96
|
+
const label = options.kind === "sandbox" ? "sandbox profile" : "permission profile";
|
|
97
|
+
if (options.trustedCwd === undefined) {
|
|
98
|
+
return `Agent '${options.agentName}' selects ${label} '${options.profileName}' from project scope, but the project is not trusted. Trust the project and retry.`;
|
|
99
|
+
}
|
|
100
|
+
if (options.trustedCwd === options.effectiveCwd)
|
|
101
|
+
return undefined;
|
|
102
|
+
if (options.messageStyle === "executor") {
|
|
103
|
+
return `Agent '${options.agentName}' selects ${label} '${options.profileName}' from project scope, but child cwd '${options.effectiveCwd}' does not match the trusted project cwd '${options.trustedCwd}'. Launch from the trusted project cwd and retry.`;
|
|
104
|
+
}
|
|
105
|
+
return `Agent '${options.agentName}' selects ${label} '${options.profileName}' from project scope, but cwd '${options.effectiveCwd}' does not match trusted project cwd '${options.trustedCwd}'. Launch from the trusted project cwd and retry.`;
|
|
106
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A child extension that refuses to start (for example a required sandbox
|
|
3
|
+
* profile that cannot initialize) blocks the first model turn, so the child
|
|
4
|
+
* session ends with no messages and no tool result to inspect. The launcher
|
|
5
|
+
* hands the extension this path through the transient launch environment and
|
|
6
|
+
* reads it back, so the caller sees the real reason instead of an invented
|
|
7
|
+
* empty-output message.
|
|
8
|
+
*/
|
|
9
|
+
export declare const SANDBOX_DIAGNOSTICS_PATH_ENV = "PI_SUBAGENT_SANDBOX_DIAGNOSTICS_PATH";
|
|
10
|
+
export interface SandboxStartupDiagnostic {
|
|
11
|
+
version: 1;
|
|
12
|
+
profile?: string;
|
|
13
|
+
reason: string;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Read the startup diagnostic a blocked child extension wrote. The file is
|
|
17
|
+
* treated as untrusted input: only a bounded, well-formed record is accepted.
|
|
18
|
+
*/
|
|
19
|
+
export declare function readSandboxStartupDiagnostic(diagnosticsPath: string | undefined): SandboxStartupDiagnostic | undefined;
|
|
20
|
+
/** Best-effort removal so a stale diagnostic cannot describe a later attempt. */
|
|
21
|
+
export declare function clearSandboxStartupDiagnostic(diagnosticsPath: string | undefined): void;
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
/**
|
|
3
|
+
* A child extension that refuses to start (for example a required sandbox
|
|
4
|
+
* profile that cannot initialize) blocks the first model turn, so the child
|
|
5
|
+
* session ends with no messages and no tool result to inspect. The launcher
|
|
6
|
+
* hands the extension this path through the transient launch environment and
|
|
7
|
+
* reads it back, so the caller sees the real reason instead of an invented
|
|
8
|
+
* empty-output message.
|
|
9
|
+
*/
|
|
10
|
+
export const SANDBOX_DIAGNOSTICS_PATH_ENV = "PI_SUBAGENT_SANDBOX_DIAGNOSTICS_PATH";
|
|
11
|
+
const MAX_DIAGNOSTIC_BYTES = 8192;
|
|
12
|
+
/**
|
|
13
|
+
* Read the startup diagnostic a blocked child extension wrote. The file is
|
|
14
|
+
* treated as untrusted input: only a bounded, well-formed record is accepted.
|
|
15
|
+
*/
|
|
16
|
+
export function readSandboxStartupDiagnostic(diagnosticsPath) {
|
|
17
|
+
if (!diagnosticsPath)
|
|
18
|
+
return undefined;
|
|
19
|
+
try {
|
|
20
|
+
const stat = fs.lstatSync(diagnosticsPath);
|
|
21
|
+
if (!stat.isFile() || stat.isSymbolicLink() || stat.size > MAX_DIAGNOSTIC_BYTES)
|
|
22
|
+
return undefined;
|
|
23
|
+
const parsed = JSON.parse(fs.readFileSync(diagnosticsPath, "utf-8"));
|
|
24
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
|
|
25
|
+
return undefined;
|
|
26
|
+
const record = parsed;
|
|
27
|
+
if (record.version !== 1)
|
|
28
|
+
return undefined;
|
|
29
|
+
if (typeof record.reason !== "string" || !record.reason.trim())
|
|
30
|
+
return undefined;
|
|
31
|
+
const profile = typeof record.profile === "string" && record.profile.trim() ? record.profile : undefined;
|
|
32
|
+
const diagnostic = { version: 1, reason: record.reason.trim() };
|
|
33
|
+
if (profile !== undefined)
|
|
34
|
+
diagnostic.profile = profile;
|
|
35
|
+
return diagnostic;
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
return undefined;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
/** Best-effort removal so a stale diagnostic cannot describe a later attempt. */
|
|
42
|
+
export function clearSandboxStartupDiagnostic(diagnosticsPath) {
|
|
43
|
+
if (!diagnosticsPath)
|
|
44
|
+
return;
|
|
45
|
+
try {
|
|
46
|
+
fs.rmSync(diagnosticsPath, { force: true });
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
// Best effort: the diagnostics directory lives in the transient temp root.
|
|
50
|
+
}
|
|
51
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
export declare const SESSION_LEASES_DIR: string;
|
|
2
|
+
export interface SessionLeaseRequest {
|
|
3
|
+
sessionFile: string;
|
|
4
|
+
runId: string;
|
|
5
|
+
sourceRunId: string;
|
|
6
|
+
parentSessionId?: string;
|
|
7
|
+
}
|
|
8
|
+
export interface SessionLeaseOwner {
|
|
9
|
+
version: 1;
|
|
10
|
+
token: string;
|
|
11
|
+
canonicalSessionFile: string;
|
|
12
|
+
runId: string;
|
|
13
|
+
sourceRunId: string;
|
|
14
|
+
parentSessionId?: string;
|
|
15
|
+
pid: number;
|
|
16
|
+
hostname: string;
|
|
17
|
+
processStartIdentity?: string;
|
|
18
|
+
writerState: "none" | "spawning" | "running";
|
|
19
|
+
writerPid?: number;
|
|
20
|
+
writerProcessStartIdentity?: string;
|
|
21
|
+
acquiredAt: string;
|
|
22
|
+
acquiredAtMs: number;
|
|
23
|
+
updatedAtMs: number;
|
|
24
|
+
}
|
|
25
|
+
export interface SessionLeaseHandle {
|
|
26
|
+
leaseDir: string;
|
|
27
|
+
owner: SessionLeaseOwner;
|
|
28
|
+
updateWriter(writer: {
|
|
29
|
+
state: "none" | "spawning";
|
|
30
|
+
} | {
|
|
31
|
+
state: "running";
|
|
32
|
+
pid: number;
|
|
33
|
+
}): void;
|
|
34
|
+
release(): boolean;
|
|
35
|
+
}
|
|
36
|
+
export type SessionLeaseState = {
|
|
37
|
+
state: "free";
|
|
38
|
+
canonicalSessionFile: string;
|
|
39
|
+
canonicalSessionId: string;
|
|
40
|
+
} | {
|
|
41
|
+
state: "owned";
|
|
42
|
+
canonicalSessionFile: string;
|
|
43
|
+
canonicalSessionId: string;
|
|
44
|
+
owner: SessionLeaseOwner;
|
|
45
|
+
} | {
|
|
46
|
+
state: "unreadable";
|
|
47
|
+
canonicalSessionFile: string;
|
|
48
|
+
canonicalSessionId: string;
|
|
49
|
+
};
|
|
50
|
+
interface SessionLeaseOptions {
|
|
51
|
+
rootDir?: string;
|
|
52
|
+
now?: () => number;
|
|
53
|
+
token?: () => string;
|
|
54
|
+
pid?: number;
|
|
55
|
+
hostname?: string;
|
|
56
|
+
processStartIdentity?: string;
|
|
57
|
+
isProcessAlive?: (pid: number) => boolean | undefined;
|
|
58
|
+
getProcessStartIdentity?: (pid: number) => string | undefined;
|
|
59
|
+
}
|
|
60
|
+
export declare class SessionLeaseConflictError extends Error {
|
|
61
|
+
readonly owner?: SessionLeaseOwner;
|
|
62
|
+
constructor(message: string, owner?: SessionLeaseOwner);
|
|
63
|
+
}
|
|
64
|
+
export declare function canonicalSessionFilePath(sessionFile: string): string;
|
|
65
|
+
export declare function canonicalSessionId(sessionFile: string): string;
|
|
66
|
+
export declare function sessionLeaseDir(sessionFile: string, rootDir?: string): string;
|
|
67
|
+
export declare function inspectSessionLease(sessionFile: string, rootDir?: string): SessionLeaseState;
|
|
68
|
+
export declare function acquireSessionLease(request: SessionLeaseRequest, options?: SessionLeaseOptions): SessionLeaseHandle;
|
|
69
|
+
export {};
|
|
@@ -0,0 +1,250 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as os from "node:os";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { createAtomicJsonWriter } from "../../shared/atomic-json.js";
|
|
6
|
+
import { TEMP_ROOT_DIR } from "../../shared/types.js";
|
|
7
|
+
export const SESSION_LEASES_DIR = path.join(TEMP_ROOT_DIR, "session-leases");
|
|
8
|
+
export class SessionLeaseConflictError extends Error {
|
|
9
|
+
owner;
|
|
10
|
+
constructor(message, owner) {
|
|
11
|
+
super(message);
|
|
12
|
+
this.name = "SessionLeaseConflictError";
|
|
13
|
+
this.owner = owner;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
function getProcessStartIdentity(pid) {
|
|
17
|
+
if (process.platform === "linux") {
|
|
18
|
+
try {
|
|
19
|
+
const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf-8");
|
|
20
|
+
const commandEnd = stat.lastIndexOf(")");
|
|
21
|
+
if (commandEnd === -1)
|
|
22
|
+
return undefined;
|
|
23
|
+
const fields = stat.slice(commandEnd + 1).trim().split(/\s+/);
|
|
24
|
+
const startTicks = fields[19];
|
|
25
|
+
return startTicks ? `linux:${startTicks}` : undefined;
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
function processIsAlive(pid) {
|
|
34
|
+
try {
|
|
35
|
+
process.kill(pid, 0);
|
|
36
|
+
return true;
|
|
37
|
+
}
|
|
38
|
+
catch (error) {
|
|
39
|
+
const code = error.code;
|
|
40
|
+
if (code === "ESRCH")
|
|
41
|
+
return false;
|
|
42
|
+
if (code === "EPERM")
|
|
43
|
+
return true;
|
|
44
|
+
return undefined;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
export function canonicalSessionFilePath(sessionFile) {
|
|
48
|
+
return fs.realpathSync.native(path.resolve(sessionFile));
|
|
49
|
+
}
|
|
50
|
+
export function canonicalSessionId(sessionFile) {
|
|
51
|
+
const canonical = canonicalSessionFilePath(sessionFile);
|
|
52
|
+
const key = process.platform === "win32" ? canonical.toLowerCase() : canonical;
|
|
53
|
+
return createHash("sha256").update(key).digest("hex");
|
|
54
|
+
}
|
|
55
|
+
export function sessionLeaseDir(sessionFile, rootDir = SESSION_LEASES_DIR) {
|
|
56
|
+
return path.join(rootDir, canonicalSessionId(sessionFile));
|
|
57
|
+
}
|
|
58
|
+
export function inspectSessionLease(sessionFile, rootDir = SESSION_LEASES_DIR) {
|
|
59
|
+
const canonicalSessionFile = canonicalSessionFilePath(sessionFile);
|
|
60
|
+
const canonicalSessionIdValue = canonicalSessionId(canonicalSessionFile);
|
|
61
|
+
const leaseDir = path.join(rootDir, canonicalSessionIdValue);
|
|
62
|
+
if (!fs.existsSync(leaseDir))
|
|
63
|
+
return { state: "free", canonicalSessionFile, canonicalSessionId: canonicalSessionIdValue };
|
|
64
|
+
const owner = readLeaseOwner(leaseDir);
|
|
65
|
+
return owner
|
|
66
|
+
? { state: "owned", canonicalSessionFile, canonicalSessionId: canonicalSessionIdValue, owner }
|
|
67
|
+
: { state: "unreadable", canonicalSessionFile, canonicalSessionId: canonicalSessionIdValue };
|
|
68
|
+
}
|
|
69
|
+
function parseOwner(value) {
|
|
70
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
71
|
+
return undefined;
|
|
72
|
+
const owner = value;
|
|
73
|
+
if (owner.version !== 1
|
|
74
|
+
|| typeof owner.token !== "string"
|
|
75
|
+
|| typeof owner.canonicalSessionFile !== "string"
|
|
76
|
+
|| typeof owner.runId !== "string"
|
|
77
|
+
|| typeof owner.sourceRunId !== "string"
|
|
78
|
+
|| typeof owner.pid !== "number"
|
|
79
|
+
|| !Number.isInteger(owner.pid)
|
|
80
|
+
|| owner.pid <= 0
|
|
81
|
+
|| typeof owner.hostname !== "string"
|
|
82
|
+
|| (owner.writerState !== "none" && owner.writerState !== "spawning" && owner.writerState !== "running")
|
|
83
|
+
|| typeof owner.acquiredAt !== "string"
|
|
84
|
+
|| typeof owner.acquiredAtMs !== "number"
|
|
85
|
+
|| typeof owner.updatedAtMs !== "number")
|
|
86
|
+
return undefined;
|
|
87
|
+
if (owner.parentSessionId !== undefined && typeof owner.parentSessionId !== "string")
|
|
88
|
+
return undefined;
|
|
89
|
+
if (owner.processStartIdentity !== undefined && typeof owner.processStartIdentity !== "string")
|
|
90
|
+
return undefined;
|
|
91
|
+
if (owner.writerPid !== undefined && (typeof owner.writerPid !== "number" || !Number.isInteger(owner.writerPid) || owner.writerPid <= 0))
|
|
92
|
+
return undefined;
|
|
93
|
+
if (owner.writerProcessStartIdentity !== undefined && typeof owner.writerProcessStartIdentity !== "string")
|
|
94
|
+
return undefined;
|
|
95
|
+
if (owner.writerState === "running" && owner.writerPid === undefined)
|
|
96
|
+
return undefined;
|
|
97
|
+
if (owner.writerState !== "running" && (owner.writerPid !== undefined || owner.writerProcessStartIdentity !== undefined))
|
|
98
|
+
return undefined;
|
|
99
|
+
return owner;
|
|
100
|
+
}
|
|
101
|
+
function readLeaseOwner(leaseDir) {
|
|
102
|
+
try {
|
|
103
|
+
return parseOwner(JSON.parse(fs.readFileSync(path.join(leaseDir, "owner.json"), "utf-8")));
|
|
104
|
+
}
|
|
105
|
+
catch {
|
|
106
|
+
return undefined;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
function conflictMessage(canonicalSessionFile, owner) {
|
|
110
|
+
if (!owner) {
|
|
111
|
+
return `Direct revival of session '${canonicalSessionFile}' is blocked by an existing lease with unreadable owner metadata. Refusing to reclaim it without proof that the owner is stale.`;
|
|
112
|
+
}
|
|
113
|
+
const parent = owner.parentSessionId ? `, parent session '${owner.parentSessionId}'` : "";
|
|
114
|
+
return `Direct revival of session '${canonicalSessionFile}' is already owned by run '${owner.runId}' (source run '${owner.sourceRunId}'${parent}, pid ${owner.pid} on ${owner.hostname}). Wait for that revival to finish or start a separate continuation without reusing this session file.`;
|
|
115
|
+
}
|
|
116
|
+
function processDemonstrablyGone(pid, startIdentity, options) {
|
|
117
|
+
const alive = options.isProcessAlive(pid);
|
|
118
|
+
if (alive === false)
|
|
119
|
+
return true;
|
|
120
|
+
if (alive !== true || !startIdentity)
|
|
121
|
+
return false;
|
|
122
|
+
const currentIdentity = options.getProcessStartIdentity(pid);
|
|
123
|
+
return currentIdentity !== undefined && currentIdentity !== startIdentity;
|
|
124
|
+
}
|
|
125
|
+
function demonstrablyStale(owner, options) {
|
|
126
|
+
if (owner.hostname !== options.hostname)
|
|
127
|
+
return false;
|
|
128
|
+
if (!processDemonstrablyGone(owner.pid, owner.processStartIdentity, options))
|
|
129
|
+
return false;
|
|
130
|
+
if (owner.writerState === "spawning")
|
|
131
|
+
return false;
|
|
132
|
+
if (owner.writerState === "none")
|
|
133
|
+
return true;
|
|
134
|
+
return owner.writerPid !== undefined
|
|
135
|
+
&& processDemonstrablyGone(owner.writerPid, owner.writerProcessStartIdentity, options);
|
|
136
|
+
}
|
|
137
|
+
function createLeaseDirectory(leaseDir, owner) {
|
|
138
|
+
const tempDir = `${leaseDir}.candidate-${owner.token}`;
|
|
139
|
+
fs.mkdirSync(path.dirname(leaseDir), { recursive: true, mode: 0o700 });
|
|
140
|
+
fs.rmSync(tempDir, { recursive: true, force: true });
|
|
141
|
+
fs.mkdirSync(tempDir, { mode: 0o700 });
|
|
142
|
+
try {
|
|
143
|
+
fs.writeFileSync(path.join(tempDir, "owner.json"), JSON.stringify(owner, null, 2), { encoding: "utf-8", mode: 0o600 });
|
|
144
|
+
try {
|
|
145
|
+
fs.renameSync(tempDir, leaseDir);
|
|
146
|
+
return true;
|
|
147
|
+
}
|
|
148
|
+
catch (error) {
|
|
149
|
+
if (fs.existsSync(leaseDir))
|
|
150
|
+
return false;
|
|
151
|
+
throw error;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
finally {
|
|
155
|
+
fs.rmSync(tempDir, { recursive: true, force: true });
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
export function acquireSessionLease(request, options = {}) {
|
|
159
|
+
const canonicalSessionFile = canonicalSessionFilePath(request.sessionFile);
|
|
160
|
+
const rootDir = options.rootDir ?? SESSION_LEASES_DIR;
|
|
161
|
+
const leaseDir = sessionLeaseDir(canonicalSessionFile, rootDir);
|
|
162
|
+
const now = options.now ?? Date.now;
|
|
163
|
+
const pid = options.pid ?? process.pid;
|
|
164
|
+
const hostname = options.hostname ?? os.hostname();
|
|
165
|
+
const getIdentity = options.getProcessStartIdentity ?? getProcessStartIdentity;
|
|
166
|
+
const processStartIdentity = options.processStartIdentity
|
|
167
|
+
?? getIdentity(pid)
|
|
168
|
+
?? (pid === process.pid ? `runtime:${Math.round(Date.now() - process.uptime() * 1000)}` : undefined);
|
|
169
|
+
const acquiredAtMs = now();
|
|
170
|
+
const owner = {
|
|
171
|
+
version: 1,
|
|
172
|
+
token: options.token?.() ?? randomUUID(),
|
|
173
|
+
canonicalSessionFile,
|
|
174
|
+
runId: request.runId,
|
|
175
|
+
sourceRunId: request.sourceRunId,
|
|
176
|
+
...(request.parentSessionId ? { parentSessionId: request.parentSessionId } : {}),
|
|
177
|
+
pid,
|
|
178
|
+
hostname,
|
|
179
|
+
...(processStartIdentity ? { processStartIdentity } : {}),
|
|
180
|
+
writerState: "none",
|
|
181
|
+
acquiredAt: new Date(acquiredAtMs).toISOString(),
|
|
182
|
+
acquiredAtMs,
|
|
183
|
+
updatedAtMs: acquiredAtMs,
|
|
184
|
+
};
|
|
185
|
+
const staleOptions = {
|
|
186
|
+
hostname,
|
|
187
|
+
isProcessAlive: options.isProcessAlive ?? processIsAlive,
|
|
188
|
+
getProcessStartIdentity: getIdentity,
|
|
189
|
+
};
|
|
190
|
+
for (let attempt = 0; attempt < 4; attempt++) {
|
|
191
|
+
if (createLeaseDirectory(leaseDir, owner)) {
|
|
192
|
+
const writeOwner = createAtomicJsonWriter();
|
|
193
|
+
return {
|
|
194
|
+
leaseDir,
|
|
195
|
+
owner,
|
|
196
|
+
updateWriter(writer) {
|
|
197
|
+
const currentOwner = readLeaseOwner(leaseDir);
|
|
198
|
+
if (!currentOwner || currentOwner.token !== owner.token) {
|
|
199
|
+
throw new Error(`Session revival lease ownership changed for run '${owner.runId}'.`);
|
|
200
|
+
}
|
|
201
|
+
const writerProcessStartIdentity = writer.state === "running" ? getIdentity(writer.pid) : undefined;
|
|
202
|
+
const nextOwner = {
|
|
203
|
+
...owner,
|
|
204
|
+
writerState: writer.state,
|
|
205
|
+
...(writer.state === "running" ? { writerPid: writer.pid } : {}),
|
|
206
|
+
...(writerProcessStartIdentity ? { writerProcessStartIdentity } : {}),
|
|
207
|
+
updatedAtMs: now(),
|
|
208
|
+
};
|
|
209
|
+
delete nextOwner.writerPid;
|
|
210
|
+
delete nextOwner.writerProcessStartIdentity;
|
|
211
|
+
if (writer.state === "running") {
|
|
212
|
+
nextOwner.writerPid = writer.pid;
|
|
213
|
+
if (writerProcessStartIdentity)
|
|
214
|
+
nextOwner.writerProcessStartIdentity = writerProcessStartIdentity;
|
|
215
|
+
}
|
|
216
|
+
writeOwner(path.join(leaseDir, "owner.json"), nextOwner);
|
|
217
|
+
delete owner.writerPid;
|
|
218
|
+
delete owner.writerProcessStartIdentity;
|
|
219
|
+
Object.assign(owner, nextOwner);
|
|
220
|
+
},
|
|
221
|
+
release() {
|
|
222
|
+
const currentOwner = readLeaseOwner(leaseDir);
|
|
223
|
+
if (!currentOwner || currentOwner.token !== owner.token)
|
|
224
|
+
return false;
|
|
225
|
+
fs.rmSync(leaseDir, { recursive: true, force: true });
|
|
226
|
+
return !fs.existsSync(leaseDir);
|
|
227
|
+
},
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
const existingOwner = readLeaseOwner(leaseDir);
|
|
231
|
+
if (!existingOwner || !demonstrablyStale(existingOwner, staleOptions)) {
|
|
232
|
+
throw new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);
|
|
233
|
+
}
|
|
234
|
+
// The per-owner tombstone is retained. Every contender that observed this
|
|
235
|
+
// stale token targets the same occupied destination, so only the first can
|
|
236
|
+
// rename it and later contenders cannot move a successor lease by mistake.
|
|
237
|
+
const tombstone = `${leaseDir}.stale-${existingOwner.token.replace(/[^A-Za-z0-9._-]/g, "-")}`;
|
|
238
|
+
try {
|
|
239
|
+
fs.renameSync(leaseDir, tombstone);
|
|
240
|
+
}
|
|
241
|
+
catch (error) {
|
|
242
|
+
const code = error.code;
|
|
243
|
+
if (code === "ENOENT" || fs.existsSync(tombstone))
|
|
244
|
+
continue;
|
|
245
|
+
throw error;
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
const existingOwner = readLeaseOwner(leaseDir);
|
|
249
|
+
throw new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);
|
|
250
|
+
}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import type { Message } from "@earendil-works/pi-ai";
|
|
2
|
+
import type { OutputMode, SavedOutputReference } from "../../shared/types.ts";
|
|
3
|
+
export interface SingleOutputSnapshot {
|
|
4
|
+
exists: boolean;
|
|
5
|
+
mtimeMs?: number;
|
|
6
|
+
size?: number;
|
|
7
|
+
error?: string;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Content the child itself sent to the configured output path, taken from its
|
|
11
|
+
* last `write` tool call whose tool result reports success. Unlike reading the
|
|
12
|
+
* path from disk, this cannot be polluted by a sibling run writing the same
|
|
13
|
+
* path (#420); requiring the successful tool result keeps failed, cancelled,
|
|
14
|
+
* or unanswered write calls from counting as authored output. Returns
|
|
15
|
+
* undefined when no such write exists (e.g. bash or edit-based construction),
|
|
16
|
+
* in which case callers must not assume file authorship.
|
|
17
|
+
*/
|
|
18
|
+
export declare function extractChildWrittenOutput(messages: Message[] | undefined, outputPath: string | undefined, cwd?: string): string | undefined;
|
|
19
|
+
export declare function normalizeSingleOutputOverride(output: string | boolean | undefined, defaultOutput: string | undefined): string | false | undefined;
|
|
20
|
+
export declare function resolveSingleOutputPath(output: string | boolean | undefined, runtimeCwd: string, requestedCwd?: string, relativeBaseDir?: string): string | undefined;
|
|
21
|
+
interface OutputInstructionCapabilities {
|
|
22
|
+
tools?: string[];
|
|
23
|
+
mcpDirectTools?: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare function requestedOutputPathFromTask(task: string): string | undefined;
|
|
26
|
+
export declare function outputPathMappingFromTask(task: string, savedPath: string | undefined): {
|
|
27
|
+
requestedPath: string;
|
|
28
|
+
savedPath: string;
|
|
29
|
+
} | undefined;
|
|
30
|
+
export declare function injectSingleOutputInstruction(task: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string;
|
|
31
|
+
export declare function formatSavedOutputReference(savedPath: string, fullOutput: string): SavedOutputReference;
|
|
32
|
+
/**
|
|
33
|
+
* Keeps at most INLINE_OUTPUT_HEAD_CHARS of a child's output inline and points to the file holding all of it.
|
|
34
|
+
* Files come only from run records, never from the child's text: a trailing `Output saved to:` line is kept as the
|
|
35
|
+
* pointer only when it names the run's recorded saved-output path, and that recorded path is what gets read.
|
|
36
|
+
* Trailing blocks the file does not hold, such as a timed-out child's recovery summary, stay inline after the pointer.
|
|
37
|
+
* Output stays whole when it is short or no readable file contains it, so no text is lost.
|
|
38
|
+
*/
|
|
39
|
+
export declare function capInlineOutput(output: string, files: {
|
|
40
|
+
artifactPath?: string;
|
|
41
|
+
savedPath?: string;
|
|
42
|
+
}): string;
|
|
43
|
+
/** Applies capInlineOutput to each `agent:\noutput` section of a run summary whose child output is long. */
|
|
44
|
+
export declare function capSummaryOutputs(summary: string, results: ReadonlyArray<{
|
|
45
|
+
agent?: unknown;
|
|
46
|
+
output?: unknown;
|
|
47
|
+
artifactPaths?: {
|
|
48
|
+
outputPath?: unknown;
|
|
49
|
+
};
|
|
50
|
+
artifactOutputSaveFailed?: unknown;
|
|
51
|
+
savedOutputPath?: unknown;
|
|
52
|
+
}> | undefined): string;
|
|
53
|
+
export declare function validateFileOnlyOutputMode(outputMode: OutputMode | undefined, outputPath: string | undefined, context: string): string | undefined;
|
|
54
|
+
export declare function resolveSingleOutputClaimPath(outputPath: string): string;
|
|
55
|
+
export declare function captureSingleOutputSnapshot(outputPath: string | undefined): SingleOutputSnapshot | undefined;
|
|
56
|
+
export declare function hasSingleOutputChangedSinceSnapshot(outputPath: string | undefined, beforeRun: SingleOutputSnapshot | undefined): boolean | undefined;
|
|
57
|
+
export declare function resolveSingleOutput(outputPath: string | undefined, fallbackOutput: string, beforeRun: SingleOutputSnapshot | undefined, expectedClaimPath?: string): {
|
|
58
|
+
fullOutput: string;
|
|
59
|
+
savedPath?: string;
|
|
60
|
+
saveError?: string;
|
|
61
|
+
fatalError?: boolean;
|
|
62
|
+
};
|
|
63
|
+
export declare function finalizeSingleOutput(params: {
|
|
64
|
+
fullOutput: string;
|
|
65
|
+
truncatedOutput?: string;
|
|
66
|
+
outputPath?: string;
|
|
67
|
+
outputMode?: OutputMode;
|
|
68
|
+
exitCode: number;
|
|
69
|
+
/** Keep the saved-output reference when a post-run acceptance gate rejects an otherwise completed child. */
|
|
70
|
+
preserveSavedOutput?: boolean;
|
|
71
|
+
savedPath?: string;
|
|
72
|
+
outputReference?: SavedOutputReference;
|
|
73
|
+
saveError?: string;
|
|
74
|
+
}): {
|
|
75
|
+
displayOutput: string;
|
|
76
|
+
savedPath?: string;
|
|
77
|
+
outputReference?: SavedOutputReference;
|
|
78
|
+
saveError?: string;
|
|
79
|
+
};
|
|
80
|
+
/**
|
|
81
|
+
* Determines whether an output resolution error represents an unrecoverable settlement failure.
|
|
82
|
+
* Returns true for fatal claim-path mismatches in any mode, or when required file-only output
|
|
83
|
+
* fails to persist without a savedPath. Inline and optional outputs remain nonfatal warnings.
|
|
84
|
+
*/
|
|
85
|
+
export declare function isSettlementFatalOutputError(resolvedOutput: {
|
|
86
|
+
savedPath?: string;
|
|
87
|
+
saveError?: string;
|
|
88
|
+
fatalError?: boolean;
|
|
89
|
+
}, outputMode?: OutputMode): boolean;
|
|
90
|
+
export {};
|