@chankov/agent-fleet 2.0.1 → 2.0.2

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 (695) hide show
  1. package/.pi/agents/voices.yaml +13 -0
  2. package/.pi/harnesses/agent-hub/README.md +3 -1
  3. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  4. package/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  5. package/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  6. package/.pi/harnesses/agent-hub/config/agents.ts +14 -5
  7. package/.pi/harnesses/agent-hub/config/overrides.ts +44 -4
  8. package/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  9. package/.pi/harnesses/agent-hub/delegate.ts +2 -2
  10. package/.pi/harnesses/agent-hub/index.ts +197 -0
  11. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +5 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  14. package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -0
  15. package/.pi/harnesses/agent-hub/types.ts +1 -0
  16. package/.pi/harnesses/ask-user-remote/README.md +1 -1
  17. package/.pi/harnesses/coms/README.md +1 -1
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  20. package/.versions/2.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  21. package/.versions/2.0.2/.pi/agents/model-profiles.yaml +27 -0
  22. package/.versions/2.0.2/.pi/agents/peers.yaml +142 -0
  23. package/.versions/2.0.2/.pi/agents/teams.yaml +41 -0
  24. package/.versions/2.0.2/.pi/agents/voices.yaml +13 -0
  25. package/.versions/2.0.2/.pi/damage-control-rules.yaml +297 -0
  26. package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  27. package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  28. package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  29. package/.versions/2.0.2/.pi/extensions/btw/README.md +120 -0
  30. package/.versions/2.0.2/.pi/extensions/btw/index.ts +914 -0
  31. package/.versions/2.0.2/.pi/extensions/btw/package.json +6 -0
  32. package/.versions/2.0.2/.pi/extensions/btw/state.js +179 -0
  33. package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  34. package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  35. package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  36. package/.versions/2.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  37. package/.versions/2.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  38. package/.versions/2.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  39. package/.versions/2.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  40. package/.versions/2.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  41. package/.versions/2.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  42. package/.versions/2.0.2/.pi/extensions/package-lock.json +1175 -0
  43. package/.versions/2.0.2/.pi/extensions/package.json +9 -0
  44. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  45. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  46. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  47. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  48. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  49. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  50. package/.versions/2.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  51. package/.versions/2.0.2/.pi/harnesses/agent-hub/README.md +1163 -0
  52. package/.versions/2.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  53. package/.versions/2.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  54. package/.versions/2.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  55. package/.versions/2.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  56. package/.versions/2.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  57. package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  58. package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  59. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  60. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  61. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  62. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  63. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  64. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  65. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  66. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  67. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  68. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  69. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  70. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  71. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  72. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  73. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  74. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  75. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  76. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  77. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  78. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  79. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  80. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  81. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  82. package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  83. package/.versions/2.0.2/.pi/harnesses/agent-hub/config/agents.ts +180 -0
  84. package/.versions/2.0.2/.pi/harnesses/agent-hub/config/overrides.ts +158 -0
  85. package/.versions/2.0.2/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  86. package/.versions/2.0.2/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  87. package/.versions/2.0.2/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  88. package/.versions/2.0.2/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  89. package/.versions/2.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  90. package/.versions/2.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  91. package/.versions/2.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  92. package/.versions/2.0.2/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  93. package/.versions/2.0.2/.pi/harnesses/agent-hub/delegate.ts +446 -0
  94. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  95. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  96. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  97. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  98. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  99. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  100. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  101. package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  102. package/.versions/2.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  103. package/.versions/2.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  104. package/.versions/2.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  105. package/.versions/2.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  106. package/.versions/2.0.2/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  107. package/.versions/2.0.2/.pi/harnesses/agent-hub/footer.ts +30 -0
  108. package/.versions/2.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  109. package/.versions/2.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  110. package/.versions/2.0.2/.pi/harnesses/agent-hub/index.ts +2047 -0
  111. package/.versions/2.0.2/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  112. package/.versions/2.0.2/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  113. package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  114. package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  115. package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  116. package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  117. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  118. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  119. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  120. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  121. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  122. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  123. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  124. package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  125. package/.versions/2.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  126. package/.versions/2.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  127. package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  128. package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  129. package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  130. package/.versions/2.0.2/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  131. package/.versions/2.0.2/.pi/harnesses/agent-hub/presentation.ts +48 -0
  132. package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  133. package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  134. package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  135. package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  136. package/.versions/2.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  137. package/.versions/2.0.2/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  138. package/.versions/2.0.2/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  139. package/.versions/2.0.2/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  140. package/.versions/2.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  141. package/.versions/2.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  142. package/.versions/2.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  143. package/.versions/2.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  144. package/.versions/2.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  145. package/.versions/2.0.2/.pi/harnesses/agent-hub/run-budget.js +537 -0
  146. package/.versions/2.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  147. package/.versions/2.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  148. package/.versions/2.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  149. package/.versions/2.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  150. package/.versions/2.0.2/.pi/harnesses/agent-hub/session-start.ts +42 -0
  151. package/.versions/2.0.2/.pi/harnesses/agent-hub/spawn.ts +388 -0
  152. package/.versions/2.0.2/.pi/harnesses/agent-hub/timeline.ts +54 -0
  153. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  154. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  155. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  156. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  157. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  158. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  159. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  160. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  161. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  162. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  163. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  164. package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  165. package/.versions/2.0.2/.pi/harnesses/agent-hub/types.ts +61 -0
  166. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  167. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  168. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  169. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  170. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  171. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  172. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  173. package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  174. package/.versions/2.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  175. package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  176. package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  177. package/.versions/2.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  178. package/.versions/2.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  179. package/.versions/2.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  180. package/.versions/2.0.2/.pi/harnesses/coms/README.md +100 -0
  181. package/.versions/2.0.2/.pi/harnesses/coms/index.ts +276 -0
  182. package/.versions/2.0.2/.pi/harnesses/coms/package.json +7 -0
  183. package/.versions/2.0.2/.pi/harnesses/coms/version.ts +42 -0
  184. package/.versions/2.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  185. package/.versions/2.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  186. package/.versions/2.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  187. package/.versions/2.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  188. package/.versions/2.0.2/.pi/harnesses/lib/coms-core-io.ts +385 -0
  189. package/.versions/2.0.2/.pi/harnesses/lib/coms-core.ts +577 -0
  190. package/.versions/2.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  191. package/.versions/2.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  192. package/.versions/2.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  193. package/.versions/2.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  194. package/.versions/2.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  195. package/.versions/2.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  196. package/.versions/2.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  197. package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  198. package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  199. package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  200. package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  201. package/.versions/2.0.2/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  202. package/.versions/2.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  203. package/.versions/2.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  204. package/.versions/2.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  205. package/.versions/2.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  206. package/.versions/2.0.2/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  207. package/.versions/2.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  208. package/.versions/2.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  209. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  210. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  211. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  212. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  213. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  214. package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  215. package/.versions/2.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  216. package/.versions/2.0.2/.pi/harnesses/package-lock.json +2039 -0
  217. package/.versions/2.0.2/.pi/harnesses/package.json +10 -0
  218. package/.versions/2.0.2/.pi/prompts/af-build.md +24 -0
  219. package/.versions/2.0.2/.pi/prompts/af-code-simplify.md +22 -0
  220. package/.versions/2.0.2/.pi/prompts/af-plan.md +17 -0
  221. package/.versions/2.0.2/.pi/prompts/af-review.md +16 -0
  222. package/.versions/2.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  223. package/.versions/2.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  224. package/.versions/2.0.2/.pi/prompts/af-ship.md +17 -0
  225. package/.versions/2.0.2/.pi/prompts/af-spec.md +15 -0
  226. package/.versions/2.0.2/.pi/prompts/af-test.md +19 -0
  227. package/.versions/2.0.2/.pi/skills/bowser/SKILL.md +145 -0
  228. package/.versions/2.0.2/.version +1 -0
  229. package/.versions/2.0.2/agents/architect.md +25 -0
  230. package/.versions/2.0.2/agents/bowser.md +28 -0
  231. package/.versions/2.0.2/agents/builder.md +56 -0
  232. package/.versions/2.0.2/agents/code-reviewer.md +210 -0
  233. package/.versions/2.0.2/agents/deep-researcher.md +33 -0
  234. package/.versions/2.0.2/agents/documenter.md +22 -0
  235. package/.versions/2.0.2/agents/orchestrator.md +23 -0
  236. package/.versions/2.0.2/agents/plan-reviewer.md +84 -0
  237. package/.versions/2.0.2/agents/planner.md +105 -0
  238. package/.versions/2.0.2/agents/releaser.md +25 -0
  239. package/.versions/2.0.2/agents/researcher.md +31 -0
  240. package/.versions/2.0.2/agents/security-auditor.md +168 -0
  241. package/.versions/2.0.2/agents/test-engineer.md +154 -0
  242. package/.versions/2.0.2/agents/web-debugger.md +44 -0
  243. package/.versions/2.0.2/agents/web-performance-auditor.md +194 -0
  244. package/.versions/2.0.2/bin/catalog/harness-runtime-closure.json +34 -0
  245. package/.versions/2.0.2/codex/CONDUCTOR.md +148 -0
  246. package/.versions/2.0.2/docs/ARCHITECTURE.md +407 -0
  247. package/.versions/2.0.2/docs/agent-fleet-setup.md +473 -0
  248. package/.versions/2.0.2/docs/claude-code-coms-bridge.md +128 -0
  249. package/.versions/2.0.2/docs/codex-remote-conductor.md +170 -0
  250. package/.versions/2.0.2/docs/coms-hermes-bridge.md +189 -0
  251. package/.versions/2.0.2/docs/getting-started.md +119 -0
  252. package/.versions/2.0.2/docs/npm-install.md +292 -0
  253. package/.versions/2.0.2/docs/pi-extensions.md +444 -0
  254. package/.versions/2.0.2/docs/pi-setup.md +74 -0
  255. package/.versions/2.0.2/docs/skill-anatomy.md +150 -0
  256. package/.versions/2.0.2/hermes/README.md +347 -0
  257. package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  258. package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  259. package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  260. package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  261. package/.versions/2.0.2/hermes/gates/gate-o-capability.md +8 -0
  262. package/.versions/2.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  263. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  264. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  265. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  266. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  267. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  268. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  269. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  270. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  271. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  272. package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  273. package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  274. package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  275. package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  276. package/.versions/2.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  277. package/.versions/2.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  278. package/.versions/2.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  279. package/.versions/2.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  280. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  281. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  282. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  283. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  284. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  285. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  286. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  287. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  288. package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  289. package/.versions/2.0.2/hermes/watchdog-tests/__init__.py +0 -0
  290. package/.versions/2.0.2/hooks/coms-stop-hook.mjs +84 -0
  291. package/.versions/2.0.2/install-manifest.json +2905 -0
  292. package/.versions/2.0.2/justfile +288 -0
  293. package/.versions/2.0.2/manifest-meta.json +945 -0
  294. package/.versions/2.0.2/references/accessibility-checklist.md +160 -0
  295. package/.versions/2.0.2/references/communication-contract.md +26 -0
  296. package/.versions/2.0.2/references/definition-of-done.md +67 -0
  297. package/.versions/2.0.2/references/fleet-coordination-patterns.md +171 -0
  298. package/.versions/2.0.2/references/observability-checklist.md +91 -0
  299. package/.versions/2.0.2/references/orchestration-patterns.md +370 -0
  300. package/.versions/2.0.2/references/performance-checklist.md +153 -0
  301. package/.versions/2.0.2/references/prompting-patterns.md +380 -0
  302. package/.versions/2.0.2/references/security-checklist.md +179 -0
  303. package/.versions/2.0.2/references/testing-patterns.md +236 -0
  304. package/.versions/2.0.2/references/workflow-authoring.md +304 -0
  305. package/.versions/2.0.2/scripts/codex-conductor.ts +41 -0
  306. package/.versions/2.0.2/scripts/codex-remote-control.ts +167 -0
  307. package/.versions/2.0.2/scripts/coms-claude-bridge.ts +411 -0
  308. package/.versions/2.0.2/scripts/coms-cli.ts +484 -0
  309. package/.versions/2.0.2/scripts/coms-hermes-bridge.ts +413 -0
  310. package/.versions/2.0.2/scripts/fleet.ts +199 -0
  311. package/.versions/2.0.2/scripts/flow.ts +137 -0
  312. package/.versions/2.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  313. package/.versions/2.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  314. package/.versions/2.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  315. package/.versions/2.0.2/scripts/install-hermes-plugin.sh +180 -0
  316. package/.versions/2.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  317. package/.versions/2.0.2/scripts/lib/codex-conductor.ts +88 -0
  318. package/.versions/2.0.2/scripts/lib/codex-remote-control.ts +482 -0
  319. package/.versions/2.0.2/scripts/lib/coms-envelope.ts +582 -0
  320. package/.versions/2.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  321. package/.versions/2.0.2/scripts/lib/fleet-command.ts +270 -0
  322. package/.versions/2.0.2/scripts/lib/flow-command.ts +93 -0
  323. package/.versions/2.0.2/scripts/lib/flow-maintenance.ts +230 -0
  324. package/.versions/2.0.2/scripts/lib/herdr-layout.ts +281 -0
  325. package/.versions/2.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  326. package/.versions/2.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  327. package/.versions/2.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  328. package/.versions/2.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  329. package/.versions/2.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  330. package/.versions/2.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  331. package/.versions/2.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  332. package/.versions/2.0.2/scripts/lib/monitor-env.ts +146 -0
  333. package/.versions/2.0.2/scripts/lib/peer-launch.ts +318 -0
  334. package/.versions/2.0.2/scripts/lib/persona-banner.ts +62 -0
  335. package/.versions/2.0.2/scripts/lib/spawn-stagger.ts +101 -0
  336. package/.versions/2.0.2/scripts/lib/team-project.ts +213 -0
  337. package/.versions/2.0.2/scripts/lib/team-snapshot.ts +147 -0
  338. package/.versions/2.0.2/scripts/peer-banner.ts +40 -0
  339. package/.versions/2.0.2/scripts/peer-launch.ts +259 -0
  340. package/.versions/2.0.2/scripts/team-snapshot.ts +237 -0
  341. package/.versions/2.0.2/scripts/team-up.ts +406 -0
  342. package/.versions/2.0.2/scripts/workflows/lib/agent-phase.ts +132 -0
  343. package/.versions/2.0.2/scripts/workflows/lib/changes.ts +61 -0
  344. package/.versions/2.0.2/scripts/workflows/lib/debate.ts +149 -0
  345. package/.versions/2.0.2/scripts/workflows/lib/env.ts +34 -0
  346. package/.versions/2.0.2/scripts/workflows/lib/envelopes.ts +169 -0
  347. package/.versions/2.0.2/scripts/workflows/lib/gates.ts +81 -0
  348. package/.versions/2.0.2/scripts/workflows/lib/git.ts +96 -0
  349. package/.versions/2.0.2/scripts/workflows/lib/merge.ts +95 -0
  350. package/.versions/2.0.2/scripts/workflows/lib/model-visibility.ts +92 -0
  351. package/.versions/2.0.2/scripts/workflows/lib/permissions.ts +130 -0
  352. package/.versions/2.0.2/scripts/workflows/lib/personas.ts +54 -0
  353. package/.versions/2.0.2/scripts/workflows/lib/poll.ts +86 -0
  354. package/.versions/2.0.2/scripts/workflows/lib/quality.ts +64 -0
  355. package/.versions/2.0.2/scripts/workflows/lib/run.ts +108 -0
  356. package/.versions/2.0.2/scripts/workflows/lib/trace.ts +34 -0
  357. package/.versions/2.0.2/scripts/workflows/lib/voices.ts +125 -0
  358. package/.versions/2.0.2/scripts/workflows/lib/writer-lease.ts +112 -0
  359. package/.versions/2.0.2/scripts/workflows/tsconfig.json +22 -0
  360. package/.versions/2.0.2/scripts/workflows/wf-build-test.ts +61 -0
  361. package/.versions/2.0.2/scripts/workflows/wf-debate.ts +87 -0
  362. package/.versions/2.0.2/scripts/workflows/wf-document.ts +50 -0
  363. package/.versions/2.0.2/scripts/workflows/wf-poll.ts +95 -0
  364. package/.versions/2.0.2/scripts/workflows/wf-quality.ts +20 -0
  365. package/.versions/2.0.2/scripts/workflows/wf-scout.ts +38 -0
  366. package/.versions/2.0.2/skills/_internal/grilling.md +59 -0
  367. package/.versions/2.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  368. package/.versions/2.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  369. package/.versions/2.0.2/skills/compound-learning/SKILL.md +137 -0
  370. package/.versions/2.0.2/skills/context-engineering/SKILL.md +291 -0
  371. package/.versions/2.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  372. package/.versions/2.0.2/skills/designing-agents/SKILL.md +394 -0
  373. package/.versions/2.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  374. package/.versions/2.0.2/skills/drafting-workflows/SKILL.md +143 -0
  375. package/.versions/2.0.2/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  376. package/.versions/2.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  377. package/.versions/2.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  378. package/.versions/2.0.2/skills/idea-refine/SKILL.md +182 -0
  379. package/.versions/2.0.2/skills/idea-refine/examples.md +238 -0
  380. package/.versions/2.0.2/skills/idea-refine/frameworks.md +99 -0
  381. package/.versions/2.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  382. package/.versions/2.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  383. package/.versions/2.0.2/skills/incremental-implementation/SKILL.md +298 -0
  384. package/.versions/2.0.2/skills/interview-me/SKILL.md +226 -0
  385. package/.versions/2.0.2/skills/orchestration-verification/SKILL.md +181 -0
  386. package/.versions/2.0.2/skills/peer-coms/SKILL.md +90 -0
  387. package/.versions/2.0.2/skills/performance-optimization/SKILL.md +350 -0
  388. package/.versions/2.0.2/skills/planning-and-task-breakdown/SKILL.md +265 -0
  389. package/.versions/2.0.2/skills/security-and-hardening/SKILL.md +461 -0
  390. package/.versions/2.0.2/skills/spec-driven-development/SKILL.md +256 -0
  391. package/.versions/2.0.2/skills/using-agent-skills/SKILL.md +197 -0
  392. package/.versions/2.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  393. package/.versions/2.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  394. package/.versions/2.0.2/vendor/agent-skills-upstream/README.md +11 -0
  395. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  396. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  397. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  398. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  399. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  400. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  401. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  402. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  403. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  404. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  405. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  406. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  407. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  408. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  409. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  410. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  411. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  412. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  413. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  414. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  415. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  416. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  417. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  418. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  419. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  420. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  421. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  422. package/.versions/2.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  423. package/CHANGELOG.md +7 -0
  424. package/agents/planner.md +40 -8
  425. package/bin/catalog/harness-runtime-closure.json +0 -4
  426. package/bin/lib/apply.js +65 -2
  427. package/bin/lib/doctor.js +143 -1
  428. package/bin/lib/plan.js +2 -0
  429. package/bin/lib/transaction.js +14 -1
  430. package/bin/lib/validate-overrides.js +20 -0
  431. package/bin/lib/verify.js +22 -1
  432. package/codex/CONDUCTOR.md +1 -1
  433. package/docs/agent-fleet-setup.md +8 -3
  434. package/docs/codex-remote-conductor.md +3 -3
  435. package/docs/pi-extensions.md +5 -0
  436. package/docs/workflows.md +7 -0
  437. package/install-manifest.json +84 -9
  438. package/justfile +2 -0
  439. package/manifest-meta.json +37 -5
  440. package/node_modules/yaml/LICENSE +13 -0
  441. package/node_modules/yaml/README.md +172 -0
  442. package/node_modules/yaml/bin.mjs +11 -0
  443. package/node_modules/yaml/browser/dist/compose/compose-collection.js +88 -0
  444. package/node_modules/yaml/browser/dist/compose/compose-doc.js +43 -0
  445. package/node_modules/yaml/browser/dist/compose/compose-node.js +109 -0
  446. package/node_modules/yaml/browser/dist/compose/compose-scalar.js +86 -0
  447. package/node_modules/yaml/browser/dist/compose/composer.js +219 -0
  448. package/node_modules/yaml/browser/dist/compose/resolve-block-map.js +115 -0
  449. package/node_modules/yaml/browser/dist/compose/resolve-block-scalar.js +198 -0
  450. package/node_modules/yaml/browser/dist/compose/resolve-block-seq.js +49 -0
  451. package/node_modules/yaml/browser/dist/compose/resolve-end.js +37 -0
  452. package/node_modules/yaml/browser/dist/compose/resolve-flow-collection.js +207 -0
  453. package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +225 -0
  454. package/node_modules/yaml/browser/dist/compose/resolve-props.js +146 -0
  455. package/node_modules/yaml/browser/dist/compose/util-contains-newline.js +34 -0
  456. package/node_modules/yaml/browser/dist/compose/util-empty-scalar-position.js +26 -0
  457. package/node_modules/yaml/browser/dist/compose/util-flow-indent-check.js +15 -0
  458. package/node_modules/yaml/browser/dist/compose/util-map-includes.js +13 -0
  459. package/node_modules/yaml/browser/dist/doc/Document.js +335 -0
  460. package/node_modules/yaml/browser/dist/doc/anchors.js +71 -0
  461. package/node_modules/yaml/browser/dist/doc/applyReviver.js +55 -0
  462. package/node_modules/yaml/browser/dist/doc/createNode.js +88 -0
  463. package/node_modules/yaml/browser/dist/doc/directives.js +176 -0
  464. package/node_modules/yaml/browser/dist/errors.js +57 -0
  465. package/node_modules/yaml/browser/dist/index.js +17 -0
  466. package/node_modules/yaml/browser/dist/log.js +11 -0
  467. package/node_modules/yaml/browser/dist/nodes/Alias.js +116 -0
  468. package/node_modules/yaml/browser/dist/nodes/Collection.js +147 -0
  469. package/node_modules/yaml/browser/dist/nodes/Node.js +38 -0
  470. package/node_modules/yaml/browser/dist/nodes/Pair.js +36 -0
  471. package/node_modules/yaml/browser/dist/nodes/Scalar.js +24 -0
  472. package/node_modules/yaml/browser/dist/nodes/YAMLMap.js +144 -0
  473. package/node_modules/yaml/browser/dist/nodes/YAMLSeq.js +113 -0
  474. package/node_modules/yaml/browser/dist/nodes/addPairToJSMap.js +63 -0
  475. package/node_modules/yaml/browser/dist/nodes/identity.js +36 -0
  476. package/node_modules/yaml/browser/dist/nodes/toJS.js +37 -0
  477. package/node_modules/yaml/browser/dist/parse/cst-scalar.js +214 -0
  478. package/node_modules/yaml/browser/dist/parse/cst-stringify.js +61 -0
  479. package/node_modules/yaml/browser/dist/parse/cst-visit.js +97 -0
  480. package/node_modules/yaml/browser/dist/parse/cst.js +98 -0
  481. package/node_modules/yaml/browser/dist/parse/lexer.js +721 -0
  482. package/node_modules/yaml/browser/dist/parse/line-counter.js +39 -0
  483. package/node_modules/yaml/browser/dist/parse/parser.js +975 -0
  484. package/node_modules/yaml/browser/dist/public-api.js +102 -0
  485. package/node_modules/yaml/browser/dist/schema/Schema.js +37 -0
  486. package/node_modules/yaml/browser/dist/schema/common/map.js +17 -0
  487. package/node_modules/yaml/browser/dist/schema/common/null.js +15 -0
  488. package/node_modules/yaml/browser/dist/schema/common/seq.js +17 -0
  489. package/node_modules/yaml/browser/dist/schema/common/string.js +14 -0
  490. package/node_modules/yaml/browser/dist/schema/core/bool.js +19 -0
  491. package/node_modules/yaml/browser/dist/schema/core/float.js +43 -0
  492. package/node_modules/yaml/browser/dist/schema/core/int.js +38 -0
  493. package/node_modules/yaml/browser/dist/schema/core/schema.js +23 -0
  494. package/node_modules/yaml/browser/dist/schema/json/schema.js +62 -0
  495. package/node_modules/yaml/browser/dist/schema/tags.js +96 -0
  496. package/node_modules/yaml/browser/dist/schema/yaml-1.1/binary.js +58 -0
  497. package/node_modules/yaml/browser/dist/schema/yaml-1.1/bool.js +26 -0
  498. package/node_modules/yaml/browser/dist/schema/yaml-1.1/float.js +46 -0
  499. package/node_modules/yaml/browser/dist/schema/yaml-1.1/int.js +71 -0
  500. package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +67 -0
  501. package/node_modules/yaml/browser/dist/schema/yaml-1.1/omap.js +74 -0
  502. package/node_modules/yaml/browser/dist/schema/yaml-1.1/pairs.js +78 -0
  503. package/node_modules/yaml/browser/dist/schema/yaml-1.1/schema.js +39 -0
  504. package/node_modules/yaml/browser/dist/schema/yaml-1.1/set.js +93 -0
  505. package/node_modules/yaml/browser/dist/schema/yaml-1.1/timestamp.js +101 -0
  506. package/node_modules/yaml/browser/dist/stringify/foldFlowLines.js +146 -0
  507. package/node_modules/yaml/browser/dist/stringify/stringify.js +129 -0
  508. package/node_modules/yaml/browser/dist/stringify/stringifyCollection.js +153 -0
  509. package/node_modules/yaml/browser/dist/stringify/stringifyComment.js +20 -0
  510. package/node_modules/yaml/browser/dist/stringify/stringifyDocument.js +85 -0
  511. package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +25 -0
  512. package/node_modules/yaml/browser/dist/stringify/stringifyPair.js +150 -0
  513. package/node_modules/yaml/browser/dist/stringify/stringifyString.js +336 -0
  514. package/node_modules/yaml/browser/dist/util.js +11 -0
  515. package/node_modules/yaml/browser/dist/visit.js +233 -0
  516. package/node_modules/yaml/browser/index.js +5 -0
  517. package/node_modules/yaml/browser/package.json +3 -0
  518. package/node_modules/yaml/dist/cli.d.ts +8 -0
  519. package/node_modules/yaml/dist/cli.mjs +201 -0
  520. package/node_modules/yaml/dist/compose/compose-collection.d.ts +11 -0
  521. package/node_modules/yaml/dist/compose/compose-collection.js +90 -0
  522. package/node_modules/yaml/dist/compose/compose-doc.d.ts +7 -0
  523. package/node_modules/yaml/dist/compose/compose-doc.js +45 -0
  524. package/node_modules/yaml/dist/compose/compose-node.d.ts +29 -0
  525. package/node_modules/yaml/dist/compose/compose-node.js +112 -0
  526. package/node_modules/yaml/dist/compose/compose-scalar.d.ts +5 -0
  527. package/node_modules/yaml/dist/compose/compose-scalar.js +88 -0
  528. package/node_modules/yaml/dist/compose/composer.d.ts +63 -0
  529. package/node_modules/yaml/dist/compose/composer.js +224 -0
  530. package/node_modules/yaml/dist/compose/resolve-block-map.d.ts +6 -0
  531. package/node_modules/yaml/dist/compose/resolve-block-map.js +117 -0
  532. package/node_modules/yaml/dist/compose/resolve-block-scalar.d.ts +11 -0
  533. package/node_modules/yaml/dist/compose/resolve-block-scalar.js +200 -0
  534. package/node_modules/yaml/dist/compose/resolve-block-seq.d.ts +6 -0
  535. package/node_modules/yaml/dist/compose/resolve-block-seq.js +51 -0
  536. package/node_modules/yaml/dist/compose/resolve-end.d.ts +6 -0
  537. package/node_modules/yaml/dist/compose/resolve-end.js +39 -0
  538. package/node_modules/yaml/dist/compose/resolve-flow-collection.d.ts +7 -0
  539. package/node_modules/yaml/dist/compose/resolve-flow-collection.js +209 -0
  540. package/node_modules/yaml/dist/compose/resolve-flow-scalar.d.ts +10 -0
  541. package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +227 -0
  542. package/node_modules/yaml/dist/compose/resolve-props.d.ts +23 -0
  543. package/node_modules/yaml/dist/compose/resolve-props.js +148 -0
  544. package/node_modules/yaml/dist/compose/util-contains-newline.d.ts +2 -0
  545. package/node_modules/yaml/dist/compose/util-contains-newline.js +36 -0
  546. package/node_modules/yaml/dist/compose/util-empty-scalar-position.d.ts +2 -0
  547. package/node_modules/yaml/dist/compose/util-empty-scalar-position.js +28 -0
  548. package/node_modules/yaml/dist/compose/util-flow-indent-check.d.ts +3 -0
  549. package/node_modules/yaml/dist/compose/util-flow-indent-check.js +17 -0
  550. package/node_modules/yaml/dist/compose/util-map-includes.d.ts +4 -0
  551. package/node_modules/yaml/dist/compose/util-map-includes.js +15 -0
  552. package/node_modules/yaml/dist/doc/Document.d.ts +141 -0
  553. package/node_modules/yaml/dist/doc/Document.js +337 -0
  554. package/node_modules/yaml/dist/doc/anchors.d.ts +24 -0
  555. package/node_modules/yaml/dist/doc/anchors.js +76 -0
  556. package/node_modules/yaml/dist/doc/applyReviver.d.ts +9 -0
  557. package/node_modules/yaml/dist/doc/applyReviver.js +57 -0
  558. package/node_modules/yaml/dist/doc/createNode.d.ts +17 -0
  559. package/node_modules/yaml/dist/doc/createNode.js +90 -0
  560. package/node_modules/yaml/dist/doc/directives.d.ts +49 -0
  561. package/node_modules/yaml/dist/doc/directives.js +178 -0
  562. package/node_modules/yaml/dist/errors.d.ts +21 -0
  563. package/node_modules/yaml/dist/errors.js +62 -0
  564. package/node_modules/yaml/dist/index.d.ts +25 -0
  565. package/node_modules/yaml/dist/index.js +50 -0
  566. package/node_modules/yaml/dist/log.d.ts +3 -0
  567. package/node_modules/yaml/dist/log.js +19 -0
  568. package/node_modules/yaml/dist/nodes/Alias.d.ts +29 -0
  569. package/node_modules/yaml/dist/nodes/Alias.js +118 -0
  570. package/node_modules/yaml/dist/nodes/Collection.d.ts +73 -0
  571. package/node_modules/yaml/dist/nodes/Collection.js +151 -0
  572. package/node_modules/yaml/dist/nodes/Node.d.ts +53 -0
  573. package/node_modules/yaml/dist/nodes/Node.js +40 -0
  574. package/node_modules/yaml/dist/nodes/Pair.d.ts +22 -0
  575. package/node_modules/yaml/dist/nodes/Pair.js +39 -0
  576. package/node_modules/yaml/dist/nodes/Scalar.d.ts +47 -0
  577. package/node_modules/yaml/dist/nodes/Scalar.js +27 -0
  578. package/node_modules/yaml/dist/nodes/YAMLMap.d.ts +53 -0
  579. package/node_modules/yaml/dist/nodes/YAMLMap.js +147 -0
  580. package/node_modules/yaml/dist/nodes/YAMLSeq.d.ts +60 -0
  581. package/node_modules/yaml/dist/nodes/YAMLSeq.js +115 -0
  582. package/node_modules/yaml/dist/nodes/addPairToJSMap.d.ts +4 -0
  583. package/node_modules/yaml/dist/nodes/addPairToJSMap.js +65 -0
  584. package/node_modules/yaml/dist/nodes/identity.d.ts +23 -0
  585. package/node_modules/yaml/dist/nodes/identity.js +53 -0
  586. package/node_modules/yaml/dist/nodes/toJS.d.ts +29 -0
  587. package/node_modules/yaml/dist/nodes/toJS.js +39 -0
  588. package/node_modules/yaml/dist/options.d.ts +350 -0
  589. package/node_modules/yaml/dist/parse/cst-scalar.d.ts +64 -0
  590. package/node_modules/yaml/dist/parse/cst-scalar.js +218 -0
  591. package/node_modules/yaml/dist/parse/cst-stringify.d.ts +8 -0
  592. package/node_modules/yaml/dist/parse/cst-stringify.js +63 -0
  593. package/node_modules/yaml/dist/parse/cst-visit.d.ts +39 -0
  594. package/node_modules/yaml/dist/parse/cst-visit.js +99 -0
  595. package/node_modules/yaml/dist/parse/cst.d.ts +109 -0
  596. package/node_modules/yaml/dist/parse/cst.js +112 -0
  597. package/node_modules/yaml/dist/parse/lexer.d.ts +87 -0
  598. package/node_modules/yaml/dist/parse/lexer.js +723 -0
  599. package/node_modules/yaml/dist/parse/line-counter.d.ts +22 -0
  600. package/node_modules/yaml/dist/parse/line-counter.js +41 -0
  601. package/node_modules/yaml/dist/parse/parser.d.ts +84 -0
  602. package/node_modules/yaml/dist/parse/parser.js +980 -0
  603. package/node_modules/yaml/dist/public-api.d.ts +44 -0
  604. package/node_modules/yaml/dist/public-api.js +107 -0
  605. package/node_modules/yaml/dist/schema/Schema.d.ts +17 -0
  606. package/node_modules/yaml/dist/schema/Schema.js +39 -0
  607. package/node_modules/yaml/dist/schema/common/map.d.ts +2 -0
  608. package/node_modules/yaml/dist/schema/common/map.js +19 -0
  609. package/node_modules/yaml/dist/schema/common/null.d.ts +4 -0
  610. package/node_modules/yaml/dist/schema/common/null.js +17 -0
  611. package/node_modules/yaml/dist/schema/common/seq.d.ts +2 -0
  612. package/node_modules/yaml/dist/schema/common/seq.js +19 -0
  613. package/node_modules/yaml/dist/schema/common/string.d.ts +2 -0
  614. package/node_modules/yaml/dist/schema/common/string.js +16 -0
  615. package/node_modules/yaml/dist/schema/core/bool.d.ts +4 -0
  616. package/node_modules/yaml/dist/schema/core/bool.js +21 -0
  617. package/node_modules/yaml/dist/schema/core/float.d.ts +4 -0
  618. package/node_modules/yaml/dist/schema/core/float.js +47 -0
  619. package/node_modules/yaml/dist/schema/core/int.d.ts +4 -0
  620. package/node_modules/yaml/dist/schema/core/int.js +42 -0
  621. package/node_modules/yaml/dist/schema/core/schema.d.ts +1 -0
  622. package/node_modules/yaml/dist/schema/core/schema.js +25 -0
  623. package/node_modules/yaml/dist/schema/json/schema.d.ts +2 -0
  624. package/node_modules/yaml/dist/schema/json/schema.js +64 -0
  625. package/node_modules/yaml/dist/schema/json-schema.d.ts +69 -0
  626. package/node_modules/yaml/dist/schema/tags.d.ts +48 -0
  627. package/node_modules/yaml/dist/schema/tags.js +99 -0
  628. package/node_modules/yaml/dist/schema/types.d.ts +92 -0
  629. package/node_modules/yaml/dist/schema/yaml-1.1/binary.d.ts +2 -0
  630. package/node_modules/yaml/dist/schema/yaml-1.1/binary.js +70 -0
  631. package/node_modules/yaml/dist/schema/yaml-1.1/bool.d.ts +7 -0
  632. package/node_modules/yaml/dist/schema/yaml-1.1/bool.js +29 -0
  633. package/node_modules/yaml/dist/schema/yaml-1.1/float.d.ts +4 -0
  634. package/node_modules/yaml/dist/schema/yaml-1.1/float.js +50 -0
  635. package/node_modules/yaml/dist/schema/yaml-1.1/int.d.ts +5 -0
  636. package/node_modules/yaml/dist/schema/yaml-1.1/int.js +76 -0
  637. package/node_modules/yaml/dist/schema/yaml-1.1/merge.d.ts +9 -0
  638. package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +71 -0
  639. package/node_modules/yaml/dist/schema/yaml-1.1/omap.d.ts +22 -0
  640. package/node_modules/yaml/dist/schema/yaml-1.1/omap.js +77 -0
  641. package/node_modules/yaml/dist/schema/yaml-1.1/pairs.d.ts +10 -0
  642. package/node_modules/yaml/dist/schema/yaml-1.1/pairs.js +82 -0
  643. package/node_modules/yaml/dist/schema/yaml-1.1/schema.d.ts +1 -0
  644. package/node_modules/yaml/dist/schema/yaml-1.1/schema.js +41 -0
  645. package/node_modules/yaml/dist/schema/yaml-1.1/set.d.ts +28 -0
  646. package/node_modules/yaml/dist/schema/yaml-1.1/set.js +96 -0
  647. package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.d.ts +6 -0
  648. package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.js +105 -0
  649. package/node_modules/yaml/dist/stringify/foldFlowLines.d.ts +34 -0
  650. package/node_modules/yaml/dist/stringify/foldFlowLines.js +151 -0
  651. package/node_modules/yaml/dist/stringify/stringify.d.ts +21 -0
  652. package/node_modules/yaml/dist/stringify/stringify.js +132 -0
  653. package/node_modules/yaml/dist/stringify/stringifyCollection.d.ts +17 -0
  654. package/node_modules/yaml/dist/stringify/stringifyCollection.js +155 -0
  655. package/node_modules/yaml/dist/stringify/stringifyComment.d.ts +10 -0
  656. package/node_modules/yaml/dist/stringify/stringifyComment.js +24 -0
  657. package/node_modules/yaml/dist/stringify/stringifyDocument.d.ts +4 -0
  658. package/node_modules/yaml/dist/stringify/stringifyDocument.js +87 -0
  659. package/node_modules/yaml/dist/stringify/stringifyNumber.d.ts +2 -0
  660. package/node_modules/yaml/dist/stringify/stringifyNumber.js +27 -0
  661. package/node_modules/yaml/dist/stringify/stringifyPair.d.ts +3 -0
  662. package/node_modules/yaml/dist/stringify/stringifyPair.js +152 -0
  663. package/node_modules/yaml/dist/stringify/stringifyString.d.ts +9 -0
  664. package/node_modules/yaml/dist/stringify/stringifyString.js +338 -0
  665. package/node_modules/yaml/dist/test-events.d.ts +4 -0
  666. package/node_modules/yaml/dist/test-events.js +134 -0
  667. package/node_modules/yaml/dist/util.d.ts +16 -0
  668. package/node_modules/yaml/dist/util.js +28 -0
  669. package/node_modules/yaml/dist/visit.d.ts +102 -0
  670. package/node_modules/yaml/dist/visit.js +236 -0
  671. package/node_modules/yaml/package.json +97 -0
  672. package/node_modules/yaml/util.js +2 -0
  673. package/package.json +4 -3
  674. package/references/communication-contract.md +26 -0
  675. package/references/fleet-coordination-patterns.md +20 -0
  676. package/references/orchestration-patterns.md +2 -2
  677. package/references/workflow-authoring.md +1 -1
  678. package/scripts/fleet.ts +2 -1
  679. package/scripts/flow.ts +23 -7
  680. package/scripts/lib/codex-remote-control.ts +3 -1
  681. package/scripts/lib/flow-command.ts +19 -3
  682. package/scripts/workflows/lib/agent-phase.ts +18 -4
  683. package/scripts/workflows/lib/debate.ts +149 -0
  684. package/scripts/workflows/lib/envelopes.ts +32 -4
  685. package/scripts/workflows/lib/merge.ts +95 -0
  686. package/scripts/workflows/lib/model-visibility.ts +92 -0
  687. package/scripts/workflows/lib/personas.ts +10 -0
  688. package/scripts/workflows/lib/poll.ts +86 -0
  689. package/scripts/workflows/lib/run.ts +2 -0
  690. package/scripts/workflows/lib/voices.ts +125 -0
  691. package/scripts/workflows/lib/writer-lease.ts +112 -0
  692. package/scripts/workflows/wf-debate.ts +87 -0
  693. package/scripts/workflows/wf-poll.ts +95 -0
  694. package/skills/drafting-workflows/SKILL.md +1 -1
  695. package/skills/planning-and-task-breakdown/SKILL.md +2 -0
