@chankov/agent-fleet 0.0.6 → 0.0.7

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 (419) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/harnesses/agent-hub/README.md +75 -16
  4. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  5. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  6. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  7. package/.pi/harnesses/agent-hub/delegate.ts +58 -9
  8. package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
  9. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  10. package/.pi/harnesses/agent-hub/index.ts +723 -159
  11. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  12. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  13. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  14. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  15. package/.pi/harnesses/agent-hub/package.json +1 -1
  16. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  17. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  18. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  19. package/.pi/harnesses/agent-hub/run-budget.js +29 -3
  20. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  21. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  22. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  23. package/.pi/harnesses/coms/README.md +4 -3
  24. package/.pi/harnesses/coms/index.ts +80 -58
  25. package/.pi/harnesses/coms/package.json +1 -1
  26. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  27. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  28. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  29. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  30. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  31. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  32. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  33. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  34. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  35. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  36. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  37. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  38. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  39. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  40. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  41. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  42. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  43. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  44. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  45. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  46. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  47. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  48. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  49. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  50. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  51. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  52. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  53. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  54. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  55. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  56. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  57. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  58. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  59. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  60. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  61. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  62. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  63. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  64. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  65. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  66. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  67. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  68. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  69. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  70. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  71. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  72. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  73. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  74. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  75. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  76. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  77. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  78. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  79. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  80. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  81. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  82. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  83. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  84. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  85. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  86. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  87. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  88. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  89. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  90. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  91. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  92. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  93. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  94. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  95. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  96. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  97. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  98. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  99. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  100. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  101. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  102. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  103. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  104. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  105. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  106. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  107. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  108. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  110. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  125. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  126. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  127. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  128. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  129. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  130. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  131. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  132. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  133. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  134. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  135. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  136. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  137. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  138. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  139. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  140. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  141. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  142. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  143. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  144. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  145. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  146. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  147. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  148. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  149. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  150. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  151. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  152. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  153. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  154. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  155. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  156. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  157. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  158. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  159. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  160. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  161. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.7/.version +1 -0
  167. package/.versions/0.0.7/agents/architect.md +23 -0
  168. package/.versions/0.0.7/agents/bowser.md +26 -0
  169. package/.versions/0.0.7/agents/builder.md +53 -0
  170. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.7/agents/documenter.md +18 -0
  173. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  174. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.7/agents/planner.md +69 -0
  176. package/.versions/0.0.7/agents/releaser.md +24 -0
  177. package/.versions/0.0.7/agents/researcher.md +28 -0
  178. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  184. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  186. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  188. package/.versions/0.0.7/docs/getting-started.md +231 -0
  189. package/.versions/0.0.7/docs/npm-install.md +337 -0
  190. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.7/hermes/README.md +347 -0
  195. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  196. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  197. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  198. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  199. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  200. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  201. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  202. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  203. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  204. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  205. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  206. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  207. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  208. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  209. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  210. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  211. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  212. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  213. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  214. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  215. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  216. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  217. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  218. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  219. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  220. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  221. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  222. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  223. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  224. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  225. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  226. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  227. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  228. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  229. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  230. package/.versions/0.0.7/hooks/hooks.json +14 -0
  231. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  232. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  233. package/.versions/0.0.7/justfile +245 -0
  234. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  235. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  236. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  237. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  238. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  239. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  240. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  241. package/.versions/0.0.7/references/security-checklist.md +179 -0
  242. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  243. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  244. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  245. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  246. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  247. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  248. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  249. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  250. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  251. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  252. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  253. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  254. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  255. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  256. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  257. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  258. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  259. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  260. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  261. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  262. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  263. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  264. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  265. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  266. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  267. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  268. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  269. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  270. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  271. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  272. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  273. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  274. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  275. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  276. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  277. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  278. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  279. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  280. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  281. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  282. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  283. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  284. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  285. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  286. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  287. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  288. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  289. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  290. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  291. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  292. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  293. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  294. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  295. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  296. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  297. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  298. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  299. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  300. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  301. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  302. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  303. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  304. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  305. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  306. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  307. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  308. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  309. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  310. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  311. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  312. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  313. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  314. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  315. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  316. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  317. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  318. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  319. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  320. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  321. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  322. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  323. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  324. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  325. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  326. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  327. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  328. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  329. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  330. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  331. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  332. package/CHANGELOG.md +134 -0
  333. package/README.md +175 -18
  334. package/agents/code-reviewer.md +2 -2
  335. package/agents/orchestrator.md +11 -0
  336. package/agents/plan-reviewer.md +1 -1
  337. package/agents/planner.md +1 -1
  338. package/agents/security-auditor.md +1 -1
  339. package/bin/cli.js +40 -1
  340. package/bin/lib/hermes-profile-artifact.js +144 -0
  341. package/bin/lib/set-hermes-watchdog.js +173 -0
  342. package/bin/set-hermes-watchdog.js +26 -0
  343. package/docs/ARCHITECTURE.md +64 -12
  344. package/docs/agent-fleet-setup.md +2 -2
  345. package/docs/claude-code-coms-bridge.md +7 -1
  346. package/docs/coms-hermes-bridge.md +10 -0
  347. package/docs/getting-started.md +48 -0
  348. package/docs/hermes-watchdog-supervisor.md +140 -0
  349. package/hermes/README.md +135 -19
  350. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  351. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  352. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  353. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  354. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  355. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  356. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  357. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  358. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  359. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  360. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  361. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  362. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  363. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  364. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  365. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  366. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  367. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  368. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  369. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  370. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  371. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  372. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  373. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  374. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  375. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  376. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  377. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  378. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  379. package/hooks/coms-stop-hook.mjs +12 -1
  380. package/package.json +11 -2
  381. package/scripts/coms-claude-bridge.ts +154 -39
  382. package/scripts/fleet.ts +9 -1
  383. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  384. package/scripts/lib/claude-bridge-core.ts +65 -0
  385. package/scripts/lib/coms-envelope.ts +44 -1
  386. package/scripts/lib/hermes-monitor-events.ts +1 -0
  387. package/scripts/lib/monitor-env.ts +120 -0
  388. package/scripts/team-snapshot.ts +1 -1
  389. package/scripts/team-up.ts +10 -1
  390. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  391. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  392. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  393. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  394. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  395. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  396. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  397. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  398. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  399. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  400. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  401. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  402. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  403. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  404. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  405. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  406. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  407. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  408. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  409. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  410. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  411. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  412. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  413. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  414. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  415. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  416. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  417. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  418. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  419. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
