@chankov/agent-fleet 2.0.6 → 2.0.7

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.
Files changed (450) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/README.md +11 -0
  4. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  5. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  6. package/.pi/harnesses/lib/update-check.ts +222 -0
  7. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  8. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  9. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  10. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  11. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  12. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  13. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  14. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  15. package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
  16. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  17. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  18. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  19. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  20. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  21. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  22. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  23. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  24. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  25. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  26. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  27. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  28. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  29. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  30. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  31. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  32. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  33. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  34. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  35. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  36. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  37. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  38. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  39. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  40. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  41. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  42. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  43. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  44. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  45. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  46. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  47. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  48. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  49. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  50. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  51. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  52. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  53. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  54. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  55. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  56. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  57. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  58. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  59. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  60. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  61. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  62. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  63. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  64. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  65. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  66. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  67. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  68. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  69. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  70. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  71. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  72. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  73. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  74. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  75. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  76. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  77. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  78. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  79. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  80. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  81. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  82. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  83. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  84. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  85. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  86. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  87. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  88. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  89. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  90. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  91. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  92. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  93. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  94. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  95. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  97. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  98. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  99. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  100. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  101. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  102. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  103. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  104. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  105. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  106. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  107. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  108. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  109. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  110. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  111. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  112. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  113. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  114. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  115. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  116. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  117. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  118. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  119. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  120. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  121. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  122. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  123. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  124. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  125. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  126. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  127. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  128. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  129. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  130. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  131. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  132. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  133. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  134. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  135. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  136. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  137. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  138. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  139. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  140. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  141. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  142. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  143. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  144. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  145. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  146. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  147. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  148. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  149. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  150. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  151. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  152. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  153. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  154. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  155. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  156. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  157. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  158. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  159. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  160. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  161. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  162. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  163. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  164. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  165. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  166. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  167. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  168. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  169. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  170. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  171. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  172. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  173. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  174. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  175. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  176. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  177. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  178. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  179. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  180. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  181. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  182. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  183. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  184. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  185. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  186. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  187. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  188. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  189. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  190. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  191. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  192. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  193. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  194. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  195. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  196. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  197. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  198. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  199. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  200. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  201. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  202. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  203. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  204. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  205. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  206. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  207. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  208. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  209. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  210. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  211. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  212. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  213. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  214. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  215. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  216. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  217. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  218. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  219. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  220. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  221. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  222. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  223. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  224. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  225. package/.versions/2.0.7/.version +1 -0
  226. package/.versions/2.0.7/agents/architect.md +25 -0
  227. package/.versions/2.0.7/agents/bowser.md +28 -0
  228. package/.versions/2.0.7/agents/builder.md +56 -0
  229. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  230. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  231. package/.versions/2.0.7/agents/documenter.md +23 -0
  232. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  233. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  234. package/.versions/2.0.7/agents/planner.md +106 -0
  235. package/.versions/2.0.7/agents/releaser.md +25 -0
  236. package/.versions/2.0.7/agents/researcher.md +31 -0
  237. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  238. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  239. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  240. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  241. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  242. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  243. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  244. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  246. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  247. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  248. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  249. package/.versions/2.0.7/docs/getting-started.md +126 -0
  250. package/.versions/2.0.7/docs/npm-install.md +327 -0
  251. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  252. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  253. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.7/hermes/README.md +347 -0
  255. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  262. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.7/install-manifest.json +2886 -0
  290. package/.versions/2.0.7/justfile +247 -0
  291. package/.versions/2.0.7/manifest-meta.json +958 -0
  292. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.7/references/communication-contract.md +26 -0
  294. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.7/references/security-checklist.md +179 -0
  301. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
  304. package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
  305. package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
  306. package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
  307. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  308. package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
  309. package/.versions/2.0.7/scripts/fleet.ts +216 -0
  310. package/.versions/2.0.7/scripts/flow.ts +137 -0
  311. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  312. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  313. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  314. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  315. package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
  316. package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
  317. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  318. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  319. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  320. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  321. package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
  322. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  323. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  324. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  325. package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
  326. package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  327. package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  328. package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  329. package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  330. package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  331. package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  332. package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  333. package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
  334. package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
  335. package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
  336. package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
  337. package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
  338. package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
  339. package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
  340. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  341. package/.versions/2.0.7/scripts/package.json +9 -0
  342. package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
  343. package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
  344. package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
  345. package/.versions/2.0.7/scripts/team-up.ts +378 -0
  346. package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
  347. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  348. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  349. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  350. package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
  351. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  352. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  353. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  354. package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
  355. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  356. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  357. package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
  358. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  359. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  360. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  361. package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
  362. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  363. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  364. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  365. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  366. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  367. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  368. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  369. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  370. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  371. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  372. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  373. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  374. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  375. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  376. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  377. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  378. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  379. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  380. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  381. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  382. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  383. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  384. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  385. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  386. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  387. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  388. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  389. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  390. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  391. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  392. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  393. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  394. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  395. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  396. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  397. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  398. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  399. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  400. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  401. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  402. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  403. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  404. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  405. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  406. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  407. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  408. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  409. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  410. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  411. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  412. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  413. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  414. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  415. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  416. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  417. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  418. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  419. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  420. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  421. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  422. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  423. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  424. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  425. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  426. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  427. package/CHANGELOG.md +8 -0
  428. package/README.md +14 -7
  429. package/bin/cli.js +149 -78
  430. package/bin/lib/apply.js +53 -62
  431. package/bin/lib/features.js +2 -2
  432. package/bin/lib/public-plan.js +17 -0
  433. package/bin/lib/purge.js +9 -3
  434. package/bin/lib/reconcile.js +4 -10
  435. package/bin/lib/repair-desired.js +73 -0
  436. package/bin/lib/stt-wizard.js +25 -11
  437. package/bin/lib/transaction.js +118 -108
  438. package/bin/lib/tui.js +70 -65
  439. package/bin/lib/update-notifier.js +2 -2
  440. package/bin/lib/workspace-safety.js +72 -0
  441. package/docs/npm-install.md +41 -15
  442. package/docs/pi-extensions.md +3 -3
  443. package/docs/pi-setup.md +2 -2
  444. package/install-manifest.json +1 -39
  445. package/justfile +3 -3
  446. package/manifest-meta.json +2 -20
  447. package/package.json +2 -2
  448. package/scripts/fleet.ts +1 -1
  449. package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
  450. package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
