@chankov/agent-fleet 2.0.0 → 2.0.1

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 (428) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  4. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  5. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  6. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  7. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  8. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  9. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  10. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  11. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  12. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  13. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  14. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  15. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  16. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  17. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  18. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  19. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  20. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  21. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  22. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  23. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  24. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  25. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  26. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  27. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  28. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  29. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  30. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  31. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  32. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  33. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  34. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  35. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  36. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  37. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  38. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  39. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  40. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  41. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  42. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  43. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  44. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  45. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  46. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  47. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  48. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  49. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  50. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  51. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  52. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  53. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  54. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  55. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  56. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  57. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  58. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  59. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  60. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  61. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  62. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  63. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  64. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  65. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  66. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  67. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  68. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  69. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  70. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  71. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  72. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  74. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  75. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  76. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  77. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  78. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  79. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  80. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  81. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  82. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  83. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  84. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  85. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  86. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  87. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  88. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  89. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  90. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  91. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  92. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  93. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  94. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  95. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  96. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  97. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  98. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  99. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  100. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  101. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  102. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  103. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  104. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  105. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  106. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  107. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  108. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  109. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  110. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  111. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  112. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  113. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  114. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  115. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  116. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  117. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  118. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  119. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  120. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  121. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  122. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  123. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  124. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  125. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  126. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  129. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  130. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  131. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  132. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  133. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  134. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  135. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  136. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  137. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  138. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  139. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  140. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  141. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  142. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  143. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  144. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  145. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  146. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  147. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  148. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  149. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  150. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  151. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  152. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  153. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  154. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  155. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  156. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  157. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  158. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  159. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  160. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  161. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  162. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  163. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  164. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  165. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  166. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  167. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  168. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  169. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  170. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  171. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  172. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  173. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  174. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  175. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  176. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  177. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  178. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  179. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  180. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  181. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  182. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  183. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  184. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  185. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  186. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  187. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  188. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  189. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  190. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  191. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  192. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  193. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  194. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  195. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  196. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  197. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  198. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  199. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  200. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  201. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  202. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  203. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  204. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  205. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  206. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  207. package/.versions/2.0.1/.version +1 -0
  208. package/.versions/2.0.1/agents/architect.md +25 -0
  209. package/.versions/2.0.1/agents/bowser.md +28 -0
  210. package/.versions/2.0.1/agents/builder.md +56 -0
  211. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  212. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  213. package/.versions/2.0.1/agents/documenter.md +22 -0
  214. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  215. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  216. package/.versions/2.0.1/agents/planner.md +73 -0
  217. package/.versions/2.0.1/agents/releaser.md +25 -0
  218. package/.versions/2.0.1/agents/researcher.md +31 -0
  219. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  220. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  221. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  222. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  223. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  224. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  225. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  226. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  227. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  228. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  229. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  230. package/.versions/2.0.1/docs/getting-started.md +119 -0
  231. package/.versions/2.0.1/docs/npm-install.md +292 -0
  232. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  233. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  234. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  235. package/.versions/2.0.1/hermes/README.md +347 -0
  236. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  237. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  238. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  239. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  240. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  241. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  242. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  243. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  244. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  245. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  246. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  247. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  248. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  249. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  250. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  251. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  252. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  253. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  254. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  255. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  256. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  257. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  258. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  259. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  260. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  261. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  262. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  263. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  264. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  265. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  266. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  267. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  268. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  269. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  270. package/.versions/2.0.1/install-manifest.json +2830 -0
  271. package/.versions/2.0.1/justfile +286 -0
  272. package/.versions/2.0.1/manifest-meta.json +913 -0
  273. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  274. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  275. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  276. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  277. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  278. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  279. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  280. package/.versions/2.0.1/references/security-checklist.md +179 -0
  281. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  282. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  283. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  284. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  285. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  286. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  287. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  288. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  289. package/.versions/2.0.1/scripts/flow.ts +121 -0
  290. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  291. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  292. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  293. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  294. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  295. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  296. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  297. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  298. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  299. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  300. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  301. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  302. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  303. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  304. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  305. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  306. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  307. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  308. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  309. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  310. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  311. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  312. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  313. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  314. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  315. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  316. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  317. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  318. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  319. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  320. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  321. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  322. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  323. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  324. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  325. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  326. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  327. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  328. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  329. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  330. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  331. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  332. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  333. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  334. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  335. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  336. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  337. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  338. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  339. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  340. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  341. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  342. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  343. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  344. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  345. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  346. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  347. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  348. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  349. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  350. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  351. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  352. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  353. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  354. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  355. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  356. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  357. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  358. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  359. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  360. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  361. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  362. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  363. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  364. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  365. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  366. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  367. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  368. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  369. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  370. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  371. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  372. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  373. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  374. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  375. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  376. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  377. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  378. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  379. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  380. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  381. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  382. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  383. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  384. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  385. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  386. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  387. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  388. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  389. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  390. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  391. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  392. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  393. package/CHANGELOG.md +7 -0
  394. package/README.md +21 -0
  395. package/agents/code-reviewer.md +1 -0
  396. package/agents/documenter.md +3 -0
  397. package/agents/planner.md +2 -0
  398. package/agents/researcher.md +2 -0
  399. package/docs/ARCHITECTURE.md +3 -0
  400. package/docs/getting-started.md +21 -0
  401. package/docs/workflows.md +136 -0
  402. package/install-manifest.json +86 -1
  403. package/justfile +14 -0
  404. package/manifest-meta.json +32 -1
  405. package/package.json +10 -3
  406. package/references/workflow-authoring.md +304 -0
  407. package/scripts/fleet.ts +13 -0
  408. package/scripts/flow.ts +121 -0
  409. package/scripts/lib/flow-command.ts +77 -0
  410. package/scripts/lib/flow-maintenance.ts +230 -0
  411. package/scripts/workflows/lib/agent-phase.ts +118 -0
  412. package/scripts/workflows/lib/changes.ts +61 -0
  413. package/scripts/workflows/lib/env.ts +34 -0
  414. package/scripts/workflows/lib/envelopes.ts +141 -0
  415. package/scripts/workflows/lib/gates.ts +81 -0
  416. package/scripts/workflows/lib/git.ts +96 -0
  417. package/scripts/workflows/lib/permissions.ts +130 -0
  418. package/scripts/workflows/lib/personas.ts +44 -0
  419. package/scripts/workflows/lib/quality.ts +64 -0
  420. package/scripts/workflows/lib/run.ts +106 -0
  421. package/scripts/workflows/lib/trace.ts +34 -0
  422. package/scripts/workflows/tsconfig.json +22 -0
  423. package/scripts/workflows/wf-build-test.ts +61 -0
  424. package/scripts/workflows/wf-document.ts +50 -0
  425. package/scripts/workflows/wf-quality.ts +20 -0
  426. package/scripts/workflows/wf-scout.ts +38 -0
  427. package/skills/drafting-workflows/SKILL.md +143 -0
  428. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
