@chankov/agent-fleet 1.0.4 → 2.0.0

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 (476) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/CHANGELOG.md +33 -0
  460. package/README.md +5 -5
  461. package/agents/orchestrator.md +3 -1
  462. package/bin/lib/overrides.js +2 -0
  463. package/bin/lib/validate-overrides.js +1 -1
  464. package/docs/ARCHITECTURE.md +42 -13
  465. package/docs/MIGRATION-agent-fleet.md +4 -4
  466. package/docs/agent-fleet-setup.md +15 -15
  467. package/docs/npm-install.md +1 -1
  468. package/docs/pi-extensions.md +16 -18
  469. package/install-manifest.json +1 -1
  470. package/justfile +2 -2
  471. package/package.json +3 -2
  472. package/scripts/fleet.ts +10 -10
  473. package/scripts/lib/fleet-command.ts +15 -11
  474. package/scripts/lib/team-project.ts +2 -2
  475. package/scripts/team-up.ts +10 -10
  476. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -0,0 +1,137 @@
1
+ export type HistoryKind = "orchestrator" | "agent" | "research" | "delegate";
2
+ export type HistoryStatus = "running" | "done" | "error" | "idle";
3
+
4
+ export interface HistoryEntry {
5
+ kind: HistoryKind;
6
+ name: string;
7
+ startedAt: number;
8
+ endedAt: number | null;
9
+ status: HistoryStatus;
10
+ parent: HistoryEntry | null;
11
+ awaitIntervals?: Array<[number, number]>;
12
+ }
13
+
14
+ export interface ExecutionHistoryStore {
15
+ entries(): readonly HistoryEntry[];
16
+ onChange(listener: () => void): () => void;
17
+ start(kind: HistoryKind, name: string, options?: { parent?: HistoryEntry | null; startedAt?: number }): HistoryEntry;
18
+ end(entry: HistoryEntry, status: HistoryStatus, endedAt?: number): void;
19
+ reset(): void;
20
+ startTurn(startedAt?: number): void;
21
+ endTurn(endedAt?: number): void;
22
+ renewTurnStartedAt(startedAt?: number): void;
23
+ turnStartedAt(): number;
24
+ startAskUser(toolCallId: string, startedAt?: number): void;
25
+ endAskUser(toolCallId: string, endedAt?: number): number;
26
+ openAskUserWaitMs(now?: number): number;
27
+ }
28
+
29
+ export function createExecutionHistoryStore(now: () => number = Date.now): ExecutionHistoryStore {
30
+ const history: HistoryEntry[] = [];
31
+ const listeners = new Set<() => void>();
32
+ const askUserStarts = new Map<string, number>();
33
+ const turnAskUserIntervals: Array<[number, number]> = [];
34
+ let currentOrchestrator: HistoryEntry | null = null;
35
+ let turnActive = false;
36
+ let currentTurnStartedAt = 0;
37
+
38
+ const changed = () => { for (const listener of listeners) listener(); };
39
+ const push = (kind: HistoryKind, name: string, parent: HistoryEntry | null, startedAt: number): HistoryEntry => {
40
+ const entry: HistoryEntry = { kind, name, startedAt, endedAt: null, status: "running", parent };
41
+ history.push(entry);
42
+ changed();
43
+ return entry;
44
+ };
45
+ const ensureOrchestrator = (): HistoryEntry | null => {
46
+ if (!turnActive) return null;
47
+ if (!currentOrchestrator) {
48
+ currentOrchestrator = push("orchestrator", "Dispatcher", null, currentTurnStartedAt);
49
+ if (turnAskUserIntervals.length) {
50
+ currentOrchestrator.awaitIntervals = [...turnAskUserIntervals];
51
+ turnAskUserIntervals.length = 0;
52
+ }
53
+ }
54
+ return currentOrchestrator;
55
+ };
56
+ const descendantOf = (node: HistoryEntry, ancestor: HistoryEntry): boolean => {
57
+ let parent = node.parent;
58
+ while (parent) {
59
+ if (parent === ancestor) return true;
60
+ parent = parent.parent;
61
+ }
62
+ return false;
63
+ };
64
+
65
+ return {
66
+ entries: () => history,
67
+ onChange(listener) { listeners.add(listener); return () => listeners.delete(listener); },
68
+ start(kind, name, options = {}) {
69
+ const parent = options.parent !== undefined
70
+ ? options.parent
71
+ : kind === "agent" || kind === "research" ? ensureOrchestrator() : null;
72
+ return push(kind, name, parent, options.startedAt ?? now());
73
+ },
74
+ end(entry, status, endedAt = now()) {
75
+ entry.endedAt = endedAt;
76
+ entry.status = status;
77
+ if (entry.kind !== "delegate") {
78
+ for (const candidate of history) {
79
+ if (candidate.endedAt === null && descendantOf(candidate, entry)) {
80
+ candidate.endedAt = endedAt;
81
+ if (candidate.status === "running") candidate.status = status === "error" ? "error" : "done";
82
+ }
83
+ }
84
+ }
85
+ changed();
86
+ },
87
+ reset() {
88
+ history.length = 0;
89
+ currentOrchestrator = null;
90
+ turnActive = false;
91
+ currentTurnStartedAt = 0;
92
+ askUserStarts.clear();
93
+ turnAskUserIntervals.length = 0;
94
+ changed();
95
+ },
96
+ startTurn(startedAt = now()) {
97
+ if (currentOrchestrator?.endedAt === null) {
98
+ currentOrchestrator.endedAt = startedAt;
99
+ if (currentOrchestrator.status === "running") currentOrchestrator.status = "done";
100
+ }
101
+ turnActive = true;
102
+ currentTurnStartedAt = startedAt;
103
+ currentOrchestrator = null;
104
+ askUserStarts.clear();
105
+ turnAskUserIntervals.length = 0;
106
+ changed();
107
+ },
108
+ endTurn(endedAt = now()) {
109
+ turnActive = false;
110
+ if (currentOrchestrator) {
111
+ currentOrchestrator.endedAt = endedAt;
112
+ if (currentOrchestrator.status === "running") currentOrchestrator.status = "done";
113
+ currentOrchestrator = null;
114
+ }
115
+ currentTurnStartedAt = 0;
116
+ changed();
117
+ },
118
+ renewTurnStartedAt(startedAt = now()) { currentTurnStartedAt = startedAt; },
119
+ turnStartedAt: () => currentTurnStartedAt,
120
+ startAskUser(toolCallId, startedAt = now()) { askUserStarts.set(toolCallId, startedAt); },
121
+ endAskUser(toolCallId, endedAt = now()) {
122
+ const startedAt = askUserStarts.get(toolCallId);
123
+ askUserStarts.delete(toolCallId);
124
+ if (startedAt == null) return 0;
125
+ const interval: [number, number] = [startedAt, endedAt];
126
+ if (currentOrchestrator) (currentOrchestrator.awaitIntervals ??= []).push(interval);
127
+ else turnAskUserIntervals.push(interval);
128
+ changed();
129
+ return Math.max(0, endedAt - startedAt);
130
+ },
131
+ openAskUserWaitMs(at = now()) {
132
+ let total = 0;
133
+ for (const startedAt of askUserStarts.values()) total += Math.max(0, at - startedAt);
134
+ return total;
135
+ },
136
+ };
137
+ }
@@ -0,0 +1,234 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+ import { DynamicBorder } from "@mariozechner/pi-coding-agent";
3
+ import { Text, Container, Spacer, matchesKey, Key, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
4
+ import { FULLSCREEN_OVERLAY, bodyRows, fitToHeight } from "../../lib/fleet-overlay.ts";
5
+ import { createPanelResources } from "../../lib/fleet-panel.ts";
6
+ import { unionMs } from "../../lib/fleet-read-model.ts";
7
+ import type { ExecutionHistoryStore, HistoryEntry } from "./history-store.ts";
8
+
9
+ function fmtDuration(ms: number): string {
10
+ const totalSec = Math.max(0, Math.round(ms / 1000));
11
+ if (totalSec < 60) return `${totalSec}sec`;
12
+ const m = Math.floor(totalSec / 60);
13
+ const s = totalSec % 60;
14
+ return `${m}:${String(s).padStart(2, "0")}min`;
15
+ }
16
+
17
+ export const HISTORY_CHROME_ROWS = 6;
18
+
19
+ export class HistoryUI {
20
+ private scrollOffset = 0;
21
+ private followTail = true;
22
+
23
+ constructor(
24
+ private getEntries: () => HistoryEntry[],
25
+ private getLabel: () => string,
26
+ private onDone: () => void,
27
+ ) {}
28
+
29
+ handleInput(data: string, tui: any): void {
30
+ if (matchesKey(data, Key.up)) {
31
+ this.followTail = false;
32
+ this.scrollOffset = Math.max(0, this.scrollOffset - 1);
33
+ } else if (matchesKey(data, Key.down)) {
34
+ this.followTail = false;
35
+ this.scrollOffset++;
36
+ } else if (matchesKey(data, "g") || matchesKey(data, Key.shift("g"))) {
37
+ this.followTail = true; // jump back to the live tail
38
+ } else if (matchesKey(data, Key.escape) || matchesKey(data, "q") || matchesKey(data, Key.shift("q"))) {
39
+ this.onDone();
40
+ return;
41
+ }
42
+ tui.requestRender();
43
+ }
44
+
45
+ private statusGlyph(e: HistoryEntry, theme: any): string {
46
+ if (e.status === "running") return theme.fg("warning", "●");
47
+ if (e.status === "done") return theme.fg("success", "✓");
48
+ if (e.status === "error") return theme.fg("error", "✗");
49
+ return theme.fg("dim", "⊘");
50
+ }
51
+
52
+ // Pad a styled left segment to the full width with a right-aligned duration.
53
+ // Width math uses visibleWidth (ANSI-aware); the styled string is only truncated
54
+ // when it would actually overflow, so colors stay intact in the common case.
55
+ private rowLine(styledLeft: string, dur: string, width: number, theme: any): string {
56
+ const budget = Math.max(0, width - dur.length - 2);
57
+ let left = styledLeft;
58
+ let w = visibleWidth(styledLeft);
59
+ if (w > budget) {
60
+ left = truncateToWidth(styledLeft, budget);
61
+ w = visibleWidth(left);
62
+ }
63
+ const gap = Math.max(1, width - w - dur.length - 1);
64
+ return ` ${left}${" ".repeat(gap)}${dur ? theme.fg("dim", dur) : ""}`;
65
+ }
66
+
67
+ // A node's *real work*: its own span minus the time it spent awaiting — both its
68
+ // children (the union of their runs) and, for a dispatcher, any `ask_user` waits
69
+ // (`awaitIntervals`). All clipped to the node's own window and unioned together,
70
+ // so overlapping awaits are never subtracted twice. A leaf with no awaits returns
71
+ // its full span; a dispatcher blocked on six concurrent agents (or on the human)
72
+ // is credited only for the time it was actually working between/around the awaits.
73
+ private realWorkMs(entry: HistoryEntry, kids: HistoryEntry[], now: number): number {
74
+ const start = entry.startedAt;
75
+ const end = entry.endedAt ?? now;
76
+ const span = end - start;
77
+ const intervals: Array<[number, number]> = [];
78
+ for (const k of kids) {
79
+ const s = Math.max(k.startedAt, start);
80
+ const e = Math.min(k.endedAt ?? now, end);
81
+ if (e > s) intervals.push([s, e]);
82
+ }
83
+ for (const [s0, e0] of entry.awaitIntervals ?? []) {
84
+ const s = Math.max(s0, start);
85
+ const e = Math.min(e0, end);
86
+ if (e > s) intervals.push([s, e]);
87
+ }
88
+ if (intervals.length === 0) return Math.max(0, span);
89
+ return Math.max(0, span - unionMs(intervals));
90
+ }
91
+
92
+ // Group entries by parent (children sorted by start time). Shared by buildRows
93
+ // (tree walk) and render (footer total), so the tree is built once per frame.
94
+ private groupByParent(entries: HistoryEntry[]): Map<HistoryEntry | null, HistoryEntry[]> {
95
+ const childrenOf = new Map<HistoryEntry | null, HistoryEntry[]>();
96
+ for (const e of entries) {
97
+ const arr = childrenOf.get(e.parent) ?? [];
98
+ arr.push(e);
99
+ childrenOf.set(e.parent, arr);
100
+ }
101
+ for (const arr of childrenOf.values()) arr.sort((a, b) => a.startedAt - b.startedAt);
102
+ return childrenOf;
103
+ }
104
+
105
+ // Build the display rows by walking the parent→child tree. Siblings are sorted by
106
+ // start time; those whose runs overlap form a "wave" and are marked parallel
107
+ // (a "│→" connector). Indentation tracks tree depth, so delegate sub-sub-agents
108
+ // nest under the specialist that spawned them.
109
+ private buildRows(childrenOf: Map<HistoryEntry | null, HistoryEntry[]>, width: number, theme: any, now: number): string[] {
110
+ // Mark parallel waves within each sibling group.
111
+ const parallel = new Set<HistoryEntry>();
112
+ for (const arr of childrenOf.values()) {
113
+ let waveStart = 0;
114
+ let waveMaxEnd = -Infinity;
115
+ const flush = (endIdx: number) => {
116
+ if (endIdx - waveStart >= 2) {
117
+ for (let i = waveStart; i < endIdx; i++) parallel.add(arr[i]);
118
+ }
119
+ };
120
+ for (let i = 0; i < arr.length; i++) {
121
+ const end = arr[i].endedAt ?? now;
122
+ if (i === waveStart) {
123
+ waveMaxEnd = end;
124
+ } else if (arr[i].startedAt < waveMaxEnd) {
125
+ waveMaxEnd = Math.max(waveMaxEnd, end);
126
+ } else {
127
+ flush(i);
128
+ waveStart = i;
129
+ waveMaxEnd = end;
130
+ }
131
+ }
132
+ flush(arr.length);
133
+ }
134
+
135
+ const rows: string[] = [];
136
+ const walk = (entry: HistoryEntry, depth: number) => {
137
+ const kids = childrenOf.get(entry) ?? [];
138
+ const dur = fmtDuration(this.realWorkMs(entry, kids, now));
139
+ const glyph = this.statusGlyph(entry, theme);
140
+ const isPar = parallel.has(entry);
141
+ const pad = " ".repeat(depth);
142
+ const connector = isPar ? theme.fg("accent", "│→ ") : "";
143
+ let label: string;
144
+ if (entry.kind === "orchestrator") {
145
+ label = `${theme.bold(theme.fg("accent", entry.name))} ${theme.fg("dim", "(dispatcher)")}`;
146
+ } else if (entry.kind === "delegate") {
147
+ label = `${theme.fg("dim", entry.name)} ${theme.fg("dim", "(delegate)")}`;
148
+ } else {
149
+ label = isPar ? theme.fg("muted", entry.name) : entry.name;
150
+ }
151
+ rows.push(this.rowLine(`${pad}${connector}${glyph} ${label}`, dur, width, theme));
152
+ for (const child of kids) walk(child, depth + 1);
153
+ };
154
+ for (const top of childrenOf.get(null) ?? []) walk(top, 0);
155
+ return rows;
156
+ }
157
+
158
+ render(width: number, contentHeight: number, theme: any): string[] {
159
+ const entries = this.getEntries();
160
+ const now = Date.now();
161
+ const runningCount = entries.filter(e => e.status === "running" && e.kind !== "orchestrator").length;
162
+
163
+ const top = new Container();
164
+ top.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
165
+ top.addChild(new Text(
166
+ `${theme.fg("accent", theme.bold(" AGENTS HISTORY"))} ${theme.fg("dim", "|")} ${theme.bold(this.getLabel())} ${theme.fg("dim", "|")} ${theme.fg("warning", String(runningCount))} running`,
167
+ 1, 0,
168
+ ));
169
+ top.addChild(new Spacer(1));
170
+ const topLines = top.render(width);
171
+
172
+ const childrenOf = this.groupByParent(entries);
173
+
174
+ // Footer total = the real work of everyone: the dispatched specialists' and
175
+ // research helpers' full runtime PLUS each dispatcher turn's own work (its span
176
+ // minus the time it awaited agents and the human via ask_user). Wall-clock is
177
+ // intentionally NOT shown — it would fold in the idle gaps between turns.
178
+ const runEntries = entries.filter(e => e.kind === "agent" || e.kind === "research");
179
+ const dispatchers = entries.filter(e => e.kind === "orchestrator");
180
+ let summaryLine = theme.fg("dim", " No agent activity yet.");
181
+ if (runEntries.length > 0 || dispatchers.length > 0) {
182
+ const agentMs = runEntries.reduce((n, e) => n + ((e.endedAt ?? now) - e.startedAt), 0);
183
+ const dispatcherMs = dispatchers.reduce((n, e) => n + this.realWorkMs(e, childrenOf.get(e) ?? [], now), 0);
184
+ summaryLine =
185
+ theme.fg("success", theme.bold(` Σ real work ${fmtDuration(agentMs + dispatcherMs)}`)) +
186
+ theme.fg("dim", ` · ${runEntries.length} runs (agents ${fmtDuration(agentMs)} + dispatchers ${fmtDuration(dispatcherMs)})`);
187
+ }
188
+
189
+ const bottom = new Container();
190
+ bottom.addChild(new Text(summaryLine, 1, 0));
191
+ bottom.addChild(new Text(theme.fg("dim", " ↑/↓ Scroll • G Live tail • Q/Esc Close"), 1, 0));
192
+ bottom.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
193
+ const bottomLines = bottom.render(width);
194
+
195
+ const rows = this.buildRows(childrenOf, width, theme, now);
196
+ const bodyHeight = Math.max(0, contentHeight + HISTORY_CHROME_ROWS - topLines.length - bottomLines.length);
197
+
198
+ let bodyLines: string[];
199
+ if (rows.length === 0) {
200
+ bodyLines = [theme.fg("dim", " No dispatches yet — history fills as agents run.")];
201
+ } else {
202
+ const maxOffset = Math.max(0, rows.length - bodyHeight);
203
+ if (this.followTail) this.scrollOffset = maxOffset;
204
+ this.scrollOffset = Math.max(0, Math.min(this.scrollOffset, maxOffset));
205
+ bodyLines = rows.slice(this.scrollOffset, this.scrollOffset + bodyHeight);
206
+ }
207
+
208
+ return fitToHeight([...topLines, ...fitToHeight(bodyLines, bodyHeight), ...bottomLines], contentHeight + HISTORY_CHROME_ROWS);
209
+ }
210
+ }
211
+
212
+
213
+ export async function openHistory(
214
+ ctx: ExtensionContext,
215
+ store: ExecutionHistoryStore,
216
+ getLabel: () => string,
217
+ ): Promise<void> {
218
+ const resources = createPanelResources();
219
+ try {
220
+ await ctx.ui.custom((tui: any, theme: any, _kb: any, done: (result: unknown) => void) => {
221
+ const ui = new HistoryUI(() => [...store.entries()], getLabel, () => done(undefined));
222
+ resources.onDispose(store.onChange(() => tui.requestRender()));
223
+ resources.every(1000, () => tui.requestRender());
224
+ return {
225
+ render: (w: number) => ui.render(w, bodyRows(tui.terminal?.rows, HISTORY_CHROME_ROWS), theme),
226
+ handleInput: (data: string) => ui.handleInput(data, tui),
227
+ invalidate: () => {},
228
+ dispose: () => resources.dispose(),
229
+ };
230
+ }, FULLSCREEN_OVERLAY);
231
+ } finally {
232
+ resources.dispose();
233
+ }
234
+ }
@@ -0,0 +1,103 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+ import type { RegistryEntry as ComsRegistryEntry } from "../../lib/coms-core.ts";
3
+ import { abbreviateModel, hexFg } from "../../lib/coms-core.ts";
4
+ import { buildFleetRows, type PeerInput } from "../../lib/fleet-read-model.ts";
5
+
6
+ export interface PoolPresentationDeps {
7
+ getIdentity(): { session_id: string; name: string; color: string; project: string } | null;
8
+ getDisplayProject(): string | undefined;
9
+ includeExplicitPeers(): boolean;
10
+ getPeerCards(): ReadonlyMap<string, { name: string; model: string; purpose: string; color: string; staleCount?: number }>;
11
+ readProjectEntries(project: string): ComsRegistryEntry[];
12
+ readAllEntries(): ComsRegistryEntry[];
13
+ isCompact(): boolean;
14
+ truncate(text: string, width: number): string;
15
+ }
16
+
17
+ export interface PoolPresentation {
18
+ peerInputs(formatModel?: (model: string) => string): PeerInput[];
19
+ render(width: number, theme: { fg(color: string, text: string): string }): string[];
20
+ install(ctx: ExtensionContext): void;
21
+ }
22
+
23
+ const scrubFleetText = (text: string) => text.replace(/[\x00-\x1f\x7f]+/g, " ").replace(/\s+/g, " ").trim();
24
+
25
+ export function createPoolPresentation(deps: PoolPresentationDeps): PoolPresentation {
26
+ let cachedProject: string | undefined;
27
+ let cachedEntries: ComsRegistryEntry[] = [];
28
+ let cachedAt = 0;
29
+
30
+ const peerInputs = (formatModel: (model: string) => string = model => model): PeerInput[] => {
31
+ const identity = deps.getIdentity();
32
+ const project = deps.getDisplayProject() ?? identity?.project ?? "default";
33
+ if (cachedProject !== project || Date.now() - cachedAt > 1000) {
34
+ cachedProject = project;
35
+ cachedEntries = project === "*" ? deps.readAllEntries() : deps.readProjectEntries(project);
36
+ cachedAt = Date.now();
37
+ }
38
+ const peers: PeerInput[] = [];
39
+ const sessions = new Set<string>();
40
+ const names = new Set<string>();
41
+ for (const [sid, card] of deps.getPeerCards()) {
42
+ if (identity && sid === identity.session_id) continue;
43
+ sessions.add(sid); names.add(card.name);
44
+ peers.push({ key: `peer:${sid}`, name: scrubFleetText(card.name), model: formatModel(card.model), lastWork: scrubFleetText(card.purpose), colorHex: card.color, staleCount: card.staleCount });
45
+ }
46
+ for (const entry of cachedEntries) {
47
+ if (identity && entry.session_id === identity.session_id) continue;
48
+ if (!deps.includeExplicitPeers() && entry.explicit) continue;
49
+ if (sessions.has(entry.session_id) || names.has(entry.name)) continue;
50
+ peers.push({ key: `peer:${entry.session_id}`, name: scrubFleetText(entry.name), model: formatModel(entry.model), lastWork: scrubFleetText(entry.purpose), colorHex: entry.color, pending: true });
51
+ }
52
+ return peers;
53
+ };
54
+
55
+ const render = (width: number, theme: { fg(color: string, text: string): string }): string[] => {
56
+ if (!deps.isCompact()) return [];
57
+ const rows = buildFleetRows({ specialists: [], research: [], peers: peerInputs() }, { showFinished: true });
58
+ const safeWidth = Math.max(0, width);
59
+ const identity = deps.getIdentity();
60
+ let topBorder: string;
61
+ let bottomBorder: string;
62
+ if (safeWidth < 12) {
63
+ topBorder = theme.fg("dim", "━".repeat(safeWidth));
64
+ bottomBorder = theme.fg("dim", "━".repeat(safeWidth));
65
+ } else {
66
+ const left = theme.fg("dim", "┏━") + theme.fg("border", " coms ");
67
+ const remaining = safeWidth - 9 - (identity ? identity.name.length + 4 : 0) - 1;
68
+ if (identity && remaining >= 1) {
69
+ topBorder = left + theme.fg("dim", "━") + theme.fg("dim", "━".repeat(remaining)) + theme.fg("dim", " ") + hexFg(identity.color, identity.name) + theme.fg("dim", " ━") + theme.fg("dim", "┓");
70
+ } else {
71
+ topBorder = left + theme.fg("dim", "━".repeat(Math.max(0, safeWidth - 9)) + "┓");
72
+ }
73
+ bottomBorder = theme.fg("dim", "┗" + "━".repeat(safeWidth - 2) + "┛");
74
+ }
75
+ if (rows.length === 0) return [topBorder, deps.truncate(theme.fg("dim", " ") + theme.fg("muted", "no peers connected"), width), bottomBorder];
76
+ rows.sort((a, b) => a.name.localeCompare(b.name));
77
+ const out = [topBorder];
78
+ for (const row of rows) {
79
+ const pct = row.contextPct ?? 0;
80
+ const filled = Math.max(0, Math.min(15, Math.round(pct / 100 * 15)));
81
+ const pctLabel = row.contextPct == null ? "--%" : `${row.contextPct}%`;
82
+ if (row.status === "stale") {
83
+ out.push(deps.truncate(" " + theme.fg("dim", `✗ ${row.name.padEnd(12)} ${abbreviateModel(row.model).padEnd(14)} [${"-".repeat(15)}] ${pctLabel.padStart(4)} — ${row.lastWork || ""}`), width));
84
+ continue;
85
+ }
86
+ const pending = row.status === "pending";
87
+ const swatch = pending ? theme.fg("dim", "●") : hexFg(row.colorHex ?? "#808080", "●");
88
+ const fill = pending ? theme.fg("dim", "-".repeat(15)) : hexFg(row.colorHex ?? "#808080", "#".repeat(filled)) + theme.fg("dim", "-".repeat(15 - filled));
89
+ const line = " " + swatch + " " + theme.fg("accent", row.name.padEnd(12)) + " " + theme.fg("dim", abbreviateModel(row.model).padEnd(14)) + " " + theme.fg("warning", "[") + fill + theme.fg("warning", "]") + " " + theme.fg("accent", pctLabel.padStart(4)) + theme.fg("dim", " — ") + theme.fg("muted", row.lastWork || "");
90
+ out.push(deps.truncate(line, width));
91
+ }
92
+ out.push(bottomBorder);
93
+ return out;
94
+ };
95
+
96
+ return {
97
+ peerInputs, render,
98
+ install(ctx) {
99
+ if (!ctx.hasUI) return;
100
+ try { ctx.ui.setWidget("coms-pool", (_tui, theme) => ({ invalidate() {}, render: width => render(width, theme) }), { placement: "belowEditor" }); } catch {}
101
+ },
102
+ };
103
+ }
@@ -0,0 +1,204 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+ import { DynamicBorder, getMarkdownTheme as getPiMdTheme, copyToClipboard } from "@mariozechner/pi-coding-agent";
3
+ import { Text, Box, Container, Spacer, Markdown, matchesKey, Key, truncateToWidth } from "@mariozechner/pi-tui";
4
+ import { FULLSCREEN_OVERLAY, bodyRows, fitToHeight } from "../../lib/fleet-overlay.ts";
5
+ import { createPanelResources } from "../../lib/fleet-panel.ts";
6
+
7
+ export interface TimelineEntry {
8
+ kind: "text" | "tool" | "thinking" | "tool-start" | "tool-result";
9
+ title: string;
10
+ content: string;
11
+ timestamp: number;
12
+ callId?: string;
13
+ status?: "success" | "error";
14
+ durationMs?: number;
15
+ }
16
+
17
+ export interface Zoomable {
18
+ def: { name: string };
19
+ status: string;
20
+ timeline: TimelineEntry[];
21
+ zoomRender?: (force?: boolean) => void;
22
+ }
23
+
24
+ function displayName(name: string): string {
25
+ return name.split("-").map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
26
+ }
27
+
28
+ export const ZOOM_CHROME_ROWS = 5;
29
+
30
+ export class ZoomUI {
31
+ private selectedIndex = 0;
32
+ private expandedIndex: number | null = null;
33
+ private scrollOffset = 0;
34
+ private followTail = true;
35
+ private autoExpandedTailIndex: number | null = null;
36
+
37
+ constructor(
38
+ private state: Zoomable,
39
+ private onDone: () => void,
40
+ private notify: (message: string, type?: "info" | "success" | "warning" | "error") => void,
41
+ ) {}
42
+
43
+ handleInput(data: string, tui: any): void {
44
+ const n = this.state.timeline.length;
45
+ if (matchesKey(data, Key.up)) {
46
+ this.followTail = false;
47
+ this.selectedIndex = Math.max(0, this.selectedIndex - 1);
48
+ } else if (matchesKey(data, Key.down)) {
49
+ this.selectedIndex = Math.min(n - 1, this.selectedIndex + 1);
50
+ if (this.selectedIndex >= n - 1) this.followTail = true;
51
+ } else if (matchesKey(data, Key.enter)) {
52
+ this.expandedIndex = this.expandedIndex === this.selectedIndex ? null : this.selectedIndex;
53
+ if (this.followTail && this.selectedIndex >= n - 1) this.autoExpandedTailIndex = this.selectedIndex;
54
+ } else if (matchesKey(data, Key.space) || matchesKey(data, Key.ctrl("c"))) {
55
+ void this.copySelected();
56
+ } else if (matchesKey(data, Key.escape) || matchesKey(data, "q") || matchesKey(data, Key.shift("q"))) {
57
+ this.onDone();
58
+ return;
59
+ }
60
+ tui.requestRender();
61
+ }
62
+
63
+ private async copySelected(): Promise<void> {
64
+ const item = this.state.timeline[this.selectedIndex];
65
+ if (!item) return;
66
+ try {
67
+ await copyToClipboard(item.content);
68
+ this.notify("Copied selected zoom row", "success");
69
+ } catch (err) {
70
+ const message = err instanceof Error ? err.message : String(err);
71
+ this.notify(`Failed to copy selected zoom row: ${message}`, "error");
72
+ }
73
+ }
74
+
75
+ // Render one timeline entry (card + trailing spacer) to its exact lines, so the
76
+ // scroll math and viewport capping can use real heights — an expanded markdown
77
+ // entry is many lines, a collapsed one is two. Mirrors the old inline card build.
78
+ private renderItemBlock(item: TimelineEntry, absoluteIndex: number, width: number, theme: any, mdTheme: any): string[] {
79
+ const isSelected = absoluteIndex === this.selectedIndex;
80
+ const isExpanded = isSelected && absoluteIndex === this.expandedIndex;
81
+
82
+ const cardBox = new Box(1, 0, (s: string) => isSelected ? theme.bg("selectedBg", s) : s);
83
+
84
+ let icon = "○", color = "dim";
85
+ if (item.kind === "text") { icon = "🤖"; color = "accent"; }
86
+ else if (item.kind === "tool") { icon = "🛠️"; color = "warning"; }
87
+ else if (item.kind === "thinking") { icon = "💭"; color = "dim"; }
88
+
89
+ cardBox.addChild(new Text(`${theme.fg(color, icon)} ${theme.bold(item.title)}`, 0, 0));
90
+
91
+ if (isExpanded) {
92
+ cardBox.addChild(new Spacer(1));
93
+ cardBox.addChild(new Markdown(item.content || "(empty)", 2, 0, mdTheme));
94
+ } else {
95
+ const flat = (item.content || "").replace(/\s+/g, " ").trim();
96
+ const preview = truncateToWidth(flat, Math.max(0, width - 8));
97
+ cardBox.addChild(new Text(theme.fg("dim", " " + (preview || "…")), 0, 0));
98
+ }
99
+
100
+ const block = new Container();
101
+ block.addChild(cardBox);
102
+ block.addChild(new Spacer(1));
103
+ return block.render(width);
104
+ }
105
+
106
+ // Height-aware scroll: scroll the viewport so the selected entry's FULL height
107
+ // fits in the content budget. Entries above the selection may be tall (expanded
108
+ // markdown), so a per-entry-is-one-line assumption clipped the last/expanded
109
+ // entry below the fold — this counts real line heights instead.
110
+ private ensureVisible(heights: number[], contentHeight: number) {
111
+ if (this.selectedIndex < this.scrollOffset) this.scrollOffset = this.selectedIndex;
112
+ const sumToSelected = (from: number): number => {
113
+ let s = 0;
114
+ for (let i = from; i <= this.selectedIndex; i++) s += heights[i] ?? 0;
115
+ return s;
116
+ };
117
+ // Push the top of the window down until the selected entry fits (or it is
118
+ // the only entry shown, in which case the overlay clips a too-tall entry).
119
+ while (this.scrollOffset < this.selectedIndex && sumToSelected(this.scrollOffset) > contentHeight) {
120
+ this.scrollOffset++;
121
+ }
122
+ if (this.scrollOffset < 0) this.scrollOffset = 0;
123
+ }
124
+
125
+ render(width: number, contentHeight: number, theme: any): string[] {
126
+ const items = this.state.timeline;
127
+ // Live tail-follow: keep the selection pinned to the newest entry as the
128
+ // stream grows, until the user scrolls up. Auto-expand each new tail entry
129
+ // once so the latest message opens full, while still allowing Enter to collapse it.
130
+ if (this.followTail && items.length > 0) {
131
+ this.selectedIndex = items.length - 1;
132
+ if (this.autoExpandedTailIndex !== this.selectedIndex) {
133
+ this.expandedIndex = this.selectedIndex;
134
+ this.autoExpandedTailIndex = this.selectedIndex;
135
+ }
136
+ }
137
+ this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, items.length - 1));
138
+
139
+ const mdTheme = getPiMdTheme();
140
+ const st = this.state.status;
141
+ const statusColor = st === "error" ? "error" : st === "running" ? "warning" : "success";
142
+
143
+ // Chrome (border + header + footer) is rendered separately from the body so
144
+ // the body can be windowed to an exact line budget — header and footer always
145
+ // stay visible no matter how tall the expanded entries are.
146
+ const top = new Container();
147
+ top.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
148
+ top.addChild(new Text(
149
+ `${theme.fg("accent", theme.bold(" ZOOM"))} ${theme.fg("dim", "|")} ${theme.bold(displayName(this.state.def.name))} ${theme.fg("dim", "|")} ${theme.fg(statusColor, st)} ${theme.fg("dim", "|")} ${theme.fg("success", String(items.length))} events`,
150
+ 1, 0,
151
+ ));
152
+ top.addChild(new Spacer(1));
153
+ const topLines = top.render(width);
154
+
155
+ const bottom = new Container();
156
+ bottom.addChild(new Text(theme.fg("dim", " ↑/↓ Navigate • Enter Collapse/Expand • Space/Ctrl+C Copy • Q/Esc Close • live"), 1, 0));
157
+ bottom.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
158
+ const bottomLines = bottom.render(width);
159
+ const bodyHeight = Math.max(0, contentHeight + ZOOM_CHROME_ROWS - topLines.length - bottomLines.length);
160
+
161
+ let bodyLines: string[];
162
+ if (items.length === 0) {
163
+ bodyLines = [theme.fg("dim", " No activity captured yet.")];
164
+ } else {
165
+ const blocks = items.map((item, i) => this.renderItemBlock(item, i, width, theme, mdTheme));
166
+ const heights = blocks.map(b => b.length);
167
+ this.ensureVisible(heights, bodyHeight);
168
+ bodyLines = [];
169
+ for (let i = this.scrollOffset; i < blocks.length; i++) {
170
+ // Always show the first windowed entry (the selected one fits by
171
+ // construction); stop before a later entry would overflow the budget.
172
+ if (bodyLines.length > 0 && bodyLines.length + heights[i] > bodyHeight) break;
173
+ bodyLines.push(...blocks[i]);
174
+ }
175
+ }
176
+
177
+ return fitToHeight([...topLines, ...fitToHeight(bodyLines, bodyHeight), ...bottomLines], contentHeight + ZOOM_CHROME_ROWS);
178
+ }
179
+ }
180
+
181
+
182
+ export async function openZoom(target: Zoomable, ctx: ExtensionContext): Promise<void> {
183
+ const resources = createPanelResources();
184
+ let lastRender = 0;
185
+ try {
186
+ await ctx.ui.custom((tui: any, theme: any, _kb: any, done: (result: unknown) => void) => {
187
+ const ui = new ZoomUI(target, () => done(undefined), (message, type) => ctx.ui.notify(message, type));
188
+ target.zoomRender = (force?: boolean) => {
189
+ const now = Date.now();
190
+ if (force || now - lastRender > 80) { lastRender = now; tui.requestRender(); }
191
+ };
192
+ resources.onDispose(() => { target.zoomRender = undefined; });
193
+ return {
194
+ render: (w: number) => ui.render(w, bodyRows(tui.terminal?.rows, ZOOM_CHROME_ROWS), theme),
195
+ handleInput: (data: string) => ui.handleInput(data, tui),
196
+ invalidate: () => {},
197
+ dispose: () => resources.dispose(),
198
+ };
199
+ }, FULLSCREEN_OVERLAY);
200
+ } finally {
201
+ resources.dispose();
202
+ target.zoomRender = undefined;
203
+ }
204
+ }