@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,319 @@
|
|
|
1
|
+
import { Agent } from "@earendil-works/pi-agent-core";
|
|
2
|
+
import { createReadOnlyTools, convertToLlm } from "@earendil-works/pi-coding-agent";
|
|
3
|
+
import { Type } from "typebox";
|
|
4
|
+
import { resolveModelCandidate } from "../runs/shared/model-resolution.js";
|
|
5
|
+
import { agentStreamOptions } from "../shared/agent-stream-options.js";
|
|
6
|
+
import { opencodeSessionHeaders } from "../shared/opencode-session-headers.js";
|
|
7
|
+
import { resolveEffectiveThinking, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo } from "../shared/model-info.js";
|
|
8
|
+
import { createWatchdogDiffTool, WATCHDOG_DIFF_TOOL_NAME } from "./diff-tool.js";
|
|
9
|
+
import { loadWatchdogGuidance } from "./guidance.js";
|
|
10
|
+
import { boundWatchdogReviewText } from "./runtime.js";
|
|
11
|
+
import { WATCHDOG_WARNING_CATEGORIES, WATCHDOG_WARNING_IMPORTANCES, WATCHDOG_WARNING_SEVERITIES, } from "./types.js";
|
|
12
|
+
const WATCHDOG_ALLOWED_TOOL_NAMES = new Set(["read", "grep", "find", "ls", "watchdog_warn", WATCHDOG_DIFF_TOOL_NAME]);
|
|
13
|
+
const WatchdogAskParams = Type.Object({ question: Type.String(), evidence: Type.String() }, { additionalProperties: false });
|
|
14
|
+
const WatchdogWarnParams = Type.Object({
|
|
15
|
+
severity: Type.String({ enum: WATCHDOG_WARNING_SEVERITIES, description: "concern for actionable risk, blocker for a likely wrong or unsafe outcome" }),
|
|
16
|
+
importance: Type.String({ enum: WATCHDOG_WARNING_IMPORTANCES, description: "low or medium for user-only visibility; high when the parent model must receive the finding" }),
|
|
17
|
+
summary: Type.String({ description: "One concise sentence naming the issue." }),
|
|
18
|
+
evidence: Type.String({ description: "Specific evidence from the turn delta or inspected files." }),
|
|
19
|
+
recommendedAction: Type.String({ description: "Specific action the parent should take before accepting or continuing." }),
|
|
20
|
+
category: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CATEGORIES })),
|
|
21
|
+
}, { additionalProperties: false });
|
|
22
|
+
function fullModelId(model) {
|
|
23
|
+
return `${model.provider}/${model.id}`;
|
|
24
|
+
}
|
|
25
|
+
function splitProviderModel(value) {
|
|
26
|
+
const slashIndex = value.indexOf("/");
|
|
27
|
+
if (slashIndex <= 0 || slashIndex === value.length - 1)
|
|
28
|
+
return undefined;
|
|
29
|
+
return { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };
|
|
30
|
+
}
|
|
31
|
+
function assertThinkingLevel(value, source) {
|
|
32
|
+
if (THINKING_LEVELS.includes(value))
|
|
33
|
+
return value;
|
|
34
|
+
throw new Error(`Unsupported watchdog thinking level '${value}' from ${source}; expected ${THINKING_LEVELS.join(", ")} or false.`);
|
|
35
|
+
}
|
|
36
|
+
function contextThinkingLevel(ctx, currentThinkingLevel) {
|
|
37
|
+
if (currentThinkingLevel)
|
|
38
|
+
return currentThinkingLevel;
|
|
39
|
+
const value = ctx.thinkingLevel;
|
|
40
|
+
return typeof value === "string" && THINKING_LEVELS.includes(value) ? value : undefined;
|
|
41
|
+
}
|
|
42
|
+
function resolveReviewThinking(input) {
|
|
43
|
+
const fromModelOrConfig = resolveEffectiveThinking(input.modelString, input.configThinking);
|
|
44
|
+
if (fromModelOrConfig)
|
|
45
|
+
return assertThinkingLevel(fromModelOrConfig, "watchdog model/config");
|
|
46
|
+
if (input.configThinking === false)
|
|
47
|
+
return "off";
|
|
48
|
+
if (input.configThinking !== undefined)
|
|
49
|
+
return assertThinkingLevel(input.configThinking, "watchdog config");
|
|
50
|
+
if (input.allowContextThinking)
|
|
51
|
+
return contextThinkingLevel(input.ctx, input.currentThinkingLevel) ?? "off";
|
|
52
|
+
return "off";
|
|
53
|
+
}
|
|
54
|
+
function resolveConfiguredModel(ctx, rawModel) {
|
|
55
|
+
const availableModels = ctx.modelRegistry.getAvailable().map(toModelInfo);
|
|
56
|
+
const preferredProvider = typeof ctx.model?.provider === "string" ? ctx.model.provider : undefined;
|
|
57
|
+
const resolved = resolveModelCandidate(rawModel, availableModels, preferredProvider);
|
|
58
|
+
if (!resolved) {
|
|
59
|
+
throw new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);
|
|
60
|
+
}
|
|
61
|
+
const { baseModel } = splitKnownThinkingSuffix(resolved);
|
|
62
|
+
const named = splitProviderModel(baseModel);
|
|
63
|
+
if (!named) {
|
|
64
|
+
throw new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);
|
|
65
|
+
}
|
|
66
|
+
const model = ctx.modelRegistry.find(named.provider, named.id);
|
|
67
|
+
if (!model)
|
|
68
|
+
throw new Error(`Configured watchdog model '${rawModel}' was not found as '${baseModel}'.`);
|
|
69
|
+
if (!ctx.modelRegistry.hasConfiguredAuth(model)) {
|
|
70
|
+
throw new Error(`Configured watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);
|
|
71
|
+
}
|
|
72
|
+
return { model, modelString: resolved };
|
|
73
|
+
}
|
|
74
|
+
class WatchdogAuthError extends Error {
|
|
75
|
+
}
|
|
76
|
+
async function resolveReviewAuth(ctx, model) {
|
|
77
|
+
let auth;
|
|
78
|
+
try {
|
|
79
|
+
auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
throw new WatchdogAuthError(`Watchdog model auth failed for ${fullModelId(model)}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
83
|
+
}
|
|
84
|
+
if (auth.ok === false)
|
|
85
|
+
throw new WatchdogAuthError(`Watchdog model auth failed for ${fullModelId(model)}: ${auth.error}`);
|
|
86
|
+
return {
|
|
87
|
+
...(auth.apiKey ? { apiKey: auth.apiKey } : {}),
|
|
88
|
+
...(auth.headers ? { headers: auth.headers } : {}),
|
|
89
|
+
...(auth.env ? { env: auth.env } : {}),
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
export async function resolveWatchdogReviewModel(ctx, config, options = {}) {
|
|
93
|
+
if (config.main.model) {
|
|
94
|
+
const resolved = resolveConfiguredModel(ctx, config.main.model);
|
|
95
|
+
return {
|
|
96
|
+
model: resolved.model,
|
|
97
|
+
thinkingLevel: resolveReviewThinking({
|
|
98
|
+
modelString: resolved.modelString,
|
|
99
|
+
configThinking: config.main.thinking,
|
|
100
|
+
ctx,
|
|
101
|
+
allowContextThinking: false,
|
|
102
|
+
currentThinkingLevel: options.currentThinkingLevel,
|
|
103
|
+
}),
|
|
104
|
+
auth: await resolveReviewAuth(ctx, resolved.model),
|
|
105
|
+
explicit: true,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
const currentModel = ctx.model;
|
|
109
|
+
if (!currentModel) {
|
|
110
|
+
throw new Error("Main watchdog review cannot run because the current Pi session model is unavailable and subagents.watchdog.main.model is not configured.");
|
|
111
|
+
}
|
|
112
|
+
return {
|
|
113
|
+
model: currentModel,
|
|
114
|
+
thinkingLevel: resolveReviewThinking({
|
|
115
|
+
modelString: fullModelId(currentModel),
|
|
116
|
+
configThinking: config.main.thinking,
|
|
117
|
+
ctx,
|
|
118
|
+
allowContextThinking: true,
|
|
119
|
+
currentThinkingLevel: options.currentThinkingLevel,
|
|
120
|
+
}),
|
|
121
|
+
auth: await resolveReviewAuth(ctx, currentModel),
|
|
122
|
+
explicit: false,
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
function nonEmptyString(value, field) {
|
|
126
|
+
const trimmed = value.trim();
|
|
127
|
+
if (!trimmed)
|
|
128
|
+
throw new Error(`watchdog_warn.${field} must be a non-empty string.`);
|
|
129
|
+
return trimmed;
|
|
130
|
+
}
|
|
131
|
+
function toWatchdogWarning(params) {
|
|
132
|
+
return {
|
|
133
|
+
severity: params.severity,
|
|
134
|
+
importance: params.importance,
|
|
135
|
+
category: (params.category ?? "other"),
|
|
136
|
+
source: "main",
|
|
137
|
+
summary: nonEmptyString(params.summary, "summary"),
|
|
138
|
+
evidence: nonEmptyString(params.evidence, "evidence"),
|
|
139
|
+
recommendedAction: nonEmptyString(params.recommendedAction, "recommendedAction"),
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
function createWatchdogWarnTool(request) {
|
|
143
|
+
return {
|
|
144
|
+
name: "watchdog_warn",
|
|
145
|
+
label: "Watchdog warning",
|
|
146
|
+
description: [
|
|
147
|
+
"Emit one actionable main-session watchdog warning.",
|
|
148
|
+
"Set importance explicitly: low or medium for user-only visibility, high only when the parent model must receive the finding.",
|
|
149
|
+
"Do not use for nits, praise, informational notes, or clean reviews.",
|
|
150
|
+
].join(" "),
|
|
151
|
+
parameters: WatchdogWarnParams,
|
|
152
|
+
executionMode: "sequential",
|
|
153
|
+
async execute(_toolCallId, params) {
|
|
154
|
+
const warning = toWatchdogWarning(params);
|
|
155
|
+
const accepted = request.emitWarning(warning);
|
|
156
|
+
return {
|
|
157
|
+
content: [{
|
|
158
|
+
type: "text",
|
|
159
|
+
text: accepted
|
|
160
|
+
? "Watchdog warning recorded."
|
|
161
|
+
: "Watchdog warning was ignored by the runtime guard because it was stale, duplicate, or over budget.",
|
|
162
|
+
}],
|
|
163
|
+
details: { accepted },
|
|
164
|
+
};
|
|
165
|
+
},
|
|
166
|
+
};
|
|
167
|
+
}
|
|
168
|
+
export function formatWatchdogCwdSection(cwd) {
|
|
169
|
+
if (/[\p{Cc}\p{Zl}\p{Zp}<>]/u.test(cwd))
|
|
170
|
+
throw new Error("Watchdog cwd cannot contain control, line-separator, or angle-bracket characters.");
|
|
171
|
+
return `<cwd>\n${cwd}\n</cwd>`;
|
|
172
|
+
}
|
|
173
|
+
export function buildWatchdogSystemPrompt(ctx, options = {}) {
|
|
174
|
+
const guidance = options.guidance?.trim();
|
|
175
|
+
return [
|
|
176
|
+
"You are the main-session subagent watchdog for Pi.",
|
|
177
|
+
"Review only the supplied parent turn delta. Inspect repository files only when needed to verify a concrete concern.",
|
|
178
|
+
options.hasScope ? "Use the Current scope record alongside supplied activity evidence; an unrelated user question does not cancel older authorized work." : undefined,
|
|
179
|
+
`You are read-only. You may use ${options.hasDiff ? "read, grep, find, ls, and watchdog_diff (the full repo diff since the session baseline; pass a path to narrow it)" : "read, grep, find, and ls"}. Do not edit files, run shell commands, spawn agents, or mutate state.`,
|
|
180
|
+
"Emit warnings only by calling watchdog_warn. Freeform assistant text is ignored and must not be used to report warnings.",
|
|
181
|
+
"Emit only actionable concerns or blockers: missed user constraints, correctness risks, test gaps that matter, unsafe changes, stale facts, loop risks, or scope drift.",
|
|
182
|
+
"Do not emit nits, style preferences, unsupported guesses, informational notes, praise, or summaries.",
|
|
183
|
+
"If the turn is clean, call no tools and end normally.",
|
|
184
|
+
"Use severity='blocker' only when the issue should stop acceptance until addressed; otherwise use severity='concern'.",
|
|
185
|
+
guidance ? `\nStanding instructions from WATCHDOG.md (project first, then user):\n${guidance}` : undefined,
|
|
186
|
+
`\n${formatWatchdogCwdSection(ctx.cwd)}`,
|
|
187
|
+
].filter((line) => Boolean(line)).join("\n");
|
|
188
|
+
}
|
|
189
|
+
function buildReviewPrompt(request, selection) {
|
|
190
|
+
return [
|
|
191
|
+
"Review this parent-session turn delta for subagent-watchdog-worthy issues.",
|
|
192
|
+
`Review id: ${request.reviewId}; epoch: ${request.epoch}; review model: ${fullModelId(selection.model)}; thinking: ${selection.thinkingLevel}.`,
|
|
193
|
+
"Call watchdog_warn for each qualifying concern or blocker. Call no tools when clean.",
|
|
194
|
+
"<turn_delta>",
|
|
195
|
+
request.delta,
|
|
196
|
+
"</turn_delta>",
|
|
197
|
+
].join("\n\n");
|
|
198
|
+
}
|
|
199
|
+
function resolveContext(provider) {
|
|
200
|
+
return typeof provider === "function" ? provider() : provider;
|
|
201
|
+
}
|
|
202
|
+
export function createMainWatchdogReview(provider, options = {}) {
|
|
203
|
+
return async (request) => {
|
|
204
|
+
const ctx = resolveContext(provider);
|
|
205
|
+
if (!ctx)
|
|
206
|
+
throw new Error("Main watchdog review cannot run without an active Pi extension context.");
|
|
207
|
+
const aborted = () => ctx.signal?.aborted || request.signal?.aborted;
|
|
208
|
+
if (aborted())
|
|
209
|
+
return { stopReason: "aborted" };
|
|
210
|
+
try {
|
|
211
|
+
return (await runWatchdogAttempt(ctx, request, options)).result;
|
|
212
|
+
}
|
|
213
|
+
catch (error) {
|
|
214
|
+
if (error instanceof WatchdogAuthError)
|
|
215
|
+
throw error.cause ?? error;
|
|
216
|
+
throw error;
|
|
217
|
+
}
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
async function runWatchdogAttempt(ctx, request, options) {
|
|
221
|
+
const selection = await resolveWatchdogReviewModel(ctx, request.config, {
|
|
222
|
+
currentThinkingLevel: options.getThinkingLevel?.(),
|
|
223
|
+
});
|
|
224
|
+
if (ctx.signal?.aborted || request.signal?.aborted)
|
|
225
|
+
return { result: { stopReason: "aborted" } };
|
|
226
|
+
const auth = selection.auth;
|
|
227
|
+
const baseStreamFn = (options.streamFn ?? ((model, context, streamOptions) => ctx.modelRegistry.streamSimple(model, context, streamOptions)));
|
|
228
|
+
const sessionId = ctx.sessionManager.getSessionId();
|
|
229
|
+
const streamFn = (model, context, streamOptions) => {
|
|
230
|
+
// Agent may enter one final loop iteration after an aborted mixed tool batch.
|
|
231
|
+
// Never send that iteration to the provider after an intentional yield.
|
|
232
|
+
if (clarification)
|
|
233
|
+
throw new Error("Watchdog review yielded for clarification.");
|
|
234
|
+
return baseStreamFn(model, context, {
|
|
235
|
+
...streamOptions,
|
|
236
|
+
...(auth.apiKey ? { apiKey: auth.apiKey } : {}),
|
|
237
|
+
env: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,
|
|
238
|
+
headers: { ...opencodeSessionHeaders(model, sessionId), ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },
|
|
239
|
+
});
|
|
240
|
+
};
|
|
241
|
+
const diffBaseline = await options.diffBaseline?.();
|
|
242
|
+
let clarification;
|
|
243
|
+
let warned = false;
|
|
244
|
+
let toolCount = 0;
|
|
245
|
+
const warnRequest = request.allowClarification ? { ...request, emitWarning: (warning) => {
|
|
246
|
+
if (clarification)
|
|
247
|
+
return false;
|
|
248
|
+
const accepted = request.emitWarning(warning);
|
|
249
|
+
warned ||= accepted;
|
|
250
|
+
return accepted;
|
|
251
|
+
} } : request;
|
|
252
|
+
const tools = [
|
|
253
|
+
...(options.createReadOnlyTools ?? createReadOnlyTools)(ctx.cwd).filter((tool) => WATCHDOG_ALLOWED_TOOL_NAMES.has(tool.name) && tool.name !== "watchdog_warn"),
|
|
254
|
+
createWatchdogWarnTool(warnRequest),
|
|
255
|
+
...(diffBaseline ? [createWatchdogDiffTool(diffBaseline)] : []),
|
|
256
|
+
];
|
|
257
|
+
if (request.allowClarification)
|
|
258
|
+
tools.push({
|
|
259
|
+
name: "watchdog_ask",
|
|
260
|
+
label: "Watchdog clarification",
|
|
261
|
+
description: "Send one focused question when missing task status, intent or other orchestrator context prevents a concrete review judgment. Yields and ends this review so the orchestrator can handle the message and continue; no answer or follow-up review is required. Never ask for approval or permission, or after recording a warning. Question and evidence are capped at 1000 and 2000 characters.",
|
|
262
|
+
parameters: WatchdogAskParams,
|
|
263
|
+
executionMode: "sequential",
|
|
264
|
+
async execute(_id, rawParams) {
|
|
265
|
+
const params = rawParams;
|
|
266
|
+
if (warned || clarification || ctx.signal?.aborted || request.signal?.aborted)
|
|
267
|
+
throw new Error("Clarification unavailable after warning, yield, or cancellation.");
|
|
268
|
+
if (!params.question.trim() || !params.evidence.trim())
|
|
269
|
+
throw new Error("A focused question and concrete evidence are required.");
|
|
270
|
+
clarification = { question: boundWatchdogReviewText(params.question.trim(), 1_000), evidence: boundWatchdogReviewText(params.evidence.trim(), 2_000) };
|
|
271
|
+
agent.abort(); // Intentional yield also stops mixed tool batches; terminate alone does not.
|
|
272
|
+
return { content: [{ type: "text", text: "Review yielded for clarification." }], details: {} };
|
|
273
|
+
},
|
|
274
|
+
});
|
|
275
|
+
const systemPrompt = buildWatchdogSystemPrompt(ctx, {
|
|
276
|
+
hasScope: request.hasScope,
|
|
277
|
+
guidance: loadWatchdogGuidance(ctx.cwd, request.config.guidance.watchdogMd),
|
|
278
|
+
hasDiff: diffBaseline !== undefined,
|
|
279
|
+
});
|
|
280
|
+
const agent = new Agent({
|
|
281
|
+
initialState: {
|
|
282
|
+
systemPrompt,
|
|
283
|
+
model: selection.model,
|
|
284
|
+
thinkingLevel: selection.thinkingLevel,
|
|
285
|
+
tools,
|
|
286
|
+
},
|
|
287
|
+
convertToLlm,
|
|
288
|
+
...agentStreamOptions(streamFn),
|
|
289
|
+
getApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,
|
|
290
|
+
beforeToolCall: async ({ toolCall }) => !clarification && (WATCHDOG_ALLOWED_TOOL_NAMES.has(toolCall.name) || (request.allowClarification && toolCall.name === "watchdog_ask"))
|
|
291
|
+
? undefined
|
|
292
|
+
: { block: true, reason: `Watchdog reviews are read-only; tool '${toolCall.name}' is not allowed.` },
|
|
293
|
+
toolExecution: "sequential",
|
|
294
|
+
});
|
|
295
|
+
// Include rejected/invalid calls as well as read-only work and findings.
|
|
296
|
+
agent.subscribe((event) => { if (event.type === "tool_execution_start")
|
|
297
|
+
toolCount++; });
|
|
298
|
+
const abort = () => agent.abort();
|
|
299
|
+
ctx.signal?.addEventListener("abort", abort, { once: true });
|
|
300
|
+
request.signal?.addEventListener("abort", abort, { once: true });
|
|
301
|
+
try {
|
|
302
|
+
if (ctx.signal?.aborted || request.signal?.aborted)
|
|
303
|
+
return { result: { stopReason: "aborted" } };
|
|
304
|
+
await agent.prompt(buildReviewPrompt(request, selection));
|
|
305
|
+
}
|
|
306
|
+
finally {
|
|
307
|
+
ctx.signal?.removeEventListener("abort", abort);
|
|
308
|
+
request.signal?.removeEventListener("abort", abort);
|
|
309
|
+
}
|
|
310
|
+
if (ctx.signal?.aborted || request.signal?.aborted)
|
|
311
|
+
return { result: { stopReason: "aborted" } };
|
|
312
|
+
const terminal = agent.state.messages.findLast((message) => message.role === "assistant");
|
|
313
|
+
const reason = terminal && "stopReason" in terminal ? terminal.stopReason : undefined;
|
|
314
|
+
const stopReason = reason === "error" || reason === "aborted" || reason === "length" ? reason : "stop";
|
|
315
|
+
const error = terminal && "errorMessage" in terminal && typeof terminal.errorMessage === "string" ? terminal.errorMessage : undefined;
|
|
316
|
+
return {
|
|
317
|
+
result: clarification ? { clarification } : error ? { stopReason, errorMessage: error } : { stopReason },
|
|
318
|
+
};
|
|
319
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { WatchdogRulesConfig, WatchdogWarning } from "./types.ts";
|
|
3
|
+
export interface WatchdogRuleViolation {
|
|
4
|
+
agent: string;
|
|
5
|
+
summary: string;
|
|
6
|
+
evidence: string;
|
|
7
|
+
recommendedAction: string;
|
|
8
|
+
}
|
|
9
|
+
/** `*` matches any run of characters, `?` one character; anchored, case-sensitive. */
|
|
10
|
+
export declare function watchdogGlobMatch(pattern: string, value: string): boolean;
|
|
11
|
+
/** Deny wins over allow; an unknown model cannot be judged. */
|
|
12
|
+
export declare function evaluateLaunchRule(rules: WatchdogRulesConfig | undefined, agent: string, model: string | undefined): WatchdogRuleViolation | undefined;
|
|
13
|
+
export declare function ruleViolationWarning(violation: WatchdogRuleViolation): WatchdogWarning;
|
|
14
|
+
export declare function applyWatchdogLaunchRules(input: {
|
|
15
|
+
cwd: string;
|
|
16
|
+
agent: string;
|
|
17
|
+
model?: string;
|
|
18
|
+
warn?: (violation: WatchdogRuleViolation) => void;
|
|
19
|
+
}): string | undefined;
|
|
20
|
+
/** For launch paths without a main watchdog runtime (background chain steps). */
|
|
21
|
+
export declare function sendRuleViolationWarning(pi: Pick<ExtensionAPI, "sendMessage">, violation: WatchdogRuleViolation): void;
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { splitKnownThinkingSuffix } from "../shared/model-info.js";
|
|
2
|
+
import { resolveWatchdogConfig } from "./settings.js";
|
|
3
|
+
import { createWatchdogWarningMessage } from "./warning-format.js";
|
|
4
|
+
function loadWatchdogLaunchRules(cwd) {
|
|
5
|
+
const result = resolveWatchdogConfig(cwd);
|
|
6
|
+
return result.ok ? result.config.rules : undefined;
|
|
7
|
+
}
|
|
8
|
+
/** `*` matches any run of characters, `?` one character; anchored, case-sensitive. */
|
|
9
|
+
export function watchdogGlobMatch(pattern, value) {
|
|
10
|
+
const source = pattern.split("").map((char) => char === "*" ? ".*" : char === "?" ? "." : char.replace(/[.+^${}()|[\]\\]/g, "\\$&")).join("");
|
|
11
|
+
return new RegExp(`^${source}$`).test(value);
|
|
12
|
+
}
|
|
13
|
+
function modelMatches(patterns, model) {
|
|
14
|
+
const base = splitKnownThinkingSuffix(model).baseModel;
|
|
15
|
+
return patterns.find((pattern) => watchdogGlobMatch(pattern, model) || watchdogGlobMatch(pattern, base));
|
|
16
|
+
}
|
|
17
|
+
/** Deny wins over allow; an unknown model cannot be judged. */
|
|
18
|
+
export function evaluateLaunchRule(rules, agent, model) {
|
|
19
|
+
const roleRule = rules?.roleModels[agent];
|
|
20
|
+
if (!roleRule || !model)
|
|
21
|
+
return undefined;
|
|
22
|
+
const note = roleRule.note ? ` ${roleRule.note}` : "";
|
|
23
|
+
const denied = roleRule.deny?.length ? modelMatches(roleRule.deny, model) : undefined;
|
|
24
|
+
if (denied !== undefined) {
|
|
25
|
+
return {
|
|
26
|
+
agent,
|
|
27
|
+
summary: `Agent '${agent}' was launched with denied model '${model}'.`,
|
|
28
|
+
evidence: `subagents.watchdog.rules.roleModels.${agent}.deny matches '${denied}'.${note}`,
|
|
29
|
+
recommendedAction: roleRule.allow?.length ? `Use one of: ${roleRule.allow.join(", ")}.` : "Choose a different model for this role.",
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
if (!roleRule.allow?.length || modelMatches(roleRule.allow, model) !== undefined)
|
|
33
|
+
return undefined;
|
|
34
|
+
return {
|
|
35
|
+
agent,
|
|
36
|
+
summary: `Agent '${agent}' was launched with model '${model}', which is not in its allowed list.`,
|
|
37
|
+
evidence: `subagents.watchdog.rules.roleModels.${agent}.allow is [${roleRule.allow.join(", ")}].${note}`,
|
|
38
|
+
recommendedAction: `Use one of: ${roleRule.allow.join(", ")}.`,
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
export function ruleViolationWarning(violation) {
|
|
42
|
+
return { severity: "concern", category: "missed-constraint", importance: "high", source: "main", ...violation };
|
|
43
|
+
}
|
|
44
|
+
export function applyWatchdogLaunchRules(input) {
|
|
45
|
+
const rules = loadWatchdogLaunchRules(input.cwd);
|
|
46
|
+
const violation = evaluateLaunchRule(rules, input.agent, input.model);
|
|
47
|
+
if (!violation)
|
|
48
|
+
return undefined;
|
|
49
|
+
if (rules?.action === "block")
|
|
50
|
+
return `Launch blocked by subagents.watchdog.rules: ${violation.summary}`;
|
|
51
|
+
input.warn?.(violation);
|
|
52
|
+
return undefined;
|
|
53
|
+
}
|
|
54
|
+
/** For launch paths without a main watchdog runtime (background chain steps). */
|
|
55
|
+
export function sendRuleViolationWarning(pi, violation) {
|
|
56
|
+
const warning = ruleViolationWarning(violation);
|
|
57
|
+
pi.sendMessage(createWatchdogWarningMessage(warning, { display: true, details: { state: "displayed", displayedAt: new Date().toISOString() } }), { deliverAs: "steer" });
|
|
58
|
+
}
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
import type { ExtensionContext, InputEvent } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import { computeWatchdogRepoChangeSignature } from "./change-signature.ts";
|
|
3
|
+
import { type WatchdogLspDiagnosticsFunction } from "./lsp-diagnostics.ts";
|
|
4
|
+
import { type WatchdogRuleViolation } from "./rules.ts";
|
|
5
|
+
import { type ResolvedWatchdogConfig, type WatchdogEndpointConfig, type WatchdogLspRuntimeSnapshot, type WatchdogRuntimeStatus, type WatchdogSettingsError, type WatchdogSettingsResult, type WatchdogSettingsSource, type WatchdogWarning, type WatchdogWarningDetails } from "./types.ts";
|
|
6
|
+
type ReviewStopReason = "stop" | "error" | "aborted" | "length";
|
|
7
|
+
export interface WatchdogReviewResult {
|
|
8
|
+
warnings?: WatchdogWarning[];
|
|
9
|
+
stopReason?: ReviewStopReason;
|
|
10
|
+
/** Provider error text for a failed review, surfaced in status `Last error`. */
|
|
11
|
+
errorMessage?: string;
|
|
12
|
+
clarification?: {
|
|
13
|
+
question: string;
|
|
14
|
+
evidence: string;
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
export interface WatchdogReviewRequest {
|
|
18
|
+
delta: string;
|
|
19
|
+
epoch: number;
|
|
20
|
+
hasScope: boolean;
|
|
21
|
+
reviewId: number;
|
|
22
|
+
config: ResolvedWatchdogConfig;
|
|
23
|
+
emitWarning(warning: WatchdogWarning): boolean;
|
|
24
|
+
allowClarification?: boolean;
|
|
25
|
+
signal?: AbortSignal;
|
|
26
|
+
}
|
|
27
|
+
export type WatchdogReviewFunction = (request: WatchdogReviewRequest) => Promise<WatchdogReviewResult | void> | WatchdogReviewResult | void;
|
|
28
|
+
export interface WatchdogRuntimeSnapshot {
|
|
29
|
+
status: WatchdogRuntimeStatus;
|
|
30
|
+
enabled: boolean;
|
|
31
|
+
config: ResolvedWatchdogConfig;
|
|
32
|
+
configOk: boolean;
|
|
33
|
+
errors: WatchdogSettingsError[];
|
|
34
|
+
sources: WatchdogSettingsSource[];
|
|
35
|
+
bufferedDeltas: number;
|
|
36
|
+
epoch: number;
|
|
37
|
+
activeReviewId?: number;
|
|
38
|
+
sessionOverride?: boolean;
|
|
39
|
+
sessionModelOverride?: Partial<Pick<WatchdogEndpointConfig, "model" | "thinking">>;
|
|
40
|
+
lastWarning?: WatchdogWarningDetails;
|
|
41
|
+
lastError?: string;
|
|
42
|
+
failedReviews: number;
|
|
43
|
+
staleReviews: number;
|
|
44
|
+
reviewConnected: boolean;
|
|
45
|
+
reviewDescription: string;
|
|
46
|
+
boundaryRepeats: number;
|
|
47
|
+
stalemate: boolean;
|
|
48
|
+
reviewTrigger: "turn-delta" | "repo-edits";
|
|
49
|
+
changedPaths?: string[];
|
|
50
|
+
lsp: WatchdogLspRuntimeSnapshot;
|
|
51
|
+
}
|
|
52
|
+
interface MainWatchdogRuntimeOptions {
|
|
53
|
+
cwd?: string;
|
|
54
|
+
resolveConfig?: (cwd: string, options?: {
|
|
55
|
+
session?: Record<string, unknown>;
|
|
56
|
+
}) => WatchdogSettingsResult;
|
|
57
|
+
review?: WatchdogReviewFunction;
|
|
58
|
+
reviewDescription?: string;
|
|
59
|
+
displayWarning?: (warning: WatchdogWarningDetails, options?: WatchdogWarningSendOptions) => void;
|
|
60
|
+
displayUserWarning?: (warning: WatchdogWarningDetails) => void;
|
|
61
|
+
/** Supplying this main-session delivery capability gates clarification (children omit it). */
|
|
62
|
+
displayClarification?: (content: string) => void;
|
|
63
|
+
reviewChangesOnly?: boolean;
|
|
64
|
+
lspDiagnostics?: WatchdogLspDiagnosticsFunction;
|
|
65
|
+
repoChangeSignature?: typeof computeWatchdogRepoChangeSignature;
|
|
66
|
+
}
|
|
67
|
+
export type WatchdogWarningSendOptions = {
|
|
68
|
+
deliverAs: "steer";
|
|
69
|
+
} | {
|
|
70
|
+
triggerTurn: false;
|
|
71
|
+
};
|
|
72
|
+
type ContextLike = Pick<ExtensionContext, "cwd"> & {
|
|
73
|
+
signal?: AbortSignal;
|
|
74
|
+
};
|
|
75
|
+
export declare function boundWatchdogReviewText(text: string, cap?: number): string;
|
|
76
|
+
export declare class MainWatchdogRuntime {
|
|
77
|
+
private cwd;
|
|
78
|
+
private readonly resolveConfig;
|
|
79
|
+
private readonly review;
|
|
80
|
+
private readonly reviewConnected;
|
|
81
|
+
private readonly reviewDescription;
|
|
82
|
+
private readonly displayWarning;
|
|
83
|
+
private readonly displayUserWarning;
|
|
84
|
+
private readonly reviewChangesOnly;
|
|
85
|
+
private readonly lspDiagnostics;
|
|
86
|
+
private readonly repoChangeSignature;
|
|
87
|
+
private readonly lspLedger;
|
|
88
|
+
private readonly scope;
|
|
89
|
+
private configResult;
|
|
90
|
+
private sessionOverrideEnabled;
|
|
91
|
+
private sessionModelOverride;
|
|
92
|
+
private status;
|
|
93
|
+
private pendingDeltas;
|
|
94
|
+
private pendingDeltaChars;
|
|
95
|
+
private guard;
|
|
96
|
+
private guardMaxWarnings;
|
|
97
|
+
private epoch;
|
|
98
|
+
private reviewIdCounter;
|
|
99
|
+
private agentEndIdCounter;
|
|
100
|
+
private activeAgentEndId;
|
|
101
|
+
private activeAgentEndAbortController;
|
|
102
|
+
private activeReviewId;
|
|
103
|
+
private activeReviewWarning;
|
|
104
|
+
private reviewing;
|
|
105
|
+
private waitingAtAgentEnd;
|
|
106
|
+
private disposed;
|
|
107
|
+
private includeUserPromptInNextDelta;
|
|
108
|
+
private userPrompt;
|
|
109
|
+
private waiters;
|
|
110
|
+
private lastWarning;
|
|
111
|
+
private lastError;
|
|
112
|
+
private lastReviewInputSignature;
|
|
113
|
+
private turnStartChangeSignature;
|
|
114
|
+
private lastReviewedChangeSignature;
|
|
115
|
+
private currentChangedPaths;
|
|
116
|
+
private lastLspSnapshot;
|
|
117
|
+
private observedRepoEditThisTurn;
|
|
118
|
+
private toolResultsThisRun;
|
|
119
|
+
private midRunReviewing;
|
|
120
|
+
private lastBoundaryIdentity;
|
|
121
|
+
private boundaryRepeats;
|
|
122
|
+
private stalemate;
|
|
123
|
+
private ruleWarningsThisRun;
|
|
124
|
+
private midRunGeneration;
|
|
125
|
+
private activeReviewAbortController;
|
|
126
|
+
private failedReviews;
|
|
127
|
+
private staleReviews;
|
|
128
|
+
private readonly displayClarification;
|
|
129
|
+
private askedThisPrompt;
|
|
130
|
+
private activityTail;
|
|
131
|
+
private activityPending;
|
|
132
|
+
private activityReviewUsed;
|
|
133
|
+
constructor(options?: MainWatchdogRuntimeOptions);
|
|
134
|
+
bindSession(ctx: ContextLike): void;
|
|
135
|
+
refreshConfig(cwd?: string): WatchdogSettingsResult;
|
|
136
|
+
setSessionEnabled(enabled: boolean, cwd?: string): WatchdogRuntimeSnapshot;
|
|
137
|
+
setSessionModel(patch: {
|
|
138
|
+
model?: string | null;
|
|
139
|
+
thinking?: WatchdogEndpointConfig["thinking"] | null;
|
|
140
|
+
}, cwd?: string): WatchdogRuntimeSnapshot;
|
|
141
|
+
clearSessionModel(cwd?: string): WatchdogRuntimeSnapshot;
|
|
142
|
+
clearSessionOverride(cwd?: string): WatchdogRuntimeSnapshot;
|
|
143
|
+
reset(_reason?: string, options?: {
|
|
144
|
+
clearReviewInputSignature?: boolean;
|
|
145
|
+
resetChangeSignature?: boolean;
|
|
146
|
+
clearLspLedger?: boolean;
|
|
147
|
+
clearScope?: boolean;
|
|
148
|
+
clearActivity?: boolean;
|
|
149
|
+
}): void;
|
|
150
|
+
dispose(): void;
|
|
151
|
+
handleBeforeAgentStart(event: unknown, ctx: ContextLike): void;
|
|
152
|
+
handleTurnEnd(event: unknown, ctx: ContextLike, structuredTerminal?: boolean): void;
|
|
153
|
+
enqueueDelta(delta: string): void;
|
|
154
|
+
handleToolResult(ctx: ContextLike): void;
|
|
155
|
+
handleAgentEnd(_event: unknown, ctx: ContextLike): Promise<void>;
|
|
156
|
+
displayRuleWarning(violation: WatchdogRuleViolation): void;
|
|
157
|
+
displayRecordedWarning(warning: WatchdogWarning): void;
|
|
158
|
+
getSnapshot(cwd?: string): WatchdogRuntimeSnapshot;
|
|
159
|
+
/** A real user input sent while the agent streams reaches the loop without before_agent_start, so record it in scope here. */
|
|
160
|
+
handleUserInput(event: Pick<InputEvent, "text" | "source" | "streamingBehavior">): void;
|
|
161
|
+
handleModelChange(): void;
|
|
162
|
+
waitForIdle(timeoutMs?: number): Promise<boolean>;
|
|
163
|
+
private isEnabled;
|
|
164
|
+
private abortActiveAgentEnd;
|
|
165
|
+
private isAgentEndCurrent;
|
|
166
|
+
private isCurrent;
|
|
167
|
+
private warningMeetsThreshold;
|
|
168
|
+
private routeWarning;
|
|
169
|
+
private acceptWarning;
|
|
170
|
+
private displayBoundaryWarning;
|
|
171
|
+
private invalidateActiveReview;
|
|
172
|
+
private reviewMidRunDelta;
|
|
173
|
+
private cancelMidRunReview;
|
|
174
|
+
private reviewDelta;
|
|
175
|
+
private displayAcceptedReviewWarning;
|
|
176
|
+
private deliverBoundaryWarning;
|
|
177
|
+
private repeatableBoundaryIdentity;
|
|
178
|
+
private resetBoundaryRepeats;
|
|
179
|
+
private currentRepoChangeSignature;
|
|
180
|
+
private resetRepoChangeBaseline;
|
|
181
|
+
private resolveReviewChangeSignature;
|
|
182
|
+
private collectLspDiagnostics;
|
|
183
|
+
private lspSnapshot;
|
|
184
|
+
private appendBoundedDelta;
|
|
185
|
+
private buildReviewInput;
|
|
186
|
+
private scopeBlock;
|
|
187
|
+
private clearPendingDeltas;
|
|
188
|
+
private clearActivity;
|
|
189
|
+
private fail;
|
|
190
|
+
private markLastWarningStale;
|
|
191
|
+
private isSettled;
|
|
192
|
+
private waitForSettled;
|
|
193
|
+
private resolveWaiters;
|
|
194
|
+
}
|
|
195
|
+
export {};
|