@@ -0,0 +1,273 @@
1
+ import { retainDeliverable } from "../execution-evidence.ts";
2
+ import { preflightDeliverables, readBackDeliverables, type DeliverableContract } from "../acceptance.ts";
3
+ import { withNoProgress, type NoProgressGuard } from "../no-progress.ts";
4
+ import { randomUUID } from "node:crypto";
5
+ import { mkdirSync, writeFileSync } from "node:fs";
6
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
7
+ import { blockingFindingCap, checkReviewRoundCap, checkTaskBudget, checkTierPersonaGate, checkTurnBudget, isReviewPersona, remainingTaskResearch, reviewBudgetClause, reviewRoundCap } from "../run-budget.js";
8
+ import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
9
+ import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
10
+ import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
11
+ import type { BudgetRecovery } from "../budget-recovery.ts";
12
+ import { checkScope, diffAgainst, snapshotWorktree } from "../scope-gate.js";
13
+ import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
14
+ import { shouldExtractReturn } from "../return-extract.js";
15
+ import { normalizeAgentInput, safeAgentKey, safePathWithin, taskFingerprint } from "../helpers.ts";
16
+ import { MAX_AUTO_RESEARCH_QUESTIONS, MAX_AUTO_RESEARCH_ROUNDS, type ResearchAgentDef, type ResearchRuntime } from "../research/runtime.ts";
17
+ import type { BudgetContext, SessionTotals, TurnReport } from "../context/budgets.ts";
18
+ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../context/assertions-artifacts.ts";
19
+ import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
20
+
21
+ type Gate = { reason: string; message: string } | null;
22
+ type DispatchResult = import("../dispatch-native-types.ts").NativeDispatchResult;
23
+ type AgentState = { def: { name: string; tools: string }; runCount: number; contextPct: number; lastBackend?: string | null };
24
+
25
+ export interface DispatchExecutionState {
26
+ getTurnDispatchCount(): number; setTurnDispatchCount(value: number): void;
27
+ getTurnResearchCount(): number; setTurnResearchCount(value: number): void;
28
+ getTaskDispatchCount(): number; setTaskDispatchCount(value: number): void;
29
+ getTaskResearchCount(): number; setTaskResearchCount(value: number): void;
30
+ getTaskReviewRounds(): number; setTaskReviewRounds(value: number): void;
31
+ getTaskTier(): string | null;
32
+ getTurnReport(): TurnReport;
33
+ getSessionTotals(): SessionTotals;
34
+ getTurnDispatchFingerprints(): Set<string>;
35
+ getExternalBlockers(): Array<{ agent: string; what: string }>;
36
+ getExternalBlockerAcknowledged(): boolean; setExternalBlockerAcknowledged(value: boolean): void;
37
+ getExternalBlockerRefusedOnce(): boolean; setExternalBlockerRefusedOnce(value: boolean): void;
38
+ isAskUserAvailable(): boolean;
39
+ getUserLanguage(): string;
40
+ getSessionDir(): string;
41
+ getAgentStates(): Map<string, AgentState>;
42
+ getResearchPersonas(): ResearchAgentDef[];
43
+ getActiveWritableDispatches(): number; setActiveWritableDispatches(value: number): void;
44
+ getWritableOverlapCounter(): number; setWritableOverlapCounter(value: number): void;
45
+ }
46
+
47
+ export interface DispatchExecutorDeps {
48
+ noProgress: NoProgressGuard;
49
+ state: DispatchExecutionState;
50
+ budget: BudgetContext;
51
+ budgetRecovery: BudgetRecovery;
52
+ artifacts: AssertionsArtifactsContext;
53
+ research: ResearchRuntime<any>;
54
+ provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
55
+ dispatchAgent(agent: string, task: string, ctx: ExtensionContext, artifacts: InputArtifactPreview[], scope: string[], watchdog?: boolean, backend?: "auto" | "native" | "coms", resume?: boolean): Promise<DispatchResult>;
56
+ runReturnExtraction(path: string, ids: string[], ctx: ExtensionContext): Promise<any>;
57
+ extractNeedsResearch(output: string): string[];
58
+ extractAskUserQuestions(output: string): string[];
59
+ contextPressure(percent: number): boolean;
60
+ displayName(name: string): string;
61
+ }
62
+
63
+ interface PreparedDispatch { taskToken: object; contract: DeliverableContract; sessionDir: string; agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
64
+ interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
65
+ interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
66
+
67
+ export function preflightGate(d: DispatchExecutorDeps, persona: string): Gate {
68
+ const s = d.state;
69
+ const blocked = checkExternalBlockerGate({ blockers: s.getExternalBlockers(), acknowledged: s.getExternalBlockerAcknowledged(), askUserAvailable: s.isAskUserAvailable(), refusedOnce: s.getExternalBlockerRefusedOnce() });
70
+ if (blocked) { s.setExternalBlockerRefusedOnce(true); return blocked; }
71
+ return checkTierPersonaGate(s.getTaskTier(), persona);
72
+ }
73
+
74
+ function refusal(d: DispatchExecutorDeps, agent: string, task: string, status: string, message: string, reason?: string): ToolExecutionResult {
75
+ d.state.getTurnReport().refusals++; d.state.getSessionTotals().refusals++;
76
+ return { content: [{ type: "text", text: message }], details: { agent, task, status, reason: reason ?? status, elapsed: 0, exitCode: 1, fullOutput: "" } };
77
+ }
78
+
79
+ const RESEARCH_DISPATCH_NAMES = new Set(["researcher", "deep-researcher"]);
80
+
81
+ function rosterNames(d: DispatchExecutorDeps): string[] {
82
+ return Array.from(d.state.getAgentStates().values()).map(s => s.def.name);
83
+ }
84
+
85
+ function isResearchDispatchName(d: DispatchExecutorDeps, agent: string): boolean {
86
+ if (RESEARCH_DISPATCH_NAMES.has(agent)) return true;
87
+ return d.state.getResearchPersonas().some(p => normalizeAgentInput(p.name) === agent);
88
+ }
89
+
90
+ function unknownAgentMessage(agent: string, available: string[], researchHint: boolean): string {
91
+ const roster = available.length ? available.join(", ") : "(none)";
92
+ const research = researchHint
93
+ ? `\n\n"${agent}" is a research persona. Call spawn_research with persona "${agent}" instead of dispatch_agent. Do not invent a substitute dispatch.`
94
+ : "";
95
+ return `Unknown agent "${agent}". dispatch_agent only accepts the active roster. Available agents: ${roster}.${research}\n\nDo not invent a substitute dispatch. Use an available agent, or spawn_research for a research persona.`;
96
+ }
97
+
98
+ export function validateDispatchAgent(d: DispatchExecutorDeps, agent: string, task: string): ToolExecutionResult | null {
99
+ const available = rosterNames(d);
100
+ const onRoster = d.state.getAgentStates().has(agent) || available.some(name => normalizeAgentInput(name) === agent);
101
+ if (isResearchDispatchName(d, agent)) {
102
+ return refusal(d, agent, task, "research_persona_via_dispatch", unknownAgentMessage(agent, available, true), "research_persona_via_dispatch");
103
+ }
104
+ if (!onRoster) {
105
+ return refusal(d, agent, task, "unknown_agent", unknownAgentMessage(agent, available, false), "unknown_agent");
106
+ }
107
+ return null;
108
+ }
109
+
110
+ export function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): PreparedDispatch | ToolExecutionResult {
111
+ const s = d.state; const { task, artifacts, scope, review_reason } = params; const agent = normalizeAgentInput(params.agent);
112
+ d.budget.ensureTaskTier();
113
+ const rosterRefusal = validateDispatchAgent(d, agent, task);
114
+ if (rosterRefusal) return rosterRefusal;
115
+ const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(s.getTaskTier(), agent, s.getTaskReviewRounds()) ?? checkDocsLane(agent, scope || [], review_reason);
116
+ if (preflight) return refusal(d, agent, task, preflight.reason, preflight.message, preflight.reason);
117
+ const taskRefusal = checkTaskBudget("dispatch", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
118
+ if (taskRefusal) return refusal(d, agent, task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
119
+ const turnRefusal = checkTurnBudget("dispatch", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
120
+ if (turnRefusal) return refusal(d, agent, task, "budget_refused", turnRefusal.message, turnRefusal.reason);
121
+ let contract: DeliverableContract;
122
+ try { contract = preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: s.getSessionDir() }); }
123
+ catch (error) { return refusal(d, agent, task, "scope_preflight_failed", String(error)); }
124
+ const fingerprint = taskFingerprint(agent, task);
125
+ if (s.getTurnDispatchFingerprints().has(fingerprint)) return refusal(d, agent, task, "duplicate_refused", `⚠ Duplicate dispatch refused: you already dispatched ${agent} with this task (or a trivial rewording of it) THIS turn. Use the earlier result — re-read its digest/returnPath — or change the task materially (new instructions, corrected inputs) before re-dispatching.`);
126
+ let inputArtifacts: InputArtifactPreview[];
127
+ try { inputArtifacts = d.artifacts.loadInputArtifacts(artifacts, ctx); }
128
+ catch (err: any) { return { content: [{ type: "text", text: `⚠ Dispatch NOT sent and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and dispatch again.` }], details: { agent, task, status: "artifact_preflight_failed", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
129
+ s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
130
+ if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
131
+ s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
132
+ const declaredTask = contract.files.length ? `${task}\n\n## Expected deliverables (explicit contract)\nProduce these exact files and report their paths. The hub will read them back; a prose claim is not delivery.\n${contract.files.map(file => `- ${file.path}`).join("\n")}` : task;
133
+ return { taskToken: d.noProgress.taskToken(), contract, sessionDir: s.getSessionDir(), agent, task: declaredTask, inputArtifacts, scopeGlobs: (scope || []).map(String).map(x => x.trim()).filter(Boolean), fingerprint };
134
+ }
135
+
136
+ function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
137
+ const s = d.state; const state = s.getAgentStates().get(prepared.agent.toLowerCase()); const canWrite = !!state && hasWriteCapability(state.def.tools);
138
+ const tracking = { writable: canWrite, snapshot: null as any, overlapBaseline: s.getWritableOverlapCounter(), concurrentAtStart: false };
139
+ if (canWrite) {
140
+ tracking.concurrentAtStart = s.getActiveWritableDispatches() > 0;
141
+ if (tracking.concurrentAtStart) s.setWritableOverlapCounter(s.getWritableOverlapCounter() + 1);
142
+ s.setActiveWritableDispatches(s.getActiveWritableDispatches() + 1);
143
+ if (prepared.scopeGlobs.length > 0) tracking.snapshot = snapshotWorktree(ctx.cwd || process.cwd());
144
+ }
145
+ return tracking;
146
+ }
147
+
148
+ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<RunData> {
149
+ const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
150
+ let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto");
151
+ let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = []; let autoResearchTaskCapped = false;
152
+ while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS && p.taskToken === d.noProgress.taskToken() && p.sessionDir === d.state.getSessionDir()) {
153
+ const left = remainingTaskResearch(d.budget.currentTaskBudget(), d.budget.taskCounters()); if (left === 0) { autoResearchTaskCapped = true; break; }
154
+ const questions = d.extractNeedsResearch(result.output).slice(0, left == null ? MAX_AUTO_RESEARCH_QUESTIONS : Math.min(MAX_AUTO_RESEARCH_QUESTIONS, left)); if (!questions.length) break;
155
+ d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
156
+ onUpdate?.({ content: [{ type: "text", text: `${p.agent} paused for research (${questions.length} question(s)) — spawning read-only helpers...` }], details: { agent: p.agent, task: p.task, status: "researching" } });
157
+ const findingsDir = safePathWithin(p.sessionDir, "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
158
+ const answered = await Promise.all(questions.map(async question => {
159
+ const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx));
160
+ const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-${response.dispatchId ?? randomUUID()}.md`);
161
+ writeFileSync(file, `# Research findings r${state.id}\n\n**Question:** ${question}\n\n${response.exitCode === 0 ? response.output : `(research helper failed, exit ${response.exitCode})\n\n${response.output}`}\n`, { encoding: "utf-8", flag: "wx" }); return { question, file };
162
+ }));
163
+ researchRounds.push({ questions, files: answered.map(a => a.file) });
164
+ const resume = "Research findings for your NEEDS_RESEARCH questions are ready. Read each file with your read tool, then continue from where you paused:\n" + answered.map((a, i) => `${i + 1}. ${a.question}\n → ${a.file}`).join("\n");
165
+ if (p.taskToken !== d.noProgress.taskToken() || p.sessionDir !== d.state.getSessionDir()) break;
166
+ result = await d.dispatchAgent(p.agent, resume, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto", true); billed += result.billed ?? 0; out += result.out ?? 0;
167
+ }
168
+ return { result, billed, out, researchRounds, autoResearchTaskCapped };
169
+ }
170
+
171
+ function scopeResult(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tracking, ctx: ExtensionContext): any {
172
+ if (!tracking.snapshot) return null; const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
173
+ const concurrentWritableOverlap = tracking.concurrentAtStart || d.state.getWritableOverlapCounter() !== tracking.overlapBaseline;
174
+ if (diff.skipped) return { skipped: true, reason: diff.reason, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
175
+ return { ...checkScope(diff.paths, p.scopeGlobs), changedPaths: diff.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
176
+ }
177
+
178
+ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
179
+ const s = d.state; const { result, researchRounds } = run;
180
+ const sameTask = p.taskToken === d.noProgress.taskToken() && p.sessionDir === s.getSessionDir(); const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
181
+ let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(result.output, ids, disposition.delivered); const shouldUseDigest = ids.length > 0 || !!parsedReturn;
182
+ const state = sameTask ? s.getAgentStates().get(p.agent.toLowerCase()) : undefined; const key = safeAgentKey(state?.def.name ?? p.agent);
183
+ const failureMetadata = { dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null,
184
+ agent: p.agent, task: p.task, scope: p.scopeGlobs, exitCode: result.exitCode, diagnostics: result.diagnostics ?? null };
185
+ const artifactOutput = disposition.delivered ? result.output
186
+ : `# Dispatch failure\n\n\`\`\`json\n${JSON.stringify(failureMetadata, null, 2)}\n\`\`\`\n\n## Output\n\n${result.output}`;
187
+ const runPath = disposition.artifactKind ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, artifactOutput, disposition.artifactKind, result.dispatchId, p.sessionDir) : null;
188
+ const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
189
+ if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
190
+ onUpdate?.({ content: [{ type: "text", text: `${p.agent} returned no structured block — extracting it from the report...` }], details: { agent: p.agent, task: p.task, status: "extracting_return" } });
191
+ const recovered = await d.runReturnExtraction(returnPath, ids, ctx); if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
192
+ }
193
+ const assessmentId = result.dispatchId ?? randomUUID();
194
+ const readback = disposition.pending ? [] : readBackDeliverables(p.contract, { cwd: ctx.cwd || process.cwd(), sessionDir: p.sessionDir },
195
+ (index, bytes) => retainDeliverable(p.sessionDir, assessmentId, index, bytes));
196
+ const deliverableFailed = readback.some(file => file.status !== "read");
197
+ const executionStatus = disposition.pending ? "pending" : disposition.delivered ? "completed" : "failed";
198
+ const status = disposition.delivered ? deliverableFailed ? "verification_failed" : "completed_unverified" : disposition.status;
199
+ const acceptanceStatus = disposition.pending || !disposition.delivered ? "not_available" : deliverableFailed ? "deliverable_failed" : "needs_verification";
200
+ const assessment = { executionStatus, acceptanceStatus, accepted: false, dispatchId: result.dispatchId ?? null, readback, scopeRoots: p.contract.scopeRoots, assertions: ids };
201
+ const assessmentPath = disposition.pending ? null : d.artifacts.writeRunArtifact(`${key}-acceptance`, state?.runCount ?? 0, JSON.stringify(assessment, null, 2), "evidence", assessmentId, p.sessionDir);
202
+ if (sameTask && [0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
203
+ if (sameTask) { s.getTurnReport().dispatches.push({ agent: p.agent, status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out; }
204
+ const questions = d.extractAskUserQuestions(result.output); const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
205
+ const notices: string[] = [];
206
+ if (!sameTask) notices.push("Late result from a prior task/session: evidence retained in its original namespace; current-task counters and blockers were not changed.");
207
+ if (disposition.delivered) notices.push(`Execution completed, NOT accepted. ${deliverableFailed ? "Expected deliverable readback failed." : "Verify correctness against the assertion ledger; file presence and exit 0 are not proof."} Acceptance check: ${assessmentPath}`);
208
+ if (readback.some(file => file.changed === false)) notices.push("Some deliverables already existed unchanged. Do not attribute their creation to this execution.");
209
+ const blockers = extractExternalBlockers(result.output); if (sameTask && blockers.length) { for (const what of blockers) if (!s.getExternalBlockers().some(b => b.what === what)) s.getExternalBlockers().push({ agent: p.agent, what }); s.setExternalBlockerAcknowledged(false); s.setExternalBlockerRefusedOnce(false); notices.push(`⛔ ${p.agent} reported an EXTERNAL BLOCKER — something outside the fleet's reach is missing:\n${blockers.map((w, i) => ` ${i + 1}. ${w}`).join("\n")}\nThe next dispatch/research call is refused until you escalate this to the human. Do not build a substitute for the missing fact.`); }
210
+ if (questions.length) notices.push(`⚠ ${questions.length} ASK_USER question(s) raised by ${p.agent}. You MUST call ask_user for each (in ${s.getUserLanguage()}) before re-dispatching:\n${questions.map((q, i) => ` ${i + 1}. ${q}`).join("\n")}`);
211
+ if (researchRounds.length) notices.push(`ℹ ${p.agent} auto-paused for research ${researchRounds.length} round(s); ${answered} question(s) answered by read-only helpers. Findings were saved under ${safePathWithin(s.getSessionDir(), "findings")} and read by the agent directly — they are NOT inlined here.`);
212
+ if (unresolved.length && researchRounds.length >= MAX_AUTO_RESEARCH_ROUNDS) notices.push(`⚠ ${p.agent} still requests research (${unresolved.length} question(s)) but the auto-research budget is exhausted. Run spawn_research yourself and re-dispatch with the findings, or simplify the task.`);
213
+ if (run.autoResearchTaskCapped) notices.push(`⚠ ${p.agent} paused for research, but the TASK research envelope is spent (${s.getTaskResearchCount()}/${d.budget.currentTaskBudget().maxResearch}) — no helper was spawned and the specialist was not resumed. Its questions are unanswered. Narrow the task so it can proceed on what it has, or call set_task_tier with new_task: true if this is genuinely different work.`);
214
+ if (returnPath) notices.push(`Full specialist output: ${returnPath}`);
215
+ if (disposition.pending) notices.push("⏳ DELIVERY PENDING — no result or assertion evidence is available yet, and no return/failure artifact was written. Use the msg_id above with coms_get/coms_await; do not re-dispatch.");
216
+ if (failurePath) notices.push(`⚠ DELIVERY FAILURE (exit ${result.exitCode}) — no specialist result was returned. The error output is at ${failurePath}; it is NOT a return and carries no assertion evidence. The work may or may not have happened — check the artifacts the task was supposed to produce before re-dispatching.`);
217
+ const corrected = p.inputArtifacts.filter(a => a.resolvedFromKind); if (corrected.length) notices.push(`ℹ Artifact path corrected: ${corrected.map(a => `"${a.input}" → ${a.displayPath}`).join("; ")}. Use the corrected path from now on.`);
218
+ if (state && d.contextPressure(state.contextPct)) notices.push(`⚠ ${d.displayName(state.def.name)} context at ${Math.ceil(state.contextPct)}% — consider /af-agents-restart ${state.def.name} (state lives in the artifacts/ledger, a restart is cheap).`);
219
+ const scopeViolations = scopeResult(d, p, tracking, ctx); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
220
+ const finding = isReviewPersona(p.agent) ? findingBudgetNotice(p.agent, blockingFindingCap(s.getTaskTier()), countReviewFindings(result.output), s.getTaskReviewRounds(), reviewRoundCap(s.getTaskTier())) || "" : ""; if (finding) notices.push(finding.trim());
221
+ const docs = docsLaneNotice(p.agent, p.scopeGlobs); if (docs) notices.push(docs);
222
+ const contract = contractNoticeText(contractNotices); const extraction = returnExtracted ? "ℹ The specialist declared no structured return. The block below was EXTRACTED from its report by a cheap read-only pass — weaker than a declared return. Verify the named evidence before you gate on it." : "";
223
+ const digest = shouldUseDigest ? [extraction, structuredReturnDigest(parsedReturn) || "Structured return: (none parsed)", contract].filter(Boolean).join("\n\n") : (result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output);
224
+ return { content: [{ type: "text", text: `[${p.agent}] ${status} in ${Math.round(result.elapsed / 1000)}s${notices.length ? `\n\n${notices.join("\n\n")}` : ""}\n\n${digest}` }], details: { agent: p.agent, task: p.task, status, executionStatus, acceptanceStatus, accepted: false, staleTask: !sameTask, deliverableReadback: readback, scopeRoots: p.contract.scopeRoots, assessmentPath, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId ?? null, transcriptPath: result.transcriptPath ?? null, diagnostics: result.diagnostics ?? null, evidencePath: result.evidencePath ?? null, structuredReturn: parsedReturn, returnExtracted, pending: disposition.pending, returnPath, failurePath, contractNotices, questions, researchRounds, scopeViolations, sessionReset: result.sessionReset ?? null, artifacts: p.inputArtifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } };
225
+ }
226
+
227
+ export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
228
+ return withNoProgress(d, "dispatch", async (_id, params, signal, onUpdate, ctx) => {
229
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
230
+ d.budget.ensureTaskTier();
231
+ const agent = normalizeAgentInput(params.agent);
232
+ const invalid = validateDispatchAgent(d, agent, params.task); if (invalid) return invalid;
233
+ const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(d.state.getTaskTier(), agent, d.state.getTaskReviewRounds()) ?? checkDocsLane(agent, params.scope || [], params.review_reason);
234
+ if (preflight) return refusal(d, agent, params.task, preflight.reason, preflight.message);
235
+ try { preflightDeliverables(params, { cwd: ctx.cwd || process.cwd(), sessionDir: d.state.getSessionDir() }); }
236
+ catch (error) { return refusal(d, agent, params.task, "scope_preflight_failed", String(error)); }
237
+ const budgetBlock = await d.budgetRecovery.ensure("dispatch", `${agent}: ${params.task}`, ctx, signal);
238
+ if (budgetBlock) return refusal(d, agent, params.task, budgetBlock.reason, budgetBlock.message);
239
+ if (signal?.aborted) return refusal(d, agent, params.task, "cancelled", "Operation cancelled before dispatch.");
240
+ const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
241
+ const tracking = startTracking(d, prepared, ctx);
242
+ try { onUpdate?.({ content: [{ type: "text", text: `Dispatching to ${prepared.agent}...` }], details: { agent: prepared.agent, task: prepared.task, status: "dispatching" } }); return await finishDispatch(d, prepared, params, await runWithAutoResearch(d, prepared, params, ctx, onUpdate), tracking, ctx, onUpdate); }
243
+ catch (err: any) { return { content: [{ type: "text", text: `Error dispatching to ${prepared.agent}: ${err?.message || err}` }], details: { agent: prepared.agent, task: prepared.task, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
244
+ finally { if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
245
+ });
246
+ }
247
+
248
+ export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
249
+ return withNoProgress(d, "research", async (_id, params, signal, onUpdate, ctx) => {
250
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
251
+ const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, preflight.message, preflight.reason);
252
+ const budgetBlock = await d.budgetRecovery.ensure("research", params.task, ctx, signal);
253
+ if (budgetBlock) return refusal(d, "", params.task, budgetBlock.reason, budgetBlock.message);
254
+ if (signal?.aborted) return refusal(d, "", params.task, "cancelled", "Operation cancelled before research.");
255
+ const taskRefusal = checkTaskBudget("research", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
256
+ if (taskRefusal) return refusal(d, "", params.task, "task_budget_refused", taskRefusal.message, taskRefusal.reason);
257
+ const turnRefusal = checkTurnBudget("research", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
258
+ if (turnRefusal) return refusal(d, "", params.task, "budget_refused", turnRefusal.message, turnRefusal.reason);
259
+ let def: any; let persona = false;
260
+ if (params.persona) { def = s.getResearchPersonas().find(x => x.name.toLowerCase() === params.persona!.toLowerCase()); if (!def) return { content: [{ type: "text", text: `No research persona "${params.persona}". Available: ${s.getResearchPersonas().map(x => x.name).join(", ") || "(none defined)"}. Omit \`persona\` for an ad-hoc helper. (Not counted against the turn budget.)` }], details: { status: "error" } }; persona = true; } else def = d.research.anonymousDef();
261
+ const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
262
+ try { artifacts = d.artifacts.loadInputArtifacts(params.artifacts, ctx); } catch (err: any) { return { content: [{ type: "text", text: `⚠ Research NOT spawned and NOT counted against the turn budget — input artifact could not be resolved:\n${err?.message || err}\n\nFix the path and try again.` }], details: { status: "artifact_preflight_failed" } }; }
263
+ s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
264
+ const state = d.research.createState(def, persona, model); onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
265
+ try { const result = await d.research.spawn(state, params.task, ctx, artifacts, signal); const status = result.termination ? result.termination.reason : result.exitCode === 0 ? "done" : "error"; const output = result.output.length > 8000 ? `${result.output.slice(0, 8000)}\n\n... [truncated]` : result.output; return { content: [{ type: "text", text: `[research r${state.id} · ${persona ? d.displayName(def.name) : "ad-hoc"} · read-only] ${status} in ${Math.round(result.elapsed / 1000)}s\n\n${output}${result.evidencePath ? `\n\nFull execution evidence: ${result.evidencePath}` : ""}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, dispatchId: result.dispatchId, evidencePath: result.evidencePath, transcriptPath: result.transcriptPath, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
266
+ catch (err: any) { return { content: [{ type: "text", text: `Error spawning research helper: ${err?.message || err}` }], details: { handle: `r${state.id}`, status: "error", elapsed: 0, exitCode: 1, fullOutput: "" } }; }
267
+ });
268
+ }
269
+
270
+ function hasWriteCapability(tools: string): boolean { const set = new Set(String(tools || "").split(",").map(x => x.trim()).filter(Boolean)); return ["write", "edit", "bash"].some(x => set.has(x)); }
271
+ function scopeNoticeText(v: any): string { if (!v) return ""; if (v.skipped) return `\n\n⚠ Scope gate skipped: ${v.reason || "not a git worktree"}.`; if (!v.outOfScope?.length) return ""; const overlap = v.concurrentWritableOverlap ? " Concurrent writable dispatches overlapped this run, so attribution is approximate." : ""; return `\n\n⚠ Scope advisory: changed outside declared scope: ${v.outOfScope.join(", ")}. Review these paths and decide whether to accept them or explicitly order cleanup; the hub did not revert anything.${overlap}`; }
272
+ function structuredReturnDigest(parsed: any): string { if (!parsed) return ""; const lines = ["Structured return (parsed):"]; for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) { const entries = parsed[key] || []; if (!entries.length) continue; lines.push(`${key}:`); for (const entry of entries) { const evidence = entry.evidence ? ` — evidence: ${entry.evidence}` : ""; const note = entry.note || (entry.evidence ? "" : "(no note)"); lines.push(`- ${entry.id}${note ? `: ${note}` : ""}${evidence}`); } } for (const key of ["changed_files", "tests_run", "open_risks", "requires_user_decision"]) { const entries = parsed[key] || []; if (entries.length) lines.push(`${key}: ${entries.slice(0, 5).join("; ")}${entries.length > 5 ? " …" : ""}`); } return lines.join("\n"); }
273
+ function contractNoticeText(notices: any[]): string { if (!notices?.length) return ""; const lines = ["⚠ Structured return contract notices:"]; const missing = notices.filter(n => n.type === "missing").map(n => n.id); const noStructured = notices.find(n => n.type === "no_structured_return"); if (noStructured) lines.push(`- no_structured_return: no parseable structured return for dispatched assertions ${(noStructured.ids || []).join(", ")} — treat all as unproven; full output is on disk.`); if (missing.length) lines.push(`- missing: return does not cover ${missing.join(", ")} — treat as unproven.`); for (const n of notices.filter(n => n.type === "proven_without_evidence")) lines.push(`- proven_without_evidence: ${n.id} claimed proven without named evidence — demoted to unproven.`); return lines.join("\n"); }
@@ -0,0 +1,22 @@
1
+ import type { ToolContext } from "./context.ts";
2
+ import { createDispatchExecutor, createResearchExecutor, type DispatchExecutorDeps } from "./dispatch-execution.ts";
3
+ import { createActionExecutors, type ActionExecutorDeps } from "./action-executors.ts";
4
+ import { createHerdrExecutors, type HerdrExecutorDeps } from "./herdr-executors.ts";
5
+
6
+ /** Explicit Phase 6.3 ports to budget/artifact/research, dispatch, policy and fleet owners. */
7
+ export interface DispatchExecutionContext {
8
+ dispatch: DispatchExecutorDeps;
9
+ actions: ActionExecutorDeps;
10
+ herdr: HerdrExecutorDeps;
11
+ }
12
+
13
+ /** Build the compatibility ToolContext consumed by the unchanged Phase-3 registrars. */
14
+ export function createToolExecutionOrchestration(ctx: DispatchExecutionContext): ToolContext {
15
+ return {
16
+ executeDispatchAgent: createDispatchExecutor(ctx.dispatch),
17
+ executeSpawnResearch: createResearchExecutor(ctx.dispatch),
18
+ ...createActionExecutors(ctx.actions),
19
+ ...createHerdrExecutors(ctx.herdr),
20
+ getAssertionCount: () => ctx.actions.getAssertions().length,
21
+ };
22
+ }
@@ -0,0 +1,202 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import * as fs from "node:fs";
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import { herdr as herdrApi } from "../../lib/herdr-client.ts";
8
+ import {
9
+ PEER_READY_TIMEOUT_MS,
10
+ peerReadyDelayMs,
11
+ spawnStaggerSeconds,
12
+ } from "../../lib/spawned-peers.js";
13
+ import { STAGGER_ENV_VAR, WARMUP_SECONDS, oauthNeedsWarmup } from "../../../../scripts/lib/spawn-stagger.ts";
14
+ import type {
15
+ HerdrClosePaneParams,
16
+ HerdrNotifyParams,
17
+ HerdrReadPaneParams,
18
+ HerdrSpawnPaneParams,
19
+ HerdrSpawnPeerParams,
20
+ ToolContext,
21
+ } from "./context.ts";
22
+
23
+ export async function waitForPeerRegistration(
24
+ name: string,
25
+ isComsAvailable: () => boolean,
26
+ peerNamesInScope: () => string[],
27
+ timeoutMs = PEER_READY_TIMEOUT_MS,
28
+ ): Promise<{ found: boolean; waitedMs: number }> {
29
+ const wanted = String(name).toLowerCase();
30
+ const started = Date.now();
31
+ for (let attempt = 0; ; attempt++) {
32
+ const live = isComsAvailable() ? peerNamesInScope() : [];
33
+ if (live.some(peerName => peerName.toLowerCase() === wanted)) {
34
+ return { found: true, waitedMs: Date.now() - started };
35
+ }
36
+ const remaining = timeoutMs - (Date.now() - started);
37
+ if (remaining <= 0) return { found: false, waitedMs: Date.now() - started };
38
+ await new Promise(resolve => setTimeout(resolve, Math.min(peerReadyDelayMs(attempt), remaining)));
39
+ }
40
+ }
41
+
42
+ export async function paneTail(paneId: string, lines = 12): Promise<string> {
43
+ try {
44
+ const { read } = await herdrApi.paneRead({ pane_id: paneId, lines });
45
+ return read?.text ?? "";
46
+ } catch {
47
+ return "";
48
+ }
49
+ }
50
+
51
+ export function peerManifest(cwd: string): string {
52
+ try {
53
+ return fs.readFileSync(path.join(cwd, ".pi", "agents", "peers.yaml"), "utf-8");
54
+ } catch {
55
+ return "";
56
+ }
57
+ }
58
+
59
+ export function peerPersonaExists(cwd: string, persona: string): boolean {
60
+ return (
61
+ fs.existsSync(path.join(cwd, "agents", `${persona}.md`)) ||
62
+ fs.existsSync(path.join(cwd, ".pi", "agents", `${persona}.md`))
63
+ );
64
+ }
65
+
66
+ export function spawnDelaySeconds(lastHubPiSpawnAt: number | null): number {
67
+ let authRaw: string | undefined;
68
+ try {
69
+ authRaw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
70
+ } catch {
71
+ authRaw = undefined;
72
+ }
73
+ return spawnStaggerSeconds({
74
+ needed: oauthNeedsWarmup(authRaw),
75
+ lastSpawnAt: lastHubPiSpawnAt,
76
+ now: Date.now(),
77
+ warmupSeconds: WARMUP_SECONDS,
78
+ });
79
+ }
80
+
81
+ export { STAGGER_ENV_VAR };
82
+
83
+ export function registerFleetTools(pi: ExtensionAPI, toolCtx: ToolContext): void {
84
+ pi.registerTool({
85
+ name: "herdr_spawn_peer",
86
+ label: "Herdr Spawn Peer",
87
+ description: "Spawn a reusable sibling coms peer from its declared or compatible override settings; wait for peer_ready.",
88
+ parameters: Type.Object({
89
+ name: Type.String({ description: "Peer and pane name." }),
90
+ runner: Type.Optional(Type.Union([Type.Literal("pi"), Type.Literal("claude-code")], { description: "Runner override." })),
91
+ persona: Type.Optional(Type.String({ description: "Pi persona override." })),
92
+ no_persona: Type.Optional(Type.Boolean({ description: "Use persona-less Fleet Core." })),
93
+ model: Type.Optional(Type.String({ description: "Model override." })),
94
+ extensions: Type.Optional(Type.String({ description: "Pi extensions." })),
95
+ browser: Type.Optional(Type.Boolean({ description: "Enable browser." })),
96
+ all_extensions: Type.Optional(Type.Boolean({ description: "All extensions (Fleet Core only)." })),
97
+ direction: Type.Optional(Type.Union([Type.Literal("right"), Type.Literal("down")], { description: "Split direction." })),
98
+ }),
99
+ execute(toolCallId, params, signal, onUpdate, ctx) {
100
+ return toolCtx.executeHerdrSpawnPeer(toolCallId, params as HerdrSpawnPeerParams, signal, onUpdate, ctx);
101
+ },
102
+ renderCall(args, theme) {
103
+ const a = args as any;
104
+ return new Text(
105
+ theme.fg("toolTitle", theme.bold("herdr_spawn_peer ")) + theme.fg("accent", a.name ?? "?") + theme.fg("dim", a.runner ? ` (${a.runner})` : ""),
106
+ 0, 0,
107
+ );
108
+ },
109
+ renderResult(result, _options, theme) {
110
+ const d = result.details as any;
111
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
112
+ if (d?.peer_ready === false) return new Text(theme.fg("error", `✗ ${d?.pane_id ?? "peer failed"}`), 0, 0);
113
+ return new Text(theme.fg("success", `✓ ${d?.pane_id ?? "spawned"}`), 0, 0);
114
+ },
115
+ });
116
+
117
+ pi.registerTool({
118
+ name: "herdr_spawn_pane",
119
+ label: "Herdr Spawn Pane",
120
+ description: "Spawn a raw auxiliary command in a sibling pane, not a coms peer.",
121
+ parameters: Type.Object({
122
+ name: Type.String({ description: "Human-visible pane label." }),
123
+ command: Type.String({ description: "Raw shell command executed with bash -lc." }),
124
+ direction: Type.Optional(Type.Union([Type.Literal("right"), Type.Literal("down")], { description: "Split direction (default right)." })),
125
+ }),
126
+ execute(toolCallId, params, signal, onUpdate, ctx) {
127
+ return toolCtx.executeHerdrSpawnPane(toolCallId, params as HerdrSpawnPaneParams, signal, onUpdate, ctx);
128
+ },
129
+ renderCall(args, theme) {
130
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_spawn_pane ")) + theme.fg("accent", (args as any).name ?? "?"), 0, 0);
131
+ },
132
+ renderResult(result, _options, theme) {
133
+ const d = result.details as any;
134
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
135
+ return new Text(theme.fg("success", `✓ ${d?.pane_id ?? "spawned"}`), 0, 0);
136
+ },
137
+ });
138
+
139
+ pi.registerTool({
140
+ name: "herdr_read_pane",
141
+ label: "Herdr Read Pane",
142
+ description: "Read up to 200 recent pane lines; use coms for bridged peers.",
143
+ parameters: Type.Object({
144
+ pane_id: Type.String({ description: "Pane id, e.g. w3:p2 (see herdr_spawn_peer result or the sidebar)." }),
145
+ lines: Type.Optional(Type.Number({ description: "Line cap, default 60, max 200." })),
146
+ }),
147
+ execute(toolCallId, params, signal, onUpdate, ctx) {
148
+ return toolCtx.executeHerdrReadPane(toolCallId, params as HerdrReadPaneParams, signal, onUpdate, ctx);
149
+ },
150
+ renderCall(args, theme) {
151
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_read_pane ")) + theme.fg("warning", (args as any).pane_id ?? "?"), 0, 0);
152
+ },
153
+ renderResult(result, _options, theme) {
154
+ const d = result.details as any;
155
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
156
+ return new Text(theme.fg("success", `✓ read ${d?.pane_id}`), 0, 0);
157
+ },
158
+ });
159
+
160
+ pi.registerTool({
161
+ name: "herdr_close_pane",
162
+ label: "Herdr Close Pane",
163
+ description: "Close a Hub-spawned pane. Destructive: always asks the human.",
164
+ parameters: Type.Object({
165
+ pane_id: Type.String({ description: "Pane id to close." }),
166
+ reason: Type.String({ description: "One line shown to the human: why this pane can die." }),
167
+ }),
168
+ execute(toolCallId, params, signal, onUpdate, ctx) {
169
+ return toolCtx.executeHerdrClosePane(toolCallId, params as HerdrClosePaneParams, signal, onUpdate, ctx);
170
+ },
171
+ renderCall(args, theme) {
172
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_close_pane ")) + theme.fg("error", (args as any).pane_id ?? "?"), 0, 0);
173
+ },
174
+ renderResult(result, _options, theme) {
175
+ const d = result.details as any;
176
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
177
+ if (d?.declined) return new Text(theme.fg("warning", "✗ declined by human"), 0, 0);
178
+ return new Text(theme.fg("success", `✓ closed`), 0, 0);
179
+ },
180
+ });
181
+
182
+ pi.registerTool({
183
+ name: "herdr_notify",
184
+ label: "Herdr Notify",
185
+ description: "Notify an away human; never replaces ask_user.",
186
+ parameters: Type.Object({
187
+ title: Type.String({ description: "Notification title." }),
188
+ body: Type.Optional(Type.String({ description: "Notification body." })),
189
+ }),
190
+ execute(toolCallId, params, signal, onUpdate, ctx) {
191
+ return toolCtx.executeHerdrNotify(toolCallId, params as HerdrNotifyParams, signal, onUpdate, ctx);
192
+ },
193
+ renderCall(args, theme) {
194
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_notify ")) + theme.fg("accent", (args as any).title ?? ""), 0, 0);
195
+ },
196
+ renderResult(result, _options, theme) {
197
+ const d = result.details as any;
198
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
199
+ return new Text(theme.fg("success", "✓ notified"), 0, 0);
200
+ },
201
+ });
202
+ }
@@ -0,0 +1,86 @@
1
+ import { PROFILE_ENV, profilePeerGate, profileSpawnPeerRefusal, readActiveProfile } from '../policy/profile-runtime.ts';
2
+ import { PANE_PROMPT_TIMEOUT_MS, launchPeerInPane } from "../../lib/spawned-peers.js";
3
+ import { herdrPaneId } from "../../lib/herdr-presence.ts";
4
+ import { buildHubPeerSpawnPlan, launchHubPeerInPane } from "../peer-spawn-plan.ts";
5
+ import { paneTail, peerManifest, peerPersonaExists, spawnDelaySeconds, STAGGER_ENV_VAR, waitForPeerRegistration } from "./fleet-tools.ts";
6
+ import { parseEnvFile, resolveEnvFilePath } from "../../../../scripts/lib/herdr-layout.ts";
7
+ import { worktreeTag } from "../../../../scripts/lib/team-project.ts";
8
+ import type { HerdrClosePaneParams, HerdrNotifyParams, HerdrReadPaneParams, HerdrSpawnPaneParams, HerdrSpawnPeerParams, ToolExecutionResult, ToolExecutor } from "./context.ts";
9
+
10
+ export interface HerdrExecutorDeps {
11
+ provisionalCapabilityRefusal(pack: "workspace"): ToolExecutionResult | null;
12
+ isFleetReady(): boolean;
13
+ isComsReady(): boolean;
14
+ getIdentity(): { project: string } | null;
15
+ getCurrentContext(): { cwd?: string; hasUI?: boolean; ui?: any } | null;
16
+ peersInScope(): Array<{ name: string }>;
17
+ getComsPeerNames(): string[];
18
+ herdr: any;
19
+ readEnvFile(path: string): string;
20
+ envFileExists(path: string): boolean;
21
+ getLastPiSpawnAt(): number | null;
22
+ setLastPiSpawnAt(value: number): void;
23
+ recordSpawnedPeer(name: string, paneId: string): void;
24
+ }
25
+
26
+ const unavailable = (): ToolExecutionResult => ({ content: [{ type: "text", text: "herdr is not available in this session." }], details: { error: "no herdr" } });
27
+ const noPane = (): ToolExecutionResult => ({ content: [{ type: "text", text: "not inside a herdr pane." }], details: { error: "no pane" } });
28
+
29
+ export function createHerdrExecutors(d: HerdrExecutorDeps): Pick<import("./context.ts").ToolContext, "executeHerdrSpawnPeer" | "executeHerdrSpawnPane" | "executeHerdrReadPane" | "executeHerdrClosePane" | "executeHerdrNotify"> {
30
+ const executeHerdrSpawnPeer: ToolExecutor<HerdrSpawnPeerParams> = async (_id, params) => {
31
+ const earlyProfile = profilePeerGate({ targetResolved: false }); if (earlyProfile) return earlyProfile;
32
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal;
33
+ if (!d.isFleetReady()) return unavailable();
34
+ const ownPane = herdrPaneId(); if (!ownPane) return noPane();
35
+ const identity = d.getIdentity();
36
+ if (!d.isComsReady() || !identity) return { content: [{ type: "text", text: "Cannot spawn an addressable peer while coms is unavailable. Start without --solo/--no-coms, or use herdr_spawn_pane for a non-peer command." }], details: { error: "no coms" } };
37
+ try {
38
+ const cwd = d.getCurrentContext()?.cwd ?? process.cwd();
39
+ const plan = buildHubPeerSpawnPlan(params, { project: identity.project, peersYaml: peerManifest(cwd), personaExists: persona => peerPersonaExists(cwd, persona), worktreeTag: worktreeTag(cwd) });
40
+ const profileRefusal = profileSpawnPeerRefusal(plan); if (profileRefusal) return profileRefusal;
41
+ if (d.peersInScope().some(peer => peer.name.toLowerCase() === plan.name.toLowerCase())) throw new Error(`Peer "${plan.name}" is already visible in project "${identity.project}"; use coms_send instead of spawning a duplicate.`);
42
+ const env: Record<string, string> = {};
43
+ if (plan.envFile) { const envPath = resolveEnvFilePath(plan.envFile, cwd); if (!d.envFileExists(envPath)) throw new Error(`env_file not found: ${plan.envFile} (resolved: ${envPath})`); Object.assign(env, parseEnvFile(d.readEnvFile(envPath), plan.envFile)); }
44
+ const active = readActiveProfile(); if (active) env[PROFILE_ENV] = JSON.stringify(active);
45
+ const delay = plan.runner === "pi" ? spawnDelaySeconds(d.getLastPiSpawnAt()) : 0; if (delay > 0) env[STAGGER_ENV_VAR] = String(delay);
46
+ const launched = await launchHubPeerInPane(plan, {
47
+ client: d.herdr, targetPaneId: ownPane, cwd, env,
48
+ waitForRegistration: (name, timeoutMs) => waitForPeerRegistration(name, () => d.isComsReady() && d.getIdentity() !== null, d.getComsPeerNames, timeoutMs),
49
+ paneTail,
50
+ onLaunched: paneId => { d.recordSpawnedPeer(plan.name, paneId); if (plan.runner === "pi") d.setLastPiSpawnAt(Date.now()); },
51
+ });
52
+ const promptNote = launched.promptSeen ? "" : `\n⚠ pane ${launched.paneId} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`;
53
+ return { content: [{ type: "text", text: `spawned ${plan.kind} in pane ${launched.paneId} (${plan.name}): ${plan.command.join(" ")}${promptNote}\n\n${launched.verdict.message}` }], details: { pane_id: launched.paneId, name: plan.name, kind: plan.kind, runner: plan.runner, project: plan.project, prompt_seen: launched.promptSeen, env_file: plan.envFile ?? null, ...launched.verdict } };
54
+ } catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_spawn_peer failed before readiness: ${m}` }], details: { error: m } }; }
55
+ };
56
+ const executeHerdrSpawnPane: ToolExecutor<HerdrSpawnPaneParams> = async (_id, params) => {
57
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal;
58
+ if (!d.isFleetReady()) return unavailable(); const ownPane = herdrPaneId(); if (!ownPane) return noPane();
59
+ try {
60
+ const cwd = d.getCurrentContext()?.cwd ?? process.cwd(); const argv = ["bash", "-lc", params.command];
61
+ const { pane } = await d.herdr.paneSplit({ target_pane_id: ownPane, direction: params.direction ?? "right", cwd, focus: false });
62
+ try { await d.herdr.paneRename(pane.pane_id, params.name); } catch {}
63
+ const launch = await launchPeerInPane(d.herdr, pane.pane_id, argv); const promptNote = launch.promptSeen ? "" : `\n⚠ pane ${pane.pane_id} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`;
64
+ return { content: [{ type: "text", text: `spawned raw pane ${pane.pane_id} (${params.name}): ${params.command}${promptNote}` }], details: { pane_id: pane.pane_id, name: params.name, prompt_seen: launch.promptSeen } };
65
+ } catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_spawn_pane failed: ${m}` }], details: { error: m } }; }
66
+ };
67
+ const executeHerdrReadPane: ToolExecutor<HerdrReadPaneParams> = async (_id, params) => {
68
+ if (!d.isFleetReady()) return unavailable(); const lines = Math.min(Math.max(1, params.lines ?? 60), 200);
69
+ try { const { read } = await d.herdr.paneRead({ pane_id: params.pane_id, lines }); return { content: [{ type: "text", text: read.text || "(pane is empty)" }], details: { pane_id: params.pane_id, lines } }; }
70
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_read_pane failed: ${m}` }], details: { error: m } }; }
71
+ };
72
+ const executeHerdrClosePane: ToolExecutor<HerdrClosePaneParams> = async (_id, params) => {
73
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal; if (!d.isFleetReady()) return unavailable();
74
+ const ctx = d.getCurrentContext(); if (!ctx?.hasUI) return { content: [{ type: "text", text: "no UI to confirm the close — refused." }], details: { error: "no ui" } };
75
+ const ok = await ctx.ui.confirm("herdr_close_pane", `Close pane ${params.pane_id}? Reason: ${params.reason}\nThis kills the process running in it.`);
76
+ if (!ok) return { content: [{ type: "text", text: `human declined closing ${params.pane_id} — adapt and continue.` }], details: { declined: true } };
77
+ try { await d.herdr.paneClose(params.pane_id); return { content: [{ type: "text", text: `closed ${params.pane_id}` }], details: { closed: params.pane_id } }; }
78
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_close_pane failed: ${m}` }], details: { error: m } }; }
79
+ };
80
+ const executeHerdrNotify: ToolExecutor<HerdrNotifyParams> = async (_id, params) => {
81
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal; if (!d.isFleetReady()) return unavailable();
82
+ try { await d.herdr.notificationShow({ title: params.title, body: params.body ?? "" }); return { content: [{ type: "text", text: `notified: ${params.title}` }], details: { title: params.title } }; }
83
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_notify failed: ${m}` }], details: { error: m } }; }
84
+ };
85
+ return { executeHerdrSpawnPeer, executeHerdrSpawnPane, executeHerdrReadPane, executeHerdrClosePane, executeHerdrNotify };
86
+ }