@apralabs/apra-fleet 0.3.6 → 0.4.1

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 (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@apralabs/apra-fleet",
3
- "version": "0.3.6",
3
+ "version": "0.4.1",
4
4
  "description": "MCP server for orchestrating multiple agentic AI instances (Claude, Gemini, Codex, Copilot, AGY) across machines via SSH",
5
5
  "author": "Apra Labs",
6
6
  "homepage": "https://github.com/Apra-Labs/apra-fleet",
@@ -12,40 +12,62 @@
12
12
  "url": "https://github.com/Apra-Labs/apra-fleet/issues"
13
13
  },
14
14
  "type": "module",
15
+ "workspaces": [
16
+ "packages/apra-fleet-client",
17
+ "packages/apra-fleet-workflow",
18
+ "packages/apra-fleet-se",
19
+ "packages/fleet-api-contract"
20
+ ],
15
21
  "main": "dist/index.js",
16
22
  "bin": {
17
23
  "apra-fleet": "dist/index.js"
18
24
  },
19
25
  "engines": {
20
- "node": ">=22.0.0"
26
+ "node": ">=22.5.0"
21
27
  },
22
28
  "files": [
23
29
  "dist/",
24
30
  "hooks/",
25
31
  "scripts/fleet-statusline.sh",
26
- "scripts/agy-settings-merge.js",
27
32
  "scripts/agy-transcript-reader.js",
28
33
  "skills/",
29
- "version.json"
34
+ "version.json",
35
+ "packages/apra-fleet-se/workflow.json",
36
+ "packages/apra-fleet-se/package.json",
37
+ "packages/apra-fleet-se/fleet-sprint/",
38
+ "packages/apra-fleet-se/bin/",
39
+ "packages/apra-fleet-se/apra-pm/agents/",
40
+ "packages/apra-fleet-se/apra-pm/skills/",
41
+ "packages/apra-fleet-workflow/src/",
42
+ "packages/apra-fleet-workflow/package.json",
43
+ "packages/apra-fleet-client/src/",
44
+ "packages/apra-fleet-client/package.json"
30
45
  ],
31
46
  "publishConfig": {
32
47
  "access": "public"
33
48
  },
49
+ "overrides": {
50
+ "undici": "^7.29.0",
51
+ "fast-uri": "4.1.2"
52
+ },
34
53
  "scripts": {
35
- "build": "tsc",
54
+ "build": "npm run build:contract && tsc",
55
+ "build:contract": "npm run build --workspace=@apralabs/fleet-api-contract",
56
+ "gen:openapi": "npm run gen:openapi --workspace=@apralabs/fleet-api-contract",
57
+ "dist-pm": "node scripts/dist-pm.mjs",
36
58
  "build:sea": "node scripts/build-sea.mjs",
37
59
  "build:sea-config": "node scripts/gen-sea-config.mjs",
38
60
  "build:sea-package": "node scripts/package-sea.mjs",
39
61
  "build:binary": "npm run build && npm run build:sea && npm run build:sea-config && npm run build:sea-package",
40
62
  "start": "node dist/index.js",
41
63
  "dev": "tsc --watch",
42
- "pretest": "git submodule update --init --recursive",
43
- "test": "vitest run",
64
+ "pretest": "npm run build:contract",
65
+ "test": "node scripts/run-all-tests.mjs",
44
66
  "test:watch": "vitest",
45
67
  "smoke": "tsc && node dist/smoke-test.js",
46
- "integration": "tsc && npx tsx tests/integration.test.ts",
47
68
  "prepare": "node scripts/install-hooks.mjs",
48
- "prepublishOnly": "node scripts/vendor-pm.mjs && npm run build"
69
+ "sync-agent-docs": "node scripts/sync-agent-docs.mjs",
70
+ "prepublishOnly": "npm run dist-pm && npm run build"
49
71
  },
50
72
  "keywords": [
51
73
  "ai-agent",
@@ -64,18 +86,27 @@
64
86
  ],
65
87
  "license": "Apache-2.0",
