@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,354 @@
1
+ /**
2
+ * AGY project binding (docs/agy-provider.md section 1).
3
+ *
4
+ * A headless `agy -p` run only enforces a project's permissionGrants when the
5
+ * run names that project with `--project <id>`; without it every run on the
6
+ * machine shares default-cli-project. Each agy member therefore owns one agy
7
+ * project, created once with `agy --new-project` and recorded on the Agent as
8
+ * `agyProjectId`. compose_permissions writes grants into that project's file
9
+ * and every dispatch passes `--project <agyProjectId>`.
10
+ *
11
+ * agy silently falls back to default-cli-project when `<id>.json` is missing
12
+ * or unparseable (docs/agy-provider.md section 1), so the file is probed before
13
+ * it is relied on and the project is re-provisioned when the probe fails.
14
+ */
15
+ import os from 'node:os';
16
+ import { getStrategy } from './strategy.js';
17
+ import { updateAgent } from './registry.js';
18
+ import { buildAgyNodeCommand, AGY_MODEL_FOR_TIER } from '../providers/agy.js';
19
+ import { getModelOverride } from './user-config.js';
20
+ import { stageAuthEnv, removeMemberSecretFile } from './member-secret-env.js';
21
+ import { logLine, logWarn } from '../utils/log-helpers.js';
22
+ /** Raised when an agy project cannot be created or verified. */
23
+ export class AgyProjectError extends Error {
24
+ constructor(message) {
25
+ super(message);
26
+ this.name = 'AgyProjectError';
27
+ }
28
+ }
29
+ /** agy project ids are UUIDs; anything else is refused before it is embedded
30
+ * in a member-side script or a command line. */
31
+ const PROJECT_ID_RE = /^[A-Za-z0-9][A-Za-z0-9-]{0,127}$/;
32
+ export function isValidAgyProjectId(id) {
33
+ return typeof id === 'string' && PROJECT_ID_RE.test(id);
34
+ }
35
+ const PROBE_MARKER = 'FLEET_AGY_PROJECT:';
36
+ const NEW_PROJECT_MARKER = 'FLEET_AGY_NEW_PROJECT:';
37
+ const DELETE_MARKER = 'FLEET_AGY_PROJECT_DELETE:';
38
+ /** The prompt of the one model turn `agy --new-project` needs. It asks for no
39
+ * tool use: the id is read from the new project file and agy's own log, never
40
+ * from the model (the model does not know it -- see docs/agy-provider.md section 1). */
41
+ export const AGY_NEW_PROJECT_PROMPT = 'Reply with only the word OK. Do not use any tools.';
42
+ const PROBE_TIMEOUT_MS = 30_000;
43
+ const NEW_PROJECT_SPAWN_TIMEOUT_MS = 180_000;
44
+ const NEW_PROJECT_EXEC_TIMEOUT_MS = 240_000;
45
+ /** JS expression for the member's home directory inside a member-side node
46
+ * script. A local member's home is this process's home (resolved here, in
47
+ * JS); a remote member's is the node process's own os.homedir() on the
48
+ * member -- never a shell variable, and never a probed MSYS path that node
49
+ * on Windows would misread. */
50
+ function homeExpr(home) {
51
+ return home ? JSON.stringify(home) : "require('os').homedir()";
52
+ }
53
+ export function buildAgyProjectProbeScript(projectId, home) {
54
+ if (!isValidAgyProjectId(projectId))
55
+ throw new AgyProjectError(`invalid agy project id "${String(projectId)}"`);
56
+ return `const fs = require('fs');
57
+ const path = require('path');
58
+ const home = ${homeExpr(home)};
59
+ const id = ${JSON.stringify(projectId)};
60
+ const f = path.join(home, '.gemini', 'config', 'projects', id + '.json');
61
+ let state = 'ok';
62
+ if (!fs.existsSync(f)) {
63
+ state = 'missing';
64
+ } else {
65
+ try {
66
+ const j = JSON.parse(fs.readFileSync(f, 'utf8'));
67
+ if (!j || typeof j !== 'object' || Array.isArray(j)) state = 'corrupt';
68
+ else if (j.id !== id) state = 'id_mismatch';
69
+ } catch (e) {
70
+ state = 'corrupt';
71
+ }
72
+ }
73
+ console.log(${JSON.stringify(PROBE_MARKER)} + JSON.stringify({ state }));`;
74
+ }
75
+ /**
76
+ * Member-side node script: list ~/.gemini/config/projects, run
77
+ * `agy --new-project` (spawned directly, no shell) in the work folder with a
78
+ * --log-file, list again, and report the new file names plus the ids agy
79
+ * logged as `created project "<name>" (id=<id>)`. The log file is deleted and
80
+ * its content is never echoed (it carries the account e-mail).
81
+ */
82
+ export function buildAgyNewProjectScript(opts) {
83
+ const file = opts.agyCommand?.file ?? 'agy';
84
+ const leadArgs = opts.agyCommand?.args ?? [];
85
+ const args = [
86
+ ...leadArgs,
87
+ '--add-dir', opts.workFolder,
88
+ '--model', opts.model,
89
+ '--output-format', 'json',
90
+ '--log-file', '__LOG_FILE__',
91
+ '--new-project',
92
+ '-p', AGY_NEW_PROJECT_PROMPT,
93
+ ];
94
+ return `const fs = require('fs');
95
+ const path = require('path');
96
+ const os = require('os');
97
+ const cp = require('child_process');
98
+ const home = ${homeExpr(opts.home)};
99
+ const dir = path.join(home, '.gemini', 'config', 'projects');
100
+ function list() {
101
+ try { return fs.readdirSync(dir).filter(function (f) { return f.endsWith('.json'); }); } catch (e) { return []; }
102
+ }
103
+ const before = new Set(list());
104
+ const logFile = path.join(os.tmpdir(), 'fleet-agy-new-project-' + process.pid + '-' + Date.now() + '.log');
105
+ const env = Object.assign({}, process.env, ${JSON.stringify(opts.env ?? {})});
106
+ ['ANTIGRAVITY_SOURCE_METADATA', 'CLAUDE_SOURCE_METADATA', 'COPILOT_SOURCE_METADATA', 'CODEX_SOURCE_METADATA'].forEach(function (k) { delete env[k]; });
107
+ const pathKey = Object.keys(env).find(function (k) { return k.toUpperCase() === 'PATH'; }) || 'PATH';
108
+ const extra = [path.join(home, '.local', 'bin')];
109
+ if (process.platform === 'win32' && env.LOCALAPPDATA) extra.push(path.join(env.LOCALAPPDATA, 'agy', 'bin'));
110
+ env[pathKey] = extra.join(path.delimiter) + path.delimiter + (env[pathKey] || '');
111
+ const args = ${JSON.stringify(args)}.map(function (a) { return a === '__LOG_FILE__' ? logFile : a; });
112
+ const r = cp.spawnSync(${JSON.stringify(file)}, args, { cwd: ${JSON.stringify(opts.workFolder)}, env: env, encoding: 'utf8', timeout: ${NEW_PROJECT_SPAWN_TIMEOUT_MS}, windowsHide: true });
113
+ const created = list().filter(function (f) { return !before.has(f); }).map(function (f) { return f.slice(0, -5); });
114
+ const logIds = [];
115
+ try {
116
+ const log = fs.readFileSync(logFile, 'utf8');
117
+ const re = /created project "[^"]*" \\(id=([A-Za-z0-9-]+)\\)/g;
118
+ let m;
119
+ while ((m = re.exec(log)) !== null) { if (logIds.indexOf(m[1]) < 0) logIds.push(m[1]); }
120
+ } catch (e) {}
121
+ try { fs.unlinkSync(logFile); } catch (e) {}
122
+ console.log(${JSON.stringify(NEW_PROJECT_MARKER)} + JSON.stringify({
123
+ created: created,
124
+ logIds: logIds,
125
+ status: r.status,
126
+ spawnError: r.error ? String(r.error.message || r.error) : undefined,
127
+ stderrTail: String(r.stderr || '').slice(-400),
128
+ }));`;
129
+ }
130
+ function extractMarkedJson(stdout, marker) {
131
+ // indexOf, not startsWith: Windows PowerShell can prefix the line with its
132
+ // own CLIXML progress record ("...</Objs>FLEET_AGY_...").
133
+ const line = stdout.split(/\r?\n/).reverse().find(l => l.includes(marker));
134
+ if (!line)
135
+ return undefined;
136
+ try {
137
+ return JSON.parse(line.slice(line.indexOf(marker) + marker.length).trim());
138
+ }
139
+ catch {
140
+ return undefined;
141
+ }
142
+ }
143
+ /**
144
+ * Member-side script for remove_member's best-effort cleanup: deletes the
145
+ * member's own `<projectId>.json` plus, if present, the legacy
146
+ * `fleet-<memberId>.json` from an earlier design (older fleet versions), from ~/.gemini/config/projects only. A missing
147
+ * target is not an error (fs.rm's force:true); any other failure (e.g.
148
+ * permission denied) is reported back per target so the caller can decide
149
+ * whether it is warning-worthy.
150
+ */
151
+ export function buildAgyProjectDeleteScript(projectId, memberId, home) {
152
+ if (!isValidAgyProjectId(projectId))
153
+ throw new AgyProjectError(`invalid agy project id "${String(projectId)}"`);
154
+ return `const fs = require('fs');
155
+ const path = require('path');
156
+ const home = ${homeExpr(home)};
157
+ const dir = path.join(home, '.gemini', 'config', 'projects');
158
+ const targets = [${JSON.stringify(projectId + '.json')}, ${JSON.stringify('fleet-' + memberId + '.json')}];
159
+ const deleted = [];
160
+ const errors = [];
161
+ for (const name of targets) {
162
+ const f = path.join(dir, name);
163
+ try {
164
+ fs.unlinkSync(f);
165
+ deleted.push(name);
166
+ } catch (e) {
167
+ if (!e || e.code !== 'ENOENT') errors.push(name + ': ' + (e && e.message ? e.message : String(e)));
168
+ }
169
+ }
170
+ console.log(${JSON.stringify(DELETE_MARKER)} + JSON.stringify({ deleted, errors }));`;
171
+ }
172
+ export function parseAgyProjectDeleteResult(result) {
173
+ const parsed = extractMarkedJson(result.stdout ?? '', DELETE_MARKER);
174
+ if (!parsed) {
175
+ const detail = (result.stderr || result.stdout || '').trim().slice(0, 300);
176
+ throw new AgyProjectError(`agy project delete produced no result (exit ${result.code})${detail ? `: ${detail}` : ''}`);
177
+ }
178
+ return {
179
+ deleted: Array.isArray(parsed.deleted) ? parsed.deleted.filter((c) => typeof c === 'string') : [],
180
+ errors: Array.isArray(parsed.errors) ? parsed.errors.filter((c) => typeof c === 'string') : [],
181
+ };
182
+ }
183
+ export function parseAgyProjectProbe(result) {
184
+ const parsed = extractMarkedJson(result.stdout ?? '', PROBE_MARKER);
185
+ const state = parsed?.state;
186
+ if (state === 'ok' || state === 'missing' || state === 'corrupt' || state === 'id_mismatch')
187
+ return state;
188
+ const detail = (result.stderr || result.stdout || '').trim().slice(0, 300);
189
+ throw new AgyProjectError(`agy project probe produced no result (exit ${result.code})${detail ? `: ${detail}` : ''}`);
190
+ }
191
+ /**
192
+ * Validates the output of the new-project script: exactly one new
193
+ * `<uuid>.json` must have appeared, and agy's own log must name the same id.
194
+ * Anything else throws with the evidence.
195
+ */
196
+ export function parseAgyNewProjectResult(result) {
197
+ const parsed = extractMarkedJson(result.stdout ?? '', NEW_PROJECT_MARKER);
198
+ if (!parsed) {
199
+ const detail = (result.stderr || result.stdout || '').trim().slice(0, 300);
200
+ throw new AgyProjectError(`agy --new-project could not be run on the member (exit ${result.code})${detail ? `: ${detail}` : ''}`);
201
+ }
202
+ const created = Array.isArray(parsed.created) ? parsed.created.filter((c) => typeof c === 'string') : [];
203
+ const logIds = Array.isArray(parsed.logIds) ? parsed.logIds.filter((c) => typeof c === 'string') : [];
204
+ const agyFailure = parsed.spawnError
205
+ ? ` agy could not be started: ${parsed.spawnError}.`
206
+ : (parsed.status !== 0 ? ` agy exited ${parsed.status}${parsed.stderrTail ? `: ${String(parsed.stderrTail).trim()}` : ''}.` : '');
207
+ if (created.length !== 1) {
208
+ throw new AgyProjectError(`agy --new-project must create exactly one project file in ~/.gemini/config/projects, found ${created.length}` +
209
+ `${created.length ? ` (${created.join(', ')})` : ''}.${agyFailure}`);
210
+ }
211
+ const id = created[0];
212
+ if (!isValidAgyProjectId(id)) {
213
+ throw new AgyProjectError(`agy --new-project created an unexpected project file "${id}.json".${agyFailure}`);
214
+ }
215
+ if (logIds.length !== 1 || logIds[0] !== id) {
216
+ throw new AgyProjectError(`agy --new-project created "${id}.json" but agy's log names ${logIds.length ? logIds.join(', ') : 'no created project'}; ` +
217
+ `refusing to bind an unconfirmed project id.${agyFailure}`);
218
+ }
219
+ if (parsed.spawnError || parsed.status !== 0) {
220
+ throw new AgyProjectError(`agy --new-project created "${id}.json" but did not complete.${agyFailure}`);
221
+ }
222
+ return id;
223
+ }
224
+ function defaultExec(agent) {
225
+ const strategy = getStrategy(agent);
226
+ return (command, timeoutMs) => strategy.execCommand(command, timeoutMs);
227
+ }
228
+ function homeFor(agent) {
229
+ return agent.agentType === 'local' ? os.homedir() : null;
230
+ }
231
+ function memberOs(agent) {
232
+ return agent.os ?? 'linux';
233
+ }
234
+ export async function probeAgyProject(agent, projectId, exec = defaultExec(agent)) {
235
+ const cmd = buildAgyNodeCommand(buildAgyProjectProbeScript(projectId, homeFor(agent)), memberOs(agent), 'FLEET_AGY_PROBE_EOF');
236
+ return parseAgyProjectProbe(await exec(cmd, PROBE_TIMEOUT_MS));
237
+ }
238
+ /**
239
+ * remove_member's best-effort cleanup: deletes the member's own agy project
240
+ * file (and a legacy fleet-<id>.json, if present) from its machine. Callers
241
+ * must skip this entirely when another registered member shares the same
242
+ * agyProjectId, and must treat any thrown AgyProjectError as a warning, not a
243
+ * reason to abort the removal.
244
+ */
245
+ export async function removeAgyProject(agent, exec = defaultExec(agent)) {
246
+ if (!agent.agyProjectId)
247
+ throw new AgyProjectError(`member "${agent.friendlyName}" has no agy project id`);
248
+ const cmd = buildAgyNodeCommand(buildAgyProjectDeleteScript(agent.agyProjectId, agent.id, homeFor(agent)), memberOs(agent), 'FLEET_AGY_PROJECT_DELETE_EOF');
249
+ return parseAgyProjectDeleteResult(await exec(cmd, PROBE_TIMEOUT_MS));
250
+ }
251
+ // One `agy --new-project` at a time per machine: the new id is identified by
252
+ // diffing the projects directory, which two concurrent creations would break.
253
+ const provisionLocks = new Map();
254
+ function machineKey(agent) {
255
+ if (agent.agentType === 'local')
256
+ return 'local';
257
+ if (agent.agentType === 'relay')
258
+ return `relay:${agent.relayMemberId ?? agent.id}`;
259
+ return `remote:${agent.host ?? agent.id}`;
260
+ }
261
+ async function withMachineLock(agent, fn) {
262
+ const key = machineKey(agent);
263
+ const prev = provisionLocks.get(key) ?? Promise.resolve();
264
+ const run = prev.catch(() => undefined).then(fn);
265
+ provisionLocks.set(key, run);
266
+ try {
267
+ return await run;
268
+ }
269
+ finally {
270
+ if (provisionLocks.get(key) === run)
271
+ provisionLocks.delete(key);
272
+ }
273
+ }
274
+ let agyCommandOverride;
275
+ /** Test seam: run a stand-in executable instead of the real `agy` on the
276
+ * member (undefined restores the default). */
277
+ export function setAgyCommandForTests(cmd) {
278
+ agyCommandOverride = cmd;
279
+ }
280
+ /** Creates a new agy project for the member and returns its id. Does not
281
+ * persist it -- see ensureAgyProject. */
282
+ export async function provisionAgyProject(agent, exec = defaultExec(agent), agyCommand = agyCommandOverride) {
283
+ if (!agent.workFolder)
284
+ throw new AgyProjectError('member has no work folder');
285
+ // Under the test suite (NODE_ENV=test, set by tests/setup.ts) never spawn
286
+ // the real agy: it would create projects in the developer's real
287
+ // ~/.gemini and run a model turn. Without a test override the stand-in
288
+ // exits 97 and provisioning fails ("agy exited 97").
289
+ if (!agyCommand && process.env.NODE_ENV === 'test') {
290
+ agyCommand = { file: process.execPath, args: ['-e', 'process.exit(97)', '--'] };
291
+ }
292
+ const model = getModelOverride('agy', 'cheap') ?? AGY_MODEL_FOR_TIER.cheap;
293
+ // Stored auth env vars reach agy through the staged env file the command
294
+ // loads (inherited by node, then by the agy spawn) -- never embedded in the
295
+ // script text, which is part of the member command line for the whole run.
296
+ const script = buildAgyNewProjectScript({
297
+ workFolder: agent.workFolder,
298
+ model,
299
+ home: homeFor(agent),
300
+ agyCommand,
301
+ });
302
+ const cmd = buildAgyNodeCommand(script, memberOs(agent), 'FLEET_AGY_NEW_PROJECT_EOF');
303
+ return withMachineLock(agent, async () => {
304
+ const staged = await stageAuthEnv(agent);
305
+ try {
306
+ return parseAgyNewProjectResult(await exec(staged.prefix + cmd, NEW_PROJECT_EXEC_TIMEOUT_MS));
307
+ }
308
+ catch (err) {
309
+ if (staged.path)
310
+ await removeMemberSecretFile(agent, staged.path);
311
+ throw err;
312
+ }
313
+ });
314
+ }
315
+ /**
316
+ * Returns a verified project id for an agy member, creating the project when
317
+ * the member has none (upgrade path for members registered before project
318
+ * binding) or when its project file is missing, unparseable or names a
319
+ * different id. Sets `agent.agyProjectId` on the passed object and, unless
320
+ * persist is false, in the registry. Throws AgyProjectError on failure --
321
+ * callers must treat that as a hard error, never fall back to running agy
322
+ * without --project.
323
+ */
324
+ export async function ensureAgyProject(agent, options = {}) {
325
+ if ((agent.llmProvider ?? 'claude') !== 'agy') {
326
+ throw new AgyProjectError(`member "${agent.friendlyName}" is not an agy member`);
327
+ }
328
+ const exec = options.exec ?? defaultExec(agent);
329
+ let reason;
330
+ const current = agent.agyProjectId;
331
+ if (current === undefined || current === '') {
332
+ reason = 'no_project_id';
333
+ }
334
+ else if (!isValidAgyProjectId(current)) {
335
+ reason = 'invalid_project_id';
336
+ }
337
+ else {
338
+ const state = await probeAgyProject(agent, current, exec);
339
+ if (state === 'ok')
340
+ return { projectId: current };
341
+ reason = state;
342
+ }
343
+ if (reason !== 'no_project_id') {
344
+ logWarn('agy_project', `agy project "${current}" for "${agent.friendlyName}" is ${reason} -- creating a new project`, agent);
345
+ }
346
+ const projectId = await provisionAgyProject(agent, exec, options.agyCommand ?? agyCommandOverride);
347
+ agent.agyProjectId = projectId;
348
+ if (options.persist !== false) {
349
+ updateAgent(agent.id, { agyProjectId: projectId });
350
+ }
351
+ logLine('agy_project', `created agy project ${projectId} for "${agent.friendlyName}" (${reason})`, agent);
352
+ return { projectId, provisioned: reason };
353
+ }
354
+ //# sourceMappingURL=agy-project.js.map
@@ -76,6 +76,31 @@ export declare function isSSHSession(): boolean;
76
76
  * SSH and headless service sessions have SESSIONNAME !== 'Console'.
