@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -12,62 +12,205 @@ import { credentialResolve } from '../services/credential-store.js';
12
12
  import { encryptPassword, decryptPassword } from '../utils/crypto.js';
13
13
  import { updateAgent } from '../services/registry.js';
14
14
  import { collectOobApiKey } from '../services/auth-socket.js';
15
- import { logLine } from '../utils/log-helpers.js';
15
+ import { logLine, logWarn } from '../utils/log-helpers.js';
16
+ import { findSecretTokens, legacyTokenWarning } from '../services/secret-token.js';
16
17
  import { invalidatePreflightCache } from '../services/preflight-check.js';
18
+ import { stageEnvVars, writeMemberSecretFile, removeMemberSecretFile, SecretDeliveryError } from '../services/member-secret-env.js';
17
19
  export const provisionAuthSchema = z.object({
18
20
  ...memberIdentifier,
19
- api_key: z.string().optional().describe(`Your AI provider API key. If omitted, your local OAuth session is copied to the member instead. Supports {{secure.NAME}} token — value is resolved from the credential store before use.`),
21
+ api_key: z.string().optional().describe(`Your AI provider API key or Claude Code OAuth token (sk-ant-oat..., from \`claude setup-token\`). If omitted, a credential already stored for the member is re-deployed, else your local OAuth session is copied to the member. Supports {{secret.NAME}} token -- value is resolved from the credential store before use.`),
22
+ force_oauth_copy: z.boolean().optional().describe(`Only without api_key: copy your local OAuth session even when the member has a stored env credential, and clear that credential (ANTHROPIC_API_KEY / CLAUDE_CODE_OAUTH_TOKEN) so the copied login applies. Default false.`),
23
+ clear_stored_credentials: z.boolean().optional().describe('Remove ALL credential env vars stored for this member in the fleet registry (what every dispatch delivers to it), and do nothing else. '
24
+ + 'Registry only: works for relay, offline and local members, and never contacts the member (values already written to its shell profile or user environment stay). '
25
+ + 'Use it when a dispatch fails with reason secret_delivery_unavailable and the credential is provided on that machine itself. Cannot be combined with api_key or force_oauth_copy.'),
20
26
  });
