@chankov/agent-fleet 2.0.12 → 2.0.13

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 (616) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +5 -3
  2. package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
  3. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
  4. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  5. package/.pi/agents/model-profiles.yaml +80 -29
  6. package/.pi/agents/peers.yaml +18 -18
  7. package/.pi/agents/voices.yaml +2 -2
  8. package/.pi/harnesses/agent-hub/README.md +55 -4
  9. package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
  10. package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
  12. package/.pi/harnesses/agent-hub/delegate.ts +5 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
  16. package/.pi/harnesses/agent-hub/index.ts +75 -40
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
  19. package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  20. package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  21. package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  22. package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  23. package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  24. package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  25. package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  26. package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  27. package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  28. package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  29. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  30. package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  31. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  32. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
  33. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  34. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
  35. package/.pi/harnesses/agent-hub/return-extract.js +1 -1
  36. package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
  37. package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
  38. package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
  39. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
  40. package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
  41. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
  42. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
  43. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
  44. package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
  45. package/.pi/harnesses/coms/package.json +1 -1
  46. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  47. package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
  48. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
  49. package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
  50. package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
  51. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  52. package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
  53. package/.pi/prompts/af-setup-rules.md +20 -0
  54. package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
  55. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  56. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  57. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  58. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  59. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  60. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  61. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  62. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  63. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  64. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  65. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  66. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  67. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  68. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  69. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  70. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  71. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  72. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  73. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  74. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  75. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  76. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  77. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  78. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  79. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  80. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  81. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  82. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  83. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  84. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  85. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  86. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  87. package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  88. package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  89. package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  90. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  91. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  92. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  93. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  94. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  95. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
  96. package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
  97. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  98. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  99. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  100. package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  101. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  102. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  103. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  104. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  105. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  106. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  107. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  108. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  109. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  110. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  111. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  112. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  113. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  114. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  115. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  116. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  117. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  118. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  119. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  120. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  121. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  122. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  123. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  124. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  125. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  126. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  127. package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
  128. package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
  129. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  130. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  131. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  132. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
  133. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  134. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  135. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  136. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  137. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  138. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  139. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  140. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  141. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  142. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  143. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  144. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  145. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  146. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  147. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  148. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  149. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  150. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  151. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  152. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  153. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  154. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  155. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  156. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  157. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  158. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  159. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  160. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  161. package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
  162. package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
  163. package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
  164. package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
  165. package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
  166. package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
  167. package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
  168. package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
  169. package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
  170. package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
  171. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  172. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  173. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  174. package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
  175. package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
  176. package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
  177. package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
  178. package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
  179. package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
  180. package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
  181. package/.versions/2.0.13/.pi/extensions/package.json +9 -0
  182. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
  183. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
  184. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  185. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
  186. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
  187. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  188. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  189. package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
  190. package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  191. package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  192. package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
  193. package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  194. package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  195. package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  197. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  198. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  199. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  200. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  201. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  202. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  203. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  204. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  205. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  206. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  207. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  208. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  209. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  210. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  211. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  212. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  213. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  214. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  215. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  216. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  217. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  218. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  219. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  220. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  221. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  222. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  223. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  224. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  225. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  226. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  227. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  228. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  229. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  230. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  231. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  232. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  233. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  234. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  235. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  236. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  237. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  238. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
  239. package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  240. package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
  241. package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  242. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  243. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  244. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  245. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  246. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  247. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  248. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  249. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  250. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  251. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  252. package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  253. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  254. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  255. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  256. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  257. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  258. package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  259. package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  260. package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  261. package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  262. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  263. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  264. package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
  265. package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
  266. package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  267. package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
  268. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  269. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  270. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  271. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  272. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  273. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  274. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  275. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  276. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  277. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  278. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  279. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  280. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  281. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  282. package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  283. package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
  284. package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  285. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  286. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  287. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  288. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  289. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  290. package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  291. package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
  292. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  293. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  294. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  295. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  296. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  297. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  298. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  299. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  300. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  301. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  302. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  303. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  304. package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  305. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
  306. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  307. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  308. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
  309. package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  310. package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  311. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  312. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  313. package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  314. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  315. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  316. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  317. package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  318. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
  319. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
  320. package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
  321. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
  322. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  323. package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  324. package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  325. package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  326. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  327. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
  328. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
  329. package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
  330. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  331. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  332. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
  333. package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  334. package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
  335. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  336. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  337. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  338. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  339. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  340. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  341. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  342. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  343. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  344. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  345. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  346. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  347. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  348. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  349. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  350. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  351. package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  352. package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
  353. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  354. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  355. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  356. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  357. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
  358. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  359. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  360. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  361. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  362. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  363. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  364. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  365. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  366. package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  367. package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
  368. package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  369. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  370. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  371. package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  372. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
  373. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
  374. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  375. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  376. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  377. package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
  378. package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
  379. package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
  380. package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
  381. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
  382. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
  383. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
  384. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
  385. package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  386. package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
  387. package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
  388. package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  389. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  390. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  391. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
  392. package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
  393. package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  394. package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  395. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  396. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  397. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  398. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  399. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  400. package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  401. package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  402. package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
  403. package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  404. package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
  405. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  406. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  407. package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  408. package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
  409. package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
  410. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  411. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  412. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  413. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  414. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  415. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  416. package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
  417. package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
  418. package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
  419. package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
  420. package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
  421. package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
  422. package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
  423. package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
  424. package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
  425. package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
  426. package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
  427. package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
  428. package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
  429. package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
  430. package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
  431. package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  432. package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
  433. package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
  434. package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
  435. package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
  436. package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
  437. package/.versions/2.0.13/.version +1 -0
  438. package/.versions/2.0.13/agents/architect.md +24 -0
  439. package/.versions/2.0.13/agents/bowser.md +28 -0
  440. package/.versions/2.0.13/agents/builder.md +55 -0
  441. package/.versions/2.0.13/agents/code-reviewer.md +209 -0
  442. package/.versions/2.0.13/agents/deep-researcher.md +32 -0
  443. package/.versions/2.0.13/agents/documenter.md +22 -0
  444. package/.versions/2.0.13/agents/orchestrator.md +22 -0
  445. package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
  446. package/.versions/2.0.13/agents/planner.md +105 -0
  447. package/.versions/2.0.13/agents/releaser.md +24 -0
  448. package/.versions/2.0.13/agents/researcher.md +30 -0
  449. package/.versions/2.0.13/agents/security-auditor.md +167 -0
  450. package/.versions/2.0.13/agents/test-engineer.md +153 -0
  451. package/.versions/2.0.13/agents/web-debugger.md +44 -0
  452. package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
  453. package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
  454. package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
  455. package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
  456. package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
  457. package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
  458. package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
  459. package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
  460. package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
  461. package/.versions/2.0.13/docs/getting-started.md +126 -0
  462. package/.versions/2.0.13/docs/npm-install.md +468 -0
  463. package/.versions/2.0.13/docs/pi-extensions.md +454 -0
  464. package/.versions/2.0.13/docs/pi-setup.md +92 -0
  465. package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
  466. package/.versions/2.0.13/install-manifest.json +3175 -0
  467. package/.versions/2.0.13/justfile +247 -0
  468. package/.versions/2.0.13/manifest-meta.json +1057 -0
  469. package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
  470. package/.versions/2.0.13/references/communication-contract.md +26 -0
  471. package/.versions/2.0.13/references/definition-of-done.md +67 -0
  472. package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
  473. package/.versions/2.0.13/references/observability-checklist.md +92 -0
  474. package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
  475. package/.versions/2.0.13/references/performance-checklist.md +236 -0
  476. package/.versions/2.0.13/references/prompting-patterns.md +380 -0
  477. package/.versions/2.0.13/references/security-checklist.md +245 -0
  478. package/.versions/2.0.13/references/testing-patterns.md +235 -0
  479. package/.versions/2.0.13/references/workflow-authoring.md +304 -0
  480. package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
  481. package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
  482. package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
  483. package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
  484. package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
  485. package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
  486. package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
  487. package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
  488. package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
  489. package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
  490. package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
  491. package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  492. package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
  493. package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
  494. package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
  495. package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
  496. package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
  497. package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
  498. package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
  499. package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
  500. package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
  501. package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
  502. package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
  503. package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
  504. package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
  505. package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
  506. package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  507. package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
  508. package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
  509. package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
  510. package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
  511. package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
  512. package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
  513. package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
  514. package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
  515. package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
  516. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  517. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  518. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  519. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  520. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  521. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  522. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  524. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  525. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  526. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  527. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  528. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  529. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  530. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  531. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  532. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  533. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  534. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  535. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  536. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  537. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  538. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  539. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  540. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  541. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  542. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  543. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  544. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  545. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  546. package/CHANGELOG.md +10 -0
  547. package/README.md +3 -3
  548. package/agents/architect.md +2 -3
  549. package/agents/bowser.md +2 -2
  550. package/agents/builder.md +2 -3
  551. package/agents/code-reviewer.md +7 -8
  552. package/agents/deep-researcher.md +3 -4
  553. package/agents/documenter.md +2 -3
  554. package/agents/orchestrator.md +2 -3
  555. package/agents/plan-reviewer.md +5 -6
  556. package/agents/planner.md +5 -6
  557. package/agents/releaser.md +2 -3
  558. package/agents/researcher.md +4 -5
  559. package/agents/security-auditor.md +6 -7
  560. package/agents/test-engineer.md +3 -4
  561. package/agents/web-debugger.md +3 -3
  562. package/agents/web-performance-auditor.md +3 -3
  563. package/bin/catalog/harness-runtime-closure.json +30 -18
  564. package/bin/cli.js +47 -1
  565. package/bin/lib/apply.js +16 -0
  566. package/bin/lib/overrides.js +37 -1
  567. package/bin/lib/project-provenance.js +119 -0
  568. package/bin/lib/scan.js +1 -1
  569. package/bin/lib/transaction.js +1 -1
  570. package/bin/lib/validate-overrides.js +37 -3
  571. package/catalog/agent-prompts/README.md +12 -0
  572. package/catalog/agent-prompts/architecture-decision-author.md +24 -0
  573. package/catalog/agent-prompts/requirements-author.md +21 -0
  574. package/catalog/commands/README.md +13 -0
  575. package/catalog/commands/assess-change-impact.md +19 -0
  576. package/catalog/commands/audit-documentation.md +19 -0
  577. package/catalog/rules/README.md +33 -0
  578. package/catalog/rules/ai/policy-authoring.md +22 -0
  579. package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
  580. package/catalog/rules/architecture/public-contracts.md +22 -0
  581. package/catalog/rules/architecture/repository-boundaries.md +21 -0
  582. package/catalog/rules/architecture/structural-change-registration.md +25 -0
  583. package/catalog/rules/backend/notification-date-time.md +25 -0
  584. package/catalog/rules/bundles/README.md +16 -0
  585. package/catalog/rules/data/enum-semantics.md +25 -0
  586. package/catalog/rules/data/mixed-ownership-data.md +22 -0
  587. package/catalog/rules/data/reporting-queries.md +34 -0
  588. package/catalog/rules/docs/docs-maintenance.md +25 -0
  589. package/catalog/rules/frameworks/vue.md +25 -0
  590. package/catalog/rules/frontend/async-ui-states.md +26 -0
  591. package/catalog/rules/frontend/established-ui-primitives.md +25 -0
  592. package/catalog/rules/frontend/form-validation.md +26 -0
  593. package/catalog/rules/frontend/navigation-contracts.md +25 -0
  594. package/catalog/rules/languages/csharp.md +25 -0
  595. package/catalog/rules/languages/javascript.md +25 -0
  596. package/catalog/rules/languages/sql.md +24 -0
  597. package/catalog/rules/security/authorization-before-effects.md +26 -0
  598. package/catalog/rules/security/diagnostic-data-safety.md +22 -0
  599. package/catalog/rules/security/response-data-minimization.md +25 -0
  600. package/catalog/rules/security/trusted-tenant-scope.md +26 -0
  601. package/catalog/rules/testing/shared-package-consumers.md +25 -0
  602. package/catalog/rules/testing/verification-conventions.md +24 -0
  603. package/docs/ARCHITECTURE.md +50 -2
  604. package/docs/agent-fleet-setup.md +246 -28
  605. package/docs/codex-session-bridge.md +1 -1
  606. package/docs/pi-extensions.md +10 -5
  607. package/docs/workflows.md +4 -3
  608. package/install-manifest.json +125 -3
  609. package/manifest-meta.json +77 -15
  610. package/package.json +5 -3
  611. package/skills/repository-ai-setup/SKILL.md +117 -0
  612. package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  613. package/skills/repository-ai-setup/references/apply-contract.md +74 -0
  614. package/skills/repository-ai-setup/references/provenance-template.md +16 -0
  615. package/skills/repository-ai-setup/references/setup-flow.md +108 -0
  616. package/skills/repository-ai-setup/references/verify-setup.md +20 -0
