@chankov/agent-fleet 1.0.1 → 1.0.2

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 (316) hide show
  1. package/.pi/extensions/package-lock.json +77 -45
  2. package/.pi/harnesses/agent-hub/README.md +109 -18
  3. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  4. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  5. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  6. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  7. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  8. package/.pi/harnesses/agent-hub/hub-state-audit.js +18 -0
  9. package/.pi/harnesses/agent-hub/index.ts +988 -422
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  12. package/.pi/harnesses/agent-hub/run-budget.js +12 -13
  13. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  14. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  15. package/.pi/harnesses/coms/package.json +1 -1
  16. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  17. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  18. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  19. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  20. package/.pi/harnesses/lib/context-budget.ts +114 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  22. package/.pi/harnesses/package-lock.json +73 -80
  23. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  25. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  26. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  27. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  28. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  29. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  30. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  31. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  32. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  33. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  34. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  35. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  36. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  37. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  38. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  39. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  40. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  41. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  42. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  43. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  44. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  45. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  46. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  47. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  48. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  49. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  50. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  51. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  52. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  53. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  54. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  55. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  56. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  57. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  58. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  59. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  60. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  61. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  62. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  63. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  70. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  71. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  72. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  73. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  74. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  75. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  76. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  77. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  78. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  79. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  80. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  81. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  82. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  83. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  84. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  85. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  86. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  87. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  88. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  89. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  90. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  91. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  92. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  93. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  94. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  95. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  96. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  97. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  98. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  99. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  100. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  101. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  102. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  103. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  104. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  105. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  106. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  107. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  108. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  109. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  110. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  111. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  112. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  113. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  114. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  115. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  116. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  117. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  118. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  119. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  120. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  121. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  122. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  123. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  124. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  125. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  126. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  127. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  128. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  129. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  130. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  131. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  132. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  133. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  134. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  135. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  136. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  138. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  139. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  140. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  141. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  142. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  143. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  144. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  145. package/.versions/1.0.2/.version +1 -0
  146. package/.versions/1.0.2/agents/architect.md +24 -0
  147. package/.versions/1.0.2/agents/bowser.md +27 -0
  148. package/.versions/1.0.2/agents/builder.md +54 -0
  149. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  150. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  151. package/.versions/1.0.2/agents/documenter.md +18 -0
  152. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  153. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  154. package/.versions/1.0.2/agents/planner.md +70 -0
  155. package/.versions/1.0.2/agents/releaser.md +24 -0
  156. package/.versions/1.0.2/agents/researcher.md +28 -0
  157. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  158. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  159. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  160. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  161. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  162. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  163. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  164. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  165. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  166. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  167. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  168. package/.versions/1.0.2/docs/getting-started.md +98 -0
  169. package/.versions/1.0.2/docs/npm-install.md +292 -0
  170. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  171. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  172. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  173. package/.versions/1.0.2/hermes/README.md +347 -0
  174. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  175. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  176. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  177. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  178. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  179. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  180. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  181. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  182. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  183. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  184. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  185. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  186. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  187. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  188. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  189. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  190. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  191. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  192. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  193. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  194. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  195. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  196. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  197. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  198. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  199. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  200. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  201. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  202. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  203. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  204. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  205. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  206. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  207. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  208. package/.versions/1.0.2/install-manifest.json +2745 -0
  209. package/.versions/1.0.2/justfile +272 -0
  210. package/.versions/1.0.2/manifest-meta.json +882 -0
  211. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  212. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  213. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  214. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  215. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  216. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  217. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  218. package/.versions/1.0.2/references/security-checklist.md +179 -0
  219. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  220. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  221. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  222. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  223. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  224. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  225. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  226. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  227. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  228. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  229. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  230. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  231. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  232. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  233. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  234. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  235. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  236. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  237. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  238. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  239. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  240. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  241. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  242. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  243. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  244. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  245. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  246. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  247. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  248. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  249. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  250. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  251. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  252. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  253. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  254. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  255. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  256. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  257. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  258. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  259. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  260. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  261. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  262. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  263. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  264. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  265. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  266. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  267. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  268. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  269. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  270. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  271. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  272. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  273. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  274. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  275. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  276. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  277. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  278. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  279. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  280. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  281. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  282. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  283. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  284. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  285. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  286. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  287. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  288. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  289. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  290. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  291. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  292. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  293. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  294. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  295. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  299. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  300. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  301. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  302. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  303. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  304. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  305. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  306. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  307. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  308. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  309. package/CHANGELOG.md +9 -0
  310. package/README.md +4 -2
  311. package/agents/orchestrator.md +4 -56
  312. package/docs/ARCHITECTURE.md +48 -16
  313. package/docs/agent-fleet-setup.md +33 -2
  314. package/docs/pi-extensions.md +29 -2
  315. package/install-manifest.json +2 -2
  316. package/package.json +2 -2
