@chankov/agent-fleet 2.0.5 → 2.0.7

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 (949) hide show
  1. package/.pi/harnesses/agent-hub/README.md +74 -10
  2. package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  3. package/.pi/harnesses/agent-hub/artifacts.js +1 -1
  4. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
  5. package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  6. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  7. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  8. package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  9. package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
  10. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
  11. package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
  12. package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
  13. package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
  14. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
  15. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
  16. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +22 -0
  17. package/.pi/harnesses/agent-hub/dispatch-native.ts +25 -11
  18. package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  19. package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
  20. package/.pi/harnesses/agent-hub/index.ts +79 -43
  21. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
  22. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
  23. package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
  24. package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  25. package/.pi/harnesses/agent-hub/package.json +1 -1
  26. package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
  27. package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
  28. package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
  29. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  30. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  31. package/.pi/harnesses/agent-hub/research/runtime.ts +17 -2
  32. package/.pi/harnesses/agent-hub/research/spawn-run.ts +14 -6
  33. package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
  34. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  35. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
  36. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +65 -24
  37. package/.pi/harnesses/agent-hub/types.ts +1 -0
  38. package/.pi/harnesses/agent-hub/ui/pool.ts +6 -1
  39. package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
  40. package/.pi/harnesses/ask-user-remote/README.md +8 -2
  41. package/.pi/harnesses/ask-user-remote/index.ts +40 -14
  42. package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  43. package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
  44. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  45. package/.pi/harnesses/coms/README.md +1 -1
  46. package/.pi/harnesses/coms/index.ts +7 -1
  47. package/.pi/harnesses/coms/package.json +1 -1
  48. package/.pi/harnesses/damage-control-continue/README.md +11 -0
  49. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  50. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  51. package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
  52. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  53. package/.pi/harnesses/lib/update-check.ts +222 -0
  54. package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  55. package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
  56. package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
  57. package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
  58. package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
  59. package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
  74. package/.versions/2.0.6/.pi/extensions/package.json +9 -0
  75. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
  83. package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  84. package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  85. package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
  86. package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  87. package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  88. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  89. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  90. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  91. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  92. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  93. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  94. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  95. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  96. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  97. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  98. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  99. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  100. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  101. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  102. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  103. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  104. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  105. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  106. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  107. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  108. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  109. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  110. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  111. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  112. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  113. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  114. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  115. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  116. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  117. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  118. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  119. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  120. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  121. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  122. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  123. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  124. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  125. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  126. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  127. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
  128. package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  129. package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
  130. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  131. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  132. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  133. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  134. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  135. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  136. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  137. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  138. package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  139. package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  140. package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  141. package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  142. package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  143. package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  144. package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
  145. package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
  146. package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  147. package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
  148. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  149. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  150. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  151. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  152. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  153. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  154. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  155. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  156. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  157. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  158. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  159. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  160. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  161. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  162. package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  163. package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  164. package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  165. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  166. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  167. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  168. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  169. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  170. package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  171. package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
  172. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  173. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  174. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  175. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  176. package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  177. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  178. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  179. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  180. package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  181. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
  182. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
  183. package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
  184. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
  185. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  186. package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  187. package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  188. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
  189. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
  190. package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
  191. package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
  192. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  193. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  194. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  195. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  196. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  197. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  198. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  199. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  200. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  201. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  202. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  203. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  204. package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
  205. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  206. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  207. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  208. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  209. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  210. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  211. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  212. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  213. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  214. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  215. package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
  216. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  217. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  218. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
  219. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
  220. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  221. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  222. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  223. package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
  224. package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
  225. package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
  226. package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
  227. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
  228. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  229. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  230. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
  231. package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
  232. package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
  233. package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  234. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  235. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  236. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
  237. package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
  238. package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  239. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  240. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  241. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  242. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  243. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  244. package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  245. package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  246. package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
  247. package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  248. package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
  249. package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  250. package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
  251. package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
  252. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  253. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  254. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  255. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  256. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  257. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  258. package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
  259. package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
  260. package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
  261. package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
  262. package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
  263. package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
  264. package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
  265. package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  266. package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  267. package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
  268. package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
  269. package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
  270. package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
  271. package/.versions/2.0.6/.version +1 -0
  272. package/.versions/2.0.6/agents/architect.md +25 -0
  273. package/.versions/2.0.6/agents/bowser.md +28 -0
  274. package/.versions/2.0.6/agents/builder.md +56 -0
  275. package/.versions/2.0.6/agents/code-reviewer.md +210 -0
  276. package/.versions/2.0.6/agents/deep-researcher.md +33 -0
  277. package/.versions/2.0.6/agents/documenter.md +23 -0
  278. package/.versions/2.0.6/agents/orchestrator.md +23 -0
  279. package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
  280. package/.versions/2.0.6/agents/planner.md +106 -0
  281. package/.versions/2.0.6/agents/releaser.md +25 -0
  282. package/.versions/2.0.6/agents/researcher.md +31 -0
  283. package/.versions/2.0.6/agents/security-auditor.md +168 -0
  284. package/.versions/2.0.6/agents/test-engineer.md +154 -0
  285. package/.versions/2.0.6/agents/web-debugger.md +44 -0
  286. package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
  287. package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
  288. package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
  289. package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
  290. package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
  291. package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
  292. package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
  293. package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
  294. package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
  295. package/.versions/2.0.6/docs/getting-started.md +126 -0
  296. package/.versions/2.0.6/docs/npm-install.md +301 -0
  297. package/.versions/2.0.6/docs/pi-extensions.md +446 -0
  298. package/.versions/2.0.6/docs/pi-setup.md +76 -0
  299. package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
  300. package/.versions/2.0.6/hermes/README.md +347 -0
  301. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  302. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  303. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  304. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  305. package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
  306. package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
  307. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  308. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  309. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  310. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  311. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  312. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  313. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  314. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  315. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  316. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  317. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  318. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  319. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  320. package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  321. package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  322. package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
  323. package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
  324. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  325. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  326. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  327. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  328. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  329. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  330. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  331. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  332. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  333. package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
  334. package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
  335. package/.versions/2.0.6/install-manifest.json +2924 -0
  336. package/.versions/2.0.6/justfile +247 -0
  337. package/.versions/2.0.6/manifest-meta.json +976 -0
  338. package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
  339. package/.versions/2.0.6/references/communication-contract.md +26 -0
  340. package/.versions/2.0.6/references/definition-of-done.md +67 -0
  341. package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
  342. package/.versions/2.0.6/references/observability-checklist.md +91 -0
  343. package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
  344. package/.versions/2.0.6/references/performance-checklist.md +153 -0
  345. package/.versions/2.0.6/references/prompting-patterns.md +380 -0
  346. package/.versions/2.0.6/references/security-checklist.md +179 -0
  347. package/.versions/2.0.6/references/testing-patterns.md +236 -0
  348. package/.versions/2.0.6/references/workflow-authoring.md +304 -0
  349. package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
  350. package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
  351. package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
  352. package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
  353. package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
  354. package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
  355. package/.versions/2.0.6/scripts/fleet.ts +216 -0
  356. package/.versions/2.0.6/scripts/flow.ts +137 -0
  357. package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  358. package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
  359. package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
  360. package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
  361. package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
  362. package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
  363. package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  364. package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
  365. package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
  366. package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
  367. package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
  368. package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
  369. package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
  370. package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
  371. package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
  372. package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  373. package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
  374. package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  375. package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  376. package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  377. package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  378. package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  379. package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
  380. package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
  381. package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
  382. package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
  383. package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
  384. package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
  385. package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
  386. package/.versions/2.0.6/scripts/package-lock.json +35 -0
  387. package/.versions/2.0.6/scripts/package.json +9 -0
  388. package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
  389. package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
  390. package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
  391. package/.versions/2.0.6/scripts/team-up.ts +378 -0
  392. package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
  393. package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
  394. package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
  395. package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
  396. package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
  397. package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
  398. package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
  399. package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
  400. package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
  401. package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
  402. package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
  403. package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
  404. package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
  405. package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
  406. package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
  407. package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
  408. package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
  409. package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
  410. package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
  411. package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
  412. package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
  413. package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
  414. package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
  415. package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
  416. package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
  417. package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
  418. package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
  419. package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  420. package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
  421. package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
  422. package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  423. package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
  424. package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  425. package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
  426. package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  427. package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  428. package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  429. package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
  430. package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
  431. package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
  432. package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  433. package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  434. package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
  435. package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
  436. package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
  437. package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
  438. package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
  439. package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
  440. package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
  441. package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
  442. package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
  443. package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  444. package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
  445. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  446. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  447. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  448. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  449. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  450. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  451. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  452. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  453. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  454. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  455. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  456. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  457. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  458. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  459. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  460. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  461. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  462. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  463. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  464. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  465. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  466. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  467. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  468. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  469. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  470. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  471. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  472. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  473. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  474. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  475. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  476. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  477. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  478. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  479. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  480. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  481. package/.versions/2.0.7/.pi/extensions/btw/package.json +6 -0
  482. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  483. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  484. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  485. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  486. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  487. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  488. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  489. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  490. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  491. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  492. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  493. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  494. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  495. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  496. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  497. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  498. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  499. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  500. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  501. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  502. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  503. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  504. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  505. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  506. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  507. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  508. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  509. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  510. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  511. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  512. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  513. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  514. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  515. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  516. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  517. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  518. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  519. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  520. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  521. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  522. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  523. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  524. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  525. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  526. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  527. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  528. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  529. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  530. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  531. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  532. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  533. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  534. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  535. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  536. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  537. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  538. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  539. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  540. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  541. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  542. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  543. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  544. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  545. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  546. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  547. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  548. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  549. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  550. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  551. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  552. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  553. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  554. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  555. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  556. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  557. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  558. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  559. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  560. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  561. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  562. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  563. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  564. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  565. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  566. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  567. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  568. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  569. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  570. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  571. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  572. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  573. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  574. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  575. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  576. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  577. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  578. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  579. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  580. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  581. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  582. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  583. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  584. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  585. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  586. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  587. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  588. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  589. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  590. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  591. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  592. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  593. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  594. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  595. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  596. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  597. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  598. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  599. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  600. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  601. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  602. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  603. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  604. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  605. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  606. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  607. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  608. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  609. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  610. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  611. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  612. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  613. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  614. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  615. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  616. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  617. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  618. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  619. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  620. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  621. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  622. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  623. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  624. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  625. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  626. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  627. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  628. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  629. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  630. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  631. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  632. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  633. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  634. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  635. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  636. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  637. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  638. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  639. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  640. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  641. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  642. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  643. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  644. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  645. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  646. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  647. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  648. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  649. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  650. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  651. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  652. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  653. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  654. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  655. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  656. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  657. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  658. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  659. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  660. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  661. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  662. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  663. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  664. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  665. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  666. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  667. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  668. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  669. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  670. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  671. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  672. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  673. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  674. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  675. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  676. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  677. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  678. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  679. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  680. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  681. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  682. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  683. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  684. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  685. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  686. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  687. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  688. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  689. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  690. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  691. package/.versions/2.0.7/.version +1 -0
  692. package/.versions/2.0.7/agents/architect.md +25 -0
  693. package/.versions/2.0.7/agents/bowser.md +28 -0
  694. package/.versions/2.0.7/agents/builder.md +56 -0
  695. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  696. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  697. package/.versions/2.0.7/agents/documenter.md +23 -0
  698. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  699. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  700. package/.versions/2.0.7/agents/planner.md +106 -0
  701. package/.versions/2.0.7/agents/releaser.md +25 -0
  702. package/.versions/2.0.7/agents/researcher.md +31 -0
  703. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  704. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  705. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  706. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  707. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  708. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  709. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  710. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  711. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  712. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  713. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  714. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  715. package/.versions/2.0.7/docs/getting-started.md +126 -0
  716. package/.versions/2.0.7/docs/npm-install.md +327 -0
  717. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  718. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  719. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  720. package/.versions/2.0.7/hermes/README.md +347 -0
  721. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  722. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  723. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  724. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  725. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  726. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  727. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  728. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  729. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  730. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  731. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  732. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  733. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  734. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  735. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  736. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  737. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  738. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  739. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  740. package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  741. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  742. package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  743. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  744. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  745. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  746. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  747. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  748. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  749. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  750. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  751. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  752. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  753. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  754. package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
  755. package/.versions/2.0.7/install-manifest.json +2886 -0
  756. package/.versions/2.0.7/justfile +247 -0
  757. package/.versions/2.0.7/manifest-meta.json +958 -0
  758. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  759. package/.versions/2.0.7/references/communication-contract.md +26 -0
  760. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  761. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  762. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  763. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  764. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  765. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  766. package/.versions/2.0.7/references/security-checklist.md +179 -0
  767. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  768. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  769. package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
  770. package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
  771. package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
  772. package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
  773. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  774. package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
  775. package/.versions/2.0.7/scripts/fleet.ts +216 -0
  776. package/.versions/2.0.7/scripts/flow.ts +137 -0
  777. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  778. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  779. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  780. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  781. package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
  782. package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
  783. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  784. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  785. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  786. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  787. package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
  788. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  789. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  790. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  791. package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
  792. package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  793. package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  794. package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  795. package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  796. package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  797. package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  798. package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  799. package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
  800. package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
  801. package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
  802. package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
  803. package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
  804. package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
  805. package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
  806. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  807. package/.versions/2.0.7/scripts/package.json +9 -0
  808. package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
  809. package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
  810. package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
  811. package/.versions/2.0.7/scripts/team-up.ts +378 -0
  812. package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
  813. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  814. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  815. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  816. package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
  817. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  818. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  819. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  820. package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
  821. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  822. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  823. package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
  824. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  825. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  826. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  827. package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
  828. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  829. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  830. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  831. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  832. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  833. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  834. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  835. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  836. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  837. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  838. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  839. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  840. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  841. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  842. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  843. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  844. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  845. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  846. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  847. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  848. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  849. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  850. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  851. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  852. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  853. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  854. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  855. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  856. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  857. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  858. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  859. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  860. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  861. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  862. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  863. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  864. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  865. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  866. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  867. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  868. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  869. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  870. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  871. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  872. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  873. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  874. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  875. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  876. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  877. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  878. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  879. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  880. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  881. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  882. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  883. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  884. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  885. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  886. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  887. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  888. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  889. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  890. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  891. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  892. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  893. package/CHANGELOG.md +31 -0
  894. package/README.md +26 -21
  895. package/bin/catalog/harness-runtime-closure.json +1 -6
  896. package/bin/cli.js +149 -78
  897. package/bin/lib/apply.js +53 -62
  898. package/bin/lib/desired.js +2 -2
  899. package/bin/lib/features.js +10 -3
  900. package/bin/lib/public-plan.js +17 -0
  901. package/bin/lib/purge.js +9 -3
  902. package/bin/lib/reconcile.js +4 -10
  903. package/bin/lib/repair-desired.js +73 -0
  904. package/bin/lib/stt-wizard.js +25 -11
  905. package/bin/lib/transaction.js +118 -108
  906. package/bin/lib/tui.js +70 -65
  907. package/bin/lib/update-notifier.js +2 -2
  908. package/bin/lib/workspace-safety.js +72 -0
  909. package/bin/snapshot-version.js +1 -2
  910. package/codex/fleet-session-client/SKILL.md +34 -0
  911. package/codex/fleet-session-client.zip +0 -0
  912. package/docs/ARCHITECTURE.md +4 -4
  913. package/docs/MIGRATION-agent-fleet.md +2 -2
  914. package/docs/assets/branding/README.md +33 -0
  915. package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
  916. package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
  917. package/docs/codex-session-bridge.md +219 -0
  918. package/docs/coms-hermes-bridge.md +4 -5
  919. package/docs/getting-started.md +2 -0
  920. package/docs/npm-install.md +44 -16
  921. package/docs/pi-extensions.md +3 -3
  922. package/docs/pi-setup.md +4 -2
  923. package/hermes/README.md +1 -1
  924. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
  925. package/install-manifest.json +54 -110
  926. package/justfile +3 -45
  927. package/manifest-meta.json +52 -63
  928. package/package.json +10 -7
  929. package/scripts/coms-cli.ts +2 -61
  930. package/scripts/fleet-codex-client.ts +69 -0
  931. package/scripts/fleet-codex-read.py +146 -0
  932. package/scripts/fleet.ts +1 -7
  933. package/scripts/lib/fleet-codex-catalog.ts +63 -0
  934. package/scripts/lib/fleet-codex-operations.ts +190 -0
  935. package/scripts/lib/fleet-codex-session.ts +166 -0
  936. package/scripts/lib/fleet-codex-transport.ts +124 -0
  937. package/scripts/lib/fleet-command.ts +5 -23
  938. package/scripts/lib/team-project.ts +15 -50
  939. package/scripts/team-up.ts +6 -34
  940. package/codex/CONDUCTOR.md +0 -148
  941. package/docs/codex-remote-conductor.md +0 -170
  942. package/scripts/codex-conductor.ts +0 -41
  943. package/scripts/codex-remote-control.ts +0 -167
  944. package/scripts/lib/codex-conductor.ts +0 -88
  945. package/scripts/lib/codex-remote-control.ts +0 -482
  946. package/systemd/user/agent-fleet-codex-remote-control.service.in +0 -23
  947. /package/{.pi → .versions/2.0.6/.pi}/extensions/agent-fleet-update-check/README.md +0 -0
  948. /package/{.pi → .versions/2.0.6/.pi}/extensions/agent-fleet-update-check/index.ts +0 -0
  949. /package/{.pi → .versions/2.0.6/.pi}/extensions/agent-fleet-update-check/package.json +0 -0
