@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,134 @@
1
+ """Source A — which Agent Fleet sessions exist, and in which project.
2
+
3
+ Reads `~/.pi/coms/projects/<project>/agents/<name>.json` directly. The
4
+ directory IS the project: that is exactly the scope `team-up --project X`
5
+ creates, so grouping by it needs no extra bookkeeping.
6
+
7
+ Deliberately NOT going through `coms-cli list`: that CLI wants `--project` and
8
+ `--name`, answers for one project only, and excludes the caller — the opposite
9
+ of "every project". The price is a dependency on someone else's on-disk shape;
10
+ `SUPPORTED_VERSION` below is the tripwire for when it changes.
11
+
12
+ Read-only by construction. `pruneDeadEntries()` in scripts/lib/coms-envelope.ts
13
+ deletes dead records; we copy only its liveness CRITERION. A visualisation
14
+ plugin that races the real coms writer over file deletion is the wrong shape.
15
+ """
16
+
17
+ import json
18
+ import os
19
+ from datetime import datetime, timezone
20
+ from pathlib import Path
21
+
22
+ # Mirrors REGISTRY_HEARTBEAT_FRESH_MS in scripts/lib/coms-envelope.ts:25, and
23
+ # the -5s clock-skew tolerance of registryHeartbeatIsFresh().
24
+ HEARTBEAT_FRESH_MS = 90_000
25
+ HEARTBEAT_SKEW_MS = 5_000
26
+
27
+ # `version` in the registry record. A record from a coms that bumped the schema
28
+ # is reported as unavailable rather than silently mis-parsed — a wrong panel is
29
+ # worse than an honest one that says it cannot read the registry.
30
+ SUPPORTED_VERSION = 1
31
+
32
+
33
+ class RegistryUnavailable(Exception):
34
+ """The coms registry cannot be read or is written in a schema we don't know."""
35
+
36
+
37
+ def default_projects_root() -> Path:
38
+ return Path.home() / ".pi" / "coms" / "projects"
39
+
40
+
41
+ def parse_timestamp_ms(value) -> float | None:
42
+ """ISO-8601 (the `Z` form coms writes) to epoch milliseconds."""
43
+ if not isinstance(value, str) or not value:
44
+ return None
45
+ try:
46
+ parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
47
+ except ValueError:
48
+ return None
49
+ if parsed.tzinfo is None:
50
+ parsed = parsed.replace(tzinfo=timezone.utc)
51
+ return parsed.timestamp() * 1000
52
+
53
+
54
+ def heartbeat_is_fresh(entry: dict, now_ms: float) -> bool:
55
+ heartbeat = parse_timestamp_ms(entry.get("heartbeat_at"))
56
+ if heartbeat is None:
57
+ return False
58
+ age = now_ms - heartbeat
59
+ return -HEARTBEAT_SKEW_MS <= age <= HEARTBEAT_FRESH_MS
60
+
61
+
62
+ def pid_is_alive(pid) -> bool:
63
+ """`kill(pid, 0)`: ESRCH means gone, EPERM means alive but not ours."""
64
+ if not isinstance(pid, int) or isinstance(pid, bool) or pid <= 0:
65
+ return False
66
+ try:
67
+ os.kill(pid, 0)
68
+ except ProcessLookupError:
69
+ return False
70
+ except PermissionError:
71
+ return True
72
+ except OSError:
73
+ return True
74
+ return True
75
+
76
+
77
+ def entry_is_live(entry: dict, now_ms: float, pid_probe=pid_is_alive) -> bool:
78
+ """A fresh heartbeat wins before the PID probe — Codex remote commands can
79
+ run in a different PID namespace, where the probe would answer nonsense."""
80
+ if heartbeat_is_fresh(entry, now_ms):
81
+ return True
82
+ return pid_probe(entry.get("pid"))
83
+
84
+
85
+ def _read_entry(path: Path) -> dict | None:
86
+ """One registry file, or None when it is not a usable record.
87
+
88
+ Unparseable or half-written files are skipped, not fatal: the writer is
89
+ another live process and we may catch it mid-write.
90
+ """
91
+ try:
92
+ entry = json.loads(path.read_text(encoding="utf-8"))
93
+ except (OSError, ValueError):
94
+ return None
95
+ if not isinstance(entry, dict) or not isinstance(entry.get("name"), str) or not entry["name"]:
96
+ return None
97
+ version = entry.get("version", SUPPORTED_VERSION)
98
+ if version != SUPPORTED_VERSION:
99
+ raise RegistryUnavailable(
100
+ f"coms registry record {path.name} declares schema version {version!r}, "
101
+ f"this plugin reads version {SUPPORTED_VERSION}"
102
+ )
103
+ return entry
104
+
105
+
106
+ def live_sessions_by_project(root: Path | None = None, now_ms: float | None = None, pid_probe=pid_is_alive) -> dict[str, list[dict]]:
107
+ """Every live coms session, keyed by project directory name.
108
+
109
+ Projects with no live session are omitted entirely: `~/.pi/coms/projects/`
110
+ accumulates dozens of historical scopes, and an empty group is noise.
111
+ """
112
+ root = Path(root) if root is not None else default_projects_root()
113
+ now_ms = now_ms if now_ms is not None else datetime.now(timezone.utc).timestamp() * 1000
114
+
115
+ try:
116
+ project_dirs = sorted(child for child in root.iterdir() if child.is_dir())
117
+ except OSError as error:
118
+ raise RegistryUnavailable(f"cannot read coms registry at {root}: {error}") from error
119
+
120
+ projects: dict[str, list[dict]] = {}
121
+ for project_dir in project_dirs:
122
+ agents_dir = project_dir / "agents"
123
+ try:
124
+ files = sorted(agents_dir.glob("*.json"))
125
+ except OSError:
126
+ continue
127
+ live = []
128
+ for path in files:
129
+ entry = _read_entry(path)
130
+ if entry is not None and entry_is_live(entry, now_ms, pid_probe):
131
+ live.append(entry)
132
+ if live:
133
+ projects[project_dir.name] = live
134
+ return projects
@@ -0,0 +1,350 @@
1
+ """The write half — hand a prompt to a live coms peer and keep its answer.
2
+
3
+ This is the one module in the plugin that is not read-only, so its boundaries
4
+ are drawn tightly:
5
+
6
+ - the renderer never names an ENDPOINT, only `(project, name)`. The socket
7
+ path is looked up here, from the registry, and never travels outward. A
8
+ renderer running with the full privileges of the app must not also be
9
+ holding write doors into other agents' processes.
10
+ - `project` and `name` are validated against the same character classes the
11
+ TS side enforces (coms-envelope.ts), before either touches a path.
12
+ - delivery is fire-and-forget. The peer answers on its own schedule — minutes,
13
+ for anything worth asking — so the HTTP request returns as soon as the
14
+ prompt is ACKed, and the answer arrives later on the reply socket opened for
15
+ it. A panel that polls every 3s must never hold a request open for minutes.
16
+
17
+ Wire format is coms-envelope.ts exactly: one JSON object per line over a unix
18
+ socket, answered with a single `ack`/`nack` line. Any drift here is a protocol
19
+ break, not a refactor.
20
+
21
+ State: replies live in memory, bounded and per-process. A gateway restart loses
22
+ the transcript — the agent's own pane has it, and this pane is a fleet view, not
23
+ a message store.
24
+ """
25
+
26
+ import json
27
+ import os
28
+ import re
29
+ import secrets
30
+ import socket
31
+ import threading
32
+ import time
33
+ from datetime import datetime, timezone
34
+ from pathlib import Path
35
+
36
+ import coms_registry
37
+
38
+ # Mirrors COMS_PROJECT_SAFE / COMS_NAME_SAFE in scripts/lib/coms-envelope.ts.
39
+ _PROJECT_SAFE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]*$")
40
+ _NAME_SAFE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$")
41
+
42
+ # Who the fleet sees this dispatch as. Deliberately not a registered peer: the
43
+ # panel is a window onto the pool, not a member of it, and registering would put
44
+ # it in everyone's `coms_list`.
45
+ SENDER_NAME = "hermes-panel"
46
+
47
+ # LINE_CAP_BYTES in coms-envelope.ts is 64 KiB for the WHOLE envelope; leave
48
+ # room for the ~600 bytes of framing around the prompt.
49
+ MAX_PROMPT_CHARS = 32_000
50
+
51
+ # How long a reply socket waits before giving up and cleaning itself up. Long
52
+ # turns are normal; an abandoned socket is not.
53
+ REPLY_TTL_S = 1800.0
54
+
55
+ # Most recent dispatches kept. Enough to cover a session's worth of asking,
56
+ # small enough that an idle gateway is not holding a transcript.
57
+ MAX_TRACKED = 50
58
+
59
+ _CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"
60
+
61
+
62
+ class ComsSendError(Exception):
63
+ """The prompt could not be handed over. Carries a human-readable reason."""
64
+
65
+
66
+ def now_iso() -> str:
67
+ return datetime.now(timezone.utc).isoformat(timespec="milliseconds").replace("+00:00", "Z")
68
+
69
+
70
+ def ulid() -> str:
71
+ """Port of ulid() in coms-envelope.ts — 10 chars of time, 16 of randomness."""
72
+ ms = int(time.time() * 1000)
73
+ time_part = ""
74
+ for _ in range(10):
75
+ time_part = _CROCKFORD[ms % 32] + time_part
76
+ ms //= 32
77
+ rand_part = "".join(secrets.choice(_CROCKFORD) for _ in range(16))
78
+ return (time_part + rand_part)[:26]
79
+
80
+
81
+ def validate_project(project: str) -> str:
82
+ if not isinstance(project, str) or ".." in project or "/" in project or "\\" in project:
83
+ raise ComsSendError(f"invalid project name: {project!r}")
84
+ if project in (".", "") or not _PROJECT_SAFE.match(project):
85
+ raise ComsSendError(f"invalid project name: {project!r}")
86
+ return project
87
+
88
+
89
+ def validate_name(name: str) -> str:
90
+ if not isinstance(name, str) or not _NAME_SAFE.match(name) or name == "projects":
91
+ raise ComsSendError(f"invalid coms name: {name!r}")
92
+ return name
93
+
94
+
95
+ def resolve_endpoint(project: str, name: str, root: Path | None = None) -> str:
96
+ """The peer's socket path — the only place this value is produced.
97
+
98
+ Re-reads the registry rather than trusting anything the caller passed: the
99
+ panel's snapshot is up to 3 seconds old, and a peer that died in that window
100
+ must fail here instead of having a prompt written into a stale path.
101
+ """
102
+ root = Path(root) if root is not None else coms_registry.default_projects_root()
103
+ path = root / project / "agents" / f"{name}.json"
104
+ try:
105
+ entry = json.loads(path.read_text(encoding="utf-8"))
106
+ except FileNotFoundError as error:
107
+ raise ComsSendError(f"no live peer {name!r} in project {project!r}") from error
108
+ except (OSError, ValueError) as error:
109
+ raise ComsSendError(f"cannot read the registry entry for {name!r}: {error}") from error
110
+
111
+ now_ms = datetime.now(timezone.utc).timestamp() * 1000
112
+ if not coms_registry.entry_is_live(entry, now_ms):
113
+ raise ComsSendError(f"peer {name!r} in project {project!r} is no longer live")
114
+
115
+ endpoint = entry.get("endpoint")
116
+ if not isinstance(endpoint, str) or not endpoint:
117
+ raise ComsSendError(f"peer {name!r} has no endpoint to write to")
118
+ return endpoint
119
+
120
+
121
+ def _read_line(sock: socket.socket, cap: int = 65_536) -> str:
122
+ chunks: list[bytes] = []
123
+ total = 0
124
+ while True:
125
+ chunk = sock.recv(4096)
126
+ if not chunk:
127
+ break
128
+ chunks.append(chunk)
129
+ total += len(chunk)
130
+ if b"\n" in chunk or total > cap:
131
+ break
132
+ return b"".join(chunks).split(b"\n", 1)[0].decode("utf-8", "replace")
133
+
134
+
135
+ def send_envelope(endpoint: str, envelope: dict, timeout: float = 5.0) -> dict:
136
+ """Write one envelope, read one ack/nack. Mirrors sendEnvelope()."""
137
+ sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
138
+ sock.settimeout(timeout)
139
+ try:
140
+ try:
141
+ sock.connect(endpoint)
142
+ except OSError as error:
143
+ raise ComsSendError(f"peer is not listening: {error}") from error
144
+ sock.sendall((json.dumps(envelope) + "\n").encode("utf-8"))
145
+ line = _read_line(sock)
146
+ except socket.timeout as error:
147
+ raise ComsSendError("peer did not acknowledge in time") from error
148
+ finally:
149
+ try:
150
+ sock.close()
151
+ except OSError:
152
+ pass
153
+
154
+ try:
155
+ parsed = json.loads(line)
156
+ except ValueError as error:
157
+ raise ComsSendError("peer answered with something that is not an envelope") from error
158
+ if isinstance(parsed, dict) and parsed.get("type") == "nack":
159
+ raise ComsSendError(str(parsed.get("error") or "peer refused the prompt"))
160
+ return parsed if isinstance(parsed, dict) else {}
161
+
162
+
163
+ class Dispatcher:
164
+ """Sends prompts and holds the answers that come back.
165
+
166
+ One reply socket per dispatch, closed as soon as its answer lands (or when
167
+ REPLY_TTL_S expires). A single shared socket would be tidier until two
168
+ prompts are outstanding and the answers have to be told apart by msg_id
169
+ alone — which is exactly when it matters that they cannot be confused.
170
+ """
171
+
172
+ def __init__(self, sockets_dir: Path | None = None, ttl_s: float = REPLY_TTL_S):
173
+ self._dir = Path(sockets_dir) if sockets_dir is not None else Path.home() / ".pi" / "coms" / "sockets"
174
+ self._ttl_s = ttl_s
175
+ self._lock = threading.Lock()
176
+ self._tracked: dict[str, dict] = {}
177
+
178
+ # ── the answer side ────────────────────────────────────────────────────
179
+
180
+ def _record(self, msg_id: str, **fields) -> None:
181
+ with self._lock:
182
+ entry = self._tracked.get(msg_id)
183
+ if entry is None:
184
+ return
185
+ entry.update(fields)
186
+
187
+ def _serve_reply(self, server: socket.socket, path: Path, msg_id: str) -> None:
188
+ """Accept at most one response for `msg_id`, then take the socket down."""
189
+ try:
190
+ server.settimeout(self._ttl_s)
191
+ while True:
192
+ try:
193
+ conn, _ = server.accept()
194
+ except socket.timeout:
195
+ self._record(msg_id, status="timeout", detail=f"no answer within {int(self._ttl_s)}s")
196
+ return
197
+ except OSError:
198
+ return
199
+ with conn:
200
+ conn.settimeout(5.0)
201
+ try:
202
+ line = _read_line(conn)
203
+ envelope = json.loads(line)
204
+ except (OSError, ValueError):
205
+ continue
206
+ if not isinstance(envelope, dict):
207
+ continue
208
+ kind = envelope.get("type")
209
+ # Peers ping an endpoint to check it is alive; that is not
210
+ # an answer and must not close the socket.
211
+ if kind == "ping":
212
+ self._ack(conn, envelope.get("msg_id") or "")
213
+ continue
214
+ if kind != "response" or envelope.get("msg_id") != msg_id:
215
+ continue
216
+ self._ack(conn, msg_id)
217
+ error = envelope.get("error")
218
+ self._record(
219
+ msg_id,
220
+ status="error" if error else "answered",
221
+ detail=str(error) if error else None,
222
+ response=_as_text(envelope.get("response")),
223
+ answered_at=now_iso(),
224
+ )
225
+ return
226
+ finally:
227
+ try:
228
+ server.close()
229
+ except OSError:
230
+ pass
231
+ try:
232
+ path.unlink()
233
+ except OSError:
234
+ pass
235
+
236
+ @staticmethod
237
+ def _ack(conn: socket.socket, msg_id: str) -> None:
238
+ try:
239
+ conn.sendall((json.dumps({"type": "ack", "msg_id": msg_id}) + "\n").encode("utf-8"))
240
+ except OSError:
241
+ pass
242
+
243
+ def _open_reply_socket(self, session_id: str) -> tuple[socket.socket, Path]:
244
+ self._dir.mkdir(parents=True, exist_ok=True)
245
+ path = self._dir / f"{session_id}.sock"
246
+ try:
247
+ path.unlink()
248
+ except OSError:
249
+ pass
250
+ server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
251
+ server.bind(str(path))
252
+ server.listen(4)
253
+ return server, path
254
+
255
+ # ── the ask side ───────────────────────────────────────────────────────
256
+
257
+ def dispatch(self, project: str, name: str, prompt: str, root: Path | None = None) -> dict:
258
+ project = validate_project(project)
259
+ name = validate_name(name)
260
+ if not isinstance(prompt, str) or not prompt.strip():
261
+ raise ComsSendError("a prompt is required")
262
+ if len(prompt) > MAX_PROMPT_CHARS:
263
+ raise ComsSendError(f"prompt is longer than {MAX_PROMPT_CHARS} characters")
264
+
265
+ endpoint = resolve_endpoint(project, name, root)
266
+ session_id = ulid()
267
+ server, reply_path = self._open_reply_socket(session_id)
268
+ envelope = {
269
+ "type": "prompt",
270
+ "msg_id": ulid(),
271
+ "sender_session": session_id,
272
+ "sender_endpoint": str(reply_path),
273
+ "hops": 0,
274
+ "timestamp": now_iso(),
275
+ "prompt": prompt,
276
+ "sender_name": SENDER_NAME,
277
+ "sender_cwd": os.getcwd(),
278
+ "conversation_id": None,
279
+ "response_schema": None,
280
+ }
281
+ msg_id = envelope["msg_id"]
282
+
283
+ with self._lock:
284
+ self._tracked[msg_id] = {
285
+ "msg_id": msg_id,
286
+ "project": project,
287
+ "name": name,
288
+ "prompt": prompt,
289
+ "sent_at": now_iso(),
290
+ "status": "pending",
291
+ "detail": None,
292
+ "response": None,
293
+ "answered_at": None,
294
+ }
295
+ # Oldest first; `dict` preserves insertion order.
296
+ while len(self._tracked) > MAX_TRACKED:
297
+ self._tracked.pop(next(iter(self._tracked)))
298
+
299
+ # The listener must be up before the prompt goes out: a fast peer can
300
+ # answer before a thread that is started afterwards ever accepts.
301
+ threading.Thread(
302
+ target=self._serve_reply,
303
+ args=(server, reply_path, msg_id),
304
+ name=f"coms-reply-{msg_id[:8]}",
305
+ daemon=True,
306
+ ).start()
307
+
308
+ try:
309
+ send_envelope(endpoint, envelope)
310
+ except ComsSendError:
311
+ self._record(msg_id, status="failed")
312
+ try:
313
+ server.close()
314
+ except OSError:
315
+ pass
316
+ raise
317
+
318
+ with self._lock:
319
+ return dict(self._tracked[msg_id])
320
+
321
+ def recent(self, limit: int = 20) -> list[dict]:
322
+ """Newest first, prompts trimmed — this feeds a 300px-wide pane."""
323
+ with self._lock:
324
+ rows = list(self._tracked.values())[-limit:]
325
+ rows.reverse()
326
+ return [
327
+ {
328
+ **row,
329
+ "prompt": _clip(row["prompt"], 200),
330
+ "response": _clip(row["response"], 2000) if row["response"] else None,
331
+ }
332
+ for row in rows
333
+ ]
334
+
335
+
336
+ def _as_text(response) -> str | None:
337
+ if response is None:
338
+ return None
339
+ if isinstance(response, str):
340
+ return response
341
+ try:
342
+ return json.dumps(response, indent=2)
343
+ except (TypeError, ValueError):
344
+ return str(response)
345
+
346
+
347
+ def _clip(text: str | None, limit: int) -> str | None:
348
+ if text is None:
349
+ return None
350
+ return text if len(text) <= limit else text[: limit - 1] + "…"
@@ -0,0 +1,193 @@
1
+ """Source B — what each session is doing right now, from herdr.
2
+
3
+ `herdr agent list` needs nothing but `HOME` in the environment: it finds its own
4
+ socket. That is why the gateway process, which carries no `HERDR_*` variables,
5
+ can call it without setup — and why this is a subprocess and not a socket
6
+ client. A socket client would save ~20ms per poll and unlock
7
+ `pane.agent_status_changed` push, at the cost of reimplementing the JSON-lines
8
+ protocol in Python. At a 3s interval that trade is not worth taking yet.
9
+
10
+ Nothing here raises for a herdr that is down or slow: the caller degrades every
11
+ row to `state: "unknown"` and still renders the sessions. A missing herdr means
12
+ "we don't know what they're doing", never "there are no sessions".
13
+ """
14
+
15
+ import json
16
+ import re
17
+ import subprocess
18
+
19
+ HERDR_BIN = "herdr"
20
+ HERDR_TIMEOUT_S = 3.0
21
+
22
+ # herdr's own vocabulary. Anything else (including a herdr that grows a new
23
+ # state) normalises to "unknown" rather than leaking a label the UI can't tone.
24
+ KNOWN_STATES = ("idle", "working", "blocked")
25
+
26
+ # Port of parsePeerName in .pi/harnesses/lib/herdr-presence.ts — the inverse of
27
+ # formatPeerStatus's `<name> <pct>% q<depth>`. Kept character-identical
28
+ # (including the tolerant `q\d*` tail) so both ends agree on truncated input.
29
+ # Only reachable on herdr <= 0.7.3; see peer_key().
30
+ _PEER_STATUS = re.compile(r"^(.*?)\s+\d+%\s+q\d*$")
31
+
32
+ # Pane fields the join is allowed to see. `terminal_id` and the session paths
33
+ # herdr also reports stay behind this line — see the allowlist note in
34
+ # sessions.py.
35
+ _PANE_FIELDS = ("agent", "pane_id", "focused", "workspace_id")
36
+
37
+
38
+ class HerdrUnavailable(Exception):
39
+ """herdr could not be asked: missing binary, timeout, or a bad answer."""
40
+
41
+
42
+ def parse_peer_name(custom_status) -> str | None:
43
+ """`"reviewer 12% q0"` -> `"reviewer"`.
44
+
45
+ `custom_status` is capped at 32 chars by the herdr server, which is exactly
46
+ why the coms peer name is written FIRST: a truncated tail still leaves the
47
+ identity readable. When the tail is cut off mid-way the regex misses and we
48
+ return the raw string — the caller resolves that by prefix, and treats an
49
+ ambiguous prefix as unknown rather than guessing.
50
+ """
51
+ if not isinstance(custom_status, str) or not custom_status.strip():
52
+ return None
53
+ match = _PEER_STATUS.match(custom_status)
54
+ name = (match.group(1) if match else custom_status).strip()
55
+ return name or None
56
+
57
+
58
+ def peer_key(agent: dict) -> tuple[str | None, str] | None:
59
+ """`(project, name)` for the coms peer occupying a pane, or None.
60
+
61
+ Mirrors peerNameFrom/peerProjectFrom in herdr-presence.ts. `project` is None
62
+ only for the legacy `custom_status` dialect, which had 32 characters to work
63
+ with and no room for it — and that missing project is precisely why two
64
+ projects each running an `orchestrator` used to be unjoinable.
65
+
66
+ `name` (herdr's `agent rename`) is a human label rather than a coms
67
+ identity, so it is the last resort, never the first.
68
+ """
69
+ tokens = agent.get("tokens")
70
+ if isinstance(tokens, dict):
71
+ name = tokens.get("coms")
72
+ if isinstance(name, str) and name.strip():
73
+ project = tokens.get("proj")
74
+ scope = project.strip() if isinstance(project, str) and project.strip() else None
75
+ return (scope, name.strip())
76
+
77
+ legacy = parse_peer_name(agent.get("custom_status"))
78
+ if legacy:
79
+ return (None, legacy)
80
+
81
+ named = agent.get("name")
82
+ if isinstance(named, str) and named.strip():
83
+ return (None, named.strip())
84
+ return None
85
+
86
+
87
+ def normalize_state(agent_status) -> str:
88
+ return agent_status if agent_status in KNOWN_STATES else "unknown"
89
+
90
+
91
+ def run_herdr(args: list[str], timeout: float, runner=subprocess.run) -> str:
92
+ """The one place a herdr failure becomes `HerdrUnavailable`."""
93
+ try:
94
+ result = runner(
95
+ args,
96
+ capture_output=True,
97
+ text=True,
98
+ timeout=timeout,
99
+ check=False,
100
+ )
101
+ except FileNotFoundError as error:
102
+ raise HerdrUnavailable(f"{args[0]} not found on PATH") from error
103
+ except subprocess.TimeoutExpired as error:
104
+ raise HerdrUnavailable(f"{' '.join(args)} timed out after {timeout}s") from error
105
+ except OSError as error:
106
+ raise HerdrUnavailable(f"{' '.join(args)} failed: {error}") from error
107
+ if result.returncode != 0:
108
+ raise HerdrUnavailable(f"{' '.join(args)} exited {result.returncode}: {result.stderr.strip()[:200]}")
109
+ return result.stdout
110
+
111
+
112
+ def list_agents(run=run_herdr, timeout: float = HERDR_TIMEOUT_S) -> list[dict]:
113
+ """Raw pane records from `herdr agent list`."""
114
+ raw = run([HERDR_BIN, "agent", "list"], timeout)
115
+ try:
116
+ payload = json.loads(raw)
117
+ except ValueError as error:
118
+ raise HerdrUnavailable("herdr agent list returned non-JSON output") from error
119
+ # The CLI wraps its answer in the wire envelope (`{"id":…,"result":{…}}`);
120
+ # accept the bare form too, so a future unwrapped CLI does not break us.
121
+ container = payload.get("result", payload) if isinstance(payload, dict) else {}
122
+ agents = container.get("agents") if isinstance(container, dict) else None
123
+ if not isinstance(agents, list):
124
+ raise HerdrUnavailable("herdr agent list returned no agents array")
125
+ return [agent for agent in agents if isinstance(agent, dict)]
126
+
127
+
128
+ def pane_snapshot(run=run_herdr, timeout: float = HERDR_TIMEOUT_S) -> tuple[dict[tuple[str | None, str], dict], int]:
129
+ """The panes we can join, and how many panes herdr reported in total.
130
+
131
+ One `herdr agent list` for both numbers. The total includes panes with no
132
+ peer annotation, which is the point: it is what lets the panel tell "herdr
133
+ sees nothing at all" apart from "herdr sees panes, none of them is yours".
134
+ """
135
+ agents = list_agents(run, timeout)
136
+ return panes_from_agents(agents), len(agents)
137
+
138
+
139
+ def panes_by_peer_key(run=run_herdr, timeout: float = HERDR_TIMEOUT_S) -> dict[tuple[str | None, str], dict]:
140
+ """Panes keyed by the `(project, name)` coms peer they advertise."""
141
+ return panes_from_agents(list_agents(run, timeout))
142
+
143
+
144
+ def panes_from_agents(agents: list[dict]) -> dict[tuple[str | None, str], dict]:
145
+ """Panes keyed by the `(project, name)` coms peer they advertise.
146
+
147
+ Panes without a peer annotation are dropped: they are not Agent Fleet
148
+ sessions (or have not reported presence yet), and the registry side of the
149
+ join is what decides who exists. Two panes claiming one key collapse to a
150
+ single ambiguous marker — a wrong status on the right row is worse than an
151
+ honest "unknown".
152
+ """
153
+ claims: dict[tuple[str | None, str], list[dict]] = {}
154
+ for agent in agents:
155
+ key = peer_key(agent)
156
+ if not key:
157
+ continue
158
+ pane = {field: agent.get(field) for field in _PANE_FIELDS if agent.get(field) is not None}
159
+ pane["state"] = normalize_state(agent.get("agent_status"))
160
+ claims.setdefault(key, []).append(pane)
161
+
162
+ panes: dict[tuple[str | None, str], dict] = {}
163
+ for key, matches in claims.items():
164
+ panes[key] = matches[0] if len(matches) == 1 else {"state": "unknown", "ambiguous": True}
165
+ return panes
166
+
167
+
168
+ # herdr's own ids (`wA`, `wA:p13`). Validated before reaching argv even though
169
+ # nothing here goes through a shell: an id is a machine token, and the moment a
170
+ # renderer can put arbitrary text in one, "not a shell" is the only thing left
171
+ # between it and the command line.
172
+ _WORKSPACE_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$")
173
+
174
+
175
+ def focus_workspace(workspace_id, run=run_herdr, timeout: float = HERDR_TIMEOUT_S) -> None:
176
+ """Bring a workspace forward. The only write this module makes.
177
+
178
+ Raises `HerdrUnavailable` when herdr refuses or cannot be reached — the
179
+ caller turns that into an answer on screen, because a focus that silently
180
+ did nothing is worse than one that says it failed.
181
+ """
182
+ if not isinstance(workspace_id, str) or not _WORKSPACE_ID.match(workspace_id):
183
+ raise HerdrUnavailable(f"not a herdr workspace id: {workspace_id!r}")
184
+ run([HERDR_BIN, "workspace", "focus", workspace_id], timeout)
185
+
186
+
187
+ def herdr_version(run=run_herdr, timeout: float = HERDR_TIMEOUT_S) -> str | None:
188
+ """Reported for `/capabilities` only — never gates behaviour."""
189
+ try:
190
+ text = run([HERDR_BIN, "--version"], timeout).strip()
191
+ except HerdrUnavailable:
192
+ return None
193
+ return text.splitlines()[0].strip() if text else None
@@ -0,0 +1,4 @@
1
+ {
2
+ "name": "agent-fleet-herdr",
3
+ "api": "plugin_api.py"
4
+ }