@chankov/agent-fleet 2.0.3 → 2.0.4

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 (452) hide show
  1. package/.pi/agents/model-profiles.yaml +64 -13
  2. package/.pi/agents/peers.yaml +11 -8
  3. package/.pi/harnesses/agent-hub/README.md +4 -2
  4. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  5. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  6. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  7. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  8. package/.pi/harnesses/agent-hub/dispatch-native.ts +4 -1
  9. package/.pi/harnesses/agent-hub/index.ts +61 -9
  10. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -7
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  13. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  14. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  15. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  16. package/.pi/harnesses/agent-hub/research/spawn-run.ts +2 -1
  17. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  18. package/.pi/harnesses/agent-hub/tools/action-executors.ts +2 -0
  19. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -0
  20. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +4 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  23. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  25. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  26. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  27. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  28. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  29. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  30. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  31. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  32. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  33. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  34. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  35. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  36. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  37. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  38. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  39. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  40. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  41. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  42. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  43. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  44. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  45. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  46. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  47. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  48. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  49. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  50. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  51. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  52. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  53. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  54. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  55. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  56. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  57. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  58. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  59. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  60. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  61. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  62. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  63. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  64. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  65. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  66. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  67. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  68. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  69. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  70. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  71. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  72. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  73. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  74. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  75. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  76. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  77. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  78. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  79. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  80. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  81. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  82. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  83. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  84. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  85. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  86. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  87. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  88. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  89. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  90. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  91. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  92. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  93. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  94. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  95. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  96. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  97. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  98. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  99. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  100. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  101. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  102. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  103. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  104. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  105. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  106. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  107. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  108. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  109. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  110. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  111. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  112. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  113. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  114. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  115. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  116. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  117. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  118. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  119. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  120. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  121. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  122. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  123. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  124. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  125. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  126. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  127. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  128. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  129. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  130. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  131. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  132. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  133. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  134. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  135. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  136. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  137. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  138. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  139. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  140. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  141. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  142. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  143. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  144. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  145. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  146. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  147. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  148. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  149. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  150. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  151. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  152. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  153. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  154. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  155. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  156. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  157. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  158. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  159. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  160. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  161. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  162. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  163. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  164. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  165. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  166. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  167. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  168. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  169. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  170. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  171. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  172. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  173. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  174. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  175. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  176. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  177. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  178. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  179. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  180. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  181. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  182. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  183. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  184. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  185. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  186. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  187. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  188. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  189. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  190. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  191. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  192. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  193. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  194. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  195. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  196. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  197. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  198. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  199. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  200. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  201. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  202. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  203. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  204. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  205. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  206. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  207. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  208. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  209. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  210. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  211. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  212. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  213. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  214. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  215. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  216. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  217. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  218. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  219. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  220. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  221. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  222. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  223. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  224. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  225. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  226. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  227. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  228. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  229. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  230. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  231. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  232. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  233. package/.versions/2.0.4/.version +1 -0
  234. package/.versions/2.0.4/agents/architect.md +25 -0
  235. package/.versions/2.0.4/agents/bowser.md +28 -0
  236. package/.versions/2.0.4/agents/builder.md +56 -0
  237. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  238. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  239. package/.versions/2.0.4/agents/documenter.md +22 -0
  240. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  241. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  242. package/.versions/2.0.4/agents/planner.md +105 -0
  243. package/.versions/2.0.4/agents/releaser.md +25 -0
  244. package/.versions/2.0.4/agents/researcher.md +31 -0
  245. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  246. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  247. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  248. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  249. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  250. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  251. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  252. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  253. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  254. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  255. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  256. package/.versions/2.0.4/docs/getting-started.md +124 -0
  257. package/.versions/2.0.4/docs/npm-install.md +299 -0
  258. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  259. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  260. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  261. package/.versions/2.0.4/hermes/README.md +347 -0
  262. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  263. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  264. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  265. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  266. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  267. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  268. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  269. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  270. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  271. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  272. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  273. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  274. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  275. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  276. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  277. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  278. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  279. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  280. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  281. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  282. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  283. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  284. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  285. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  286. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  287. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  288. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  289. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  290. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  291. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  292. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  293. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  294. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  295. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  296. package/.versions/2.0.4/install-manifest.json +2942 -0
  297. package/.versions/2.0.4/justfile +289 -0
  298. package/.versions/2.0.4/manifest-meta.json +969 -0
  299. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  300. package/.versions/2.0.4/references/communication-contract.md +26 -0
  301. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  302. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  303. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  304. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  305. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  306. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  307. package/.versions/2.0.4/references/security-checklist.md +179 -0
  308. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  309. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  310. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  311. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  312. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  313. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  314. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  315. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  316. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  317. package/.versions/2.0.4/scripts/flow.ts +137 -0
  318. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  319. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  320. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  321. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  322. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  323. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  324. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  325. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  326. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  327. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  328. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  329. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  330. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  331. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  332. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  333. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  334. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  335. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  336. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  337. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  338. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  339. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  340. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  341. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  342. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  343. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  344. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  345. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  346. package/.versions/2.0.4/scripts/package.json +9 -0
  347. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  348. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  349. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  350. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  351. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  352. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  353. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  354. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  355. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  356. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  357. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  358. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  359. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  360. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  361. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  362. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  363. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  364. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  365. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  366. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  367. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  368. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  369. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  370. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  371. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  372. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  373. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  374. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  375. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  376. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  377. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  378. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  379. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  380. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  381. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  382. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  383. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  384. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  385. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  386. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  387. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  388. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  389. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  390. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  391. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  392. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  393. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  394. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  395. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  396. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  397. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  398. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  399. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  400. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  401. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  402. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  403. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  404. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  405. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  406. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  407. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  408. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  409. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  410. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  411. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  412. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  413. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  414. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  415. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  416. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  417. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  418. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  419. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  420. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  421. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  422. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  423. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  424. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  425. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  426. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  427. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  428. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  429. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  430. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  431. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  432. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  433. package/CHANGELOG.md +7 -0
  434. package/bin/catalog/harness-runtime-closure.json +2 -0
  435. package/bin/cli.js +47 -9
  436. package/bin/lib/doctor.js +35 -2
  437. package/bin/lib/reconcile.js +3 -2
  438. package/docs/agent-fleet-setup.md +74 -0
  439. package/docs/claude-code-coms-bridge.md +5 -0
  440. package/docs/getting-started.md +5 -0
  441. package/docs/npm-install.md +12 -5
  442. package/install-manifest.json +3 -1
  443. package/justfile +1 -1
  444. package/package.json +5 -3
  445. package/scripts/claude-code-preflight.ts +70 -0
  446. package/scripts/fleet.ts +23 -0
  447. package/scripts/lib/runtime-dependencies.js +124 -0
  448. package/scripts/peer-launch.ts +27 -1
  449. package/scripts/workflows/lib/agent-phase.ts +2 -1
  450. package/scripts/workflows/lib/model-profile.ts +22 -0
  451. package/scripts/workflows/lib/personas.ts +6 -3
  452. package/scripts/workflows/lib/voices.ts +3 -0
