@chankov/agent-fleet 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (428) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  4. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  5. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  6. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  7. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  8. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  9. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  10. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  11. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  12. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  13. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  14. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  15. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  16. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  17. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  18. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  19. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  20. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  21. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  22. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  23. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  24. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  25. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  26. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  27. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  28. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  29. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  30. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  31. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  32. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  33. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  34. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  35. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  36. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  37. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  38. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  39. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  40. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  41. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  42. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  43. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  44. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  45. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  46. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  47. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  48. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  49. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  50. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  51. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  52. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  53. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  54. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  55. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  56. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  57. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  58. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  59. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  60. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  61. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  62. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  63. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  64. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  65. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  66. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  67. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  68. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  69. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  70. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  71. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  72. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  74. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  75. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  76. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  77. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  78. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  79. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  80. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  81. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  82. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  83. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  84. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  85. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  86. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  87. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  88. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  89. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  90. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  91. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  92. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  93. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  94. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  95. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  96. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  97. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  98. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  99. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  100. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  101. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  102. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  103. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  104. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  105. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  106. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  107. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  108. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  109. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  110. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  111. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  112. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  113. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  114. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  115. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  116. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  117. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  118. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  119. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  120. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  121. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  122. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  123. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  124. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  125. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  126. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  129. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  130. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  131. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  132. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  133. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  134. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  135. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  136. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  137. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  138. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  139. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  140. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  141. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  142. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  143. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  144. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  145. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  146. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  147. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  148. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  149. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  150. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  151. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  152. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  153. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  154. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  155. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  156. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  157. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  158. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  159. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  160. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  161. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  162. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  163. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  164. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  165. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  166. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  167. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  168. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  169. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  170. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  171. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  172. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  173. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  174. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  175. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  176. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  177. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  178. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  179. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  180. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  181. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  182. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  183. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  184. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  185. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  186. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  187. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  188. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  189. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  190. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  191. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  192. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  193. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  194. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  195. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  196. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  197. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  198. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  199. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  200. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  201. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  202. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  203. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  204. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  205. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  206. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  207. package/.versions/2.0.1/.version +1 -0
  208. package/.versions/2.0.1/agents/architect.md +25 -0
  209. package/.versions/2.0.1/agents/bowser.md +28 -0
  210. package/.versions/2.0.1/agents/builder.md +56 -0
  211. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  212. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  213. package/.versions/2.0.1/agents/documenter.md +22 -0
  214. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  215. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  216. package/.versions/2.0.1/agents/planner.md +73 -0
  217. package/.versions/2.0.1/agents/releaser.md +25 -0
  218. package/.versions/2.0.1/agents/researcher.md +31 -0
  219. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  220. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  221. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  222. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  223. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  224. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  225. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  226. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  227. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  228. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  229. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  230. package/.versions/2.0.1/docs/getting-started.md +119 -0
  231. package/.versions/2.0.1/docs/npm-install.md +292 -0
  232. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  233. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  234. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  235. package/.versions/2.0.1/hermes/README.md +347 -0
  236. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  237. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  238. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  239. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  240. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  241. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  242. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  243. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  244. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  245. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  246. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  247. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  248. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  249. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  250. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  251. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  252. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  253. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  254. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  255. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  256. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  257. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  258. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  259. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  260. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  261. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  262. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  263. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  264. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  265. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  266. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  267. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  268. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  269. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  270. package/.versions/2.0.1/install-manifest.json +2830 -0
  271. package/.versions/2.0.1/justfile +286 -0
  272. package/.versions/2.0.1/manifest-meta.json +913 -0
  273. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  274. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  275. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  276. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  277. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  278. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  279. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  280. package/.versions/2.0.1/references/security-checklist.md +179 -0
  281. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  282. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  283. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  284. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  285. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  286. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  287. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  288. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  289. package/.versions/2.0.1/scripts/flow.ts +121 -0
  290. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  291. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  292. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  293. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  294. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  295. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  296. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  297. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  298. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  299. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  300. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  301. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  302. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  303. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  304. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  305. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  306. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  307. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  308. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  309. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  310. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  311. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  312. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  313. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  314. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  315. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  316. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  317. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  318. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  319. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  320. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  321. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  322. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  323. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  324. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  325. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  326. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  327. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  328. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  329. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  330. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  331. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  332. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  333. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  334. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  335. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  336. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  337. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  338. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  339. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  340. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  341. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  342. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  343. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  344. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  345. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  346. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  347. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  348. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  349. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  350. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  351. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  352. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  353. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  354. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  355. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  356. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  357. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  358. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  359. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  360. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  361. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  362. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  363. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  364. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  365. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  366. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  367. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  368. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  369. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  370. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  371. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  372. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  373. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  374. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  375. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  376. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  377. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  378. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  379. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  380. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  381. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  382. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  383. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  384. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  385. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  386. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  387. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  388. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  389. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  390. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  391. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  392. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  393. package/CHANGELOG.md +7 -0
  394. package/README.md +21 -0
  395. package/agents/code-reviewer.md +1 -0
  396. package/agents/documenter.md +3 -0
  397. package/agents/planner.md +2 -0
  398. package/agents/researcher.md +2 -0
  399. package/docs/ARCHITECTURE.md +3 -0
  400. package/docs/getting-started.md +21 -0
  401. package/docs/workflows.md +136 -0
  402. package/install-manifest.json +86 -1
  403. package/justfile +14 -0
  404. package/manifest-meta.json +32 -1
  405. package/package.json +10 -3
  406. package/references/workflow-authoring.md +304 -0
  407. package/scripts/fleet.ts +13 -0
  408. package/scripts/flow.ts +121 -0
  409. package/scripts/lib/flow-command.ts +77 -0
  410. package/scripts/lib/flow-maintenance.ts +230 -0
  411. package/scripts/workflows/lib/agent-phase.ts +118 -0
  412. package/scripts/workflows/lib/changes.ts +61 -0
  413. package/scripts/workflows/lib/env.ts +34 -0
  414. package/scripts/workflows/lib/envelopes.ts +141 -0
  415. package/scripts/workflows/lib/gates.ts +81 -0
  416. package/scripts/workflows/lib/git.ts +96 -0
  417. package/scripts/workflows/lib/permissions.ts +130 -0
  418. package/scripts/workflows/lib/personas.ts +44 -0
  419. package/scripts/workflows/lib/quality.ts +64 -0
  420. package/scripts/workflows/lib/run.ts +106 -0
  421. package/scripts/workflows/lib/trace.ts +34 -0
  422. package/scripts/workflows/tsconfig.json +22 -0
  423. package/scripts/workflows/wf-build-test.ts +61 -0
  424. package/scripts/workflows/wf-document.ts +50 -0
  425. package/scripts/workflows/wf-quality.ts +20 -0
  426. package/scripts/workflows/wf-scout.ts +38 -0
  427. package/skills/drafting-workflows/SKILL.md +143 -0
  428. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
