@chankov/agent-fleet 2.0.4 → 2.0.6

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 (939) hide show
  1. package/.pi/agents/model-profiles.yaml +39 -34
  2. package/.pi/harnesses/agent-hub/README.md +85 -42
  3. package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  4. package/.pi/harnesses/agent-hub/artifacts.js +1 -1
  5. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
  6. package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  7. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  8. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  9. package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  10. package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
  11. package/.pi/harnesses/agent-hub/context/agent-state.ts +1 -1
  12. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
  13. package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
  14. package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
  15. package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
  16. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
  17. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
  18. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  19. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +23 -0
  20. package/.pi/harnesses/agent-hub/dispatch-native.ts +56 -30
  21. package/.pi/harnesses/agent-hub/dispatch-observability.ts +6 -1
  22. package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  23. package/.pi/harnesses/agent-hub/footer.ts +2 -2
  24. package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
  25. package/.pi/harnesses/agent-hub/index.ts +148 -85
  26. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -29
  27. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
  28. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
  29. package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
  30. package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  31. package/.pi/harnesses/agent-hub/package.json +1 -1
  32. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +59 -3
  33. package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
  34. package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
  35. package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
  36. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  37. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  38. package/.pi/harnesses/agent-hub/research/runtime.ts +19 -2
  39. package/.pi/harnesses/agent-hub/research/spawn-run.ts +18 -6
  40. package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
  41. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -4
  42. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  43. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
  44. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +99 -25
  45. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +4 -2
  46. package/.pi/harnesses/agent-hub/types.ts +2 -0
  47. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  48. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +4 -2
  49. package/.pi/harnesses/agent-hub/ui/grid.ts +16 -118
  50. package/.pi/harnesses/agent-hub/ui/pool.ts +7 -7
  51. package/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  52. package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
  53. package/.pi/harnesses/ask-user-remote/README.md +8 -2
  54. package/.pi/harnesses/ask-user-remote/index.ts +40 -14
  55. package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  56. package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
  57. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  58. package/.pi/harnesses/coms/README.md +1 -1
  59. package/.pi/harnesses/coms/index.ts +7 -1
  60. package/.pi/harnesses/coms/package.json +1 -1
  61. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  62. package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
  63. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +0 -5
  64. package/.pi/harnesses/lib/fleet-dashboard-view.ts +8 -2
  65. package/.versions/2.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  66. package/.versions/2.0.5/.pi/agents/model-profiles.yaml +83 -0
  67. package/.versions/2.0.5/.pi/agents/peers.yaml +145 -0
  68. package/.versions/2.0.5/.pi/agents/teams.yaml +41 -0
  69. package/.versions/2.0.5/.pi/agents/voices.yaml +13 -0
  70. package/.versions/2.0.5/.pi/damage-control-rules.yaml +297 -0
  71. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  72. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  73. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  74. package/.versions/2.0.5/.pi/extensions/btw/README.md +120 -0
  75. package/.versions/2.0.5/.pi/extensions/btw/index.ts +914 -0
  76. package/.versions/2.0.5/.pi/extensions/btw/package.json +6 -0
  77. package/.versions/2.0.5/.pi/extensions/btw/state.js +179 -0
  78. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  79. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  80. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  81. package/.versions/2.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  82. package/.versions/2.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  83. package/.versions/2.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  84. package/.versions/2.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  85. package/.versions/2.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  86. package/.versions/2.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  87. package/.versions/2.0.5/.pi/extensions/package-lock.json +1175 -0
  88. package/.versions/2.0.5/.pi/extensions/package.json +9 -0
  89. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/README.md +205 -0
  90. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  91. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  92. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  93. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  94. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  95. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  96. package/.versions/2.0.5/.pi/harnesses/agent-hub/README.md +1139 -0
  97. package/.versions/2.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  98. package/.versions/2.0.5/.pi/harnesses/agent-hub/artifacts.js +146 -0
  99. package/.versions/2.0.5/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  100. package/.versions/2.0.5/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  101. package/.versions/2.0.5/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  102. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  103. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  104. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  105. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  106. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  107. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  108. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  109. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  110. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  111. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  112. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  113. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  114. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  115. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  116. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  117. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  118. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  119. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  120. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  121. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  122. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  123. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  124. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  125. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  126. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  127. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  128. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  129. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  130. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  131. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  132. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  133. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  134. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  135. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  136. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  137. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-window.js +106 -0
  138. package/.versions/2.0.5/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  139. package/.versions/2.0.5/.pi/harnesses/agent-hub/delegate.ts +446 -0
  140. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  141. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  142. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  143. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  144. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  145. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-types.ts +208 -0
  146. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native.ts +199 -0
  147. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  148. package/.versions/2.0.5/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  149. package/.versions/2.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  150. package/.versions/2.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  151. package/.versions/2.0.5/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  152. package/.versions/2.0.5/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  153. package/.versions/2.0.5/.pi/harnesses/agent-hub/footer.ts +30 -0
  154. package/.versions/2.0.5/.pi/harnesses/agent-hub/helpers.ts +266 -0
  155. package/.versions/2.0.5/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  156. package/.versions/2.0.5/.pi/harnesses/agent-hub/index.ts +2115 -0
  157. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  158. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  159. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  160. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  161. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  162. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  163. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  164. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  165. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  166. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  167. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  168. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  169. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  170. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  171. package/.versions/2.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  172. package/.versions/2.0.5/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  173. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  174. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  175. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  176. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  177. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  178. package/.versions/2.0.5/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  179. package/.versions/2.0.5/.pi/harnesses/agent-hub/presentation.ts +48 -0
  180. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  181. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  182. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  183. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  184. package/.versions/2.0.5/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  185. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  186. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/runtime.ts +177 -0
  187. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/spawn-run.ts +148 -0
  188. package/.versions/2.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  189. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-contract.js +293 -0
  190. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-extract.js +75 -0
  191. package/.versions/2.0.5/.pi/harnesses/agent-hub/review-findings.js +102 -0
  192. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-budget.js +537 -0
  193. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  194. package/.versions/2.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  195. package/.versions/2.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  196. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-health.js +110 -0
  197. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-start.ts +42 -0
  198. package/.versions/2.0.5/.pi/harnesses/agent-hub/spawn.ts +404 -0
  199. package/.versions/2.0.5/.pi/harnesses/agent-hub/timeline.ts +54 -0
  200. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  201. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  202. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  203. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  204. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +232 -0
  205. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  206. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  207. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  208. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  209. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  210. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  211. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  212. package/.versions/2.0.5/.pi/harnesses/agent-hub/types.ts +62 -0
  213. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  214. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  215. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  216. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  217. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  218. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  219. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  220. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/pool.ts +98 -0
  221. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  222. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  223. package/.versions/2.0.5/.pi/harnesses/agent-hub/version.ts +42 -0
  224. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  225. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  226. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/README.md +53 -0
  227. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/index.ts +532 -0
  228. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  229. package/.versions/2.0.5/.pi/harnesses/coms/README.md +100 -0
  230. package/.versions/2.0.5/.pi/harnesses/coms/index.ts +276 -0
  231. package/.versions/2.0.5/.pi/harnesses/coms/package.json +7 -0
  232. package/.versions/2.0.5/.pi/harnesses/coms/version.ts +42 -0
  233. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/README.md +124 -0
  234. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  235. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  236. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/version.ts +42 -0
  237. package/.versions/2.0.5/.pi/harnesses/lib/coms-core-io.ts +385 -0
  238. package/.versions/2.0.5/.pi/harnesses/lib/coms-core.ts +577 -0
  239. package/.versions/2.0.5/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  240. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  241. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  242. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-view.ts +107 -0
  243. package/.versions/2.0.5/.pi/harnesses/lib/context-budget.ts +114 -0
  244. package/.versions/2.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  245. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  246. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  247. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  248. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  249. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  250. package/.versions/2.0.5/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  251. package/.versions/2.0.5/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  252. package/.versions/2.0.5/.pi/harnesses/lib/fleet-panel.ts +34 -0
  253. package/.versions/2.0.5/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  254. package/.versions/2.0.5/.pi/harnesses/lib/fleet-selection.ts +24 -0
  255. package/.versions/2.0.5/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  256. package/.versions/2.0.5/.pi/harnesses/lib/herdr-client.ts +472 -0
  257. package/.versions/2.0.5/.pi/harnesses/lib/herdr-presence.ts +399 -0
  258. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  259. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  260. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  261. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  262. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  263. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  264. package/.versions/2.0.5/.pi/harnesses/lib/spawned-peers.js +190 -0
  265. package/.versions/2.0.5/.pi/harnesses/package-lock.json +2039 -0
  266. package/.versions/2.0.5/.pi/harnesses/package.json +10 -0
  267. package/.versions/2.0.5/.pi/prompts/af-build.md +24 -0
  268. package/.versions/2.0.5/.pi/prompts/af-code-simplify.md +22 -0
  269. package/.versions/2.0.5/.pi/prompts/af-plan.md +17 -0
  270. package/.versions/2.0.5/.pi/prompts/af-review.md +16 -0
  271. package/.versions/2.0.5/.pi/prompts/af-set-hermes-telegram.md +15 -0
  272. package/.versions/2.0.5/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  273. package/.versions/2.0.5/.pi/prompts/af-ship.md +17 -0
  274. package/.versions/2.0.5/.pi/prompts/af-spec.md +15 -0
  275. package/.versions/2.0.5/.pi/prompts/af-test.md +19 -0
  276. package/.versions/2.0.5/.pi/skills/bowser/SKILL.md +145 -0
  277. package/.versions/2.0.5/.version +1 -0
  278. package/.versions/2.0.5/agents/architect.md +25 -0
  279. package/.versions/2.0.5/agents/bowser.md +28 -0
  280. package/.versions/2.0.5/agents/builder.md +56 -0
  281. package/.versions/2.0.5/agents/code-reviewer.md +210 -0
  282. package/.versions/2.0.5/agents/deep-researcher.md +33 -0
  283. package/.versions/2.0.5/agents/documenter.md +23 -0
  284. package/.versions/2.0.5/agents/orchestrator.md +23 -0
  285. package/.versions/2.0.5/agents/plan-reviewer.md +84 -0
  286. package/.versions/2.0.5/agents/planner.md +106 -0
  287. package/.versions/2.0.5/agents/releaser.md +25 -0
  288. package/.versions/2.0.5/agents/researcher.md +31 -0
  289. package/.versions/2.0.5/agents/security-auditor.md +168 -0
  290. package/.versions/2.0.5/agents/test-engineer.md +154 -0
  291. package/.versions/2.0.5/agents/web-debugger.md +44 -0
  292. package/.versions/2.0.5/agents/web-performance-auditor.md +194 -0
  293. package/.versions/2.0.5/bin/catalog/harness-runtime-closure.json +36 -0
  294. package/.versions/2.0.5/docs/ARCHITECTURE.md +407 -0
  295. package/.versions/2.0.5/docs/agent-fleet-setup.md +561 -0
  296. package/.versions/2.0.5/docs/claude-code-coms-bridge.md +133 -0
  297. package/.versions/2.0.5/docs/coms-hermes-bridge.md +189 -0
  298. package/.versions/2.0.5/docs/getting-started.md +124 -0
  299. package/.versions/2.0.5/docs/npm-install.md +299 -0
  300. package/.versions/2.0.5/docs/pi-extensions.md +446 -0
  301. package/.versions/2.0.5/docs/pi-setup.md +74 -0
  302. package/.versions/2.0.5/docs/skill-anatomy.md +150 -0
  303. package/.versions/2.0.5/hermes/README.md +347 -0
  304. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  305. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  306. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  307. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  308. package/.versions/2.0.5/hermes/gates/gate-o-capability.md +8 -0
  309. package/.versions/2.0.5/hermes/gates/gate-o-validator-fixtures.json +1 -0
  310. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  311. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  312. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  313. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  314. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  315. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  316. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  317. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  318. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  319. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  320. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  321. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  322. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  323. package/.versions/2.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  324. package/.versions/2.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  325. package/.versions/2.0.5/hermes/skills/hub-watchdog/SKILL.md +76 -0
  326. package/.versions/2.0.5/hermes/skills/hub-watchdog/manifest.json +1 -0
  327. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  328. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  329. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  330. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  331. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  332. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  333. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  334. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  335. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  336. package/.versions/2.0.5/hermes/watchdog-tests/__init__.py +0 -0
  337. package/.versions/2.0.5/hooks/coms-stop-hook.mjs +84 -0
  338. package/.versions/2.0.5/install-manifest.json +2942 -0
  339. package/.versions/2.0.5/justfile +289 -0
  340. package/.versions/2.0.5/manifest-meta.json +969 -0
  341. package/.versions/2.0.5/references/accessibility-checklist.md +160 -0
  342. package/.versions/2.0.5/references/communication-contract.md +26 -0
  343. package/.versions/2.0.5/references/definition-of-done.md +67 -0
  344. package/.versions/2.0.5/references/fleet-coordination-patterns.md +171 -0
  345. package/.versions/2.0.5/references/observability-checklist.md +91 -0
  346. package/.versions/2.0.5/references/orchestration-patterns.md +370 -0
  347. package/.versions/2.0.5/references/performance-checklist.md +153 -0
  348. package/.versions/2.0.5/references/prompting-patterns.md +380 -0
  349. package/.versions/2.0.5/references/security-checklist.md +179 -0
  350. package/.versions/2.0.5/references/testing-patterns.md +236 -0
  351. package/.versions/2.0.5/references/workflow-authoring.md +304 -0
  352. package/.versions/2.0.5/scripts/claude-code-preflight.ts +70 -0
  353. package/.versions/2.0.5/scripts/coms-claude-bridge.ts +411 -0
  354. package/.versions/2.0.5/scripts/coms-cli.ts +484 -0
  355. package/.versions/2.0.5/scripts/coms-hermes-bridge.ts +413 -0
  356. package/.versions/2.0.5/scripts/fleet.ts +222 -0
  357. package/.versions/2.0.5/scripts/flow.ts +137 -0
  358. package/.versions/2.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  359. package/.versions/2.0.5/scripts/hermes-monitor-scenario.ts +474 -0
  360. package/.versions/2.0.5/scripts/hermes-watchdog-capability-probe.ts +45 -0
  361. package/.versions/2.0.5/scripts/install-hermes-plugin.sh +180 -0
  362. package/.versions/2.0.5/scripts/lib/claude-bridge-core.ts +210 -0
  363. package/.versions/2.0.5/scripts/lib/coms-envelope.ts +582 -0
  364. package/.versions/2.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  365. package/.versions/2.0.5/scripts/lib/fleet-command.ts +270 -0
  366. package/.versions/2.0.5/scripts/lib/flow-command.ts +93 -0
  367. package/.versions/2.0.5/scripts/lib/flow-maintenance.ts +230 -0
  368. package/.versions/2.0.5/scripts/lib/herdr-layout.ts +281 -0
  369. package/.versions/2.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  370. package/.versions/2.0.5/scripts/lib/hermes-monitor-events.ts +1 -0
  371. package/.versions/2.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  372. package/.versions/2.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  373. package/.versions/2.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  374. package/.versions/2.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  375. package/.versions/2.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  376. package/.versions/2.0.5/scripts/lib/monitor-env.ts +146 -0
  377. package/.versions/2.0.5/scripts/lib/peer-launch.ts +318 -0
  378. package/.versions/2.0.5/scripts/lib/persona-banner.ts +62 -0
  379. package/.versions/2.0.5/scripts/lib/runtime-dependencies.js +124 -0
  380. package/.versions/2.0.5/scripts/lib/spawn-stagger.ts +101 -0
  381. package/.versions/2.0.5/scripts/lib/team-project.ts +213 -0
  382. package/.versions/2.0.5/scripts/lib/team-snapshot.ts +147 -0
  383. package/.versions/2.0.5/scripts/package-lock.json +35 -0
  384. package/.versions/2.0.5/scripts/package.json +9 -0
  385. package/.versions/2.0.5/scripts/peer-banner.ts +40 -0
  386. package/.versions/2.0.5/scripts/peer-launch.ts +285 -0
  387. package/.versions/2.0.5/scripts/team-snapshot.ts +237 -0
  388. package/.versions/2.0.5/scripts/team-up.ts +406 -0
  389. package/.versions/2.0.5/scripts/workflows/lib/agent-phase.ts +133 -0
  390. package/.versions/2.0.5/scripts/workflows/lib/changes.ts +61 -0
  391. package/.versions/2.0.5/scripts/workflows/lib/debate.ts +149 -0
  392. package/.versions/2.0.5/scripts/workflows/lib/env.ts +34 -0
  393. package/.versions/2.0.5/scripts/workflows/lib/envelopes.ts +169 -0
  394. package/.versions/2.0.5/scripts/workflows/lib/gates.ts +81 -0
  395. package/.versions/2.0.5/scripts/workflows/lib/git.ts +96 -0
  396. package/.versions/2.0.5/scripts/workflows/lib/merge.ts +95 -0
  397. package/.versions/2.0.5/scripts/workflows/lib/model-profile.ts +22 -0
  398. package/.versions/2.0.5/scripts/workflows/lib/model-visibility.ts +92 -0
  399. package/.versions/2.0.5/scripts/workflows/lib/permissions.ts +130 -0
  400. package/.versions/2.0.5/scripts/workflows/lib/personas.ts +57 -0
  401. package/.versions/2.0.5/scripts/workflows/lib/poll.ts +86 -0
  402. package/.versions/2.0.5/scripts/workflows/lib/quality.ts +64 -0
  403. package/.versions/2.0.5/scripts/workflows/lib/run.ts +108 -0
  404. package/.versions/2.0.5/scripts/workflows/lib/trace.ts +34 -0
  405. package/.versions/2.0.5/scripts/workflows/lib/voices.ts +128 -0
  406. package/.versions/2.0.5/scripts/workflows/lib/writer-lease.ts +112 -0
  407. package/.versions/2.0.5/scripts/workflows/tsconfig.json +22 -0
  408. package/.versions/2.0.5/scripts/workflows/wf-build-test.ts +61 -0
  409. package/.versions/2.0.5/scripts/workflows/wf-debate.ts +87 -0
  410. package/.versions/2.0.5/scripts/workflows/wf-document.ts +50 -0
  411. package/.versions/2.0.5/scripts/workflows/wf-poll.ts +95 -0
  412. package/.versions/2.0.5/scripts/workflows/wf-quality.ts +20 -0
  413. package/.versions/2.0.5/scripts/workflows/wf-scout.ts +38 -0
  414. package/.versions/2.0.5/skills/_internal/grilling.md +59 -0
  415. package/.versions/2.0.5/skills/browser-testing-with-devtools/SKILL.md +351 -0
  416. package/.versions/2.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  417. package/.versions/2.0.5/skills/compound-learning/SKILL.md +137 -0
  418. package/.versions/2.0.5/skills/context-engineering/SKILL.md +291 -0
  419. package/.versions/2.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  420. package/.versions/2.0.5/skills/designing-agents/SKILL.md +394 -0
  421. package/.versions/2.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  422. package/.versions/2.0.5/skills/drafting-workflows/SKILL.md +143 -0
  423. package/.versions/2.0.5/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  424. package/.versions/2.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  425. package/.versions/2.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  426. package/.versions/2.0.5/skills/idea-refine/SKILL.md +182 -0
  427. package/.versions/2.0.5/skills/idea-refine/examples.md +238 -0
  428. package/.versions/2.0.5/skills/idea-refine/frameworks.md +99 -0
  429. package/.versions/2.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  430. package/.versions/2.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  431. package/.versions/2.0.5/skills/incremental-implementation/SKILL.md +298 -0
  432. package/.versions/2.0.5/skills/interview-me/SKILL.md +226 -0
  433. package/.versions/2.0.5/skills/orchestration-verification/SKILL.md +181 -0
  434. package/.versions/2.0.5/skills/peer-coms/SKILL.md +90 -0
  435. package/.versions/2.0.5/skills/performance-optimization/SKILL.md +350 -0
  436. package/.versions/2.0.5/skills/planning-and-task-breakdown/SKILL.md +265 -0
  437. package/.versions/2.0.5/skills/security-and-hardening/SKILL.md +461 -0
  438. package/.versions/2.0.5/skills/spec-driven-development/SKILL.md +256 -0
  439. package/.versions/2.0.5/skills/using-agent-skills/SKILL.md +197 -0
  440. package/.versions/2.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  441. package/.versions/2.0.5/vendor/agent-skills-upstream/README.md +11 -0
  442. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  443. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  444. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  445. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  446. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  447. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  448. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  449. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  450. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  451. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  452. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  453. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  454. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  455. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  456. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  457. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  458. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  459. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  460. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  461. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  462. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  463. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  464. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  465. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  466. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  467. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  468. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  469. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  470. package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  471. package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
  472. package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
  473. package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
  474. package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
  475. package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
  476. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  477. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  478. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  479. package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
  480. package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
  481. package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
  482. package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
  483. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  484. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  485. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  486. package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  487. package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  488. package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  489. package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  490. package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  491. package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  492. package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
  493. package/.versions/2.0.6/.pi/extensions/package.json +9 -0
  494. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
  495. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  496. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  497. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  498. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  499. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  500. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  501. package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
  502. package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  503. package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  504. package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
  505. package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  506. package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  507. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  508. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  509. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  510. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  511. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  512. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  513. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  514. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  515. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  516. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  517. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  518. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  519. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  520. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  521. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  522. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  523. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  524. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  525. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  526. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  527. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  528. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  529. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  530. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  531. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  532. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  533. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  534. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  535. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  536. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  537. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  538. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  539. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  540. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  541. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  542. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  543. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  544. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  545. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  546. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
  547. package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  548. package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
  549. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  550. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  551. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  552. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  553. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  554. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  555. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  556. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  557. package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  558. package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  559. package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  560. package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  561. package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  562. package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  563. package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
  564. package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
  565. package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  566. package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
  567. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  568. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  569. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  570. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  571. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  572. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  573. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  574. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  575. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  576. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  577. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  578. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  579. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  580. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  581. package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  582. package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  583. package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  584. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  585. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  586. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  587. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  588. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  589. package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  590. package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
  591. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  592. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  593. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  594. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  595. package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  596. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  597. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  598. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  599. package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  600. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
  601. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
  602. package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
  603. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
  604. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  605. package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  606. package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  607. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
  608. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
  609. package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
  610. package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
  611. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  612. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  613. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  614. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  615. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  616. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  617. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  618. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  619. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  620. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  621. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  622. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  623. package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
  624. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  625. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  626. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  627. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  628. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  629. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  630. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  631. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  632. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  633. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  634. package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
  635. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  636. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  637. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
  638. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
  639. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  640. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  641. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  642. package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
  643. package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
  644. package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
  645. package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
  646. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
  647. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  648. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  649. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
  650. package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
  651. package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
  652. package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  653. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  654. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  655. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
  656. package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
  657. package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  658. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  659. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  660. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  661. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  662. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  663. package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  664. package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  665. package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
  666. package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  667. package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
  668. package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  669. package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
  670. package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
  671. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  672. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  673. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  674. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  675. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  676. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  677. package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
  678. package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
  679. package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
  680. package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
  681. package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
  682. package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
  683. package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
  684. package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  685. package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  686. package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
  687. package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
  688. package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
  689. package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
  690. package/.versions/2.0.6/.version +1 -0
  691. package/.versions/2.0.6/agents/architect.md +25 -0
  692. package/.versions/2.0.6/agents/bowser.md +28 -0
  693. package/.versions/2.0.6/agents/builder.md +56 -0
  694. package/.versions/2.0.6/agents/code-reviewer.md +210 -0
  695. package/.versions/2.0.6/agents/deep-researcher.md +33 -0
  696. package/.versions/2.0.6/agents/documenter.md +23 -0
  697. package/.versions/2.0.6/agents/orchestrator.md +23 -0
  698. package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
  699. package/.versions/2.0.6/agents/planner.md +106 -0
  700. package/.versions/2.0.6/agents/releaser.md +25 -0
  701. package/.versions/2.0.6/agents/researcher.md +31 -0
  702. package/.versions/2.0.6/agents/security-auditor.md +168 -0
  703. package/.versions/2.0.6/agents/test-engineer.md +154 -0
  704. package/.versions/2.0.6/agents/web-debugger.md +44 -0
  705. package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
  706. package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
  707. package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
  708. package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
  709. package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
  710. package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
  711. package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
  712. package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
  713. package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
  714. package/.versions/2.0.6/docs/getting-started.md +126 -0
  715. package/.versions/2.0.6/docs/npm-install.md +301 -0
  716. package/.versions/2.0.6/docs/pi-extensions.md +446 -0
  717. package/.versions/2.0.6/docs/pi-setup.md +76 -0
  718. package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
  719. package/.versions/2.0.6/hermes/README.md +347 -0
  720. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  721. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  722. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  723. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  724. package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
  725. package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
  726. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  727. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  728. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  729. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  730. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  731. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  732. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  733. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  734. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  735. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  736. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  737. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  738. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  739. package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  740. package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  741. package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
  742. package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
  743. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  744. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  745. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  746. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  747. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  748. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  749. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  750. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  751. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  752. package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
  753. package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
  754. package/.versions/2.0.6/install-manifest.json +2924 -0
  755. package/.versions/2.0.6/justfile +247 -0
  756. package/.versions/2.0.6/manifest-meta.json +976 -0
  757. package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
  758. package/.versions/2.0.6/references/communication-contract.md +26 -0
  759. package/.versions/2.0.6/references/definition-of-done.md +67 -0
  760. package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
  761. package/.versions/2.0.6/references/observability-checklist.md +91 -0
  762. package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
  763. package/.versions/2.0.6/references/performance-checklist.md +153 -0
  764. package/.versions/2.0.6/references/prompting-patterns.md +380 -0
  765. package/.versions/2.0.6/references/security-checklist.md +179 -0
  766. package/.versions/2.0.6/references/testing-patterns.md +236 -0
  767. package/.versions/2.0.6/references/workflow-authoring.md +304 -0
  768. package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
  769. package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
  770. package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
  771. package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
  772. package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
  773. package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
  774. package/.versions/2.0.6/scripts/fleet.ts +216 -0
  775. package/.versions/2.0.6/scripts/flow.ts +137 -0
  776. package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  777. package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
  778. package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
  779. package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
  780. package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
  781. package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
  782. package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  783. package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
  784. package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
  785. package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
  786. package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
  787. package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
  788. package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
  789. package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
  790. package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
  791. package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  792. package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
  793. package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  794. package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  795. package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  796. package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  797. package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  798. package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
  799. package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
  800. package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
  801. package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
  802. package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
  803. package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
  804. package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
  805. package/.versions/2.0.6/scripts/package-lock.json +35 -0
  806. package/.versions/2.0.6/scripts/package.json +9 -0
  807. package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
  808. package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
  809. package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
  810. package/.versions/2.0.6/scripts/team-up.ts +378 -0
  811. package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
  812. package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
  813. package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
  814. package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
  815. package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
  816. package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
  817. package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
  818. package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
  819. package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
  820. package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
  821. package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
  822. package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
  823. package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
  824. package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
  825. package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
  826. package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
  827. package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
  828. package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
  829. package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
  830. package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
  831. package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
  832. package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
  833. package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
  834. package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
  835. package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
  836. package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
  837. package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
  838. package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  839. package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
  840. package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
  841. package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  842. package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
  843. package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  844. package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
  845. package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  846. package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  847. package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  848. package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
  849. package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
  850. package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
  851. package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  852. package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  853. package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
  854. package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
  855. package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
  856. package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
  857. package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
  858. package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
  859. package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
  860. package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
  861. package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
  862. package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  863. package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
  864. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  865. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  866. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  867. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  868. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  869. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  870. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  871. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  872. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  873. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  874. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  875. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  876. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  877. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  878. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  879. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  880. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  881. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  882. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  883. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  884. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  885. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  886. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  887. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  888. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  889. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  890. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  891. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  892. package/CHANGELOG.md +29 -0
  893. package/README.md +13 -15
  894. package/agents/builder.md +2 -2
  895. package/agents/documenter.md +2 -1
  896. package/agents/planner.md +2 -1
  897. package/agents/releaser.md +2 -2
  898. package/bin/catalog/harness-runtime-closure.json +1 -6
  899. package/bin/lib/desired.js +2 -2
  900. package/bin/lib/features.js +8 -1
  901. package/bin/snapshot-version.js +1 -2
  902. package/codex/fleet-session-client/SKILL.md +34 -0
  903. package/codex/fleet-session-client.zip +0 -0
  904. package/docs/ARCHITECTURE.md +4 -4
  905. package/docs/MIGRATION-agent-fleet.md +2 -2
  906. package/docs/agent-fleet-setup.md +28 -14
  907. package/docs/assets/branding/README.md +33 -0
  908. package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
  909. package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
  910. package/docs/codex-session-bridge.md +219 -0
  911. package/docs/coms-hermes-bridge.md +4 -5
  912. package/docs/getting-started.md +2 -0
  913. package/docs/npm-install.md +3 -1
  914. package/docs/pi-extensions.md +3 -4
  915. package/docs/pi-setup.md +2 -0
  916. package/hermes/README.md +1 -1
  917. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
  918. package/install-manifest.json +54 -72
  919. package/justfile +0 -42
  920. package/manifest-meta.json +50 -43
  921. package/package.json +10 -7
  922. package/scripts/coms-cli.ts +2 -61
  923. package/scripts/fleet-codex-client.ts +69 -0
  924. package/scripts/fleet-codex-read.py +146 -0
  925. package/scripts/fleet.ts +0 -6
  926. package/scripts/lib/fleet-codex-catalog.ts +63 -0
  927. package/scripts/lib/fleet-codex-operations.ts +190 -0
  928. package/scripts/lib/fleet-codex-session.ts +166 -0
  929. package/scripts/lib/fleet-codex-transport.ts +124 -0
  930. package/scripts/lib/fleet-command.ts +5 -23
  931. package/scripts/lib/team-project.ts +15 -50
  932. package/scripts/team-up.ts +6 -34
  933. /package/{codex → .versions/2.0.5/codex}/CONDUCTOR.md +0 -0
  934. /package/{docs → .versions/2.0.5/docs}/codex-remote-conductor.md +0 -0
  935. /package/{scripts → .versions/2.0.5/scripts}/codex-conductor.ts +0 -0
  936. /package/{scripts → .versions/2.0.5/scripts}/codex-remote-control.ts +0 -0
  937. /package/{scripts → .versions/2.0.5/scripts}/lib/codex-conductor.ts +0 -0
  938. /package/{scripts → .versions/2.0.5/scripts}/lib/codex-remote-control.ts +0 -0
  939. /package/{systemd → .versions/2.0.5/systemd}/user/agent-fleet-codex-remote-control.service.in +0 -0
