@apralabs/apra-fleet 0.4.1 → 0.4.3

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 (476) hide show
  1. package/README.md +53 -12
  2. package/dist/agents/backlog-groomer.md +42 -21
  3. package/dist/agents/ci-watcher.md +14 -0
  4. package/dist/agents/deployer.md +59 -46
  5. package/dist/agents/doer.md +157 -134
  6. package/dist/agents/harvester.md +31 -32
  7. package/dist/agents/integ-test-runner.md +92 -113
  8. package/dist/agents/kb-reconciler.md +40 -42
  9. package/dist/agents/plan-reviewer.md +139 -63
  10. package/dist/agents/planner.md +176 -100
  11. package/dist/agents/regression-test-runner.md +77 -81
  12. package/dist/agents/reviewer.md +69 -85
  13. package/dist/agents/schemas/integ-test-runner-output.json +1 -1
  14. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  15. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  16. package/dist/cli/agent-transform.d.ts +83 -2
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +266 -21
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +29 -11
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +7 -5
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +44 -43
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +33 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +294 -61
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/kb-directives.d.ts.map +1 -1
  32. package/dist/cli/kb-directives.js +2 -1
  33. package/dist/cli/kb-directives.js.map +1 -1
  34. package/dist/cli/register-member.d.ts.map +1 -1
  35. package/dist/cli/register-member.js +7 -3
  36. package/dist/cli/register-member.js.map +1 -1
  37. package/dist/cli/start.d.ts.map +1 -1
  38. package/dist/cli/start.js +7 -0
  39. package/dist/cli/start.js.map +1 -1
  40. package/dist/cli/uninstall.d.ts.map +1 -1
  41. package/dist/cli/uninstall.js +5 -3
  42. package/dist/cli/uninstall.js.map +1 -1
  43. package/dist/cli/watch.d.ts +26 -3
  44. package/dist/cli/watch.d.ts.map +1 -1
  45. package/dist/cli/watch.js +41 -9
  46. package/dist/cli/watch.js.map +1 -1
  47. package/dist/commands/kb-server.d.ts +3 -0
  48. package/dist/commands/kb-server.d.ts.map +1 -1
  49. package/dist/commands/kb-server.js +43 -3
  50. package/dist/commands/kb-server.js.map +1 -1
  51. package/dist/index.js +3 -3
  52. package/dist/os/git-bash-candidates.d.ts +35 -0
  53. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  54. package/dist/os/git-bash-candidates.js +46 -0
  55. package/dist/os/git-bash-candidates.js.map +1 -0
  56. package/dist/os/index.d.ts +13 -4
  57. package/dist/os/index.d.ts.map +1 -1
  58. package/dist/os/index.js +17 -2
  59. package/dist/os/index.js.map +1 -1
  60. package/dist/os/linux.d.ts +6 -0
  61. package/dist/os/linux.d.ts.map +1 -1
  62. package/dist/os/linux.js +36 -3
  63. package/dist/os/linux.js.map +1 -1
  64. package/dist/os/os-commands.d.ts +68 -2
  65. package/dist/os/os-commands.d.ts.map +1 -1
  66. package/dist/os/os-commands.js.map +1 -1
  67. package/dist/os/windows-gitbash.d.ts +98 -0
  68. package/dist/os/windows-gitbash.d.ts.map +1 -0
  69. package/dist/os/windows-gitbash.js +259 -0
  70. package/dist/os/windows-gitbash.js.map +1 -0
  71. package/dist/os/windows.d.ts +6 -0
  72. package/dist/os/windows.d.ts.map +1 -1
  73. package/dist/os/windows.js +73 -8
  74. package/dist/os/windows.js.map +1 -1
  75. package/dist/providers/agy.d.ts +118 -8
  76. package/dist/providers/agy.d.ts.map +1 -1
  77. package/dist/providers/agy.js +580 -55
  78. package/dist/providers/agy.js.map +1 -1
  79. package/dist/providers/claude.d.ts +83 -4
  80. package/dist/providers/claude.d.ts.map +1 -1
  81. package/dist/providers/claude.js +365 -12
  82. package/dist/providers/claude.js.map +1 -1
  83. package/dist/providers/codex.d.ts +7 -4
  84. package/dist/providers/codex.d.ts.map +1 -1
  85. package/dist/providers/codex.js +24 -4
  86. package/dist/providers/codex.js.map +1 -1
  87. package/dist/providers/copilot.d.ts +7 -4
  88. package/dist/providers/copilot.d.ts.map +1 -1
  89. package/dist/providers/copilot.js +27 -4
  90. package/dist/providers/copilot.js.map +1 -1
  91. package/dist/providers/index.d.ts +0 -1
  92. package/dist/providers/index.d.ts.map +1 -1
  93. package/dist/providers/index.js +0 -3
  94. package/dist/providers/index.js.map +1 -1
  95. package/dist/providers/none.d.ts +7 -4
  96. package/dist/providers/none.d.ts.map +1 -1
  97. package/dist/providers/none.js +22 -4
  98. package/dist/providers/none.js.map +1 -1
  99. package/dist/providers/opencode.d.ts +6 -3
  100. package/dist/providers/opencode.d.ts.map +1 -1
  101. package/dist/providers/opencode.js +27 -4
  102. package/dist/providers/opencode.js.map +1 -1
  103. package/dist/providers/provider.d.ts +215 -11
  104. package/dist/providers/provider.d.ts.map +1 -1
  105. package/dist/providers/provider.js +58 -2
  106. package/dist/providers/provider.js.map +1 -1
  107. package/dist/services/agent-provisioner.js +2 -2
  108. package/dist/services/agent-provisioner.js.map +1 -1
  109. package/dist/services/agy-project.d.ts +102 -0
  110. package/dist/services/agy-project.d.ts.map +1 -0
  111. package/dist/services/agy-project.js +356 -0
  112. package/dist/services/agy-project.js.map +1 -0
  113. package/dist/services/auth-socket.js +4 -4
  114. package/dist/services/auth-web.js +1 -1
  115. package/dist/services/cloud/activity.js +2 -2
  116. package/dist/services/cloud/activity.js.map +1 -1
  117. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  118. package/dist/services/cloud/lifecycle.js +33 -4
  119. package/dist/services/cloud/lifecycle.js.map +1 -1
  120. package/dist/services/context-admission.d.ts.map +1 -1
  121. package/dist/services/context-admission.js +9 -7
  122. package/dist/services/context-admission.js.map +1 -1
  123. package/dist/services/credential-cleanup.d.ts.map +1 -1
  124. package/dist/services/credential-cleanup.js +47 -10
  125. package/dist/services/credential-cleanup.js.map +1 -1
  126. package/dist/services/exit-drain.d.ts +44 -0
  127. package/dist/services/exit-drain.d.ts.map +1 -0
  128. package/dist/services/exit-drain.js +52 -0
  129. package/dist/services/exit-drain.js.map +1 -0
  130. package/dist/services/github-app.d.ts.map +1 -1
  131. package/dist/services/github-app.js +32 -4
  132. package/dist/services/github-app.js.map +1 -1
  133. package/dist/services/http-transport.d.ts +1 -0
  134. package/dist/services/http-transport.d.ts.map +1 -1
  135. package/dist/services/http-transport.js +48 -1
  136. package/dist/services/http-transport.js.map +1 -1
  137. package/dist/services/knowledge/kb-config.d.ts +42 -0
  138. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  139. package/dist/services/knowledge/kb-config.js +54 -0
  140. package/dist/services/knowledge/kb-config.js.map +1 -0
  141. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  142. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  143. package/dist/services/knowledge/kb-providers.js +191 -17
  144. package/dist/services/knowledge/kb-providers.js.map +1 -1
  145. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  146. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  149. package/dist/services/member-home.d.ts +1 -1
  150. package/dist/services/member-home.d.ts.map +1 -1
  151. package/dist/services/member-home.js +15 -12
  152. package/dist/services/member-home.js.map +1 -1
  153. package/dist/services/model-pricing.d.ts.map +1 -1
  154. package/dist/services/model-pricing.js +7 -8
  155. package/dist/services/model-pricing.js.map +1 -1
  156. package/dist/services/orphan-recovery.d.ts +6 -3
  157. package/dist/services/orphan-recovery.d.ts.map +1 -1
  158. package/dist/services/orphan-recovery.js +17 -14
  159. package/dist/services/orphan-recovery.js.map +1 -1
  160. package/dist/services/preflight-check.js +2 -2
  161. package/dist/services/preflight-check.js.map +1 -1
  162. package/dist/services/secret-token.d.ts +38 -0
  163. package/dist/services/secret-token.d.ts.map +1 -0
  164. package/dist/services/secret-token.js +51 -0
  165. package/dist/services/secret-token.js.map +1 -0
  166. package/dist/services/service-manager/types.d.ts +3 -1
  167. package/dist/services/service-manager/types.d.ts.map +1 -1
  168. package/dist/services/service-manager/windows.d.ts +14 -2
  169. package/dist/services/service-manager/windows.d.ts.map +1 -1
  170. package/dist/services/service-manager/windows.js +65 -7
  171. package/dist/services/service-manager/windows.js.map +1 -1
  172. package/dist/services/shell-probe.d.ts +131 -0
  173. package/dist/services/shell-probe.d.ts.map +1 -0
  174. package/dist/services/shell-probe.js +210 -0
  175. package/dist/services/shell-probe.js.map +1 -0
  176. package/dist/services/singleton.d.ts +2 -0
  177. package/dist/services/singleton.d.ts.map +1 -1
  178. package/dist/services/singleton.js +1 -1
  179. package/dist/services/singleton.js.map +1 -1
  180. package/dist/services/ssh.d.ts.map +1 -1
  181. package/dist/services/ssh.js +60 -4
  182. package/dist/services/ssh.js.map +1 -1
  183. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  184. package/dist/services/stall/find-log-file.js +22 -16
  185. package/dist/services/stall/find-log-file.js.map +1 -1
  186. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  187. package/dist/services/stall/read-log-tail.js +26 -15
  188. package/dist/services/stall/read-log-tail.js.map +1 -1
  189. package/dist/services/stall/stall-detector.d.ts +53 -4
  190. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  191. package/dist/services/stall/stall-detector.js +212 -34
  192. package/dist/services/stall/stall-detector.js.map +1 -1
  193. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  194. package/dist/services/stall/stall-poller.js +35 -42
  195. package/dist/services/stall/stall-poller.js.map +1 -1
  196. package/dist/services/strategy.d.ts +9 -0
  197. package/dist/services/strategy.d.ts.map +1 -1
  198. package/dist/services/strategy.js +119 -8
  199. package/dist/services/strategy.js.map +1 -1
  200. package/dist/services/substitution-engine.js +2 -2
  201. package/dist/services/substitution-engine.js.map +1 -1
  202. package/dist/services/tool-registry.d.ts.map +1 -1
  203. package/dist/services/tool-registry.js +5 -3
  204. package/dist/services/tool-registry.js.map +1 -1
  205. package/dist/services/user-config.js +1 -1
  206. package/dist/services/user-config.js.map +1 -1
  207. package/dist/services/vcs/azure-devops.d.ts +67 -2
  208. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  209. package/dist/services/vcs/azure-devops.js +281 -15
  210. package/dist/services/vcs/azure-devops.js.map +1 -1
  211. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  212. package/dist/services/vcs/bitbucket.js +16 -0
  213. package/dist/services/vcs/bitbucket.js.map +1 -1
  214. package/dist/services/vcs/github.d.ts.map +1 -1
  215. package/dist/services/vcs/github.js +24 -0
  216. package/dist/services/vcs/github.js.map +1 -1
  217. package/dist/services/vcs/types.d.ts +123 -2
  218. package/dist/services/vcs/types.d.ts.map +1 -1
  219. package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
  220. package/dist/skills/pm/SKILL.md +1 -2
  221. package/dist/skills/pm/cost.md +0 -4
  222. package/dist/skills/pm/fleet-addendum.md +2 -3
  223. package/dist/tools/check-status.d.ts +7 -4
  224. package/dist/tools/check-status.d.ts.map +1 -1
  225. package/dist/tools/check-status.js +5 -3
  226. package/dist/tools/check-status.js.map +1 -1
  227. package/dist/tools/cloud-control.js +2 -2
  228. package/dist/tools/cloud-control.js.map +1 -1
  229. package/dist/tools/compose-permissions.d.ts +6 -0
  230. package/dist/tools/compose-permissions.d.ts.map +1 -1
  231. package/dist/tools/compose-permissions.js +211 -50
  232. package/dist/tools/compose-permissions.js.map +1 -1
  233. package/dist/tools/credential-store-set.js +1 -1
  234. package/dist/tools/execute-command.d.ts.map +1 -1
  235. package/dist/tools/execute-command.js +56 -29
  236. package/dist/tools/execute-command.js.map +1 -1
  237. package/dist/tools/execute-prompt.d.ts +15 -2
  238. package/dist/tools/execute-prompt.d.ts.map +1 -1
  239. package/dist/tools/execute-prompt.js +1214 -873
  240. package/dist/tools/execute-prompt.js.map +1 -1
  241. package/dist/tools/kb-capture.d.ts +2 -2
  242. package/dist/tools/kb-capture.d.ts.map +1 -1
  243. package/dist/tools/kb-capture.js +29 -5
  244. package/dist/tools/kb-capture.js.map +1 -1
  245. package/dist/tools/kb-export.d.ts +2 -2
  246. package/dist/tools/kb-export.d.ts.map +1 -1
  247. package/dist/tools/kb-export.js +3 -28
  248. package/dist/tools/kb-export.js.map +1 -1
  249. package/dist/tools/kb-feedback.d.ts.map +1 -1
  250. package/dist/tools/kb-feedback.js +3 -1
  251. package/dist/tools/kb-feedback.js.map +1 -1
  252. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  253. package/dist/tools/kb-freshness-sweep.js +3 -1
  254. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  255. package/dist/tools/kb-import.d.ts.map +1 -1
  256. package/dist/tools/kb-import.js +2 -1
  257. package/dist/tools/kb-import.js.map +1 -1
  258. package/dist/tools/kb-list.d.ts.map +1 -1
  259. package/dist/tools/kb-list.js +3 -1
  260. package/dist/tools/kb-list.js.map +1 -1
  261. package/dist/tools/kb-query.d.ts +2 -2
  262. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  263. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  264. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  265. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  266. package/dist/tools/kb-resolve-contradiction.js +3 -1
  267. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  268. package/dist/tools/kb-setup.d.ts.map +1 -1
  269. package/dist/tools/kb-setup.js +125 -20
  270. package/dist/tools/kb-setup.js.map +1 -1
  271. package/dist/tools/kb-stats.d.ts.map +1 -1
  272. package/dist/tools/kb-stats.js +64 -43
  273. package/dist/tools/kb-stats.js.map +1 -1
  274. package/dist/tools/list-members.d.ts +2 -2
  275. package/dist/tools/list-members.d.ts.map +1 -1
  276. package/dist/tools/list-members.js +7 -2
  277. package/dist/tools/list-members.js.map +1 -1
  278. package/dist/tools/member-detail.d.ts +2 -2
  279. package/dist/tools/member-detail.d.ts.map +1 -1
  280. package/dist/tools/member-detail.js +22 -3
  281. package/dist/tools/member-detail.js.map +1 -1
  282. package/dist/tools/member-reservation.d.ts +58 -1
  283. package/dist/tools/member-reservation.d.ts.map +1 -1
  284. package/dist/tools/member-reservation.js +71 -18
  285. package/dist/tools/member-reservation.js.map +1 -1
  286. package/dist/tools/monitor-task.d.ts.map +1 -1
  287. package/dist/tools/monitor-task.js +17 -2
  288. package/dist/tools/monitor-task.js.map +1 -1
  289. package/dist/tools/provision-auth.d.ts +80 -1
  290. package/dist/tools/provision-auth.d.ts.map +1 -1
  291. package/dist/tools/provision-auth.js +147 -59
  292. package/dist/tools/provision-auth.js.map +1 -1
  293. package/dist/tools/provision-vcs-auth.d.ts +96 -3
  294. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  295. package/dist/tools/provision-vcs-auth.js +254 -88
  296. package/dist/tools/provision-vcs-auth.js.map +1 -1
  297. package/dist/tools/register-member.d.ts +21 -12
  298. package/dist/tools/register-member.d.ts.map +1 -1
  299. package/dist/tools/register-member.js +141 -16
  300. package/dist/tools/register-member.js.map +1 -1
  301. package/dist/tools/remove-member.d.ts.map +1 -1
  302. package/dist/tools/remove-member.js +29 -4
  303. package/dist/tools/remove-member.js.map +1 -1
  304. package/dist/tools/revoke-vcs-auth.js +2 -2
  305. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  306. package/dist/tools/send-email.d.ts +2 -2
  307. package/dist/tools/setup-git-app.d.ts.map +1 -1
  308. package/dist/tools/setup-git-app.js +11 -7
  309. package/dist/tools/setup-git-app.js.map +1 -1
  310. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  311. package/dist/tools/setup-ssh-key.js +2 -1
  312. package/dist/tools/setup-ssh-key.js.map +1 -1
  313. package/dist/tools/shutdown-server.d.ts +2 -0
  314. package/dist/tools/shutdown-server.d.ts.map +1 -1
  315. package/dist/tools/shutdown-server.js +23 -1
  316. package/dist/tools/shutdown-server.js.map +1 -1
  317. package/dist/tools/stop-prompt.js +2 -2
  318. package/dist/tools/stop-prompt.js.map +1 -1
  319. package/dist/tools/update-agent-cli.js +2 -2
  320. package/dist/tools/update-agent-cli.js.map +1 -1
  321. package/dist/tools/update-member.d.ts +21 -12
  322. package/dist/tools/update-member.d.ts.map +1 -1
  323. package/dist/tools/update-member.js +61 -12
  324. package/dist/tools/update-member.js.map +1 -1
  325. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  326. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  327. package/dist/tools/vcs-credential-exec.js +197 -0
  328. package/dist/tools/vcs-credential-exec.js.map +1 -0
  329. package/dist/types.d.ts +24 -1
  330. package/dist/types.d.ts.map +1 -1
  331. package/dist/utils/agent-helpers.d.ts +36 -0
  332. package/dist/utils/agent-helpers.d.ts.map +1 -1
  333. package/dist/utils/agent-helpers.js +39 -1
  334. package/dist/utils/agent-helpers.js.map +1 -1
  335. package/dist/utils/log-helpers.d.ts.map +1 -1
  336. package/dist/utils/log-helpers.js +2 -2
  337. package/dist/utils/log-helpers.js.map +1 -1
  338. package/dist/utils/platform.d.ts +7 -0
  339. package/dist/utils/platform.d.ts.map +1 -1
  340. package/dist/utils/platform.js +11 -1
  341. package/dist/utils/platform.js.map +1 -1
  342. package/dist/utils/prompt-errors.d.ts.map +1 -1
  343. package/dist/utils/prompt-errors.js +7 -1
  344. package/dist/utils/prompt-errors.js.map +1 -1
  345. package/dist/utils/shell-escape.d.ts +16 -0
  346. package/dist/utils/shell-escape.d.ts.map +1 -1
  347. package/dist/utils/shell-escape.js +22 -2
  348. package/dist/utils/shell-escape.js.map +1 -1
  349. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  350. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  351. package/dist/utils/vcs-provider-detect.js +109 -0
  352. package/dist/utils/vcs-provider-detect.js.map +1 -0
  353. package/dist/utils/workspace-trust.d.ts +20 -17
  354. package/dist/utils/workspace-trust.d.ts.map +1 -1
  355. package/dist/utils/workspace-trust.js +91 -1
  356. package/dist/utils/workspace-trust.js.map +1 -1
  357. package/dist/workflows/auto-sprint.js +180 -32
  358. package/package.json +7 -5
  359. package/packages/apra-fleet-client/src/client/api.mjs +403 -12
  360. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  361. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  362. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
  363. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
  364. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
  365. package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
  366. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
  367. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
  368. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
  369. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
  370. package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
  371. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
  372. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
  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/regression-test-runner-output.json +4 -17
  376. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
  377. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
  379. package/packages/apra-fleet-se/bin/cli.mjs +280 -3
  380. package/packages/apra-fleet-se/bin/serve.mjs +114 -5
  381. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  382. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  383. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  384. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  385. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  386. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  387. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  388. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  389. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
  390. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  391. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  392. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  393. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  394. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  395. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
  396. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
  397. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
  398. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  399. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
  400. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  401. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  402. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
  403. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
  404. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
  405. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  406. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  407. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  408. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  409. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  410. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  411. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  412. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  413. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  414. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  415. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  416. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  417. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  418. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  419. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  420. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  421. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  422. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  423. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  424. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  425. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  426. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  427. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  428. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  429. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  430. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  431. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  432. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  433. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  434. package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
  435. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  436. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
  437. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  438. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  439. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  440. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
  441. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  442. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  443. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  444. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  445. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  446. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  447. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  448. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
  449. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
  450. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  451. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  452. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
  453. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
  454. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
  455. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
  456. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  457. package/packages/apra-fleet-se/package.json +1 -1
  458. package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
  459. package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
  460. package/skills/fleet/SKILL.md +27 -16
  461. package/skills/fleet/auth-azdevops.md +57 -7
  462. package/skills/fleet/auth-bitbucket.md +5 -5
  463. package/skills/fleet/auth-github.md +7 -6
  464. package/skills/fleet/beads-conflict-resolution.md +141 -0
  465. package/skills/fleet/beads.md +16 -12
  466. package/skills/fleet/onboarding.md +6 -6
  467. package/skills/fleet/permissions.md +11 -7
  468. package/skills/fleet/profiles/node.json +1 -1
  469. package/skills/fleet/skill-matrix.md +1 -1
  470. package/skills/fleet/troubleshooting.md +4 -3
  471. package/version.json +1 -1
  472. package/dist/providers/gemini.d.ts +0 -52
  473. package/dist/providers/gemini.d.ts.map +0 -1
  474. package/dist/providers/gemini.js +0 -236
  475. package/dist/providers/gemini.js.map +0 -1
  476. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