@@ -0,0 +1,175 @@
1
+ import { copyToClipboard } from "@mariozechner/pi-coding-agent";
2
+ import { Key, matchesKey } from "@mariozechner/pi-tui";
3
+ import type { ModelPolicy } from "../policy/models.ts";
4
+ import type { ResearchState } from "../research/runtime.ts";
5
+ import type { DelegationChild } from "../dispatch-core.ts";
6
+ import type { SpecialistContextManifest } from "../../lib/context-budget-child-prompt.ts";
7
+ import type { TimelineEntry, Zoomable } from "./zoom.ts";
8
+ import type { FleetRow } from "../../lib/fleet-read-model.ts";
9
+ import {
10
+ detailContent, detailEntryOffsets, detailTransition, fleetModelChoices, modelPickerTransition,
11
+ normalizeFleetDetailInput, renderFleetDetail, renderFleetModelPicker, DETAIL_CHROME_ROWS,
12
+ type FleetDetailKey, type FleetModelChoice,
13
+ } from "../../lib/fleet-detail-view.ts";
14
+ import { liveTimeline } from "../../lib/fleet-dashboard-ops.ts";
15
+ import { FULLSCREEN_OVERLAY, bodyRows } from "../../lib/fleet-overlay.ts";
16
+ import { createPanelResources } from "../../lib/fleet-panel.ts";
17
+ import {
18
+ readFleetTranscript, readFleetTranscriptBefore, readFleetTranscriptTail,
19
+ type FleetTranscriptRecord, type FleetTranscriptStore,
20
+ } from "../../lib/fleet-transcript-store.ts";
21
+
22
+ export interface DetailAgentDef {
23
+ name: string;
24
+ description: string;
25
+ tools: string;
26
+ model?: string;
27
+ fallbackModel?: string;
28
+ thinking?: string;
29
+ kind?: string;
30
+ systemPrompt: string;
31
+ file: string;
32
+ subagents?: Record<string, { model: string; fallbackModel?: string; tools?: string }>;
33
+ }
34
+
35
+ export interface DetailAgentState {
36
+ def: DetailAgentDef;
37
+ status: "idle" | "running" | "done" | "error";
38
+ timeline: TimelineEntry[];
39
+ transcriptStore?: FleetTranscriptStore;
40
+ zoomRender?: (force?: boolean) => void;
41
+ specialistManifest?: SpecialistContextManifest;
42
+ }
43
+
44
+ export interface DetailDelegation {
45
+ child: DelegationChild;
46
+ owner: DetailAgentState;
47
+ }
48
+
49
+ export interface DetailUiContext {
50
+ ui: {
51
+ custom(factory: (tui: any, theme: any, kb: any, done: () => void) => any, options: unknown): Promise<unknown>;
52
+ notify(message: string, level: "error" | "info" | "success" | "warning"): void;
53
+ };
54
+ modelRegistry?: {
55
+ refresh?(): Promise<void>;
56
+ getAvailable?(): readonly unknown[];
57
+ getError?(): string | undefined;
58
+ };
59
+ }
60
+
61
+ export interface DetailPanelDeps<TDef extends DetailAgentDef, TAgent extends DetailAgentState, TResearch extends ResearchState<TDef>> {
62
+ getAgent(key: string): TAgent | undefined;
63
+ getResearch(id: number): TResearch | undefined;
64
+ parseResearchHandle(value: string): number | null;
65
+ findDelegationChild(key: string): DetailDelegation | null;
66
+ modelPolicy: ModelPolicy<TDef>;
67
+ displayName(name: string): string;
68
+ shortModel(model: string | undefined): string;
69
+ refreshUi(): void;
70
+ getDispatchPreference(name: string): "native" | "coms";
71
+ maxLiveEntryChars: number;
72
+ }
73
+
74
+ type ModelTarget<TAgent, TResearch> =
75
+ | { kind: "specialist"; current: string; state: TAgent }
76
+ | { kind: "research"; current: string; state: TResearch }
77
+ | { kind: "delegate"; current: string; delegation: DetailDelegation; role: [string, { model: string; fallbackModel?: string; tools?: string }] };
78
+
79
+ export function createDetailPanel<TDef extends DetailAgentDef, TAgent extends DetailAgentState, TResearch extends ResearchState<TDef>>(deps: DetailPanelDeps<TDef, TAgent, TResearch>) {
80
+ function resolveModelTarget(row: FleetRow, ctx: DetailUiContext): ModelTarget<TAgent, TResearch> | null {
81
+ if (row.kind === "peer") { ctx.ui.notify("External coms peers control their own model; switch it in that peer's Pi session.", "info"); return null; }
82
+ if (row.kind === "specialist") {
83
+ const state = deps.getAgent(row.key);
84
+ if (!state) { ctx.ui.notify("This specialist is no longer available.", "warning"); return null; }
85
+ return { kind: "specialist", current: deps.modelPolicy.resolvedModel(state.def as TDef) ?? "", state };
86
+ }
87
+ if (row.kind === "research") {
88
+ const id = deps.parseResearchHandle(row.key);
89
+ const state = id == null ? undefined : deps.getResearch(id);
90
+ if (!state) { ctx.ui.notify("This research helper is no longer available.", "warning"); return null; }
91
+ return { kind: "research", current: state.model, state };
92
+ }
93
+ const delegation = deps.findDelegationChild(row.key);
94
+ if (!delegation) { ctx.ui.notify("This nested delegate is no longer available.", "warning"); return null; }
95
+ const role = Object.entries(delegation.owner.def.subagents ?? {}).find(([name]) => name.toLowerCase() === delegation.child.role.toLowerCase());
96
+ if (!role) { ctx.ui.notify(`The role for ${row.name} is no longer declared by ${deps.displayName(delegation.owner.def.name)}.`, "warning"); return null; }
97
+ return { kind: "delegate", current: deps.modelPolicy.resolvedSubagentModel(delegation.owner.def.name, role[0], role[1].model), delegation, role };
98
+ }
99
+
100
+ async function loadAvailableModelChoices(ctx: DetailUiContext, current?: string): Promise<FleetModelChoice[] | null> {
101
+ try { await ctx.modelRegistry?.refresh?.(); } catch { /* retain last-known models */ }
102
+ const choices = fleetModelChoices(ctx.modelRegistry?.getAvailable?.() ?? [], current);
103
+ if (choices.length === 0) {
104
+ const diagnostic = ctx.modelRegistry?.getError?.();
105
+ ctx.ui.notify(`Pi reports no available models${diagnostic ? `: ${diagnostic}` : "."}`, "warning");
106
+ return null;
107
+ }
108
+ return choices;
109
+ }
110
+
111
+ function applyModel(row: FleetRow, picked: string, ctx: DetailUiContext): boolean {
112
+ const target = resolveModelTarget(row, ctx);
113
+ if (!target) return false;
114
+ const effectivePicked = deps.modelPolicy.substitutedModel(picked) ?? picked;
115
+ if (effectivePicked === target.current) { ctx.ui.notify(`${row.name} is already on ${effectivePicked}`, "info"); return false; }
116
+ let applyHint = "applies on the next run";
117
+ if (target.kind === "specialist") {
118
+ const key = target.state.def.name.toLowerCase();
119
+ deps.modelPolicy.setPersonaOverride(key, picked === target.state.def.model ? undefined : picked);
120
+ applyHint = "applies on the next dispatch";
121
+ } else if (target.kind === "research") {
122
+ target.state.model = picked;
123
+ applyHint = `applies when r${target.state.id} next continues or restarts`;
124
+ } else {
125
+ deps.modelPolicy.setSubagentOverride(target.delegation.owner.def.name, target.role[0], picked === target.role[1].model ? undefined : picked);
126
+ applyHint = `applies on the next ${deps.displayName(target.delegation.owner.def.name)} dispatch`;
127
+ }
128
+ deps.refreshUi();
129
+ ctx.ui.notify(`${row.name} → ${effectivePicked} (${applyHint}; current runs are not interrupted)`, "success");
130
+ if (target.kind === "specialist" && deps.getDispatchPreference(target.state.def.name) === "coms") ctx.ui.notify("This specialist prefers a coms peer; the choice applies to native fallback runs, while the peer keeps its own model.", "info");
131
+ return true;
132
+ }
133
+
134
+ function matchedInput(data: string): string {
135
+ const key: FleetDetailKey | undefined = matchesKey(data, Key.up) ? "up" : matchesKey(data, Key.down) ? "down" : matchesKey(data, Key.pageUp) ? "pageUp" : matchesKey(data, Key.pageDown) ? "pageDown" : matchesKey(data, Key.home) ? "home" : matchesKey(data, Key.end) ? "end" : matchesKey(data, Key.enter) ? "enter" : matchesKey(data, Key.escape) ? "escape" : matchesKey(data, Key.ctrl("c")) ? "copy" : undefined;
136
+ return normalizeFleetDetailInput(data, key);
137
+ }
138
+
139
+ async function openFleetDetail(row: FleetRow, ctx: DetailUiContext, initialVerbose = false): Promise<boolean> {
140
+ const researchId = row.kind === "research" ? deps.parseResearchHandle(row.key) : null;
141
+ const target: Zoomable | undefined = researchId != null ? deps.getResearch(researchId) : row.kind === "delegate" ? deps.findDelegationChild(row.key)?.child : deps.getAgent(row.key);
142
+ const resources = createPanelResources();
143
+ let detailRow = row, modelPicker: { choices: FleetModelChoice[]; index: number; scrollOffset: number } | null = null;
144
+ let scrollOffset = 0, selectedIndex = 0, expandedIndex: number | null = null, followTail = true, verbose = initialVerbose, lastRender = 0;
145
+ const transcriptPath = target?.transcriptStore?.path;
146
+ let transcriptRecords: FleetTranscriptRecord[] | null = transcriptPath ? readFleetTranscriptTail(transcriptPath, { limit: 2000 }).records : null;
147
+ const compactRecords = (records: readonly FleetTranscriptRecord[]): TimelineEntry[] => {
148
+ const entries: TimelineEntry[] = [];
149
+ for (const { event } of records) {
150
+ const current = event as TimelineEntry, last = entries[entries.length - 1];
151
+ const merge = last && last.kind === current.kind && (current.kind === "text" || current.kind === "thinking" || (last.callId && last.callId === current.callId));
152
+ if (merge && last.content.length < deps.maxLiveEntryChars) { const room = deps.maxLiveEntryChars - last.content.length; last.content += current.content.slice(0, room); if (current.content.length > room) entries.push({ ...current, content: current.content.slice(room) }); }
153
+ else entries.push({ ...current });
154
+ }
155
+ return entries;
156
+ };
157
+ const timeline = () => transcriptRecords ? compactRecords(transcriptRecords) : [...liveTimeline(target)] as TimelineEntry[];
158
+ const syncTail = () => { if (!transcriptPath || !transcriptRecords || !followTail) return; const after = transcriptRecords.at(-1)?.endOffset ?? 0; const page = readFleetTranscript(transcriptPath, { after, limit: 500 }); transcriptRecords.push(...page.records); if (transcriptRecords.length > 2000) transcriptRecords.splice(0, transcriptRecords.length - 2000); };
159
+ const loadOlder = () => { if (!transcriptPath || !transcriptRecords) return 0; const before = transcriptRecords[0]?.startOffset ?? 0; if (before <= 0) return 0; const older = readFleetTranscriptBefore(transcriptPath, { before, limit: 500 }).records; transcriptRecords.unshift(...older); if (transcriptRecords.length > 2000) transcriptRecords.splice(2000); return compactRecords(older).length; };
160
+ const loadNewer = () => { if (!transcriptPath || !transcriptRecords) return 0; const newer = readFleetTranscript(transcriptPath, { after: transcriptRecords.at(-1)?.endOffset ?? 0, limit: 500 }).records; if (!newer.length) return 0; transcriptRecords.push(...newer); const overflow = Math.max(0, transcriptRecords.length - 2000); const removed = overflow ? compactRecords(transcriptRecords.slice(0, overflow)).length : 0; if (overflow) transcriptRecords.splice(0, overflow); return removed; };
161
+ const reloadTail = () => { if (transcriptPath) transcriptRecords = readFleetTranscriptTail(transcriptPath, { limit: 2000 }).records; };
162
+ try { await ctx.ui.custom((tui: any, theme: any, _kb: any, done: () => void) => {
163
+ if (target) target.zoomRender = (force?: boolean) => { const now = Date.now(); if (force || now - lastRender > 80) { lastRender = now; tui.requestRender(); } };
164
+ resources.every(2000, () => tui.requestRender());
165
+ return { render: (w: number) => { const body = bodyRows(tui.terminal?.rows, DETAIL_CHROME_ROWS); if (modelPicker) return renderFleetModelPicker(detailRow.name, modelPicker.choices, modelPicker, w, body, theme); syncTail(); const entries = timeline(); if (followTail) { selectedIndex = Math.max(0, entries.length - 1); scrollOffset = Math.max(0, detailContent(entries, w, expandedIndex, verbose, selectedIndex).length - body); } const liveRow = detailRow.status === "running" && detailRow.startedAt != null ? { ...detailRow, elapsed: Date.now() - detailRow.startedAt } : detailRow; return renderFleetDetail(liveRow, entries, scrollOffset, w, body, theme, expandedIndex, verbose, selectedIndex); },
166
+ handleInput: async (data: string) => { const input = matchedInput(data), body = bodyRows(tui.terminal?.rows, DETAIL_CHROME_ROWS); if (modelPicker) { const action = modelPickerTransition(input, modelPicker, modelPicker.choices.length, body); if (action === "cancel") modelPicker = null; else if (action === "select") { const picked = modelPicker.choices[modelPicker.index]?.spec; modelPicker = null; if (picked && applyModel(detailRow, picked, ctx)) { const effective = deps.modelPolicy.substitutedModel(picked) ?? picked; detailRow = { ...detailRow, model: detailRow.status === "running" ? `${detailRow.model} → ${deps.shortModel(effective)} next` : `${deps.shortModel(effective)} (next)` }; } } tui.requestRender(); return; }
167
+ if ((input === "\u001b[A" || input === "k" || input === "\u001b[5~" || input === "\u001b[H") && scrollOffset === 0) selectedIndex += loadOlder(); if (input === "\u001b[F") reloadTail(); let entries = timeline(); if (!followTail && (input === "\u001b[B" || input === "j" || input === "\u001b[6~") && selectedIndex >= entries.length - 1) { selectedIndex = Math.max(0, selectedIndex - loadNewer()); entries = timeline(); }
168
+ const width = tui.terminal?.columns ?? 80, state = { scrollOffset, selectedIndex, expandedIndex, followTail, verbose }, content = detailContent(entries, width, expandedIndex, verbose, selectedIndex), offsets = detailEntryOffsets(entries, width, expandedIndex, verbose); const action = detailTransition(input, state, entries, body, content.length, offsets); ({ scrollOffset, selectedIndex, expandedIndex, followTail, verbose } = state); if (action === "close") done(); else if (action === "copy") { const item = entries[selectedIndex]; if (item) { try { await copyToClipboard(item.content); ctx.ui.notify("Copied selected zoom row", "success"); } catch { ctx.ui.notify("Failed to copy selected zoom row", "error"); } } } else if (action === "model") { const target = resolveModelTarget(detailRow, ctx); if (target) { const choices = await loadAvailableModelChoices(ctx, target.current); if (choices) { const index = choices.findIndex(choice => choice.spec === target.current); modelPicker = { choices, index: Math.max(0, index), scrollOffset: Math.max(0, index) }; } } } tui.requestRender(); },
169
+ invalidate() {}, dispose: () => resources.dispose() };
170
+ }, FULLSCREEN_OVERLAY); } finally { resources.dispose(); if (target) target.zoomRender = undefined; }
171
+ return verbose;
172
+ }
173
+
174
+ return { openFleetDetail, loadAvailableModelChoices };
175
+ }
@@ -0,0 +1,130 @@
1
+ import { Key, matchesKey } from "@mariozechner/pi-tui";
2
+ import type { ChildProcess } from "node:child_process";
3
+ import type { ModelPolicy } from "../policy/models.ts";
4
+ import type { ResearchState } from "../research/runtime.ts";
5
+ import type { DetailAgentDef, DetailAgentState, DetailUiContext } from "./detail-panel.ts";
6
+ import type { DelegationChild } from "../dispatch-core.ts";
7
+ import type { FleetRow, PeerInput, ResearchInput, SpecialistInput } from "../../lib/fleet-read-model.ts";
8
+ import { buildFleetRows, fleetTiming, summarise, unionMs } from "../../lib/fleet-read-model.ts";
9
+ import { attachFleetDashboardTicker, resolveFleetKill, resolveFleetRestart } from "../../lib/fleet-dashboard-ops.ts";
10
+ import { dashboardTransition, renderFleetDashboard, FLEET_CHROME_ROWS, type DashboardConfirm } from "../../lib/fleet-dashboard-view.ts";
11
+ import { modelPickerTransition, renderFleetSubstitutionPicker, type FleetModelChoice } from "../../lib/fleet-detail-view.ts";
12
+ import { FULLSCREEN_OVERLAY, bodyRows, clampScroll } from "../../lib/fleet-overlay.ts";
13
+ import { createPanelResources } from "../../lib/fleet-panel.ts";
14
+ import { reconcileSelection, type Selection } from "../../lib/fleet-selection.ts";
15
+ import type { HistoryEntry } from "./history-store.ts";
16
+
17
+ export interface DashboardAgentState<TDef extends DetailAgentDef> extends DetailAgentState {
18
+ def: TDef;
19
+ task: string;
20
+ toolCount: number;
21
+ elapsed: number;
22
+ lastWork: string;
23
+ contextPct: number;
24
+ contextTokens: number;
25
+ histEntry?: HistoryEntry;
26
+ delegations?: Map<string, DelegationChild>;
27
+ lastBackend?: "native" | "coms";
28
+ comsPeerModel?: string;
29
+ proc?: ChildProcess;
30
+ comsAbort?: () => void;
31
+ killedByOperator?: boolean;
32
+ runCount: number;
33
+ }
34
+
35
+ export interface FleetDashboardDeps<TDef extends DetailAgentDef, TAgent extends DashboardAgentState<TDef>, TResearch extends ResearchState<TDef>> {
36
+ getAgents(): ReadonlyMap<string, TAgent>;
37
+ getResearch(): ReadonlyMap<number, TResearch>;
38
+ getShowFinished(): boolean;
39
+ setShowFinished(value: boolean): void;
40
+ getFilter(): string;
41
+ setFilter(value: string): void;
42
+ getPeerInputs(formatModel?: (model: string) => string): PeerInput[];
43
+ parseResearchHandle(value: string): number | null;
44
+ displayName(name: string): string;
45
+ shortModel(model: string | undefined): string;
46
+ thinkingSuffix(thinking: string | undefined): string;
47
+ modelWithThinking(def: TDef): string;
48
+ resolvedThinking(def: TDef): string | undefined;
49
+ abbreviatePeerModel(model: string): string;
50
+ modelPolicy: ModelPolicy<TDef>;
51
+ loadAvailableModels(ctx: DetailUiContext, current?: string): Promise<FleetModelChoice[] | null>;
52
+ openDetail(row: FleetRow, ctx: DetailUiContext, verbose?: boolean): Promise<boolean>;
53
+ modelWorkBlocked(ctx: DetailUiContext): boolean;
54
+ restartResearch(state: TResearch, ctx: DetailUiContext): void;
55
+ restartSpecialist(state: TAgent, ctx: DetailUiContext): Promise<void>;
56
+ removeResearch(state: TResearch, ctx: DetailUiContext): void;
57
+ killSpecialistProcess(state: TAgent): void;
58
+ abortComs(state: TAgent): void;
59
+ }
60
+
61
+ type SubstitutionPicker = { stage: "source" | "target"; source?: string; choices: FleetModelChoice[]; index: number; scrollOffset: number };
62
+
63
+ export function createFleetDashboard<TDef extends DetailAgentDef, TAgent extends DashboardAgentState<TDef>, TResearch extends ResearchState<TDef>>(deps: FleetDashboardDeps<TDef, TAgent, TResearch>) {
64
+ function fleetRows(unfiltered = false): FleetRow[] {
65
+ const specialists: SpecialistInput[] = Array.from(deps.getAgents().entries()).map(([key, state]) => ({
66
+ key, name: deps.displayName(state.def.name), status: state.status,
67
+ model: state.lastBackend === "coms" ? `⇄ ${deps.shortModel(state.comsPeerModel)}` : deps.modelWithThinking(state.def), backend: state.lastBackend ?? "native",
68
+ contextPct: state.contextPct, contextTokens: state.contextTokens, ...fleetTiming(state.histEntry), toolCount: state.toolCount,
69
+ lastWork: state.lastWork || state.task || state.def.description, hasTimeline: true,
70
+ delegates: Array.from(state.delegations?.values() ?? []).map(child => ({ key: child.id, name: child.role || child.id, status: child.status, model: deps.shortModel(child.model), contextPct: null, contextTokens: child.tokens, elapsed: child.status === "running" ? Date.now() - child.startedAt : child.elapsed, startedAt: child.startedAt, toolCount: child.toolCount, lastWork: child.lastWork, children: [] })),
71
+ }));
72
+ const research: ResearchInput[] = Array.from(deps.getResearch().values()).map(state => ({ key: `r${state.id}`, name: `r${state.id} ${state.persona ? deps.displayName(state.def.name) : "research"}`, status: state.status, model: deps.shortModel(state.model) + deps.thinkingSuffix(deps.resolvedThinking(state.def)), backend: "native", contextPct: state.contextPct, contextTokens: null, ...fleetTiming(state.histEntry), toolCount: state.toolCount, lastWork: state.lastWork || state.task, hasTimeline: true }));
73
+ const peers = deps.getPeerInputs(model => `⇄ ${deps.abbreviatePeerModel(model)}`);
74
+ return buildFleetRows({ specialists, research, peers }, unfiltered ? { showFinished: true } : { showFinished: deps.getShowFinished(), query: deps.getFilter() });
75
+ }
76
+
77
+ function substitutionSourceChoices(): FleetModelChoice[] {
78
+ return deps.modelPolicy.allKnownModels().map(spec => { const target = deps.modelPolicy.getSubstitution(spec); return { spec, label: target ? `${spec} → ${target} (active this session)` : spec }; });
79
+ }
80
+
81
+ async function restartRow(selected: FleetRow, ctx: DetailUiContext): Promise<void> {
82
+ if (deps.modelWorkBlocked(ctx)) return;
83
+ const decision = resolveFleetRestart(selected, {
84
+ researchRestartable: key => { const id = deps.parseResearchHandle(key); const state = id == null ? undefined : deps.getResearch().get(id); return !!(state?.task && state.status !== "running"); },
85
+ specialistRestartable: key => !!deps.getAgents().get(key)?.task,
86
+ });
87
+ if (decision.action === "unsupported") { ctx.ui.notify(decision.message, decision.level); return; }
88
+ if (decision.action === "restart-research") {
89
+ const id = deps.parseResearchHandle(selected.key), state = id == null ? undefined : deps.getResearch().get(id);
90
+ if (!state?.task) { ctx.ui.notify(decision.message.replace("Restarting", "Cannot restart"), "warning"); return; }
91
+ ctx.ui.notify(decision.message, "info"); deps.restartResearch(state, ctx); return;
92
+ }
93
+ const state = deps.getAgents().get(selected.key);
94
+ if (!state?.task) { ctx.ui.notify(decision.message.replace("Restarting", "Cannot restart"), "warning"); return; }
95
+ ctx.ui.notify(decision.message.includes(deps.displayName(state.def.name)) ? decision.message : `Restarting ${deps.displayName(state.def.name)} (fresh)...`, "info");
96
+ await deps.restartSpecialist(state, ctx);
97
+ }
98
+
99
+ function killRow(selected: FleetRow, ctx: DetailUiContext): void {
100
+ const decision = resolveFleetKill(selected, {
101
+ researchExists: key => { const id = deps.parseResearchHandle(key); return id != null && deps.getResearch().has(id); },
102
+ agentHandles: key => { const agent = deps.getAgents().get(key); return agent ? { proc: agent.proc, comsAbort: agent.comsAbort } : undefined; },
103
+ });
104
+ if (decision.action === "kill-research") {
105
+ const id = deps.parseResearchHandle(selected.key), state = id == null ? undefined : deps.getResearch().get(id);
106
+ if (state) { deps.removeResearch(state, ctx); ctx.ui.notify(decision.message, "info"); } else ctx.ui.notify(`Research ${selected.name} is no longer available.`, "warning");
107
+ } else if (decision.action === "kill-proc") {
108
+ const state = deps.getAgents().get(selected.key)!; state.killedByOperator = true; deps.killSpecialistProcess(state); ctx.ui.notify(decision.message, "info");
109
+ } else if (decision.action === "coms-abort") { const state = deps.getAgents().get(selected.key); if (state) deps.abortComs(state); ctx.ui.notify(decision.message, "info"); }
110
+ else ctx.ui.notify(decision.message, decision.level);
111
+ }
112
+
113
+ async function openFleetDashboard(ctx: DetailUiContext, startSubstitution = false): Promise<void> {
114
+ const resources = createPanelResources(), selection: Selection = { index: 0 };
115
+ let scrollOffset = 0, filtering = false, detailVerbose = false, confirm: DashboardConfirm = null;
116
+ let picker: SubstitutionPicker | null = startSubstitution ? { stage: "source", choices: substitutionSourceChoices(), index: 0, scrollOffset: 0 } : null;
117
+ const toInput = (data: string) => matchesKey(data, Key.up) ? "\u001b[A" : matchesKey(data, Key.down) ? "\u001b[B" : matchesKey(data, Key.pageUp) ? "\u001b[5~" : matchesKey(data, Key.pageDown) ? "\u001b[6~" : matchesKey(data, Key.enter) ? "\r" : matchesKey(data, Key.escape) ? "\u001b" : data;
118
+ try { await ctx.ui.custom((tui: any, theme: any, _kb: any, done: () => void) => {
119
+ attachFleetDashboardTicker(resources, () => tui.requestRender());
120
+ return { render: (w: number) => { const rows = fleetRows(); reconcileSelection(selection, rows); const body = bodyRows(tui.terminal?.rows, FLEET_CHROME_ROWS); if (picker) return renderFleetSubstitutionPicker(picker.stage, picker.source, picker.choices, picker, w, body, theme); scrollOffset = clampScroll(scrollOffset, rows.length, body); const summary = summarise(rows); return renderFleetDashboard({ rows, selection, scrollOffset, filterQuery: deps.getFilter(), showFinished: deps.getShowFinished(), confirmation: confirm && confirm.until > Date.now() ? `press ${confirm.action === "kill" ? "x" : "r"} again to ${confirm.action} ${rows.find(row => row.key === confirm!.key)?.name ?? "agent"}` : undefined, summary: { ...summary, wallMs: unionMs(summary.intervals) } }, w, body, theme); },
121
+ handleInput: async (data: string) => { const rows = fleetRows(); reconcileSelection(selection, rows); const body = bodyRows(tui.terminal?.rows, FLEET_CHROME_ROWS), input = toInput(data);
122
+ if (picker) { const action = modelPickerTransition(input, picker, picker.choices.length, body); if (action === "cancel") { if (picker.stage === "target") { const source = picker.source, choices = substitutionSourceChoices(), index = Math.max(0, choices.findIndex(choice => choice.spec === source)); picker = { stage: "source", choices, index, scrollOffset: index }; } else picker = null; } else if (action === "select") { const picked = picker.choices[picker.index]?.spec; if (picked && picker.stage === "source") { const targets = await deps.loadAvailableModels(ctx, deps.modelPolicy.getSubstitution(picked)); if (targets) { const current = deps.modelPolicy.getSubstitution(picked), index = Math.max(0, targets.findIndex(choice => choice.spec === current)); picker = { stage: "target", source: picked, choices: targets, index, scrollOffset: index }; } } else if (picked && picker.source) { await deps.modelPolicy.applySessionSubstitution(picker.source, picked, { loadAvailable: current => deps.loadAvailableModels(ctx, current), notify: (message, level) => ctx.ui.notify(message, level) }); picker = null; } } tui.requestRender(); return; }
123
+ const state = { selection, scrollOffset, filtering, filterQuery: deps.getFilter(), showFinished: deps.getShowFinished(), confirm }, intent = dashboardTransition(input, state, rows, body); ({ scrollOffset, filtering, confirm } = state); deps.setFilter(state.filterQuery); deps.setShowFinished(state.showFinished);
124
+ if (intent === "close") done(); else if (intent === "substitute") { const choices = substitutionSourceChoices(); if (!choices.length) ctx.ui.notify("No configured persona or sub-role models are available as substitution sources.", "warning"); else picker = { stage: "source", choices, index: 0, scrollOffset: 0 }; } else if (intent && typeof intent === "object" && "open" in intent) { const selected = rows.find(row => row.key === intent.open) ?? rows[selection.index]; if (selected) detailVerbose = await deps.openDetail(selected, ctx, detailVerbose); } else if (intent && typeof intent === "object" && "kill" in intent) { const selected = rows.find(row => row.key === intent.kill); if (selected) killRow(selected, ctx); else ctx.ui.notify("Selected fleet row no longer exists.", "warning"); } else if (intent && typeof intent === "object" && "restart" in intent) { const selected = rows.find(row => row.key === intent.restart); if (selected) await restartRow(selected, ctx); } tui.requestRender(); },
125
+ invalidate() {}, dispose: () => resources.dispose() };
126
+ }, FULLSCREEN_OVERLAY); } finally { resources.dispose(); }
127
+ }
128
+
129
+ return { fleetRows, openFleetDashboard };
130
+ }
@@ -0,0 +1,306 @@
1
+ import { Text, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
2
+ import { compactWidgetsEnabled, gridColumnsForItems, renderCardGrid } from "../../lib/fleet-dashboard-ops.ts";
3
+
4
+ type RunStatus = "idle" | "running" | "done" | "error";
5
+ export interface GridAgentDef { name: string; description: string; thinking?: string; }
6
+ export interface GridAgentState { def: GridAgentDef; status: RunStatus; elapsed: number; contextPct: number; lastBackend?: "native" | "coms"; comsPeerModel?: string; }
7
+ export interface GridResearchState { id: number; def: GridAgentDef; persona: boolean; status: RunStatus; elapsed: number; contextPct: number; model: string; turnCount: number; lastWork: string; task: string; }
8
+ export interface GridWidgetContext { ui: { setWidget(name: string, widget: unknown, options?: unknown): void } }
9
+
10
+ export interface GridUIContext {
11
+ getWidgetContext(): GridWidgetContext | null | undefined;
12
+ getViewMode(): "compact" | "off";
13
+ getGridCols(): number;
14
+ getAgentStates(): Map<string, GridAgentState>;
15
+ getResearchStates(): Map<number, GridResearchState>;
16
+ getMarkedAgent(): string | null;
17
+ setMarkedAgent(value: string | null): void;
18
+ isRunningWidgetInstalled(): boolean;
19
+ markRunningWidgetInstalled(): void;
20
+ displayName(name: string): string;
21
+ resolvedThinking(def: GridAgentDef): string | undefined;
22
+ shortModel(model: string | undefined): string;
23
+ thinkingSuffix(rawThinking: string | undefined): string;
24
+ modelWithThinking(def: GridAgentDef): string;
25
+ contextWarnThreshold: number;
26
+ }
27
+
28
+ const CARD_HEIGHT = 4;
29
+
30
+ function truncateCardText(text: string, maxWidth: number): string {
31
+ const width = Math.max(0, maxWidth);
32
+ if (width === 0) return "";
33
+ if (visibleWidth(text) <= width) return text;
34
+ if (width <= 3) return ".".repeat(width);
35
+ return `${truncateToWidth(text, width - 3)}...`;
36
+ }
37
+
38
+ function contextPressure(contextPct: number, deps: GridUIContext): boolean {
39
+ return contextPct >= deps.contextWarnThreshold;
40
+ }
41
+
42
+ function contextLabel(contextPct: number, warn = false): string {
43
+ return `${warn ? "⚠" : ""}${Math.ceil(contextPct)}%`;
44
+ }
45
+
46
+ function cardStatus(status: "idle" | "running" | "done" | "error", elapsed: number): { color: string; text: string } {
47
+ const color = status === "idle" ? "dim"
48
+ : status === "running" ? "accent"
49
+ : status === "done" ? "success" : "error";
50
+ const icon = status === "idle" ? "○"
51
+ : status === "running" ? "●"
52
+ : status === "done" ? "✓" : "✗";
53
+ const time = status !== "idle" ? ` ${Math.round(elapsed / 1000)}s` : "";
54
+ return { color, text: `${icon} ${status}${time}` };
55
+ }
56
+
57
+ function renderCardHeaderLine(
58
+ nameRaw: string,
59
+ contextPct: number,
60
+ modelRaw: string,
61
+ statusRaw: string,
62
+ statusColor: string,
63
+ w: number,
64
+ theme: any,
65
+ warnContext = false,
66
+ ): string {
67
+ const indent = w > 0 ? " " : "";
68
+ const contentWidth = Math.max(0, w - visibleWidth(indent));
69
+ if (contentWidth === 0) return "";
70
+
71
+ const rightRaw = `${modelRaw} ${statusRaw}`;
72
+ const rightWidth = visibleWidth(rightRaw);
73
+ const renderRight = () => theme.fg("dim", `${modelRaw} `) + theme.fg(statusColor, statusRaw);
74
+
75
+ if (rightWidth === contentWidth) return indent + renderRight();
76
+ if (rightWidth > contentWidth) return indent + theme.fg("dim", truncateCardText(rightRaw, contentWidth));
77
+
78
+ const leftBudget = Math.max(0, contentWidth - rightWidth - 1);
79
+ const ctxRaw = contextLabel(contextPct, warnContext);
80
+ const ctxWidth = visibleWidth(ctxRaw);
81
+ let leftVisible = 0;
82
+ let leftStyled = "";
83
+
84
+ if (leftBudget >= ctxWidth) {
85
+ const nameBudget = Math.max(0, leftBudget - ctxWidth - 1);
86
+ const nameText = truncateCardText(nameRaw, nameBudget);
87
+ const ctxStyle = warnContext ? "warning" : "dim";
88
+ if (nameText) {
89
+ leftStyled = theme.fg("accent", theme.bold(nameText)) + theme.fg(ctxStyle, ` ${ctxRaw}`);
90
+ leftVisible = visibleWidth(`${nameText} ${ctxRaw}`);
91
+ } else {
92
+ leftStyled = theme.fg(ctxStyle, ctxRaw);
93
+ leftVisible = ctxWidth;
94
+ }
95
+ } else {
96
+ const ctxText = truncateCardText(ctxRaw, leftBudget);
97
+ leftStyled = theme.fg(warnContext ? "warning" : "dim", ctxText);
98
+ leftVisible = visibleWidth(ctxText);
99
+ }
100
+
101
+ const gap = " ".repeat(Math.max(1, contentWidth - leftVisible - rightWidth));
102
+ return indent + leftStyled + gap + renderRight();
103
+ }
104
+
105
+ function renderWorkLine(workRaw: string, w: number, theme: any): string {
106
+ const indent = w > 0 ? " " : "";
107
+ const maxWorkWidth = Math.max(0, Math.min(50, w - visibleWidth(indent)));
108
+ return indent + theme.fg("muted", truncateCardText(workRaw, maxWorkWidth));
109
+ }
110
+
111
+ function renderBorderedLine(content: string, w: number, theme: any): string {
112
+ return theme.fg("dim", "│")
113
+ + content
114
+ + " ".repeat(Math.max(0, w - visibleWidth(content)))
115
+ + theme.fg("dim", "│");
116
+ }
117
+
118
+ // One-line agent summary for compact view: " Name 42% gpt-5.5 (xh) ● running 12s".
119
+ // nameWidth aligns the name column across the running set; the styled line is
120
+ // truncated to the widget width so ANSI runs never overflow. `model` already
121
+ // carries the thinking badge (modelWithThinking); pass "" to omit it.
122
+ function renderCompactLine(
123
+ nameRaw: string,
124
+ contextPct: number,
125
+ model: string,
126
+ status: { color: string; text: string },
127
+ nameWidth: number,
128
+ width: number,
129
+ theme: any,
130
+ marked = false,
131
+ warnContext = false,
132
+ ): string {
133
+ const vis = visibleWidth(nameRaw);
134
+ const name = vis >= nameWidth ? nameRaw : nameRaw + " ".repeat(nameWidth - vis);
135
+ const ctx = contextLabel(contextPct, warnContext).padStart(4);
136
+ // The marked row (compact-view switcher) gets a `›` lead + a full-width
137
+ // selectedBg highlight, mirroring ZoomUI's selected-row treatment.
138
+ const lead = marked ? theme.fg("accent", "›") : " ";
139
+ const line = lead
140
+ + theme.fg("accent", theme.bold(name))
141
+ + " " + theme.fg(warnContext ? "warning" : "dim", ctx)
142
+ + (model ? " " + theme.fg("dim", model) : "")
143
+ + " " + theme.fg(status.color, status.text);
144
+ const truncated = truncateToWidth(line, width);
145
+ if (!marked) return truncated;
146
+ const pad = " ".repeat(Math.max(0, width - visibleWidth(truncated)));
147
+ return theme.bg("selectedBg", truncated + pad);
148
+ }
149
+
150
+ // A research-helper card. Mirrors renderCard's compact two-line layout while
151
+ // keeping the `rN` handle + persona/anon label + turn in the name slot.
152
+ function renderResearchCard(state: GridResearchState, colWidth: number, theme: any, deps: GridUIContext): string[] {
153
+ const w = Math.max(0, colWidth - 2);
154
+ const status = cardStatus(state.status, state.elapsed);
155
+ const label = state.persona ? deps.displayName(state.def.name) : "research";
156
+ const turnStr = state.turnCount > 1 ? ` ·T${state.turnCount}` : "";
157
+ const headerLine = renderCardHeaderLine(
158
+ `r${state.id} ${label}${turnStr}`,
159
+ state.contextPct,
160
+ deps.shortModel(state.model) + deps.thinkingSuffix(deps.resolvedThinking(state.def)),
161
+ status.text,
162
+ status.color,
163
+ w,
164
+ theme,
165
+ );
166
+ const workRaw = state.lastWork || state.task || state.def.description;
167
+
168
+ return [
169
+ theme.fg("dim", "┌" + "─".repeat(Math.max(0, w)) + "┐"),
170
+ renderBorderedLine(headerLine, w, theme),
171
+ renderBorderedLine(renderWorkLine(workRaw, w, theme), w, theme),
172
+ theme.fg("dim", "└" + "─".repeat(Math.max(0, w)) + "┘"),
173
+ ];
174
+ }
175
+
176
+
177
+ export function createGridUI(deps: GridUIContext) {
178
+ function updateWidget() {
179
+ if (!deps.getWidgetContext()) return;
180
+ installRunningWidget();
181
+
182
+ deps.getWidgetContext()!.ui.setWidget("agent-team", (_tui: any, theme: any) => {
183
+ const text = new Text("", 0, 1);
184
+
185
+ return {
186
+ render(width: number): string[] {
187
+ // The full fleet list is now a separate overlay; this legacy widget is retired.
188
+ return [];
189
+
190
+ },
191
+ invalidate() {
192
+ text.invalidate();
193
+ },
194
+ };
195
+ });
196
+ }
197
+
198
+ // Research helpers render in their own widget row, labelled "research", below the
199
+ // team grid. The widget is removed entirely when no helpers exist so it takes no
200
+ // space on a fresh session.
201
+ function updateResearchWidget() {
202
+ if (!deps.getWidgetContext()) return;
203
+ if (deps.getResearchStates().size === 0) {
204
+ deps.getWidgetContext()!.ui.setWidget("agent-research", undefined);
205
+ return;
206
+ }
207
+ deps.getWidgetContext()!.ui.setWidget("agent-research", (_tui: any, theme: any) => {
208
+ const text = new Text("", 0, 1);
209
+
210
+ return {
211
+ render(width: number): string[] {
212
+ const states = Array.from(deps.getResearchStates().values());
213
+ if (states.length === 0) {
214
+ text.setText("");
215
+ return text.render(width);
216
+ }
217
+
218
+ // Compact mode hides the research grid; running helpers are folded
219
+ // into the belowEditor "agent-running" widget instead.
220
+ if (!compactWidgetsEnabled(deps.getViewMode())) return [];
221
+
222
+ const cols = gridColumnsForItems(deps.getGridCols(), states.length);
223
+ const gap = 1;
224
+ const colWidth = Math.floor((width - gap * (cols - 1)) / cols);
225
+ const labelText = "── research ";
226
+ const header = theme.fg("dim", labelText + "─".repeat(Math.max(0, width - labelText.length)));
227
+ const grid = renderCardGrid(
228
+ states,
229
+ cols,
230
+ CARD_HEIGHT,
231
+ s => renderResearchCard(s, colWidth, theme, deps),
232
+ " ".repeat(gap),
233
+ " ".repeat(Math.max(0, colWidth)),
234
+ );
235
+ text.setText([header, ...grid].join("\n"));
236
+ return text.render(width);
237
+ },
238
+ invalidate() {
239
+ text.invalidate();
240
+ },
241
+ };
242
+ });
243
+ }
244
+
245
+ // The compact running-agents widget, rendered BELOW the editor (between the
246
+ // input box and the footer). Registered once; it re-renders on every frame
247
+ // driven by the existing updateWidget/updateResearchWidget refreshes, reading
248
+ // live state + viewMode each time. In dashboard mode it renders nothing. In
249
+ // compact mode it lists only *running* team specialists and research helpers,
250
+ // one line each — idle/done agents are omitted.
251
+ // Ordered list of switchable subagents for the compact-view marker: running team
252
+ // specialists then running research helpers. main is the session under the input
253
+ // box, so it is never listed. Each entry's `key` matches /af-zoom resolution
254
+ // (lowercase persona name for team, `rN` for research), so Alt+\ can resolve it.
255
+ function switchableAgents(): { key: string; name: string; ctx: number; ctxWarn: boolean; model: string; status: { color: string; text: string } }[] {
256
+ return [
257
+ ...Array.from(deps.getAgentStates().values())
258
+ .filter(a => a.status === "running")
259
+ .map(a => ({
260
+ key: a.def.name.toLowerCase(),
261
+ name: deps.displayName(a.def.name),
262
+ ctx: a.contextPct,
263
+ ctxWarn: contextPressure(a.contextPct, deps),
264
+ model: a.lastBackend === "coms" ? `⇄coms ${deps.shortModel(a.comsPeerModel)}` : deps.modelWithThinking(a.def),
265
+ status: cardStatus(a.status, a.elapsed),
266
+ })),
267
+ ...Array.from(deps.getResearchStates().values())
268
+ .filter(s => s.status === "running")
269
+ .map(s => ({
270
+ key: `r${s.id}`,
271
+ name: `r${s.id} ${s.persona ? deps.displayName(s.def.name) : "research"}`,
272
+ ctx: s.contextPct,
273
+ ctxWarn: false,
274
+ model: deps.shortModel(s.model) + deps.thinkingSuffix(deps.resolvedThinking(s.def)),
275
+ status: cardStatus(s.status, s.elapsed),
276
+ })),
277
+ ];
278
+ }
279
+
280
+ // Keep markedAgent pointing at a still-running entry: if the marked one is gone
281
+ // (finished/killed), clamp to the nearest surviving entry, or null when empty.
282
+ // Called from the cycle shortcuts and before a zoom.
283
+ function clampMarker() {
284
+ const keys = switchableAgents().map(a => a.key);
285
+ if (keys.length === 0) { deps.setMarkedAgent(null); return; }
286
+ if (deps.getMarkedAgent() && keys.includes(deps.getMarkedAgent()!)) return;
287
+ deps.setMarkedAgent(keys[0]);
288
+ }
289
+
290
+ function installRunningWidget() {
291
+ if (!deps.getWidgetContext() || deps.isRunningWidgetInstalled()) return;
292
+ deps.markRunningWidgetInstalled();
293
+ deps.getWidgetContext()!.ui.setWidget("agent-running", (_tui: any, theme: any) => ({
294
+ invalidate() {},
295
+ render(width: number): string[] {
296
+ if (!compactWidgetsEnabled(deps.getViewMode())) return [];
297
+ const running = switchableAgents();
298
+ if (running.length === 0) return [];
299
+ const nameWidth = Math.min(24, Math.max(...running.map(r => visibleWidth(r.name))));
300
+ return running.map(r => renderCompactLine(r.name, r.ctx, r.model, r.status, nameWidth, width, theme, r.key === deps.getMarkedAgent(), r.ctxWarn));
301
+ },
302
+ }), { placement: "belowEditor" });
303
+ }
304
+
305
+ return { updateWidget, updateResearchWidget, switchableAgents, clampMarker };
306
+ }