27
+ const OK_REASONS = ['ok', 'deployed_unverified', 'deployed_with_errors', 'skipped_local_member', 'stored_credentials_cleared'];
21
28
  /**
22
- * Real auth check via `claude -p "hello"` — makes an actual API call.
29
+ * Resolve a provider's display name for the structured payload without ever
30
+ * throwing (apra-fleet-3swo.9). getProvider() throws a TypeError for any
31
+ * llmProvider value outside the six registered adapters, and only defaults
32
+ * to claude when the value is null/undefined -- so a registry entry carrying
33
+ * a retired or hand-edited provider string would otherwise turn the
34
+ * local-member skip and offline early-returns below into a thrown MCP
35
+ * protocol error (wrapTool has no try/catch) instead of their intended clean
36
+ * message. Falls back to the raw stored value, or null when there is none.
37
+ */
38
+ function safeProviderName(llmProvider) {
39
+ try {
40
+ return getProvider(llmProvider).name;
41
+ }
42
+ catch {
43
+ return llmProvider ?? null;
44
+ }
45
+ }
46
+ function authResult(text, fields) {
47
+ return {
48
+ text,
49
+ structuredContent: {
50
+ ok: fields.ok ?? OK_REASONS.includes(fields.reason),
51
+ reason: fields.reason,
52
+ provider: fields.provider ?? null,
53
+ credentialLabel: fields.credentialLabel ?? null,
54
+ expiresAt: fields.expiresAt ?? null,
55
+ verified: fields.verified ?? false,
56
+ memberId: fields.memberId ?? null,
57
+ memberName: fields.memberName ?? null,
58
+ },
59
+ };
60
+ }
61
+ /**
62
+ * Credential-file expiry, normalized to ISO, or null when the file exposes
63
+ * none. Mirrors validateCredentials()'s own (Claude-shaped) parse rather than
64
+ * inventing a second convention; any provider whose credential JSON has no
65
+ * such field simply yields null, which reads as "no expiry tracked -> OK".
66
+ */
67
+ function extractCredentialExpiresAt(json) {
68
+ try {
69
+ const parsed = JSON.parse(json);
70
+ const raw = parsed?.claudeAiOauth?.expiresAt;
71
+ if (raw === undefined || raw === null)
72
+ return null;
73
+ const d = new Date(raw);
74
+ return Number.isNaN(d.getTime()) ? null : d.toISOString();
75
+ }
76
+ catch {
77
+ return null;
78
+ }
79
+ }
80
+ /** Post-provision auth test bounds: inactivity timeout and hard wall-clock cap. */
81
+ export const AUTH_TEST_IDLE_TIMEOUT_MS = 60_000;
82
+ export const AUTH_TEST_MAX_TOTAL_MS = 90_000;
83
+ const AUTH_ERROR_DETAIL_MAX_CHARS = 300;
84
+ /** Suffix a superseded credential file is renamed to (never deleted). */
85
+ export const SUPERSEDED_CREDENTIAL_SUFFIX = '.fleet-superseded';
86
+ /**
87
+ * Make CLI error text safe and short enough for a tool result: strip the
88
+ * provisioned secret (a shell error can echo the command line that carries it)
89
+ * and anything shaped like an Anthropic credential, force ASCII, collapse
90
+ * whitespace and truncate.
91
+ */
92
+ export function sanitizeAuthErrorDetail(text, secret) {
93
+ let out = text;
94
+ if (secret && secret.length >= 4)
95
+ out = out.split(secret).join('[REDACTED]');
96
+ out = out.replace(/sk-ant-[A-Za-z0-9_-]+/g, 'sk-ant-[REDACTED]');
97
+ out = out.replace(/[^\x20-\x7E]+/g, ' ').replace(/\s+/g, ' ').trim();
98
+ if (out.length > AUTH_ERROR_DETAIL_MAX_CHARS)
99
+ out = `${out.slice(0, AUTH_ERROR_DETAIL_MAX_CHARS)}...`;
100
+ return out;
101
+ }
102
+ /**
103
+ * Turn a `claude -p --output-format json` run into an AuthCheck. A run can
104
+ * exit 0 yet report `is_error: true` (e.g. an invalid key), so both are
105
+ * checked; on failure the CLI's own message (JSON `result`, else stderr,
106
+ * else stdout) becomes the detail.
107
+ */
108
+ export function interpretClaudeAuthResult(result, secret) {
109
+ const stdout = result.stdout ?? '';
110
+ const stderr = result.stderr ?? '';
111
+ let jsonError = null;
112
+ let isError = false;
113
+ const jsonLine = stdout.split(/\r?\n/).map(l => l.trim()).filter(l => l.startsWith('{')).pop();
114
+ if (jsonLine) {
115
+ try {
116
+ const parsed = JSON.parse(jsonLine);
117
+ if (parsed && (parsed.is_error === true || (typeof parsed.subtype === 'string' && parsed.subtype.startsWith('error')))) {
118
+ isError = true;
119
+ jsonError = typeof parsed.result === 'string' && parsed.result.trim() ? parsed.result : String(parsed.subtype ?? 'error');
120
+ }
121
+ }
122
+ catch { /* not JSON -- fall back to the raw streams */ }
123
+ }
124
+ if (result.code === 0 && !isError)
125
+ return { ok: true, detail: null };
126
+ const raw = jsonError ?? (stderr.trim() || stdout.trim() || `CLI exited with code ${result.code}`);
127
+ return { ok: false, detail: sanitizeAuthErrorDetail(raw, secret) };
128
+ }
129
+ /**
130
+ * Real auth check via `claude -p "hello"` -- makes an actual API call.
23
131
  * This is the only reliable validation for both OAuth and API key auth,
24
132
  * since `claude auth status` doesn't actually validate API keys.
25
133
  * Claude-only: other providers use a version check for verification.
134
+ * Bounded by AUTH_TEST_IDLE_TIMEOUT_MS / AUTH_TEST_MAX_TOTAL_MS so a CLI that
135
+ * stalls on a bad credential can never hang the tool.
26
136
  */