@@ -0,0 +1,472 @@
1
+ // .pi/harnesses/lib/herdr-client.ts
2
+ //
3
+ // The one shared client for the herdr socket API (https://herdr.dev/docs/socket-api/).
4
+ // Every file in this repo that talks to herdr goes through this module — no other
5
+ // file opens the socket directly.
6
+ //
7
+ // Wire facts this client is built on (validated live against herdr 0.7.1,
8
+ // protocol 14 — see docs/plans/herdr/spike-notes.md):
9
+ // - ndjson over a unix socket; the server closes the connection after each
10
+ // response, so request() opens a fresh connection per call.
11
+ // - events.subscribe is the exception: the connection stays open and streams
12
+ // `{"event":…,"data":…}` lines after a `subscription_started` ack.
13
+ // - Unknown request params are SILENTLY IGNORED by the server (e.g. `pane_id`
14
+ // instead of `target_pane_id` on pane.split retargets the focused pane) —
15
+ // the typed wrappers below exist so callers never hand-write param names.
16
+ // - Parse-level errors come back with an empty id; with one request in flight
17
+ // per connection they are safely attributed to that request.
18
+ //
19
+ // No pi imports; plain Node stdlib; erasable-TS only (runs under node --test).
20
+
21
+ import * as net from "node:net";
22
+ import * as os from "node:os";
23
+ import * as path from "node:path";
24
+
25
+ export interface HerdrErrorShape {
26
+ code: string;
27
+ message: string;
28
+ }
29
+
30
+ export class HerdrRequestError extends Error {
31
+ code: string;
32
+ constructor(err: HerdrErrorShape) {
33
+ super(`herdr: ${err.code}: ${err.message}`);
34
+ this.name = "HerdrRequestError";
35
+ this.code = err.code;
36
+ }
37
+ }
38
+
39
+ export class HerdrUnavailableError extends Error {
40
+ socketPath: string;
41
+ constructor(socketPath: string, cause: string) {
42
+ super(
43
+ `herdr is not running or unreachable (socket: ${socketPath}): ${cause}\n` +
44
+ `Start herdr first (run \`herdr\` in a terminal), or point HERDR_SOCKET_PATH at a running server.`,
45
+ );
46
+ this.name = "HerdrUnavailableError";
47
+ this.socketPath = socketPath;
48
+ }
49
+ }
50
+
51
+ export interface HerdrClientOptions {
52
+ socketPath?: string;
53
+ timeoutMs?: number;
54
+ }
55
+
56
+ export interface PongInfo {
57
+ type: "pong";
58
+ version: string;
59
+ protocol: number;
60
+ capabilities?: Record<string, unknown>;
61
+ [key: string]: unknown;
62
+ }
63
+
64
+ // Minimum server the fleet features are validated against (spike: 0.7.1 / protocol 14).
65
+ export const MIN_PROTOCOL = 14;
66
+ const DEFAULT_TIMEOUT_MS = 5000;
67
+
68
+ // Resolution order: explicit arg → HERDR_SOCKET_PATH (set inside every herdr
69
+ // pane) → the default-session socket. Named sessions always export
70
+ // HERDR_SOCKET_PATH into their panes, so the env var covers them.
71
+ export function resolveSocketPath(explicit?: string): string {
72
+ if (explicit) return explicit;
73
+ if (process.env.HERDR_SOCKET_PATH) return process.env.HERDR_SOCKET_PATH;
74
+ return path.join(os.homedir(), ".config", "herdr", "herdr.sock");
75
+ }
76
+
77
+ interface WireResponse {
78
+ id?: string;
79
+ result?: Record<string, unknown>;
80
+ error?: HerdrErrorShape;
81
+ event?: string;
82
+ data?: unknown;
83
+ }
84
+
85
+ let nextId = 0;
86
+
87
+ // One request → one connection → one response line. Resolves with the raw
88
+ // `result` object (unknown fields pass through untouched); rejects with
89
+ // HerdrRequestError on an error envelope, HerdrUnavailableError when the
90
+ // socket cannot be reached, and a plain Error on timeout.
91
+ export function request<T = Record<string, unknown>>(
92
+ method: string,
93
+ params: Record<string, unknown> = {},
94
+ opts: HerdrClientOptions = {},
95
+ ): Promise<T> {
96
+ const socketPath = resolveSocketPath(opts.socketPath);
97
+ const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
98
+ const id = `as-${process.pid}-${++nextId}`;
99
+
100
+ return new Promise<T>((resolve, reject) => {
101
+ const sock = net.createConnection(socketPath);
102
+ let buf = "";
103
+ let settled = false;
104
+ const timer = setTimeout(() => {
105
+ finish(() => reject(new Error(`herdr: timeout after ${timeoutMs}ms waiting for ${method}`)));
106
+ }, timeoutMs);
107
+
108
+ function finish(f: () => void): void {
109
+ if (settled) return;
110
+ settled = true;
111
+ clearTimeout(timer);
112
+ sock.destroy();
113
+ f();
114
+ }
115
+
116
+ sock.on("connect", () => {
117
+ sock.write(JSON.stringify({ id, method, params }) + "\n");
118
+ });
119
+ sock.on("data", (chunk) => {
120
+ buf += chunk.toString();
121
+ let nl: number;
122
+ while ((nl = buf.indexOf("\n")) !== -1) {
123
+ const line = buf.slice(0, nl).trim();
124
+ buf = buf.slice(nl + 1);
125
+ if (!line) continue;
126
+ let msg: WireResponse;
127
+ try {
128
+ msg = JSON.parse(line);
129
+ } catch {
130
+ continue; // not ours; keep reading until timeout
131
+ }
132
+ // Parse errors arrive with an empty id — with one in-flight request
133
+ // per connection they belong to us. Ignore lines for other ids.
134
+ if (msg.error && (msg.id === id || msg.id === "" || msg.id === undefined)) {
135
+ finish(() => reject(new HerdrRequestError(msg.error as HerdrErrorShape)));
136
+ return;
137
+ }
138
+ if (msg.id === id && msg.result !== undefined) {
139
+ finish(() => resolve(msg.result as T));
140
+ return;
141
+ }
142
+ }
143
+ });
144
+ sock.on("error", (err) => {
145
+ finish(() => reject(new HerdrUnavailableError(socketPath, err.message)));
146
+ });
147
+ sock.on("close", () => {
148
+ finish(() => reject(new Error(`herdr: connection closed before a response to ${method}`)));
149
+ });
150
+ });
151
+ }
152
+
153
+ // Ping and return server info, or null when herdr is not reachable/answering.
154
+ export async function herdrAvailable(opts: HerdrClientOptions = {}): Promise<PongInfo | null> {
155
+ try {
156
+ const pong = await request<PongInfo>("ping", {}, { timeoutMs: 2000, ...opts });
157
+ return pong && pong.type === "pong" ? pong : null;
158
+ } catch {
159
+ return null;
160
+ }
161
+ }
162
+
163
+ // Fail-fast helper used by every fleet entrypoint: resolves with the pong,
164
+ // throws HerdrUnavailableError with an actionable message otherwise.
165
+ export async function requireHerdr(opts: HerdrClientOptions = {}): Promise<PongInfo> {
166
+ const socketPath = resolveSocketPath(opts.socketPath);
167
+ const pong = await herdrAvailable(opts);
168
+ if (!pong) throw new HerdrUnavailableError(socketPath, "no server answered ping");
169
+ if (typeof pong.protocol === "number" && pong.protocol < MIN_PROTOCOL) {
170
+ throw new HerdrUnavailableError(
171
+ socketPath,
172
+ `server protocol ${pong.protocol} is older than the minimum tested protocol ${MIN_PROTOCOL} — update herdr`,
173
+ );
174
+ }
175
+ return pong;
176
+ }
177
+
178
+ // ---------------------------------------------------------------- events
179
+
180
+ // Global topics subscribe as {type}; pane.agent_status_changed and
181
+ // pane.output_matched additionally REQUIRE a concrete pane_id (no wildcard).
182
+ export type Subscription = { type: string; [key: string]: unknown };
183
+
184
+ export interface HerdrEvent {
185
+ event: string;
186
+ data: Record<string, unknown>;
187
+ }
188
+
189
+ export interface SubscribeHandle {
190
+ close(): void;
191
+ }
192
+
193
+ export interface SubscribeOptions extends HerdrClientOptions {
194
+ // Called when the stream (re)establishes — subscriptions are re-sent
195
+ // automatically; use this to reconcile state missed while disconnected.
196
+ onConnect?: () => void;
197
+ onError?: (err: Error) => void;
198
+ reconnectDelayMs?: number;
199
+ }
200
+
201
+ // Long-lived event stream with auto-reconnect. The returned handle's close()
202
+ // stops both the stream and any pending reconnect.
203
+ export function subscribe(
204
+ subscriptions: Subscription[],
205
+ onEvent: (ev: HerdrEvent) => void,
206
+ opts: SubscribeOptions = {},
207
+ ): SubscribeHandle {
208
+ const socketPath = resolveSocketPath(opts.socketPath);
209
+ const reconnectDelayMs = opts.reconnectDelayMs ?? 1000;
210
+ let sock: net.Socket | null = null;
211
+ let closed = false;
212
+ let retryTimer: ReturnType<typeof setTimeout> | null = null;
213
+
214
+ function connect(): void {
215
+ if (closed) return;
216
+ let buf = "";
217
+ let acked = false;
218
+ sock = net.createConnection(socketPath);
219
+ sock.on("connect", () => {
220
+ sock?.write(
221
+ JSON.stringify({ id: "sub", method: "events.subscribe", params: { subscriptions } }) + "\n",
222
+ );
223
+ });
224
+ sock.on("data", (chunk) => {
225
+ buf += chunk.toString();
226
+ let nl: number;
227
+ while ((nl = buf.indexOf("\n")) !== -1) {
228
+ const line = buf.slice(0, nl).trim();
229
+ buf = buf.slice(nl + 1);
230
+ if (!line) continue;
231
+ let msg: WireResponse;
232
+ try {
233
+ msg = JSON.parse(line);
234
+ } catch {
235
+ continue;
236
+ }
237
+ if (!acked && msg.result && (msg.result as { type?: string }).type === "subscription_started") {
238
+ acked = true;
239
+ opts.onConnect?.();
240
+ continue;
241
+ }
242
+ if (!acked && msg.error) {
243
+ opts.onError?.(new HerdrRequestError(msg.error));
244
+ // A rejected subscription will not fix itself by retrying.
245
+ closed = true;
246
+ sock?.destroy();
247
+ return;
248
+ }
249
+ if (msg.event) {
250
+ onEvent({ event: msg.event, data: (msg.data ?? {}) as Record<string, unknown> });
251
+ }
252
+ }
253
+ });
254
+ const scheduleReconnect = () => {
255
+ if (closed || retryTimer) return;
256
+ retryTimer = setTimeout(() => {
257
+ retryTimer = null;
258
+ connect();
259
+ }, reconnectDelayMs);
260
+ };
261
+ sock.on("error", (err) => {
262
+ opts.onError?.(err);
263
+ sock?.destroy();
264
+ scheduleReconnect();
265
+ });
266
+ sock.on("close", scheduleReconnect);
267
+ }
268
+
269
+ connect();
270
+ return {
271
+ close() {
272
+ closed = true;
273
+ if (retryTimer) clearTimeout(retryTimer);
274
+ retryTimer = null;
275
+ sock?.destroy();
276
+ sock = null;
277
+ },
278
+ };
279
+ }
280
+
281
+ // ---------------------------------------------------------------- typed wrappers
282
+ //
283
+ // Thin, param-name-exact wrappers for the methods this repo uses. Response
284
+ // types capture the fields we rely on; everything else passes through.
285
+
286
+ export interface WorkspaceInfo {
287
+ workspace_id: string;
288
+ number?: number;
289
+ label?: string;
290
+ focused?: boolean;
291
+ pane_count?: number;
292
+ tab_count?: number;
293
+ active_tab_id?: string;
294
+ agent_status?: string;
295
+ [key: string]: unknown;
296
+ }
297
+
298
+ export interface PaneInfo {
299
+ pane_id: string;
300
+ terminal_id?: string;
301
+ workspace_id?: string;
302
+ tab_id?: string;
303
+ focused?: boolean;
304
+ cwd?: string;
305
+ label?: string;
306
+ agent?: string;
307
+ agent_status?: string;
308
+ agent_session?: { source?: string; agent?: string; kind?: string; value?: string };
309
+ [key: string]: unknown;
310
+ }
311
+
312
+ // Layout tree nodes for layout.apply: `command` is an ARGV ARRAY (a string is
313
+ // rejected by the server); layout.apply creates a NEW tab in the workspace.
314
+ export type LayoutNode =
315
+ | {
316
+ type: "pane";
317
+ command?: string[];
318
+ cwd?: string;
319
+ label?: string;
320
+ env?: Record<string, string>;
321
+ pane_id?: string;
322
+ }
323
+ | {
324
+ type: "split";
325
+ direction: "right" | "down";
326
+ ratio?: number;
327
+ first: LayoutNode;
328
+ second: LayoutNode;
329
+ };
330
+
331
+ export const herdr = {
332
+ ping: (opts?: HerdrClientOptions) => request<PongInfo>("ping", {}, opts),
333
+
334
+ workspaceCreate: (
335
+ params: { label?: string; cwd?: string; env?: Record<string, string>; focus?: boolean },
336
+ opts?: HerdrClientOptions,
337
+ ) =>
338
+ request<{ workspace: WorkspaceInfo; tab: Record<string, unknown>; root_pane: PaneInfo }>(
339
+ "workspace.create",
340
+ params,
341
+ opts,
342
+ ),
343
+ workspaceList: (opts?: HerdrClientOptions) =>
344
+ request<{ workspaces: WorkspaceInfo[] }>("workspace.list", {}, opts),
345
+ workspaceFocus: (workspace_id: string, opts?: HerdrClientOptions) =>
346
+ request("workspace.focus", { workspace_id }, opts),
347
+ workspaceRename: (workspace_id: string, label: string, opts?: HerdrClientOptions) =>
348
+ request("workspace.rename", { workspace_id, label }, opts),
349
+ workspaceClose: (workspace_id: string, opts?: HerdrClientOptions) =>
350
+ request("workspace.close", { workspace_id }, opts),
351
+
352
+ // NOTE: the target field is `target_pane_id` — `pane_id` would be silently
353
+ // ignored and the FOCUSED pane split instead (spike finding).
354
+ //
355
+ // There is NO `command` param: a split always opens a plain interactive
356
+ // shell in `cwd`. Verified against herdr 0.7.5 — `PaneSplitParams` is
357
+ // {target_pane_id, direction, ratio, cwd, env, focus} and `herdr pane split
358
+ // --help` exposes no command flag. Only `layout.apply` pane nodes carry
359
+ // `command: [argv…]`. This type used to advertise `command?: string[]`;
360
+ // because unknown params are silently ignored, callers got a bare shell
361
+ // pane and a success response. To launch something in a split pane, send
362
+ // the command line as input once the pane is at its shell prompt
363
+ // (paneSendText) — see the herdr_spawn_peer tool in agent-hub.
364
+ paneSplit: (
365
+ params: {
366
+ target_pane_id: string;
367
+ direction: "right" | "down";
368
+ ratio?: number;
369
+ cwd?: string;
370
+ env?: Record<string, string>;
371
+ focus?: boolean;
372
+ },
373
+ opts?: HerdrClientOptions,
374
+ ) => request<{ pane: PaneInfo }>("pane.split", params, opts),
375
+ paneRename: (pane_id: string, label: string, opts?: HerdrClientOptions) =>
376
+ request<{ pane: PaneInfo }>("pane.rename", { pane_id, label }, opts),
377
+ paneSendText: (pane_id: string, text: string, opts?: HerdrClientOptions) =>
378
+ request("pane.send_text", { pane_id, text }, opts),
379
+ paneSendKeys: (pane_id: string, keys: string[], opts?: HerdrClientOptions) =>
380
+ request("pane.send_keys", { pane_id, keys }, opts),
381
+ paneRead: (
382
+ params: {
383
+ pane_id: string;
384
+ source?: "visible" | "recent" | "recent_unwrapped" | "detection";
385
+ lines?: number;
386
+ format?: "text" | "ansi";
387
+ strip_ansi?: boolean;
388
+ },
389
+ opts?: HerdrClientOptions,
390
+ ) =>
391
+ request<{ read: { pane_id: string; text: string; truncated?: boolean; [key: string]: unknown } }>(
392
+ "pane.read",
393
+ { source: "recent", format: "text", strip_ansi: true, ...params },
394
+ opts,
395
+ ),
396
+ paneGet: (pane_id: string, opts?: HerdrClientOptions) =>
397
+ request<{ pane: PaneInfo }>("pane.get", { pane_id }, opts),
398
+ paneList: (params: { workspace_id?: string } = {}, opts?: HerdrClientOptions) =>
399
+ request<{ panes: PaneInfo[] }>("pane.list", params, opts),
400
+ paneClose: (pane_id: string, opts?: HerdrClientOptions) =>
401
+ request("pane.close", { pane_id }, opts),
402
+ // `source` is REQUIRED (client identity herdr uses to arbitrate authority).
403
+ paneReportAgent: (
404
+ params: {
405
+ pane_id: string;
406
+ source: string;
407
+ agent: string;
408
+ state: "idle" | "working" | "blocked" | "unknown";
409
+ message?: string;
410
+ custom_status?: string;
411
+ seq?: number;
412
+ agent_session_id?: string;
413
+ agent_session_path?: string;
414
+ },
415
+ opts?: HerdrClientOptions,
416
+ ) => request("pane.report_agent", params, opts),
417
+ paneReleaseAgent: (
418
+ params: { pane_id: string; source: string; agent: string; seq?: number },
419
+ opts?: HerdrClientOptions,
420
+ ) => request("pane.release_agent", params, opts),
421
+ // Metadata annotations for a pane whose agent authority is held by herdr's
422
+ // built-in detection (report_agent is silently ignored there — spike
423
+ // finding). What shows in the sidebar is `tokens` on herdr >= 0.7.4 and
424
+ // `custom_status` on <= 0.7.3; the field was REMOVED from the params in
425
+ // 0.7.4, so sending it there fails the whole request. herdr-presence.ts
426
+ // negotiates which one to send. ttl_ms lets stale annotations expire if the
427
+ // reporter dies.
428
+ paneReportMetadata: (
429
+ params: {
430
+ pane_id: string;
431
+ source: string;
432
+ agent?: string;
433
+ tokens?: Record<string, string>;
434
+ state_labels?: Record<string, string>;
435
+ custom_status?: string;
436
+ title?: string;
437
+ display_agent?: string;
438
+ ttl_ms?: number;
439
+ seq?: number;
440
+ },
441
+ opts?: HerdrClientOptions,
442
+ ) => request("pane.report_metadata", params, opts),
443
+
444
+ tabClose: (tab_id: string, opts?: HerdrClientOptions) =>
445
+ request("tab.close", { tab_id }, opts),
446
+
447
+ agentList: (opts?: HerdrClientOptions) =>
448
+ request<{ agents: Array<Record<string, unknown>> }>("agent.list", {}, opts),
449
+ agentRead: (
450
+ params: { target: string; source?: string; lines?: number },
451
+ opts?: HerdrClientOptions,
452
+ ) => request("agent.read", params, opts),
453
+
454
+ layoutApply: (
455
+ params: { workspace_id?: string; root: LayoutNode },
456
+ opts?: HerdrClientOptions,
457
+ ) =>
458
+ request<{ layout: { workspace_id: string; tab_id: string; root: unknown } }>(
459
+ "layout.apply",
460
+ params,
461
+ opts,
462
+ ),
463
+ layoutExport: (params: Record<string, unknown> = {}, opts?: HerdrClientOptions) =>
464
+ request<{ layout: Record<string, unknown> }>("layout.export", params, opts),
465
+
466
+ notificationShow: (
467
+ params: { title?: string; body?: string; [key: string]: unknown },
468
+ opts?: HerdrClientOptions,
469
+ ) => request("notification.show", params, opts),
470
+
471
+ subscribe,
472
+ };