@chankov/agent-fleet 2.0.0 → 2.0.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.
Files changed (428) 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/package.json +1 -1
  4. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  5. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  6. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  7. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  8. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  9. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  10. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  11. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  12. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  13. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  14. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  15. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  16. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  17. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  18. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  19. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  20. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  21. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  22. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  23. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  24. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  25. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  26. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  27. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  28. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  29. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  30. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  31. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  32. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  33. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  34. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  35. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  36. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  37. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  38. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  39. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  40. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  41. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  42. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  43. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  44. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  45. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  46. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  47. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  48. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  49. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  50. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  51. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  52. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  53. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  54. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  55. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  56. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  57. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  58. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  59. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  60. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  61. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  62. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  63. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  64. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  65. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  66. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  67. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  68. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  69. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  70. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  71. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  72. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  74. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  75. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  76. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  77. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  78. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  79. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  80. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  81. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  82. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  83. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  84. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  85. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  86. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  87. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  88. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  89. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  90. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  91. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  92. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  93. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  94. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  95. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  96. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  97. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  98. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  99. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  100. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  101. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  102. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  103. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  104. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  105. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  106. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  107. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  108. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  109. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  110. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  111. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  112. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  113. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  114. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  115. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  116. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  117. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  118. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  119. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  120. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  121. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  122. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  123. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  124. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  125. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  126. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  129. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  130. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  131. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  132. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  133. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  134. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  135. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  136. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  137. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  138. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  139. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  140. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  141. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  142. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  143. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  144. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  145. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  146. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  147. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  148. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  149. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  150. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  151. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  152. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  153. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  154. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  155. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  156. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  157. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  158. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  159. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  160. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  161. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  162. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  163. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  164. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  165. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  166. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  167. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  168. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  169. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  170. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  171. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  172. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  173. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  174. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  175. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  176. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  177. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  178. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  179. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  180. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  181. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  182. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  183. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  184. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  185. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  186. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  187. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  188. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  189. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  190. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  191. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  192. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  193. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  194. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  195. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  196. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  197. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  198. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  199. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  200. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  201. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  202. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  203. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  204. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  205. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  206. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  207. package/.versions/2.0.1/.version +1 -0
  208. package/.versions/2.0.1/agents/architect.md +25 -0
  209. package/.versions/2.0.1/agents/bowser.md +28 -0
  210. package/.versions/2.0.1/agents/builder.md +56 -0
  211. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  212. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  213. package/.versions/2.0.1/agents/documenter.md +22 -0
  214. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  215. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  216. package/.versions/2.0.1/agents/planner.md +73 -0
  217. package/.versions/2.0.1/agents/releaser.md +25 -0
  218. package/.versions/2.0.1/agents/researcher.md +31 -0
  219. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  220. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  221. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  222. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  223. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  224. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  225. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  226. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  227. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  228. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  229. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  230. package/.versions/2.0.1/docs/getting-started.md +119 -0
  231. package/.versions/2.0.1/docs/npm-install.md +292 -0
  232. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  233. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  234. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  235. package/.versions/2.0.1/hermes/README.md +347 -0
  236. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  237. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  238. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  239. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  240. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  241. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  242. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  243. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  244. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  245. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  246. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  247. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  248. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  249. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  250. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  251. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  252. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  253. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  254. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  255. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  256. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  257. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  258. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  259. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  260. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  261. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  262. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  263. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  264. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  265. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  266. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  267. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  268. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  269. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  270. package/.versions/2.0.1/install-manifest.json +2830 -0
  271. package/.versions/2.0.1/justfile +286 -0
  272. package/.versions/2.0.1/manifest-meta.json +913 -0
  273. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  274. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  275. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  276. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  277. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  278. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  279. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  280. package/.versions/2.0.1/references/security-checklist.md +179 -0
  281. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  282. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  283. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  284. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  285. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  286. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  287. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  288. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  289. package/.versions/2.0.1/scripts/flow.ts +121 -0
  290. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  291. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  292. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  293. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  294. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  295. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  296. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  297. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  298. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  299. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  300. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  301. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  302. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  303. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  304. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  305. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  306. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  307. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  308. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  309. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  310. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  311. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  312. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  313. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  314. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  315. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  316. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  317. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  318. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  319. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  320. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  321. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  322. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  323. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  324. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  325. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  326. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  327. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  328. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  329. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  330. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  331. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  332. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  333. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  334. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  335. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  336. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  337. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  338. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  339. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  340. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  341. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  342. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  343. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  344. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  345. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  346. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  347. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  348. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  349. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  350. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  351. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  352. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  353. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  354. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  355. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  356. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  357. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  358. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  359. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  360. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  361. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  362. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  363. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  364. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  365. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  366. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  367. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  368. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  369. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  370. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  371. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  372. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  373. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  374. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  375. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  376. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  377. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  378. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  379. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  380. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  381. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  382. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  383. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  384. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  385. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  386. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  387. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  388. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  389. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  390. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  391. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  392. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  393. package/CHANGELOG.md +7 -0
  394. package/README.md +21 -0
  395. package/agents/code-reviewer.md +1 -0
  396. package/agents/documenter.md +3 -0
  397. package/agents/planner.md +2 -0
  398. package/agents/researcher.md +2 -0
  399. package/docs/ARCHITECTURE.md +3 -0
  400. package/docs/getting-started.md +21 -0
  401. package/docs/workflows.md +136 -0
  402. package/install-manifest.json +86 -1
  403. package/justfile +14 -0
  404. package/manifest-meta.json +32 -1
  405. package/package.json +10 -3
  406. package/references/workflow-authoring.md +304 -0
  407. package/scripts/fleet.ts +13 -0
  408. package/scripts/flow.ts +121 -0
  409. package/scripts/lib/flow-command.ts +77 -0
  410. package/scripts/lib/flow-maintenance.ts +230 -0
  411. package/scripts/workflows/lib/agent-phase.ts +118 -0
  412. package/scripts/workflows/lib/changes.ts +61 -0
  413. package/scripts/workflows/lib/env.ts +34 -0
  414. package/scripts/workflows/lib/envelopes.ts +141 -0
  415. package/scripts/workflows/lib/gates.ts +81 -0
  416. package/scripts/workflows/lib/git.ts +96 -0
  417. package/scripts/workflows/lib/permissions.ts +130 -0
  418. package/scripts/workflows/lib/personas.ts +44 -0
  419. package/scripts/workflows/lib/quality.ts +64 -0
  420. package/scripts/workflows/lib/run.ts +106 -0
  421. package/scripts/workflows/lib/trace.ts +34 -0
  422. package/scripts/workflows/tsconfig.json +22 -0
  423. package/scripts/workflows/wf-build-test.ts +61 -0
  424. package/scripts/workflows/wf-document.ts +50 -0
  425. package/scripts/workflows/wf-quality.ts +20 -0
  426. package/scripts/workflows/wf-scout.ts +38 -0
  427. package/skills/drafting-workflows/SKILL.md +143 -0
  428. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