27
- async function verifyWithClaudePrompt(agent, envPrefix) {
137
+ async function verifyWithClaudePrompt(agent, env, secret) {
28
138
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
29
139
  const provider = getProvider('claude');
30
140
  const strategy = getStrategy(agent);
31
141
  const escapedFolder = escapeDoubleQuoted(agent.workFolder);
32
- const prefix = envPrefix ? `${envPrefix} ` : '';
33
- const cmd = `cd "${escapedFolder}" && ${prefix}${cmds.agentCommand(provider, '-p "hello" --output-format json --max-turns 1')}`;
142
+ return runWithStagedEnv(agent, env, secret, (prefix) => strategy.execCommand(`${prefix}cd "${escapedFolder}" && ${cmds.agentCommand(provider, '-p "hello" --output-format json --max-turns 1')}`, AUTH_TEST_IDLE_TIMEOUT_MS, AUTH_TEST_MAX_TOTAL_MS), (result) => interpretClaudeAuthResult(result, secret));
143
+ }
144
+ /**
145
+ * Run one verification command with `env` delivered through a staged
146
+ * owner-only file (never inline on the command line) and interpret the FULL
147
+ * exec result (an exit-0 run can still be an auth failure). A delivery or
148
+ * exec failure becomes a sanitized failed AuthCheck.
149
+ */
150
+ async function runWithStagedEnv(agent, env, secret, run, interpret) {
151
+ let stagedPath = null;
152
+ let consumed = false;
34
153
  try {
35
- const result = await strategy.execCommand(cmd, 60000);
36
- return result.code === 0;
154
+ const staged = await stageEnvVars(agent, env ?? {});
155
+ stagedPath = staged.path;
156
+ const result = await run(staged.prefix);
157
+ consumed = result.code === 0;
158
+ return interpret(result);
37
159
  }
38
- catch {
39
- return false;
160
+ catch (err) {
161
+ return { ok: false, detail: sanitizeAuthErrorDetail(String(err?.message ?? err), secret) };
162
+ }
163
+ finally {
164
+ // The prefix deletes the file once loaded; a failed run may not have.
165
+ if (stagedPath && !consumed)
166
+ await removeMemberSecretFile(agent, stagedPath);
40
167
  }
41
168
  }
42
169
  /**
43
- * Version-based CLI check with optional env prefix.
170
+ * Version-based CLI check with optional staged env.
44
171
  * Used to verify non-Claude providers after API key provisioning.
45
172
  */
46
- async function verifyWithVersion(agent, provider, envPrefix) {
173
+ async function verifyWithVersion(agent, provider, env, secret) {
47
174
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
48
175
  const strategy = getStrategy(agent);
49
- const prefix = envPrefix ? `${envPrefix} ` : '';
50
- const cmd = `${prefix}${cmds.agentVersion(provider)}`;
51
- try {
52
- const result = await strategy.execCommand(cmd, 30000);
53
- return result.code === 0;
54
- }
55
- catch {
56
- return false;
57
- }
176
+ return runWithStagedEnv(agent, env, secret, (prefix) => strategy.execCommand(`${prefix}${cmds.agentVersion(provider)}`, 30000, AUTH_TEST_MAX_TOTAL_MS), (result) => {
177
+ if (result.code === 0)
178
+ return { ok: true, detail: null };
179
+ const raw = (result.stderr ?? '').trim() || (result.stdout ?? '').trim() || `CLI exited with code ${result.code}`;
180
+ return { ok: false, detail: sanitizeAuthErrorDetail(raw, secret) };
181
+ });
182
+ }
183
+ /**
184
+ * Drop the named auth env vars from the member's stored encryptedEnvVars
185
+ * (dispatch exports every stored var), keeping every unrelated entry, then
186
+ * merge `extra` in.
187
+ */
188
+ function storeAuthEnvVars(agent, drop, extra) {
189
+ const current = agent.encryptedEnvVars ?? {};
190
+ const kept = Object.fromEntries(Object.entries(current).filter(([k]) => !drop.includes(k)));
191
+ const next = { ...kept, ...(extra ?? {}) };
192
+ const changed = Object.keys(current).length !== Object.keys(next).length
193
+ || Object.entries(next).some(([k, v]) => current[k] !== v);
194
+ if (changed)
195
+ updateAgent(agent.id, { encryptedEnvVars: next });
58
196
  }
59
197
  // ---------------------------------------------------------------------------
60
198
  // Flow A: Copy OAuth credentials using the provider interface
61
199
  // ---------------------------------------------------------------------------
62
- async function provisionOAuthCopy(agent, provider) {
200
+ async function provisionOAuthCopy(agent, provider, clearEnvCredentials = false) {
63
201
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
64
202
  const strategy = getStrategy(agent);
203
+ // Identity fields every return path below shares. `credentialLabel: 'oauth'`
204
+ // names the FLOW, never the secret -- no plaintext credential is ever placed
205
+ // in the structured payload.
206
+ const who = { provider: provider.name, memberId: agent.id, memberName: agent.friendlyName };
65
207
  const credentialFiles = provider.oauthCredentialFiles();
66
208
  if (!credentialFiles || credentialFiles.length === 0) {
67
- return `❌ Provider "${provider.name}" does not support OAuth credential copy.`;
209
+ return authResult(`[FAIL] Provider "${provider.name}" does not support OAuth credential copy.`, { ...who, reason: 'oauth_not_supported' });
68
210
  }
69
211
  // 1. Copy credential files
70
212
  let credStatus = null;
213
+ let expiresAt = null;
71
214
  for (const file of credentialFiles) {
72
215
  try {
73
216
  const localPath = file.localPath.replace('~', os.homedir());
@@ -76,23 +219,33 @@ async function provisionOAuthCopy(agent, provider) {
76
219
  // Validate credentials before sending
77
220
  if (file.localPath.includes('.json')) {
78
221
  credStatus = validateCredentials(content);
222
+ expiresAt = extractCredentialExpiresAt(content) ?? expiresAt;
79
223
  if (credStatus?.status === 'expired-no-refresh') {
80
- return `❌ OAuth token in ${file.localPath} is expired with no refresh token.
224
+ return authResult(`[FAIL] OAuth token in ${file.localPath} is expired with no refresh token.
81
225
  `
82
- + ` Run /login in your ${provider.name} session, then re-run provision_llm_auth.`;
226
+ + ` Run /login in your ${provider.name} session, then re-run provision_llm_auth.`, { ...who, reason: 'oauth_token_expired_no_refresh', expiresAt });
83
227
  }
84
228
  }
85
- const result = await strategy.execCommand(cmds.credentialFileWrite(content, file.remotePath), 10000);
229
+ // Content (OAuth access + refresh token) travels over SFTP/fs into an
230
+ // owner-only staged file; the install command carries only paths.
231
+ const staged = await writeMemberSecretFile(agent, content, 'cred');
232
+ const result = await strategy.execCommand(cmds.credentialFileInstall(staged, file.remotePath), 10000)
233
+ .catch(async (err) => { await removeMemberSecretFile(agent, staged); throw err; });
234
+ if (result.code !== 0)
235
+ await removeMemberSecretFile(agent, staged);
86
236
  if (result.code !== 0 && result.stderr) {
87
- return `❌ Failed to write ${file.remotePath} on "${agent.friendlyName}": ${result.stderr}`;
237
+ return authResult(`[FAIL] Failed to write ${file.remotePath} on "${agent.friendlyName}": ${result.stderr}`, { ...who, reason: 'oauth_credential_write_failed', expiresAt });
88
238
  }
89
239
  }
90
240
  else {
91
- return `❌ Could not find local credential file: ${localPath}`;
241
+ return authResult(`[FAIL] Could not find local credential file: ${localPath}`, { ...who, reason: 'oauth_credential_file_missing' });
92
242
  }
93
243
  }
94
244
  catch (err) {
95
- return `❌ Failed to copy ${file.localPath} to "${agent.friendlyName}": ${err.message}`;
245
+ if (err instanceof SecretDeliveryError) {
246
+ return authResult(`[FAIL] ${err.message}`, { ...who, reason: 'secret_delivery_unavailable', expiresAt });
247
+ }
248
+ return authResult(`[FAIL] Failed to copy ${file.localPath} to "${agent.friendlyName}": ${err.message}`, { ...who, reason: 'oauth_copy_failed', expiresAt });
96
249
  }
97
250
  }
98
251
  // 2. Merge settings
@@ -103,15 +256,19 @@ async function provisionOAuthCopy(agent, provider) {
103
256
  try {
104
257
  const result = await strategy.execCommand(cmds.deepMergeJson(remoteSettingsPath, mergeObj), 10000);
105
258
  if (result.code !== 0 && result.stderr) {
106
- return `❌ Failed to merge settings on "${agent.friendlyName}": ${result.stderr}`;
259
+ return authResult(`[FAIL] Failed to merge settings on "${agent.friendlyName}": ${result.stderr}`, { ...who, reason: 'oauth_settings_merge_failed', expiresAt });
107
260
  }
108
261
  }
109
262
  catch (err) {
110
- return `❌ Failed to merge settings on "${agent.friendlyName}": ${err.message}`;
263
+ return authResult(`[FAIL] Failed to merge settings on "${agent.friendlyName}": ${err.message}`, { ...who, reason: 'oauth_settings_merge_failed', expiresAt });
111
264
  }
112
265
  }
113
- // 3. Unset env vars
114
- const varsToUnset = provider.oauthEnvVarsToUnset() ?? [];
266
+ // 3. Unset env vars. Env credentials (e.g. CLAUDE_CODE_OAUTH_TOKEN /
267
+ // ANTHROPIC_API_KEY) are cleared ONLY on an explicit force_oauth_copy:
268
+ // this flow also runs automatically (cloud start, sprint self-heal) and must
269
+ // never erase an operator-provisioned credential.
270
+ const envKinds = clearEnvCredentials ? (provider.authEnvVarNames?.() ?? []) : [];
271
+ const varsToUnset = [...new Set([...(provider.oauthEnvVarsToUnset() ?? []), ...envKinds])];
115
272
  for (const envVar of varsToUnset) {
116
273
  const unsetCmds = cmds.unsetEnv(envVar);
117
274
  for (const cmd of unsetCmds) {
@@ -119,46 +276,111 @@ async function provisionOAuthCopy(agent, provider) {
119
276
  await strategy.execCommand(cmd, 15000).catch(() => { });
120
277
  }
121
278
  }
279
+ // Also drop them from the stored member config (dispatch exports it).
280
+ if (envKinds.length > 0)
281
+ storeAuthEnvVars(agent, envKinds);
282
+ const clearedNote = envKinds.length > 0
283
+ ? `\n Cleared: ${envKinds.join(', ')} removed from shell profiles and member config (force_oauth_copy)`
284
+ : '';
122
285
  // 4. Verify auth
123
- const authWorks = provider.name === 'claude'
286
+ const authCheck = provider.name === 'claude'
124
287
  ? await verifyWithClaudePrompt(agent)
125
288
  : await verifyWithVersion(agent, provider);
289
+ const authWorks = authCheck.ok;
126
290
  touchAgent(agent.id);
127
291
  const statusNote = credentialStatusNote(credStatus);
128
292
  const suffix = statusNote ? `\n ${statusNote}` : '';
129
293
  if (authWorks) {
130
- return `✅ OAuth credentials for ${provider.name} deployed to "${agent.friendlyName}"
294
+ return authResult(`[OK] OAuth credentials for ${provider.name} deployed to "${agent.friendlyName}"
131
295
  `
132
- + ` Auth: verified with a successful ${provider.name} API call.${suffix}`;
296
+ + ` Auth: verified with a successful ${provider.name} API call.${suffix}${clearedNote}`, { ...who, reason: 'ok', credentialLabel: 'oauth', expiresAt, verified: true });
133
297
  }
134
- return `⚠️ ${provider.name} OAuth credentials deployed to "${agent.friendlyName}" but could not verify auth.
298
+ return authResult(`[WARN] ${provider.name} OAuth credentials deployed to "${agent.friendlyName}" but could not verify auth.
135
299
  `
136
- + ` Credential files were written — try running a prompt to confirm.${suffix}`;
300
+ + ` Credential files were written -- try running a prompt to confirm.${suffix}${clearedNote}`
301
+ + (authCheck.detail ? `\n Auth test error: ${authCheck.detail}` : ''), { ...who, reason: 'deployed_unverified', credentialLabel: 'oauth', expiresAt, verified: false });
137
302
  }
138
303
  // ---------------------------------------------------------------------------
139
- // Flow B — API Key Override (all providers)
304
+ // Flow B -- API Key Override (all providers)
140
305
  // ---------------------------------------------------------------------------
141
306
  async function provisionApiKey(agent, apiKey, provider) {
142
307
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
143
308
  const strategy = getStrategy(agent);
309
+ // Credential kind decides the env var (e.g. a Claude Code OAuth token goes
310
+ // to CLAUDE_CODE_OAUTH_TOKEN, an API key to ANTHROPIC_API_KEY).
144
311
  const envVarName = provider.authEnvVarForToken(apiKey);
145
- const commands = cmds.setEnv(envVarName, apiKey);
312
+ const kindWarning = provider.authTokenKindWarning?.(apiKey) ?? null;
313
+ const otherKinds = (provider.authEnvVarNames?.() ?? []).filter(n => n !== envVarName);
314
+ // Persist into the member's profile / user env. The value travels in an
315
+ // owner-only file (SFTP / fs); the command that applies it and deletes the
316
+ // file carries only the path -- never the key (it would sit in the member
317
+ // shell's argv, readable via ps). Error text never echoes a command.
146
318
  const errors = [];
147
- for (const cmd of commands) {
319
+ let persistFile = null;
320
+ let persisted = false;
321
+ // 1. Stage / refuse. No safe delivery channel (relay member, SFTP
322
+ // unavailable): refuse BEFORE changing anything -- a stored key every later
323
+ // dispatch cannot deliver would break the member instead of failing here.
324
+ try {
325
+ persistFile = await writeMemberSecretFile(agent, cmds.persistEnvFileContent(envVarName, apiKey), 'persist');
326
+ }
327
+ catch (err) {
328
+ if (!(err instanceof SecretDeliveryError))
329
+ throw err;
330
+ return authResult(`[FAIL] ${err.message}\n This call changed nothing on the member or in its stored config.`, {
331
+ provider: provider.name, memberId: agent.id, memberName: agent.friendlyName,
332
+ reason: 'secret_delivery_unavailable', credentialLabel: envVarName,
333
+ });
334
+ }
335
+ const run = async (cmd) => {
148
336
  try {
149
337
  const result = await strategy.execCommand(cmd, 15000);
150
- if (result.code !== 0 && result.stderr) {
151
- errors.push(`Command "${cmd.substring(0, 40)}..." stderr: ${result.stderr}`);
152
- }
338
+ if (result.code !== 0 && result.stderr)
339
+ errors.push(sanitizeAuthErrorDetail(`stderr: ${result.stderr}`, apiKey));
153
340
  }
154
341
  catch (err) {
155
- errors.push(`Command failed: ${err.message}`);
342
+ errors.push(sanitizeAuthErrorDetail(`Command failed: ${err.message}`, apiKey));
343
+ }
344
+ };
345
+ // 2. Clear the other credential kind first so the CLI cannot pick it up.
346
+ for (const other of otherKinds) {
347
+ for (const cmd of cmds.unsetEnv(other))
348
+ await run(cmd);
349
+ }
350
+ // 3. Persist (path-only command; the staged file is deleted by it).
351
+ try {
352
+ const result = await strategy.execCommand(cmds.persistEnvFromFile(envVarName, persistFile), 15000);
353
+ persisted = result.code === 0;
354
+ if (!persisted)
355
+ errors.push(sanitizeAuthErrorDetail(`Persisting ${envVarName} failed (exit ${result.code})${result.stderr ? `: ${result.stderr}` : ''}`, apiKey));
356
+ }
357
+ catch (err) {
358
+ errors.push(sanitizeAuthErrorDetail(`Persisting ${envVarName} failed: ${err.message}`, apiKey));
359
+ }
360
+ finally {
361
+ if (!persisted)
362
+ await removeMemberSecretFile(agent, persistFile);
363
+ }
364
+ // 4. Store the encrypted credential in the member's registry entry, dropping any
365
+ // stored credential of the other kind (dispatch delivers every stored var).
366
+ storeAuthEnvVars(agent, otherKinds, { [envVarName]: encryptPassword(apiKey) });
367
+ // 5. An env token supersedes a copied login file; move a stale one aside
368
+ // (renamed, never deleted) so it cannot shadow or confuse the new credential.
369
+ // Timestamped suffix so a later switch never overwrites an earlier backup.
370
+ const backupSuffix = `${SUPERSEDED_CREDENTIAL_SUFFIX}-${new Date().toISOString().replace(/[^0-9]/g, '').slice(0, 14)}`;
371
+ const movedAside = [];
372
+ for (const file of provider.credentialFilesSupersededByEnvToken?.(apiKey) ?? []) {
373
+ try {
374
+ const r = await strategy.execCommand(cmds.credentialFileMoveAside(file, backupSuffix), 15000);
375
+ if (r.code === 0 && r.stdout.includes('moved'))
376
+ movedAside.push(file);
377
+ else if (r.code !== 0 && r.stderr)
378
+ errors.push(sanitizeAuthErrorDetail(`Could not move aside ${file}: ${r.stderr}`, apiKey));
379
+ }
380
+ catch (err) {
381
+ errors.push(sanitizeAuthErrorDetail(`Could not move aside ${file}: ${err.message}`, apiKey));
156
382
  }
157
383
  }
158
- // Store encrypted API key in the agent's registry entry
159
- updateAgent(agent.id, {
160
- encryptedEnvVars: { ...agent.encryptedEnvVars, [envVarName]: encryptPassword(apiKey) },
161
- });
162
384
  // Verify the key was persisted in a new shell
163
385
  let verified = false;
164
386
  try {
@@ -168,19 +390,21 @@ async function provisionApiKey(agent, apiKey, provider) {
168
390
  catch {
169
391
  // May still work after re-login
170
392
  }
171
- // Verify with a real CLI call
172
- const envPrefix = cmds.envPrefix(envVarName, apiKey);
173
- const authWorks = provider.name === 'claude'
174
- ? await verifyWithClaudePrompt(agent, envPrefix)
175
- : await verifyWithVersion(agent, provider, envPrefix);
393
+ // 6. Verify with a real CLI call, the key delivered through a staged file.
394
+ const verifyEnv = { [envVarName]: apiKey };
395
+ const authCheck = provider.name === 'claude'
396
+ ? await verifyWithClaudePrompt(agent, verifyEnv, apiKey)
397
+ : await verifyWithVersion(agent, provider, verifyEnv, apiKey);
398
+ const authWorks = authCheck.ok;
176
399
  touchAgent(agent.id);
400
+ const kindLabel = /OAUTH/i.test(envVarName) ? 'OAuth token' : 'API key';
177
401
  let result = '';
178
402
  if (errors.length === 0) {
179
- result += `✅ API key provisioned on "${agent.friendlyName}"
403
+ result += `[OK] ${kindLabel} provisioned on "${agent.friendlyName}"
180
404
  `;
181
405
  }
182
406
  else {
183
- result += `⚠️ API key provisioned with some issues on "${agent.friendlyName}":
407
+ result += `[WARN] ${kindLabel} provisioned with some issues on "${agent.friendlyName}":
184
408
  `;
185
409
  for (const e of errors) {
186
410
  result += ` - ${e}
@@ -192,72 +416,158 @@ async function provisionApiKey(agent, apiKey, provider) {
192
416
  `;
193
417
  result += ` Verification: ${verified ? 'Key visible in new shell' : 'Key will be available after re-login'}
194
418
  `;
195
- result += ` Auth test: ${authWorks ? `${provider.name} CLI authenticated successfully` : 'Could not verify — may need to re-login'}
419
+ if (otherKinds.length > 0) {
420
+ result += ` Cleared: ${otherKinds.join(', ')} removed from shell profiles and member config (other credential kind)
196
421
  `;
197
- return result;
422
+ }
423
+ for (const file of movedAside) {
424
+ result += ` Superseded: ${file} moved to ${file}${backupSuffix} (the env credential now applies)
425
+ `;
426
+ }
427
+ if (kindWarning) {
428
+ result += ` [WARN] ${kindWarning}
429
+ `;
430
+ }
431
+ result += ` Auth test: ${authWorks
432
+ ? `${provider.name} CLI authenticated successfully`
433
+ : `FAILED -- ${authCheck.detail ?? 'no error text from the CLI'}`}
434
+ `;
435
+ // credentialLabel is the env var the key was deployed under (e.g.
436
+ // ANTHROPIC_API_KEY) -- a name, never the key itself. An API key carries no
437
+ // expiry the server can observe, so expiresAt stays null ("no expiry
438
+ // tracked -> OK").
439
+ return authResult(result, {
440
+ provider: provider.name,
441
+ memberId: agent.id,
442
+ memberName: agent.friendlyName,
443
+ reason: errors.length > 0 ? 'deployed_with_errors' : authWorks ? 'ok' : 'deployed_unverified',
444
+ credentialLabel: envVarName,
445
+ expiresAt: null,
446
+ verified: authWorks,
447
+ });
198
448
  }
199
449
  // ---------------------------------------------------------------------------
200
450
  // Entry point
201
451
  // ---------------------------------------------------------------------------
202
452
  export async function provisionAuth(input) {
203
453
  const agentOrError = resolveMember(input.member_id, input.member_name);
204
- if (typeof agentOrError === 'string')
205
- return agentOrError;
454
+ if (typeof agentOrError === 'string') {
455
+ return authResult(agentOrError, {
456
+ reason: 'member_not_found',
457
+ memberId: input.member_id ?? null,
458
+ memberName: input.member_name ?? null,
459
+ });
460
+ }
206
461
  const agent = agentOrError;
462
+ const who = { memberId: agent.id, memberName: agent.friendlyName };
463
+ // Registry-only recovery path: never contacts the member, so it works for
464
+ // relay, offline and local members alike (the supported way out of
465
+ // secret_delivery_unavailable).
466
+ if (input.clear_stored_credentials) {
467
+ if (input.api_key || input.force_oauth_copy) {
468
+ return authResult('[FAIL] clear_stored_credentials cannot be combined with api_key or force_oauth_copy.', { ...who, reason: 'invalid_arguments', provider: safeProviderName(agent.llmProvider) });
469
+ }
470
+ const names = Object.keys(agent.encryptedEnvVars ?? {});
471
+ updateAgent(agent.id, { encryptedEnvVars: undefined });
472
+ invalidatePreflightCache(agent.id);
473
+ logLine('provision_llm_auth', `cleared ${names.length} stored credential env var(s): ${names.join(', ') || '(none)'}`, agent);
474
+ return authResult(names.length > 0
475
+ ? `[OK] Cleared ${names.length} stored credential env var(s) for "${agent.friendlyName}": ${names.join(', ')}.\n`
476
+ + ' Dispatches no longer deliver them; provide the credential in that machine\'s own environment (or re-run provision_llm_auth). '
477
+ + 'Values already written to the member\'s shell profile / user environment were not touched.'
478
+ : `[OK] "${agent.friendlyName}" has no stored credential env vars -- nothing to clear.`, { ...who, reason: 'stored_credentials_cleared', provider: safeProviderName(agent.llmProvider), credentialLabel: names.join(',') || null });
479
+ }
207
480
  if (agent.agentType === 'local') {
208
- return `⏭️ Skipping "${agent.friendlyName}" — local members use this machine's credentials directly.`;
481
+ return authResult(`[SKIP] Skipping "${agent.friendlyName}" -- local members use this machine's credentials directly.`, { ...who, reason: 'skipped_local_member', provider: safeProviderName(agent.llmProvider) });
209
482
  }
210
483
  const strategy = getStrategy(agent);
211
484
  const conn = await strategy.testConnection();
212
485
  if (!conn.ok) {
213
- return `❌ Member "${agent.friendlyName}" is offline: ${conn.error}`;
486
+ return authResult(`[FAIL] Member "${agent.friendlyName}" is offline: ${conn.error}`, { ...who, reason: 'member_offline', provider: safeProviderName(agent.llmProvider) });
214
487
  }
488
+ // getProvider() defaults to claude ONLY when llmProvider is null/undefined;
489
+ // every registered adapter (claude, codex, copilot, agy, opencode, none)
490
+ // reports its own `name` into the structured payload below, so nothing here
491
+ // assumes Claude-specific credential fields.
215
492
  const provider = getProvider(agent.llmProvider);
493
+ // Every success path logs and invalidates the preflight cache; the
494
+ // `ok` discriminator replaces the old "does the text start with the failure
495
+ // emoji" test, which was the only signal before apra-fleet-3swo.7.2.
496
+ const onSuccess = (result) => {
497
+ if (result.structuredContent.ok) {
498
+ logLine('provision_llm_auth', `provider=${provider.name}`, agent);
499
+ invalidatePreflightCache(agent.id);
500
+ }
501
+ return result;
502
+ };
216
503
  // Flow B: API key is provided directly
217
504
  if (input.api_key) {
218
- const TOKEN_RE = /\{\{secure\.([a-zA-Z0-9_-]{1,64})\}\}/g;
219
- const tokenNames = new Set();
220
- let match;
221
- while ((match = TOKEN_RE.exec(input.api_key)) !== null)
222
- tokenNames.add(match[1]);
505
+ const tokens = findSecretTokens(input.api_key);
506
+ const tokenNames = new Set(tokens.map((t) => t.name));
507
+ const legacyNames = tokens.filter((t) => t.legacy).map((t) => t.name);
223
508
  let resolvedKey = input.api_key;
224
509
  for (const name of tokenNames) {
225
510
  const entry = credentialResolve(name, agent.friendlyName);
226
- if (!entry)
227
- return `❌ Credential "${name}" not found. Run credential_store_set first.`;
228
- if ('denied' in entry)
229
- return `❌ ${entry.denied}`;
230
- if ('expired' in entry)
231
- return `❌ ${entry.expired}`;
232
- resolvedKey = resolvedKey.replaceAll(`{{secure.${name}}}`, entry.plaintext);
511
+ const secretFailure = { ...who, provider: provider.name };
512
+ if (!entry) {
513
+ return authResult(`[FAIL] Credential "${name}" not found. Run credential_store_set first.`, { ...secretFailure, reason: 'secret_variable_not_found' });
514
+ }
515
+ if ('denied' in entry) {
516
+ return authResult(`[FAIL] ${entry.denied}`, { ...secretFailure, reason: 'secret_variable_denied' });
517
+ }
518
+ if ('expired' in entry) {
519
+ return authResult(`[FAIL] ${entry.expired}`, { ...secretFailure, reason: 'secret_variable_expired' });
520
+ }
521
+ resolvedKey = resolvedKey.replaceAll(`{{secret.${name}}}`, entry.plaintext);
522
+ resolvedKey = resolvedKey.replaceAll(`{{secure.${name}}}`, entry.plaintext); // legacy spelling
233
523
  }
234
- const result = await provisionApiKey(agent, resolvedKey, provider);
235
- if (!result.startsWith('❌')) {
236
- logLine('provision_llm_auth', `provider=${provider.name}`, agent);
237
- invalidatePreflightCache(agent.id);
524
+ if (legacyNames.length > 0) {
525
+ logWarn('provision_llm_auth', legacyTokenWarning(legacyNames), agent);
526
+ }
527
+ const apiKeyResult = await provisionApiKey(agent, resolvedKey, provider);
528
+ if (legacyNames.length > 0) {
529
+ apiKeyResult.text += `\n${legacyTokenWarning(legacyNames)}`;
530
+ }
531
+ return onSuccess(apiKeyResult);
532
+ }
533
+ // No api_key: if the member holds a stored env credential (the operator's
534
+ // chosen one, e.g. a CLAUDE_CODE_OAUTH_TOKEN), re-deploy THAT instead of
535
+ // copying this machine's login over it. This path also runs automatically
536
+ // (cloud start, sprint self-heal), so it must never replace or erase the
537
+ // operator's credential; force_oauth_copy is the explicit way to switch.
538
+ let storedNote = '';
539
+ if (!input.force_oauth_copy) {
540
+ const storedName = (provider.authEnvVarNames?.() ?? []).find(n => agent.encryptedEnvVars?.[n]);
541
+ if (storedName) {
542
+ let storedValue = null;
543
+ try {
544
+ storedValue = decryptPassword(agent.encryptedEnvVars[storedName]);
545
+ }
546
+ catch {
547
+ storedNote = `\n [WARN] Stored ${storedName} could not be decrypted; copied the local login instead (the stored value was left in place).`;
548
+ }
549
+ if (storedValue) {
550
+ const redeployed = await provisionApiKey(agent, storedValue, provider);
551
+ redeployed.text += redeployed.structuredContent.reason === 'secret_delivery_unavailable'
552
+ ? `\n The member's stored ${storedName} (re-deploy attempted, no api_key given) is still in its config and cannot be delivered; clear it with clear_stored_credentials: true, or pass force_oauth_copy: true to replace it with your local login.\n`
553
+ : `\n Re-deployed the member's stored ${storedName} (no api_key given). Pass force_oauth_copy: true to replace it with your local login.\n`;
554
+ return onSuccess(redeployed);
555
+ }
238
556
  }
239
- return result;
240
557
  }
241
558
  // Flow A: OAuth credentials copy
242
559
  if (provider.oauthCredentialFiles()?.length) {
243
- const result = await provisionOAuthCopy(agent, provider);
244
- if (!result.startsWith('❌')) {
245
- logLine('provision_llm_auth', `provider=${provider.name}`, agent);
246
- invalidatePreflightCache(agent.id);
247
- }
248
- return result;
560
+ const copied = await provisionOAuthCopy(agent, provider, input.force_oauth_copy === true);
561
+ copied.text += storedNote;
562
+ return onSuccess(copied);
249
563
  }
250
564
  // Fallback: OOB key collection for non-OAuth or non-copyable providers
251
565
  const oob = await collectOobApiKey(agent.friendlyName, 'provision_llm_auth', {
252
566
  prompt: `Enter API key for ${provider.name} on ${agent.friendlyName}`,
253
567
  });
254
- if ('fallback' in oob)
255
- return oob.fallback ?? 'Error: OOB operation cancelled.';
256
- const result = await provisionApiKey(agent, decryptPassword(oob.password), provider);
257
- if (!result.startsWith('❌')) {
258
- logLine('provision_llm_auth', `provider=${provider.name}`, agent);
259
- invalidatePreflightCache(agent.id);
568
+ if ('fallback' in oob) {
569
+ return authResult(oob.fallback ?? 'Error: OOB operation cancelled.', { ...who, provider: provider.name, reason: 'oob_cancelled' });
260
570
  }
261
- return result;
571
+ return onSuccess(await provisionApiKey(agent, decryptPassword(oob.password), provider));
262
572
  }
263
573
  //# sourceMappingURL=provision-auth.js.map