@@ -0,0 +1,74 @@
1
+ // Hub-spawned coms peers: readiness policy and the never-addressed sweep.
2
+ //
3
+ // Root cause this encodes: `herdr_spawn_peer` launches a REUSABLE coms peer —
4
+ // it boots idle and waits for a `coms_send`. Spawning it delivers no work. One
5
+ // session spawned `repair-builder` and `final-test-worker`, sent all twelve of
6
+ // its messages to a third peer, and left two empty panes named like workers.
7
+ // The spawns were a sound reaction to a broken session; nothing told the
8
+ // dispatcher when the peers became addressable, and nothing noticed they never
9
+ // were addressed.
10
+ //
11
+ // Two answers: the spawn returns a readiness verdict instead of a bare pane id,
12
+ // and an unaddressed hub-spawned peer is named at the end of the session.
13
+
14
+ /** Longest we wait for a spawned peer to register in the coms pool. */
15
+ export const PEER_READY_TIMEOUT_MS = 45_000;
16
+
17
+ /** Poll backoff while waiting for registration, in ms; the last step repeats. */
18
+ export const PEER_READY_BACKOFF_MS = [250, 500, 1_000, 2_000, 3_000];
19
+
20
+ /** Backoff delay for the nth readiness poll (0-based); the last step repeats. */
21
+ export function peerReadyDelayMs(attempt) {
22
+ const i = Math.max(0, Math.min(Math.floor(attempt) || 0, PEER_READY_BACKOFF_MS.length - 1));
23
+ return PEER_READY_BACKOFF_MS[i];
24
+ }
25
+
26
+ /**
27
+ * The verdict a spawn reports back. `ready` means the peer is in the pool and
28
+ * `coms_send` will reach it; otherwise it is still booting and the caller is
29
+ * told how long we waited rather than being left to guess.
30
+ */
31
+ export function peerReadyVerdict({ name, paneId, found, waitedMs, timeoutMs = PEER_READY_TIMEOUT_MS }) {
32
+ if (found) {
33
+ return {
34
+ peer_ready: true,
35
+ peer_name: name,
36
+ pane_id: paneId,
37
+ waited_ms: waitedMs,
38
+ message:
39
+ `Peer "${name}" is ready in pane ${paneId} after ${Math.round(waitedMs / 1000)}s — ` +
40
+ `address it with coms_send(target: "${name}", ...). It boots idle and does no work until you send.`,
41
+ };
42
+ }
43
+ return {
44
+ peer_ready: false,
45
+ peer_name: name,
46
+ pane_id: paneId,
47
+ waited_ms: waitedMs,
48
+ message:
49
+ `Peer "${name}" is still booting in pane ${paneId} — it did not register in the coms pool within ` +
50
+ `${Math.round(timeoutMs / 1000)}s. Check coms_list before sending; if it never appears, read the pane ` +
51
+ "to see why it failed to start, and close it if it is dead.",
52
+ };
53
+ }
54
+
55
+ /**
56
+ * Sweep report for peers this hub spawned. `entries` carry
57
+ * { name, paneId, addressed } — `addressed` is true once any coms_send targeted
58
+ * that peer. Returns null when every spawned peer got work (the common case).
59
+ */
60
+ export function unaddressedPeerSweep(entries) {
61
+ const idle = (Array.isArray(entries) ? entries : []).filter((e) => e && !e.addressed);
62
+ if (idle.length === 0) return null;
63
+ const rows = idle.map((e) => ` ${e.name} (pane ${e.paneId ?? "?"}) — spawned, never sent to`);
64
+ return {
65
+ count: idle.length,
66
+ peers: idle.map((e) => ({ name: e.name, pane_id: e.paneId ?? null })),
67
+ message: [
68
+ `⚠ ${idle.length} hub-spawned peer(s) never received a message:`,
69
+ ...rows,
70
+ "A spawned peer boots idle and waits — it is holding a pane and a model session for nothing.",
71
+ `Close them with herdr_close_pane (asks for your confirmation) or send them work.`,
72
+ ].join("\n"),
73
+ };
74
+ }
@@ -30,8 +30,9 @@ tools, and pool-scope boundary are identical in both**:
30
30
 