@@ -0,0 +1,85 @@
1
+ // External-blocker circuit breaker — the pure policy core behind "stop when the
2
+ // thing you need is not yours to get".
3
+ //
4
+ // The observed failure: a runtime-telemetry assertion could not be proven
5
+ // because the correlation destination did not exist outside the fleet. Nothing
6
+ // stopped the line, so the run kept substituting internal work for the missing
7
+ // external fact — building manifests, fixtures, and diagnostic packets — for
8
+ // hours, and the assertion ended UNPROVEN anyway. An external blocker is not a
9
+ // harder version of the task; it is the end of what delegation can buy.
10
+ //
11
+ // Protocol: a specialist that cannot proceed without something outside the
12
+ // fleet's reach emits `EXTERNAL_BLOCKED: <what is missing and who owns it>`.
13
+ // The hub records it and refuses the NEXT dispatch/research until the human has
14
+ // been addressed — the escalation is the deliverable at that point.
15
+
16
+ /** Pull `EXTERNAL_BLOCKED: …` markers out of a specialist's output. */
17
+ export function extractExternalBlockers(output) {
18
+ const blockers = [];
19
+ for (const rawLine of String(output || "").split("\n")) {
20
+ const line = rawLine.trim();
21
+ const match = line.match(/^EXTERNAL_BLOCKED\s*:\s*(.+)$/i);
22
+ if (match) {
23
+ const what = match[1].trim();
24
+ if (what && !blockers.includes(what)) blockers.push(what);
25
+ }
26
+ }
27
+ return blockers;
28
+ }
29
+
30
+ /**
31
+ * Gate the next dispatcher call while an external blocker is unacknowledged.
32
+ *
33
+ * state: {
34
+ * blockers: [{ agent, what }], // recorded, newest last
35
+ * acknowledged: boolean, // human addressed (ask_user called, or new user turn)
36
+ * askUserAvailable: boolean, // whether this session has the ask_user tool
37
+ * refusedOnce: boolean, // a refusal was already issued for this blocker set
38
+ * }
39
+ *
40
+ * Returns null when allowed, else { reason, message }. Without ask_user the gate
41
+ * fires exactly once: a session that cannot reach the human must still be able
42
+ * to finish and report, and an unbreakable gate there is a deadlock, not a stop.
43
+ */
44
+ export function checkExternalBlockerGate(state) {
45
+ const blockers = state?.blockers || [];
46
+ if (blockers.length === 0) return null;
47
+ if (state?.acknowledged) return null;
48
+ if (!state?.askUserAvailable && state?.refusedOnce) return null;
49
+
50
+ const list = blockers.map((b) => ` - ${b.what}${b.agent ? ` (reported by ${b.agent})` : ""}`).join("\n");
51
+ const escalation = state?.askUserAvailable
52
+ ? "Call `ask_user` with the packet below. The gate opens as soon as you do."
53
+ : "`ask_user` is unavailable in this session: put the packet below in your reply to the human and stop " +
54
+ "this line of work. (This gate fires once; further dispatches are allowed so you can finish and report.)";
55
+
56
+ return {
57
+ reason: "external_blocked",
58
+ message: `⛔ EXTERNAL BLOCKER — dispatch refused and NOT counted against any budget.\n\n` +
59
+ `A specialist reported that it needs something outside the fleet's reach:\n${list}\n\n` +
60
+ `Do NOT route around this. Substituting internal work for a missing external fact — building ` +
61
+ `scripts, manifests, fixtures, or diagnostic packets to approximate it — is how a blocked ` +
62
+ `assertion turns into hours of work that still ends UNPROVEN.\n\n` +
63
+ `${escalation}\n\n` +
64
+ `Owner escalation packet (one message, no dispatches):\n` +
65
+ ` 1. WHAT is missing and who owns it.\n` +
66
+ ` 2. WHICH assertions/tasks are blocked on it, by id.\n` +
67
+ ` 3. WHAT is already proven and where the evidence lives (artifact paths).\n` +
68
+ ` 4. The concrete OPTIONS for the human: provide the missing access, waive the assertion as ` +
69
+ `UNPROVEN (a waiver is not a PASS), or drop the item from scope.\n` +
70
+ ` 5. What you will do while it is blocked — normally: the unrelated remaining work, or nothing.`,
71
+ };
72
+ }
73
+
74
+ /** The protocol paragraph injected into every specialist's system prompt. */
75
+ export function externalBlockedProtocol() {
76
+ return [
77
+ "- External blocker: if you cannot proceed because something OUTSIDE this repo and outside your",
78
+ " tools is missing — an account, a permission, a deployment credential, a telemetry/monitoring",
79
+ " destination, a third-party service, a human-only console action — do NOT build a substitute for",
80
+ " it and do NOT keep trying alternatives. Emit a line of the form",
81
+ " `EXTERNAL_BLOCKED: <what is missing, who owns it, and what it blocks>`, report what you DID",
82
+ " prove, and stop. The dispatcher escalates it to the human; approximating the missing fact with",
83
+ " extra scripts, fixtures, or manifests is the failure this protocol exists to prevent.",
84
+ ].join("\n");
85
+ }
@@ -0,0 +1,55 @@
1
+ {
2
+ "tools": [
3
+ "coms_await",
4
+ "coms_get",
5
+ "coms_list",
6
+ "coms_send",
7
+ "dispatch_agent",
8
+ "get_assertions",
9
+ "herdr_close_pane",
10
+ "herdr_notify",
11
+ "herdr_read_pane",
12
+ "herdr_spawn_pane",
13
+ "herdr_spawn_peer",
14
+ "set_assertions",
15
+ "set_task_tier",
16
+ "spawn_research",
17
+ "team_adjust",
18
+ "update_assertion"
19
+ ],
20
+ "commands": [
21
+ "af-agent-model",
22
+ "af-agent-model-thinking",
23
+ "af-agent-models-substitute",
24
+ "af-agents-add",
25
+ "af-agents-drop",
26
+ "af-agents-history",
27
+ "af-agents-kill",
28
+ "af-agents-list",
29
+ "af-agents-restart",
30
+ "af-agents-save",
31
+ "af-agents-team",
32
+ "af-compound",
33
+ "af-coms",
34
+ "af-context",
35
+ "af-debate",
36
+ "af-dispatch-policy",
37
+ "af-handoff",
38
+ "af-hub-report",
39
+ "af-models",
40
+ "af-poll",
41
+ "af-watchdog",
42
+ "af-work-mode",
43
+ "af-zoom"
44
+ ],
45
+ "flags": [
46
+ "agent-team",
47
+ "color",
48
+ "explicit",
49
+ "name",
50
+ "project",
51
+ "purpose",
52
+ "solo",
53
+ "work-mode"
54
+ ]
55
+ }
@@ -0,0 +1,30 @@
1
+ import { formatVersionLabel } from "./version.ts";
2
+
3
+ type FooterTheme = {
4
+ fg(color: string, text: string): string;
5
+ };
6
+
7
+ export function composeHubFooterLeft(
8
+ version: string | null,
9
+ model: string,
10
+ thinkingSuffix: string,
11
+ ): string {
12
+ return [version ? formatVersionLabel(version) : "", `${model}${thinkingSuffix}`]
13
+ .filter(Boolean)
14
+ .join(" · ");
15
+ }
16
+
17
+ export function composeFleetFooterHint(viewMode: "compact" | "off", executionPair?: string): string {
18
+ const work = executionPair ? ` · Alt+M ${executionPair}` : "";
19
+ return `Alt+A fleet${work} · Alt+Shift+A widget:${viewMode}`;
20
+ }
21
+
22
+ export function renderHubFooterLeft(
23
+ theme: FooterTheme,
24
+ version: string | null,
25
+ model: string,
26
+ thinkingSuffix: string,
27
+ ): string {
28
+ const metadata = composeHubFooterLeft(version, model, thinkingSuffix);
29
+ return theme.fg("dim", ` ${metadata}`);
30
+ }
@@ -0,0 +1,266 @@
1
+ import { isAbsolute, relative, resolve } from "node:path";
2
+
3
+ export const MAX_DELEGATE_DEPTH = 1;
4
+ export const DELEGATE_TREE_SPAWN_BUDGET = 4;
5
+ export const READ_ONLY_TOOLS = "read,grep,find,ls";
6
+
7
+ const SAFE_AGENT_KEY_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
8
+
9
+ export interface ModelOverrideConfig {
10
+ model?: string;
11
+ fallbackModel?: string;
12
+ }
13
+
14
+ // Preserve the persona/frontmatter model across any number of project/session
15
+ // overrides. The first declared model is the only automatic fallback target.
16
+ export function applyModelOverride<T extends ModelOverrideConfig>(current: T, override: string): T {
17
+ if (!override || override === current.model) return current;
18
+ const original = current.fallbackModel ?? current.model;
19
+ return {
20
+ ...current,
21
+ model: override,
22
+ ...(original && original !== override ? { fallbackModel: original } : {}),
23
+ };
24
+ }
25
+
26
+ export function fallbackModelFor(config: ModelOverrideConfig, effectiveModel?: string): string | undefined {
27
+ const original = config.fallbackModel ?? config.model;
28
+ return original && effectiveModel && original !== effectiveModel ? original : undefined;
29
+ }
30
+
31
+ export function parseTeamsYaml(raw: string): Record<string, string[]> {
32
+ const teams: Record<string, string[]> = {};
33
+ let current: string | null = null;
34
+ for (const rawLine of raw.split("\n")) {
35
+ const line = rawLine.replace(/\r$/, "");
36
+ const teamMatch = line.match(/^(\S[^:]*):\s*$/);
37
+ if (teamMatch) {
38
+ current = teamMatch[1].trim();
39
+ teams[current] = [];
40
+ continue;
41
+ }
42
+ const itemMatch = line.match(/^\s+-\s+(.+)$/);
43
+ if (itemMatch && current) {
44
+ teams[current].push(itemMatch[1].trim());
45
+ }
46
+ }
47
+ return teams;
48
+ }
49
+
50
+ export function resolveStartupRoster(
51
+ teams: Record<string, string[]>,
52
+ requested: unknown,
53
+ ): { name: string; members: string[] } | null {
54
+ if (typeof requested !== "string" || requested.trim() === "") return null;
55
+ const wanted = requested.trim().toLowerCase();
56
+ const name = Object.keys(teams).find(candidate => candidate.toLowerCase() === wanted);
57
+ if (!name) {
58
+ const available = Object.keys(teams).sort().join(", ") || "(none)";
59
+ throw new Error(`Unknown native roster "${requested}". Available: ${available}.`);
60
+ }
61
+ return { name, members: [...teams[name]] };
62
+ }
63
+
64
+ export function orchestratorNeedsRoster(workMode: string, rosterSize: number): boolean {
65
+ return workMode === "orchestrator" && rosterSize < 1;
66
+ }
67
+
68
+ // Normalize a dispatcher-supplied agent name to the persona-slug key space:
69
+ // display names ("Test Engineer"), underscores, and stray whitespace all resolve
70
+ // to the same key the hub stores states under ("test-engineer").
71
+ export function normalizeAgentInput(value: string): string {
72
+ return String(value ?? "").trim().toLowerCase().replace(/[\s_]+/g, "-");
73
+ }
74
+
75
+ // Duplicate-dispatch guard: one fingerprint per (agent, task) where the task
76
+ // text is normalized hard (case, whitespace, punctuation) so trivial rewording
77
+ // still collides. Genuinely different tasks differ in their words, not their
78
+ // commas.
79
+ export function taskFingerprint(agent: string, task: string): string {
80
+ const normalizedTask = String(task ?? "")
81
+ .toLowerCase()
82
+ .replace(/[^\p{L}\p{N}]+/gu, " ")
83
+ .trim()
84
+ .replace(/\s+/g, " ");
85
+ return `${normalizeAgentInput(agent)}::${normalizedTask}`;
86
+ }
87
+
88
+ // Replace one team's block in teams.yaml text (or append it) without touching
89
+ // comments or other teams — a full re-serialize would destroy the file's
90
+ // header comments. The block is `name:` plus its ` - member` lines.
91
+ export function upsertTeamInYaml(raw: string, name: string, members: string[]): string {
92
+ const block = `${name}:\n${members.map(m => ` - ${m}`).join("\n")}\n`;
93
+ const lines = String(raw ?? "").split("\n");
94
+ let start = -1;
95
+ let end = -1;
96
+ for (let i = 0; i < lines.length; i++) {
97
+ const teamMatch = lines[i].match(/^(\S[^:]*):\s*$/);
98
+ if (start === -1) {
99
+ if (teamMatch && teamMatch[1].trim() === name) start = i;
100
+ continue;
101
+ }
102
+ // Inside the target block: it ends at the next top-level key or a
103
+ // top-level comment (comments are never deleted, only members are).
104
+ if (teamMatch || /^#/.test(lines[i])) { end = i; break; }
105
+ }
106
+ if (start === -1) {
107
+ const body = String(raw ?? "");
108
+ const sep = body.length === 0 || body.endsWith("\n\n") ? "" : body.endsWith("\n") ? "\n" : "\n\n";
109
+ return body + sep + block;
110
+ }
111
+ if (end === -1) end = lines.length;
112
+ // Keep blank/comment lines that trail the block attached to the NEXT section.
113
+ while (end - 1 > start && lines[end - 1].trim() === "") end--;
114
+ return [...lines.slice(0, start), ...block.split("\n").slice(0, -1), ...lines.slice(end)].join("\n");
115
+ }
116
+
117
+ export function safeAgentKey(value: string): string {
118
+ if (typeof value !== "string") {
119
+ throw new Error("Agent key must be a string");
120
+ }
121
+ const key = value.trim();
122
+ if (!SAFE_AGENT_KEY_RE.test(key)) {
123
+ throw new Error(`Invalid agent key "${value}"; expected a lowercase slug (a-z, 0-9, hyphen)`);
124
+ }
125
+ return key;
126
+ }
127
+
128
+ export function safePathWithin(baseDir: string, ...segments: string[]): string {
129
+ const base = resolve(baseDir);
130
+ const target = resolve(base, ...segments);
131
+ const rel = relative(base, target);
132
+ if (rel && (rel.startsWith("..") || isAbsolute(rel))) {
133
+ throw new Error(`Refusing path outside ${base}: ${target}`);
134
+ }
135
+ return target;
136
+ }
137
+
138
+ export function clampDelegateDepth(depth: number): number {
139
+ return Math.min(Math.max(0, Math.floor(depth)), MAX_DELEGATE_DEPTH);
140
+ }
141
+
142
+ function positiveBudget(value: unknown, fallback: number): number {
143
+ const safeFallback = Math.min(Math.max(1, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
144
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
145
+ return Number.isFinite(n) && n > 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
146
+ }
147
+
148
+ function remainingBudget(value: unknown, fallback: number): number {
149
+ const safeFallback = Math.min(Math.max(0, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
150
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
151
+ return Number.isFinite(n) && n >= 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
152
+ }
153
+
154
+ export interface DelegateBudgetState {
155
+ depth: number;
156
+ callBudget: number;
157
+ remainingSpawns: number;
158
+ }
159
+
160
+ export function normalizeDelegateRuntimeBudgets(
161
+ input: { depth?: unknown; callBudget?: unknown; remainingSpawns?: unknown },
162
+ fallbackCallBudget = DELEGATE_TREE_SPAWN_BUDGET,
163
+ ): DelegateBudgetState {
164
+ const callBudget = positiveBudget(input.callBudget, fallbackCallBudget);
165
+ return {
166
+ depth: typeof input.depth === "number" ? clampDelegateDepth(input.depth) : 0,
167
+ callBudget,
168
+ remainingSpawns: remainingBudget(input.remainingSpawns, callBudget),
169
+ };
170
+ }
171
+
172
+ export function delegateBudgetRefusal(state: DelegateBudgetState & { callCount: number }): string | null {
173
+ if (state.depth <= 0) {
174
+ return "Delegation refused: your depth budget is 0 — you are already at the bottom of the " +
175
+ "delegation tree. Do this task yourself with your own tools.";
176
+ }
177
+ if (state.remainingSpawns <= 0) {
178
+ return `Delegation refused: tree-wide spawn budget exhausted (${DELEGATE_TREE_SPAWN_BUDGET} ` +
179
+ "delegate children per dispatch). Finish with the results you already have.";
180
+ }
181
+ if (state.callCount >= state.callBudget) {
182
+ return `Delegation refused: process call budget exhausted (${state.callBudget} delegate calls). ` +
183
+ "Finish with the results you already have.";
184
+ }
185
+ return null;
186
+ }
187
+
188
+ export function intersectToolLists(base: string, cap: string): string {
189
+ const baseSet = new Set(base.split(",").map(s => s.trim()).filter(Boolean));
190
+ return cap.split(",").map(s => s.trim()).filter(t => t && baseSet.has(t)).join(",");
191
+ }
192
+
193
+ /**
194
+ * True only when EVERY tool in the list is one of READ_ONLY_TOOLS. Conservative
195
+ * by construction: an unknown tool name makes the answer false, because the
196
+ * caller uses this to decide whether re-running is safe (a mid-run model
197
+ * fallback) and a wrong "yes" duplicates side effects.
198
+ */
199
+ export function isReadOnlyToolList(tools: string): boolean {
200
+ const allowed = new Set(READ_ONLY_TOOLS.split(",").map(s => s.trim()));
201
+ const named = String(tools ?? "").split(",").map(s => s.trim()).filter(Boolean);
202
+ return named.length > 0 && named.every(t => allowed.has(t));
203
+ }
204
+
205
+ export interface DelegateToolResolution {
206
+ baseTools: string;
207
+ effectiveTools: string;
208
+ writeDowngraded: boolean;
209
+ refused: boolean;
210
+ }
211
+
212
+ export function resolveDelegateTools(input: {
213
+ parentTools: string;
214
+ roleTools?: string;
215
+ allowWrite?: boolean;
216
+ concurrent?: boolean;
217
+ }): DelegateToolResolution {
218
+ const writeDowngraded = input.allowWrite === true && input.concurrent === true;
219
+ const baseTools = input.allowWrite === true && input.concurrent !== true ? input.parentTools : READ_ONLY_TOOLS;
220
+ const effectiveTools = input.roleTools ? intersectToolLists(baseTools, input.roleTools) : baseTools;
221
+ return {
222
+ baseTools,
223
+ effectiveTools,
224
+ writeDowngraded,
225
+ refused: effectiveTools.length === 0,
226
+ };
227
+ }
228
+
229
+ export interface DelegateSpawnPlan {
230
+ childId: string;
231
+ nextRemainingSpawns: number;
232
+ childDepth: number;
233
+ childRemainingSpawns: number;
234
+ childCanDelegate: boolean;
235
+ childExtensions: string[];
236
+ childTools: string;
237
+ includeDelegateConfig: boolean;
238
+ }
239
+
240
+ export function planDelegateSpawn(input: {
241
+ tag: string;
242
+ roleKey: string;
243
+ childSeq: number;
244
+ depth: number;
245
+ remainingSpawns: number;
246
+ effectiveTools: string;
247
+ damageControl?: string;
248
+ delegateExt: string;
249
+ }): DelegateSpawnPlan {
250
+ const nextRemainingSpawns = Math.max(0, input.remainingSpawns - 1);
251
+ const childDepth = input.depth - 1;
252
+ const childCanDelegate = childDepth > 0 && nextRemainingSpawns > 0;
253
+ return {
254
+ childId: input.tag === "root" ? `${input.roleKey}-${input.childSeq}` : `${input.tag}.${input.roleKey}-${input.childSeq}`,
255
+ nextRemainingSpawns,
256
+ childDepth,
257
+ childRemainingSpawns: nextRemainingSpawns,
258
+ childCanDelegate,
259
+ childExtensions: [
260
+ ...(input.damageControl ? [input.damageControl] : []),
261
+ ...(childCanDelegate ? [input.delegateExt] : []),
262
+ ],
263
+ childTools: childCanDelegate ? `${input.effectiveTools},delegate` : input.effectiveTools,
264
+ includeDelegateConfig: childCanDelegate,
265
+ };
266
+ }
@@ -0,0 +1,59 @@
1
+ // Pure, allowlisted serializers for Hub mode/task lifecycle audit entries.
2
+ // Callers provide only runtime identity fields; unknown properties are ignored.
3
+
4
+ function text(value, max = 4096) {
5
+ if (typeof value !== "string") return null;
6
+ const clean = value.replace(/[\r\n]+/g, " ").trim();
7
+ return clean ? clean.slice(0, max) : null;
8
+ }
9
+
10
+ function count(value) {
11
+ return Number.isFinite(value) ? Math.max(0, Math.round(value)) : 0;
12
+ }
13
+
14
+ /** Return only non-secret process/session routing identity. */
15
+ export function buildHubAuditIdentity(input = {}) {
16
+ return {
17
+ cwd: text(input.cwd),
18
+ pid: count(input.pid),
19
+ session_id: text(input.sessionId, 256),
20
+ project: text(input.project, 256),
21
+ herdr_workspace_id: text(input.workspaceId, 256),
22
+ herdr_pane_id: text(input.paneId, 256),
23
+ };
24
+ }
25
+
26
+ export function buildTaskResetAudit(input = {}) {
27
+ const prior = input.prior ?? {};
28
+ return {
29
+ schema_version: 1,
30
+ source: text(input.source, 64),
31
+ label: text(input.label, 160),
32
+ prior: {
33
+ tier: text(prior.tier, 32),
34
+ dispatches: count(prior.dispatches),
35
+ research: count(prior.research),
36
+ review_rounds: count(prior.reviewRounds),
37
+ active_ms: count(prior.activeMs),
38
+ },
39
+ identity: buildHubAuditIdentity(input.identity),
40
+ };
41
+ }
42
+
43
+ export function buildBudgetContinuationAudit(input = {}) {
44
+ const prior = input.prior ?? {};
45
+ return {
46
+ schema_version: 1,
47
+ kind: text(input.kind, 16),
48
+ continuation: count(input.continuation),
49
+ reason: text(input.reason, 64),
50
+ prior: {
51
+ tier: text(prior.tier, 32),
52
+ dispatches: count(prior.dispatches),
53
+ research: count(prior.research),
54
+ review_rounds: count(prior.reviewRounds),
55
+ active_ms: count(prior.activeMs),
56
+ },
57
+ identity: buildHubAuditIdentity(input.identity),
58
+ };
59
+ }