@chankov/agent-fleet 1.0.0 → 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 (598) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/extensions/package-lock.json +77 -45
  3. package/.pi/harnesses/agent-hub/README.md +116 -16
  4. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  5. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  6. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  7. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  8. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  9. package/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  10. package/.pi/harnesses/agent-hub/index.ts +1095 -465
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  13. package/.pi/harnesses/agent-hub/run-budget.js +73 -13
  14. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  15. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  18. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  19. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  20. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  21. package/.pi/harnesses/lib/context-budget.ts +114 -0
  22. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
  23. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  24. package/.pi/harnesses/package-lock.json +73 -80
  25. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  26. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  27. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  28. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  29. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  30. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  31. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  32. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  33. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  34. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  35. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  36. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  37. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  38. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  39. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  40. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  41. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  42. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  43. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  44. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  45. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  46. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  47. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  48. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  49. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  50. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  51. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  52. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  53. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  54. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  55. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  56. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  57. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  58. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  59. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  60. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  61. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  62. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  63. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  64. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  66. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  67. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  68. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  69. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  70. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  71. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  72. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  73. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  74. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  75. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  76. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  77. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  78. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  79. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  80. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  81. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  82. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  83. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  84. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  85. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  86. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  87. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  88. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  89. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  90. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  91. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  92. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  93. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  94. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  95. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  96. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  97. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  98. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  99. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  100. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  101. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  102. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  103. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  104. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  105. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  106. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  108. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  109. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  110. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  111. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  112. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  113. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  114. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  115. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  116. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  117. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  118. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  119. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  120. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  121. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  122. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  123. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  124. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  125. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  126. package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
  127. package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
  128. package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
  129. package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  130. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  131. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  132. package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
  133. package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
  134. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  135. package/.versions/1.0.1/.version +1 -0
  136. package/.versions/1.0.1/agents/architect.md +24 -0
  137. package/.versions/1.0.1/agents/bowser.md +27 -0
  138. package/.versions/1.0.1/agents/builder.md +54 -0
  139. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  140. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  141. package/.versions/1.0.1/agents/documenter.md +18 -0
  142. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  143. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  144. package/.versions/1.0.1/agents/planner.md +70 -0
  145. package/.versions/1.0.1/agents/releaser.md +24 -0
  146. package/.versions/1.0.1/agents/researcher.md +28 -0
  147. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  148. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  149. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  150. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  151. package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  152. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  153. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  154. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  155. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  156. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  157. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  158. package/.versions/1.0.1/docs/getting-started.md +98 -0
  159. package/.versions/1.0.1/docs/npm-install.md +292 -0
  160. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  161. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  162. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  163. package/.versions/1.0.1/hermes/README.md +347 -0
  164. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  165. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  166. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  167. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  168. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  169. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  170. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  171. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  172. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  173. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  174. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  175. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  176. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  177. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  178. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  179. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  180. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  181. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  182. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  183. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  184. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  185. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  186. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  187. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  188. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  189. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  190. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  191. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  192. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  193. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  194. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  195. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  196. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  197. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  198. package/.versions/1.0.1/install-manifest.json +2745 -0
  199. package/.versions/1.0.1/justfile +272 -0
  200. package/.versions/1.0.1/manifest-meta.json +882 -0
  201. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  202. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  203. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  204. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  205. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  206. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  207. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  208. package/.versions/1.0.1/references/security-checklist.md +179 -0
  209. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  210. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  211. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  212. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  213. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  214. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  215. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  216. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  217. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  218. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  219. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  220. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  221. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  222. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  223. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  224. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  225. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  226. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  227. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  228. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  229. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  230. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  231. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  232. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  233. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  234. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  235. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  236. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  237. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  238. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  239. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  240. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  241. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  242. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  243. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  244. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  245. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  246. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  247. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  248. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  249. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  250. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  251. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  252. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  253. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  254. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  255. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  256. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  257. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  258. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  259. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  260. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  261. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  262. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  263. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  264. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  265. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  266. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  267. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  268. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  269. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  270. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  271. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  272. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  273. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  274. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  275. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  276. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  277. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  278. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  279. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  280. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  281. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  282. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  283. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  284. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  285. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  286. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  287. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  288. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  289. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  290. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  291. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  292. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  293. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  294. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  295. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  296. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  297. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  298. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  299. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  300. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  301. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  302. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  303. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  304. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  305. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  306. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  307. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  308. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  309. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  310. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  311. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  312. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  313. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  314. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  315. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  316. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  317. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  318. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  319. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  320. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  321. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  322. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  323. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  324. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  325. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  326. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  327. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  328. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  329. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  330. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  331. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  332. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  333. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  334. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  335. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  336. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  337. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  338. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  339. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  340. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  341. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  342. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  343. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  344. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  345. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  346. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  347. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  348. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  349. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  350. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  351. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  352. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  353. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  354. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  355. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  356. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  357. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  358. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  359. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  360. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  361. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  362. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  363. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  364. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  365. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  366. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  367. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  368. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  369. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  370. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  371. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  372. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  373. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  374. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  375. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  376. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  377. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  378. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  379. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  380. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  381. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  382. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  383. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  384. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  385. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  386. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  387. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  388. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  389. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  390. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  391. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  392. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  393. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  394. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  395. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  396. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  397. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  398. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  399. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  400. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  401. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  402. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  403. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  404. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  405. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  406. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  407. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  408. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  409. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  410. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  411. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  412. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  413. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  414. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  415. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  416. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  417. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  418. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  419. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  420. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  421. package/.versions/1.0.2/.version +1 -0
  422. package/.versions/1.0.2/agents/architect.md +24 -0
  423. package/.versions/1.0.2/agents/bowser.md +27 -0
  424. package/.versions/1.0.2/agents/builder.md +54 -0
  425. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  426. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  427. package/.versions/1.0.2/agents/documenter.md +18 -0
  428. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  429. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  430. package/.versions/1.0.2/agents/planner.md +70 -0
  431. package/.versions/1.0.2/agents/releaser.md +24 -0
  432. package/.versions/1.0.2/agents/researcher.md +28 -0
  433. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  434. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  435. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  436. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  437. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  438. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  439. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  440. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  441. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  442. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  443. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  444. package/.versions/1.0.2/docs/getting-started.md +98 -0
  445. package/.versions/1.0.2/docs/npm-install.md +292 -0
  446. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  447. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  448. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  449. package/.versions/1.0.2/hermes/README.md +347 -0
  450. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  451. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  452. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  453. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  454. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  455. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  456. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  457. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  458. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  459. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  460. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  461. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  462. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  463. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  464. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  465. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  466. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  467. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  468. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  469. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  470. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  471. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  472. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  473. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  474. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  475. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  476. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  477. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  478. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  479. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  480. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  481. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  482. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  483. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  484. package/.versions/1.0.2/install-manifest.json +2745 -0
  485. package/.versions/1.0.2/justfile +272 -0
  486. package/.versions/1.0.2/manifest-meta.json +882 -0
  487. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  488. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  489. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  490. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  491. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  492. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  493. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  494. package/.versions/1.0.2/references/security-checklist.md +179 -0
  495. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  496. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  497. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  498. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  499. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  500. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  501. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  502. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  503. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  504. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  505. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  506. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  507. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  508. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  509. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  510. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  511. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  512. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  513. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  514. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  515. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  516. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  517. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  518. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  519. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  520. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  521. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  522. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  523. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  524. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  525. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  526. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  527. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  528. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  529. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  530. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  531. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  532. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  533. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  534. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  535. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  536. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  537. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  538. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  539. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  540. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  541. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  542. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  543. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  544. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  545. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  546. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  547. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  548. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  549. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  550. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  551. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  552. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  553. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  554. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  555. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  556. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  557. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  558. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  559. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  560. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  561. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  562. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  563. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  564. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  565. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  566. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  567. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  568. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  569. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  570. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  571. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  572. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  573. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  574. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  575. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  576. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  577. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  578. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  579. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  580. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  581. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  582. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  583. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  584. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  585. package/CHANGELOG.md +15 -0
  586. package/README.md +4 -2
  587. package/agents/code-reviewer.md +1 -1
  588. package/agents/deep-researcher.md +1 -1
  589. package/agents/orchestrator.md +4 -56
  590. package/agents/plan-reviewer.md +1 -1
  591. package/agents/planner.md +1 -1
  592. package/agents/security-auditor.md +1 -1
  593. package/agents/test-engineer.md +1 -1
  594. package/docs/ARCHITECTURE.md +48 -16
  595. package/docs/agent-fleet-setup.md +33 -2
  596. package/docs/pi-extensions.md +29 -2
  597. package/install-manifest.json +2 -2
  598. package/package.json +2 -2