package/bin/lib/apply.js CHANGED
@@ -28,6 +28,7 @@ import { itemsForAgent } from "./manifest.js";
28
28
  import { expandBinding } from "./verify.js";
29
29
  import { extractRegion, replaceRegion, stripRegion, leafPaths, setPath, canonicalJson } from "./merge-forms.js";
30
30
  import { runTransaction } from "./transaction.js";
31
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
31
32
  import { renderDesired } from "./desired.js";
32
33
  import {
33
34
  readState, writeState, emptyState, hashFile, hashText, walkTree,
@@ -35,26 +36,35 @@ import {
35
36
  } from "./state.js";
36
37
 
37
38
  export const APPLY_SCHEMA_VERSION = 1;
39
+ export const EXEC_TIMEOUT_MS = 120_000;
38
40
 
39
- /** Retry only commands recorded after a previous post-commit runtime failure. */
40
- export function retryRuntimeRepairs({ workspace, output = console.log }) {
41
+ function manifestExec(manifest, agent, id) {
42
+ const item = itemsForAgent(manifest, agent).find((entry) => entry.id === id);
43
+ if (!item?.exec) throw new Error(`runtime repair ${id} is not authorized by the current manifest`);
44
+ return item.exec;
45
+ }
46
+ export function runTrustedExec({ workspace, spec, output, timeoutMs = EXEC_TIMEOUT_MS }) {
47
+ const display = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
48
+ output(`starting ${display} (timeout ${timeoutMs}ms)`);
49
+ const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8", timeout: timeoutMs });
50
+ output(run.status === 0 ? `completed ${display}` : `failed ${display}`);
51
+ return { run, display };
52
+ }
53
+
54
+ /** Retry only action IDs still authorized by the trusted current manifest. */
55
+ export function retryRuntimeRepairs({ workspace, manifest, output = console.log }) {
41
56
  const state = readState(workspace);
42
57
  const pending = state?.runtimeRepairs ?? [];
43
58
  if (pending.length === 0) return { attempted: 0, remaining: [] };
44
-
45
59
  const remaining = [];
46
60
  for (const repair of pending) {
47
- const command = `${repair.command} ${(repair.args ?? []).join(" ")}`.trim();
48
- output(command);
49
- const run = spawnSync(repair.command, repair.args ?? [], {
50
- cwd: insideWorkspace(workspace, repair.cwd ?? "."), stdio: "pipe", encoding: "utf8",
51
- });
52
- if (run.status !== 0) {
53
- remaining.push({ ...repair, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
54
- }
61
+ let spec;
62
+ try { spec = manifestExec(manifest, state.agent, repair.id); }
63
+ catch (error) { remaining.push({ id: repair.id, status: "unauthorized", detail: error.message }); continue; }
64
+ const { run, display } = runTrustedExec({ workspace, spec, output });
65
+ if (run.status !== 0) remaining.push({ id: repair.id, args: spec.args ?? [], cwd: spec.cwd ?? ".", display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
55
66
  }
56
- state.runtimeRepairs = remaining;
57
- writeState(workspace, state);
67
+ state.runtimeRepairs = remaining; writeState(workspace, state);
58
68
  return { attempted: pending.length, remaining };
59
69
  }
60
70
 
@@ -68,7 +78,7 @@ export function retryRuntimeRepairs({ workspace, output = console.log }) {
68
78
  * @param {() => string} [opts.now] injectable clock, for deterministic tests
69
79
  * @returns {object} result
70
80
  */
71
- export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null }) {
81
+ export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null, lockHeld = false }) {
72
82
  const validate = () => {
73
83
  if (plan.migrationBlocked) throw Object.assign(new Error(plan.migrationError), { exitCode: 1 });
74
84
  if (plan.snapshotMetadataError) throw Object.assign(new Error(plan.snapshotMetadataError), { exitCode: 1 });
@@ -76,37 +86,34 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
76
86
  };
77
87
  let result;
78
88
  try {
79
- result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, commit: () => {
80
- if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired));
81
- if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text);
82
- if (plan.stt) {
83
- writeFileSyncDeep(plan.stt.path, plan.stt.text);
84
- if (plan.stt.env.missing.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text);
85
- }
89
+ result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, lockHeld, commit: () => {
90
+ if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired), plan.workspace);
91
+ if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text, plan.workspace);
92
+ if (plan.stt?.write) writeFileSyncDeep(plan.stt.path, plan.stt.text, plan.workspace);
93
+ if (plan.stt?.env?.missing?.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text, plan.workspace);
86
94
  return applyImmediate({ plan, manifest, allowExec: false, now });
87
95
  } });
