@xzzpig/pi-subagents 0.22.0 → 0.24.1
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 +355 -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-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-6BJUEES3.js +276 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -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-EUPJB4S7.js +5503 -0
- package/bundle/chunk-FG6SQJAR.js +940 -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-JEA2ZKUA.js +1372 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LMGQAJ3O.js +9872 -0
- package/bundle/chunk-LVWU2HOO.js +1234 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RU522D5W.js +1768 -0
- package/bundle/chunk-SLNMBXLL.js +7336 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-TGLFTQWJ.js +143 -0
- package/bundle/chunk-TMHVDPYW.js +4132 -0
- package/bundle/chunk-U4ODUYAG.js +235 -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-X6LOM3Z4.js +4175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-Y6H2G6KX.js +1310 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/chunk-ZWXU5SPQ.js +16932 -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/goal-auto-continuation-gate.md +26 -0
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -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 +1300 -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/goal-auto-continue-gate.d.ts +17 -0
- package/src/goal-auto-continue-gate.js +61 -0
- package/src/goal-auto-continue-state.d.ts +22 -0
- package/src/goal-auto-continue-state.js +20 -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 +306 -0
- package/src/runs/background/async-execution.js +2210 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +926 -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 +179 -0
- package/src/runs/background/async-status.js +712 -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 +216 -0
- package/src/runs/background/notify.js +1006 -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 +7990 -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 +2842 -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,42 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import packageJson from "../../package.json" with { type: "json" };
|
|
5
|
+
import { writeAtomicJson } from "../shared/atomic-json.js";
|
|
6
|
+
import { getAgentDir } from "../shared/utils.js";
|
|
7
|
+
// major.minor.patch as one comparable number; undefined for anything else.
|
|
8
|
+
const versionNumber = (version) => typeof version === "string" && /^\d+\.\d+\.\d+$/.test(version)
|
|
9
|
+
? version.split(".").reduce((total, part) => total * 1e6 + Number(part), 0)
|
|
10
|
+
: undefined;
|
|
11
|
+
export async function showUpgradeNotice(ctx, stateDir = path.join(getAgentDir(), "pi-subagents"), changelogPath = fileURLToPath(new URL("../../CHANGELOG.md", import.meta.url)), version = packageJson.version) {
|
|
12
|
+
if (!ctx.hasUI)
|
|
13
|
+
return;
|
|
14
|
+
const statePath = path.join(stateDir, "last-seen-version.json");
|
|
15
|
+
const lastSeen = await fs.promises.readFile(statePath, "utf-8").then((raw) => JSON.parse(raw).version).catch(() => undefined);
|
|
16
|
+
const previous = versionNumber(lastSeen);
|
|
17
|
+
const current = versionNumber(version);
|
|
18
|
+
if (current === undefined || previous === current)
|
|
19
|
+
return;
|
|
20
|
+
try {
|
|
21
|
+
writeAtomicJson(statePath, { version });
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
// Read-only installs cannot record the seen version. Without it the notice would repeat on every start, so skip it.
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
if (previous === undefined || previous > current)
|
|
28
|
+
return;
|
|
29
|
+
const bullets = (await fs.promises.readFile(changelogPath, "utf-8")).split(/^## /m).flatMap((section) => {
|
|
30
|
+
const released = versionNumber(/^\[([^\]]+)\]/.exec(section)?.[1]);
|
|
31
|
+
if (released === undefined || released <= previous || released > current)
|
|
32
|
+
return [];
|
|
33
|
+
const highlights = section.split(/^### /m).find((part) => part.startsWith("Highlights")) ?? "";
|
|
34
|
+
return (highlights.match(/^- .*/gm) ?? []).map((bullet) => bullet.replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").trim());
|
|
35
|
+
});
|
|
36
|
+
ctx.ui.notify([
|
|
37
|
+
`pi-subagents updated from ${lastSeen} to ${version}`,
|
|
38
|
+
...bullets.slice(0, 5),
|
|
39
|
+
...(bullets.length > 5 ? [`...and ${bullets.length - 5} more`] : []),
|
|
40
|
+
"Changelog: https://github.com/nicobailon/pi-subagents/blob/main/CHANGELOG.md",
|
|
41
|
+
].join("\n"), "info");
|
|
42
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { ResultDeliveryOwnership } from "./runs/background/result-delivery-ownership.ts";
|
|
3
|
+
import type { ParentWake } from "./shared/parent-wake.ts";
|
|
4
|
+
import { type CompletionNotifier } from "./runs/background/notify.ts";
|
|
5
|
+
import type { SubagentState } from "./shared/types.ts";
|
|
6
|
+
export declare const GOAL_AUTO_CONTINUE_GATE_EVENT = "pi-goal:before-auto-continue:v1";
|
|
7
|
+
export declare const GOAL_AUTO_CONTINUE_GATE_VERSION: 1;
|
|
8
|
+
export interface GoalAutoContinueGateDependencies {
|
|
9
|
+
state: SubagentState;
|
|
10
|
+
ownership: Pick<ResultDeliveryOwnership, "owns">;
|
|
11
|
+
notifier: Pick<CompletionNotifier, "hasPendingWake">;
|
|
12
|
+
parentWake: Pick<ParentWake, "isPending">;
|
|
13
|
+
isHeld(): boolean;
|
|
14
|
+
owedResultRunIds: ReadonlySet<string>;
|
|
15
|
+
}
|
|
16
|
+
/** Install one synchronous listener for the current parent runtime; dispose it on session replacement/reload. */
|
|
17
|
+
export declare function registerGoalAutoContinueGate(pi: Pick<ExtensionAPI, "events">, dependencies: GoalAutoContinueGateDependencies): () => void;
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { ownsRun } from "./runs/shared/run-ownership.js";
|
|
2
|
+
import { scheduledCompletionTriggersTurn } from "./runs/background/notify.js";
|
|
3
|
+
import { hasGoalAutoContinueWakeWork } from "./goal-auto-continue-state.js";
|
|
4
|
+
export const GOAL_AUTO_CONTINUE_GATE_EVENT = "pi-goal:before-auto-continue:v1";
|
|
5
|
+
export const GOAL_AUTO_CONTINUE_GATE_VERSION = 1;
|
|
6
|
+
function gateRequest(value) {
|
|
7
|
+
if (!value || typeof value !== "object")
|
|
8
|
+
return undefined;
|
|
9
|
+
const candidate = value;
|
|
10
|
+
if (typeof candidate.defer !== "function")
|
|
11
|
+
return undefined;
|
|
12
|
+
return candidate;
|
|
13
|
+
}
|
|
14
|
+
/** Install one synchronous listener for the current parent runtime; dispose it on session replacement/reload. */
|
|
15
|
+
export function registerGoalAutoContinueGate(pi, dependencies) {
|
|
16
|
+
return pi.events.on(GOAL_AUTO_CONTINUE_GATE_EVENT, (value) => {
|
|
17
|
+
const request = gateRequest(value);
|
|
18
|
+
if (!request)
|
|
19
|
+
return;
|
|
20
|
+
try {
|
|
21
|
+
if (request.version !== GOAL_AUTO_CONTINUE_GATE_VERSION || typeof request.sessionId !== "string" || typeof request.goalId !== "string") {
|
|
22
|
+
request.defer({ owner: "pi-subagents", reason: "gate-protocol-invalid" });
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
const { state } = dependencies;
|
|
26
|
+
if (state.supervisorOwnerSessionId !== request.sessionId)
|
|
27
|
+
return;
|
|
28
|
+
const blocked = hasGoalAutoContinueWakeWork(state, request.sessionId, {
|
|
29
|
+
ownsAsyncRun: (job) => typeof job.sessionId === "string" && dependencies.ownership.owns(job.sessionId, job.completionOwnerId),
|
|
30
|
+
ownsForegroundRun: (control) => typeof control.sessionId === "string" && ownsRun(state.currentSessionId, control.sessionId),
|
|
31
|
+
hasOwedResultHandoff: () => {
|
|
32
|
+
if (dependencies.isHeld())
|
|
33
|
+
return false;
|
|
34
|
+
for (const runId of dependencies.owedResultRunIds) {
|
|
35
|
+
const job = state.asyncJobs.get(runId);
|
|
36
|
+
if (!job)
|
|
37
|
+
return true;
|
|
38
|
+
const outcome = job.status === "complete" ? "completed" : job.status;
|
|
39
|
+
if (scheduledCompletionTriggersTurn(job.scheduleOrigin, outcome))
|
|
40
|
+
return true;
|
|
41
|
+
}
|
|
42
|
+
return false;
|
|
43
|
+
},
|
|
44
|
+
hasPendingNativeWake: () => !dependencies.isHeld()
|
|
45
|
+
&& (dependencies.notifier.hasPendingWake() || dependencies.parentWake.isPending()),
|
|
46
|
+
});
|
|
47
|
+
if (blocked)
|
|
48
|
+
request.defer({ owner: "pi-subagents", reason: "parent-wake-pending" });
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
// The host event bus swallows listener errors. Fail this send closed using only bounded local diagnostics.
|
|
52
|
+
try {
|
|
53
|
+
request.defer({ owner: "pi-subagents", reason: "state-unavailable" });
|
|
54
|
+
}
|
|
55
|
+
catch {
|
|
56
|
+
// A malformed or already-closed gate request cannot be recovered by this listener.
|
|
57
|
+
}
|
|
58
|
+
console.error("[pi-subagents] Goal auto-continuation state unavailable; deferring this send attempt.");
|
|
59
|
+
}
|
|
60
|
+
});
|
|
61
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { AsyncJobState, ForegroundRunControl } from "./shared/types.ts";
|
|
2
|
+
export interface GoalAutoContinueStateView {
|
|
3
|
+
supervisorOwnerSessionId?: string | null;
|
|
4
|
+
asyncJobs: ReadonlyMap<string, AsyncJobState>;
|
|
5
|
+
foregroundControls: ReadonlyMap<string, ForegroundRunControl>;
|
|
6
|
+
}
|
|
7
|
+
export interface GoalAutoContinueStateQueries {
|
|
8
|
+
/** Reuses pi-subagents' authoritative completion-owner/session-succession decision. */
|
|
9
|
+
ownsAsyncRun(job: AsyncJobState): boolean;
|
|
10
|
+
/** Reuses the same owning-session decision for live detached foreground controls. */
|
|
11
|
+
ownsForegroundRun(control: ForegroundRunControl): boolean;
|
|
12
|
+
/** Existing result watcher/notifier state; this is not a new completion counter. */
|
|
13
|
+
hasOwedResultHandoff(): boolean;
|
|
14
|
+
/** True only for notifier work with a native parent-turn wake still pending. */
|
|
15
|
+
hasPendingNativeWake(): boolean;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Read-only projection used by pi-goal-x's synchronous final-send gate.
|
|
19
|
+
* It deliberately inspects only existing in-memory ownership and lifecycle state;
|
|
20
|
+
* it performs no filesystem, event-log, transcript, or tool-result lookup.
|
|
21
|
+
*/
|
|
22
|
+
export declare function hasGoalAutoContinueWakeWork(state: GoalAutoContinueStateView, requestSessionId: string, queries: GoalAutoContinueStateQueries): boolean;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Read-only projection used by pi-goal-x's synchronous final-send gate.
|
|
3
|
+
* It deliberately inspects only existing in-memory ownership and lifecycle state;
|
|
4
|
+
* it performs no filesystem, event-log, transcript, or tool-result lookup.
|
|
5
|
+
*/
|
|
6
|
+
export function hasGoalAutoContinueWakeWork(state, requestSessionId, queries) {
|
|
7
|
+
if (!requestSessionId || state.supervisorOwnerSessionId !== requestSessionId)
|
|
8
|
+
return false;
|
|
9
|
+
for (const job of state.asyncJobs.values()) {
|
|
10
|
+
if ((job.status === "queued" || job.status === "running")
|
|
11
|
+
&& job.scheduleOrigin?.quiet !== true
|
|
12
|
+
&& queries.ownsAsyncRun(job))
|
|
13
|
+
return true;
|
|
14
|
+
}
|
|
15
|
+
for (const control of state.foregroundControls.values()) {
|
|
16
|
+
if (queries.ownsForegroundRun(control))
|
|
17
|
+
return true;
|
|
18
|
+
}
|
|
19
|
+
return queries.hasOwedResultHandoff() || queries.hasPendingNativeWake();
|
|
20
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { AgentToolResult } from "@earendil-works/pi-agent-core";
|
|
2
|
+
import type { MissionStoreConfig } from "../missions/types.ts";
|
|
3
|
+
import { type AuthorityPolicyConfig } from "../policy/authority.ts";
|
|
4
|
+
import { type Details, type SubagentState } from "../shared/types.ts";
|
|
5
|
+
import type { InspectorAction, InspectorParams, InspectorPlugin } from "./types.ts";
|
|
6
|
+
export { INSPECTOR_ACTIONS } from "./types.ts";
|
|
7
|
+
export type { InspectorAction, InspectorParams, InspectorPlugin } from "./types.ts";
|
|
8
|
+
export interface InspectorDispatcherDeps {
|
|
9
|
+
state?: SubagentState;
|
|
10
|
+
asyncDirRoot?: string;
|
|
11
|
+
resultsDir?: string;
|
|
12
|
+
missions?: MissionStoreConfig;
|
|
13
|
+
authorityPolicy?: AuthorityPolicyConfig;
|
|
14
|
+
sessionRoots?: string[];
|
|
15
|
+
cwd: string;
|
|
16
|
+
signal?: AbortSignal;
|
|
17
|
+
now?: () => Date;
|
|
18
|
+
runnerPath?: string;
|
|
19
|
+
env?: NodeJS.ProcessEnv;
|
|
20
|
+
plugins?: readonly InspectorPlugin[];
|
|
21
|
+
/** How long open and close wait for another open or close of the same target. */
|
|
22
|
+
leaseWaitMs?: number;
|
|
23
|
+
}
|
|
24
|
+
export declare function handleInspectorAction(action: InspectorAction, params: InspectorParams, deps: InspectorDispatcherDeps): Promise<AgentToolResult<Details>>;
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import { readMissionBinding } from "../missions/lifecycle.js";
|
|
5
|
+
import { listMissions, missionRecordPath, resolveMissionStoreLocation } from "../missions/store.js";
|
|
6
|
+
import { resolveAuthorityDecision } from "../policy/authority.js";
|
|
7
|
+
import { DIRS } from "../shared/types.js";
|
|
8
|
+
import { tryLease } from "../shared/file-lease.js";
|
|
9
|
+
import { readStatus } from "../shared/utils.js";
|
|
10
|
+
import { resolveSubagentRunId } from "../runs/background/run-id-resolver.js";
|
|
11
|
+
import { resolveNodeExecutable } from "../shared/node-executable.js";
|
|
12
|
+
import { encodeSessionRoots } from "./session-roots-codec.js";
|
|
13
|
+
import { formatShellCommand } from "./shell-command.js";
|
|
14
|
+
export { INSPECTOR_ACTIONS } from "./types.js";
|
|
15
|
+
// Covers a provider's slowest normal open (a 15 s split or launch plus its follow-up commands).
|
|
16
|
+
const INSPECTOR_LEASE_WAIT_MS = 30_000;
|
|
17
|
+
function result(text, isError = false) {
|
|
18
|
+
const response = {
|
|
19
|
+
content: [{ type: "text", text }],
|
|
20
|
+
details: { mode: "management", results: [] },
|
|
21
|
+
};
|
|
22
|
+
if (isError)
|
|
23
|
+
response.isError = true;
|
|
24
|
+
return response;
|
|
25
|
+
}
|
|
26
|
+
function pathWithin(base, candidate) {
|
|
27
|
+
const resolvedBase = path.resolve(base);
|
|
28
|
+
const resolvedCandidate = path.resolve(candidate);
|
|
29
|
+
return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);
|
|
30
|
+
}
|
|
31
|
+
function trustedDir(dir, deps) {
|
|
32
|
+
try {
|
|
33
|
+
if (fs.lstatSync(dir).isSymbolicLink() || !fs.statSync(dir).isDirectory())
|
|
34
|
+
return false;
|
|
35
|
+
const real = fs.realpathSync(dir);
|
|
36
|
+
if ([...(deps.state?.asyncJobs.values() ?? []), ...(deps.state?.fleetJobs?.values() ?? [])].some((job) => {
|
|
37
|
+
try {
|
|
38
|
+
return fs.realpathSync(job.asyncDir) === real;
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
}))
|
|
44
|
+
return true;
|
|
45
|
+
const root = deps.asyncDirRoot ?? DIRS.async;
|
|
46
|
+
return fs.existsSync(root) && pathWithin(root, dir) && pathWithin(fs.realpathSync(root), real);
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return false;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
function resolveTarget(params, deps) {
|
|
53
|
+
const requested = params.id ?? params.runId;
|
|
54
|
+
let runId;
|
|
55
|
+
let asyncDir;
|
|
56
|
+
if (params.dir) {
|
|
57
|
+
asyncDir = path.resolve(params.dir);
|
|
58
|
+
if (!trustedDir(asyncDir, deps))
|
|
59
|
+
return { error: `Async run directory '${asyncDir}' is outside trusted run roots.` };
|
|
60
|
+
const status = readStatus(asyncDir);
|
|
61
|
+
if (!status)
|
|
62
|
+
return { error: `No async run status found in '${asyncDir}'.` };
|
|
63
|
+
if (requested && requested !== status.runId && !status.runId.startsWith(requested))
|
|
64
|
+
return { error: `Run '${requested}' does not match status run '${status.runId}'.` };
|
|
65
|
+
runId = status.runId;
|
|
66
|
+
}
|
|
67
|
+
else {
|
|
68
|
+
if (!requested)
|
|
69
|
+
return { error: "Inspector actions require id or dir." };
|
|
70
|
+
try {
|
|
71
|
+
const found = resolveSubagentRunId(requested, { state: deps.state, asyncDirRoot: deps.asyncDirRoot ?? DIRS.async, resultsDir: deps.resultsDir ?? DIRS.results });
|
|
72
|
+
if (!found)
|
|
73
|
+
return { error: `No subagent run found for '${requested}'.` };
|
|
74
|
+
if (found.kind !== "async" || !found.location.asyncDir)
|
|
75
|
+
return { error: `Run '${found.id}' is not an inspectable async run with lifecycle artifacts.` };
|
|
76
|
+
runId = found.id;
|
|
77
|
+
asyncDir = found.location.asyncDir;
|
|
78
|
+
}
|
|
79
|
+
catch (cause) {
|
|
80
|
+
return { error: cause instanceof Error ? cause.message : String(cause) };
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
const status = readStatus(asyncDir);
|
|
84
|
+
if (!status)
|
|
85
|
+
return { error: `No lifecycle status exists for async run '${runId}'.` };
|
|
86
|
+
if (params.index !== undefined && (params.index < 0 || params.index >= (status.steps?.length ?? 0)))
|
|
87
|
+
return { error: `Async run '${runId}' has ${status.steps?.length ?? 0} children. Index ${params.index} is out of range.` };
|
|
88
|
+
const target = { runId, asyncDir, status: { cwd: status.cwd, state: status.state, steps: status.steps } };
|
|
89
|
+
if (params.index !== undefined)
|
|
90
|
+
target.index = params.index;
|
|
91
|
+
return target;
|
|
92
|
+
}
|
|
93
|
+
function missionFor(target, deps) {
|
|
94
|
+
try {
|
|
95
|
+
const binding = readMissionBinding(target.asyncDir);
|
|
96
|
+
if (binding)
|
|
97
|
+
return { id: binding.missionId, path: missionRecordPath(binding.location, binding.missionId) };
|
|
98
|
+
const location = resolveMissionStoreLocation(deps.missions ? { projectRoot: deps.cwd, config: deps.missions } : { projectRoot: deps.cwd });
|
|
99
|
+
const mission = listMissions(location).records.find((record) => record.runs.some((run) => run.runId === target.runId));
|
|
100
|
+
return mission ? { id: mission.id, path: missionRecordPath(location, mission.id) } : undefined;
|
|
101
|
+
}
|
|
102
|
+
catch {
|
|
103
|
+
return undefined;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
function launchFor(target, deps) {
|
|
107
|
+
const mission = missionFor(target, deps);
|
|
108
|
+
const runnerPath = deps.runnerPath ?? fileURLToPath(new URL("../../inspector-runner.mjs", import.meta.url));
|
|
109
|
+
const job = deps.state?.asyncJobs.get(target.runId) ?? deps.state?.fleetJobs?.get(target.runId);
|
|
110
|
+
const sessionRoots = [...new Set([...(deps.sessionRoots ?? deps.state?.trustedSessionRoots ?? []), ...(job?.sessionRoot ? [job.sessionRoot] : [])])];
|
|
111
|
+
const allowSteer = resolveAuthorityDecision({ action: "steerRun", policy: deps.authorityPolicy }) === "auto";
|
|
112
|
+
const allowStop = resolveAuthorityDecision({ action: "stopRun", policy: deps.authorityPolicy }) === "auto";
|
|
113
|
+
const argv = [runnerPath, "--async-dir", target.asyncDir, "--run-id", target.runId, "--allow-steer", String(allowSteer), "--allow-stop", String(allowStop), "--session-roots", encodeSessionRoots(sessionRoots)];
|
|
114
|
+
if (target.index !== undefined)
|
|
115
|
+
argv.push("--index", String(target.index));
|
|
116
|
+
if (mission)
|
|
117
|
+
argv.push("--mission-path", mission.path);
|
|
118
|
+
const executable = resolveNodeExecutable();
|
|
119
|
+
const launch = { executable, argv, displayCommand: formatShellCommand(executable, argv), allowSteer, allowStop, sessionRoots };
|
|
120
|
+
if (mission)
|
|
121
|
+
launch.mission = mission;
|
|
122
|
+
return launch;
|
|
123
|
+
}
|
|
124
|
+
export async function handleInspectorAction(action, params, deps) {
|
|
125
|
+
const target = resolveTarget(params, deps);
|
|
126
|
+
if ("error" in target)
|
|
127
|
+
return result(target.error, true);
|
|
128
|
+
const context = {
|
|
129
|
+
cwd: deps.cwd,
|
|
130
|
+
signal: deps.signal,
|
|
131
|
+
env: deps.env ?? process.env,
|
|
132
|
+
target,
|
|
133
|
+
};
|
|
134
|
+
if (deps.now)
|
|
135
|
+
context.now = deps.now;
|
|
136
|
+
if (action === "inspector.command")
|
|
137
|
+
return result(launchFor(target, deps).displayCommand);
|
|
138
|
+
const plugins = deps.plugins ?? [];
|
|
139
|
+
if (action === "inspector.status") {
|
|
140
|
+
const owner = plugins.find((plugin) => plugin.owns(context));
|
|
141
|
+
if (!owner)
|
|
142
|
+
return result(`No inspector plugin owns this binding for async run ${target.runId}.`);
|
|
143
|
+
return owner.status
|
|
144
|
+
? owner.status(context)
|
|
145
|
+
: result(`Inspector plugin '${owner.name}' does not support status for async run ${target.runId}.`, true);
|
|
146
|
+
}
|
|
147
|
+
// Open and close read, create and delete the target's binding. Two callers at once, including another Pi
|
|
148
|
+
// process sharing the run directory, would each open a pane and one binding would overwrite the other.
|
|
149
|
+
const label = target.index === undefined ? "" : ` child ${target.index}`;
|
|
150
|
+
const lockPath = path.join(fs.realpathSync.native(target.asyncDir), `inspector-${target.index ?? "root"}.lock`);
|
|
151
|
+
const deadline = Date.now() + (deps.leaseWaitMs ?? INSPECTOR_LEASE_WAIT_MS);
|
|
152
|
+
let release = tryLease(lockPath);
|
|
153
|
+
while (!release) {
|
|
154
|
+
if (deps.signal?.aborted)
|
|
155
|
+
return result(`Inspector ${action} for async run ${target.runId}${label} was cancelled while waiting for another inspector open or close to finish.`, true);
|
|
156
|
+
if (Date.now() >= deadline)
|
|
157
|
+
return result(`Another inspector open or close for async run ${target.runId}${label} is still in progress. Try again when it finishes.`, true);
|
|
158
|
+
await new Promise((resolve) => setTimeout(resolve, 50));
|
|
159
|
+
release = tryLease(lockPath);
|
|
160
|
+
}
|
|
161
|
+
try {
|
|
162
|
+
// The wait may end with the lease in the same tick the caller cancelled; never act for a cancelled caller.
|
|
163
|
+
if (deps.signal?.aborted)
|
|
164
|
+
return result(`Inspector ${action} for async run ${target.runId}${label} was cancelled while waiting for another inspector open or close to finish.`, true);
|
|
165
|
+
if (action === "inspector.open") {
|
|
166
|
+
for (const plugin of plugins) {
|
|
167
|
+
if (await plugin.available(context))
|
|
168
|
+
return await plugin.open(context, launchFor(target, deps), params);
|
|
169
|
+
}
|
|
170
|
+
return result("No inspector plugin is available. Start a supported inspector host, or use inspector.command for a standalone command.", true);
|
|
171
|
+
}
|
|
172
|
+
const owner = plugins.find((plugin) => plugin.owns(context));
|
|
173
|
+
if (!owner)
|
|
174
|
+
return result(`No inspector plugin owns this binding for async run ${target.runId}.`);
|
|
175
|
+
return owner.close
|
|
176
|
+
? await owner.close(context)
|
|
177
|
+
: result(`Inspector plugin '${owner.name}' does not support close for async run ${target.runId}.`, true);
|
|
178
|
+
}
|
|
179
|
+
finally {
|
|
180
|
+
release();
|
|
181
|
+
}
|
|
182
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type ExecFileOptionsWithStringEncoding } from "node:child_process";
|
|
2
|
+
import type { AgentToolResult } from "@earendil-works/pi-agent-core";
|
|
3
|
+
import type { Details } from "../../shared/types.ts";
|
|
4
|
+
import type { InspectorContext, InspectorLaunch, InspectorParams } from "../types.ts";
|
|
5
|
+
/** Static Ghostty 1.3 AppleScript; dynamic values arrive as `on run argv` arguments. */
|
|
6
|
+
export declare const GHOSTTY_APPLESCRIPT = "on run argv\n set launchCommand to item 1 of argv\n set launchCwd to item 2 of argv\n set shouldFocus to item 3 of argv\n tell application \"Ghostty\"\n set sourceWindow to front window\n set sourceTab to selected tab of sourceWindow\n set sourceTerminal to focused terminal of sourceTab\n set surfaceConfiguration to new surface configuration\n set initial working directory of surfaceConfiguration to launchCwd\n set command of surfaceConfiguration to launchCommand\n set newTerminal to split sourceTerminal direction right with configuration surfaceConfiguration\n if shouldFocus is \"true\" then\n focus newTerminal\n else\n focus sourceTerminal\n end if\n return id of newTerminal\n end tell\nend run";
|
|
7
|
+
export type GhosttyRunner = (args: readonly string[], options: ExecFileOptionsWithStringEncoding) => Promise<{
|
|
8
|
+
stdout: string;
|
|
9
|
+
stderr: string;
|
|
10
|
+
}>;
|
|
11
|
+
export declare function openGhosttyInspector(context: InspectorContext, launch: InspectorLaunch, params: InspectorParams, runner?: GhosttyRunner): Promise<AgentToolResult<Details>>;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { execFile } from "node:child_process";
|
|
2
|
+
/** Static Ghostty 1.3 AppleScript; dynamic values arrive as `on run argv` arguments. */
|
|
3
|
+
export const GHOSTTY_APPLESCRIPT = `on run argv
|
|
4
|
+
set launchCommand to item 1 of argv
|
|
5
|
+
set launchCwd to item 2 of argv
|
|
6
|
+
set shouldFocus to item 3 of argv
|
|
7
|
+
tell application "Ghostty"
|
|
8
|
+
set sourceWindow to front window
|
|
9
|
+
set sourceTab to selected tab of sourceWindow
|
|
10
|
+
set sourceTerminal to focused terminal of sourceTab
|
|
11
|
+
set surfaceConfiguration to new surface configuration
|
|
12
|
+
set initial working directory of surfaceConfiguration to launchCwd
|
|
13
|
+
set command of surfaceConfiguration to launchCommand
|
|
14
|
+
set newTerminal to split sourceTerminal direction right with configuration surfaceConfiguration
|
|
15
|
+
if shouldFocus is "true" then
|
|
16
|
+
focus newTerminal
|
|
17
|
+
else
|
|
18
|
+
focus sourceTerminal
|
|
19
|
+
end if
|
|
20
|
+
return id of newTerminal
|
|
21
|
+
end tell
|
|
22
|
+
end run`;
|
|
23
|
+
function defaultRunner(args, options) {
|
|
24
|
+
return new Promise((resolve, reject) => {
|
|
25
|
+
execFile("/usr/bin/osascript", [...args], options, (error, stdout, stderr) => {
|
|
26
|
+
if (error) {
|
|
27
|
+
const failure = error instanceof Error ? error : new Error(String(error));
|
|
28
|
+
reject(failure);
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
resolve({ stdout, stderr });
|
|
32
|
+
});
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
function result(text, isError = false) {
|
|
36
|
+
const response = {
|
|
37
|
+
content: [{ type: "text", text }],
|
|
38
|
+
details: { mode: "management", results: [] },
|
|
39
|
+
};
|
|
40
|
+
if (isError)
|
|
41
|
+
response.isError = true;
|
|
42
|
+
return response;
|
|
43
|
+
}
|
|
44
|
+
const failureHint = "Ghostty inspector requires Ghostty 1.3+ and Automation permission for osascript.";
|
|
45
|
+
export async function openGhosttyInspector(context, launch, params, runner = defaultRunner) {
|
|
46
|
+
try {
|
|
47
|
+
const output = await runner(["-e", GHOSTTY_APPLESCRIPT, "--", launch.displayCommand, context.target.status.cwd ?? context.cwd, params.focus === true ? "true" : "false"], {
|
|
48
|
+
signal: context.signal,
|
|
49
|
+
timeout: 15_000,
|
|
50
|
+
encoding: "utf8",
|
|
51
|
+
maxBuffer: 64 * 1024,
|
|
52
|
+
});
|
|
53
|
+
const id = output.stdout.trim();
|
|
54
|
+
if (!id)
|
|
55
|
+
return result(`Ghostty inspector error: Ghostty returned an empty terminal id. ${failureHint}`, true);
|
|
56
|
+
return result(`Opened read-only Ghostty inspector terminal ${id} for async run ${context.target.runId}. Status and close are unavailable because this plugin writes no binding.`);
|
|
57
|
+
}
|
|
58
|
+
catch (cause) {
|
|
59
|
+
const message = cause instanceof Error ? cause.message : String(cause);
|
|
60
|
+
return result(`Ghostty inspector error: ${message}. ${failureHint}`, true);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type GhosttyRunner } from "./actions.ts";
|
|
2
|
+
import type { InspectorPlugin } from "../types.ts";
|
|
3
|
+
export interface GhosttyPluginDeps {
|
|
4
|
+
platform?: NodeJS.Platform;
|
|
5
|
+
runner?: GhosttyRunner;
|
|
6
|
+
}
|
|
7
|
+
export declare function createGhosttyInspectorPlugin(deps?: GhosttyPluginDeps): InspectorPlugin;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { openGhosttyInspector } from "./actions.js";
|
|
2
|
+
/** 独立 Ghostty.app 的 bundle id (作者 Mitchell Hashimoto)。 */
|
|
3
|
+
const GHOSTTY_BUNDLE_ID = "com.mitchellh.ghostty";
|
|
4
|
+
export function createGhosttyInspectorPlugin(deps = {}) {
|
|
5
|
+
const platform = deps.platform ?? process.platform;
|
|
6
|
+
return {
|
|
7
|
+
name: "ghostty",
|
|
8
|
+
available: (context) => {
|
|
9
|
+
// cmux 内嵌 Ghostty 内核, 也会把 TERM_PROGRAM 设成 "ghostty"。仅凭环境变量会让 plugin
|
|
10
|
+
// 在 cmux 下误接管, 随后 osascript 连不上真正的 Ghostty 应用而抛 -1728/-2741。
|
|
11
|
+
if (platform !== "darwin")
|
|
12
|
+
return false;
|
|
13
|
+
if (context.env.TERM_PROGRAM?.toLowerCase() !== "ghostty")
|
|
14
|
+
return false;
|
|
15
|
+
// macOS GUI 应用启动子进程时注入 __CFBundleIdentifier, 标识当前终端宿主 app。
|
|
16
|
+
// cmux 的 bundle id 是 com.cmuxterm.app, 而非 Ghostty; 即便系统同时装了独立 Ghostty,
|
|
17
|
+
// 也能据此判定当前终端不是 Ghostty, 避免误连独立 Ghostty 的窗口。
|
|
18
|
+
return context.env.__CFBundleIdentifier?.trim() === GHOSTTY_BUNDLE_ID;
|
|
19
|
+
},
|
|
20
|
+
owns: () => false,
|
|
21
|
+
open: (context, launch, params) => openGhosttyInspector(context, launch, params, deps.runner),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { AgentToolResult } from "@earendil-works/pi-agent-core";
|
|
2
|
+
import type { Details } from "../../shared/types.ts";
|
|
3
|
+
import type { InspectorContext, InspectorLaunch, InspectorParams, InspectorTarget } from "../types.ts";
|
|
4
|
+
import { type HerdrClient } from "./client.ts";
|
|
5
|
+
export interface HerdrInspectorBinding {
|
|
6
|
+
schemaVersion: 1;
|
|
7
|
+
kind: "herdr-inspector";
|
|
8
|
+
runId: string;
|
|
9
|
+
asyncDir: string;
|
|
10
|
+
childIndex?: number;
|
|
11
|
+
missionId?: string;
|
|
12
|
+
missionPath?: string;
|
|
13
|
+
paneId: string;
|
|
14
|
+
openedAt: string;
|
|
15
|
+
lastFocusedAt?: string;
|
|
16
|
+
herdrVersion?: string;
|
|
17
|
+
command: string;
|
|
18
|
+
}
|
|
19
|
+
export declare function bindingPath(asyncDir: string, index?: number): string;
|
|
20
|
+
export declare function readHerdrInspectorBinding(asyncDir: string, index?: number): HerdrInspectorBinding | undefined;
|
|
21
|
+
/** Read a binding only when it belongs to the requested inspector target. */
|
|
22
|
+
export declare function readHerdrInspectorBindingForTarget(target: InspectorTarget): HerdrInspectorBinding | undefined;
|
|
23
|
+
export declare function openHerdrInspector(context: InspectorContext, launch: InspectorLaunch, params: InspectorParams, client: HerdrClient): Promise<AgentToolResult<Details>>;
|
|
24
|
+
export declare function statusHerdrInspector(context: InspectorContext, client: HerdrClient): Promise<AgentToolResult<Details>>;
|
|
25
|
+
export declare function closeHerdrInspector(context: InspectorContext, client: HerdrClient): Promise<AgentToolResult<Details>>;
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { writeAtomicJson } from "../../shared/atomic-json.js";
|
|
4
|
+
import { detectHerdr } from "./client.js";
|
|
5
|
+
export function bindingPath(asyncDir, index) {
|
|
6
|
+
return path.join(asyncDir, "inspectors", `herdr${index === undefined ? "" : `-${index}`}.json`);
|
|
7
|
+
}
|
|
8
|
+
function parse(value) {
|
|
9
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
10
|
+
return undefined;
|
|
11
|
+
const binding = value;
|
|
12
|
+
if (binding.schemaVersion !== 1
|
|
13
|
+
|| binding.kind !== "herdr-inspector"
|
|
14
|
+
|| (binding.childIndex !== undefined && (!Number.isInteger(binding.childIndex) || binding.childIndex < 0))
|
|
15
|
+
|| typeof binding.runId !== "string"
|
|
16
|
+
|| typeof binding.asyncDir !== "string"
|
|
17
|
+
|| typeof binding.paneId !== "string"
|
|
18
|
+
|| typeof binding.openedAt !== "string"
|
|
19
|
+
|| typeof binding.command !== "string")
|
|
20
|
+
return undefined;
|
|
21
|
+
return binding;
|
|
22
|
+
}
|
|
23
|
+
export function readHerdrInspectorBinding(asyncDir, index) {
|
|
24
|
+
try {
|
|
25
|
+
return parse(JSON.parse(fs.readFileSync(bindingPath(asyncDir, index), "utf8")));
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/** Read a binding only when it belongs to the requested inspector target. */
|
|
32
|
+
export function readHerdrInspectorBindingForTarget(target) {
|
|
33
|
+
const binding = readHerdrInspectorBinding(target.asyncDir, target.index);
|
|
34
|
+
if (!binding || binding.runId !== target.runId || binding.childIndex !== target.index)
|
|
35
|
+
return undefined;
|
|
36
|
+
try {
|
|
37
|
+
if (fs.realpathSync(binding.asyncDir) !== fs.realpathSync(target.asyncDir))
|
|
38
|
+
return undefined;
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return undefined;
|
|
42
|
+
}
|
|
43
|
+
return binding;
|
|
44
|
+
}
|
|
45
|
+
function result(text, isError = false) {
|
|
46
|
+
return {
|
|
47
|
+
content: [{ type: "text", text }],
|
|
48
|
+
...(isError ? { isError: true } : {}),
|
|
49
|
+
details: { mode: "management", results: [] },
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
function errorText(input) {
|
|
53
|
+
return `Herdr inspector error (${input.code}): ${input.message}`;
|
|
54
|
+
}
|
|
55
|
+
function paneId(value) {
|
|
56
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
57
|
+
return undefined;
|
|
58
|
+
const record = value;
|
|
59
|
+
const pane = record.pane && typeof record.pane === "object" ? record.pane : record;
|
|
60
|
+
for (const key of ["pane_id", "paneId", "id"]) {
|
|
61
|
+
if (typeof pane[key] === "string")
|
|
62
|
+
return pane[key];
|
|
63
|
+
}
|
|
64
|
+
return undefined;
|
|
65
|
+
}
|
|
66
|
+
async function pane(client, id, signal) {
|
|
67
|
+
return client.run(["pane", "get", id], { timeoutMs: 5_000, signal });
|
|
68
|
+
}
|
|
69
|
+
export async function openHerdrInspector(context, launch, params, client) {
|
|
70
|
+
const detected = await detectHerdr(client, context.signal);
|
|
71
|
+
if (!detected.ok)
|
|
72
|
+
return result(errorText(detected.error), true);
|
|
73
|
+
const existing = readHerdrInspectorBindingForTarget(context.target);
|
|
74
|
+
if (existing) {
|
|
75
|
+
const current = await pane(client, existing.paneId, context.signal);
|
|
76
|
+
if (current.ok && paneId(current.data) === existing.paneId) {
|
|
77
|
+
return result(`Herdr inspector pane ${existing.paneId} is already open for async run ${context.target.runId}.${params.focus ? " Herdr cannot refocus an arbitrary raw pane id; select it in the Herdr UI." : ""}`);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
const split = await client.run([
|
|
81
|
+
"pane", "split", "--current", "--direction", "right",
|
|
82
|
+
"--cwd", context.target.status.cwd ?? context.cwd,
|
|
83
|
+
params.focus === true ? "--focus" : "--no-focus",
|
|
84
|
+
], { timeoutMs: 15_000, signal: context.signal });
|
|
85
|
+
if (!split.ok)
|
|
86
|
+
return result(errorText(split.error), true);
|
|
87
|
+
const id = paneId(split.data);
|
|
88
|
+
if (!id)
|
|
89
|
+
return result("Herdr inspector error (PANE_GONE): pane split returned no pane id.", true);
|
|
90
|
+
const started = await client.run(["pane", "run", id, launch.displayCommand], { timeoutMs: 15_000, signal: context.signal });
|
|
91
|
+
if (!started.ok) {
|
|
92
|
+
await client.run(["pane", "close", id], { timeoutMs: 5_000 });
|
|
93
|
+
return result(errorText(started.error), true);
|
|
94
|
+
}
|
|
95
|
+
const now = (context.now?.() ?? new Date()).toISOString();
|
|
96
|
+
const binding = {
|
|
97
|
+
schemaVersion: 1,
|
|
98
|
+
kind: "herdr-inspector",
|
|
99
|
+
runId: context.target.runId,
|
|
100
|
+
asyncDir: context.target.asyncDir,
|
|
101
|
+
...(context.target.index === undefined ? {} : { childIndex: context.target.index }),
|
|
102
|
+
...(launch.mission ? { missionId: launch.mission.id, missionPath: launch.mission.path } : {}),
|
|
103
|
+
paneId: id,
|
|
104
|
+
openedAt: now,
|
|
105
|
+
...(params.focus === true ? { lastFocusedAt: now } : {}),
|
|
106
|
+
herdrVersion: detected.data.versionText,
|
|
107
|
+
command: launch.displayCommand,
|
|
108
|
+
};
|
|
109
|
+
writeAtomicJson(bindingPath(context.target.asyncDir, context.target.index), binding);
|
|
110
|
+
return result(`Opened read-only Herdr inspector pane ${id} for async run ${context.target.runId}. Closing the pane does not stop the run.\nControls inside the pane: steer <message>, stop, status.`);
|
|
111
|
+
}
|
|
112
|
+
export async function statusHerdrInspector(context, client) {
|
|
113
|
+
const binding = readHerdrInspectorBindingForTarget(context.target);
|
|
114
|
+
if (!binding) {
|
|
115
|
+
return result(`No Herdr inspector binding exists for async run ${context.target.runId}${context.target.index === undefined ? "" : ` child ${context.target.index}`}.`);
|
|
116
|
+
}
|
|
117
|
+
const live = await pane(client, binding.paneId, context.signal);
|
|
118
|
+
if (!live.ok) {
|
|
119
|
+
return result(`${errorText(live.error)}\nBinding: ${bindingPath(context.target.asyncDir, context.target.index)}\nRun state remains authoritative: ${context.target.status.state}.`, true);
|
|
120
|
+
}
|
|
121
|
+
return result(`Herdr inspector ${binding.paneId} is open for async run ${context.target.runId}.\nRun state: ${context.target.status.state}\nBinding: ${bindingPath(context.target.asyncDir, context.target.index)}`);
|
|
122
|
+
}
|
|
123
|
+
export async function closeHerdrInspector(context, client) {
|
|
124
|
+
const binding = readHerdrInspectorBindingForTarget(context.target);
|
|
125
|
+
if (!binding)
|
|
126
|
+
return result(`No Herdr inspector binding exists for async run ${context.target.runId}.`);
|
|
127
|
+
const closed = await client.run(["pane", "close", binding.paneId], { timeoutMs: 10_000, signal: context.signal });
|
|
128
|
+
if (!closed.ok && closed.error.code !== "NOT_FOUND" && closed.error.code !== "PANE_GONE") {
|
|
129
|
+
return result(errorText(closed.error), true);
|
|
130
|
+
}
|
|
131
|
+
fs.rmSync(bindingPath(context.target.asyncDir, context.target.index), { force: true });
|
|
132
|
+
return result(`Closed Herdr inspector pane ${binding.paneId} for async run ${context.target.runId}. The subagent run was not stopped.`);
|
|
133
|
+
}
|