@chankov/agent-fleet 0.0.9 → 0.0.10

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 (354) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +12 -7
  2. package/.claude/commands/setup-agent-fleet.md +7 -15
  3. package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
  4. package/.opencode/commands/af-setup-agent-fleet.md +8 -6
  5. package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
  6. package/.pi/extensions/btw/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
  8. package/.pi/extensions/compact-and-continue/README.md +3 -3
  9. package/.pi/extensions/mcp-bridge/README.md +1 -1
  10. package/.pi/harnesses/agent-hub/README.md +139 -10
  11. package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  12. package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  13. package/.pi/harnesses/agent-hub/index.ts +448 -39
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/review-findings.js +102 -0
  16. package/.pi/harnesses/agent-hub/run-budget.js +302 -4
  17. package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  20. package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
  21. package/.pi/prompts/af-setup-agent-fleet.md +7 -15
  22. package/.versions/0.0.10/.claude/commands/build.md +44 -0
  23. package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
  24. package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
  25. package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
  26. package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
  27. package/.versions/0.0.10/.claude/commands/plan.md +16 -0
  28. package/.versions/0.0.10/.claude/commands/prime.md +22 -0
  29. package/.versions/0.0.10/.claude/commands/review.md +16 -0
  30. package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
  31. package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
  32. package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
  33. package/.versions/0.0.10/.claude/commands/ship.md +72 -0
  34. package/.versions/0.0.10/.claude/commands/spec.md +15 -0
  35. package/.versions/0.0.10/.claude/commands/test.md +19 -0
  36. package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
  37. package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
  38. package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
  39. package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
  40. package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
  41. package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
  42. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  43. package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
  44. package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
  45. package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
  46. package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
  47. package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
  48. package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  49. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
  50. package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
  51. package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
  52. package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
  53. package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
  54. package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  56. package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
  57. package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
  58. package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
  59. package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  61. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  62. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  63. package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
  64. package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
  65. package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
  66. package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
  67. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  68. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  69. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  70. package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  71. package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  72. package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  73. package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  74. package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  75. package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  76. package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
  77. package/.versions/0.0.10/.pi/extensions/package.json +9 -0
  78. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
  79. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  80. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  81. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  82. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  83. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  84. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  85. package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
  86. package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  87. package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  88. package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  89. package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  90. package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
  92. package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  93. package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  94. package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  95. package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
  97. package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
  98. package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
  99. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  100. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  101. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  102. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  103. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  104. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  105. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  106. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  107. package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  108. package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  109. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
  110. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  111. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
  112. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  113. package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  114. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
  115. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  116. package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  117. package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  118. package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  119. package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
  120. package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  121. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
  122. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
  123. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  124. package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
  125. package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
  126. package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
  127. package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
  128. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
  129. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
  130. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  131. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  132. package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  133. package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  134. package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  135. package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  136. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  137. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  138. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  139. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  140. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  141. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  142. package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  143. package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
  144. package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
  145. package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
  146. package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
  147. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  148. package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
  149. package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
  150. package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  151. package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  152. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
  153. package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
  154. package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
  155. package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
  156. package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
  157. package/.versions/0.0.10/.version +1 -0
  158. package/.versions/0.0.10/agents/architect.md +24 -0
  159. package/.versions/0.0.10/agents/bowser.md +27 -0
  160. package/.versions/0.0.10/agents/builder.md +54 -0
  161. package/.versions/0.0.10/agents/code-reviewer.md +208 -0
  162. package/.versions/0.0.10/agents/deep-researcher.md +32 -0
  163. package/.versions/0.0.10/agents/documenter.md +18 -0
  164. package/.versions/0.0.10/agents/orchestrator.md +72 -0
  165. package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
  166. package/.versions/0.0.10/agents/planner.md +70 -0
  167. package/.versions/0.0.10/agents/releaser.md +24 -0
  168. package/.versions/0.0.10/agents/researcher.md +28 -0
  169. package/.versions/0.0.10/agents/security-auditor.md +167 -0
  170. package/.versions/0.0.10/agents/test-engineer.md +153 -0
  171. package/.versions/0.0.10/agents/web-debugger.md +43 -0
  172. package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
  173. package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
  174. package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
  175. package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
  176. package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
  177. package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
  178. package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
  179. package/.versions/0.0.10/docs/getting-started.md +254 -0
  180. package/.versions/0.0.10/docs/npm-install.md +514 -0
  181. package/.versions/0.0.10/docs/opencode-setup.md +281 -0
  182. package/.versions/0.0.10/docs/pi-extensions.md +363 -0
  183. package/.versions/0.0.10/docs/pi-setup.md +571 -0
  184. package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
  185. package/.versions/0.0.10/hermes/README.md +347 -0
  186. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  187. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  188. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  189. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  190. package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
  191. package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
  192. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  193. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  194. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  195. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  196. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  197. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  198. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  199. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  200. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  201. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  202. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  203. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  204. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  205. package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
  206. package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
  207. package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
  208. package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
  209. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  210. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  211. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  212. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  213. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  214. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  215. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  216. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  217. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  218. package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
  219. package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
  220. package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
  221. package/.versions/0.0.10/hooks/hooks.json +14 -0
  222. package/.versions/0.0.10/hooks/session-start.sh +74 -0
  223. package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
  224. package/.versions/0.0.10/install-manifest.json +3615 -0
  225. package/.versions/0.0.10/justfile +254 -0
  226. package/.versions/0.0.10/manifest-meta.json +472 -0
  227. package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
  228. package/.versions/0.0.10/references/definition-of-done.md +67 -0
  229. package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
  230. package/.versions/0.0.10/references/observability-checklist.md +91 -0
  231. package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
  232. package/.versions/0.0.10/references/performance-checklist.md +153 -0
  233. package/.versions/0.0.10/references/prompting-patterns.md +380 -0
  234. package/.versions/0.0.10/references/security-checklist.md +179 -0
  235. package/.versions/0.0.10/references/testing-patterns.md +236 -0
  236. package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
  237. package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
  238. package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
  239. package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
  240. package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
  241. package/.versions/0.0.10/scripts/fleet.ts +168 -0
  242. package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
  243. package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
  244. package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
  245. package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
  246. package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
  247. package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
  248. package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
  249. package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
  250. package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
  251. package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
  252. package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
  253. package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
  254. package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
  255. package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
  256. package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
  257. package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
  258. package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
  259. package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
  260. package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
  261. package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
  262. package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
  263. package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
  264. package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
  265. package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
  266. package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
  267. package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
  268. package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
  269. package/.versions/0.0.10/scripts/team-up.ts +360 -0
  270. package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
  271. package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  272. package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
  273. package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
  274. package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
  275. package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
  276. package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
  277. package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  278. package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  279. package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  280. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
  281. package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
  282. package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
  283. package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
  284. package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
  285. package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  286. package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  287. package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
  288. package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
  289. package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
  290. package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
  291. package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
  292. package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
  293. package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
  294. package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
  295. package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
  296. package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  297. package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  298. package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
  299. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  300. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  301. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  302. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  303. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  304. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  305. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  306. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  307. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  308. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  309. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  310. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  311. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  312. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  313. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  314. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  315. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  316. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  317. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  318. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  319. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  320. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  321. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  322. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  323. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  324. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  325. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  326. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  327. package/CHANGELOG.md +103 -0
  328. package/README.md +22 -5
  329. package/agents/code-reviewer.md +4 -0
  330. package/agents/orchestrator.md +7 -1
  331. package/agents/plan-reviewer.md +22 -1
  332. package/bin/build-manifest.js +68 -0
  333. package/bin/cli.js +679 -49
  334. package/bin/lib/apply.js +641 -0
  335. package/bin/lib/manifest.js +731 -0
  336. package/bin/lib/merge-forms.js +106 -0
  337. package/bin/lib/plan.js +569 -0
  338. package/bin/lib/state.js +213 -0
  339. package/bin/lib/verify.js +576 -0
  340. package/bin/snapshot-version.js +5 -0
  341. package/docs/ARCHITECTURE.md +52 -11
  342. package/docs/agent-fleet-setup.md +59 -48
  343. package/docs/getting-started.md +29 -6
  344. package/docs/npm-install.md +208 -31
  345. package/docs/opencode-setup.md +32 -0
  346. package/docs/pi-extensions.md +17 -10
  347. package/docs/pi-setup.md +164 -69
  348. package/install-manifest.json +3615 -0
  349. package/manifest-meta.json +472 -0
  350. package/package.json +8 -3
  351. package/skills/browser-testing-with-devtools/SKILL.md +3 -4
  352. package/skills/guided-workspace-setup/SKILL.md +172 -490
  353. package/skills/planning-and-task-breakdown/SKILL.md +18 -0
  354. package/skills/spec-driven-development/SKILL.md +12 -0