@@ -0,0 +1,197 @@
1
+ /**
2
+ * Shared exemption + escalation plumbing for damage-control-continue and agent-hub.
3
+ *
4
+ * Exemptions are runtime, session-scoped allowances layered on top of
5
+ * `.pi/damage-control-rules.yaml` — they never edit the rules file and only
6
+ * ever apply to the path categories (zeroAccessPaths / readOnlyPaths /
7
+ * noDeletePaths), never to the destructive bashToolPatterns.
8
+ *
9
+ * Consumers:
10
+ * - damage-control-continue — /allow commands, block-time prompts, and
11
+ * escalation to the agent-hub dispatcher from headless children
12
+ * - agent-hub — computes the shared file path, passes the env plumbing to
13
+ * spawned children, and answers access_request envelopes on its coms socket
14
+ */
15
+
16
+ import * as fs from "fs";
17
+ import * as net from "net";
18
+ import * as os from "os";
19
+ import * as path from "path";
20
+
21
+ // Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
22
+ // process.env, so delegate grandchildren inherit these for free.
23
+ export const ASK_ENDPOINT_ENV = "AGENT_HUB_ASK_ENDPOINT";
24
+ export const EXEMPTIONS_FILE_ENV = "AGENT_HUB_EXEMPTIONS_FILE";
25
+ export const AGENT_ID_ENV = "AGENT_HUB_AGENT_ID";
26
+
27
+ export type ExemptionScope = "turn" | "session";
28
+ export type PathRuleCategory = "zero_access" | "read_only" | "no_delete";
29
+
30
+ export interface Exemption {
31
+ /** The protected pattern being unlocked — same syntax as the rules file entries. */
32
+ pattern: string;
33
+ scope: ExemptionScope;
34
+ /** When set, the exemption applies only to the spawned agent with this id. */
35
+ agent?: string;
36
+ grantedVia: "command" | "prompt" | "escalation";
37
+ grantedAt: string;
38
+ }
39
+
40
+ // ── shared exemptions file (one per hub session, read by spawned children) ──
41
+
42
+ export function exemptionsFilePath(sessionId: string): string {
43
+ const comsDir = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
44
+ return path.join(comsDir, "exemptions", `${sessionId}.json`);
45
+ }
46
+
47
+ export function readExemptionsFile(filePath: string | undefined): Exemption[] {
48
+ if (!filePath) return [];
49
+ try {
50
+ const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
51
+ if (!Array.isArray(parsed)) return [];
52
+ return parsed.filter((e): e is Exemption => !!e && typeof e.pattern === "string" && e.pattern.length > 0);
53
+ } catch {
54
+ return [];
55
+ }
56
+ }
57
+
58
+ /** Exemptions visible to one process: agent-agnostic entries plus those granted to `agentId`. */
59
+ export function fileExemptionsFor(filePath: string | undefined, agentId: string | undefined): Exemption[] {
60
+ return readExemptionsFile(filePath).filter((e) => !e.agent || e.agent === agentId);
61
+ }
62
+
63
+ export function appendExemptionToFile(filePath: string, exemption: Exemption): void {
64
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
65
+ const existing = readExemptionsFile(filePath);
66
+ const dup = existing.some((e) => e.pattern === exemption.pattern && (e.agent ?? "") === (exemption.agent ?? ""));
67
+ if (!dup) existing.push(exemption);
68
+ const tmp = `${filePath}.tmp`;
69
+ fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
70
+ fs.renameSync(tmp, filePath);
71
+ }
72
+
73
+ /** Remove every entry for `pattern` (any agent). Returns true when something was removed. */
74
+ export function removeExemptionFromFile(filePath: string | undefined, pattern: string): boolean {
75
+ if (!filePath) return false;
76
+ const existing = readExemptionsFile(filePath);
77
+ const next = existing.filter((e) => e.pattern !== pattern);
78
+ if (next.length === existing.length) return false;
79
+ try {
80
+ const tmp = `${filePath}.tmp`;
81
+ fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
82
+ fs.renameSync(tmp, filePath);
83
+ return true;
84
+ } catch {
85
+ return false;
86
+ }
87
+ }
88
+
89
+ // ── escalation protocol (headless child → hub dispatcher) ──
90
+
91
+ /**
92
+ * Sent by a child's damage-control-continue to the hub's coms socket. Carries
93
+ * the Envelope base fields (sender_session = agent id, sender_endpoint = "")
94
+ * so the hub's isValidEnvelope accepts it.
95
+ */
96
+ export interface AccessRequest {
97
+ type: "access_request";
98
+ msg_id: string;
99
+ sender_session: string;
100
+ sender_endpoint: string;
101
+ hops: number;
102
+ timestamp: string;
103
+ agent: string;
104
+ tool: string;
105
+ rule: string;
106
+ pattern: string;
107
+ category: PathRuleCategory;
108
+ invocation: string;
109
+ }
110
+
111
+ export type AccessDecisionChoice = "deny" | "allow_once" | "allow_agent" | "allow_all";
112
+
113
+ /** Protected deletions are approved per invocation; broader grants stay operator-explicit. */
114
+ export function accessDecisionChoices(category: PathRuleCategory): AccessDecisionChoice[] {
115
+ return category === "no_delete"
116
+ ? ["deny", "allow_once"]
117
+ : ["deny", "allow_once", "allow_agent", "allow_all"];
118
+ }
119
+
120
+ /** Coalesce identical asks without letting one delete approval cover sibling paths. */
121
+ export function accessRequestCacheKey(
122
+ request: Pick<AccessRequest, "agent" | "pattern" | "category" | "invocation">,
123
+ ): string {
124
+ const base = `${request.agent}::${request.pattern}`;
125
+ return request.category === "no_delete" ? `${base}::${request.invocation}` : base;
126
+ }
127
+
128
+ export interface AccessDecision {
129
+ type: "access_decision";
130
+ msg_id: string;
131
+ decision: AccessDecisionChoice;
132
+ }
133
+
134
+ export const ESCALATION_TIMEOUT_MS = Number(process.env.AGENT_HUB_ASK_TIMEOUT_MS) || 60_000;
135
+
136
+ /**
137
+ * Ask the hub to approve a blocked call. Synchronous over a single connection:
138
+ * the child has no socket server of its own, so the hub keeps this socket open
139
+ * and writes the decision line whenever the user answers. Resolves "timeout" /
140
+ * "error" instead of rejecting — callers always fail closed.
141
+ */
142
+ export function requestAccessFromHub(
143
+ endpoint: string,
144
+ request: AccessRequest,
145
+ timeoutMs: number = ESCALATION_TIMEOUT_MS,
146
+ ): Promise<AccessDecisionChoice | "timeout" | "error"> {
147
+ return new Promise((resolve) => {
148
+ let settled = false;
149
+ let timer: ReturnType<typeof setTimeout> | undefined;
150
+ let sock: net.Socket;
151
+ const settle = (v: AccessDecisionChoice | "timeout" | "error") => {
152
+ if (settled) return;
153
+ settled = true;
154
+ if (timer) clearTimeout(timer);
155
+ try { sock.destroy(); } catch { /* ignore */ }
156
+ resolve(v);
157
+ };
158
+ try {
159
+ sock = net.createConnection({ path: endpoint });
160
+ } catch {
161
+ resolve("error");
162
+ return;
163
+ }
164
+ timer = setTimeout(() => settle("timeout"), timeoutMs);
165
+ let buf = "";
166
+ sock.on("connect", () => {
167
+ try {
168
+ sock.write(JSON.stringify(request) + "\n");
169
+ } catch {
170
+ settle("error");
171
+ }
172
+ });
173
+ sock.on("data", (chunk: Buffer) => {
174
+ buf += chunk.toString("utf-8");
175
+ const nl = buf.indexOf("\n");
176
+ if (nl < 0) return;
177
+ try {
178
+ const parsed = JSON.parse(buf.slice(0, nl));
179
+ if (
180
+ parsed &&
181
+ parsed.type === "access_decision" &&
182
+ (parsed.decision === "deny" || parsed.decision === "allow_once" ||
183
+ parsed.decision === "allow_agent" || parsed.decision === "allow_all")
184
+ ) {
185
+ settle(parsed.decision);
186
+ } else {
187
+ // nack or unknown reply (e.g. an older hub without escalation support)
188
+ settle("error");
189
+ }
190
+ } catch {
191
+ settle("error");
192
+ }
193
+ });
194
+ sock.on("error", () => settle("error"));
195
+ sock.on("close", () => settle("error"));
196
+ });
197
+ }
@@ -0,0 +1,155 @@
1
+ /**
2
+ * Pure decision helpers for Fleet Dashboard destructive actions and live views.
3
+ * Kept free of pi imports so black-box tests can exercise operator outcomes
4
+ * without booting the full agent-hub extension.
5
+ */
6
+ import type { FleetKind } from "./fleet-read-model.ts";
7
+ import type { createPanelResources } from "./fleet-panel.ts";
8
+
9
+ export type KillHandles = {
10
+ proc?: unknown;
11
+ comsAbort?: (() => void) | null;
12
+ };
13
+
14
+ export type KillOutcome =
15
+ | { action: "kill-research"; message: string }
16
+ | { action: "kill-proc"; message: string }
17
+ | { action: "coms-abort"; message: string }
18
+ | { action: "unsupported"; level: "warning"; message: string };
19
+
20
+ export type RestartOutcome =
21
+ | { action: "restart-research"; message: string }
22
+ | { action: "restart-specialist"; message: string }
23
+ | { action: "unsupported"; level: "warning"; message: string };
24
+
25
+ /** Resolve a confirmed `x` kill for the highlighted row kind. */
26
+ export function resolveFleetKill(
27
+ selected: { key: string; kind: FleetKind; name: string; status: "idle" | "running" | "done" | "error" | "pending" | "stale" },
28
+ lookup: {
29
+ researchExists: (key: string) => boolean;
30
+ agentHandles: (key: string) => KillHandles | undefined;
31
+ },
32
+ ): KillOutcome {
33
+ if (selected.kind === "research") {
34
+ if (!lookup.researchExists(selected.key)) {
35
+ return { action: "unsupported", level: "warning", message: `Research ${selected.name} is no longer available.` };
36
+ }
37
+ return { action: "kill-research", message: `Killed research ${selected.name}.` };
38
+ }
39
+ const agent = lookup.agentHandles(selected.key);
40
+ if (agent?.proc) {
41
+ return { action: "kill-proc", message: `Killing ${selected.name}...` };
42
+ }
43
+ if (agent?.comsAbort) {
44
+ return { action: "coms-abort", message: `Abandoning ${selected.name}'s coms dispatch (the peer pane keeps running)...` };
45
+ }
46
+ if (selected.kind === "specialist" && selected.status !== "running") {
47
+ return {
48
+ action: "unsupported",
49
+ level: "warning",
50
+ message: `${selected.name} is ${selected.status === "done" ? "already finished" : `not running (${selected.status})`}; no live process or abort handle is available.`,
51
+ };
52
+ }
53
+ return {
54
+ action: "unsupported",
55
+ level: "warning",
56
+ message: `Kill is unsupported for ${selected.kind} rows; no owned process or abort handle is available.`,
57
+ };
58
+ }
59
+
60
+ /** Resolve a confirmed `r` restart for the highlighted row kind. */
61
+ export function resolveFleetRestart(
62
+ selected: { key: string; kind: FleetKind; name: string },
63
+ lookup: {
64
+ researchRestartable: (key: string) => boolean;
65
+ specialistRestartable: (key: string) => boolean;
66
+ },
67
+ ): RestartOutcome {
68
+ if (selected.kind === "peer" || selected.kind === "delegate") {
69
+ return {
70
+ action: "unsupported",
71
+ level: "warning",
72
+ message: `Restart is unsupported for ${selected.kind} rows; restart it from its owning session.`,
73
+ };
74
+ }
75
+ if (selected.kind === "research") {
76
+ if (!lookup.researchRestartable(selected.key)) {
77
+ return {
78
+ action: "unsupported",
79
+ level: "warning",
80
+ message: `Research ${selected.name} cannot be restarted while running or without a previous task.`,
81
+ };
82
+ }
83
+ return { action: "restart-research", message: `Restarting research ${selected.name} (fresh)...` };
84
+ }
85
+ if (!lookup.specialistRestartable(selected.key)) {
86
+ return {
87
+ action: "unsupported",
88
+ level: "warning",
89
+ message: `${selected.name} has no previous task to restart.`,
90
+ };
91
+ }
92
+ return { action: "restart-specialist", message: `Restarting ${selected.name} (fresh)...` };
93
+ }
94
+
95
+ /**
96
+ * Always read the live timeline array from the target. Capturing the array at
97
+ * open time freezes the detail view across re-dispatch (`state.timeline = []`).
98
+ */
99
+ export function liveTimeline<T>(target: { timeline?: readonly T[] } | null | undefined): readonly T[] {
100
+ return target?.timeline ?? [];
101
+ }
102
+
103
+ /** A zero-member operator roster still needs a valid column for research cards. */
104
+ export function gridColumnsForSize(size: number): number {
105
+ if (size <= 0) return 1;
106
+ return size <= 3 ? size : size === 4 ? 2 : 3;
107
+ }
108
+
109
+ /** Defensive render bound: a non-empty card list can never be split by zero. */
110
+ export function gridColumnsForItems(columns: number, itemCount: number): number {
111
+ const safeColumns = Number.isFinite(columns) ? Math.max(1, Math.floor(columns)) : 1;
112
+ const safeItems = Number.isFinite(itemCount) ? Math.max(1, Math.floor(itemCount)) : 1;
113
+ return Math.min(safeColumns, safeItems);
114
+ }
115
+
116
+ /** Render card lines in a grid without ever indexing an empty first column. */
117
+ export function renderCardGrid<T>(
118
+ items: readonly T[],
119
+ columns: number,
120
+ cardHeight: number,
121
+ renderCard: (item: T) => string[],
122
+ gap = " ",
123
+ blankLine = "",
124
+ ): string[] {
125
+ if (items.length === 0) return [];
126
+ const cols = gridColumnsForItems(columns, items.length);
127
+ const height = Number.isFinite(cardHeight) ? Math.max(0, Math.floor(cardHeight)) : 0;
128
+ const lines: string[] = [];
129
+ for (let i = 0; i < items.length; i += cols) {
130
+ const cards = items.slice(i, i + cols).map(renderCard);
131
+ while (cards.length < cols) cards.push(Array(height).fill(blankLine));
132
+ const rowHeight = cards[0]?.length ?? height;
133
+ for (let line = 0; line < rowHeight; line++) {
134
+ lines.push(cards.map(card => card[line] || "").join(gap));
135
+ }
136
+ }
137
+ return lines;
138
+ }
139
+
140
+ /** Compact below-editor / research-card widgets render only in compact mode. */
141
+ export function compactWidgetsEnabled(viewMode: "compact" | "off"): boolean {
142
+ return viewMode === "compact";
143
+ }
144
+
145
+ type PanelResources = ReturnType<typeof createPanelResources>;
146
+
147
+ /** Register the 1s elapsed/status ticker and return a disposer that tears it down. */
148
+ export function attachFleetDashboardTicker(
149
+ resources: PanelResources,
150
+ requestRender: () => void,
151
+ intervalMs = 1000,
152
+ ): () => void {
153
+ resources.every(intervalMs, requestRender);
154
+ return () => resources.dispose();
155
+ }
@@ -0,0 +1,140 @@
1
+ import type { FleetRow } from "./fleet-read-model.ts";
2
+ import { moveSelection, type Selection } from "./fleet-selection.ts";
3
+
4
+ export interface ThemeLike { fg(color: string, text: string): string; bold(text: string): string; bg?(color: string, text: string): string; }
5
+ export const FLEET_CHROME_ROWS = 4;
6
+ export interface FleetViewModel {
7
+ rows: readonly FleetRow[];
8
+ selection: Selection;
9
+ summary: { running: number; done: number; failed: number; totalTokens: number; intervals: Array<[number, number]>; wallMs: number };
10
+ filterQuery?: string;
11
+ showFinished: boolean;
12
+ scrollOffset?: number;
13
+ confirmation?: string;
14
+ }
15
+
16
+ const ANSI = /\x1b\[[0-?]*[ -/]*[@-~]/g;
17
+ const visibleWidth = (text: string) => Array.from(text.replace(ANSI, "")).length;
18
+ /** Truncate terminal-styled text without cutting an ANSI sequence; close SGR styling when clipped. */
19
+ const ellipsis = (text: string, width: number) => {
20
+ if (visibleWidth(text) <= width) return text;
21
+ if (width <= 0) return "";
22
+ let out = "", visible = 0, i = 0, styled = false;
23
+ const limit = Math.max(0, width - 1);
24
+ while (i < text.length && visible < limit) {
25
+ if (text[i] === "\x1b") {
26
+ const match = text.slice(i).match(/^\x1b\[[0-?]*[ -/]*[@-~]/);
27
+ if (match) { out += match[0]; styled = match[0] !== "\x1b[0m"; i += match[0].length; continue; }
28
+ }
29
+ const char = String.fromCodePoint(text.codePointAt(i)!);
30
+ out += char; visible++; i += char.length;
31
+ }
32
+ return `${out}${width > 1 ? "…" : ""}${styled ? "\x1b[0m" : ""}`;
33
+ };
34
+ const duration = (ms: number) => ms < 60_000 ? `${Math.round(ms / 1000)}s` : `${Math.floor(ms / 60_000)}:${String(Math.round(ms / 1000) % 60).padStart(2, "0")}`;
35
+ const tokens = (n: number | null) => n == null ? "—" : n >= 1000 ? `${Math.round(n / 1000)}k` : String(n);
36
+ const glyph = (row: FleetRow) => row.status === "running" ? "●" : row.status === "done" ? "✓" : row.status === "error" ? "✗" : row.status === "pending" ? "◌" : row.status === "stale" ? "○" : "▪";
37
+ const context = (pct: number | null) => pct == null ? "[automatic] —" : `[${"#".repeat(Math.max(0, Math.min(10, Math.round(pct / 10))))}${"·".repeat(Math.max(0, 10 - Math.round(pct / 10)))}] ${Math.round(pct)}%`;
38
+
39
+ /** Render a constant-height, width-bounded fleet list without pi runtime dependencies. */
40
+ export function renderFleetDashboard(vm: FleetViewModel, width: number, bodyHeight: number, theme: ThemeLike): string[] {
41
+ const w = Math.max(1, width), body = Math.max(0, bodyHeight);
42
+ const summary = `${vm.summary.running} running · ${vm.summary.done} done${vm.summary.failed ? ` · ${vm.summary.failed} failed` : ""} · ${duration(vm.summary.wallMs)} · ${tokens(vm.summary.totalTokens)} tok`;
43
+ const header = ellipsis(` Fleet ${vm.filterQuery ? `· filter: ${vm.filterQuery}` : ""}`, Math.max(1, w - summary.length - 1));
44
+ const lines: string[] = [ellipsis(theme.bold(header) + " " + theme.fg("dim", summary), w), theme.fg("dim", "╭" + "─".repeat(Math.max(0, w - 2)) + "╮")];
45
+ if (vm.rows.length === 0) {
46
+ const message = "no agents dispatched yet";
47
+ lines.push(...Array.from({ length: body }, (_, i) => i === Math.floor(body / 2) ? ellipsis(theme.fg("dim", message.padStart(Math.floor((w + message.length) / 2))), w) : ""));
48
+ } else {
49
+ const offset = Math.max(0, Math.min(vm.scrollOffset ?? 0, Math.max(0, vm.rows.length - body)));
50
+ for (let i = 0; i < body; i++) {
51
+ const row = vm.rows[offset + i];
52
+ if (!row) { lines.push(""); continue; }
53
+ const selected = offset + i === vm.selection.index;
54
+ const indent = row.depth ? " " + "└ ".repeat(row.depth) : " ";
55
+ const name = `${selected ? "❯" : " "} ${glyph(row)} ${indent}${row.name}`;
56
+ const parts = [name, row.kind, row.model, context(row.contextPct), tokens(row.contextTokens), duration(row.elapsed), row.toolCount == null ? "—" : String(row.toolCount), row.lastWork];
57
+ const count = w < 80 ? 4 : w < 105 ? 6 : 8;
58
+ const line = ellipsis(parts.slice(0, count).join(" "), w);
59
+ lines.push(selected && theme.bg ? theme.bg("selectedBg", line.padEnd(w)) : line);
60
+ }
61
+ }
62
+ lines.push(theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"));
63
+ lines.push(ellipsis(theme.fg("dim", vm.confirmation ?? "↑↓ select · Enter open · x kill · r restart · c continue · f filter · a all · q close"), w));
64
+ return lines.slice(0, body + FLEET_CHROME_ROWS).concat(Array(Math.max(0, body + FLEET_CHROME_ROWS - lines.length)).fill(""));
65
+ }
66
+
67
+ export type DashboardConfirm = { action: "kill" | "restart"; key: string; until: number } | null;
68
+ export interface DashboardControllerState {
69
+ selection: Selection;
70
+ scrollOffset: number;
71
+ filtering: boolean;
72
+ filterQuery: string;
73
+ showFinished: boolean;
74
+ confirm: DashboardConfirm;
75
+ }
76
+ export type DashboardIntent =
77
+ | null
78
+ | "close"
79
+ | { open: string }
80
+ | { kill: string }
81
+ | { restart: string };
82
+
83
+ /** Pure keyboard transitions for the fleet list controller (mirrors detailTransition). */
84
+ export function dashboardTransition(
85
+ input: string,
86
+ state: DashboardControllerState,
87
+ rows: readonly { key: string }[],
88
+ bodyHeight: number,
89
+ now = Date.now(),
90
+ ): DashboardIntent {
91
+ if (state.filtering) {
92
+ if (input === "\u001b") {
93
+ state.filterQuery = "";
94
+ state.filtering = false;
95
+ } else if (input === "\r") {
96
+ state.filtering = false;
97
+ } else if (input === "\u007f" || input === "\b") {
98
+ state.filterQuery = Array.from(state.filterQuery).slice(0, -1).join("");
99
+ } else if (input.length === 1) {
100
+ state.filterQuery += input;
101
+ }
102
+ return null;
103
+ }
104
+ const selected = rows[state.selection.index];
105
+ if (input === "\u001b[A" || input === "k" || input === "\u001b[B" || input === "j") {
106
+ moveSelection(state.selection, rows, input === "\u001b[A" || input === "k" ? -1 : 1);
107
+ const viewport = Math.max(1, bodyHeight);
108
+ if (state.selection.index < state.scrollOffset) state.scrollOffset = state.selection.index;
109
+ else if (state.selection.index >= state.scrollOffset + viewport) state.scrollOffset = state.selection.index - viewport + 1;
110
+ state.scrollOffset = Math.max(0, Math.min(state.scrollOffset, Math.max(0, rows.length - viewport)));
111
+ return null;
112
+ }
113
+ if (input === "\u001b[5~" || input === "\u001b[6~") {
114
+ const viewport = Math.max(1, bodyHeight);
115
+ moveSelection(state.selection, rows, (input === "\u001b[5~" ? -1 : 1) * viewport);
116
+ state.scrollOffset = Math.max(0, Math.min(state.selection.index, Math.max(0, rows.length - viewport)));
117
+ return null;
118
+ }
119
+ if (input === "f") {
120
+ state.filtering = true;
121
+ return null;
122
+ }
123
+ if (input === "a") {
124
+ state.showFinished = !state.showFinished;
125
+ return null;
126
+ }
127
+ if (input === "\r" && selected) return { open: selected.key };
128
+ if (input === "x" || input === "r") {
129
+ if (!selected) return null;
130
+ const action = input === "x" ? "kill" : "restart";
131
+ if (state.confirm?.action === action && state.confirm.key === selected.key && state.confirm.until > now) {
132
+ state.confirm = null;
133
+ return action === "kill" ? { kill: selected.key } : { restart: selected.key };
134
+ }
135
+ state.confirm = { action, key: selected.key, until: now + 2000 };
136
+ return null;
137
+ }
138
+ if (input === "\u001b" || input === "q") return "close";
139
+ return null;
140
+ }
@@ -0,0 +1,43 @@
1
+ import type { FleetRow } from "./fleet-read-model.ts";
2
+ import type { ThemeLike } from "./fleet-dashboard-view.ts";
3
+
4
+ export interface TimelineEntry { kind: "text" | "tool" | "thinking"; title: string; content: string; timestamp: number; }
5
+ export const DETAIL_CHROME_ROWS = 4;
6
+ 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
+
8
+ export function detailContent(timeline: readonly TimelineEntry[], width: number, expandedIndex: number | null): string[] {
9
+ const w = Math.max(1, width);
10
+ return timeline.flatMap((entry, index) => {
11
+ const icon = entry.kind === "tool" ? "▸" : entry.kind === "thinking" ? "·" : "•";
12
+ if (index === expandedIndex && entry.kind === "tool") return [` ${icon} ${entry.title}`, ...entry.content.split(/\r?\n/).map(line => ` ${trim(line, Math.max(0, w - 3))}`)];
13
+ return [` ${icon} ${trim(`${entry.title} ${entry.content.replace(/\s+/g, " ")}`, Math.max(0, w - 1))}`];
14
+ });
15
+ }
16
+
17
+ /** Render a constant-height transcript detail screen, including the no-local-peer notice. */
18
+ export function renderFleetDetail(row: FleetRow, timeline: readonly TimelineEntry[], scrollOffset: number, width: number, bodyHeight: number, theme: ThemeLike, expandedIndex: number | null = null): string[] {
19
+ const w = Math.max(1, width), body = Math.max(0, bodyHeight);
20
+ const header = trim(` ${row.name} · ${row.status} · ${row.kind} · ${row.model} · ${row.backend} · ${row.contextPct == null ? "context automatic" : `${Math.round(row.contextPct)}%`} · ${Math.round(row.elapsed / 1000)}s · ${row.toolCount ?? "—"} tools`, w);
21
+ const lines = [theme.bold(header), theme.fg("dim", "╭" + "─".repeat(Math.max(0, w - 2)) + "╮")];
22
+ if (!row.hasTimeline) lines.push(...Array.from({ length: body }, (_, i) => i === 0 ? theme.fg("dim", " no local transcript for this coms peer") : ""));
23
+ else {
24
+ const content = detailContent(timeline, w, expandedIndex);
25
+ const offset = Math.max(0, Math.min(scrollOffset, Math.max(0, content.length - body)));
26
+ lines.push(...content.slice(offset, offset + body), ...Array(Math.max(0, body - content.slice(offset, offset + body).length)).fill(""));
27
+ }
28
+ 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"));
30
+ return lines.slice(0, body + DETAIL_CHROME_ROWS).concat(Array(Math.max(0, body + DETAIL_CHROME_ROWS - lines.length)).fill(""));
31
+ }
32
+
33
+ /** 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 {
35
+ const max = Math.max(0, contentLength - Math.max(1, bodyHeight));
36
+ if (input === "\u001b" || input === "q") return "close";
37
+ if (input === "\u0003") return "copy";
38
+ if (input === "\u001b[F") { state.followTail = true; state.scrollOffset = max; return null; }
39
+ if (input === "\r") { if (timeline[state.selectedIndex]?.kind === "tool") state.expandedIndex = state.expandedIndex === state.selectedIndex ? null : state.selectedIndex; return null; }
40
+ const delta = input === "\u001b[A" || input === "k" ? -1 : input === "\u001b[B" || input === "j" ? 1 : input === "\u001b[5~" ? -bodyHeight : input === "\u001b[6~" ? bodyHeight : 0;
41
+ if (delta) { state.followTail = false; state.selectedIndex = Math.max(0, Math.min(Math.max(0, timeline.length - 1), state.selectedIndex + delta)); state.scrollOffset = Math.max(0, Math.min(max, state.scrollOffset + delta)); }
42
+ return null;
43
+ }
@@ -0,0 +1,26 @@
1
+ /** Overlay options for a full-screen pi overlay. */
2
+ export const FULLSCREEN_OVERLAY = {
3
+ overlay: true as const,
4
+ overlayOptions: { anchor: "center", width: "100%", maxHeight: "100%" },
5
+ } as const;
6
+
7
+ /** Minimum body height below which an overlay degrades rather than breaks. */
8
+ export const MIN_BODY_ROWS = 6;
9
+
10
+ /** Return the fixed scrolling-body budget for a terminal. */
11
+ export function bodyRows(terminalRows: number | undefined, chromeRows: number, min = MIN_BODY_ROWS): number {
12
+ const rows = terminalRows && terminalRows > 0 ? terminalRows : 30;
13
+ return Math.max(min, rows - 1 - Math.max(0, chromeRows));
14
+ }
15
+
16
+ /** Pad with empty strings or truncate to exactly n lines. */
17
+ export function fitToHeight(lines: readonly string[], n: number): string[] {
18
+ const height = Math.max(0, n);
19
+ return [...lines.slice(0, height), ...Array(Math.max(0, height - lines.length)).fill("")];
20
+ }
21
+
22
+ /** Clamp a scroll offset to the available content window. */
23
+ export function clampScroll(offset: number, contentLength: number, viewport: number): number {
24
+ const max = Math.max(0, contentLength - Math.max(0, viewport));
25
+ return Math.max(0, Math.min(offset, max));
26
+ }
@@ -0,0 +1,34 @@
1
+ export interface PanelResources {
2
+ every(ms: number, fn: () => void): void;
3
+ onDispose(fn: () => void): void;
4
+ dispose(): void;
5
+ readonly closed: boolean;
6
+ }
7
+
8
+ /** Own timers and cleanup callbacks for one disposable overlay component. */
9
+ export function createPanelResources(): PanelResources {
10
+ let closed = false;
11
+ const teardowns: Array<() => void> = [];
12
+ return {
13
+ every(ms, fn) {
14
+ if (closed) return;
15
+ const timer = setInterval(fn, ms);
16
+ teardowns.push(() => clearInterval(timer));
17
+ },
18
+ onDispose(fn) {
19
+ if (closed) {
20
+ fn();
21
+ return;
22
+ }
23
+ teardowns.push(fn);
24
+ },
25
+ dispose() {
26
+ if (closed) return;
27
+ closed = true;
28
+ for (const teardown of teardowns.splice(0)) {
29
+ try { teardown(); } catch {}
30
+ }
31
+ },
32
+ get closed() { return closed; },
33
+ };
34
+ }