@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
@@ -0,0 +1,710 @@
1
+ import type { Agent, FleetMcpStatus, LlmProvider, SSHExecResult } from '../types.js';
2
+ import type { TargetOS } from '../providers/provider.js';
3
+ import { getAgentShell } from '../utils/agent-helpers.js';
4
+ import { type StageSecretFileFn } from './member-access-secret.js';
5
+ type MemberShell = ReturnType<typeof getAgentShell>;
6
+ /** Emitted by the probe when the install path is not present/executable. */
7
+ export declare const NO_INSTALL_SENTINEL = "__APRA_FLEET_NO_INSTALL__";
8
+ /** Emitted by the probe when the path exists but running it failed. */
9
+ export declare const EXEC_FAILED_SENTINEL = "__APRA_FLEET_EXEC_FAILED__";
10
+ /** GitHub repo the tagged release assets are published to (.github/workflows/ci.yml). */
11
+ export declare const RELEASE_REPO = "Apra-Labs/apra-fleet";
12
+ /** Normalized CPU architecture names (Node's process.arch spelling). */
13
+ export type MemberArch = 'x64' | 'arm64' | string;
14
+ export interface MemberPlatform {
15
+ os: TargetOS;
16
+ arch: MemberArch;
17
+ }
18
+ /** Why a member could not be given an apra-fleet install. */
19
+ export type FleetInstallUnavailableReason =
20
+ /** The member's home directory could not be resolved, so no path can be built. */
21
+ 'home-unresolved'
22
+ /** The member could not be probed (transport error, non-zero shell exit). */
23
+ | 'probe-failed'
24
+ /** The member's CPU architecture could not be determined. */
25
+ | 'arch-unknown'
26
+ /** Different OS/arch than the orchestrator and no release asset exists for it. */
27
+ | 'unsupported-platform'
28
+ /** Same platform, but this orchestrator is not a single-executable binary to
29
+ * copy, and no release asset could be fetched either. */
30
+ | 'no-install-source'
31
+ /** Downloading the release asset failed. */
32
+ | 'download-failed'
33
+ /** The release asset download did not finish within the bounded timeout. Recoverable: retry. */
34
+ | 'download-timeout'
35
+ /** The downloaded asset's SHA-256 does not match the published checksum; it was discarded. */
36
+ | 'checksum-mismatch'
37
+ /** No published checksum for the asset could be fetched, so it cannot be verified; it was discarded. */
38
+ | 'checksum-unavailable'
39
+ /** No published release (exact-build prerelease, or stable release whose
40
+ * BUILD_INFO names this build) carries an installer for the orchestrator's
41
+ * build. */
42
+ | 'no-matching-release'
43
+ /** The member apra-fleet install has no member-install marker (a full install, or a member install older than the
44
+ * marker): it was not installed over, its server (if running) was left running, and the member was not
45
+ * self-registered into it. */
46
+ | 'full-install-running'
47
+ /** Copying the installer onto the member failed. */
48
+ | 'transfer-failed'
49
+ /** The installer ran but exited non-zero. */
50
+ | 'install-failed'
51
+ /** After installing, the member still does not report a version >= the
52
+ * orchestrator's. */
53
+ | 'install-unverified'
54
+ /** The opt-in full-install replacement (fleet_install "replace-full") failed
55
+ * at a step that ran on the member; the detail names the step and, from the
56
+ * uninstall step on, the rollback commands. */
57
+ | 'replace-failed';
58
+ /** What the probe observed about the member's current install. */
59
+ export type MemberFleetProbe = {
60
+ kind: 'installed';
61
+ version: string;
62
+ binPath: string;
63
+ } | {
64
+ kind: 'missing';
65
+ binPath: string;
66
+ } | {
67
+ kind: 'broken';
68
+ binPath: string;
69
+ detail: string;
70
+ } | {
71
+ kind: 'probe-failed';
72
+ detail: string;
73
+ };
74
+ export type InstallSource = {
75
+ kind: 'orchestrator-executable';
76
+ localPath: string;
77
+ } | {
78
+ kind: 'release-asset';
79
+ assetName: string;
80
+ /** The first URL tried (candidates[0]). */
81
+ url: string;
82
+ /** Releases tried in order (stable first, BUILD_INFO-gated, then the
83
+ * exact-build prerelease) until one has a verified asset for this
84
+ * build; see releaseCandidatesFor and fetchReleaseInstaller. */
85
+ candidates: ReleaseCandidate[];
86
+ };
87
+ export type MemberFleetInstallResult = {
88
+ state: 'available';
89
+ /** Version the member reports after this call. */
90
+ version: string;
91
+ /** True when this call ran an install; false when the existing install
92
+ * was already up to date. */
93
+ installed: boolean;
94
+ source?: InstallSource['kind'];
95
+ binPath: string;
96
+ /** Set when this call replaced an unmarked (full) install with a member
97
+ * install (fleet_install "replace-full"). */
98
+ replaced?: ReplacedFullInstall;
99
+ /** Set when no release carried the exact build and the signed stable
100
+ * release of the same core was installed instead. */
101
+ sameCoreFallback?: SameCoreFallback;
102
+ } | {
103
+ state: 'unavailable';
104
+ reason: FleetInstallUnavailableReason;
105
+ detail?: string;
106
+ /** Version observed before any install attempt, if one was present. */
107
+ version?: string;
108
+ /** OS-correct manual install steps for the member (buildManualInstallSteps). */
109
+ manualSteps?: string;
110
+ };
111
+ /** Injected transports. Production defaults come from defaultMemberFleetInstallDeps(). */
112
+ export interface MemberFleetInstallDeps {
113
+ exec(agent: Agent, command: string, timeoutMs: number): Promise<SSHExecResult>;
114
+ /** Copy local files into an ABSOLUTE member directory (file basename kept). */
115
+ transfer(agent: Agent, localPaths: string[], destinationDir: string): Promise<{
116
+ success: string[];
117
+ failed: {
118
+ path: string;
119
+ error: string;
120
+ }[];
121
+ }>;
122
+ resolveHome(agent: Agent): Promise<string | null>;
123
+ orchestratorPlatform(): MemberPlatform;
124
+ /** Path of the orchestrator's own single-executable binary, or null when it
125
+ * does not run as one (npm/dev mode: there is nothing self-contained to copy). */
126
+ orchestratorExecutable(): string | null;
127
+ orchestratorVersion(): string;
128
+ /** Download `url` to a local temp file named `assetName`, verified against
129
+ * the release's SHA256SUMS; returns its path. With `expectBuild`, the
130
+ * release must also be that build (its BUILD_INFO). Throws on failure
131
+ * (a ReleaseDownloadError names the reason). */
132
+ downloadReleaseAsset(url: string, assetName: string, expectBuild?: string): Promise<string>;
133
+ /** Remove a local temp file created by downloadReleaseAsset. Best effort. */
134
+ removeLocal(localPath: string): void;
135
+ /** Clock for the full-install replacement's backup timestamp. Optional:
136
+ * absent means the real clock. */
137
+ now?(): Date;
138
+ }
139
+ /** Executable name apra-fleet installs itself as on the member's OS. */
140
+ export declare function binaryNameFor(targetOs: TargetOS): string;
141
+ /** Join path segments with the member's separator. A POSIX shell on Windows
142
+ * (gitbash) has a POSIX-style home (/c/Users/x) and takes '/'. */
143
+ export declare function memberJoin(targetOs: TargetOS, shell: MemberShell, ...parts: string[]): string;
144
+ /** Pick the POSIX or PowerShell form of a member-bound command. PowerShell is
145
+ * always delivered via -EncodedCommand so no intermediate shell re-tokenizes it. */
146
+ export declare function memberCommandFor(targetOs: TargetOS, shell: MemberShell, forms: {
147
+ posix: string;
148
+ powershell: string;
149
+ }): string;
150
+ /**
151
+ * The member-side version probe, built from an already-resolved absolute path.
152
+ *
153
+ * Both branches exit 0 and TAG their outcome in stdout, so a non-zero exit
154
+ * means "the shell/transport itself failed" and nothing else.
155
+ *
156
+ * POWERSHELL BRANCH -- DO NOT "SIMPLIFY" THE $LASTEXITCODE TEST OR THE TRAILING
157
+ * `exit 0` (ported from PR 543). PowerShell raises NO terminating error when a
158
+ * NATIVE executable exits non-zero, so a bare try/catch never reaches its catch
159
+ * for a present-but-broken install: the probe would return partial stdout (which
160
+ * may even look like a version) and wrapPowerShellEncoded would propagate the
161
+ * leftover $LASTEXITCODE as the exit code. The explicit $LASTEXITCODE branch
162
+ * reports such an install as EXEC_FAILED instead of reading its output as a
163
+ * version; the catch still covers a path that cannot be launched at all.
164
+ */
165
+ export declare function buildFleetVersionProbe(binPath: string, targetOs: TargetOS, shell: MemberShell): string;
166
+ /** The member's CPU architecture, as one raw token on stdout. */
167
+ export declare function buildArchProbe(targetOs: TargetOS, shell: MemberShell): string;
168
+ /** Normalize uname -m / PROCESSOR_ARCHITECTURE output to Node's process.arch names. */
169
+ export declare function normalizeArch(raw: string): MemberArch | null;
170
+ /** First `apra-fleet <version>` line in the probe output, or null. */
171
+ export declare function parseFleetVersion(stdout: string): string | null;
172
+ /** True when the member's version is older than the orchestrator's (semver
173
+ * core only; a dev build's _hash suffix is ignored). */
174
+ export declare function isOlderThan(memberVersion: string, orchestratorVersion: string): boolean;
175
+ /**
176
+ * Build-aware outdated check for the member install (exported for tests).
177
+ * Rule: a member core OLDER than the orchestrator's is always outdated; a
178
+ * NEWER core never is (never downgrade, whatever the suffixes). At the SAME
179
+ * core, a differing build suffix counts as outdated only when
180
+ * `canSupplyOrchestratorBuild` -- i.e. the source installs exactly the
181
+ * orchestrator's build: its own executable, or (suffixed orchestrator) a
182
+ * release whose BUILD_INFO names that build (sourceSuppliesBuild). A bare
183
+ * release orchestrator installs whatever build its stable tag has, so a
184
+ * same-core build difference there is "up to date" (else it would reinstall
185
+ * on every registration and report install-unverified). Mixed
186
+ * suffix/no-suffix at the same core follows the same rule; identical
187
+ * versions are never outdated.
188
+ * isNewer/parseVersion (shared with the CLI self-update check) are untouched.
189
+ */
190
+ export declare function isMemberOutdated(memberVersion: string, orchestratorVersion: string, canSupplyOrchestratorBuild: boolean): boolean;
191
+ /** Release asset names published by .github/workflows/ci.yml, by platform. */
192
+ export declare const RELEASE_ASSETS: Record<string, string>;
193
+ export declare function releaseAssetNameFor(platform: MemberPlatform): string | null;
194
+ /** `v0.4.4_abc123` -> `v0.4.4`: the STABLE release tag of a build's core version. */
195
+ export declare function releaseTagFor(version: string): string;
196
+ /** `v0.4.4_abc123` -> `v0.4.4_abc123`: the exact-build prerelease tag CI
197
+ * publishes for builds of its prerelease branches (ci.yml job prerelease),
198
+ * or null for a bare release version, which has no build to match. */
199
+ export declare function prereleaseTagFor(version: string): string | null;
200
+ /** Anonymous download URL of `fileName` in the release tagged `tag`. */
201
+ export declare function releaseFileUrl(tag: string, fileName: string): string;
202
+ /** Human-browsable page of the release tagged `tag`. */
203
+ export declare function releasePageUrl(tag: string): string;
204
+ /** Where a build's installer may be published, in the order the installer
205
+ * tries them: the STABLE release of the core version first, accepted only
206
+ * when its BUILD_INFO names the same build (see buildInfoMatches) -- stable
207
+ * tag builds carry a build suffix too, and their commit also gets an
208
+ * unsigned prerelease when it is pushed to main, so a stable orchestrator
209
+ * must get the signed stable assets -- then the exact-build prerelease
210
+ * (dev/branch builds). The same-core stable fallback is not a candidate: it
211
+ * is a separate, opt-in last step in fetchReleaseInstaller. */
212
+ export interface ReleaseCandidate {
213
+ tag: string;
214
+ channel: 'prerelease' | 'stable';
215
+ }
216
+ export declare function releaseCandidatesFor(version: string): ReleaseCandidate[];
217
+ /** The URL the installer tries first for `version` (the stable release). */
218
+ export declare function releaseAssetUrl(version: string, assetName: string): string;
219
+ /**
220
+ * Choose where the member's install comes from (pure; exported for tests).
221
+ * same OS+arch and a copyable orchestrator executable -> that executable;
222
+ * otherwise a release asset for the member's platform;
223
+ * otherwise unavailable(<reason>).
224
+ */
225
+ export declare function chooseInstallSource(member: MemberPlatform, orchestrator: MemberPlatform, orchestratorExecutable: string | null, orchestratorVersion: string): InstallSource | {
226
+ kind: 'unavailable';
227
+ reason: FleetInstallUnavailableReason;
228
+ detail: string;
229
+ };
230
+ /** The member-mode install command line arguments (exported for tests). */
231
+ export declare function memberInstallArgs(provider: LlmProvider): string[];
232
+ /** Command that makes the staged installer executable and runs it in member mode. */
233
+ export declare function buildInstallCommand(installerPath: string, provider: LlmProvider, targetOs: TargetOS, shell: MemberShell): string;
234
+ /** Bound on each release HTTP request (asset and checksum list). */
235
+ export declare const DOWNLOAD_TIMEOUT_MS = 120000;
236
+ /** Name of the checksum list published next to the release assets (ci.yml release job). */
237
+ export declare const CHECKSUM_ASSET = "SHA256SUMS";
238
+ /** Build marker published next to the release assets (ci.yml release and
239
+ * prerelease jobs): `version=<exact build version>` and `commit=<full sha>`
240
+ * lines, itself listed in SHA256SUMS. */
241
+ export declare const BUILD_INFO_ASSET = "BUILD_INFO";
242
+ /** Typed download failure reasons. `release-not-found` (the tag has no
243
+ * release: SHA256SUMS is HTTP 404) and `build-mismatch` (the release is not
244
+ * this build) only move on to the next candidate release; when every
245
+ * candidate ends that way the result is `no-matching-release`. */
246
+ export type ReleaseDownloadReason = 'download-failed' | 'download-timeout' | 'checksum-mismatch' | 'checksum-unavailable' | 'release-not-found' | 'build-mismatch' | 'no-matching-release';
247
+ /** A typed download failure; ensureOnce maps `reason` onto the fleetMcp status. */
248
+ export declare class ReleaseDownloadError extends Error {
249
+ readonly reason: ReleaseDownloadReason;
250
+ /** HTTP status of the failed request, when it got an answer. */
251
+ readonly status?: number | undefined;
252
+ constructor(reason: ReleaseDownloadReason, message: string,
253
+ /** HTTP status of the failed request, when it got an answer. */
254
+ status?: number | undefined);
255
+ }
256
+ /** Parse BUILD_INFO (`key=value` lines). */
257
+ export declare function parseBuildInfo(text: string): {
258
+ version?: string;
259
+ commit?: string;
260
+ };
261
+ /**
262
+ * Does a release's BUILD_INFO describe the build `expected` (the
263
+ * orchestrator's version)? A dev/branch build `v<x.y.z>_<sha6>` matches only
264
+ * the same version, or the same core built from a commit starting with that
265
+ * sha; a bare release version `v<x.y.z>` matches any build of that core.
266
+ */
267
+ export declare function buildInfoMatches(info: {
268
+ version?: string;
269
+ commit?: string;
270
+ }, expected: string): boolean;
271
+ /** The expected hex digest for `assetName` in a `sha256sum`-format list, or null. */
272
+ export declare function parseSha256Sums(text: string, assetName: string): string | null;
273
+ export interface DownloadOpts {
274
+ fetchImpl?: typeof fetch;
275
+ timeoutMs?: number;
276
+ /** The build the release must be (the orchestrator's version). When set,
277
+ * the release is resolved, not assumed: SHA256SUMS HTTP 404 is
278
+ * `release-not-found`, and the release's BUILD_INFO (listed in SHA256SUMS
279
+ * and checksum-verified) must name this build, else `build-mismatch`. */
280
+ expectBuild?: string;
281
+ }
282
+ /**
283
+ * Download a release asset to a temp file, bounded by a timeout, and verify its
284
+ * SHA-256 against the release's published SHA256SUMS before returning the path.
285
+ * Fails closed: a missing checksum is `checksum-unavailable`, a differing one
286
+ * `checksum-mismatch`; nothing unverified is ever written to disk.
287
+ */
288
+ export declare function downloadVerifiedAsset(url: string, assetName: string, opts?: DownloadOpts): Promise<string>;
289
+ /**
290
+ * Fetch the verified installer for the orchestrator's build from the first
291
+ * candidate release that has it: the stable release whose BUILD_INFO names
292
+ * this build, then the exact-build prerelease, then -- only with
293
+ * `allowSameCoreStable` (member has no apra-fleet or an older core) -- the
294
+ * signed stable release of the same core (never across cores). Only a
295
+ * missing release or one that is not this build moves on to the next
296
+ * candidate; any other failure (network, timeout, checksum) is reported as
297
+ * itself, never hidden behind the fallback. Anonymous URLs only.
298
+ */
299
+ export declare function fetchReleaseInstaller(deps: Pick<MemberFleetInstallDeps, 'downloadReleaseAsset'>, source: Extract<InstallSource, {
300
+ kind: 'release-asset';
301
+ }>, orchestratorVersion: string, opts?: {
302
+ allowSameCoreStable?: boolean;
303
+ }): Promise<FetchedReleaseInstaller>;
304
+ /** The signed stable release installed in place of an unpublished exact build. */
305
+ export interface SameCoreFallback {
306
+ /** The stable tag installed, e.g. v0.4.4. */
307
+ tag: string;
308
+ /** The orchestrator build that has no published release. */
309
+ wantedBuild: string;
310
+ /** Why the exact build could not be fetched. */
311
+ why: string;
312
+ }
313
+ /** A fetched, verified installer and where it came from. */
314
+ export interface FetchedReleaseInstaller {
315
+ localPath: string;
316
+ url: string;
317
+ tag: string;
318
+ /** Set when no release carries the exact build and the signed stable
319
+ * release of the same core was used instead. */
320
+ sameCoreFallback?: {
321
+ wantedBuild: string;
322
+ why: string;
323
+ };
324
+ }
325
+ export declare function defaultMemberFleetInstallDeps(): MemberFleetInstallDeps;
326
+ /** Where the member's own apra-fleet lives: <home>/.apra-fleet/bin/<exe>. */
327
+ export declare function memberBinPath(home: string, targetOs: TargetOS, shell: MemberShell): string;
328
+ /** Where installers are staged before running: <home>/.apra-fleet/staging. */
329
+ export declare function memberStagingDir(home: string, targetOs: TargetOS, shell: MemberShell): string;
330
+ /** Probe a member's apra-fleet at `binPath`. Never throws. */
331
+ export declare function probeMemberFleetVersion(agent: Agent, binPath: string, deps: MemberFleetInstallDeps): Promise<MemberFleetProbe>;
332
+ /** Where the installer for the replacement ended up (or why it did not). */
333
+ export type ReplacementInstaller = {
334
+ staged: true;
335
+ path: string;
336
+ } | {
337
+ staged: false;
338
+ why: string;
339
+ target: string;
340
+ fetchCommand?: string;
341
+ };
342
+ /**
343
+ * The manual steps an OWNER runs on the member to replace an unmarked install
344
+ * (a full install, or a member install older than the marker) with a member
345
+ * install, which writes the marker. Every path is resolved here in JS from the
346
+ * probed home -- no ~ or $HOME -- and quoted for the member's shell. The fleet
347
+ * never runs these itself. Steps use the INSTALLED binary only for `uninstall`
348
+ * (present in old installs) and the freshly STAGED current installer for the
349
+ * install, so no flag the old binary predates is ever needed. ASCII, one line.
350
+ */
351
+ export declare function buildFullInstallReplaceHint(opts: {
352
+ home: string;
353
+ targetOs: TargetOS;
354
+ shell: MemberShell;
355
+ provider: LlmProvider;
356
+ installer: ReplacementInstaller;
357
+ }): string;
358
+ /** The explicit fleet_install value that lets the fleet replace an unmarked
359
+ * (full) install with a member install. Never implied by "auto". */
360
+ export declare const REPLACE_FULL_INSTALL = "replace-full";
361
+ /** Tag the linux supervisor step prints when it moved a unit file into the backup. */
362
+ export declare const SUPERVISOR_MOVED_SENTINEL = "__APRA_FLEET_SUPERVISOR_MOVED__";
363
+ /** What a successful replacement removed and where the backup is. */
364
+ export interface ReplacedFullInstall {
365
+ /** The replaced install's version. */
366
+ previousVersion: string;
367
+ /** Human-readable items the replacement removed or moved. */
368
+ removed: string[];
369
+ /** Timestamped backup directory on the member (data/ and fleet.key). */
370
+ backupPath: string;
371
+ }
372
+ export type ReplaceStepName = 'backup' | 'uninstall' | 'supervisor' | 'move-data' | 'install';
373
+ export interface ReplaceFullInstallPlan {
374
+ backupDir: string;
375
+ dataAside: string;
376
+ /** Ordered member-bound commands (already wrapped for the member's shell). */
377
+ steps: Array<{
378
+ name: ReplaceStepName;
379
+ command: string;
380
+ }>;
381
+ /** Rollback commands, in order, per failed step (empty for a backup failure):
382
+ * data/ is left in place before step 4 completes, restored from dataAside
383
+ * after it, and the (possibly torn) backup copy is only a last resort. */
384
+ rollbackFor: Record<ReplaceStepName | 'verify', string[]>;
385
+ }
386
+ /** Path-safe UTC stamp (no ':'): 20261006T143000Z. */
387
+ export declare function replaceBackupStamp(d: Date): string;
388
+ /**
389
+ * The member-bound command sequence of the opt-in replacement (pure; exported
390
+ * for tests). Every path is resolved here from the probed home and quoted for
391
+ * the member's shell; PowerShell is wrapped via -EncodedCommand. Steps:
392
+ * backup -- copy data/ and fleet.key (outside data/) into a timestamped dir;
393
+ * uninstall -- the INSTALLED binary's own uninstall --force --yes;
394
+ * supervisor -- linux: stop/disable the fleet-supervisor user unit when its
395
+ * unit file exists, move the file into the backup, daemon-reload
396
+ * (uninstall leaves it running);
397
+ * move-data -- move data/ aside;
398
+ * install -- the staged CURRENT installer in member mode.
399
+ * Self-registration and the per-folder MCP entry follow in the probe.
400
+ */
401
+ export declare function buildReplaceFullInstallPlan(opts: {
402
+ home: string;
403
+ targetOs: TargetOS;
404
+ shell: MemberShell;
405
+ provider: LlmProvider;
406
+ installerPath: string;
407
+ stamp: string;
408
+ }): ReplaceFullInstallPlan;
409
+ /** The member-install marker on the member: <home>/.apra-fleet/data/member-install.json
410
+ * (written by `install --member`, cleared by a full install; see
411
+ * src/cli/install-guard.ts writeMemberInstallMarker). Built in JS from the
412
+ * probed home. */
413
+ export declare function memberInstallMarkerPathFor(home: string, agent: Agent): string;
414
+ /** Outcome of the member-install marker probe: three-way, never a boolean. */
415
+ export type MemberMarkerProbe = {
416
+ kind: 'present';
417
+ } | {
418
+ kind: 'absent';
419
+ } | {
420
+ kind: 'probe-failed';
421
+ detail: string;
422
+ };
423
+ /**
424
+ * Probe whether the member's apra-fleet install carries the member-install
425
+ * marker, i.e. it is a member install the fleet may manage and self-register
426
+ * into.
427
+ *
428
+ * The marker is the SOLE fleet-ownership signal. An install without it is
429
+ * either a human full install or a member install made before the marker
430
+ * existed; nothing on the member tells the two apart (both may hold a LOCAL
431
+ * registry entry for this member's uuid, because builds before this rule
432
+ * self-registered into any install), so the fleet treats both as not its own:
433
+ * it never self-registers into them and never sends --force-stop-full-install.
434
+ *
435
+ * Three outcomes: present (exit 0), cleanly absent (`test -f` / Test-Path exit
436
+ * 1) and probe-failed (a timeout or transport error, or any other non-zero
437
+ * exit such as 126/127/255) with the reason. A probe failure is never read as
438
+ * "absent": a slow or flaky member is not an unowned one. Never throws.
439
+ */
440
+ export declare function probeMemberInstallMarker(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<MemberMarkerProbe>;
441
+ /**
442
+ * Ensure a REMOTE member runs an apra-fleet at least as new as this
443
+ * orchestrator, installed in HTTP member mode. Never throws: every failure is a
444
+ * typed `unavailable(<reason>)` result so the caller's registration proceeds.
445
+ */
446
+ export declare function ensureMemberFleetInstall(agent: Agent, deps?: MemberFleetInstallDeps, opts?: {
447
+ force?: boolean;
448
+ replaceFull?: boolean;
449
+ }): Promise<MemberFleetInstallResult>;
450
+ /**
451
+ * The exact steps an owner runs ON THE MEMBER to install this orchestrator's
452
+ * build by hand when the fleet could not (pure; exported for tests). Built in
453
+ * JS for the member's OS/shell from the probed home -- no ~, $HOME or other
454
+ * shell expansion -- with every path and URL quoted. The download is the
455
+ * anonymous release URL the fleet itself tried first (no GitHub account
456
+ * needed); the SHA-256 check uses the release's SHA256SUMS (sha256sum on
457
+ * linux and Git Bash, shasum -a 256 on macOS, Get-FileHash in PowerShell).
458
+ * ASCII; one step per line.
459
+ */
460
+ export declare function buildManualInstallSteps(opts: {
461
+ home: string | null;
462
+ targetOs: TargetOS;
463
+ shell: MemberShell;
464
+ provider: LlmProvider;
465
+ arch: MemberArch | null;
466
+ orchestratorVersion: string;
467
+ reason: FleetInstallUnavailableReason;
468
+ }): string;
469
+ /**
470
+ * The prominent WARNING register_member / update_member print when a
471
+ * requested apra-fleet install/upgrade on the member did not happen, or null
472
+ * when there is nothing to warn about. Names (a) the consequence, (b) the
473
+ * exact reason and (c) the manual steps. The tool call itself succeeds. ASCII.
474
+ */
475
+ export declare function fleetInstallWarning(memberName: string, status: FleetMcpStatus): string | null;
476
+ /** Machine-readable fleetMcp reasons beyond the install reasons above. */
477
+ export type FleetMcpUnavailableReason = FleetInstallUnavailableReason
478
+ /** The member's install predates `register-member --id`. */
479
+ | 'install-too-old'
480
+ /** The member's own install has the work folder registered under another id. */
481
+ | 'E-FOLDER-TAKEN'
482
+ /** register-member on the member's own install failed for another reason. */
483
+ | 'register-failed'
484
+ /** The per-folder apra-fleet MCP entry compose_permissions writes is absent
485
+ * or does not point at ?member=<uuid>. */
486
+ | 'mcp-entry-missing'
487
+ /** claude: the role files a `--agent <role>` dispatch loads have a tools
488
+ * allowlist without the member kb_* / code_* tools, so dispatched roles
489
+ * never see them even though the member session lists them. */
490
+ | 'role-agents-hide-member-tools'
491
+ /** agy has no per-project MCP config fleet can point at the member session. */
492
+ | 'no-per-project-mcp'
493
+ /** The member's LLM provider has no MCP entry fleet configures. */
494
+ | 'provider-unsupported'
495
+ /** A member config file compose must edit exists but could not be read; compose wrote nothing to it. */
496
+ | 'member-config-unreadable'
497
+ /** A member config file compose must edit is not strict JSON; compose wrote nothing to it. */
498
+ | 'member-config-unparseable'
499
+ /** The work folder's opencode.json is tracked by git; compose left it untouched. */
500
+ | 'opencode-config-tracked'
501
+ /** The work folder's opencode.json is not strict JSON (e.g. JSONC); compose left it untouched. */
502
+ | 'opencode-config-unparseable'
503
+ /** A MEMBER session could not be opened or its version call failed. */
504
+ | 'member-session-failed'
505
+ /** The MEMBER session answered but did not list kb_* and code_* tools. */
506
+ | 'member-tools-missing'
507
+ /** The member install's member access secret (which its server requires on
508
+ * a ?member= session) could not be read, or created when missing. */
509
+ | 'member-secret-unavailable';
510
+ /** Reasons the sprint init (not the server probe) records for providers it treats as unverified. */
511
+ export type FleetMcpProviderReason = 'no-per-tool-deny' | 'no-per-project-mcp';
512
+ /**
513
+ * One-line operator fix per fleetMcp reason. ASCII only, no newlines. Covers
514
+ * every FleetMcpUnavailableReason plus the provider-level reasons the sprint
515
+ * init records (opencode: no-per-tool-deny; agy: no-per-project-mcp).
516
+ */
517
+ export declare const FLEET_MCP_FIX: Record<FleetMcpUnavailableReason | FleetMcpProviderReason, string>;
518
+ /**
519
+ * The one-line fix to show for a fleetMcp status, or null when the member's KB
520
+ * and code tools are usable (available and not flagged unverified).
521
+ */
522
+ export declare function fleetMcpFixLine(status: {
523
+ state: string;
524
+ reason?: string;
525
+ unverified?: boolean;
526
+ installFailure?: {
527
+ reason: string;
528
+ };
529
+ } | null | undefined): string | null;
530
+ /** A MEMBER session's client surface (subset of the MCP client). */
531
+ export interface MemberSession {
532
+ mcpClient: {
533
+ callTool(name: string, args: unknown): Promise<unknown>;
534
+ listTools(): Promise<unknown>;
535
+ };
536
+ close?: () => Promise<void>;
537
+ transport?: {
538
+ stop?: () => void;
539
+ };
540
+ }
541
+ export interface MemberFleetMcpDeps extends MemberFleetInstallDeps {
542
+ /** Open a direct MEMBER session (?member=<uuid>) to THIS orchestrator's server (local members). */
543
+ connectLocalMember(memberId: string): Promise<MemberSession>;
544
+ now(): Date;
545
+ /** Persist the observation on the member registry entry. */
546
+ record(memberId: string, status: FleetMcpStatus): void;
547
+ /** Do the role files a `claude --agent <role>` dispatch loads grant the
548
+ * member kb_* / code_* tools? Heals what it can (local: rewrites bad role
549
+ * files; remote: re-provisions) and reports `healed` files. Optional:
550
+ * absent means not checked. */
551
+ roleAgents?(agent: Agent): Promise<{
552
+ ok: true;
553
+ healed?: string[];
554
+ } | {
555
+ ok: false;
556
+ detail: string;
557
+ }>;
558
+ /** Write the member's per-folder apra-fleet MCP entry (the compose_permissions
559
+ * writer). Optional: absent means the probe only checks the entry. `reason`
560
+ * is set when a member config could not be safely edited. */
561
+ writeMcpEntry?(agent: Agent): Promise<{
562
+ ok: true;
563
+ } | {
564
+ ok: false;
565
+ reason?: string;
566
+ detail: string;
567
+ }>;
568
+ /** Stage content in a fresh owner-only file on the member (the secret-file
569
+ * channel); used to create a missing member access secret there. Optional:
570
+ * absent means a missing secret cannot be created. */
571
+ stageSecretFile?: StageSecretFileFn;
572
+ /** Persist the member install's access secret (encrypted) on the registry entry. */
573
+ recordMemberSecret?(memberId: string, secret: string): void;
574
+ }
575
+ /** Test-only: replace the production transports used by register/update/remove_member and member_detail. Pass null to restore. */
576
+ export declare function __setMemberFleetMcpDeps(deps: MemberFleetMcpDeps | null): void;
577
+ /** The deps the tool handlers use (production transports unless a test injected fakes). */
578
+ export declare function getMemberFleetMcpDeps(): MemberFleetMcpDeps;
579
+ export declare function defaultMemberFleetMcpDeps(): MemberFleetMcpDeps;
580
+ /** `register-member` on the member's own install, as a LOCAL member under the
581
+ * orchestrator's id for it (exported for tests). */
582
+ export declare function buildSelfRegisterCommand(binPath: string, agent: Agent, targetOs: TargetOS, shell: MemberShell): string;
583
+ /** `remove-member` on the member's own install (exported for tests). */
584
+ export declare function buildSelfRemoveCommand(binPath: string, memberId: string, targetOs: TargetOS, shell: MemberShell): string;
585
+ /** `call --member <uuid> version` (with a `{}` args file written first) or
586
+ * `call --member <uuid> --list-tools`, on the member (exported for tests). */
587
+ export declare function buildMemberCallCommand(binPath: string, memberId: string, what: 'version' | 'list-tools', argsPath: string, targetOs: TargetOS, shell: MemberShell): string;
588
+ /**
589
+ * Cap on member-side error text recorded in fleetMcp.detail. Large enough that
590
+ * the leading ERROR line plus its cause (e.g. compose_permissions' full
591
+ * searched-path list) always survive; only a runaway output is truncated.
592
+ */
593
+ export declare const MEMBER_ERROR_DETAIL_MAX = 4000;
594
+ /**
595
+ * The member-side error text to record in fleetMcp.detail. Keeps the HEAD of
596
+ * the output (the `ERROR: ...` line and its cause come first), never the tail:
597
+ * a tail slice drops the leading cause and leaves only the end of a long list.
598
+ */
599
+ export declare function memberErrorDetail(out: string, max?: number): string;
600
+ /**
601
+ * The URL of the member's per-folder apra-fleet MCP entry written by
602
+ * compose_permissions, or null when there is none. claude:
603
+ * <config dir>/.claude.json projects[<folder>].mcpServers['apra-fleet'].url;
604
+ * opencode: <workFolder>/opencode.json mcp['apra-fleet'].url.
605
+ */
606
+ export declare function readMemberMcpEntryUrl(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<string | null>;
607
+ /** Outcome of resolving the port a remote member's own install listens on. */
608
+ export type MemberPortResolution = {
609
+ kind: 'resolved';
610
+ port: number;
611
+ source: 'marker' | 'default';
612
+ note?: string;
613
+ } | {
614
+ kind: 'failed';
615
+ detail: string;
616
+ };
617
+ /**
618
+ * The port a REMOTE member's own apra-fleet install listens on, resolved on
619
+ * the member: the `port` its member-install marker
620
+ * (<home>/.apra-fleet/data/member-install.json) records. server.json in the
621
+ * same data dir is only advisory -- a no-op `apra-fleet start` never rewrites
622
+ * it, so it can describe an older instance -- and a disagreement is reported
623
+ * in `note` while the marker wins. A marker that records no port (an install
624
+ * from before port recording) resolves to the built-in default with a note
625
+ * saying so. Read commands carry resolved, quoted paths built here in JS (no
626
+ * shell variable expansion). Never throws.
627
+ */
628
+ export declare function resolveMemberMcpPort(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<MemberPortResolution>;
629
+ /**
630
+ * Observe a member's apra-fleet MCP server and return its fleetMcp status.
631
+ * Never throws and never records -- see refreshMemberFleetMcp for that.
632
+ *
633
+ * - agy: unavailable(no-per-project-mcp), unverified; nothing is probed.
634
+ * - providers with no per-folder fleet entry: unavailable(provider-unsupported), unverified.
635
+ * - LOCAL members: no install and no per-folder entry (a claude dispatch gets
636
+ * the member config per session, --mcp-config). Verified by opening a
637
+ * MEMBER session for the uuid on this server through the client's own
638
+ * server resolution (registered member, version answers, kb_* / code_*
639
+ * listed) -- the same server and member identity the injected URL names,
640
+ * not a request to that literal URL or a run of the CLI with the file.
641
+ * - remote members: ensure the install (opts.install, default true; false
642
+ * only probes the version), register the member on its own install
643
+ * (`register-member --type local --id <uuid>`), check the per-folder MCP
644
+ * entry (not for claude: per-session config, the entry is only its
645
+ * fallback), then verify a MEMBER session through `apra-fleet call`.
646
+ * - claude, both: the role files `--agent <role>` loads must grant the member
647
+ * tools; roleAgents heals them (local rewrite, remote re-provision) first.
648
+ */
649
+ export declare function probeMemberFleetMcp(agent: Agent, deps?: MemberFleetMcpDeps, opts?: ProbeOpts): Promise<FleetMcpStatus>;
650
+ /** Fix line recorded with a missing/broken bd on a member. ASCII, one line. */
651
+ export declare const BEADS_MISSING_FIX = "Run update_member {member_id, fleet_install: \"auto\"} so the member installer puts bd in <home>/.apra-fleet/bin (or install bd on the member so bd --version works), then member_detail with refresh:true.";
652
+ /** Suffix for a register/update fleetMcp result line: names a missing bd, else ''. */
653
+ export declare function beadsStatusNote(status: Pick<FleetMcpStatus, 'beads'>): string;
654
+ /** Where the member installer places bd when npm -g is not writable. */
655
+ export declare function memberBeadsPath(home: string, targetOs: TargetOS, shell: MemberShell): string;
656
+ /**
657
+ * The member-side bd probe: bd on the member's PATH first, else the member
658
+ * install's <home>/.apra-fleet/bin copy -- the same order every fleet-built
659
+ * member command resolves it in (BIN_DIR is appended to PATH). Tagged like
660
+ * buildFleetVersionProbe: always exits 0, outcome in stdout.
661
+ */
662
+ export declare function buildBeadsProbe(bdPath: string, targetOs: TargetOS, shell: MemberShell): string;
663
+ /**
664
+ * Probe bd on a remote member. Returns the `beads` field to record when bd is
665
+ * missing or broken there, or null when it works or the probe itself could
666
+ * not run (an unreachable member is reported by the fleetMcp status already).
667
+ * Never throws.
668
+ */
669
+ export declare function probeMemberBeads(agent: Agent, deps: MemberFleetInstallDeps): Promise<NonNullable<FleetMcpStatus['beads']> | null>;
670
+ /** Probe options. `writeMcpEntry` (register_member / update_member with a
671
+ * fleet install) writes the per-folder MCP entry before it is checked;
672
+ * without it (member_detail refresh) the probe stays read-only. */
673
+ export interface ProbeOpts {
674
+ install?: boolean;
675
+ forceInstall?: boolean;
676
+ writeMcpEntry?: boolean;
677
+ /** fleet_install "replace-full": with `install`, replace an unmarked (full)
678
+ * install with a member install instead of refusing it. Never implied. */
679
+ replaceFull?: boolean;
680
+ }
681
+ /**
682
+ * Probe and RECORD the member's fleetMcp status on its registry entry. The
683
+ * record is an observation, overwritten on every call, so a re-probe after a
684
+ * manual fix flips unavailable -> available with no restart.
685
+ */
686
+ export declare function refreshMemberFleetMcp(agent: Agent, deps?: MemberFleetMcpDeps, opts?: ProbeOpts): Promise<FleetMcpStatus>;
687
+ export type SelfRemoveResult = {
688
+ removed: boolean;
689
+ detail: string;
690
+ } | {
691
+ removed: false;
692
+ reason: 'home-unresolved' | 'install-too-old' | 'remove-failed' | 'probe-failed';
693
+ detail: string;
694
+ }
695
+ /** The member-side removal was deliberately not run: the install is not fleet-owned (marker absent) or ownership could not be established (marker probe failed). */
696
+ | {
697
+ removed: false;
698
+ skipped: true;
699
+ reason: 'not-fleet-owned' | 'probe-failed';
700
+ detail: string;
701
+ };
702
+ /**
703
+ * Remove the member's self-registration from its OWN install (remove_member's
704
+ * counterpart of the register step). Local members share this orchestrator's
705
+ * install, whose registry remove_member already edits, so nothing runs for
706
+ * them. A member with no install has nothing to remove. Never throws.
707
+ */
708
+ export declare function removeMemberFromOwnInstall(agent: Agent, deps?: MemberFleetInstallDeps): Promise<SelfRemoveResult>;
709
+ export {};
710
+ //# sourceMappingURL=member-fleet-install.d.ts.map