66
88
  "dependencies": {
89
+ "@apralabs/apra-fleet-client": "file:packages/apra-fleet-client",
67
90
  "@inquirer/password": "^5.0.11",
68
91
  "@modelcontextprotocol/sdk": "^1.27.0",
92
+ "ajv": "^8.12.0",
93
+ "better-sqlite3": "^9.6.0",
94
+ "pg": "^8.22.0",
69
95
  "smol-toml": "^1.6.1",
70
96
  "ssh2": "^1.17.0",
97
+ "undici": "^7.29.0",
71
98
  "uuid": "^14.0.0",
72
99
  "zod": "^3.25.0"
73
100
  },
74
101
  "devDependencies": {
102
+ "@apralabs/fleet-api-contract": "^0.1.0",
103
+ "@types/better-sqlite3": "^7.6.13",
75
104
  "@types/node": "^22.0.0",
105
+ "@types/pg": "^8.20.0",
76
106
  "@types/ssh2": "^1.15.0",
77
107
  "@types/uuid": "^10.0.0",
78
108
  "esbuild": "^0.27.4",
109
+ "pg-mem": "^3.0.14",
79
110
  "postject": "^1.0.0-alpha.6",
80
111
  "typescript": "^5.5.0",
81
112
  "vitest": "^4.0.18"
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "@apralabs/apra-fleet-client",
3
+ "version": "1.0.0",
4
+ "description": "MCP Client SDK for Apra Fleet",
5
+ "private": true,
6
+ "engines": {
7
+ "node": ">=22.0.0"
8
+ },
9
+ "main": "src/client/api.mjs",
10
+ "exports": {
11
+ ".": "./src/client/api.mjs",
12
+ "./client": "./src/client/client.mjs",
13
+ "./factory": "./src/client/factory.mjs",
14
+ "./transport": "./src/client/transport.mjs",
15
+ "./server-resolution": "./src/client/server-resolution.mjs"
16
+ },
17
+ "scripts": {
18
+ "test": "node --test test/*.test.mjs"
19
+ },
20
+ "type": "module",
21
+ "author": "Apra Labs",
22
+ "license": "Apache-2.0",
23
+ "dependencies": {
24
+ "undici": "^7.29.0"
25
+ }
26
+ }
@@ -0,0 +1,510 @@
1
+ /**
2
+ * @typedef {Object} ExecutePromptOptions
3
+ * @property {string} prompt - The prompt to send to the LLM on the remote member
4
+ * @property {string} [agent] - Optional agent name to activate
5
+ * @property {number} [max_total_s] - Hard ceiling in seconds
6
+ * @property {number} [max_turns] - Max turns for claude -p (default: 50)
7
+ * @property {string} [member_id] - UUID of the member
8
+ * @property {string} [member_name] - Friendly name of the member
9
+ * @property {string} [model] - Model tier ("cheap", "standard", "premium") or a specific model ID
10
+ * @property {boolean|string} [resume] - Resume the previous session if one exists. Defaults to
11
+ * true at this client/transport layer when the field is omitted entirely. NOTE: the
12
+ * FleetWorkflow.agent() workflow layer (packages/apra-fleet-workflow/src/workflow/index.mjs)
13
+ * always sends this field explicitly, defaulting it to `false` for workflow-authored
14
+ * prompts (see AgentOptions.resume there and apra-fleet-unw.3 / F10) -- so workflow
15
+ * callers effectively opt out of this client-level default unless they ask for resume.
16
+ * @property {string} [session_id] - Optional explicit session ID to resume (shorthand alias for resume: "<sessionId>")
17
+ * @property {Record<string, string>} [substitutions] - Optional map of token name to replacement value
18
+ * @property {number} [timeout_s] - Inactivity timeout in seconds (default: 300)
19
+ * @property {number} [expected_context_tokens] - Optional estimate of how many
20
+ * tokens this dispatch will add to the target session's context. When set (or context_size is
21
+ * set), the server compares it against the session's remaining context-window headroom BEFORE
22
+ * invoking the LLM: too little headroom rejects the call with {reason:
23
+ * "insufficient_context_headroom", detail: {demand, headroom, window}} and no spawn; a fit that
24
+ * lands inside the safety margin still proceeds but attaches a structured contextWarning. Wins
25
+ * over context_size when both are set. Omitting both fields disables the check entirely --
26
+ * pre-existing behavior is unchanged. Matches src/tools/execute-prompt.ts's
27
+ * expected_context_tokens field exactly (number, optional).
28
+ * @property {'S'|'M'|'L'} [context_size] - Optional size-bucket shorthand for
29
+ * expected_context_tokens: S/M/L map to configured token estimates (fleet
30
+ * defaults, overridable via config.json's contextAdmission.sizeBucketTokens). Ignored when
31
+ * expected_context_tokens is also set. Matches src/tools/execute-prompt.ts's context_size field
32
+ * exactly (enum 'S'|'M'|'L', optional).
33
+ * @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
34
+ * the server; consumed locally by McpClient.request(). When omitted, a default is derived
35
+ * from max_total_s/timeout_s (see deriveTimeoutMs in this file).
36
+ * @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
37
+ * a response. Not sent to the server. Aborting rejects the pending request locally; it
38
+ * cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
39
+ */
40
+
41
+ /**
42
+ * @typedef {Object} ExecuteCommandOptions
43
+ * @property {string} command - The shell command to execute
44
+ * @property {boolean} [long_running] - Run as background task. Supported on linux and windows
45
+ * members. Windows launches the task detached via `Invoke-CimMethod Win32_Process.Create`
46
+ * (WMI provider host / session 0), independent of the SSH session's job object, since a plain
47
+ * background launch dies with the SSH channel there. darwin gets an advisory warning (the
48
+ * wrapper script is designed for Linux) but is not blocked. Matches
49
+ * src/tools/execute-command.ts's long_running branch exactly.
50
+ * @property {number} [max_retries] - Max crash retries (long_running only)
51
+ * @property {string} [member_id] - UUID of the member
52
+ * @property {string} [member_name] - Friendly name of the member
53
+ * @property {string} [restart_command] - Command for retry runs, e.g. checkpoint resume
54
+ * @property {string} [run_from] - Override directory to run from
55
+ * @property {number} [timeout_s] - Timeout in seconds (default: 120)
56
+ * @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
57
+ * the server; consumed locally by McpClient.request(). When omitted, a default is derived
58
+ * from timeout_s (see deriveTimeoutMs in this file).
59
+ * @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
60
+ * a response. Not sent to the server. Aborting rejects the pending request locally; it
61
+ * cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
62
+ */
63
+
64
+ /**
65
+ * @typedef {Object} ListMembersOptions
66
+ * @property {"compact" | "json"} [format] - Output format
67
+ * @property {string[]} [tags] - Filter members by tags (AND semantics)
68
+ */
69
+
70
+ /**
71
+ * @typedef {Object} FleetStatusOptions
72
+ * @property {"compact" | "json"} [format] - Output format
73
+ */
74
+
75
+ /**
76
+ * @typedef {Object} SendFilesOptions
77
+ * @property {string[]} local_paths - Array of local file paths to upload
78
+ * @property {string} [dest_subdir] - Destination subdirectory relative to work_folder on the member
79
+ * @property {string} [member_id] - UUID of the member
80
+ * @property {string} [member_name] - Friendly name of the member
81
+ * @property {Record<string, string>} [substitutions] - Optional map of token name to replacement value
82
+ */
83
+
84
+ /**
85
+ * @typedef {Object} ReceiveFilesOptions
86
+ * @property {string[]} remote_paths - Paths on the member to download
87
+ * @property {string} local_dest_dir - Local directory to write the downloaded files into
88
+ * @property {string} [member_id] - UUID of the member
89
+ * @property {string} [member_name] - Friendly name of the member
90
+ */
91
+
92
+ /**
93
+ * @typedef {Object} RegisterMemberOptions
94
+ * @property {string} friendly_name - Human-friendly name for this member (required)
95
+ * @property {string} work_folder - Working directory on the target machine (required). For remote members, must be a fully-qualified/absolute path -- "~" and relative paths are rejected.
96
+ * @property {"local" | "remote"} [member_type] - Member type (default: "remote")
97
+ * @property {string} [host] - IP address or hostname of the remote machine
98
+ * @property {string} [username] - SSH username
99
+ * @property {number} [port] - SSH port (default: 22)
100
+ * @property {"password" | "key"} [auth_type] - Authentication method
101
+ * @property {string} [password] - SSH password
102
+ * @property {string} [key_path] - Path to SSH private key
103
+ * @property {string} [llm_provider] - LLM provider for this member
104
+ * @property {string} [category] - Optional group label
105
+ * @property {string[]} [tags] - Optional list of free-form labels
106
+ * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode for unattended execution
107
+ */
108
+
109
+ /**
110
+ * @typedef {Object} UpdateMemberOptions
111
+ * @property {string} [member_id] - UUID of the member
112
+ * @property {string} [member_name] - Friendly name of the member
113
+ * @property {string} [friendly_name] - New friendly name
114
+ * @property {string} [work_folder] - New working directory. For non-local (remote/relay) members, must be a fully-qualified/absolute path -- "~" and relative paths are rejected.
115
+ * @property {string} [host] - New host
116
+ * @property {string} [username] - New SSH username
117
+ * @property {number} [port] - New SSH port
118
+ * @property {"password" | "key"} [auth_type] - New auth method
119
+ * @property {string} [password] - New SSH password
120
+ * @property {string} [key_path] - New SSH private key path
121
+ * @property {string} [llm_provider] - Change the LLM provider
122
+ * @property {string} [category] - Group label
123
+ * @property {string[]} [tags] - Free-form labels
124
+ * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode
125
+ */
126
+
127
+ /**
128
+ * @typedef {Object} RemoveMemberOptions
129
+ * @property {string} [member_id] - UUID of the member
130
+ * @property {string} [member_name] - Friendly name of the member
131
+ * @property {boolean} [force] - Remove even if the member is currently busy
132
+ */
133
+
134
+ /**
135
+ * @typedef {Object} ProvisionLlmAuthOptions
136
+ * @property {string} [member_id] - UUID of the member
137
+ * @property {string} [member_name] - Friendly name of the member
138
+ * @property {string} [api_key] - AI provider API key. If omitted, the local OAuth
139
+ * session is copied to the member instead. Supports {{secure.NAME}} token --
140
+ * resolved from the credential store server-side before use.
141
+ */
142
+
143
+ /**
144
+ * @typedef {Object} ProvisionVcsAuthOptions
145
+ * @property {string} [member_id] - UUID of the member
146
+ * @property {string} [member_name] - Friendly name of the member
147
+ * @property {"github" | "bitbucket" | "azure-devops"} provider - VCS provider to configure
148
+ * @property {string} [label] - Credential label (slug, e.g. "work-github"). Defaults to provider name.
149
+ * @property {string} [scope_url] - Git credential scope URL (e.g. "https://github.com/my-org").
150
+ * Defaults to "https://<host>".
151
+ * @property {"github-app" | "pat"} [github_mode] - GitHub auth mode: github-app (mint via
152
+ * configured app) or pat (personal access token)
153
+ * @property {string} [token] - Personal access token (GitHub PAT or Azure DevOps PAT).
154
+ * Supports {{secure.NAME}} token -- resolved from the credential store server-side before use.
155
+ * @property {"read" | "push" | "push+pr" | "admin" | "issues" | "full"} [git_access] - GitHub App access
156
+ * level override
157
+ * @property {string[]} [repos] - GitHub App repository list override
158
+ * @property {string} [email] - Bitbucket account email
159
+ * @property {string} [api_token] - Bitbucket API token. Supports {{secure.NAME}} token --
160
+ * resolved from the credential store server-side before use.
161
+ * @property {string} [workspace] - Bitbucket workspace slug
162
+ * @property {string} [org_url] - Azure DevOps organization URL (e.g. https://dev.azure.com/myorg)
163
+ * @property {string} [pat] - Azure DevOps personal access token. Supports {{secure.NAME}}
164
+ * token -- resolved from the credential store server-side before use.
165
+ */
166
+
167
+ /**
168
+ * @typedef {Object} ComposePermissionsOptions
169
+ * @property {string} [member_id] - UUID of the member
170
+ * @property {string} [member_name] - Friendly name of the member
171
+ * @property {"doer" | "reviewer"} [role] - Base profile. Provide at least one of role or tags.
172
+ * @property {string[]} [tags] - Member tags; "doer"/"reviewer" sets the primary mode
173
+ * and wins over role when both are given. Other tags load tag-<name>.json profiles.
174
+ * @property {string} [project_folder] - Local project folder containing the
175
+ * permissions.json ledger. Omit to skip ledger merge.
176
+ * @property {string[]} [grant] - Reactive mode: additional permissions to grant.
177
+ * Each entry is checked against the NEVER_AUTO_GRANT denylist, which is
178
+ * wildcard-matched (not exact-matched) against a normalized form of the
179
+ * request: sudo/su/doas, `bash -c`/`sh -c`/eval, env/printenv, nc/nmap,
180
+ * `chmod 777`, any catch-all such as `Bash(*)`, and any payload containing a
181
+ * shell-chaining metacharacter (| ; && backtick $() are rejected outright,
182
+ * for every caller.
183
+ * @property {string} [grant_reason] - Reason for the grant (stored in ledger)
184
+ */
185
+
186
+ /**
187
+ * @typedef {Object} SetupSshKeyOptions
188
+ * @property {string} [member_id] - UUID of the member
189
+ * @property {string} [member_name] - Friendly name of the member
190
+ */
191
+
192
+ /**
193
+ * @typedef {Object} SendEmailOptions
194
+ * @property {"sendgrid" | "smtp"} [provider] - Email provider to use (default "sendgrid").
195
+ * Secrets are resolved server-side from the credential store ("sendgrid_api_key" / "smtp_password").
196
+ * @property {string} from - Sender email address (required)
197
+ * @property {string} [host] - SMTP server hostname (required for smtp provider)
198
+ * @property {number} [port] - SMTP server port (default 587, or 465 when secure is true)
199
+ * @property {string} [user] - SMTP username (required for smtp provider)
200
+ * @property {boolean} [secure] - Use implicit TLS, e.g. port 465 (default false).
201
+ * When false, STARTTLS is required; plaintext AUTH is refused.
202
+ * @property {string | string[]} to - Recipient email address, or list of addresses
203
+ * @property {string} subject - Email subject line
204
+ * @property {string} body - Plain-text email body
205
+ * @property {string} [html] - Optional HTML email body
206
+ * @property {string[]} [cc] - CC recipient addresses
207
+ * @property {string[]} [bcc] - BCC recipient addresses
208
+ * @property {{ filename: string, content: string, contentType?: string }[]} [attachments] - Optional file attachments (base64-encoded content)
209
+ */
210
+
211
+
212
+ // Grace margin added on top of the payload's own timeout hint (timeout_s /
213
+ // max_total_s) so the client doesn't race the server's own deadline -- the
214
+ // server should have a chance to reply with its own timeout/error first.
215
+ //
216
+ // This single-budget (max_total_s * 1) + grace shape relies on the server
217
+ // (src/tools/execute-prompt.ts, apra-fleet-y8q.1) sharing ONE max_total_s
218
+ // deadline budget across an original dispatch attempt AND any single retry it
219
+ // runs on its own (e.g. the fresh-session retry after an SSH inactivity
220
+ // exception) -- a retry's own maxTotalMs/timeoutMs is capped to whatever
221
+ // remains of max_total_s since the dispatch started, and skipped entirely
222
+ // once that budget is exhausted. Without that server-side sharing, a retry
223
+ // could burn a second full max_total_s budget and the client's hard timeout
224
+ // here would fire before the server's own clean retry-and-report path ever
225
+ // gets a chance, surfacing a raw client transport timeout instead of the
226
+ // server's typed error. Do not widen this to max_total_s * 2 unless that
227
+ // server-side sharing invariant is removed.
228
+ const TIMEOUT_GRACE_MS = 30 * 1000;
229
+
230
+ /**
231
+ * Derives a client-side McpClient.request() timeout (ms) from a payload's
232
+ * own timeout hints. Prefers max_total_s (a hard ceiling) over timeout_s
233
+ * (an inactivity timeout) when both are present, then adds a grace margin.
234
+ * Returns undefined when neither hint is present, letting McpClient fall
235
+ * back to its own conservative default (never infinite).
236
+ *
237
+ * See the TIMEOUT_GRACE_MS comment above: this budget is only sufficient
238
+ * because the server shares a single max_total_s deadline across an attempt
239
+ * and its own internal retry, rather than granting each a fresh full budget.
240
+ *
241
+ * @param {{ max_total_s?: number, timeout_s?: number }} payload
242
+ * @returns {number | undefined}
243
+ */
244
+ export function deriveTimeoutMs(payload = {}) {
245
+ const hintSeconds = payload.max_total_s ?? payload.timeout_s;
246
+ if (typeof hintSeconds !== 'number' || !Number.isFinite(hintSeconds) || hintSeconds <= 0) {
247
+ return undefined;
248
+ }
249
+ return hintSeconds * 1000 + TIMEOUT_GRACE_MS;
250
+ }
251
+
252
+ /**
253
+ * Extract the JSON payload from a raw MCP tool-call result.
254
+ *
255
+ * Every ApraFleet wrapper returns the raw callTool() result --
256
+ * `{ content: [{ type: 'text', text }, ...] }` -- NOT a JSON string, so
257
+ * `JSON.parse(result)` on it throws. Tool results can also carry
258
+ * display-only items (e.g. an `<apra-fleet-display>` onboarding block)
259
+ * AHEAD of the payload, so content[0] is not reliable either. This helper
260
+ * returns the first content item that parses as JSON.
261
+ *
262
+ * @param {{ content?: { text?: string }[] }} result - raw callTool() result
263
+ * @returns {any} the parsed JSON payload
264
+ * @throws {Error} when no content item contains valid JSON
265
+ */
266
+ export function parseToolJson(result) {
267
+ for (const item of result?.content ?? []) {
268
+ try { return JSON.parse(item.text); } catch { /* not the payload */ }
269
+ }
270
+ throw new Error('No JSON payload in tool result');
271
+ }
272
+
273
+ export class ApraFleet {
274
+ /**
275
+ * @param {{ callTool: (name: string, args: Record<string, any>, opts?: { timeoutMs?: number, signal?: AbortSignal }) => Promise<any> }} mcpClient
276
+ */
277
+ constructor(mcpClient) {
278
+ this.mcpClient = mcpClient;
279
+ }
280
+
281
+ /**
282
+ * Run an AI prompt on a member.
283
+ * @param {ExecutePromptOptions} options
284
+ */
285
+ async executePrompt(options) {
286
+ const { timeoutMs, signal, ...payload } = options;
287
+ return this.mcpClient.callTool('execute_prompt', payload, {
288
+ timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
289
+ signal
290
+ });
291
+ }
292
+
293
+ /**
294
+ * Run a shell command on a member.
295
+ * @param {ExecuteCommandOptions} options
296
+ */
297
+ async executeCommand(options) {
298
+ const { timeoutMs, signal, ...payload } = options;
299
+ return this.mcpClient.callTool('execute_command', payload, {
300
+ timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
301
+ signal
302
+ });
303
+ }
304
+
305
+ /**
306
+ * List all fleet members and their current status.
307
+ * @param {ListMembersOptions} [options]
308
+ */
309
+ async listMembers(options = {}) {
310
+ return this.mcpClient.callTool('list_members', options);
311
+ }
312
+
313
+ /**
314
+ * Get status of all fleet members.
315
+ * @param {FleetStatusOptions} [options]
316
+ */
317
+ async fleetStatus(options = {}) {
318
+ return this.mcpClient.callTool('fleet_status', options);
319
+ }
320
+
321
+ /**
322
+ * Get detailed status for one member: connectivity, session, work folder, provider.
323
+ * @param {{ member_id?: string, member_name?: string, format?: 'compact'|'json' }} options
324
+ */
325
+ async memberDetail(options) {
326
+ return this.mcpClient.callTool('member_detail', options);
327
+ }
328
+
329
+ /**
330
+ * Get a member's cheap/standard/premium tier resolved to a concrete
331
+ * model and its real per-1M-token price (apra-fleet-dv5.5/dv5.6).
332
+ * @param {{ member_id?: string, member_name?: string }} options
333
+ */
334
+ async getMemberModelPricing(options) {
335
+ return this.mcpClient.callTool('get_member_model_pricing', options);
336
+ }
337
+
338
+ /**
339
+ * Transfer local files to a member.
340
+ * @param {SendFilesOptions} options
341
+ */
342
+ async sendFiles(options) {
343
+ return this.mcpClient.callTool('send_files', options);
344
+ }
345
+
346
+ /**
347
+ * Download files from a member to a local directory.
348
+ * @param {ReceiveFilesOptions} options
349
+ */
350
+ async receiveFiles(options) {
351
+ return this.mcpClient.callTool('receive_files', options);
352
+ }
353
+
354
+ /**
355
+ * Add a machine to the fleet.
356
+ * @param {RegisterMemberOptions} options
357
+ */
358
+ async registerMember(options) {
359
+ return this.mcpClient.callTool('register_member', options);
360
+ }
361
+
362
+ /**
363
+ * Change a member's settings.
364
+ * @param {UpdateMemberOptions} options
365
+ */
366
+ async updateMember(options) {
367
+ return this.mcpClient.callTool('update_member', options);
368
+ }
369
+
370
+ /**
371
+ * Remove a member from the fleet.
372
+ * @param {RemoveMemberOptions} options
373
+ */
374
+ async removeMember(options) {
375
+ return this.mcpClient.callTool('remove_member', options);
376
+ }
377
+
378
+ /**
379
+ * Provision LLM auth (OAuth session copy or API key) onto a member.
380
+ * @param {ProvisionLlmAuthOptions} options
381
+ */
382
+ async provisionLlmAuth(options) {
383
+ return this.mcpClient.callTool('provision_llm_auth', options);
384
+ }
385
+
386
+ /**
387
+ * Provision VCS (git host) auth -- GitHub App token / PAT, Bitbucket API
388
+ * token, or Azure DevOps PAT -- onto a member.
389
+ * @param {ProvisionVcsAuthOptions} options
390
+ */
391
+ async provisionVcsAuth(options) {
392
+ return this.mcpClient.callTool('provision_vcs_auth', options);
393
+ }
394
+
395
+ /**
396
+ * Compose and deliver a scoped permission profile to a member.
397
+ * @param {ComposePermissionsOptions} options
398
+ */
399
+ async composePermissions(options) {
400
+ return this.mcpClient.callTool('compose_permissions', options);
401
+ }
402
+
403
+ /**
404
+ * Convert a remote member from password to SSH key authentication.
405
+ * @param {SetupSshKeyOptions} options
406
+ */
407
+ async setupSshKey(options) {
408
+ return this.mcpClient.callTool('setup_ssh_key', options);
409
+ }
410
+
411
+ /**
412
+ * Send an email. Pass provider config inline (provider, from, and for
413
+ * SMTP: host, port, user, secure). Secrets resolve from the credential
414
+ * store (sendgrid_api_key / smtp_password).
415
+ * @param {SendEmailOptions} options
416
+ */
417
+ async sendEmail(options) {
418
+ return this.mcpClient.callTool('send_email', options);
419
+ }
420
+
421
+ /**
422
+ * Collect a secret from the user out-of-band and store it in the fleet
423
+ * credential store. The secret value never passes through the caller.
424
+ * @param {{ name: string, prompt: string, persist?: boolean,
425
+ * network_policy?: 'allow'|'confirm'|'deny', members?: string,
426
+ * ttl_seconds?: number }} options
427
+ */
428
+ async credentialStoreSet(options) {
429
+ return this.mcpClient.callTool('credential_store_set', options);
430
+ }
431
+
432
+ /**
433
+ * List stored credentials (names and metadata only -- no values).
434
+ * The result payload is a JSON array of { name, scope, ... } entries;
435
+ * extract it with parseToolJson().
436
+ */
437
+ async credentialStoreList() {
438
+ return this.mcpClient.callTool('credential_store_list', {});
439
+ }
440
+
441
+ /**
442
+ * Delete a named credential from the store.
443
+ * @param {{ name: string }} options
444
+ */
445
+ async credentialStoreDelete(options) {
446
+ return this.mcpClient.callTool('credential_store_delete', options);
447
+ }
448
+
449
+ /**
450
+ * Update metadata (members, TTL, network policy) on an existing
451
+ * credential without re-entering the secret.
452
+ * @param {{ name: string, members?: string, ttl_seconds?: number,
453
+ * network_policy?: 'allow'|'confirm'|'deny' }} options
454
+ */
455
+ async credentialStoreUpdate(options) {
456
+ return this.mcpClient.callTool('credential_store_update', options);
457
+ }
458
+
459
+ /**
460
+ * Fleet-server-hosted global dolt push mutex (apra-fleet-f34.2,
461
+ * src/tools/dolt-push-mutex.ts). Serializes cross-sprint `bd dolt push`
462
+ * for sprints launched WITHOUT a supervisor to coordinate through.
463
+ *
464
+ * `acquire` is ticketed (an MCP call cannot long-poll): it returns
465
+ * `{ granted, ticket, token? }` after a bounded wait, and the caller
466
+ * re-`poll`s the SAME ticket until granted. Polling never dequeues the
467
+ * waiter, so FIFO order is preserved. Pass the caller's real `pid` so a
468
+ * crashed holder is reclaimed by the dead-pid probe.
469
+ *
470
+ * @param {{ action: 'acquire'|'poll'|'release'|'renew'|'cancel'|'status',
471
+ * sprint_id?: string, ticket?: string, token?: string,
472
+ * pid?: number, wait_ms?: number }} options
473
+ */
474
+ async doltPushMutex(options) {
475
+ return this.mcpClient.callTool('dolt_push_mutex', options);
476
+ }
477
+
478
+ /**
479
+ * Fleet-server-hosted global child-bead-id allocator (apra-fleet-f34.2,
480
+ * src/tools/child-id-allocator.ts). Mints globally-distinct child ids under
481
+ * a shared parent for sprints launched WITHOUT a supervisor, so two sprints
482
+ * creating children under the same parent never derive the same id.
483
+ *
484
+ * @param {{ action: 'allocate'|'confirm'|'release'|'status',
485
+ * parent_id?: string, token?: string, sprint_id?: string,
486
+ * pid?: number, floor?: number }} options
487
+ */
488
+ async childIdAllocator(options) {
489
+ return this.mcpClient.callTool('child_id_allocator', options);
490
+ }
491
+
492
+ /**
493
+ * Gracefully shut down the fleet server this client is connected to.
494
+ * Self-terminates the server process (deletes the singleton pointer,
495
+ * closes the HTTP transport and all SSH connections) -- does not touch
496
+ * the OS service-manager layer at all, so it works even when service
497
+ * registration (systemd/schtasks) never succeeded.
498
+ *
499
+ * The server closing its own transport as part of shutting down can race
500
+ * this very request's response -- callers should treat ANY outcome
501
+ * (resolve, reject, or timeout) as inconclusive on its own and verify via
502
+ * a direct status check instead. opts.timeoutMs (default 5000) keeps a
503
+ * lost response from hanging the caller up to the SDK's normal 15-minute
504
+ * default.
505
+ * @param {{ timeoutMs?: number }} [opts]
506
+ */
507
+ async shutdownServer(opts = {}) {
508
+ return this.mcpClient.callTool('shutdown_server', {}, { timeoutMs: opts.timeoutMs ?? 5000 });
509
+ }
510
+ }