@@ -0,0 +1,1291 @@
1
+ /**
2
+ * Agent Fleet — live sessions, grouped by project.
3
+ *
4
+ * Which Agent Fleet sessions are alive, what they are doing, which of them is
5
+ * waiting on a human — and, for the row you select, a modal with the detail a
6
+ * 300px pane has to truncate plus what can be done about it.
7
+ *
8
+ * Read-only for now. The ask box that handed a prompt to the selected peer was
9
+ * removed deliberately; the backend write door still exists and nothing here
10
+ * calls it (docs/hermes-desktop-plugins.md).
11
+ *
12
+ * Contract (apps/desktop/src/contrib/{plugin,runtime-loader}.ts):
13
+ * - default export { id, name?, register(ctx) }; folder name must equal `id`
14
+ * - only `@hermes/plugin-sdk` and `react*` resolve as bare specifiers, and a
15
+ * RELATIVE import cannot resolve at all — the file is evaluated as a blob.
16
+ * That is why the pure logic below is a verbatim copy of presentation.js,
17
+ * guarded by presentation.test.js.
18
+ * - plain ESM, never transpiled: no JSX syntax, only createElement
19
+ * - this file runs with the full privileges of the app; the backend is what
20
+ * keeps socket paths and pids out of here (dashboard/sessions.py), which is
21
+ * also why every action names `(project, name)` and never an endpoint
22
+ *
23
+ * Backend: /api/plugins/agent-fleet-herdr/{sessions,events,dispatches}, plus a
24
+ * WebSocket at events/stream that accelerates the events poll without replacing
25
+ * it — see docs/hermes-desktop-plugins.md for the install + restart rules.
26
+ */
27
+
28
+ import {
29
+ Button,
30
+ Dialog,
31
+ DialogContent,
32
+ DialogDescription,
33
+ DialogFooter,
34
+ DialogHeader,
35
+ DialogTitle,
36
+ EmptyState,
37
+ host,
38
+ StatusDot,
39
+ useValue
40
+ } from '@hermes/plugin-sdk'
41
+ import { createElement as h, useEffect, useRef, useState } from 'react'
42
+
43
+ // <<< SHARED WITH plugin.js — keep byte-identical >>>
44
+
45
+ // StatusDot tones. `detached` and `unknown` are both "we can't see it", but
46
+ // they arrive from different places: detached = herdr answered and had no pane,
47
+ // unknown = herdr did not answer at all.
48
+ const STATE_TONE = { working: 'good', idle: 'muted', blocked: 'warn', detached: 'bad', unknown: 'bad' }
49
+
50
+ const STATE_LABEL = {
51
+ working: 'working',
52
+ idle: 'idle',
53
+ blocked: 'needs answer',
54
+ detached: 'detached',
55
+ unknown: 'unknown'
56
+ }
57
+
58
+ // A dispatch is a prompt this pane handed to a peer. `failed` never reached the
59
+ // peer at all; `error` reached it and came back refused; `timeout` reached it
60
+ // and was never answered. Three different things to do about it, so three
61
+ // words.
62
+ const DISPATCH_TONE = { pending: 'muted', answered: 'good', error: 'bad', failed: 'bad', timeout: 'warn' }
63
+
64
+ const DISPATCH_LABEL = {
65
+ pending: 'working on it',
66
+ answered: 'answered',
67
+ error: 'refused',
68
+ failed: 'not delivered',
69
+ timeout: 'no answer'
70
+ }
71
+
72
+ function stateTone(state) {
73
+ return STATE_TONE[state] ?? 'bad'
74
+ }
75
+
76
+ function stateLabel(state) {
77
+ return STATE_LABEL[state] ?? 'unknown'
78
+ }
79
+
80
+ function countSessions(projects) {
81
+ return projects.reduce((total, group) => total + (group.sessions?.length ?? 0), 0)
82
+ }
83
+
84
+ function countWaiting(projects) {
85
+ return projects.reduce((total, group) => total + (group.sessions ?? []).filter(s => s.needs_answer).length, 0)
86
+ }
87
+
88
+ function plural(count, noun) {
89
+ return `${count} ${noun}${count === 1 ? '' : 's'}`
90
+ }
91
+
92
+ /** Seconds to something a glance can read: `45s`, `3m12s`, `2h13m`, `3d4h`.
93
+ *
94
+ * Seconds survive up to the hour mark because that is the range a human is
95
+ * watching a turn in; above it, nobody counts seconds. An unusable input —
96
+ * the backend sends `null` for a timestamp it could not parse — returns the
97
+ * empty string, so a caller that forwards it renders nothing rather than
98
+ * "0s", which would be a claim. */
99
+ function formatAge(seconds) {
100
+ if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds < 0) return ''
101
+ const whole = Math.floor(seconds)
102
+ if (whole < 60) return `${whole}s`
103
+ if (whole < 3600) return `${Math.floor(whole / 60)}m${String(whole % 60).padStart(2, '0')}s`
104
+ if (whole < 86400) return `${Math.floor(whole / 3600)}h${Math.floor((whole % 3600) / 60)}m`
105
+
106
+ return `${Math.floor(whole / 86400)}d${Math.floor((whole % 86400) / 3600)}h`
107
+ }
108
+
109
+ /** Why a row cannot be seen, or why it should not be trusted — in a sentence.
110
+ *
111
+ * `detached` used to be the end of the story, which made a herdr that was up
112
+ * but empty look exactly like a peer that had left its pane. `herdrPanes` is
113
+ * the pane count from the payload; `undefined` means the payload predates it,
114
+ * and the answer degrades to the older, vaguer sentence rather than inventing
115
+ * a number. */
116
+ function sessionNote(session, herdrPanes) {
117
+ const state = session.state ?? 'unknown'
118
+
119
+ // Checked before the state, because a stopped heartbeat says something about
120
+ // the PROCESS, while `detached` only says something about our view of it.
121
+ if (session.stale) {
122
+ const age = formatAge(session.heartbeat_age_s)
123
+
124
+ return age ? `no heartbeat for ${age}` : 'no heartbeat'
125
+ }
126
+
127
+ if (state === 'detached') {
128
+ if (herdrPanes === 0) return 'alive — herdr reports no panes at all'
129
+ if (typeof herdrPanes === 'number') return `alive — none of ${plural(herdrPanes, 'herdr pane')} reports it`
130
+
131
+ return 'alive, but no herdr pane reports it'
132
+ }
133
+
134
+ if (state === 'unknown') return 'herdr did not answer — state unknown'
135
+
136
+ return ''
137
+ }
138
+
139
+ /** The pane's own status line: `{ kind, tone, headline, detail, projects }`.
140
+ *
141
+ * `kind` drives which body renders; `tone`/`headline`/`detail` are what the
142
+ * header shows in every case, so the state is legible without reading the
143
+ * payload. */
144
+ function presentSessions(value) {
145
+ const projects = value?.projects ?? []
146
+ const dispatches = value?.dispatches ?? []
147
+ // Every branch below spreads this. The renderer maps over `projects` and
148
+ // `dispatches` unconditionally, so a branch that forgets one is not a missing
149
+ // list — it is a blank pane reading "failed to render". `herdrPanes` rides
150
+ // along because it belongs to the payload, not to any one row, and the rows
151
+ // are what need it.
152
+ const base = { projects, dispatches, herdrPanes: value?.herdr_panes }
153
+
154
+ if (value?.error) {
155
+ const message = String(value.error)
156
+ // The enable gate is middleware in front of routing (web_server.py:576), so
157
+ // a disabled plugin and a missing route are the same 404. Fail closed and
158
+ // calm: this is a configuration answer, not a crash.
159
+ const notEnabled = /\b404\b/.test(message)
160
+
161
+ return {
162
+ ...base,
163
+ kind: 'unavailable',
164
+ tone: 'muted',
165
+ headline: notEnabled ? 'Fleet backend not enabled' : 'Fleet backend unavailable',
166
+ detail: notEnabled
167
+ ? 'hermes plugins enable agent-fleet-herdr && hermes gateway restart'
168
+ : message.slice(0, 200),
169
+ projects: []
170
+ }
171
+ }
172
+
173
+ if (value?.loading) {
174
+ return { ...base, kind: 'loading', tone: 'muted', headline: 'Reading the fleet…', detail: '' }
175
+ }
176
+
177
+ const herdrDown = value?.herdr === false
178
+
179
+ if (projects.length === 0) {
180
+ return {
181
+ ...base,
182
+ kind: 'empty',
183
+ tone: 'muted',
184
+ headline: 'No live Agent Fleet sessions',
185
+ // Two genuinely different situations, two different sentences.
186
+ detail: herdrDown ? 'herdr is not answering either' : 'Nothing registered in the coms registry'
187
+ }
188
+ }
189
+
190
+ const waiting = countWaiting(projects)
191
+
192
+ return {
193
+ ...base,
194
+ kind: 'projects',
195
+ tone: waiting > 0 ? 'warn' : 'good',
196
+ headline:
197
+ waiting > 0
198
+ ? `${plural(waiting, 'agent')} waiting for you`
199
+ : `${plural(countSessions(projects), 'session')} in ${plural(projects.length, 'project')}`,
200
+ detail: herdrDown ? 'herdr not answering — states unknown' : ''
201
+ }
202
+ }
203
+
204
+ /** One sent prompt, already decided. `state` is deliberately absent: whether a
205
+ * peer sits in a herdr pane has nothing to do with whether it can be asked —
206
+ * coms goes to the peer's own socket — so a `detached` agent is a perfectly
207
+ * good target and must not be rendered as an unavailable one. */
208
+ function presentDispatch(dispatch, nowMs = Date.now()) {
209
+ const status = dispatch.status ?? 'pending'
210
+ const label = DISPATCH_LABEL[status] ?? status
211
+ // A turn takes minutes. Without this, `working on it` is indistinguishable
212
+ // from `stuck` for the entire time it matters. A finished dispatch keeps the
213
+ // time it TOOK — `Date.parse` of a missing timestamp is NaN, which is falsy,
214
+ // so an unanswered one ages against now.
215
+ const sentMs = Date.parse(dispatch.sent_at ?? '')
216
+ const untilMs = Date.parse(dispatch.answered_at ?? '') || nowMs
217
+ const age = Number.isFinite(sentMs) ? formatAge((untilMs - sentMs) / 1000) : ''
218
+
219
+ return {
220
+ id: dispatch.msg_id,
221
+ target: `${dispatch.name} · ${dispatch.project}`,
222
+ tone: DISPATCH_TONE[status] ?? 'bad',
223
+ label,
224
+ age,
225
+ prompt: dispatch.prompt ?? '',
226
+ // The reason a failure happened is more use than the answer that is absent.
227
+ body: dispatch.response ?? dispatch.detail ?? '',
228
+ pending: status === 'pending',
229
+ ariaLabel: `${dispatch.prompt ?? ''} — ${label}${age ? ` after ${age}` : ''} by ${dispatch.name}`
230
+ }
231
+ }
232
+
233
+ /** The row a `(project, name)` selection points at, or null.
234
+ *
235
+ * The selection is a pair of strings held by the pane; the row it names is
236
+ * re-found in every payload rather than copied at click time, so an action
237
+ * offered for it is decided on what is true now, not on what was true when it
238
+ * was clicked — and a row that dies while its modal is open says so. */
239
+ function findSession(projects, target) {
240
+ if (!target) return null
241
+ const group = (projects ?? []).find(item => item.project === target.project)
242
+
243
+ return (group?.sessions ?? []).find(session => session.name === target.name) ?? null
244
+ }
245
+
246
+ // What a step in the timeline is. `blocked` is the only one that raises its
247
+ // voice: the agent stopped and is waiting on a person. `done` is muted on
248
+ // purpose — a finished turn is the resting state, not an achievement.
249
+ const ACTIVITY_TONE = { tool: 'muted', assistant: 'good', dispatch: 'good', blocked: 'warn', done: 'muted' }
250
+
251
+ /** `…/activity` -> the timeline, and the one line that says what it is doing.
252
+ *
253
+ * The headline is the whole point of the phase: `working · 3m12s · bash git
254
+ * rev-list…` instead of `working`. It degrades a piece at a time — no
255
+ * timestamp drops the age, no transcript drops everything but the verdict —
256
+ * because a session with nothing on disk to read (a bridged Claude Code peer,
257
+ * a cwd that moved) is ordinary, and must read as an honest absence rather
258
+ * than as a broken panel. */
259
+ function presentActivity(payload, session = {}) {
260
+ const verdict = stateLabel(session?.state ?? 'unknown')
261
+ const blank = { available: false, headline: verdict, note: '', steps: [], seq: 0 }
262
+
263
+ if (!payload || payload.loading) return { ...blank, note: payload?.loading ? 'Reading the transcript…' : '' }
264
+
265
+ if (payload.error) {
266
+ const message = String(payload.error)
267
+ // The route is new; a Desktop that has not restarted since it landed 404s
268
+ // on it while the rest of the pane works perfectly. Naming that is more
269
+ // use than the status code.
270
+ return {
271
+ ...blank,
272
+ note: /\b404\b/.test(message) ? 'Restart Hermes Desktop to pick up the activity route' : message.slice(0, 120)
273
+ }
274
+ }
275
+
276
+ const seq = typeof payload.seq === 'number' ? payload.seq : 0
277
+ if (payload.available !== true) {
278
+ return { ...blank, seq, note: payload.reason || 'no transcript matches this session' }
279
+ }
280
+
281
+ const current = payload.current
282
+ const age = formatAge(current?.since_s)
283
+ const doing = current ? [current.label, current.detail].filter(Boolean).join(' ') : ''
284
+
285
+ return {
286
+ available: true,
287
+ // Joined from whatever survived: `working · 3m12s · bash git status`, or
288
+ // just `working` when the transcript has nothing to add.
289
+ headline: [verdict, age, doing].filter(Boolean).join(' · '),
290
+ note: '',
291
+ steps: (payload.steps ?? []).map((step, index) => ({
292
+ // The list is append-only and `seq` is a byte offset, so this is stable
293
+ // across polls even when one line contributed several steps.
294
+ key: `${step.seq}:${index}`,
295
+ kind: step.kind ?? '',
296
+ tone: ACTIVITY_TONE[step.kind] ?? 'muted',
297
+ label: step.label ?? step.kind ?? '',
298
+ detail: step.detail ?? '',
299
+ ariaLabel: [step.label, step.detail].filter(Boolean).join(' ')
300
+ })),
301
+ seq
302
+ }
303
+ }
304
+
305
+ // The monitor's task vocabulary (hermes-monitor-model.ts). `recovering` is the
306
+ // one that needed a word rather than a state name: the task is alive and the
307
+ // connection to it is not, which is a different worry from either "running" or
308
+ // "failed".
309
+ const TASK_TONE = {
310
+ starting: 'muted',
311
+ running: 'good',
312
+ cancelling: 'warn',
313
+ recovering: 'warn',
314
+ completed: 'muted',
315
+ blocked: 'warn',
316
+ failed: 'bad',
317
+ cancelled: 'muted',
318
+ orphaned: 'bad'
319
+ }
320
+
321
+ const TASK_LABEL = {
322
+ starting: 'starting',
323
+ running: 'running',
324
+ cancelling: 'cancelling…',
325
+ recovering: 'reconnecting',
326
+ completed: 'done',
327
+ blocked: 'needs answer',
328
+ failed: 'failed',
329
+ cancelled: 'cancelled',
330
+ orphaned: 'orphaned'
331
+ }
332
+
333
+ // Cancellable exactly where the backend says so (tasks.ACTIVE_STATES). Kept as
334
+ // its own list rather than "not terminal" so the two ends can be compared by
335
+ // reading them, and a button that would always 422 is never offered.
336
+ const TASK_ACTIVE = ['starting', 'running', 'cancelling', 'recovering']
337
+
338
+ /** `…/tasks` -> the subagent tree, flattened for rendering with a depth.
339
+ *
340
+ * A flat list with `depth` rather than nested arrays: the tree is at most two
341
+ * levels (a hub turn and its specialists), and a renderer that walks a nested
342
+ * structure has to recurse for a shape that cannot get deeper. The indentation
343
+ * is a presentational fact, so it is decided here.
344
+ *
345
+ * `available: false` is the ordinary answer — the monitor is opt-in and most
346
+ * hubs run without it — so it returns a sentence, never an alarm. */
347
+ function presentTasks(payload) {
348
+ const blank = { available: false, note: '', rows: [], running: 0 }
349
+
350
+ if (!payload || payload.loading) return { ...blank, note: payload?.loading ? 'Asking the monitor…' : '' }
351
+
352
+ if (payload.error) {
353
+ const message = String(payload.error)
354
+ // Same 404 as the activity route: a Desktop that has not restarted since
355
+ // this landed has no such route, while everything else in the pane works.
356
+ return {
357
+ ...blank,
358
+ note: /\b404\b/.test(message) ? 'Restart Hermes Desktop to pick up the tasks route' : message.slice(0, 120)
359
+ }
360
+ }
361
+
362
+ if (payload.available !== true) return { ...blank, note: payload.reason || 'no monitored hub for this session' }
363
+
364
+ const rows = []
365
+ let running = 0
366
+ for (const parent of payload.tasks ?? []) {
367
+ for (const [depth, task] of [[0, parent], ...(parent.children ?? []).map(c => [1, c])]) {
368
+ const state = task.state ?? 'orphaned'
369
+ if (TASK_ACTIVE.includes(state)) running += 1
370
+ rows.push({
371
+ key: `${task.hubInstanceId ?? ''}:${task.id}:${task.generation}`,
372
+ depth,
373
+ // The specialist is who it is; the id is only how it is addressed, and
374
+ // a hub turn has no specialist to name.
375
+ label: task.specialist || task.id,
376
+ tone: TASK_TONE[state] ?? 'muted',
377
+ state: TASK_LABEL[state] ?? state,
378
+ // A parent whose own parent was pruned is said out loud — the hierarchy
379
+ // is missing a level and a silently promoted row would misread as a
380
+ // top-level turn.
381
+ note: task.orphaned_parent ? 'parent no longer in the monitor' : '',
382
+ output: task.output ?? '',
383
+ truncated: Boolean(task.truncated),
384
+ canCancel: TASK_ACTIVE.includes(state),
385
+ taskId: task.id,
386
+ generation: task.generation,
387
+ ariaLabel: `${task.specialist || task.id}: ${TASK_LABEL[state] ?? state}`
388
+ })
389
+ }
390
+ }
391
+
392
+ return {
393
+ available: true,
394
+ note: rows.length ? '' : 'this hub has not spawned any subagents',
395
+ rows,
396
+ running
397
+ }
398
+ }
399
+
400
+ /** The modal a selected row opens: everything the 300px row had to truncate,
401
+ * plus what can be done about it.
402
+ *
403
+ * A list of actions rather than a fixed pair of buttons, because the set is
404
+ * what changes: sending a prompt used to live here and will again, and an
405
+ * action that is currently impossible is returned DISABLED with the reason
406
+ * instead of being hidden — "why can't I focus this one" is the question the
407
+ * panel exists to answer.
408
+ *
409
+ * Nothing selected is the resting state, not an error, so it returns a closed
410
+ * modal rather than a complaint. */
411
+ function presentSessionMenu({ target, session, herdrPanes, busy, error, activity, tasks } = {}) {
412
+ if (!target) {
413
+ return {
414
+ open: false,
415
+ title: '',
416
+ state: '',
417
+ note: '',
418
+ description: '',
419
+ facts: [],
420
+ actions: [],
421
+ activity: presentActivity(null),
422
+ tasks: presentTasks(null),
423
+ error: ''
424
+ }
425
+ }
426
+
427
+ const state = session?.state ?? 'unknown'
428
+ // A row that vanished from the payload between the click and this render: the
429
+ // selection is re-found every time (`findSession`), so `null` here means the
430
+ // session is gone, and saying so is better than an empty modal.
431
+ const facts = session
432
+ ? [
433
+ ['Purpose', session.purpose],
434
+ ['Model', session.model],
435
+ ['Directory', session.cwd],
436
+ ['Context', typeof session.context_used_pct === 'number' ? `${session.context_used_pct}%` : ''],
437
+ ['Queue', typeof session.queue_depth === 'number' ? String(session.queue_depth) : ''],
438
+ ['Uptime', formatAge(session.uptime_s)],
439
+ // Absent means the entry was written by a coms too old to carry it —
440
+ // not "just now", so it says nothing at all.
441
+ ['Heartbeat', formatAge(session.heartbeat_age_s) ? `${formatAge(session.heartbeat_age_s)} ago` : ''],
442
+ ['Pane', session.pane_id]
443
+ ]
444
+ .filter(([, value]) => Boolean(value))
445
+ .map(([label, value]) => ({ label, value: String(value) }))
446
+ : []
447
+
448
+ const note = session ? sessionNote(session, herdrPanes) : 'this session is no longer in the registry'
449
+ const timeline = presentActivity(session ? activity : null, session ?? {})
450
+ const subagents = presentTasks(session ? tasks : null)
451
+ const verdict = session ? stateLabel(state) : 'gone'
452
+
453
+ return {
454
+ open: true,
455
+ title: `${target.name} · ${target.project}`,
456
+ state: verdict,
457
+ note,
458
+ // The one line under the title. The transcript wins when it has something
459
+ // to say — `working · 3m12s · bash git status` answers "what is it doing",
460
+ // which `working — ` never could — and the registry's verdict is the
461
+ // fallback, not a second line saying the same word twice.
462
+ //
463
+ // A running subagent count joins it because a hub whose own transcript is
464
+ // idle while three specialists work is the case the panel used to read as
465
+ // "nothing is happening".
466
+ description: [
467
+ timeline.available ? timeline.headline : note ? `${verdict} — ${note}` : verdict,
468
+ subagents.running ? plural(subagents.running, 'subagent') : ''
469
+ ]
470
+ .filter(Boolean)
471
+ .join(' · '),
472
+ facts,
473
+ activity: timeline,
474
+ // The subagents this hub spawned, live, with a Cancel on each. The only
475
+ // part of the modal that can STOP something rather than describe it.
476
+ tasks: subagents,
477
+ actions: [
478
+ {
479
+ id: 'focus',
480
+ label: 'Focus pane',
481
+ // Possible only while herdr reports a pane for this peer. A `detached`
482
+ // row is a live session — coms still reaches its own socket — there is
483
+ // simply nothing to bring to the front.
484
+ enabled: Boolean(session?.workspace_id) && !busy,
485
+ detail: session?.workspace_id
486
+ ? 'Bring the herdr pane running it to the front'
487
+ : 'No herdr pane is hosting this agent right now'
488
+ }
489
+ ],
490
+ error: error ?? ''
491
+ }
492
+ }
493
+
494
+ /** One row, already decided: colour is never the only carrier of "waiting".
495
+ *
496
+ * `herdrPanes` comes from the payload, not from the row, which is why this
497
+ * takes a second argument instead of reading a global. */
498
+ function presentSession(session, { herdrPanes } = {}) {
499
+ const state = session.state ?? 'unknown'
500
+ const note = sessionNote(session, herdrPanes)
501
+ const uptime = formatAge(session.uptime_s)
502
+ const meta = [session.model, session.repo]
503
+
504
+ // Context and queue are what the herdr sidebar shows for the same peer;
505
+ // keeping the vocabulary identical means one glance works in both places.
506
+ if (typeof session.context_used_pct === 'number') meta.push(`ctx ${session.context_used_pct}%`)
507
+ // A queue of zero is the resting state and says nothing worth 4 characters
508
+ // in a 300px pane. A queue that is NOT zero is the reason a peer looks idle
509
+ // while work is waiting.
510
+ if (session.queue_depth) meta.push(`q${session.queue_depth}`)
511
+ if (uptime) meta.push(`up ${uptime}`)
512
+
513
+ return {
514
+ name: session.name,
515
+ tone: stateTone(state),
516
+ label: stateLabel(state),
517
+ // A glyph, not a hue — a red dot is invisible to a third of the reasons
518
+ // people open an accessibility guideline.
519
+ marker: session.needs_answer ? '▲' : '·',
520
+ meta: meta.filter(Boolean).join(' · '),
521
+ note,
522
+ ariaLabel: `${session.name}: ${stateLabel(state)}${session.needs_answer ? ', waiting for an answer' : ''}${note ? `, ${note}` : ''}`
523
+ }
524
+ }
525
+
526
+ // What a fleet transition is worth interrupting for. `error` and `warning` are
527
+ // sticky in the app's notification stack (notifications.ts:defaultDuration),
528
+ // which is the correct behaviour for "somebody is waiting on you" and the wrong
529
+ // one for "a session ended".
530
+ const EVENT_KIND = {
531
+ needs_answer: 'warning',
532
+ stale: 'warning',
533
+ dispatch_failed: 'warning',
534
+ vanished: 'error',
535
+ unblocked: 'info',
536
+ finished: 'info',
537
+ dispatch_answered: 'info',
538
+ throttled: 'info'
539
+ }
540
+
541
+ const EVENT_TITLE = {
542
+ needs_answer: 'Waiting for you',
543
+ stale: 'Heartbeat stopped',
544
+ dispatch_failed: 'Prompt failed',
545
+ vanished: 'Agent vanished',
546
+ unblocked: 'No longer waiting',
547
+ finished: 'Session ended',
548
+ dispatch_answered: 'Answer received',
549
+ throttled: 'Too much at once'
550
+ }
551
+
552
+ /** `/events` -> the toasts to raise and the cursor to resume from.
553
+ *
554
+ * `primed` is false for the very first answer, whose events are whatever
555
+ * survived in the buffer from before this pane existed. Their cursor is taken
556
+ * and their toasts are dropped: a pane opening is not the moment to be told
557
+ * about a question that was answered an hour ago, and the list below is where
558
+ * the current state lives anyway.
559
+ *
560
+ * `after` is what the caller has already shown. Two feeds deliver the same
561
+ * numbered events — the poll and the socket — and either may repeat what the
562
+ * other just delivered, so the cursor is applied HERE rather than trusted to
563
+ * the request: an event at or behind it is one this pane has already raised.
564
+ * For the same reason the returned cursor never goes backwards, so a frame
565
+ * that overtakes another cannot un-see events.
566
+ *
567
+ * The toast id is `(kind, project, name)`, which the app treats as a replace —
568
+ * so an agent that flaps updates one toast instead of stacking a column of
569
+ * them. */
570
+ function presentEvents(payload, primed = true, after = 0) {
571
+ const reported = typeof payload?.seq === 'number' ? payload.seq : 0
572
+ const cursor = typeof after === 'number' && after > 0 ? after : 0
573
+ const events = (primed ? payload?.events ?? [] : []).filter(
574
+ event => typeof event?.seq !== 'number' || event.seq > cursor
575
+ )
576
+
577
+ return {
578
+ seq: Math.max(reported, cursor),
579
+ toasts: events.map(event => ({
580
+ id: `agent-fleet:${event.kind}:${event.project ?? ''}:${event.name ?? ''}`,
581
+ kind: EVENT_KIND[event.kind] ?? 'info',
582
+ title: EVENT_TITLE[event.kind] ?? 'Agent Fleet',
583
+ message: event.message ?? event.kind
584
+ }))
585
+ }
586
+ }
587
+
588
+ // A socket frame this recent means the push transport is delivering. Longer
589
+ // than the server's 20s keepalive so one late frame does not read as a dead
590
+ // connection — `ctx.socket` gives the caller no close event, so "when did it
591
+ // last speak" is the only liveness signal there is.
592
+ const SOCKET_FRESH_MS = 25000
593
+
594
+ // How often to poll anyway while the socket is delivering. Not zero, ever: the
595
+ // stream drops a batch rather than queue it without bound, and this is what
596
+ // picks that batch up. It is the difference between a fallback and a hope.
597
+ const SOCKET_POLL_MS = 30000
598
+
599
+ /** Whether a tick of the events poll should actually fetch.
600
+ *
601
+ * The socket does not replace the poll, it slows it down: with frames
602
+ * arriving, the poll drops from every 5s to every 30s and becomes a safety
603
+ * net; the moment frames stop — a dropped connection, an OAuth remote where
604
+ * `ctx.socket` is a documented no-op — the next tick fetches again. Nothing
605
+ * has to detect the failure, because nothing was ever switched off. */
606
+ function shouldPollEvents({ lastFrameAt = 0, lastPollAt = 0, now = 0 } = {}) {
607
+ if (!lastFrameAt || now - lastFrameAt > SOCKET_FRESH_MS) return true
608
+
609
+ return !lastPollAt || now - lastPollAt >= SOCKET_POLL_MS
610
+ }
611
+
612
+ /** 3s polling with the two guards the monitor pane learned to need
613
+ * (`state.js:createActiveViewController`): no overlapping requests, and an
614
+ * epoch that voids answers arriving after the pane went away. Timer functions
615
+ * are injectable so the whole thing is testable without a DOM.
616
+ *
617
+ * Both feeds run on this — `/sessions` for the list and `/events` for the
618
+ * toasts — because the guards are the same problem in both cases.
619
+ *
620
+ * `shouldPoll` is the third guard, and only the events feed uses it: a tick
621
+ * that answers false is skipped, not cancelled, so the cadence can change
622
+ * without the timer being torn down and rebuilt. */
623
+ function createSessionsPoller({
624
+ fetchSessions,
625
+ onValue,
626
+ intervalMs = 3000,
627
+ shouldPoll = null,
628
+ setTimer = setInterval,
629
+ clearTimer = clearInterval
630
+ }) {
631
+ let timer = null
632
+ let visible = false
633
+ let inFlight = null
634
+ let epoch = 0
635
+
636
+ const poll = () => {
637
+ if (!visible || inFlight) return inFlight
638
+ if (shouldPoll && !shouldPoll()) return null
639
+ const requestEpoch = epoch
640
+ const request = (async () => {
641
+ try {
642
+ const payload = await fetchSessions()
643
+ if (visible && requestEpoch === epoch) onValue(payload)
644
+ } catch (error) {
645
+ if (visible && requestEpoch === epoch) onValue({ error: error?.message ?? String(error) })
646
+ }
647
+ })().finally(() => {
648
+ if (inFlight === request) inFlight = null
649
+ })
650
+
651
+ inFlight = request
652
+
653
+ return request
654
+ }
655
+
656
+ return {
657
+ poll,
658
+ setVisible(next) {
659
+ if (!next) {
660
+ visible = false
661
+ epoch++
662
+ if (timer) clearTimer(timer)
663
+ timer = null
664
+
665
+ return
666
+ }
667
+ visible = true
668
+ if (!timer) timer = setTimer(() => void poll(), intervalMs)
669
+ },
670
+ dispose() {
671
+ visible = false
672
+ epoch++
673
+ if (timer) clearTimer(timer)
674
+ timer = null
675
+ }
676
+ }
677
+ }
678
+
679
+ // <<< END SHARED >>>
680
+
681
+ /** Polls `/sessions` while the window is visible; pauses when it is not. */
682
+ function useSessions(ctx) {
683
+ const [value, setValue] = useState({ loading: true })
684
+ // Held in a ref so sending can force a refresh without the poller being
685
+ // rebuilt on every keystroke.
686
+ const pollerRef = useRef(null)
687
+
688
+ useEffect(() => {
689
+ const documentRef = globalThis.document
690
+ const poller = createSessionsPoller({
691
+ fetchSessions: () => ctx.rest('/sessions'),
692
+ onValue: setValue
693
+ })
694
+ pollerRef.current = poller
695
+ const sync = () => poller.setVisible(!documentRef || documentRef.visibilityState === 'visible')
696
+
697
+ sync()
698
+ void poller.poll()
699
+ documentRef?.addEventListener('visibilitychange', sync)
700
+
701
+ return () => {
702
+ poller.dispose()
703
+ pollerRef.current = null
704
+ documentRef?.removeEventListener('visibilitychange', sync)
705
+ }
706
+ }, [ctx])
707
+
708
+ return [value, () => void pollerRef.current?.poll()]
709
+ }
710
+
711
+ /** Drains `/events` into the app's notification stack, over two feeds.
712
+ *
713
+ * `WS /events/stream` is the fast one and `GET /events` is the one that is
714
+ * always there: `ctx.socket` resolves to nothing on an OAuth remote by design,
715
+ * and a socket can drop at any moment without telling its caller. So the poll
716
+ * never stops — it steps down to every 30s while frames are arriving and back
717
+ * to every 5s the moment they stop (`shouldPollEvents`), which means a broken
718
+ * socket costs latency and nothing else.
719
+ *
720
+ * Both feeds run through ONE handler and ONE cursor. That is what makes them
721
+ * interchangeable rather than additive: the same event delivered twice is
722
+ * filtered by `presentEvents`, so a duplicate is a wasted frame, never a
723
+ * duplicate toast.
724
+ *
725
+ * Deliberately NOT paused on `visibilitychange` the way the list poll is: a
726
+ * hidden window is exactly when a toast about an agent waiting on you is worth
727
+ * raising, and the read is an in-memory ring buffer rather than a herdr
728
+ * subprocess. The pane being mounted at all is the consent.
729
+ *
730
+ * Nothing is rendered from this — the events are the interruption; the list
731
+ * below is the state. */
732
+ function useFleetEvents(ctx) {
733
+ useEffect(() => {
734
+ // Refs, not state: a cursor that re-rendered the pane on every frame would
735
+ // be paying for the privilege of changing nothing on screen.
736
+ const cursor = { seq: 0, primed: false, lastFrameAt: 0, lastPollAt: 0 }
737
+ const consume = payload => {
738
+ // A backend that is down already says so in the header. Repeating it as
739
+ // a toast every 5 seconds would be the noisiest possible way to
740
+ // describe a pane that is visibly empty.
741
+ if (payload?.error) return
742
+ const view = presentEvents(payload, cursor.primed, cursor.seq)
743
+ cursor.seq = view.seq
744
+ cursor.primed = true
745
+ for (const toast of view.toasts) host.notify(toast)
746
+ }
747
+
748
+ const poller = createSessionsPoller({
749
+ fetchSessions: () => ctx.rest(`/events?after=${cursor.seq}`),
750
+ intervalMs: 5000,
751
+ shouldPoll: () =>
752
+ shouldPollEvents({ lastFrameAt: cursor.lastFrameAt, lastPollAt: cursor.lastPollAt, now: Date.now() }),
753
+ onValue: payload => {
754
+ // Stamped even for a failed poll: what this measures is when we last
755
+ // asked, and a backend that is refusing is not a reason to ask less.
756
+ cursor.lastPollAt = Date.now()
757
+ consume(payload)
758
+ }
759
+ })
760
+
761
+ poller.setVisible(true)
762
+ void poller.poll()
763
+
764
+ // `after=0` on purpose: the backlog it replies with is filtered by the
765
+ // cursor the poll may already have advanced, and priming drops it anyway on
766
+ // a cold start. Asking for a cursor that is a moving number would be
767
+ // guessing at a race that costs nothing to lose.
768
+ let closeSocket = null
769
+ try {
770
+ closeSocket = ctx.socket?.('/events/stream?after=0', frame => {
771
+ cursor.lastFrameAt = Date.now()
772
+ consume(frame)
773
+ })
774
+ } catch {
775
+ // An older host without `ctx.socket`, or one that refused the path. The
776
+ // poll above is the feed; there is nothing to report and nothing to fix.
777
+ }
778
+
779
+ return () => {
780
+ poller.dispose()
781
+ closeSocket?.()
782
+ }
783
+ }, [ctx])
784
+ }
785
+
786
+ // Steps kept in the open modal. A long turn produces more than any dialog can
787
+ // show, and the endpoint only ever hands back what is past the cursor — so the
788
+ // cap is here, on the accumulated list, rather than on the request.
789
+ const ACTIVITY_STEPS = 200
790
+
791
+ /** Polls one agent's `/activity` while its modal is open.
792
+ *
793
+ * Only the SELECTED row. The pane lists the whole fleet, and a transcript read
794
+ * per row per 3 seconds would turn a status panel into a disk load; opening
795
+ * the modal is the request for detail.
796
+ *
797
+ * Steps accumulate across polls because the endpoint is cursor-based: it
798
+ * returns what is new since the byte offset we last saw, not the window again.
799
+ * A payload that is not `available` replaces the value instead of extending it
800
+ * — "the transcript went away" is a state, not another step. */
801
+ function useActivity(ctx, target) {
802
+ const [value, setValue] = useState({ loading: true })
803
+ const project = target?.project
804
+ const name = target?.name
805
+
806
+ useEffect(() => {
807
+ if (!project || !name) return undefined
808
+ const cursor = { seq: 0 }
809
+ let steps = []
810
+ const poller = createSessionsPoller({
811
+ fetchSessions: () =>
812
+ ctx.rest(`/sessions/${encodeURIComponent(project)}/${encodeURIComponent(name)}/activity?after=${cursor.seq}`),
813
+ onValue: payload => {
814
+ if (payload?.available !== true) {
815
+ setValue(payload)
816
+
817
+ return
818
+ }
819
+ cursor.seq = typeof payload.seq === 'number' ? payload.seq : cursor.seq
820
+ steps = [...steps, ...(payload.steps ?? [])].slice(-ACTIVITY_STEPS)
821
+ setValue({ ...payload, steps })
822
+ }
823
+ })
824
+
825
+ poller.setVisible(true)
826
+ void poller.poll()
827
+
828
+ return () => poller.dispose()
829
+ }, [ctx, project, name])
830
+
831
+ return value
832
+ }
833
+
834
+ /** Polls one hub's `/tasks` while its modal is open.
835
+ *
836
+ * Same rule as `useActivity` — only the selected row — and for a sharper
837
+ * reason: every poll costs a `herdr agent list` plus one UDS round trip per
838
+ * live subagent, so a per-row version of this would be the most expensive
839
+ * thing the panel does.
840
+ *
841
+ * No cursor and no accumulation, unlike the activity tail: the monitor's
842
+ * snapshot IS the current state of the tree, so each answer REPLACES the last.
843
+ * A task that finished has to stop being listed as running, and a list that
844
+ * only ever grew could not express that.
845
+ *
846
+ * `nonce` re-runs the effect after a Cancel, so the tree does not sit on a
847
+ * stale `running` for up to the poll interval while the process is already
848
+ * dying. */
849
+ function useTasks(ctx, target, nonce) {
850
+ const [value, setValue] = useState({ loading: true })
851
+ const project = target?.project
852
+ const name = target?.name
853
+
854
+ useEffect(() => {
855
+ if (!project || !name) return undefined
856
+ const poller = createSessionsPoller({
857
+ fetchSessions: () => ctx.rest(`/sessions/${encodeURIComponent(project)}/${encodeURIComponent(name)}/tasks`),
858
+ onValue: setValue
859
+ })
860
+
861
+ poller.setVisible(true)
862
+ void poller.poll()
863
+
864
+ return () => poller.dispose()
865
+ }, [ctx, project, name, nonce])
866
+
867
+ return value
868
+ }
869
+
870
+ const secondary = { color: 'var(--ui-text-secondary)' }
871
+
872
+ /** `Date.now()` on a one-second tick, or a frozen clock when `active` is false.
873
+ *
874
+ * Elapsed time has to move on its own: the 3s poll re-renders the row, but a
875
+ * dispatch that is still pending returns byte-identical JSON, and a counter
876
+ * that only advances when the payload changes is a counter that looks stuck
877
+ * exactly while the thing it measures is running. */
878
+ function useNow(active) {
879
+ const [now, setNow] = useState(() => Date.now())
880
+
881
+ useEffect(() => {
882
+ if (!active) return undefined
883
+ const timer = setInterval(() => setNow(Date.now()), 1000)
884
+
885
+ return () => clearInterval(timer)
886
+ }, [active])
887
+
888
+ return now
889
+ }
890
+
891
+ function SessionRow({ session, project, selected, herdrPanes, onSelect }) {
892
+ const row = presentSession(session, { herdrPanes })
893
+
894
+ // A button, not a div with a click handler: opening an agent's actions is a
895
+ // real action, and it has to be reachable from the keyboard.
896
+ return h(
897
+ 'button',
898
+ {
899
+ type: 'button',
900
+ className: 'flex w-full flex-col rounded py-0.5 text-left',
901
+ // Stays highlighted while its modal is open, so the dialog is visibly
902
+ // about THIS row and not about the fleet.
903
+ style: selected ? { background: 'var(--ui-bg-selected, rgba(127,127,127,0.18))' } : undefined,
904
+ role: 'listitem',
905
+ 'aria-label': row.ariaLabel,
906
+ 'aria-haspopup': 'dialog',
907
+ onClick: () => onSelect({ project, name: session.name })
908
+ },
909
+ h(
910
+ 'div',
911
+ { className: 'flex w-full items-baseline gap-2' },
912
+ h('span', { 'aria-hidden': 'true', className: 'w-3 shrink-0 text-center' }, row.marker),
913
+ h(StatusDot, { tone: row.tone }),
914
+ h('span', { className: 'flex-1 truncate font-medium' }, row.name),
915
+ h('span', { className: 'shrink-0', style: session.needs_answer ? undefined : secondary }, row.label)
916
+ ),
917
+ // The second line is where everything that is not the verdict goes, so the
918
+ // first line stays scannable down the column at 300px wide.
919
+ row.meta ? h('div', { className: 'truncate pl-5', style: secondary }, row.meta) : null,
920
+ row.note ? h('div', { className: 'truncate pl-5', style: secondary }, row.note) : null
921
+ )
922
+ }
923
+
924
+ /** What a selected row opens: the detail the pane truncates, and the actions
925
+ * available on that agent.
926
+ *
927
+ * Every action names `(project, name)` and nothing else — the backend resolves
928
+ * the workspace or the socket, so a file running with the full privileges of
929
+ * the app is never holding a handle into another agent's process. An action
930
+ * that cannot be taken right now stays visible and disabled with its reason
931
+ * next to it; a modal that silently omits the button you came for teaches you
932
+ * nothing. */
933
+ function SessionDialog({ ctx, target, session, herdrPanes, onClose, onActed }) {
934
+ const [busy, setBusy] = useState('')
935
+ const [error, setError] = useState('')
936
+ // Bumped by a successful Cancel so the tree re-reads immediately instead of
937
+ // showing `running` for up to 3 more seconds after the kill.
938
+ const [taskNonce, setTaskNonce] = useState(0)
939
+ const activity = useActivity(ctx, target)
940
+ const tasks = useTasks(ctx, target, taskNonce)
941
+ const view = presentSessionMenu({ target, session, herdrPanes, busy: Boolean(busy), error, activity, tasks })
942
+ const timeline = useRef(null)
943
+
944
+ // The newest step is the one being watched, and it is at the bottom. Without
945
+ // this the list silently grows past the fold and looks frozen on whatever was
946
+ // happening when the modal opened.
947
+ useEffect(() => {
948
+ const node = timeline.current
949
+ if (node) node.scrollTop = node.scrollHeight
950
+ }, [view.activity.steps.length])
951
+
952
+ // One door per action id. The map is the whole reason `actions` is a list:
953
+ // adding one is a row here and an entry in presentSessionMenu, not a new
954
+ // component.
955
+ const doors = {
956
+ focus: () =>
957
+ ctx.rest(`/sessions/${encodeURIComponent(target.project)}/${encodeURIComponent(target.name)}/focus`, {
958
+ method: 'POST'
959
+ })
960
+ }
961
+
962
+ /** Stop one subagent. Its own handler rather than an entry in `doors`,
963
+ * because it names a task and the session actions do not — and because the
964
+ * modal stays OPEN afterwards: you cancel one of several children and then
965
+ * watch what the rest do. */
966
+ const cancelTask = async row => {
967
+ if (busy) return
968
+ setBusy(row.key)
969
+ setError('')
970
+ try {
971
+ await ctx.rest(
972
+ `/sessions/${encodeURIComponent(target.project)}/${encodeURIComponent(target.name)}/tasks/${encodeURIComponent(row.taskId)}/${encodeURIComponent(row.generation)}/cancel`,
973
+ { method: 'POST' }
974
+ )
975
+ setTaskNonce(n => n + 1)
976
+ } catch (err) {
977
+ // The backend's 422 detail is the answer — "the task is already
978
+ // completed" — and a Cancel that quietly did nothing is the worse bug.
979
+ setError(err?.message ?? String(err))
980
+ } finally {
981
+ setBusy('')
982
+ }
983
+ }
984
+
985
+ const run = async id => {
986
+ const door = doors[id]
987
+ if (!door || busy) return
988
+ setBusy(id)
989
+ setError('')
990
+ try {
991
+ await door()
992
+ // The row's `focused` flag just changed; a poll that is up to 3s away
993
+ // would leave the pane disagreeing with the screen.
994
+ onActed()
995
+ onClose()
996
+ } catch (err) {
997
+ // The backend's 422 detail IS the answer — "orchestrator is not in a
998
+ // herdr pane" — and an action that quietly did nothing is the worse bug.
999
+ setError(err?.message ?? String(err))
1000
+ } finally {
1001
+ setBusy('')
1002
+ }
1003
+ }
1004
+
1005
+ return h(
1006
+ Dialog,
1007
+ {
1008
+ open: view.open,
1009
+ onOpenChange: next => {
1010
+ if (!next) onClose()
1011
+ }
1012
+ },
1013
+ h(
1014
+ DialogContent,
1015
+ { className: 'text-xs' },
1016
+ h(
1017
+ DialogHeader,
1018
+ null,
1019
+ h(DialogTitle, { className: 'text-sm' }, view.title),
1020
+ // `working · 3m12s · bash git rev-list…` when the transcript can be
1021
+ // read; otherwise the verdict and why it cannot be trusted — the same
1022
+ // sentence the row carries, with room to read it in full.
1023
+ h(DialogDescription, null, view.description)
1024
+ ),
1025
+ view.facts.length
1026
+ ? h(
1027
+ 'dl',
1028
+ { className: 'grid grid-cols-[auto_1fr] gap-x-3 gap-y-0.5' },
1029
+ ...view.facts.flatMap(fact => [
1030
+ h('dt', { key: `${fact.label}-label`, style: secondary }, fact.label),
1031
+ h('dd', { key: `${fact.label}-value`, className: 'break-all' }, fact.value)
1032
+ ])
1033
+ )
1034
+ : null,
1035
+ // What it has actually been doing, read from its own pi transcript. It is
1036
+ // the only part of this modal that works for a `detached` session: the
1037
+ // file is on disk regardless of who is watching.
1038
+ view.activity.steps.length
1039
+ ? h(
1040
+ 'div',
1041
+ {
1042
+ ref: timeline,
1043
+ className: 'flex max-h-48 flex-col gap-0.5 overflow-y-auto',
1044
+ role: 'list',
1045
+ 'aria-label': 'Recent activity'
1046
+ },
1047
+ ...view.activity.steps.map(step =>
1048
+ h(
1049
+ 'div',
1050
+ {
1051
+ key: step.key,
1052
+ className: 'flex items-baseline gap-2',
1053
+ role: 'listitem',
1054
+ 'aria-label': step.ariaLabel
1055
+ },
1056
+ h(StatusDot, { tone: step.tone }),
1057
+ h('span', { className: 'shrink-0' }, step.label),
1058
+ step.detail ? h('span', { className: 'flex-1 truncate', style: secondary }, step.detail) : null
1059
+ )
1060
+ )
1061
+ )
1062
+ : // No timeline is a sentence, not a blank space: "which transcript"
1063
+ // is the question this whole source exists to answer, and a silent
1064
+ // gap would read as a rendering failure.
1065
+ view.activity.note
1066
+ ? h('div', { style: secondary }, view.activity.note)
1067
+ : null,
1068
+ // The subagents this hub spawned. A tree by role rather than by nesting
1069
+ // depth — it is only ever two levels — with the raw stdout of each live
1070
+ // child under it and the one control in this panel that stops something.
1071
+ view.tasks.rows.length
1072
+ ? h(
1073
+ 'div',
1074
+ { className: 'flex flex-col gap-1', role: 'tree', 'aria-label': 'Subagents' },
1075
+ ...view.tasks.rows.map(row =>
1076
+ h(
1077
+ 'div',
1078
+ {
1079
+ key: row.key,
1080
+ className: 'flex flex-col',
1081
+ role: 'treeitem',
1082
+ 'aria-level': row.depth + 1,
1083
+ 'aria-label': row.ariaLabel,
1084
+ // Indentation is the only thing carrying the hierarchy, so it
1085
+ // is paired with aria-level rather than left to the eye.
1086
+ style: row.depth ? { paddingLeft: '1rem' } : undefined
1087
+ },
1088
+ h(
1089
+ 'div',
1090
+ { className: 'flex items-baseline gap-2' },
1091
+ h(StatusDot, { tone: row.tone }),
1092
+ h('span', { className: 'flex-1 truncate font-medium' }, row.label),
1093
+ h('span', { className: 'shrink-0', style: secondary }, row.state),
1094
+ row.canCancel
1095
+ ? h(
1096
+ Button,
1097
+ {
1098
+ type: 'button',
1099
+ size: 'xs',
1100
+ variant: 'text',
1101
+ disabled: Boolean(busy),
1102
+ 'aria-label': `Cancel ${row.label}`,
1103
+ onClick: () => void cancelTask(row)
1104
+ },
1105
+ busy === row.key ? 'Stopping…' : 'Cancel'
1106
+ )
1107
+ : null
1108
+ ),
1109
+ row.note ? h('div', { className: 'truncate pl-5', style: secondary }, row.note) : null,
1110
+ // Raw stdout, monospaced and scrollable — the thing the
1111
+ // transcript projection deliberately does not carry.
1112
+ row.output
1113
+ ? h(
1114
+ 'pre',
1115
+ {
1116
+ className: 'ml-5 max-h-20 overflow-y-auto whitespace-pre-wrap break-all',
1117
+ style: secondary
1118
+ },
1119
+ row.output
1120
+ )
1121
+ : null
1122
+ )
1123
+ )
1124
+ )
1125
+ : // "No monitor" and "a monitor with nothing to report" are different
1126
+ // facts, and presentTasks already phrased both.
1127
+ view.tasks.note
1128
+ ? h('div', { style: secondary }, view.tasks.note)
1129
+ : null,
1130
+ h(
1131
+ 'div',
1132
+ { className: 'flex flex-col gap-1' },
1133
+ ...view.actions.map(action =>
1134
+ h(
1135
+ 'div',
1136
+ { key: action.id, className: 'flex items-baseline justify-between gap-3' },
1137
+ h('span', { style: secondary }, action.detail),
1138
+ h(
1139
+ Button,
1140
+ {
1141
+ type: 'button',
1142
+ size: 'xs',
1143
+ variant: 'secondary',
1144
+ disabled: !action.enabled,
1145
+ 'aria-label': `${action.label} — ${action.detail}`,
1146
+ onClick: () => void run(action.id)
1147
+ },
1148
+ busy === action.id ? 'Working…' : action.label
1149
+ )
1150
+ )
1151
+ )
1152
+ ),
1153
+ view.error ? h('div', { role: 'alert', style: { color: 'var(--ui-text-error, #e06c75)' } }, view.error) : null,
1154
+ h(DialogFooter, null, h(Button, { type: 'button', size: 'xs', variant: 'text', onClick: onClose }, 'Close'))
1155
+ )
1156
+ )
1157
+ }
1158
+
1159
+ function DispatchRow({ dispatch, now }) {
1160
+ const row = presentDispatch(dispatch, now)
1161
+
1162
+ return h(
1163
+ 'div',
1164
+ { className: 'flex flex-col gap-0.5 py-1', role: 'listitem', 'aria-label': row.ariaLabel },
1165
+ h(
1166
+ 'div',
1167
+ { className: 'flex items-baseline gap-2' },
1168
+ h(StatusDot, { tone: row.tone }),
1169
+ h('span', { className: 'flex-1 truncate' }, row.prompt),
1170
+ h('span', { className: 'shrink-0', style: secondary }, row.age ? `${row.label} · ${row.age}` : row.label)
1171
+ ),
1172
+ h('div', { className: 'truncate pl-4', style: secondary }, row.target),
1173
+ row.body
1174
+ ? h('div', { className: 'whitespace-pre-wrap break-words pl-4' }, row.body)
1175
+ : null
1176
+ )
1177
+ }
1178
+
1179
+ function ProjectGroup({ group, selected, herdrPanes, onSelect }) {
1180
+ return h(
1181
+ 'div',
1182
+ { className: 'pt-2', role: 'list', 'aria-label': `${group.project} sessions` },
1183
+ h(
1184
+ 'div',
1185
+ { className: 'flex items-baseline justify-between gap-2 pb-0.5 text-xs font-medium' },
1186
+ h('span', { className: 'truncate' }, group.project),
1187
+ h('span', { style: secondary }, String(group.sessions?.length ?? 0))
1188
+ ),
1189
+ ...(group.sessions ?? []).map(session =>
1190
+ h(SessionRow, {
1191
+ key: `${group.project}:${session.name}`,
1192
+ session,
1193
+ project: group.project,
1194
+ selected: selected?.project === group.project && selected?.name === session.name,
1195
+ herdrPanes,
1196
+ onSelect
1197
+ })
1198
+ )
1199
+ )
1200
+ }
1201
+
1202
+ function FleetPane({ ctx }) {
1203
+ const gateway = useValue(host.state.gateway)
1204
+ const [value, refresh] = useSessions(ctx)
1205
+ const [selected, setSelected] = useState(null)
1206
+ useFleetEvents(ctx)
1207
+ const view = presentSessions(value)
1208
+ // Only ticks while something is actually being waited on — an idle pane has
1209
+ // no reason to re-render once a second.
1210
+ const now = useNow(view.dispatches.some(dispatch => (dispatch.status ?? 'pending') === 'pending'))
1211
+
1212
+ // Nothing to list: the EmptyState says it once, centred. Repeating the same
1213
+ // sentence in a status line above it reads as two different problems.
1214
+ if (view.kind === 'empty' || view.kind === 'unavailable') {
1215
+ return h(
1216
+ 'div',
1217
+ { className: 'flex h-full flex-col p-3 text-xs', role: 'status' },
1218
+ h(EmptyState, { title: view.headline, description: view.detail })
1219
+ )
1220
+ }
1221
+
1222
+ return h(
1223
+ 'div',
1224
+ { className: 'flex h-full flex-col gap-1 p-3 text-xs' },
1225
+ h(
1226
+ 'div',
1227
+ { className: 'flex items-center gap-2 pb-1 text-sm font-medium', role: 'status' },
1228
+ h(StatusDot, { tone: gateway === 'open' ? view.tone : 'muted' }),
1229
+ h('span', { className: 'truncate' }, view.headline)
1230
+ ),
1231
+ view.detail ? h('div', { style: secondary }, view.detail) : null,
1232
+ // Only the list scrolls: the header keeps the fleet's verdict on screen
1233
+ // however long the list gets.
1234
+ h(
1235
+ 'div',
1236
+ { className: 'flex-1 overflow-y-auto' },
1237
+ ...view.projects.map(group =>
1238
+ h(ProjectGroup, { key: group.project, group, selected, herdrPanes: view.herdrPanes, onSelect: setSelected })
1239
+ ),
1240
+ view.dispatches.length
1241
+ ? h(
1242
+ 'div',
1243
+ { className: 'pt-3', role: 'list', 'aria-label': 'Sent prompts' },
1244
+ h('div', { className: 'pb-0.5 text-xs font-medium' }, 'Sent'),
1245
+ ...view.dispatches.map(dispatch => h(DispatchRow, { key: dispatch.msg_id, dispatch, now }))
1246
+ )
1247
+ : null
1248
+ ),
1249
+ // Mounted only while a row is selected, and keyed by it: `busy` and the
1250
+ // last error belong to the agent you opened, not to the next one.
1251
+ selected
1252
+ ? h(SessionDialog, {
1253
+ key: `${selected.project}:${selected.name}`,
1254
+ ctx,
1255
+ target: selected,
1256
+ session: findSession(view.projects, selected),
1257
+ herdrPanes: view.herdrPanes,
1258
+ onClose: () => setSelected(null),
1259
+ onActed: refresh
1260
+ })
1261
+ : null
1262
+ )
1263
+ }
1264
+
1265
+ export default {
1266
+ id: 'agent-fleet-herdr',
1267
+ name: 'Agent Fleet',
1268
+ register(ctx) {
1269
+ ctx.registerMany([
1270
+ {
1271
+ id: 'pane',
1272
+ area: 'panes',
1273
+ title: 'Agent Fleet',
1274
+ data: { placement: 'right', width: '300px' },
1275
+ render: () => h(FleetPane, { ctx })
1276
+ },
1277
+ {
1278
+ id: 'page',
1279
+ area: 'routes',
1280
+ title: 'Agent Fleet',
1281
+ data: { path: '/agent-fleet' },
1282
+ render: () => h(FleetPane, { ctx })
1283
+ },
1284
+ {
1285
+ id: 'nav',
1286
+ area: 'sidebar.nav',
1287
+ data: { codicon: 'organization', label: 'Agent Fleet', path: '/agent-fleet' }
1288
+ }
1289
+ ])
1290
+ }
1291
+ }