@chankov/agent-fleet 0.0.6 → 0.0.8

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 (717) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/harnesses/agent-hub/README.md +75 -16
  4. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  5. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  6. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  7. package/.pi/harnesses/agent-hub/delegate.ts +58 -9
  8. package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
  9. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  10. package/.pi/harnesses/agent-hub/index.ts +723 -159
  11. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  12. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  13. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  14. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  15. package/.pi/harnesses/agent-hub/package.json +1 -1
  16. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  17. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  18. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  19. package/.pi/harnesses/agent-hub/run-budget.js +29 -3
  20. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  21. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  22. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  23. package/.pi/harnesses/coms/README.md +4 -3
  24. package/.pi/harnesses/coms/index.ts +80 -58
  25. package/.pi/harnesses/coms/package.json +1 -1
  26. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  27. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  28. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  29. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  30. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  31. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  32. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  33. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  34. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  35. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  36. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  37. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  38. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  39. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  40. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  41. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  42. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  43. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  44. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  45. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  46. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  47. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  48. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  49. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  50. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  51. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  52. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  53. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  54. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  55. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  56. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  57. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  58. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  59. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  60. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  61. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  62. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  63. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  64. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  65. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  66. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  67. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  68. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  69. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  70. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  71. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  72. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  73. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  74. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  75. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  76. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  77. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  78. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  79. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  80. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  81. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  82. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  83. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  84. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  85. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  86. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  87. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  88. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  89. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  90. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  91. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  92. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  93. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  94. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  95. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  96. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  97. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  98. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  99. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  100. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  101. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  102. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  103. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  104. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  105. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  106. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  107. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  108. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  110. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  125. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  126. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  127. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  128. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  129. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  130. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  131. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  132. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  133. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  134. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  135. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  136. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  137. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  138. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  139. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  140. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  141. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  142. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  143. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  144. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  145. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  146. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  147. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  148. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  149. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  150. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  151. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  152. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  153. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  154. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  155. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  156. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  157. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  158. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  159. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  160. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  161. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.7/.version +1 -0
  167. package/.versions/0.0.7/agents/architect.md +23 -0
  168. package/.versions/0.0.7/agents/bowser.md +26 -0
  169. package/.versions/0.0.7/agents/builder.md +53 -0
  170. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.7/agents/documenter.md +18 -0
  173. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  174. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.7/agents/planner.md +69 -0
  176. package/.versions/0.0.7/agents/releaser.md +24 -0
  177. package/.versions/0.0.7/agents/researcher.md +28 -0
  178. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  184. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  186. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  188. package/.versions/0.0.7/docs/getting-started.md +231 -0
  189. package/.versions/0.0.7/docs/npm-install.md +337 -0
  190. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.7/hermes/README.md +347 -0
  195. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  196. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  197. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  198. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  199. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  200. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  201. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  202. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  203. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  204. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  205. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  206. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  207. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  208. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  209. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  210. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  211. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  212. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  213. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  214. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  215. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  216. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  217. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  218. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  219. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  220. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  221. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  222. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  223. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  224. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  225. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  226. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  227. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  228. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  229. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  230. package/.versions/0.0.7/hooks/hooks.json +14 -0
  231. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  232. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  233. package/.versions/0.0.7/justfile +245 -0
  234. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  235. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  236. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  237. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  238. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  239. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  240. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  241. package/.versions/0.0.7/references/security-checklist.md +179 -0
  242. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  243. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  244. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  245. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  246. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  247. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  248. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  249. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  250. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  251. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  252. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  253. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  254. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  255. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  256. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  257. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  258. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  259. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  260. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  261. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  262. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  263. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  264. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  265. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  266. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  267. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  268. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  269. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  270. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  271. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  272. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  273. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  274. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  275. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  276. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  277. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  278. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  279. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  280. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  281. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  282. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  283. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  284. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  285. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  286. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  287. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  288. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  289. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  290. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  291. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  292. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  293. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  294. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  295. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  296. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  297. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  298. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  299. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  300. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  301. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  302. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  303. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  304. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  305. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  306. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  307. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  308. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  309. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  310. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  311. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  312. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  313. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  314. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  315. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  316. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  317. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  318. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  319. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  320. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  321. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  322. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  323. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  324. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  325. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  326. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  327. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  328. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  329. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  330. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  331. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  332. package/.versions/0.0.8/.claude/commands/build.md +44 -0
  333. package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
  334. package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
  335. package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
  336. package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
  337. package/.versions/0.0.8/.claude/commands/plan.md +16 -0
  338. package/.versions/0.0.8/.claude/commands/prime.md +22 -0
  339. package/.versions/0.0.8/.claude/commands/review.md +16 -0
  340. package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
  341. package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
  342. package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
  343. package/.versions/0.0.8/.claude/commands/ship.md +72 -0
  344. package/.versions/0.0.8/.claude/commands/spec.md +15 -0
  345. package/.versions/0.0.8/.claude/commands/test.md +19 -0
  346. package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
  347. package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
  348. package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
  349. package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
  350. package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
  351. package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
  352. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  353. package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
  354. package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
  355. package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
  356. package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
  357. package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
  358. package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  359. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
  360. package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
  361. package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
  362. package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
  363. package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
  364. package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
  365. package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  366. package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
  367. package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
  368. package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
  369. package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
  370. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  371. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  372. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  373. package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
  374. package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
  375. package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
  376. package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
  377. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  378. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  379. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  380. package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  381. package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  382. package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  383. package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  384. package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  385. package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  386. package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
  387. package/.versions/0.0.8/.pi/extensions/package.json +9 -0
  388. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
  389. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  390. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  391. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  392. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  393. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  394. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  395. package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
  396. package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  397. package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  398. package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  399. package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  400. package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  401. package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
  402. package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  403. package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  404. package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
  405. package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
  406. package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
  407. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  408. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  409. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  410. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  411. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  412. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  413. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  414. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  415. package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  416. package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  417. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
  418. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  419. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  420. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  421. package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
  422. package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  423. package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  424. package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  425. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
  426. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  427. package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
  428. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
  429. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
  430. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  431. package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
  432. package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
  433. package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
  434. package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
  435. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
  436. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
  437. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  438. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
  439. package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  440. package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  441. package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
  442. package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  443. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  444. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  445. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  446. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  447. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  448. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  449. package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
  450. package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
  451. package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
  452. package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
  453. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  454. package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
  455. package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
  456. package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  457. package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  458. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
  459. package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
  460. package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
  461. package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
  462. package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
  463. package/.versions/0.0.8/.version +1 -0
  464. package/.versions/0.0.8/agents/architect.md +23 -0
  465. package/.versions/0.0.8/agents/bowser.md +26 -0
  466. package/.versions/0.0.8/agents/builder.md +53 -0
  467. package/.versions/0.0.8/agents/code-reviewer.md +205 -0
  468. package/.versions/0.0.8/agents/deep-researcher.md +31 -0
  469. package/.versions/0.0.8/agents/documenter.md +18 -0
  470. package/.versions/0.0.8/agents/orchestrator.md +65 -0
  471. package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
  472. package/.versions/0.0.8/agents/planner.md +69 -0
  473. package/.versions/0.0.8/agents/releaser.md +24 -0
  474. package/.versions/0.0.8/agents/researcher.md +28 -0
  475. package/.versions/0.0.8/agents/security-auditor.md +166 -0
  476. package/.versions/0.0.8/agents/test-engineer.md +151 -0
  477. package/.versions/0.0.8/agents/web-debugger.md +42 -0
  478. package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
  479. package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
  480. package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
  481. package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
  482. package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
  483. package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
  484. package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
  485. package/.versions/0.0.8/docs/getting-started.md +231 -0
  486. package/.versions/0.0.8/docs/npm-install.md +337 -0
  487. package/.versions/0.0.8/docs/opencode-setup.md +249 -0
  488. package/.versions/0.0.8/docs/pi-extensions.md +293 -0
  489. package/.versions/0.0.8/docs/pi-setup.md +476 -0
  490. package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
  491. package/.versions/0.0.8/hermes/README.md +347 -0
  492. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  493. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  494. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  495. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  496. package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
  497. package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
  498. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  499. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  500. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  501. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  502. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  503. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  504. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  505. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  506. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  507. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  508. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  509. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  510. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  511. package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
  512. package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
  513. package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
  514. package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
  515. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  516. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  517. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  518. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  519. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  520. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  521. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  522. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  523. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  524. package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
  525. package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
  526. package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
  527. package/.versions/0.0.8/hooks/hooks.json +14 -0
  528. package/.versions/0.0.8/hooks/session-start.sh +74 -0
  529. package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
  530. package/.versions/0.0.8/justfile +245 -0
  531. package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
  532. package/.versions/0.0.8/references/definition-of-done.md +67 -0
  533. package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
  534. package/.versions/0.0.8/references/observability-checklist.md +91 -0
  535. package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
  536. package/.versions/0.0.8/references/performance-checklist.md +153 -0
  537. package/.versions/0.0.8/references/prompting-patterns.md +380 -0
  538. package/.versions/0.0.8/references/security-checklist.md +179 -0
  539. package/.versions/0.0.8/references/testing-patterns.md +236 -0
  540. package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
  541. package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
  542. package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
  543. package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
  544. package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
  545. package/.versions/0.0.8/scripts/fleet.ts +149 -0
  546. package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
  547. package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
  548. package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
  549. package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
  550. package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
  551. package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
  552. package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
  553. package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
  554. package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
  555. package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
  556. package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
  557. package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
  558. package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
  559. package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
  560. package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
  561. package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
  562. package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
  563. package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
  564. package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
  565. package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
  566. package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
  567. package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
  568. package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
  569. package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
  570. package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
  571. package/.versions/0.0.8/scripts/team-up.ts +360 -0
  572. package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
  573. package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
  574. package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
  575. package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
  576. package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
  577. package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
  578. package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
  579. package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  580. package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  581. package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  582. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
  583. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
  584. package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
  585. package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
  586. package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
  587. package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  588. package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  589. package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
  590. package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
  591. package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
  592. package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
  593. package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
  594. package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
  595. package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
  596. package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
  597. package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
  598. package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  599. package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  600. package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
  601. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  602. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  603. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  604. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  605. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  606. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  607. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  608. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  609. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  610. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  611. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  612. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  613. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  614. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  615. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  616. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  617. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  618. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  619. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  620. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  621. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  622. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  623. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  624. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  625. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  626. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  627. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  628. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  629. package/CHANGELOG.md +140 -0
  630. package/README.md +175 -18
  631. package/agents/code-reviewer.md +2 -2
  632. package/agents/orchestrator.md +11 -0
  633. package/agents/plan-reviewer.md +1 -1
  634. package/agents/planner.md +1 -1
  635. package/agents/security-auditor.md +1 -1
  636. package/bin/cli.js +40 -1
  637. package/bin/lib/hermes-profile-artifact.js +144 -0
  638. package/bin/lib/set-hermes-watchdog.js +173 -0
  639. package/bin/set-hermes-watchdog.js +26 -0
  640. package/docs/ARCHITECTURE.md +64 -12
  641. package/docs/agent-fleet-setup.md +2 -2
  642. package/docs/claude-code-coms-bridge.md +7 -1
  643. package/docs/coms-hermes-bridge.md +10 -0
  644. package/docs/getting-started.md +48 -0
  645. package/docs/hermes-watchdog-supervisor.md +140 -0
  646. package/hermes/README.md +135 -19
  647. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  648. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  649. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  650. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  651. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  652. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  653. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  654. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  655. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  656. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  657. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  658. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  659. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  660. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  661. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  662. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  663. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  664. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  665. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  666. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  667. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  668. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  669. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  670. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  671. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  672. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  673. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  674. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  675. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  676. package/hooks/coms-stop-hook.mjs +12 -1
  677. package/package.json +11 -2
  678. package/scripts/coms-claude-bridge.ts +154 -39
  679. package/scripts/fleet.ts +9 -1
  680. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  681. package/scripts/lib/claude-bridge-core.ts +65 -0
  682. package/scripts/lib/coms-envelope.ts +44 -1
  683. package/scripts/lib/hermes-monitor-events.ts +1 -0
  684. package/scripts/lib/monitor-env.ts +120 -0
  685. package/scripts/team-snapshot.ts +1 -1
  686. package/scripts/team-up.ts +10 -1
  687. package/skills/guided-workspace-setup/companion-manifest.json +1 -0
  688. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  689. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  690. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  691. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  692. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  693. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  694. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  695. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  696. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  697. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  698. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  699. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  700. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  701. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  702. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  703. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  704. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  705. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  706. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  707. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  708. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  709. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  710. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  711. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  712. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  713. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  714. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  715. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  716. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  717. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
