@chankov/agent-fleet 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/harnesses/agent-hub/README.md +12 -3
  3. package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  4. package/.pi/harnesses/agent-hub/index.ts +121 -57
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/run-budget.js +61 -0
  7. package/.pi/harnesses/coms/package.json +1 -1
  8. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  9. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
  10. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  11. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  12. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  13. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  14. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  15. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  16. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  17. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  18. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  19. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  20. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  21. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  22. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  23. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  24. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  25. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  26. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  27. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  28. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  29. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  30. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  31. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  32. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  33. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  34. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  35. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  36. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  37. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  38. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  39. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  40. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  41. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  42. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  43. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  44. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  45. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  46. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  47. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  48. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  49. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  50. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  51. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  52. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  53. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  54. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  55. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  56. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  57. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  58. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  59. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  60. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  61. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  62. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  63. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  64. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  65. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  66. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  67. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  68. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  69. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  70. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  71. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  72. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  73. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  74. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  75. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  76. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  77. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  78. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  79. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  80. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  81. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  82. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  83. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  84. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  85. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  86. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  87. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  88. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  89. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  90. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  91. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  92. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  93. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  94. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  95. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  96. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  97. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  98. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  99. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  100. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  101. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  102. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  103. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  104. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  105. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  106. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  107. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  108. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  109. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  110. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  111. package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
  112. package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
  113. package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
  114. package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  115. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  116. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  117. package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
  118. package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
  119. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  120. package/.versions/1.0.1/.version +1 -0
  121. package/.versions/1.0.1/agents/architect.md +24 -0
  122. package/.versions/1.0.1/agents/bowser.md +27 -0
  123. package/.versions/1.0.1/agents/builder.md +54 -0
  124. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  125. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  126. package/.versions/1.0.1/agents/documenter.md +18 -0
  127. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  128. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  129. package/.versions/1.0.1/agents/planner.md +70 -0
  130. package/.versions/1.0.1/agents/releaser.md +24 -0
  131. package/.versions/1.0.1/agents/researcher.md +28 -0
  132. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  133. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  134. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  135. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  136. package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  137. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  138. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  139. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  140. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  141. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  142. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  143. package/.versions/1.0.1/docs/getting-started.md +98 -0
  144. package/.versions/1.0.1/docs/npm-install.md +292 -0
  145. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  146. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  147. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  148. package/.versions/1.0.1/hermes/README.md +347 -0
  149. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  150. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  151. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  152. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  153. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  154. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  155. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  156. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  157. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  158. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  159. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  160. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  161. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  162. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  163. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  164. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  165. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  166. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  167. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  168. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  169. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  170. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  171. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  172. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  173. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  174. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  175. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  176. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  177. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  178. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  179. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  180. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  181. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  182. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  183. package/.versions/1.0.1/install-manifest.json +2745 -0
  184. package/.versions/1.0.1/justfile +272 -0
  185. package/.versions/1.0.1/manifest-meta.json +882 -0
  186. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  187. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  188. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  189. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  190. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  191. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  192. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  193. package/.versions/1.0.1/references/security-checklist.md +179 -0
  194. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  195. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  196. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  197. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  198. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  199. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  200. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  201. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  202. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  203. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  204. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  205. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  206. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  207. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  208. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  209. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  210. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  211. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  212. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  213. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  214. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  215. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  216. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  217. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  218. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  219. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  220. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  221. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  222. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  223. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  224. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  225. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  226. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  227. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  228. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  229. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  230. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  231. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  232. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  233. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  234. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  235. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  236. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  237. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  238. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  239. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  240. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  241. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  242. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  243. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  244. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  245. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  246. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  247. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  248. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  249. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  250. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  251. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  252. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  253. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  254. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  255. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  256. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  257. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  258. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  259. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  260. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  261. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  262. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  263. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  264. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  265. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  266. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  267. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  268. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  269. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  270. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  271. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  272. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  273. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  274. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  275. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  276. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  277. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  278. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  279. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  280. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  281. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  282. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  283. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  284. package/CHANGELOG.md +6 -0
  285. package/agents/code-reviewer.md +1 -1
  286. package/agents/deep-researcher.md +1 -1
  287. package/agents/plan-reviewer.md +1 -1
  288. package/agents/planner.md +1 -1
  289. package/agents/security-auditor.md +1 -1
  290. package/agents/test-engineer.md +1 -1
  291. package/install-manifest.json +1 -1
  292. package/package.json +2 -2
