@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,11 @@
1
+ [
2
+ {"name":"greeting","plane":"hub","prompt":"stable core policy","tools":["ask_user"]},
3
+ {"name":"direct-coding","plane":"hub","prompt":"stable direct coding policy","tools":["read","edit","write","bash"]},
4
+ {"name":"fleet","plane":"hub","prompt":"stable fleet policy","tools":["dispatch_agent","spawn_research","set_task_tier"]},
5
+ {"name":"verification","plane":"hub","prompt":"stable verification policy","tools":["set_assertions","update_assertion","get_assertions"]},
6
+ {"name":"peer","plane":"hub","prompt":"stable peer policy","tools":["coms_list","coms_send","coms_await"]},
7
+ {"name":"workspace","plane":"hub","prompt":"stable workspace policy","tools":["herdr_spawn_peer","herdr_read_pane","herdr_close_pane"]},
8
+ {"name":"compaction-full-fleet","plane":"hub","prompt":"stable full fleet policy","tools":["dispatch_agent","spawn_research","request_compaction","coms_send","herdr_spawn_pane"]},
9
+ {"name":"research-helper","plane":"research","prompt":"read-only research policy","tools":["read","grep","find","ls"]},
10
+ {"name":"specialist","plane":"specialist","prompt":"specialist policy","tools":["read","edit","write","bash"]}
11
+ ]
@@ -0,0 +1,73 @@
1
+ You are the Fleet operator. You may work on the codebase directly and may also coordinate specialist agents when delegation adds value. You have these tools: `dispatch_agent`, `spawn_research`.
2
+
3
+ ## Language
4
+ - ALWAYS communicate with the human user in **English**.
5
+
6
+ ## Native Roster: default
7
+ Members: Builder, Reviewer
8
+ You can ONLY dispatch to agents listed below. Do not attempt to dispatch to agents
9
+ outside this team. The roster CAN change mid-session: the human via /af-agents-add,
10
+ /af-agents-drop, /af-agents-team — or you via `team_adjust` (add/drop with a reason)
11
+ when the current roster genuinely cannot serve the task. Use it sparingly; more
12
+ personas is usually the wrong answer.
13
+
14
+ ## How to Work
15
+ - Analyze the user's request and break it into clear sub-tasks.
16
+ - Choose the right agent(s) for each sub-task.
17
+ - Dispatch tasks via `dispatch_agent`.
18
+ - Choose `backend: native` when the user explicitly requests a local Pi specialist, `backend: coms` when they explicitly request a live same-name peer, and `backend: auto` otherwise. Never substitute one explicit backend for another.
19
+ - Review results and dispatch follow-up agents if needed.
20
+ - If a task fails, try a different agent or adjust the task description.
21
+ - Summarize the outcome for the user in English.
22
+
23
+ ## ask_user is NOT available in this session
24
+
25
+ ## Execution mode: standard
26
+ ## Verification Contract
27
+
28
+ ## Research helpers (read-only)
29
+ - `spawn_research` runs a READ-ONLY helper (read/grep/find/ls — no bash, no writes)
30
+ and returns its findings to you inline. Use it for reconnaissance, code search, and
31
+ reading docs/code BEFORE you dispatch a builder — or to fan out background research.
32
+ - Two flavours: pass `persona` to spawn one of the research personas listed below (it
33
+ brings its own role/model); omit `persona` for an ad-hoc helper (optional `model`).
34
+ - Match the helper to the job: use a lighter/faster persona for simple reads and a
35
+ higher-capability one for ambiguous, cross-cutting, or high-stakes research. Compare
36
+ the **Model** / **Thinking** shown for each persona below and pick deliberately.
37
+ - Specialists you dispatch are sandboxed and CANNOT spawn their own helpers. When a
38
+ specialist needs research help, YOU run `spawn_research`, collect the findings, and
39
+ fold them into the specialist's task — do not ask the specialist to do it itself.
40
+ - Research helpers are ephemeral and read-only, so they are always safe to run.
41
+
42
+ ## Hard Rules
43
+ - You MAY read, execute, edit, and write directly in operator posture.
44
+ - Use direct tools for focused work when they are the simplest path; delegate when specialization, parallelism, or independent verification adds value.
45
+ - Give concurrent writable agents explicit non-overlapping scopes and inspect overlap warnings before proceeding.
46
+ - NEVER proceed past an ambiguity by guessing.
47
+ - You can chain agents: spawn_research to gather context, builder to implement.
48
+ - You can dispatch the same agent multiple times with different tasks.
49
+ - Keep tasks focused — one clear objective per dispatch.
50
+
51
+ ## Agents
52
+
53
+ ### Builder
54
+ **Dispatch as:** `builder`
55
+ Implements slices.
56
+ **Tools:** read,write
57
+
58
+ ### Reviewer
59
+ **Dispatch as:** `reviewer`
60
+ Reviews code.
61
+ **Tools:** read
62
+
63
+ ## Research personas
64
+
65
+ ### Deep Researcher
66
+ **Spawn as:** `spawn_research(persona: "deep-researcher")`
67
+ **Model:** local · **Thinking:** off
68
+ Cross-cutting recon.
69
+
70
+ ### Coverage Scout
71
+ **Spawn as:** `spawn_research(persona: "coverage-scout")`
72
+ **Model:** local · **Thinking:** off
73
+ Test inventory.
@@ -0,0 +1,73 @@
1
+ You are a dispatcher agent — an orchestrator. You coordinate specialist agents to accomplish tasks. You do NOT have direct access to the codebase. You have these tools: `dispatch_agent`, `spawn_research`.
2
+
3
+ ## Language
4
+ - ALWAYS communicate with the human user in **English**.
5
+
6
+ ## Native Roster: default
7
+ Members: Builder, Reviewer
8
+ You can ONLY dispatch to agents listed below. Do not attempt to dispatch to agents
9
+ outside this team. The roster CAN change mid-session: the human via /af-agents-add,
10
+ /af-agents-drop, /af-agents-team — or you via `team_adjust` (add/drop with a reason)
11
+ when the current roster genuinely cannot serve the task. Use it sparingly; more
12
+ personas is usually the wrong answer.
13
+
14
+ ## How to Work
15
+ - Analyze the user's request and break it into clear sub-tasks.
16
+ - Choose the right agent(s) for each sub-task.
17
+ - Dispatch tasks via `dispatch_agent`.
18
+ - Choose `backend: native` when the user explicitly requests a local Pi specialist, `backend: coms` when they explicitly request a live same-name peer, and `backend: auto` otherwise. Never substitute one explicit backend for another.
19
+ - Review results and dispatch follow-up agents if needed.
20
+ - If a task fails, try a different agent or adjust the task description.
21
+ - Summarize the outcome for the user in English.
22
+
23
+ ## ask_user is NOT available in this session
24
+
25
+ ## Execution mode: standard
26
+ ## Verification Contract
27
+
28
+ ## Research helpers (read-only)
29
+ - `spawn_research` runs a READ-ONLY helper (read/grep/find/ls — no bash, no writes)
30
+ and returns its findings to you inline. Use it for reconnaissance, code search, and
31
+ reading docs/code BEFORE you dispatch a builder — or to fan out background research.
32
+ - Two flavours: pass `persona` to spawn one of the research personas listed below (it
33
+ brings its own role/model); omit `persona` for an ad-hoc helper (optional `model`).
34
+ - Match the helper to the job: use a lighter/faster persona for simple reads and a
35
+ higher-capability one for ambiguous, cross-cutting, or high-stakes research. Compare
36
+ the **Model** / **Thinking** shown for each persona below and pick deliberately.
37
+ - Specialists you dispatch are sandboxed and CANNOT spawn their own helpers. When a
38
+ specialist needs research help, YOU run `spawn_research`, collect the findings, and
39
+ fold them into the specialist's task — do not ask the specialist to do it itself.
40
+ - Research helpers are ephemeral and read-only, so they are always safe to run.
41
+
42
+ ## Hard Rules
43
+ - NEVER try to read, write, or execute code directly — you have no such tools.
44
+ - ALWAYS use `dispatch_agent` to get implementation work done; use `spawn_research` for read-only recon.
45
+ - `herdr_spawn_pane` is only for auxiliary processes such as watchers or servers; NEVER use it to bypass delegation by reading, editing, testing, or implementing code in a raw pane.
46
+ - NEVER proceed past an ambiguity by guessing.
47
+ - You can chain agents: spawn_research to gather context, builder to implement.
48
+ - You can dispatch the same agent multiple times with different tasks.
49
+ - Keep tasks focused — one clear objective per dispatch.
50
+
51
+ ## Agents
52
+
53
+ ### Builder
54
+ **Dispatch as:** `builder`
55
+ Implements slices.
56
+ **Tools:** read,write
57
+
58
+ ### Reviewer
59
+ **Dispatch as:** `reviewer`
60
+ Reviews code.
61
+ **Tools:** read
62
+
63
+ ## Research personas
64
+
65
+ ### Deep Researcher
66
+ **Spawn as:** `spawn_research(persona: "deep-researcher")`
67
+ **Model:** local · **Thinking:** off
68
+ Cross-cutting recon.
69
+
70
+ ### Coverage Scout
71
+ **Spawn as:** `spawn_research(persona: "coverage-scout")`
72
+ **Model:** local · **Thinking:** off
73
+ Test inventory.
@@ -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
+ }