@@ -0,0 +1,138 @@
1
+ // Per-provider in-flight semaphore.
2
+ //
3
+ // A dispatch may fan out to four delegate children at once, concurrent children
4
+ // are explicitly allowed, and several specialists can be mid-run — with nothing
5
+ // bounding how many requests land on ONE provider. That is survivable against a
6
+ // hosted endpoint and not against a local one: `custom/*` is a single machine,
7
+ // and the observed symptom was mid-run OOM on exactly the children that exist to
8
+ // protect the parent's context.
9
+ //
10
+ // Scope, stated plainly: this bounds the direct children spawned by ONE process.
11
+ // A nested delegate runs in its own pi process with its own semaphore, so the
12
+ // cap is per level of the tree, not global across the fleet. That is deliberate
13
+ // — a cross-process lock would have to survive crashed holders, and the level
14
+ // cap already removes the burst that caused the failures. Within one process the
15
+ // leaf holds the permit and a parent hands its own permit down (`parent`), so a
16
+ // nested spawn can never wait on its ancestor.
17
+
18
+ /** Only the local endpoint is capped by default; hosted providers scale on their side. */
19
+ export const DEFAULT_PROVIDER_LIMITS = Object.freeze({ custom: 2, omlx: 2 });
20
+
21
+ /** "custom/Qwen3.8-27B-Uncensored-MLX-4bit" → "custom"; the part before the first slash. */
22
+ export function providerKey(model) {
23
+ const spec = String(model ?? "").trim().toLowerCase();
24
+ const slash = spec.indexOf("/");
25
+ return slash < 0 ? spec : spec.slice(0, slash);
26
+ }
27
+
28
+ /** Concurrency cap for a model spec, or null when the provider is unlimited. */
29
+ export function providerLimit(model, limits = DEFAULT_PROVIDER_LIMITS) {
30
+ const limit = (limits || {})[providerKey(model)];
31
+ return Number.isFinite(limit) && limit > 0 ? limit : null;
32
+ }
33
+
34
+ /**
35
+ * Parse an override list: "custom=3,ollama=1". A value of 0 or "off" means
36
+ * unlimited (recorded as null so it overrides a default cap). Junk is dropped —
37
+ * a malformed env var must never make the hub refuse to start.
38
+ */
39
+ export function parseProviderLimits(raw) {
40
+ const out = {};
41
+ for (const part of String(raw ?? "").split(",")) {
42
+ const [rawKey, rawValue] = part.split("=");
43
+ if (rawValue === undefined) continue;
44
+ const key = String(rawKey).trim().toLowerCase();
45
+ const value = String(rawValue).trim().toLowerCase();
46
+ if (!key) continue;
47
+ if (value === "off" || value === "none" || value === "unlimited") { out[key] = null; continue; }
48
+ const n = Number(value);
49
+ if (!Number.isFinite(n)) continue;
50
+ out[key] = n > 0 ? Math.floor(n) : null;
51
+ }
52
+ return out;
53
+ }
54
+
55
+ /**
56
+ * FIFO semaphore keyed by provider prefix.
57
+ *
58
+ * - `acquire(model)` → Promise<release>. `release()` is idempotent.
59
+ * - `run(model, fn, { parent })` → runs `fn(permit)` under a permit and releases
60
+ * it however `fn` settles. Pass the permit you were given as `parent` when
61
+ * spawning on the same provider from inside `fn`: the call reuses it instead
62
+ * of taking a second one.
63
+ *
64
+ * Admission is synchronous when a permit is free, and a release hands off
65
+ * directly to the head of the queue, so ordering is exactly request order.
66
+ */
67
+ export function createProviderSemaphore(limits = DEFAULT_PROVIDER_LIMITS) {
68
+ /** @type {Map<string, { live: number, queue: Array<(release: () => void) => void> }>} */
69
+ const lanes = new Map();
70
+
71
+ const lane = (key) => {
72
+ let l = lanes.get(key);
73
+ if (!l) { l = { live: 0, queue: [] }; lanes.set(key, l); }
74
+ return l;
75
+ };
76
+
77
+ const makeRelease = (key) => {
78
+ let released = false;
79
+ const release = () => {
80
+ if (released) return;
81
+ released = true;
82
+ const l = lane(key);
83
+ const next = l.queue.shift();
84
+ // Hand the permit straight to the next waiter: `live` never dips, so a
85
+ // third caller arriving in between cannot jump the queue.
86
+ if (next) next(makeRelease(key));
87
+ else l.live--;
88
+ };
89
+ release.provider = key;
90
+ return release;
91
+ };
92
+
93
+ /** A free permit now, or null when the lane is full. */
94
+ const tryAcquire = (key, limit) => {
95
+ const l = lane(key);
96
+ if (limit != null && l.live >= limit) return null;
97
+ l.live++;
98
+ return makeRelease(key);
99
+ };
100
+
101
+ function acquire(model) {
102
+ const key = providerKey(model);
103
+ const limit = providerLimit(model, limits);
104
+ const permit = tryAcquire(key, limit);
105
+ if (permit) return Promise.resolve(permit);
106
+ return new Promise((resolve) => lane(key).queue.push(resolve));
107
+ }
108
+
109
+ function run(model, fn, { parent } = {}) {
110
+ const key = providerKey(model);
111
+ // Reentrancy: a parent holding this provider's permit lends it to its own
112
+ // nested spawn rather than queueing behind itself.
113
+ if (typeof parent === "function" && parent.provider === key) {
114
+ try { return Promise.resolve(fn(parent)); } catch (error) { return Promise.reject(error); }
115
+ }
116
+ const invoke = (permit) => {
117
+ let result;
118
+ try { result = fn(permit); } catch (error) { permit(); return Promise.reject(error); }
119
+ return Promise.resolve(result).then(
120
+ (value) => { permit(); return value; },
121
+ (error) => { permit(); throw error; },
122
+ );
123
+ };
124
+ const permit = tryAcquire(key, providerLimit(model, limits));
125
+ if (permit) return invoke(permit);
126
+ return new Promise((resolve, reject) => {
127
+ lane(key).queue.push((granted) => invoke(granted).then(resolve, reject));
128
+ });
129
+ }
130
+
131
+ return {
132
+ acquire,
133
+ run,
134
+ inFlight: (model) => lane(providerKey(model)).live,
135
+ queued: (model) => lane(providerKey(model)).queue.length,
136
+ limitFor: (model) => providerLimit(model, limits),
137
+ };
138
+ }
@@ -0,0 +1,74 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+ import type { ResearchAgentDef, ResearchRuntime, ResearchState } from "./runtime.ts";
3
+
4
+ export interface ResearchControlPorts<TDef extends ResearchAgentDef> {
5
+ runtime: ResearchRuntime<TDef>;
6
+ refresh(): void;
7
+ restartSpecialist(state: any, ctx: ExtensionContext): Promise<void>;
8
+ getAgents(): Map<string, any>;
9
+ displayName(name: string): string;
10
+ modelWorkBlocked(ctx: ExtensionContext): boolean;
11
+ cancelWait(state: any, kind: "wait_only_cancelled" | "restart"): Promise<void>;
12
+ cancelOwned(state: any): void;
13
+ }
14
+ export interface ResearchControls<TDef extends ResearchAgentDef> {
15
+ remove(state: ResearchState<TDef>, ctx: ExtensionContext): void;
16
+ clear(ctx: ExtensionContext): void;
17
+ restartSpecialist(state: any, ctx: ExtensionContext): Promise<void>;
18
+ handleKill(args: string | undefined, ctx: ExtensionContext): Promise<void>;
19
+ handleRestart(args: string | undefined, ctx: ExtensionContext): Promise<void>;
20
+ }
21
+
22
+ const researchId = (name: string | undefined) => { const match = name?.match(/^#?r?(\d+)$/i); return match ? parseInt(match[1], 10) : null; };
23
+ const specialistTargets = <TDef extends ResearchAgentDef>(ports: ResearchControlPorts<TDef>) =>
24
+ Array.from(ports.getAgents().values()).map(state => ports.displayName(state.def.name)).join(", ");
25
+ const liveTargets = <TDef extends ResearchAgentDef>(ports: ResearchControlPorts<TDef>) => [
26
+ ...Array.from(ports.getAgents().values()).map(state => ports.displayName(state.def.name)),
27
+ ...Array.from(ports.runtime.states().values()).map(state => `r${state.id}`),
28
+ ].join(", ");
29
+
30
+ export function createResearchControls<TDef extends ResearchAgentDef>(ports: ResearchControlPorts<TDef>): ResearchControls<TDef> {
31
+ const remove = (state: ResearchState<TDef>, ctx: ExtensionContext) => {
32
+ if (state.proc && state.status === "running") { state.killedByOperator = true; state.proc.kill("SIGTERM"); ctx.ui.notify(`Research r${state.id} killed and removed.`, "warning"); }
33
+ else ctx.ui.notify(`Research r${state.id} removed.`, "info");
34
+ ports.runtime.finalize(state, { status: "idle", historyStatus: "idle", lastWork: "(killed by operator)" });
35
+ ports.refresh();
36
+ };
37
+ const controls: ResearchControls<TDef> = {
38
+ remove,
39
+ clear(ctx) {
40
+ let killed = 0; const live = Array.from(ports.runtime.states().values()); const total = live.length;
41
+ for (const state of live) {
42
+ if (state.proc && state.status === "running") { state.killedByOperator = true; state.proc.kill("SIGTERM"); killed++; }
43
+ ports.runtime.finalize(state, { status: "idle", historyStatus: "idle", lastWork: "(killed by operator)" });
44
+ }
45
+ ports.refresh();
46
+ ctx.ui.notify(total === 0 ? "No research helpers to clear." : `Cleared ${total} research helper${total !== 1 ? "s" : ""}${killed > 0 ? ` (${killed} killed)` : ""}.`, total === 0 ? "info" : "success");
47
+ },
48
+ restartSpecialist: ports.restartSpecialist,
49
+ async handleKill(args, ctx) {
50
+ const name = args?.trim();
51
+ if (name?.toLowerCase() === "all") { controls.clear(ctx); return; }
52
+ const id = researchId(name);
53
+ if (id != null) { const research = ports.runtime.states().get(id); if (!research) ctx.ui.notify(`No research helper "${name}". Known: ${Array.from(ports.runtime.states().values()).map(item => `r${item.id}`).join(", ") || "none"}`, "error"); else controls.remove(research, ctx); return; }
54
+ const state = name ? ports.getAgents().get(name.toLowerCase()) : undefined;
55
+ if (!state) { ctx.ui.notify(`Usage: /af-agents-kill <name|rN|all>. Known: ${liveTargets(ports) || "none"}`, "error"); return; }
56
+ if (state.status !== "running" || (!state.proc && !state.comsAbort)) { ctx.ui.notify(`${ports.displayName(state.def.name)} is not running — nothing to kill.`, "warning"); return; }
57
+ if (!state.proc) { void ports.cancelWait(state, "wait_only_cancelled"); ctx.ui.notify(`Abandoning ${ports.displayName(state.def.name)}'s coms dispatch (the peer pane keeps running)...`, "info"); return; }
58
+ state.killedByOperator = true; ports.cancelOwned(state); ctx.ui.notify(`Killing ${ports.displayName(state.def.name)}...`, "info");
59
+ },
60
+ async handleRestart(args, ctx) {
61
+ if (ports.modelWorkBlocked(ctx)) return;
62
+ const name = args?.trim(); const id = researchId(name);
63
+ if (id != null) {
64
+ ctx.ui.notify(`Research helpers cannot be restarted — spawn a new helper instead.`, "warning");
65
+ return;
66
+ }
67
+ const state = name ? ports.getAgents().get(name.toLowerCase()) : undefined;
68
+ if (!state) { ctx.ui.notify(`Usage: /af-agents-restart <name>. Known: ${specialistTargets(ports) || "none"}`, "error"); return; }
69
+ if (!state.task) { ctx.ui.notify(`${ports.displayName(state.def.name)} has no previous task to restart.`, "warning"); return; }
70
+ ctx.ui.notify(`Restarting ${ports.displayName(state.def.name)} (fresh)...`, "info"); await ports.restartSpecialist(state, ctx);
71
+ },
72
+ };
73
+ return controls;
74
+ }
@@ -0,0 +1,175 @@
1
+ import type { ChildProcess } from "child_process";
2
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
+ import type { Termination, spawnPiAgentWithModelFallback } from "../spawn.ts";
4
+ import type { TimelineEntry } from "../ui/zoom.ts";
5
+ import type { FleetTranscriptStore } from "../../lib/fleet-transcript-store.ts";
6
+ import type { HistoryEntry, ExecutionHistoryStore } from "../ui/history-store.ts";
7
+ import type { HubStateContext } from "../context/hub-state.ts";
8
+ import type { BudgetContext } from "../context/budgets.ts";
9
+ import type { InputArtifactPreview, AssertionsArtifactsContext } from "../context/assertions-artifacts.ts";
10
+ import type { createProviderSemaphore } from "../provider-semaphore.js";
11
+ import { safePathWithin } from "../helpers.ts";
12
+ import { runResearchSpawn, type ResearchSpawnPorts } from "./spawn-run.ts";
13
+
14
+ export const RESEARCH_TOOLS = "read,grep,find,ls";
15
+ export const MAX_AUTO_RESEARCH_ROUNDS = 2;
16
+ export const MAX_AUTO_RESEARCH_QUESTIONS = 4;
17
+
18
+ export const ANON_RESEARCH_PROMPT = `# Research Helper
19
+
20
+ You are an ad-hoc read-only research helper assisting a team of specialist agents.
21
+ Locate the relevant code or docs, read the surrounding context, and report concise,
22
+ well-cited findings the rest of the team can act on.`;
23
+
24
+ export interface ResearchAgentDef {
25
+ name: string;
26
+ description: string;
27
+ tools: string;
28
+ model?: string;
29
+ fallbackModel?: string;
30
+ thinking?: string;
31
+ systemPrompt: string;
32
+ file: string;
33
+ }
34
+
35
+ export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef> {
36
+ id: number;
37
+ def: TDef;
38
+ persona: boolean;
39
+ model: string;
40
+ status: "idle" | "running" | "done" | "error";
41
+ task: string;
42
+ toolCount: number;
43
+ elapsed: number;
44
+ lastWork: string;
45
+ contextPct: number;
46
+ contextTokens: number;
47
+ timer?: ReturnType<typeof setInterval>;
48
+ proc?: ChildProcess;
49
+ killedByOperator?: boolean;
50
+ timeline: TimelineEntry[];
51
+ transcriptStore?: FleetTranscriptStore;
52
+ zoomRender?: (force?: boolean) => void;
53
+ histEntry?: HistoryEntry;
54
+ }
55
+
56
+ export interface ResearchResult {
57
+ output: string;
58
+ exitCode: number;
59
+ elapsed: number;
60
+ termination?: Termination;
61
+ }
62
+
63
+ export interface ResearchFinalizeOutcome {
64
+ status: "idle" | "done" | "error";
65
+ historyStatus: "idle" | "done" | "error";
66
+ lastWork: string;
67
+ }
68
+
69
+ export interface ResearchRuntimeStatePorts<TDef extends ResearchAgentDef> {
70
+ getResearchStates(): Map<number, ResearchState<TDef>>;
71
+ setResearchStates(value: Map<number, ResearchState<TDef>>): void;
72
+ getNextResearchId(): number;
73
+ setNextResearchId(value: number): void;
74
+ }
75
+
76
+ export interface ResearchRuntimeDeps<TDef extends ResearchAgentDef> extends ResearchRuntimeStatePorts<TDef> {
77
+ hubState: Pick<HubStateContext, "getSessionDir">;
78
+ budget: Pick<BudgetContext, "currentBudget">;
79
+ artifacts: Pick<AssertionsArtifactsContext, "appendInputArtifacts">;
80
+ executionHistory: ExecutionHistoryStore;
81
+ providerSemaphore: ReturnType<typeof createProviderSemaphore>;
82
+ getSafetyHarnessPath(): string | null;
83
+ getReconSearchTimeoutMs(): number | null;
84
+ getContextWindow(): number;
85
+ resolvedModel(def: TDef): string | undefined;
86
+ resolvedThinking(def: TDef): string | undefined;
87
+ resolveThinkingLevel(value: string | undefined): string;
88
+ fallbackModelFor(def: TDef, model: string): string | undefined;
89
+ substitutedModel(model: string | undefined): string | undefined;
90
+ modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) => unknown;
91
+ guardrailEnv(agentId: string): Record<string, string>;
92
+ notifyProviderQueue(model: string, label: string, ctx: ExtensionContext): void;
93
+ spawnPiAgentWithModelFallback: typeof spawnPiAgentWithModelFallback;
94
+ nativeResearchSystemPrompt(input: { personaName?: string; personaPath?: string; cwd: string }): string;
95
+ requireSafetyHarness(path: string | null): { ok: true; extensions: string[] } | { ok: false; error: string };
96
+ shortModel(model: string): string;
97
+ displayName(name: string): string;
98
+ flushTimelineStore(state: ResearchState<TDef>): void;
99
+ appendTimelineText(state: ResearchState<TDef>, kind: "text" | "thinking", content: string): void;
100
+ appendTimelineEvent(state: ResearchState<TDef>, event: TimelineEntry): void;
101
+ createTranscriptStore(path: string): FleetTranscriptStore;
102
+ }
103
+
104
+ export interface ResearchRuntime<TDef extends ResearchAgentDef = ResearchAgentDef> {
105
+ states(): Map<number, ResearchState<TDef>>;
106
+ reset(): void;
107
+ sessionPath(id: number): string;
108
+ anonymousDef(): TDef;
109
+ resolveModel(def: TDef, explicit: string | undefined, ctx: ExtensionContext): string;
110
+ createState(def: TDef, persona: boolean, model: string): ResearchState<TDef>;
111
+ finalize(state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome): void;
112
+ spawn(state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext, inputArtifacts?: InputArtifactPreview[], signal?: AbortSignal): Promise<ResearchResult>;
113
+ }
114
+
115
+ export function parseResearchHandle(arg: string): number | null {
116
+ const match = arg.trim().match(/^#?r?(\d+)$/i);
117
+ return match ? parseInt(match[1], 10) : null;
118
+ }
119
+
120
+ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: ResearchRuntimeDeps<TDef>): ResearchRuntime<TDef> {
121
+ const sessionPath = (id: number) => safePathWithin(deps.hubState.getSessionDir(), `research-${id}.json`);
122
+ const finalized = new WeakSet<ResearchState<TDef>>();
123
+ const finalize = (state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome) => {
124
+ if (finalized.has(state)) return;
125
+ finalized.add(state);
126
+ if (state.timer) {
127
+ clearInterval(state.timer);
128
+ state.timer = undefined;
129
+ }
130
+ state.proc = undefined;
131
+ state.status = outcome.status;
132
+ state.lastWork = outcome.lastWork;
133
+ state.zoomRender?.(true);
134
+ if (state.histEntry) {
135
+ deps.executionHistory.end(state.histEntry, outcome.historyStatus);
136
+ state.histEntry = undefined;
137
+ }
138
+ const states = deps.getResearchStates();
139
+ if (states.get(state.id) === state) states.delete(state.id);
140
+ };
141
+ const spawnPorts: ResearchSpawnPorts<TDef> = { ...deps, researchTools: RESEARCH_TOOLS, sessionPath, finalize };
142
+
143
+ return {
144
+ states: deps.getResearchStates,
145
+ reset() {
146
+ deps.setResearchStates(new Map());
147
+ deps.setNextResearchId(1);
148
+ },
149
+ sessionPath,
150
+ anonymousDef() {
151
+ return {
152
+ name: "research", description: "Ad-hoc read-only research helper.", tools: RESEARCH_TOOLS,
153
+ systemPrompt: ANON_RESEARCH_PROMPT, file: "",
154
+ } as TDef;
155
+ },
156
+ resolveModel(def, explicit, ctx) {
157
+ if (explicit) return explicit;
158
+ return deps.resolvedModel(def) || (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
159
+ },
160
+ createState(def, persona, model) {
161
+ const id = deps.getNextResearchId();
162
+ deps.setNextResearchId(id + 1);
163
+ const state: ResearchState<TDef> = {
164
+ id, def, persona, model, status: "running", task: "", toolCount: 0,
165
+ elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0, timeline: [],
166
+ };
167
+ deps.getResearchStates().set(id, state);
168
+ return state;
169
+ },
170
+ finalize,
171
+ spawn(state, prompt, ctx, inputArtifacts = [], signal) {
172
+ return runResearchSpawn(spawnPorts, state, prompt, ctx, inputArtifacts, signal);
173
+ },
174
+ };
175
+ }
@@ -0,0 +1,144 @@
1
+ import { profileFallback } from '../policy/profile-runtime.ts';
2
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
+ import { contextPct, resolveContextWindow } from "../context-window.js";
4
+ import { isReadOnlyToolList, safePathWithin } from "../helpers.ts";
5
+ import { researchTerminationOutcome, researchWatchdogSpawnOptions } from "../research-watchdog.ts";
6
+ import type { InputArtifactPreview } from "../context/assertions-artifacts.ts";
7
+ import type { ResearchAgentDef, ResearchFinalizeOutcome, ResearchResult, ResearchRuntimeDeps, ResearchState } from "./runtime.ts";
8
+
9
+ export interface ResearchSpawnPorts<TDef extends ResearchAgentDef> extends ResearchRuntimeDeps<TDef> {
10
+ researchTools: string;
11
+ sessionPath(id: number): string;
12
+ finalize(state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome): void;
13
+ }
14
+
15
+ function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef>, res: any): string {
16
+ let output = String(res.output ?? "");
17
+ if (res.modelFallback) {
18
+ output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
19
+ }
20
+ if (res.exitCode !== 0) {
21
+ const errText = String(res.stderr ?? "").trim();
22
+ const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
23
+ const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
24
+ output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
25
+ }
26
+ return output;
27
+ }
28
+
29
+ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
30
+ deps: ResearchSpawnPorts<TDef>, state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext,
31
+ inputArtifacts: InputArtifactPreview[] = [], signal?: AbortSignal,
32
+ ): Promise<ResearchResult> {
33
+ const startTime = Date.now();
34
+ let result: ResearchResult | undefined;
35
+ const settle = (status: ResearchFinalizeOutcome["status"], historyStatus: ResearchFinalizeOutcome["historyStatus"], lastWork: string, settled: ResearchResult): ResearchResult => {
36
+ state.elapsed = settled.elapsed;
37
+ deps.finalize(state, { status, historyStatus, lastWork });
38
+ result = settled;
39
+ return settled;
40
+ };
41
+
42
+ try {
43
+ if (!state.histEntry) state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
44
+
45
+ const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
46
+ if (!safety.ok) return settle("error", "error", safety.error, { output: safety.error, exitCode: 1, elapsed: 0 });
47
+
48
+ state.status = "running";
49
+ state.task = prompt;
50
+ state.toolCount = 0;
51
+ state.elapsed = 0;
52
+ state.lastWork = "";
53
+ state.killedByOperator = false;
54
+ deps.flushTimelineStore(state);
55
+ state.timeline = [];
56
+ state.transcriptStore = deps.createTranscriptStore(safePathWithin(deps.hubState.getSessionDir(), "transcripts", `research-r${state.id}.jsonl`));
57
+
58
+ state.timer = setInterval(() => {
59
+ state.elapsed = Date.now() - startTime;
60
+ }, 1000);
61
+ const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
62
+ const wantThinking = thinkingLevel !== "off";
63
+ const sessionPath = deps.sessionPath(state.id);
64
+ const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
65
+ const fallbackCandidate = profileFallback(deps.substitutedModel(deps.fallbackModelFor(state.def, state.model)));
66
+ const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
67
+ let fullText = "";
68
+ deps.notifyProviderQueue(state.model, `Research r${state.id}`, ctx);
69
+
70
+ const res = await deps.providerSemaphore.run(state.model, () => deps.spawnPiAgentWithModelFallback({
71
+ model: state.model, tools: deps.researchTools, thinking: thinkingLevel,
72
+ systemPrompt: deps.nativeResearchSystemPrompt({
73
+ ...(state.persona ? { personaName: state.def.name, personaPath: state.def.file } : {}),
74
+ cwd: ctx.cwd || process.cwd(),
75
+ }),
76
+ noSkills: true, noContextFiles: true, sessionFile: sessionPath, resume: false,
77
+ prompt: deps.artifacts.appendInputArtifacts(prompt, inputArtifacts), cwd: ctx.cwd || process.cwd(),
78
+ extensions: safety.extensions, env: deps.guardrailEnv(`research-r${state.id}`),
79
+ ...researchWatchdogSpawnOptions(deps.getReconSearchTimeoutMs(), signal),
80
+ turnDeadlineMs: deps.budget.currentBudget().agentTurnMs,
81
+ }, fallback, {
82
+ onProcess: process => { state.proc = process; },
83
+ onModelFallback: ({ from, to, reason }) => {
84
+ state.lastWork = `model fallback: ${deps.shortModel(from)} → ${deps.shortModel(to)}`;
85
+ ctx.ui.notify(`Research r${state.id}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
86
+ },
87
+ onTextDelta: delta => {
88
+ fullText += delta;
89
+ state.lastWork = fullText.split("\n").filter(line => line.trim()).pop() || "";
90
+ deps.appendTimelineText(state, "text", delta);
91
+ state.zoomRender?.();
92
+ },
93
+ onThinkingDelta: delta => {
94
+ if (!wantThinking) return;
95
+ deps.appendTimelineText(state, "thinking", delta);
96
+ state.zoomRender?.();
97
+ },
98
+ onToolStart: (toolName, argStr, callId) => {
99
+ state.toolCount++;
100
+ deps.appendTimelineEvent(state, { kind: "tool-start", title: `Tool: ${toolName}`, content: argStr, timestamp: Date.now(), ...(callId ? { callId } : {}) });
101
+ state.zoomRender?.();
102
+ },
103
+ onToolEnd: (toolName, callId, isError, resultText, durationMs) => {
104
+ deps.appendTimelineEvent(state, { kind: "tool-result", title: `Result: ${toolName}`, content: resultText ?? "", timestamp: Date.now(), ...(callId ? { callId } : {}), status: isError ? "error" : "success", ...(durationMs == null ? {} : { durationMs }) });
105
+ state.zoomRender?.();
106
+ },
107
+ onUsage: usage => {
108
+ state.contextTokens = (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
109
+ if (researchWindow.window > 0) {
110
+ state.contextPct = contextPct(usage, researchWindow.window);
111
+ }
112
+ },
113
+ }, { midRun: isReadOnlyToolList(deps.researchTools) }));
114
+
115
+ state.elapsed = Date.now() - startTime;
116
+ state.proc = undefined;
117
+ if (res.spawnError) {
118
+ return settle("error", "error", `Error: ${res.spawnError}`, { output: `Error spawning research helper: ${res.spawnError}`, exitCode: 1, elapsed: state.elapsed });
119
+ }
120
+ if (res.termination) {
121
+ const outcome = researchTerminationOutcome(state.id, res.termination);
122
+ return settle("error", "error", outcome.lastWork, { output: outcome.output, exitCode: outcome.exitCode, elapsed: state.elapsed, termination: res.termination });
123
+ }
124
+ if (state.killedByOperator) {
125
+ state.killedByOperator = false;
126
+ return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode ?? 143, elapsed: state.elapsed });
127
+ }
128
+
129
+ const status = res.exitCode === 0 ? "done" : "error";
130
+ const lastWork = String(res.output ?? "").split("\n").filter((line: string) => line.trim()).pop() || "";
131
+ const settled = settle(status, status, lastWork, { output: completeOutput(state, res), exitCode: res.exitCode ?? 1, elapsed: state.elapsed });
132
+ ctx.ui.notify(`Research r${state.id} ${status} in ${Math.round(state.elapsed / 1000)}s`, status === "done" ? "success" : "error");
133
+ return settled;
134
+ } catch (err: unknown) {
135
+ const message = err instanceof Error ? err.message : String(err);
136
+ state.elapsed = Date.now() - startTime;
137
+ return settle("error", "error", `Error: ${message}`, { output: `Error spawning research helper: ${message}`, exitCode: 1, elapsed: state.elapsed });
138
+ } finally {
139
+ if (!result) {
140
+ state.elapsed = Date.now() - startTime;
141
+ deps.finalize(state, { status: "error", historyStatus: "error", lastWork: "terminated unexpectedly" });
142
+ }
143
+ }
144
+ }
@@ -0,0 +1,40 @@
1
+ import type { Termination } from "./spawn.ts";
2
+
3
+ /** Spawn policy shared by every native read-only research-helper path. */
4
+ export function researchWatchdogSpawnOptions(timeoutMs: number | null, signal?: AbortSignal) {
5
+ return {
6
+ detached: true,
7
+ signal,
8
+ toolWatchdog: { timeoutMs },
9
+ };
10
+ }
11
+
12
+ /** Stable terminal result used by research lifecycle code after parent cleanup. */
13
+ export function researchTerminationOutcome(id: number, termination: Termination) {
14
+ const reason = termination.reason;
15
+ const tool = termination.tool;
16
+ const status = reason; // "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled"
17
+ const lastWork = reason === "tool_timeout"
18
+ ? `tool_timeout: ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
19
+ : reason === "turn_timeout"
20
+ ? "turn_timeout: per-run deadline exceeded"
21
+ : reason === "drift_stop"
22
+ ? "drift_stop: stopped by the drift watchdog"
23
+ : "cancelled by caller";
24
+ const metadata = reason === "tool_timeout"
25
+ ? `toolCallId=${tool?.toolCallId || "unknown"}, tool=${tool?.toolName || "unknown"}, deadline=${tool?.deadlineAt || "unknown"}, terminationConfirmed=${termination.confirmed}`
26
+ : `terminationConfirmed=${termination.confirmed}`;
27
+ const explanation = reason === "tool_timeout"
28
+ ? "exceeded its per-tool watchdog"
29
+ : reason === "turn_timeout"
30
+ ? "exceeded the per-run deadline (agent-turn-timeout-s / mode budget) — narrow the question or raise the deadline"
31
+ : reason === "drift_stop"
32
+ ? "was stopped by the drift watchdog"
33
+ : "was cancelled by its caller";
34
+ return {
35
+ status,
36
+ lastWork,
37
+ output: `${status}: research helper r${id} ${explanation} (${metadata}).`,
38
+ exitCode: reason === "cancelled" ? 130 : reason === "drift_stop" ? 125 : 124,
39
+ };
40
+ }