@@ -0,0 +1,107 @@
1
+ import { clampScroll, fitToHeight } from "./fleet-overlay.ts";
2
+ import { moveSelection, reconcileSelection, type Selection } from "./fleet-selection.ts";
3
+ import type { ContextBudgetSnapshot } from "../agent-hub/context-budget-snapshot.ts";
4
+
5
+ export interface ContextBudgetViewState { selection: Selection; expanded: Set<string>; scrollOffset: number; }
6
+ export const CONTEXT_BUDGET_CHROME_ROWS = 5;
7
+ const tokens = (n: number | undefined) => n == null ? "—" : Intl.NumberFormat("en").format(Math.round(n));
8
+ const pct = (n: number | undefined) => n == null ? "window unknown" : `${n.toFixed(1)}%`;
9
+ const ANSI = /\x1B\[[0-?]*[ -\/]*[@-~]/;
10
+ /** Truncate by terminal cells while never cutting an ANSI escape sequence. */
11
+ export function ansiTruncate(value: string, width: number): string {
12
+ let cells = 0; let out = "";
13
+ for (let i = 0; i < value.length;) {
14
+ const escape = value.slice(i).match(/^\x1B\[[0-?]*[ -\/]*[@-~]/)?.[0];
15
+ if (escape) { out += escape; i += escape.length; continue; }
16
+ const char = String.fromCodePoint(value.codePointAt(i)!); if (cells + 1 > width) break;
17
+ out += char; cells++; i += char.length;
18
+ }
19
+ return out + (ANSI.test(out) ? "\x1b[0m" : "");
20
+ }
21
+
22
+ function groupKey(category: string): string {
23
+ if (category === "tool") return "group/tools";
24
+ if (category === "addon") return "group/addons";
25
+ if (category === "skill") return "group/skills";
26
+ if (category === "conversation") return "group/conversation";
27
+ if (category === "project") return "group/project";
28
+ if (category === "roster" || category === "persona") return "group/roster";
29
+ return "group/system";
30
+ }
31
+
32
+ export interface ContextBudgetRow { key: string; label: string; detail: string; expandable?: boolean; }
33
+
34
+ export function contextBudgetRows(snapshot: ContextBudgetSnapshot, expanded: Set<string> = new Set()): ContextBudgetRow[] {
35
+ const groups = new Map<string, { key: string; label: string; children: ContextBudgetRow[] }>();
36
+ const order = ["group/system", "group/project", "group/roster", "group/tools", "group/addons", "group/skills", "group/conversation"];
37
+ for (const component of snapshot.components) {
38
+ const key = groupKey(component.category);
39
+ if (!groups.has(key)) groups.set(key, { key, label: key.replace("group/", ""), children: [] });
40
+ groups.get(key)!.children.push({
41
+ key: `hub/${component.id}`,
42
+ label: ` ${component.label}`,
43
+ detail: `${component.visibility} · ${component.confidence} · ${tokens(component.adjustedTokens ?? component.estimatedTokens)} tok`,
44
+ });
45
+ }
46
+ const rows: ContextBudgetRow[] = [];
47
+ for (const key of order) {
48
+ const group = groups.get(key);
49
+ if (!group) continue;
50
+ rows.push({ key: group.key, label: group.label, detail: `${group.children.length} items`, expandable: true });
51
+ if (expanded.has(group.key)) rows.push(...group.children);
52
+ }
53
+ for (const plane of snapshot.planes) {
54
+ const key = `plane/${plane.summary.plane}/${plane.components[0]?.id ?? plane.summary.plane}`;
55
+ rows.push({ key, label: `${plane.summary.plane} plane`, detail: `${tokens(plane.summary.measuredTokens)} / ${tokens(plane.summary.window)} · ${pct(plane.summary.occupancyPercent)}`, expandable: true });
56
+ if (expanded.has(key)) {
57
+ for (const component of plane.components) {
58
+ rows.push({ key: `${key}/${component.id}`, label: ` ${component.label}`, detail: `${component.confidence} · ${tokens(component.adjustedTokens ?? component.estimatedTokens)} tok` });
59
+ }
60
+ }
61
+ }
62
+ return rows;
63
+ }
64
+
65
+ function keepSelectionVisible(state: ContextBudgetViewState, rows: readonly ContextBudgetRow[], bodyHeight: number): void {
66
+ const viewport = Math.max(1, bodyHeight);
67
+ if (state.selection.index < state.scrollOffset) state.scrollOffset = state.selection.index;
68
+ else if (state.selection.index >= state.scrollOffset + viewport) state.scrollOffset = state.selection.index - viewport + 1;
69
+ state.scrollOffset = clampScroll(state.scrollOffset, rows.length, viewport);
70
+ }
71
+
72
+ export function contextBudgetTransition(data: string, state: ContextBudgetViewState, snapshot: ContextBudgetSnapshot, bodyHeight: number): "close" | "refresh" | undefined {
73
+ let rows = contextBudgetRows(snapshot, state.expanded); reconcileSelection(state.selection, rows);
74
+ if (data === "q" || data === "\u001b") return "close";
75
+ if (data === "r") return "refresh";
76
+ if (data === "\u001b[A") moveSelection(state.selection, rows, -1);
77
+ else if (data === "\u001b[B") moveSelection(state.selection, rows, 1);
78
+ else if (data === "\u001b[5~") moveSelection(state.selection, rows, -Math.max(1, bodyHeight));
79
+ else if (data === "\u001b[6~") moveSelection(state.selection, rows, Math.max(1, bodyHeight));
80
+ else if (data === "g") { state.selection.index = 0; state.selection.key = rows[0]?.key; }
81
+ else if (data === "G") { state.selection.index = Math.max(0, rows.length - 1); state.selection.key = rows.at(-1)?.key; }
82
+ else if (data === "\r" && rows[state.selection.index]?.expandable) {
83
+ const key = state.selection.key!;
84
+ state.expanded.has(key) ? state.expanded.delete(key) : state.expanded.add(key);
85
+ rows = contextBudgetRows(snapshot, state.expanded);
86
+ reconcileSelection(state.selection, rows);
87
+ }
88
+ keepSelectionVisible(state, rows, bodyHeight);
89
+ return undefined;
90
+ }
91
+
92
+ /** Fixed-height, metadata-only overlay rendering. */
93
+ export function renderContextBudget(snapshot: ContextBudgetSnapshot, state: ContextBudgetViewState, width: number, height: number): string[] {
94
+ const rows = contextBudgetRows(snapshot, state.expanded); reconcileSelection(state.selection, rows);
95
+ keepSelectionVisible(state, rows, Math.max(0, height - 2));
96
+ const hub = snapshot.hub.summary;
97
+ const pressure = snapshot.pressure;
98
+ const pressureLabel = pressure ? ` · pressure ${pressure.phase}` : "";
99
+ const header = ansiTruncate(`CONTEXT BUDGET ${snapshot.model ?? "model unknown"} · ${tokens(hub.measuredTokens)} / ${tokens(hub.window)} (${pct(hub.occupancyPercent)})${pressureLabel} · ${snapshot.estimator}`, Math.max(1, width));
100
+ const visible = rows.slice(state.scrollOffset, state.scrollOffset + Math.max(0, height - 2));
101
+ const body = visible.map((row) => ansiTruncate(`${state.selection.key === row.key ? ">" : " "} ${row.label} — ${row.detail}`, Math.max(1, width)));
102
+ const recovery = pressure
103
+ ? `warn ${pressure.warningPercent}% · auto ${pressure.automaticPercent}% · last ${pressure.lastRecoveryOutcome} · `
104
+ : "";
105
+ const footer = ansiTruncate(`${recovery}Attributed ${tokens(hub.attributedTokens)} · residual ${tokens(hub.residualTokens)} · ↑↓ Enter r q`, Math.max(1, width));
106
+ return fitToHeight([header, ...fitToHeight(body, Math.max(0, height - 2)), footer], height);
107
+ }
@@ -0,0 +1,114 @@
1
+ export type ContextPlane = "hub" | "specialist" | "research" | "delegate" | "peer";
2
+ export type ContextCategory = "system" | "project" | "persona" | "roster" | "skill" | "tool" | "addon" | "conversation" | "protocol" | "unattributed";
3
+ export type ContextPersistence = "fixed" | "session" | "turn" | "message" | "projected";
4
+ export type ContextVisibility = "model-visible" | "loaded-excluded" | "ui-only" | "unknown";
5
+ export type ContextConfidence = "exact-chars" | "heuristic" | "provider-scaled" | "provider-total" | "unavailable";
6
+
7
+ /** Metadata-only accounting record. Deliberately contains no component text. */
8
+ export interface ContextBudgetComponent {
9
+ id: string;
10
+ parentId?: string;
11
+ plane: ContextPlane;
12
+ category: ContextCategory;
13
+ label: string;
14
+ source?: string;
15
+ persistence: ContextPersistence;
16
+ visibility: ContextVisibility;
17
+ chars: number;
18
+ estimatedTokens: number;
19
+ adjustedTokens?: number;
20
+ confidence: ContextConfidence;
21
+ }
22
+
23
+ export interface ContextPlaneSummary {
24
+ plane: ContextPlane;
25
+ measuredTokens?: number;
26
+ attributedTokens: number;
27
+ residualTokens?: number;
28
+ window?: number;
29
+ occupancyPercent?: number;
30
+ }
31
+
32
+ export const TOKEN_ESTIMATOR = "chars/4-v1";
33
+
34
+ /** A named, provider-independent heuristic retained beside provider measurements. */
35
+ export function estimateTokens(chars: number): number {
36
+ return Math.ceil(Math.max(0, Number.isFinite(chars) ? chars : 0) / 4);
37
+ }
38
+
39
+ /** Exact JavaScript string character count (not bytes) without retaining text. */
40
+ export function characterCount(value: unknown): number {
41
+ return typeof value === "string" ? value.length : String(value ?? "").length;
42
+ }
43
+
44
+ /**
45
+ * Safely measure a schema's serialised representation. Unsupported values are
46
+ * represented by stable markers; this never throws on circular user schemas.
47
+ */
48
+ export function safeSchemaChars(schema: unknown): number {
49
+ const seen = new WeakSet<object>();
50
+ const json = JSON.stringify(schema, (_key, value) => {
51
+ if (typeof value === "bigint") return "[bigint]";
52
+ if (typeof value === "function") return "[function]";
53
+ if (typeof value === "symbol") return "[symbol]";
54
+ if (value && typeof value === "object") {
55
+ if (seen.has(value)) return "[circular]";
56
+ seen.add(value);
57
+ }
58
+ return value;
59
+ });
60
+ return characterCount(json ?? "[undefined]");
61
+ }
62
+
63
+ export function component(input: Omit<ContextBudgetComponent, "chars" | "estimatedTokens"> & { chars?: number }): ContextBudgetComponent {
64
+ const chars = Math.max(0, Number(input.chars) || 0);
65
+ return { ...input, chars, estimatedTokens: estimateTokens(chars) };
66
+ }
67
+
68
+ /**
69
+ * Reconcile visible component estimates with a provider total. The raw estimate
70
+ * always remains intact. Estimated components are scaled only when needed;
71
+ * non-negative residual absorbs all rounding.
72
+ */
73
+ export function reconcileComponents(components: readonly ContextBudgetComponent[], measuredTokens?: number): ContextBudgetComponent[] {
74
+ const measured = Number(measuredTokens);
75
+ const hasMeasured = Number.isFinite(measured) && measured >= 0;
76
+ const visible = components.filter((entry) => entry.visibility === "model-visible");
77
+ const estimate = visible.reduce((sum, entry) => sum + Math.max(0, entry.estimatedTokens), 0);
78
+ const scale = hasMeasured && estimate > measured && estimate > 0 ? measured / estimate : 1;
79
+ return components.map((entry) => {
80
+ if (entry.visibility !== "model-visible") return { ...entry, adjustedTokens: 0, confidence: entry.confidence === "unavailable" ? "unavailable" : "exact-chars" };
81
+ const adjustedTokens = Math.max(0, Math.floor(Math.max(0, entry.estimatedTokens) * scale));
82
+ return {
83
+ ...entry,
84
+ adjustedTokens,
85
+ confidence: hasMeasured && scale < 1 ? "provider-scaled" : entry.confidence,
86
+ };
87
+ });
88
+ }
89
+
90
+ /** Produce a non-negative provider residual and an exact post-rounding total. */
91
+ export function reconcilePlane(components: readonly ContextBudgetComponent[], plane: ContextPlane, measuredTokens?: number, window?: number): { components: ContextBudgetComponent[]; summary: ContextPlaneSummary; residual?: ContextBudgetComponent } {
92
+ const reconciled = reconcileComponents(components, measuredTokens);
93
+ const measured = Number(measuredTokens);
94
+ const hasMeasured = Number.isFinite(measured) && measured >= 0;
95
+ const attributedTokens = reconciled
96
+ .filter((entry) => entry.plane === plane && entry.visibility === "model-visible")
97
+ .reduce((sum, entry) => sum + Math.max(0, entry.adjustedTokens ?? 0), 0);
98
+ const residualTokens = hasMeasured ? Math.max(0, measured - attributedTokens) : undefined;
99
+ const validWindow = Number(window);
100
+ const occupancyPercent = hasMeasured && Number.isFinite(validWindow) && validWindow > 0 ? (measured / validWindow) * 100 : undefined;
101
+ const residual = residualTokens === undefined ? undefined : {
102
+ id: `${plane}/provider-unattributed`, plane, category: "unattributed", label: "Provider / serialization / unattributed",
103
+ persistence: "turn", visibility: "model-visible", chars: 0, estimatedTokens: 0, adjustedTokens: residualTokens,
104
+ confidence: "provider-total" as const,
105
+ };
106
+ return { components: reconciled, summary: { plane, measuredTokens: hasMeasured ? measured : undefined, attributedTokens, residualTokens, window: Number.isFinite(validWindow) && validWindow > 0 ? validWindow : undefined, occupancyPercent }, residual };
107
+ }
108
+
109
+ /** Context capacity is meaningful only with this plane's own known window. */
110
+ export function planeOccupancy(tokens: number | undefined, window: number | undefined): number | undefined {
111
+ const total = Number(tokens);
112
+ const capacity = Number(window);
113
+ return Number.isFinite(total) && total >= 0 && Number.isFinite(capacity) && capacity > 0 ? (total / capacity) * 100 : undefined;
114
+ }
@@ -2,9 +2,97 @@ import type { FleetRow } from "./fleet-read-model.ts";
2
2
  import type { ThemeLike } from "./fleet-dashboard-view.ts";
3
3
 
4
4
  export interface TimelineEntry { kind: "text" | "tool" | "thinking"; title: string; content: string; timestamp: number; }
5
+ export interface PiModelSummary { provider?: unknown; id?: unknown; name?: unknown; }
6
+ export interface FleetModelChoice { spec: string; label: string; }
7
+ export interface FleetModelPickerState { index: number; scrollOffset: number; }
5
8
  export const DETAIL_CHROME_ROWS = 4;
6
9
  const trim = (s: string, n: number) => Array.from(s).length <= n ? s : n <= 1 ? Array.from(s).slice(0, n).join("") : `${Array.from(s).slice(0, n - 1).join("")}…`;
7
10
 
11
+ /** Convert Pi's available model registry into stable, deduplicated picker rows. */
12
+ export function fleetModelChoices(models: readonly PiModelSummary[], current?: string): FleetModelChoice[] {
13
+ const bySpec = new Map<string, FleetModelChoice>();
14
+ for (const model of models) {
15
+ const provider = typeof model?.provider === "string" ? model.provider.trim() : "";
16
+ const id = typeof model?.id === "string" ? model.id.trim() : "";
17
+ if (!provider || !id) continue;
18
+ const spec = `${provider}/${id}`;
19
+ if (bySpec.has(spec)) continue;
20
+ const name = typeof model.name === "string" ? model.name.trim() : "";
21
+ const detail = name && name !== id ? ` — ${name}` : "";
22
+ bySpec.set(spec, { spec, label: `${spec}${detail}${spec === current ? " (current)" : ""}` });
23
+ }
24
+ return Array.from(bySpec.values()).sort((a, b) => a.spec.localeCompare(b.spec));
25
+ }
26
+
27
+ /** Render the model picker in the same full-screen layer as Fleet Detail. */
28
+ export function renderFleetModelPicker(
29
+ title: string,
30
+ choices: readonly FleetModelChoice[],
31
+ state: FleetModelPickerState,
32
+ width: number,
33
+ bodyHeight: number,
34
+ theme: ThemeLike,
35
+ ): string[] {
36
+ const w = Math.max(1, width), body = Math.max(0, bodyHeight);
37
+ const maxOffset = Math.max(0, choices.length - body);
38
+ const offset = Math.max(0, Math.min(state.scrollOffset, maxOffset));
39
+ const rows = choices.slice(offset, offset + body).map((choice, visibleIndex) => {
40
+ const selected = offset + visibleIndex === state.index;
41
+ const line = trim(`${selected ? " ›" : " "} ${choice.label}`, w);
42
+ return selected ? theme.fg("accent", theme.bold(line)) : line;
43
+ });
44
+ const lines = [
45
+ theme.bold(trim(` Model for ${title} · next run · ${choices.length} available`, w)),
46
+ theme.fg("dim", "╭" + "─".repeat(Math.max(0, w - 2)) + "╮"),
47
+ ...rows,
48
+ ...Array(Math.max(0, body - rows.length)).fill(""),
49
+ theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"),
50
+ theme.fg("dim", "↑↓ select · PgUp/PgDn page · Home/End · Enter apply · Esc cancel"),
51
+ ];
52
+ return lines.slice(0, body + DETAIL_CHROME_ROWS).concat(Array(Math.max(0, body + DETAIL_CHROME_ROWS - lines.length)).fill(""));
53
+ }
54
+
55
+ export type FleetDetailKey = "up" | "down" | "pageUp" | "pageDown" | "home" | "end" | "enter" | "escape" | "copy";
56
+
57
+ /** Convert a key identified by Pi's matcher into the detail controller's stable input. */
58
+ export function normalizeFleetDetailInput(data: string, key?: FleetDetailKey): string {
59
+ if (key === "up") return "\u001b[A";
60
+ if (key === "down") return "\u001b[B";
61
+ if (key === "pageUp") return "\u001b[5~";
62
+ if (key === "pageDown") return "\u001b[6~";
63
+ if (key === "home") return "\u001b[H";
64
+ if (key === "end") return "\u001b[F";
65
+ if (key === "enter") return "\r";
66
+ if (key === "escape") return "\u001b";
67
+ if (key === "copy") return "\u0003";
68
+ return data;
69
+ }
70
+
71
+ /** Pure navigation for the inline model picker. */
72
+ export function modelPickerTransition(
73
+ input: string,
74
+ state: FleetModelPickerState,
75
+ choiceCount: number,
76
+ bodyHeight: number,
77
+ ): "cancel" | "select" | null {
78
+ if (input === "\u001b" || input === "q" || input === "m") return "cancel";
79
+ if (input === "\r") return choiceCount > 0 ? "select" : null;
80
+ const page = Math.max(1, bodyHeight);
81
+ let next = state.index;
82
+ if (input === "\u001b[A" || input === "k") next--;
83
+ else if (input === "\u001b[B" || input === "j") next++;
84
+ else if (input === "\u001b[5~") next -= page;
85
+ else if (input === "\u001b[6~") next += page;
86
+ else if (input === "\u001b[H") next = 0;
87
+ else if (input === "\u001b[F") next = Math.max(0, choiceCount - 1);
88
+ else return null;
89
+ state.index = Math.max(0, Math.min(Math.max(0, choiceCount - 1), next));
90
+ if (state.index < state.scrollOffset) state.scrollOffset = state.index;
91
+ else if (state.index >= state.scrollOffset + page) state.scrollOffset = state.index - page + 1;
92
+ state.scrollOffset = Math.max(0, Math.min(state.scrollOffset, Math.max(0, choiceCount - page)));
93
+ return null;
94
+ }
95
+
8
96
  export function detailContent(timeline: readonly TimelineEntry[], width: number, expandedIndex: number | null): string[] {
9
97
  const w = Math.max(1, width);
10
98
  return timeline.flatMap((entry, index) => {
@@ -26,15 +114,17 @@ export function renderFleetDetail(row: FleetRow, timeline: readonly TimelineEntr
26
114
  lines.push(...content.slice(offset, offset + body), ...Array(Math.max(0, body - content.slice(offset, offset + body).length)).fill(""));
27
115
  }
28
116
  lines.push(theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"));
29
- lines.push(theme.fg("dim", "↑↓ scroll · PgUp/PgDn page · End tail · Enter expand tool · Ctrl+C copy · Esc dashboard"));
117
+ const modelHint = row.kind === "peer" ? "" : " · m model";
118
+ lines.push(theme.fg("dim", `↑↓ scroll · PgUp/PgDn page · End tail · Enter expand tool · Ctrl+C copy${modelHint} · Esc dashboard`));
30
119
  return lines.slice(0, body + DETAIL_CHROME_ROWS).concat(Array(Math.max(0, body + DETAIL_CHROME_ROWS - lines.length)).fill(""));
31
120
  }
32
121
 
33
122
  /** Pure state transitions used by the harness detail controller. */
34
- export function detailTransition(input: string, state: { scrollOffset: number; selectedIndex: number; expandedIndex: number | null; followTail: boolean }, timeline: readonly TimelineEntry[], bodyHeight: number, contentLength = timeline.length): "close" | "copy" | null {
123
+ export function detailTransition(input: string, state: { scrollOffset: number; selectedIndex: number; expandedIndex: number | null; followTail: boolean }, timeline: readonly TimelineEntry[], bodyHeight: number, contentLength = timeline.length): "close" | "copy" | "model" | null {
35
124
  const max = Math.max(0, contentLength - Math.max(1, bodyHeight));
36
125
  if (input === "\u001b" || input === "q") return "close";
37
126
  if (input === "\u0003") return "copy";
127
+ if (input === "m") return "model";
38
128
  if (input === "\u001b[F") { state.followTail = true; state.scrollOffset = max; return null; }
39
129
  if (input === "\r") { if (timeline[state.selectedIndex]?.kind === "tool") state.expandedIndex = state.expandedIndex === state.selectedIndex ? null : state.selectedIndex; return null; }
40
130
  const delta = input === "\u001b[A" || input === "k" ? -1 : input === "\u001b[B" || input === "j" ? 1 : input === "\u001b[5~" ? -bodyHeight : input === "\u001b[6~" ? bodyHeight : 0;
@@ -12,21 +12,24 @@
12
12
  }
13
13
  },
14
14
  "node_modules/@earendil-works/pi-coding-agent": {
15
- "version": "0.83.0",
16
- "resolved": "https://registry.npmjs.org/@earendil-works/pi-coding-agent/-/pi-coding-agent-0.83.0.tgz",
17
- "integrity": "sha512-uYhF+FsZxogoSX/AxBcUdiY+ZklubwaXyAoEGA2eQwsHcyEAhUYIKh/WLXe/a8+k8eTCmxb+ZN2Zo9mzQtzbWw==",
15
+ "version": "0.84.2",
16
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-coding-agent/-/pi-coding-agent-0.84.2.tgz",
17
+ "integrity": "sha512-l4E+B7hgXKWddRo8bC/eSue2aWZjEgJ9xIpf5p0Og+lq8a2TArCwJ0HCoCPCgaBP/tN4zbYH/wOwvx9pJpeLCA==",
18
18
  "hasShrinkwrap": true,
19
19
  "license": "MIT",
20
20
  "peer": true,
21
21
  "dependencies": {
22
- "@earendil-works/pi-agent-core": "^0.83.0",
23
- "@earendil-works/pi-ai": "^0.83.0",
24
- "@earendil-works/pi-tui": "^0.83.0",
22
+ "@earendil-works/pi-agent-core": "^0.84.2",
23
+ "@earendil-works/pi-ai": "^0.84.2",
24
+ "@earendil-works/pi-client": "^0.84.2",
25
+ "@earendil-works/pi-protocol": "^0.84.2",
26
+ "@earendil-works/pi-tui": "^0.84.2",
25
27
  "@silvia-odwyer/photon-node": "0.3.4",
26
28
  "chalk": "5.6.2",
27
29
  "cross-spawn": "7.0.6",
28
30
  "diff": "8.0.4",
29
31
  "glob": "13.0.6",
32
+ "grok-mermaid": "0.2.2",
30
33
  "highlight.js": "10.7.3",
31
34
  "hosted-git-info": "9.0.3",
32
35
  "ignore": "7.0.5",
@@ -35,7 +38,7 @@
35
38
  "proper-lockfile": "4.1.2",
36
39
  "semver": "7.8.0",
37
40
  "typebox": "1.3.7",
38
- "undici": "8.5.0",
41
+ "undici": "8.9.0",
39
42
  "yaml": "2.9.0"
40
43
  },
41
44
  "bin": {
@@ -511,12 +514,13 @@
511
514
  }
512
515
  },
513
516
  "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-agent-core": {
514
- "version": "0.83.0",
515
- "resolved": "https://registry.npmjs.org/@earendil-works/pi-agent-core/-/pi-agent-core-0.83.0.tgz",
517
+ "version": "0.84.2",
518
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-agent-core/-/pi-agent-core-0.84.2.tgz",
516
519
  "license": "MIT",
517
520
  "peer": true,
518
521
  "dependencies": {
519
- "@earendil-works/pi-ai": "^0.83.0",
522
+ "@earendil-works/pi-ai": "^0.84.2",
523
+ "@earendil-works/pi-telemetry": "^0.84.2",
520
524
  "diff": "8.0.4",
521
525
  "ignore": "7.0.5",
522
526
  "typebox": "1.3.7",
@@ -527,20 +531,20 @@
527
531
  }
528
532
  },
529
533
  "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-ai": {
530
- "version": "0.83.0",
531
- "resolved": "https://registry.npmjs.org/@earendil-works/pi-ai/-/pi-ai-0.83.0.tgz",
534
+ "version": "0.84.2",
535
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-ai/-/pi-ai-0.84.2.tgz",
532
536
  "license": "MIT",
533
537
  "peer": true,
534
538
  "dependencies": {
535
539
  "@anthropic-ai/sdk": "0.91.1",
536
540
  "@aws-sdk/client-bedrock-runtime": "3.1048.0",
541
+ "@earendil-works/pi-telemetry": "^0.84.2",
537
542
  "@google/genai": "1.52.0",
538
- "@mistralai/mistralai": "2.2.6",
539
543
  "@opentelemetry/api": "1.9.0",
540
544
  "@smithy/node-http-handler": "4.7.3",
541
545
  "http-proxy-agent": "7.0.2",
542
546
  "https-proxy-agent": "7.0.6",
543
- "openai": "6.26.0",
547
+ "openai": "6.40.0",
544
548
  "partial-json": "0.1.7",
545
549
  "typebox": "1.3.7"
546
550
  },
@@ -551,9 +555,42 @@
551
555
  "node": ">=22.19.0"
552
556
  }
553
557
  },
558
+ "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-client": {
559
+ "version": "0.84.2",
560
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-client/-/pi-client-0.84.2.tgz",
561
+ "license": "MIT",
562
+ "peer": true,
563
+ "dependencies": {
564
+ "@earendil-works/pi-protocol": "^0.84.2"
565
+ },
566
+ "engines": {
567
+ "node": ">=22.19.0"
568
+ }
569
+ },
570
+ "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-protocol": {
571
+ "version": "0.84.2",
572
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-protocol/-/pi-protocol-0.84.2.tgz",
573
+ "license": "MIT",
574
+ "peer": true,
575
+ "dependencies": {
576
+ "typebox": "1.3.7"
577
+ },
578
+ "engines": {
579
+ "node": ">=22.19.0"
580
+ }
581
+ },
582
+ "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-telemetry": {
583
+ "version": "0.84.2",
584
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-telemetry/-/pi-telemetry-0.84.2.tgz",
585
+ "license": "MIT",
586
+ "peer": true,
587
+ "engines": {
588
+ "node": ">=22.19.0"
589
+ }
590
+ },
554
591
  "node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-tui": {
555
- "version": "0.83.0",
556
- "resolved": "https://registry.npmjs.org/@earendil-works/pi-tui/-/pi-tui-0.83.0.tgz",
592
+ "version": "0.84.2",
593
+ "resolved": "https://registry.npmjs.org/@earendil-works/pi-tui/-/pi-tui-0.84.2.tgz",
557
594
  "license": "MIT",
558
595
  "peer": true,
559
596
  "dependencies": {
@@ -779,27 +816,6 @@
779
816
  "node": ">= 10"
780
817
  }
781
818
  },
782
- "node_modules/@earendil-works/pi-coding-agent/node_modules/@mistralai/mistralai": {
783
- "version": "2.2.6",
784
- "resolved": "https://registry.npmjs.org/@mistralai/mistralai/-/mistralai-2.2.6.tgz",
785
- "integrity": "sha512-W8pX7zHxjJvMIpw8JMxeJEleapXX0Q9NPszdNzqkM3MIEoIGPObdodujj+WHteXEvGfaP/AMwlNyRfEzSY6dQQ==",
786
- "license": "Apache-2.0",
787
- "peer": true,
788
- "dependencies": {
789
- "@opentelemetry/semantic-conventions": "^1.40.0",
790
- "ws": "^8.18.0",
791
- "zod": "^3.25.0 || ^4.0.0",
792
- "zod-to-json-schema": "^3.25.0"
793
- },
794
- "peerDependencies": {
795
- "@opentelemetry/api": "^1.9.0"
796
- },
797
- "peerDependenciesMeta": {
798
- "@opentelemetry/api": {
799
- "optional": true
800
- }
801
- }
802
- },
803
819
  "node_modules/@earendil-works/pi-coding-agent/node_modules/@nodable/entities": {
804
820
  "version": "2.1.0",
805
821
  "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-2.1.0.tgz",
@@ -823,16 +839,6 @@
823
839
  "node": ">=8.0.0"
824
840
  }
825
841
  },
826
- "node_modules/@earendil-works/pi-coding-agent/node_modules/@opentelemetry/semantic-conventions": {
827
- "version": "1.41.1",
828
- "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.41.1.tgz",
829
- "integrity": "sha512-/UhIkaZgPutTFmQ7RnIJGgDXZmtEJ7Dvi86xNTFWcnRxVRNk/aotsqDJYeEvDP+FSMB2SdW+pQzNMcWP0rwuNA==",
830
- "license": "Apache-2.0",
831
- "peer": true,
832
- "engines": {
833
- "node": ">=14"
834
- }
835
- },
836
842
  "node_modules/@earendil-works/pi-coding-agent/node_modules/@protobufjs/aspromise": {
837
843
  "version": "1.1.2",
838
844
  "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz",
@@ -1104,16 +1110,16 @@
1104
1110
  "peer": true
1105
1111
  },
1106
1112
  "node_modules/@earendil-works/pi-coding-agent/node_modules/brace-expansion": {
1107
- "version": "5.0.7",
1108
- "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz",
1109
- "integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==",
1113
+ "version": "5.0.9",
1114
+ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
1115
+ "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
1110
1116
  "license": "MIT",
1111
1117
  "peer": true,
1112
1118
  "dependencies": {
1113
1119
  "balanced-match": "^4.0.2"
1114
1120
  },
1115
1121
  "engines": {
1116
- "node": "18 || 20 || >=22"
1122
+ "node": "20 || >=22"
1117
1123
  }
1118
1124
  },
1119
1125
  "node_modules/@earendil-works/pi-coding-agent/node_modules/buffer-equal-constant-time": {
@@ -1378,6 +1384,16 @@
1378
1384
  "license": "ISC",
1379
1385
  "peer": true
1380
1386
  },
1387
+ "node_modules/@earendil-works/pi-coding-agent/node_modules/grok-mermaid": {
1388
+ "version": "0.2.2",
1389
+ "resolved": "https://registry.npmjs.org/grok-mermaid/-/grok-mermaid-0.2.2.tgz",
1390
+ "integrity": "sha512-XcJEP5dDC8liHBh52mlLjU18fNvu1ckFsu0QpIG3+APZ270fsj9wxpiA6cOURmbUEuoMVgjbC2+UYgTdCqqgzA==",
1391
+ "license": "Apache-2.0",
1392
+ "peer": true,
1393
+ "engines": {
1394
+ "node": ">=18"
1395
+ }
1396
+ },
1381
1397
  "node_modules/@earendil-works/pi-coding-agent/node_modules/highlight.js": {
1382
1398
  "version": "10.7.3",
1383
1399
  "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.3.tgz",
@@ -1607,14 +1623,11 @@
1607
1623
  }
1608
1624
  },
1609
1625
  "node_modules/@earendil-works/pi-coding-agent/node_modules/openai": {
1610
- "version": "6.26.0",
1611
- "resolved": "https://registry.npmjs.org/openai/-/openai-6.26.0.tgz",
1612
- "integrity": "sha512-zd23dbWTjiJ6sSAX6s0HrCZi41JwTA1bQVs0wLQPZ2/5o2gxOJA5wh7yOAUgwYybfhDXyhwlpeQf7Mlgx8EOCA==",
1626
+ "version": "6.40.0",
1627
+ "resolved": "https://registry.npmjs.org/openai/-/openai-6.40.0.tgz",
1628
+ "integrity": "sha512-MWtTjd/gQt4jpbji61NTgFWJLoY/PdRJ6wG9/ZDRMYNMlBKrCrSlkLI+KgHP1vR1qT6LKSAyAqIxno6lcK9JiA==",
1613
1629
  "license": "Apache-2.0",
1614
1630
  "peer": true,
1615
- "bin": {
1616
- "openai": "bin/cli"
1617
- },
1618
1631
  "peerDependencies": {
1619
1632
  "ws": "^8.18.0",
1620
1633
  "zod": "^3.25 || ^4.0"
@@ -1854,9 +1867,9 @@
1854
1867
  "peer": true
1855
1868
  },
1856
1869
  "node_modules/@earendil-works/pi-coding-agent/node_modules/undici": {
1857
- "version": "8.5.0",
1858
- "resolved": "https://registry.npmjs.org/undici/-/undici-8.5.0.tgz",
1859
- "integrity": "sha512-xamtWoB1EshgjpmlXd7GGm2VfdDtw1+rD8uhry8pSNW3If6S8E0m2T2+orSKeZXEn/aPJMviCpDBA65WJt8zhg==",
1870
+ "version": "8.9.0",
1871
+ "resolved": "https://registry.npmjs.org/undici/-/undici-8.9.0.tgz",
1872
+ "integrity": "sha512-aWZpUj7XoGonMClx4gdDRfgBjqeA+F473aDmROQQbM9n6PRfK/u1q/a0X4wMTgcHfT8H6fpbt98PFuDUwFg2YA==",
1860
1873
  "license": "MIT",
1861
1874
  "peer": true,
1862
1875
  "engines": {
@@ -1950,26 +1963,6 @@
1950
1963
  "url": "https://github.com/sponsors/eemeli"
1951
1964
  }
1952
1965
  },
1953
- "node_modules/@earendil-works/pi-coding-agent/node_modules/zod": {
1954
- "version": "3.25.76",
1955
- "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
1956
- "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
1957
- "license": "MIT",
1958
- "peer": true,
1959
- "funding": {
1960
- "url": "https://github.com/sponsors/colinhacks"
1961
- }
1962
- },
1963
- "node_modules/@earendil-works/pi-coding-agent/node_modules/zod-to-json-schema": {
1964
- "version": "3.25.2",
1965
- "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.2.tgz",
1966
- "integrity": "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA==",
1967
- "license": "ISC",
1968
- "peer": true,
1969
- "peerDependencies": {
1970
- "zod": "^3.25.28 || ^4"
1971
- }
1972
- },
1973
1966
  "node_modules/@earendil-works/pi-tui": {
1974
1967
  "version": "0.83.0",
1975
1968
  "resolved": "https://registry.npmjs.org/@earendil-works/pi-tui/-/pi-tui-0.83.0.tgz",
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native