@@ -0,0 +1,9 @@
1
+ {
2
+ "name": "agent-fleet-pi-extensions-runtime-deps",
3
+ "private": true,
4
+ "type": "module",
5
+ "dependencies": {
6
+ "@modelcontextprotocol/sdk": "^1.29.0",
7
+ "typebox": "^1.1.33"
8
+ }
9
+ }
@@ -0,0 +1,201 @@
1
+ # pi-voice-stt
2
+
3
+ Push-to-talk voice dictation for pi's terminal UI. Press a hotkey, speak, and the
4
+ transcript is inserted into the prompt — or transcribed and sent in one step.
5
+
6
+ A simplified, self-contained port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt),
7
+ trimmed to **two** transcription backends and adapted to this repo's pi runtime.
8
+
9
+ ## How it works
10
+
11
+ The mic is recorded to a temporary 16 kHz mono PCM WAV via `ffmpeg`, the WAV is sent to
12
+ the configured provider, and the returned text goes into the editor. There is no native
13
+ dependency and no build step — pi loads the TypeScript directly.
14
+
15
+ ## Controls
16
+
17
+ | Key / command | Action |
18
+ | --- | --- |
19
+ | **Alt+S** | Start recording; press again to **transcribe and insert** into the prompt |
20
+ | **Enter** (while recording) | Transcribe and **send** immediately |
21
+ | **Esc** (while recording) | Cancel — discard the recording |
22
+ | `/af-stt status` | Show config + current state |
23
+ | `/af-stt doctor` | Check `ffmpeg`, provider, and API key |
24
+ | `/af-stt start` · `stop` · `send` · `cancel` | Drive the state machine without the hotkey |
25
+
26
+ While recording, a `● REC m:ss` indicator animates in the status bar; during transcription
27
+ it shows a moving `transcribing…` dot.
28
+
29
+ > The hotkey is bound **only when a provider is configured**. Until then the extension is a
30
+ > silent no-op — `/af-stt doctor` still works to guide setup.
31
+
32
+ ## Requirements
33
+
34
+ - `ffmpeg` on `PATH` (or set `capture.ffmpegPath`).
35
+ - A configured provider (below).
36
+
37
+ ## Configuration
38
+
39
+ Config is resolved in this order (first hit wins):
40
+
41
+ 1. `PI_STT_CONFIG` — inline JSON (starts with `{`) or a path to a JSON file
42
+ 2. `<cwd>/.ai/stt.json` — project-local config (what guided setup writes)
43
+ 3. `~/.pi/agent/stt.json` — global config
44
+ 4. built-in defaults
45
+
46
+ Secrets are **never** stored in the file: the config names an environment variable and the
47
+ key is read from the process environment — a gitignored `.env` at the repo root, auto-loaded by
48
+ the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
49
+
50
+ > **Guided setup** can write the `.ai/stt.json` + `.env` for you — pick `pi-voice-stt` in
51
+ > `/af-setup-agent-fleet` and answer the provider prompts. See
52
+ > [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
53
+
54
+ ### Option 1 — Generic OpenAI-compatible endpoint
55
+
56
+ Works with OpenAI Whisper, Groq, and local servers (`whisper.cpp`, `faster-whisper`) that
57
+ expose `POST /v1/audio/transcriptions`.
58
+
59
+ ```json
60
+ {
61
+ "language": "en-US",
62
+ "provider": {
63
+ "type": "openai",
64
+ "baseUrl": "https://api.openai.com/v1",
65
+ "model": "whisper-1",
66
+ "apiKeyEnv": "OPENAI_API_KEY"
67
+ }
68
+ }
69
+ ```
70
+
71
+ Point `baseUrl` at `http://127.0.0.1:8080/v1` for a local server — plain HTTP is allowed for
72
+ loopback hosts only; everything else must be HTTPS.
73
+
74
+ ### Option 2 — Azure Speech (speech-to-text)
75
+
76
+ Uses the Azure [REST API for short audio](https://learn.microsoft.com/azure/ai-services/speech-service/rest-speech-to-text-short)
77
+ (≤ 60 s per utterance, final result only). The recorder already produces the required
78
+ 16 kHz mono PCM WAV.
79
+
80
+ ```json
81
+ {
82
+ "language": "en-US",
83
+ "provider": {
84
+ "type": "azure",
85
+ "endpoint": "https://<resource>.cognitiveservices.azure.com",
86
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
87
+ "format": "detailed"
88
+ }
89
+ }
90
+ ```
91
+
92
+ Then set the secrets in your environment:
93
+
94
+ ```sh
95
+ export AZURE_SPEECH_ENDPOINT="https://<resource>.cognitiveservices.azure.com" # used if `endpoint` is omitted
96
+ export AZURE_SPEECH_KEY="<your-resource-key>"
97
+ ```
98
+
99
+ The request posts the WAV to
100
+ `{endpoint}/af-stt/speech/recognition/conversation/cognitiveservices/v1?language=<lang>&format=<format>`
101
+ with the `Ocp-Apim-Subscription-Key` header. `format: "detailed"` returns the best
102
+ `NBest[0].Display`; `"simple"` returns `DisplayText`.
103
+
104
+ #### Azure language identification (mixed languages)
105
+
106
+ To let Azure auto-detect the language, add `locales` (candidate locales). The provider then
107
+ switches to the **Fast Transcription API** (`/speechtotext/transcriptions:transcribe`), which
108
+ runs per-phrase language identification:
109
+
110
+ ```json
111
+ {
112
+ "provider": {
113
+ "type": "azure",
114
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
115
+ "locales": ["bg-BG", "en-US"],
116
+ "apiVersion": "2024-11-15"
117
+ }
118
+ }
119
+ ```
120
+
121
+ Identification is **phrase-level, not word-level** — a single English word inside a Bulgarian
122
+ sentence may still be transliterated. For true intra-sentence code-switching with English in
123
+ Latin script, use a Whisper backend (Option 1 or Option 3) instead. Omit `locales` to keep the
124
+ single-language short-audio behaviour.
125
+
126
+ ### Option 3 — Azure OpenAI Whisper (Azure AI Foundry)
127
+
128
+ Whisper hosted on Azure OpenAI / Azure AI Foundry. Same Whisper model as Option 1 (so it keeps
129
+ mixed Bulgarian + English in the right scripts), but served from your Azure resource — and a
130
+ multi-service Azure AI Services resource can reuse the **same key** as Azure Speech.
131
+
132
+ ```json
133
+ {
134
+ "language": "bg-BG",
135
+ "provider": {
136
+ "type": "azure-openai",
137
+ "endpoint": "https://<resource>.openai.azure.com",
138
+ "deployment": "gpt-4o-transcribe",
139
+ "apiVersion": "2025-03-01-preview",
140
+ "apiKeyEnv": "AZURE_SPEECH_KEY"
141
+ }
142
+ }
143
+ ```
144
+
145
+ The request posts the WAV (multipart) to
146
+ `{endpoint}/openai/deployments/{deployment}/audio/transcriptions?api-version={apiVersion}` with
147
+ the **`api-key`** header. `deployment` is the deployment name from Azure AI Foundry → Deployments.
148
+
149
+ **Model choice.** Both `whisper` and the newer `gpt-4o-transcribe` work via this provider:
150
+ - `gpt-4o-transcribe` (GlobalStandard) — recommended; higher capacity/quota and good mixed
151
+ Bulgarian + English (English terms stay in Latin). Needs a recent `apiVersion`
152
+ (e.g. `2025-03-01-preview`).
153
+ - `whisper` — works with `apiVersion: "2024-10-21"`, but low-capacity deployments can be flaky
154
+ (intermittent `404 DeploymentNotFound`); the provider retries those automatically.
155
+
156
+ > **Use the legacy data-plane host, not the Foundry endpoint.** Audio transcription is **not**
157
+ > served by the Foundry `https://<resource>.services.ai.azure.com` (`/openai/v1`) endpoint — that
158
+ > returns `404 DeploymentNotFound`. Use `https://<resource>.openai.azure.com` (or
159
+ > `…cognitiveservices.azure.com`). The `apiVersion` also matters: a recent GA version like
160
+ > `2024-10-21` works; older ones (e.g. `2024-06-01`) can 404. If omitted, `endpoint` falls back to
161
+ > `AZURE_OPENAI_ENDPOINT`.
162
+
163
+ Whisper accepts longer audio than the short-audio REST (up to ~25 MB), so `capture.maxSeconds`
164
+ can be raised.
165
+
166
+ ### All options
167
+
168
+ | Key | Default | Notes |
169
+ | --- | --- | --- |
170
+ | `keybind` | `alt+s` | Any pi key id; override per-run with `PI_STT_KEYBIND` |
171
+ | `language` | `en-US` | BCP-47 locale (OpenAI receives the language part only) |
172
+ | `capture.ffmpegPath` | `ffmpeg` | Path to the ffmpeg binary |
173
+ | `capture.inputFormat` / `capture.input` | per-platform | ffmpeg `-f` / `-i` (avfoundation/pulse/dshow defaults) |
174
+ | `capture.sampleRate` / `capture.channels` | `16000` / `1` | Keep at 16 kHz mono for Azure |
175
+ | `capture.maxSeconds` | `60` | Hard cap; Azure short-audio rejects longer clips |
176
+ | `capture.minBytes` | `2048` | Reject empty/too-short captures |
177
+ | `provider.apiKeyEnv` | `OPENAI_API_KEY` / `AZURE_SPEECH_KEY` / `AZURE_OPENAI_API_KEY` | Env var holding the key |
178
+
179
+ ## Troubleshooting
180
+
181
+ - **`/af-stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
182
+ - **Linux: no audio** — ensure PulseAudio/PipeWire is running; try `capture.input` of a
183
+ specific source name from `pactl list sources short`.
184
+ - **Azure `NoMatch`** — the spoken language doesn't match `language`; fix the locale.
185
+ - **Azure OpenAI `404 DeploymentNotFound`** — usually **not** the deployment name: check that
186
+ `endpoint` is the legacy `*.openai.azure.com` / `*.cognitiveservices.azure.com` host (not the
187
+ Foundry `*.services.ai.azure.com`), and that `apiVersion` is recent (`2024-10-21`, not
188
+ `2024-06-01`). Only after those, verify the `deployment` name in Azure AI Foundry → Deployments.
189
+ - **Intermittent `404 DeploymentNotFound` (some requests succeed, most fail)** — the deployment is
190
+ still propagating (freshly created) or has near-zero capacity. The extension already retries
191
+ transient 404/429/5xx up to 3×, but if it stays flaky for long, wait for provisioning to settle,
192
+ raise the deployment's capacity/quota (its **Requests-per-Minute** limit may be very low), or
193
+ delete and recreate the deployment.
194
+ - **Recording too short** — speak before the indicator clears, or lower `capture.minBytes`.
195
+
196
+ ## Attribution
197
+
198
+ Ported and simplified from [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt).
199
+ Only the OpenAI-compatible, Azure Speech, and Azure OpenAI Whisper backends are included; the
200
+ other upstream providers, macOS Keychain lookup, and streaming/interim results are out of scope
201
+ here.
@@ -0,0 +1,198 @@
1
+ // Configuration loading and validation for the pi-voice-stt extension.
2
+ //
3
+ // Resolution order (first hit wins):
4
+ // 1. PI_STT_CONFIG — inline JSON (starts with "{") or a path to a JSON file
5
+ // 2. <cwd>/.ai/stt.json — project-local config (written by guided setup)
6
+ // 3. ~/.pi/agent/stt.json — global config
7
+ // 4. built-in defaults
8
+ //
9
+ // Secrets are never stored in the config file: the config names an environment
10
+ // variable (apiKeyEnv) and the key is read from the process environment (a
11
+ // gitignored .env at the repo root, auto-loaded by the justfile's dotenv-load).
12
+
13
+ import { readFileSync } from "node:fs";
14
+ import { homedir } from "node:os";
15
+ import path from "node:path";
16
+
17
+ export interface CaptureConfig {
18
+ ffmpegPath?: string;
19
+ /** ffmpeg -f input format. Defaults per-platform (avfoundation/pulse/dshow). */
20
+ inputFormat?: string;
21
+ /** ffmpeg -i input device. Defaults per-platform. */
22
+ input?: string;
23
+ sampleRate?: number;
24
+ channels?: number;
25
+ /** Hard cap on recording length. Azure REST short-audio rejects >60s. */
26
+ maxSeconds?: number;
27
+ /** Reject recordings whose WAV is smaller than this (treat as "no audio"). */
28
+ minBytes?: number;
29
+ }
30
+
31
+ export interface OpenAIProvider {
32
+ type: "openai" | "openai-compatible";
33
+ /** Any OpenAI-compatible base, e.g. http://127.0.0.1:8080/v1 for local whisper. */
34
+ baseUrl?: string;
35
+ model?: string;
36
+ apiKeyEnv?: string;
37
+ }
38
+
39
+ export interface AzureProvider {
40
+ type: "azure";
41
+ /** Resource endpoint, e.g. https://<resource>.cognitiveservices.azure.com */
42
+ endpoint?: string;
43
+ /** Env var to read the endpoint from when `endpoint` is unset. */
44
+ endpointEnv?: string;
45
+ apiKeyEnv?: string;
46
+ format?: "simple" | "detailed";
47
+ /**
48
+ * Candidate locales for the Fast Transcription API's per-phrase language
49
+ * identification, e.g. ["bg-BG", "en-US"]. When set, the provider uses the
50
+ * Fast Transcription endpoint instead of the single-language short-audio REST.
51
+ * Note: identification is phrase-level, not word-level.
52
+ */
53
+ locales?: string[];
54
+ /** Fast Transcription API version (only used when `locales` is set). */
55
+ apiVersion?: string;
56
+ }
57
+
58
+ export interface AzureOpenAIProvider {
59
+ type: "azure-openai";
60
+ /** Resource endpoint, e.g. https://<resource>.services.ai.azure.com (Azure AI Foundry)
61
+ * or https://<resource>.openai.azure.com (Azure OpenAI). */
62
+ endpoint?: string;
63
+ /** Env var to read the endpoint from when `endpoint` is unset (default AZURE_OPENAI_ENDPOINT). */
64
+ endpointEnv?: string;
65
+ /** Whisper deployment name as configured in Azure AI Foundry / Azure OpenAI. */
66
+ deployment: string;
67
+ /** Azure OpenAI data-plane API version. */
68
+ apiVersion?: string;
69
+ apiKeyEnv?: string;
70
+ /** Optional; the deployment already pins the model, so usually omitted. */
71
+ model?: string;
72
+ }
73
+
74
+ export type Provider = OpenAIProvider | AzureProvider | AzureOpenAIProvider;
75
+
76
+ export interface SttConfig {
77
+ keybind: string;
78
+ language: string;
79
+ capture: CaptureConfig;
80
+ provider?: Provider;
81
+ }
82
+
83
+ export interface LoadedConfig {
84
+ config: SttConfig;
85
+ /** Human-readable description of where the config came from. */
86
+ source: string;
87
+ }
88
+
89
+ const DEFAULTS: SttConfig = {
90
+ keybind: "alt+s",
91
+ language: "en-US",
92
+ capture: {
93
+ sampleRate: 16000,
94
+ channels: 1,
95
+ maxSeconds: 60,
96
+ minBytes: 2048,
97
+ },
98
+ };
99
+
100
+ function readConfigFile(): { raw: unknown; source: string } | undefined {
101
+ const fromEnv = process.env.PI_STT_CONFIG?.trim();
102
+ if (fromEnv) {
103
+ if (fromEnv.startsWith("{")) {
104
+ return { raw: JSON.parse(fromEnv), source: "PI_STT_CONFIG (inline)" };
105
+ }
106
+ const resolved = path.resolve(fromEnv);
107
+ return { raw: JSON.parse(readFileSync(resolved, "utf8")), source: resolved };
108
+ }
109
+
110
+ // Project-local config in the target repo's .ai/ dir takes precedence over the
111
+ // global one, so a per-project STT setup wins when pi runs inside that repo.
112
+ const candidates = [
113
+ path.resolve(process.cwd(), ".ai", "stt.json"),
114
+ path.join(homedir(), ".pi", "agent", "stt.json"),
115
+ ];
116
+ for (const file of candidates) {
117
+ try {
118
+ return { raw: JSON.parse(readFileSync(file, "utf8")), source: file };
119
+ } catch {
120
+ // not present / unreadable — try the next candidate
121
+ }
122
+ }
123
+ return undefined;
124
+ }
125
+
126
+ /** Drop the documentation-only `_azureExample` block and other `_`-prefixed keys. */
127
+ function stripComments(obj: Record<string, unknown>): Record<string, unknown> {
128
+ const out: Record<string, unknown> = {};
129
+ for (const [k, v] of Object.entries(obj)) {
130
+ if (!k.startsWith("_")) out[k] = v;
131
+ }
132
+ return out;
133
+ }
134
+
135
+ export function loadConfig(): LoadedConfig {
136
+ const file = readConfigFile();
137
+ const fromFile = file && typeof file.raw === "object" && file.raw
138
+ ? stripComments(file.raw as Record<string, unknown>)
139
+ : {};
140
+
141
+ const config: SttConfig = {
142
+ keybind: (process.env.PI_STT_KEYBIND?.trim() || (fromFile.keybind as string) || DEFAULTS.keybind),
143
+ language: ((fromFile.language as string) || DEFAULTS.language),
144
+ capture: { ...DEFAULTS.capture, ...(fromFile.capture as CaptureConfig | undefined) },
145
+ provider: fromFile.provider as Provider | undefined,
146
+ };
147
+
148
+ return { config, source: file?.source ?? "defaults (no config file)" };
149
+ }
150
+
151
+ /** The env var that holds the API key for a provider, with sensible defaults. */
152
+ export function apiKeyEnvName(provider: Provider): string {
153
+ if (provider.apiKeyEnv) return provider.apiKeyEnv;
154
+ switch (provider.type) {
155
+ case "azure":
156
+ return "AZURE_SPEECH_KEY";
157
+ case "azure-openai":
158
+ return "AZURE_OPENAI_API_KEY";
159
+ default:
160
+ return "OPENAI_API_KEY";
161
+ }
162
+ }
163
+
164
+ export function resolveApiKey(provider: Provider): string | undefined {
165
+ const value = process.env[apiKeyEnvName(provider)]?.trim();
166
+ return value || undefined;
167
+ }
168
+
169
+ /** Resolve an Azure resource endpoint (Speech or OpenAI) from config or environment. */
170
+ export function resolveAzureEndpoint(provider: AzureProvider | AzureOpenAIProvider): string | undefined {
171
+ if (provider.endpoint?.trim()) return provider.endpoint.trim();
172
+ const fallbackEnv = provider.type === "azure-openai" ? "AZURE_OPENAI_ENDPOINT" : "AZURE_SPEECH_ENDPOINT";
173
+ const envName = provider.endpointEnv?.trim() || fallbackEnv;
174
+ return process.env[envName]?.trim() || undefined;
175
+ }
176
+
177
+ /** True when a provider is present AND its API key is available in the environment. */
178
+ export function isConfigured(config: SttConfig): boolean {
179
+ const provider = config.provider;
180
+ if (!provider) return false;
181
+ if (!resolveApiKey(provider)) return false;
182
+ if (provider.type === "azure" && !resolveAzureEndpoint(provider)) return false;
183
+ if (provider.type === "azure-openai" && (!resolveAzureEndpoint(provider) || !provider.deployment)) return false;
184
+ return true;
185
+ }
186
+
187
+ const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "::1", "[::1]"]);
188
+
189
+ /**
190
+ * HTTPS-by-default endpoint policy: plain HTTP is allowed only for loopback hosts
191
+ * (local whisper servers). Throws on any other insecure URL.
192
+ */
193
+ export function assertSafeUrl(url: string): URL {
194
+ const parsed = new URL(url);
195
+ if (parsed.protocol === "https:") return parsed;
196
+ if (parsed.protocol === "http:" && LOOPBACK_HOSTS.has(parsed.hostname)) return parsed;
197
+ throw new Error(`Insecure endpoint not allowed (use HTTPS, or loopback for local servers): ${url}`);
198
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "keybind": "alt+s",
3
+ "language": "en-US",
4
+ "capture": {
5
+ "maxSeconds": 60
6
+ },
7
+ "provider": {
8
+ "type": "openai",
9
+ "baseUrl": "https://api.openai.com/v1",
10
+ "model": "whisper-1",
11
+ "apiKeyEnv": "OPENAI_API_KEY"
12
+ },
13
+
14
+ "_azureExample": {
15
+ "type": "azure",
16
+ "endpoint": "https://fd-ai-credits.cognitiveservices.azure.com",
17
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
18
+ "format": "detailed"
19
+ },
20
+
21
+ "_azureLanguageIdExample": {
22
+ "type": "azure",
23
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
24
+ "locales": ["bg-BG", "en-US"],
25
+ "apiVersion": "2024-11-15"
26
+ },
27
+
28
+ "_azureOpenAIExample": {
29
+ "type": "azure-openai",
30
+ "endpoint": "https://<resource>.openai.azure.com",
31
+ "deployment": "gpt-4o-transcribe",
32
+ "apiVersion": "2025-03-01-preview",
33
+ "apiKeyEnv": "AZURE_SPEECH_KEY"
34
+ }
35
+ }
@@ -0,0 +1,248 @@
1
+ // pi-voice-stt — push-to-talk dictation for pi's terminal UI.
2
+ //
3
+ // Press Alt+S to start recording, Alt+S again to transcribe and insert the text
4
+ // into the prompt. While recording, Enter transcribes and sends immediately, and
5
+ // Esc cancels. The extension is a silent no-op until a provider is configured —
6
+ // see README.md and `/af-stt doctor`.
7
+
8
+ import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
9
+ import { matchesKey } from "@mariozechner/pi-tui";
10
+ import { spawn } from "node:child_process";
11
+ import { apiKeyEnvName, isConfigured, loadConfig, resolveAzureEndpoint } from "./config.js";
12
+ import { transcribe } from "./providers.js";
13
+ import { Recorder } from "./recorder.js";
14
+
15
+ const STATUS_KEY = "voice-stt";
16
+
17
+ type State = "idle" | "recording" | "transcribing";
18
+
19
+ export default function voiceSttExtension(pi: ExtensionAPI): void {
20
+ const { config, source } = loadConfig();
21
+
22
+ let state: State = "idle";
23
+ let recorder: Recorder | undefined;
24
+ let recordStart = 0;
25
+ let tick = 0;
26
+ let anim: ReturnType<typeof setInterval> | undefined;
27
+ let unsubInput: (() => void) | undefined;
28
+
29
+ // ---- indicator ---------------------------------------------------------
30
+
31
+ function renderFrame(): string {
32
+ if (state === "recording") {
33
+ const secs = Math.max(0, Math.floor((Date.now() - recordStart) / 1000));
34
+ const clock = `${Math.floor(secs / 60)}:${String(secs % 60).padStart(2, "0")}`;
35
+ const dot = tick % 2 === 0 ? "●" : "○";
36
+ return `${dot} REC ${clock} ⏎ send · esc cancel`;
37
+ }
38
+ const frames = ["· ", " · ", " ·", " · "];
39
+ return `${frames[tick % frames.length]} transcribing…`;
40
+ }
41
+
42
+ function startAnim(ctx: ExtensionContext): void {
43
+ stopAnimTimer();
44
+ anim = setInterval(() => {
45
+ tick++;
46
+ ctx.ui.setStatus(STATUS_KEY, renderFrame());
47
+ }, 120);
48
+ anim.unref?.();
49
+ ctx.ui.setStatus(STATUS_KEY, renderFrame());
50
+ }
51
+
52
+ function stopAnimTimer(): void {
53
+ if (anim) {
54
+ clearInterval(anim);
55
+ anim = undefined;
56
+ }
57
+ }
58
+
59
+ function reset(ctx: ExtensionContext): void {
60
+ state = "idle";
61
+ stopAnimTimer();
62
+ ctx.ui.setStatus(STATUS_KEY, undefined);
63
+ }
64
+
65
+ // ---- state machine -----------------------------------------------------
66
+
67
+ function startRecording(ctx: ExtensionContext): void {
68
+ if (state !== "idle") return;
69
+ if (!isConfigured(config)) {
70
+ ctx.ui.notify("Voice STT is not configured — run /af-stt doctor for setup help.", "warning");
71
+ return;
72
+ }
73
+
74
+ recorder = new Recorder(config.capture);
75
+ try {
76
+ recorder.start();
77
+ } catch (error) {
78
+ recorder = undefined;
79
+ ctx.ui.notify(`Could not start ffmpeg: ${describe(error)}`, "error");
80
+ return;
81
+ }
82
+
83
+ state = "recording";
84
+ recordStart = Date.now();
85
+ startAnim(ctx);
86
+
87
+ // While recording, intercept Enter (send) and Esc (cancel); let other keys through.
88
+ unsubInput = ctx.ui.onTerminalInput((data) => {
89
+ if (state !== "recording") return undefined;
90
+ if (matchesKey(data, "enter")) {
91
+ void finish(ctx, true);
92
+ return { consume: true };
93
+ }
94
+ if (matchesKey(data, "escape")) {
95
+ cancel(ctx);
96
+ return { consume: true };
97
+ }
98
+ return undefined;
99
+ });
100
+ }
101
+
102
+ async function finish(ctx: ExtensionContext, send: boolean): Promise<void> {
103
+ if (state !== "recording" || !recorder) return;
104
+ const active = recorder;
105
+ state = "transcribing";
106
+ unsubInput?.();
107
+ unsubInput = undefined;
108
+ startAnim(ctx);
109
+
110
+ try {
111
+ const wavPath = await active.stop();
112
+ const text = await transcribe(wavPath, config);
113
+ active.cleanup();
114
+
115
+ if (send) {
116
+ const existing = ctx.ui.getEditorText().trim();
117
+ const content = existing ? `${existing} ${text}` : text;
118
+ ctx.ui.setEditorText("");
119
+ pi.sendUserMessage(content);
120
+ } else {
121
+ const current = ctx.ui.getEditorText();
122
+ const sep = current.length > 0 && !/\s$/.test(current) ? " " : "";
123
+ ctx.ui.setEditorText(`${current}${sep}${text}`);
124
+ }
125
+ } catch (error) {
126
+ active.cleanup();
127
+ ctx.ui.notify(`Voice STT: ${describe(error)}`, "error");
128
+ } finally {
129
+ recorder = undefined;
130
+ reset(ctx);
131
+ }
132
+ }
133
+
134
+ function cancel(ctx: ExtensionContext): void {
135
+ unsubInput?.();
136
+ unsubInput = undefined;
137
+ recorder?.cancel();
138
+ recorder = undefined;
139
+ reset(ctx);
140
+ ctx.ui.notify("Voice capture cancelled.", "info");
141
+ }
142
+
143
+ // ---- commands ----------------------------------------------------------
144
+
145
+ pi.registerCommand("af-stt", {
146
+ description: "Voice dictation: status | doctor | start | stop | send | cancel",
147
+ handler: async (args: string, ctx: ExtensionCommandContext) => {
148
+ const sub = args.trim().split(/\s+/)[0]?.toLowerCase() || "status";
149
+ switch (sub) {
150
+ case "status":
151
+ ctx.ui.notify(statusLine(), "info");
152
+ return;
153
+ case "doctor":
154
+ await runDoctor(ctx);
155
+ return;
156
+ case "start":
157
+ startRecording(ctx);
158
+ return;
159
+ case "stop":
160
+ await finish(ctx, false);
161
+ return;
162
+ case "send":
163
+ await finish(ctx, true);
164
+ return;
165
+ case "cancel":
166
+ if (state === "idle") ctx.ui.notify("Nothing to cancel.", "info");
167
+ else cancel(ctx);
168
+ return;
169
+ default:
170
+ ctx.ui.notify(`Unknown /af-stt subcommand: ${sub}`, "warning");
171
+ }
172
+ },
173
+ });
174
+
175
+ // Only bind the hotkey once a provider is configured — keeps the extension a
176
+ // true no-op for users who haven't set it up.
177
+ if (isConfigured(config)) {
178
+ pi.registerShortcut(config.keybind, {
179
+ description: "Voice dictation: toggle recording (insert); Enter sends, Esc cancels",
180
+ handler: async (ctx) => {
181
+ if (state === "idle") startRecording(ctx);
182
+ else if (state === "recording") await finish(ctx, false);
183
+ // transcribing: ignore
184
+ },
185
+ });
186
+ }
187
+
188
+ pi.on("session_shutdown", async () => {
189
+ stopAnimTimer();
190
+ recorder?.cancel();
191
+ recorder = undefined;
192
+ unsubInput?.();
193
+ unsubInput = undefined;
194
+ });
195
+
196
+ // ---- helpers -----------------------------------------------------------
197
+
198
+ function statusLine(): string {
199
+ const provider = config.provider ? config.provider.type : "none";
200
+ const ready = isConfigured(config) ? "configured" : "NOT configured";
201
+ return `Voice STT: ${ready} · provider=${provider} · keybind=${config.keybind} · state=${state} · config=${source}`;
202
+ }
203
+
204
+ async function runDoctor(ctx: ExtensionCommandContext): Promise<void> {
205
+ const lines: string[] = [];
206
+ const ffmpeg = config.capture.ffmpegPath ?? "ffmpeg";
207
+ lines.push((await hasFfmpeg(ffmpeg)) ? `✓ ffmpeg found (${ffmpeg})` : `✗ ffmpeg not found — install it and ensure it is on PATH`);
208
+
209
+ if (!config.provider) {
210
+ lines.push("✗ no provider configured — see .pi/extensions/pi-voice-stt/README.md");
211
+ } else {
212
+ lines.push(`• provider: ${config.provider.type}`);
213
+ const keyEnv = apiKeyEnvName(config.provider);
214
+ lines.push(process.env[keyEnv]?.trim() ? `✓ API key present (${keyEnv})` : `✗ API key missing — set ${keyEnv}`);
215
+ if (config.provider.type === "azure") {
216
+ const ep = resolveAzureEndpoint(config.provider);
217
+ lines.push(ep ? `✓ Azure endpoint: ${ep}` : "✗ Azure endpoint missing — set `endpoint` or AZURE_SPEECH_ENDPOINT");
218
+ }
219
+ if (config.provider.type === "azure-openai") {
220
+ const ep = resolveAzureEndpoint(config.provider);
221
+ lines.push(ep ? `✓ endpoint: ${ep}` : "✗ endpoint missing — set `endpoint` or AZURE_OPENAI_ENDPOINT");
222
+ if (ep && /\.services\.ai\.azure\.com/i.test(ep)) {
223
+ lines.push("⚠ Foundry host does not serve audio — use *.openai.azure.com / *.cognitiveservices.azure.com");
224
+ }
225
+ lines.push(config.provider.deployment ? `✓ deployment: ${config.provider.deployment}` : "✗ deployment missing — set the Whisper deployment name");
226
+ lines.push(`• api-version: ${config.provider.apiVersion ?? "2024-10-21"}`);
227
+ }
228
+ }
229
+ lines.push(`config source: ${source}`);
230
+ ctx.ui.notify(lines.join("\n"), isConfigured(config) ? "info" : "warning");
231
+ }
232
+ }
233
+
234
+ function hasFfmpeg(bin: string): Promise<boolean> {
235
+ return new Promise((resolve) => {
236
+ try {
237
+ const proc = spawn(bin, ["-version"], { stdio: "ignore" });
238
+ proc.once("error", () => resolve(false));
239
+ proc.once("close", (code) => resolve(code === 0));
240
+ } catch {
241
+ resolve(false);
242
+ }
243
+ });
244
+ }
245
+
246
+ function describe(error: unknown): string {
247
+ return error instanceof Error ? error.message : String(error);
248
+ }