88
96
  } catch (error) {
97
+ const status = error.postCommit ? "committed-cleanup-incomplete" : error.rollbackFailed ? "rollback-failed" : "rolled-back";
89
98
  return { schemaVersion: APPLY_SCHEMA_VERSION, workspace: plan.workspace, verb: plan.verb,
90
- results: [], conflictFiles: [], failure: { status: "failed", detail: error.message },
91
- exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1 } };
99
+ results: [], conflictFiles: [], failure: { status, detail: error.message },
100
+ exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1, notReached: 0 } };
92
101
  }
93
102
  if (!allowExec) return { ...result, exitCode: 0 };
94
103
 
95
104
  const repairs = [];
96
105
  for (const action of plan.actions.filter((entry) => entry.kind === "exec")) {
97
- const item = new Map(itemsForAgent(manifest, plan.agent).map((entry) => [entry.id, entry])).get(action.id);
98
- const spec = item?.exec;
99
- if (!spec) continue;
100
- const command = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
101
- output(command);
102
- const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(plan.workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8" });
103
- if (run.status !== 0) repairs.push({ id: action.id, command: spec.command, args: spec.args ?? [], cwd: spec.cwd ?? ".", display: command, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
106
+ const spec = manifestExec(manifest, plan.agent, action.id);
107
+ const { run, display } = runTrustedExec({ workspace: plan.workspace, spec, output });
108
+ if (run.status !== 0) repairs.push({ id: action.id, display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
104
109
  }
105
110
  if (repairs.length) {
106
111
  const state = readState(plan.workspace);
107
112
  state.runtimeRepairs = repairs;
108
113
  writeState(plan.workspace, state);
109
- return { ...result, exitCode: 1, runtimeRepairs: repairs };
114
+ return { ...result, exitCode: 1, runtimeRepairs: repairs,
115
+ failure: { id: repairs[0].id, status: "runtime-incomplete", detail: `files committed; ${repairs.length} runtime command(s) failed or timed out` },
116
+ summary: { ...result.summary, failed: repairs.length } };
110
117
  }
111
118
  const results = result.results.map((entry) => plan.actions.some((action) => action.id === entry.id && action.kind === "exec")
112
119
  ? { ...entry, status: "applied", detail: "command ran after file commit" }
@@ -114,7 +121,7 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
114
121
  return { ...result, results, exitCode: 0, runtimeRepairs: [] };
115
122
  }
116
123
 
117
- function applyImmediate({ plan, manifest, allowExec = false, now = () => new Date().toISOString() }) {
124
+ function applyImmediate({ plan, manifest, now = () => new Date().toISOString() }) {
118
125
  const { workspace, sourceRoot, agent, method, packageVersion } = plan;
119
126
  const catalogue = new Map(itemsForAgent(manifest, agent).map((i) => [i.id, i]));
120
127
  const previous = readState(workspace);
@@ -142,7 +149,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
142
149
  try {
143
150
  const outcome = perform({
144
151
  action, item: catalogue.get(action.id), state, workspace, sourceRoot,
145
- method, agent, allowExec, now,
152
+ method, agent, now,
146
153
  });
147
154
  results.push({ id: action.id, action: action.kind, ...outcome });
148
155
  if (outcome.conflicts) conflictFiles.push(...outcome.conflicts);
@@ -202,7 +209,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
202
209
 
203
210
  // ── one action ──────────────────────────────────────────────────────────────
204
211
 
205
- function perform({ action, item, state, workspace, sourceRoot, method, agent, allowExec, now }) {
212
+ function perform({ action, item, state, workspace, sourceRoot, method, agent, now }) {
206
213
  switch (action.kind) {
207
214
  case "create":
208
215
  case "refresh":
@@ -263,25 +270,10 @@ function perform({ action, item, state, workspace, sourceRoot, method, agent, al
263
270
  case "remove":
264
271
  return removeItem({ id: action.id, state, workspace, sourceRoot });
265
272
 
266
- case "exec": {
267
- if (!allowExec) return { status: "skipped", detail: "exec not permitted" };
268
- const spec = item?.exec;
269
- if (!spec) return { status: "skipped", detail: "no exec specification" };
270
- const cwd = insideWorkspace(workspace, spec.cwd ?? ".");
271
- const run = spawnSync(spec.command, spec.args ?? [], { cwd, stdio: "pipe", encoding: "utf8" });
272
- if (run.status !== 0) {
273
- throw new Error(
274
- `${spec.command} ${(spec.args ?? []).join(" ")} exited ${run.status ?? "on signal"}: ` +
275
- `${(run.stderr ?? "").trim().split("\n").slice(-3).join(" ") || "no output"}`,
276
- );
277
- }
278
- state.items[action.id] = {
279
- kind: item.kind, strategy: "exec", method: "exec",
280
- version: state.packageVersion, files: [],
281
- lastRun: { at: now(), command: `${spec.command} ${(spec.args ?? []).join(" ")}`.trim() },
282
- };
283
- return { status: "applied", detail: "command ran" };
284
- }
273
+ case "exec":
274
+ // Runtime execution happens only after the durable file commit through
275
+ // runTrustedExec(), which owns timeout/progress/failure reporting.
276
+ return { status: "skipped", detail: "exec deferred until after file commit" };
285
277
 
286
278
  case "external": {
287
279
  const spec = item?.package;
@@ -501,7 +493,7 @@ function writeManagedRegion({ binding, workspace, sourceRoot }) {
501
493
 
502
494
  const targetAbs = insideWorkspace(workspace, binding.target);
503
495
  const existing = existsSync(targetAbs) ? readFileSync(targetAbs, "utf8") : "";
504
- writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block));
496
+ writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block), workspace);
505
497
 
506
498
  return {
507
499
  files: [{
@@ -537,7 +529,7 @@ function mergeJson({ binding, workspace, sourceRoot }) {
537
529
  sha256: hashText(canonicalJson(value)),
538
530
  });
539
531
  }
540
- writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n");
532
+ writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n", workspace);
541
533
 
542
534
  return { files: [], jsonKeys };
543
535
  }
@@ -555,7 +547,7 @@ function writeConflictCopies({ item, action, workspace, sourceRoot, agent }) {
555
547
  const emit = (targetRel, contents) => {
556
548
  if (!conflicted.has(targetRel)) return;
557
549
  const dest = insideWorkspace(workspace, `${targetRel}.new`);
558
- writeFileSyncDeep(dest, contents);
550
+ writeFileSyncDeep(dest, contents, workspace);
559
551
  written.push(`${targetRel}.new`);
560
552
  };
561
553
 
@@ -673,7 +665,7 @@ updated: ${state.updatedAt.slice(0, 10)}
673
665
  - No secrets are stored in this file or in ${STATE_REL_PATH}.
674
666
  `;
675
667
  const path = join(workspace, LEGACY_RECORD_REL_PATH);
676
- writeFileSyncDeep(path, text);
668
+ writeFileSyncDeep(path, text, workspace);
677
669
  return path;
678
670
  }
679
671
 
@@ -686,13 +678,12 @@ updated: ${state.updatedAt.slice(0, 10)}
686
678
  */
687
679
  function insideWorkspace(workspace, rel) {
688
680
  const abs = resolve(workspace, rel);
689
- if (!isInside(workspace, abs)) {
690
- throw new Error(`refusing to write outside the workspace: ${rel}`);
691
- }
692
- return abs;
681
+ if (!isInside(workspace, abs)) throw new Error(`refusing to write outside the workspace: ${rel}`);
682
+ return assertSafeWorkspaceTarget(workspace, abs);
693
683
  }
694
684
 
695
- function writeFileSyncDeep(abs, contents) {
685
+ function writeFileSyncDeep(abs, contents, workspace = null) {
686
+ if (workspace) assertSafeWorkspaceTarget(workspace, abs, { allowLeafSymlink: false });
696
687
  mkdirSync(dirname(abs), { recursive: true });
697
688
  writeFileSync(abs, contents);
698
689
  }
@@ -2,7 +2,7 @@
2
2
 
3
3
  import { existsSync, readFileSync } from "node:fs";
4
4
  import { join } from "node:path";
5
- import { featureNames, normalizeFeatureSet } from "./features.js";
5
+ import { featureNames, normalizeFeatureSet, retiredFeatureError } from "./features.js";
6
6
 
7
7
  export const DESIRED_SCHEMA_VERSION = 1;
8
8
  export const DESIRED_FILE = ".ai/agent-fleet.json";
@@ -22,7 +22,7 @@ export function validateDesired(value, manifest) {
22
22
  if (!value.features || typeof value.features !== "object" || Array.isArray(value.features)) throw new Error("desired features must be an object");
23
23
  const known = new Set(featureNames(manifest));
24
24
  for (const [name, enabled] of Object.entries(value.features)) {
25
- if (!known.has(name)) throw new Error(`unknown feature "${name}"`);
25
+ if (!known.has(name)) throw new Error(retiredFeatureError(name) ?? `unknown feature "${name}"`);
26
26
  if (typeof enabled !== "boolean") throw new Error(`desired feature "${name}" must be boolean`);
27
27
  }
28
28
  return {
@@ -6,13 +6,20 @@ export function featureNames(manifest) {
6
6
  return Object.keys(manifest.features ?? {}).sort();
7
7
  }
8
8
 
9
+ export function retiredFeatureError(name) {
10
+ if (name === "codex-remote") {
11
+ return 'retired feature "codex-remote": the Codex Remote-Control conductor is no longer packaged. Opt in explicitly with --features chatgpt-client. No mutation was applied.';
12
+ }
13
+ return null;
14
+ }
15
+
9
16
  export function normalizeFeatureSet(manifest, features) {
10
17
  const known = new Set(featureNames(manifest));
11
18
  const values = typeof features === "string"
12
- ? (features === "none" ? [] : features.split(",").filter(Boolean))
13
- : (features ?? []);
19
+ ? (features.trim().toLowerCase() === "none" ? [] : features.split(",").map((name) => name.trim()).filter(Boolean))
20
+ : (features ?? []).map((name) => typeof name === "string" ? name.trim() : name).filter(Boolean);
14
21
  for (const feature of values) {
15
- if (!known.has(feature)) throw new Error(`unknown feature "${feature}"`);
22
+ if (!known.has(feature)) throw new Error(retiredFeatureError(feature) ?? `unknown feature "${feature}"`);
16
23
  }
17
24
  return [...new Set(values)].sort();
18
25
  }
@@ -0,0 +1,17 @@
1
+ // Explicit public serialization boundary: write buffers never cross stdout/stderr.
2
+ const SECRET_BEARING_KEYS = new Set(["text", "original", "replacement", "before", "after", "backup"]);
3
+ export const PUBLIC_PLAN_SCHEMA_VERSION = 1;
4
+ function safe(value, key = "") {
5
+ if (SECRET_BEARING_KEYS.has(key)) return undefined;
6
+ if (Array.isArray(value)) return value.map((item) => safe(item)).filter((item) => item !== undefined);
7
+ if (!value || typeof value !== "object") return value;
8
+ if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) return undefined;
9
+ return Object.fromEntries(Object.entries(value).flatMap(([name, item]) => {
10
+ const cleaned = safe(item, name); return cleaned === undefined ? [] : [[name, cleaned]];
11
+ }));
12
+ }
13
+ export function publicPlan(plan, stage = "preview") { return { ...safe(plan), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
14
+ export function publicResult(result, stage = "apply") { return { ...safe(result), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
15
+ export function publicRepairPreview(proposal) {
16
+ return { publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage: "config-repair-preview", configRepair: { path: proposal.path, removed: proposal.removed, requiresApproval: true, nextStep: "Run setup interactively, or setup --yes --repair-config. No mutation was applied." } };
17
+ }
package/bin/lib/purge.js CHANGED
@@ -1,11 +1,17 @@
1
1
  // purge.js — explicit human-config boundary for state-owned uninstall.
2
2
  import { existsSync, rmSync } from "node:fs";
3
3
  import { join } from "node:path";
4
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
4
5
 
5
6
  const HUMAN_CONFIG = [".ai/agent-fleet.json", ".ai/agent-fleet-overrides.md", ".ai/stt.json"];
6
- export function purgeHumanConfig(workspace, { purgeConfig = false } = {}) {
7
- if (!purgeConfig) return { removed: [], preserved: HUMAN_CONFIG.filter((path) => existsSync(join(workspace, path))) };
7
+ export function purgeHumanConfig(workspace, { purgeConfig = false, dryRun = false } = {}) {
8
+ const present = HUMAN_CONFIG.filter((path) => {
9
+ const target = assertSafeWorkspaceTarget(workspace, path, { allowLeafSymlink: false });
10
+ return existsSync(target);
11
+ });
12
+ if (!purgeConfig) return { removed: [], preserved: present };
13
+ if (dryRun) return { removed: [], wouldRemove: present, preserved: present };
8
14
  const removed = [];
9
- for (const path of HUMAN_CONFIG) if (existsSync(join(workspace, path))) { rmSync(join(workspace, path), { force: true }); removed.push(path); }
15
+ for (const path of present) { rmSync(join(workspace, path), { force: true }); removed.push(path); }
10
16
  return { removed, preserved: [] };
11
17
  }
@@ -8,14 +8,14 @@ import { buildPlan } from "./plan.js";
8
8
  import { readState } from "./state.js";
9
9
  import { scanProject } from "./scan.js";
10
10
  import { planOverrides } from "./overrides.js";
11
- import { appendEnvPlaceholders, renderSttConfig } from "./stt-wizard.js";
11
+ import { planStt } from "./stt-wizard.js";
12
12
 
13
13
  /** Build one setup plan. This function writes nothing. */
14
14
  export function buildReconcilePlan(opts) {
15
15
  const { workspace, manifest, sourceRoot, packageVersion, agent = "pi", method,
16
16
  preset, features, saveDesired = false, tuiDesired = null, dryRun = false,
17
17
  migrate = false, yes = false, accept = null, allowExec = false,
18
- platform = process.platform } = opts;
18
+ sttProvider = null, sttReplacementApproved = false, platform = process.platform } = opts;
19
19
  const state = readState(workspace);
20
20
  const desiredPath = join(workspace, DESIRED_FILE);
21
21
  const firstMigration = Boolean(state && !existsSync(desiredPath));
@@ -37,13 +37,7 @@ export function buildReconcilePlan(opts) {
37
37
  method, items: featureResult.roots, accept, allowExec, platform });
38
38
  const wanted = new Set(featureResult.selected);
39
39
  const overrides = planOverrides(workspace, scanProject(workspace));
40
- const sttConfig = featureResult.features.includes("voice")
41
- ? { provider: "openai", apiKeyEnv: "OPENAI_API_KEY" }
42
- : null;
43
- const stt = sttConfig ? {
44
- path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(sttConfig),
45
- env: appendEnvPlaceholders(workspace, sttConfig),
46
- } : null;
40
+ const stt = featureResult.features.includes("voice") ? planStt(workspace, sttProvider, { replacementApproved: sttReplacementApproved }) : null;
47
41
  const recorded = Object.keys(state?.items ?? {});
48
42
  const removals = recorded.filter((id) => !wanted.has(id)).sort().map((id) => ({
49
43
  kind: "remove", id, itemKind: state.items[id].kind ?? "unknown", consent: "file", state: "owned",
@@ -60,7 +54,7 @@ export function buildReconcilePlan(opts) {
60
54
  migrationError: migrationBlocked
61
55
  ? "first migration requires --migrate --preset <default|full> --features <exact-set> --yes"
62
56
  : null,
63
- selection: { ...base.selection, desired: featureResult, resolved: featureResult.selected },
57
+ selection: { ...base.selection, desired: { ...featureResult, requestedFeatures: Object.entries(desiredResult.desired.features).filter(([, enabled]) => enabled).map(([name]) => name).sort() }, resolved: featureResult.selected },
64
58
  actions, conflicts,
65
59
  overrides,
66
60
  stt,
@@ -0,0 +1,73 @@
1
+ // Explicit, narrowly scoped repair of known retired desired-state features.
2
+ import { existsSync, readFileSync, lstatSync, writeFileSync, renameSync, unlinkSync } from "node:fs";
3
+ import { randomUUID } from "node:crypto";
4
+ import { join } from "node:path";
5
+ import { DESIRED_FILE, validateDesired } from "./desired.js";
6
+ import { retiredFeatureError } from "./features.js";
7
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
8
+ import { publicRepairPreview } from "./public-plan.js";
9
+
10
+ export function inspectDesiredRepair(workspace, manifest) {
11
+ const path = assertSafeWorkspaceTarget(workspace, DESIRED_FILE, { allowLeafSymlink: false });
12
+ if (!existsSync(path)) return null;
13
+ const original = readFileSync(path, "utf8");
14
+ let value;
15
+ try { value = JSON.parse(original); }
16
+ catch { throw new Error(`invalid desired config ${DESIRED_FILE}: invalid JSON; manual repair required`); }
17
+ const candidate = structuredClone(value);
18
+ const removed = [];
19
+ if (candidate?.features && typeof candidate.features === "object" && !Array.isArray(candidate.features)) {
20
+ for (const [name, enabled] of Object.entries(candidate.features)) {
21
+ if (!manifest.features?.[name] && retiredFeatureError(name) && typeof enabled === "boolean") {
22
+ removed.push({ name, value: enabled });
23
+ delete candidate.features[name];
24
+ }
25
+ }
26
+ }
27
+ // Never offer a partial repair of an otherwise invalid configuration.
28
+ validateDesired(candidate, manifest);
29
+ if (!removed.length) return null;
30
+ if (!lstatSync(path).isFile()) throw new Error(`cannot repair non-regular config ${DESIRED_FILE}`);
31
+ return { path, original, replacement: JSON.stringify(candidate, null, 2) + "\n", removed };
32
+ }
33
+
34
+ export function describeDesiredRepair(proposal) {
35
+ return `Retired settings found in ${DESIRED_FILE}:\n${proposal.removed.map(({ name, value }) => `- ${JSON.stringify(name)}: ${value}`).join("\n")}\nProposed repair: remove only these settings. Other settings are preserved.\nchatgpt-client will NOT be enabled automatically.\nA backup will be saved before the repair. This repair is separate from the subsequent setup plan.`;
36
+ }
37
+
38
+ export function applyDesiredRepair(proposal) {
39
+ const { path, original, replacement } = proposal;
40
+ const unchanged = () => {
41
+ if (!lstatSync(path).isFile() || readFileSync(path, "utf8") !== original) {
42
+ throw new Error("desired config changed since repair was proposed; rerun setup");
43
+ }
44
+ };
45
+ unchanged();
46
+ const id = randomUUID();
47
+ const backup = `${path}.backup-${id}`;
48
+ const temporary = `${path}.repair-${id}`;
49
+ writeFileSync(backup, original, { flag: "wx", mode: 0o600 });
50
+ try {
51
+ writeFileSync(temporary, replacement, { flag: "wx", mode: lstatSync(path).mode & 0o777 });
52
+ unchanged();
53
+ renameSync(temporary, path);
54
+ } finally {
55
+ if (existsSync(temporary)) unlinkSync(temporary);
56
+ }
57
+ return backup;
58
+ }
59
+
60
+ export async function prepareDesiredRepair({ workspace, manifest, dryRun, approved, interactive, output, confirm }) {
61
+ const proposal = inspectDesiredRepair(workspace, manifest);
62
+ if (!proposal) return { repaired: false };
63
+ if (dryRun) return { repaired: false, preview: publicRepairPreview(proposal) };
64
+ output.write(describeDesiredRepair(proposal) + "\n");
65
+ if (!approved) {
66
+ if (!interactive) throw new Error("Config repair requires explicit approval: rerun setup interactively or with --yes --repair-config. No mutation was applied.");
67
+ const answer = await confirm("Apply this config repair now? yes/y | no/n; Enter = no (cancel; backup is created only after yes) > ");
68
+ if (answer === null || !/^y(es)?$/i.test(answer.trim())) return { repaired: false, cancelled: true };
69
+ }
70
+ const backup = applyDesiredRepair(proposal);
71
+ output.write(`Config repaired. Original saved to ${backup}\n`);
72
+ return { repaired: true, backup };
73
+ }
@@ -1,28 +1,32 @@
1
- // Non-secret STT configuration. Values are env-var names only.
1
+ // Human-owned, non-secret STT configuration. Installer prompts for provider/env names, never values.
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
 
5
- const PROVIDERS = {
5
+ export const STT_PROVIDERS = {
6
6
  openai: { apiKeyEnv: "OPENAI_API_KEY" },
7
7
  groq: { apiKeyEnv: "GROQ_API_KEY" },
8
8
  azure: { apiKeyEnv: "AZURE_OPENAI_API_KEY", endpointEnv: "AZURE_OPENAI_ENDPOINT" },
9
9
  };
10
-
11
10
  export function validateSttConfig(value) {
12
- const spec = PROVIDERS[value?.provider];
13
- if (!spec) throw new Error(`unsupported STT provider "${value?.provider}"`);
14
- for (const key of ["apiKeyEnv", ...(spec.endpointEnv ? ["endpointEnv"] : [])]) {
15
- if (value[key] !== spec[key]) throw new Error(`${key} must be ${spec[key]} for ${value.provider}`);
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`);
16
15
  }
17
16
  for (const [key, item] of Object.entries(value)) {
18
17
  if (/key|token|secret|password/i.test(key) && !/Env$/.test(key)) throw new Error(`STT config must not store ${key}`);
19
- if (typeof item === "string" && /sk-[A-Za-z0-9]|AIza|ghp_/i.test(item)) throw new Error("STT config must not store secret values");
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");
20
19
  }
21
- return { provider: value.provider, apiKeyEnv: spec.apiKeyEnv, ...(spec.endpointEnv ? { endpointEnv: spec.endpointEnv } : {}) };
20
+ return structuredClone(value); // unknown human-owned fields are valid and preserved.
22
21
  }
23
-
24
22
  export function renderSttConfig(value) { return JSON.stringify(validateSttConfig(value), null, 2) + "\n"; }
25
-
23
+ export function readSttConfig(workspace) {
24
+ const path = join(workspace, ".ai", "stt.json");
25
+ if (!existsSync(path)) return null;
26
+ 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`); }
29
+ }
26
30
  /** Append empty placeholders only for variables not already declared. */
27
31
  export function appendEnvPlaceholders(workspace, config) {
28
32
  const path = join(workspace, ".env");
@@ -31,3 +35,13 @@ export function appendEnvPlaceholders(workspace, config) {
31
35
  const missing = names.filter((name) => !new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`, "m").test(before));
32
36
  return { path, text: missing.length ? `${before}${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : before, missing };
33
37
  }
38
+ export function planStt(workspace, provider, { replacementApproved = false } = {}) {
39
+ 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) };
42
+ }
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) };
47
+ }