@@ -1,6 +1,7 @@
1
1
  import type { LlmProvider } from '../types.js';
2
2
  import type { SSHExecResult } from '../types.js';
3
3
  import type { PromptErrorCategory } from '../utils/prompt-errors.js';
4
+ import type { MemberShell } from '../os/os-commands.js';
4
5
  export type { LlmProvider };
5
6
  /** The OS of the machine a resolved path will be USED on (the member's own
6
7
  * machine), which is NOT necessarily the OS this hub process runs on. */
@@ -12,7 +13,7 @@ export type TargetOS = 'linux' | 'macos' | 'windows';
12
13
  * Providers previously built member-side log paths with the default `path`
13
14
  * module, so a Windows hub produced backslash-joined paths for a Linux member
14
15
  * (and vice versa) -- a path that can never exist on the member, which silently
15
- * disables stall detection (Claude/Gemini) or manufactures a false-positive
16
+ * disables stall detection (Claude) or manufactures a false-positive
16
17
  * stall kill (AGY/OpenCode).
17
18
  *
18
19
  * `targetOs === undefined` deliberately keeps the legacy host-convention
@@ -39,10 +40,36 @@ export type SessionIdStrategy = {
39
40
  } | {
40
41
  type: 'provider-minted';
41
42
  };
43
+ /**
44
+ * apra-fleet-25yl.2.1: what the EXEC-LEVEL ROLLING (inactivity) timeout handed
45
+ * to `strategy.execCommand()` is derived from, for this provider.
46
+ *
47
+ * - 'inactivity_timeout' -- derive it from the caller's `timeout_s`. Choose
48
+ * this when the exec channel (stdout/stderr on the dispatch pipe) is a
49
+ * REAL mid-turn liveness signal for the provider, OR when preserving the
50
+ * provider's current behaviour is the point. Codex is the load-bearing
51
+ * case: its adapter returns null from resolveSessionLogDir(), so the
52
+ * StallDetector has no transcript to poll and this timer is its ONLY stall
53
+ * signal -- decoupling it there disables stall detection outright.
54
+ * - 'total_ceiling' -- do NOT arm a `timeout_s`-sized rolling deadline;
55
+ * derive it from `max_total_s` instead (a value that can never bind before
56
+ * the caller's own hard ceiling does). Choose this when the provider is
57
+ * batch/CONOUT$-only, so the exec channel emits nothing mid-turn and a
58
+ * `timeout_s`-sized rolling deadline is a false kill. The StallDetector's
59
+ * transcript polling is the real stall mechanism for these providers, and
60
+ * it still gets `timeout_s` as its thresholdMs.
61
+ *
62
+ * This is deliberately a REQUIRED member of {@link ProviderAdapter} rather
63
+ * than an optional one with a default: a newly added provider must state its
64
+ * own answer (a compile error if it does not) instead of silently inheriting
65
+ * whichever branch happens to be the fallback, because the wrong branch
66
+ * silently disables a kill path.
67
+ */
68
+ export type ExecTimeoutSource = 'inactivity_timeout' | 'total_ceiling';
42
69
  export declare function encodeClaudeProjectDir(workFolder: string): string;
