@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,14 @@
1
+ export declare const SERVICE_NOTICE_PATH: string;
2
+ /** `shown`: the text was already printed to a console, so the next service verb does not repeat it. */
3
+ export declare function writeServiceNotice(text: string, file?: string, now?: Date, shown?: boolean): void;
4
+ export declare function clearServiceNotice(file?: string): void;
5
+ /** Remove the pending notice only when its text contains `marker` (an obsolete refusal). */
6
+ export declare function clearServiceNoticeContaining(marker: string, file?: string): void;
7
+ /**
8
+ * The notice text if it has not been shown yet, marking it shown (the file
9
+ * stays until registration clears it). Null when there is nothing new.
10
+ */
11
+ export declare function takePendingServiceNotice(file?: string, now?: Date): string | null;
12
+ /** Print a pending notice once, on stderr (stdout of service verbs may be parsed). */
13
+ export declare function showPendingServiceNotice(file?: string): void;
14
+ //# sourceMappingURL=service-notice.d.ts.map
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Pending service notice: guidance install could not show to the user.
3
+ * `apra-fleet update` runs install detached with stdio ignored, so a message
4
+ * printed by service registration (e.g. a legacy Windows task that could not
5
+ * be replaced) never reaches anyone. Registration persists it here; the next
6
+ * service verb (status/start/stop/restart/update) prints it once, and
7
+ * registration clears it once the current service definition is in place.
8
+ */
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+ import { FLEET_DIR } from '../paths.js';
12
+ export const SERVICE_NOTICE_PATH = path.join(FLEET_DIR, 'service-notice.json');
13
+ /** `shown`: the text was already printed to a console, so the next service verb does not repeat it. */
14
+ export function writeServiceNotice(text, file = SERVICE_NOTICE_PATH, now = new Date(), shown = false) {
15
+ try {
16
+ fs.mkdirSync(path.dirname(file), { recursive: true });
17
+ const n = { createdAt: now.toISOString(), text, ...(shown ? { shownAt: now.toISOString() } : {}) };
18
+ fs.writeFileSync(file, JSON.stringify(n, null, 2));
19
+ }
20
+ catch { /* best-effort: never fail registration on the notice */ }
21
+ }
22
+ export function clearServiceNotice(file = SERVICE_NOTICE_PATH) {
23
+ try {
24
+ fs.unlinkSync(file);
25
+ }
26
+ catch { /* absent */ }
27
+ }
28
+ /** Remove the pending notice only when its text contains `marker` (an obsolete refusal). */
29
+ export function clearServiceNoticeContaining(marker, file = SERVICE_NOTICE_PATH) {
30
+ if (readNotice(file)?.text.includes(marker))
31
+ clearServiceNotice(file);
32
+ }
33
+ function readNotice(file) {
34
+ try {
35
+ const n = JSON.parse(fs.readFileSync(file, 'utf8'));
36
+ return typeof n?.text === 'string' && n.text ? n : null;
37
+ }
38
+ catch {
39
+ return null;
40
+ }
41
+ }
42
+ /**
43
+ * The notice text if it has not been shown yet, marking it shown (the file
44
+ * stays until registration clears it). Null when there is nothing new.
45
+ */
46
+ export function takePendingServiceNotice(file = SERVICE_NOTICE_PATH, now = new Date()) {
47
+ const n = readNotice(file);
48
+ if (!n || n.shownAt)
49
+ return null;
50
+ try {
51
+ fs.writeFileSync(file, JSON.stringify({ ...n, shownAt: now.toISOString() }, null, 2));
52
+ }
53
+ catch { /* shown again next time */ }
54
+ return n.text;
55
+ }
56
+ /** Print a pending notice once, on stderr (stdout of service verbs may be parsed). */
57
+ export function showPendingServiceNotice(file = SERVICE_NOTICE_PATH) {
58
+ const text = takePendingServiceNotice(file);
59
+ if (text)
60
+ console.error(`Note from the last apra-fleet install:\n${text}\n`);
61
+ }
62
+ //# sourceMappingURL=service-notice.js.map
@@ -0,0 +1,20 @@
1
+ export declare const MAX_CONSECUTIVE_FAILURES = 3;
2
+ export declare const BACKOFF_MS: number;
3
+ export declare const SERVICE_START_STATE_PATH: string;
4
+ /**
5
+ * Skip this launch? Returns the one-line reason when skipping, else null.
6
+ */
7
+ export declare function serviceStartBackoff(file?: string, now?: number): string | null;
8
+ /** Count this launch as a failure until clearServiceStartFailures() runs. */
9
+ export declare function recordServiceStartAttempt(file?: string, now?: number): void;
10
+ export declare function clearServiceStartFailures(file?: string): void;
11
+ export declare const SERVICE_NOTICE_STATE_PATH: string;
12
+ export declare const SERVICE_NOTICE_INTERVAL_MS: number;
13
+ /**
14
+ * Rate limit for routine service-launch notices ("already running", "stopped
15
+ * by user -- not starting"): the Windows task's revive trigger fires every 5
16
+ * minutes, which would otherwise append ~288 identical lines a day to the
17
+ * service log. True at most once per interval per kind.
18
+ */
19
+ export declare function shouldLogServiceNotice(kind: string, file?: string, now?: number, intervalMs?: number): boolean;
20
+ //# sourceMappingURL=service-start-guard.d.ts.map
@@ -0,0 +1,86 @@
1
+ /**
2
+ * Backoff for service-manager launches that keep failing (GitHub #585
3
+ * recovery). The Windows task has a repeating revive trigger, and every OS
4
+ * service launches at logon; a server that refuses (port held by another app,
5
+ * unresponsive holder -- exit 0 under the service marker, so no crash loop)
6
+ * or crashes at startup would otherwise retry every interval forever, each
7
+ * attempt a new fleet-<pid>.log.
8
+ *
9
+ * State lives in <data dir>/service-start-failures.json. Every service launch
10
+ * counts as a failure until it is listening; a successful start (or finding
11
+ * a healthy server already running) clears it. After MAX_CONSECUTIVE_FAILURES
12
+ * failures in a row, launches are skipped (one line to stdout, exit 0) until
13
+ * BACKOFF_MS has passed since the last attempt. An explicit user start
14
+ * (apra-fleet start/install) clears the state first, so it is never skipped.
15
+ */
16
+ import fs from 'node:fs';
17
+ import path from 'node:path';
18
+ import { FLEET_DIR } from '../paths.js';
19
+ export const MAX_CONSECUTIVE_FAILURES = 3;
20
+ export const BACKOFF_MS = 30 * 60 * 1000;
21
+ export const SERVICE_START_STATE_PATH = path.join(FLEET_DIR, 'service-start-failures.json');
22
+ function readState(file) {
23
+ try {
24
+ const s = JSON.parse(fs.readFileSync(file, 'utf8'));
25
+ if (typeof s?.consecutive === 'number' && typeof s?.lastAttemptAt === 'number')
26
+ return s;
27
+ }
28
+ catch { /* absent or corrupt */ }
29
+ return null;
30
+ }
31
+ /**
32
+ * Skip this launch? Returns the one-line reason when skipping, else null.
33
+ */
34
+ export function serviceStartBackoff(file = SERVICE_START_STATE_PATH, now = Date.now()) {
35
+ const s = readState(file);
36
+ if (!s || s.consecutive < MAX_CONSECUTIVE_FAILURES)
37
+ return null;
38
+ const retryAt = s.lastAttemptAt + BACKOFF_MS;
39
+ if (now >= retryAt)
40
+ return null;
41
+ return `apra-fleet service launch skipped: the last ${s.consecutive} service starts failed or were refused `
42
+ + `(see the logs in ${path.dirname(file)}); next automatic attempt after ${new Date(retryAt).toISOString()}. `
43
+ + `'apra-fleet start' retries immediately.`;
44
+ }
45
+ /** Count this launch as a failure until clearServiceStartFailures() runs. */
46
+ export function recordServiceStartAttempt(file = SERVICE_START_STATE_PATH, now = Date.now()) {
47
+ const s = readState(file);
48
+ const next = { consecutive: (s?.consecutive ?? 0) + 1, lastAttemptAt: now };
49
+ try {
50
+ fs.mkdirSync(path.dirname(file), { recursive: true });
51
+ fs.writeFileSync(file, JSON.stringify(next));
52
+ }
53
+ catch { /* best-effort: never block a start on the guard */ }
54
+ }
55
+ export function clearServiceStartFailures(file = SERVICE_START_STATE_PATH) {
56
+ try {
57
+ fs.unlinkSync(file);
58
+ }
59
+ catch { /* absent */ }
60
+ }
61
+ export const SERVICE_NOTICE_STATE_PATH = path.join(FLEET_DIR, 'service-notices.json');
62
+ export const SERVICE_NOTICE_INTERVAL_MS = 60 * 60 * 1000;
63
+ /**
64
+ * Rate limit for routine service-launch notices ("already running", "stopped
65
+ * by user -- not starting"): the Windows task's revive trigger fires every 5
66
+ * minutes, which would otherwise append ~288 identical lines a day to the
67
+ * service log. True at most once per interval per kind.
68
+ */
69
+ export function shouldLogServiceNotice(kind, file = SERVICE_NOTICE_STATE_PATH, now = Date.now(), intervalMs = SERVICE_NOTICE_INTERVAL_MS) {
70
+ let state = {};
71
+ try {
72
+ state = JSON.parse(fs.readFileSync(file, 'utf8')) ?? {};
73
+ }
74
+ catch { /* absent or corrupt */ }
75
+ const last = state[kind];
76
+ if (typeof last === 'number' && now - last < intervalMs)
77
+ return false;
78
+ state[kind] = now;
79
+ try {
80
+ fs.mkdirSync(path.dirname(file), { recursive: true });
81
+ fs.writeFileSync(file, JSON.stringify(state));
82
+ }
83
+ catch { /* best-effort */ }
84
+ return true;
85
+ }
86
+ //# sourceMappingURL=service-start-guard.js.map
@@ -0,0 +1,24 @@
1
+ /** The last cumulative cost seen for a session, or undefined. */
2
+ export declare function lastSessionCost(sessionId: string | undefined): number | undefined;
3
+ /** Records the latest cumulative cost seen for a session. */
4
+ export declare function recordSessionCost(sessionId: string | undefined, cumulativeUsd: number): void;
5
+ /**
6
+ * The cost of ONE dispatch, from the cumulative figure its result reported.
7
+ *
8
+ * @param cumulativeUsd the result's cumulative session cost
9
+ * @param sessionId the session the result landed on
10
+ * @param continuedFrom the session whose saved total this invocation started
11
+ * from: the resumed session id for a resume, the source id for a fork,
12
+ * undefined for a fresh session (baseline 0)
13
+ * @returns the delta in USD, or undefined when the invocation continued a
14
+ * session whose earlier total this server never saw (the caller then falls
15
+ * back to pricing the token counts). The cumulative figure is recorded as
16
+ * the session's new baseline either way.
17
+ */
18
+ export declare function dispatchCostFromCumulative(cumulativeUsd: number, sessionId: string | undefined, continuedFrom: string | undefined): number | undefined;
19
+ /** Test-only: drop the in-memory cache (the file is re-read on next use). */
20
+ export declare function _resetSessionCostCache(): void;
21
+ /** Test-only: keep the baselines in `p` instead of the shared data dir
22
+ * (null restores the default); also drops the in-memory cache. */
23
+ export declare function _setSessionCostFileForTest(p: string | null): void;
24
+ //# sourceMappingURL=session-cost.d.ts.map
@@ -0,0 +1,105 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { FLEET_DIR } from '../paths.js';
4
+ /**
5
+ * Per-dispatch cost from a provider's CUMULATIVE session cost figure.
6
+ *
7
+ * Claude Code's result `total_cost_usd` is cumulative for the session, not
8
+ * per invocation. Its own field docs (CLI 2.1.291): "a resumed or forked
9
+ * session continues from the total its transcript saved, when it has one (so
10
+ * the first result already carries the earlier turns) ... and a mid-session
11
+ * /clear resets the running total." fleet dispatches resume the member's
12
+ * session routinely, so taking the figure as-is would charge every earlier
13
+ * turn again on each resume. The dispatch's own cost is the delta against the
14
+ * last figure this server saw for the session (or, for a fork, for its source
15
+ * session).
16
+ *
17
+ * The last-seen figures are persisted (a small JSON map under the fleet data
18
+ * dir, newest MAX_ENTRIES kept) so a server restart does not lose the
19
+ * baseline and charge a whole session's history to the next resume.
20
+ */
21
+ const MAX_ENTRIES = 500;
22
+ const fileName = 'session-costs.json';
23
+ let cache = null;
24
+ let fileOverride = null;
25
+ function filePath() {
26
+ return fileOverride ?? path.join(FLEET_DIR, fileName);
27
+ }
28
+ function load() {
29
+ if (cache)
30
+ return cache;
31
+ cache = new Map();
32
+ try {
33
+ const raw = JSON.parse(fs.readFileSync(filePath(), 'utf-8'));
34
+ if (raw && typeof raw === 'object') {
35
+ for (const [k, v] of Object.entries(raw)) {
36
+ if (typeof v === 'number' && Number.isFinite(v) && v >= 0)
37
+ cache.set(k, v);
38
+ }
39
+ }
40
+ }
41
+ catch { /* missing or unreadable: start empty */ }
42
+ return cache;
43
+ }
44
+ function save(map) {
45
+ try {
46
+ fs.mkdirSync(path.dirname(filePath()), { recursive: true });
47
+ fs.writeFileSync(filePath(), JSON.stringify(Object.fromEntries(map)) + '\n');
48
+ }
49
+ catch { /* best effort: an unwritable data dir only loses the baseline */ }
50
+ }
51
+ /** The last cumulative cost seen for a session, or undefined. */
52
+ export function lastSessionCost(sessionId) {
53
+ if (!sessionId)
54
+ return undefined;
55
+ return load().get(sessionId);
56
+ }
57
+ /** Records the latest cumulative cost seen for a session. */
58
+ export function recordSessionCost(sessionId, cumulativeUsd) {
59
+ if (!sessionId || !Number.isFinite(cumulativeUsd) || cumulativeUsd < 0)
60
+ return;
61
+ const map = load();
62
+ map.delete(sessionId); // re-insert so insertion order tracks recency
63
+ map.set(sessionId, cumulativeUsd);
64
+ while (map.size > MAX_ENTRIES) {
65
+ const oldest = map.keys().next().value;
66
+ map.delete(oldest);
67
+ }
68
+ save(map);
69
+ }
70
+ /**
71
+ * The cost of ONE dispatch, from the cumulative figure its result reported.
72
+ *
73
+ * @param cumulativeUsd the result's cumulative session cost
74
+ * @param sessionId the session the result landed on
75
+ * @param continuedFrom the session whose saved total this invocation started
76
+ * from: the resumed session id for a resume, the source id for a fork,
77
+ * undefined for a fresh session (baseline 0)
78
+ * @returns the delta in USD, or undefined when the invocation continued a
79
+ * session whose earlier total this server never saw (the caller then falls
80
+ * back to pricing the token counts). The cumulative figure is recorded as
81
+ * the session's new baseline either way.
82
+ */
83
+ export function dispatchCostFromCumulative(cumulativeUsd, sessionId, continuedFrom) {
84
+ let base = 0;
85
+ if (continuedFrom)
86
+ base = lastSessionCost(continuedFrom);
87
+ recordSessionCost(sessionId, cumulativeUsd);
88
+ if (base === undefined)
89
+ return undefined;
90
+ // A figure below the baseline means the total restarted (no saved total in
91
+ // the transcript, or a /clear): the whole figure is this dispatch's.
92
+ const delta = cumulativeUsd >= base ? cumulativeUsd - base : cumulativeUsd;
93
+ return Math.round(delta * 1e10) / 1e10; // strip float noise from the subtraction
94
+ }
95
+ /** Test-only: drop the in-memory cache (the file is re-read on next use). */
96
+ export function _resetSessionCostCache() {
97
+ cache = null;
98
+ }
99
+ /** Test-only: keep the baselines in `p` instead of the shared data dir
100
+ * (null restores the default); also drops the in-memory cache. */
101
+ export function _setSessionCostFileForTest(p) {
102
+ fileOverride = p;
103
+ cache = null;
104
+ }
105
+ //# sourceMappingURL=session-cost.js.map
@@ -0,0 +1,83 @@
1
+ import type { Agent } from '../types.js';
2
+ import { type MemberExecFn } from './member-config-io.js';
3
+ import { type StageSecretFileFn } from './member-access-secret.js';
4
+ /** Work-folder-relative name of a remote member's per-dispatch config file. */
5
+ export declare const REMOTE_SESSION_MCP_FILE = ".fleet-session-mcp.json";
6
+ /**
7
+ * Whether a dispatch to `agent` gets the per-session member config.
8
+ * - claude only (the flag is a Claude CLI flag);
9
+ * - local members: always -- they share this server -- except while the
10
+ * recorded fleetMcp says this server refused the member session;
11
+ * - remote members: only when the member's recorded fleetMcp says its own
12
+ * server answered a member session. Pointing a session at a server that is
13
+ * not there would replace a working user-scope entry with a dead one.
14
+ */
15
+ export declare function sessionMcpInjectionAvailable(agent: Agent): boolean;
16
+ /**
17
+ * Whether compose_permissions should write the per-folder apra-fleet entry.
18
+ * Not for a local claude member: every dispatch to it gets the member config
19
+ * per session, so a folder entry would only change the human's own sessions
20
+ * in that clone. Remote members keep it as the fallback for a dispatch where
21
+ * injection is unavailable.
22
+ */
23
+ export declare function perFolderMcpEntryNeeded(agent: Agent): boolean;
24
+ /**
25
+ * The config file body: exactly one http `apra-fleet` server at the member URL.
26
+ *
27
+ * `alwaysLoad: true` (Claude Code MCP server option) keeps every tool of that
28
+ * server in the session's prompt instead of deferring it behind the
29
+ * tool-search tool, so a role session can call kb_* / code_* from its first
30
+ * turn without a discovery round-trip. Emitted only when the caller has
31
+ * established that the member's CLI accepts it (see resolveSessionMcpAlwaysLoad).
32
+ */
33
+ export declare function sessionMcpConfigContent(agent: Pick<Agent, 'id' | 'agentType' | 'memberMcpPort' | 'encryptedMemberMcpSecret'>, opts?: {
34
+ alwaysLoad?: boolean;
35
+ }): string;
36
+ /** First `X.Y.Z` in a CLI's version output (e.g. "2.1.291 (Claude Code)"). */
37
+ export declare function parseCliVersion(output: string): string | undefined;
38
+ /** Numeric dotted-version comparison: true when `version` >= `min`. */
39
+ export declare function cliVersionAtLeast(version: string, min: string): boolean;
40
+ /** How long a probed member CLI version is reused before it is probed again
41
+ * (a CLI update on the member is picked up within this window). */
42
+ export declare const CLI_VERSION_CACHE_TTL_MS: number;
43
+ /** Test hook: forget every cached member CLI version. */
44
+ export declare function resetCliVersionCache(): void;
45
+ /**
46
+ * Decides whether this dispatch's session config may carry `alwaysLoad`.
47
+ * The provider names the minimum CLI version that supports it
48
+ * (ProviderAdapter.mcpAlwaysLoadMinVersion); the member's CLI version is
49
+ * probed with `versionCmd` and cached per member. Never throws. When the
50
+ * mechanism cannot be applied the config is written WITHOUT the key (an
51
+ * unknown key could invalidate the entry on an older CLI, leaving the session
52
+ * with no apra-fleet server at all) and `warning` names the cause, so the
53
+ * dispatcher can log it -- the tools then stay deferred for that session.
54
+ */
55
+ export declare function resolveSessionMcpAlwaysLoad(agent: Pick<Agent, 'id'>, minVersion: string | undefined, versionCmd: string, exec: MemberExecFn, now?: () => number): Promise<{
56
+ alwaysLoad: boolean;
57
+ warning?: string;
58
+ }>;
59
+ /** Absolute member-side path of the config file (see the header for the layout). */
60
+ export declare function sessionMcpConfigPath(agent: Agent, resolvedWorkFolder: string): string;
61
+ /** remove_member: deletes a local member's reused config file (no-op when absent).
62
+ * A remote member's file is per dispatch and already removed with its prompt file. */
63
+ export declare function removeLocalSessionMcpConfig(agent: Pick<Agent, 'id' | 'agentType'>): void;
64
+ /** True when the file lives in the work folder and must be removed after the dispatch. */
65
+ export declare function sessionMcpConfigIsPerDispatch(agent: Agent): boolean;
66
+ /**
67
+ * Writes the config file. Local: through fs, owner-only. Remote: a config
68
+ * carrying the access secret goes through the owner-only secret-file channel
69
+ * plus a content-free move (never a command string); one without a secret (an
70
+ * install older than the secret) through the shared member file writer
71
+ * (quoted resolved path, read back). Never throws: a failure returns its
72
+ * detail so the caller falls back to a dispatch without the flag.
73
+ */
74
+ export declare function writeSessionMcpConfig(agent: Agent, absPath: string, exec: MemberExecFn, opts?: {
75
+ alwaysLoad?: boolean;
76
+ stage?: StageSecretFileFn;
77
+ }): Promise<{
78
+ ok: true;
79
+ } | {
80
+ ok: false;
81
+ detail: string;
82
+ }>;
83
+ //# sourceMappingURL=session-mcp-config.d.ts.map
@@ -0,0 +1,211 @@
1
+ // Per-session apra-fleet MCP config for Claude role dispatches.
2
+ //
3
+ // Every Claude session execute_prompt starts for a member is given the
4
+ // member-scoped apra-fleet server (http://localhost:<port>/mcp?member=<uuid>,
5
+ // see memberMcpUrl) through the CLI's `--mcp-config <file>` flag. The entry is
6
+ // named `apra-fleet`, so it overrides a user-scope `apra-fleet` entry for THAT
7
+ // session only, while every other configured server (deepwiki, ...) stays
8
+ // available. `--strict-mcp-config` is deliberately NOT used for that reason.
9
+ //
10
+ // The per-folder entry compose_permissions writes for remote members is the
11
+ // fallback for a dispatch where injection is unavailable (fewer tools, never
12
+ // zero). Local members need no per-folder entry at all.
13
+ //
14
+ // File location (resolved in JavaScript, never by the member's shell):
15
+ // - local members: <FLEET_DIR>/session-mcp/<uuid>.json -- one file per
16
+ // member, outside the work folder, overwritten on every dispatch (no
17
+ // accumulation, and the human's own sessions in that folder are untouched);
18
+ // - remote members: <workFolder>/.fleet-session-mcp.json, written next to the
19
+ // prompt file and removed with it when the dispatch ends. The name is not
20
+ // `.mcp.json`, so no Claude session picks it up on its own.
21
+ //
22
+ // The entry carries the member install's access secret as an http header
23
+ // (member-access-secret.ts): its server refuses a `?member=` session without
24
+ // it. So the file is owner-only -- local: written with mode 0600; remote:
25
+ // staged through the owner-only secret-file channel and moved into place by
26
+ // a content-free command, never written through a command string.
27
+ import fs from 'node:fs';
28
+ import path from 'node:path';
29
+ import { FLEET_DIR } from '../paths.js';
30
+ import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
31
+ import { ensureGitExcluded, joinMemberPath, memberMcpUrl, writeMemberFile, MEMBER_MCP_SERVER_NAME } from './member-config-io.js';
32
+ import { deliverMemberFileViaSecretChannel, memberMcpHeaders } from './member-access-secret.js';
33
+ import { removeMemberSecretFile, writeMemberSecretFile } from './member-secret-env.js';
34
+ /** Work-folder-relative name of a remote member's per-dispatch config file. */
35
+ export const REMOTE_SESSION_MCP_FILE = '.fleet-session-mcp.json';
36
+ /** Recorded fleetMcp reasons that still mean the member's own server answers
37
+ * a ?member= session (the problem is elsewhere), so injection is safe. */
38
+ const SERVER_OK_REASONS = new Set(['role-agents-hide-member-tools']);
39
+ /**
40
+ * Whether a dispatch to `agent` gets the per-session member config.
41
+ * - claude only (the flag is a Claude CLI flag);
42
+ * - local members: always -- they share this server -- except while the
43
+ * recorded fleetMcp says this server refused the member session;
44
+ * - remote members: only when the member's recorded fleetMcp says its own
45
+ * server answered a member session. Pointing a session at a server that is
46
+ * not there would replace a working user-scope entry with a dead one.
47
+ */
48
+ export function sessionMcpInjectionAvailable(agent) {
49
+ if ((agent.llmProvider ?? 'claude') !== 'claude')
50
+ return false;
51
+ const f = agent.fleetMcp;
52
+ // Local: this server -- unless it last refused this member's session.
53
+ if (agent.agentType === 'local')
54
+ return !(f?.state === 'unavailable' && f.reason === 'member-session-failed');
55
+ if (!f)
56
+ return false;
57
+ if (f.state === 'available')
58
+ return f.unverified !== true;
59
+ return !!f.reason && SERVER_OK_REASONS.has(f.reason);
60
+ }
61
+ /**
62
+ * Whether compose_permissions should write the per-folder apra-fleet entry.
63
+ * Not for a local claude member: every dispatch to it gets the member config
64
+ * per session, so a folder entry would only change the human's own sessions
65
+ * in that clone. Remote members keep it as the fallback for a dispatch where
66
+ * injection is unavailable.
67
+ */
68
+ export function perFolderMcpEntryNeeded(agent) {
69
+ return !(agent.agentType === 'local' && (agent.llmProvider ?? 'claude') === 'claude');
70
+ }
71
+ /**
72
+ * The config file body: exactly one http `apra-fleet` server at the member URL.
73
+ *
74
+ * `alwaysLoad: true` (Claude Code MCP server option) keeps every tool of that
75
+ * server in the session's prompt instead of deferring it behind the
76
+ * tool-search tool, so a role session can call kb_* / code_* from its first
77
+ * turn without a discovery round-trip. Emitted only when the caller has
78
+ * established that the member's CLI accepts it (see resolveSessionMcpAlwaysLoad).
79
+ */
80
+ export function sessionMcpConfigContent(agent, opts = {}) {
81
+ const entry = { type: 'http', url: memberMcpUrl(agent) };
82
+ const headers = memberMcpHeaders(agent);
83
+ if (headers)
84
+ entry.headers = headers;
85
+ if (opts.alwaysLoad)
86
+ entry.alwaysLoad = true;
87
+ return JSON.stringify({ mcpServers: { [MEMBER_MCP_SERVER_NAME]: entry } });
88
+ }
89
+ /** First `X.Y.Z` in a CLI's version output (e.g. "2.1.291 (Claude Code)"). */
90
+ export function parseCliVersion(output) {
91
+ return /(\d+)\.(\d+)\.(\d+)/.exec(output)?.[0];
92
+ }
93
+ /** Numeric dotted-version comparison: true when `version` >= `min`. */
94
+ export function cliVersionAtLeast(version, min) {
95
+ const a = version.split('.').map(Number);
96
+ const b = min.split('.').map(Number);
97
+ for (let i = 0; i < Math.max(a.length, b.length); i++) {
98
+ const d = (a[i] ?? 0) - (b[i] ?? 0);
99
+ if (d !== 0)
100
+ return d > 0;
101
+ }
102
+ return true;
103
+ }
104
+ /** How long a probed member CLI version is reused before it is probed again
105
+ * (a CLI update on the member is picked up within this window). */
106
+ export const CLI_VERSION_CACHE_TTL_MS = 10 * 60 * 1000;
107
+ const cliVersionCache = new Map();
108
+ /** Test hook: forget every cached member CLI version. */
109
+ export function resetCliVersionCache() {
110
+ cliVersionCache.clear();
111
+ }
112
+ /**
113
+ * Decides whether this dispatch's session config may carry `alwaysLoad`.
114
+ * The provider names the minimum CLI version that supports it
115
+ * (ProviderAdapter.mcpAlwaysLoadMinVersion); the member's CLI version is
116
+ * probed with `versionCmd` and cached per member. Never throws. When the
117
+ * mechanism cannot be applied the config is written WITHOUT the key (an
118
+ * unknown key could invalidate the entry on an older CLI, leaving the session
119
+ * with no apra-fleet server at all) and `warning` names the cause, so the
120
+ * dispatcher can log it -- the tools then stay deferred for that session.
121
+ */
122
+ export async function resolveSessionMcpAlwaysLoad(agent, minVersion, versionCmd, exec, now = Date.now) {
123
+ if (!minVersion) {
124
+ return { alwaysLoad: false, warning: 'the provider has no MCP always-load option; kb/code tools may stay deferred behind tool search' };
125
+ }
126
+ let version;
127
+ const cached = cliVersionCache.get(agent.id);
128
+ if (cached && now() - cached.at < CLI_VERSION_CACHE_TTL_MS) {
129
+ version = cached.version;
130
+ }
131
+ else {
132
+ try {
133
+ const r = await exec(versionCmd, 30_000);
134
+ if (typeof r.code !== 'number' || r.code === 0)
135
+ version = parseCliVersion(`${r.stdout}\n${r.stderr}`);
136
+ }
137
+ catch { /* reported below */ }
138
+ if (version)
139
+ cliVersionCache.set(agent.id, { version, at: now() });
140
+ }
141
+ if (!version) {
142
+ return { alwaysLoad: false, warning: `member CLI version could not be determined, so the MCP always-load option was not applied (needs >= ${minVersion}); kb/code tools may stay deferred behind tool search` };
143
+ }
144
+ if (!cliVersionAtLeast(version, minVersion)) {
145
+ return { alwaysLoad: false, warning: `member CLI ${version} is older than ${minVersion}, so the MCP always-load option was not applied; kb/code tools stay deferred behind tool search (update the member CLI)` };
146
+ }
147
+ return { alwaysLoad: true };
148
+ }
149
+ /** Absolute member-side path of the config file (see the header for the layout). */
150
+ export function sessionMcpConfigPath(agent, resolvedWorkFolder) {
151
+ if (agent.agentType === 'local') {
152
+ return path.join(FLEET_DIR, 'session-mcp', `${agent.id}.json`);
153
+ }
154
+ return joinMemberPath(resolvedWorkFolder, REMOTE_SESSION_MCP_FILE, getAgentOS(agent) === 'windows', getAgentShell(agent));
155
+ }
156
+ /** remove_member: deletes a local member's reused config file (no-op when absent).
157
+ * A remote member's file is per dispatch and already removed with its prompt file. */
158
+ export function removeLocalSessionMcpConfig(agent) {
159
+ if (agent.agentType !== 'local')
160
+ return;
161
+ try {
162
+ fs.unlinkSync(path.join(FLEET_DIR, 'session-mcp', `${agent.id}.json`));
163
+ }
164
+ catch { /* absent */ }
165
+ }
166
+ /** True when the file lives in the work folder and must be removed after the dispatch. */
167
+ export function sessionMcpConfigIsPerDispatch(agent) {
168
+ return agent.agentType !== 'local';
169
+ }
170
+ /**
171
+ * Writes the config file. Local: through fs, owner-only. Remote: a config
172
+ * carrying the access secret goes through the owner-only secret-file channel
173
+ * plus a content-free move (never a command string); one without a secret (an
174
+ * install older than the secret) through the shared member file writer
175
+ * (quoted resolved path, read back). Never throws: a failure returns its
176
+ * detail so the caller falls back to a dispatch without the flag.
177
+ */
178
+ export async function writeSessionMcpConfig(agent, absPath, exec, opts = {}) {
179
+ const content = sessionMcpConfigContent(agent, opts);
180
+ try {
181
+ if (agent.agentType === 'local') {
182
+ fs.mkdirSync(path.dirname(absPath), { recursive: true });
183
+ fs.writeFileSync(absPath, content, { encoding: 'utf-8', mode: 0o600 });
184
+ try {
185
+ fs.chmodSync(absPath, 0o600);
186
+ }
187
+ catch { /* Windows */ }
188
+ return { ok: true };
189
+ }
190
+ const posix = isPosixShell(getAgentOS(agent), getAgentShell(agent));
191
+ if (memberMcpHeaders(agent)) {
192
+ const stage = opts.stage ?? ((a, c) => writeMemberSecretFile(a, c, 'session-mcp'));
193
+ await deliverMemberFileViaSecretChannel(agent, exec, absPath, content, stage, removeMemberSecretFile);
194
+ }
195
+ else {
196
+ await writeMemberFile(exec, absPath, content, posix);
197
+ }
198
+ // Keep the file out of `git status` (and a role's `git add -A`) even when
199
+ // compose never ran for this clone. Best effort: a non-repo or a failed
200
+ // exclude never blocks the dispatch.
201
+ try {
202
+ await ensureGitExcluded(exec, agent.workFolder, [REMOTE_SESSION_MCP_FILE], getAgentOS(agent) === 'windows', getAgentShell(agent));
203
+ }
204
+ catch { /* best effort */ }
205
+ return { ok: true };
206
+ }
207
+ catch (err) {
208
+ return { ok: false, detail: err instanceof Error ? err.message : String(err) };
209
+ }
210
+ }
211
+ //# sourceMappingURL=session-mcp-config.js.map
@@ -1,4 +1,22 @@
1
+ import type { Client, SFTPWrapper } from 'ssh2';
1
2
  import type { Agent } from '../types.js';
