@xzzpig/pi-subagents 0.22.0 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +346 -0
- package/README.md +2 -2
- package/agents/evidence-auditor.md +1 -0
- package/agents/oracle.md +1 -0
- package/agents/reviewer.md +1 -0
- package/bundle/agent-management.js +16 -0
- package/bundle/agents.js +41 -0
- package/bundle/background-work.js +16 -0
- package/bundle/capability-ceiling.js +22 -0
- package/bundle/child-tool-plan.js +11 -0
- package/bundle/chunk-355ECEP2.js +1321 -0
- package/bundle/chunk-35GII5EF.js +637 -0
- package/bundle/chunk-3G4JXNZ4.js +4130 -0
- package/bundle/chunk-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -0
- package/bundle/chunk-7K3Z6DM7.js +276 -0
- package/bundle/chunk-BGIYHF2W.js +138 -0
- package/bundle/chunk-CTPAE36Y.js +94 -0
- package/bundle/chunk-D4EHT5SJ.js +14 -0
- package/bundle/chunk-ED55MIC2.js +1681 -0
- package/bundle/chunk-F3NSN7UH.js +7331 -0
- package/bundle/chunk-FJWI64H7.js +490 -0
- package/bundle/chunk-H36HBZB2.js +753 -0
- package/bundle/chunk-ICNYIALB.js +7347 -0
- package/bundle/chunk-KD2IMFN4.js +1310 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LPVUHUZ7.js +5503 -0
- package/bundle/chunk-MYCL5QEJ.js +1372 -0
- package/bundle/chunk-NCWCVJLT.js +1768 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-NTRJDXBC.js +4175 -0
- package/bundle/chunk-OFGSZBHP.js +16924 -0
- package/bundle/chunk-OTLRAB22.js +143 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RK2HDPLK.js +1234 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-T65XRVVM.js +940 -0
- package/bundle/chunk-U4ODUYAG.js +235 -0
- package/bundle/chunk-UFNSLL5D.js +9796 -0
- package/bundle/chunk-UKG4V45O.js +228 -0
- package/bundle/chunk-UQDHXMUG.js +264 -0
- package/bundle/chunk-V2KFIGFH.js +8774 -0
- package/bundle/chunk-VO3G7HI3.js +85 -0
- package/bundle/chunk-WPW4V6HM.js +227 -0
- package/bundle/chunk-WW76JRIX.js +175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/control-channel.js +11 -0
- package/bundle/delegation.js +14 -0
- package/bundle/external-job-provider.js +20 -0
- package/bundle/external-runs.js +21 -0
- package/bundle/index.js +30 -0
- package/bundle/inspectors.js +8 -0
- package/bundle/intercom-bridge.js +11 -0
- package/bundle/preflight.js +468 -0
- package/bundle/project-panes.js +28 -0
- package/bundle/required-child-extensions.js +6 -0
- package/bundle/shared-types.js +8 -0
- package/bundle/supervisor-routing.js +12 -0
- package/bundle/workflow-resources.js +7 -0
- package/docs/agents.md +42 -10
- package/docs/configuration.md +59 -14
- package/docs/extension-api.md +61 -9
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -87
- package/skills/council-mode/SKILL.md +1 -4
- package/skills/pi-subagents/SKILL.md +130 -106
- package/skills/pi-subagents/references/orchestration.md +124 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
- package/src/agents/advertised-agent-prompt.d.ts +13 -0
- package/src/agents/advertised-agent-prompt.js +68 -0
- package/src/agents/agent-eject.d.ts +39 -0
- package/src/agents/agent-eject.js +263 -0
- package/src/agents/agent-management.d.ts +33 -0
- package/src/agents/agent-management.js +1541 -0
- package/src/agents/agent-memory.d.ts +48 -0
- package/src/agents/agent-memory.js +350 -0
- package/src/agents/agent-refinements.d.ts +99 -0
- package/src/agents/agent-refinements.js +568 -0
- package/src/agents/agent-scope.d.ts +3 -0
- package/src/agents/agent-scope.js +8 -0
- package/src/agents/agent-selection.d.ts +2 -0
- package/src/agents/agent-selection.js +22 -0
- package/src/agents/agent-serializer.d.ts +7 -0
- package/src/agents/agent-serializer.js +213 -0
- package/src/agents/agents.d.ts +352 -0
- package/src/agents/agents.js +2817 -0
- package/src/agents/builtin-names.d.ts +1 -0
- package/src/agents/builtin-names.js +16 -0
- package/src/agents/chain-serializer.d.ts +6 -0
- package/src/agents/chain-serializer.js +318 -0
- package/src/agents/frontmatter.d.ts +19 -0
- package/src/agents/frontmatter.js +166 -0
- package/src/agents/global-npm-root.d.ts +6 -0
- package/src/agents/global-npm-root.js +57 -0
- package/src/agents/identity.d.ts +7 -0
- package/src/agents/identity.js +29 -0
- package/src/agents/proactive-skills.d.ts +35 -0
- package/src/agents/proactive-skills.js +155 -0
- package/src/agents/runtime-agent-events.d.ts +26 -0
- package/src/agents/runtime-agent-events.js +52 -0
- package/src/agents/runtime-agent-registry.d.ts +66 -0
- package/src/agents/runtime-agent-registry.js +415 -0
- package/src/agents/runtime-discovery.d.ts +13 -0
- package/src/agents/runtime-discovery.js +27 -0
- package/src/agents/skills.d.ts +34 -0
- package/src/agents/skills.js +718 -0
- package/src/api/agent-management.d.ts +2 -0
- package/src/api/agent-management.js +2 -0
- package/src/api/agents.d.ts +6 -0
- package/src/api/agents.js +3 -0
- package/src/api/background-work.d.ts +41 -0
- package/src/api/background-work.js +171 -0
- package/src/api/capability-ceiling.d.ts +1 -0
- package/src/api/capability-ceiling.js +1 -0
- package/src/api/child-tool-plan.d.ts +1 -0
- package/src/api/child-tool-plan.js +1 -0
- package/src/api/control-channel.d.ts +1 -0
- package/src/api/control-channel.js +1 -0
- package/src/api/delegation.d.ts +132 -0
- package/src/api/delegation.js +8 -0
- package/src/api/external-job-provider.d.ts +57 -0
- package/src/api/external-job-provider.js +139 -0
- package/src/api/external-runs.d.ts +47 -0
- package/src/api/external-runs.js +245 -0
- package/src/api/inspectors.d.ts +20 -0
- package/src/api/inspectors.js +11 -0
- package/src/api/intercom-bridge.d.ts +1 -0
- package/src/api/intercom-bridge.js +1 -0
- package/src/api/preflight.d.ts +183 -0
- package/src/api/preflight.js +455 -0
- package/src/api/project-panes.d.ts +7 -0
- package/src/api/project-panes.js +7 -0
- package/src/api/required-child-extensions.d.ts +1 -0
- package/src/api/required-child-extensions.js +1 -0
- package/src/api/shared-types.d.ts +1 -0
- package/src/api/shared-types.js +1 -0
- package/src/api/supervisor-routing.d.ts +110 -0
- package/src/api/supervisor-routing.js +95 -0
- package/src/api/workflow-resources.d.ts +2 -0
- package/src/api/workflow-resources.js +1 -0
- package/src/extension/active-runs-prompt.d.ts +7 -0
- package/src/extension/active-runs-prompt.js +29 -0
- package/src/extension/config.d.ts +7 -0
- package/src/extension/config.js +290 -0
- package/src/extension/context-injection.d.ts +52 -0
- package/src/extension/context-injection.js +102 -0
- package/src/extension/control-notices.d.ts +18 -0
- package/src/extension/control-notices.js +29 -0
- package/src/extension/declaration-pinning.d.ts +18 -0
- package/src/extension/declaration-pinning.js +167 -0
- package/src/extension/doctor.d.ts +34 -0
- package/src/extension/doctor.js +236 -0
- package/src/extension/fanout-child.d.ts +6 -0
- package/src/extension/fanout-child.js +278 -0
- package/src/extension/herdr-pi-bridge.d.ts +16 -0
- package/src/extension/herdr-pi-bridge.js +261 -0
- package/src/extension/index.d.ts +18 -0
- package/src/extension/index.js +1288 -0
- package/src/extension/public-execution.d.ts +71 -0
- package/src/extension/public-execution.js +214 -0
- package/src/extension/reply-workflow-script.d.ts +11 -0
- package/src/extension/reply-workflow-script.js +71 -0
- package/src/extension/rpc.d.ts +84 -0
- package/src/extension/rpc.js +729 -0
- package/src/extension/schemas.d.ts +276 -0
- package/src/extension/schemas.js +311 -0
- package/src/extension/steering-notices.d.ts +14 -0
- package/src/extension/steering-notices.js +22 -0
- package/src/extension/subagent-guide.d.ts +4 -0
- package/src/extension/subagent-guide.js +114 -0
- package/src/extension/subagent-options.d.ts +7 -0
- package/src/extension/subagent-options.js +64 -0
- package/src/extension/tool-activation.d.ts +7 -0
- package/src/extension/tool-activation.js +185 -0
- package/src/extension/tool-description.d.ts +19 -0
- package/src/extension/tool-description.js +169 -0
- package/src/extension/tool-result.d.ts +9 -0
- package/src/extension/tool-result.js +16 -0
- package/src/extension/upgrade-notice.d.ts +6 -0
- package/src/extension/upgrade-notice.js +42 -0
- package/src/inspectors/actions.d.ts +24 -0
- package/src/inspectors/actions.js +182 -0
- package/src/inspectors/ghostty/actions.d.ts +11 -0
- package/src/inspectors/ghostty/actions.js +62 -0
- package/src/inspectors/ghostty/plugin.d.ts +7 -0
- package/src/inspectors/ghostty/plugin.js +23 -0
- package/src/inspectors/herdr/actions.d.ts +25 -0
- package/src/inspectors/herdr/actions.js +133 -0
- package/src/inspectors/herdr/client.d.ts +41 -0
- package/src/inspectors/herdr/client.js +129 -0
- package/src/inspectors/herdr/focus.d.ts +24 -0
- package/src/inspectors/herdr/focus.js +49 -0
- package/src/inspectors/herdr/plugin.d.ts +6 -0
- package/src/inspectors/herdr/plugin.js +14 -0
- package/src/inspectors/herdr/project-panes.d.ts +136 -0
- package/src/inspectors/herdr/project-panes.js +610 -0
- package/src/inspectors/inspector-runner.d.ts +23 -0
- package/src/inspectors/inspector-runner.js +161 -0
- package/src/inspectors/plugins.d.ts +8 -0
- package/src/inspectors/plugins.js +82 -0
- package/src/inspectors/session-roots-codec.d.ts +15 -0
- package/src/inspectors/session-roots-codec.js +32 -0
- package/src/inspectors/shell-command.d.ts +1 -0
- package/src/inspectors/shell-command.js +16 -0
- package/src/inspectors/tmux/actions.d.ts +25 -0
- package/src/inspectors/tmux/actions.js +181 -0
- package/src/inspectors/tmux/client.d.ts +27 -0
- package/src/inspectors/tmux/client.js +64 -0
- package/src/inspectors/tmux/plugin.d.ts +7 -0
- package/src/inspectors/tmux/plugin.js +14 -0
- package/src/inspectors/types.d.ts +48 -0
- package/src/inspectors/types.js +1 -0
- package/src/integrations/herdr-status.d.ts +47 -0
- package/src/integrations/herdr-status.js +350 -0
- package/src/integrations/pi-web-session-liveness.d.ts +19 -0
- package/src/integrations/pi-web-session-liveness.js +53 -0
- package/src/integrations/program-status.d.ts +30 -0
- package/src/integrations/program-status.js +188 -0
- package/src/intercom/fork-supervisor-routing.d.ts +90 -0
- package/src/intercom/fork-supervisor-routing.js +392 -0
- package/src/intercom/intercom-bridge.d.ts +58 -0
- package/src/intercom/intercom-bridge.js +193 -0
- package/src/intercom/native-supervisor-channel.d.ts +97 -0
- package/src/intercom/native-supervisor-channel.js +1184 -0
- package/src/intercom/result-intercom.d.ts +35 -0
- package/src/intercom/result-intercom.js +376 -0
- package/src/intercom/supervisor-ui.d.ts +29 -0
- package/src/intercom/supervisor-ui.js +49 -0
- package/src/missions/actions.d.ts +54 -0
- package/src/missions/actions.js +400 -0
- package/src/missions/goal-driver.d.ts +16 -0
- package/src/missions/goal-driver.js +171 -0
- package/src/missions/lifecycle.d.ts +50 -0
- package/src/missions/lifecycle.js +388 -0
- package/src/missions/store.d.ts +21 -0
- package/src/missions/store.js +605 -0
- package/src/missions/types.d.ts +169 -0
- package/src/missions/types.js +9 -0
- package/src/missions/workflow-state.d.ts +14 -0
- package/src/missions/workflow-state.js +273 -0
- package/src/policy/authority.d.ts +9 -0
- package/src/policy/authority.js +41 -0
- package/src/profiles/profiles.d.ts +134 -0
- package/src/profiles/profiles.js +526 -0
- package/src/runs/background/active-async-capacity.d.ts +115 -0
- package/src/runs/background/active-async-capacity.js +517 -0
- package/src/runs/background/active-run-index.d.ts +12 -0
- package/src/runs/background/active-run-index.js +157 -0
- package/src/runs/background/async-execution.d.ts +304 -0
- package/src/runs/background/async-execution.js +2206 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +921 -0
- package/src/runs/background/async-resume.d.ts +60 -0
- package/src/runs/background/async-resume.js +707 -0
- package/src/runs/background/async-retention.d.ts +45 -0
- package/src/runs/background/async-retention.js +932 -0
- package/src/runs/background/async-status-snapshot.d.ts +9 -0
- package/src/runs/background/async-status-snapshot.js +26 -0
- package/src/runs/background/async-status.d.ts +177 -0
- package/src/runs/background/async-status.js +710 -0
- package/src/runs/background/auto-drain.d.ts +16 -0
- package/src/runs/background/auto-drain.js +71 -0
- package/src/runs/background/await-async-run.d.ts +26 -0
- package/src/runs/background/await-async-run.js +83 -0
- package/src/runs/background/binary-bootstrap.d.ts +8 -0
- package/src/runs/background/binary-bootstrap.js +69 -0
- package/src/runs/background/boot-id.d.ts +12 -0
- package/src/runs/background/boot-id.js +47 -0
- package/src/runs/background/calendar-schedule.d.ts +26 -0
- package/src/runs/background/calendar-schedule.js +93 -0
- package/src/runs/background/chain-append.d.ts +34 -0
- package/src/runs/background/chain-append.js +299 -0
- package/src/runs/background/chain-root-attachment.d.ts +51 -0
- package/src/runs/background/chain-root-attachment.js +186 -0
- package/src/runs/background/completion-batcher.d.ts +51 -0
- package/src/runs/background/completion-batcher.js +119 -0
- package/src/runs/background/completion-dedupe.d.ts +13 -0
- package/src/runs/background/completion-dedupe.js +48 -0
- package/src/runs/background/completion-replay.d.ts +47 -0
- package/src/runs/background/completion-replay.js +266 -0
- package/src/runs/background/control-channel.d.ts +170 -0
- package/src/runs/background/control-channel.js +610 -0
- package/src/runs/background/fleet-view.d.ts +63 -0
- package/src/runs/background/fleet-view.js +666 -0
- package/src/runs/background/index-segment.d.ts +16 -0
- package/src/runs/background/index-segment.js +58 -0
- package/src/runs/background/inspect-rpc.d.ts +64 -0
- package/src/runs/background/inspect-rpc.js +422 -0
- package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
- package/src/runs/background/interrupted-elsewhere.js +68 -0
- package/src/runs/background/notify.d.ts +214 -0
- package/src/runs/background/notify.js +1001 -0
- package/src/runs/background/owned-process-tree.d.ts +10 -0
- package/src/runs/background/owned-process-tree.js +116 -0
- package/src/runs/background/parallel-groups.d.ts +3 -0
- package/src/runs/background/parallel-groups.js +46 -0
- package/src/runs/background/pid-namespace.d.ts +2 -0
- package/src/runs/background/pid-namespace.js +19 -0
- package/src/runs/background/process-terminal-candidate.d.ts +17 -0
- package/src/runs/background/process-terminal-candidate.js +96 -0
- package/src/runs/background/process-terminal.d.ts +21 -0
- package/src/runs/background/process-terminal.js +227 -0
- package/src/runs/background/result-delivery-ownership.d.ts +14 -0
- package/src/runs/background/result-delivery-ownership.js +38 -0
- package/src/runs/background/result-files.d.ts +63 -0
- package/src/runs/background/result-files.js +629 -0
- package/src/runs/background/result-watcher.d.ts +92 -0
- package/src/runs/background/result-watcher.js +819 -0
- package/src/runs/background/resume-guidance.d.ts +4 -0
- package/src/runs/background/resume-guidance.js +57 -0
- package/src/runs/background/retained-children.d.ts +24 -0
- package/src/runs/background/retained-children.js +128 -0
- package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
- package/src/runs/background/retained-nested-route-tracker.js +90 -0
- package/src/runs/background/run-child-session.d.ts +123 -0
- package/src/runs/background/run-child-session.js +670 -0
- package/src/runs/background/run-id-query.d.ts +3 -0
- package/src/runs/background/run-id-query.js +6 -0
- package/src/runs/background/run-id-resolver.d.ts +22 -0
- package/src/runs/background/run-id-resolver.js +172 -0
- package/src/runs/background/run-status.d.ts +25 -0
- package/src/runs/background/run-status.js +850 -0
- package/src/runs/background/runner-aliases.d.ts +17 -0
- package/src/runs/background/runner-aliases.js +191 -0
- package/src/runs/background/runner-child-launch.d.ts +24 -0
- package/src/runs/background/runner-child-launch.js +72 -0
- package/src/runs/background/runner-child-sessions.d.ts +6 -0
- package/src/runs/background/runner-child-sessions.js +34 -0
- package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
- package/src/runs/background/runner-http-dispatcher.js +115 -0
- package/src/runs/background/runner-startup-failure.d.ts +13 -0
- package/src/runs/background/runner-startup-failure.js +46 -0
- package/src/runs/background/scheduled-runs.d.ts +127 -0
- package/src/runs/background/scheduled-runs.js +1265 -0
- package/src/runs/background/stale-run-reconciler.d.ts +62 -0
- package/src/runs/background/stale-run-reconciler.js +509 -0
- package/src/runs/background/steering.d.ts +51 -0
- package/src/runs/background/steering.js +246 -0
- package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
- package/src/runs/background/subagent-runner-bootstrap.js +283 -0
- package/src/runs/background/subagent-runner.d.ts +210 -0
- package/src/runs/background/subagent-runner.js +4963 -0
- package/src/runs/background/subagent-wait.d.ts +124 -0
- package/src/runs/background/subagent-wait.js +756 -0
- package/src/runs/background/terminal-run-index.d.ts +10 -0
- package/src/runs/background/terminal-run-index.js +209 -0
- package/src/runs/background/top-level-async.d.ts +7 -0
- package/src/runs/background/top-level-async.js +5 -0
- package/src/runs/background/wait-completions.d.ts +28 -0
- package/src/runs/background/wait-completions.js +264 -0
- package/src/runs/background/wait-config.d.ts +8 -0
- package/src/runs/background/wait-config.js +46 -0
- package/src/runs/background/wait-subscriptions.d.ts +26 -0
- package/src/runs/background/wait-subscriptions.js +339 -0
- package/src/runs/background/wait-tool.d.ts +6 -0
- package/src/runs/background/wait-tool.js +48 -0
- package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
- package/src/runs/background/workflow-terminal-proof.js +116 -0
- package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
- package/src/runs/foreground/async-dismiss-action.js +82 -0
- package/src/runs/foreground/async-steering-action.d.ts +31 -0
- package/src/runs/foreground/async-steering-action.js +294 -0
- package/src/runs/foreground/async-stop-action.d.ts +13 -0
- package/src/runs/foreground/async-stop-action.js +213 -0
- package/src/runs/foreground/command-action.d.ts +12 -0
- package/src/runs/foreground/command-action.js +38 -0
- package/src/runs/foreground/execution.d.ts +10 -0
- package/src/runs/foreground/execution.js +2322 -0
- package/src/runs/foreground/foreground-control.d.ts +24 -0
- package/src/runs/foreground/foreground-control.js +138 -0
- package/src/runs/foreground/foreground-history.d.ts +25 -0
- package/src/runs/foreground/foreground-history.js +267 -0
- package/src/runs/foreground/prompt-audit.d.ts +32 -0
- package/src/runs/foreground/prompt-audit.js +138 -0
- package/src/runs/foreground/subagent-executor.d.ts +316 -0
- package/src/runs/foreground/subagent-executor.js +7986 -0
- package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
- package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
- package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
- package/src/runs/foreground/workflow-foreground-steering.js +148 -0
- package/src/runs/shared/abort-recovery.d.ts +26 -0
- package/src/runs/shared/abort-recovery.js +108 -0
- package/src/runs/shared/acceptance.d.ts +144 -0
- package/src/runs/shared/acceptance.js +1616 -0
- package/src/runs/shared/agent-contract.d.ts +5 -0
- package/src/runs/shared/agent-contract.js +35 -0
- package/src/runs/shared/async-status-projection.d.ts +100 -0
- package/src/runs/shared/async-status-projection.js +566 -0
- package/src/runs/shared/background-process-options.d.ts +4 -0
- package/src/runs/shared/background-process-options.js +6 -0
- package/src/runs/shared/capability-ceiling.d.ts +58 -0
- package/src/runs/shared/capability-ceiling.js +179 -0
- package/src/runs/shared/chain-outputs.d.ts +18 -0
- package/src/runs/shared/chain-outputs.js +104 -0
- package/src/runs/shared/child-commands.d.ts +29 -0
- package/src/runs/shared/child-commands.js +254 -0
- package/src/runs/shared/child-hooks.d.ts +31 -0
- package/src/runs/shared/child-hooks.js +173 -0
- package/src/runs/shared/child-identity.d.ts +23 -0
- package/src/runs/shared/child-identity.js +40 -0
- package/src/runs/shared/child-launch-plan.d.ts +70 -0
- package/src/runs/shared/child-launch-plan.js +88 -0
- package/src/runs/shared/child-launch.d.ts +128 -0
- package/src/runs/shared/child-launch.js +262 -0
- package/src/runs/shared/child-lifecycle.d.ts +13 -0
- package/src/runs/shared/child-lifecycle.js +22 -0
- package/src/runs/shared/child-runtime-config.d.ts +111 -0
- package/src/runs/shared/child-runtime-config.js +44 -0
- package/src/runs/shared/child-session.d.ts +178 -0
- package/src/runs/shared/child-session.js +726 -0
- package/src/runs/shared/child-tool-plan.d.ts +101 -0
- package/src/runs/shared/child-tool-plan.js +430 -0
- package/src/runs/shared/claude-code-adapter.d.ts +80 -0
- package/src/runs/shared/claude-code-adapter.js +255 -0
- package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
- package/src/runs/shared/codex-exec-adapter.js +127 -0
- package/src/runs/shared/context-mode.d.ts +12 -0
- package/src/runs/shared/context-mode.js +38 -0
- package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
- package/src/runs/shared/cursor-agent-adapter.js +99 -0
- package/src/runs/shared/dynamic-fanout.d.ts +49 -0
- package/src/runs/shared/dynamic-fanout.js +273 -0
- package/src/runs/shared/effective-system-prompt.d.ts +17 -0
- package/src/runs/shared/effective-system-prompt.js +23 -0
- package/src/runs/shared/extension-bindings.d.ts +25 -0
- package/src/runs/shared/extension-bindings.js +96 -0
- package/src/runs/shared/external-cli-contract.d.ts +29 -0
- package/src/runs/shared/external-cli-contract.js +145 -0
- package/src/runs/shared/external-cli-preflight.d.ts +41 -0
- package/src/runs/shared/external-cli-preflight.js +159 -0
- package/src/runs/shared/external-cli-runner.d.ts +65 -0
- package/src/runs/shared/external-cli-runner.js +425 -0
- package/src/runs/shared/external-job-bridge.d.ts +24 -0
- package/src/runs/shared/external-job-bridge.js +486 -0
- package/src/runs/shared/external-job-runner.d.ts +44 -0
- package/src/runs/shared/external-job-runner.js +352 -0
- package/src/runs/shared/fast-mode-extension.d.ts +3 -0
- package/src/runs/shared/fast-mode-extension.js +8 -0
- package/src/runs/shared/fork-placed-env.d.ts +4 -0
- package/src/runs/shared/fork-placed-env.js +13 -0
- package/src/runs/shared/git-environment.d.ts +2 -0
- package/src/runs/shared/git-environment.js +27 -0
- package/src/runs/shared/herdr-connection.d.ts +79 -0
- package/src/runs/shared/herdr-connection.js +269 -0
- package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
- package/src/runs/shared/herdr-external-adapters.js +404 -0
- package/src/runs/shared/herdr-machine.d.ts +59 -0
- package/src/runs/shared/herdr-machine.js +294 -0
- package/src/runs/shared/herdr-pane-host.d.ts +88 -0
- package/src/runs/shared/herdr-pane-host.js +155 -0
- package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
- package/src/runs/shared/herdr-pi-protocol.js +57 -0
- package/src/runs/shared/herdr-placed-run.d.ts +144 -0
- package/src/runs/shared/herdr-placed-run.js +380 -0
- package/src/runs/shared/host-step-status.d.ts +33 -0
- package/src/runs/shared/host-step-status.js +244 -0
- package/src/runs/shared/lane-metadata.d.ts +23 -0
- package/src/runs/shared/lane-metadata.js +126 -0
- package/src/runs/shared/launch-cwd.d.ts +1 -0
- package/src/runs/shared/launch-cwd.js +16 -0
- package/src/runs/shared/local-machine-access.d.ts +5 -0
- package/src/runs/shared/local-machine-access.js +28 -0
- package/src/runs/shared/long-running-guard.d.ts +34 -0
- package/src/runs/shared/long-running-guard.js +256 -0
- package/src/runs/shared/mcp-config-sources.d.ts +33 -0
- package/src/runs/shared/mcp-config-sources.js +418 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
- package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
- package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
- package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
- package/src/runs/shared/model-resolution-diagnostic.js +116 -0
- package/src/runs/shared/model-resolution.d.ts +109 -0
- package/src/runs/shared/model-resolution.js +411 -0
- package/src/runs/shared/model-scope.d.ts +68 -0
- package/src/runs/shared/model-scope.js +171 -0
- package/src/runs/shared/mutation-evidence.d.ts +18 -0
- package/src/runs/shared/mutation-evidence.js +198 -0
- package/src/runs/shared/nested-events.d.ts +135 -0
- package/src/runs/shared/nested-events.js +1090 -0
- package/src/runs/shared/nested-path.d.ts +8 -0
- package/src/runs/shared/nested-path.js +34 -0
- package/src/runs/shared/nested-render.d.ts +20 -0
- package/src/runs/shared/nested-render.js +115 -0
- package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
- package/src/runs/shared/orca-progress-tabs.js +503 -0
- package/src/runs/shared/parallel-handoff.d.ts +78 -0
- package/src/runs/shared/parallel-handoff.js +783 -0
- package/src/runs/shared/parallel-utils.d.ts +177 -0
- package/src/runs/shared/parallel-utils.js +125 -0
- package/src/runs/shared/partial-output.d.ts +24 -0
- package/src/runs/shared/partial-output.js +35 -0
- package/src/runs/shared/permissions.d.ts +12 -0
- package/src/runs/shared/permissions.js +92 -0
- package/src/runs/shared/pi-spawn.d.ts +31 -0
- package/src/runs/shared/pi-spawn.js +211 -0
- package/src/runs/shared/placed-run-owner.d.ts +49 -0
- package/src/runs/shared/placed-run-owner.js +93 -0
- package/src/runs/shared/placement-host.d.ts +99 -0
- package/src/runs/shared/placement-host.js +157 -0
- package/src/runs/shared/process-signal.d.ts +15 -0
- package/src/runs/shared/process-signal.js +21 -0
- package/src/runs/shared/profile-extensions.d.ts +21 -0
- package/src/runs/shared/profile-extensions.js +122 -0
- package/src/runs/shared/profile-launch-env.d.ts +26 -0
- package/src/runs/shared/profile-launch-env.js +90 -0
- package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
- package/src/runs/shared/readonly-drain-observation.js +50 -0
- package/src/runs/shared/rex-machine.d.ts +25 -0
- package/src/runs/shared/rex-machine.js +83 -0
- package/src/runs/shared/rex-pane-host.d.ts +62 -0
- package/src/runs/shared/rex-pane-host.js +327 -0
- package/src/runs/shared/run-fanout-budget.d.ts +14 -0
- package/src/runs/shared/run-fanout-budget.js +258 -0
- package/src/runs/shared/run-ownership.d.ts +3 -0
- package/src/runs/shared/run-ownership.js +8 -0
- package/src/runs/shared/runner-launcher.d.ts +11 -0
- package/src/runs/shared/runner-launcher.js +24 -0
- package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
- package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
- package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
- package/src/runs/shared/sandbox-profile-guard.js +106 -0
- package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
- package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
- package/src/runs/shared/session-lease.d.ts +69 -0
- package/src/runs/shared/session-lease.js +250 -0
- package/src/runs/shared/single-output.d.ts +90 -0
- package/src/runs/shared/single-output.js +349 -0
- package/src/runs/shared/spawn-budget.d.ts +20 -0
- package/src/runs/shared/spawn-budget.js +93 -0
- package/src/runs/shared/structured-output.d.ts +66 -0
- package/src/runs/shared/structured-output.js +483 -0
- package/src/runs/shared/subagent-control.d.ts +50 -0
- package/src/runs/shared/subagent-control.js +247 -0
- package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
- package/src/runs/shared/subagent-prompt-runtime.js +776 -0
- package/src/runs/shared/tool-availability.d.ts +16 -0
- package/src/runs/shared/tool-availability.js +29 -0
- package/src/runs/shared/tool-budget.d.ts +21 -0
- package/src/runs/shared/tool-budget.js +78 -0
- package/src/runs/shared/tool-timeout.d.ts +31 -0
- package/src/runs/shared/tool-timeout.js +73 -0
- package/src/runs/shared/usage-budget.d.ts +7 -0
- package/src/runs/shared/usage-budget.js +74 -0
- package/src/runs/shared/usage-reconciliation.d.ts +8 -0
- package/src/runs/shared/usage-reconciliation.js +71 -0
- package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
- package/src/runs/shared/workflow-async-child-guidance.js +17 -0
- package/src/runs/shared/workflow-graph.d.ts +31 -0
- package/src/runs/shared/workflow-graph.js +221 -0
- package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
- package/src/runs/shared/worktree-cleanup-apply.js +178 -0
- package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
- package/src/runs/shared/worktree-cleanup-plan.js +803 -0
- package/src/runs/shared/worktree-lock.d.ts +5 -0
- package/src/runs/shared/worktree-lock.js +40 -0
- package/src/runs/shared/worktree-setup-command.d.ts +38 -0
- package/src/runs/shared/worktree-setup-command.js +200 -0
- package/src/runs/shared/worktree.d.ts +181 -0
- package/src/runs/shared/worktree.js +1346 -0
- package/src/shared/accessible-dir.d.ts +11 -0
- package/src/shared/accessible-dir.js +39 -0
- package/src/shared/agent-stream-options.d.ts +5 -0
- package/src/shared/agent-stream-options.js +3 -0
- package/src/shared/artifacts.d.ts +22 -0
- package/src/shared/artifacts.js +272 -0
- package/src/shared/atomic-json.d.ts +19 -0
- package/src/shared/atomic-json.js +61 -0
- package/src/shared/capacity-resilient-json.d.ts +26 -0
- package/src/shared/capacity-resilient-json.js +86 -0
- package/src/shared/child-cache-retention.d.ts +29 -0
- package/src/shared/child-cache-retention.js +40 -0
- package/src/shared/child-session-name.d.ts +8 -0
- package/src/shared/child-session-name.js +40 -0
- package/src/shared/child-transcript.d.ts +37 -0
- package/src/shared/child-transcript.js +225 -0
- package/src/shared/completion-owner.d.ts +7 -0
- package/src/shared/completion-owner.js +13 -0
- package/src/shared/disabled-features.d.ts +93 -0
- package/src/shared/disabled-features.js +120 -0
- package/src/shared/display-text.d.ts +5 -0
- package/src/shared/display-text.js +154 -0
- package/src/shared/edit-distance.d.ts +4 -0
- package/src/shared/edit-distance.js +32 -0
- package/src/shared/extension-context.d.ts +21 -0
- package/src/shared/extension-context.js +39 -0
- package/src/shared/file-coalescer.d.ts +11 -0
- package/src/shared/file-coalescer.js +34 -0
- package/src/shared/file-lease.d.ts +10 -0
- package/src/shared/file-lease.js +106 -0
- package/src/shared/file-system-retry.d.ts +31 -0
- package/src/shared/file-system-retry.js +84 -0
- package/src/shared/fork-context.d.ts +64 -0
- package/src/shared/fork-context.js +185 -0
- package/src/shared/fork-session-cwd.d.ts +2 -0
- package/src/shared/fork-session-cwd.js +23 -0
- package/src/shared/formatters.d.ts +35 -0
- package/src/shared/formatters.js +137 -0
- package/src/shared/jsonl-writer.d.ts +20 -0
- package/src/shared/jsonl-writer.js +67 -0
- package/src/shared/launch-contract.d.ts +65 -0
- package/src/shared/launch-contract.js +145 -0
- package/src/shared/model-info.d.ts +55 -0
- package/src/shared/model-info.js +103 -0
- package/src/shared/model-response-aliases.d.ts +1 -0
- package/src/shared/model-response-aliases.js +15 -0
- package/src/shared/node-executable.d.ts +1 -0
- package/src/shared/node-executable.js +20 -0
- package/src/shared/opencode-session-headers.d.ts +12 -0
- package/src/shared/opencode-session-headers.js +26 -0
- package/src/shared/package-version.d.ts +2 -0
- package/src/shared/package-version.js +14 -0
- package/src/shared/parent-wake.d.ts +26 -0
- package/src/shared/parent-wake.js +68 -0
- package/src/shared/permission-profile.d.ts +26 -0
- package/src/shared/permission-profile.js +49 -0
- package/src/shared/prompt-resources.d.ts +5 -0
- package/src/shared/prompt-resources.js +10 -0
- package/src/shared/provider-diagnostics.d.ts +9 -0
- package/src/shared/provider-diagnostics.js +75 -0
- package/src/shared/pruned-fork.d.ts +34 -0
- package/src/shared/pruned-fork.js +434 -0
- package/src/shared/required-child-extensions.d.ts +34 -0
- package/src/shared/required-child-extensions.js +105 -0
- package/src/shared/runtime-module-path.d.ts +10 -0
- package/src/shared/runtime-module-path.js +16 -0
- package/src/shared/sandbox-profile.d.ts +12 -0
- package/src/shared/sandbox-profile.js +35 -0
- package/src/shared/session-file-trust.d.ts +1 -0
- package/src/shared/session-file-trust.js +20 -0
- package/src/shared/session-identity.d.ts +8 -0
- package/src/shared/session-identity.js +32 -0
- package/src/shared/session-succession.d.ts +4 -0
- package/src/shared/session-succession.js +24 -0
- package/src/shared/session-tokens.d.ts +2 -0
- package/src/shared/session-tokens.js +58 -0
- package/src/shared/settings-file-lease.d.ts +4 -0
- package/src/shared/settings-file-lease.js +38 -0
- package/src/shared/settings.d.ts +146 -0
- package/src/shared/settings.js +247 -0
- package/src/shared/shortcuts.d.ts +1 -0
- package/src/shared/shortcuts.js +17 -0
- package/src/shared/status-format.d.ts +9 -0
- package/src/shared/status-format.js +60 -0
- package/src/shared/thinking-ceiling.d.ts +13 -0
- package/src/shared/thinking-ceiling.js +37 -0
- package/src/shared/types.d.ts +2840 -0
- package/src/shared/types.js +276 -0
- package/src/shared/utf8.d.ts +5 -0
- package/src/shared/utf8.js +12 -0
- package/src/shared/utils.d.ts +83 -0
- package/src/shared/utils.js +612 -0
- package/src/shared/watch-strategy.d.ts +2 -0
- package/src/shared/watch-strategy.js +5 -0
- package/src/shared/workflow-child-permit.d.ts +58 -0
- package/src/shared/workflow-child-permit.js +159 -0
- package/src/slash/delegation-adapters.d.ts +154 -0
- package/src/slash/delegation-adapters.js +316 -0
- package/src/slash/delegation-json.d.ts +10 -0
- package/src/slash/delegation-json.js +117 -0
- package/src/slash/delegation-request.d.ts +12 -0
- package/src/slash/delegation-request.js +174 -0
- package/src/slash/prompt-template-bridge.d.ts +29 -0
- package/src/slash/prompt-template-bridge.js +399 -0
- package/src/slash/prompt-workflows.d.ts +21 -0
- package/src/slash/prompt-workflows.js +274 -0
- package/src/slash/selector.d.ts +47 -0
- package/src/slash/selector.js +117 -0
- package/src/slash/slash-bridge.d.ts +30 -0
- package/src/slash/slash-bridge.js +132 -0
- package/src/slash/slash-commands.d.ts +10 -0
- package/src/slash/slash-commands.js +1059 -0
- package/src/slash/slash-live-state.d.ts +21 -0
- package/src/slash/slash-live-state.js +263 -0
- package/src/slash/subagent-cost.d.ts +29 -0
- package/src/slash/subagent-cost.js +310 -0
- package/src/slash/subagents-admin.d.ts +3 -0
- package/src/slash/subagents-admin.js +481 -0
- package/src/tui/fleet-layout.d.ts +20 -0
- package/src/tui/fleet-layout.js +17 -0
- package/src/tui/fleet-native-transcript.d.ts +53 -0
- package/src/tui/fleet-native-transcript.js +339 -0
- package/src/tui/fleet-status.d.ts +92 -0
- package/src/tui/fleet-status.js +1132 -0
- package/src/tui/fleet-transcript.d.ts +64 -0
- package/src/tui/fleet-transcript.js +544 -0
- package/src/tui/fleet-viewport.d.ts +12 -0
- package/src/tui/fleet-viewport.js +35 -0
- package/src/tui/fleet.d.ts +196 -0
- package/src/tui/fleet.js +1588 -0
- package/src/tui/mouse-events.d.ts +21 -0
- package/src/tui/mouse-events.js +26 -0
- package/src/tui/render-helpers.d.ts +23 -0
- package/src/tui/render-helpers.js +100 -0
- package/src/tui/render.d.ts +66 -0
- package/src/tui/render.js +3707 -0
- package/src/tui/running-tone.d.ts +10 -0
- package/src/tui/running-tone.js +22 -0
- package/src/tui/subagent-messages.d.ts +22 -0
- package/src/tui/subagent-messages.js +270 -0
- package/src/ui-silent-marker.d.ts +20 -0
- package/src/ui-silent-marker.js +25 -0
- package/src/watchdog/change-signature.d.ts +7 -0
- package/src/watchdog/change-signature.js +243 -0
- package/src/watchdog/child-status.d.ts +53 -0
- package/src/watchdog/child-status.js +187 -0
- package/src/watchdog/diff-tool.d.ts +25 -0
- package/src/watchdog/diff-tool.js +104 -0
- package/src/watchdog/emission-guard.d.ts +36 -0
- package/src/watchdog/emission-guard.js +97 -0
- package/src/watchdog/guidance.d.ts +3 -0
- package/src/watchdog/guidance.js +19 -0
- package/src/watchdog/lsp-diagnostics.d.ts +17 -0
- package/src/watchdog/lsp-diagnostics.js +489 -0
- package/src/watchdog/model-selection.d.ts +24 -0
- package/src/watchdog/model-selection.js +167 -0
- package/src/watchdog/permission-arbiter.d.ts +20 -0
- package/src/watchdog/permission-arbiter.js +135 -0
- package/src/watchdog/register-child.d.ts +13 -0
- package/src/watchdog/register-child.js +128 -0
- package/src/watchdog/register-main.d.ts +11 -0
- package/src/watchdog/register-main.js +400 -0
- package/src/watchdog/render.d.ts +3 -0
- package/src/watchdog/render.js +33 -0
- package/src/watchdog/review.d.ts +36 -0
- package/src/watchdog/review.js +319 -0
- package/src/watchdog/rules.d.ts +21 -0
- package/src/watchdog/rules.js +58 -0
- package/src/watchdog/runtime.d.ts +195 -0
- package/src/watchdog/runtime.js +864 -0
- package/src/watchdog/scope.d.ts +14 -0
- package/src/watchdog/scope.js +44 -0
- package/src/watchdog/settings.d.ts +29 -0
- package/src/watchdog/settings.js +480 -0
- package/src/watchdog/tool-actions.d.ts +17 -0
- package/src/watchdog/tool-actions.js +150 -0
- package/src/watchdog/turn-delta.d.ts +15 -0
- package/src/watchdog/turn-delta.js +188 -0
- package/src/watchdog/types.d.ts +141 -0
- package/src/watchdog/types.js +27 -0
- package/src/watchdog/warning-format.d.ts +7 -0
- package/src/watchdog/warning-format.js +59 -0
- package/src/workflows/chat-progress.d.ts +37 -0
- package/src/workflows/chat-progress.js +129 -0
- package/src/workflows/host-command.d.ts +30 -0
- package/src/workflows/host-command.js +227 -0
- package/src/workflows/scripted-workflow.d.ts +204 -0
- package/src/workflows/scripted-workflow.js +1673 -0
- package/src/workflows/structured-workflow-scripts.d.ts +10 -0
- package/src/workflows/structured-workflow-scripts.js +179 -0
- package/src/workflows/workflow-auto-resume.d.ts +32 -0
- package/src/workflows/workflow-auto-resume.js +102 -0
- package/src/workflows/workflow-checklist.d.ts +127 -0
- package/src/workflows/workflow-checklist.js +314 -0
- package/src/workflows/workflow-child-summary.d.ts +24 -0
- package/src/workflows/workflow-child-summary.js +195 -0
- package/src/workflows/workflow-launch-record.d.ts +27 -0
- package/src/workflows/workflow-launch-record.js +48 -0
- package/src/workflows/workflow-preflight.d.ts +58 -0
- package/src/workflows/workflow-preflight.js +288 -0
- package/src/workflows/workflow-receipt.d.ts +34 -0
- package/src/workflows/workflow-receipt.js +454 -0
- package/src/workflows/workflow-resources.d.ts +55 -0
- package/src/workflows/workflow-resources.js +271 -0
- package/src/workflows/workflow-resume-claim.d.ts +82 -0
- package/src/workflows/workflow-resume-claim.js +210 -0
- package/src/workflows/workflow-resume.d.ts +56 -0
- package/src/workflows/workflow-resume.js +106 -0
- package/src/workflows/workflow-reuse.d.ts +61 -0
- package/src/workflows/workflow-reuse.js +186 -0
- package/src/workflows/workflow-revival.d.ts +33 -0
- package/src/workflows/workflow-revival.js +111 -0
- package/src/workflows/workflow-settlement.d.ts +84 -0
- package/src/workflows/workflow-settlement.js +203 -0
- package/src/workflows/workflow-stop-cause.d.ts +6 -0
- package/src/workflows/workflow-stop-cause.js +8 -0
- package/workflow-script-worker.cjs +1342 -0
- package/index.ts +0 -18
- package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
- package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
- package/skills/pi-subagents/references/execution-controls.md +0 -561
- package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
- package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
- package/skills/pi-subagents/references/review-and-validation.md +0 -73
- package/src/agents/advertised-agent-prompt.ts +0 -82
- package/src/agents/agent-eject.ts +0 -339
- package/src/agents/agent-management.ts +0 -1442
- package/src/agents/agent-memory.ts +0 -341
- package/src/agents/agent-refinements.ts +0 -624
- package/src/agents/agent-scope.ts +0 -10
- package/src/agents/agent-selection.ts +0 -25
- package/src/agents/agent-serializer.ts +0 -195
- package/src/agents/agents.ts +0 -3169
- package/src/agents/builtin-names.ts +0 -16
- package/src/agents/chain-serializer.ts +0 -285
- package/src/agents/frontmatter.ts +0 -153
- package/src/agents/global-npm-root.ts +0 -58
- package/src/agents/identity.ts +0 -30
- package/src/agents/proactive-skills.ts +0 -197
- package/src/agents/runtime-agent-events.ts +0 -70
- package/src/agents/runtime-agent-registry.ts +0 -457
- package/src/agents/runtime-discovery.ts +0 -39
- package/src/agents/skills.ts +0 -787
- package/src/api/agent-management.ts +0 -9
- package/src/api/agents.ts +0 -19
- package/src/api/background-work.ts +0 -206
- package/src/api/capability-ceiling.ts +0 -16
- package/src/api/child-tool-plan.ts +0 -5
- package/src/api/control-channel.ts +0 -4
- package/src/api/delegation.ts +0 -131
- package/src/api/external-job-provider.ts +0 -195
- package/src/api/external-runs.ts +0 -282
- package/src/api/inspectors.ts +0 -27
- package/src/api/intercom-bridge.ts +0 -3
- package/src/api/preflight.ts +0 -641
- package/src/api/project-panes.ts +0 -32
- package/src/api/required-child-extensions.ts +0 -6
- package/src/api/shared-types.ts +0 -29
- package/src/api/supervisor-routing.ts +0 -196
- package/src/api/workflow-resources.ts +0 -6
- package/src/extension/config.ts +0 -262
- package/src/extension/context-injection.ts +0 -123
- package/src/extension/control-notices.ts +0 -53
- package/src/extension/declaration-pinning.ts +0 -164
- package/src/extension/doctor.ts +0 -284
- package/src/extension/fanout-child.ts +0 -282
- package/src/extension/herdr-pi-bridge.ts +0 -166
- package/src/extension/index.ts +0 -1212
- package/src/extension/public-execution.ts +0 -262
- package/src/extension/reply-workflow-script.ts +0 -67
- package/src/extension/rpc.ts +0 -881
- package/src/extension/schemas.ts +0 -337
- package/src/extension/steering-notices.ts +0 -35
- package/src/extension/subagent-guide.ts +0 -127
- package/src/extension/subagent-options.ts +0 -47
- package/src/extension/tool-activation.ts +0 -147
- package/src/extension/tool-description.ts +0 -193
- package/src/extension/tool-result.ts +0 -19
- package/src/extension/upgrade-notice.ts +0 -40
- package/src/inspectors/actions.ts +0 -174
- package/src/inspectors/ghostty/actions.ts +0 -74
- package/src/inspectors/ghostty/plugin.ts +0 -29
- package/src/inspectors/herdr/actions.ts +0 -155
- package/src/inspectors/herdr/client.ts +0 -130
- package/src/inspectors/herdr/focus.ts +0 -55
- package/src/inspectors/herdr/plugin.ts +0 -20
- package/src/inspectors/herdr/project-panes.ts +0 -733
- package/src/inspectors/inspector-runner.ts +0 -153
- package/src/inspectors/plugins.ts +0 -76
- package/src/inspectors/session-roots-codec.ts +0 -31
- package/src/inspectors/shell-command.ts +0 -16
- package/src/inspectors/tmux/actions.ts +0 -204
- package/src/inspectors/tmux/client.ts +0 -85
- package/src/inspectors/tmux/plugin.ts +0 -21
- package/src/inspectors/types.ts +0 -51
- package/src/integrations/herdr-status.ts +0 -385
- package/src/integrations/pi-web-session-liveness.ts +0 -73
- package/src/integrations/program-status.ts +0 -215
- package/src/intercom/fork-supervisor-routing.ts +0 -533
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1066
- package/src/intercom/result-intercom.ts +0 -433
- package/src/intercom/supervisor-ui.ts +0 -72
- package/src/missions/actions.ts +0 -433
- package/src/missions/goal-driver.ts +0 -177
- package/src/missions/lifecycle.ts +0 -367
- package/src/missions/store.ts +0 -613
- package/src/missions/types.ts +0 -190
- package/src/missions/workflow-state.ts +0 -281
- package/src/policy/authority.ts +0 -50
- package/src/profiles/profiles.ts +0 -674
- package/src/runs/background/active-async-capacity.ts +0 -548
- package/src/runs/background/active-run-index.ts +0 -155
- package/src/runs/background/async-execution.ts +0 -2479
- package/src/runs/background/async-job-tracker.ts +0 -869
- package/src/runs/background/async-resume.ts +0 -686
- package/src/runs/background/async-retention.ts +0 -953
- package/src/runs/background/async-status-snapshot.ts +0 -46
- package/src/runs/background/async-status.ts +0 -787
- package/src/runs/background/auto-drain.ts +0 -92
- package/src/runs/background/await-async-run.ts +0 -83
- package/src/runs/background/binary-bootstrap.ts +0 -67
- package/src/runs/background/calendar-schedule.ts +0 -90
- package/src/runs/background/chain-append.ts +0 -321
- package/src/runs/background/chain-root-attachment.ts +0 -263
- package/src/runs/background/completion-batcher.ts +0 -168
- package/src/runs/background/completion-dedupe.ts +0 -58
- package/src/runs/background/completion-replay.ts +0 -287
- package/src/runs/background/control-channel.ts +0 -659
- package/src/runs/background/fleet-view.ts +0 -692
- package/src/runs/background/index-segment.ts +0 -59
- package/src/runs/background/inspect-rpc.ts +0 -443
- package/src/runs/background/notify.ts +0 -1083
- package/src/runs/background/owned-process-tree.ts +0 -131
- package/src/runs/background/parallel-groups.ts +0 -45
- package/src/runs/background/pid-namespace.ts +0 -18
- package/src/runs/background/process-terminal-candidate.ts +0 -98
- package/src/runs/background/process-terminal.ts +0 -231
- package/src/runs/background/result-delivery-ownership.ts +0 -45
- package/src/runs/background/result-files.ts +0 -634
- package/src/runs/background/result-watcher.ts +0 -842
- package/src/runs/background/resume-guidance.ts +0 -56
- package/src/runs/background/retained-children.ts +0 -136
- package/src/runs/background/retained-nested-route-tracker.ts +0 -96
- package/src/runs/background/run-child-session.ts +0 -725
- package/src/runs/background/run-id-query.ts +0 -7
- package/src/runs/background/run-id-resolver.ts +0 -183
- package/src/runs/background/run-status.ts +0 -803
- package/src/runs/background/runner-aliases.ts +0 -183
- package/src/runs/background/runner-child-launch.ts +0 -96
- package/src/runs/background/runner-child-sessions.ts +0 -32
- package/src/runs/background/runner-http-dispatcher.ts +0 -122
- package/src/runs/background/runner-startup-failure.ts +0 -56
- package/src/runs/background/scheduled-runs.ts +0 -1222
- package/src/runs/background/stale-run-reconciler.ts +0 -463
- package/src/runs/background/steering.ts +0 -260
- package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
- package/src/runs/background/subagent-runner.ts +0 -5251
- package/src/runs/background/subagent-wait.ts +0 -895
- package/src/runs/background/terminal-run-index.ts +0 -183
- package/src/runs/background/top-level-async.ts +0 -14
- package/src/runs/background/wait-completions.ts +0 -262
- package/src/runs/background/wait-config.ts +0 -50
- package/src/runs/background/wait-subscriptions.ts +0 -354
- package/src/runs/background/wait-tool.ts +0 -57
- package/src/runs/background/workflow-terminal-proof.ts +0 -85
- package/src/runs/foreground/async-dismiss-action.ts +0 -86
- package/src/runs/foreground/async-steering-action.ts +0 -276
- package/src/runs/foreground/async-stop-action.ts +0 -216
- package/src/runs/foreground/command-action.ts +0 -41
- package/src/runs/foreground/execution.ts +0 -2315
- package/src/runs/foreground/foreground-control.ts +0 -157
- package/src/runs/foreground/foreground-history.ts +0 -164
- package/src/runs/foreground/prompt-audit.ts +0 -172
- package/src/runs/foreground/subagent-executor.ts +0 -8252
- package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
- package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
- package/src/runs/shared/abort-recovery.ts +0 -119
- package/src/runs/shared/acceptance.ts +0 -1664
- package/src/runs/shared/agent-contract.ts +0 -38
- package/src/runs/shared/async-status-projection.ts +0 -664
- package/src/runs/shared/background-process-options.ts +0 -9
- package/src/runs/shared/capability-ceiling.ts +0 -214
- package/src/runs/shared/chain-outputs.ts +0 -116
- package/src/runs/shared/child-commands.ts +0 -229
- package/src/runs/shared/child-hooks.ts +0 -175
- package/src/runs/shared/child-identity.ts +0 -62
- package/src/runs/shared/child-launch-plan.ts +0 -163
- package/src/runs/shared/child-launch.ts +0 -389
- package/src/runs/shared/child-lifecycle.ts +0 -28
- package/src/runs/shared/child-runtime-config.ts +0 -136
- package/src/runs/shared/child-session.ts +0 -699
- package/src/runs/shared/child-tool-plan.ts +0 -599
- package/src/runs/shared/claude-code-adapter.ts +0 -288
- package/src/runs/shared/codex-exec-adapter.ts +0 -129
- package/src/runs/shared/context-mode.ts +0 -44
- package/src/runs/shared/cursor-agent-adapter.ts +0 -114
- package/src/runs/shared/dynamic-fanout.ts +0 -297
- package/src/runs/shared/effective-system-prompt.ts +0 -33
- package/src/runs/shared/extension-bindings.ts +0 -103
- package/src/runs/shared/external-cli-contract.ts +0 -177
- package/src/runs/shared/external-cli-preflight.ts +0 -190
- package/src/runs/shared/external-cli-runner.ts +0 -437
- package/src/runs/shared/external-job-bridge.ts +0 -514
- package/src/runs/shared/external-job-runner.ts +0 -389
- package/src/runs/shared/fast-mode-extension.ts +0 -10
- package/src/runs/shared/fork-command-result.ts +0 -10
- package/src/runs/shared/git-environment.ts +0 -29
- package/src/runs/shared/herdr-connection.ts +0 -134
- package/src/runs/shared/herdr-external-adapters.ts +0 -169
- package/src/runs/shared/herdr-machine.ts +0 -279
- package/src/runs/shared/herdr-pi-protocol.ts +0 -59
- package/src/runs/shared/herdr-placed-run.ts +0 -264
- package/src/runs/shared/host-step-status.ts +0 -231
- package/src/runs/shared/lane-metadata.ts +0 -126
- package/src/runs/shared/launch-cwd.ts +0 -16
- package/src/runs/shared/long-running-guard.ts +0 -221
- package/src/runs/shared/mcp-config-sources.ts +0 -426
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
- package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
- package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
- package/src/runs/shared/model-resolution.ts +0 -503
- package/src/runs/shared/model-scope.ts +0 -224
- package/src/runs/shared/mutation-evidence.ts +0 -199
- package/src/runs/shared/nested-events.ts +0 -1125
- package/src/runs/shared/nested-path.ts +0 -38
- package/src/runs/shared/nested-render.ts +0 -127
- package/src/runs/shared/orca-progress-tabs.ts +0 -511
- package/src/runs/shared/parallel-handoff.ts +0 -789
- package/src/runs/shared/parallel-utils.ts +0 -292
- package/src/runs/shared/partial-output.ts +0 -48
- package/src/runs/shared/permissions.ts +0 -86
- package/src/runs/shared/pi-spawn.ts +0 -205
- package/src/runs/shared/process-signal.ts +0 -35
- package/src/runs/shared/profile-extensions.ts +0 -134
- package/src/runs/shared/profile-launch-env.ts +0 -121
- package/src/runs/shared/readonly-drain-observation.ts +0 -42
- package/src/runs/shared/run-fanout-budget.ts +0 -267
- package/src/runs/shared/run-history.ts +0 -288
- package/src/runs/shared/runner-launcher.ts +0 -25
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
- package/src/runs/shared/sandbox-profile-guard.ts +0 -119
- package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
- package/src/runs/shared/session-lease.ts +0 -293
- package/src/runs/shared/single-output.ts +0 -366
- package/src/runs/shared/spawn-budget.ts +0 -128
- package/src/runs/shared/structured-output.ts +0 -463
- package/src/runs/shared/subagent-control.ts +0 -295
- package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
- package/src/runs/shared/tool-availability.ts +0 -37
- package/src/runs/shared/tool-budget.ts +0 -87
- package/src/runs/shared/tool-timeout.ts +0 -93
- package/src/runs/shared/usage-budget.ts +0 -65
- package/src/runs/shared/usage-reconciliation.ts +0 -73
- package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
- package/src/runs/shared/workflow-graph.ts +0 -225
- package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
- package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
- package/src/runs/shared/worktree-lock.ts +0 -29
- package/src/runs/shared/worktree-setup-command.ts +0 -213
- package/src/runs/shared/worktree.ts +0 -1554
- package/src/shared/accessible-dir.ts +0 -47
- package/src/shared/agent-stream-options.ts +0 -5
- package/src/shared/artifacts.ts +0 -281
- package/src/shared/atomic-json.ts +0 -85
- package/src/shared/capacity-resilient-json.ts +0 -102
- package/src/shared/child-cache-retention.ts +0 -43
- package/src/shared/child-session-name.ts +0 -48
- package/src/shared/child-transcript.ts +0 -264
- package/src/shared/completion-owner.ts +0 -14
- package/src/shared/disabled-features.ts +0 -123
- package/src/shared/display-text.ts +0 -150
- package/src/shared/edit-distance.ts +0 -33
- package/src/shared/extension-context.ts +0 -37
- package/src/shared/file-coalescer.ts +0 -49
- package/src/shared/file-lease.ts +0 -74
- package/src/shared/file-system-retry.ts +0 -95
- package/src/shared/fork-context.ts +0 -243
- package/src/shared/fork-session-cwd.ts +0 -27
- package/src/shared/formatters.ts +0 -142
- package/src/shared/jsonl-writer.ts +0 -92
- package/src/shared/launch-contract.ts +0 -206
- package/src/shared/model-info.ts +0 -132
- package/src/shared/model-response-aliases.ts +0 -13
- package/src/shared/node-executable.ts +0 -21
- package/src/shared/opencode-session-headers.ts +0 -30
- package/src/shared/package-version.ts +0 -17
- package/src/shared/parent-wake.ts +0 -79
- package/src/shared/permission-profile.ts +0 -56
- package/src/shared/prompt-resources.ts +0 -11
- package/src/shared/pruned-fork.ts +0 -469
- package/src/shared/required-child-extensions.ts +0 -115
- package/src/shared/runtime-module-path.ts +0 -19
- package/src/shared/sandbox-profile.ts +0 -37
- package/src/shared/session-file-trust.ts +0 -19
- package/src/shared/session-identity.ts +0 -10
- package/src/shared/session-tokens.ts +0 -55
- package/src/shared/settings-file-lease.ts +0 -36
- package/src/shared/settings.ts +0 -412
- package/src/shared/shortcuts.ts +0 -13
- package/src/shared/status-format.ts +0 -55
- package/src/shared/thinking-ceiling.ts +0 -46
- package/src/shared/types.ts +0 -3105
- package/src/shared/utf8.ts +0 -11
- package/src/shared/utils.ts +0 -610
- package/src/shared/watch-strategy.ts +0 -12
- package/src/shared/workflow-child-permit.ts +0 -212
- package/src/slash/delegation-adapters.ts +0 -452
- package/src/slash/delegation-json.ts +0 -108
- package/src/slash/delegation-request.ts +0 -176
- package/src/slash/prompt-template-bridge.ts +0 -435
- package/src/slash/prompt-workflows.ts +0 -298
- package/src/slash/selector.ts +0 -147
- package/src/slash/slash-bridge.ts +0 -192
- package/src/slash/slash-commands.ts +0 -1096
- package/src/slash/slash-live-state.ts +0 -310
- package/src/slash/subagent-cost.ts +0 -317
- package/src/slash/subagents-admin.ts +0 -489
- package/src/tui/fleet-native-transcript.ts +0 -424
- package/src/tui/fleet-status.ts +0 -1139
- package/src/tui/fleet-transcript.ts +0 -591
- package/src/tui/fleet.ts +0 -1618
- package/src/tui/mouse-events.ts +0 -42
- package/src/tui/render-helpers.ts +0 -111
- package/src/tui/render.ts +0 -3824
- package/src/tui/running-tone.ts +0 -28
- package/src/tui/subagent-messages.ts +0 -305
- package/src/ui-silent-marker.ts +0 -32
- package/src/watchdog/change-signature.ts +0 -260
- package/src/watchdog/child-status.ts +0 -225
- package/src/watchdog/diff-tool.ts +0 -112
- package/src/watchdog/emission-guard.ts +0 -125
- package/src/watchdog/guidance.ts +0 -20
- package/src/watchdog/lsp-diagnostics.ts +0 -538
- package/src/watchdog/model-selection.ts +0 -187
- package/src/watchdog/permission-arbiter.ts +0 -154
- package/src/watchdog/register-child.ts +0 -136
- package/src/watchdog/register-main.ts +0 -425
- package/src/watchdog/render.ts +0 -31
- package/src/watchdog/review.ts +0 -362
- package/src/watchdog/rules.ts +0 -70
- package/src/watchdog/runtime.ts +0 -927
- package/src/watchdog/scope.ts +0 -51
- package/src/watchdog/settings.ts +0 -520
- package/src/watchdog/tool-actions.ts +0 -156
- package/src/watchdog/turn-delta.ts +0 -190
- package/src/watchdog/types.ts +0 -186
- package/src/watchdog/warning-format.ts +0 -72
- package/src/workflows/chat-progress.ts +0 -152
- package/src/workflows/host-command.ts +0 -235
- package/src/workflows/scripted-workflow.ts +0 -2733
- package/src/workflows/structured-workflow-scripts.ts +0 -177
- package/src/workflows/workflow-checklist.ts +0 -442
- package/src/workflows/workflow-child-summary.ts +0 -172
- package/src/workflows/workflow-preflight.ts +0 -297
- package/src/workflows/workflow-receipt.ts +0 -390
- package/src/workflows/workflow-resources.ts +0 -275
- package/src/workflows/workflow-reuse.ts +0 -120
- package/src/workflows/workflow-revival.ts +0 -123
- package/src/workflows/workflow-settlement.ts +0 -252
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Keep opaque index keys below common filesystem component limits.
|
|
3
|
+
*
|
|
4
|
+
* Portable short values retain the historical URI-encoded representation.
|
|
5
|
+
* Oversized or non-portable values use a deterministic digest so callers can
|
|
6
|
+
* resolve the same index without persisting a separate lookup table.
|
|
7
|
+
*
|
|
8
|
+
* Encoded backslashes and trailing file extensions are not portable. Pi session
|
|
9
|
+
* ids are often the full session `.jsonl` path. On Windows, `readdir` of a
|
|
10
|
+
* directory whose name ends in `.jsonl` or contains `%5C` can fail with EPERM.
|
|
11
|
+
*/
|
|
12
|
+
export declare const MAX_INDEX_SEGMENT_BYTES = 255;
|
|
13
|
+
export declare function hashedSegment(value: string): string;
|
|
14
|
+
export declare function encodeIndexSegment(value: string, maxBytes?: number): string;
|
|
15
|
+
/** Current write key first, then the pre-hash URI-encoded key when it still fits. */
|
|
16
|
+
export declare function indexSegmentAliases(value: string, maxBytes?: number): string[];
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
/**
|
|
3
|
+
* Keep opaque index keys below common filesystem component limits.
|
|
4
|
+
*
|
|
5
|
+
* Portable short values retain the historical URI-encoded representation.
|
|
6
|
+
* Oversized or non-portable values use a deterministic digest so callers can
|
|
7
|
+
* resolve the same index without persisting a separate lookup table.
|
|
8
|
+
*
|
|
9
|
+
* Encoded backslashes and trailing file extensions are not portable. Pi session
|
|
10
|
+
* ids are often the full session `.jsonl` path. On Windows, `readdir` of a
|
|
11
|
+
* directory whose name ends in `.jsonl` or contains `%5C` can fail with EPERM.
|
|
12
|
+
*/
|
|
13
|
+
export const MAX_INDEX_SEGMENT_BYTES = 255;
|
|
14
|
+
const HASHED_INDEX_SEGMENT_PREFIX = "~sha256-";
|
|
15
|
+
const WINDOWS_RESERVED_NAME = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i;
|
|
16
|
+
export function hashedSegment(value) {
|
|
17
|
+
return `${HASHED_INDEX_SEGMENT_PREFIX}${createHash("sha256").update(value).digest("hex")}`;
|
|
18
|
+
}
|
|
19
|
+
function isPortableSegment(value) {
|
|
20
|
+
return value.length > 0
|
|
21
|
+
&& value !== "."
|
|
22
|
+
&& value !== ".."
|
|
23
|
+
&& !value.endsWith(".")
|
|
24
|
+
&& !WINDOWS_RESERVED_NAME.test(value)
|
|
25
|
+
&& !/%5C/i.test(value)
|
|
26
|
+
&& !/\.[A-Za-z][A-Za-z0-9]{0,7}$/.test(value);
|
|
27
|
+
}
|
|
28
|
+
export function encodeIndexSegment(value, maxBytes = MAX_INDEX_SEGMENT_BYTES) {
|
|
29
|
+
let encoded;
|
|
30
|
+
try {
|
|
31
|
+
encoded = encodeURIComponent(value);
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return hashedSegment(value);
|
|
35
|
+
}
|
|
36
|
+
if (Buffer.byteLength(encoded, "utf-8") <= maxBytes && isPortableSegment(encoded))
|
|
37
|
+
return encoded;
|
|
38
|
+
return hashedSegment(value);
|
|
39
|
+
}
|
|
40
|
+
function historicallyReadableSegment(value, maxBytes) {
|
|
41
|
+
try {
|
|
42
|
+
const encoded = encodeURIComponent(value);
|
|
43
|
+
if (encoded.length === 0 || encoded === "." || encoded === ".." || encoded.endsWith(".") || WINDOWS_RESERVED_NAME.test(encoded))
|
|
44
|
+
return undefined;
|
|
45
|
+
if (Buffer.byteLength(encoded, "utf-8") > maxBytes)
|
|
46
|
+
return undefined;
|
|
47
|
+
return encoded;
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
return undefined;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** Current write key first, then the pre-hash URI-encoded key when it still fits. */
|
|
54
|
+
export function indexSegmentAliases(value, maxBytes = MAX_INDEX_SEGMENT_BYTES) {
|
|
55
|
+
const current = encodeIndexSegment(value, maxBytes);
|
|
56
|
+
const historical = historicallyReadableSegment(value, maxBytes);
|
|
57
|
+
return historical && historical !== current ? [current, historical] : [current];
|
|
58
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { type AsyncStatus, type SubagentState } from "../../shared/types.ts";
|
|
2
|
+
/** On-demand inspection of current-session async children. Re-reads canonical artifacts after the same reconciliation as status; nothing is persisted or broadcast. */
|
|
3
|
+
export declare const INSPECT_REPLY_KIND = "pi-subagents.inspect-reply";
|
|
4
|
+
export declare const INSPECT_REPLY_VERSION = 1;
|
|
5
|
+
export declare const INSPECT_WIDGET_KEY = "subagent-inspect";
|
|
6
|
+
export declare const INSPECT_WIDGET_PREFIX = "PI_SUBAGENT_INSPECT_JSON:";
|
|
7
|
+
export type InspectErrorCode = "invalid_request" | "not_found" | "foreign_session" | "stale" | "no_active_session" | "internal";
|
|
8
|
+
export interface InspectRequest {
|
|
9
|
+
requestId: string;
|
|
10
|
+
asyncId: string;
|
|
11
|
+
childId?: string;
|
|
12
|
+
lines?: number;
|
|
13
|
+
}
|
|
14
|
+
export interface InspectReplyMessage {
|
|
15
|
+
role: string;
|
|
16
|
+
kind: "text" | "toolCall" | "toolResult";
|
|
17
|
+
text: string;
|
|
18
|
+
name?: string;
|
|
19
|
+
isError?: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface InspectReply {
|
|
22
|
+
kind: typeof INSPECT_REPLY_KIND;
|
|
23
|
+
version: typeof INSPECT_REPLY_VERSION;
|
|
24
|
+
requestId: string;
|
|
25
|
+
/** Canonical run id of the inspected node. Absent on error replies that
|
|
26
|
+
* could not resolve a run. */
|
|
27
|
+
asyncId?: string;
|
|
28
|
+
childId?: string;
|
|
29
|
+
status?: AsyncStatus["state"];
|
|
30
|
+
label?: string;
|
|
31
|
+
task?: string;
|
|
32
|
+
messages?: InspectReplyMessage[];
|
|
33
|
+
finalOutput?: string;
|
|
34
|
+
/** Provider and model of the inspected child's latest own assistant reply, as Pi recorded them. */
|
|
35
|
+
resolvedModel?: {
|
|
36
|
+
provider: string;
|
|
37
|
+
model: string;
|
|
38
|
+
};
|
|
39
|
+
truncated?: {
|
|
40
|
+
task: boolean;
|
|
41
|
+
messages: number;
|
|
42
|
+
finalOutput: boolean;
|
|
43
|
+
};
|
|
44
|
+
error?: {
|
|
45
|
+
code: InspectErrorCode;
|
|
46
|
+
message: string;
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
export declare const MAX_SERIALIZED_BYTES: number;
|
|
50
|
+
export interface InspectDeps {
|
|
51
|
+
state?: SubagentState;
|
|
52
|
+
asyncDirRoot?: string;
|
|
53
|
+
resultsDir?: string;
|
|
54
|
+
kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
|
|
55
|
+
now?: () => number;
|
|
56
|
+
}
|
|
57
|
+
export declare function parseInspectRequest(args: string): {
|
|
58
|
+
request?: InspectRequest;
|
|
59
|
+
error?: string;
|
|
60
|
+
};
|
|
61
|
+
export declare function buildInspectReply(request: InspectRequest, deps?: InspectDeps): InspectReply;
|
|
62
|
+
export declare function encodeInspectReply(reply: InspectReply): string[];
|
|
63
|
+
/** Parse the slash-command args and always return a correlated inspect reply. */
|
|
64
|
+
export declare function handleInspectRpcArgs(args: string, deps?: InspectDeps): InspectReply;
|
|
@@ -0,0 +1,422 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import { sanitizeDisplayText, truncateDisplayText } from "../../shared/display-text.js";
|
|
3
|
+
import { decodeUtf8Tail } from "../../shared/utf8.js";
|
|
4
|
+
import { DIRS } from "../../shared/types.js";
|
|
5
|
+
import { readStatus } from "../../shared/utils.js";
|
|
6
|
+
import { readSessionMessagesTail } from "./fleet-view.js";
|
|
7
|
+
import { completionReplayPath, readCompletionArchive, readCompletionReplay } from "./completion-replay.js";
|
|
8
|
+
import { resultPayloadPathForSessionRun } from "./result-files.js";
|
|
9
|
+
import { resolveSubagentRunId } from "./run-id-resolver.js";
|
|
10
|
+
import { reconcileAsyncRun, reconcileNestedAsyncDescendants } from "./stale-run-reconciler.js";
|
|
11
|
+
import { ownsRun } from "../shared/run-ownership.js";
|
|
12
|
+
/** On-demand inspection of current-session async children. Re-reads canonical artifacts after the same reconciliation as status; nothing is persisted or broadcast. */
|
|
13
|
+
export const INSPECT_REPLY_KIND = "pi-subagents.inspect-reply";
|
|
14
|
+
export const INSPECT_REPLY_VERSION = 1;
|
|
15
|
+
export const INSPECT_WIDGET_KEY = "subagent-inspect";
|
|
16
|
+
export const INSPECT_WIDGET_PREFIX = "PI_SUBAGENT_INSPECT_JSON:";
|
|
17
|
+
const REQUEST_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
|
|
18
|
+
const MAX_ID_LENGTH = 256;
|
|
19
|
+
const MAX_LABEL_LENGTH = 160;
|
|
20
|
+
const MAX_TASK_LENGTH = 2_000;
|
|
21
|
+
const MAX_FINAL_OUTPUT_LENGTH = 8_000;
|
|
22
|
+
const MAX_MESSAGE_TEXT_LENGTH = 1_000;
|
|
23
|
+
const DEFAULT_MESSAGE_LINES = 100;
|
|
24
|
+
const MAX_MESSAGE_LINES = 200;
|
|
25
|
+
const FAILED_OUTPUT_ARTIFACT_PREFIX = "Subagent run failed before producing output.\n\nError:\n";
|
|
26
|
+
export const MAX_SERIALIZED_BYTES = 64 * 1024;
|
|
27
|
+
function isRecord(value) {
|
|
28
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
29
|
+
}
|
|
30
|
+
function publicText(value, maxLength) {
|
|
31
|
+
if (typeof value !== "string")
|
|
32
|
+
return undefined;
|
|
33
|
+
const normalized = sanitizeDisplayText(value.slice(0, maxLength * 4));
|
|
34
|
+
return normalized ? truncateDisplayText(normalized, maxLength) : undefined;
|
|
35
|
+
}
|
|
36
|
+
/** Bound long-form content without flattening it: task/finalOutput/message text
|
|
37
|
+
* must keep newlines readable. Only the two unicode line separators are
|
|
38
|
+
* normalized, since JSON.stringify does not escape them and hosts split the
|
|
39
|
+
* widget payload on line boundaries. */
|
|
40
|
+
function boundContent(value, maxLength) {
|
|
41
|
+
const normalized = value.replace(/[\u2028\u2029]/g, "\n");
|
|
42
|
+
return truncateDisplayText(normalized, maxLength);
|
|
43
|
+
}
|
|
44
|
+
function errorReply(request, code, message) {
|
|
45
|
+
return {
|
|
46
|
+
kind: INSPECT_REPLY_KIND,
|
|
47
|
+
version: INSPECT_REPLY_VERSION,
|
|
48
|
+
requestId: typeof request.requestId === "string" && REQUEST_ID_PATTERN.test(request.requestId) ? request.requestId : "invalid",
|
|
49
|
+
...(typeof request.asyncId === "string" ? { asyncId: truncateDisplayText(request.asyncId, MAX_ID_LENGTH) } : {}),
|
|
50
|
+
...(typeof request.childId === "string" ? { childId: truncateDisplayText(request.childId, MAX_ID_LENGTH) } : {}),
|
|
51
|
+
error: { code, message },
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
export function parseInspectRequest(args) {
|
|
55
|
+
const tokens = args.trim().split(/\s+/).filter(Boolean);
|
|
56
|
+
const positional = [];
|
|
57
|
+
let lines;
|
|
58
|
+
for (let index = 0; index < tokens.length; index++) {
|
|
59
|
+
const token = tokens[index];
|
|
60
|
+
if (token === "--lines") {
|
|
61
|
+
const value = tokens[++index];
|
|
62
|
+
const parsed = value === undefined ? NaN : Number.parseInt(value, 10);
|
|
63
|
+
if (!Number.isFinite(parsed))
|
|
64
|
+
return { error: "--lines requires an integer value." };
|
|
65
|
+
lines = parsed;
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
if (token.startsWith("--"))
|
|
69
|
+
return { error: `Unknown flag: ${token}. Supported: --lines N.` };
|
|
70
|
+
positional.push(token);
|
|
71
|
+
}
|
|
72
|
+
const [requestId, asyncId, childId, ...extra] = positional;
|
|
73
|
+
if (!requestId || !REQUEST_ID_PATTERN.test(requestId)) {
|
|
74
|
+
return { error: "requestId must match [A-Za-z0-9_-]{1,64}." };
|
|
75
|
+
}
|
|
76
|
+
if (!asyncId)
|
|
77
|
+
return { error: "Usage: /subagents-inspect-rpc <requestId> <asyncId> [childId] [--lines N]." };
|
|
78
|
+
if (asyncId.length > MAX_ID_LENGTH || (childId !== undefined && childId.length > MAX_ID_LENGTH)) {
|
|
79
|
+
return { error: "asyncId/childId exceed the maximum length." };
|
|
80
|
+
}
|
|
81
|
+
if (extra.length > 0)
|
|
82
|
+
return { error: "Too many positional arguments. Usage: /subagents-inspect-rpc <requestId> <asyncId> [childId] [--lines N]." };
|
|
83
|
+
if (lines !== undefined && (lines < 1 || !Number.isSafeInteger(lines)))
|
|
84
|
+
return { error: "--lines must be a positive integer." };
|
|
85
|
+
return { request: { requestId, asyncId, childId, lines } };
|
|
86
|
+
}
|
|
87
|
+
function findChildNode(status, asyncDir, childId) {
|
|
88
|
+
const steps = status.steps ?? [];
|
|
89
|
+
for (let index = 0; index < steps.length; index++) {
|
|
90
|
+
const step = steps[index];
|
|
91
|
+
const ids = [step.workflowKey, step.runId, `step:${index}`];
|
|
92
|
+
if (ids.includes(childId)) {
|
|
93
|
+
return { asyncDir, status, stepIndex: index, label: step.label ?? step.agent };
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
const findNested = (children) => {
|
|
97
|
+
for (const child of children ?? []) {
|
|
98
|
+
if (child.id === childId)
|
|
99
|
+
return child;
|
|
100
|
+
const deeper = findNested(child.children);
|
|
101
|
+
if (deeper)
|
|
102
|
+
return deeper;
|
|
103
|
+
}
|
|
104
|
+
return undefined;
|
|
105
|
+
};
|
|
106
|
+
for (const step of steps) {
|
|
107
|
+
const nested = findNested(step.children);
|
|
108
|
+
if (nested) {
|
|
109
|
+
if (!nested.asyncDir)
|
|
110
|
+
return { error: `Child '${childId}' has no async directory to inspect.` };
|
|
111
|
+
const childStatus = readStatus(nested.asyncDir);
|
|
112
|
+
if (!childStatus)
|
|
113
|
+
return { error: `Child '${childId}' status is unavailable.` };
|
|
114
|
+
return { asyncDir: nested.asyncDir, status: childStatus, label: nested.agent ?? nested.agents?.join(", ") };
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
return { error: `Child '${childId}' was not found under async run '${status.runId}'.` };
|
|
118
|
+
}
|
|
119
|
+
function resultOutput(data, stepIndex) {
|
|
120
|
+
if (!isRecord(data))
|
|
121
|
+
throw new Error("Async result payload must be an object.");
|
|
122
|
+
if (data.results !== undefined && !Array.isArray(data.results))
|
|
123
|
+
throw new Error("Async result payload results must be an array.");
|
|
124
|
+
if (data.summary !== undefined && typeof data.summary !== "string")
|
|
125
|
+
throw new Error("Async result payload summary must be a string.");
|
|
126
|
+
const results = data.results;
|
|
127
|
+
if (stepIndex !== undefined && results) {
|
|
128
|
+
const stepResult = results[stepIndex];
|
|
129
|
+
if (stepResult === undefined)
|
|
130
|
+
return {};
|
|
131
|
+
if (!isRecord(stepResult))
|
|
132
|
+
throw new Error("Async result payload step result must be an object.");
|
|
133
|
+
if (stepResult.output !== undefined && typeof stepResult.output !== "string")
|
|
134
|
+
throw new Error("Async result payload step output must be a string.");
|
|
135
|
+
if (stepResult.error !== undefined && typeof stepResult.error !== "string")
|
|
136
|
+
throw new Error("Async result payload step error must be a string.");
|
|
137
|
+
return {
|
|
138
|
+
...(typeof stepResult.output === "string" ? { output: stepResult.output } : {}),
|
|
139
|
+
...(typeof stepResult.error === "string" ? { errorText: stepResult.error } : {}),
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
if (typeof data.summary === "string")
|
|
143
|
+
return { output: data.summary };
|
|
144
|
+
if (results?.length === 1) {
|
|
145
|
+
const result = results[0];
|
|
146
|
+
if (!isRecord(result))
|
|
147
|
+
throw new Error("Async result payload result must be an object.");
|
|
148
|
+
if (result.output !== undefined && typeof result.output !== "string")
|
|
149
|
+
throw new Error("Async result payload output must be a string.");
|
|
150
|
+
if (typeof result.output === "string")
|
|
151
|
+
return { output: result.output };
|
|
152
|
+
}
|
|
153
|
+
return {};
|
|
154
|
+
}
|
|
155
|
+
function readOutputArtifact(outputPath) {
|
|
156
|
+
const file = fs.openSync(outputPath, "r");
|
|
157
|
+
try {
|
|
158
|
+
const prefix = Buffer.allocUnsafe(Buffer.byteLength(FAILED_OUTPUT_ARTIFACT_PREFIX, "utf-8"));
|
|
159
|
+
const prefixBytes = fs.readSync(file, prefix, 0, prefix.length, 0);
|
|
160
|
+
const failedOutput = prefix.subarray(0, prefixBytes).toString("utf-8") === FAILED_OUTPUT_ARTIFACT_PREFIX;
|
|
161
|
+
const size = fs.fstatSync(file).size;
|
|
162
|
+
const length = Math.min(size, MAX_FINAL_OUTPUT_LENGTH * 4);
|
|
163
|
+
const buffer = Buffer.allocUnsafe(length);
|
|
164
|
+
const bytesRead = fs.readSync(file, buffer, 0, length, size - length);
|
|
165
|
+
let text = decodeUtf8Tail(buffer.subarray(0, bytesRead));
|
|
166
|
+
if (!failedOutput)
|
|
167
|
+
return { output: text };
|
|
168
|
+
const metadata = text.lastIndexOf("\nMetadata: ");
|
|
169
|
+
if (metadata >= 0 && !text.slice(metadata + 1).includes("\n"))
|
|
170
|
+
text = text.slice(0, metadata);
|
|
171
|
+
const transcript = text.lastIndexOf("\n\nTranscript: ");
|
|
172
|
+
if (transcript >= 0 && !text.slice(transcript + 2).includes("\n"))
|
|
173
|
+
text = text.slice(0, transcript);
|
|
174
|
+
return { errorText: text.startsWith(FAILED_OUTPUT_ARTIFACT_PREFIX) ? text.slice(FAILED_OUTPUT_ARTIFACT_PREFIX.length) : text };
|
|
175
|
+
}
|
|
176
|
+
finally {
|
|
177
|
+
fs.closeSync(file);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
function readSessionBackedOutput(sessionPath, trustedRoots, trustedSessionFileRoot) {
|
|
181
|
+
if (trustedRoots.length === 0 && !trustedSessionFileRoot)
|
|
182
|
+
return {};
|
|
183
|
+
// The archive retains the child's session file as its output record. The
|
|
184
|
+
// final answer is the terminal assistant message's text — all text parts
|
|
185
|
+
// of that one session record, not just the last part.
|
|
186
|
+
const tail = readSessionMessagesTail(sessionPath, MAX_MESSAGE_LINES, trustedRoots, [sessionPath], trustedSessionFileRoot);
|
|
187
|
+
const last = tail.messages.findLast((message) => message.role === "assistant" && message.kind === "text");
|
|
188
|
+
if (!last)
|
|
189
|
+
return {};
|
|
190
|
+
const parts = tail.messages.filter((message) => message.recordIndex === last.recordIndex && message.kind === "text");
|
|
191
|
+
return { output: parts.map((part) => part.text).join("\n") };
|
|
192
|
+
}
|
|
193
|
+
function readResultOutput(resultsDir, sessionId, runId, stepIndex, trustedRoots, stepAgent, now, trustedSessionFileRoot) {
|
|
194
|
+
const resultPath = resultPayloadPathForSessionRun(resultsDir, sessionId, runId);
|
|
195
|
+
if (resultPath)
|
|
196
|
+
return resultOutput(JSON.parse(fs.readFileSync(resultPath, "utf-8")), stepIndex);
|
|
197
|
+
// Read the raw record first: readCompletionReplay best-effort deletes
|
|
198
|
+
// invalid or expired records, so reading after it cannot distinguish
|
|
199
|
+
// "never existed" from "failed validation".
|
|
200
|
+
const replayPath = completionReplayPath(resultsDir, runId);
|
|
201
|
+
let rawReplay;
|
|
202
|
+
try {
|
|
203
|
+
rawReplay = JSON.parse(fs.readFileSync(replayPath, "utf-8"));
|
|
204
|
+
}
|
|
205
|
+
catch (error) {
|
|
206
|
+
if (error.code !== "ENOENT")
|
|
207
|
+
throw error;
|
|
208
|
+
}
|
|
209
|
+
const nowMs = now();
|
|
210
|
+
const replay = readCompletionReplay(resultsDir, runId, { sessionId, now: nowMs });
|
|
211
|
+
if (!replay) {
|
|
212
|
+
// readCompletionReplay also returns undefined for absent, expired, foreign,
|
|
213
|
+
// and unknown-version records. A current-version, unexpired record for this
|
|
214
|
+
// run and session that still failed validation is an inspection failure,
|
|
215
|
+
// not a child without output — surface it instead of replying success with
|
|
216
|
+
// no finalOutput.
|
|
217
|
+
if (isRecord(rawReplay) && rawReplay.version === 1 && rawReplay.runId === runId
|
|
218
|
+
&& rawReplay.sessionId === sessionId
|
|
219
|
+
&& typeof rawReplay.expiresAt === "number" && rawReplay.expiresAt > nowMs) {
|
|
220
|
+
throw new Error("Completion replay record failed validation.");
|
|
221
|
+
}
|
|
222
|
+
return {};
|
|
223
|
+
}
|
|
224
|
+
const archive = readCompletionArchive(replay.archivePath);
|
|
225
|
+
// Run-level inspection must not attribute a child's output to the run in a
|
|
226
|
+
// multi-child archive. Current child entries carry resultIndex and agent;
|
|
227
|
+
// run-level entries carry neither. Legacy archives (written before
|
|
228
|
+
// resultIndex existed) have child entries with agent but no resultIndex,
|
|
229
|
+
// so child reads fall back to a unique agent name. Duplicate legacy agent
|
|
230
|
+
// names fail closed. A single-child archive is the one exception: the run's
|
|
231
|
+
// output IS that child's output, including a legacy agent-tagged entry.
|
|
232
|
+
const childEntries = archive?.entries.filter((entry) => entry.resultIndex !== undefined || entry.agent !== undefined) ?? [];
|
|
233
|
+
const singleChild = childEntries.length === 1;
|
|
234
|
+
const uniqueLegacyAgent = (agent) => agent !== undefined
|
|
235
|
+
&& archive?.entries.filter((entry) => entry.resultIndex === undefined && entry.agent === agent).length === 1;
|
|
236
|
+
const matches = (entry) => {
|
|
237
|
+
if (stepIndex !== undefined) {
|
|
238
|
+
if (entry.resultIndex !== undefined)
|
|
239
|
+
return entry.resultIndex === stepIndex;
|
|
240
|
+
return uniqueLegacyAgent(stepAgent) && entry.agent === stepAgent;
|
|
241
|
+
}
|
|
242
|
+
if (singleChild)
|
|
243
|
+
return entry.resultIndex !== undefined || entry.agent !== undefined;
|
|
244
|
+
return entry.resultIndex === undefined && entry.agent === undefined;
|
|
245
|
+
};
|
|
246
|
+
const artifact = archive?.entries.find((entry) => entry.source === "output-artifact" && matches(entry));
|
|
247
|
+
const artifactPath = artifact?.source === "output-artifact" ? artifact.path : undefined;
|
|
248
|
+
if (artifactPath)
|
|
249
|
+
return readOutputArtifact(artifactPath);
|
|
250
|
+
const sessionEntry = archive?.entries.find((entry) => entry.source === "session" && matches(entry));
|
|
251
|
+
const sessionPath = sessionEntry?.source === "session" ? sessionEntry.path : undefined;
|
|
252
|
+
if (sessionPath)
|
|
253
|
+
return readSessionBackedOutput(sessionPath, trustedRoots, trustedSessionFileRoot);
|
|
254
|
+
const output = archive?.entries.find((entry) => entry.source === "result-tail" && matches(entry))?.text;
|
|
255
|
+
return output ? { output } : {};
|
|
256
|
+
}
|
|
257
|
+
function workflowChildRunModel(runId, workflowRunId, currentSessionId, asyncDirRoot, resultsDir, state) {
|
|
258
|
+
const resolved = resolveSubagentRunId(runId, { asyncDirRoot, resultsDir, state });
|
|
259
|
+
if (resolved?.kind !== "async" || resolved.id !== runId || !resolved.location.asyncDir)
|
|
260
|
+
return undefined;
|
|
261
|
+
const child = readStatus(resolved.location.asyncDir);
|
|
262
|
+
if (!child || child.runId !== runId || child.parentWorkflowRunId !== workflowRunId || child.mode !== "single" || !ownsRun(currentSessionId, child.sessionId))
|
|
263
|
+
return undefined;
|
|
264
|
+
return child.steps?.[0]?.resolvedModel;
|
|
265
|
+
}
|
|
266
|
+
function toReplyMessage(message) {
|
|
267
|
+
return {
|
|
268
|
+
role: truncateDisplayText(sanitizeDisplayText(message.role), 32),
|
|
269
|
+
kind: message.kind,
|
|
270
|
+
text: boundContent(message.text, MAX_MESSAGE_TEXT_LENGTH),
|
|
271
|
+
...(message.name ? { name: truncateDisplayText(sanitizeDisplayText(message.name), 96) } : {}),
|
|
272
|
+
...(message.isError === true ? { isError: true } : {}),
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
/** Fit the reply under MAX_SERIALIZED_BYTES: drop oldest messages first, then
|
|
276
|
+
* shrink finalOutput, then task. The envelope always survives. */
|
|
277
|
+
function enforceByteBudget(reply) {
|
|
278
|
+
const truncated = reply.truncated ?? { task: false, messages: 0, finalOutput: false };
|
|
279
|
+
const sized = () => Buffer.byteLength(JSON.stringify(reply), "utf-8");
|
|
280
|
+
while (reply.messages && reply.messages.length > 0 && sized() > MAX_SERIALIZED_BYTES) {
|
|
281
|
+
reply.messages.shift();
|
|
282
|
+
truncated.messages += 1;
|
|
283
|
+
}
|
|
284
|
+
if (sized() > MAX_SERIALIZED_BYTES && reply.finalOutput) {
|
|
285
|
+
reply.finalOutput = truncateDisplayText(reply.finalOutput, Math.max(0, reply.finalOutput.length - (sized() - MAX_SERIALIZED_BYTES) - 256));
|
|
286
|
+
truncated.finalOutput = true;
|
|
287
|
+
}
|
|
288
|
+
if (sized() > MAX_SERIALIZED_BYTES && reply.task) {
|
|
289
|
+
reply.task = truncateDisplayText(reply.task, Math.max(0, reply.task.length - (sized() - MAX_SERIALIZED_BYTES) - 256));
|
|
290
|
+
truncated.task = true;
|
|
291
|
+
}
|
|
292
|
+
if (truncated.task || truncated.messages > 0 || truncated.finalOutput)
|
|
293
|
+
reply.truncated = truncated;
|
|
294
|
+
return reply;
|
|
295
|
+
}
|
|
296
|
+
export function buildInspectReply(request, deps = {}) {
|
|
297
|
+
const asyncDirRoot = deps.asyncDirRoot ?? DIRS.async;
|
|
298
|
+
const resultsDir = deps.resultsDir ?? DIRS.results;
|
|
299
|
+
const currentSessionId = deps.state?.currentSessionId ?? undefined;
|
|
300
|
+
if (!currentSessionId) {
|
|
301
|
+
return errorReply(request, "no_active_session", "Inspection requires an active session; the request could not be attributed to a session.");
|
|
302
|
+
}
|
|
303
|
+
let resolved;
|
|
304
|
+
try {
|
|
305
|
+
resolved = resolveSubagentRunId(request.asyncId, { asyncDirRoot, resultsDir, state: deps.state });
|
|
306
|
+
}
|
|
307
|
+
catch {
|
|
308
|
+
return errorReply(request, "invalid_request", "The requested async run could not be resolved.");
|
|
309
|
+
}
|
|
310
|
+
if (!resolved || resolved.kind === "foreground") {
|
|
311
|
+
return errorReply(request, "not_found", `Async run '${request.asyncId}' was not found.`);
|
|
312
|
+
}
|
|
313
|
+
try {
|
|
314
|
+
let asyncDir;
|
|
315
|
+
let status;
|
|
316
|
+
if (resolved.kind === "nested") {
|
|
317
|
+
reconcileNestedAsyncDescendants(resolved.match.route, { resultsDir, kill: deps.kill, now: deps.now });
|
|
318
|
+
asyncDir = resolved.match.run.asyncDir ?? "";
|
|
319
|
+
status = asyncDir ? readStatus(asyncDir) : null;
|
|
320
|
+
}
|
|
321
|
+
else {
|
|
322
|
+
if (!resolved.location.asyncDir)
|
|
323
|
+
return errorReply(request, "stale", `Async run '${request.asyncId}' has no remaining artifacts.`);
|
|
324
|
+
asyncDir = resolved.location.asyncDir;
|
|
325
|
+
status = reconcileAsyncRun(asyncDir, { resultsDir, kill: deps.kill, now: deps.now }).status ?? readStatus(asyncDir);
|
|
326
|
+
}
|
|
327
|
+
if (!status)
|
|
328
|
+
return errorReply(request, "stale", `Async run '${request.asyncId}' artifacts are no longer available.`);
|
|
329
|
+
if (!ownsRun(currentSessionId, status.sessionId)) {
|
|
330
|
+
return errorReply(request, "foreign_session", "Inspection is only available for async runs owned by the current session.");
|
|
331
|
+
}
|
|
332
|
+
const node = request.childId === undefined
|
|
333
|
+
? { asyncDir, status }
|
|
334
|
+
: findChildNode(status, asyncDir, request.childId);
|
|
335
|
+
if ("error" in node)
|
|
336
|
+
return errorReply(request, "not_found", node.error);
|
|
337
|
+
if (node.asyncDir !== asyncDir) {
|
|
338
|
+
if (!ownsRun(currentSessionId, node.status.sessionId)) {
|
|
339
|
+
return errorReply(request, "foreign_session", "Inspection is only available for async runs owned by the current session.");
|
|
340
|
+
}
|
|
341
|
+
reconcileAsyncRun(node.asyncDir, { resultsDir, kill: deps.kill, now: deps.now });
|
|
342
|
+
node.status = readStatus(node.asyncDir) ?? node.status;
|
|
343
|
+
}
|
|
344
|
+
const step = node.stepIndex !== undefined ? node.status.steps?.[node.stepIndex] : undefined;
|
|
345
|
+
const lineLimit = Math.max(1, Math.min(MAX_MESSAGE_LINES, Math.trunc(request.lines ?? DEFAULT_MESSAGE_LINES)));
|
|
346
|
+
const sessionFile = step?.sessionFile ?? node.status.sessionFile;
|
|
347
|
+
const trustedRoots = [...new Set([
|
|
348
|
+
...(deps.state?.trustedSessionRoots ?? []),
|
|
349
|
+
...(node.status.sessionRoot ? [node.status.sessionRoot] : []),
|
|
350
|
+
])];
|
|
351
|
+
let messages;
|
|
352
|
+
let task;
|
|
353
|
+
if (sessionFile && (trustedRoots.length > 0 || deps.state?.trustedSessionFileRoot)) {
|
|
354
|
+
const tail = readSessionMessagesTail(sessionFile, lineLimit, trustedRoots, [sessionFile], deps.state?.trustedSessionFileRoot);
|
|
355
|
+
if (tail.messages.length > 0) {
|
|
356
|
+
messages = tail.messages.map(toReplyMessage);
|
|
357
|
+
// The delegated task is the child session's first user message, but
|
|
358
|
+
// only when it is genuinely attributable: fresh-context children
|
|
359
|
+
// (forked sessions begin with inherited parent history) whose
|
|
360
|
+
// session file is fully inside the read window (a truncated tail
|
|
361
|
+
// means the first visible user message may be a steering message).
|
|
362
|
+
if (!tail.truncated && node.status.context !== "fork" && step?.context !== "fork") {
|
|
363
|
+
const firstUser = tail.messages.find((message) => message.role === "user" && message.kind === "text");
|
|
364
|
+
if (firstUser)
|
|
365
|
+
task = firstUser.text;
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
const result = readResultOutput(resultsDir, node.status.sessionId ?? currentSessionId, node.status.runId, node.stepIndex, trustedRoots, step?.agent, deps.now ?? Date.now, deps.state?.trustedSessionFileRoot);
|
|
370
|
+
const failedText = step?.error ?? node.status.error;
|
|
371
|
+
if (result.output === undefined && result.errorText === undefined && failedText !== undefined) {
|
|
372
|
+
return errorReply(request, "internal", "Inspection could not read the async run artifacts.");
|
|
373
|
+
}
|
|
374
|
+
const finalOutputRaw = result.output ?? result.errorText;
|
|
375
|
+
const truncated = { task: false, messages: 0, finalOutput: false };
|
|
376
|
+
const boundedTask = task !== undefined ? boundContent(task, MAX_TASK_LENGTH) : undefined;
|
|
377
|
+
if (task !== undefined && boundedTask !== task)
|
|
378
|
+
truncated.task = true;
|
|
379
|
+
const boundedFinal = finalOutputRaw !== undefined ? boundContent(finalOutputRaw, MAX_FINAL_OUTPUT_LENGTH) : undefined;
|
|
380
|
+
if (finalOutputRaw !== undefined && boundedFinal !== finalOutputRaw)
|
|
381
|
+
truncated.finalOutput = true;
|
|
382
|
+
const label = publicText(node.label ?? step?.label ?? step?.agent ?? node.status.runId, MAX_LABEL_LENGTH);
|
|
383
|
+
// Only the inspected child's own record: a multi-step run-level node has no single child.
|
|
384
|
+
// A background workflow child records its model in its own run's status, linked back by parentWorkflowRunId.
|
|
385
|
+
const recordedModel = (step ?? (node.status.mode === "single" ? node.status.steps?.[0] : undefined))?.resolvedModel
|
|
386
|
+
?? (step?.runId ? workflowChildRunModel(step.runId, node.status.runId, currentSessionId, asyncDirRoot, resultsDir, deps.state) : undefined);
|
|
387
|
+
const resolvedProvider = publicText(recordedModel?.provider, 64);
|
|
388
|
+
const resolvedModelId = publicText(recordedModel?.model, 160);
|
|
389
|
+
const reply = {
|
|
390
|
+
kind: INSPECT_REPLY_KIND,
|
|
391
|
+
version: INSPECT_REPLY_VERSION,
|
|
392
|
+
requestId: request.requestId,
|
|
393
|
+
asyncId: node.status.runId,
|
|
394
|
+
...(request.childId !== undefined ? { childId: request.childId } : {}),
|
|
395
|
+
status: node.status.state,
|
|
396
|
+
...(label ? { label } : {}),
|
|
397
|
+
...(boundedTask !== undefined ? { task: boundedTask } : {}),
|
|
398
|
+
...(messages && messages.length > 0 ? { messages } : {}),
|
|
399
|
+
...(boundedFinal !== undefined ? { finalOutput: boundedFinal } : {}),
|
|
400
|
+
...(resolvedProvider && resolvedModelId ? { resolvedModel: { provider: resolvedProvider, model: resolvedModelId } } : {}),
|
|
401
|
+
...(truncated.task || truncated.finalOutput || truncated.messages > 0 ? { truncated } : {}),
|
|
402
|
+
};
|
|
403
|
+
return enforceByteBudget(reply);
|
|
404
|
+
}
|
|
405
|
+
catch {
|
|
406
|
+
return errorReply(request, "internal", "Inspection could not read the async run artifacts.");
|
|
407
|
+
}
|
|
408
|
+
}
|
|
409
|
+
export function encodeInspectReply(reply) {
|
|
410
|
+
return [`${INSPECT_WIDGET_PREFIX}${JSON.stringify(reply)}`];
|
|
411
|
+
}
|
|
412
|
+
/** Parse the slash-command args and always return a correlated inspect reply. */
|
|
413
|
+
export function handleInspectRpcArgs(args, deps = {}) {
|
|
414
|
+
const parsed = parseInspectRequest(args);
|
|
415
|
+
if (parsed.error || !parsed.request) {
|
|
416
|
+
// Echo a well-formed requestId so the host can correlate the failure.
|
|
417
|
+
const firstToken = args.trim().split(/\s+/)[0];
|
|
418
|
+
const echo = firstToken !== undefined && REQUEST_ID_PATTERN.test(firstToken) ? { requestId: firstToken } : {};
|
|
419
|
+
return errorReply(echo, "invalid_request", parsed.error ?? "Invalid inspect request.");
|
|
420
|
+
}
|
|
421
|
+
return buildInspectReply(parsed.request, deps);
|
|
422
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { ForegroundResumeRun } from "../../shared/types.ts";
|
|
2
|
+
import type { RawDrainStatusObserver } from "../shared/readonly-drain-observation.ts";
|
|
3
|
+
interface InterruptedElsewhereCollector {
|
|
4
|
+
/** Observer for the async statuses session start already reads; keeps foreign ones that may be interrupted. */
|
|
5
|
+
observeStatus: RawDrainStatusObserver;
|
|
6
|
+
/** Receives the foreground records of other sessions that session start already reads. */
|
|
7
|
+
observeForegroundRun: (run: ForegroundResumeRun) => void;
|
|
8
|
+
/** One line per other session that can be reopened and has runs whose Pi is dead. */
|
|
9
|
+
lines: () => string[];
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Collects runs of other sessions in this folder that were cut off because their Pi died, from what
|
|
13
|
+
* session start reads anyway. Read-only: nothing is written to those runs or sessions. The cheap
|
|
14
|
+
* filters run as records arrive; `lines` reads each session file's header once, then probes each
|
|
15
|
+
* candidate's pid once.
|
|
16
|
+
*/
|
|
17
|
+
export declare function createInterruptedElsewhereCollector(input: {
|
|
18
|
+
currentSessionId: string;
|
|
19
|
+
cwd: string;
|
|
20
|
+
now: number;
|
|
21
|
+
}): InterruptedElsewhereCollector;
|
|
22
|
+
export {};
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { resolvePiSessionId } from "../../shared/session-identity.js";
|
|
2
|
+
import { ownerConfirmedDead } from "../foreground/foreground-history.js";
|
|
3
|
+
import { ownerSessionIds } from "../shared/run-ownership.js";
|
|
4
|
+
import { checkRecordedPidLiveness } from "./stale-run-reconciler.js";
|
|
5
|
+
/** Runs interrupted longer ago than this are not pointed to. */
|
|
6
|
+
const INTERRUPTED_ELSEWHERE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
|
|
7
|
+
function interruptedElsewhereLine(reopenId, count) {
|
|
8
|
+
const command = `\`pi --session ${reopenId}\``;
|
|
9
|
+
return count === 1
|
|
10
|
+
? `1 subagent run was interrupted in another session. Reopen it to resume it: ${command}`
|
|
11
|
+
: `${count} subagent runs were interrupted in another session. Reopen it to resume them: ${command}`;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Collects runs of other sessions in this folder that were cut off because their Pi died, from what
|
|
15
|
+
* session start reads anyway. Read-only: nothing is written to those runs or sessions. The cheap
|
|
16
|
+
* filters run as records arrive; `lines` reads each session file's header once, then probes each
|
|
17
|
+
* candidate's pid once.
|
|
18
|
+
*/
|
|
19
|
+
export function createInterruptedElsewhereCollector(input) {
|
|
20
|
+
const ownSessions = ownerSessionIds(input.currentSessionId);
|
|
21
|
+
// sessionId -> runId -> whether its owner is dead; a run seen from both sources counts once.
|
|
22
|
+
const candidates = new Map();
|
|
23
|
+
const recent = (at) => typeof at === "number" && input.now - at <= INTERRUPTED_ELSEWHERE_MAX_AGE_MS;
|
|
24
|
+
const add = (sessionId, runId, ownerDead) => {
|
|
25
|
+
if (ownSessions.has(sessionId))
|
|
26
|
+
return;
|
|
27
|
+
const runs = candidates.get(sessionId) ?? new Map();
|
|
28
|
+
if (!runs.has(runId))
|
|
29
|
+
runs.set(runId, ownerDead);
|
|
30
|
+
candidates.set(sessionId, runs);
|
|
31
|
+
};
|
|
32
|
+
return {
|
|
33
|
+
observeStatus(observed) {
|
|
34
|
+
// The listing passes the status.json values it read.
|
|
35
|
+
const status = observed;
|
|
36
|
+
if (!status || typeof status.sessionId !== "string" || typeof status.runId !== "string" || (status.state !== "running" && status.state !== "queued"))
|
|
37
|
+
return;
|
|
38
|
+
if (status.parentWorkflowRunId !== undefined || status.cwd !== input.cwd || !recent(status.lastUpdate ?? status.startedAt))
|
|
39
|
+
return;
|
|
40
|
+
const { pid, pidNamespaceScope, bootId } = status;
|
|
41
|
+
if (typeof pid !== "number")
|
|
42
|
+
return;
|
|
43
|
+
add(status.sessionId, status.runId, () => checkRecordedPidLiveness({ pid, pidNamespaceScope, bootId }) === "dead");
|
|
44
|
+
},
|
|
45
|
+
observeForegroundRun(run) {
|
|
46
|
+
if (!run.sessionId || run.parentWorkflowRunId !== undefined || run.cwd !== input.cwd || !recent(run.updatedAt))
|
|
47
|
+
return;
|
|
48
|
+
add(run.sessionId, run.runId, () => ownerConfirmedDead(run));
|
|
49
|
+
},
|
|
50
|
+
lines() {
|
|
51
|
+
const lines = [];
|
|
52
|
+
for (const [sessionId, runs] of candidates) {
|
|
53
|
+
// Only a persisted session can be reopened; its id is then its file path, whose header names
|
|
54
|
+
// the id `pi --session` resolves, so the command needs no quoting in any shell.
|
|
55
|
+
const reopenId = resolvePiSessionId(sessionId);
|
|
56
|
+
if (!reopenId)
|
|
57
|
+
continue;
|
|
58
|
+
let interrupted = 0;
|
|
59
|
+
for (const ownerDead of runs.values())
|
|
60
|
+
if (ownerDead())
|
|
61
|
+
interrupted += 1;
|
|
62
|
+
if (interrupted > 0)
|
|
63
|
+
lines.push(interruptedElsewhereLine(reopenId, interrupted));
|
|
64
|
+
}
|
|
65
|
+
return lines;
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
}
|