43
70
  /**
44
71
  * Build a `--resume <id>` flag with session ID sanitization and quoting.
45
- * Shared by providers that pass session IDs on the command line (Claude, Gemini).
72
+ * Shared by providers that pass session IDs on the command line (Claude).
46
73
  * @param sessionId - The raw session ID (will be sanitized)
47
74
  * @param fallback - Value to return when sessionId is absent (default: '')
48
75
  */
@@ -52,6 +79,22 @@ export declare function buildResumeFlag(sessionId: string | undefined, fallback?
52
79
  * @param sessionId - The raw session ID (will be sanitized)
53
80
  */
54
81
  export declare function buildSessionIdFlag(sessionId: string): string;
82
+ /**
83
+ * Build a fork-mode resume flag: seed context from `sourceSessionId`'s transcript
84
+ * but yield a NEW, distinct session id rather than continuing the source id in
85
+ * place (contrast with {@link buildResumeFlag}, which resumes the source id
86
+ * unchanged). Shared by providers whose CLI supports resuming into a forked
87
+ * session id (Claude's `--fork-session`, used together with `--resume`).
88
+ *
89
+ * The forked session id is pre-minted by the caller and passed explicitly via
90
+ * `--session-id` alongside `--resume ... --fork-session`, rather than letting
91
+ * the CLI mint its own id and scraping it out of the response afterward -- the
92
+ * CLI honors a caller-supplied `--session-id` even in fork mode.
93
+ * @param sourceSessionId - The session ID to seed/fork from (will be sanitized)
94
+ * @param newSessionId - The caller-minted id the forked session should be created under (will be sanitized)
95
+ * @param fallback - Value to return when sourceSessionId is absent (default: '')
96
+ */
97
+ export declare function buildForkFlag(sourceSessionId: string | undefined, newSessionId: string | undefined, fallback?: string): string;
55
98
  export interface PromptOptions {
56
99
  folder: string;
57
100
  promptFile: string;
@@ -63,7 +106,44 @@ export interface PromptOptions {
63
106
  maxTurns?: number;
64
107
  inv?: string;
65
108
  agentName?: string;
109
+ /** Provider project the run is bound to (AGY: `--project <id>`, from
110
+ * Agent.agyProjectId). Ignored by providers without {@link ProviderAdapter.projectFlag}. */
111
+ projectId?: string;
112
+ }
113
+ /**
114
+ * apra-fleet-hzeb.1: a provider-agnostic "this dispatch hit a usage/quota limit
115
+ * and cannot make progress until `resumeAt`" signal. Distinct from a transient
116
+ * overload (529/overloaded), which is retryable after a short backoff -- a usage
117
+ * limit needs a real wall-clock wait until the quota window resets.
118
+ *
119
+ * `resumeAt` is ALWAYS a concrete ISO-8601 UTC timestamp, never null: when the
120
+ * provider CLI exposes a real reset time we parse it (`resumeAtSource: 'parsed'`);
121
+ * otherwise we fall back to a guessed window (`resumeAtSource: 'guessed'`), so a
122
+ * consumer can always schedule a resume without special-casing "unknown".
123
+ */
124
+ export interface UsageLimitSignal {
125
+ type: 'usage_limit';
126
+ /** ISO-8601 UTC instant at which work may resume. Never null. */
127
+ resumeAt: string;
128
+ /** Whether `resumeAt` was parsed from the provider's own reset time, or guessed. */
129
+ resumeAtSource: 'parsed' | 'guessed';
130
+ /** The raw message/output that identified this as a usage limit (for logging). */
131
+ message: string;
66
132
  }
133
+ /**
134
+ * apra-fleet-hzeb.1: THE provider-adapter default resume window for a guessed
135
+ * usage-limit signal (1 hour). This is the single source of truth for the guess --
136
+ * fleet-sprint and other consumers must read the signal's `resumeAt`, never
137
+ * hardcode their own 1h fallback.
138
+ */
139
+ export declare const DEFAULT_USAGE_LIMIT_RESUME_MS: number;
140
+ /**
141
+ * apra-fleet-hzeb.1: build a guessed usage-limit signal whose `resumeAt` is
142
+ * `now + DEFAULT_USAGE_LIMIT_RESUME_MS`. `now` is injectable for deterministic
143
+ * tests.
144
+ */
145
+ export declare function guessedUsageLimitSignal(message: string, now?: number): UsageLimitSignal;
146
+ export declare function defaultUsageLimitSignal(output: string, now?: number): UsageLimitSignal | null;
67
147
  export interface ParsedResponse {
68
148
  result: string;
69
149
  sessionId?: string;
@@ -77,6 +157,51 @@ export interface ParsedResponse {
77
157
  subtype?: string;
78
158
  /** e.g. 'max_turns' -- the CLI result event's own terminal_reason, when present. */
79
159
  terminalReason?: string;
160
+ /** apra-fleet-hzeb.1: the Claude result event's api_error_status (e.g. 429), when
161
+ * present -- previously dropped by the parser. Used by detectUsageLimit. */
162
+ apiErrorStatus?: number;
163
+ /** apra-fleet-hzeb.1: set by execute_prompt (from detectUsageLimit) when this
164
+ * dispatch was terminated by a provider usage/quota limit. */
165
+ usageLimit?: UsageLimitSignal;
166
+ /** Set by a provider parser when the CLI refused one or more tool calls for
167
+ * lack of a permission grant (AGY headless mode auto-denies them). */
168
+ permissionDenial?: PermissionDenial;
169
+ }
170
+ /** A tool call the member CLI refused because no grant allowed it. */
171
+ export interface PermissionDenialItem {
172
+ /** Provider permission action, e.g. 'command', 'read_file', 'mcp'. */
173
+ action: string;
174
+ /** The concrete target, when the CLI named it, e.g. 'git status --short --branch'. */
175
+ target?: string;
176
+ }
177
+ /** Structured permission denial surfaced by execute_prompt as
178
+ * `reason: 'permission_denied'`. */
179
+ export interface PermissionDenial {
180
+ /** Unique denied actions, in first-seen order. */
181
+ actions: string[];
182
+ denials: PermissionDenialItem[];
183
+ /** compose_permissions `grant` values that would allow the denied calls
184
+ * (empty when there is no canonical mapping for an action). The primary
185
+ * suggestion comes first; a narrower alternative may follow it. */
186
+ suggestedGrants: string[];
187
+ /** One-line remediation for a human or an orchestrator. */
188
+ hint: string;
189
+ /** Which of the CLI's signals reported the denial. */
190
+ signals: Array<'result_json' | 'stderr' | 'transcript'>;
191
+ }
192
+ /** Context parseResponse may use; providers that do not need it ignore it. */
193
+ export interface ParseResponseContext {
194
+ /** The member's OS (e.g. agy's permission-denial hint differs on Windows). */
195
+ agentOs?: 'linux' | 'macos' | 'windows';
196
+ }
197
+ /** Extra inputs to composePermissionConfig; providers that do not need them
198
+ * ignore them. */
199
+ export interface ComposePermissionOptions {
200
+ /** The member's home directory, resolved in JavaScript (getMemberHomeDir). */
201
+ memberHomeDir?: string | null;
202
+ /** Receives lines for grants that could not be expressed and were dropped;
203
+ * compose_permissions shows them in its result. */
204
+ warnings?: string[];
80
205
  }
81
206
  export declare function isMaxTurnsResponse(parsed: ParsedResponse | undefined | null): boolean;
82
207
  export interface RegisterMcpEndpointOptions {
@@ -99,6 +224,23 @@ export interface RegisterMcpEndpointResult {
99
224
  * type (rather than importing AgentStrategy) so providers.ts has no dependency on
100
225
  * services/strategy.ts. */
101
226
  export type WorkspaceTrustExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
227
+ /** Optional file-delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted}
228
+ * (GitHub #499). Writes `content` to `relPath`, resolved relative to the MEMBER's home
229
+ * directory, without going through a shell command line: node:fs for a local member,
230
+ * SFTP for an SSH member. A merged ~/.claude.json can be far larger than any command
231
+ * line a Windows process may carry (CreateProcess caps it at 32767 chars; cmd.exe at
232
+ * 8191), so the adapter prefers this channel when present and only falls back to
233
+ * exec-based delivery (chunked on Windows) when it is absent or fails. Must throw on
234
+ * failure so the adapter can fall back. */
235
+ export type WorkspaceTrustWriteHomeFileFn = (relPath: string, content: string) => Promise<void>;
236
+ export type WorkspaceTrustReadHomeFileFn = (relPath: string) => Promise<{
237
+ found: boolean;
238
+ content?: string;
239
+ } | undefined>;
240
+ export interface WorkspaceTrustTransport {
241
+ writeHomeFile?: WorkspaceTrustWriteHomeFileFn;
242
+ readHomeFile?: WorkspaceTrustReadHomeFileFn;
243
+ }
102
244
  export interface EnsureWorkspaceTrustedResult {
103
245
  /** true only when this call just wrote hasTrustDialogAccepted=true because it was
104
246
  * missing. false when the provider no-ops, or when trust was already present. */
@@ -119,7 +261,12 @@ export interface ProviderAdapter {
119
261
  readonly instructionFileName: string;
120
262
  cliCommand(args: string): string;
121
263
  versionCommand(): string;
122
- installCommand(os: 'linux' | 'macos' | 'windows'): string;
264
+ /** `shell` is the member's registered shell (only meaningful for
265
+ * `os === 'windows'`). A gitbash Windows member gets a bash-invokable
266
+ * install string; every other combination -- including a Windows member
267
+ * with no shell recorded, or pwsh7/powershell5 -- resolves exactly as it
268
+ * did before the shell parameter existed (apra-fleet-7dir.2.7). */
269
+ installCommand(os: 'linux' | 'macos' | 'windows', shell?: MemberShell): string;
123
270
  updateCommand(): string;
124
271
  buildPromptCommand(opts: PromptOptions): string;
125
272
  skipPermissionsFlag(): string;
@@ -143,12 +290,60 @@ export interface ProviderAdapter {
143
290
  * os/windows.ts call this instead of re-deriving the branching
144
291
  * themselves, so the two dispatch paths cannot diverge. */
145
292
  resolvePermissionFlag(unattended: false | 'auto' | 'dangerous' | undefined): string;
146
- parseResponse(result: SSHExecResult): ParsedResponse;
293
+ parseResponse(result: SSHExecResult, ctx?: ParseResponseContext): ParsedResponse;
294
+ /** apra-fleet-hzeb.1: detect whether this dispatch was terminated by a provider
295
+ * usage/quota limit (as opposed to a transient overload). Returns a
296
+ * {@link UsageLimitSignal} with a concrete `resumeAt`, or null when this was not
297
+ * a usage limit. REQUIRED on every adapter: none.ts returns null; the non-Claude
298
+ * adapters delegate to {@link defaultUsageLimitSignal} on their raw output; Claude
299
+ * keys off its api_error_status / terminal_reason plus its own limit message. */
300
+ detectUsageLimit(result: SSHExecResult, parsed: ParsedResponse): UsageLimitSignal | null;
147
301
  supportsResume(): boolean;
148
302
  supportsMaxTurns(): boolean;
149
303
  resumeFlag(sessionId?: string, resuming?: boolean): string;
150
304
  /** Defines whether this provider accepts caller-minted UUIDs or generates session IDs natively. */
151
305
  sessionIdStrategy(): SessionIdStrategy;
306
+ /** apra-fleet-25yl.2.1: what the exec-level rolling (inactivity) timeout is
307
+ * derived from for this provider -- see {@link ExecTimeoutSource}. REQUIRED
308
+ * on every adapter, deliberately with no default, so a new provider must
309
+ * state its answer rather than inherit one. */
310
+ execTimeoutSource(): ExecTimeoutSource;
311
+ /** apra-fleet-lmtg.1: true when this provider supports fork-mode dispatch --
312
+ * branching a NEW, distinct session id from an existing session's context,
313
+ * as opposed to resume (which continues the source id in place). Optional:
314
+ * providers that do not implement it are NOT fork-capable. Callers MUST
315
+ * check `provider.supportsFork?.() ?? false` before ever calling
316
+ * {@link forkFlag} -- never assume support. */
317
+ supportsFork?(): boolean;
318
+ /** Builds the CLI flag(s) for a fork-mode dispatch: seeds context from
319
+ * `sourceSessionId`'s transcript but yields a NEW session id distinct from
320
+ * the source (the source session itself is left untouched). `newSessionId`
321
+ * is the caller-minted id the forked session should be created under --
322
+ * passed explicitly (e.g. as `--session-id`) rather than left for the CLI
323
+ * to mint and scrape back out of the response afterward. Only called
324
+ * when `supportsFork()` returns true. For providers whose CLI cannot
325
+ * express "new id, seeded from an existing transcript" (i.e. mints a new
326
+ * session id NOT derived from source context, same as a fresh dispatch),
327
+ * omit both this and {@link supportsFork} rather than faking support. */
328
+ forkFlag?(sourceSessionId: string, newSessionId: string): string;
329
+ /** Builds the CLI flag that makes a folder the dispatched session's WORKSPACE,
330
+ * for providers whose CLI does not adopt the process working directory as
331
+ * its workspace (AGY: `--add-dir <folder>`). Optional -- omit it for any
332
+ * provider where `cd <folder>` already establishes the workspace (claude,
333
+ * codex, copilot, opencode), and callers MUST treat a missing
334
+ * implementation as "nothing to add" rather than assuming a default flag.
335
+ * @param escapedFolder the work folder ALREADY escaped for the caller's own
336
+ * target shell (same contract as {@link modelFlag}) -- a POSIX caller
337
+ * passes escapeDoubleQuoted(folder), a Windows caller escapeWindowsArg(folder).
338
+ * Escaping cannot be done here: this method does not know the member's shell,
339
+ * and escapeDoubleQuoted would mangle the backslashes in a Windows path. */
340
+ workspaceDirFlag?(escapedFolder: string): string | null;
341
+ /** Builds the CLI flag that binds the run to the member's provider project
342
+ * (AGY: `--project <id>`), whose permission grants are the member's own.
343
+ * Optional -- omit it for providers with no project binding. An
344
+ * implementation must throw for a missing id rather than return '', so a
345
+ * dispatch can never silently run under a shared default project. */
346
+ projectFlag?(projectId?: string): string;
152
347
  /** Resolves the session transcript log path for a given session ID, AS IT EXISTS
153
348
  * ON THE MEMBER'S MACHINE.
154
349
  * @param homeDir The MEMBER's home directory. `undefined` falls back to this
@@ -177,16 +372,19 @@ export interface ProviderAdapter {
177
372
  * Default: passthrough (return content unchanged). */
178
373
  transformAgent(content: string, relPath: string): string;
179
374
  /** Returns the CLI flag/prefix for activating a named agent.
180
- * Claude/AGY: '--agent "name"'. Gemini: '@name '. Others: ''. */
375
+ * Claude/AGY: '--agent "name"'. Others: ''. */
181
376
  agentNameFlag(agentName: string): string;
182
377
  classifyError(output: string): PromptErrorCategory;
183
- /** Returns the config file path(s) for this provider's permission config (relative to repo root).
378
+ /** Optional hook called during compose_permissions before config delivery; returns
379
+ * warnings to surface in the tool result (e.g. AGY's global-skills check). */
380
+ preparePermissionsDelivery?(agent: import('../types.js').Agent, execCommand: WorkspaceTrustExecFn, memberHomeDir?: string | null, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell): Promise<string[] | void>;
381
+ /** Returns the config file path(s) for this provider's permission config (relative to repo root or home-anchored).
184
382
  * Parallel to the array returned by composePermissionConfig(). */
185
- permissionConfigPaths(): string[];
383
+ permissionConfigPaths(agent?: import('../types.js').Agent): string[];
186
384
  /** Returns provider-native permission config for the given role.
187
385
  * Each element corresponds to the path at the same index in permissionConfigPaths().
188
386
  * JSON providers return Record<string, unknown>; TOML providers return a string. */
189
- composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[]): Array<Record<string, unknown> | string>;
387
+ composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[], agent?: import('../types.js').Agent, opts?: ComposePermissionOptions): Array<Record<string, unknown> | string>;
190
388
  supportsOAuthCopy(): boolean;
191
389
  supportsApiKey(): boolean;
192
390
  oauthCredentialFiles(): Array<{
@@ -202,7 +400,7 @@ export interface ProviderAdapter {
202
400
  /** JSON output flag for the CLI (e.g. --output-format json, --json, --format json) */
203
401
  jsonOutputFlag(): string;
204
402
  /** Args for headless invocation with a safe literal prompt string.
205
- * Returns e.g. `-p "LITERAL"` for Claude/Gemini/Copilot or `exec "LITERAL"` for Codex. */
403
+ * Returns e.g. `-p "LITERAL"` for Claude/AGY/Copilot or `exec "LITERAL"` for Codex. */
206
404
  headlessInvocation(promptLiteral: string): string;
207
405
  /** Register (or update) this member's apra-fleet MCP endpoint using the provider's own
208
406
  * native mechanism (CLI verb, e.g. Claude's `claude mcp add`; or config-file merge, e.g.
@@ -234,7 +432,13 @@ export interface ProviderAdapter {
234
432
  * `execCommand` is the delivery channel (same one compose_permissions' deliverConfigFile
235
433
  * uses), so this works uniformly for local and remote (SSH) members. Non-Claude
236
434
  * providers no-op -- see each implementation's rationale comment (apra-fleet-eft.40
237
- * provider trust matrix). Callers should log distinctly on `seeded: true` vs `false`. */
238
- ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows'): Promise<EnsureWorkspaceTrustedResult>;
435
+ * provider trust matrix). Callers should log distinctly on `seeded: true` vs `false`.
436
+ * `shell` is the member's REGISTERED shell and is only meaningful when `agentOs` is
437
+ * 'windows': a member registered as Git-for-Windows bash needs POSIX command strings,
438
+ * because the PowerShell ones are handed straight to bash.exe and fail (apra-fleet-7dir.2.8).
439
+ * `transport.writeHomeFile`, when present, delivers the merged file without a shell
440
+ * command line (node:fs / SFTP) so a large ~/.claude.json cannot overflow the Windows
441
+ * CreateProcess limit (GitHub #499); without it the adapter chunks the write on Windows. */
442
+ ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell, transport?: WorkspaceTrustTransport, memberHomeDir?: string | null): Promise<EnsureWorkspaceTrustedResult>;
239
443
  }
240
444
  //# sourceMappingURL=provider.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
@@ -8,7 +8,7 @@ import { sanitizeSessionId } from '../os/os-commands.js';
8
8
  * Providers previously built member-side log paths with the default `path`
9
9
  * module, so a Windows hub produced backslash-joined paths for a Linux member
10
10
  * (and vice versa) -- a path that can never exist on the member, which silently
11
- * disables stall detection (Claude/Gemini) or manufactures a false-positive
11
+ * disables stall detection (Claude) or manufactures a false-positive
12
12
  * stall kill (AGY/OpenCode).
13
13
  *
14
14
  * `targetOs === undefined` deliberately keeps the legacy host-convention
@@ -45,7 +45,7 @@ export function encodeClaudeProjectDir(workFolder) {
45
45
  }
46
46
  /**
47
47
  * Build a `--resume <id>` flag with session ID sanitization and quoting.
48
- * Shared by providers that pass session IDs on the command line (Claude, Gemini).
48
+ * Shared by providers that pass session IDs on the command line (Claude).
49
49
  * @param sessionId - The raw session ID (will be sanitized)
50
50
  * @param fallback - Value to return when sessionId is absent (default: '')
51
51
  */
@@ -62,6 +62,62 @@ export function buildResumeFlag(sessionId, fallback = '') {
62
62
  export function buildSessionIdFlag(sessionId) {
63
63
  return `--session-id "${sanitizeSessionId(sessionId)}"`;
64
64
  }
65
+ /**
66
+ * Build a fork-mode resume flag: seed context from `sourceSessionId`'s transcript
67
+ * but yield a NEW, distinct session id rather than continuing the source id in
68
+ * place (contrast with {@link buildResumeFlag}, which resumes the source id
69
+ * unchanged). Shared by providers whose CLI supports resuming into a forked
70
+ * session id (Claude's `--fork-session`, used together with `--resume`).
71
+ *
72
+ * The forked session id is pre-minted by the caller and passed explicitly via
73
+ * `--session-id` alongside `--resume ... --fork-session`, rather than letting
74
+ * the CLI mint its own id and scraping it out of the response afterward -- the
75
+ * CLI honors a caller-supplied `--session-id` even in fork mode.
76
+ * @param sourceSessionId - The session ID to seed/fork from (will be sanitized)
77
+ * @param newSessionId - The caller-minted id the forked session should be created under (will be sanitized)
78
+ * @param fallback - Value to return when sourceSessionId is absent (default: '')
79
+ */
80
+ export function buildForkFlag(sourceSessionId, newSessionId, fallback = '') {
81
+ if (sourceSessionId) {
82
+ const sessionIdPart = newSessionId ? `--session-id "${sanitizeSessionId(newSessionId)}" ` : '';
83
+ return `${sessionIdPart}--resume "${sanitizeSessionId(sourceSessionId)}" --fork-session`;
84
+ }
85
+ return fallback;
86
+ }
87
+ /**
88
+ * apra-fleet-hzeb.1: THE provider-adapter default resume window for a guessed
89
+ * usage-limit signal (1 hour). This is the single source of truth for the guess --
90
+ * fleet-sprint and other consumers must read the signal's `resumeAt`, never
91
+ * hardcode their own 1h fallback.
92
+ */
93
+ export const DEFAULT_USAGE_LIMIT_RESUME_MS = 60 * 60 * 1000;
94
+ /**
95
+ * apra-fleet-hzeb.1: build a guessed usage-limit signal whose `resumeAt` is
96
+ * `now + DEFAULT_USAGE_LIMIT_RESUME_MS`. `now` is injectable for deterministic
97
+ * tests.
98
+ */
99
+ export function guessedUsageLimitSignal(message, now = Date.now()) {
100
+ return {
101
+ type: 'usage_limit',
102
+ resumeAt: new Date(now + DEFAULT_USAGE_LIMIT_RESUME_MS).toISOString(),
103
+ resumeAtSource: 'guessed',
104
+ message,
105
+ };
106
+ }
107
+ /**
108
+ * apra-fleet-hzeb.1: generic quota/usage-limit detector shared by the
109
+ * non-Claude adapters. Matches the durable "you are out of quota" signatures
110
+ * (a bare 429, "rate limit", "quota exceeded", "usage limit", "credit limit",
111
+ * "resource_exhausted") and returns a GUESSED signal. Transient overload
112
+ * (529 / "overloaded") deliberately does NOT match here -- that stays a
113
+ * retryable overload, not a usage limit.
114
+ */
115
+ const USAGE_LIMIT_QUOTA_RE = /\b429\b|rate limit|quota exceeded|usage limit|credit limit|resource_exhausted/i;
116
+ export function defaultUsageLimitSignal(output, now = Date.now()) {
117
+ if (!output || !USAGE_LIMIT_QUOTA_RE.test(output))
118
+ return null;
119
+ return guessedUsageLimitSignal(output, now);
120
+ }
65
121
  // apra-fleet-iuc.1 / apra-fleet-ekm: single source of truth for classifying a
66
122
  // parsed response as turn-limit terminated. The claude provider normalizes
67
123
  // terminalReason to 'max_turns' when the transcript carried the signal via any
@@ -1 +1 @@
1
- {"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,QAA8B,EAAE,GAAG,QAAkB;IAC7E,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAAkC;IAC/D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AACjC,CAAC;AAMD,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAA6B,EAAE,QAAQ,GAAG,EAAE;IAC1E,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,aAAa,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC;IACtD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,iBAAiB,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC;AAC1D,CAAC;AA2BD,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,4EAA4E;AAC5E,uDAAuD;AACvD,MAAM,UAAU,kBAAkB,CAAC,MAAyC;IAC1E,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,MAAM,CAAC,cAAc,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,CAAC;AACvF,CAAC"}
1
+ {"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@
10
10
  */
11
11
  import { createHash } from 'node:crypto';
12
12
  import { getOsCommands } from '../os/index.js';
13
- import { getAgentOS } from '../utils/agent-helpers.js';
13
+ import { getAgentOS, getAgentShell } from '../utils/agent-helpers.js';
14
14
  import { getStrategy } from './strategy.js';
15
15
  import { uploadContentToHome } from './sftp.js';
16
16
  import { loadAgentAssets } from '../cli/install.js';
@@ -53,7 +53,7 @@ const HASH_LINE_RE = /^([0-9a-fA-F]{64})\s+\*?(.+)$/;
53
53
  * successful probe that yields an empty map.
54
54
  */
55
55
  export async function probeRemoteAgentHashes(agent, dir) {
56
- const cmds = getOsCommands(getAgentOS(agent));
56
+ const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
57
57
  const strategy = getStrategy(agent);
58
58
  let result;
59
59
  try {
@@ -1 +1 @@
1
- {"version":3,"file":"agent-provisioner.js","sourceRoot":"","sources":["../../src/services/agent-provisioner.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-provisioner.js","sourceRoot":"","sources":["../../src/services/agent-provisioner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,102 @@
1
+ import type { Agent, SSHExecResult } from '../types.js';
2
+ export type AgyExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
3
+ /** Raised when an agy project cannot be created or verified. */
4
+ export declare class AgyProjectError extends Error {
5
+ constructor(message: string);
6
+ }
7
+ export declare function isValidAgyProjectId(id: unknown): id is string;
8
+ /** The prompt of the one model turn `agy --new-project` needs. It asks for no
9
+ * tool use: the id is read from the new project file and agy's own log, never
10
+ * from the model (the model does not know it -- see docs/agy-provider.md section 1). */
11
+ export declare const AGY_NEW_PROJECT_PROMPT = "Reply with only the word OK. Do not use any tools.";
12
+ export declare function buildAgyProjectProbeScript(projectId: string, home?: string | null): string;
13
+ export interface NewProjectScriptOptions {
14
+ workFolder: string;
15
+ model: string;
16
+ home?: string | null;
17
+ /** Extra environment for the agy process (the member's stored auth env vars). */
18
+ env?: Record<string, string>;
19
+ /** Test seam: run this executable (plus leading args) instead of `agy`. */
20
+ agyCommand?: {
21
+ file: string;
22
+ args: string[];
23
+ };
24
+ }
25
+ /**
26
+ * Member-side node script: list ~/.gemini/config/projects, run
27
+ * `agy --new-project` (spawned directly, no shell) in the work folder with a
28
+ * --log-file, list again, and report the new file names plus the ids agy
29
+ * logged as `created project "<name>" (id=<id>)`. The log file is deleted and
30
+ * its content is never echoed (it carries the account e-mail).
31
+ */
32
+ export declare function buildAgyNewProjectScript(opts: NewProjectScriptOptions): string;
33
+ /**
34
+ * Member-side script for remove_member's best-effort cleanup: deletes the
35
+ * member's own `<projectId>.json` plus, if present, the legacy
36
+ * `fleet-<memberId>.json` from an earlier design (older fleet versions), from ~/.gemini/config/projects only. A missing
37
+ * target is not an error (fs.rm's force:true); any other failure (e.g.
38
+ * permission denied) is reported back per target so the caller can decide
39
+ * whether it is warning-worthy.
40
+ */
41
+ export declare function buildAgyProjectDeleteScript(projectId: string, memberId: string, home?: string | null): string;
42
+ export interface AgyProjectDeleteResult {
43
+ deleted: string[];
44
+ errors: string[];
45
+ }
46
+ export declare function parseAgyProjectDeleteResult(result: SSHExecResult): AgyProjectDeleteResult;
47
+ export type AgyProjectState = 'ok' | 'missing' | 'corrupt' | 'id_mismatch';
48
+ export declare function parseAgyProjectProbe(result: SSHExecResult): AgyProjectState;
49
+ /**
50
+ * Validates the output of the new-project script: exactly one new
51
+ * `<uuid>.json` must have appeared, and agy's own log must name the same id.
52
+ * Anything else throws with the evidence.
53
+ */
54
+ export declare function parseAgyNewProjectResult(result: SSHExecResult): string;
55
+ export declare function probeAgyProject(agent: Agent, projectId: string, exec?: AgyExecFn): Promise<AgyProjectState>;
56
+ /**
57
+ * remove_member's best-effort cleanup: deletes the member's own agy project
58
+ * file (and a legacy fleet-<id>.json, if present) from its machine. Callers
59
+ * must skip this entirely when another registered member shares the same
60
+ * agyProjectId, and must treat any thrown AgyProjectError as a warning, not a
61
+ * reason to abort the removal.
62
+ */
63
+ export declare function removeAgyProject(agent: Agent, exec?: AgyExecFn): Promise<AgyProjectDeleteResult>;
64
+ /** Test seam: run a stand-in executable instead of the real `agy` on the
65
+ * member (undefined restores the default). */
66
+ export declare function setAgyCommandForTests(cmd: {
67
+ file: string;
68
+ args: string[];
69
+ } | undefined): void;
70
+ /** Creates a new agy project for the member and returns its id. Does not
71
+ * persist it -- see ensureAgyProject. */
72
+ export declare function provisionAgyProject(agent: Agent, exec?: AgyExecFn, agyCommand?: {
73
+ file: string;
74
+ args: string[];
75
+ } | undefined): Promise<string>;
76
+ export interface EnsureAgyProjectResult {
77
+ projectId: string;
78
+ /** Set when a project was created by this call, with the reason. */
79
+ provisioned?: 'no_project_id' | 'missing' | 'corrupt' | 'id_mismatch' | 'invalid_project_id';
80
+ }
81
+ export interface EnsureAgyProjectOptions {
82
+ exec?: AgyExecFn;
83
+ /** Write a newly created id to the registry (default true). register_member
84
+ * passes false because the member is not in the registry yet. */
85
+ persist?: boolean;
86
+ /** Test seam, forwarded to provisionAgyProject. */
87
+ agyCommand?: {
88
+ file: string;
89
+ args: string[];
90
+ };
91
+ }
92
+ /**
93
+ * Returns a verified project id for an agy member, creating the project when
94
+ * the member has none (upgrade path for members registered before project
95
+ * binding) or when its project file is missing, unparseable or names a
96
+ * different id. Sets `agent.agyProjectId` on the passed object and, unless
97
+ * persist is false, in the registry. Throws AgyProjectError on failure --
98
+ * callers must treat that as a hard error, never fall back to running agy
99
+ * without --project.
100
+ */
101
+ export declare function ensureAgyProject(agent: Agent, options?: EnsureAgyProjectOptions): Promise<EnsureAgyProjectResult>;
102
+ //# sourceMappingURL=agy-project.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agy-project.d.ts","sourceRoot":"","sources":["../../src/services/agy-project.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQxD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAExF,gEAAgE;AAChE,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAMD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAE7D;AAMD;;yFAEyF;AACzF,eAAO,MAAM,sBAAsB,uDAAuD,CAAC;AAe3F,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAoB1F;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CA+C9E;AAcD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmB7G;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAUzF;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAE3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA+BtE;AA6BD,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,SAA8B,GAAG,OAAO,CAAC,eAAe,CAAC,CAGrI;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAA8B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAI1H;AA0BD;+CAC+C;AAC/C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAE7F;AAED;0CAC0C;AAC1C,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,SAA8B,EACpC,UAAU,GAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAA8B,GAC5E,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,oBAAoB,CAAC;CAC9F;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;sEACkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2B3H"}