@@ -0,0 +1,133 @@
1
+ # Claude Code as a coms peer — the bridge
2
+
3
+ Makes an interactive Claude Code (terminal CLI) a **first-class, bidirectional peer** in
4
+ the local coms pool: pi agents reach it with plain `coms_send`/`coms_await`, and Claude
5
+ Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
6
+ [herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
7
+ socket API).
8
+
9
+ > **This is the only role Claude Code has in Agent Fleet.** It is not a coding-agent
10
+ > install target: deterministic `agent-fleet setup` targets pi and nothing else, there are no
11
+ > `.claude/` skills, commands, or personas, and no Claude Code plugin. What a bridged
12
+ > pane gets is what this page describes — the `peer-coms` skill and the Stop hook,
13
+ > both installed under the pi agent because the *fleet* is what needs them. A Claude
14
+ > Code peer contributes review, research, and analysis turns over coms; it does not run
15
+ > the lifecycle commands or orchestrate anything.
16
+
17
+ ```
18
+ pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
19
+ pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
20
+ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (outbound asks)
21
+ ```
22
+
23
+ ## Pieces
24
+
25
+ | Piece | File | Role |
26
+ |---|---|---|
27
+ | Bridge daemon | `scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
28
+ | Envelope CLI | `scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
29
+ | Stop hook | `hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
30
+ | Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
31
+ | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
32
+
33
+ ## Setup
34
+
35
+ The stable `claude-bridge` setup feature selects `peer-coms` and its
36
+ `coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
37
+ claude-bridge --yes` (or select it interactively); it puts both halves in place:
38
+ `.pi/skills/peer-coms/` and `.claude/hooks/coms-stop-hook.mjs`. The hook file lands under
39
+ `.claude/` deliberately — that is where the Claude Code process in the pane looks for it.
40
+
41
+ **Registering the hook stays a manual step.** The installer writes the file; it does not
42
+ touch `.claude/settings.json`, because that file is the user's own Claude Code
43
+ configuration and merging into it is not something a pi install should decide.
44
+
45
+ 1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
46
+
47
+ ```json
48
+ {
49
+ "hooks": {
50
+ "Stop": [{ "hooks": [{ "type": "command",
51
+ "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
52
+ }
53
+ }
54
+ ```
55
+
56
+ Without the hook the bridge falls back to asking Claude for a
57
+ `<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
58
+ carry TUI noise (tool-status lines). The hook returns exact text.
59
+
60
+ 2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
61
+ use `coms-cli`. Point Claude Code at it the way you normally load project skills —
62
+ a `CLAUDE.md` reference to `.pi/skills/peer-coms/SKILL.md` is enough.
63
+
64
+ 3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
65
+ `just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
66
+
67
+ ```bash
68
+ node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
69
+ # (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
70
+ ```
71
+
72
+ ## Demo scenario (verified live)
73
+
74
+ ```bash
75
+ just fleet team docs --no-hub # Pi peers up
76
+ # pane with: bridge (claude-main) + claude
77
+ just fleet hub # in another pane: the orchestrator
78
+ # from the hub (or any shell):
79
+ node --experimental-strip-types scripts/coms-cli.ts send claude-main \
80
+ "Summarize the failing test output in artifacts/test.log" --await --timeout 300000
81
+ ```
82
+
83
+ And the reverse — Claude Code, mid-task, asking a pi peer:
84
+
85
+ ```bash
86
+ node --experimental-strip-types scripts/coms-cli.ts send researcher \
87
+ "Where is the retry logic for webhooks? file:line" --await --timeout 300000
88
+ ```
89
+
90
+ ## Serving team dispatches (coms-backed dispatch)
91
+
92
+ A bridge peer that shares a name with an agent-hub team member (e.g. `code-reviewer`,
93
+ `plan-reviewer` in the shipped `peers.yaml`) can serve that member's `dispatch_agent`
94
+ calls transparently: `.pi/agents/dispatch-policy.yaml` marks the member `prefer: coms`,
95
+ and the hub routes the dispatch to the live peer instead of spawning a native subagent —
96
+ same return contract, ASK_USER handling, and history. The standing Claude session keeps
97
+ its context across review rounds, which is the point for code/plan review. See
98
+ "Coms-backed dispatch" in `.pi/harnesses/agent-hub/README.md`.
99
+
100
+ ## Migrating legacy CLI spools
101
+
102
+ Current releases isolate CLI queues by project at:
103
+
104
+ ```text
105
+ ~/.pi/coms/cli/projects/<project>/<name>/
106
+ ```
107
+
108
+ Older releases used the ambiguous name-only path `~/.pi/coms/cli/<name>/`. If that legacy directory exists, `send`, `await`, `reply`, and listener operations fail closed rather than assigning queued messages to whichever project runs first. Before upgrading, stop commands using that CLI identity, inspect its `pending`, `responses`, and `inbound` files, determine the owning project, and move the complete `<name>` directory to `cli/projects/<project>/<name>`. Do not merge two queues or delete pending data merely to clear the error. The name `projects` is reserved for the namespace and cannot be used as a coms identity.
109
+
110
+ ## Behavior notes
111
+
112
+ - **Executable preflight:** a standalone `fleet peer` requires `claude --version`
113
+ to succeed before it creates a pane, so a missing CLI or partial npm install
114
+ fails directly instead of surfacing as a 45-second registration timeout. Team
115
+ layouts and direct `_claude-peer` calls repeat the check inside each created
116
+ pane before starting its bridge; their failure remains visible in that pane.
117
+ - **Serialization:** one prompt at a time per pane; queue depth shows in the peer's
118
+ agent card and the herdr sidebar (`q<depth>`).
119
+ - **Presence:** the bridge annotates its pane through the shared `HerdrPresence`
120
+ (same dialect negotiation as pi peers — `tokens` on herdr >= 0.7.4, one latched
121
+ fallback to `custom_status`), so the pane carries `coms`/`proj` and the fleet panel
122
+ can join it to the registry entry. It writes the annotation ONLY, never
123
+ `pane.report_agent`: the pane's `agent_status` is herdr's own Claude detection and
124
+ the bridge polls it back as its turn-completion signal.
125
+ - **Blocked panes:** a Claude waiting on a permission prompt returns a readable error
126
+ envelope ("blocked on a permission prompt — a human must approve it") instead of
127
+ hanging until timeout.
128
+ - **Busy panes:** a prompt arriving while Claude is mid-turn errors immediately
129
+ ("mid-turn — try again shortly") rather than typing into a running turn.
130
+ - **Restarts:** the bridge is bound to the pane id, not the Claude process — restart
131
+ Claude in the pane and the bridge keeps working.
132
+ - **Fleet safety:** the bridge and skill never create or close panes; herdr driving
133
+ stays with the orchestrator (see `.pi/damage-control-rules.yaml`).
@@ -0,0 +1,189 @@
1
+ # coms Hermes bridge
2
+
3
+ > The optional `hub-watchdog` is not this bridge and is not a coms conductor. It has no
4
+ > Herdr, shell, direct-tool, peer-delegation, service, or gateway authority. `hermes send --to`
5
+ > is an explicit destination mechanism, never origin-route evidence. Gate O has no checked-in
6
+ > live proof, so the supported watchdog posture is journal-only/dormant: no delivery,
7
+ > steering, cancellation, or recovery. It must not send an out-of-turn update, wake a chat, or
8
+ > fall back to another route. See [the watchdog runbook](hermes-watchdog-supervisor.md).
9
+
10
+
11
+ Protocol contract for the Hermes ⇄ pi `coms` bridge. The first implemented daemon is `scripts/coms-hermes-bridge.ts`, which registers a `user-remote` peer and turns coms prompt envelopes into Hermes/Telegram questions.
12
+
13
+ ## Pieces
14
+
15
+ | Piece | Role |
16
+ | --- | --- |
17
+ | `scripts/coms-hermes-bridge.ts` | Daemon peer, default name `user-remote`, purpose `Remote human via Hermes/Telegram`. Accepts prompt, cancel, and ping envelopes. |
18
+ | `scripts/lib/hermes-bridge-core.ts` | Pure contract logic: qid validation, Telegram formatting, answer-file validation, answer mapping, timeout outcome, state transitions, and log records. |
19
+ | `scripts/lib/coms-envelope.ts` | Shared non-pi envelope wire shapes, including additive `cancel` envelopes. |
20
+ | `~/.pi/coms/hermes-bridge/questions/` | Private answer-file wire written by the Hermes gateway/liaison. |
21
+ | `~/.pi/coms/hermes-bridge/log.ndjson` | Bridge observability log. |
22
+
23
+ ## user-remote topology
24
+
25
+ 1. A pi peer sends a coms `prompt` envelope to `user-remote`.
26
+ 2. The bridge derives `qid` from `prompt.msg_id`, formats the question, and runs `hermes send --to <target> <message>` (`<target>` defaults to `telegram`). For a topic, copy the target accepted by `hermes send --list telegram`; depending on the Hermes output format, its `id` may already contain the `:<thread_id>` suffix, so do not append the thread twice.
27
+ 3. The human replies in Telegram; the Hermes gateway/liaison writes the answer file.
28
+ 4. The bridge polls the questions directory, validates the file, maps the answer, sends a coms `response` envelope, and removes the answer file.
29
+
30
+ ## Protocol contract v1
31
+
32
+ ### qid and correlation
33
+
34
+ `qid` is exactly the prompt envelope's `msg_id`. It must match the 26-character Crockford ULID regex `^[0-9A-HJKMNP-TV-Z]{26}$`. The same `qid` is the only correlation key across coms, Telegram, answer files, state, and logs.
35
+
36
+ ### Telegram question format
37
+
38
+ `formatTelegramQuestion` emits UTF-16 text capped at 4096 code units:
39
+
40
+ ```text
41
+ ❓ [HUB-Q:<qid>] <question>
42
+
43
+ 📁 Project: <coms-project>
44
+
45
+ Context: <context, truncated if needed>
46
+
47
+ Options:
48
+ 1. <title> — <description>
49
+ ...
50
+
51
+ ↩ Reply to this message, or type: HUB-Q:<qid>: <answer>
52
+ ```
53
+
54
+ `Project:` is always present and comes from the bridge's validated `--project` scope, making simultaneous questions from different pools distinguishable. `Context:` is omitted when absent. `Options:` is omitted when no options are supplied. Context receives the remaining budget after the header, project, options, and reply instruction.
55
+
56
+ ### Answer-file path, schema, and validation
57
+
58
+ The private wire path is:
59
+
60
+ ```text
61
+ ~/.pi/coms/hermes-bridge/questions/<qid>.answer.json
62
+ ```
63
+
64
+ Schema:
65
+
66
+ ```json
67
+ {
68
+ "qid": "<26-character Crockford ULID>",
69
+ "answer": "<text>",
70
+ "answered_by": "telegram:<user>",
71
+ "at": "<ISO timestamp>"
72
+ }
73
+ ```
74
+
75
+ Validation rejects and ignores files unless all conditions hold: filename ends in `.answer.json`; filename qid is valid; filename qid is currently pending; JSON parses; object fields match the schema; `at` parses as a timestamp; and body `qid` equals the filename qid. Rejection reasons are `invalid_path`, `invalid_qid`, `foreign_qid`, `invalid_json`, `invalid_schema`, and `qid_mismatch`; the daemon logs rejected files as `answer_rejected` and removes them. Exception: an `invalid_json` file is treated as a possible partial write and left in place for a short grace window (`max(2 × poll interval, 1s)` from first sighting); it is rejected and removed only if it still fails to parse after the grace expires.
76
+
77
+ ### Answer mapping
78
+
79
+ If options exist and the trimmed answer is a 1-based number for an option, the response is `{ "kind": "selection", "selections": ["<option title>"] }`. If options exist and the trimmed answer case-insensitively equals an option title, it maps to the same selection shape. All other answers map to `{ "kind": "freeform", "text": "<trimmed answer>" }`.
80
+
81
+ ### Cancel semantics
82
+
83
+ `cancel` is an additive coms envelope with shape `{ "type": "cancel", "msg_id", "from", "to", "created_at", "ref_msg_id" }`; `ref_msg_id` is the target `qid`. The bridge acks well-formed cancel envelopes before handling them.
84
+
85
+ For a pending qid, cancel clears the timeout, removes the pending question, records terminal state `cancelled`, appends a `cancelled` log event, and sends a Telegram note: `✖ [HUB-Q:<qid>] The question was cancelled — it was answered from the console.` Cancel for a non-pending or invalid qid is a no-op after the envelope ack. A later answer file for a closed qid is treated as `late_answer`: logged, removed, and answered in Telegram with a polite ignored note; no response envelope is sent.
86
+
87
+ **Cancellation is local wait abandonment.** Cancelling a coms-backed run ends only this side's wait. The remote peer is not signalled and may keep working, so a `cancelled` state here is a statement about the local wait, never about the remote task. It follows that watchdog auto-recovery is forbidden for coms runs: no automatic retry, re-dispatch, retarget, or recovery invoke may follow a coms cancellation, and a cancelled coms run is never a recovery target. An explicit `hermes send --to <destination>` remains a destination-only mechanism chosen by a human; it is not evidence of an origin route and must not be used to "reply" to a cancelled run.
88
+
89
+ ### Timeouts
90
+
91
+ The per-question remote timeout defaults to `PI_COMS_TIMEOUT_MS`, or `1800000` ms when unset/invalid; `--timeout <ms>` overrides it. On timeout, the bridge removes the pending question, records terminal state `timeout`, logs `timeout`, sends the Telegram note `⌛ [HUB-Q:<qid>] The question timed out after <ms>ms.`, and sends an error response envelope with error `no remote answer within <ms>ms` and `response: null`.
92
+
93
+ ### States
94
+
95
+ Question states are in-memory per qid: `pending`, `delivered`, `answered`, `cancelled`, and `timeout`. Implemented transitions are: `null + question_received → pending`; `pending + delivered → delivered`; `pending + delivery_error → null`; `pending|delivered + answered → answered` (the daemon currently answers from delivered or pending if the file arrives quickly); `pending|delivered + cancelled → cancelled`; `pending|delivered + timeout → timeout`; and terminal `answered|cancelled|timeout + late_answer` remains terminal.
96
+
97
+ ### ndjson logging
98
+
99
+ The bridge appends one JSON object per line to `~/.pi/coms/hermes-bridge/log.ndjson`. Core log records have shape `{ "at": "<ISO>", "qid": "<qid>", "event": "<event>", "detail"?: <value> }`. Contract events are `question_received`, `delivered`, `delivery_error`, `answered`, `cancelled`, `timeout`, and `late_answer`; the daemon also writes `answer_rejected` for invalid answer files. Ping agent cards report `queue_depth` as the current number of pending questions.
100
+
101
+ ## Hermes as conductor
102
+
103
+ Hermes can also act as the conductor without this daemon: use `coms-cli list` to discover peers and `coms-cli send --await --timeout <ms>` to delegate to hub-team pi peers, then synthesize the results for the human. This conductor topology uses the existing coms CLI as the bridge; no standing Hermes peer is required.
104
+
105
+ Launch a visible conductor workspace with:
106
+
107
+ ```bash
108
+ just fleet conductor hermes docs # live conductor + team workspace
109
+ just fleet conductor hermes docs --dry-run # preview; no Herdr calls
110
+ ```
111
+
112
+ The live recipe reuses `scripts/team-up.ts --conductor`: it creates a normal herdr workspace labeled `<worktree-tag>-conductor-<team>` (the tag is the last dot-segment of the checkout's basename, so the same team from a different worktree gets its own workspace), places a `conductor` pane running `hermes -p dev`, and tiles the chosen team beside it. Team peers keep their normal coms harness and herdr presence reporting, so they continue to show agent state in the sidebar; Hermes' own herdr-agent-state plugin is responsible for the conductor pane's state.
113
+
114
+ ### Telegram bridge control command
115
+
116
+ The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi uses the namespaced command:
117
+
118
+ ```text
119
+ /af-set-hermes-telegram status --profile default
120
+ /af-set-hermes-telegram install --profile default
121
+ /af-set-hermes-telegram install --profile default --force --restart
122
+ /af-set-hermes-telegram on 7883056502:1735 --profile default
123
+ /af-set-hermes-telegram off 7883056502:1735
124
+ ```
125
+
126
+ Claude Code exposes the unprefixed `/set-hermes-telegram`; the arguments and backend are identical. The deterministic CLI can also be called directly with `agent-fleet set-hermes-telegram ...`.
127
+
128
+ #### `status` and profile resolution
129
+
130
+ `status` is read-only. It verifies the Hermes executable/profile, compares the complete installed `hub-liaison` tree to the version packaged with Agent Fleet, asks Hermes whether the skill is enabled, checks `terminal` and `file` toolsets for the `telegram` platform, and reports gateway state. `--profile <name>` is recommended. Without it the controller selects a profile only when `hermes gateway list` reports exactly one running gateway; zero or multiple running gateways fail closed and require an explicit profile.
131
+
132
+ #### `install`
133
+
134
+ `install` writes to `<Hermes-profile-path>/skills/hub-liaison`, where the profile path comes from `hermes profile show <name>` (important because the `default` profile is normally `~/.hermes`, while named profiles normally live below `~/.hermes/profiles/`). Installation behavior is:
135
+
136
+ - missing skill: copied atomically from the packaged Agent Fleet source;
137
+ - byte-identical tree: no-op;
138
+ - differing tree: refused unless `--force` is explicit;
139
+ - forced replacement: the previous tree is moved first to `<profile>/backups/agent-fleet/hub-liaison-<timestamp>`;
140
+ - symlinks or unsupported filesystem entries in either skill tree are refused;
141
+ - the installed tree is fingerprinted again, then `hermes --profile <name> skills list --enabled-only` and `tools list --platform telegram` are run for verification.
142
+
143
+ The command does not silently broaden Telegram tool permissions. If `terminal` or `file` is disabled, it prints the explicit remediation:
144
+
145
+ ```bash
146
+ hermes --profile <name> tools enable --platform telegram terminal file
147
+ ```
148
+
149
+ If the skill itself is disabled, use `hermes --profile <name> skills config`. A running gateway is restarted only with explicit `--restart`; otherwise the command prints the required restart command. A stopped gateway is never started as a side effect. No install/status/on/off action sends a test Telegram message.
150
+
151
+ #### `on` and `off`
152
+
153
+ `on` fails before touching Herdr unless the selected gateway is running, `hub-liaison` is current and enabled, and both required Telegram toolsets are enabled. It then closes any existing pane labeled `hermes-bridge` in the current workspace, creates a new right-hand pane in that **same Herdr workspace**, labels it `hermes-bridge`, and starts the daemon with `telegram:<id>` as its exact target. The selected profile is forwarded as `--hermes-profile`, so every question, timeout, cancel, and late-answer send executes as `hermes --profile <name> send ...` rather than silently falling back to Hermes' sticky default. `off` remains available even when Hermes readiness is broken, closes the bridge pane, creates nothing, and is idempotent.
154
+
155
+ The Telegram destination must contain digits only (`<chat_id>`) or two digit groups separated by one colon (`<chat_id>:<topic_id>`). Values such as `telegram:123`, `123:`, `123:456:789`, spaces, signs, and letters are rejected. The controller infers the coms project independently from the current hub process's explicit `--project`, then `PI_COMS_PROJECT`, then `default`.
156
+
157
+ The manual equivalent is:
158
+
159
+ ```bash
160
+ node --experimental-strip-types scripts/coms-hermes-bridge.ts \
161
+ --project af \
162
+ --hermes-profile default \
163
+ --timeout 1800000 \
164
+ --to 'telegram:<chat_id>:<thread_id>'
165
+ just fleet team docs --project af
166
+ ```
167
+
168
+ Repeated value flags such as two `--to` arguments are rejected at startup rather than silently selecting one destination. The `ask-user-remote` wrapper resolves the explicit Pi `--project` flag when the tool executes, so non-default hubs discover `user-remote` in their own pool.
169
+
170
+ Hard boundary: the Hermes conductor must not run `herdr` commands, drive panes, create/kill workspaces, or manage fleet lifecycle. Herdr driving stays with the human/orchestrator so the damage-control model remains intact; see `.pi/damage-control-rules.yaml` for the authoritative no-herdr boundary. Hermes may only operate inside the project coms pool through the documented coms CLI commands.
171
+
172
+ ## Hermes and the experimental Codex conductor
173
+
174
+ Hermes/Telegram remains the **inbound** human `ask_user` complement to the
175
+ experimental Codex remote-control conductor. Codex is outbound-initiated,
176
+ approval-gated, and serialized; it is not an inbound question channel. The Codex user service and control-pane lifecycle are
177
+ separate from Hermes. See the [experimental Codex operator runbook](codex-remote-conductor.md).
178
+
179
+ Both conductor contracts are advisory outside Pi damage-control: Pi wraps Pi
180
+ tool calls, not Hermes or Codex, and neither has an OS command allowlist.
181
+ Human confirmation, approvals, and sandboxing reduce risk but do not
182
+ technically enforce either external contract.
183
+
184
+ ## Deferred
185
+
186
+ - Standing conductor peer for pi → Hermes inbound messages.
187
+ - Telegram-driven conductor profile.
188
+ - Group/multi-recipient questions and non-text answers.
189
+ - Kanban-driven orchestration on top of the same conductor contract.
@@ -0,0 +1,124 @@
1
+ # Getting started
2
+
3
+ Agent Fleet installs deterministic pi workspace content. The public lifecycle is
4
+ **setup**, **doctor**, and **uninstall**; no coding agent or model is required.
5
+
6
+ ## Install a new repository
7
+
8
+ From the target repository, run the package command. `just fleet` does not exist
9
+ yet — the managed justfile region is one of the things setup writes — so a first
10
+ install always goes through `npx`:
11
+
12
+ ```bash
13
+ cd ~/projects/my-app
14
+ npx @chankov/agent-fleet@latest setup
15
+ ```
16
+
17
+ In a real TTY that opens the installer: choose **Default** or **Full** plus
18
+ optional comma-separated features, read the exact plan, and confirm once. For
19
+ automation, name the selection and consent:
20
+
21
+ ```bash
22
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
23
+ ```
24
+
25
+ Choose **Default** for stable Fleet Core or **Full** for all stable,
26
+ platform-applicable catalogue roots. Default creates neither voice configuration
27
+ nor `.claude/`; Full may install the recorded Claude Code coms bridge. Features
28
+ are named additions after preset selection. In an Agent Fleet source checkout,
29
+ use `node bin/cli.js setup` instead.
30
+
31
+ Setup writes files but runs no commands, so finish the install with the npm
32
+ steps it deliberately skipped — the workspace is not launchable until they run:
33
+
34
+ ```bash
35
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
36
+ just fleet doctor # exit 0 = nothing to repair
37
+ ```
38
+
39
+ (Or pass `--allow-exec` to setup and let it run them in the same pass.)
40
+
41
+ `doctor` validates all three roots with `npm ls`. The launcher repeats that
42
+ read-only preflight before Pi starts and points back to `just fleet deps` or
43
+ `setup --allow-exec` instead of allowing a missing import to surface later as a
44
+ misleading unknown command-line option.
45
+
46
+ ## First session
47
+
48
+ ```bash
49
+ just fleet # Hub/operator; empty native roster
50
+ just fleet --agents default --project af # Hub/orchestrator + native roster
51
+ just fleet --agents default --peers docs --project af
52
+ # Hub + standing Herdr peers
53
+ ```
54
+
55
+ ## Run and maintain deterministic flows
56
+
57
+ When the workflow runtime is selected, `just flow` runs code-owned workflows outside the interactive hub:
58
+
59
+ ```bash
60
+ just flow scout "where is authentication configured?"
61
+ just flow quality
62
+ just flow build-test "add the validated endpoint"
63
+ ```
64
+
65
+ Each run creates a `flow/<name>-<runId>` branch. Use the numbered maintenance selector to remove an empty/integrated branch or squash-merge an accepted result back to the branch from which it started:
66
+
67
+ ```bash
68
+ just flow cleanup # list flow branches and prompt for a number
69
+ just flow cleanup 1 # safely remove selection 1 through Worktrunk
70
+ just flow merge # list flow branches and prompt for a number
71
+ just flow merge 2 # squash-merge selection 2 through Worktrunk
72
+ ```
73
+
74
+ Maintenance requires [Worktrunk](https://worktrunk.dev). It refuses dirty worktrees, rejected runs, and unknown merge targets. See [workflows.md](workflows.md#clean-up-and-merge-flow-branches) for `--discard`, `--target`, full branch selectors, non-interactive `--yes`, and safety details.
75
+
76
+ ## Update an existing install
77
+
78
+ A pi session tells you when a newer version is published. To act on it:
79
+
80
+ ```bash
81
+ just fleet setup --dry-run # preview: what changes, what gets overwritten
82
+ just fleet setup # apply; shows the plan and asks once
83
+ just fleet deps # if the plan skipped the npm steps
84
+ just fleet doctor
85
+ ```
86
+
87
+ Your preset and features are remembered in `.ai/agent-fleet.json`, so a plain
88
+ `setup` reconciles to the selection you already chose.
89
+
90
+ Two things to know before your first update:
91
+
92
+ - **`setup` reconciles toward the package.** A file you edited in place is
93
+ refreshed and your edit is overwritten — no prompt, no conflict. Customize
94
+ through `.ai/agent-fleet-overrides.md` instead, which the lifecycle never
95
+ touches.
96
+ - **A conflict stops the run.** If you *and* the new version changed the same
97
+ file, setup exits `3` having written nothing; re-run with `--on-conflict
98
+ theirs` or `--on-conflict ours`.
99
+
100
+ `pi update --extensions` updates pi's own extensions only — never this installer
101
+ or what it wrote. Full update reference, including what happens to every file
102
+ state: [npm-install.md](npm-install.md#updating-an-existing-install).
103
+
104
+ ## Uninstall
105
+
106
+ `just fleet uninstall --yes` is for the self-hosted workspace lifecycle; it
107
+ removes the launcher last. Reinstall after that with the package CLI, not `just`:
108
+
109
+ ```bash
110
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
111
+ ```
112
+
113
+ ## Pi package-native skills and prompts
114
+
115
+ For pi package-native skills/prompts instead of copied ones:
116
+
117
+ ```bash
118
+ pi install -l npm:@chankov/agent-fleet
119
+ ```
120
+
121
+ Do not mix copied and package-native skills/prompts. `doctor` identifies that
122
+ ownership overlap. Read [pi-setup.md](pi-setup.md) for runtime composition,
123
+ [agent-fleet-setup.md](agent-fleet-setup.md) for project configuration, and
124
+ [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md) for the major-release matrix.