@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,202 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import * as fs from "node:fs";
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import { herdr as herdrApi } from "../../lib/herdr-client.ts";
8
+ import {
9
+ PEER_READY_TIMEOUT_MS,
10
+ peerReadyDelayMs,
11
+ spawnStaggerSeconds,
12
+ } from "../../lib/spawned-peers.js";
13
+ import { STAGGER_ENV_VAR, WARMUP_SECONDS, oauthNeedsWarmup } from "../../../../scripts/lib/spawn-stagger.ts";
14
+ import type {
15
+ HerdrClosePaneParams,
16
+ HerdrNotifyParams,
17
+ HerdrReadPaneParams,
18
+ HerdrSpawnPaneParams,
19
+ HerdrSpawnPeerParams,
20
+ ToolContext,
21
+ } from "./context.ts";
22
+
23
+ export async function waitForPeerRegistration(
24
+ name: string,
25
+ isComsAvailable: () => boolean,
26
+ peerNamesInScope: () => string[],
27
+ timeoutMs = PEER_READY_TIMEOUT_MS,
28
+ ): Promise<{ found: boolean; waitedMs: number }> {
29
+ const wanted = String(name).toLowerCase();
30
+ const started = Date.now();
31
+ for (let attempt = 0; ; attempt++) {
32
+ const live = isComsAvailable() ? peerNamesInScope() : [];
33
+ if (live.some(peerName => peerName.toLowerCase() === wanted)) {
34
+ return { found: true, waitedMs: Date.now() - started };
35
+ }
36
+ const remaining = timeoutMs - (Date.now() - started);
37
+ if (remaining <= 0) return { found: false, waitedMs: Date.now() - started };
38
+ await new Promise(resolve => setTimeout(resolve, Math.min(peerReadyDelayMs(attempt), remaining)));
39
+ }
40
+ }
41
+
42
+ export async function paneTail(paneId: string, lines = 12): Promise<string> {
43
+ try {
44
+ const { read } = await herdrApi.paneRead({ pane_id: paneId, lines });
45
+ return read?.text ?? "";
46
+ } catch {
47
+ return "";
48
+ }
49
+ }
50
+
51
+ export function peerManifest(cwd: string): string {
52
+ try {
53
+ return fs.readFileSync(path.join(cwd, ".pi", "agents", "peers.yaml"), "utf-8");
54
+ } catch {
55
+ return "";
56
+ }
57
+ }
58
+
59
+ export function peerPersonaExists(cwd: string, persona: string): boolean {
60
+ return (
61
+ fs.existsSync(path.join(cwd, "agents", `${persona}.md`)) ||
62
+ fs.existsSync(path.join(cwd, ".pi", "agents", `${persona}.md`))
63
+ );
64
+ }
65
+
66
+ export function spawnDelaySeconds(lastHubPiSpawnAt: number | null): number {
67
+ let authRaw: string | undefined;
68
+ try {
69
+ authRaw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
70
+ } catch {
71
+ authRaw = undefined;
72
+ }
73
+ return spawnStaggerSeconds({
74
+ needed: oauthNeedsWarmup(authRaw),
75
+ lastSpawnAt: lastHubPiSpawnAt,
76
+ now: Date.now(),
77
+ warmupSeconds: WARMUP_SECONDS,
78
+ });
79
+ }
80
+
81
+ export { STAGGER_ENV_VAR };
82
+
83
+ export function registerFleetTools(pi: ExtensionAPI, toolCtx: ToolContext): void {
84
+ pi.registerTool({
85
+ name: "herdr_spawn_peer",
86
+ label: "Herdr Spawn Peer",
87
+ description: "Spawn a reusable sibling coms peer from its declared or compatible override settings; wait for peer_ready.",
88
+ parameters: Type.Object({
89
+ name: Type.String({ description: "Peer and pane name." }),
90
+ runner: Type.Optional(Type.Union([Type.Literal("pi"), Type.Literal("claude-code")], { description: "Runner override." })),
91
+ persona: Type.Optional(Type.String({ description: "Pi persona override." })),
92
+ no_persona: Type.Optional(Type.Boolean({ description: "Use persona-less Fleet Core." })),
93
+ model: Type.Optional(Type.String({ description: "Model override." })),
94
+ extensions: Type.Optional(Type.String({ description: "Pi extensions." })),
95
+ browser: Type.Optional(Type.Boolean({ description: "Enable browser." })),
96
+ all_extensions: Type.Optional(Type.Boolean({ description: "All extensions (Fleet Core only)." })),
97
+ direction: Type.Optional(Type.Union([Type.Literal("right"), Type.Literal("down")], { description: "Split direction." })),
98
+ }),
99
+ execute(toolCallId, params, signal, onUpdate, ctx) {
100
+ return toolCtx.executeHerdrSpawnPeer(toolCallId, params as HerdrSpawnPeerParams, signal, onUpdate, ctx);
101
+ },
102
+ renderCall(args, theme) {
103
+ const a = args as any;
104
+ return new Text(
105
+ theme.fg("toolTitle", theme.bold("herdr_spawn_peer ")) + theme.fg("accent", a.name ?? "?") + theme.fg("dim", a.runner ? ` (${a.runner})` : ""),
106
+ 0, 0,
107
+ );
108
+ },
109
+ renderResult(result, _options, theme) {
110
+ const d = result.details as any;
111
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
112
+ if (d?.peer_ready === false) return new Text(theme.fg("error", `✗ ${d?.pane_id ?? "peer failed"}`), 0, 0);
113
+ return new Text(theme.fg("success", `✓ ${d?.pane_id ?? "spawned"}`), 0, 0);
114
+ },
115
+ });
116
+
117
+ pi.registerTool({
118
+ name: "herdr_spawn_pane",
119
+ label: "Herdr Spawn Pane",
120
+ description: "Spawn a raw auxiliary command in a sibling pane, not a coms peer.",
121
+ parameters: Type.Object({
122
+ name: Type.String({ description: "Human-visible pane label." }),
123
+ command: Type.String({ description: "Raw shell command executed with bash -lc." }),
124
+ direction: Type.Optional(Type.Union([Type.Literal("right"), Type.Literal("down")], { description: "Split direction (default right)." })),
125
+ }),
126
+ execute(toolCallId, params, signal, onUpdate, ctx) {
127
+ return toolCtx.executeHerdrSpawnPane(toolCallId, params as HerdrSpawnPaneParams, signal, onUpdate, ctx);
128
+ },
129
+ renderCall(args, theme) {
130
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_spawn_pane ")) + theme.fg("accent", (args as any).name ?? "?"), 0, 0);
131
+ },
132
+ renderResult(result, _options, theme) {
133
+ const d = result.details as any;
134
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
135
+ return new Text(theme.fg("success", `✓ ${d?.pane_id ?? "spawned"}`), 0, 0);
136
+ },
137
+ });
138
+
139
+ pi.registerTool({
140
+ name: "herdr_read_pane",
141
+ label: "Herdr Read Pane",
142
+ description: "Read up to 200 recent pane lines; use coms for bridged peers.",
143
+ parameters: Type.Object({
144
+ pane_id: Type.String({ description: "Pane id, e.g. w3:p2 (see herdr_spawn_peer result or the sidebar)." }),
145
+ lines: Type.Optional(Type.Number({ description: "Line cap, default 60, max 200." })),
146
+ }),
147
+ execute(toolCallId, params, signal, onUpdate, ctx) {
148
+ return toolCtx.executeHerdrReadPane(toolCallId, params as HerdrReadPaneParams, signal, onUpdate, ctx);
149
+ },
150
+ renderCall(args, theme) {
151
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_read_pane ")) + theme.fg("warning", (args as any).pane_id ?? "?"), 0, 0);
152
+ },
153
+ renderResult(result, _options, theme) {
154
+ const d = result.details as any;
155
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
156
+ return new Text(theme.fg("success", `✓ read ${d?.pane_id}`), 0, 0);
157
+ },
158
+ });
159
+
160
+ pi.registerTool({
161
+ name: "herdr_close_pane",
162
+ label: "Herdr Close Pane",
163
+ description: "Close a Hub-spawned pane. Destructive: always asks the human.",
164
+ parameters: Type.Object({
165
+ pane_id: Type.String({ description: "Pane id to close." }),
166
+ reason: Type.String({ description: "One line shown to the human: why this pane can die." }),
167
+ }),
168
+ execute(toolCallId, params, signal, onUpdate, ctx) {
169
+ return toolCtx.executeHerdrClosePane(toolCallId, params as HerdrClosePaneParams, signal, onUpdate, ctx);
170
+ },
171
+ renderCall(args, theme) {
172
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_close_pane ")) + theme.fg("error", (args as any).pane_id ?? "?"), 0, 0);
173
+ },
174
+ renderResult(result, _options, theme) {
175
+ const d = result.details as any;
176
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
177
+ if (d?.declined) return new Text(theme.fg("warning", "✗ declined by human"), 0, 0);
178
+ return new Text(theme.fg("success", `✓ closed`), 0, 0);
179
+ },
180
+ });
181
+
182
+ pi.registerTool({
183
+ name: "herdr_notify",
184
+ label: "Herdr Notify",
185
+ description: "Notify an away human; never replaces ask_user.",
186
+ parameters: Type.Object({
187
+ title: Type.String({ description: "Notification title." }),
188
+ body: Type.Optional(Type.String({ description: "Notification body." })),
189
+ }),
190
+ execute(toolCallId, params, signal, onUpdate, ctx) {
191
+ return toolCtx.executeHerdrNotify(toolCallId, params as HerdrNotifyParams, signal, onUpdate, ctx);
192
+ },
193
+ renderCall(args, theme) {
194
+ return new Text(theme.fg("toolTitle", theme.bold("herdr_notify ")) + theme.fg("accent", (args as any).title ?? ""), 0, 0);
195
+ },
196
+ renderResult(result, _options, theme) {
197
+ const d = result.details as any;
198
+ if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
199
+ return new Text(theme.fg("success", "✓ notified"), 0, 0);
200
+ },
201
+ });
202
+ }
@@ -0,0 +1,82 @@
1
+ import { PANE_PROMPT_TIMEOUT_MS, launchPeerInPane } from "../../lib/spawned-peers.js";
2
+ import { herdrPaneId } from "../../lib/herdr-presence.ts";
3
+ import { buildHubPeerSpawnPlan, launchHubPeerInPane } from "../peer-spawn-plan.ts";
4
+ import { paneTail, peerManifest, peerPersonaExists, spawnDelaySeconds, STAGGER_ENV_VAR, waitForPeerRegistration } from "./fleet-tools.ts";
5
+ import { parseEnvFile, resolveEnvFilePath } from "../../../../scripts/lib/herdr-layout.ts";
6
+ import { worktreeTag } from "../../../../scripts/lib/team-project.ts";
7
+ import type { HerdrClosePaneParams, HerdrNotifyParams, HerdrReadPaneParams, HerdrSpawnPaneParams, HerdrSpawnPeerParams, ToolExecutionResult, ToolExecutor } from "./context.ts";
8
+
9
+ export interface HerdrExecutorDeps {
10
+ provisionalCapabilityRefusal(pack: "workspace"): ToolExecutionResult | null;
11
+ isFleetReady(): boolean;
12
+ isComsReady(): boolean;
13
+ getIdentity(): { project: string } | null;
14
+ getCurrentContext(): { cwd?: string; hasUI?: boolean; ui?: any } | null;
15
+ peersInScope(): Array<{ name: string }>;
16
+ getComsPeerNames(): string[];
17
+ herdr: any;
18
+ readEnvFile(path: string): string;
19
+ envFileExists(path: string): boolean;
20
+ getLastPiSpawnAt(): number | null;
21
+ setLastPiSpawnAt(value: number): void;
22
+ recordSpawnedPeer(name: string, paneId: string): void;
23
+ }
24
+
25
+ const unavailable = (): ToolExecutionResult => ({ content: [{ type: "text", text: "herdr is not available in this session." }], details: { error: "no herdr" } });
26
+ const noPane = (): ToolExecutionResult => ({ content: [{ type: "text", text: "not inside a herdr pane." }], details: { error: "no pane" } });
27
+
28
+ export function createHerdrExecutors(d: HerdrExecutorDeps): Pick<import("./context.ts").ToolContext, "executeHerdrSpawnPeer" | "executeHerdrSpawnPane" | "executeHerdrReadPane" | "executeHerdrClosePane" | "executeHerdrNotify"> {
29
+ const executeHerdrSpawnPeer: ToolExecutor<HerdrSpawnPeerParams> = async (_id, params) => {
30
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal;
31
+ if (!d.isFleetReady()) return unavailable();
32
+ const ownPane = herdrPaneId(); if (!ownPane) return noPane();
33
+ const identity = d.getIdentity();
34
+ if (!d.isComsReady() || !identity) return { content: [{ type: "text", text: "Cannot spawn an addressable peer while coms is unavailable. Start without --solo/--no-coms, or use herdr_spawn_pane for a non-peer command." }], details: { error: "no coms" } };
35
+ try {
36
+ const cwd = d.getCurrentContext()?.cwd ?? process.cwd();
37
+ const plan = buildHubPeerSpawnPlan(params, { project: identity.project, peersYaml: peerManifest(cwd), personaExists: persona => peerPersonaExists(cwd, persona), worktreeTag: worktreeTag(cwd) });
38
+ if (d.peersInScope().some(peer => peer.name.toLowerCase() === plan.name.toLowerCase())) throw new Error(`Peer "${plan.name}" is already visible in project "${identity.project}"; use coms_send instead of spawning a duplicate.`);
39
+ const env: Record<string, string> = {};
40
+ if (plan.envFile) { const envPath = resolveEnvFilePath(plan.envFile, cwd); if (!d.envFileExists(envPath)) throw new Error(`env_file not found: ${plan.envFile} (resolved: ${envPath})`); Object.assign(env, parseEnvFile(d.readEnvFile(envPath), plan.envFile)); }
41
+ const delay = plan.runner === "pi" ? spawnDelaySeconds(d.getLastPiSpawnAt()) : 0; if (delay > 0) env[STAGGER_ENV_VAR] = String(delay);
42
+ const launched = await launchHubPeerInPane(plan, {
43
+ client: d.herdr, targetPaneId: ownPane, cwd, env,
44
+ waitForRegistration: (name, timeoutMs) => waitForPeerRegistration(name, () => d.isComsReady() && d.getIdentity() !== null, d.getComsPeerNames, timeoutMs),
45
+ paneTail,
46
+ onLaunched: paneId => { d.recordSpawnedPeer(plan.name, paneId); if (plan.runner === "pi") d.setLastPiSpawnAt(Date.now()); },
47
+ });
48
+ const promptNote = launched.promptSeen ? "" : `\n⚠ pane ${launched.paneId} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`;
49
+ return { content: [{ type: "text", text: `spawned ${plan.kind} in pane ${launched.paneId} (${plan.name}): ${plan.command.join(" ")}${promptNote}\n\n${launched.verdict.message}` }], details: { pane_id: launched.paneId, name: plan.name, kind: plan.kind, runner: plan.runner, project: plan.project, prompt_seen: launched.promptSeen, env_file: plan.envFile ?? null, ...launched.verdict } };
50
+ } catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_spawn_peer failed before readiness: ${m}` }], details: { error: m } }; }
51
+ };
52
+ const executeHerdrSpawnPane: ToolExecutor<HerdrSpawnPaneParams> = async (_id, params) => {
53
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal;
54
+ if (!d.isFleetReady()) return unavailable(); const ownPane = herdrPaneId(); if (!ownPane) return noPane();
55
+ try {
56
+ const cwd = d.getCurrentContext()?.cwd ?? process.cwd(); const argv = ["bash", "-lc", params.command];
57
+ const { pane } = await d.herdr.paneSplit({ target_pane_id: ownPane, direction: params.direction ?? "right", cwd, focus: false });
58
+ try { await d.herdr.paneRename(pane.pane_id, params.name); } catch {}
59
+ const launch = await launchPeerInPane(d.herdr, pane.pane_id, argv); const promptNote = launch.promptSeen ? "" : `\n⚠ pane ${pane.pane_id} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`;
60
+ return { content: [{ type: "text", text: `spawned raw pane ${pane.pane_id} (${params.name}): ${params.command}${promptNote}` }], details: { pane_id: pane.pane_id, name: params.name, prompt_seen: launch.promptSeen } };
61
+ } catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_spawn_pane failed: ${m}` }], details: { error: m } }; }
62
+ };
63
+ const executeHerdrReadPane: ToolExecutor<HerdrReadPaneParams> = async (_id, params) => {
64
+ if (!d.isFleetReady()) return unavailable(); const lines = Math.min(Math.max(1, params.lines ?? 60), 200);
65
+ try { const { read } = await d.herdr.paneRead({ pane_id: params.pane_id, lines }); return { content: [{ type: "text", text: read.text || "(pane is empty)" }], details: { pane_id: params.pane_id, lines } }; }
66
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_read_pane failed: ${m}` }], details: { error: m } }; }
67
+ };
68
+ const executeHerdrClosePane: ToolExecutor<HerdrClosePaneParams> = async (_id, params) => {
69
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal; if (!d.isFleetReady()) return unavailable();
70
+ const ctx = d.getCurrentContext(); if (!ctx?.hasUI) return { content: [{ type: "text", text: "no UI to confirm the close — refused." }], details: { error: "no ui" } };
71
+ const ok = await ctx.ui.confirm("herdr_close_pane", `Close pane ${params.pane_id}? Reason: ${params.reason}\nThis kills the process running in it.`);
72
+ if (!ok) return { content: [{ type: "text", text: `human declined closing ${params.pane_id} — adapt and continue.` }], details: { declined: true } };
73
+ try { await d.herdr.paneClose(params.pane_id); return { content: [{ type: "text", text: `closed ${params.pane_id}` }], details: { closed: params.pane_id } }; }
74
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_close_pane failed: ${m}` }], details: { error: m } }; }
75
+ };
76
+ const executeHerdrNotify: ToolExecutor<HerdrNotifyParams> = async (_id, params) => {
77
+ const refusal = d.provisionalCapabilityRefusal("workspace"); if (refusal) return refusal; if (!d.isFleetReady()) return unavailable();
78
+ try { await d.herdr.notificationShow({ title: params.title, body: params.body ?? "" }); return { content: [{ type: "text", text: `notified: ${params.title}` }], details: { title: params.title } }; }
79
+ catch (err) { const m = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `herdr_notify failed: ${m}` }], details: { error: m } }; }
80
+ };
81
+ return { executeHerdrSpawnPeer, executeHerdrSpawnPane, executeHerdrReadPane, executeHerdrClosePane, executeHerdrNotify };
82
+ }
@@ -0,0 +1,29 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import type { SetTaskTierParams, ToolContext } from "./context.ts";
5
+
6
+ export function registerSetTaskTier(pi: ExtensionAPI, toolCtx: ToolContext): void {
7
+ pi.registerTool({
8
+ name: "set_task_tier",
9
+ label: "Set Task Tier",
10
+ description:
11
+ "Classify the CURRENT TASK before your first dispatch: trivial (one obvious, low-risk change — 1 dispatch), small (a contained change, no planning pipeline — 2 dispatches), feature (a normal multi-step feature — 8 dispatches), project (a large effort — 12 dispatches). Nested delegation is off at trivial/small. The tier persists across user messages and moves by ratchet: LOWERING it is always free, RAISING it requires `reason` naming what the ask turned out to contain. Pass `new_task: true` only when the human has moved on to a genuinely different piece of work — it also resets the task budget.",
12
+ parameters: Type.Object({
13
+ tier: Type.String({ description: "One of: trivial | small | feature | project" }),
14
+ reason: Type.Optional(Type.String({ description: "One line on why this tier fits the ask. REQUIRED when raising the tier above the current one." })),
15
+ new_task: Type.Optional(Type.Boolean({ description: "The human moved on to a different piece of work: clears the task budget, the tier, and the duplicate guard. Not for a correction or a follow-up on the same work." })),
16
+ }),
17
+ execute(toolCallId, params, signal, onUpdate, ctx) {
18
+ return toolCtx.executeSetTaskTier(toolCallId, params as SetTaskTierParams, signal, onUpdate, ctx);
19
+ },
20
+ renderCall(args, theme) {
21
+ return new Text(
22
+ theme.fg("toolTitle", theme.bold("set_task_tier ")) +
23
+ theme.fg("accent", String((args as any).tier || "?")) +
24
+ theme.fg("dim", (args as any).reason ? ` — ${String((args as any).reason).slice(0, 60)}` : ""),
25
+ 0, 0,
26
+ );
27
+ },
28
+ });
29
+ }
@@ -0,0 +1,62 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import type { SpawnResearchParams, ToolContext } from "./context.ts";
5
+
6
+ export function registerSpawnResearch(pi: ExtensionAPI, toolCtx: ToolContext): void {
7
+ pi.registerTool({
8
+ name: "spawn_research",
9
+ label: "Spawn Research",
10
+ description: "Run a read-only (read/grep/find/ls) helper and return findings.",
11
+ parameters: Type.Object({
12
+ task: Type.String({ description: "Investigation and expected findings." }),
13
+ persona: Type.Optional(Type.String({ description: "Research persona; omit for ad-hoc." })),
14
+ model: Type.Optional(Type.String({ description: "Anonymous-helper model; ignored with persona." })),
15
+ artifacts: Type.Optional(Type.Array(Type.String({ description: "Input artifact path." }))),
16
+ }),
17
+
18
+ execute(toolCallId, params, signal, onUpdate, ctx) {
19
+ return toolCtx.executeSpawnResearch(toolCallId, params as SpawnResearchParams, signal, onUpdate, ctx);
20
+ },
21
+
22
+ renderCall(args, theme) {
23
+ const persona = (args as any).persona;
24
+ const task = (args as any).task || "";
25
+ const preview = task.length > 60 ? task.slice(0, 57) + "..." : task;
26
+ return new Text(
27
+ theme.fg("toolTitle", theme.bold("spawn_research ")) +
28
+ theme.fg("accent", persona ? `@${persona}` : "ad-hoc") +
29
+ theme.fg("dim", " — ") +
30
+ theme.fg("muted", preview),
31
+ 0, 0,
32
+ );
33
+ },
34
+
35
+ renderResult(result, options, theme) {
36
+ const details = result.details as any;
37
+ if (!details) {
38
+ const text = result.content[0];
39
+ return new Text(text?.type === "text" ? text.text : "", 0, 0);
40
+ }
41
+ if (options.isPartial || details.status === "spawning") {
42
+ return new Text(
43
+ theme.fg("accent", `● ${details.handle || "research"}`) +
44
+ theme.fg("dim", " researching..."),
45
+ 0, 0,
46
+ );
47
+ }
48
+ const icon = details.status === "done" ? "✓" : "✗";
49
+ const color = details.status === "done" ? "success" : "error";
50
+ const elapsed = typeof details.elapsed === "number" ? Math.round(details.elapsed / 1000) : 0;
51
+ const header = theme.fg(color, `${icon} ${details.handle || "research"}`) +
52
+ theme.fg("dim", ` read-only ${elapsed}s`);
53
+ if (options.expanded && details.fullOutput) {
54
+ const output = details.fullOutput.length > 4000
55
+ ? details.fullOutput.slice(0, 4000) + "\n... [truncated]"
56
+ : details.fullOutput;
57
+ return new Text(header + "\n" + theme.fg("muted", output), 0, 0);
58
+ }
59
+ return new Text(header, 0, 0);
60
+ },
61
+ });
62
+ }
@@ -0,0 +1,29 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import type { TeamAdjustParams, ToolContext } from "./context.ts";
5
+
6
+ export function registerTeamAdjust(pi: ExtensionAPI, toolCtx: ToolContext): void {
7
+ pi.registerTool({
8
+ name: "team_adjust",
9
+ label: "Team Adjust",
10
+ description:
11
+ "Add or drop a specialist persona in the ACTIVE team (the roster you can dispatch to). Use sparingly, when the current roster genuinely cannot serve the task (e.g. add security-auditor for a security-sensitive change, drop an unused specialist). Not available at trivial/small tiers. The human sees every change and can revert with /af-agents-add /af-agents-drop.",
12
+ parameters: Type.Object({
13
+ action: Type.String({ description: "add | drop" }),
14
+ agent: Type.String({ description: "Persona name (case-insensitive), e.g. security-auditor" }),
15
+ reason: Type.String({ description: "One line on why the roster must change for this task." }),
16
+ }),
17
+ execute(toolCallId, params, signal, onUpdate, ctx) {
18
+ return toolCtx.executeTeamAdjust(toolCallId, params as TeamAdjustParams, signal, onUpdate, ctx);
19
+ },
20
+ renderCall(args, theme) {
21
+ return new Text(
22
+ theme.fg("toolTitle", theme.bold("team_adjust ")) +
23
+ theme.fg("accent", `${String((args as any).action || "?")} ${String((args as any).agent || "?")}`) +
24
+ theme.fg("dim", (args as any).reason ? ` — ${String((args as any).reason).slice(0, 50)}` : ""),
25
+ 0, 0,
26
+ );
27
+ },
28
+ });
29
+ }
@@ -0,0 +1,77 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import { Type } from "@sinclair/typebox";
3
+ import { Text } from "@mariozechner/pi-tui";
4
+ import { MAX_OPEN_ASSERTIONS } from "../assertion-ledger.js";
5
+ import type { SetAssertionsParams, UpdateAssertionParams, ToolContext } from "./context.ts";
6
+
7
+ export function registerVerificationContract(pi: ExtensionAPI, toolCtx: ToolContext): void {
8
+ pi.registerTool({
9
+ name: "set_assertions",
10
+ label: "Set Assertions",
11
+ description: `Replace this task's checkable assertion ledger (max ${MAX_OPEN_ASSERTIONS}); dispatch only evidence-gated work.`,
12
+ parameters: Type.Object({
13
+ assertions: Type.Array(
14
+ Type.Object({
15
+ id: Type.String({ description: "Stable id (A1, A2)." }),
16
+ tag: Type.String({ description: "test | runtime-ui | code-grep | manual." }),
17
+ text: Type.String({ description: "One pass condition." }),
18
+ source: Type.String({ description: "Requirement origin." }),
19
+ }),
20
+ { description: `Replacement list; soft cap ${MAX_OPEN_ASSERTIONS}.` },
21
+ ),
22
+ }),
23
+ execute(toolCallId, params, signal, onUpdate, ctx) {
24
+ return toolCtx.executeSetAssertions(toolCallId, params as SetAssertionsParams, signal, onUpdate, ctx);
25
+ },
26
+ renderCall(args, theme) {
27
+ const n = Array.isArray((args as any).assertions) ? (args as any).assertions.length : 0;
28
+ return new Text(
29
+ theme.fg("toolTitle", theme.bold("set_assertions ")) +
30
+ theme.fg("muted", `${n} assertion(s)`),
31
+ 0, 0,
32
+ );
33
+ },
34
+ });
35
+
36
+ pi.registerTool({
37
+ name: "update_assertion",
38
+ label: "Update Assertion",
39
+ description: "Record a verification result. proven requires named evidence; unproven/failed are not done.",
40
+ parameters: Type.Object({
41
+ id: Type.String({ description: "Assertion id to update, e.g. A2." }),
42
+ status: Type.String({ description: "One of: proven | unproven | failed." }),
43
+ evidence: Type.Optional(Type.String({ description: "Named evidence for proven/failed — test name, command output, file:line, or runtime observation." })),
44
+ }),
45
+ execute(toolCallId, params, signal, onUpdate, ctx) {
46
+ return toolCtx.executeUpdateAssertion(toolCallId, params as UpdateAssertionParams, signal, onUpdate, ctx);
47
+ },
48
+ renderCall(args, theme) {
49
+ const id = (args as any).id || "";
50
+ const status = (args as any).status || "";
51
+ return new Text(
52
+ theme.fg("toolTitle", theme.bold("update_assertion ")) +
53
+ theme.fg("accent", id) +
54
+ theme.fg("dim", " → ") +
55
+ theme.fg("muted", status),
56
+ 0, 0,
57
+ );
58
+ },
59
+ });
60
+
61
+ pi.registerTool({
62
+ name: "get_assertions",
63
+ label: "Get Assertions",
64
+ description: "Read the full assertion ledger, especially after compaction. Read-only.",
65
+ parameters: Type.Object({}),
66
+ execute(toolCallId, params, signal, onUpdate, ctx) {
67
+ return toolCtx.executeGetAssertions(toolCallId, params as Record<string, never>, signal, onUpdate, ctx);
68
+ },
69
+ renderCall(_args, theme) {
70
+ return new Text(
71
+ theme.fg("toolTitle", theme.bold("get_assertions ")) +
72
+ theme.fg("muted", `${toolCtx.getAssertionCount()} assertion(s)`),
73
+ 0, 0,
74
+ );
75
+ },
76
+ });
77
+ }
@@ -0,0 +1,60 @@
1
+ import type { ChildProcess } from "child_process";
2
+ import type { DelegationChild } from "./dispatch-core.ts";
3
+ import type { SpecialistContextManifest } from "../lib/context-budget-child-prompt.ts";
4
+ import type { FleetTranscriptStore } from "../lib/fleet-transcript-store.ts";
5
+ import type { HistoryEntry } from "./ui/history-store.ts";
6
+ import type { TimelineEntry } from "./ui/zoom.ts";
7
+ import type { ResearchAgentDef, ResearchState as RuntimeResearchState } from "./research/runtime.ts";
8
+
9
+ export interface SubagentRole {
10
+ model: string;
11
+ tools?: string;
12
+ fallbackModel?: string;
13
+ }
14
+
15
+ export interface AgentDef extends ResearchAgentDef {
16
+ name: string;
17
+ description: string;
18
+ tools: string;
19
+ model?: string;
20
+ fallbackModel?: string;
21
+ models?: string[];
22
+ subagents?: Record<string, SubagentRole>;
23
+ delegateDepth?: number;
24
+ warnings?: string[];
25
+ kind?: string;
26
+ thinking?: string;
27
+ systemPrompt: string;
28
+ file: string;
29
+ }
30
+
31
+ export interface AgentState {
32
+ def: AgentDef;
33
+ status: "idle" | "running" | "done" | "error";
34
+ task: string;
35
+ toolCount: number;
36
+ elapsed: number;
37
+ lastWork: string;
38
+ contextPct: number;
39
+ contextTokens: number;
40
+ sessionFile: string | null;
41
+ specialistManifest?: SpecialistContextManifest;
42
+ runCount: number;
43
+ runsSinceFresh: number;
44
+ timer?: ReturnType<typeof setInterval>;
45
+ delegations?: Map<string, DelegationChild>;
46
+ delegationsWatcher?: { close(): void };
47
+ proc?: ChildProcess;
48
+ killedByOperator?: boolean;
49
+ restarting?: boolean;
50
+ onTerminate?: () => void;
51
+ timeline: TimelineEntry[];
52
+ transcriptStore?: FleetTranscriptStore;
53
+ zoomRender?: (force?: boolean) => void;
54
+ histEntry?: HistoryEntry;
55
+ lastBackend?: "native" | "coms";
56
+ comsPeerModel?: string;
57
+ comsAbort?: () => void;
58
+ }
59
+
60
+ export type ResearchState = RuntimeResearchState<AgentDef>;
@@ -0,0 +1,86 @@
1
+ import { Key, matchesKey } from "@mariozechner/pi-tui";
2
+ import type { ModelPolicy } from "../policy/models.ts";
3
+ import type { ContextPressureState } from "../context-pressure.ts";
4
+ import { contextPressureDiagnostic } from "../context-pressure.ts";
5
+ import type { ResearchState } from "../research/runtime.ts";
6
+ import type { DetailAgentDef } from "./detail-panel.ts";
7
+ import type { DashboardAgentState } from "./fleet-dashboard.ts";
8
+ import { resolveContextWindow } from "../context-window.js";
9
+ import { collectContextBudgetSnapshot, type LivePlane } from "../context-budget-snapshot.ts";
10
+ import { CONTEXT_BUDGET_CHROME_ROWS, contextBudgetTransition, renderContextBudget, type ContextBudgetViewState } from "../../lib/context-budget-view.ts";
11
+ import { safeSchemaChars } from "../../lib/context-budget.ts";
12
+ import {
13
+ buildSpecialistContextManifest, delegateStandingParts, nativeResearchSystemPrompt,
14
+ nativeSpecialistSystemPrompt, researchStandingParts, specialistStandingParts,
15
+ } from "../../lib/context-budget-child-prompt.ts";
16
+ import { FULLSCREEN_OVERLAY, bodyRows } from "../../lib/fleet-overlay.ts";
17
+ import { createPanelResources } from "../../lib/fleet-panel.ts";
18
+
19
+ export interface ContextBudgetUiContext {
20
+ cwd?: string;
21
+ getSystemPromptOptions?(): unknown;
22
+ ui: { custom(factory: (tui: any, theme: any, kb: any, done: () => void) => any, options: unknown): Promise<unknown> };
23
+ }
24
+
25
+ export interface ContextBudgetDeps<TDef extends DetailAgentDef, TAgent extends DashboardAgentState<TDef>, TResearch extends ResearchState<TDef>> {
26
+ getAgents(): ReadonlyMap<string, TAgent>;
27
+ getResearch(): ReadonlyMap<number, TResearch>;
28
+ getAllDefs(): readonly TDef[];
29
+ getResearchPersonas(): readonly TDef[];
30
+ getPeers(): Iterable<{ name: string; model?: string; context_used_pct?: number }>;
31
+ modelPolicy: ModelPolicy<TDef>;
32
+ displayName(name: string): string;
33
+ getProjectDocsPaths(): readonly string[];
34
+ getUserLanguage(): string;
35
+ getDelegateExtensionPath(): string | null;
36
+ safeAgentKey(name: string): string;
37
+ projectPolicyPaths(cwd: string): string[];
38
+ modelWindowLookup(ctx: ContextBudgetUiContext): (model: string) => number | undefined;
39
+ getResearchTools(): string;
40
+ getPromptLedger(): readonly unknown[];
41
+ getPressureState(): ContextPressureState;
42
+ buildHubSystemPrompt(): void;
43
+ getAllTools(): readonly any[];
44
+ getActiveTools(): readonly string[];
45
+ getCommands(): readonly any[];
46
+ }
47
+
48
+ export function createContextBudgetUi<TDef extends DetailAgentDef, TAgent extends DashboardAgentState<TDef>, TResearch extends ResearchState<TDef>>(deps: ContextBudgetDeps<TDef, TAgent, TResearch>) {
49
+ function toolSchemaChars(toolList: string): number {
50
+ const names = toolList.split(",").map(name => name.trim()).filter(Boolean);
51
+ const byName = new Map(deps.getAllTools().map(tool => [tool.name, tool]));
52
+ return names.reduce((sum, name) => { const tool = byName.get(name); return sum + (tool ? safeSchemaChars({ name: tool.name, description: tool.description, parameters: tool.parameters, promptGuidelines: tool.promptGuidelines }) : name.length); }, 0);
53
+ }
54
+
55
+ function contextPlanes(ctx: ContextBudgetUiContext): LivePlane[] {
56
+ const agents = deps.getAgents(), researchStates = deps.getResearch(), baseChars = safeSchemaChars(ctx.getSystemPromptOptions?.() ?? {}), cwd = ctx.cwd || process.cwd();
57
+ const projection = (def: TDef, research = false) => research
58
+ ? researchStandingParts({ replacementPrompt: nativeResearchSystemPrompt({ personaName: def.name, personaPath: def.file, cwd }), toolChars: toolSchemaChars(deps.getResearchTools()), basePromptChars: 0 })
59
+ : specialistStandingParts({ replacementPrompt: nativeSpecialistSystemPrompt({ manifest: agents.get(def.name.toLowerCase())?.specialistManifest ?? buildSpecialistContextManifest({ personaName: def.name, personaPath: def.file, personaPrompt: def.systemPrompt, task: "", rulesPaths: deps.projectPolicyPaths(cwd), docsPaths: [...deps.getProjectDocsPaths()], hasAssertions: false, hasScope: false, hasArtifacts: false, delegateRoles: def.subagents && deps.getDelegateExtensionPath() ? Object.keys(def.subagents) : [] }), userLanguage: deps.getUserLanguage(), agentKey: deps.safeAgentKey(def.name), runNumber: agents.get(def.name.toLowerCase())?.runCount ?? 0 }), toolChars: toolSchemaChars(def.tools) });
60
+ const windowFor = (model: string) => model ? resolveContextWindow(model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: 0 }).window || undefined : undefined;
61
+ const local = deps.getAllDefs().filter(def => def.kind !== "research").map(def => { const state = agents.get(def.name.toLowerCase()), model = deps.modelPolicy.resolvedModel(state?.def as TDef ?? def) ?? ""; return { id: `specialist/${def.name}`, label: deps.displayName(def.name), plane: "specialist" as const, model, window: windowFor(model), tokens: state?.contextTokens, projectionParts: projection(def) }; });
62
+ const research = deps.getResearchPersonas().map(def => { const active = Array.from(researchStates.values()).find(state => state.def.name === def.name), model = active?.model ?? deps.modelPolicy.resolvedModel(def) ?? ""; return { id: `research/${def.name}`, label: deps.displayName(def.name), plane: "research" as const, model, window: windowFor(model), tokens: active?.contextTokens, projectionParts: projection(def, true), attribution: "projected" as const }; });
63
+ const delegates = Array.from(agents.values()).flatMap(state => Array.from(state.delegations?.values() ?? []).map(child => { const role = Object.entries(state.def.subagents ?? {}).find(([name]) => name.toLowerCase() === child.role.toLowerCase()); const parts = role ? delegateStandingParts({ toolChars: toolSchemaChars(child.tools || role[1].tools || state.def.tools), basePromptChars: baseChars, roleNames: [role[0]] }) : undefined; return parts ? { id: `delegate/${child.id}`, label: child.role, plane: "delegate" as const, model: child.model, window: windowFor(child.model), tokens: child.tokens, projectionParts: parts, attribution: "projected" as const } : { id: `delegate/${child.id}`, label: child.role, plane: "delegate" as const, model: child.model, window: windowFor(child.model), tokens: child.tokens, attribution: "unavailable" as const }; }));
64
+ const peers = Array.from(deps.getPeers()).map(peer => ({ id: `peer/${peer.name}`, label: peer.name, plane: "peer" as const, model: peer.model, window: windowFor(peer.model ?? ""), percent: peer.context_used_pct, projectionChars: 0, attribution: "unavailable" as const }));
65
+ return [...local, ...research, ...delegates, ...peers];
66
+ }
67
+
68
+ async function openContextBudget(ctx: ContextBudgetUiContext): Promise<void> {
69
+ const resources = createPanelResources();
70
+ const toInput = (data: string): string => {
71
+ if (matchesKey(data, Key.up)) return "\u001b[A";
72
+ if (matchesKey(data, Key.down)) return "\u001b[B";
73
+ if (matchesKey(data, Key.pageUp)) return "\u001b[5~";
74
+ if (matchesKey(data, Key.pageDown)) return "\u001b[6~";
75
+ if (matchesKey(data, Key.enter)) return "\r";
76
+ if (matchesKey(data, Key.escape)) return "\u001b";
77
+ return data;
78
+ };
79
+ const state: ContextBudgetViewState = { selection: { index: 0 }, expanded: new Set(), scrollOffset: 0 };
80
+ const collect = () => { deps.buildHubSystemPrompt(); return collectContextBudgetSnapshot(ctx, { ledger: deps.getPromptLedger() as any, pressure: contextPressureDiagnostic(deps.getPressureState()), planes: contextPlanes(ctx), tools: [...deps.getAllTools()], activeToolNames: [...deps.getActiveTools()], commands: [...deps.getCommands()] }); };
81
+ let snapshot = collect(); const refresh = () => { snapshot = collect(); };
82
+ try { await ctx.ui.custom((tui: any, _theme: any, _kb: any, done: () => void) => { resources.every(1000, () => { refresh(); tui.requestRender(); }); return { render: (w: number) => renderContextBudget(snapshot, state, w, bodyRows(tui.terminal?.rows, CONTEXT_BUDGET_CHROME_ROWS)), handleInput: (data: string) => { const intent = contextBudgetTransition(toInput(data), state, snapshot, bodyRows(tui.terminal?.rows, CONTEXT_BUDGET_CHROME_ROWS)); if (intent === "close") done(); if (intent === "refresh") refresh(); tui.requestRender(); }, invalidate() {}, dispose: () => resources.dispose() }; }, FULLSCREEN_OVERLAY); } finally { resources.dispose(); }
83
+ }
84
+
85
+ return { contextPlanes, openContextBudget };
86
+ }