@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,95 @@
|
|
|
1
|
+
export const SUPERVISOR_RESPONDER_REGISTER_EVENT = "pi-subagents:supervisor-responder-register:v1";
|
|
2
|
+
export const SUPERVISOR_RESPONDER_REGISTER_VERSION = 1;
|
|
3
|
+
const MAX_IDENTITY_LENGTH = 256;
|
|
4
|
+
const IDENTITY_FIELDS = ["sessionId", "requestId", "ownerRunId", "nodeId", "agent"];
|
|
5
|
+
function identityError(field, reason) {
|
|
6
|
+
return `Supervisor responder scope.${field} ${reason}.`;
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Validate a scope strictly: every identity field must be present, non-empty,
|
|
10
|
+
* CR/LF-free and within the delegation identity byte budget. A scope that only
|
|
11
|
+
* names an agent (the "take over every ask of this agent" shape) is refused.
|
|
12
|
+
*/
|
|
13
|
+
export function validateSupervisorResponderScope(scope) {
|
|
14
|
+
if (!scope || typeof scope !== "object" || Array.isArray(scope)) {
|
|
15
|
+
return { error: "Supervisor responder scope must be an object." };
|
|
16
|
+
}
|
|
17
|
+
const candidate = scope;
|
|
18
|
+
for (const field of IDENTITY_FIELDS) {
|
|
19
|
+
const value = candidate[field];
|
|
20
|
+
if (typeof value !== "string")
|
|
21
|
+
return { error: identityError(field, "must be a string") };
|
|
22
|
+
if (!value.trim())
|
|
23
|
+
return { error: identityError(field, "must not be empty") };
|
|
24
|
+
if (value.length > MAX_IDENTITY_LENGTH) {
|
|
25
|
+
return { error: identityError(field, `must be at most ${MAX_IDENTITY_LENGTH} characters`) };
|
|
26
|
+
}
|
|
27
|
+
if (/[\r\n]/.test(value))
|
|
28
|
+
return { error: identityError(field, "must not contain CR or LF") };
|
|
29
|
+
}
|
|
30
|
+
if (candidate.agent === "*") {
|
|
31
|
+
return { error: "Supervisor responder scope.agent must name one agent; wildcard takeover is not supported." };
|
|
32
|
+
}
|
|
33
|
+
return {
|
|
34
|
+
scope: {
|
|
35
|
+
sessionId: candidate.sessionId,
|
|
36
|
+
requestId: candidate.requestId,
|
|
37
|
+
ownerRunId: candidate.ownerRunId,
|
|
38
|
+
nodeId: candidate.nodeId,
|
|
39
|
+
agent: candidate.agent,
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
function errorFrom(value) {
|
|
44
|
+
return value instanceof Error ? value : new Error(String(value));
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Register a responder for one exact delegation attempt through the installed
|
|
48
|
+
* pi-subagents owner in this Pi process. Throws an actionable error when the
|
|
49
|
+
* owner is missing, older than this API, or refuses the registration.
|
|
50
|
+
*/
|
|
51
|
+
export function registerSupervisorResponderViaEvents(input) {
|
|
52
|
+
const validated = validateSupervisorResponderScope(input.scope);
|
|
53
|
+
if ("error" in validated)
|
|
54
|
+
throw new Error(validated.error);
|
|
55
|
+
if (typeof input.respond !== "function") {
|
|
56
|
+
throw new Error("Supervisor responder must be a function: (request) => outcome.");
|
|
57
|
+
}
|
|
58
|
+
if (input.onFailure !== undefined && typeof input.onFailure !== "function") {
|
|
59
|
+
throw new Error("Supervisor responder onFailure must be a function when provided.");
|
|
60
|
+
}
|
|
61
|
+
const request = {
|
|
62
|
+
version: SUPERVISOR_RESPONDER_REGISTER_VERSION,
|
|
63
|
+
scope: validated.scope,
|
|
64
|
+
respond: input.respond,
|
|
65
|
+
...(input.onFailure ? { onFailure: input.onFailure } : {}),
|
|
66
|
+
};
|
|
67
|
+
input.pi.events.emit(SUPERVISOR_RESPONDER_REGISTER_EVENT, request);
|
|
68
|
+
const result = request.result;
|
|
69
|
+
if (result === undefined) {
|
|
70
|
+
throw new Error("pi-subagents is not installed, not ready, or does not support supervisor responder event registration.");
|
|
71
|
+
}
|
|
72
|
+
if (result && typeof result === "object" && !Array.isArray(result)) {
|
|
73
|
+
const candidate = result;
|
|
74
|
+
if (candidate.ok === true &&
|
|
75
|
+
candidate.registration &&
|
|
76
|
+
typeof candidate.registration === "object" &&
|
|
77
|
+
typeof candidate.registration.dispose === "function") {
|
|
78
|
+
const registration = candidate.registration;
|
|
79
|
+
let disposed = false;
|
|
80
|
+
return {
|
|
81
|
+
dispose: () => {
|
|
82
|
+
if (disposed)
|
|
83
|
+
return;
|
|
84
|
+
disposed = true;
|
|
85
|
+
registration.dispose();
|
|
86
|
+
},
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
if (candidate.ok === false && candidate.error instanceof Error)
|
|
90
|
+
throw candidate.error;
|
|
91
|
+
if (candidate.ok === false)
|
|
92
|
+
throw errorFrom(candidate.error);
|
|
93
|
+
}
|
|
94
|
+
throw new Error("pi-subagents returned a malformed supervisor responder registration result.");
|
|
95
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { registerWorkflowResource } from "../workflows/workflow-resources.js";
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { AsyncJobState } from "../shared/types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* The `active_subagents` prompt section: one line per queued or running background run of this session.
|
|
4
|
+
* Pi diffs prompt sections every turn, so it holds only fields that stay the same while a run is unchanged.
|
|
5
|
+
* Task text is not available here: launch events carry it redacted.
|
|
6
|
+
*/
|
|
7
|
+
export declare function buildActiveRunsSection(jobs: Iterable<AsyncJobState>, sessionId: string | null | undefined): string | undefined;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
const MAX_LISTED_RUNS = 10;
|
|
2
|
+
const MAX_LISTED_AGENTS = 3;
|
|
3
|
+
/**
|
|
4
|
+
* The `active_subagents` prompt section: one line per queued or running background run of this session.
|
|
5
|
+
* Pi diffs prompt sections every turn, so it holds only fields that stay the same while a run is unchanged.
|
|
6
|
+
* Task text is not available here: launch events carry it redacted.
|
|
7
|
+
*/
|
|
8
|
+
export function buildActiveRunsSection(jobs, sessionId) {
|
|
9
|
+
const active = [...jobs].filter((job) => (job.status === "queued" || job.status === "running")
|
|
10
|
+
&& (typeof sessionId !== "string" || job.sessionId === sessionId));
|
|
11
|
+
if (active.length === 0)
|
|
12
|
+
return undefined;
|
|
13
|
+
const lines = active.slice(0, MAX_LISTED_RUNS).map((job) => {
|
|
14
|
+
const agents = [...new Set(job.agents ?? [])];
|
|
15
|
+
const agentText = agents.length > MAX_LISTED_AGENTS
|
|
16
|
+
? `${agents.slice(0, MAX_LISTED_AGENTS).join(", ")} +${agents.length - MAX_LISTED_AGENTS}`
|
|
17
|
+
: agents.join(", ") || "subagent";
|
|
18
|
+
const step = job.mode === "chain" && job.currentStep !== undefined && (job.chainStepCount ?? 0) > 1
|
|
19
|
+
? `, step ${job.currentStep + 1}/${job.chainStepCount}`
|
|
20
|
+
: "";
|
|
21
|
+
return `- ${job.asyncId} ${agentText} (${job.mode ?? "single"}${step})`;
|
|
22
|
+
});
|
|
23
|
+
if (active.length > MAX_LISTED_RUNS)
|
|
24
|
+
lines.push(`- +${active.length - MAX_LISTED_RUNS} more`);
|
|
25
|
+
return [
|
|
26
|
+
`Background subagent runs still active in this session (${active.length}). Check them with subagent({ action: "status", id }) before launching duplicate work.`,
|
|
27
|
+
...lines,
|
|
28
|
+
].join("\n");
|
|
29
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type ExtensionConfig } from "../shared/types.ts";
|
|
2
|
+
export declare function resolveScheduledStoreRoot(value: string): string;
|
|
3
|
+
export declare function getConfigPath(): string;
|
|
4
|
+
export declare function saveConfig(config: ExtensionConfig, configPath?: string): void;
|
|
5
|
+
export declare function updateConfig(updater: (config: ExtensionConfig) => ExtensionConfig): ExtensionConfig;
|
|
6
|
+
export declare function resolveAsyncByDefault(config: Pick<ExtensionConfig, "asyncByDefault">): boolean;
|
|
7
|
+
export declare function loadConfig(): ExtensionConfig;
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as os from "node:os";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
import { Key } from "@earendil-works/pi-tui";
|
|
5
|
+
import { FLEET_KEYBINDING_ACTIONS, RUNNER_LAUNCHER_NAME_PATTERN, RUNNER_LAUNCHER_NAME_RULE } from "../shared/types.js";
|
|
6
|
+
import { validateMissionStoreConfig } from "../missions/store.js";
|
|
7
|
+
import { validateAuthorityPolicy } from "../policy/authority.js";
|
|
8
|
+
import { getAgentDir } from "../shared/utils.js";
|
|
9
|
+
import { validatePermissionConfig } from "../runs/shared/permissions.js";
|
|
10
|
+
import { MAX_ABANDONED_SLOT_RELEASE_AFTER_MS, MIN_ABANDONED_SLOT_RELEASE_AFTER_MS } from "../runs/background/active-async-capacity.js";
|
|
11
|
+
import { normalizeWorktreeBranchPrefix } from "../runs/shared/worktree.js";
|
|
12
|
+
import { validateModelResponseAliases } from "../shared/model-response-aliases.js";
|
|
13
|
+
import { validateDisabledFeatures } from "../shared/disabled-features.js";
|
|
14
|
+
// Explicit route identity, worktree, checkpoint, and tool-surface policies must not be silently
|
|
15
|
+
// discarded and replaced by the built-in defaults after validation fails.
|
|
16
|
+
const FAIL_CLOSED_CONFIG_KEYS = ["worktreeProvider", "worktreeBranchPrefix", "modelResponseAliases", "modelExclusions", "checkpointBeforeDeadlineMs", "disabledFeatures", "scheduledRuns", "toolActivation", "authorityPolicy", "permissions", "toolBudget", "runnerLaunchers"];
|
|
17
|
+
const ARTIFACT_DIR_PREFERENCES = new Set(["project", "session", "temp"]);
|
|
18
|
+
const FLEET_KEYBINDING_ACTION_SET = new Set(FLEET_KEYBINDING_ACTIONS);
|
|
19
|
+
const KEY_MODIFIERS = new Set(["ctrl", "shift", "alt", "super"]);
|
|
20
|
+
const BASE_KEY_IDS = new Set([
|
|
21
|
+
..."abcdefghijklmnopqrstuvwxyz0123456789",
|
|
22
|
+
...Object.values(Key).flatMap((value) => typeof value === "string" ? [value.toLowerCase()] : []),
|
|
23
|
+
]);
|
|
24
|
+
class PrunedForkConfigError extends Error {
|
|
25
|
+
}
|
|
26
|
+
function validateForkContextConfig(value) {
|
|
27
|
+
if (value === undefined)
|
|
28
|
+
return;
|
|
29
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
30
|
+
throw new Error("config.forkContext must be a JSON object");
|
|
31
|
+
const config = value;
|
|
32
|
+
if (config.mode !== undefined && config.mode !== "full" && config.mode !== "pruned") {
|
|
33
|
+
throw new Error('config.forkContext.mode must be "full" or "pruned"');
|
|
34
|
+
}
|
|
35
|
+
if (config.model !== undefined && (typeof config.model !== "string" || !config.model.trim())) {
|
|
36
|
+
throw new PrunedForkConfigError("config.forkContext.model must be a non-empty string");
|
|
37
|
+
}
|
|
38
|
+
if (config.mode === "pruned" && config.model === undefined) {
|
|
39
|
+
throw new PrunedForkConfigError('config.forkContext.model is required when config.forkContext.mode is "pruned"');
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
function isValidKeyId(value) {
|
|
43
|
+
if (value !== value.trim())
|
|
44
|
+
return false;
|
|
45
|
+
const parts = value.toLowerCase().split("+");
|
|
46
|
+
const base = parts.pop();
|
|
47
|
+
if (!base || !BASE_KEY_IDS.has(base))
|
|
48
|
+
return false;
|
|
49
|
+
return parts.length <= KEY_MODIFIERS.size
|
|
50
|
+
&& new Set(parts).size === parts.length
|
|
51
|
+
&& parts.every((modifier) => KEY_MODIFIERS.has(modifier));
|
|
52
|
+
}
|
|
53
|
+
export function resolveScheduledStoreRoot(value) {
|
|
54
|
+
const expanded = value.startsWith("~/") ? path.join(os.homedir(), value.slice(2)) : value;
|
|
55
|
+
if (!path.isAbsolute(expanded))
|
|
56
|
+
throw new Error(`config.scheduledRuns.storeRoot must be an absolute path or "~/...", got ${JSON.stringify(value)}`);
|
|
57
|
+
return path.normalize(expanded);
|
|
58
|
+
}
|
|
59
|
+
function validateScheduledRunsConfig(value) {
|
|
60
|
+
if (value === undefined)
|
|
61
|
+
return;
|
|
62
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
63
|
+
throw new Error("config.scheduledRuns must be a JSON object");
|
|
64
|
+
const enabled = value.enabled;
|
|
65
|
+
if (enabled !== undefined && typeof enabled !== "boolean")
|
|
66
|
+
throw new Error("config.scheduledRuns.enabled must be a boolean");
|
|
67
|
+
const storeRoot = value.storeRoot;
|
|
68
|
+
if (storeRoot === undefined)
|
|
69
|
+
return;
|
|
70
|
+
if (typeof storeRoot !== "string" || !storeRoot.trim())
|
|
71
|
+
throw new Error("config.scheduledRuns.storeRoot must be a non-empty string");
|
|
72
|
+
resolveScheduledStoreRoot(storeRoot);
|
|
73
|
+
}
|
|
74
|
+
function validateFleetKeybindingsConfig(value) {
|
|
75
|
+
if (value === undefined)
|
|
76
|
+
return;
|
|
77
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
78
|
+
throw new Error("config.fleetKeybindings must be a JSON object");
|
|
79
|
+
for (const [action, bindings] of Object.entries(value)) {
|
|
80
|
+
if (!FLEET_KEYBINDING_ACTION_SET.has(action))
|
|
81
|
+
throw new Error(`config.fleetKeybindings.${action} is not a supported Fleet action`);
|
|
82
|
+
if (!Array.isArray(bindings) || bindings.length === 0)
|
|
83
|
+
throw new Error(`config.fleetKeybindings.${action} must be a non-empty array of strings`);
|
|
84
|
+
for (const binding of bindings) {
|
|
85
|
+
if (typeof binding !== "string" || !binding.trim())
|
|
86
|
+
throw new Error(`config.fleetKeybindings.${action} entries must be non-empty strings`);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
function validateArtifactConfig(value) {
|
|
91
|
+
if (value === undefined)
|
|
92
|
+
return;
|
|
93
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
94
|
+
throw new Error("config.artifactConfig must be a JSON object");
|
|
95
|
+
const cleanupDays = value.cleanupDays;
|
|
96
|
+
if (cleanupDays !== undefined && (typeof cleanupDays !== "number" || !Number.isInteger(cleanupDays) || cleanupDays < 0)) {
|
|
97
|
+
throw new Error("config.artifactConfig.cleanupDays must be a non-negative integer");
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
function validateCapacityConfig(value) {
|
|
101
|
+
if (value === undefined)
|
|
102
|
+
return;
|
|
103
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
104
|
+
throw new Error("config.capacity must be a JSON object");
|
|
105
|
+
const abandonedSlotReleaseAfterMs = value.abandonedSlotReleaseAfterMs;
|
|
106
|
+
if (abandonedSlotReleaseAfterMs !== undefined
|
|
107
|
+
&& abandonedSlotReleaseAfterMs !== false
|
|
108
|
+
&& (typeof abandonedSlotReleaseAfterMs !== "number"
|
|
109
|
+
|| !Number.isInteger(abandonedSlotReleaseAfterMs)
|
|
110
|
+
|| abandonedSlotReleaseAfterMs < MIN_ABANDONED_SLOT_RELEASE_AFTER_MS
|
|
111
|
+
|| abandonedSlotReleaseAfterMs > MAX_ABANDONED_SLOT_RELEASE_AFTER_MS)) {
|
|
112
|
+
throw new Error(`config.capacity.abandonedSlotReleaseAfterMs must be false or an integer from ${MIN_ABANDONED_SLOT_RELEASE_AFTER_MS} to ${MAX_ABANDONED_SLOT_RELEASE_AFTER_MS}`);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
function validateRunnerLaunchersConfig(value) {
|
|
116
|
+
if (value === undefined)
|
|
117
|
+
return;
|
|
118
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
119
|
+
throw new Error("config.runnerLaunchers must be a JSON object mapping launcher names to argv arrays");
|
|
120
|
+
for (const [name, argv] of Object.entries(value)) {
|
|
121
|
+
const label = `config.runnerLaunchers[${JSON.stringify(name)}]`;
|
|
122
|
+
if (!RUNNER_LAUNCHER_NAME_PATTERN.test(name))
|
|
123
|
+
throw new Error(`${label} has an invalid name; launcher names ${RUNNER_LAUNCHER_NAME_RULE}`);
|
|
124
|
+
if (!Array.isArray(argv) || argv.length === 0 || argv.some((arg) => typeof arg !== "string" || !arg.trim() || arg.includes("\u0000"))) {
|
|
125
|
+
throw new Error(`${label} must be a non-empty argv array of non-blank strings without NUL characters`);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
function validateOrcaProgressTabsConfig(value) {
|
|
130
|
+
if (value === undefined)
|
|
131
|
+
return;
|
|
132
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
133
|
+
throw new Error("config.orcaProgressTabs must be a JSON object");
|
|
134
|
+
const config = value;
|
|
135
|
+
for (const key of Object.keys(config)) {
|
|
136
|
+
if (key !== "enabled")
|
|
137
|
+
throw new Error(`config.orcaProgressTabs.${key} is not supported`);
|
|
138
|
+
}
|
|
139
|
+
if (config.enabled !== undefined && typeof config.enabled !== "boolean") {
|
|
140
|
+
throw new Error("config.orcaProgressTabs.enabled must be a boolean");
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
function validateMainWindowRendererConfig(value) {
|
|
144
|
+
if (value === undefined)
|
|
145
|
+
return;
|
|
146
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
147
|
+
throw new Error("config.mainWindowRenderer must be a JSON object");
|
|
148
|
+
const rendererConfig = value;
|
|
149
|
+
if (rendererConfig.horizontalSpacing !== undefined
|
|
150
|
+
&& (typeof rendererConfig.horizontalSpacing !== "number"
|
|
151
|
+
|| !Number.isInteger(rendererConfig.horizontalSpacing)
|
|
152
|
+
|| rendererConfig.horizontalSpacing < 0
|
|
153
|
+
|| rendererConfig.horizontalSpacing > 4)) {
|
|
154
|
+
throw new Error("config.mainWindowRenderer.horizontalSpacing must be an integer from 0 to 4");
|
|
155
|
+
}
|
|
156
|
+
if (rendererConfig.compactResultMaxLines !== undefined
|
|
157
|
+
&& (typeof rendererConfig.compactResultMaxLines !== "number"
|
|
158
|
+
|| !Number.isInteger(rendererConfig.compactResultMaxLines)
|
|
159
|
+
|| rendererConfig.compactResultMaxLines < 1)) {
|
|
160
|
+
throw new Error("config.mainWindowRenderer.compactResultMaxLines must be a positive integer");
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
function validateConfig(config) {
|
|
164
|
+
if (config.worktree !== undefined && typeof config.worktree !== "boolean") {
|
|
165
|
+
throw new Error("config.worktree must be a boolean");
|
|
166
|
+
}
|
|
167
|
+
if (config.worktreeProvider !== undefined && config.worktreeProvider !== "auto" && config.worktreeProvider !== "native" && config.worktreeProvider !== "worktrunk") {
|
|
168
|
+
throw new Error('config.worktreeProvider must be "auto", "native", or "worktrunk"');
|
|
169
|
+
}
|
|
170
|
+
if (config.worktreeBranchPrefix !== undefined) {
|
|
171
|
+
if (typeof config.worktreeBranchPrefix !== "string")
|
|
172
|
+
throw new Error("config.worktreeBranchPrefix must be a string");
|
|
173
|
+
normalizeWorktreeBranchPrefix(config.worktreeBranchPrefix);
|
|
174
|
+
}
|
|
175
|
+
if (config.defaultSubagentContext !== undefined && config.defaultSubagentContext !== "fresh" && config.defaultSubagentContext !== "fork") {
|
|
176
|
+
throw new Error('config.defaultSubagentContext must be "fresh" or "fork"');
|
|
177
|
+
}
|
|
178
|
+
validateForkContextConfig(config.forkContext);
|
|
179
|
+
if (config.checkpointBeforeDeadlineMs !== undefined
|
|
180
|
+
&& (typeof config.checkpointBeforeDeadlineMs !== "number"
|
|
181
|
+
|| !Number.isInteger(config.checkpointBeforeDeadlineMs)
|
|
182
|
+
|| config.checkpointBeforeDeadlineMs <= 0
|
|
183
|
+
|| config.checkpointBeforeDeadlineMs > 2_147_483_647)) {
|
|
184
|
+
throw new Error("config.checkpointBeforeDeadlineMs must be a positive integer no larger than 2147483647");
|
|
185
|
+
}
|
|
186
|
+
if (config.foregroundDetachShortcut !== undefined
|
|
187
|
+
&& (typeof config.foregroundDetachShortcut !== "string" || !isValidKeyId(config.foregroundDetachShortcut))) {
|
|
188
|
+
throw new Error("config.foregroundDetachShortcut must be a valid keybinding string such as \"ctrl+b\"");
|
|
189
|
+
}
|
|
190
|
+
if (config.artifactDir !== undefined && !ARTIFACT_DIR_PREFERENCES.has(config.artifactDir)) {
|
|
191
|
+
throw new Error(`config.artifactDir must be "project", "session", or "temp"`);
|
|
192
|
+
}
|
|
193
|
+
if (config.maxActiveAsyncRunsPerSession !== undefined
|
|
194
|
+
&& (typeof config.maxActiveAsyncRunsPerSession !== "number"
|
|
195
|
+
|| !Number.isInteger(config.maxActiveAsyncRunsPerSession)
|
|
196
|
+
|| config.maxActiveAsyncRunsPerSession < 0)) {
|
|
197
|
+
throw new Error("config.maxActiveAsyncRunsPerSession must be a non-negative integer");
|
|
198
|
+
}
|
|
199
|
+
if (config.resultScanLogging !== undefined && config.resultScanLogging !== "all" && config.resultScanLogging !== "activity" && config.resultScanLogging !== "off") {
|
|
200
|
+
throw new Error('config.resultScanLogging must be "all", "activity", or "off"');
|
|
201
|
+
}
|
|
202
|
+
if (config.asyncWidgetCollapsed !== undefined && typeof config.asyncWidgetCollapsed !== "boolean") {
|
|
203
|
+
throw new Error("config.asyncWidgetCollapsed must be a boolean");
|
|
204
|
+
}
|
|
205
|
+
if (config.asyncWidgetLayout !== undefined && config.asyncWidgetLayout !== "adaptive" && config.asyncWidgetLayout !== "rows") {
|
|
206
|
+
throw new Error('config.asyncWidgetLayout must be "adaptive" or "rows"');
|
|
207
|
+
}
|
|
208
|
+
if (config.programStatus !== undefined && typeof config.programStatus !== "boolean") {
|
|
209
|
+
throw new Error("config.programStatus must be a boolean");
|
|
210
|
+
}
|
|
211
|
+
if (config.activeRunsPrompt !== undefined && typeof config.activeRunsPrompt !== "boolean") {
|
|
212
|
+
throw new Error("config.activeRunsPrompt must be a boolean");
|
|
213
|
+
}
|
|
214
|
+
if (config.pinToolDeclarations !== undefined && typeof config.pinToolDeclarations !== "boolean") {
|
|
215
|
+
throw new Error("config.pinToolDeclarations must be a boolean");
|
|
216
|
+
}
|
|
217
|
+
if (config.enableSlashCommands !== undefined && typeof config.enableSlashCommands !== "boolean") {
|
|
218
|
+
throw new Error("config.enableSlashCommands must be a boolean");
|
|
219
|
+
}
|
|
220
|
+
if (config.autoResume !== undefined && typeof config.autoResume !== "boolean") {
|
|
221
|
+
throw new Error("config.autoResume must be a boolean");
|
|
222
|
+
}
|
|
223
|
+
if (config.toolActivation !== undefined && config.toolActivation !== "auto" && config.toolActivation !== "dynamic" && config.toolActivation !== "eager") {
|
|
224
|
+
throw new Error('config.toolActivation must be "auto", "dynamic", or "eager"');
|
|
225
|
+
}
|
|
226
|
+
validateMissionStoreConfig(config.missions);
|
|
227
|
+
validateAuthorityPolicy(config.authorityPolicy);
|
|
228
|
+
validatePermissionConfig(config.permissions);
|
|
229
|
+
validateScheduledRunsConfig(config.scheduledRuns);
|
|
230
|
+
validateDisabledFeatures(config.disabledFeatures);
|
|
231
|
+
validateFleetKeybindingsConfig(config.fleetKeybindings);
|
|
232
|
+
validateArtifactConfig(config.artifactConfig);
|
|
233
|
+
validateCapacityConfig(config.capacity);
|
|
234
|
+
if (config.modelExclusions !== undefined)
|
|
235
|
+
throw new Error("config.modelExclusions was removed; model failures are no longer persisted or used for automatic switching");
|
|
236
|
+
validateModelResponseAliases(config.modelResponseAliases);
|
|
237
|
+
validateMainWindowRendererConfig(config.mainWindowRenderer);
|
|
238
|
+
validateOrcaProgressTabsConfig(config.orcaProgressTabs);
|
|
239
|
+
validateRunnerLaunchersConfig(config.runnerLaunchers);
|
|
240
|
+
}
|
|
241
|
+
export function getConfigPath() {
|
|
242
|
+
return path.join(getAgentDir(), "extensions", "subagent", "config.json");
|
|
243
|
+
}
|
|
244
|
+
function readConfigForUpdate(configPath = getConfigPath()) {
|
|
245
|
+
if (!fs.existsSync(configPath))
|
|
246
|
+
return {};
|
|
247
|
+
// Upstream-original: config parse is guarded by the object check below, which throws a domain error.
|
|
248
|
+
// pi-lens-ignore: unchecked-throwing-call-js
|
|
249
|
+
const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
|
|
250
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
251
|
+
throw new Error(`Subagent config at '${configPath}' must be a JSON object`);
|
|
252
|
+
}
|
|
253
|
+
validateConfig(parsed);
|
|
254
|
+
return parsed;
|
|
255
|
+
}
|
|
256
|
+
export function saveConfig(config, configPath = getConfigPath()) {
|
|
257
|
+
fs.mkdirSync(path.dirname(configPath), { recursive: true });
|
|
258
|
+
fs.writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}\n`, "utf-8");
|
|
259
|
+
}
|
|
260
|
+
export function updateConfig(updater) {
|
|
261
|
+
const configPath = getConfigPath();
|
|
262
|
+
const next = updater(readConfigForUpdate(configPath));
|
|
263
|
+
validateConfig(next);
|
|
264
|
+
saveConfig(next, configPath);
|
|
265
|
+
return next;
|
|
266
|
+
}
|
|
267
|
+
export function resolveAsyncByDefault(config) {
|
|
268
|
+
return config.asyncByDefault !== false;
|
|
269
|
+
}
|
|
270
|
+
export function loadConfig() {
|
|
271
|
+
const configPath = getConfigPath();
|
|
272
|
+
try {
|
|
273
|
+
return readConfigForUpdate(configPath);
|
|
274
|
+
}
|
|
275
|
+
catch (error) {
|
|
276
|
+
if (error instanceof PrunedForkConfigError)
|
|
277
|
+
throw error;
|
|
278
|
+
try {
|
|
279
|
+
const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
|
|
280
|
+
if (raw && typeof raw === "object" && !Array.isArray(raw) && FAIL_CLOSED_CONFIG_KEYS.some((key) => Object.hasOwn(raw, key)))
|
|
281
|
+
throw error;
|
|
282
|
+
}
|
|
283
|
+
catch (readError) {
|
|
284
|
+
if (readError === error)
|
|
285
|
+
throw error;
|
|
286
|
+
}
|
|
287
|
+
console.error(`Failed to load subagent config from '${configPath}':`, error);
|
|
288
|
+
}
|
|
289
|
+
return {};
|
|
290
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { AgentConfig } from "../agents/agents.ts";
|
|
2
|
+
import { type ResolvedSubagentCapabilityCeiling } from "../runs/shared/capability-ceiling.ts";
|
|
3
|
+
/**
|
|
4
|
+
* Marker used to detect an already-injected block so repeated injections
|
|
5
|
+
* (forked or resumed sessions replaying chained system prompts) stay idempotent.
|
|
6
|
+
*/
|
|
7
|
+
export declare const SUBAGENT_INJECTION_MARKER = "<available_subagents>";
|
|
8
|
+
/** One compact line per advertised agent inside the injected block. */
|
|
9
|
+
export interface InjectableAgentSummary {
|
|
10
|
+
name: string;
|
|
11
|
+
description: string;
|
|
12
|
+
}
|
|
13
|
+
export interface ResolveInjectableAgentsInput {
|
|
14
|
+
/** Merged discovered agents across scopes (builtin, package, user, project). */
|
|
15
|
+
agents: readonly AgentConfig[];
|
|
16
|
+
/** Names (canonical or alias) listed by the `subagents.injectAgents` setting. */
|
|
17
|
+
injectAgents?: readonly string[];
|
|
18
|
+
/** Current session capability ceiling; restricted agents are never advertised. */
|
|
19
|
+
capabilityCeiling?: ResolvedSubagentCapabilityCeiling | undefined;
|
|
20
|
+
}
|
|
21
|
+
export interface ResolveInjectableAgentsResult {
|
|
22
|
+
agents: InjectableAgentSummary[];
|
|
23
|
+
/** Setting entries that matched no discovered agent, trimmed, discovery order preserved. */
|
|
24
|
+
unknownNames: string[];
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Union of settings-listed agents (`subagents.injectAgents`) and agents whose
|
|
28
|
+
* frontmatter opts in with `injectToContext: true`. Settings names resolve
|
|
29
|
+
* against canonical names and aliases; unresolved entries are reported through
|
|
30
|
+
* `unknownNames` instead of failing discovery. Disabled agents and agents
|
|
31
|
+
* restricted by the session capability ceiling are never advertised.
|
|
32
|
+
*/
|
|
33
|
+
export declare function resolveInjectableAgents(input: ResolveInjectableAgentsInput): ResolveInjectableAgentsResult;
|
|
34
|
+
/**
|
|
35
|
+
* Append the session-snapshot block to this turn's system prompt.
|
|
36
|
+
* Returns `undefined` when nothing should change: empty block, or a prompt
|
|
37
|
+
* that already carries the marker (forked/resumed chains replaying history).
|
|
38
|
+
*/
|
|
39
|
+
export declare function applyInjectionBlock(input: {
|
|
40
|
+
systemPrompt: string;
|
|
41
|
+
block: string;
|
|
42
|
+
replaceExisting?: boolean;
|
|
43
|
+
}): string | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Render the deterministic `<available_subagents>` block appended to the parent
|
|
46
|
+
* system prompt. Pure function of its input: stable sort order and a fixed
|
|
47
|
+
* template guarantee byte-identical output across turns so provider prompt
|
|
48
|
+
* caching stays effective. Descriptions are collapsed to a single line so a
|
|
49
|
+
* multi-line frontmatter description cannot break the compact format. Returns
|
|
50
|
+
* an empty string when nothing is advertised.
|
|
51
|
+
*/
|
|
52
|
+
export declare function renderInjectionBlock(agents: readonly InjectableAgentSummary[]): string;
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { isAgentAllowedByCapabilityCeiling } from "../runs/shared/capability-ceiling.js";
|
|
2
|
+
/**
|
|
3
|
+
* Marker used to detect an already-injected block so repeated injections
|
|
4
|
+
* (forked or resumed sessions replaying chained system prompts) stay idempotent.
|
|
5
|
+
*/
|
|
6
|
+
export const SUBAGENT_INJECTION_MARKER = "<available_subagents>";
|
|
7
|
+
function normalizeDescription(description) {
|
|
8
|
+
return description.replace(/\s+/g, " ").trim();
|
|
9
|
+
}
|
|
10
|
+
function buildNameLookup(agents) {
|
|
11
|
+
const lookup = new Map();
|
|
12
|
+
for (const agent of agents) {
|
|
13
|
+
if (!lookup.has(agent.name))
|
|
14
|
+
lookup.set(agent.name, agent);
|
|
15
|
+
for (const alias of agent.aliases ?? []) {
|
|
16
|
+
if (!lookup.has(alias))
|
|
17
|
+
lookup.set(alias, agent);
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
return lookup;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Union of settings-listed agents (`subagents.injectAgents`) and agents whose
|
|
24
|
+
* frontmatter opts in with `injectToContext: true`. Settings names resolve
|
|
25
|
+
* against canonical names and aliases; unresolved entries are reported through
|
|
26
|
+
* `unknownNames` instead of failing discovery. Disabled agents and agents
|
|
27
|
+
* restricted by the session capability ceiling are never advertised.
|
|
28
|
+
*/
|
|
29
|
+
export function resolveInjectableAgents(input) {
|
|
30
|
+
const { agents, injectAgents, capabilityCeiling } = input;
|
|
31
|
+
const lookup = buildNameLookup(agents);
|
|
32
|
+
const selected = new Map();
|
|
33
|
+
const unknownNames = [];
|
|
34
|
+
const advertise = (agent) => {
|
|
35
|
+
if (agent.disabled === true)
|
|
36
|
+
return;
|
|
37
|
+
if (!isAgentAllowedByCapabilityCeiling(agent.name, capabilityCeiling))
|
|
38
|
+
return;
|
|
39
|
+
if (selected.has(agent.name))
|
|
40
|
+
return;
|
|
41
|
+
selected.set(agent.name, { name: agent.name, description: normalizeDescription(agent.description) });
|
|
42
|
+
};
|
|
43
|
+
for (const rawName of injectAgents ?? []) {
|
|
44
|
+
const name = rawName.trim();
|
|
45
|
+
if (!name)
|
|
46
|
+
continue;
|
|
47
|
+
const resolved = lookup.get(name);
|
|
48
|
+
if (!resolved) {
|
|
49
|
+
if (!unknownNames.includes(name))
|
|
50
|
+
unknownNames.push(name);
|
|
51
|
+
continue;
|
|
52
|
+
}
|
|
53
|
+
advertise(resolved);
|
|
54
|
+
}
|
|
55
|
+
for (const agent of agents) {
|
|
56
|
+
if (agent.injectToContext === true)
|
|
57
|
+
advertise(agent);
|
|
58
|
+
}
|
|
59
|
+
return {
|
|
60
|
+
agents: Array.from(selected.values()).sort((a, b) => a.name.localeCompare(b.name)),
|
|
61
|
+
unknownNames,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Append the session-snapshot block to this turn's system prompt.
|
|
66
|
+
* Returns `undefined` when nothing should change: empty block, or a prompt
|
|
67
|
+
* that already carries the marker (forked/resumed chains replaying history).
|
|
68
|
+
*/
|
|
69
|
+
export function applyInjectionBlock(input) {
|
|
70
|
+
const { systemPrompt, block } = input;
|
|
71
|
+
if (input.replaceExisting) {
|
|
72
|
+
const base = systemPrompt.replace(/\n*<available_subagents>[\s\S]*<\/available_subagents>/g, "");
|
|
73
|
+
const next = block ? `${base}\n\n${block}` : base;
|
|
74
|
+
return next === systemPrompt ? undefined : next;
|
|
75
|
+
}
|
|
76
|
+
if (!block)
|
|
77
|
+
return undefined;
|
|
78
|
+
if (systemPrompt.includes(SUBAGENT_INJECTION_MARKER))
|
|
79
|
+
return undefined;
|
|
80
|
+
return `${systemPrompt}\n\n${block}`;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Render the deterministic `<available_subagents>` block appended to the parent
|
|
84
|
+
* system prompt. Pure function of its input: stable sort order and a fixed
|
|
85
|
+
* template guarantee byte-identical output across turns so provider prompt
|
|
86
|
+
* caching stays effective. Descriptions are collapsed to a single line so a
|
|
87
|
+
* multi-line frontmatter description cannot break the compact format. Returns
|
|
88
|
+
* an empty string when nothing is advertised.
|
|
89
|
+
*/
|
|
90
|
+
export function renderInjectionBlock(agents) {
|
|
91
|
+
if (agents.length === 0)
|
|
92
|
+
return "";
|
|
93
|
+
const lines = [
|
|
94
|
+
SUBAGENT_INJECTION_MARKER,
|
|
95
|
+
"The following pre-declared subagents are available.",
|
|
96
|
+
"Launch them with the subagent tool when a task matches their description.",
|
|
97
|
+
"",
|
|
98
|
+
...agents.map((agent) => `- ${agent.name}: ${normalizeDescription(agent.description)}`),
|
|
99
|
+
"</available_subagents>",
|
|
100
|
+
];
|
|
101
|
+
return lines.join("\n");
|
|
102
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { ControlEvent, SubagentState } from "../shared/types.ts";
|
|
3
|
+
export declare const SUBAGENT_CONTROL_MESSAGE_TYPE = "subagent_control_notice";
|
|
4
|
+
export interface SubagentControlMessageDetails {
|
|
5
|
+
event: ControlEvent;
|
|
6
|
+
source?: "foreground" | "async" | "goal";
|
|
7
|
+
asyncDir?: string;
|
|
8
|
+
childIntercomTarget?: string;
|
|
9
|
+
noticeText?: string;
|
|
10
|
+
/** Status-only copy of a supervisor request; the tracker sends the notice later if the request is still unanswered. */
|
|
11
|
+
noticeDeferred?: boolean;
|
|
12
|
+
}
|
|
13
|
+
export declare function handleSubagentControlNotice(input: {
|
|
14
|
+
pi: Pick<ExtensionAPI, "sendMessage">;
|
|
15
|
+
state: SubagentState;
|
|
16
|
+
visibleControlNotices: Set<string>;
|
|
17
|
+
details: SubagentControlMessageDetails;
|
|
18
|
+
}): void;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { controlNotificationKey, formatControlNoticeMessage } from "../runs/shared/subagent-control.js";
|
|
2
|
+
export const SUBAGENT_CONTROL_MESSAGE_TYPE = "subagent_control_notice";
|
|
3
|
+
function deliverControlNotice(input) {
|
|
4
|
+
const childIntercomTarget = input.details.childIntercomTarget;
|
|
5
|
+
const key = controlNotificationKey(input.details.event, childIntercomTarget);
|
|
6
|
+
if (input.visibleControlNotices.has(key))
|
|
7
|
+
return;
|
|
8
|
+
input.visibleControlNotices.add(key);
|
|
9
|
+
const noticeText = input.details.noticeText ?? formatControlNoticeMessage(input.details.event, childIntercomTarget);
|
|
10
|
+
input.pi.sendMessage({
|
|
11
|
+
customType: SUBAGENT_CONTROL_MESSAGE_TYPE,
|
|
12
|
+
content: noticeText,
|
|
13
|
+
display: true,
|
|
14
|
+
details: { ...input.details, childIntercomTarget, noticeText },
|
|
15
|
+
}, { triggerTurn: input.details.source === "async" });
|
|
16
|
+
}
|
|
17
|
+
export function handleSubagentControlNotice(input) {
|
|
18
|
+
if (!input.details?.event || input.details.event.type === "active_long_running")
|
|
19
|
+
return;
|
|
20
|
+
if (input.details.noticeDeferred)
|
|
21
|
+
return;
|
|
22
|
+
if (input.details.source === "foreground") {
|
|
23
|
+
// A foreground tool blocks Pi from displaying this message. The run can
|
|
24
|
+
// finish before Pi flushes it, and queued messages cannot be withdrawn.
|
|
25
|
+
// Foreground control remains available through the live tool and fleet state.
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
deliverControlNotice(input);
|
|
29
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { TSchema } from "typebox";
|
|
3
|
+
/**
|
|
4
|
+
* The text, without its tags, that the session transcript recorded for one of the prompt sections
|
|
5
|
+
* pi-subagents adds, so that section can keep the wording the session already sent.
|
|
6
|
+
* A session that never recorded the section gets undefined.
|
|
7
|
+
*/
|
|
8
|
+
export declare function recordedPromptSection(pi: ExtensionAPI, name: string): string | undefined;
|
|
9
|
+
/**
|
|
10
|
+
* Register a pi-subagents tool so a session keeps the definition, prompt snippet and guidelines
|
|
11
|
+
* its transcript already declared. Only a session that never declared the tool gets this definition.
|
|
12
|
+
*/
|
|
13
|
+
export declare function registerPinnedTool<TParams extends TSchema, TDetails>(pi: ExtensionAPI, tool: ToolDefinition<TParams, TDetails>): void;
|
|
14
|
+
/**
|
|
15
|
+
* Choose whether this session keeps the pi-subagents definitions and prompt text its transcript
|
|
16
|
+
* declared (the default) or gets the current ones. Call before registering any pinned tool.
|
|
17
|
+
*/
|
|
18
|
+
export declare function setDeclarationPinning(pi: ExtensionAPI, pinned: boolean): void;
|