@@ -0,0 +1,484 @@
1
+ // scripts/coms-cli.ts
2
+ //
3
+ // Envelope-protocol CLI for non-pi participants in a coms pool. Registry and
4
+ // spool paths are always scoped by a validated project and caller name.
5
+ //
6
+ // usage: coms-cli <list|send|await|reply> [args] --project <p> --name <me>
7
+
8
+ import { spawn } from "node:child_process";
9
+ import * as fs from "node:fs";
10
+ import * as path from "node:path";
11
+ import { fileURLToPath } from "node:url";
12
+
13
+ import {
14
+ bindEndpoint,
15
+ COMS_DIR,
16
+ ensureComsDirs,
17
+ isPromptEnvelope,
18
+ isResponseEnvelope,
19
+ makeConnHandler,
20
+ makeEndpoint,
21
+ makePromptEnvelope,
22
+ makeResponseEnvelope,
23
+ nowIso,
24
+ pruneDeadEntries,
25
+ removeRegistryEntry,
26
+ sendEnvelope,
27
+ ulid,
28
+ validateComsName,
29
+ validateComsProject,
30
+ writeAck,
31
+ writeNack,
32
+ writeRegistryAtomic,
33
+ type RegistryEntry,
34
+ type SenderIdentity,
35
+ } from "./lib/coms-envelope.ts";
36
+
37
+ const DEFAULT_NAME = "claude-cli";
38
+ const DEFAULT_PROJECT = "default";
39
+ const DEFAULT_AWAIT_MS = 300_000;
40
+ const MAX_TIMEOUT_MS = 0x7fffffff;
41
+ const COMS_ID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
42
+
43
+ type FlagName = "project" | "name" | "await" | "timeout" | "all" | "conductor" | "session" | "ttl";
44
+
45
+ interface ParsedArgs {
46
+ positionals: string[];
47
+ flags: Map<FlagName, string | true>;
48
+ }
49
+
50
+ interface Scope {
51
+ project: string;
52
+ name: string;
53
+ includeExplicit: boolean;
54
+ }
55
+
56
+ interface CodexLock {
57
+ release(): void;
58
+ }
59
+
60
+ function fail(message: string): never {
61
+ throw new Error(message);
62
+ }
63
+
64
+ function parseArgs(argv: string[], allowed: readonly FlagName[]): ParsedArgs {
65
+ const allowedFlags = new Set<FlagName>(allowed);
66
+ const flags = new Map<FlagName, string | true>();
67
+ const positionals: string[] = [];
68
+ for (let i = 0; i < argv.length; i++) {
69
+ const arg = argv[i];
70
+ if (!arg.startsWith("--")) {
71
+ positionals.push(arg);
72
+ continue;
73
+ }
74
+ const flag = arg.slice(2) as FlagName;
75
+ if (!allowedFlags.has(flag)) fail(`unknown flag: ${arg}`);
76
+ if (flags.has(flag)) fail(`--${flag} may only be provided once`);
77
+ if (flag === "await" || flag === "all") {
78
+ flags.set(flag, true);
79
+ continue;
80
+ }
81
+ const value = argv[i + 1];
82
+ if (!value || value.startsWith("--")) fail(`--${flag} requires a value`);
83
+ flags.set(flag, value);
84
+ i++;
85
+ }
86
+ return { positionals, flags };
87
+ }
88
+
89
+ function flagValue(parsed: ParsedArgs, flag: FlagName): string | undefined {
90
+ const value = parsed.flags.get(flag);
91
+ return typeof value === "string" ? value : undefined;
92
+ }
93
+
94
+ function scopeFrom(parsed: ParsedArgs): Scope {
95
+ const project = validateComsProject(flagValue(parsed, "project") ?? process.env.COMS_CLI_PROJECT ?? DEFAULT_PROJECT);
96
+ const name = validateComsName(flagValue(parsed, "name") ?? process.env.COMS_CLI_NAME ?? DEFAULT_NAME);
97
+ return { project, name, includeExplicit: parsed.flags.get("all") === true };
98
+ }
99
+
100
+ function timeoutFrom(parsed: ParsedArgs, flag: "timeout" | "ttl" = "timeout"): number {
101
+ const raw = flagValue(parsed, flag) ?? process.env.PI_COMS_TIMEOUT_MS ?? String(DEFAULT_AWAIT_MS);
102
+ if (!/^\d+$/.test(raw)) fail(`Invalid timeout: ${JSON.stringify(raw)} (use a positive integer no greater than ${MAX_TIMEOUT_MS})`);
103
+ const timeoutMs = Number(raw);
104
+ if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > MAX_TIMEOUT_MS) {
105
+ fail(`Invalid timeout: ${JSON.stringify(raw)} (use a positive integer no greater than ${MAX_TIMEOUT_MS})`);
106
+ }
107
+ return timeoutMs;
108
+ }
109
+
110
+ function validateComsId(value: string, label: "msg_id" | "listen session"): string {
111
+ if (!COMS_ID_RE.test(value)) fail(`Invalid ${label}: ${JSON.stringify(value)} (expected a 26-character Crockford ULID)`);
112
+ return value;
113
+ }
114
+
115
+ function spoolDir(project: string, name: string): string {
116
+ return path.join(COMS_DIR, "cli", "projects", validateComsProject(project), validateComsName(name));
117
+ }
118
+
119
+ function legacySpoolDir(name: string): string {
120
+ return path.join(COMS_DIR, "cli", validateComsName(name));
121
+ }
122
+
123
+ function ensureSpool(project: string, name: string): { pending: string; responses: string; inbound: string } {
124
+ const base = spoolDir(project, name);
125
+ const legacy = legacySpoolDir(name);
126
+ // A legacy name-only queue cannot be assigned to a project safely. Refuse
127
+ // rather than consuming it under whichever project happens to run first.
128
+ if (fs.existsSync(legacy)) {
129
+ fail(`Legacy name-only coms spool exists at ${legacy}; stop that identity, inspect the queue, and move the complete directory under cli/projects/<project>/<name> after confirming its project. Do not delete ambiguous pending data.`);
130
+ }
131
+ const dirs = {
132
+ pending: path.join(base, "pending"),
133
+ responses: path.join(base, "responses"),
134
+ inbound: path.join(base, "inbound"),
135
+ };
136
+ for (const dir of Object.values(dirs)) fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
137
+ return dirs;
138
+ }
139
+
140
+ function peersInScope(scope: Scope): RegistryEntry[] {
141
+ return pruneDeadEntries(scope.project).filter(
142
+ (entry) => entry.name !== scope.name && (scope.includeExplicit || !entry.explicit),
143
+ );
144
+ }
145
+
146
+ function makeIdentity(name: string, sessionId: string): SenderIdentity {
147
+ return { session_id: sessionId, name, endpoint: makeEndpoint(sessionId), cwd: process.cwd() };
148
+ }
149
+
150
+ function registerCliEntry(id: SenderIdentity, project: string, purpose: string): void {
151
+ const entry: RegistryEntry = {
152
+ session_id: id.session_id,
153
+ name: id.name,
154
+ purpose,
155
+ model: "cli",
156
+ color: "#FEDE5D",
157
+ pid: process.pid,
158
+ endpoint: id.endpoint,
159
+ cwd: id.cwd,
160
+ started_at: nowIso(),
161
+ explicit: true,
162
+ version: 1,
163
+ };
164
+ writeRegistryAtomic(entry, project);
165
+ }
166
+
167
+ function acquireCodexLock(scope: Scope): CodexLock {
168
+ const lockDir = path.join(COMS_DIR, "locks");
169
+ const lockPath = path.join(lockDir, "codex-send.lock");
170
+ fs.mkdirSync(lockDir, { recursive: true, mode: 0o700 });
171
+ try { fs.chmodSync(lockDir, 0o700); } catch { /* best effort */ }
172
+ let fd: number;
173
+ try {
174
+ fd = fs.openSync(lockPath, "wx", 0o600);
175
+ } catch (err) {
176
+ if ((err as NodeJS.ErrnoException).code === "EEXIST") {
177
+ fail(`Codex send lock is held (or stale) at ${lockPath}; inspect its metadata and remove it manually only after confirming the owner is gone.`);
178
+ }
179
+ throw err;
180
+ }
181
+ try {
182
+ fs.writeFileSync(fd, `${JSON.stringify({ pid: process.pid, started_at: nowIso(), project: scope.project, name: scope.name })}\n`);
183
+ } finally {
184
+ fs.closeSync(fd);
185
+ }
186
+
187
+ let released = false;
188
+ const release = () => {
189
+ if (released) return;
190
+ released = true;
191
+ process.removeListener("SIGTERM", onSigterm);
192
+ process.removeListener("SIGINT", onSigint);
193
+ try { fs.unlinkSync(lockPath); } catch { /* best effort */ }
194
+ };
195
+ const exitForSignal = (signal: NodeJS.Signals) => {
196
+ release();
197
+ process.exit(signal === "SIGINT" ? 130 : 143);
198
+ };
199
+ const onSigterm = () => exitForSignal("SIGTERM");
200
+ const onSigint = () => exitForSignal("SIGINT");
201
+ process.once("SIGTERM", onSigterm);
202
+ process.once("SIGINT", onSigint);
203
+ return { release };
204
+ }
205
+
206
+ // ━━ list ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
207
+
208
+ function cmdList(argv: string[]): void {
209
+ const parsed = parseArgs(argv, ["project", "name", "all"]);
210
+ if (parsed.positionals.length > 0) fail("list does not accept positional arguments");
211
+ const scope = scopeFrom(parsed);
212
+ const peers = peersInScope(scope);
213
+ if (peers.length === 0) {
214
+ console.log(`(no live peers in project "${scope.project}")`);
215
+ return;
216
+ }
217
+ for (const peer of peers) console.log(`${peer.name}\t${peer.model}\t${peer.purpose}`);
218
+ }
219
+
220
+ // ━━ send ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
221
+
222
+ function validateCodexMode(parsed: ParsedArgs): boolean {
223
+ const conductor = flagValue(parsed, "conductor");
224
+ if (conductor === undefined) return false;
225
+ if (conductor !== "codex") fail(`Unsupported conductor: ${JSON.stringify(conductor)}`);
226
+ if (!parsed.flags.has("project") || !parsed.flags.has("name") || !parsed.flags.has("timeout") || parsed.flags.get("await") !== true) {
227
+ fail("Codex mode requires explicit --project, --name, --await, and --timeout options.");
228
+ }
229
+ if (parsed.flags.get("all") === true) fail("Codex mode does not allow --all.");
230
+ return true;
231
+ }
232
+
233
+ async function cmdSend(argv: string[]): Promise<void> {
234
+ const parsed = parseArgs(argv, ["project", "name", "await", "timeout", "all", "conductor"]);
235
+ const [rawTarget, ...promptParts] = parsed.positionals;
236
+ const prompt = promptParts.join(" ");
237
+ if (!rawTarget || !prompt) fail("usage: coms-cli send <peer> <prompt…> --project <project> --name <name> [--await] [--timeout <ms>]");
238
+ const target = validateComsName(rawTarget);
239
+ const scope = scopeFrom(parsed);
240
+ const timeoutMs = timeoutFrom(parsed);
241
+ const codexMode = validateCodexMode(parsed);
242
+ const lock = codexMode ? acquireCodexLock(scope) : null;
243
+ try {
244
+ // This fresh scoped list is both the only target source and, for Codex,
245
+ // intentionally happens after lock acquisition.
246
+ const peers = peersInScope(scope);
247
+ const peer = peers.find((entry) => entry.name === target);
248
+ if (!peer) {
249
+ const names = peers.map((entry) => entry.name).join(", ") || "(none)";
250
+ fail(`Peer "${target}" not found in project "${scope.project}". Live peers: ${names}`);
251
+ }
252
+
253
+ ensureComsDirs(scope.project);
254
+ const spool = ensureSpool(scope.project, scope.name);
255
+ const doAwait = parsed.flags.get("await") === true;
256
+ if (doAwait) {
257
+ const id = makeIdentity(scope.name, ulid());
258
+ let resolveReply!: (value: { response: unknown; error?: string | null }) => void;
259
+ const reply = new Promise<{ response: unknown; error?: string | null }>((resolve) => { resolveReply = resolve; });
260
+ const server = await bindEndpoint(
261
+ id.endpoint,
262
+ makeConnHandler((env, socket) => {
263
+ if (isResponseEnvelope(env)) {
264
+ writeAck(socket, env.msg_id);
265
+ resolveReply({ response: env.response, error: env.error ?? null });
266
+ } else if ((env as { type?: string }).type === "ping") {
267
+ writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
268
+ } else {
269
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "cli awaits responses only");
270
+ }
271
+ }),
272
+ );
273
+ registerCliEntry(id, scope.project, `coms-cli (one-shot ask from ${scope.name})`);
274
+ const cleanup = () => {
275
+ try { server.close(); } catch { /* ignore */ }
276
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
277
+ removeRegistryEntry(scope.project, id.name);
278
+ };
279
+ try {
280
+ const env = makePromptEnvelope(id, prompt);
281
+ await sendEnvelope(peer.endpoint, env);
282
+ console.error(`sent ${env.msg_id} → ${peer.name} (awaiting reply, timeout ${timeoutMs}ms)`);
283
+ let timeoutTimer!: NodeJS.Timeout;
284
+ const timeout = new Promise<never>((_resolve, reject) => {
285
+ timeoutTimer = setTimeout(() => reject(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs);
286
+ });
287
+ const result = await Promise.race([reply, timeout]).finally(() => clearTimeout(timeoutTimer));
288
+ if (result.error) fail(`peer error: ${result.error}`);
289
+ console.log(typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2));
290
+ } finally {
291
+ cleanup();
292
+ }
293
+ return;
294
+ }
295
+
296
+ const sessionId = ulid();
297
+ const endpoint = makeEndpoint(sessionId);
298
+ const child = spawn(
299
+ process.execPath,
300
+ [
301
+ fileURLToPath(import.meta.url),
302
+ "_listen",
303
+ "--name", scope.name,
304
+ "--project", scope.project,
305
+ "--session", sessionId,
306
+ "--ttl", String(timeoutMs),
307
+ ],
308
+ { detached: true, stdio: ["ignore", "pipe", "ignore"] },
309
+ );
310
+ await new Promise<void>((resolve, reject) => {
311
+ let settled = false;
312
+ const finish = (fn: () => void) => {
313
+ if (settled) return;
314
+ settled = true;
315
+ clearTimeout(timer);
316
+ fn();
317
+ };
318
+ const timer = setTimeout(() => finish(() => reject(new Error("waiter did not become ready"))), 5_000);
319
+ child.stdout!.on("data", (data) => {
320
+ if (data.toString().includes("READY")) finish(resolve);
321
+ });
322
+ child.once("exit", () => finish(() => reject(new Error("waiter exited early"))));
323
+ });
324
+ child.unref();
325
+ child.stdout!.destroy();
326
+
327
+ const id: SenderIdentity = { session_id: sessionId, name: scope.name, endpoint, cwd: process.cwd() };
328
+ const env = makePromptEnvelope(id, prompt);
329
+ const pendingFile = path.join(spool.pending, `${env.msg_id}.json`);
330
+ fs.writeFileSync(pendingFile, JSON.stringify({ msg_id: env.msg_id, target: peer.name, sent_at: nowIso() }));
331
+ try {
332
+ await sendEnvelope(peer.endpoint, env);
333
+ } catch (err) {
334
+ try { fs.unlinkSync(pendingFile); } catch { /* ignore */ }
335
+ try { if (child.pid) process.kill(-child.pid, "SIGTERM"); } catch { /* ignore */ }
336
+ fail(`send failed: ${err instanceof Error ? err.message : String(err)}`);
337
+ }
338
+ console.log(env.msg_id);
339
+ } finally {
340
+ lock?.release();
341
+ }
342
+ }
343
+
344
+ // ━━ _listen (internal detached waiter) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
345
+
346
+ async function cmdListen(argv: string[]): Promise<void> {
347
+ const parsed = parseArgs(argv, ["project", "name", "session", "ttl"]);
348
+ if (parsed.positionals.length > 0) fail("_listen does not accept positional arguments");
349
+ const scope = scopeFrom(parsed);
350
+ const sessionId = validateComsId(flagValue(parsed, "session") ?? ulid(), "listen session");
351
+ const ttl = timeoutFrom(parsed, "ttl");
352
+ ensureComsDirs(scope.project);
353
+ const spool = ensureSpool(scope.project, scope.name);
354
+ const id = makeIdentity(scope.name, sessionId);
355
+
356
+ const server = await bindEndpoint(
357
+ id.endpoint,
358
+ makeConnHandler((env, socket) => {
359
+ if (isResponseEnvelope(env) && typeof env.msg_id === "string" && COMS_ID_RE.test(env.msg_id)) {
360
+ writeAck(socket, env.msg_id);
361
+ fs.writeFileSync(
362
+ path.join(spool.responses, `${env.msg_id}.json`),
363
+ JSON.stringify({ response: env.response, error: env.error ?? null, received_at: nowIso() }),
364
+ );
365
+ try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
366
+ maybeExit();
367
+ } else if (isPromptEnvelope(env) && typeof env.msg_id === "string" && COMS_ID_RE.test(env.msg_id)) {
368
+ writeAck(socket, env.msg_id);
369
+ fs.writeFileSync(
370
+ path.join(spool.inbound, `${env.msg_id}.json`),
371
+ JSON.stringify({
372
+ msg_id: env.msg_id,
373
+ prompt: env.prompt,
374
+ sender_name: env.sender_name,
375
+ sender_endpoint: env.sender_endpoint,
376
+ sender_session: env.sender_session,
377
+ hops: env.hops,
378
+ received_at: nowIso(),
379
+ }),
380
+ );
381
+ } else if ((env as { type?: string }).type === "ping") {
382
+ writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
383
+ } else {
384
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "unsupported envelope or msg_id");
385
+ }
386
+ }),
387
+ );
388
+ registerCliEntry(id, scope.project, "coms-cli reply waiter");
389
+ console.log("READY");
390
+
391
+ const cleanup = () => {
392
+ try { server.close(); } catch { /* ignore */ }
393
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
394
+ removeRegistryEntry(scope.project, id.name);
395
+ process.exit(0);
396
+ };
397
+ const startedAt = Date.now();
398
+ function maybeExit(): void {
399
+ try {
400
+ const pendingLeft = fs.readdirSync(spool.pending).length;
401
+ if (pendingLeft === 0 && Date.now() - startedAt > 3_000) cleanup();
402
+ } catch {
403
+ // Best-effort cleanup only; the TTL remains authoritative.
404
+ }
405
+ }
406
+ setInterval(maybeExit, 5_000);
407
+ setTimeout(cleanup, ttl);
408
+ process.on("SIGTERM", cleanup);
409
+ process.on("SIGINT", cleanup);
410
+ }
411
+
412
+ // ━━ await ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
413
+
414
+ async function cmdAwait(argv: string[]): Promise<void> {
415
+ const parsed = parseArgs(argv, ["project", "name", "timeout"]);
416
+ if (parsed.positionals.length !== 1) fail("usage: coms-cli await <msg_id> --project <project> --name <name> [--timeout <ms>]");
417
+ const msgId = validateComsId(parsed.positionals[0], "msg_id");
418
+ const scope = scopeFrom(parsed);
419
+ const timeoutMs = timeoutFrom(parsed);
420
+ const spool = ensureSpool(scope.project, scope.name);
421
+ const file = path.join(spool.responses, `${msgId}.json`);
422
+ const deadline = Date.now() + timeoutMs;
423
+ while (Date.now() < deadline) {
424
+ if (fs.existsSync(file)) {
425
+ const record = JSON.parse(fs.readFileSync(file, "utf-8"));
426
+ if (record.error) fail(`peer error: ${record.error}`);
427
+ console.log(typeof record.response === "string" ? record.response : JSON.stringify(record.response, null, 2));
428
+ return;
429
+ }
430
+ await new Promise((resolve) => setTimeout(resolve, 500));
431
+ }
432
+ fail(`timeout: no reply for ${msgId} after ${timeoutMs}ms`);
433
+ }
434
+
435
+ // ━━ reply ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
436
+
437
+ async function cmdReply(argv: string[]): Promise<void> {
438
+ const parsed = parseArgs(argv, ["project", "name"]);
439
+ const [rawMsgId, ...textParts] = parsed.positionals;
440
+ const msgId = rawMsgId ? validateComsId(rawMsgId, "msg_id") : undefined;
441
+ const scope = scopeFrom(parsed);
442
+ let text = textParts.join(" ");
443
+ if (!text && !process.stdin.isTTY) text = fs.readFileSync(0, "utf-8").trim();
444
+ if (!msgId || !text) fail("usage: coms-cli reply <msg_id> <text…> --project <project> --name <name> (or pipe the text on stdin)");
445
+ const spool = ensureSpool(scope.project, scope.name);
446
+ const recordFile = path.join(spool.inbound, `${msgId}.json`);
447
+ if (!fs.existsSync(recordFile)) fail(`No inbound prompt ${msgId} in ${spool.inbound}`);
448
+ const record = JSON.parse(fs.readFileSync(recordFile, "utf-8"));
449
+ const id = makeIdentity(scope.name, ulid());
450
+ await sendEnvelope(record.sender_endpoint, makeResponseEnvelope(id, msgId, text));
451
+ fs.unlinkSync(recordFile);
452
+ console.log(`replied to ${record.sender_name ?? record.sender_session} (${msgId})`);
453
+ }
454
+
455
+ async function main(): Promise<void> {
456
+ const [command, ...rest] = process.argv.slice(2);
457
+ switch (command) {
458
+ case "list":
459
+ cmdList(rest);
460
+ return;
461
+ case "send":
462
+ await cmdSend(rest);
463
+ return;
464
+ case "await":
465
+ await cmdAwait(rest);
466
+ return;
467
+ case "reply":
468
+ await cmdReply(rest);
469
+ return;
470
+ case "_listen":
471
+ await cmdListen(rest);
472
+ return;
473
+ default:
474
+ fail("usage: coms-cli <list|send|await|reply> …");
475
+ }
476
+ }
477
+
478
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
479
+ if (isEntry) {
480
+ void main().catch((err) => {
481
+ console.error(err instanceof Error ? err.message : String(err));
482
+ process.exitCode = 1;
483
+ });
484
+ }