@chankov/agent-fleet 2.0.9 → 2.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (465) hide show
  1. package/.pi/extensions/pi-voice-stt/README.md +24 -5
  2. package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
  3. package/.pi/harnesses/agent-hub/package.json +1 -1
  4. package/.pi/harnesses/agent-hub/return-contract.js +34 -0
  5. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +80 -18
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  9. package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
  10. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  11. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  12. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  13. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  14. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  15. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  16. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  17. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  18. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  19. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  20. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  21. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  22. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  23. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  24. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  25. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  26. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  27. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  28. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  29. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  30. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  31. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  32. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  33. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  34. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  35. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  36. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  37. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  38. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  39. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  40. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  41. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  42. package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  43. package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  44. package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  45. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  46. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  47. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  48. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  49. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  50. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
  51. package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
  52. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  53. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  54. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  55. package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  56. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  57. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  58. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  59. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  60. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  61. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  62. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  63. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  64. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  65. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  66. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  67. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  68. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  69. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  70. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  71. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  72. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  73. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  74. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  75. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  76. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  77. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  78. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  79. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  80. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  81. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  82. package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
  83. package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
  84. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  85. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  86. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  87. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
  88. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  89. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  90. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  91. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  92. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  93. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  94. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  95. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  96. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  97. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  98. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  99. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  100. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  101. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  102. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  103. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  104. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  105. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  106. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  107. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  108. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  109. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  110. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  111. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  112. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  113. package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  114. package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
  115. package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
  116. package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
  117. package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
  118. package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
  119. package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
  120. package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
  121. package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
  122. package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
  123. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  124. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  125. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  126. package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  127. package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  128. package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  129. package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  130. package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  131. package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  132. package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
  133. package/.versions/2.0.10/.pi/extensions/package.json +9 -0
  134. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
  135. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  136. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  137. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  138. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  139. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  140. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  141. package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
  142. package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  143. package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  144. package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  145. package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  146. package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  147. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  148. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  149. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  150. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  151. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  152. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  153. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  154. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  155. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  156. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  157. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  158. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  159. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  160. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  161. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  162. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  163. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  164. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  165. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  166. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  167. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  168. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  169. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  170. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  171. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  172. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  173. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  174. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  175. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  176. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  177. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  178. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  179. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  180. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  181. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  182. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  183. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  184. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  185. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  186. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  187. package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  188. package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
  189. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  190. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  191. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  192. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  193. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  194. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  195. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  196. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  197. package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  198. package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  199. package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  200. package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  201. package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  202. package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  203. package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
  204. package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
  205. package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  206. package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
  207. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  208. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  209. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  210. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  211. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  212. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  213. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  214. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  215. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  216. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  217. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  218. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  219. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  220. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  221. package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  222. package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  223. package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  224. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  225. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  226. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  227. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  228. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  229. package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  230. package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
  231. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  232. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  233. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  234. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  235. package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  236. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  237. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  238. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  239. package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  240. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
  241. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  242. package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  243. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
  244. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  245. package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  246. package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  247. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  248. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
  249. package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
  250. package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
  251. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  252. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  253. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  254. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  255. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
  256. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  257. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  258. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  259. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  260. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  261. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  262. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  263. package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
  264. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  265. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  266. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  267. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  268. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  269. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  270. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  271. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  272. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  273. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  274. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  275. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  276. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  277. package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  278. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  279. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  280. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
  281. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
  282. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  283. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  284. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  285. package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
  286. package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
  287. package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
  288. package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
  289. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
  290. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
  291. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  292. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  293. package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  294. package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
  295. package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
  296. package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  297. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  298. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  299. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
  300. package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
  301. package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  302. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  303. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  304. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  305. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  306. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  307. package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  308. package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  309. package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
  310. package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  311. package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
  312. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  313. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  314. package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  315. package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  316. package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  317. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  318. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  319. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  320. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  321. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  322. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  323. package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  324. package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
  325. package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
  326. package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
  327. package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
  328. package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
  329. package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
  330. package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
  331. package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
  332. package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  333. package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  334. package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
  335. package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
  336. package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
  337. package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
  338. package/.versions/2.0.10/.version +1 -0
  339. package/.versions/2.0.10/agents/architect.md +25 -0
  340. package/.versions/2.0.10/agents/bowser.md +28 -0
  341. package/.versions/2.0.10/agents/builder.md +56 -0
  342. package/.versions/2.0.10/agents/code-reviewer.md +210 -0
  343. package/.versions/2.0.10/agents/deep-researcher.md +33 -0
  344. package/.versions/2.0.10/agents/documenter.md +23 -0
  345. package/.versions/2.0.10/agents/orchestrator.md +23 -0
  346. package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
  347. package/.versions/2.0.10/agents/planner.md +106 -0
  348. package/.versions/2.0.10/agents/releaser.md +25 -0
  349. package/.versions/2.0.10/agents/researcher.md +31 -0
  350. package/.versions/2.0.10/agents/security-auditor.md +168 -0
  351. package/.versions/2.0.10/agents/test-engineer.md +154 -0
  352. package/.versions/2.0.10/agents/web-debugger.md +44 -0
  353. package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
  354. package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
  355. package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
  356. package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
  357. package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
  358. package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
  359. package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
  360. package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
  361. package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
  362. package/.versions/2.0.10/docs/getting-started.md +126 -0
  363. package/.versions/2.0.10/docs/npm-install.md +383 -0
  364. package/.versions/2.0.10/docs/pi-extensions.md +449 -0
  365. package/.versions/2.0.10/docs/pi-setup.md +92 -0
  366. package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
  367. package/.versions/2.0.10/install-manifest.json +2991 -0
  368. package/.versions/2.0.10/justfile +247 -0
  369. package/.versions/2.0.10/manifest-meta.json +970 -0
  370. package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
  371. package/.versions/2.0.10/references/communication-contract.md +26 -0
  372. package/.versions/2.0.10/references/definition-of-done.md +67 -0
  373. package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
  374. package/.versions/2.0.10/references/observability-checklist.md +92 -0
  375. package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
  376. package/.versions/2.0.10/references/performance-checklist.md +236 -0
  377. package/.versions/2.0.10/references/prompting-patterns.md +380 -0
  378. package/.versions/2.0.10/references/security-checklist.md +245 -0
  379. package/.versions/2.0.10/references/testing-patterns.md +235 -0
  380. package/.versions/2.0.10/references/workflow-authoring.md +304 -0
  381. package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
  382. package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  383. package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
  384. package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
  385. package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
  386. package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
  387. package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
  388. package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
  389. package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
  390. package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  391. package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
  392. package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  393. package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  394. package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  395. package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
  396. package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
  397. package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
  398. package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  399. package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  400. package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
  401. package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
  402. package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
  403. package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
  404. package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
  405. package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
  406. package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
  407. package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
  408. package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
  409. package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  410. package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
  411. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  412. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  413. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  414. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  415. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  416. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  417. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  418. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  419. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  420. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  421. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  422. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  423. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  424. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  425. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  426. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  427. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  428. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  429. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  430. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  431. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  432. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  433. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  434. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  435. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  436. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  437. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  438. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  439. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  440. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  441. package/CHANGELOG.md +11 -0
  442. package/agents/architect.md +1 -1
  443. package/agents/bowser.md +1 -1
  444. package/agents/builder.md +1 -1
  445. package/agents/code-reviewer.md +1 -1
  446. package/agents/deep-researcher.md +1 -1
  447. package/agents/documenter.md +1 -1
  448. package/agents/orchestrator.md +1 -1
  449. package/agents/plan-reviewer.md +1 -1
  450. package/agents/planner.md +1 -1
  451. package/agents/releaser.md +1 -1
  452. package/agents/researcher.md +1 -1
  453. package/agents/security-auditor.md +1 -1
  454. package/agents/test-engineer.md +1 -1
  455. package/agents/web-debugger.md +1 -1
  456. package/agents/web-performance-auditor.md +1 -1
  457. package/bin/cli.js +8 -5
  458. package/bin/lib/path-boundaries.js +5 -6
  459. package/bin/lib/stt-wizard.js +154 -23
  460. package/docs/agent-fleet-setup.md +26 -8
  461. package/docs/npm-install.md +29 -2
  462. package/docs/pi-setup.md +16 -0
  463. package/install-manifest.json +1 -1
  464. package/package.json +13 -3
  465. package/skills/orchestration-verification/SKILL.md +1 -0
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── No quality bar written down? ──→ constraint-driven-development
23
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
24
+ ├── Implementing code? ────────────→ incremental-implementation
25
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
26
+ │ ├── API work? ────────────────→ api-and-interface-design
27
+ │ ├── Need better context? ─────→ context-engineering
28
+ │ ├── Need doc-verified code? ───→ source-driven-development
29
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
30
+ ├── Writing/running tests? ────────→ test-driven-development
31
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
32
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
33
+ ├── Reviewing code? ───────────────→ code-review-and-quality
34
+ │ ├── Too complex? ─────────────→ code-simplification
35
+ │ ├── Security concerns? ───────→ security-and-hardening
36
+ │ └── Performance concerns? ────→ performance-optimization
37
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
38
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
39
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
40
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
41
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
42
+ └── Deploying/launching? ─────────→ shipping-and-launch
43
+ ```
44
+
45
+ ## Core Operating Behaviors
46
+
47
+ These behaviors apply at all times, across all skills. They are non-negotiable.
48
+
49
+ ### 1. Surface Assumptions
50
+
51
+ Before implementing anything non-trivial, explicitly state your assumptions:
52
+
53
+ ```
54
+ ASSUMPTIONS I'M MAKING:
55
+ 1. [assumption about requirements]
56
+ 2. [assumption about architecture]
57
+ 3. [assumption about scope]
58
+ → Correct me now or I'll proceed with these.
59
+ ```
60
+
61
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
62
+
63
+ ### 2. Manage Confusion Actively
64
+
65
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
66
+
67
+ 1. **STOP.** Do not proceed with a guess.
68
+ 2. Name the specific confusion.
69
+ 3. Present the tradeoff or ask the clarifying question.
70
+ 4. Wait for resolution before continuing.
71
+
72
+ **Bad:** Silently picking one interpretation and hoping it's right.
73
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
74
+
75
+ ### 3. Push Back When Warranted
76
+
77
+ You are not a yes-machine. When an approach has clear problems:
78
+
79
+ - Point out the issue directly
80
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
81
+ - Propose an alternative
82
+ - Accept the human's decision if they override with full information
83
+
84
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
85
+
86
+ ### 4. Enforce Simplicity
87
+
88
+ Your natural tendency is to overcomplicate. Actively resist it.
89
+
90
+ Before finishing any implementation, ask:
91
+ - Can this be done in fewer lines?
92
+ - Are these abstractions earning their complexity?
93
+ - Would a staff engineer look at this and say "why didn't you just..."?
94
+
95
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
96
+
97
+ ### 5. Maintain Scope Discipline
98
+
99
+ Touch only what you're asked to touch.
100
+
101
+ Do NOT:
102
+ - Remove comments you don't understand
103
+ - "Clean up" code orthogonal to the task
104
+ - Refactor adjacent systems as a side effect
105
+ - Delete code that seems unused without explicit approval
106
+ - Add features not in the spec because they "seem useful"
107
+
108
+ Your job is surgical precision, not unsolicited renovation.
109
+
110
+ ### 6. Verify, Don't Assume
111
+
112
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
113
+
114
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
115
+
116
+ ## Failure Modes to Avoid
117
+
118
+ These are the subtle errors that look like productivity but create problems:
119
+
120
+ 1. Making wrong assumptions without checking
121
+ 2. Not managing your own confusion — plowing ahead when lost
122
+ 3. Not surfacing inconsistencies you notice
123
+ 4. Not presenting tradeoffs on non-obvious decisions
124
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
125
+ 6. Overcomplicating code and APIs
126
+ 7. Modifying code or comments orthogonal to the task
127
+ 8. Removing things you don't fully understand
128
+ 9. Building without a spec because "it's obvious"
129
+ 10. Skipping verification because "it looks right"
130
+
131
+ ## Skill Rules
132
+
133
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
134
+
135
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
136
+
137
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
138
+
139
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
140
+
141
+ ## Lifecycle Sequence
142
+
143
+ For a complete feature, the typical skill sequence is:
144
+
145
+ ```
146
+ 1. interview-me → Extract what the user actually wants
147
+ 2. idea-refine → Refine vague ideas
148
+ 3. spec-driven-development → Define what we're building
149
+ 4. planning-and-task-breakdown → Break into verifiable chunks
150
+ 5. context-engineering → Load the right context
151
+ 6. source-driven-development → Verify against official docs
152
+ 7. incremental-implementation → Build slice by slice
153
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
154
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
155
+ 10. test-driven-development → Prove each slice works
156
+ 11. code-review-and-quality → Review before merge
157
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
158
+ 13. git-workflow-and-versioning → Clean commit history
159
+ 14. documentation-and-adrs → Document decisions
160
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
161
+ 16. shipping-and-launch → Deploy safely
162
+ ```
163
+
164
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
165
+
166
+ ## Quick Reference
167
+
168
+ | Phase | Skill | One-Line Summary |
169
+ |-------|-------|-----------------|
170
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
171
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
172
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
173
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
174
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
175
+ | Build | source-driven-development | Verify against official docs before implementing |
176
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
177
+ | Build | context-engineering | Right context at the right time |
178
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
179
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
180
+ | Verify | test-driven-development | Failing test first, then make it pass |
181
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
182
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
183
+ | Review | code-review-and-quality | Five-axis review with quality gates |
184
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
185
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
186
+ | Review | performance-optimization | Measure first, optimize only what matters |
187
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
188
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
189
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
190
+ | Ship | documentation-and-adrs | Document the why, not just the what |
191
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
192
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,16 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 2.0.10
4
+
5
+ ### Patch Changes
6
+
7
+ - 1c5488a: Run local TypeScript diagnostics once after successful writable native dispatches and conservatively demote current-dispatch proof claims when changed-file compiler errors contradict them.
8
+ - 12608f1: Fix package-internal Pi skill collisions by discovering only unshadowed upstream skills alongside Fleet-native skills, preserving the full skill catalog.
9
+ - a07cf09: Accept and preserve canonical nested voice STT configuration, distinguish installer aliases from runtime provider types, and require prepared provider settings instead of guessing them.
10
+ - 7077fc4: Fix compiler diagnostic path attribution through symlinked worktrees, including macOS temporary directories. Make diagnostics tests independent of `/tmp` and the installed TypeScript version.
11
+
12
+ Prevent release-blocking false positives by parsing actual import syntax instead of fixture text and checking untracked source files before commit. Run the shared Linux/macOS validation matrix on pull requests with read-only permissions, plus alternate-temp-directory regressions; reserve publishing permissions for validated main-branch releases.
13
+
3
14
  ## 2.0.9
4
15
 
5
16
  ### Patch Changes
@@ -8,7 +8,7 @@ models:
8
8
  - openai-codex/gpt-5.6-luna
9
9
  - ollama/nemotron-3-ultra:cloud
10
10
  - ollama/glm-5.2:cloud
11
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
11
+ - omlx/Qwen3.6-35B-A3B-4bit
12
12
  thinking: high
13
13
  ---
14
14
 
package/agents/bowser.md CHANGED
@@ -8,7 +8,7 @@ models:
8
8
  - openai-codex/gpt-5.6-terra
9
9
  - ollama/minimax-m3:cloud
10
10
  - ollama/nemotron-3-ultra:cloud
11
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
11
+ - omlx/Qwen3.6-35B-A3B-4bit
12
12
  color: orange
13
13
  skills:
14
14
  - bowser
package/agents/builder.md CHANGED
@@ -12,7 +12,7 @@ models:
12
12
  - ollama/kimi-k2.7-code:cloud
13
13
  - ollama/glm-5.2:cloud
14
14
  - ollama/nemotron-3-ultra:cloud
15
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
15
+ - omlx/Qwen3.6-35B-A3B-4bit
16
16
  thinking: medium
17
17
  delegate_depth: 1
18
18
  subagents:
@@ -13,7 +13,7 @@ models:
13
13
  - ollama/kimi-k2.7-code:cloud
14
14
  - ollama/glm-5.2:cloud
15
15
  - ollama/minimax-m3:cloud
16
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
16
+ - omlx/Qwen3.6-35B-A3B-4bit
17
17
  thinking: medium
18
18
  delegate_depth: 1
19
19
  subagents:
@@ -10,7 +10,7 @@ models:
10
10
  - openai-codex/gpt-5.6-luna
11
11
  - ollama/nemotron-3-ultra:cloud
12
12
  - ollama/glm-5.2:cloud
13
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
13
+ - omlx/Qwen3.6-35B-A3B-4bit
14
14
  thinking: medium
15
15
  ---
16
16
 
@@ -12,7 +12,7 @@ models:
12
12
  - openai-codex/gpt-5.3-codex-spark
13
13
  - ollama/glm-5.2:cloud
14
14
  - ollama/nemotron-3-ultra:cloud
15
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
15
+ - omlx/Qwen3.6-35B-A3B-4bit
16
16
  thinking: minimal
17
17
  ---
18
18
  You are a documentation agent. Write clear, concise documentation. Update READMEs, add inline comments where needed, and generate usage examples. Match the project's existing doc style.
@@ -8,7 +8,7 @@ models:
8
8
  - openai-codex/gpt-5.6-luna
9
9
  - ollama/minimax-m3:cloud
10
10
  - ollama/nemotron-3-ultra:cloud
11
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
11
+ - omlx/Qwen3.6-35B-A3B-4bit
12
12
  thinking: medium
13
13
  ---
14
14
 
@@ -10,7 +10,7 @@ models:
10
10
  - openai-codex/gpt-5.6-luna
11
11
  - ollama/nemotron-3-ultra:cloud
12
12
  - ollama/glm-5.2:cloud
13
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
13
+ - omlx/Qwen3.6-35B-A3B-4bit
14
14
  thinking: medium
15
15
  delegate_depth: 1
16
16
  subagents:
package/agents/planner.md CHANGED
@@ -12,7 +12,7 @@ models:
12
12
  - openai-codex/gpt-5.6-luna
13
13
  - ollama/nemotron-3-ultra:cloud
14
14
  - ollama/glm-5.2:cloud
15
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
15
+ - omlx/Qwen3.6-35B-A3B-4bit
16
16
  thinking: high
17
17
  delegate_depth: 1
18
18
  subagents:
@@ -8,7 +8,7 @@ models:
8
8
  - openai-codex/gpt-5.6-luna
9
9
  - ollama/glm-5.2:cloud
10
10
  - ollama/nemotron-3-ultra:cloud
11
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
11
+ - omlx/Qwen3.6-35B-A3B-4bit
12
12
  thinking: low
13
13
  ---
14
14
 
@@ -11,7 +11,7 @@ models:
11
11
  - openai-codex/gpt-5.6-terra
12
12
  - ollama/nemotron-3-ultra:cloud
13
13
  - ollama/minimax-m3:cloud
14
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
14
+ - omlx/Qwen3.6-35B-A3B-4bit
15
15
  thinking: low
16
16
  ---
17
17
 
@@ -9,7 +9,7 @@ models:
9
9
  - openai-codex/gpt-5.6-luna
10
10
  - ollama/nemotron-3-ultra:cloud
11
11
  - ollama/glm-5.2:cloud
12
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
12
+ - omlx/Qwen3.6-35B-A3B-4bit
13
13
  thinking: high
14
14
  delegate_depth: 1
15
15
  subagents:
@@ -11,7 +11,7 @@ models:
11
11
  - ollama/kimi-k2.7-code:cloud
12
12
  - ollama/glm-5.2:cloud
13
13
  - ollama/nemotron-3-ultra:cloud
14
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
14
+ - omlx/Qwen3.6-35B-A3B-4bit
15
15
  thinking: low
16
16
  delegate_depth: 1
17
17
  subagents:
@@ -7,7 +7,7 @@ models:
7
7
  - openai-codex/gpt-5.6-sol
8
8
  - openai-codex/gpt-5.6-luna
9
9
  - ollama/glm-5.2:cloud
10
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
10
+ - omlx/Qwen3.6-35B-A3B-4bit
11
11
  color: cyan
12
12
  skills:
13
13
  - browser-testing-with-devtools
@@ -9,7 +9,7 @@ models:
9
9
  - openai-codex/gpt-5.6-luna
10
10
  - ollama/nemotron-3-ultra:cloud
11
11
  - ollama/glm-5.2:cloud
12
- - custom/Qwen3.8-27B-Uncensored-MLX-4bit
12
+ - omlx/Qwen3.6-35B-A3B-4bit
13
13
  thinking: high
14
14
  ---
15
15
 
package/bin/cli.js CHANGED
@@ -301,13 +301,13 @@ async function cmdSetup() {
301
301
  });
302
302
  if (provider.cancelled || !provider.value) selection = { cancelled: true, reason: provider.reason ?? "no provider" };
303
303
  else sttProvider = provider.value;
304
- } else if (!selection.cancelled && existingStt && sttProvider && sttProvider !== existingStt.config.provider) {
304
+ } else if (!selection.cancelled && existingStt && sttProvider && sttProvider !== existingStt.providerAlias) {
305
305
  const replacement = await askChoice({ output: stdout, readLine: setupReadLine,
306
- prompt: `Replace STT provider ${existingStt.config.provider} with ${sttProvider}? yes/y | no/n | cancel; Enter = no (keep existing provider) > `,
306
+ prompt: `Replace STT provider ${existingStt.provider} with ${sttProvider}? yes/y | no/n | cancel; Enter = no (keep existing provider) > `,
307
307
  validate: (value) => /^y(?:es)?$/i.test(value) ? { ok: true, value: true } : value === "" || /^n(?:o)?$/i.test(value) ? { ok: true, value: false } : { ok: false, error: "Invalid answer. Enter yes/y to replace or no/n to keep the existing provider." },
308
308
  });
309
309
  if (replacement.cancelled) selection = { cancelled: true, reason: replacement.reason };
310
- else if (!replacement.value) sttProvider = existingStt.config.provider;
310
+ else if (!replacement.value) sttProvider = null;
311
311
  else sttReplacementApproved = true;
312
312
  }
313
313
  } catch (err) { setupRl.close(); fail(err.message); }
@@ -340,6 +340,7 @@ async function cmdSetup() {
340
340
  setupRl?.close();
341
341
  fail(plan.migrationError);
342
342
  }
343
+ if (opts.json && !dryRun && plan.stt?.warning) console.error(`Warning: ${plan.stt.warning}`);
343
344
  plan.fingerprints = capturePlanFingerprints(plan, manifest);
344
345
  if (dryRun) {
345
346
  setupRl?.close(); writeJson(publicPlan(plan)); exit(plan.conflicts.length ? 3 : 0);
@@ -903,6 +904,7 @@ function printPlan(plan) {
903
904
  }
904
905
 
905
906
  for (const note of plan.notes) console.log(`\nNote: ${note.detail}`);
907
+ if (plan.stt?.warning) console.log(`\nWarning: ${plan.stt.warning}`);
906
908
 
907
909
  // Only the interesting half. A hundred `keep` lines buries the four that matter.
908
910
  const shown = plan.actions.filter((a) => a.kind !== "keep");
@@ -967,7 +969,7 @@ function printConfigurationWrites(plan) {
967
969
  const writes = [
968
970
  plan.writeDesired ? plan.desiredPath : null,
969
971
  plan.overrides?.write ? plan.overrides.path : null,
970
- plan.stt?.path ?? null,
972
+ plan.stt?.write ? plan.stt.path : null,
971
973
  plan.stt?.env?.missing?.length ? plan.stt.env.path : null,
972
974
  ].filter(Boolean);
973
975
  if (writes.length === 0) return;
@@ -1186,7 +1188,8 @@ Options:
1186
1188
  --preset <default|full> Desired preset
1187
1189
  --repair-config With --yes, approve known retired config removal (backup saved)
1188
1190
  --features <name[,name]|none> Exact feature snapshot (replaces, never adds)
1189
- --stt-provider <openai|groq|azure> First-time voice provider; no secret is prompted
1191
+ --stt-provider <openai|groq|azure|azure-openai>
1192
+ Select provider explicitly; non-OpenAI setup requires prepared .ai/stt.json
1190
1193
  --save-desired Persist CLI overrides to .ai/agent-fleet.json
1191
1194
  --migrate Permit non-interactive first migration (with explicit preset/features and --yes)
1192
1195
  --allow-exec Run consented runtime commands after the file transaction
@@ -32,19 +32,18 @@ export const MOVED_TO = Object.freeze({
32
32
  agents: ".pi/agents/personas",
33
33
  });
34
34
 
35
- const SPECIFIER = /(?:\bfrom|\bimport|\brequire)\s*\(?\s*["'](\.\.?\/[^"']+)["']|new URL\(\s*["'](\.\.?[^"']*)["']/g;
36
-
37
35
  /**
38
- * Relative specifiers in `source` that do not resolve to a file on disk.
36
+ * Syntax-extracted relative specifiers that do not resolve to a file on disk.
37
+ * Parsing is supplied by the test-only caller so the installer does not acquire
38
+ * a TypeScript runtime dependency. Do not regex-scan source/fixture text here.
39
39
  *
40
40
  * `.js` is accepted for a `.ts` file: that is the NodeNext spelling the
41
41
  * harnesses already use, and Node strips types at runtime.
42
42
  */
43
- export function unresolvedSpecifiers({ root, file, source }) {
43
+ export function unresolvedSpecifiers({ root, file, specifiers }) {
44
44
  const dir = dirname(join(root, file));
45
45
  const out = [];
46
- for (const match of source.matchAll(SPECIFIER)) {
47
- const spec = match[1] ?? match[2];
46
+ for (const spec of specifiers) {
48
47
  const target = resolve(dir, spec);
49
48
  if (existsSync(target)) continue;
50
49
  if (target.endsWith(".js") && existsSync(`${target.slice(0, -3)}.ts`)) continue;
@@ -2,46 +2,177 @@
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
 
5
+ const ENV_NAME = /^[A-Z_][A-Z0-9_]*$/;
6
+ const RUNTIME_PROVIDER_TYPES = new Set(["openai", "openai-compatible", "azure", "azure-openai"]);
7
+ const LEGACY_PROVIDER_FIELDS = new Set([
8
+ "apiKeyEnv", "endpointEnv", "endpoint", "baseUrl", "model", "deployment", "apiVersion", "format", "locales",
9
+ ]);
10
+
11
+ // These are installer selections, not a list of runtime provider.type values.
5
12
  export const STT_PROVIDERS = {
6
- openai: { apiKeyEnv: "OPENAI_API_KEY" },
7
- groq: { apiKeyEnv: "GROQ_API_KEY" },
8
- azure: { apiKeyEnv: "AZURE_OPENAI_API_KEY", endpointEnv: "AZURE_OPENAI_ENDPOINT" },
13
+ openai: { runtimeType: "openai" },
14
+ groq: { preparedConfigRequired: true },
15
+ azure: { runtimeType: "azure", preparedConfigRequired: true },
16
+ "azure-openai": { runtimeType: "azure-openai", preparedConfigRequired: true },
9
17
  };
10
- export function validateSttConfig(value) {
11
- if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("STT config must be an object");
12
- if (!STT_PROVIDERS[value.provider]) throw new Error(`unsupported STT provider "${value.provider}"`);
13
- for (const key of ["apiKeyEnv", ...(value.provider === "azure" ? ["endpointEnv"] : [])]) {
14
- if (typeof value[key] !== "string" || !/^[A-Z_][A-Z0-9_]*$/.test(value[key])) throw new Error(`${key} must name an environment variable`);
15
- }
18
+
19
+ function isObject(value) {
20
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
21
+ }
22
+ function assertString(value, path) {
23
+ if (typeof value !== "string") throw new Error(`${path} must be a string`);
24
+ }
25
+ function assertOptionalString(object, key, path = key) {
26
+ if (object[key] !== undefined) assertString(object[key], path);
27
+ }
28
+ function assertEnvName(value, path) {
29
+ if (typeof value !== "string" || !ENV_NAME.test(value)) throw new Error(`${path} must name an environment variable`);
30
+ }
31
+ function isSecretField(key) {
32
+ if (/Env$/.test(key)) return false;
33
+ return /api.?key|access.?token|auth.?token|secret|password|credential|private.?key/i.test(key);
34
+ }
35
+ function containsSecretValue(value) {
36
+ return typeof value === "string" && /(?:sk-[A-Za-z0-9]|AIza[A-Za-z0-9_-]|gh[pousr]_|Bearer\s+)/i.test(value);
37
+ }
38
+ function validateSafeTree(value, path = "STT config") {
39
+ if (!value || typeof value !== "object") return;
16
40
  for (const [key, item] of Object.entries(value)) {
17
- if (/key|token|secret|password/i.test(key) && !/Env$/.test(key)) throw new Error(`STT config must not store ${key}`);
18
- if (typeof item === "string" && /(?:sk-[A-Za-z0-9]|AIza|ghp_)/i.test(item)) throw new Error("STT config must not store secret values");
41
+ const field = `${path}.${key}`;
42
+ if (isSecretField(key)) throw new Error("STT config must not store secret fields");
43
+ if (/Env$/.test(key)) assertEnvName(item, field);
44
+ if (containsSecretValue(item)) throw new Error("STT config must not store secret values");
45
+ validateSafeTree(item, field);
46
+ }
47
+ }
48
+ function validateCapture(capture) {
49
+ if (!isObject(capture)) throw new Error("capture must be an object");
50
+ for (const key of ["ffmpegPath", "inputFormat", "input"]) assertOptionalString(capture, key, `capture.${key}`);
51
+ for (const key of ["sampleRate", "channels", "maxSeconds", "minBytes"]) {
52
+ if (capture[key] !== undefined && (typeof capture[key] !== "number" || !Number.isFinite(capture[key]) || capture[key] <= 0)) {
53
+ throw new Error(`capture.${key} must be a positive number`);
54
+ }
55
+ }
56
+ }
57
+ function validateNestedProvider(provider) {
58
+ if (!isObject(provider)) throw new Error("provider must be an object or supported legacy provider");
59
+ if (typeof provider.type !== "string" || !RUNTIME_PROVIDER_TYPES.has(provider.type)) {
60
+ throw new Error("unsupported provider.type");
61
+ }
62
+ for (const key of ["apiKeyEnv", "endpointEnv"]) {
63
+ if (provider[key] !== undefined) assertEnvName(provider[key], `provider.${key}`);
64
+ }
65
+ for (const key of ["endpoint", "baseUrl", "model", "deployment", "apiVersion"]) {
66
+ assertOptionalString(provider, key, `provider.${key}`);
67
+ }
68
+ if (provider.type === "azure-openai" && (typeof provider.deployment !== "string" || !provider.deployment.trim())) {
69
+ throw new Error("provider.deployment is required for provider.type azure-openai");
70
+ }
71
+ if (provider.format !== undefined && !["simple", "detailed"].includes(provider.format)) {
72
+ throw new Error("provider.format must be simple or detailed");
73
+ }
74
+ if (provider.locales !== undefined && (!Array.isArray(provider.locales) || provider.locales.some((item) => typeof item !== "string"))) {
75
+ throw new Error("provider.locales must be an array of strings");
76
+ }
77
+ }
78
+ function validateLegacyProvider(value) {
79
+ if (!Object.hasOwn(STT_PROVIDERS, value.provider) || value.provider === "azure-openai") {
80
+ throw new Error("unsupported legacy STT provider");
19
81
  }
20
- return structuredClone(value); // unknown human-owned fields are valid and preserved.
82
+ assertEnvName(value.apiKeyEnv, "apiKeyEnv");
83
+ if (value.provider === "azure") assertEnvName(value.endpointEnv, "endpointEnv");
21
84
  }
22
- export function renderSttConfig(value) { return JSON.stringify(validateSttConfig(value), null, 2) + "\n"; }
85
+
86
+ export function validateSttConfig(value) {
87
+ if (!isObject(value)) throw new Error("STT config must be an object");
88
+ if (typeof value.provider === "string") validateLegacyProvider(value);
89
+ else validateNestedProvider(value.provider);
90
+ if (value.keybind !== undefined) assertString(value.keybind, "keybind");
91
+ if (value.language !== undefined) assertString(value.language, "language");
92
+ if (value.capture !== undefined) validateCapture(value.capture);
93
+ validateSafeTree(value);
94
+ return structuredClone(value); // Validation and metadata extraction never mutate human-owned config.
95
+ }
96
+
97
+ export function renderSttConfig(value) {
98
+ return JSON.stringify(validateSttConfig(value), null, 2) + "\n";
99
+ }
100
+
101
+ function providerMetadata(config) {
102
+ if (typeof config.provider === "string") {
103
+ return { format: "legacy", providerType: null, providerAlias: config.provider, provider: config.provider, warning: "legacy STT config preserved without automatic migration; runtime compatibility is not guaranteed" };
104
+ }
105
+ const providerType = config.provider.type;
106
+ const providerAlias = providerType === "openai" || providerType === "azure" || providerType === "azure-openai" ? providerType : null;
107
+ return { format: "runtime", providerType, providerAlias, provider: providerType, warning: null };
108
+ }
109
+
23
110
  export function readSttConfig(workspace) {
24
111
  const path = join(workspace, ".ai", "stt.json");
25
112
  if (!existsSync(path)) return null;
26
113
  const text = readFileSync(path, "utf8");
27
- try { return { path, text, config: validateSttConfig(JSON.parse(text)) }; }
28
- catch (error) { throw new Error(`invalid .ai/stt.json: ${error.message}; repair it manually before setup`); }
114
+ let parsed;
115
+ try { parsed = JSON.parse(text); }
116
+ catch { throw new Error("invalid .ai/stt.json: invalid JSON; repair it manually before setup"); }
117
+ try {
118
+ const config = validateSttConfig(parsed);
119
+ return { path, text, config, ...providerMetadata(config) };
120
+ } catch (error) {
121
+ throw new Error(`invalid .ai/stt.json: ${error.message}; repair it manually before setup`);
122
+ }
29
123
  }
124
+
125
+ function requiredEnvNames(config) {
126
+ if (typeof config.provider === "string") return [config.apiKeyEnv, config.endpointEnv].filter(Boolean);
127
+ const provider = config.provider;
128
+ const names = [];
129
+ if (provider.apiKeyEnv) names.push(provider.apiKeyEnv);
130
+ else names.push(provider.type === "azure" ? "AZURE_SPEECH_KEY" : provider.type === "azure-openai" ? "AZURE_OPENAI_API_KEY" : "OPENAI_API_KEY");
131
+ if ((provider.type === "azure" || provider.type === "azure-openai") && !provider.endpoint) {
132
+ names.push(provider.endpointEnv || (provider.type === "azure" ? "AZURE_SPEECH_ENDPOINT" : "AZURE_OPENAI_ENDPOINT"));
133
+ }
134
+ return [...new Set(names)];
135
+ }
136
+
30
137
  /** Append empty placeholders only for variables not already declared. */
31
138
  export function appendEnvPlaceholders(workspace, config) {
32
139
  const path = join(workspace, ".env");
33
140
  const before = existsSync(path) ? readFileSync(path, "utf8") : "";
34
- const names = [config.apiKeyEnv, config.endpointEnv].filter(Boolean);
141
+ const names = requiredEnvNames(config);
35
142
  const missing = names.filter((name) => !new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`, "m").test(before));
