@apralabs/apra-fleet 0.3.6 → 0.4.0

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 (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,217 @@
1
+ /**
2
+ * Spoke-side hub-client (apra-fleet-us9.6/3jg): the apra-fleet.exe half of
3
+ * docs/hub-spoke-wire-protocol.md. Maintains one outbound SSE stream to
4
+ * fleet.apralabs.com per machine, announces/heartbeats presence, and
5
+ * dedupes at-least-once envelope redelivery by envelope_id. Deliberately
6
+ * does NOT execute relayed commands itself (apra-fleet-cgg's job, once
7
+ * this lands) -- `onEnvelope` is a caller-supplied hook.
8
+ *
9
+ * All I/O (fetch, timers, randomness, wall clock) is injected so the
10
+ * reconnect/backoff/heartbeat state machine can be tested deterministically
11
+ * without real timers or a real network -- same pattern as src/cli/join.ts's
12
+ * JoinDeps.
13
+ */
14
+ import crypto from 'node:crypto';
15
+ const BACKOFF_BASE_MS = 1000;
16
+ const BACKOFF_CAP_MS = 60000;
17
+ const DEFAULT_HEARTBEAT_DUE_MS = 20000;
18
+ const SEEN_ENVELOPE_TTL_MS = 5 * 60 * 1000;
19
+ /** Exponential backoff with full jitter, base 1s / cap 60s
20
+ * (docs/hub-spoke-wire-protocol.md section 2). `attempt` is 0-indexed
21
+ * consecutive failed reconnect attempts since the last successfully
22
+ * processed heartbeat ack. */
23
+ export function computeBackoffMs(attempt, random, base = BACKOFF_BASE_MS, cap = BACKOFF_CAP_MS) {
24
+ const ceiling = Math.min(cap, base * 2 ** attempt);
25
+ return Math.floor(random() * ceiling);
26
+ }
27
+ /**
28
+ * Short-lived seen-envelope_id cache (wire-protocol.md section 5): tier 2
29
+ * must no-op a duplicate at-least-once redelivery rather than re-executing
30
+ * an already-completed request.
31
+ */
32
+ export class SeenEnvelopeCache {
33
+ ttlMs;
34
+ now;
35
+ seen = new Map();
36
+ constructor(ttlMs, now) {
37
+ this.ttlMs = ttlMs;
38
+ this.now = now;
39
+ }
40
+ hasSeen(envelopeId) {
41
+ this.evict();
42
+ return this.seen.has(envelopeId);
43
+ }
44
+ markSeen(envelopeId) {
45
+ this.seen.set(envelopeId, this.now());
46
+ }
47
+ evict() {
48
+ const cutoff = this.now() - this.ttlMs;
49
+ for (const [id, ts] of this.seen) {
50
+ if (ts < cutoff)
51
+ this.seen.delete(id);
52
+ }
53
+ }
54
+ }
55
+ /**
56
+ * Incremental SSE `data:`-frame parser. Frames are separated by a blank
57
+ * line per the SSE spec; a frame with no `data:` line (e.g. a bare
58
+ * keep-alive comment) yields nothing. Malformed JSON in a data frame is
59
+ * skipped, not thrown -- a single corrupt frame must not kill the stream.
60
+ */
61
+ export class SseFrameParser {
62
+ buffer = '';
63
+ push(chunk) {
64
+ this.buffer += chunk;
65
+ const frames = [];
66
+ let idx;
67
+ while ((idx = this.buffer.indexOf('\n\n')) !== -1) {
68
+ const raw = this.buffer.slice(0, idx);
69
+ this.buffer = this.buffer.slice(idx + 2);
70
+ const dataLines = raw.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim());
71
+ if (dataLines.length === 0)
72
+ continue;
73
+ try {
74
+ frames.push(JSON.parse(dataLines.join('')));
75
+ }
76
+ catch {
77
+ // Skip a malformed frame rather than dropping the whole stream.
78
+ }
79
+ }
80
+ return frames;
81
+ }
82
+ }
83
+ export function createHubClient(deps) {
84
+ let stopped = false;
85
+ let attempt = 0;
86
+ let heartbeatTimer = null;
87
+ let nextHeartbeatDueMs = DEFAULT_HEARTBEAT_DUE_MS;
88
+ const seen = new SeenEnvelopeCache(SEEN_ENVELOPE_TTL_MS, deps.now);
89
+ async function postEnvelope(envelope) {
90
+ return deps.fetch(`${deps.hubUrl}/ws/${deps.workspaceId}/envelopes`, {
91
+ method: 'POST',
92
+ headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${deps.jwt}` },
93
+ body: JSON.stringify(envelope),
94
+ });
95
+ }
96
+ async function announcePresence() {
97
+ const members = deps.getMemberSnapshot();
98
+ const res = await postEnvelope({
99
+ envelope_id: crypto.randomUUID(),
100
+ workspace_id: deps.workspaceId,
101
+ kind: 'presence.announce',
102
+ from: { machine_id: deps.machineId, member_id: null },
103
+ to: { machine_id: null, member_id: null },
104
+ ts: new Date(deps.now()).toISOString(),
105
+ payload: { members: members.map((m) => ({ member_id: m.memberId, status: m.status })) },
106
+ });
107
+ return res.ok;
108
+ }
109
+ async function sendHeartbeat() {
110
+ const res = await postEnvelope({
111
+ envelope_id: crypto.randomUUID(),
112
+ workspace_id: deps.workspaceId,
113
+ kind: 'presence.heartbeat',
114
+ from: { machine_id: deps.machineId, member_id: null },
115
+ to: { machine_id: null, member_id: null },
116
+ ts: new Date(deps.now()).toISOString(),
117
+ });
118
+ if (!res.ok) {
119
+ deps.onLog?.(`hub-client: heartbeat rejected (${res.status})`);
120
+ return;
121
+ }
122
+ // Backoff resets ONLY on a successfully-processed heartbeat ack -- a
123
+ // bare TCP connect does not count (wire-protocol.md section 2).
124
+ attempt = 0;
125
+ const body = await res.json().catch(() => null);
126
+ if (typeof body?.payload?.next_heartbeat_due_ms === 'number') {
127
+ nextHeartbeatDueMs = body.payload.next_heartbeat_due_ms;
128
+ }
129
+ }
130
+ function scheduleHeartbeat() {
131
+ if (stopped)
132
+ return;
133
+ heartbeatTimer = deps.setTimeout(() => {
134
+ sendHeartbeat().finally(scheduleHeartbeat);
135
+ }, nextHeartbeatDueMs);
136
+ }
137
+ function stopHeartbeat() {
138
+ if (heartbeatTimer !== null) {
139
+ deps.clearTimeout(heartbeatTimer);
140
+ heartbeatTimer = null;
141
+ }
142
+ }
143
+ async function ackEnvelope(envelopeId, memberId) {
144
+ await deps.fetch(`${deps.hubUrl}/ws/${deps.workspaceId}/ack`, {
145
+ method: 'POST',
146
+ headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${deps.jwt}` },
147
+ body: JSON.stringify({ envelope_id: envelopeId, member_id: memberId }),
148
+ });
149
+ }
150
+ async function consumeStream(body) {
151
+ const parser = new SseFrameParser();
152
+ const reader = body.getReader();
153
+ const decoder = new TextDecoder();
154
+ try {
155
+ while (!stopped) {
156
+ const { value, done } = await reader.read();
157
+ if (done)
158
+ return;
159
+ const frames = parser.push(decoder.decode(value, { stream: true }));
160
+ for (const frame of frames) {
161
+ const envelope = frame;
162
+ if (!envelope?.envelope_id)
163
+ continue;
164
+ if (seen.hasSeen(envelope.envelope_id))
165
+ continue;
166
+ seen.markSeen(envelope.envelope_id);
167
+ await deps.onEnvelope(envelope);
168
+ if (envelope.target_member_id)
169
+ await ackEnvelope(envelope.envelope_id, envelope.target_member_id);
170
+ }
171
+ }
172
+ }
173
+ finally {
174
+ reader.releaseLock();
175
+ }
176
+ }
177
+ async function connectOnce() {
178
+ const announced = await announcePresence();
179
+ if (!announced)
180
+ throw new Error('presence.announce failed');
181
+ scheduleHeartbeat();
182
+ try {
183
+ const res = await deps.fetch(`${deps.hubUrl}/ws/${deps.workspaceId}/stream?machine_id=${encodeURIComponent(deps.machineId)}`, {
184
+ headers: { Authorization: `Bearer ${deps.jwt}` },
185
+ });
186
+ if (!res.ok || !res.body)
187
+ throw new Error(`stream connect failed (${res.status})`);
188
+ await consumeStream(res.body);
189
+ }
190
+ finally {
191
+ stopHeartbeat();
192
+ }
193
+ }
194
+ async function loop() {
195
+ while (!stopped) {
196
+ try {
197
+ await connectOnce();
198
+ }
199
+ catch (err) {
200
+ deps.onLog?.(`hub-client: connection error: ${err.message}`);
201
+ }
202
+ if (stopped)
203
+ return;
204
+ const waitMs = computeBackoffMs(attempt, deps.random);
205
+ attempt++;
206
+ await new Promise((resolve) => deps.setTimeout(resolve, waitMs));
207
+ }
208
+ }
209
+ void loop();
210
+ return {
211
+ stop() {
212
+ stopped = true;
213
+ stopHeartbeat();
214
+ },
215
+ };
216
+ }
217
+ //# sourceMappingURL=hub-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-client.js","sourceRoot":"","sources":["../../src/services/hub-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ export declare function getOrCreateKey(): string;
2
+ export interface JwtClaims {
3
+ member_id: string;
4
+ /** HARD security boundary (docs/hub-spoke-master-plan.md section 3).
5
+ * Phase 1: one machine == one implicit workspace, minted by the local
6
+ * issuer (src/services/token-issuer.ts); hub-era: minted by the dashboard.
7
+ * Same claim shape either way -- no token migration needed. */
8
+ workspace_id: string;
9
+ role: string;
10
+ work_folder: string;
11
+ /** Optional grouping label inside a workspace. Carries ZERO security
12
+ * weight -- no enforcement check may rely on it. */
13
+ project_id?: string;
14
+ }
15
+ export declare function sign(payload: JwtClaims): string;
16
+ export declare function verify(token: string): JwtClaims | null;
17
+ //# sourceMappingURL=jwt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/services/jwt.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB;;;oEAGgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAQ/C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA6BtD"}
@@ -0,0 +1,70 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import os from 'node:os';
4
+ import crypto from 'node:crypto';
5
+ const KEY_PATH = path.join(os.homedir(), '.apra-fleet', 'fleet.key');
6
+ export function getOrCreateKey() {
7
+ try {
8
+ const existing = fs.readFileSync(KEY_PATH, 'utf8').trim();
9
+ if (existing.length === 64)
10
+ return existing;
11
+ }
12
+ catch {
13
+ // file missing or unreadable -- create it
14
+ }
15
+ const key = crypto.randomBytes(32).toString('hex');
16
+ fs.mkdirSync(path.dirname(KEY_PATH), { recursive: true });
17
+ fs.writeFileSync(KEY_PATH, key, { encoding: 'utf8', mode: 0o600 });
18
+ return key;
19
+ }
20
+ function b64url(buf) {
21
+ const b64 = Buffer.isBuffer(buf) ? buf.toString('base64') : Buffer.from(buf).toString('base64');
22
+ return b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
23
+ }
24
+ function b64urlDecode(s) {
25
+ const pad = s.length % 4 === 0 ? '' : '='.repeat(4 - (s.length % 4));
26
+ return Buffer.from(s.replace(/-/g, '+').replace(/_/g, '/') + pad, 'base64').toString('utf8');
27
+ }
28
+ const SEVEN_DAYS_S = 7 * 24 * 60 * 60;
29
+ export function sign(payload) {
30
+ const key = getOrCreateKey();
31
+ const header = b64url(JSON.stringify({ alg: 'HS256', typ: 'JWT' }));
32
+ const now = Math.floor(Date.now() / 1000);
33
+ const body = b64url(JSON.stringify({ ...payload, iat: now, exp: now + SEVEN_DAYS_S }));
34
+ const signing = header + '.' + body;
35
+ const sig = b64url(crypto.createHmac('sha256', key).update(signing).digest());
36
+ return signing + '.' + sig;
37
+ }
38
+ export function verify(token) {
39
+ try {
40
+ const parts = token.split('.');
41
+ if (parts.length !== 3)
42
+ return null;
43
+ const [header, body, sig] = parts;
44
+ const key = getOrCreateKey();
45
+ const expectedSig = b64url(crypto.createHmac('sha256', key).update(header + '.' + body).digest());
46
+ if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expectedSig)))
47
+ return null;
48
+ const decoded = JSON.parse(b64urlDecode(body));
49
+ const now = Math.floor(Date.now() / 1000);
50
+ if (decoded.exp && decoded.exp < now)
51
+ return null;
52
+ if (typeof decoded.member_id !== 'string' ||
53
+ typeof decoded.workspace_id !== 'string' ||
54
+ typeof decoded.role !== 'string' ||
55
+ typeof decoded.work_folder !== 'string') {
56
+ return null;
57
+ }
58
+ return {
59
+ member_id: decoded.member_id,
60
+ workspace_id: decoded.workspace_id,
61
+ role: decoded.role,
62
+ work_folder: decoded.work_folder,
63
+ ...(typeof decoded.project_id === 'string' ? { project_id: decoded.project_id } : {}),
64
+ };
65
+ }
66
+ catch {
67
+ return null;
68
+ }
69
+ }
70
+ //# sourceMappingURL=jwt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/services/jwt.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /** Record a session id the server successfully dispatched to for a member.
2
+ * No-op when sessionId is undefined (a provider that never returns one). */
3
+ export declare function recordKnownSession(memberId: string, sessionId: string | undefined): void;
4
+ /** Whether the server has previously issued this session id for this member. */
5
+ export declare function isKnownSession(memberId: string, sessionId: string): boolean;
6
+ /** Test-only: clear the entire known-session ledger. */
7
+ export declare function _resetKnownSessions(): void;
8
+ //# sourceMappingURL=known-sessions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"known-sessions.d.ts","sourceRoot":"","sources":["../../src/services/known-sessions.ts"],"names":[],"mappings":"AAoBA;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQxF;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Per-member ledger of session ids this server process has successfully
3
+ * dispatched to (apra-fleet-eft.78.1).
4
+ *
5
+ * An explicit session-id resume (execute_prompt `resume: "<id>"`) asserts that
6
+ * the prompt depends on THAT session's prior context. Honoring it blindly would
7
+ * let an unknown/expired id silently start a fresh, blank session and run a
8
+ * context-dependent delta prompt with no context -- meaningless at best,
9
+ * destructively wrong at worst. This ledger is the resumability oracle: an id
10
+ * the server has actually issued (returned from a prior successful dispatch) is
11
+ * known/resumable; anything else is rejected as a TERMINAL `session_not_found`
12
+ * BEFORE any LLM is spawned, so the caller can rebuild context and re-dispatch
13
+ * fresh deliberately.
14
+ *
15
+ * Scoped by member id: a session id issued for one member is never treated as
16
+ * resumable for another. Populated only on a SUCCESSFUL dispatch (a failed
17
+ * dispatch never marks its id resumable).
18
+ */
19
+ const knownByMember = new Map();
20
+ /** Record a session id the server successfully dispatched to for a member.
21
+ * No-op when sessionId is undefined (a provider that never returns one). */
22
+ export function recordKnownSession(memberId, sessionId) {
23
+ if (!sessionId)
24
+ return;
25
+ let set = knownByMember.get(memberId);
26
+ if (!set) {
27
+ set = new Set();
28
+ knownByMember.set(memberId, set);
29
+ }
30
+ set.add(sessionId);
31
+ }
32
+ /** Whether the server has previously issued this session id for this member. */
33
+ export function isKnownSession(memberId, sessionId) {
34
+ return knownByMember.get(memberId)?.has(sessionId) ?? false;
35
+ }
36
+ /** Test-only: clear the entire known-session ledger. */
37
+ export function _resetKnownSessions() {
38
+ knownByMember.clear();
39
+ }
40
+ //# sourceMappingURL=known-sessions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"known-sessions.js","sourceRoot":"","sources":["../../src/services/known-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AAErD;6EAC6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,SAA6B;IAChF,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QACxB,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB;IAChE,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;AAC9D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,mBAAmB;IACjC,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * apra-fleet-dv5.5: per-member, per-tier LLM token pricing.
3
+ *
4
+ * Deterministic tier -> concrete-model resolution (resolveModelForTier() in
5
+ * execute-prompt.ts / each provider's modelTiers()) is config-driven and
6
+ * known ahead of any dispatch -- it does not require a per-dispatch
7
+ * echo-back to know what "member X's premium tier" resolves to. This module
8
+ * resolves each of a member's three tiers to a concrete model (mirroring
9
+ * resolveModelForTier's own resolution order: the member's own
10
+ * `modelTiers` override first, then the provider's default) and looks up
11
+ * that model's $/1M-token price.
12
+ *
13
+ * Same "unknown model returns null, never fabricate a price" discipline as
14
+ * apra-fleet-workflow's pricing.mjs -- these are point-in-time ESTIMATES,
15
+ * not a live pricing feed.
16
+ */
17
+ import type { Agent } from '../types.js';
18
+ import type { ProviderAdapter } from '../providers/provider.js';
19
+ export interface ModelPrice {
20
+ model: string;
21
+ promptPrice: number;
22
+ completionPrice: number;
23
+ }
24
+ export type MemberModelPricing = {
25
+ cheap: ModelPrice | null;
26
+ standard: ModelPrice | null;
27
+ premium: ModelPrice | null;
28
+ };
29
+ /**
30
+ * @param agent the member to resolve pricing for
31
+ * @param provider the ProviderAdapter for agent.llmProvider (getProvider(agent.llmProvider))
32
+ * @returns per-tier pricing; a tier is `null` when its resolved model has no
33
+ * known price (unlisted model, or a provider with no pricing table).
34
+ */
35
+ export declare function getMemberModelPricing(agent: Agent, provider: ProviderAdapter): MemberModelPricing;
36
+ //# sourceMappingURL=model-pricing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/services/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B,CAAC;AA+FF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CAQjG"}
@@ -0,0 +1,108 @@
1
+ import { getModelOverride } from './user-config.js';
2
+ /**
3
+ * provider -> concrete model id -> $/1M-token {prompt, completion}.
4
+ *
5
+ * Seeded from each provider adapter's own modelTiers() default (see
6
+ * src/providers/*.ts) -- these are the models actually dispatched against
7
+ * absent a per-member modelTiers override. An unlisted model (whether from
8
+ * an override or a future provider default change) returns null rather
9
+ * than a fabricated/guessed price.
10
+ */
11
+ const PROVIDER_MODEL_PRICING = {
12
+ claude: {
13
+ haiku: { prompt: 0.80, completion: 4.00 },
14
+ sonnet: { prompt: 3.00, completion: 15.00 },
15
+ opus: { prompt: 15.00, completion: 75.00 },
16
+ },
17
+ agy: {
18
+ 'gemini-3.5-flash-lite': { prompt: 0.10, completion: 0.40 },
19
+ 'gemini-3.5-flash': { prompt: 0.35, completion: 1.05 },
20
+ 'claude-sonnet-4.6': { prompt: 3.00, completion: 15.00 },
21
+ },
22
+ gemini: {
23
+ 'gemini-3.5-flash-lite': { prompt: 0.10, completion: 0.40 },
24
+ 'gemini-3.5-flash': { prompt: 0.35, completion: 1.05 },
25
+ 'gemini-3.1-pro-preview': { prompt: 3.50, completion: 10.50 },
26
+ },
27
+ codex: {
28
+ 'gpt-5.4-mini': { prompt: 0.25, completion: 2.00 },
29
+ 'gpt-5.4': { prompt: 5.00, completion: 15.00 },
30
+ },
31
+ copilot: {
32
+ 'claude-haiku-4-5': { prompt: 0.80, completion: 4.00 },
33
+ 'claude-sonnet-4-5': { prompt: 3.00, completion: 15.00 },
34
+ 'claude-opus-4-5': { prompt: 15.00, completion: 75.00 },
35
+ },
36
+ // OpenCode's default tier models are all free-tier ($0) -- a real,
37
+ // known price, not an "unknown model" null.
38
+ opencode: {
39
+ 'opencode/north-mini-code-free': { prompt: 0, completion: 0 },
40
+ 'opencode/deepseek-v4-flash-free': { prompt: 0, completion: 0 },
41
+ 'opencode/nemotron-3-ultra-free': { prompt: 0, completion: 0 },
42
+ },
43
+ // 'none' is a compute-only, non-LLM provider (see member-detail.ts's
44
+ // `tokenUsage = 'compute only'` handling) -- it has no models to price.
45
+ none: {},
46
+ };
47
+ /**
48
+ * Resolves a member's three tiers to concrete models using the SAME
49
+ * precedence chain execute-prompt.ts actually dispatches with (see its
50
+ * per-tier `if (resolvedModel === 'cheap') ... else if (... === 'standard')
51
+ * ...` block, ~line 293-313), not just resolveModelForTier() in isolation
52
+ * (that helper is itself only reached when `agent.modelTiers` is set --
53
+ * dead code otherwise in the real dispatch path). Per tier, in order:
54
+ * 1. `agent.modelTiers` (the whole-object override, e.g. from a planner
55
+ * or admin setting all three tiers at once) -- if set, wins for ALL
56
+ * three tiers and nothing below is consulted, mirroring
57
+ * resolveModelForTier()'s own cheap/standard/premium-then-first-
58
+ * defined fallback when a specific tier is absent from the object.
59
+ * 2. `agent.model<Tier>` (the single-tier per-member override set via
60
+ * `update_member --model-cheap/standard/premium`, docs/install.md
61
+ * "Customizing model tier mapping").
62
+ * 3. The global user-config override (`~/.apra-fleet/data/config.json`,
63
+ * getModelOverride()).
64
+ * 4. The provider's own hardcoded default (provider.modelTiers()).
65
+ */
66
+ function resolveMemberTierModels(agent, provider) {
67
+ const memberTiers = agent.modelTiers;
68
+ if (memberTiers) {
69
+ const fallback = memberTiers.standard ?? memberTiers.cheap ?? Object.values(memberTiers).filter(Boolean)[0];
70
+ return {
71
+ cheap: memberTiers.cheap ?? fallback,
72
+ standard: memberTiers.standard ?? fallback,
73
+ premium: memberTiers.premium ?? fallback,
74
+ };
75
+ }
76
+ const providerName = agent.llmProvider ?? 'claude';
77
+ const defaults = provider.modelTiers();
78
+ return {
79
+ cheap: agent.modelCheap || getModelOverride(providerName, 'cheap') || defaults.cheap,
80
+ standard: agent.modelStandard || getModelOverride(providerName, 'standard') || defaults.standard,
81
+ premium: agent.modelPremium || getModelOverride(providerName, 'premium') || defaults.premium,
82
+ };
83
+ }
84
+ function priceModel(providerName, model) {
85
+ const table = PROVIDER_MODEL_PRICING[providerName];
86
+ if (!table)
87
+ return null;
88
+ const price = table[model];
89
+ if (!price)
90
+ return null;
91
+ return { model, promptPrice: price.prompt, completionPrice: price.completion };
92
+ }
93
+ /**
94
+ * @param agent the member to resolve pricing for
95
+ * @param provider the ProviderAdapter for agent.llmProvider (getProvider(agent.llmProvider))
96
+ * @returns per-tier pricing; a tier is `null` when its resolved model has no
97
+ * known price (unlisted model, or a provider with no pricing table).
98
+ */
99
+ export function getMemberModelPricing(agent, provider) {
100
+ const providerName = agent.llmProvider ?? 'claude';
101
+ const tierModels = resolveMemberTierModels(agent, provider);
102
+ return {
103
+ cheap: priceModel(providerName, tierModels.cheap),
104
+ standard: priceModel(providerName, tierModels.standard),
105
+ premium: priceModel(providerName, tierModels.premium),
106
+ };
107
+ }
108
+ //# sourceMappingURL=model-pricing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../src/services/model-pricing.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ import type { AgentStrategy } from './strategy.js';
2
+ import type { OsCommands } from '../os/os-commands.js';
3
+ import type { LogScope } from '../utils/log-helpers.js';
4
+ export type OrphanRecoveryStatus =
5
+ /** The durable output file carried a real result -- `stdout` is populated. */
6
+ 'recovered'
7
+ /** The pid is confirmed dead (or there was nothing to check) -- caller keeps
8
+ * its pre-existing empty_response behavior, unchanged. */
9
+ | 'dead'
10
+ /** Process exited but the durable file was missing/empty -- a REAL empty
11
+ * response, same terminal handling as 'dead'. */
12
+ | 'empty'
13
+ /** Still alive when the wait cap was hit; the pid has been killed. Must be
14
+ * surfaced as its own terminal reason, never as empty_response. */
15
+ | 'timeout'
16
+ /** Recovery does not apply (no captured pid, no durable file path, or a
17
+ * platform without the durable-tee companion change). */
18
+ | 'unsupported';
19
+ export interface OrphanRecoveryResult {
20
+ status: OrphanRecoveryStatus;
21
+ stdout?: string;
22
+ /** How long the recovery path waited on the live pid, in ms. */
23
+ waitedMs?: number;
24
+ }
25
+ export interface OrphanRecoveryOptions {
26
+ strategy: AgentStrategy;
27
+ cmds: OsCommands;
28
+ /** PID captured from the FLEET_PID marker via onPidCaptured. */
29
+ pid?: number;
30
+ /** Remote path the dispatch teed its stdout to. */
31
+ durablePath?: string;
32
+ /** True for members whose remote OS has no durable-tee companion support. */
33
+ unsupported?: boolean;
34
+ /** Upper bound on the wait; defaults to the remaining max_total_s, else a ceiling. */
35
+ maxWaitMs?: number;
36
+ pollIntervalMs?: number;
37
+ scope?: Pick<LogScope, 'info'>;
38
+ /** Injectable sleep so tests do not depend on wall-clock or fake timers. */
39
+ sleep?: (ms: number) => Promise<void>;
40
+ }
41
+ /**
42
+ * Probe remote PID liveness over a FRESH short exec -- deliberately NOT the
43
+ * channel that just resolved, which is exactly the thing whose verdict is in
44
+ * doubt. Conservative on ambiguity, like isPidAlive(): only an explicit DEAD
45
+ * marker counts as dead; a failed/garbled probe is reported as alive so the
46
+ * caller waits rather than declaring a false failure.
47
+ */
48
+ export declare function isRemoteProcessAlive(strategy: AgentStrategy, pid: number): Promise<boolean>;
49
+ /** Read the durable per-invocation output file back over a fresh exec. */
50
+ export declare function readDurableOutput(strategy: AgentStrategy, durablePath: string): Promise<string | null>;
51
+ /**
52
+ * Lease-of-life gate. Returns 'dead' whenever the pre-existing empty_response
53
+ * behavior should apply verbatim, so the caller's fallback path is unchanged.
54
+ */
55
+ export declare function recoverOrphanedDispatch(opts: OrphanRecoveryOptions): Promise<OrphanRecoveryResult>;
56
+ //# sourceMappingURL=orphan-recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orphan-recovery.d.ts","sourceRoot":"","sources":["../../src/services/orphan-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA6BxD,MAAM,MAAM,oBAAoB;AAC9B,8EAA8E;AAC5E,WAAW;AACb;2DAC2D;GACzD,MAAM;AACR;kDACkD;GAChD,OAAO;AACT;oEACoE;GAClE,SAAS;AACX;0DAC0D;GACxD,aAAa,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAWD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,0EAA0E;AAC1E,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuCxG"}