77
77
  */
78
78
  export declare function hasInteractiveDesktop(): boolean;
79
+ /**
80
+ * Build the AppleScript that opens a macOS Terminal window, runs the auth
81
+ * command in it, and waits for it to finish. Terminal's `do script` hands the
82
+ * string to the user's login shell, so every argv element is POSIX
83
+ * single-quoted (member names and the --prompt text can carry spaces and
84
+ * caller-supplied host/username values), and the whole command is then escaped
85
+ * for the AppleScript string literal (backslash first, then double quote).
86
+ * The command writes its own exit code to `tmpFile` so the caller can read it.
87
+ * Exported for tests.
88
+ */
89
+ export declare function buildMacTerminalAppleScript(fullArgs: string[], tmpFile: string): string;
90
+ /** Title of the Windows credential-entry console window (set by the child). */
91
+ export declare const WINDOWS_AUTH_WINDOW_TITLE = "Fleet Password Entry";
92
+ /** Env var the `secret` CLI reads to title its console window on Windows. */
93
+ export declare const OOB_WINDOW_TITLE_ENV = "APRA_FLEET_OOB_WINDOW_TITLE";
94
+ /**
95
+ * Build the spawn() call that opens the Windows credential-entry console.
96
+ * Returns the file/argv for a hidden PowerShell launcher plus the env vars it
97
+ * reads. Exported for tests.
98
+ */
99
+ export declare function buildWindowsAuthLaunch(fullArgs: string[]): {
100
+ file: string;
101
+ args: string[];
102
+ env: Record<string, string>;
103
+ };
79
104
  /**
80
105
  * Launch a new terminal window running `apra-fleet secret --set <memberName>` or `apra-fleet auth <memberName>`.
81
106
  * Records the spawned PID in the pending request so it can be killed when credential is received.
@@ -7,6 +7,7 @@ import { spawn, execSync } from 'node:child_process';
7
7
  import { FLEET_DIR } from '../paths.js';
8
8
  import { encryptPassword } from '../utils/crypto.js';
9
9
  import { logError } from '../utils/log-helpers.js';
10
+ import { escapeShellArg, escapeAppleScriptString, quoteWindowsArgv } from '../utils/shell-escape.js';
10
11
  import { OOB_TIMEOUT_MS } from '../utils/oob-timeout.js';
11
12
  import { launchAuthWeb } from './auth-web.js';
12
13
  import { fleetEvents } from './event-bus.js';
@@ -33,7 +34,7 @@ function killProcess(pid) {
33
34
  return;
34
35
  try {
35
36
  if (process.platform === 'win32') {
36
- execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore' });
37
+ execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', windowsHide: true });
37
38
  }
38
39
  else {
39
40
  process.kill(pid, 'SIGTERM');
@@ -346,7 +347,7 @@ async function collectOobInput(mode, memberName, toolName, _opts) {
346
347
  });
347
348
  const raceResult = await Promise.race([passwordPromise, cancellationPromise]);
348
349
  if (raceResult === null) {
349
- // The terminal exited with code 0 (Windows `start /wait` always exits 0, even
350
+ // The terminal exited with code 0 (some terminal launchers exit 0 even
350
351
  // on user-close). Wait briefly for any in-flight socket message — if the user
351
352
  // genuinely submitted, the password arrives within milliseconds of process exit.
352
353
  // If nothing arrives in 500 ms, treat it as a user cancellation.
@@ -486,9 +487,9 @@ function buildHeadlessFallback(memberName, reason, context, extraArgs) {
486
487
  contextLines = `\n\n Command: ${context.command}`;
487
488
  }
488
489
  if (isConfirm) {
489
- return `fallback:${reason}${contextLines}\n\nRun this in a separate terminal to confirm:\n ! apra-fleet secret --confirm ${memberName}\n\nAlternatively, pre-store the value with credential_store_set and reference it as {{secure.NAME}} in the credential field.`;
490
+ return `fallback:${reason}${contextLines}\n\nRun this in a separate terminal to confirm:\n ! apra-fleet secret --confirm ${memberName}\n\nAlternatively, pre-store the value with credential_store_set and reference it as {{secret.NAME}} in the credential field.`;
490
491
  }
491
- return `fallback:${reason}${contextLines}\n\nRun this in a separate terminal to provide the credential:\n ! apra-fleet secret --set ${memberName}\n\nAlternatively, pre-store the value with credential_store_set and reference it as {{secure.NAME}} in the credential field.`;
492
+ return `fallback:${reason}${contextLines}\n\nRun this in a separate terminal to provide the credential:\n ! apra-fleet secret --set ${memberName}\n\nAlternatively, pre-store the value with credential_store_set and reference it as {{secret.NAME}} in the credential field.`;
492
493
  }
493
494
  /**
494
495
  * Returns true when a graphical display is available on Linux/BSD.
@@ -528,7 +529,7 @@ function findLinuxTerminal() {
528
529
  if (termProg && termProgramMap[termProg]) {
529
530
  const entry = termProgramMap[termProg];
530
531
  try {
531
- execSync(`which ${entry.bin}`, { stdio: 'ignore' });
532
+ execSync(`which ${entry.bin}`, { stdio: 'ignore', windowsHide: true });
532
533
  return entry;
533
534
  }
534
535
  catch { /* not in PATH, fall through */ }