31
31
  - **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
32
32
  pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
33
- itself via `pane.report_agent` + `pane.report_metadata` (`custom_status` =
34
- `<name> <pct>% q<depth>`, capped at 32 chars by herdr), and the pool widget populates
33
+ itself via `pane.report_agent` + `pane.report_metadata` (`tokens` = `coms`/`proj`/
34
+ `ctx`/`q` on herdr >= 0.7.4, one latched fallback to the legacy 32-char
35
+ `custom_status` = `<name> <pct>% q<depth>`), and the pool widget populates
35
36
  from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
36
37
  changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
37
38
  (idle/working) in the herdr sidebar comes from herdr's own pi integration when
@@ -40,7 +41,7 @@ tools, and pool-scope boundary are identical in both**:
40
41
  byte-for-byte today's behavior.
41
42
 
42
43
  The file registry keeps being written in BOTH backends (it carries the full agent card
43
- that herdr's 32-char `custom_status` cannot, and keeps this peer discoverable to peers
44
+ that a pane annotation cannot, and keeps this peer discoverable to peers
44
45
  running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
45
46
  when you are on the herdr backend.
46
47
 
@@ -25,13 +25,13 @@ import * as os from "node:os";
25
25
  import * as crypto from "node:crypto";
26
26
  import { registerVersionStatus } from "./version.ts";
27
27
 
28
+ import { buildLiveRegistryEntry, type ComsRegistryEntry } from "../lib/coms-registry-entry.ts";
28
29
  import {
29
- formatPeerStatus,
30
30
  HerdrAgentWatch,
31
31
  HerdrPresence,
32
32
  herdrPaneId,
33
33
  herdrPresenceAvailable,
34
- parsePeerName,
34
+ peerNameFrom,
35
35
  type HerdrAgentInfo,
36
36
  } from "../lib/herdr-presence.ts";
37
37
 
@@ -69,6 +69,8 @@ interface PromptEnvelope extends Envelope {
69
69
  sender_cwd: string;
70
70
  conversation_id?: string | null;
71
71
  response_schema?: object | null;
72
+ /** How long the sender will wait; receivers driving an interactive agent use it. */
73
+ reply_timeout_ms?: number | null;
72
74
  }
73
75
 
74
76
  interface ResponseEnvelope extends Envelope {
@@ -81,6 +83,9 @@ interface PingEnvelope extends Envelope {
81
83
  type: "ping";
82
84
  }
83
85
 
86
+ /** Addressability of a peer right now — see scripts/lib/coms-envelope.ts. */
87
+ type PeerStatus = "idle" | "working" | "booting";
88
+
84
89
  interface AgentCard {
85
90
  name: string;
86
91
  purpose: string;
@@ -88,6 +93,10 @@ interface AgentCard {
88
93
  color: string;
89
94
  context_used_pct: number;
90
95
  queue_depth: number;
96
+ /** herdr pane hosting this peer, when it runs in one. */
97
+ pane_id?: string | null;
98
+ /** idle | working | booting. Absent from peers older than this field. */
99
+ status?: PeerStatus;
91
100
  }
92
101
 
93
102
  interface Pong {
@@ -96,24 +105,10 @@ interface Pong {
96
105
  agent_card: AgentCard;
97
106
  }
98
107
 
99
- interface RegistryEntry {
100
- session_id: string;
101
- name: string;
102
- purpose: string;
103
- model: string;
104
- color: string;
105
- pid: number;
106
- endpoint: string;
107
- cwd: string;
108
- started_at: string;
109
- explicit: boolean;
110
- version: number;
111
- // Live status snapshot — refreshed every KEEPALIVE_INTERVAL_MS by the heartbeat.
112
- // Optional so older entries (pre-heartbeat-refresh) still parse cleanly.
113
- context_used_pct?: number;
114
- queue_depth?: number;
115
- heartbeat_at?: string;
116
- }
108
+ // The registry shape and the heartbeat builder are shared with agent-hub —
109
+ // see ../lib/coms-registry-entry.ts. Both harnesses used to keep their own
110
+ // copy of this literal, and both refreshed `started_at` every 30 seconds.
111
+ type RegistryEntry = ComsRegistryEntry;
117
112
 
118
113
  interface PendingReply {
119
114
  resolve: (value: any) => void;
@@ -580,6 +575,8 @@ export default function (pi: ExtensionAPI) {
580
575
  model: string;
581
576
  endpoint: string;
582
577
  registryFile: string;
578
+ // Set once, at registration. The heartbeat reads it; nothing rewrites it.
579
+ started_at: string;
583
580
  } | null = null;
584
581
  const peerCards: Map<string, AgentCard & { staleCount: number }> = new Map();
585
582
  const pendingReplies: Map<string, PendingReply> = new Map();
@@ -711,6 +708,10 @@ export default function (pi: ExtensionAPI) {
711
708
  color: ident?.color ?? "#36F9F6",
712
709
  context_used_pct: pct,
713
710
  queue_depth: inboundQueue.size,
711
+ pane_id: herdrPaneId() ?? null,
712
+ // A queued inbound prompt counts as busy even between turns: the peer
713
+ // owes someone an answer before it can take another.
714
+ status: (turnState === "working" || inboundQueue.size > 0 ? "working" : "idle") as PeerStatus,
714
715
  };
715
716
  const pong: Pong = { type: "pong", msg_id: env.msg_id, agent_card: card };
716
717
  try {
@@ -846,6 +847,7 @@ export default function (pi: ExtensionAPI) {
846
847
  }
847
848
 
848
849
  // 4. Build + write registry entry atomically.
850
+ const started_at = nowIso();
849
851
  const entry: RegistryEntry = {
850
852
  session_id,
851
853
  name,
@@ -855,7 +857,7 @@ export default function (pi: ExtensionAPI) {
855
857
  pid: process.pid,
856
858
  endpoint,
857
859
  cwd,
858
- started_at: nowIso(),
860
+ started_at,
859
861
  explicit,
860
862
  version: 1,
861
863
  };
@@ -879,6 +881,7 @@ export default function (pi: ExtensionAPI) {
879
881
  model,
880
882
  endpoint,
881
883
  registryFile,
884
+ started_at,
882
885
  };
883
886
  includeExplicit = false;
884
887
  displayProject = project;
@@ -905,14 +908,25 @@ export default function (pi: ExtensionAPI) {
905
908
  // 7. Presence backend: herdr (push events, no polling) when this
906
909
  // session runs inside a herdr pane with a live server; the files ping
907
910
  // loop otherwise. The registry keepalive below runs in BOTH backends —
908
- // it carries the full agent card (context %, queue depth) that herdr's
909
- // 32-char custom_status cannot, and keeps us discoverable to peers
911
+ // it carries the full agent card (purpose, model, colour) that a pane
912
+ // annotation is no place for, and keeps us discoverable to peers
910
913
  // running outside herdr panes.
911
914
  const useHerdr = await herdrPresenceAvailable();
912
915
  if (useHerdr) {
913
916
  const paneId = herdrPaneId()!;
914
- herdrPresence = new HerdrPresence({ paneId, source: `coms:${session_id}` });
915
- void herdrPresence.report("idle", formatPeerStatus(name, 0, 0));
917
+ herdrPresence = new HerdrPresence({
918
+ paneId,
919
+ source: `coms:${session_id}`,
920
+ // A herdr that rejects our annotation dialect used to be
921
+ // invisible: presence swallows errors, so the sidebar simply
922
+ // stayed blank and every watcher saw "detached" forever.
923
+ onError: (err, dialect) => {
924
+ try {
925
+ pi.appendEntry("coms-log", { event: "presence_dialect_rejected", dialect, reason: err?.message ?? String(err) });
926
+ } catch { /* best-effort */ }
927
+ },
928
+ });
929
+ void herdrPresence.report("idle", { name, project, contextUsedPct: 0, queueDepth: 0 });
916
930
  herdrWatch = new HerdrAgentWatch({
917
931
  ownPaneId: paneId,
918
932
  onChange: (agents) => herdrSyncPeerCards(agents),
@@ -932,22 +946,13 @@ export default function (pi: ExtensionAPI) {
932
946
  // Detect missing-registry BEFORE writing so the self_heal audit only
933
947
  // fires when something actually went wrong (file unlinked under us).
934
948
  const missingBeforeWrite = !fs.existsSync(identity.registryFile);
935
- const live: RegistryEntry = {
936
- session_id: identity.session_id,
937
- name: identity.name,
938
- purpose: identity.purpose,
939
- model: ctx?.model?.id ?? identity.model,
940
- color: identity.color,
949
+ const live: RegistryEntry = buildLiveRegistryEntry(identity, {
950
+ now: nowIso(),
941
951
  pid: process.pid,
942
- endpoint: identity.endpoint,
943
- cwd: identity.cwd,
944
- started_at: nowIso(),
945
- explicit: identity.explicit,
946
- version: 1,
947
- context_used_pct: Math.round(ctx?.getContextUsage()?.percent ?? 0),
948
- queue_depth: inboundQueue.size,
949
- heartbeat_at: nowIso(),
950
- };
952
+ model: ctx?.model?.id,
953
+ contextUsedPct: ctx?.getContextUsage()?.percent,
954
+ queueDepth: inboundQueue.size,
955
+ });
951
956
  // Unconditional atomic write: handles BOTH the live-status refresh
952
957
  // (file present → overwrite with fresh values) AND self-heal (file
953
958
  // missing → re-create entry). The atomic write also bumps mtime, so
@@ -967,7 +972,7 @@ export default function (pi: ExtensionAPI) {
967
972
  // registry heartbeats just written by the other peers.
968
973
  if (herdrPresence && identity) {
969
974
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
970
- void herdrPresence.report(turnState, formatPeerStatus(identity.name, pct, inboundQueue.size));
975
+ void herdrPresence.report(turnState, { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
971
976
  }
972
977
  if (herdrWatch) herdrSyncPeerCards(herdrWatch.current());
973
978
  }, KEEPALIVE_INTERVAL_MS);
@@ -985,7 +990,7 @@ export default function (pi: ExtensionAPI) {
985
990
  turnState = "working";
986
991
  if (herdrPresence && identity) {
987
992
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
988
- void herdrPresence.report("working", formatPeerStatus(identity.name, pct, inboundQueue.size));
993
+ void herdrPresence.report("working", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
989
994
  }
990
995
  });
991
996
 
@@ -993,13 +998,13 @@ export default function (pi: ExtensionAPI) {
993
998
  turnState = "idle";
994
999
  if (herdrPresence && identity) {
995
1000
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
996
- void herdrPresence.report("idle", formatPeerStatus(identity.name, pct, inboundQueue.size));
1001
+ void herdrPresence.report("idle", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
997
1002
  }
998
1003
  });
999
1004
 
1000
1005
  // Join herdr's live pane states back to the coms registry: a herdr agent
1001
- // whose custom_status leads with a peer name maps to that peer's registry
1002
- // entry (which carries the full card the 32-char custom_status cannot).
1006
+ // that advertises a coms peer name maps to that peer's registry entry
1007
+ // (which carries the full card a pane annotation has no room for).
1003
1008
  // Pool-scope semantics are preserved — only entries from peersInScope()
1004
1009
  // become cards; peers outside herdr panes stay visible as registry-only
1005
1010
  // "pending" rows exactly like an unpinged peer in the files backend.
@@ -1007,7 +1012,7 @@ export default function (pi: ExtensionAPI) {
1007
1012
  if (!identity) return;
1008
1013
  const liveNames = new Set<string>();
1009
1014
  for (const a of agents) {
1010
- const peerName = parsePeerName(a.custom_status as string | undefined);
1015
+ const peerName = peerNameFrom(a);
1011
1016
  if (peerName) liveNames.add(peerName);
1012
1017
  }
1013
1018
  let changed = false;
@@ -1294,8 +1299,11 @@ export default function (pi: ExtensionAPI) {
1294
1299
  label: "Coms List",
1295
1300
  description:
1296
1301
  "List the peer agents in your current coms pool — the ones shown in the pool widget. Returns " +
1297
- "names, models, and live context-window usage. Discovery is scoped to what the human displays " +
1298
- "via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
1302
+ "names, models, live context-window usage, the herdr pane_id, and status (idle | working | " +
1303
+ "booting). CHECK STATUS BEFORE SENDING: `working` means the peer is mid-turn and your send " +
1304
+ "will wait for it; `booting` means it registered but is not addressable yet. Use this instead " +
1305
+ "of reading the peer's pane to guess whether it is busy. Discovery is scoped to what the human " +
1306
+ "displays via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
1299
1307
  parameters: Type.Object({
1300
1308
  project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
1301
1309
  include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
@@ -1350,6 +1358,12 @@ export default function (pi: ExtensionAPI) {
1350
1358
  project: c.project,
1351
1359
  alive: pong != null,
1352
1360
  context_used_pct: pong ? pong.context_used_pct : null,
1361
+ // Check these BEFORE sending: a `working` peer will make the send
1362
+ // wait, and a `booting` one is not addressable yet. Reading the
1363
+ // pane to find this out is the thing they replace.
1364
+ pane_id: pong?.pane_id ?? null,
1365
+ status: pong?.status ?? null,
1366
+ queue_depth: pong ? pong.queue_depth : null,
1353
1367
  color: c.entry.color,
1354
1368
  };
1355
1369
  });
@@ -1365,7 +1379,8 @@ export default function (pi: ExtensionAPI) {
1365
1379
  : agents.map((a) => {
1366
1380
  const ctxStr = a.context_used_pct != null ? ` ${a.context_used_pct}%` : " ?%";
1367
1381
  const live = a.alive ? "●" : "✗";
1368
- return `${live} ${a.name} (${a.model})${ctxStr}${a.purpose ? ` — ${a.purpose}` : ""}`;
1382
+ const state = ` [${a.alive ? (a.status ?? "unknown") : "unreachable"}${a.pane_id ? ` pane ${a.pane_id}` : ""}]`;
1383
+ return `${live} ${a.name} (${a.model})${ctxStr}${state}${a.purpose ? ` — ${a.purpose}` : ""}`;
1369
1384
  }).join("\n");
1370
1385
 
1371
1386
  return {
@@ -1391,7 +1406,10 @@ export default function (pi: ExtensionAPI) {
1391
1406
  const rows = agents.map((a) => {
1392
1407
  const dot = a.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
1393
1408
  const pct = a.context_used_pct != null ? `${a.context_used_pct}%` : "?%";
1394
- return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)}`;
1409
+ const state = a.alive ? (a.status ?? "unknown") : "unreachable";
1410
+ const stateFg = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
1411
+ return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)} ` +
1412
+ `${theme.fg(stateFg as any, state)}${a.pane_id ? theme.fg("dim", ` ${a.pane_id}`) : ""}`;
1395
1413
  }).join("\n");
1396
1414
  return new Text(header + "\n" + rows, 0, 0);
1397
1415
  },
@@ -1409,6 +1427,7 @@ export default function (pi: ExtensionAPI) {
1409
1427
  prompt: Type.String({ description: "The prompt to send." }),
1410
1428
  conversation_id: Type.Optional(Type.String()),
1411
1429
  response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
1430
+ reply_timeout_ms: Type.Optional(Type.Number({ description: "How long you will wait for the reply (ms). Pass the same value you intend to give coms_await: a receiver that drives an interactive agent (e.g. a Claude Code pane) uses this instead of its own default, so long reviews are not cut short. Clamped to 1 hour." })),
1412
1431
  }),
1413
1432
  async execute(_callId, params) {
1414
1433
  if (!identity) {
@@ -1443,6 +1462,7 @@ export default function (pi: ExtensionAPI) {
1443
1462
  prompt: params.prompt,
1444
1463
  conversation_id: params.conversation_id ?? null,
1445
1464
  response_schema: (params.response_schema as object | undefined) ?? null,
1465
+ reply_timeout_ms: params.reply_timeout_ms ?? null,
1446
1466
  };
1447
1467
 
1448
1468
  // Send the envelope synchronously and wait for the receiver's ack.
@@ -1464,13 +1484,8 @@ export default function (pi: ExtensionAPI) {
1464
1484
  target_name: target.name,
1465
1485
  created_at: nowIso(),
1466
1486
  };
1467
- entry.timer = setTimeout(() => {
1468
- if (entry.result) return;
1469
- entry.result = { error: "timeout" };
1470
- try { entry.resolve(entry.result); } catch { /* ignore */ }
1471
- }, TIMEOUT_MS);
1472
- // Don't keep the event loop alive solely for this timer.
1473
- try { (entry.timer as any).unref?.(); } catch { /* ignore */ }
1487
+ // A local wait deadline does not convert unfinished remote work into an
1488
+ // error. Keep the entry pending so a later await can collect the response.
1474
1489
  pendingReplies.set(msg_id, entry);
1475
1490
 
1476
1491
  try {
@@ -1590,10 +1605,16 @@ export default function (pi: ExtensionAPI) {
1590
1605
  });
1591
1606
 
1592
1607
  const winner = await Promise.race([entry.promise, timed]);
1608
+ if ((winner as any).error === "timeout") {
1609
+ return {
1610
+ content: [{ type: "text" as const, text: "coms_await: pending — wait budget exhausted; the peer may still complete" }],
1611
+ details: { status: "pending" },
1612
+ };
1613
+ }
1593
1614
  if ((winner as any).error) {
1594
1615
  return {
1595
1616
  content: [{ type: "text" as const, text: `coms_await: error — ${(winner as any).error}` }],
1596
- details: { error: (winner as any).error },
1617
+ details: { status: "error", error: (winner as any).error },
1597
1618
  };
1598
1619
  }
1599
1620
  const resp = (winner as any).response;
@@ -1612,6 +1633,7 @@ export default function (pi: ExtensionAPI) {
1612
1633
  renderResult(result, _options, theme) {
1613
1634
  const d = result.details as any;
1614
1635
  if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
1636
+ if (d?.status === "pending") return new Text(theme.fg("warning", "⏳ pending"), 0, 0);
1615
1637
  return new Text(theme.fg("success", "✓ response received"), 0, 0);
1616
1638
  },
1617
1639
  });
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.6"
6
+ "version": "0.0.7"
7
7
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.6"
6
+ "version": "0.0.7"
7
7
  }
@@ -0,0 +1,94 @@
1
+ // .pi/harnesses/lib/coms-registry-entry.ts
2
+ //
3
+ // The shape written to ~/.pi/coms/projects/<project>/agents/<name>.json, and
4
+ // the one function that builds it for the 30-second heartbeat.
5
+ //
6
+ // It exists because both harnesses (the standalone coms harness and the copy
7
+ // embedded in agent-hub) had their own inline copy of the same object literal,
8
+ // and both copies wrote `started_at: nowIso()` on EVERY heartbeat. The field
9
+ // therefore never held the start of anything — it was always "about 30 seconds
10
+ // ago", and every reader that tried to show uptime showed noise. Registration
11
+ // sets `started_at`; the heartbeat carries it forward unchanged and moves
12
+ // `heartbeat_at` instead. That distinction is the whole point of this module,
13
+ // so it is stated once, here, and tested.
14
+ //
15
+ // Pure module: no pi imports, no fs, no clock of its own — `now` is passed in.
16
+ // Erasable-TS; testable under node --test.
17
+
18
+ export interface ComsRegistryEntry {
19
+ session_id: string;
20
+ name: string;
21
+ purpose: string;
22
+ model: string;
23
+ color: string;
24
+ pid: number;
25
+ endpoint: string;
26
+ cwd: string;
27
+ // When this session registered. NEVER refreshed — see the module note.
28
+ started_at: string;
29
+ explicit: boolean;
30
+ version: number;
31
+ // Live status snapshot — refreshed every keepalive tick. Optional so
32
+ // entries written before the heartbeat carried them still parse cleanly.
33
+ context_used_pct?: number;
34
+ queue_depth?: number;
35
+ heartbeat_at?: string;
36
+ }
37
+
38
+ // What the session knows about itself from registration onwards. This is the
39
+ // harness `identity` object; it is the source of every field the heartbeat is
40
+ // not allowed to invent.
41
+ export interface ComsIdentity {
42
+ session_id: string;
43
+ name: string;
44
+ purpose: string;
45
+ color: string;
46
+ cwd: string;
47
+ endpoint: string;
48
+ explicit: boolean;
49
+ model: string;
50
+ started_at: string;
51
+ }
52
+
53
+ // What is genuinely new at heartbeat time.
54
+ export interface LiveSnapshot {
55
+ now: string;
56
+ pid: number;
57
+ // The model can change mid-session (`/model`), so it is re-read rather than
58
+ // frozen at registration; falling back to the registered one when the ctx
59
+ // is not available.
60
+ model?: string | null;
61
+ contextUsedPct?: number | null;
62
+ queueDepth?: number | null;
63
+ }
64
+
65
+ // Percentages arrive from `ctx.getContextUsage()`, queue depths from a Map
66
+ // size. Both reach a human eye and a JSON file, so neither may be NaN,
67
+ // negative, or fractional.
68
+ function count(value: number | null | undefined): number {
69
+ if (typeof value !== "number" || !Number.isFinite(value)) return 0;
70
+ return Math.max(0, Math.round(value));
71
+ }
72
+
73
+ // The registry entry for a heartbeat write. Also the entry used for self-heal
74
+ // (the file was unlinked under us and is being re-created), which is why every
75
+ // field is present rather than patched onto whatever is on disk: there may be
76
+ // nothing on disk.
77
+ export function buildLiveRegistryEntry(identity: ComsIdentity, live: LiveSnapshot): ComsRegistryEntry {
78
+ return {
79
+ session_id: identity.session_id,
80
+ name: identity.name,
81
+ purpose: identity.purpose,
82
+ model: live.model || identity.model,
83
+ color: identity.color,
84
+ pid: live.pid,
85
+ endpoint: identity.endpoint,
86
+ cwd: identity.cwd,
87
+ started_at: identity.started_at,
88
+ explicit: identity.explicit,
89
+ version: 1,
90
+ context_used_pct: count(live.contextUsedPct),
91
+ queue_depth: count(live.queueDepth),
92
+ heartbeat_at: live.now,
93
+ };
94
+ }
@@ -411,13 +411,18 @@ export const herdr = {
411
411
  ) => request("pane.release_agent", params, opts),
412
412
  // Metadata annotations for a pane whose agent authority is held by herdr's
413
413
  // built-in detection (report_agent is silently ignored there — spike
414
- // finding). custom_status set here shows in the sidebar; ttl_ms lets stale
415
- // annotations expire if the reporter dies.
414
+ // finding). What shows in the sidebar is `tokens` on herdr >= 0.7.4 and
415
+ // `custom_status` on <= 0.7.3; the field was REMOVED from the params in
416
+ // 0.7.4, so sending it there fails the whole request. herdr-presence.ts
417
+ // negotiates which one to send. ttl_ms lets stale annotations expire if the
418
+ // reporter dies.
416
419
  paneReportMetadata: (
417
420
  params: {
418
421
  pane_id: string;
419
422
  source: string;
420
423
  agent?: string;
424
+ tokens?: Record<string, string>;
425
+ state_labels?: Record<string, string>;
421
426
  custom_status?: string;
422
427
  title?: string;
423
428
  display_agent?: string;