@xzzpig/pi-subagents 0.22.0 → 0.24.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +355 -0
- package/README.md +2 -2
- package/agents/evidence-auditor.md +1 -0
- package/agents/oracle.md +1 -0
- package/agents/reviewer.md +1 -0
- package/bundle/agent-management.js +16 -0
- package/bundle/agents.js +41 -0
- package/bundle/background-work.js +16 -0
- package/bundle/capability-ceiling.js +22 -0
- package/bundle/child-tool-plan.js +11 -0
- package/bundle/chunk-355ECEP2.js +1321 -0
- package/bundle/chunk-35GII5EF.js +637 -0
- package/bundle/chunk-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-6BJUEES3.js +276 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -0
- package/bundle/chunk-BGIYHF2W.js +138 -0
- package/bundle/chunk-CTPAE36Y.js +94 -0
- package/bundle/chunk-D4EHT5SJ.js +14 -0
- package/bundle/chunk-ED55MIC2.js +1681 -0
- package/bundle/chunk-EUPJB4S7.js +5503 -0
- package/bundle/chunk-FG6SQJAR.js +940 -0
- package/bundle/chunk-FJWI64H7.js +490 -0
- package/bundle/chunk-H36HBZB2.js +753 -0
- package/bundle/chunk-ICNYIALB.js +7347 -0
- package/bundle/chunk-JEA2ZKUA.js +1372 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LMGQAJ3O.js +9872 -0
- package/bundle/chunk-LVWU2HOO.js +1234 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RU522D5W.js +1768 -0
- package/bundle/chunk-SLNMBXLL.js +7336 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-TGLFTQWJ.js +143 -0
- package/bundle/chunk-TMHVDPYW.js +4132 -0
- package/bundle/chunk-U4ODUYAG.js +235 -0
- package/bundle/chunk-UKG4V45O.js +228 -0
- package/bundle/chunk-UQDHXMUG.js +264 -0
- package/bundle/chunk-V2KFIGFH.js +8774 -0
- package/bundle/chunk-VO3G7HI3.js +85 -0
- package/bundle/chunk-WPW4V6HM.js +227 -0
- package/bundle/chunk-WW76JRIX.js +175 -0
- package/bundle/chunk-X6LOM3Z4.js +4175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-Y6H2G6KX.js +1310 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/chunk-ZWXU5SPQ.js +16932 -0
- package/bundle/control-channel.js +11 -0
- package/bundle/delegation.js +14 -0
- package/bundle/external-job-provider.js +20 -0
- package/bundle/external-runs.js +21 -0
- package/bundle/index.js +30 -0
- package/bundle/inspectors.js +8 -0
- package/bundle/intercom-bridge.js +11 -0
- package/bundle/preflight.js +468 -0
- package/bundle/project-panes.js +28 -0
- package/bundle/required-child-extensions.js +6 -0
- package/bundle/shared-types.js +8 -0
- package/bundle/supervisor-routing.js +12 -0
- package/bundle/workflow-resources.js +7 -0
- package/docs/agents.md +42 -10
- package/docs/configuration.md +59 -14
- package/docs/extension-api.md +61 -9
- package/docs/goal-auto-continuation-gate.md +26 -0
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -87
- package/skills/council-mode/SKILL.md +1 -4
- package/skills/pi-subagents/SKILL.md +130 -106
- package/skills/pi-subagents/references/orchestration.md +124 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
- package/src/agents/advertised-agent-prompt.d.ts +13 -0
- package/src/agents/advertised-agent-prompt.js +68 -0
- package/src/agents/agent-eject.d.ts +39 -0
- package/src/agents/agent-eject.js +263 -0
- package/src/agents/agent-management.d.ts +33 -0
- package/src/agents/agent-management.js +1541 -0
- package/src/agents/agent-memory.d.ts +48 -0
- package/src/agents/agent-memory.js +350 -0
- package/src/agents/agent-refinements.d.ts +99 -0
- package/src/agents/agent-refinements.js +568 -0
- package/src/agents/agent-scope.d.ts +3 -0
- package/src/agents/agent-scope.js +8 -0
- package/src/agents/agent-selection.d.ts +2 -0
- package/src/agents/agent-selection.js +22 -0
- package/src/agents/agent-serializer.d.ts +7 -0
- package/src/agents/agent-serializer.js +213 -0
- package/src/agents/agents.d.ts +352 -0
- package/src/agents/agents.js +2817 -0
- package/src/agents/builtin-names.d.ts +1 -0
- package/src/agents/builtin-names.js +16 -0
- package/src/agents/chain-serializer.d.ts +6 -0
- package/src/agents/chain-serializer.js +318 -0
- package/src/agents/frontmatter.d.ts +19 -0
- package/src/agents/frontmatter.js +166 -0
- package/src/agents/global-npm-root.d.ts +6 -0
- package/src/agents/global-npm-root.js +57 -0
- package/src/agents/identity.d.ts +7 -0
- package/src/agents/identity.js +29 -0
- package/src/agents/proactive-skills.d.ts +35 -0
- package/src/agents/proactive-skills.js +155 -0
- package/src/agents/runtime-agent-events.d.ts +26 -0
- package/src/agents/runtime-agent-events.js +52 -0
- package/src/agents/runtime-agent-registry.d.ts +66 -0
- package/src/agents/runtime-agent-registry.js +415 -0
- package/src/agents/runtime-discovery.d.ts +13 -0
- package/src/agents/runtime-discovery.js +27 -0
- package/src/agents/skills.d.ts +34 -0
- package/src/agents/skills.js +718 -0
- package/src/api/agent-management.d.ts +2 -0
- package/src/api/agent-management.js +2 -0
- package/src/api/agents.d.ts +6 -0
- package/src/api/agents.js +3 -0
- package/src/api/background-work.d.ts +41 -0
- package/src/api/background-work.js +171 -0
- package/src/api/capability-ceiling.d.ts +1 -0
- package/src/api/capability-ceiling.js +1 -0
- package/src/api/child-tool-plan.d.ts +1 -0
- package/src/api/child-tool-plan.js +1 -0
- package/src/api/control-channel.d.ts +1 -0
- package/src/api/control-channel.js +1 -0
- package/src/api/delegation.d.ts +132 -0
- package/src/api/delegation.js +8 -0
- package/src/api/external-job-provider.d.ts +57 -0
- package/src/api/external-job-provider.js +139 -0
- package/src/api/external-runs.d.ts +47 -0
- package/src/api/external-runs.js +245 -0
- package/src/api/inspectors.d.ts +20 -0
- package/src/api/inspectors.js +11 -0
- package/src/api/intercom-bridge.d.ts +1 -0
- package/src/api/intercom-bridge.js +1 -0
- package/src/api/preflight.d.ts +183 -0
- package/src/api/preflight.js +455 -0
- package/src/api/project-panes.d.ts +7 -0
- package/src/api/project-panes.js +7 -0
- package/src/api/required-child-extensions.d.ts +1 -0
- package/src/api/required-child-extensions.js +1 -0
- package/src/api/shared-types.d.ts +1 -0
- package/src/api/shared-types.js +1 -0
- package/src/api/supervisor-routing.d.ts +110 -0
- package/src/api/supervisor-routing.js +95 -0
- package/src/api/workflow-resources.d.ts +2 -0
- package/src/api/workflow-resources.js +1 -0
- package/src/extension/active-runs-prompt.d.ts +7 -0
- package/src/extension/active-runs-prompt.js +29 -0
- package/src/extension/config.d.ts +7 -0
- package/src/extension/config.js +290 -0
- package/src/extension/context-injection.d.ts +52 -0
- package/src/extension/context-injection.js +102 -0
- package/src/extension/control-notices.d.ts +18 -0
- package/src/extension/control-notices.js +29 -0
- package/src/extension/declaration-pinning.d.ts +18 -0
- package/src/extension/declaration-pinning.js +167 -0
- package/src/extension/doctor.d.ts +34 -0
- package/src/extension/doctor.js +236 -0
- package/src/extension/fanout-child.d.ts +6 -0
- package/src/extension/fanout-child.js +278 -0
- package/src/extension/herdr-pi-bridge.d.ts +16 -0
- package/src/extension/herdr-pi-bridge.js +261 -0
- package/src/extension/index.d.ts +18 -0
- package/src/extension/index.js +1300 -0
- package/src/extension/public-execution.d.ts +71 -0
- package/src/extension/public-execution.js +214 -0
- package/src/extension/reply-workflow-script.d.ts +11 -0
- package/src/extension/reply-workflow-script.js +71 -0
- package/src/extension/rpc.d.ts +84 -0
- package/src/extension/rpc.js +729 -0
- package/src/extension/schemas.d.ts +276 -0
- package/src/extension/schemas.js +311 -0
- package/src/extension/steering-notices.d.ts +14 -0
- package/src/extension/steering-notices.js +22 -0
- package/src/extension/subagent-guide.d.ts +4 -0
- package/src/extension/subagent-guide.js +114 -0
- package/src/extension/subagent-options.d.ts +7 -0
- package/src/extension/subagent-options.js +64 -0
- package/src/extension/tool-activation.d.ts +7 -0
- package/src/extension/tool-activation.js +185 -0
- package/src/extension/tool-description.d.ts +19 -0
- package/src/extension/tool-description.js +169 -0
- package/src/extension/tool-result.d.ts +9 -0
- package/src/extension/tool-result.js +16 -0
- package/src/extension/upgrade-notice.d.ts +6 -0
- package/src/extension/upgrade-notice.js +42 -0
- package/src/goal-auto-continue-gate.d.ts +17 -0
- package/src/goal-auto-continue-gate.js +61 -0
- package/src/goal-auto-continue-state.d.ts +22 -0
- package/src/goal-auto-continue-state.js +20 -0
- package/src/inspectors/actions.d.ts +24 -0
- package/src/inspectors/actions.js +182 -0
- package/src/inspectors/ghostty/actions.d.ts +11 -0
- package/src/inspectors/ghostty/actions.js +62 -0
- package/src/inspectors/ghostty/plugin.d.ts +7 -0
- package/src/inspectors/ghostty/plugin.js +23 -0
- package/src/inspectors/herdr/actions.d.ts +25 -0
- package/src/inspectors/herdr/actions.js +133 -0
- package/src/inspectors/herdr/client.d.ts +41 -0
- package/src/inspectors/herdr/client.js +129 -0
- package/src/inspectors/herdr/focus.d.ts +24 -0
- package/src/inspectors/herdr/focus.js +49 -0
- package/src/inspectors/herdr/plugin.d.ts +6 -0
- package/src/inspectors/herdr/plugin.js +14 -0
- package/src/inspectors/herdr/project-panes.d.ts +136 -0
- package/src/inspectors/herdr/project-panes.js +610 -0
- package/src/inspectors/inspector-runner.d.ts +23 -0
- package/src/inspectors/inspector-runner.js +161 -0
- package/src/inspectors/plugins.d.ts +8 -0
- package/src/inspectors/plugins.js +82 -0
- package/src/inspectors/session-roots-codec.d.ts +15 -0
- package/src/inspectors/session-roots-codec.js +32 -0
- package/src/inspectors/shell-command.d.ts +1 -0
- package/src/inspectors/shell-command.js +16 -0
- package/src/inspectors/tmux/actions.d.ts +25 -0
- package/src/inspectors/tmux/actions.js +181 -0
- package/src/inspectors/tmux/client.d.ts +27 -0
- package/src/inspectors/tmux/client.js +64 -0
- package/src/inspectors/tmux/plugin.d.ts +7 -0
- package/src/inspectors/tmux/plugin.js +14 -0
- package/src/inspectors/types.d.ts +48 -0
- package/src/inspectors/types.js +1 -0
- package/src/integrations/herdr-status.d.ts +47 -0
- package/src/integrations/herdr-status.js +350 -0
- package/src/integrations/pi-web-session-liveness.d.ts +19 -0
- package/src/integrations/pi-web-session-liveness.js +53 -0
- package/src/integrations/program-status.d.ts +30 -0
- package/src/integrations/program-status.js +188 -0
- package/src/intercom/fork-supervisor-routing.d.ts +90 -0
- package/src/intercom/fork-supervisor-routing.js +392 -0
- package/src/intercom/intercom-bridge.d.ts +58 -0
- package/src/intercom/intercom-bridge.js +193 -0
- package/src/intercom/native-supervisor-channel.d.ts +97 -0
- package/src/intercom/native-supervisor-channel.js +1184 -0
- package/src/intercom/result-intercom.d.ts +35 -0
- package/src/intercom/result-intercom.js +376 -0
- package/src/intercom/supervisor-ui.d.ts +29 -0
- package/src/intercom/supervisor-ui.js +49 -0
- package/src/missions/actions.d.ts +54 -0
- package/src/missions/actions.js +400 -0
- package/src/missions/goal-driver.d.ts +16 -0
- package/src/missions/goal-driver.js +171 -0
- package/src/missions/lifecycle.d.ts +50 -0
- package/src/missions/lifecycle.js +388 -0
- package/src/missions/store.d.ts +21 -0
- package/src/missions/store.js +605 -0
- package/src/missions/types.d.ts +169 -0
- package/src/missions/types.js +9 -0
- package/src/missions/workflow-state.d.ts +14 -0
- package/src/missions/workflow-state.js +273 -0
- package/src/policy/authority.d.ts +9 -0
- package/src/policy/authority.js +41 -0
- package/src/profiles/profiles.d.ts +134 -0
- package/src/profiles/profiles.js +526 -0
- package/src/runs/background/active-async-capacity.d.ts +115 -0
- package/src/runs/background/active-async-capacity.js +517 -0
- package/src/runs/background/active-run-index.d.ts +12 -0
- package/src/runs/background/active-run-index.js +157 -0
- package/src/runs/background/async-execution.d.ts +306 -0
- package/src/runs/background/async-execution.js +2210 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +926 -0
- package/src/runs/background/async-resume.d.ts +60 -0
- package/src/runs/background/async-resume.js +707 -0
- package/src/runs/background/async-retention.d.ts +45 -0
- package/src/runs/background/async-retention.js +932 -0
- package/src/runs/background/async-status-snapshot.d.ts +9 -0
- package/src/runs/background/async-status-snapshot.js +26 -0
- package/src/runs/background/async-status.d.ts +179 -0
- package/src/runs/background/async-status.js +712 -0
- package/src/runs/background/auto-drain.d.ts +16 -0
- package/src/runs/background/auto-drain.js +71 -0
- package/src/runs/background/await-async-run.d.ts +26 -0
- package/src/runs/background/await-async-run.js +83 -0
- package/src/runs/background/binary-bootstrap.d.ts +8 -0
- package/src/runs/background/binary-bootstrap.js +69 -0
- package/src/runs/background/boot-id.d.ts +12 -0
- package/src/runs/background/boot-id.js +47 -0
- package/src/runs/background/calendar-schedule.d.ts +26 -0
- package/src/runs/background/calendar-schedule.js +93 -0
- package/src/runs/background/chain-append.d.ts +34 -0
- package/src/runs/background/chain-append.js +299 -0
- package/src/runs/background/chain-root-attachment.d.ts +51 -0
- package/src/runs/background/chain-root-attachment.js +186 -0
- package/src/runs/background/completion-batcher.d.ts +51 -0
- package/src/runs/background/completion-batcher.js +119 -0
- package/src/runs/background/completion-dedupe.d.ts +13 -0
- package/src/runs/background/completion-dedupe.js +48 -0
- package/src/runs/background/completion-replay.d.ts +47 -0
- package/src/runs/background/completion-replay.js +266 -0
- package/src/runs/background/control-channel.d.ts +170 -0
- package/src/runs/background/control-channel.js +610 -0
- package/src/runs/background/fleet-view.d.ts +63 -0
- package/src/runs/background/fleet-view.js +666 -0
- package/src/runs/background/index-segment.d.ts +16 -0
- package/src/runs/background/index-segment.js +58 -0
- package/src/runs/background/inspect-rpc.d.ts +64 -0
- package/src/runs/background/inspect-rpc.js +422 -0
- package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
- package/src/runs/background/interrupted-elsewhere.js +68 -0
- package/src/runs/background/notify.d.ts +216 -0
- package/src/runs/background/notify.js +1006 -0
- package/src/runs/background/owned-process-tree.d.ts +10 -0
- package/src/runs/background/owned-process-tree.js +116 -0
- package/src/runs/background/parallel-groups.d.ts +3 -0
- package/src/runs/background/parallel-groups.js +46 -0
- package/src/runs/background/pid-namespace.d.ts +2 -0
- package/src/runs/background/pid-namespace.js +19 -0
- package/src/runs/background/process-terminal-candidate.d.ts +17 -0
- package/src/runs/background/process-terminal-candidate.js +96 -0
- package/src/runs/background/process-terminal.d.ts +21 -0
- package/src/runs/background/process-terminal.js +227 -0
- package/src/runs/background/result-delivery-ownership.d.ts +14 -0
- package/src/runs/background/result-delivery-ownership.js +38 -0
- package/src/runs/background/result-files.d.ts +63 -0
- package/src/runs/background/result-files.js +629 -0
- package/src/runs/background/result-watcher.d.ts +92 -0
- package/src/runs/background/result-watcher.js +819 -0
- package/src/runs/background/resume-guidance.d.ts +4 -0
- package/src/runs/background/resume-guidance.js +57 -0
- package/src/runs/background/retained-children.d.ts +24 -0
- package/src/runs/background/retained-children.js +128 -0
- package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
- package/src/runs/background/retained-nested-route-tracker.js +90 -0
- package/src/runs/background/run-child-session.d.ts +123 -0
- package/src/runs/background/run-child-session.js +670 -0
- package/src/runs/background/run-id-query.d.ts +3 -0
- package/src/runs/background/run-id-query.js +6 -0
- package/src/runs/background/run-id-resolver.d.ts +22 -0
- package/src/runs/background/run-id-resolver.js +172 -0
- package/src/runs/background/run-status.d.ts +25 -0
- package/src/runs/background/run-status.js +850 -0
- package/src/runs/background/runner-aliases.d.ts +17 -0
- package/src/runs/background/runner-aliases.js +191 -0
- package/src/runs/background/runner-child-launch.d.ts +24 -0
- package/src/runs/background/runner-child-launch.js +72 -0
- package/src/runs/background/runner-child-sessions.d.ts +6 -0
- package/src/runs/background/runner-child-sessions.js +34 -0
- package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
- package/src/runs/background/runner-http-dispatcher.js +115 -0
- package/src/runs/background/runner-startup-failure.d.ts +13 -0
- package/src/runs/background/runner-startup-failure.js +46 -0
- package/src/runs/background/scheduled-runs.d.ts +127 -0
- package/src/runs/background/scheduled-runs.js +1265 -0
- package/src/runs/background/stale-run-reconciler.d.ts +62 -0
- package/src/runs/background/stale-run-reconciler.js +509 -0
- package/src/runs/background/steering.d.ts +51 -0
- package/src/runs/background/steering.js +246 -0
- package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
- package/src/runs/background/subagent-runner-bootstrap.js +283 -0
- package/src/runs/background/subagent-runner.d.ts +210 -0
- package/src/runs/background/subagent-runner.js +4963 -0
- package/src/runs/background/subagent-wait.d.ts +124 -0
- package/src/runs/background/subagent-wait.js +756 -0
- package/src/runs/background/terminal-run-index.d.ts +10 -0
- package/src/runs/background/terminal-run-index.js +209 -0
- package/src/runs/background/top-level-async.d.ts +7 -0
- package/src/runs/background/top-level-async.js +5 -0
- package/src/runs/background/wait-completions.d.ts +28 -0
- package/src/runs/background/wait-completions.js +264 -0
- package/src/runs/background/wait-config.d.ts +8 -0
- package/src/runs/background/wait-config.js +46 -0
- package/src/runs/background/wait-subscriptions.d.ts +26 -0
- package/src/runs/background/wait-subscriptions.js +339 -0
- package/src/runs/background/wait-tool.d.ts +6 -0
- package/src/runs/background/wait-tool.js +48 -0
- package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
- package/src/runs/background/workflow-terminal-proof.js +116 -0
- package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
- package/src/runs/foreground/async-dismiss-action.js +82 -0
- package/src/runs/foreground/async-steering-action.d.ts +31 -0
- package/src/runs/foreground/async-steering-action.js +294 -0
- package/src/runs/foreground/async-stop-action.d.ts +13 -0
- package/src/runs/foreground/async-stop-action.js +213 -0
- package/src/runs/foreground/command-action.d.ts +12 -0
- package/src/runs/foreground/command-action.js +38 -0
- package/src/runs/foreground/execution.d.ts +10 -0
- package/src/runs/foreground/execution.js +2322 -0
- package/src/runs/foreground/foreground-control.d.ts +24 -0
- package/src/runs/foreground/foreground-control.js +138 -0
- package/src/runs/foreground/foreground-history.d.ts +25 -0
- package/src/runs/foreground/foreground-history.js +267 -0
- package/src/runs/foreground/prompt-audit.d.ts +32 -0
- package/src/runs/foreground/prompt-audit.js +138 -0
- package/src/runs/foreground/subagent-executor.d.ts +316 -0
- package/src/runs/foreground/subagent-executor.js +7990 -0
- package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
- package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
- package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
- package/src/runs/foreground/workflow-foreground-steering.js +148 -0
- package/src/runs/shared/abort-recovery.d.ts +26 -0
- package/src/runs/shared/abort-recovery.js +108 -0
- package/src/runs/shared/acceptance.d.ts +144 -0
- package/src/runs/shared/acceptance.js +1616 -0
- package/src/runs/shared/agent-contract.d.ts +5 -0
- package/src/runs/shared/agent-contract.js +35 -0
- package/src/runs/shared/async-status-projection.d.ts +100 -0
- package/src/runs/shared/async-status-projection.js +566 -0
- package/src/runs/shared/background-process-options.d.ts +4 -0
- package/src/runs/shared/background-process-options.js +6 -0
- package/src/runs/shared/capability-ceiling.d.ts +58 -0
- package/src/runs/shared/capability-ceiling.js +179 -0
- package/src/runs/shared/chain-outputs.d.ts +18 -0
- package/src/runs/shared/chain-outputs.js +104 -0
- package/src/runs/shared/child-commands.d.ts +29 -0
- package/src/runs/shared/child-commands.js +254 -0
- package/src/runs/shared/child-hooks.d.ts +31 -0
- package/src/runs/shared/child-hooks.js +173 -0
- package/src/runs/shared/child-identity.d.ts +23 -0
- package/src/runs/shared/child-identity.js +40 -0
- package/src/runs/shared/child-launch-plan.d.ts +70 -0
- package/src/runs/shared/child-launch-plan.js +88 -0
- package/src/runs/shared/child-launch.d.ts +128 -0
- package/src/runs/shared/child-launch.js +262 -0
- package/src/runs/shared/child-lifecycle.d.ts +13 -0
- package/src/runs/shared/child-lifecycle.js +22 -0
- package/src/runs/shared/child-runtime-config.d.ts +111 -0
- package/src/runs/shared/child-runtime-config.js +44 -0
- package/src/runs/shared/child-session.d.ts +178 -0
- package/src/runs/shared/child-session.js +726 -0
- package/src/runs/shared/child-tool-plan.d.ts +101 -0
- package/src/runs/shared/child-tool-plan.js +430 -0
- package/src/runs/shared/claude-code-adapter.d.ts +80 -0
- package/src/runs/shared/claude-code-adapter.js +255 -0
- package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
- package/src/runs/shared/codex-exec-adapter.js +127 -0
- package/src/runs/shared/context-mode.d.ts +12 -0
- package/src/runs/shared/context-mode.js +38 -0
- package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
- package/src/runs/shared/cursor-agent-adapter.js +99 -0
- package/src/runs/shared/dynamic-fanout.d.ts +49 -0
- package/src/runs/shared/dynamic-fanout.js +273 -0
- package/src/runs/shared/effective-system-prompt.d.ts +17 -0
- package/src/runs/shared/effective-system-prompt.js +23 -0
- package/src/runs/shared/extension-bindings.d.ts +25 -0
- package/src/runs/shared/extension-bindings.js +96 -0
- package/src/runs/shared/external-cli-contract.d.ts +29 -0
- package/src/runs/shared/external-cli-contract.js +145 -0
- package/src/runs/shared/external-cli-preflight.d.ts +41 -0
- package/src/runs/shared/external-cli-preflight.js +159 -0
- package/src/runs/shared/external-cli-runner.d.ts +65 -0
- package/src/runs/shared/external-cli-runner.js +425 -0
- package/src/runs/shared/external-job-bridge.d.ts +24 -0
- package/src/runs/shared/external-job-bridge.js +486 -0
- package/src/runs/shared/external-job-runner.d.ts +44 -0
- package/src/runs/shared/external-job-runner.js +352 -0
- package/src/runs/shared/fast-mode-extension.d.ts +3 -0
- package/src/runs/shared/fast-mode-extension.js +8 -0
- package/src/runs/shared/fork-placed-env.d.ts +4 -0
- package/src/runs/shared/fork-placed-env.js +13 -0
- package/src/runs/shared/git-environment.d.ts +2 -0
- package/src/runs/shared/git-environment.js +27 -0
- package/src/runs/shared/herdr-connection.d.ts +79 -0
- package/src/runs/shared/herdr-connection.js +269 -0
- package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
- package/src/runs/shared/herdr-external-adapters.js +404 -0
- package/src/runs/shared/herdr-machine.d.ts +59 -0
- package/src/runs/shared/herdr-machine.js +294 -0
- package/src/runs/shared/herdr-pane-host.d.ts +88 -0
- package/src/runs/shared/herdr-pane-host.js +155 -0
- package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
- package/src/runs/shared/herdr-pi-protocol.js +57 -0
- package/src/runs/shared/herdr-placed-run.d.ts +144 -0
- package/src/runs/shared/herdr-placed-run.js +380 -0
- package/src/runs/shared/host-step-status.d.ts +33 -0
- package/src/runs/shared/host-step-status.js +244 -0
- package/src/runs/shared/lane-metadata.d.ts +23 -0
- package/src/runs/shared/lane-metadata.js +126 -0
- package/src/runs/shared/launch-cwd.d.ts +1 -0
- package/src/runs/shared/launch-cwd.js +16 -0
- package/src/runs/shared/local-machine-access.d.ts +5 -0
- package/src/runs/shared/local-machine-access.js +28 -0
- package/src/runs/shared/long-running-guard.d.ts +34 -0
- package/src/runs/shared/long-running-guard.js +256 -0
- package/src/runs/shared/mcp-config-sources.d.ts +33 -0
- package/src/runs/shared/mcp-config-sources.js +418 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
- package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
- package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
- package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
- package/src/runs/shared/model-resolution-diagnostic.js +116 -0
- package/src/runs/shared/model-resolution.d.ts +109 -0
- package/src/runs/shared/model-resolution.js +411 -0
- package/src/runs/shared/model-scope.d.ts +68 -0
- package/src/runs/shared/model-scope.js +171 -0
- package/src/runs/shared/mutation-evidence.d.ts +18 -0
- package/src/runs/shared/mutation-evidence.js +198 -0
- package/src/runs/shared/nested-events.d.ts +135 -0
- package/src/runs/shared/nested-events.js +1090 -0
- package/src/runs/shared/nested-path.d.ts +8 -0
- package/src/runs/shared/nested-path.js +34 -0
- package/src/runs/shared/nested-render.d.ts +20 -0
- package/src/runs/shared/nested-render.js +115 -0
- package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
- package/src/runs/shared/orca-progress-tabs.js +503 -0
- package/src/runs/shared/parallel-handoff.d.ts +78 -0
- package/src/runs/shared/parallel-handoff.js +783 -0
- package/src/runs/shared/parallel-utils.d.ts +177 -0
- package/src/runs/shared/parallel-utils.js +125 -0
- package/src/runs/shared/partial-output.d.ts +24 -0
- package/src/runs/shared/partial-output.js +35 -0
- package/src/runs/shared/permissions.d.ts +12 -0
- package/src/runs/shared/permissions.js +92 -0
- package/src/runs/shared/pi-spawn.d.ts +31 -0
- package/src/runs/shared/pi-spawn.js +211 -0
- package/src/runs/shared/placed-run-owner.d.ts +49 -0
- package/src/runs/shared/placed-run-owner.js +93 -0
- package/src/runs/shared/placement-host.d.ts +99 -0
- package/src/runs/shared/placement-host.js +157 -0
- package/src/runs/shared/process-signal.d.ts +15 -0
- package/src/runs/shared/process-signal.js +21 -0
- package/src/runs/shared/profile-extensions.d.ts +21 -0
- package/src/runs/shared/profile-extensions.js +122 -0
- package/src/runs/shared/profile-launch-env.d.ts +26 -0
- package/src/runs/shared/profile-launch-env.js +90 -0
- package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
- package/src/runs/shared/readonly-drain-observation.js +50 -0
- package/src/runs/shared/rex-machine.d.ts +25 -0
- package/src/runs/shared/rex-machine.js +83 -0
- package/src/runs/shared/rex-pane-host.d.ts +62 -0
- package/src/runs/shared/rex-pane-host.js +327 -0
- package/src/runs/shared/run-fanout-budget.d.ts +14 -0
- package/src/runs/shared/run-fanout-budget.js +258 -0
- package/src/runs/shared/run-ownership.d.ts +3 -0
- package/src/runs/shared/run-ownership.js +8 -0
- package/src/runs/shared/runner-launcher.d.ts +11 -0
- package/src/runs/shared/runner-launcher.js +24 -0
- package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
- package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
- package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
- package/src/runs/shared/sandbox-profile-guard.js +106 -0
- package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
- package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
- package/src/runs/shared/session-lease.d.ts +69 -0
- package/src/runs/shared/session-lease.js +250 -0
- package/src/runs/shared/single-output.d.ts +90 -0
- package/src/runs/shared/single-output.js +349 -0
- package/src/runs/shared/spawn-budget.d.ts +20 -0
- package/src/runs/shared/spawn-budget.js +93 -0
- package/src/runs/shared/structured-output.d.ts +66 -0
- package/src/runs/shared/structured-output.js +483 -0
- package/src/runs/shared/subagent-control.d.ts +50 -0
- package/src/runs/shared/subagent-control.js +247 -0
- package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
- package/src/runs/shared/subagent-prompt-runtime.js +776 -0
- package/src/runs/shared/tool-availability.d.ts +16 -0
- package/src/runs/shared/tool-availability.js +29 -0
- package/src/runs/shared/tool-budget.d.ts +21 -0
- package/src/runs/shared/tool-budget.js +78 -0
- package/src/runs/shared/tool-timeout.d.ts +31 -0
- package/src/runs/shared/tool-timeout.js +73 -0
- package/src/runs/shared/usage-budget.d.ts +7 -0
- package/src/runs/shared/usage-budget.js +74 -0
- package/src/runs/shared/usage-reconciliation.d.ts +8 -0
- package/src/runs/shared/usage-reconciliation.js +71 -0
- package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
- package/src/runs/shared/workflow-async-child-guidance.js +17 -0
- package/src/runs/shared/workflow-graph.d.ts +31 -0
- package/src/runs/shared/workflow-graph.js +221 -0
- package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
- package/src/runs/shared/worktree-cleanup-apply.js +178 -0
- package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
- package/src/runs/shared/worktree-cleanup-plan.js +803 -0
- package/src/runs/shared/worktree-lock.d.ts +5 -0
- package/src/runs/shared/worktree-lock.js +40 -0
- package/src/runs/shared/worktree-setup-command.d.ts +38 -0
- package/src/runs/shared/worktree-setup-command.js +200 -0
- package/src/runs/shared/worktree.d.ts +181 -0
- package/src/runs/shared/worktree.js +1346 -0
- package/src/shared/accessible-dir.d.ts +11 -0
- package/src/shared/accessible-dir.js +39 -0
- package/src/shared/agent-stream-options.d.ts +5 -0
- package/src/shared/agent-stream-options.js +3 -0
- package/src/shared/artifacts.d.ts +22 -0
- package/src/shared/artifacts.js +272 -0
- package/src/shared/atomic-json.d.ts +19 -0
- package/src/shared/atomic-json.js +61 -0
- package/src/shared/capacity-resilient-json.d.ts +26 -0
- package/src/shared/capacity-resilient-json.js +86 -0
- package/src/shared/child-cache-retention.d.ts +29 -0
- package/src/shared/child-cache-retention.js +40 -0
- package/src/shared/child-session-name.d.ts +8 -0
- package/src/shared/child-session-name.js +40 -0
- package/src/shared/child-transcript.d.ts +37 -0
- package/src/shared/child-transcript.js +225 -0
- package/src/shared/completion-owner.d.ts +7 -0
- package/src/shared/completion-owner.js +13 -0
- package/src/shared/disabled-features.d.ts +93 -0
- package/src/shared/disabled-features.js +120 -0
- package/src/shared/display-text.d.ts +5 -0
- package/src/shared/display-text.js +154 -0
- package/src/shared/edit-distance.d.ts +4 -0
- package/src/shared/edit-distance.js +32 -0
- package/src/shared/extension-context.d.ts +21 -0
- package/src/shared/extension-context.js +39 -0
- package/src/shared/file-coalescer.d.ts +11 -0
- package/src/shared/file-coalescer.js +34 -0
- package/src/shared/file-lease.d.ts +10 -0
- package/src/shared/file-lease.js +106 -0
- package/src/shared/file-system-retry.d.ts +31 -0
- package/src/shared/file-system-retry.js +84 -0
- package/src/shared/fork-context.d.ts +64 -0
- package/src/shared/fork-context.js +185 -0
- package/src/shared/fork-session-cwd.d.ts +2 -0
- package/src/shared/fork-session-cwd.js +23 -0
- package/src/shared/formatters.d.ts +35 -0
- package/src/shared/formatters.js +137 -0
- package/src/shared/jsonl-writer.d.ts +20 -0
- package/src/shared/jsonl-writer.js +67 -0
- package/src/shared/launch-contract.d.ts +65 -0
- package/src/shared/launch-contract.js +145 -0
- package/src/shared/model-info.d.ts +55 -0
- package/src/shared/model-info.js +103 -0
- package/src/shared/model-response-aliases.d.ts +1 -0
- package/src/shared/model-response-aliases.js +15 -0
- package/src/shared/node-executable.d.ts +1 -0
- package/src/shared/node-executable.js +20 -0
- package/src/shared/opencode-session-headers.d.ts +12 -0
- package/src/shared/opencode-session-headers.js +26 -0
- package/src/shared/package-version.d.ts +2 -0
- package/src/shared/package-version.js +14 -0
- package/src/shared/parent-wake.d.ts +26 -0
- package/src/shared/parent-wake.js +68 -0
- package/src/shared/permission-profile.d.ts +26 -0
- package/src/shared/permission-profile.js +49 -0
- package/src/shared/prompt-resources.d.ts +5 -0
- package/src/shared/prompt-resources.js +10 -0
- package/src/shared/provider-diagnostics.d.ts +9 -0
- package/src/shared/provider-diagnostics.js +75 -0
- package/src/shared/pruned-fork.d.ts +34 -0
- package/src/shared/pruned-fork.js +434 -0
- package/src/shared/required-child-extensions.d.ts +34 -0
- package/src/shared/required-child-extensions.js +105 -0
- package/src/shared/runtime-module-path.d.ts +10 -0
- package/src/shared/runtime-module-path.js +16 -0
- package/src/shared/sandbox-profile.d.ts +12 -0
- package/src/shared/sandbox-profile.js +35 -0
- package/src/shared/session-file-trust.d.ts +1 -0
- package/src/shared/session-file-trust.js +20 -0
- package/src/shared/session-identity.d.ts +8 -0
- package/src/shared/session-identity.js +32 -0
- package/src/shared/session-succession.d.ts +4 -0
- package/src/shared/session-succession.js +24 -0
- package/src/shared/session-tokens.d.ts +2 -0
- package/src/shared/session-tokens.js +58 -0
- package/src/shared/settings-file-lease.d.ts +4 -0
- package/src/shared/settings-file-lease.js +38 -0
- package/src/shared/settings.d.ts +146 -0
- package/src/shared/settings.js +247 -0
- package/src/shared/shortcuts.d.ts +1 -0
- package/src/shared/shortcuts.js +17 -0
- package/src/shared/status-format.d.ts +9 -0
- package/src/shared/status-format.js +60 -0
- package/src/shared/thinking-ceiling.d.ts +13 -0
- package/src/shared/thinking-ceiling.js +37 -0
- package/src/shared/types.d.ts +2842 -0
- package/src/shared/types.js +276 -0
- package/src/shared/utf8.d.ts +5 -0
- package/src/shared/utf8.js +12 -0
- package/src/shared/utils.d.ts +83 -0
- package/src/shared/utils.js +612 -0
- package/src/shared/watch-strategy.d.ts +2 -0
- package/src/shared/watch-strategy.js +5 -0
- package/src/shared/workflow-child-permit.d.ts +58 -0
- package/src/shared/workflow-child-permit.js +159 -0
- package/src/slash/delegation-adapters.d.ts +154 -0
- package/src/slash/delegation-adapters.js +316 -0
- package/src/slash/delegation-json.d.ts +10 -0
- package/src/slash/delegation-json.js +117 -0
- package/src/slash/delegation-request.d.ts +12 -0
- package/src/slash/delegation-request.js +174 -0
- package/src/slash/prompt-template-bridge.d.ts +29 -0
- package/src/slash/prompt-template-bridge.js +399 -0
- package/src/slash/prompt-workflows.d.ts +21 -0
- package/src/slash/prompt-workflows.js +274 -0
- package/src/slash/selector.d.ts +47 -0
- package/src/slash/selector.js +117 -0
- package/src/slash/slash-bridge.d.ts +30 -0
- package/src/slash/slash-bridge.js +132 -0
- package/src/slash/slash-commands.d.ts +10 -0
- package/src/slash/slash-commands.js +1059 -0
- package/src/slash/slash-live-state.d.ts +21 -0
- package/src/slash/slash-live-state.js +263 -0
- package/src/slash/subagent-cost.d.ts +29 -0
- package/src/slash/subagent-cost.js +310 -0
- package/src/slash/subagents-admin.d.ts +3 -0
- package/src/slash/subagents-admin.js +481 -0
- package/src/tui/fleet-layout.d.ts +20 -0
- package/src/tui/fleet-layout.js +17 -0
- package/src/tui/fleet-native-transcript.d.ts +53 -0
- package/src/tui/fleet-native-transcript.js +339 -0
- package/src/tui/fleet-status.d.ts +92 -0
- package/src/tui/fleet-status.js +1132 -0
- package/src/tui/fleet-transcript.d.ts +64 -0
- package/src/tui/fleet-transcript.js +544 -0
- package/src/tui/fleet-viewport.d.ts +12 -0
- package/src/tui/fleet-viewport.js +35 -0
- package/src/tui/fleet.d.ts +196 -0
- package/src/tui/fleet.js +1588 -0
- package/src/tui/mouse-events.d.ts +21 -0
- package/src/tui/mouse-events.js +26 -0
- package/src/tui/render-helpers.d.ts +23 -0
- package/src/tui/render-helpers.js +100 -0
- package/src/tui/render.d.ts +66 -0
- package/src/tui/render.js +3707 -0
- package/src/tui/running-tone.d.ts +10 -0
- package/src/tui/running-tone.js +22 -0
- package/src/tui/subagent-messages.d.ts +22 -0
- package/src/tui/subagent-messages.js +270 -0
- package/src/ui-silent-marker.d.ts +20 -0
- package/src/ui-silent-marker.js +25 -0
- package/src/watchdog/change-signature.d.ts +7 -0
- package/src/watchdog/change-signature.js +243 -0
- package/src/watchdog/child-status.d.ts +53 -0
- package/src/watchdog/child-status.js +187 -0
- package/src/watchdog/diff-tool.d.ts +25 -0
- package/src/watchdog/diff-tool.js +104 -0
- package/src/watchdog/emission-guard.d.ts +36 -0
- package/src/watchdog/emission-guard.js +97 -0
- package/src/watchdog/guidance.d.ts +3 -0
- package/src/watchdog/guidance.js +19 -0
- package/src/watchdog/lsp-diagnostics.d.ts +17 -0
- package/src/watchdog/lsp-diagnostics.js +489 -0
- package/src/watchdog/model-selection.d.ts +24 -0
- package/src/watchdog/model-selection.js +167 -0
- package/src/watchdog/permission-arbiter.d.ts +20 -0
- package/src/watchdog/permission-arbiter.js +135 -0
- package/src/watchdog/register-child.d.ts +13 -0
- package/src/watchdog/register-child.js +128 -0
- package/src/watchdog/register-main.d.ts +11 -0
- package/src/watchdog/register-main.js +400 -0
- package/src/watchdog/render.d.ts +3 -0
- package/src/watchdog/render.js +33 -0
- package/src/watchdog/review.d.ts +36 -0
- package/src/watchdog/review.js +319 -0
- package/src/watchdog/rules.d.ts +21 -0
- package/src/watchdog/rules.js +58 -0
- package/src/watchdog/runtime.d.ts +195 -0
- package/src/watchdog/runtime.js +864 -0
- package/src/watchdog/scope.d.ts +14 -0
- package/src/watchdog/scope.js +44 -0
- package/src/watchdog/settings.d.ts +29 -0
- package/src/watchdog/settings.js +480 -0
- package/src/watchdog/tool-actions.d.ts +17 -0
- package/src/watchdog/tool-actions.js +150 -0
- package/src/watchdog/turn-delta.d.ts +15 -0
- package/src/watchdog/turn-delta.js +188 -0
- package/src/watchdog/types.d.ts +141 -0
- package/src/watchdog/types.js +27 -0
- package/src/watchdog/warning-format.d.ts +7 -0
- package/src/watchdog/warning-format.js +59 -0
- package/src/workflows/chat-progress.d.ts +37 -0
- package/src/workflows/chat-progress.js +129 -0
- package/src/workflows/host-command.d.ts +30 -0
- package/src/workflows/host-command.js +227 -0
- package/src/workflows/scripted-workflow.d.ts +204 -0
- package/src/workflows/scripted-workflow.js +1673 -0
- package/src/workflows/structured-workflow-scripts.d.ts +10 -0
- package/src/workflows/structured-workflow-scripts.js +179 -0
- package/src/workflows/workflow-auto-resume.d.ts +32 -0
- package/src/workflows/workflow-auto-resume.js +102 -0
- package/src/workflows/workflow-checklist.d.ts +127 -0
- package/src/workflows/workflow-checklist.js +314 -0
- package/src/workflows/workflow-child-summary.d.ts +24 -0
- package/src/workflows/workflow-child-summary.js +195 -0
- package/src/workflows/workflow-launch-record.d.ts +27 -0
- package/src/workflows/workflow-launch-record.js +48 -0
- package/src/workflows/workflow-preflight.d.ts +58 -0
- package/src/workflows/workflow-preflight.js +288 -0
- package/src/workflows/workflow-receipt.d.ts +34 -0
- package/src/workflows/workflow-receipt.js +454 -0
- package/src/workflows/workflow-resources.d.ts +55 -0
- package/src/workflows/workflow-resources.js +271 -0
- package/src/workflows/workflow-resume-claim.d.ts +82 -0
- package/src/workflows/workflow-resume-claim.js +210 -0
- package/src/workflows/workflow-resume.d.ts +56 -0
- package/src/workflows/workflow-resume.js +106 -0
- package/src/workflows/workflow-reuse.d.ts +61 -0
- package/src/workflows/workflow-reuse.js +186 -0
- package/src/workflows/workflow-revival.d.ts +33 -0
- package/src/workflows/workflow-revival.js +111 -0
- package/src/workflows/workflow-settlement.d.ts +84 -0
- package/src/workflows/workflow-settlement.js +203 -0
- package/src/workflows/workflow-stop-cause.d.ts +6 -0
- package/src/workflows/workflow-stop-cause.js +8 -0
- package/workflow-script-worker.cjs +1342 -0
- package/index.ts +0 -18
- package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
- package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
- package/skills/pi-subagents/references/execution-controls.md +0 -561
- package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
- package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
- package/skills/pi-subagents/references/review-and-validation.md +0 -73
- package/src/agents/advertised-agent-prompt.ts +0 -82
- package/src/agents/agent-eject.ts +0 -339
- package/src/agents/agent-management.ts +0 -1442
- package/src/agents/agent-memory.ts +0 -341
- package/src/agents/agent-refinements.ts +0 -624
- package/src/agents/agent-scope.ts +0 -10
- package/src/agents/agent-selection.ts +0 -25
- package/src/agents/agent-serializer.ts +0 -195
- package/src/agents/agents.ts +0 -3169
- package/src/agents/builtin-names.ts +0 -16
- package/src/agents/chain-serializer.ts +0 -285
- package/src/agents/frontmatter.ts +0 -153
- package/src/agents/global-npm-root.ts +0 -58
- package/src/agents/identity.ts +0 -30
- package/src/agents/proactive-skills.ts +0 -197
- package/src/agents/runtime-agent-events.ts +0 -70
- package/src/agents/runtime-agent-registry.ts +0 -457
- package/src/agents/runtime-discovery.ts +0 -39
- package/src/agents/skills.ts +0 -787
- package/src/api/agent-management.ts +0 -9
- package/src/api/agents.ts +0 -19
- package/src/api/background-work.ts +0 -206
- package/src/api/capability-ceiling.ts +0 -16
- package/src/api/child-tool-plan.ts +0 -5
- package/src/api/control-channel.ts +0 -4
- package/src/api/delegation.ts +0 -131
- package/src/api/external-job-provider.ts +0 -195
- package/src/api/external-runs.ts +0 -282
- package/src/api/inspectors.ts +0 -27
- package/src/api/intercom-bridge.ts +0 -3
- package/src/api/preflight.ts +0 -641
- package/src/api/project-panes.ts +0 -32
- package/src/api/required-child-extensions.ts +0 -6
- package/src/api/shared-types.ts +0 -29
- package/src/api/supervisor-routing.ts +0 -196
- package/src/api/workflow-resources.ts +0 -6
- package/src/extension/config.ts +0 -262
- package/src/extension/context-injection.ts +0 -123
- package/src/extension/control-notices.ts +0 -53
- package/src/extension/declaration-pinning.ts +0 -164
- package/src/extension/doctor.ts +0 -284
- package/src/extension/fanout-child.ts +0 -282
- package/src/extension/herdr-pi-bridge.ts +0 -166
- package/src/extension/index.ts +0 -1212
- package/src/extension/public-execution.ts +0 -262
- package/src/extension/reply-workflow-script.ts +0 -67
- package/src/extension/rpc.ts +0 -881
- package/src/extension/schemas.ts +0 -337
- package/src/extension/steering-notices.ts +0 -35
- package/src/extension/subagent-guide.ts +0 -127
- package/src/extension/subagent-options.ts +0 -47
- package/src/extension/tool-activation.ts +0 -147
- package/src/extension/tool-description.ts +0 -193
- package/src/extension/tool-result.ts +0 -19
- package/src/extension/upgrade-notice.ts +0 -40
- package/src/inspectors/actions.ts +0 -174
- package/src/inspectors/ghostty/actions.ts +0 -74
- package/src/inspectors/ghostty/plugin.ts +0 -29
- package/src/inspectors/herdr/actions.ts +0 -155
- package/src/inspectors/herdr/client.ts +0 -130
- package/src/inspectors/herdr/focus.ts +0 -55
- package/src/inspectors/herdr/plugin.ts +0 -20
- package/src/inspectors/herdr/project-panes.ts +0 -733
- package/src/inspectors/inspector-runner.ts +0 -153
- package/src/inspectors/plugins.ts +0 -76
- package/src/inspectors/session-roots-codec.ts +0 -31
- package/src/inspectors/shell-command.ts +0 -16
- package/src/inspectors/tmux/actions.ts +0 -204
- package/src/inspectors/tmux/client.ts +0 -85
- package/src/inspectors/tmux/plugin.ts +0 -21
- package/src/inspectors/types.ts +0 -51
- package/src/integrations/herdr-status.ts +0 -385
- package/src/integrations/pi-web-session-liveness.ts +0 -73
- package/src/integrations/program-status.ts +0 -215
- package/src/intercom/fork-supervisor-routing.ts +0 -533
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1066
- package/src/intercom/result-intercom.ts +0 -433
- package/src/intercom/supervisor-ui.ts +0 -72
- package/src/missions/actions.ts +0 -433
- package/src/missions/goal-driver.ts +0 -177
- package/src/missions/lifecycle.ts +0 -367
- package/src/missions/store.ts +0 -613
- package/src/missions/types.ts +0 -190
- package/src/missions/workflow-state.ts +0 -281
- package/src/policy/authority.ts +0 -50
- package/src/profiles/profiles.ts +0 -674
- package/src/runs/background/active-async-capacity.ts +0 -548
- package/src/runs/background/active-run-index.ts +0 -155
- package/src/runs/background/async-execution.ts +0 -2479
- package/src/runs/background/async-job-tracker.ts +0 -869
- package/src/runs/background/async-resume.ts +0 -686
- package/src/runs/background/async-retention.ts +0 -953
- package/src/runs/background/async-status-snapshot.ts +0 -46
- package/src/runs/background/async-status.ts +0 -787
- package/src/runs/background/auto-drain.ts +0 -92
- package/src/runs/background/await-async-run.ts +0 -83
- package/src/runs/background/binary-bootstrap.ts +0 -67
- package/src/runs/background/calendar-schedule.ts +0 -90
- package/src/runs/background/chain-append.ts +0 -321
- package/src/runs/background/chain-root-attachment.ts +0 -263
- package/src/runs/background/completion-batcher.ts +0 -168
- package/src/runs/background/completion-dedupe.ts +0 -58
- package/src/runs/background/completion-replay.ts +0 -287
- package/src/runs/background/control-channel.ts +0 -659
- package/src/runs/background/fleet-view.ts +0 -692
- package/src/runs/background/index-segment.ts +0 -59
- package/src/runs/background/inspect-rpc.ts +0 -443
- package/src/runs/background/notify.ts +0 -1083
- package/src/runs/background/owned-process-tree.ts +0 -131
- package/src/runs/background/parallel-groups.ts +0 -45
- package/src/runs/background/pid-namespace.ts +0 -18
- package/src/runs/background/process-terminal-candidate.ts +0 -98
- package/src/runs/background/process-terminal.ts +0 -231
- package/src/runs/background/result-delivery-ownership.ts +0 -45
- package/src/runs/background/result-files.ts +0 -634
- package/src/runs/background/result-watcher.ts +0 -842
- package/src/runs/background/resume-guidance.ts +0 -56
- package/src/runs/background/retained-children.ts +0 -136
- package/src/runs/background/retained-nested-route-tracker.ts +0 -96
- package/src/runs/background/run-child-session.ts +0 -725
- package/src/runs/background/run-id-query.ts +0 -7
- package/src/runs/background/run-id-resolver.ts +0 -183
- package/src/runs/background/run-status.ts +0 -803
- package/src/runs/background/runner-aliases.ts +0 -183
- package/src/runs/background/runner-child-launch.ts +0 -96
- package/src/runs/background/runner-child-sessions.ts +0 -32
- package/src/runs/background/runner-http-dispatcher.ts +0 -122
- package/src/runs/background/runner-startup-failure.ts +0 -56
- package/src/runs/background/scheduled-runs.ts +0 -1222
- package/src/runs/background/stale-run-reconciler.ts +0 -463
- package/src/runs/background/steering.ts +0 -260
- package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
- package/src/runs/background/subagent-runner.ts +0 -5251
- package/src/runs/background/subagent-wait.ts +0 -895
- package/src/runs/background/terminal-run-index.ts +0 -183
- package/src/runs/background/top-level-async.ts +0 -14
- package/src/runs/background/wait-completions.ts +0 -262
- package/src/runs/background/wait-config.ts +0 -50
- package/src/runs/background/wait-subscriptions.ts +0 -354
- package/src/runs/background/wait-tool.ts +0 -57
- package/src/runs/background/workflow-terminal-proof.ts +0 -85
- package/src/runs/foreground/async-dismiss-action.ts +0 -86
- package/src/runs/foreground/async-steering-action.ts +0 -276
- package/src/runs/foreground/async-stop-action.ts +0 -216
- package/src/runs/foreground/command-action.ts +0 -41
- package/src/runs/foreground/execution.ts +0 -2315
- package/src/runs/foreground/foreground-control.ts +0 -157
- package/src/runs/foreground/foreground-history.ts +0 -164
- package/src/runs/foreground/prompt-audit.ts +0 -172
- package/src/runs/foreground/subagent-executor.ts +0 -8252
- package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
- package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
- package/src/runs/shared/abort-recovery.ts +0 -119
- package/src/runs/shared/acceptance.ts +0 -1664
- package/src/runs/shared/agent-contract.ts +0 -38
- package/src/runs/shared/async-status-projection.ts +0 -664
- package/src/runs/shared/background-process-options.ts +0 -9
- package/src/runs/shared/capability-ceiling.ts +0 -214
- package/src/runs/shared/chain-outputs.ts +0 -116
- package/src/runs/shared/child-commands.ts +0 -229
- package/src/runs/shared/child-hooks.ts +0 -175
- package/src/runs/shared/child-identity.ts +0 -62
- package/src/runs/shared/child-launch-plan.ts +0 -163
- package/src/runs/shared/child-launch.ts +0 -389
- package/src/runs/shared/child-lifecycle.ts +0 -28
- package/src/runs/shared/child-runtime-config.ts +0 -136
- package/src/runs/shared/child-session.ts +0 -699
- package/src/runs/shared/child-tool-plan.ts +0 -599
- package/src/runs/shared/claude-code-adapter.ts +0 -288
- package/src/runs/shared/codex-exec-adapter.ts +0 -129
- package/src/runs/shared/context-mode.ts +0 -44
- package/src/runs/shared/cursor-agent-adapter.ts +0 -114
- package/src/runs/shared/dynamic-fanout.ts +0 -297
- package/src/runs/shared/effective-system-prompt.ts +0 -33
- package/src/runs/shared/extension-bindings.ts +0 -103
- package/src/runs/shared/external-cli-contract.ts +0 -177
- package/src/runs/shared/external-cli-preflight.ts +0 -190
- package/src/runs/shared/external-cli-runner.ts +0 -437
- package/src/runs/shared/external-job-bridge.ts +0 -514
- package/src/runs/shared/external-job-runner.ts +0 -389
- package/src/runs/shared/fast-mode-extension.ts +0 -10
- package/src/runs/shared/fork-command-result.ts +0 -10
- package/src/runs/shared/git-environment.ts +0 -29
- package/src/runs/shared/herdr-connection.ts +0 -134
- package/src/runs/shared/herdr-external-adapters.ts +0 -169
- package/src/runs/shared/herdr-machine.ts +0 -279
- package/src/runs/shared/herdr-pi-protocol.ts +0 -59
- package/src/runs/shared/herdr-placed-run.ts +0 -264
- package/src/runs/shared/host-step-status.ts +0 -231
- package/src/runs/shared/lane-metadata.ts +0 -126
- package/src/runs/shared/launch-cwd.ts +0 -16
- package/src/runs/shared/long-running-guard.ts +0 -221
- package/src/runs/shared/mcp-config-sources.ts +0 -426
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
- package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
- package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
- package/src/runs/shared/model-resolution.ts +0 -503
- package/src/runs/shared/model-scope.ts +0 -224
- package/src/runs/shared/mutation-evidence.ts +0 -199
- package/src/runs/shared/nested-events.ts +0 -1125
- package/src/runs/shared/nested-path.ts +0 -38
- package/src/runs/shared/nested-render.ts +0 -127
- package/src/runs/shared/orca-progress-tabs.ts +0 -511
- package/src/runs/shared/parallel-handoff.ts +0 -789
- package/src/runs/shared/parallel-utils.ts +0 -292
- package/src/runs/shared/partial-output.ts +0 -48
- package/src/runs/shared/permissions.ts +0 -86
- package/src/runs/shared/pi-spawn.ts +0 -205
- package/src/runs/shared/process-signal.ts +0 -35
- package/src/runs/shared/profile-extensions.ts +0 -134
- package/src/runs/shared/profile-launch-env.ts +0 -121
- package/src/runs/shared/readonly-drain-observation.ts +0 -42
- package/src/runs/shared/run-fanout-budget.ts +0 -267
- package/src/runs/shared/run-history.ts +0 -288
- package/src/runs/shared/runner-launcher.ts +0 -25
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
- package/src/runs/shared/sandbox-profile-guard.ts +0 -119
- package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
- package/src/runs/shared/session-lease.ts +0 -293
- package/src/runs/shared/single-output.ts +0 -366
- package/src/runs/shared/spawn-budget.ts +0 -128
- package/src/runs/shared/structured-output.ts +0 -463
- package/src/runs/shared/subagent-control.ts +0 -295
- package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
- package/src/runs/shared/tool-availability.ts +0 -37
- package/src/runs/shared/tool-budget.ts +0 -87
- package/src/runs/shared/tool-timeout.ts +0 -93
- package/src/runs/shared/usage-budget.ts +0 -65
- package/src/runs/shared/usage-reconciliation.ts +0 -73
- package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
- package/src/runs/shared/workflow-graph.ts +0 -225
- package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
- package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
- package/src/runs/shared/worktree-lock.ts +0 -29
- package/src/runs/shared/worktree-setup-command.ts +0 -213
- package/src/runs/shared/worktree.ts +0 -1554
- package/src/shared/accessible-dir.ts +0 -47
- package/src/shared/agent-stream-options.ts +0 -5
- package/src/shared/artifacts.ts +0 -281
- package/src/shared/atomic-json.ts +0 -85
- package/src/shared/capacity-resilient-json.ts +0 -102
- package/src/shared/child-cache-retention.ts +0 -43
- package/src/shared/child-session-name.ts +0 -48
- package/src/shared/child-transcript.ts +0 -264
- package/src/shared/completion-owner.ts +0 -14
- package/src/shared/disabled-features.ts +0 -123
- package/src/shared/display-text.ts +0 -150
- package/src/shared/edit-distance.ts +0 -33
- package/src/shared/extension-context.ts +0 -37
- package/src/shared/file-coalescer.ts +0 -49
- package/src/shared/file-lease.ts +0 -74
- package/src/shared/file-system-retry.ts +0 -95
- package/src/shared/fork-context.ts +0 -243
- package/src/shared/fork-session-cwd.ts +0 -27
- package/src/shared/formatters.ts +0 -142
- package/src/shared/jsonl-writer.ts +0 -92
- package/src/shared/launch-contract.ts +0 -206
- package/src/shared/model-info.ts +0 -132
- package/src/shared/model-response-aliases.ts +0 -13
- package/src/shared/node-executable.ts +0 -21
- package/src/shared/opencode-session-headers.ts +0 -30
- package/src/shared/package-version.ts +0 -17
- package/src/shared/parent-wake.ts +0 -79
- package/src/shared/permission-profile.ts +0 -56
- package/src/shared/prompt-resources.ts +0 -11
- package/src/shared/pruned-fork.ts +0 -469
- package/src/shared/required-child-extensions.ts +0 -115
- package/src/shared/runtime-module-path.ts +0 -19
- package/src/shared/sandbox-profile.ts +0 -37
- package/src/shared/session-file-trust.ts +0 -19
- package/src/shared/session-identity.ts +0 -10
- package/src/shared/session-tokens.ts +0 -55
- package/src/shared/settings-file-lease.ts +0 -36
- package/src/shared/settings.ts +0 -412
- package/src/shared/shortcuts.ts +0 -13
- package/src/shared/status-format.ts +0 -55
- package/src/shared/thinking-ceiling.ts +0 -46
- package/src/shared/types.ts +0 -3105
- package/src/shared/utf8.ts +0 -11
- package/src/shared/utils.ts +0 -610
- package/src/shared/watch-strategy.ts +0 -12
- package/src/shared/workflow-child-permit.ts +0 -212
- package/src/slash/delegation-adapters.ts +0 -452
- package/src/slash/delegation-json.ts +0 -108
- package/src/slash/delegation-request.ts +0 -176
- package/src/slash/prompt-template-bridge.ts +0 -435
- package/src/slash/prompt-workflows.ts +0 -298
- package/src/slash/selector.ts +0 -147
- package/src/slash/slash-bridge.ts +0 -192
- package/src/slash/slash-commands.ts +0 -1096
- package/src/slash/slash-live-state.ts +0 -310
- package/src/slash/subagent-cost.ts +0 -317
- package/src/slash/subagents-admin.ts +0 -489
- package/src/tui/fleet-native-transcript.ts +0 -424
- package/src/tui/fleet-status.ts +0 -1139
- package/src/tui/fleet-transcript.ts +0 -591
- package/src/tui/fleet.ts +0 -1618
- package/src/tui/mouse-events.ts +0 -42
- package/src/tui/render-helpers.ts +0 -111
- package/src/tui/render.ts +0 -3824
- package/src/tui/running-tone.ts +0 -28
- package/src/tui/subagent-messages.ts +0 -305
- package/src/ui-silent-marker.ts +0 -32
- package/src/watchdog/change-signature.ts +0 -260
- package/src/watchdog/child-status.ts +0 -225
- package/src/watchdog/diff-tool.ts +0 -112
- package/src/watchdog/emission-guard.ts +0 -125
- package/src/watchdog/guidance.ts +0 -20
- package/src/watchdog/lsp-diagnostics.ts +0 -538
- package/src/watchdog/model-selection.ts +0 -187
- package/src/watchdog/permission-arbiter.ts +0 -154
- package/src/watchdog/register-child.ts +0 -136
- package/src/watchdog/register-main.ts +0 -425
- package/src/watchdog/render.ts +0 -31
- package/src/watchdog/review.ts +0 -362
- package/src/watchdog/rules.ts +0 -70
- package/src/watchdog/runtime.ts +0 -927
- package/src/watchdog/scope.ts +0 -51
- package/src/watchdog/settings.ts +0 -520
- package/src/watchdog/tool-actions.ts +0 -156
- package/src/watchdog/turn-delta.ts +0 -190
- package/src/watchdog/types.ts +0 -186
- package/src/watchdog/warning-format.ts +0 -72
- package/src/workflows/chat-progress.ts +0 -152
- package/src/workflows/host-command.ts +0 -235
- package/src/workflows/scripted-workflow.ts +0 -2733
- package/src/workflows/structured-workflow-scripts.ts +0 -177
- package/src/workflows/workflow-checklist.ts +0 -442
- package/src/workflows/workflow-child-summary.ts +0 -172
- package/src/workflows/workflow-preflight.ts +0 -297
- package/src/workflows/workflow-receipt.ts +0 -390
- package/src/workflows/workflow-resources.ts +0 -275
- package/src/workflows/workflow-reuse.ts +0 -120
- package/src/workflows/workflow-revival.ts +0 -123
- package/src/workflows/workflow-settlement.ts +0 -252
|
@@ -0,0 +1,411 @@
|
|
|
1
|
+
import { splitKnownThinkingSuffix as splitThinkingSuffix } from "../../shared/model-info.js";
|
|
2
|
+
import { checkModelScope, SCOPED_PATTERN } from "./model-scope.js";
|
|
3
|
+
import { editDistance } from "../../shared/edit-distance.js";
|
|
4
|
+
export { splitThinkingSuffix };
|
|
5
|
+
/**
|
|
6
|
+
* Aliases apply only to the resolved launch candidate (without its thinking suffix) and the exact raw response ID.
|
|
7
|
+
* When the child's live selection is a Pi virtual model, assistant messages name the physical model it dispatched
|
|
8
|
+
* to, so the virtual selection's provider/id is compared exactly with the launch candidate instead.
|
|
9
|
+
*/
|
|
10
|
+
export function formatSubagentModelVerificationError(expectedModel, observedModel, availableModels, modelResponseAliases, observedVirtualModel) {
|
|
11
|
+
if (!availableModels || availableModels.length === 0)
|
|
12
|
+
return undefined;
|
|
13
|
+
const expectedBase = splitThinkingSuffix(expectedModel).baseModel;
|
|
14
|
+
if (observedVirtualModel !== undefined) {
|
|
15
|
+
return observedVirtualModel === expectedBase ? undefined : `model_verification_failed: native Pi child selected virtual model '${observedVirtualModel}', but the launch candidate was '${expectedModel}'. modelResponseAliases does not apply to a virtual-model selection.`;
|
|
16
|
+
}
|
|
17
|
+
if (modelResponseAliases && Object.hasOwn(modelResponseAliases, expectedBase)
|
|
18
|
+
&& modelResponseAliases[expectedBase]?.includes(observedModel))
|
|
19
|
+
return undefined;
|
|
20
|
+
const observedBase = splitThinkingSuffix(observedModel).baseModel;
|
|
21
|
+
if (expectedBase === observedBase)
|
|
22
|
+
return undefined;
|
|
23
|
+
const expectedEntry = availableModels.find((entry) => entry.fullId === expectedBase);
|
|
24
|
+
if (expectedEntry) {
|
|
25
|
+
if (expectedEntry.id === observedBase)
|
|
26
|
+
return undefined;
|
|
27
|
+
const expectedIdLeaf = expectedEntry.id.slice(expectedEntry.id.lastIndexOf("/") + 1);
|
|
28
|
+
const expectedFullIdLeaf = expectedEntry.fullId.slice(expectedEntry.fullId.lastIndexOf("/") + 1);
|
|
29
|
+
if (expectedIdLeaf === observedBase || expectedFullIdLeaf === observedBase)
|
|
30
|
+
return undefined;
|
|
31
|
+
}
|
|
32
|
+
return `model_verification_failed: native Pi child reported a different model than the launch candidate. Expected '${expectedModel}' but observed '${observedModel}'. If you have independently verified this response ID identifies the requested model, declare the exact mapping in modelResponseAliases in ~/.pi/agent/extensions/subagent/config.json (see docs/configuration.md#modelresponsealiases). Use the resolved provider/model ID without its thinking suffix as the key. This leaves the outgoing request unchanged. Configuration changes affect new independent native runs; resumed native runs retain their launch-time declaration. External CLI adapters do not use this setting.`;
|
|
33
|
+
}
|
|
34
|
+
/** Sentinel model value requesting that a subagent inherit the parent session's model. */
|
|
35
|
+
export const INHERIT_MODEL = "inherit";
|
|
36
|
+
export function normalizeParentModel(model) {
|
|
37
|
+
if (!model || typeof model !== "object")
|
|
38
|
+
return undefined;
|
|
39
|
+
const candidate = model;
|
|
40
|
+
if (typeof candidate.provider !== "string" || typeof candidate.id !== "string")
|
|
41
|
+
return undefined;
|
|
42
|
+
if (!candidate.provider || !candidate.id)
|
|
43
|
+
return undefined;
|
|
44
|
+
return { provider: candidate.provider, id: candidate.id };
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Provider/id ids of the host session's scoped-model snapshot (`ctx.scopedModels`).
|
|
48
|
+
* Pi reports an empty set when the session is unscoped (nothing configured, or no
|
|
49
|
+
* pattern matched), and then allows every model; `scoped` narrows that to `inherit`.
|
|
50
|
+
*/
|
|
51
|
+
export function scopedModelIdsFromContext(ctx) {
|
|
52
|
+
const scoped = ctx.scopedModels;
|
|
53
|
+
if (!Array.isArray(scoped))
|
|
54
|
+
return [];
|
|
55
|
+
const ids = [];
|
|
56
|
+
for (const entry of scoped) {
|
|
57
|
+
const model = entry?.model;
|
|
58
|
+
const normalized = normalizeParentModel(model);
|
|
59
|
+
if (normalized)
|
|
60
|
+
ids.push(`${normalized.provider}/${normalized.id}`);
|
|
61
|
+
}
|
|
62
|
+
return ids;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Normalize a model id or provider segment for fuzzy comparison: case-fold,
|
|
66
|
+
* treat dots/underscores as dashes (so `4.5` matches `4-5`), and collapse
|
|
67
|
+
* repeated separators.
|
|
68
|
+
*/
|
|
69
|
+
export function normalizeModelSegment(segment) {
|
|
70
|
+
return segment
|
|
71
|
+
.toLowerCase()
|
|
72
|
+
.replace(/[._]+/g, "-")
|
|
73
|
+
.replace(/-+/g, "-")
|
|
74
|
+
.replace(/^-|-$/g, "");
|
|
75
|
+
}
|
|
76
|
+
function isPlausibleDateStamp(year, month, day) {
|
|
77
|
+
const yyyy = Number(year);
|
|
78
|
+
const mm = Number(month);
|
|
79
|
+
const dd = Number(day);
|
|
80
|
+
return yyyy >= 1900 && yyyy <= 2099 && mm >= 1 && mm <= 12 && dd >= 1 && dd <= 31;
|
|
81
|
+
}
|
|
82
|
+
/** Drop a trailing date stamp (`-20251001` or `-2025-10-01`) so dated and undated ids match. */
|
|
83
|
+
function stripTrailingDateStamp(segment) {
|
|
84
|
+
const dashed = /^(.*)-(\d{4})-(\d{2})-(\d{2})$/.exec(segment);
|
|
85
|
+
if (dashed && isPlausibleDateStamp(dashed[2], dashed[3], dashed[4]))
|
|
86
|
+
return dashed[1];
|
|
87
|
+
const compact = /^(.*)-(\d{4})(\d{2})(\d{2})$/.exec(segment);
|
|
88
|
+
if (compact && isPlausibleDateStamp(compact[2], compact[3], compact[4]))
|
|
89
|
+
return compact[1];
|
|
90
|
+
return segment;
|
|
91
|
+
}
|
|
92
|
+
function isRegisteredProvider(provider, availableModels) {
|
|
93
|
+
const normalized = normalizeModelSegment(provider);
|
|
94
|
+
return availableModels.some((entry) => normalizeModelSegment(entry.provider) === normalized);
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Split `provider/id` only when the first path segment is a registered provider.
|
|
98
|
+
* Hugging Face-style `owner/name` ids therefore stay intact unless `owner` is
|
|
99
|
+
* itself a provider in the active registry. `:` and `.` keep the same rule.
|
|
100
|
+
*/
|
|
101
|
+
function splitQualifiedModelQuery(baseModel, availableModels) {
|
|
102
|
+
const slashIdx = baseModel.indexOf("/");
|
|
103
|
+
if (slashIdx !== -1) {
|
|
104
|
+
const providerPart = baseModel.slice(0, slashIdx);
|
|
105
|
+
if (isRegisteredProvider(providerPart, availableModels)) {
|
|
106
|
+
return { queryProvider: normalizeModelSegment(providerPart), queryIdRaw: baseModel.slice(slashIdx + 1) };
|
|
107
|
+
}
|
|
108
|
+
return { queryIdRaw: baseModel };
|
|
109
|
+
}
|
|
110
|
+
const providerSeparators = [":", "."];
|
|
111
|
+
for (const separator of providerSeparators) {
|
|
112
|
+
const separatorIdx = baseModel.indexOf(separator);
|
|
113
|
+
if (separatorIdx <= 0)
|
|
114
|
+
continue;
|
|
115
|
+
const providerPart = baseModel.slice(0, separatorIdx);
|
|
116
|
+
if (!isRegisteredProvider(providerPart, availableModels))
|
|
117
|
+
continue;
|
|
118
|
+
return { queryProvider: normalizeModelSegment(providerPart), queryIdRaw: baseModel.slice(separatorIdx + 1) };
|
|
119
|
+
}
|
|
120
|
+
return { queryIdRaw: baseModel };
|
|
121
|
+
}
|
|
122
|
+
function resolveExactIdMatches(baseModel, availableModels, preferredProvider) {
|
|
123
|
+
const exactMatches = availableModels.filter((entry) => entry.id === baseModel);
|
|
124
|
+
if (preferredProvider) {
|
|
125
|
+
const preferredMatch = exactMatches.find((entry) => entry.provider === preferredProvider);
|
|
126
|
+
if (preferredMatch)
|
|
127
|
+
return preferredMatch.fullId;
|
|
128
|
+
}
|
|
129
|
+
if (exactMatches.length === 1)
|
|
130
|
+
return exactMatches[0].fullId;
|
|
131
|
+
return undefined;
|
|
132
|
+
}
|
|
133
|
+
function resolveBaseModelCandidate(baseModel, availableModels, preferredProvider) {
|
|
134
|
+
const exact = availableModels.find((entry) => entry.fullId === baseModel);
|
|
135
|
+
if (exact)
|
|
136
|
+
return exact.fullId;
|
|
137
|
+
const { queryProvider } = splitQualifiedModelQuery(baseModel, availableModels);
|
|
138
|
+
if (queryProvider === undefined) {
|
|
139
|
+
const exactId = resolveExactIdMatches(baseModel, availableModels, preferredProvider);
|
|
140
|
+
if (exactId)
|
|
141
|
+
return exactId;
|
|
142
|
+
}
|
|
143
|
+
const fuzzy = fuzzyResolveModel(baseModel, availableModels, preferredProvider);
|
|
144
|
+
if (fuzzy || queryProvider === undefined)
|
|
145
|
+
return fuzzy;
|
|
146
|
+
// Some catalogs (OpenRouter's `openrouter/auto-beta`) repeat the provider inside the id.
|
|
147
|
+
const queryId = normalizeModelSegment(baseModel);
|
|
148
|
+
const prefixedIdMatches = availableModels.filter((entry) => normalizeModelSegment(entry.id) === queryId && normalizeModelSegment(entry.provider) === queryProvider);
|
|
149
|
+
return prefixedIdMatches.length === 1 ? prefixedIdMatches[0].fullId : undefined;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Fuzzy-resolve a base model id (thinking suffix already stripped) against the
|
|
153
|
+
* registry, tolerating separator, case, and optional date-stamp differences so
|
|
154
|
+
* users do not have to spell provider/model exactly. A slash is a provider
|
|
155
|
+
* prefix only when that prefix is a registered provider; otherwise the whole
|
|
156
|
+
* string is the model id (Hugging Face `owner/name`). A qualified provider
|
|
157
|
+
* query only matches within the named provider — this never silently switches
|
|
158
|
+
* providers for security/cost-sensitive configs. Returns the matched `fullId`,
|
|
159
|
+
* or `undefined` when there is no match or the match is ambiguous across
|
|
160
|
+
* providers (and no `preferredProvider` disambiguates).
|
|
161
|
+
*/
|
|
162
|
+
export function fuzzyResolveModel(baseModel, availableModels, preferredProvider) {
|
|
163
|
+
const { queryProvider, queryIdRaw } = splitQualifiedModelQuery(baseModel, availableModels);
|
|
164
|
+
const queryId = normalizeModelSegment(queryIdRaw);
|
|
165
|
+
const queryIdNoDate = stripTrailingDateStamp(queryId);
|
|
166
|
+
const candidates = availableModels.filter((entry) => {
|
|
167
|
+
const entryId = normalizeModelSegment(entry.id);
|
|
168
|
+
if (entryId !== queryId && stripTrailingDateStamp(entryId) !== queryIdNoDate)
|
|
169
|
+
return false;
|
|
170
|
+
if (queryProvider !== undefined && normalizeModelSegment(entry.provider) !== queryProvider)
|
|
171
|
+
return false;
|
|
172
|
+
return true;
|
|
173
|
+
});
|
|
174
|
+
if (candidates.length === 0)
|
|
175
|
+
return undefined;
|
|
176
|
+
if (preferredProvider) {
|
|
177
|
+
const preferredProviderNorm = normalizeModelSegment(preferredProvider);
|
|
178
|
+
const preferred = candidates.find((entry) => normalizeModelSegment(entry.provider) === preferredProviderNorm);
|
|
179
|
+
if (preferred)
|
|
180
|
+
return preferred.fullId;
|
|
181
|
+
}
|
|
182
|
+
if (candidates.length === 1)
|
|
183
|
+
return candidates[0].fullId;
|
|
184
|
+
return undefined;
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Resolve a possibly-loose model id to a canonical `provider/id` (plus any
|
|
188
|
+
* thinking suffix). Exact registry matches win; fuzzy normalization
|
|
189
|
+
* (separator/case/date-stamp via {@link fuzzyResolveModel}) is a fallback so
|
|
190
|
+
* spelling differences still resolve. Never switches providers for a qualified
|
|
191
|
+
* query.
|
|
192
|
+
*/
|
|
193
|
+
export function resolveModelCandidate(model, availableModels, preferredProvider) {
|
|
194
|
+
if (!model)
|
|
195
|
+
return undefined;
|
|
196
|
+
if (!availableModels || availableModels.length === 0)
|
|
197
|
+
return model;
|
|
198
|
+
const resolvedWhole = resolveBaseModelCandidate(model, availableModels, preferredProvider);
|
|
199
|
+
if (resolvedWhole)
|
|
200
|
+
return resolvedWhole;
|
|
201
|
+
const { baseModel, thinkingSuffix } = splitThinkingSuffix(model);
|
|
202
|
+
if (!thinkingSuffix)
|
|
203
|
+
return model;
|
|
204
|
+
const resolvedBase = resolveBaseModelCandidate(baseModel, availableModels, preferredProvider);
|
|
205
|
+
if (resolvedBase)
|
|
206
|
+
return `${resolvedBase}${thinkingSuffix}`;
|
|
207
|
+
return model;
|
|
208
|
+
}
|
|
209
|
+
function resolveSubagentModelCandidate(model, availableModels, preferredProvider) {
|
|
210
|
+
if (!availableModels || availableModels.length === 0)
|
|
211
|
+
return model;
|
|
212
|
+
const resolvedWhole = resolveBaseModelCandidate(model, availableModels, preferredProvider);
|
|
213
|
+
if (resolvedWhole)
|
|
214
|
+
return resolvedWhole;
|
|
215
|
+
const { baseModel, thinkingSuffix } = splitThinkingSuffix(model);
|
|
216
|
+
const resolvedBase = thinkingSuffix ? resolveBaseModelCandidate(baseModel, availableModels, preferredProvider) : undefined;
|
|
217
|
+
return resolvedBase ? `${resolvedBase}${thinkingSuffix}` : undefined;
|
|
218
|
+
}
|
|
219
|
+
function suggestAlternateProviderModel(model, availableModels) {
|
|
220
|
+
if (!availableModels || availableModels.length === 0)
|
|
221
|
+
return undefined;
|
|
222
|
+
const { baseModel, thinkingSuffix } = splitThinkingSuffix(model);
|
|
223
|
+
const { queryProvider, queryIdRaw } = splitQualifiedModelQuery(baseModel, availableModels);
|
|
224
|
+
if (queryProvider === undefined)
|
|
225
|
+
return undefined;
|
|
226
|
+
const suggestion = resolveBaseModelCandidate(queryIdRaw, availableModels);
|
|
227
|
+
if (!suggestion)
|
|
228
|
+
return undefined;
|
|
229
|
+
const matched = availableModels.find((entry) => entry.fullId === suggestion);
|
|
230
|
+
if (!matched || normalizeModelSegment(matched.provider) === queryProvider)
|
|
231
|
+
return undefined;
|
|
232
|
+
return `${suggestion}${thinkingSuffix}`;
|
|
233
|
+
}
|
|
234
|
+
const MAX_MODEL_CANDIDATES = 5;
|
|
235
|
+
/** Exact registry ids for an unresolved request: the same id under any provider first, then near spellings. */
|
|
236
|
+
function closestModelCandidates(model, availableModels) {
|
|
237
|
+
if (!availableModels || availableModels.length === 0)
|
|
238
|
+
return [];
|
|
239
|
+
const { baseModel, thinkingSuffix } = splitThinkingSuffix(model);
|
|
240
|
+
const { queryProvider, queryIdRaw } = splitQualifiedModelQuery(baseModel, availableModels);
|
|
241
|
+
const queryId = normalizeModelSegment(queryIdRaw);
|
|
242
|
+
const queryIdNoDate = stripTrailingDateStamp(queryId);
|
|
243
|
+
return availableModels
|
|
244
|
+
.map((entry) => {
|
|
245
|
+
const id = normalizeModelSegment(entry.id);
|
|
246
|
+
const distance = editDistance(queryId, id);
|
|
247
|
+
return {
|
|
248
|
+
fullId: entry.fullId,
|
|
249
|
+
sameId: id === queryId || stripTrailingDateStamp(id) === queryIdNoDate,
|
|
250
|
+
sameProvider: normalizeModelSegment(entry.provider) === queryProvider,
|
|
251
|
+
distance,
|
|
252
|
+
close: distance <= Math.max(2, Math.floor(id.length / 3)),
|
|
253
|
+
};
|
|
254
|
+
})
|
|
255
|
+
.filter((entry) => entry.sameId || entry.close)
|
|
256
|
+
.sort((left, right) => Number(right.sameId) - Number(left.sameId) || left.distance - right.distance || Number(right.sameProvider) - Number(left.sameProvider) || left.fullId.localeCompare(right.fullId))
|
|
257
|
+
.slice(0, MAX_MODEL_CANDIDATES)
|
|
258
|
+
.map((entry) => `${entry.fullId}${thinkingSuffix}`);
|
|
259
|
+
}
|
|
260
|
+
function resolveRequiredSubagentModelCandidate(model, availableModels, preferredProvider) {
|
|
261
|
+
const resolved = resolveSubagentModelCandidate(model, availableModels, preferredProvider);
|
|
262
|
+
if (resolved)
|
|
263
|
+
return resolved;
|
|
264
|
+
const suggestion = suggestAlternateProviderModel(model, availableModels);
|
|
265
|
+
const candidates = closestModelCandidates(model, availableModels).filter((candidate) => candidate !== suggestion);
|
|
266
|
+
throw new Error(`Unknown subagent model '${model}' in the active Pi model registry.${suggestion ? ` Did you mean '${suggestion}'?` : ""}${candidates.length ? ` Closest registry models: ${candidates.join(", ")}.` : ""}`);
|
|
267
|
+
}
|
|
268
|
+
function defaultScopeWarn(violation) {
|
|
269
|
+
console.warn(`[pi-subagents] ${violation.message}`);
|
|
270
|
+
}
|
|
271
|
+
function configuredScopes(scope) {
|
|
272
|
+
return scope ? (Array.isArray(scope) ? scope : [scope]) : [];
|
|
273
|
+
}
|
|
274
|
+
function throwForUnresolvedEnforcedReservedScope(scope, includeMixed = false) {
|
|
275
|
+
const unresolvedReservedScope = configuredScopes(scope)
|
|
276
|
+
.find((entry) => entry.enforce === true && (includeMixed
|
|
277
|
+
? entry.allow?.some((pattern) => pattern === INHERIT_MODEL || pattern === SCOPED_PATTERN)
|
|
278
|
+
: entry.allow?.length === 1 && (entry.allow[0] === INHERIT_MODEL || entry.allow[0] === SCOPED_PATTERN)));
|
|
279
|
+
if (!unresolvedReservedScope)
|
|
280
|
+
return;
|
|
281
|
+
const origin = unresolvedReservedScope.origin ?? "modelScope";
|
|
282
|
+
const token = unresolvedReservedScope.allow?.includes(INHERIT_MODEL) ? INHERIT_MODEL : SCOPED_PATTERN;
|
|
283
|
+
throw new Error(`Cannot enforce subagent model scope (${origin}): '${token}' requires a current parent session model.`);
|
|
284
|
+
}
|
|
285
|
+
function enforceModelScopes(model, scope, source, onWarn) {
|
|
286
|
+
const violations = configuredScopes(scope)
|
|
287
|
+
.map((entry) => checkModelScope(model, entry, source))
|
|
288
|
+
.filter((violation) => violation !== undefined);
|
|
289
|
+
const error = violations.find((violation) => violation.severity === "error");
|
|
290
|
+
if (error)
|
|
291
|
+
throw new Error(error.message);
|
|
292
|
+
for (const violation of violations)
|
|
293
|
+
(onWarn ?? defaultScopeWarn)(violation);
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* Resolve the `--model` override passed to a spawned subagent.
|
|
297
|
+
*
|
|
298
|
+
* When no model is requested (`undefined`, `false`, empty, or the `"inherit"`
|
|
299
|
+
* sentinel), the child must inherit the parent session's *in-memory* model
|
|
300
|
+
* (`provider/id`) instead of being left to resolve its own model. Without an
|
|
301
|
+
* explicit `provider/id`, the child falls back to the global
|
|
302
|
+
* `~/.pi/agent/settings.json` default, which is shared across every open PI
|
|
303
|
+
* session — so a different session that last changed its model in the TUI would
|
|
304
|
+
* silently contaminate this session's subagents (see issue #266). Passing an
|
|
305
|
+
* explicit `provider/id` keeps each session's children isolated to that
|
|
306
|
+
* session's model.
|
|
307
|
+
*
|
|
308
|
+
* An explicitly requested model string is resolved via {@link resolveModelCandidate}.
|
|
309
|
+
* When `options.scope.enforce` is on, an out-of-scope resolved model throws for
|
|
310
|
+
* an explicit (`source: "explicit"`) request and warns for an inherited one,
|
|
311
|
+
* unless strict scope enforcement makes inherited violations hard errors.
|
|
312
|
+
*/
|
|
313
|
+
export function resolveSubagentModelOverride(requestedModel, parentModel, availableModels, preferredProvider, options) {
|
|
314
|
+
const trimmed = typeof requestedModel === "string" ? requestedModel.trim() : "";
|
|
315
|
+
const explicit = trimmed && trimmed !== INHERIT_MODEL ? trimmed : undefined;
|
|
316
|
+
if (!parentModel)
|
|
317
|
+
throwForUnresolvedEnforcedReservedScope(options?.scope, explicit === undefined || options?.source === "inherited");
|
|
318
|
+
let resolved;
|
|
319
|
+
let resolvedFromRegistry = explicit === undefined;
|
|
320
|
+
if (explicit === undefined) {
|
|
321
|
+
resolved = parentModel ? `${parentModel.provider}/${parentModel.id}` : undefined;
|
|
322
|
+
}
|
|
323
|
+
else {
|
|
324
|
+
const candidate = resolveSubagentModelCandidate(explicit, availableModels, preferredProvider);
|
|
325
|
+
if (options?.source === "explicit") {
|
|
326
|
+
resolved = candidate ?? resolveRequiredSubagentModelCandidate(explicit, availableModels, preferredProvider);
|
|
327
|
+
resolvedFromRegistry = true;
|
|
328
|
+
}
|
|
329
|
+
else if (candidate) {
|
|
330
|
+
resolved = candidate;
|
|
331
|
+
resolvedFromRegistry = true;
|
|
332
|
+
}
|
|
333
|
+
else {
|
|
334
|
+
resolved = explicit;
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
if (resolved && options?.scope && resolvedFromRegistry) {
|
|
338
|
+
const source = explicit === undefined ? "inherited" : (options.source ?? "inherited");
|
|
339
|
+
enforceModelScopes(resolved, options.scope, source, options.onWarn);
|
|
340
|
+
}
|
|
341
|
+
return resolved;
|
|
342
|
+
}
|
|
343
|
+
export function resolveEffectiveSubagentModel(explicitModel, agentModel, parentModel, availableModels, preferredProvider, options) {
|
|
344
|
+
const source = options?.source ?? (explicitModel !== undefined ? "explicit" : "inherited");
|
|
345
|
+
const resolved = resolveSubagentModelOverride(explicitModel ?? agentModel, parentModel, availableModels, preferredProvider, { ...options, source });
|
|
346
|
+
if (resolved || explicitModel === undefined)
|
|
347
|
+
return resolved;
|
|
348
|
+
return resolveSubagentModelOverride(agentModel, parentModel, availableModels, preferredProvider, { ...options, source: options?.source ?? "inherited" });
|
|
349
|
+
}
|
|
350
|
+
export function resolveModelOrigin(input) {
|
|
351
|
+
if (input.storedOrigin)
|
|
352
|
+
return input.storedOrigin;
|
|
353
|
+
if (input.fromParent)
|
|
354
|
+
return "inherited";
|
|
355
|
+
if (inheritsParentModel(input.explicitModel, input.agentModel, input.parentModel))
|
|
356
|
+
return "inherited";
|
|
357
|
+
const trimmed = typeof input.explicitModel === "string" ? input.explicitModel.trim() : "";
|
|
358
|
+
return trimmed && trimmed !== INHERIT_MODEL ? "explicit" : "configured";
|
|
359
|
+
}
|
|
360
|
+
export function inheritsParentModel(explicitModel, agentModel, parentModel) {
|
|
361
|
+
const requestedModel = explicitModel ?? agentModel;
|
|
362
|
+
const trimmed = typeof requestedModel === "string" ? requestedModel.trim() : "";
|
|
363
|
+
return Boolean(parentModel && (!trimmed || trimmed === INHERIT_MODEL));
|
|
364
|
+
}
|
|
365
|
+
export function resolveModelSelection(model, availableModels, preferredProvider, options) {
|
|
366
|
+
if (!model)
|
|
367
|
+
throwForUnresolvedEnforcedReservedScope(options?.scope, true);
|
|
368
|
+
const origin = options?.origin ?? (options?.primaryModelFromParent ? "inherited" : "configured");
|
|
369
|
+
const requestedModel = origin === "inherited" ? undefined : model;
|
|
370
|
+
const scopes = configuredScopes(options?.scope);
|
|
371
|
+
if (origin === "explicit" && model) {
|
|
372
|
+
const normalized = resolveRequiredSubagentModelCandidate(model.trim(), availableModels, preferredProvider);
|
|
373
|
+
enforceModelScopes(normalized, scopes, "explicit", options?.onWarn);
|
|
374
|
+
model = normalized;
|
|
375
|
+
}
|
|
376
|
+
const resolved = model && (origin === "inherited" || origin === "explicit" || options?.primaryModelFromParent)
|
|
377
|
+
? model.trim()
|
|
378
|
+
: model ? resolveRequiredSubagentModelCandidate(model.trim(), availableModels, preferredProvider) : undefined;
|
|
379
|
+
if (resolved && scopes.some((scope) => scope.enforce === true && scope.strict === true)) {
|
|
380
|
+
enforceModelScopes(resolved, scopes, "inherited", options?.onWarn);
|
|
381
|
+
}
|
|
382
|
+
return { ...(resolved ? { model: resolved } : {}), ...(requestedModel ? { requestedModel } : {}) };
|
|
383
|
+
}
|
|
384
|
+
/** Context-overflow signals used to surface a clear input-too-large error. */
|
|
385
|
+
const CONTEXT_OVERFLOW_PATTERNS = [
|
|
386
|
+
/context(?: length| window| limit)? (?:exceed|overflow|too long)/i,
|
|
387
|
+
/maximum context length/i,
|
|
388
|
+
/too many tokens/i,
|
|
389
|
+
/token limit/i,
|
|
390
|
+
/context_length_exceeded/i,
|
|
391
|
+
/length_required/i,
|
|
392
|
+
/maximum.*tokens/i,
|
|
393
|
+
/prompt.*too long/i,
|
|
394
|
+
/input.*too long/i,
|
|
395
|
+
/exceeded.*context/i,
|
|
396
|
+
/context.*overflow/i,
|
|
397
|
+
];
|
|
398
|
+
/** Separates an error from the reply text appended to it; classification reads only the part before it. */
|
|
399
|
+
export const ERROR_REPLY_TEXT_SEPARATOR = "\nReply text: ";
|
|
400
|
+
/** The part of a child error that a classifier may read: everything before any appended reply text. */
|
|
401
|
+
export function errorWithoutReplyText(error) {
|
|
402
|
+
return error?.split(ERROR_REPLY_TEXT_SEPARATOR, 1)[0];
|
|
403
|
+
}
|
|
404
|
+
export function isContextOverflow(fullError) {
|
|
405
|
+
const error = errorWithoutReplyText(fullError);
|
|
406
|
+
if (!error)
|
|
407
|
+
return false;
|
|
408
|
+
if (/^[\w.:@/-]+ failed (?:(?:\(exit \d+\):)|(?:with exit code \d+))(?:\s|$)/i.test(error.trim()))
|
|
409
|
+
return false;
|
|
410
|
+
return CONTEXT_OVERFLOW_PATTERNS.some((pattern) => pattern.test(error));
|
|
411
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Optional model-scope enforcement for subagent model resolution.
|
|
3
|
+
*
|
|
4
|
+
* When `subagents.modelScope.enforce` is enabled in settings, a resolved model
|
|
5
|
+
* that does not match any `allow` pattern is rejected. The severity depends on
|
|
6
|
+
* where the model came from: an explicit caller-supplied model (`--model`,
|
|
7
|
+
* tool-call `model`, or a TUI clarify pick) is a hard error, while a model
|
|
8
|
+
* inherited from agent frontmatter / `defaultModel` / the parent session only
|
|
9
|
+
* emits a warning so existing configurations keep working. Optional strict
|
|
10
|
+
* enforcement makes inherited models hard errors too.
|
|
11
|
+
*
|
|
12
|
+
* The decision logic ({@link checkModelScope}) is a pure function of its
|
|
13
|
+
* inputs so it can be unit-tested without touching the filesystem or config.
|
|
14
|
+
*/
|
|
15
|
+
export interface ModelScopeRule {
|
|
16
|
+
enforce?: boolean;
|
|
17
|
+
/** Reject inherited models outside the allowlist instead of warning. */
|
|
18
|
+
strict?: boolean;
|
|
19
|
+
/** Glob-style allow patterns (only `*` is special), matched against `provider/id`. */
|
|
20
|
+
allow?: string[];
|
|
21
|
+
}
|
|
22
|
+
export interface ModelScopeConfig extends ModelScopeRule {
|
|
23
|
+
/** Additional restrictions keyed by canonical agent name. */
|
|
24
|
+
agents?: Record<string, ModelScopeRule>;
|
|
25
|
+
}
|
|
26
|
+
export interface ModelScopeCheckRule extends ModelScopeRule {
|
|
27
|
+
origin?: string;
|
|
28
|
+
}
|
|
29
|
+
export interface ResolvedModelScope extends ModelScopeCheckRule {
|
|
30
|
+
origin: string;
|
|
31
|
+
}
|
|
32
|
+
/** Where a resolved model originated, deciding enforcement severity. */
|
|
33
|
+
export type ModelSource = "explicit" | "inherited";
|
|
34
|
+
export interface ModelScopeViolation {
|
|
35
|
+
/** Resolved model id (without thinking suffix) that fell outside the scope. */
|
|
36
|
+
model: string;
|
|
37
|
+
severity: "warn" | "error";
|
|
38
|
+
message: string;
|
|
39
|
+
allowedPatterns: string[];
|
|
40
|
+
origin: string;
|
|
41
|
+
}
|
|
42
|
+
export declare const SCOPED_PATTERN = "scoped";
|
|
43
|
+
/**
|
|
44
|
+
* Test whether a resolved model matches a single allow pattern. Both sides are
|
|
45
|
+
* compared case-insensitively against the full `provider/id` (thinking suffix
|
|
46
|
+
* stripped from the model).
|
|
47
|
+
*/
|
|
48
|
+
export declare function matchesScopePattern(model: string, pattern: string): boolean;
|
|
49
|
+
/**
|
|
50
|
+
* Pure scope decision. Returns a {@link ModelScopeViolation} when the model is
|
|
51
|
+
* out of scope and enforcement is on, otherwise `undefined`. Enforcement with
|
|
52
|
+
* no `allow` list is a no-op (the settings parser rejects that combination, but
|
|
53
|
+
* this stays defensive for callers that build configs programmatically).
|
|
54
|
+
*/
|
|
55
|
+
export declare function checkModelScope(model: string | undefined, scope: ModelScopeCheckRule | undefined, source: ModelSource): ModelScopeViolation | undefined;
|
|
56
|
+
/** Resolve the global and matching agent policies into independent launch-time checks. */
|
|
57
|
+
export declare function resolveModelScopesForAgent(config: ModelScopeConfig | undefined, agentName: string, parentModel: {
|
|
58
|
+
provider: string;
|
|
59
|
+
id: string;
|
|
60
|
+
} | undefined, scopedModelIds?: readonly string[]): ResolvedModelScope[];
|
|
61
|
+
/**
|
|
62
|
+
* Validate and normalize a raw `subagents.modelScope` value from settings.
|
|
63
|
+
* Throws a descriptive error for malformed configs (matching the surrounding
|
|
64
|
+
* settings-parsing style). Returns `undefined` when the field is absent.
|
|
65
|
+
*/
|
|
66
|
+
export declare function parseModelScopeConfig(value: unknown, meta: {
|
|
67
|
+
filePath: string;
|
|
68
|
+
}): ModelScopeConfig | undefined;
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Optional model-scope enforcement for subagent model resolution.
|
|
3
|
+
*
|
|
4
|
+
* When `subagents.modelScope.enforce` is enabled in settings, a resolved model
|
|
5
|
+
* that does not match any `allow` pattern is rejected. The severity depends on
|
|
6
|
+
* where the model came from: an explicit caller-supplied model (`--model`,
|
|
7
|
+
* tool-call `model`, or a TUI clarify pick) is a hard error, while a model
|
|
8
|
+
* inherited from agent frontmatter / `defaultModel` / the parent session only
|
|
9
|
+
* emits a warning so existing configurations keep working. Optional strict
|
|
10
|
+
* enforcement makes inherited models hard errors too.
|
|
11
|
+
*
|
|
12
|
+
* The decision logic ({@link checkModelScope}) is a pure function of its
|
|
13
|
+
* inputs so it can be unit-tested without touching the filesystem or config.
|
|
14
|
+
*/
|
|
15
|
+
import { splitKnownThinkingSuffix } from "../../shared/model-info.js";
|
|
16
|
+
export const SCOPED_PATTERN = "scoped";
|
|
17
|
+
const MAX_RENDERED_PATTERNS = 8;
|
|
18
|
+
function stripThinkingSuffix(model) {
|
|
19
|
+
return splitKnownThinkingSuffix(model).baseModel;
|
|
20
|
+
}
|
|
21
|
+
/** Escape RegExp specials except `*`, then turn `*` into `.*`. */
|
|
22
|
+
function globToRegExp(pattern) {
|
|
23
|
+
const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
|
|
24
|
+
return new RegExp(`^${escaped}$`, "i");
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Test whether a resolved model matches a single allow pattern. Both sides are
|
|
28
|
+
* compared case-insensitively against the full `provider/id` (thinking suffix
|
|
29
|
+
* stripped from the model).
|
|
30
|
+
*/
|
|
31
|
+
export function matchesScopePattern(model, pattern) {
|
|
32
|
+
return globToRegExp(pattern).test(stripThinkingSuffix(model));
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Pure scope decision. Returns a {@link ModelScopeViolation} when the model is
|
|
36
|
+
* out of scope and enforcement is on, otherwise `undefined`. Enforcement with
|
|
37
|
+
* no `allow` list is a no-op (the settings parser rejects that combination, but
|
|
38
|
+
* this stays defensive for callers that build configs programmatically).
|
|
39
|
+
*/
|
|
40
|
+
export function checkModelScope(model, scope, source) {
|
|
41
|
+
if (!model || !scope?.enforce)
|
|
42
|
+
return undefined;
|
|
43
|
+
const allow = scope.allow;
|
|
44
|
+
if (!allow || allow.length === 0)
|
|
45
|
+
return undefined;
|
|
46
|
+
if (allow.some((pattern) => matchesScopePattern(model, pattern)))
|
|
47
|
+
return undefined;
|
|
48
|
+
const baseModel = stripThinkingSuffix(model);
|
|
49
|
+
const severity = source === "explicit" || scope.strict === true ? "error" : "warn";
|
|
50
|
+
const origin = scope.origin ?? "modelScope";
|
|
51
|
+
const rendered = allow.length <= MAX_RENDERED_PATTERNS
|
|
52
|
+
? allow.join(", ")
|
|
53
|
+
: `${allow.slice(0, MAX_RENDERED_PATTERNS).join(", ")}, … (${allow.length} patterns total)`;
|
|
54
|
+
return {
|
|
55
|
+
model: baseModel,
|
|
56
|
+
severity,
|
|
57
|
+
allowedPatterns: allow,
|
|
58
|
+
origin,
|
|
59
|
+
message: `Model '${baseModel}' is outside the configured subagent model scope (${origin}). ` +
|
|
60
|
+
`Allowed patterns: ${rendered}.`,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/** An empty scoped snapshot degrades `scoped` to `inherit`; absent inputs stay literal so enforced resolution fails closed. */
|
|
64
|
+
function expandReservedPatterns(pattern, parentModel, scopedModelIds) {
|
|
65
|
+
if (pattern === SCOPED_PATTERN) {
|
|
66
|
+
if (scopedModelIds?.length)
|
|
67
|
+
return [...scopedModelIds];
|
|
68
|
+
return parentModel ? [`${parentModel.provider}/${parentModel.id}`] : [pattern];
|
|
69
|
+
}
|
|
70
|
+
if (pattern === "inherit")
|
|
71
|
+
return parentModel ? [`${parentModel.provider}/${parentModel.id}`] : [pattern];
|
|
72
|
+
return [pattern];
|
|
73
|
+
}
|
|
74
|
+
function assertRecord(value, field, meta, expected = "an object") {
|
|
75
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
|
76
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected ${expected}.`);
|
|
77
|
+
}
|
|
78
|
+
return value;
|
|
79
|
+
}
|
|
80
|
+
function parseAllowList(value, field, meta) {
|
|
81
|
+
if (!Array.isArray(value)) {
|
|
82
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected an array of strings.`);
|
|
83
|
+
}
|
|
84
|
+
const allow = [];
|
|
85
|
+
for (const entry of value) {
|
|
86
|
+
if (typeof entry !== "string") {
|
|
87
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected an array of strings.`);
|
|
88
|
+
}
|
|
89
|
+
const trimmed = entry.trim();
|
|
90
|
+
if (trimmed)
|
|
91
|
+
allow.push(trimmed);
|
|
92
|
+
}
|
|
93
|
+
if (allow.length === 0) {
|
|
94
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected a non-empty array of patterns.`);
|
|
95
|
+
}
|
|
96
|
+
return allow;
|
|
97
|
+
}
|
|
98
|
+
function parseScopeRule(input, field, meta) {
|
|
99
|
+
const rule = {};
|
|
100
|
+
if ("enforce" in input) {
|
|
101
|
+
if (typeof input.enforce !== "boolean")
|
|
102
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.enforce'; expected a boolean.`);
|
|
103
|
+
rule.enforce = input.enforce;
|
|
104
|
+
}
|
|
105
|
+
if ("strict" in input) {
|
|
106
|
+
if (typeof input.strict !== "boolean")
|
|
107
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.strict'; expected a boolean.`);
|
|
108
|
+
rule.strict = input.strict;
|
|
109
|
+
}
|
|
110
|
+
if ("allow" in input)
|
|
111
|
+
rule.allow = parseAllowList(input.allow, `${field}.allow`, meta);
|
|
112
|
+
return rule;
|
|
113
|
+
}
|
|
114
|
+
/** Resolve the global and matching agent policies into independent launch-time checks. */
|
|
115
|
+
export function resolveModelScopesForAgent(config, agentName, parentModel, scopedModelIds) {
|
|
116
|
+
if (!config)
|
|
117
|
+
return [];
|
|
118
|
+
const scopes = [];
|
|
119
|
+
if (config.allow) {
|
|
120
|
+
const globalScope = {
|
|
121
|
+
allow: config.allow.flatMap((pattern) => expandReservedPatterns(pattern, parentModel, scopedModelIds)),
|
|
122
|
+
origin: "modelScope",
|
|
123
|
+
};
|
|
124
|
+
if (config.enforce !== undefined)
|
|
125
|
+
globalScope.enforce = config.enforce;
|
|
126
|
+
if (config.strict !== undefined)
|
|
127
|
+
globalScope.strict = config.strict;
|
|
128
|
+
scopes.push(globalScope);
|
|
129
|
+
}
|
|
130
|
+
const agentScope = config.agents?.[agentName];
|
|
131
|
+
if (agentScope?.allow) {
|
|
132
|
+
scopes.push({
|
|
133
|
+
enforce: agentScope.enforce ?? config.enforce,
|
|
134
|
+
strict: agentScope.strict ?? config.strict,
|
|
135
|
+
allow: agentScope.allow.flatMap((pattern) => expandReservedPatterns(pattern, parentModel, scopedModelIds)),
|
|
136
|
+
origin: `modelScope.agents.${agentName}`,
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
return scopes;
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Validate and normalize a raw `subagents.modelScope` value from settings.
|
|
143
|
+
* Throws a descriptive error for malformed configs (matching the surrounding
|
|
144
|
+
* settings-parsing style). Returns `undefined` when the field is absent.
|
|
145
|
+
*/
|
|
146
|
+
export function parseModelScopeConfig(value, meta) {
|
|
147
|
+
if (value === undefined)
|
|
148
|
+
return undefined;
|
|
149
|
+
const input = assertRecord(value, "modelScope", meta);
|
|
150
|
+
const config = parseScopeRule(input, "modelScope", meta);
|
|
151
|
+
if ("agents" in input) {
|
|
152
|
+
const agents = {};
|
|
153
|
+
for (const [rawName, rawScope] of Object.entries(assertRecord(input.agents, "modelScope.agents", meta, "an object keyed by agent name"))) {
|
|
154
|
+
const name = rawName.trim();
|
|
155
|
+
const field = `modelScope.agents.${name}`;
|
|
156
|
+
if (!name)
|
|
157
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.agents' key; expected a non-empty agent name.`);
|
|
158
|
+
const agentInput = assertRecord(rawScope, field, meta);
|
|
159
|
+
if ("agents" in agentInput) {
|
|
160
|
+
throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.agents'; nested agent scopes are not supported.`);
|
|
161
|
+
}
|
|
162
|
+
agents[name] = parseScopeRule(agentInput, field, meta);
|
|
163
|
+
}
|
|
164
|
+
config.agents = agents;
|
|
165
|
+
}
|
|
166
|
+
const hasAnyAllow = Boolean(config.allow?.length) || Object.values(config.agents ?? {}).some((scope) => Boolean(scope.allow?.length));
|
|
167
|
+
if (config.enforce === true && !hasAnyAllow) {
|
|
168
|
+
throw new Error(`Subagent settings in '${meta.filePath}' set modelScope.enforce without a non-empty 'allow' list; supply allowed model patterns or disable enforcement.`);
|
|
169
|
+
}
|
|
170
|
+
return Object.keys(config).length > 0 ? config : undefined;
|
|
171
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ArtifactPaths, TimeoutRecoveryProjection, TimeoutRecoverySummary, TrackedMutationEvidence, TrackedMutationSnapshot } from "../../shared/types.ts";
|
|
2
|
+
export declare function snapshotTrackedMutations(cwd: string): TrackedMutationSnapshot;
|
|
3
|
+
export declare function collectTrackedMutationEvidence(snapshot: TrackedMutationSnapshot, cwd?: string): TrackedMutationEvidence;
|
|
4
|
+
/** Keep status and completion details to bounded routing evidence, not raw output or effects. */
|
|
5
|
+
export declare function projectTimeoutRecovery(value: unknown): TimeoutRecoveryProjection | undefined;
|
|
6
|
+
/** Render only the bounded recovery route needed by a parent/operator. */
|
|
7
|
+
export declare function formatTimeoutRecoveryLines(value: unknown, indent?: string): string[];
|
|
8
|
+
export declare function buildTimeoutRecoverySummary(input: {
|
|
9
|
+
termination: "timed-out" | "stopped";
|
|
10
|
+
evidence: TrackedMutationEvidence;
|
|
11
|
+
requiredOutputMissing?: boolean;
|
|
12
|
+
currentTool?: string;
|
|
13
|
+
currentToolArgs?: string;
|
|
14
|
+
currentPath?: string;
|
|
15
|
+
sessionFile?: string;
|
|
16
|
+
transcriptPath?: string;
|
|
17
|
+
artifactPaths?: ArtifactPaths;
|
|
18
|
+
}): TimeoutRecoverySummary;
|