@@ -556,13 +557,69 @@ function findLinuxTerminal() {
556
557
  ];
557
558
  for (const entry of candidates) {
558
559
  try {
559
- execSync(`which ${entry.bin}`, { stdio: 'ignore' });
560
+ execSync(`which ${entry.bin}`, { stdio: 'ignore', windowsHide: true });
560
561
  return entry;
561
562
  }
562
563
  catch { /* not found */ }
563
564
  }
564
565
  return null;
565
566
  }
567
+ /**
568
+ * Build the AppleScript that opens a macOS Terminal window, runs the auth
569
+ * command in it, and waits for it to finish. Terminal's `do script` hands the
570
+ * string to the user's login shell, so every argv element is POSIX
571
+ * single-quoted (member names and the --prompt text can carry spaces and
572
+ * caller-supplied host/username values), and the whole command is then escaped
573
+ * for the AppleScript string literal (backslash first, then double quote).
574
+ * The command writes its own exit code to `tmpFile` so the caller can read it.
575
+ * Exported for tests.
576
+ */
577
+ export function buildMacTerminalAppleScript(fullArgs, tmpFile) {
578
+ const command = [...fullArgs.map(escapeShellArg), `; echo $? > ${escapeShellArg(tmpFile)}`].join(' ');
579
+ return `
580
+ tell application "Terminal"
581
+ activate
582
+ set w to do script "${escapeAppleScriptString(command)}"
583
+ delay 1
584
+ repeat while busy of w
585
+ delay 0.5
586
+ end repeat
587
+ end tell
588
+ `;
589
+ }
590
+ /** Title of the Windows credential-entry console window (set by the child). */
591
+ export const WINDOWS_AUTH_WINDOW_TITLE = 'Fleet Password Entry';
592
+ /** Env var the `secret` CLI reads to title its console window on Windows. */
593
+ export const OOB_WINDOW_TITLE_ENV = 'APRA_FLEET_OOB_WINDOW_TITLE';
594
+ // Fixed launcher script: the executable and its argument line arrive via env
595
+ // vars, so no caller-influenced text is ever parsed by cmd.exe or PowerShell.
596
+ // Start-Process passes the argument line verbatim to CreateProcess, where the
597
+ // child's CRT splits it (see quoteWindowsArgv).
598
+ const WINDOWS_AUTH_LAUNCHER_PS = [
599
+ "$ErrorActionPreference = 'Stop'",
600
+ '$exe = $env:APRA_FLEET_OOB_EXE',
601
+ '$argLine = $env:APRA_FLEET_OOB_ARGS',
602
+ 'Remove-Item Env:APRA_FLEET_OOB_EXE, Env:APRA_FLEET_OOB_ARGS -ErrorAction SilentlyContinue',
603
+ '$p = Start-Process -FilePath $exe -ArgumentList $argLine -Wait -PassThru',
604
+ 'exit $p.ExitCode',
605
+ ].join('; ');
606
+ /**
607
+ * Build the spawn() call that opens the Windows credential-entry console.
608
+ * Returns the file/argv for a hidden PowerShell launcher plus the env vars it
609
+ * reads. Exported for tests.
610
+ */
611
+ export function buildWindowsAuthLaunch(fullArgs) {
612
+ const [exe, ...rest] = fullArgs;
613
+ return {
614
+ file: 'powershell',
615
+ args: ['-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(WINDOWS_AUTH_LAUNCHER_PS, 'utf16le').toString('base64')],
616
+ env: {
617
+ APRA_FLEET_OOB_EXE: exe,
618
+ APRA_FLEET_OOB_ARGS: rest.map(quoteWindowsArgv).join(' '),
619
+ [OOB_WINDOW_TITLE_ENV]: WINDOWS_AUTH_WINDOW_TITLE,
620
+ },
621
+ };
622
+ }
566
623
  /**
567
624
  * Launch a new terminal window running `apra-fleet secret --set <memberName>` or `apra-fleet auth <memberName>`.
568
625
  * Records the spawned PID in the pending request so it can be killed when credential is received.
@@ -598,20 +655,7 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
598
655
  let exitCode = 1; // Default to cancellation
599
656
  const tmpFile = path.join(os.tmpdir(), `fleet-auth-exit-${Date.now()}`);
600
657
  try {
601
- // The command to run in the terminal. It must be a single string.
602
- // It writes its own exit code to a temp file so we can read it later.
603
- const command = [...fullArgs, `; echo $? > "${tmpFile}"`].join(' ');
604
- // AppleScript to launch terminal, run command, and wait for it to be "not busy".
605
- const appleScript = `
606
- tell application "Terminal"
607
- activate
608
- set w to do script "${command.replace(/"/g, '\\"')}"
609
- delay 1
610
- repeat while busy of w
611
- delay 0.5
612
- end repeat
613
- end tell
614
- `;
658
+ const appleScript = buildMacTerminalAppleScript(fullArgs, tmpFile);
615
659
  const child = spawn('osascript', ['-']);
616
660
  child.stdin.write(appleScript);
617
661
  child.stdin.end();
@@ -647,11 +691,12 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
647
691
  return 'launched';
648
692
  }
649
693
  else if (platform === 'win32') {
650
- // Windows: start /wait ensures that the parent cmd.exe process waits for the new
651
- // terminal window to be closed. This allows us to capture the exit event.
652
- // The title argument to start is required.
653
- const spawnArgs = ['/c', 'start', 'Fleet Password Entry', '/wait', ...fullArgs];
654
- child = spawn('cmd', spawnArgs, { stdio: 'ignore' });
694
+ // Windows: a hidden PowerShell launcher opens the new console window with
695
+ // Start-Process -Wait, so the exit event fires when that window closes.
696
+ // cmd.exe is deliberately not involved (it expands % and treats & | ^ as
697
+ // operators inside the --prompt text); see buildWindowsAuthLaunch.
698
+ const launch = buildWindowsAuthLaunch(fullArgs);
699
+ child = spawn(launch.file, launch.args, { stdio: 'ignore', windowsHide: true, env: { ...process.env, ...launch.env } });
655
700
  if (child.pid) {
656
701
  const pending = pendingRequests.get(memberName);
657
702
  if (pending)
@@ -662,7 +707,7 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
662
707
  // Linux: find available terminal emulator and use its exec-flag convention.
663
708
  const terminal = findLinuxTerminal();
664
709
  if (!terminal) {
665
- return `fallback:Could not find a terminal emulator. Ask the user to run manually:\n ${[cmd, ...args].join(' ')}\nAlternatively, pre-store the value with credential_store_set and reference it as {{secure.NAME}} in the credential field.`;
710
+ return `fallback:Could not find a terminal emulator. Ask the user to run manually:\n ${[cmd, ...args].join(' ')}\nAlternatively, pre-store the value with credential_store_set and reference it as {{secret.NAME}} in the credential field.`;
666
711
  }
667
712
  child = spawn(terminal.bin, [...terminal.execArgs, ...fullArgs], { detached: true, stdio: 'ignore' });
668
713
  if (child.pid) {
@@ -680,7 +725,7 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
680
725
  return 'launched';
681
726
  }
682
727
  catch (err) {
683
- return `fallback:Could not open a terminal window. Ask the user to run manually:\n ${[cmd, ...args].join(' ')}\nError: ${err.message}\nAlternatively, pre-store the value with credential_store_set and reference it as {{secure.NAME}} in the credential field.`;
728
+ return `fallback:Could not open a terminal window. Ask the user to run manually:\n ${[cmd, ...args].join(' ')}\nError: ${err.message}\nAlternatively, pre-store the value with credential_store_set and reference it as {{secret.NAME}} in the credential field.`;
684
729
  }
685
730
  }
686
731
  //# sourceMappingURL=auth-socket.js.map
@@ -30,7 +30,7 @@ function findBrowserOpener() {
30
30
  if (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
31
31
  return null;
32
32
  try {
33
- execSync('which xdg-open', { stdio: 'ignore' });
33
+ execSync('which xdg-open', { stdio: 'ignore', windowsHide: true });
34
34
  return { cmd: 'xdg-open', args: [] };
35
35
  }
36
36
  catch {
@@ -42,7 +42,7 @@ function escapeHtml(s) {
42
42
  }
43
43
  function formPage(prompt, isApiKey, token, error) {
44
44
  const errHtml = error ? `<p class="err">${escapeHtml(error)}</p>` : '';
45
- const placeholder = isApiKey ? 'Secure value' : 'Password';
45
+ const placeholder = isApiKey ? 'Secret value' : 'Password';
46
46
  return `<!doctype html>
47
47
  <html lang="en"><head>
48
48
  <meta charset="utf-8">
@@ -1,5 +1,5 @@
1
1
  import type { Agent } from '../types.js';
2
- import type { ProviderAdapter } from '../providers/provider.js';
2
+ import type { ProviderAdapter, TokenUsage } from '../providers/provider.js';
3
3
  /**
4
4
  * Usage/budget awareness for execute_prompt (apra-fleet-eft.80.2).
5
5
  *
@@ -89,16 +89,19 @@ export declare function estimatedSpendFor(scope: string): number;
89
89
  export declare function _resetBudgetState(): void;
90
90
  /**
91
91
  * Spend that a single dispatch's token usage represents, in the budget's unit.
92
- * For a token budget this is just input+output tokens. For a dollar budget it
93
- * is priced via getMemberModelPricing() for the resolved tier; an unpriceable
92
+ * A token budget counts input + output only -- the meaning it had before
93
+ * cache tokens were parsed. Cache reads re-count the whole cached prefix on
94
+ * every turn (one real session: 58,653 input+output tokens vs 17,966,362 with
95
+ * cache), so adding them would make an existing token budget bind hundreds of
96
+ * times sooner for an upgrading user. Cache cost is carried by dollar budgets.
97
+ * For a dollar budget the provider's own reported cost (usage.cost_usd) is
98
+ * used as-is when present; otherwise each count is priced at its own rate via
99
+ * getMemberModelPricing() for the resolved tier; an unpriceable
94
100
  * tier (unknown model, subscription-plan member with no meter) contributes 0
95
101
  * rather than a fabricated cost -- the same "never invent a price" discipline
96
102
  * model-pricing.ts already follows.
97
103
  */
98
- export declare function estimateDispatchCost(agent: Agent, provider: ProviderAdapter, tier: 'cheap' | 'standard' | 'premium' | undefined, usage: {
99
- input_tokens: number;
100
- output_tokens: number;
101
- }, unit: BudgetUnit): number;
104
+ export declare function estimateDispatchCost(agent: Agent, provider: ProviderAdapter, tier: 'cheap' | 'standard' | 'premium' | undefined, usage: TokenUsage, unit: BudgetUnit): number;
102
105
  /**
103
106
  * Current budget state for a scope, or undefined when the scope has no
104
107
  * configured budget (callers must treat undefined as "no budget awareness --
@@ -122,9 +125,6 @@ export declare function recordAndEvaluate(opts: {
122
125
  agent: Agent;
123
126
  provider: ProviderAdapter;
124
127
  tier: 'cheap' | 'standard' | 'premium' | undefined;
125
- usage: {
126
- input_tokens: number;
127
- output_tokens: number;
128
- };
128
+ usage: TokenUsage;
129
129
  }): Promise<BudgetState | undefined>;
130
130
  //# sourceMappingURL=budget-awareness.d.ts.map
@@ -48,8 +48,14 @@ export function _resetBudgetState() {
48
48
  }
49
49
  /**
50
50
  * Spend that a single dispatch's token usage represents, in the budget's unit.
51
- * For a token budget this is just input+output tokens. For a dollar budget it
52
- * is priced via getMemberModelPricing() for the resolved tier; an unpriceable
51
+ * A token budget counts input + output only -- the meaning it had before
52
+ * cache tokens were parsed. Cache reads re-count the whole cached prefix on
53
+ * every turn (one real session: 58,653 input+output tokens vs 17,966,362 with
54
+ * cache), so adding them would make an existing token budget bind hundreds of
55
+ * times sooner for an upgrading user. Cache cost is carried by dollar budgets.
56
+ * For a dollar budget the provider's own reported cost (usage.cost_usd) is
57
+ * used as-is when present; otherwise each count is priced at its own rate via
58
+ * getMemberModelPricing() for the resolved tier; an unpriceable
53
59
  * tier (unknown model, subscription-plan member with no meter) contributes 0
54
60
  * rather than a fabricated cost -- the same "never invent a price" discipline
55
61
  * model-pricing.ts already follows.
@@ -57,12 +63,18 @@ export function _resetBudgetState() {
57
63
  export function estimateDispatchCost(agent, provider, tier, usage, unit) {
58
64
  if (unit === 'tokens')
59
65
  return usage.input_tokens + usage.output_tokens;
66
+ if (typeof usage.cost_usd === 'number' && Number.isFinite(usage.cost_usd))
67
+ return usage.cost_usd;
68
+ const cacheRead = usage.cache_read_input_tokens ?? 0;
69
+ const cacheWrite = usage.cache_creation_input_tokens ?? 0;
60
70
  const pricing = getMemberModelPricing(agent, provider);
61
71
  const price = pricing[tier ?? 'standard'];
62
72
  if (!price)
63
73
  return 0;
64
74
  return (usage.input_tokens / 1_000_000) * price.promptPrice
65
- + (usage.output_tokens / 1_000_000) * price.completionPrice;
75
+ + (usage.output_tokens / 1_000_000) * price.completionPrice
76
+ + (cacheRead / 1_000_000) * price.cacheReadPrice
77
+ + (cacheWrite / 1_000_000) * price.cacheWritePrice;
66
78
  }
67
79
  /**
68
80
  * Current budget state for a scope, or undefined when the scope has no