3
+ /**
4
+ * Inactivity budget for one SFTP operation (session open, mkdir, writeFile,
5
+ * fastPut, fastGet). INACTIVITY-based, not a wall-clock ceiling: fastPut and
6
+ * fastGet report every chunk through their `step` callback and each report
7
+ * re-arms the timer, so a large transfer that keeps making progress is never
8
+ * cut; one that stops moving for this long is. On expiry the SFTP session is
9
+ * ended (its channel closed, its pooled-connection lease released) and the
10
+ * transfer rejects with SftpTimeoutError naming the member, path and budget.
11
+ * Without it a transfer the far side never answers pins its channel -- one
12
+ * of the member sshd's MaxSessions -- for as long as the connection lives.
13
+ */
14
+ export declare const SFTP_INACTIVITY_TIMEOUT_MS = 120000;
15
+ export declare class SftpTimeoutError extends Error {
16
+ constructor(agent: Agent, op: string, target: string, timeoutMs: number);
17
+ }
18
+ /** Open an SFTP session on `client`; a refused subsystem request closes its channel. */
19
+ export declare function openSftp(client: Client): Promise<SFTPWrapper>;
2
20
  export declare function uploadViaSFTP(agent: Agent, localPaths: string[], destinationPath?: string, abortSignal?: AbortSignal): Promise<{
3
21
  success: string[];
4
22
  failed: {
@@ -21,6 +39,22 @@ export declare function uploadContentToHome(agent: Agent, files: Array<{
21
39
  error: string;
22
40
  }[];
23
41
  }>;
42
+ /**
43
+ * SFTP reports a Windows (Win32-OpenSSH) path as "/C:/Users/x"; every member
44
+ * shell (PowerShell or Git Bash) wants "C:/Users/x". POSIX paths pass through.
45
+ */
46
+ export declare function sftpPathToShellPath(p: string): string;
47
+ /**
48
+ * Write a secret-bearing file into the connecting user's home directory over
49
+ * SFTP, so the value never appears in any command line on the member. The
50
+ * file is created owner-only (0600; Windows ignores the mode -- the user
51
+ * profile ACL is the boundary there). Returns the absolute path in the form
52
+ * the member's shell accepts, resolved by the SFTP server itself (never a
53
+ * guessed home directory).
54
+ */
55
+ export declare function writeSecretFileInHome(agent: Agent, fileName: string, content: string): Promise<string>;
56
+ /** Best-effort removal of a file written by writeSecretFileInHome. */
57
+ export declare function removeSecretFile(agent: Agent, shellPath: string): Promise<void>;
24
58
  export declare function downloadViaSFTP(agent: Agent, remotePaths: string[], localDestination: string, abortSignal?: AbortSignal): Promise<{
25
59
  success: string[];
26
60
  failed: {