@@ -0,0 +1,180 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # Install one in-repo Hermes plugin into a Hermes profile.
4
+ #
5
+ # scripts/install-hermes-plugin.sh agent-fleet-herdr [--profile default]
6
+ # [--copy] [--uninstall] [--force] [--dry-run]
7
+ #
8
+ # A plugin has up to two halves, installed into the profile the same way:
9
+ #
10
+ # hermes/plugins/<id>/ -> <profile>/plugins/<id> (backend, FastAPI)
11
+ # hermes/desktop-plugins/<id>/ -> <profile>/desktop-plugins/<id> (Desktop pane, ESM)
12
+ #
13
+ # Symlinked at DIRECTORY level, never file by file: web_server.py requires the
14
+ # api file to resolve inside its own dashboard directory, so linking just
15
+ # `plugin_api.py` into a real directory makes the backend fail `relative_to`
16
+ # and be skipped in silence. `--copy` opts out of symlinks entirely.
17
+ #
18
+ # The script never restarts anything. The two halves have different reload
19
+ # rules — plugin.js is watched and hot-reloads, but routers are only included
20
+ # when the app is constructed — so it prints the exact steps and lets a human
21
+ # decide when the gateway goes down.
22
+
23
+ set -euo pipefail
24
+
25
+ PLUGIN_ID=""
26
+ PROFILE="${HERMES_PROFILE:-default}"
27
+ MODE="install"
28
+ LINK=1
29
+ FORCE=0
30
+ DRY_RUN=0
31
+
32
+ REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
33
+ HERMES_SOURCE="${HERMES_SOURCE:-$HOME/.hermes/hermes-agent}"
34
+
35
+ die() { printf 'error: %s\n' "$1" >&2; exit 1; }
36
+ note() { printf ' %s\n' "$1"; }
37
+ run() { if [ "$DRY_RUN" = 1 ]; then printf ' [dry-run] %s\n' "$*"; else "$@"; fi; }
38
+
39
+ usage() {
40
+ sed -n '3,22p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
41
+ exit "${1:-0}"
42
+ }
43
+
44
+ while [ $# -gt 0 ]; do
45
+ case "$1" in
46
+ --profile) PROFILE="${2:-}"; [ -n "$PROFILE" ] || die "--profile needs a name"; shift 2 ;;
47
+ --profile=*) PROFILE="${1#*=}"; shift ;;
48
+ --copy) LINK=0; shift ;;
49
+ --uninstall) MODE="uninstall"; shift ;;
50
+ --force) FORCE=1; shift ;;
51
+ --dry-run) DRY_RUN=1; shift ;;
52
+ -h|--help) usage 0 ;;
53
+ -*) die "unknown option: $1" ;;
54
+ *) [ -z "$PLUGIN_ID" ] || die "one plugin id at a time (got '$PLUGIN_ID' and '$1')"; PLUGIN_ID="$1"; shift ;;
55
+ esac
56
+ done
57
+
58
+ [ -n "$PLUGIN_ID" ] || usage 1
59
+ # The Desktop loader keys the plugin by its folder name, so an id with a path
60
+ # separator would install a plugin that can never load.
61
+ case "$PLUGIN_ID" in *[!A-Za-z0-9._-]*) die "unsafe plugin id: $PLUGIN_ID" ;; esac
62
+
63
+ command -v hermes >/dev/null 2>&1 || die "hermes CLI not found on PATH"
64
+
65
+ BACKEND_SRC="$REPO_ROOT/hermes/plugins/$PLUGIN_ID"
66
+ DESKTOP_SRC="$REPO_ROOT/hermes/desktop-plugins/$PLUGIN_ID"
67
+ [ -d "$BACKEND_SRC" ] || [ -d "$DESKTOP_SRC" ] || die "no such plugin in this repo: $PLUGIN_ID"
68
+
69
+ # `hermes profile show` is the only authority on where a profile lives; the
70
+ # Desktop loader reads the same path from gateway status as `hermes home`.
71
+ PROFILE_PATH="$(hermes profile show "$PROFILE" 2>/dev/null | sed -n 's/^Path:[[:space:]]*//p' | head -1)"
72
+ [ -n "$PROFILE_PATH" ] || die "cannot resolve Hermes profile '$PROFILE' (try: hermes profile list)"
73
+ [ -d "$PROFILE_PATH" ] || die "profile path does not exist: $PROFILE_PATH"
74
+
75
+ printf 'plugin %s\nprofile %s (%s)\nmode %s%s\n\n' \
76
+ "$PLUGIN_ID" "$PROFILE" "$PROFILE_PATH" "$MODE" "$([ "$LINK" = 1 ] && echo ' via symlink' || echo ' via copy')"
77
+
78
+ backup_config() {
79
+ local config="$PROFILE_PATH/config.yaml"
80
+ [ -f "$config" ] || { note "no config.yaml to back up"; return 0; }
81
+ local backup_dir="$PROFILE_PATH/backups/agent-fleet"
82
+ run mkdir -p "$backup_dir"
83
+ local backup="$backup_dir/config.yaml.$(date +%Y%m%dT%H%M%S)"
84
+ run cp -p "$config" "$backup"
85
+ note "backed up config.yaml -> $backup"
86
+ }
87
+
88
+ # One half of the plugin: repo directory -> profile directory.
89
+ install_half() {
90
+ local src="$1" dest_parent="$2" label="$3"
91
+ [ -d "$src" ] || { note "no $label half in this repo — skipped"; return 0; }
92
+ local dest="$dest_parent/$PLUGIN_ID"
93
+ run mkdir -p "$dest_parent"
94
+ if [ -L "$dest" ]; then
95
+ run rm "$dest"
96
+ elif [ -e "$dest" ]; then
97
+ [ "$FORCE" = 1 ] || die "$dest exists and is not a symlink; re-run with --force to replace it"
98
+ run rm -rf "$dest"
99
+ fi
100
+ if [ "$LINK" = 1 ]; then
101
+ run ln -s "$src" "$dest"
102
+ note "$label: $dest -> $src"
103
+ else
104
+ run cp -R "$src" "$dest"
105
+ note "$label: copied to $dest"
106
+ fi
107
+ }
108
+
109
+ uninstall_half() {
110
+ local dest_parent="$1" label="$2"
111
+ local dest="$dest_parent/$PLUGIN_ID"
112
+ if [ -L "$dest" ]; then
113
+ run rm "$dest"
114
+ note "$label: removed symlink $dest"
115
+ elif [ -d "$dest" ]; then
116
+ [ "$FORCE" = 1 ] || { note "$label: $dest is a real directory — left in place (use --force to delete)"; return 0; }
117
+ run rm -rf "$dest"
118
+ note "$label: removed $dest"
119
+ else
120
+ note "$label: nothing installed"
121
+ fi
122
+ }
123
+
124
+ # The acceptance check from the plan, run WITHOUT touching the live gateway:
125
+ # discovery must see the dashboard half with an api file, and the enable record
126
+ # must exist. Both are required — either one missing yields the same 404.
127
+ verify_backend() {
128
+ local python="$HERMES_SOURCE/venv/bin/python"
129
+ if [ ! -x "$python" ]; then
130
+ note "skipped backend verification: no interpreter at $python (set HERMES_SOURCE)"
131
+ return 0
132
+ fi
133
+ if [ "$DRY_RUN" = 1 ]; then
134
+ note "[dry-run] would verify discovery + enable record"
135
+ return 0
136
+ fi
137
+ HERMES_HOME="$PROFILE_PATH" HERMES_SOURCE="$HERMES_SOURCE" "$python" - "$PLUGIN_ID" <<'PY'
138
+ import os
139
+ import sys
140
+ sys.path.insert(0, os.environ["HERMES_SOURCE"])
141
+ from hermes_cli.plugins_cmd import _get_enabled_set
142
+ from hermes_cli.web_server import _discover_dashboard_plugins
143
+
144
+ name = sys.argv[1]
145
+ found = [p for p in _discover_dashboard_plugins() if p["name"] == name]
146
+ enabled = name in _get_enabled_set()
147
+ has_api = bool(found and found[0].get("has_api"))
148
+ print(f" discovery: {'ok' if has_api else 'MISSING'} (records={len(found)}, has_api={has_api})")
149
+ print(f" enabled: {'ok' if enabled else 'MISSING'}")
150
+ sys.exit(0 if has_api and enabled else 1)
151
+ PY
152
+ }
153
+
154
+ if [ "$MODE" = "install" ]; then
155
+ backup_config
156
+ install_half "$BACKEND_SRC" "$PROFILE_PATH/plugins" "backend"
157
+ install_half "$DESKTOP_SRC" "$PROFILE_PATH/desktop-plugins" "desktop"
158
+ if [ -d "$BACKEND_SRC" ]; then
159
+ # Without this record every request to /api/plugins/<id>/* is refused by
160
+ # middleware before routing — a 404 that looks exactly like "not mounted".
161
+ run hermes --profile "$PROFILE" plugins enable "$PLUGIN_ID" --no-allow-tool-override
162
+ verify_backend || die "backend not ready — see the two lines above"
163
+ fi
164
+ printf '\nNext (not done for you):\n'
165
+ if [ -d "$BACKEND_SRC" ]; then
166
+ # Two gateways: `hermes gateway restart` covers the user service (Telegram,
167
+ # TUI, web dashboard), but the Desktop pane calls the gateway that
168
+ # `hermes desktop` spawns for itself — and routers only mount at boot.
169
+ printf ' restart the Hermes Desktop app # its own gateway serves ctx.rest() for the pane\n'
170
+ printf ' hermes --profile %s gateway restart # only if the web dashboard / TUI needs the routes\n' "$PROFILE"
171
+ fi
172
+ if [ -d "$DESKTOP_SRC" ]; then printf ' plugin.js itself hot-reloads within ~5s — no restart needed for pane edits\n'; fi
173
+ else
174
+ run hermes --profile "$PROFILE" plugins disable "$PLUGIN_ID" || note "plugins disable reported an error — continuing"
175
+ uninstall_half "$PROFILE_PATH/plugins" "backend"
176
+ uninstall_half "$PROFILE_PATH/desktop-plugins" "desktop"
177
+ printf '\nNext (not done for you):\n'
178
+ printf ' restart the Hermes Desktop app # unmounts the routers the pane was using\n'
179
+ printf ' hermes --profile %s gateway restart # unmounts them in the service gateway too\n' "$PROFILE"
180
+ fi
@@ -0,0 +1,165 @@
1
+ // scripts/lib/claude-bridge-core.ts
2
+ //
3
+ // Pure logic for the Claude Code coms bridge (scripts/coms-claude-bridge.ts):
4
+ // prompt formatting, completion sentinels, hook-record parsing, reply
5
+ // extraction from pane text, and the serial prompt queue. No sockets, no fs,
6
+ // no herdr — everything here runs under node --test.
7
+
8
+ export const SENTINEL_PREFIX = "<<COMS_DONE:";
9
+
10
+ // ── reply-timeout and idle-wait policy ──
11
+ //
12
+ // Two field failures live here. First, the bridge only ever read its own
13
+ // --reply-timeout: a caller that asked for 1_800_000ms was still told "no reply
14
+ // within 600000ms", so a review that honestly takes more than ten minutes could
15
+ // not succeed at all. Second, a pane that was mid-turn threw instantly, which
16
+ // turned every busy moment into a hard error — ten of eighteen coms_await calls
17
+ // in one session died that way, the caller hot-retried every few seconds, and
18
+ // then fell back to reading the pane 127 times to watch progress by hand.
19
+
20
+ /** No caller may hold a pane hostage indefinitely. */
21
+ export const REPLY_TIMEOUT_HARD_CAP_MS = 3_600_000;
22
+
23
+ /** Backoff while waiting for a busy pane, in ms; the last step repeats. */
24
+ export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
25
+
26
+ /** Longest we will ever wait for a pane to go idle before giving up. */
27
+ export const IDLE_WAIT_CAP_MS = 120_000;
28
+
29
+ /**
30
+ * The caller's own deadline wins — it knows how long the work takes — falling
31
+ * back to the bridge's configured timeout and always clamped to the hard cap.
32
+ */
33
+ export function resolveReplyTimeoutMs(requested: unknown, fallbackMs: number, capMs = REPLY_TIMEOUT_HARD_CAP_MS): number {
34
+ const asked = Number(requested);
35
+ const base = Number.isFinite(asked) && asked > 0 ? asked : fallbackMs;
36
+ return Math.max(1, Math.min(base, capMs));
37
+ }
38
+
39
+ /** One absolute deadline shared by idle waiting and reply collection. */
40
+ export function replyDeadlineAt(startedAtMs: number, timeoutMs: number): number {
41
+ return Number(startedAtMs) + Math.max(0, Number(timeoutMs) || 0);
42
+ }
43
+
44
+ /**
45
+ * The pane accepted the prompt but did not finish inside the caller's budget.
46
+ * This is deliberately not a response error: the work may still complete.
47
+ */
48
+ export class ReplyPendingError extends Error {
49
+ readonly pending = true;
50
+ constructor(message: string) {
51
+ super(message);
52
+ this.name = "ReplyPendingError";
53
+ }
54
+ }
55
+
56
+ export function isReplyPendingError(error: unknown): error is ReplyPendingError {
57
+ return error instanceof ReplyPendingError || Boolean((error as { pending?: unknown } | null)?.pending);
58
+ }
59
+
60
+ /** Backoff delay for the nth idle-wait attempt (0-based); the last step repeats. */
61
+ export function idleWaitDelayMs(attempt: number): number {
62
+ const i = Math.max(0, Math.min(Math.floor(attempt), IDLE_WAIT_BACKOFF_MS.length - 1));
63
+ return IDLE_WAIT_BACKOFF_MS[i];
64
+ }
65
+
66
+ /**
67
+ * How long to wait for a busy pane. Never more than half the caller's reply
68
+ * budget — waiting to start must not consume the time meant for the answer.
69
+ */
70
+ export function idleWaitBudgetMs(replyTimeoutMs: number, capMs = IDLE_WAIT_CAP_MS): number {
71
+ const half = Math.floor((Number(replyTimeoutMs) || 0) / 2);
72
+ return Math.max(0, Math.min(capMs, half));
73
+ }
74
+
75
+ export function completionSentinel(msgId: string): string {
76
+ return `${SENTINEL_PREFIX}${msgId}>>`;
77
+ }
78
+
79
+ // The prompt as typed into the Claude Code pane. Mirrors the pi side's
80
+ // "[from name @ cwd]" framing so Claude knows who is asking; in sentinel mode
81
+ // (no Stop hook seen yet) it also asks for the completion marker.
82
+ export function formatPanePrompt(
83
+ env: { prompt: string; sender_name: string; sender_cwd: string; msg_id: string },
84
+ sentinelMode: boolean,
85
+ ): string {
86
+ const header = `[coms message from ${env.sender_name} @ ${env.sender_cwd}] `;
87
+ const sentinelNote = sentinelMode
88
+ ? `\n\nEnd your reply with this exact line so the bridge can capture it: ${completionSentinel(env.msg_id)}`
89
+ : "";
90
+ return `${header}${env.prompt}${sentinelNote}`;
91
+ }
92
+
93
+ // Stop-hook record: the hook writes {text, session_id?, written_at} as JSON.
94
+ export interface HookRecord {
95
+ text: string;
96
+ written_at?: string;
97
+ [key: string]: unknown;
98
+ }
99
+
100
+ export function parseHookRecord(raw: string): HookRecord | null {
101
+ try {
102
+ const rec = JSON.parse(raw);
103
+ if (rec && typeof rec.text === "string") return rec as HookRecord;
104
+ return null;
105
+ } catch {
106
+ return null;
107
+ }
108
+ }
109
+
110
+ // Sentinel-mode fallback: pull the reply out of raw pane text. Takes
111
+ // everything between the last prompt echo (identified by the msg_id-bearing
112
+ // sentinel instruction OR the header line) and the sentinel line, stripped of
113
+ // obvious TUI furniture. Returns null when the sentinel has not appeared.
114
+ export function extractSentinelReply(paneText: string, msgId: string): string | null {
115
+ const sentinel = completionSentinel(msgId);
116
+ const at = paneText.lastIndexOf(sentinel);
117
+ if (at === -1) return null;
118
+ const before = paneText.slice(0, at);
119
+ // Cut at the end of the prompt echo: the sentinel instruction line
120
+ // contains the sentinel too, so use the LAST occurrence before the final
121
+ // one — that's the echo; the reply follows it.
122
+ const echoAt = before.lastIndexOf(sentinel);
123
+ const replyRegion = echoAt !== -1 ? before.slice(echoAt + sentinel.length) : before;
124
+ const lines = replyRegion
125
+ .split("\n")
126
+ .map((l) => l.replace(/^[●❯>\s]+/, "").trimEnd())
127
+ .filter((l) => l.trim() !== "" && !/^[─━┏┗┃│]+/.test(l));
128
+ return lines.join("\n").trim() || null;
129
+ }
130
+
131
+ // ━━ Serial prompt queue ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
132
+ //
133
+ // One prompt at a time per pane; queue depth is reported in the agent card.
134
+
135
+ export interface QueuedPrompt<T> {
136
+ envelope: T;
137
+ enqueued_at: string;
138
+ }
139
+
140
+ export class PromptQueue<T> {
141
+ private items: Array<QueuedPrompt<T>> = [];
142
+ private active = false;
143
+
144
+ get depth(): number {
145
+ return this.items.length + (this.active ? 1 : 0);
146
+ }
147
+
148
+ push(envelope: T, now: () => string = () => new Date().toISOString()): void {
149
+ this.items.push({ envelope, enqueued_at: now() });
150
+ }
151
+
152
+ // Take the next prompt if none is being processed. Callers MUST call
153
+ // done() when processing finishes (success or failure).
154
+ take(): QueuedPrompt<T> | null {
155
+ if (this.active) return null;
156
+ const next = this.items.shift();
157
+ if (!next) return null;
158
+ this.active = true;
159
+ return next;
160
+ }
161
+
162
+ done(): void {
163
+ this.active = false;
164
+ }
165
+ }
@@ -0,0 +1,88 @@
1
+ // Fail-closed command construction for the experimental external Codex conductor.
2
+ // It deliberately exposes only the two contract-approved coms operations.
3
+
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+
7
+ import { validateComsName, validateComsProject } from "./coms-envelope.ts";
8
+ import { conductorWorkspacePath, loadOwnedConfig } from "./codex-remote-control.ts";
9
+
10
+ export interface ConductorContext {
11
+ repoRoot: string;
12
+ project: string;
13
+ name: string;
14
+ timeoutMs: number;
15
+ conductorCwd: string;
16
+ comsDir: string;
17
+ }
18
+
19
+ export type ConductorOperation =
20
+ | { operation: "list" }
21
+ | { operation: "send"; peer: string; prompt: string };
22
+
23
+ function realDirectory(value: string, label: string): string {
24
+ try {
25
+ const resolved = fs.realpathSync(value);
26
+ if (!fs.statSync(resolved).isDirectory()) throw new Error("not a directory");
27
+ return resolved;
28
+ } catch {
29
+ throw new Error(`${label} must resolve to an existing directory`);
30
+ }
31
+ }
32
+
33
+ /** Parse before any config/filesystem/process access. No scope overrides exist. */
34
+ export function parseConductorArgs(argv: string[]): ConductorOperation {
35
+ const flags = new Set<string>();
36
+ for (const arg of argv) {
37
+ if (!arg.startsWith("--")) continue;
38
+ if (flags.has(arg)) throw new Error(`${arg} may only be provided once`);
39
+ flags.add(arg);
40
+ }
41
+ if (flags.size > 0) throw new Error("flags and scope overrides are not allowed; the owned configuration is authoritative");
42
+ if (argv[0] === "list" && argv.length === 1) return { operation: "list" };
43
+ if (argv[0] === "send") {
44
+ if (argv.length !== 3) throw new Error("send requires exactly a peer and prompt");
45
+ return { operation: "send", peer: argv[1], prompt: argv[2] };
46
+ }
47
+ throw new Error("usage: codex-conductor <list|send <listed-peer> <bounded-prompt>>");
48
+ }
49
+
50
+ export function loadConductorContext(input: { configPath: string; cwd: string; checkoutRoot: string }): ConductorContext {
51
+ const config = loadOwnedConfig(input.configPath);
52
+ const checkoutRoot = realDirectory(input.checkoutRoot, "checkout root");
53
+ if (config.repoRoot !== checkoutRoot) {
54
+ throw new Error("configured repository does not match this checkout");
55
+ }
56
+ const conductorCwd = conductorWorkspacePath(config.runtimeDir!);
57
+ if (realDirectory(input.cwd, "working directory") !== conductorCwd) {
58
+ throw new Error(`working directory must be ${conductorCwd}`);
59
+ }
60
+ validateComsProject(config.project);
61
+ validateComsName(config.name);
62
+ return {
63
+ repoRoot: config.repoRoot,
64
+ project: config.project,
65
+ name: config.name,
66
+ timeoutMs: config.timeoutMs,
67
+ conductorCwd,
68
+ comsDir: realDirectory(config.comsDir, "coms directory"),
69
+ };
70
+ }
71
+
72
+ export function conductorProcessEnv(
73
+ context: ConductorContext,
74
+ base: NodeJS.ProcessEnv = process.env,
75
+ ): NodeJS.ProcessEnv {
76
+ return { ...base, PI_COMS_DIR: context.comsDir };
77
+ }
78
+
79
+ export function buildConductorCommand(context: ConductorContext, operation: ConductorOperation): string[] {
80
+ if (operation.operation === "list") {
81
+ return ["list", "--project", context.project, "--name", context.name];
82
+ }
83
+ return [
84
+ "send", operation.peer, operation.prompt,
85
+ "--project", context.project, "--name", context.name,
86
+ "--await", "--timeout", String(context.timeoutMs), "--conductor", "codex",
87
+ ];
88
+ }