@@ -0,0 +1,139 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import type { ComsAwaitParams, ComsGetParams, ComsListParams, ComsSendParams, ToolContext } from "./context.ts";
5
+
6
+ export function registerComsTools(pi: ExtensionAPI, toolCtx: ToolContext): void {
7
+ pi.registerTool({
8
+ name: "coms_list",
9
+ label: "Coms List",
10
+ description: "List peers in the human-scoped pool; this tool cannot widen discovery.",
11
+ parameters: Type.Object({
12
+ project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
13
+ include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
14
+ }),
15
+ execute(toolCallId, params, signal, onUpdate, ctx) {
16
+ return toolCtx.executeComsList(toolCallId, params as ComsListParams, signal, onUpdate, ctx);
17
+ },
18
+ renderCall(args, theme) {
19
+ const proj = (args as any).project;
20
+ const filter = proj ? ` ${proj}` : "";
21
+ return new Text(
22
+ theme.fg("toolTitle", theme.bold("coms_list")) + theme.fg("dim", filter),
23
+ 0, 0,
24
+ );
25
+ },
26
+ renderResult(result, options, theme) {
27
+ const details = result.details as any;
28
+ const agents: any[] = details?.agents ?? [];
29
+ const header = theme.fg("accent", `📡 ${agents.length} peer(s)`);
30
+ if (!options.expanded || agents.length === 0) {
31
+ return new Text(header, 0, 0);
32
+ }
33
+ const rows = agents.map((a) => {
34
+ const dot = a.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
35
+ const pct = a.context_used_pct != null ? `${a.context_used_pct}%` : "?%";
36
+ const state = a.alive ? (a.status ?? "unknown") : "unreachable";
37
+ const stateFg = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
38
+ return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)} ` +
39
+ `${theme.fg(stateFg as any, state)}${a.pane_id ? theme.fg("dim", ` ${a.pane_id}`) : ""}`;
40
+ }).join("\n");
41
+ return new Text(header + "\n" + rows, 0, 0);
42
+ },
43
+ });
44
+
45
+ pi.registerTool({
46
+ name: "coms_send",
47
+ label: "Coms Send",
48
+ description: "Send to an in-pool peer; use its msg_id with coms_get or coms_await.",
49
+ parameters: Type.Object({
50
+ target: Type.String({ description: "Peer name (preferred) or session_id — must be a peer currently in your coms pool (shown in the widget). Out-of-pool targets are refused; ask the human to widen scope with /af-coms --project or /af-coms --all." }),
51
+ prompt: Type.String({ description: "The prompt to send." }),
52
+ handoff_token: Type.Optional(Type.String({ description: "Internal /af-handoff token. Only include when the /af-handoff follow-up explicitly gives you one; it authorizes the machine-appended ledger/artifact appendix." })),
53
+ conversation_id: Type.Optional(Type.String()),
54
+ response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
55
+ reply_timeout_ms: Type.Optional(Type.Number({ description: "Receiver-side reply deadline in ms; pass the same budget used for coms_await. Clamped by the receiver." })),
56
+ }),
57
+ execute(toolCallId, params, signal, onUpdate, ctx) {
58
+ return toolCtx.executeComsSend(toolCallId, params as ComsSendParams, signal, onUpdate, ctx);
59
+ },
60
+ renderCall(args, theme) {
61
+ const tgt = (args as any).target ?? "?";
62
+ const prompt = (args as any).prompt ?? "";
63
+ const preview = prompt.length > 60 ? prompt.slice(0, 57) + "..." : prompt;
64
+ return new Text(
65
+ theme.fg("toolTitle", theme.bold("coms_send ")) +
66
+ theme.fg("accent", tgt) +
67
+ theme.fg("dim", " — ") +
68
+ theme.fg("muted", preview),
69
+ 0, 0,
70
+ );
71
+ },
72
+ renderResult(result, _options, theme) {
73
+ const d = result.details as any;
74
+ if (!d) {
75
+ const t = result.content[0];
76
+ return new Text(t?.type === "text" ? t.text : "", 0, 0);
77
+ }
78
+ return new Text(
79
+ theme.fg("success", "→ ") +
80
+ theme.fg("accent", d.target) +
81
+ theme.fg("dim", ` msg_id `) +
82
+ theme.fg("warning", d.msg_id),
83
+ 0, 0,
84
+ );
85
+ },
86
+ });
87
+
88
+ pi.registerTool({
89
+ name: "coms_get",
90
+ label: "Coms Get",
91
+ description:
92
+ "Non-blocking poll of a pending coms_send reply. Returns status pending|complete|error and (when complete) the response.",
93
+ parameters: Type.Object({
94
+ msg_id: Type.String({ description: "msg_id returned by coms_send." }),
95
+ }),
96
+ execute(toolCallId, params, signal, onUpdate, ctx) {
97
+ return toolCtx.executeComsGet(toolCallId, params as ComsGetParams, signal, onUpdate, ctx);
98
+ },
99
+ renderCall(args, theme) {
100
+ const id = (args as any).msg_id ?? "?";
101
+ return new Text(
102
+ theme.fg("toolTitle", theme.bold("coms_get ")) + theme.fg("warning", id),
103
+ 0, 0,
104
+ );
105
+ },
106
+ renderResult(result, _options, theme) {
107
+ const d = result.details as any;
108
+ const status = d?.status ?? "?";
109
+ const color = status === "complete" ? "success" : status === "pending" ? "warning" : "error";
110
+ return new Text(theme.fg(color, status), 0, 0);
111
+ },
112
+ });
113
+
114
+ pi.registerTool({
115
+ name: "coms_await",
116
+ label: "Coms Await",
117
+ description: "Wait for a pending coms_send reply; timeout leaves it pending.",
118
+ parameters: Type.Object({
119
+ msg_id: Type.String({ description: "msg_id returned by coms_send." }),
120
+ timeout_ms: Type.Optional(Type.Number({ description: "Override the default timeout (ms)." })),
121
+ }),
122
+ execute(toolCallId, params, signal, onUpdate, ctx) {
123
+ return toolCtx.executeComsAwait(toolCallId, params as ComsAwaitParams, signal, onUpdate, ctx);
124
+ },
125
+ renderCall(args, theme) {
126
+ const id = (args as any).msg_id ?? "?";
127
+ return new Text(
128
+ theme.fg("toolTitle", theme.bold("coms_await ")) + theme.fg("warning", id),
129
+ 0, 0,
130
+ );
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
+ if (d?.status === "pending") return new Text(theme.fg("warning", "⏳ pending"), 0, 0);
136
+ return new Text(theme.fg("success", "✓ response received"), 0, 0);
137
+ },
138
+ });
139
+ }
@@ -0,0 +1,132 @@
1
+ import type {
2
+ AgentToolResult,
3
+ AgentToolUpdateCallback,
4
+ ExtensionContext,
5
+ } from "@mariozechner/pi-coding-agent";
6
+
7
+ export interface DispatchAgentParams {
8
+ agent: string;
9
+ task: string;
10
+ artifacts?: string[];
11
+ scope?: string[];
12
+ watchdog?: boolean;
13
+ review_reason?: string;
14
+ backend?: "auto" | "native" | "coms";
15
+ }
16
+
17
+ export interface SpawnResearchParams {
18
+ task: string;
19
+ persona?: string;
20
+ model?: string;
21
+ artifacts?: string[];
22
+ }
23
+
24
+ export interface SetTaskTierParams {
25
+ tier: string;
26
+ reason?: string;
27
+ new_task?: boolean;
28
+ }
29
+
30
+ export interface TeamAdjustParams {
31
+ action: string;
32
+ agent: string;
33
+ reason: string;
34
+ }
35
+
36
+ export interface SetAssertionsParams {
37
+ assertions: Array<{ id: string; tag: string; text: string; source?: string }>;
38
+ }
39
+
40
+ export interface UpdateAssertionParams {
41
+ id: string;
42
+ status: string;
43
+ evidence?: string;
44
+ }
45
+
46
+ export interface ComsListParams {
47
+ project?: string;
48
+ include_explicit?: boolean;
49
+ }
50
+
51
+ export interface ComsSendParams {
52
+ target: string;
53
+ prompt: string;
54
+ handoff_token?: string;
55
+ conversation_id?: string;
56
+ response_schema?: unknown;
57
+ reply_timeout_ms?: number;
58
+ }
59
+
60
+ export interface ComsGetParams {
61
+ msg_id: string;
62
+ }
63
+
64
+ export interface ComsAwaitParams {
65
+ msg_id: string;
66
+ timeout_ms?: number;
67
+ }
68
+
69
+ export interface HerdrSpawnPeerParams {
70
+ name: string;
71
+ runner?: "pi" | "claude-code";
72
+ persona?: string;
73
+ no_persona?: boolean;
74
+ model?: string;
75
+ extensions?: string;
76
+ browser?: boolean;
77
+ all_extensions?: boolean;
78
+ direction?: "right" | "down";
79
+ }
80
+
81
+ export interface HerdrSpawnPaneParams {
82
+ name: string;
83
+ command: string;
84
+ direction?: "right" | "down";
85
+ }
86
+
87
+ export interface HerdrReadPaneParams {
88
+ pane_id: string;
89
+ lines?: number;
90
+ }
91
+
92
+ export interface HerdrClosePaneParams {
93
+ pane_id: string;
94
+ reason: string;
95
+ }
96
+
97
+ export interface HerdrNotifyParams {
98
+ title: string;
99
+ body?: string;
100
+ }
101
+
102
+ export type ToolUpdate = AgentToolUpdateCallback<unknown> | undefined;
103
+ export type ToolExecutionResult = AgentToolResult<unknown>;
104
+
105
+ export type ToolExecutor<TParams> = (
106
+ toolCallId: string,
107
+ params: TParams,
108
+ signal: AbortSignal | undefined,
109
+ onUpdate: ToolUpdate,
110
+ ctx: ExtensionContext,
111
+ ) => Promise<ToolExecutionResult>;
112
+
113
+ /** Dependencies tool registrars receive from the hub composition root. */
114
+ export interface ToolContext {
115
+ executeDispatchAgent: ToolExecutor<DispatchAgentParams>;
116
+ executeSpawnResearch: ToolExecutor<SpawnResearchParams>;
117
+ executeSetTaskTier: ToolExecutor<SetTaskTierParams>;
118
+ executeTeamAdjust: ToolExecutor<TeamAdjustParams>;
119
+ executeSetAssertions: ToolExecutor<SetAssertionsParams>;
120
+ executeUpdateAssertion: ToolExecutor<UpdateAssertionParams>;
121
+ executeGetAssertions: ToolExecutor<Record<string, never>>;
122
+ executeComsList: ToolExecutor<ComsListParams>;
123
+ executeComsSend: ToolExecutor<ComsSendParams>;
124
+ executeComsGet: ToolExecutor<ComsGetParams>;
125
+ executeComsAwait: ToolExecutor<ComsAwaitParams>;
126
+ executeHerdrSpawnPeer: ToolExecutor<HerdrSpawnPeerParams>;
127
+ executeHerdrSpawnPane: ToolExecutor<HerdrSpawnPaneParams>;
128
+ executeHerdrReadPane: ToolExecutor<HerdrReadPaneParams>;
129
+ executeHerdrClosePane: ToolExecutor<HerdrClosePaneParams>;
130
+ executeHerdrNotify: ToolExecutor<HerdrNotifyParams>;
131
+ getAssertionCount(): number;
132
+ }
@@ -0,0 +1,79 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import type { DispatchAgentParams, ToolContext } from "./context.ts";
5
+
6
+ export function registerDispatchAgent(pi: ExtensionAPI, toolCtx: ToolContext): void {
7
+ pi.registerTool({
8
+ name: "dispatch_agent",
9
+ label: "Dispatch Agent",
10
+ description: "Dispatch one focused task to a listed specialist; it returns evidence.",
11
+ parameters: Type.Object({
12
+ agent: Type.String({ description: "Agent name (case-insensitive)" }),
13
+ task: Type.String({ description: "Task description for the agent to execute" }),
14
+ artifacts: Type.Optional(Type.Array(Type.String({ description: "Input artifact path; the specialist reads it." }))),
15
+ scope: Type.Optional(Type.Array(Type.String({ description: "Advisory writable-file globs; violations are reported, never reverted." }))),
16
+ watchdog: Type.Optional(Type.Boolean({ description: "Override this dispatch's drift watchdog." })),
17
+ review_reason: Type.Optional(Type.String({ description: "Why a docs-only review is needed." })),
18
+ backend: Type.Optional(Type.Union([
19
+ Type.Literal("auto"),
20
+ Type.Literal("native"),
21
+ Type.Literal("coms"),
22
+ ], { description: "auto policy; native local; coms requires its live peer (no fallback)." })),
23
+ }),
24
+
25
+ execute(toolCallId, params, signal, onUpdate, ctx) {
26
+ return toolCtx.executeDispatchAgent(toolCallId, params as DispatchAgentParams, signal, onUpdate, ctx);
27
+ },
28
+
29
+ renderCall(args, theme) {
30
+ const agentName = (args as any).agent || "?";
31
+ const task = (args as any).task || "";
32
+ const preview = task.length > 60 ? task.slice(0, 57) + "..." : task;
33
+ return new Text(
34
+ theme.fg("toolTitle", theme.bold("dispatch_agent ")) +
35
+ theme.fg("accent", agentName) +
36
+ theme.fg("dim", " — ") +
37
+ theme.fg("muted", preview),
38
+ 0, 0,
39
+ );
40
+ },
41
+
42
+ renderResult(result, options, theme) {
43
+ const details = result.details as any;
44
+ if (!details) {
45
+ const text = result.content[0];
46
+ return new Text(text?.type === "text" ? text.text : "", 0, 0);
47
+ }
48
+
49
+ // Streaming/partial result while agent is still running
50
+ if (options.isPartial || details.status === "dispatching") {
51
+ return new Text(
52
+ theme.fg("accent", `● ${details.agent || "?"}`) +
53
+ theme.fg("dim", " working..."),
54
+ 0, 0,
55
+ );
56
+ }
57
+
58
+ const icon = details.status === "done" ? "✓" : "✗";
59
+ const color = details.status === "done" ? "success" : "error";
60
+ const elapsed = typeof details.elapsed === "number" ? Math.round(details.elapsed / 1000) : 0;
61
+ const header = theme.fg(color, `${icon} ${details.agent}`) +
62
+ theme.fg("dim", ` ${elapsed}s`);
63
+
64
+ const questions: string[] = Array.isArray(details.questions) ? details.questions : [];
65
+ const questionsBlock = questions.length > 0
66
+ ? "\n" + theme.fg("warning", `⚠ ${questions.length} ASK_USER question(s) raised — surface via ask_user`)
67
+ : "";
68
+
69
+ if (options.expanded && details.fullOutput) {
70
+ const output = details.fullOutput.length > 4000
71
+ ? details.fullOutput.slice(0, 4000) + "\n... [truncated]"
72
+ : details.fullOutput;
73
+ return new Text(header + questionsBlock + "\n" + theme.fg("muted", output), 0, 0);
74
+ }
75
+
76
+ return new Text(header + questionsBlock, 0, 0);
77
+ },
78
+ });
79
+ }
@@ -0,0 +1,200 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
+ import { blockingFindingCap, checkReviewRoundCap, checkTaskBudget, checkTierPersonaGate, checkTurnBudget, isReviewPersona, remainingTaskResearch, reviewBudgetClause, reviewRoundCap } from "../run-budget.js";
4
+ import { countReviewFindings, findingBudgetNotice } from "../review-findings.js";
5
+ import { checkDocsLane, docsLaneNotice } from "../docs-lane.js";
6
+ import { checkExternalBlockerGate, extractExternalBlockers } from "../external-blocker.js";
7
+ import { budgetContinuationInstruction } from "../budget-continuation.ts";
8
+ import { checkScope, diffAgainst, snapshotWorktree } from "../scope-gate.js";
9
+ import { crossCheck, deliveryDisposition, extractAssertionIds, parseDeliveredReturn } from "../return-contract.js";
10
+ import { shouldExtractReturn } from "../return-extract.js";
11
+ import { normalizeAgentInput, safeAgentKey, safePathWithin, taskFingerprint } from "../helpers.ts";
12
+ import { MAX_AUTO_RESEARCH_QUESTIONS, MAX_AUTO_RESEARCH_ROUNDS, type ResearchAgentDef, type ResearchRuntime } from "../research/runtime.ts";
13
+ import type { BudgetContext, SessionTotals, TurnReport } from "../context/budgets.ts";
14
+ import type { AssertionsArtifactsContext, InputArtifactPreview } from "../context/assertions-artifacts.ts";
15
+ import type { DispatchAgentParams, SpawnResearchParams, ToolExecutionResult, ToolExecutor, ToolUpdate } from "./context.ts";
16
+
17
+ type Gate = { reason: string; message: string } | null;
18
+ type DispatchResult = { output: string; exitCode: number; elapsed: number; billed?: number; out?: number; pending?: boolean; sessionReset?: unknown };
19
+ type AgentState = { def: { name: string; tools: string }; runCount: number; contextPct: number; lastBackend?: string | null };
20
+
21
+ export interface DispatchExecutionState {
22
+ getTurnDispatchCount(): number; setTurnDispatchCount(value: number): void;
23
+ getTurnResearchCount(): number; setTurnResearchCount(value: number): void;
24
+ getTaskDispatchCount(): number; setTaskDispatchCount(value: number): void;
25
+ getTaskResearchCount(): number; setTaskResearchCount(value: number): void;
26
+ getTaskReviewRounds(): number; setTaskReviewRounds(value: number): void;
27
+ getTaskTier(): string | null;
28
+ getTurnReport(): TurnReport;
29
+ getSessionTotals(): SessionTotals;
30
+ getTurnDispatchFingerprints(): Set<string>;
31
+ getExternalBlockers(): Array<{ agent: string; what: string }>;
32
+ getExternalBlockerAcknowledged(): boolean; setExternalBlockerAcknowledged(value: boolean): void;
33
+ getExternalBlockerRefusedOnce(): boolean; setExternalBlockerRefusedOnce(value: boolean): void;
34
+ isAskUserAvailable(): boolean;
35
+ getUserLanguage(): string;
36
+ getSessionDir(): string;
37
+ getAgentStates(): Map<string, AgentState>;
38
+ getResearchPersonas(): ResearchAgentDef[];
39
+ getActiveWritableDispatches(): number; setActiveWritableDispatches(value: number): void;
40
+ getWritableOverlapCounter(): number; setWritableOverlapCounter(value: number): void;
41
+ }
42
+
43
+ export interface DispatchExecutorDeps {
44
+ state: DispatchExecutionState;
45
+ budget: BudgetContext;
46
+ artifacts: AssertionsArtifactsContext;
47
+ research: ResearchRuntime<any>;
48
+ provisionalCapabilityRefusal(pack: "fleet"): ToolExecutionResult | null;
49
+ dispatchAgent(agent: string, task: string, ctx: ExtensionContext, artifacts: InputArtifactPreview[], scope: string[], watchdog?: boolean, backend?: "auto" | "native" | "coms", resume?: boolean): Promise<DispatchResult>;
50
+ runReturnExtraction(path: string, ids: string[], ctx: ExtensionContext): Promise<any>;
51
+ extractNeedsResearch(output: string): string[];
52
+ extractAskUserQuestions(output: string): string[];
53
+ contextPressure(percent: number): boolean;
54
+ displayName(name: string): string;
55
+ updateResearchWidget(): void;
56
+ }
57
+
58
+ interface PreparedDispatch { agent: string; task: string; inputArtifacts: InputArtifactPreview[]; scopeGlobs: string[]; fingerprint: string; }
59
+ interface RunData { result: DispatchResult; billed: number; out: number; researchRounds: { questions: string[]; files: string[] }[]; autoResearchTaskCapped: boolean; }
60
+ interface Tracking { writable: boolean; snapshot: any; overlapBaseline: number; concurrentAtStart: boolean; }
61
+
62
+ export function preflightGate(d: DispatchExecutorDeps, persona: string): Gate {
63
+ const s = d.state;
64
+ const blocked = checkExternalBlockerGate({ blockers: s.getExternalBlockers(), acknowledged: s.getExternalBlockerAcknowledged(), askUserAvailable: s.isAskUserAvailable(), refusedOnce: s.getExternalBlockerRefusedOnce() });
65
+ if (blocked) { s.setExternalBlockerRefusedOnce(true); return blocked; }
66
+ return checkTierPersonaGate(s.getTaskTier(), persona);
67
+ }
68
+
69
+ function refusal(d: DispatchExecutorDeps, agent: string, task: string, status: string, message: string, reason?: string): ToolExecutionResult {
70
+ d.state.getTurnReport().refusals++; d.state.getSessionTotals().refusals++;
71
+ return { content: [{ type: "text", text: message }], details: { agent, task, status, reason: reason ?? status, elapsed: 0, exitCode: 1, fullOutput: "" } };
72
+ }
73
+
74
+ function prepareDispatch(d: DispatchExecutorDeps, params: DispatchAgentParams, ctx: ExtensionContext): PreparedDispatch | ToolExecutionResult {
75
+ const s = d.state; const { task, artifacts, scope, review_reason } = params; const agent = normalizeAgentInput(params.agent);
76
+ d.budget.ensureTaskTier();
77
+ const preflight = preflightGate(d, agent) ?? checkReviewRoundCap(s.getTaskTier(), agent, s.getTaskReviewRounds()) ?? checkDocsLane(agent, scope || [], review_reason);
78
+ if (preflight) return refusal(d, agent, task, preflight.reason, preflight.message, preflight.reason);
79
+ const taskRefusal = checkTaskBudget("dispatch", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
80
+ if (taskRefusal) { d.budget.armBudgetContinuation("task", taskRefusal.reason); return refusal(d, agent, task, "task_budget_refused", budgetContinuationInstruction(taskRefusal.message, "task", s.getUserLanguage()), taskRefusal.reason); }
81
+ const turnRefusal = checkTurnBudget("dispatch", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
82
+ if (turnRefusal) { d.budget.armBudgetContinuation("turn", turnRefusal.reason); return refusal(d, agent, task, "budget_refused", budgetContinuationInstruction(turnRefusal.message, "turn", s.getUserLanguage()), turnRefusal.reason); }
83
+ const fingerprint = taskFingerprint(agent, task);
84
+ 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.`);
85
+ let inputArtifacts: InputArtifactPreview[];
86
+ try { inputArtifacts = d.artifacts.loadInputArtifacts(artifacts, ctx); }
87
+ 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: "" } }; }
88
+ s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1);
89
+ if (isReviewPersona(agent)) s.setTaskReviewRounds(s.getTaskReviewRounds() + 1);
90
+ s.getSessionTotals().dispatches++; d.budget.updateModeStatus();
91
+ return { agent, task, inputArtifacts, scopeGlobs: (scope || []).map(String).map(x => x.trim()).filter(Boolean), fingerprint };
92
+ }
93
+
94
+ function startTracking(d: DispatchExecutorDeps, prepared: PreparedDispatch, ctx: ExtensionContext): Tracking {
95
+ const s = d.state; const state = s.getAgentStates().get(prepared.agent.toLowerCase()); const canWrite = !!state && hasWriteCapability(state.def.tools);
96
+ const tracking = { writable: canWrite, snapshot: null as any, overlapBaseline: s.getWritableOverlapCounter(), concurrentAtStart: false };
97
+ if (canWrite) {
98
+ tracking.concurrentAtStart = s.getActiveWritableDispatches() > 0;
99
+ if (tracking.concurrentAtStart) s.setWritableOverlapCounter(s.getWritableOverlapCounter() + 1);
100
+ s.setActiveWritableDispatches(s.getActiveWritableDispatches() + 1);
101
+ if (prepared.scopeGlobs.length > 0) tracking.snapshot = snapshotWorktree(ctx.cwd || process.cwd());
102
+ }
103
+ return tracking;
104
+ }
105
+
106
+ async function runWithAutoResearch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<RunData> {
107
+ const findingClause = reviewBudgetClause(d.state.getTaskTier(), p.agent); const dispatchedTask = findingClause ? `${p.task}\n\n${findingClause}` : p.task;
108
+ let result = await d.dispatchAgent(p.agent, dispatchedTask, ctx, p.inputArtifacts, p.scopeGlobs, params.watchdog, params.backend ?? "auto");
109
+ let billed = result.billed ?? 0; let out = result.out ?? 0; const researchRounds: RunData["researchRounds"] = []; let autoResearchTaskCapped = false;
110
+ while (result.exitCode === 0 && researchRounds.length < MAX_AUTO_RESEARCH_ROUNDS) {
111
+ const left = remainingTaskResearch(d.budget.currentTaskBudget(), d.budget.taskCounters()); if (left === 0) { autoResearchTaskCapped = true; break; }
112
+ 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;
113
+ d.state.setTaskResearchCount(d.state.getTaskResearchCount() + questions.length); d.budget.updateModeStatus();
114
+ 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" } });
115
+ const findingsDir = safePathWithin(d.state.getSessionDir(), "findings"); mkdirSync(findingsDir, { recursive: true }); const key = safeAgentKey(d.state.getAgentStates().get(p.agent.toLowerCase())?.def.name ?? p.agent);
116
+ const answered = await Promise.all(questions.map(async question => {
117
+ const def = d.research.anonymousDef(); const state = d.research.createState(def, false, d.research.resolveModel(def, undefined, ctx), true); d.updateResearchWidget();
118
+ const response = await d.research.spawn(state, question, ctx); const file = safePathWithin(findingsDir, `${key}-r${state.id}.md`);
119
+ 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`, "utf-8"); return { question, file };
120
+ }));
121
+ researchRounds.push({ questions, files: answered.map(a => a.file) });
122
+ 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");
123
+ 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;
124
+ }
125
+ return { result, billed, out, researchRounds, autoResearchTaskCapped };
126
+ }
127
+
128
+ function scopeResult(d: DispatchExecutorDeps, p: PreparedDispatch, tracking: Tracking, ctx: ExtensionContext): any {
129
+ if (!tracking.snapshot) return null; const diff = diffAgainst(tracking.snapshot, ctx.cwd || process.cwd());
130
+ const concurrentWritableOverlap = tracking.concurrentAtStart || d.state.getWritableOverlapCounter() !== tracking.overlapBaseline;
131
+ if (diff.skipped) return { skipped: true, reason: diff.reason, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
132
+ return { ...checkScope(diff.paths, p.scopeGlobs), changedPaths: diff.paths, declaredScope: p.scopeGlobs, concurrentWritableOverlap };
133
+ }
134
+
135
+ async function finishDispatch(d: DispatchExecutorDeps, p: PreparedDispatch, params: DispatchAgentParams, run: RunData, tracking: Tracking, ctx: ExtensionContext, onUpdate: ToolUpdate): Promise<ToolExecutionResult> {
136
+ const s = d.state; const { result, researchRounds } = run; const ids = extractAssertionIds(p.task); const disposition = deliveryDisposition(result.exitCode, result.pending === true);
137
+ let { parsed: parsedReturn, notices: contractNotices } = parseDeliveredReturn(result.output, ids, disposition.delivered); const shouldUseDigest = ids.length > 0 || !!parsedReturn;
138
+ const state = s.getAgentStates().get(p.agent.toLowerCase()); const key = safeAgentKey(state?.def.name ?? p.agent);
139
+ const runPath = disposition.artifactKind && (shouldUseDigest || !disposition.delivered) ? d.artifacts.writeRunArtifact(key, state?.runCount ?? 0, result.output, disposition.artifactKind) : null;
140
+ const returnPath = disposition.delivered ? runPath : null; const failurePath = disposition.delivered ? null : runPath; let returnExtracted = false;
141
+ if (returnPath && shouldExtractReturn(parsedReturn, ids)) {
142
+ 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" } });
143
+ const recovered = await d.runReturnExtraction(returnPath, ids, ctx); if (recovered) { parsedReturn = recovered; contractNotices = crossCheck(recovered, ids); returnExtracted = true; }
144
+ }
145
+ if ([0, 124, 125].includes(result.exitCode)) s.getTurnDispatchFingerprints().add(p.fingerprint);
146
+ s.getTurnReport().dispatches.push({ agent: p.agent, status: disposition.status, elapsed: result.elapsed, billed: run.billed, out: run.out }); s.getSessionTotals().billed += run.billed; s.getSessionTotals().out += run.out;
147
+ const questions = d.extractAskUserQuestions(result.output); const unresolved = d.extractNeedsResearch(result.output); const answered = researchRounds.reduce((n, r) => n + r.questions.length, 0);
148
+ const notices: string[] = [];
149
+ const blockers = extractExternalBlockers(result.output); if (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.`); }
150
+ 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")}`);
151
+ 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.`);
152
+ 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.`);
153
+ 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.`);
154
+ if (returnPath) notices.push(`Full specialist output: ${returnPath}`);
155
+ 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.");
156
+ 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.`);
157
+ 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.`);
158
+ 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).`);
159
+ const scopeViolations = scopeResult(d, p, tracking, ctx); const scopeNotice = scopeNoticeText(scopeViolations); if (scopeNotice) notices.push(scopeNotice.trim());
160
+ 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());
161
+ const docs = docsLaneNotice(p.agent, p.scopeGlobs); if (docs) notices.push(docs);
162
+ 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." : "";
163
+ 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);
164
+ return { content: [{ type: "text", text: `[${p.agent}] ${disposition.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: disposition.status, backendRequested: params.backend ?? "auto", backendUsed: state?.lastBackend ?? null, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, 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 })) } };
165
+ }
166
+
167
+ export function createDispatchExecutor(d: DispatchExecutorDeps): ToolExecutor<DispatchAgentParams> {
168
+ return async (_id, params, _signal, onUpdate, ctx) => {
169
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability;
170
+ const prepared = prepareDispatch(d, params, ctx); if (!("agent" in prepared)) return prepared;
171
+ const tracking = startTracking(d, prepared, ctx);
172
+ 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); }
173
+ 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: "" } }; }
174
+ finally { if (tracking.writable) d.state.setActiveWritableDispatches(Math.max(0, d.state.getActiveWritableDispatches() - 1)); }
175
+ };
176
+ }
177
+
178
+ export function createResearchExecutor(d: DispatchExecutorDeps): ToolExecutor<SpawnResearchParams> {
179
+ return async (_id, params, signal, onUpdate, ctx) => {
180
+ const capability = d.provisionalCapabilityRefusal("fleet"); if (capability) return capability; const s = d.state; d.budget.ensureTaskTier();
181
+ const preflight = preflightGate(d, params.persona || ""); if (preflight) return refusal(d, "", params.task, preflight.reason, preflight.message, preflight.reason);
182
+ const taskRefusal = checkTaskBudget("research", d.budget.taskCounters(), d.budget.currentTaskBudget(), d.budget.taskActiveElapsedMs(), s.getTaskTier());
183
+ if (taskRefusal) { d.budget.armBudgetContinuation("task", taskRefusal.reason); return refusal(d, "", params.task, "task_budget_refused", budgetContinuationInstruction(taskRefusal.message, "task", s.getUserLanguage()), taskRefusal.reason); }
184
+ const turnRefusal = checkTurnBudget("research", { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, d.budget.currentBudget(), d.budget.turnBudgetActiveElapsedMs(), s.getTaskTier());
185
+ if (turnRefusal) { d.budget.armBudgetContinuation("turn", turnRefusal.reason); return refusal(d, "", params.task, "budget_refused", budgetContinuationInstruction(turnRefusal.message, "turn", s.getUserLanguage()), turnRefusal.reason); }
186
+ let def: any; let persona = false;
187
+ 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();
188
+ const model = d.research.resolveModel(def, persona ? undefined : params.model, ctx); let artifacts: InputArtifactPreview[];
189
+ 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" } }; }
190
+ s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; s.getSessionTotals().research++; d.budget.updateModeStatus();
191
+ const state = d.research.createState(def, persona, model); d.updateResearchWidget(); onUpdate?.({ content: [{ type: "text", text: `Spawning research helper r${state.id}...` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, status: "spawning" } });
192
+ 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}` }], details: { handle: `r${state.id}`, persona: persona ? def.name : null, model, status, elapsed: result.elapsed, exitCode: result.exitCode, fullOutput: result.output, termination: result.termination, artifacts: artifacts.map(a => ({ path: a.path, displayPath: a.displayPath, preview: a.preview, resolvedFromKind: a.resolvedFromKind ?? null })) } }; }
193
+ 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: "" } }; }
194
+ };
195
+ }
196
+
197
+ 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)); }
198
+ 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}`; }
199
+ 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"); }
200
+ 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
+ }