@apralabs/apra-fleet 0.4.3 → 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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  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/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -98,8 +98,12 @@ export class CodexProvider {
98
98
  }
99
99
  // apra-fleet-hzeb.1: Codex has no distinct usage-limit event surface, so key off
100
100
  // the raw output using the shared quota detector (guessed resume window).
101
+ // A successful dispatch (code 0 and !isError) must NEVER be classified as a
102
+ // usage limit, even if stdout transcripts happen to mention 429 in token metrics.
101
103
  detectUsageLimit(result, parsed) {
102
- return defaultUsageLimitSignal(result.stderr || result.stdout || parsed.result);
104
+ if (result.code === 0 && !parsed.isError)
105
+ return null;
106
+ return defaultUsageLimitSignal(result.stderr || (parsed.isError ? parsed.result : ''));
103
107
  }
104
108
  supportsResume() {
105
109
  return true;
@@ -89,8 +89,12 @@ export class CopilotProvider {
89
89
  }
90
90
  // apra-fleet-hzeb.1: Copilot has no distinct usage-limit event surface, so key off
91
91
  // the raw output using the shared quota detector (guessed resume window).
92
+ // A successful dispatch (code 0 and !isError) must NEVER be classified as a
93
+ // usage limit, even if stdout transcripts happen to mention 429 in token metrics.
92
94
  detectUsageLimit(result, parsed) {
93
- return defaultUsageLimitSignal(result.stderr || result.stdout || parsed.result);
95
+ if (result.code === 0 && !parsed.isError)
96
+ return null;
97
+ return defaultUsageLimitSignal(result.stderr || (parsed.isError ? parsed.result : ''));
94
98
  }
95
99
  supportsResume() {
96
100
  return true;
@@ -1,7 +1,9 @@
1
- import type { ProviderAdapter, PromptOptions, ParsedResponse, UsageLimitSignal, RegisterMcpEndpointOptions, RegisterMcpEndpointResult, WorkspaceTrustExecFn, EnsureWorkspaceTrustedResult, SessionIdStrategy, ExecTimeoutSource, TargetOS } from './provider.js';
1
+ import type { ProviderAdapter, PromptOptions, ParsedResponse, UsageLimitSignal, MemberMcpSyncContext, MemberMcpSyncResult, WorkspaceTrustExecFn, EnsureWorkspaceTrustedResult, SessionIdStrategy, ExecTimeoutSource, TargetOS } from './provider.js';
2
2
  import type { LlmProvider, SSHExecResult } from '../types.js';
3
3
  import type { PromptErrorCategory } from '../utils/prompt-errors.js';
4
4
  import type { MemberShell } from '../os/os-commands.js';
5
+ /** Work-folder-relative project config opencode reads MCP servers from. */
6
+ export declare const OPENCODE_PROJECT_CONFIG = "opencode.json";
5
7
  export declare class OpenCodeProvider implements ProviderAdapter {
6
8
  readonly name: LlmProvider;
7
9
  readonly processName = "opencode";
@@ -39,6 +41,13 @@ export declare class OpenCodeProvider implements ProviderAdapter {
39
41
  parseResponse(result: SSHExecResult): ParsedResponse;
40
42
  permissionConfigPaths(): string[];
41
43
  composePermissionConfig(role: 'doer' | 'reviewer', _allow?: string[]): Array<Record<string, unknown> | string>;
44
+ /** Writes (or removes) mcp['apra-fleet'] in <workFolder>/opencode.json -- the
45
+ * project-scope config opencode reads -- and prunes the retired
46
+ * apra-fleet-member entry there and in the global
47
+ * ~/.config/opencode/opencode.json. opencode gets no MCP deny rules: the
48
+ * server already serves a member session only the member allowlist. On
49
+ * removal the file is deleted when nothing else remains in it. */
50
+ syncMemberMcpEntry(ctx: MemberMcpSyncContext): Promise<MemberMcpSyncResult>;
42
51
  supportsOAuthCopy(): boolean;
43
52
  supportsApiKey(): boolean;
44
53
  oauthCredentialFiles(): Array<{
@@ -49,7 +58,6 @@ export declare class OpenCodeProvider implements ProviderAdapter {
49
58
  oauthEnvVarsToUnset(): string[];
50
59
  authEnvVarForToken(_token: string): string;
51
60
  wrapWindowsPrompt(setupCmd: string, filePath: string, argList: string, _sessionId?: string, _model?: string): string;
52
- registerMcpEndpoint(opts: RegisterMcpEndpointOptions): Promise<RegisterMcpEndpointResult>;
53
61
  ensureWorkspaceTrusted(_workFolder: string, _execCommand: WorkspaceTrustExecFn, _agentOs?: 'linux' | 'macos' | 'windows', _shell?: MemberShell): Promise<EnsureWorkspaceTrustedResult>;
54
62
  }
55
63
  //# sourceMappingURL=opencode.d.ts.map
@@ -3,9 +3,15 @@ import { escapeDoubleQuoted } from '../os/os-commands.js';
3
3
  import { logWarn } from '../utils/log-helpers.js';
4
4
  import { sanitizeSessionId } from '../os/os-commands.js';
5
5
  import { transformAgentForOpenCode } from '../cli/agent-transform.js';
6
- import fs from 'node:fs';
7
- import path from 'node:path';
8
- import os from 'node:os';
6
+ import { isPosixShell } from '../utils/agent-helpers.js';
7
+ import { deleteMemberFile, joinMemberPath, pruneLegacyMcpInMemberFile, readMemberJson, MemberConfigError, MemberConfigNotJsonError, isGitTracked, memberFileExists, writeMemberJson, writeSecretBearingConfig, LEGACY_MEMBER_MCP_SERVER_NAME, MEMBER_MCP_SERVER_NAME, } from '../services/member-config-io.js';
8
+ /** Work-folder-relative project config opencode reads MCP servers from. */
9
+ export const OPENCODE_PROJECT_CONFIG = 'opencode.json';
10
+ /** True when an opencode.json mcp entry is the one compose wrote for `memberId`. */
11
+ function isOwnMemberEntry(entry, memberId) {
12
+ return !!entry && typeof entry === 'object' && typeof entry.url === 'string'
13
+ && (entry.url).endsWith(`?member=${encodeURIComponent(memberId)}`);
14
+ }
9
15
  export class OpenCodeProvider {
10
16
  name = 'opencode';
11
17
  processName = 'opencode';
@@ -90,8 +96,12 @@ export class OpenCodeProvider {
90
96
  }
91
97
  // apra-fleet-hzeb.1: OpenCode has no distinct usage-limit event surface, so key off
92
98
  // the raw output using the shared quota detector (guessed resume window).
99
+ // A successful dispatch (code 0 and !isError) must NEVER be classified as a
100
+ // usage limit, even if stdout transcripts happen to mention 429 in token metrics.
93
101
  detectUsageLimit(result, parsed) {
94
- return defaultUsageLimitSignal(result.stderr || result.stdout || parsed.result);
102
+ if (result.code === 0 && !parsed.isError)
103
+ return null;
104
+ return defaultUsageLimitSignal(result.stderr || (parsed.isError ? parsed.result : ''));
95
105
  }
96
106
  headlessInvocation(promptLiteral) {
97
107
  return `run "${promptLiteral}"`;
@@ -214,22 +224,112 @@ export class OpenCodeProvider {
214
224
  // `permission:` schema only has the three coarse categories below (edit/write/bash)
215
225
  // -- no per-tool or per-server MCP granularity exists to map onto (confirmed against
216
226
  // docs/opencode-exploration.md's live investigation). MCP tool access under OpenCode
217
- // would be all-or-nothing at the SERVER level via registerMcpEndpoint's
218
- // `mcp.apra-fleet-member` registration (unconditionally enabled, no per-tool gate) --
219
- // not by this permission map. NOTE: registerMcpEndpoint is currently unreachable for
220
- // every provider (its one caller in register-member.ts is gated behind
221
- // interactiveBootstrapEnabled(), hardcoded to return false, and behind
222
- // memberProvider === 'claude' besides), so no MCP server is actually registered this
223
- // way for anyone today -- this comment describes the mechanism's shape, not a live
224
- // path. Either way, this is a genuine platform limitation, not a gap to fix here; do
225
- // not add MCP entries to the returned permission object, they would not be understood
226
- // by OpenCode's schema.
227
+ // is all-or-nothing at the SERVER level: the member's per-folder apra-fleet entry in
228
+ // <workFolder>/opencode.json (syncMemberMcpEntry) is enabled outright, and the fleet
229
+ // server itself serves a ?member= session only the member allowlist. Do not add MCP
230
+ // entries to the returned permission object; OpenCode's schema would not understand them.
227
231
  composePermissionConfig(role, _allow = []) {
228
232
  if (role === 'doer') {
229
233
  return [{ permission: { edit: 'allow', write: 'allow', bash: 'allow' } }];
230
234
  }
231
235
  return [{ permission: { edit: 'deny', write: 'allow', bash: 'allow' } }];
232
236
  }
237
+ /** Writes (or removes) mcp['apra-fleet'] in <workFolder>/opencode.json -- the
238
+ * project-scope config opencode reads -- and prunes the retired
239
+ * apra-fleet-member entry there and in the global
240
+ * ~/.config/opencode/opencode.json. opencode gets no MCP deny rules: the
241
+ * server already serves a member session only the member allowlist. On
242
+ * removal the file is deleted when nothing else remains in it. */
243
+ async syncMemberMcpEntry(ctx) {
244
+ const { agent, url } = ctx;
245
+ const isWindows = ctx.agentOs === 'windows';
246
+ const posix = isPosixShell(isWindows, ctx.shell);
247
+ const file = joinMemberPath(agent.workFolder, OPENCODE_PROJECT_CONFIG, isWindows, ctx.shell);
248
+ let config;
249
+ try {
250
+ config = await readMemberJson(ctx.execCommand, file, posix);
251
+ }
252
+ catch (e) {
253
+ // JSONC (comments / trailing commas) is common in opencode.json: report it
254
+ // as a typed, recoverable status and never rewrite the file.
255
+ if (e instanceof MemberConfigNotJsonError) {
256
+ throw new MemberConfigNotJsonError(file, 'is not strict JSON (JSONC comments or trailing commas?)', 'opencode-config-unparseable');
257
+ }
258
+ throw e;
259
+ }
260
+ const mcp = (config.mcp && typeof config.mcp === 'object' && !Array.isArray(config.mcp))
261
+ ? config.mcp
262
+ : {};
263
+ const hadLegacy = LEGACY_MEMBER_MCP_SERVER_NAME in mcp;
264
+ delete mcp[LEGACY_MEMBER_MCP_SERVER_NAME];
265
+ // Check if the file actually exists on disk (even if empty or {})
266
+ const fileExists = await memberFileExists(ctx.execCommand, file, posix);
267
+ let detail;
268
+ if (url !== null) {
269
+ const cur = mcp[MEMBER_MCP_SERVER_NAME];
270
+ // The member install's access secret rides as an http header (opencode
271
+ // remote MCP `headers`); without it the server refuses the session.
272
+ const wanted = { type: 'remote', url, enabled: true, ...(ctx.headers ? { headers: ctx.headers } : {}) };
273
+ const current = !!cur && typeof cur === 'object' && JSON.stringify(cur) === JSON.stringify(wanted);
274
+ if (current && !hadLegacy) {
275
+ detail = `opencode: ${file} already up to date`;
276
+ }
277
+ else {
278
+ if (fileExists && await isGitTracked(ctx.execCommand, agent.workFolder, OPENCODE_PROJECT_CONFIG, isWindows, posix)) {
279
+ throw new MemberConfigError('E-OPENCODE-CONFIG-TRACKED', 'opencode-config-tracked', file, `E-OPENCODE-CONFIG-TRACKED: ${file} is tracked by git; compose left it untouched (writing the member URL would dirty the repo). Untrack it or add the apra-fleet MCP entry to it yourself.`);
280
+ }
281
+ mcp[MEMBER_MCP_SERVER_NAME] = wanted;
282
+ config.mcp = mcp;
283
+ if (ctx.headers) {
284
+ await writeSecretBearingConfig(ctx, file, JSON.stringify(config, null, 2) + '\n', posix);
285
+ }
286
+ else {
287
+ await writeMemberJson(ctx.execCommand, file, config, posix);
288
+ }
289
+ detail = `opencode: wrote ${MEMBER_MCP_SERVER_NAME} in ${file}`;
290
+ }
291
+ }
292
+ else if (fileExists && await isGitTracked(ctx.execCommand, agent.workFolder, OPENCODE_PROJECT_CONFIG, isWindows, posix)) {
293
+ detail = `opencode: ${file} is tracked by git; left untouched`;
294
+ }
295
+ else if (ctx.removeOnlyOwnEntry && !hadLegacy && !isOwnMemberEntry(mcp[MEMBER_MCP_SERVER_NAME], agent.id)) {
296
+ // Only THIS member's entry (?member=<uuid>) is removed; the owner's own
297
+ // apra-fleet entry (e.g. a full install) is never touched.
298
+ detail = `opencode: no member MCP entry of this member in ${file}`;
299
+ }
300
+ else {
301
+ if (!ctx.removeOnlyOwnEntry || isOwnMemberEntry(mcp[MEMBER_MCP_SERVER_NAME], agent.id))
302
+ delete mcp[MEMBER_MCP_SERVER_NAME];
303
+ if (Object.keys(mcp).length > 0)
304
+ config.mcp = mcp;
305
+ else
306
+ delete config.mcp;
307
+ if (Object.keys(config).length === 0) {
308
+ await deleteMemberFile(ctx.execCommand, file, posix);
309
+ detail = `opencode: removed ${file}`;
310
+ }
311
+ else {
312
+ await writeMemberJson(ctx.execCommand, file, config, posix);
313
+ detail = `opencode: removed ${MEMBER_MCP_SERVER_NAME} from ${file}`;
314
+ }
315
+ }
316
+ if (ctx.memberHomeDir) {
317
+ const globalFile = joinMemberPath(ctx.memberHomeDir.trim(), '.config/opencode/opencode.json', isWindows, ctx.shell);
318
+ try {
319
+ if (await pruneLegacyMcpInMemberFile(ctx.execCommand, globalFile, posix)) {
320
+ detail += `; pruned apra-fleet-member from ${globalFile}`;
321
+ }
322
+ }
323
+ catch (e) {
324
+ // The global config is only pruned best-effort (it is often JSONC):
325
+ // an unreadable/unparseable one is left alone and never fails compose.
326
+ if (!(e instanceof MemberConfigError))
327
+ throw e;
328
+ detail += `; skipped pruning ${globalFile} (${e.code})`;
329
+ }
330
+ }
331
+ return { workFolderFiles: [OPENCODE_PROJECT_CONFIG], detail };
332
+ }
233
333
  supportsOAuthCopy() {
234
334
  return false;
235
335
  }
@@ -251,45 +351,6 @@ export class OpenCodeProvider {
251
351
  wrapWindowsPrompt(setupCmd, filePath, argList, _sessionId, _model) {
252
352
  return `${setupCmd}Write-Output "FLEET_PID:$pid"; ${filePath} ${argList}`;
253
353
  }
254
- async registerMcpEndpoint(opts) {
255
- // OpenCode has no non-interactive registration verb for token-based auth --
256
- // `opencode mcp auth <server>` is for interactive OAuth entry only, not a
257
- // pre-minted bearer token from the hub/local server. Its native config file
258
- // (opencode.json) supports remote MCP servers with bearer-auth headers
259
- // natively: { type: 'remote', url, headers: { Authorization: 'Bearer ...' } }.
260
- // Live-verified: a local HTTP listener confirmed OpenCode sends the
261
- // Authorization header exactly as configured (see docs/member-onboarding-journey.md
262
- // 3a and apra-fleet-fnz.3). Read-modify-write, same shape as AGY, scoped by
263
- // `opts.scope`: 'project' writes workFolder/opencode.json, 'user' writes the
264
- // global ~/.config/opencode/opencode.json.
265
- const configFile = opts.scope === 'project'
266
- ? path.join(opts.workFolder, 'opencode.json')
267
- : path.join(os.homedir(), '.config', 'opencode', 'opencode.json');
268
- fs.mkdirSync(path.dirname(configFile), { recursive: true });
269
- let settings = {};
270
- if (fs.existsSync(configFile)) {
271
- try {
272
- settings = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
273
- }
274
- catch {
275
- // malformed file -- start fresh rather than write on top of unparseable state
276
- settings = {};
277
- }
278
- }
279
- const mcp = settings.mcp ?? {};
280
- mcp['apra-fleet-member'] = {
281
- type: 'remote',
282
- url: opts.url,
283
- enabled: true,
284
- headers: { Authorization: `Bearer ${opts.token}` },
285
- };
286
- settings.mcp = mcp;
287
- fs.writeFileSync(configFile, JSON.stringify(settings, null, 2) + '\n');
288
- return {
289
- mechanism: 'config-file-merge',
290
- detail: `merged apra-fleet-member into ${configFile} (mcp.apra-fleet-member, remote+bearer-auth headers)`,
291
- };
292
- }
293
354
  async ensureWorkspaceTrusted(_workFolder, _execCommand, _agentOs, _shell) {
294
355
  // apra-fleet-eft.40 provider trust matrix: OpenCode has a first-run trust/onboarding
295
356
  // gate too (docs/opencode-exploration.md:92-97), but it is ALREADY handled via the
@@ -66,7 +66,29 @@ export type SessionIdStrategy = {
66
66
  * silently disables a kill path.
67
67
  */
68
68
  export type ExecTimeoutSource = 'inactivity_timeout' | 'total_ceiling';
69
- export declare function encodeClaudeProjectDir(workFolder: string): string;
69
+ /** Claude Code caps an encoded project-dir name at this many characters. */
70
+ export declare const CLAUDE_PROJECT_DIR_MAX_LEN = 200;
71
+ /**
72
+ * The 32-bit string hash Claude Code appends to an over-long project-dir name
73
+ * (ported verbatim from the claude CLI bundle: h = ((h << 5) - h + charCode) | 0
74
+ * over UTF-16 code units).
75
+ */
76
+ export declare function claudeProjectDirHash(s: string): number;
77
+ /**
78
+ * Normalize a work folder to the cwd string Claude Code itself sees: no
79
+ * trailing separator (process.cwd() never has one, except at a root), and on
80
+ * Windows backslash separators (only the over-200 hash suffix depends on the
81
+ * separator; the visible encoding maps both to '-').
82
+ */
83
+ export declare function claudeCwdForm(workFolder: string, windows: boolean): string;
84
+ /**
85
+ * The ~/.claude/projects/<name> directory name Claude Code uses for a cwd:
86
+ * every non-alphanumeric char becomes '-', and a name longer than 200 chars is
87
+ * cut to 200 and suffixed with '-' + base36(|hash(cwd)|) -- the same rule as
88
+ * the claude CLI. `windows` selects the member's cwd form (defaults to this
89
+ * host's platform).
90
+ */
91
+ export declare function encodeClaudeProjectDir(workFolder: string, windows?: boolean): string;
70
92
  /**
71
93
  * Build a `--resume <id>` flag with session ID sanitization and quoting.
72
94
  * Shared by providers that pass session IDs on the command line (Claude).
@@ -109,6 +131,10 @@ export interface PromptOptions {
109
131
  /** Provider project the run is bound to (AGY: `--project <id>`, from
110
132
  * Agent.agyProjectId). Ignored by providers without {@link ProviderAdapter.projectFlag}. */
111
133
  projectId?: string;
134
+ /** Absolute member-side path of a per-session MCP config file (Claude:
135
+ * `--mcp-config <file>`), already written by the caller. Ignored by
136
+ * providers without {@link ProviderAdapter.mcpConfigFlag}. */
137
+ mcpConfigPath?: string;
112
138
  }
113
139
  /**
114
140
  * apra-fleet-hzeb.1: a provider-agnostic "this dispatch hit a usage/quota limit
@@ -144,15 +170,38 @@ export declare const DEFAULT_USAGE_LIMIT_RESUME_MS: number;
144
170
  */
145
171
  export declare function guessedUsageLimitSignal(message: string, now?: number): UsageLimitSignal;
146
172
  export declare function defaultUsageLimitSignal(output: string, now?: number): UsageLimitSignal | null;
173
+ /**
174
+ * Token counts one dispatch reported. input_tokens/output_tokens are required;
175
+ * the cache fields are provider-optional -- an adapter whose CLI reports
176
+ * prompt-cache traffic (Claude: cache_read_input_tokens /
177
+ * cache_creation_input_tokens on the result event's usage) fills them, every
178
+ * other adapter leaves them absent and consumers treat absent as 0. They are
179
+ * billed input tokens that are NOT included in input_tokens, so a cost figure
180
+ * that ignores them undercounts a cache-heavy dispatch several-fold.
181
+ */
182
+ export interface TokenUsage {
183
+ input_tokens: number;
184
+ output_tokens: number;
185
+ /** Prompt tokens served from the provider's prompt cache. */
186
+ cache_read_input_tokens?: number;
187
+ /** Prompt tokens written into the provider's prompt cache. */
188
+ cache_creation_input_tokens?: number;
189
+ /** USD this dispatch cost, as the provider CLI itself reported it (Claude:
190
+ * the delta of the result's cumulative total_cost_usd, see
191
+ * services/session-cost.ts). Absent when the provider reports no cost;
192
+ * cost consumers then price the token counts from the rate table. */
193
+ cost_usd?: number;
194
+ }
147
195
  export interface ParsedResponse {
148
196
  result: string;
149
197
  sessionId?: string;
150
198
  isError: boolean;
151
199
  raw: string;
152
- usage?: {
153
- input_tokens: number;
154
- output_tokens: number;
155
- };
200
+ usage?: TokenUsage;
201
+ /** The CLI's CUMULATIVE session cost in USD (Claude: total_cost_usd), when
202
+ * reported. Not per dispatch: execute_prompt turns it into the dispatch's
203
+ * usage.cost_usd. */
204
+ sessionCostUsd?: number;
156
205
  /** e.g. 'error_max_turns' -- the CLI result event's own subtype, when present. */
157
206
  subtype?: string;
158
207
  /** e.g. 'max_turns' -- the CLI result event's own terminal_reason, when present. */
@@ -173,6 +222,9 @@ export interface PermissionDenialItem {
173
222
  action: string;
174
223
  /** The concrete target, when the CLI named it, e.g. 'git status --short --branch'. */
175
224
  target?: string;
225
+ /** compose_permissions grants that would allow this one call, primary
226
+ * first (empty when no grant maps to it). */
227
+ suggestedGrants?: string[];
176
228
  }
177
229
  /** Structured permission denial surfaced by execute_prompt as
178
230
  * `reason: 'permission_denied'`. */
@@ -181,18 +233,45 @@ export interface PermissionDenial {
181
233
  actions: string[];
182
234
  denials: PermissionDenialItem[];
183
235
  /** compose_permissions `grant` values that would allow the denied calls
184
- * (empty when there is no canonical mapping for an action). The primary
185
- * suggestion comes first; a narrower alternative may follow it. */
236
+ * (empty when there is no canonical mapping for an action, and always
237
+ * empty when healable is false). The primary suggestion comes first; a
238
+ * narrower alternative may follow it. */
186
239
  suggestedGrants: string[];
187
240
  /** One-line remediation for a human or an orchestrator. */
188
241
  hint: string;
189
242
  /** Which of the CLI's signals reported the denial. */
190
243
  signals: Array<'result_json' | 'stderr' | 'transcript'>;
244
+ /** The permission mode the session ran in, when the provider knows it
245
+ * (Claude: 'auto' | 'acceptEdits' | 'bypassPermissions'). */
246
+ permissionMode?: string;
247
+ /** false when no grant may ever be added for these denials: in Claude auto
248
+ * mode a refusal comes from the safety classifier or a deny rule, not from
249
+ * a missing allow rule; in any mode, a refusal of a fleet tool outside the
250
+ * member allowlist is the member tool policy (cause 'policy_deny'). Absent
251
+ * = a grant may heal it. */
252
+ healable?: boolean;
253
+ /** 'policy_deny': at least one refused call was a fleet tool outside the
254
+ * member allowlist, denied by the deny rules compose writes on purpose.
255
+ * Always comes with healable: false. */
256
+ cause?: 'policy_deny';
191
257
  }
258
+ /**
259
+ * Splits a command line into its pipeline stages (on pipe `|`), respecting
260
+ * single and double quotes, and ignoring logical OR `||`.
261
+ */
262
+ export declare function splitPipelineStages(line: string): string[];
263
+ /** Extracts the base executable command from a single command or pipeline stage. */
264
+ export declare function extractCommandFromStage(stage: string): string | undefined;
265
+ export declare function suggestedGrantsForDenial(item: PermissionDenialItem): string[];
266
+ export declare function suggestedGrantForDenial(item: PermissionDenialItem): string | undefined;
192
267
  /** Context parseResponse may use; providers that do not need it ignore it. */
193
268
  export interface ParseResponseContext {
194
269
  /** The member's OS (e.g. agy's permission-denial hint differs on Windows). */
195
270
  agentOs?: 'linux' | 'macos' | 'windows';
271
+ /** The member's unattended setting and the model the dispatch ran with, so
272
+ * a provider can tell which permission mode the session ran in. */
273
+ unattended?: false | 'auto' | 'dangerous';
274
+ model?: string;
196
275
  }
197
276
  /** Extra inputs to composePermissionConfig; providers that do not need them
198
277
  * ignore them. */
@@ -204,25 +283,38 @@ export interface ComposePermissionOptions {
204
283
  warnings?: string[];
205
284
  }
206
285
  export declare function isMaxTurnsResponse(parsed: ParsedResponse | undefined | null): boolean;
207
- export interface RegisterMcpEndpointOptions {
208
- /** e.g. http://<host>:<port>/mcp?member=<member-uuid> */
209
- url: string;
210
- /** JWT bearer token for the member's fleet MCP session. */
211
- token: string;
212
- workFolder: string;
213
- scope: 'project' | 'user';
286
+ /** Context for {@link ProviderAdapter.syncMemberMcpEntry}. */
287
+ export interface MemberMcpSyncContext {
288
+ agent: import('../types.js').Agent;
289
+ execCommand: WorkspaceTrustExecFn;
290
+ /** The member's home directory, resolved in JavaScript (getMemberHomeDir); null when unresolvable. */
291
+ memberHomeDir: string | null;
292
+ agentOs: 'linux' | 'macos' | 'windows';
293
+ shell?: MemberShell;
294
+ /** Out-of-band file channel for large home-anchored files (see WorkspaceTrustTransport). */
295
+ transport?: WorkspaceTrustTransport;
296
+ /** Owner-only secret-file channel, tried when the file channel is unavailable
297
+ * (see MemberSecretFileChannel). With neither, the write fails loudly. */
298
+ secretChannel?: MemberSecretFileChannel;
299
+ /** The per-folder apra-fleet entry URL (.../mcp?member=<uuid>) to write, or null to REMOVE
300
+ * the entry this provider wrote for the member's folder (provider switch cleanup). */
301
+ url: string | null;
302
+ /** HTTP headers the entry carries with `url` -- the member install's access
303
+ * secret (member-access-secret.ts), without which its server refuses the
304
+ * `?member=` session. A config carrying it is written only through a file
305
+ * channel, never a command string. Absent when no secret is known. */
306
+ headers?: Record<string, string>;
307
+ /** With url null: remove the folder's apra-fleet entry only when it points at
308
+ * THIS member (?member=<uuid>), leaving any other apra-fleet entry alone. */
309
+ removeOnlyOwnEntry?: boolean;
214
310
  }
215
- export interface RegisterMcpEndpointResult {
216
- /** e.g. 'cli-verb' (Claude's `claude mcp add`) or 'config-file-merge' (AGY/OpenCode). */
217
- mechanism: string;
218
- /** Human-readable detail for logging/audit -- what file or command was used. */
311
+ export interface MemberMcpSyncResult {
312
+ /** Work-folder-relative files this provider owns for the member MCP entry -- the
313
+ * caller keeps them out of `git status` via the clone's .git/info/exclude. */
314
+ workFolderFiles: string[];
315
+ /** Human-readable summary for logs/tool output. */
219
316
  detail: string;
220
317
  }
221
- /** Delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted} -- the SAME
222
- * channel compose_permissions' deliverConfigFile already uses (AgentStrategy.execCommand:
223
- * SSH for remote members, local shell exec for local members). Kept as a narrow function
224
- * type (rather than importing AgentStrategy) so providers.ts has no dependency on
225
- * services/strategy.ts. */
226
318
  export type WorkspaceTrustExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
227
319
  /** Optional file-delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted}
228
320
  * (GitHub #499). Writes `content` to `relPath`, resolved relative to the MEMBER's home
@@ -237,6 +329,14 @@ export type WorkspaceTrustReadHomeFileFn = (relPath: string) => Promise<{
237
329
  found: boolean;
238
330
  content?: string;
239
331
  } | undefined>;
332
+ /** Owner-only secret-file channel (writeMemberSecretFile): stages `content` in a
333
+ * fresh owner-only file on the member WITHOUT a command line and returns its
334
+ * absolute member-side path. Used when the home-anchored file channel is
335
+ * unavailable; `remove` is best-effort cleanup of a staged file. */
336
+ export interface MemberSecretFileChannel {
337
+ write(content: string): Promise<string>;
338
+ remove(filePath: string): Promise<void>;
339
+ }
240
340
  export interface WorkspaceTrustTransport {
241
341
  writeHomeFile?: WorkspaceTrustWriteHomeFileFn;
242
342
  readHomeFile?: WorkspaceTrustReadHomeFileFn;
@@ -269,6 +369,18 @@ export interface ProviderAdapter {
269
369
  installCommand(os: 'linux' | 'macos' | 'windows', shell?: MemberShell): string;
270
370
  updateCommand(): string;
271
371
  buildPromptCommand(opts: PromptOptions): string;
372
+ /** The per-session MCP config flag for a resolved absolute member-side path,
373
+ * quoted by the provider for the member's shell (`posix` false = PowerShell).
374
+ * Callers append it after every positional argument: Claude's --mcp-config
375
+ * is variadic and would swallow a following positional prompt. Optional:
376
+ * providers without one never get a session config. */
377
+ mcpConfigFlag?(absPath: string, posix: boolean): string;
378
+ /** Minimum CLI version whose per-session MCP config accepts an always-load
379
+ * option that keeps the server's tools out of tool-search deferral (Claude:
380
+ * the `alwaysLoad` server key). The dispatcher probes the member's CLI
381
+ * version and writes the option only at or above this, logging a WARN
382
+ * otherwise. Optional: providers without one never get the option. */
383
+ mcpAlwaysLoadMinVersion?(): string;
272
384
  skipPermissionsFlag(): string;
273
385
  /** Returns the CLI flag for unattended='auto', or null if the provider does not support it. */
274
386
  permissionModeAutoFlag(): string | null;
@@ -288,8 +400,10 @@ export interface ProviderAdapter {
288
400
  * applies. This is the single source of truth for unattended-mode flag
289
401
  * resolution: both buildPromptCommand() (POSIX, via os/linux.ts) and
290
402
  * os/windows.ts call this instead of re-deriving the branching
291
- * themselves, so the two dispatch paths cannot diverge. */
292
- resolvePermissionFlag(unattended: false | 'auto' | 'dangerous' | undefined): string;
403
+ * themselves, so the two dispatch paths cannot diverge. `model` is the
404
+ * model the dispatch runs (Claude falls back from auto to acceptEdits on a
405
+ * model without auto-mode support). */
406
+ resolvePermissionFlag(unattended: false | 'auto' | 'dangerous' | undefined, model?: string): string;
293
407
  parseResponse(result: SSHExecResult, ctx?: ParseResponseContext): ParsedResponse;
294
408
  /** apra-fleet-hzeb.1: detect whether this dispatch was terminated by a provider
295
409
  * usage/quota limit (as opposed to a transient overload). Returns a
@@ -395,6 +509,27 @@ export interface ProviderAdapter {
395
509
  oauthEnvVarsToUnset(): string[];
396
510
  /** Returns the correct environment variable name for the given API key/token. */
397
511
  authEnvVarForToken(token: string): string;
512
+ /**
513
+ * Every env var name this provider's CLI reads a credential from. They are
514
+ * mutually exclusive: provisioning one clears the others (shell profiles and
515
+ * the member's stored encryptedEnvVars) so the CLI cannot pick a stale
516
+ * credential of the other kind. Optional -- providers with a single auth env
517
+ * var need not implement it.
518
+ */
519
+ authEnvVarNames?(): string[];
520
+ /**
521
+ * A warning when the token's shape is not one this provider recognises
522
+ * (the env var chosen for it is then a guess), or null when recognised.
523
+ * Must be pure -- preflight probes authEnvVarForToken with fake tokens.
524
+ * Never echoes the token itself.
525
+ */
526
+ authTokenKindWarning?(token: string): string | null;
527
+ /**
528
+ * Remote credential files an env-var token supersedes. When an env token is
529
+ * provisioned these are moved aside (renamed, never deleted) so a stale
530
+ * copied login cannot shadow or confuse the provisioned credential.
531
+ */
532
+ credentialFilesSupersededByEnvToken?(token: string): string[];
398
533
  /** On Windows, wrap the command for execution (e.g. via .NET ProcessStartInfo or direct shell). */
399
534
  wrapWindowsPrompt(setupCmd: string, filePath: string, argList: string, sessionId?: string, model?: string, tier?: 'cheap' | 'standard' | 'premium'): string;
400
535
  /** JSON output flag for the CLI (e.g. --output-format json, --json, --format json) */
@@ -402,12 +537,12 @@ export interface ProviderAdapter {
402
537
  /** Args for headless invocation with a safe literal prompt string.
403
538
  * Returns e.g. `-p "LITERAL"` for Claude/AGY/Copilot or `exec "LITERAL"` for Codex. */
404
539
  headlessInvocation(promptLiteral: string): string;
405
- /** Register (or update) this member's apra-fleet MCP endpoint using the provider's own
406
- * native mechanism (CLI verb, e.g. Claude's `claude mcp add`; or config-file merge, e.g.
407
- * AGY/OpenCode). Optional until every provider's mechanism has been investigated and
408
- * implemented -- see docs/member-onboarding-journey.md section 3/3a.
409
- * Returns what was done, for logging/audit. */
410
- registerMcpEndpoint?(opts: RegisterMcpEndpointOptions): Promise<RegisterMcpEndpointResult>;
540
+ /** Writes (ctx.url set) or removes (ctx.url null) the member's PER-FOLDER `apra-fleet`
541
+ * MCP entry in this provider's native per-project config, and prunes the legacy
542
+ * `apra-fleet-member` url+bearer entry wherever this provider keeps MCP servers.
543
+ * Never writes a tracked project `.mcp.json`; never touches deepwiki or any other
544
+ * server. Omitted by providers with nothing to write or prune. */
545
+ syncMemberMcpEntry?(ctx: MemberMcpSyncContext): Promise<MemberMcpSyncResult>;
411
546
  /** Optional provider-NATIVE usage/quota read for execute_prompt budget
412
547
  * awareness (apra-fleet-eft.80.2). When implemented, this is the PRIMARY
413
548
  * source of "spent so far" for a member/workspace budget, in the requested
@@ -438,7 +573,10 @@ export interface ProviderAdapter {
438
573
  * because the PowerShell ones are handed straight to bash.exe and fail (apra-fleet-7dir.2.8).
439
574
  * `transport.writeHomeFile`, when present, delivers the merged file without a shell
440
575
  * command line (node:fs / SFTP) so a large ~/.claude.json cannot overflow the Windows
441
- * CreateProcess limit (GitHub #499); without it the adapter chunks the write on Windows. */
442
- ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell, transport?: WorkspaceTrustTransport, memberHomeDir?: string | null): Promise<EnsureWorkspaceTrustedResult>;
576
+ * CreateProcess limit (GitHub #499); without it the adapter chunks the write on Windows.
577
+ * `memberHomeDir` is the member home resolved in JavaScript (getMemberHomeDir); every
578
+ * member-side path is built from it, never from a shell home variable, and an adapter
579
+ * that needs it refuses (seeded: false, E-MEMBER-HOME-UNRESOLVED) when it is absent. */
580
+ ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell, transport?: WorkspaceTrustTransport, memberHomeDir?: string | null, secretChannel?: MemberSecretFileChannel): Promise<EnsureWorkspaceTrustedResult>;
443
581
  }
444
582
  //# sourceMappingURL=provider.d.ts.map