36
- return { path, text: missing.length ? `${before}${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : before, missing };
143
+ const suffix = missing.length ? `${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : "";
144
+ return { path, text: before + suffix, missing };
145
+ }
146
+
147
+ function generatedConfig(existing, provider) {
148
+ const retained = structuredClone(existing?.config ?? {});
149
+ if (typeof retained.provider === "string") {
150
+ for (const field of LEGACY_PROVIDER_FIELDS) delete retained[field];
151
+ }
152
+ retained.provider = { type: STT_PROVIDERS[provider].runtimeType };
153
+ return validateSttConfig(retained);
37
154
  }
155
+
38
156
  export function planStt(workspace, provider, { replacementApproved = false } = {}) {
39
157
  const existing = readSttConfig(workspace);
40
- if (existing && (!provider || provider === existing.config.provider)) {
41
- return { path: existing.path, write: false, preserved: true, provider: existing.config.provider, env: appendEnvPlaceholders(workspace, existing.config) };
158
+ if (existing && (!provider || provider === existing.providerAlias)) {
159
+ return { path: existing.path, write: false, preserved: true, provider: existing.provider, format: existing.format, warning: existing.warning, env: appendEnvPlaceholders(workspace, existing.config) };
160
+ }
161
+ if (!provider || !Object.hasOwn(STT_PROVIDERS, provider)) {
162
+ throw new Error(`first-time voice setup requires an explicit STT provider: ${Object.keys(STT_PROVIDERS).join(", ")}`);
163
+ }
164
+ if (existing && !replacementApproved) throw new Error(`replacing STT provider ${existing.provider} with ${provider} requires explicit approval`);
165
+ if (STT_PROVIDERS[provider].preparedConfigRequired) {
166
+ throw new Error(`${provider} setup requires a prepared nested .ai/stt.json with provider-specific settings; no values were guessed`);
42
167
  }
43
- if (!provider || !STT_PROVIDERS[provider]) throw new Error(`first-time voice setup requires an explicit STT provider: ${Object.keys(STT_PROVIDERS).join(", ")}`);
44
- if (existing && !replacementApproved) throw new Error(`replacing STT provider ${existing.config.provider} with ${provider} requires explicit approval`);
45
- const config = validateSttConfig({ ...(existing?.config ?? {}), provider, ...STT_PROVIDERS[provider] });
46
- return { path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(config), write: true, preserved: false, replacing: existing?.config.provider ?? null, provider, env: appendEnvPlaceholders(workspace, config) };
168
+ const config = generatedConfig(existing, provider);
169
+ return {
170
+ path: join(workspace, ".ai", "stt.json"),
171
+ text: renderSttConfig(config),
172
+ write: true,
173
+ preserved: false,
174
+ replacing: existing?.provider ?? null,
175
+ provider,
176
+ env: appendEnvPlaceholders(workspace, config),
177
+ };
47
178
  }