@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
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.0",
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,6 +12,12 @@
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"
@@ -23,29 +29,44 @@
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
+ },
34
52
  "scripts": {
35
- "build": "tsc",
53
+ "build": "npm run build:contract && tsc",
54
+ "build:contract": "npm run build --workspace=@apralabs/fleet-api-contract",
55
+ "gen:openapi": "npm run gen:openapi --workspace=@apralabs/fleet-api-contract",
56
+ "dist-pm": "node scripts/dist-pm.mjs",
36
57
  "build:sea": "node scripts/build-sea.mjs",
37
58
  "build:sea-config": "node scripts/gen-sea-config.mjs",
38
59
  "build:sea-package": "node scripts/package-sea.mjs",
39
60
  "build:binary": "npm run build && npm run build:sea && npm run build:sea-config && npm run build:sea-package",
40
61
  "start": "node dist/index.js",
41
62
  "dev": "tsc --watch",
42
- "pretest": "git submodule update --init --recursive",
63
+ "pretest": "npm run build:contract",
43
64
  "test": "vitest run",
44
65
  "test:watch": "vitest",
45
66
  "smoke": "tsc && node dist/smoke-test.js",
46
- "integration": "tsc && npx tsx tests/integration.test.ts",
47
67
  "prepare": "node scripts/install-hooks.mjs",
48
- "prepublishOnly": "node scripts/vendor-pm.mjs && npm run build"
68
+ "sync-agent-docs": "node scripts/sync-agent-docs.mjs",
69
+ "prepublishOnly": "npm run dist-pm && npm run build"
49
70
  },
50
71
  "keywords": [
51
72
  "ai-agent",
@@ -64,18 +85,25 @@
64
85
  ],
65
86
  "license": "Apache-2.0",
66
87
  "dependencies": {
88
+ "@apralabs/apra-fleet-client": "file:packages/apra-fleet-client",
67
89
  "@inquirer/password": "^5.0.11",
68
90
  "@modelcontextprotocol/sdk": "^1.27.0",
91
+ "ajv": "^8.12.0",
92
+ "pg": "^8.22.0",
69
93
  "smol-toml": "^1.6.1",
70
94
  "ssh2": "^1.17.0",
95
+ "undici": "^7.29.0",
71
96
  "uuid": "^14.0.0",
72
97
  "zod": "^3.25.0"
73
98
  },
74
99
  "devDependencies": {
100
+ "@apralabs/fleet-api-contract": "^0.1.0",
75
101
  "@types/node": "^22.0.0",
102
+ "@types/pg": "^8.20.0",
76
103
  "@types/ssh2": "^1.15.0",
77
104
  "@types/uuid": "^10.0.0",
78
105
  "esbuild": "^0.27.4",
106
+ "pg-mem": "^3.0.14",
79
107
  "postject": "^1.0.0-alpha.6",
80
108
  "typescript": "^5.5.0",
81
109
  "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,396 @@
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} [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 {Record<string, string>} [substitutions] - Optional map of token name to replacement value
17
+ * @property {number} [timeout_s] - Inactivity timeout in seconds (default: 300)
18
+ * @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
19
+ * the server; consumed locally by McpClient.request(). When omitted, a default is derived
20
+ * from max_total_s/timeout_s (see deriveTimeoutMs in this file).
21
+ * @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
22
+ * a response. Not sent to the server. Aborting rejects the pending request locally; it
23
+ * cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
24
+ */
25
+
26
+ /**
27
+ * @typedef {Object} ExecuteCommandOptions
28
+ * @property {string} command - The shell command to execute
29
+ * @property {boolean} [long_running] - Run as background task
30
+ * @property {number} [max_retries] - Max crash retries (long_running only)
31
+ * @property {string} [member_id] - UUID of the member
32
+ * @property {string} [member_name] - Friendly name of the member
33
+ * @property {string} [restart_command] - Command for retry runs, e.g. checkpoint resume
34
+ * @property {string} [run_from] - Override directory to run from
35
+ * @property {number} [timeout_s] - Timeout in seconds (default: 120)
36
+ * @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
37
+ * the server; consumed locally by McpClient.request(). When omitted, a default is derived
38
+ * from timeout_s (see deriveTimeoutMs in this file).
39
+ * @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
40
+ * a response. Not sent to the server. Aborting rejects the pending request locally; it
41
+ * cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
42
+ */
43
+
44
+ /**
45
+ * @typedef {Object} ListMembersOptions
46
+ * @property {"compact" | "json"} [format] - Output format
47
+ * @property {string[]} [tags] - Filter members by tags (AND semantics)
48
+ */
49
+
50
+ /**
51
+ * @typedef {Object} FleetStatusOptions
52
+ * @property {"compact" | "json"} [format] - Output format
53
+ */
54
+
55
+ /**
56
+ * @typedef {Object} SendFilesOptions
57
+ * @property {string[]} local_paths - Array of local file paths to upload
58
+ * @property {string} [dest_subdir] - Destination subdirectory relative to work_folder on the member
59
+ * @property {string} [member_id] - UUID of the member
60
+ * @property {string} [member_name] - Friendly name of the member
61
+ * @property {Record<string, string>} [substitutions] - Optional map of token name to replacement value
62
+ */
63
+
64
+ /**
65
+ * @typedef {Object} ReceiveFilesOptions
66
+ * @property {string[]} remote_paths - Paths on the member to download
67
+ * @property {string} local_dest_dir - Local directory to write the downloaded files into
68
+ * @property {string} [member_id] - UUID of the member
69
+ * @property {string} [member_name] - Friendly name of the member
70
+ */
71
+
72
+ /**
73
+ * @typedef {Object} RegisterMemberOptions
74
+ * @property {string} friendly_name - Human-friendly name for this member (required)
75
+ * @property {string} work_folder - Working directory on the target machine (required)
76
+ * @property {"local" | "remote"} [member_type] - Member type (default: "remote")
77
+ * @property {string} [host] - IP address or hostname of the remote machine
78
+ * @property {string} [username] - SSH username
79
+ * @property {number} [port] - SSH port (default: 22)
80
+ * @property {"password" | "key"} [auth_type] - Authentication method
81
+ * @property {string} [password] - SSH password
82
+ * @property {string} [key_path] - Path to SSH private key
83
+ * @property {string} [llm_provider] - LLM provider for this member
84
+ * @property {string} [category] - Optional group label
85
+ * @property {string[]} [tags] - Optional list of free-form labels
86
+ * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode for unattended execution
87
+ */
88
+
89
+ /**
90
+ * @typedef {Object} UpdateMemberOptions
91
+ * @property {string} [member_id] - UUID of the member
92
+ * @property {string} [member_name] - Friendly name of the member
93
+ * @property {string} [friendly_name] - New friendly name
94
+ * @property {string} [work_folder] - New working directory
95
+ * @property {string} [host] - New host
96
+ * @property {string} [username] - New SSH username
97
+ * @property {number} [port] - New SSH port
98
+ * @property {"password" | "key"} [auth_type] - New auth method
99
+ * @property {string} [password] - New SSH password
100
+ * @property {string} [key_path] - New SSH private key path
101
+ * @property {string} [llm_provider] - Change the LLM provider
102
+ * @property {string} [category] - Group label
103
+ * @property {string[]} [tags] - Free-form labels
104
+ * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode
105
+ */
106
+
107
+ /**
108
+ * @typedef {Object} RemoveMemberOptions
109
+ * @property {string} [member_id] - UUID of the member
110
+ * @property {string} [member_name] - Friendly name of the member
111
+ * @property {boolean} [force] - Remove even if the member is currently busy
112
+ */
113
+
114
+ /**
115
+ * @typedef {Object} ProvisionLlmAuthOptions
116
+ * @property {string} [member_id] - UUID of the member
117
+ * @property {string} [member_name] - Friendly name of the member
118
+ * @property {string} [api_key] - AI provider API key. If omitted, the local OAuth
119
+ * session is copied to the member instead. Supports {{secure.NAME}} token --
120
+ * resolved from the credential store server-side before use.
121
+ */
122
+
123
+ /**
124
+ * @typedef {Object} ProvisionVcsAuthOptions
125
+ * @property {string} [member_id] - UUID of the member
126
+ * @property {string} [member_name] - Friendly name of the member
127
+ * @property {"github" | "bitbucket" | "azure-devops"} provider - VCS provider to configure
128
+ * @property {string} [label] - Credential label (slug, e.g. "work-github"). Defaults to provider name.
129
+ * @property {string} [scope_url] - Git credential scope URL (e.g. "https://github.com/my-org").
130
+ * Defaults to "https://<host>".
131
+ * @property {"github-app" | "pat"} [github_mode] - GitHub auth mode: github-app (mint via
132
+ * configured app) or pat (personal access token)
133
+ * @property {string} [token] - Personal access token (GitHub PAT or Azure DevOps PAT).
134
+ * Supports {{secure.NAME}} token -- resolved from the credential store server-side before use.
135
+ * @property {"read" | "push" | "push+pr" | "admin" | "issues" | "full"} [git_access] - GitHub App access
136
+ * level override
137
+ * @property {string[]} [repos] - GitHub App repository list override
138
+ * @property {string} [email] - Bitbucket account email
139
+ * @property {string} [api_token] - Bitbucket API token. Supports {{secure.NAME}} token --
140
+ * resolved from the credential store server-side before use.
141
+ * @property {string} [workspace] - Bitbucket workspace slug
142
+ * @property {string} [org_url] - Azure DevOps organization URL (e.g. https://dev.azure.com/myorg)
143
+ * @property {string} [pat] - Azure DevOps personal access token. Supports {{secure.NAME}}
144
+ * token -- resolved from the credential store server-side before use.
145
+ */
146
+
147
+ /**
148
+ * @typedef {Object} ComposePermissionsOptions
149
+ * @property {string} [member_id] - UUID of the member
150
+ * @property {string} [member_name] - Friendly name of the member
151
+ * @property {"doer" | "reviewer"} [role] - Base profile. Provide at least one of role or tags.
152
+ * @property {string[]} [tags] - Member tags; "doer"/"reviewer" sets the primary mode
153
+ * and wins over role when both are given. Other tags load tag-<name>.json profiles.
154
+ * @property {string} [project_folder] - Local project folder containing the
155
+ * permissions.json ledger. Omit to skip ledger merge.
156
+ * @property {string[]} [grant] - Reactive mode: additional permissions to grant.
157
+ * @property {string} [grant_reason] - Reason for the grant (stored in ledger)
158
+ */
159
+
160
+ /**
161
+ * @typedef {Object} SetupSshKeyOptions
162
+ * @property {string} [member_id] - UUID of the member
163
+ * @property {string} [member_name] - Friendly name of the member
164
+ */
165
+
166
+
167
+ // Grace margin added on top of the payload's own timeout hint (timeout_s /
168
+ // max_total_s) so the client doesn't race the server's own deadline -- the
169
+ // server should have a chance to reply with its own timeout/error first.
170
+ //
171
+ // This single-budget (max_total_s * 1) + grace shape relies on the server
172
+ // (src/tools/execute-prompt.ts, apra-fleet-y8q.1) sharing ONE max_total_s
173
+ // deadline budget across an original dispatch attempt AND any single retry it
174
+ // runs on its own (e.g. the fresh-session retry after an SSH inactivity
175
+ // exception) -- a retry's own maxTotalMs/timeoutMs is capped to whatever
176
+ // remains of max_total_s since the dispatch started, and skipped entirely
177
+ // once that budget is exhausted. Without that server-side sharing, a retry
178
+ // could burn a second full max_total_s budget and the client's hard timeout
179
+ // here would fire before the server's own clean retry-and-report path ever
180
+ // gets a chance, surfacing a raw client transport timeout instead of the
181
+ // server's typed error. Do not widen this to max_total_s * 2 unless that
182
+ // server-side sharing invariant is removed.
183
+ const TIMEOUT_GRACE_MS = 30 * 1000;
184
+
185
+ /**
186
+ * Derives a client-side McpClient.request() timeout (ms) from a payload's
187
+ * own timeout hints. Prefers max_total_s (a hard ceiling) over timeout_s
188
+ * (an inactivity timeout) when both are present, then adds a grace margin.
189
+ * Returns undefined when neither hint is present, letting McpClient fall
190
+ * back to its own conservative default (never infinite).
191
+ *
192
+ * See the TIMEOUT_GRACE_MS comment above: this budget is only sufficient
193
+ * because the server shares a single max_total_s deadline across an attempt
194
+ * and its own internal retry, rather than granting each a fresh full budget.
195
+ *
196
+ * @param {{ max_total_s?: number, timeout_s?: number }} payload
197
+ * @returns {number | undefined}
198
+ */
199
+ export function deriveTimeoutMs(payload = {}) {
200
+ const hintSeconds = payload.max_total_s ?? payload.timeout_s;
201
+ if (typeof hintSeconds !== 'number' || !Number.isFinite(hintSeconds) || hintSeconds <= 0) {
202
+ return undefined;
203
+ }
204
+ return hintSeconds * 1000 + TIMEOUT_GRACE_MS;
205
+ }
206
+
207
+ export class ApraFleet {
208
+ /**
209
+ * @param {{ callTool: (name: string, args: Record<string, any>, opts?: { timeoutMs?: number, signal?: AbortSignal }) => Promise<any> }} mcpClient
210
+ */
211
+ constructor(mcpClient) {
212
+ this.mcpClient = mcpClient;
213
+ }
214
+
215
+ /**
216
+ * Run an AI prompt on a member.
217
+ * @param {ExecutePromptOptions} options
218
+ */
219
+ async executePrompt(options) {
220
+ const { timeoutMs, signal, ...payload } = options;
221
+ return this.mcpClient.callTool('execute_prompt', payload, {
222
+ timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
223
+ signal
224
+ });
225
+ }
226
+
227
+ /**
228
+ * Run a shell command on a member.
229
+ * @param {ExecuteCommandOptions} options
230
+ */
231
+ async executeCommand(options) {
232
+ const { timeoutMs, signal, ...payload } = options;
233
+ return this.mcpClient.callTool('execute_command', payload, {
234
+ timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
235
+ signal
236
+ });
237
+ }
238
+
239
+ /**
240
+ * List all fleet members and their current status.
241
+ * @param {ListMembersOptions} [options]
242
+ */
243
+ async listMembers(options = {}) {
244
+ return this.mcpClient.callTool('list_members', options);
245
+ }
246
+
247
+ /**
248
+ * Get status of all fleet members.
249
+ * @param {FleetStatusOptions} [options]
250
+ */
251
+ async fleetStatus(options = {}) {
252
+ return this.mcpClient.callTool('fleet_status', options);
253
+ }
254
+
255
+ /**
256
+ * Get detailed status for one member: connectivity, session, work folder, provider.
257
+ * @param {{ member_id?: string, member_name?: string, format?: 'compact'|'json' }} options
258
+ */
259
+ async memberDetail(options) {
260
+ return this.mcpClient.callTool('member_detail', options);
261
+ }
262
+
263
+ /**
264
+ * Get a member's cheap/standard/premium tier resolved to a concrete
265
+ * model and its real per-1M-token price (apra-fleet-dv5.5/dv5.6).
266
+ * @param {{ member_id?: string, member_name?: string }} options
267
+ */
268
+ async getMemberModelPricing(options) {
269
+ return this.mcpClient.callTool('get_member_model_pricing', options);
270
+ }
271
+
272
+ /**
273
+ * Transfer local files to a member.
274
+ * @param {SendFilesOptions} options
275
+ */
276
+ async sendFiles(options) {
277
+ return this.mcpClient.callTool('send_files', options);
278
+ }
279
+
280
+ /**
281
+ * Download files from a member to a local directory.
282
+ * @param {ReceiveFilesOptions} options
283
+ */
284
+ async receiveFiles(options) {
285
+ return this.mcpClient.callTool('receive_files', options);
286
+ }
287
+
288
+ /**
289
+ * Add a machine to the fleet.
290
+ * @param {RegisterMemberOptions} options
291
+ */
292
+ async registerMember(options) {
293
+ return this.mcpClient.callTool('register_member', options);
294
+ }
295
+
296
+ /**
297
+ * Change a member's settings.
298
+ * @param {UpdateMemberOptions} options
299
+ */
300
+ async updateMember(options) {
301
+ return this.mcpClient.callTool('update_member', options);
302
+ }
303
+
304
+ /**
305
+ * Remove a member from the fleet.
306
+ * @param {RemoveMemberOptions} options
307
+ */
308
+ async removeMember(options) {
309
+ return this.mcpClient.callTool('remove_member', options);
310
+ }
311
+
312
+ /**
313
+ * Provision LLM auth (OAuth session copy or API key) onto a member.
314
+ * @param {ProvisionLlmAuthOptions} options
315
+ */
316
+ async provisionLlmAuth(options) {
317
+ return this.mcpClient.callTool('provision_llm_auth', options);
318
+ }
319
+
320
+ /**
321
+ * Provision VCS (git host) auth -- GitHub App token / PAT, Bitbucket API
322
+ * token, or Azure DevOps PAT -- onto a member.
323
+ * @param {ProvisionVcsAuthOptions} options
324
+ */
325
+ async provisionVcsAuth(options) {
326
+ return this.mcpClient.callTool('provision_vcs_auth', options);
327
+ }
328
+
329
+ /**
330
+ * Compose and deliver a scoped permission profile to a member.
331
+ * @param {ComposePermissionsOptions} options
332
+ */
333
+ async composePermissions(options) {
334
+ return this.mcpClient.callTool('compose_permissions', options);
335
+ }
336
+
337
+ /**
338
+ * Convert a remote member from password to SSH key authentication.
339
+ * @param {SetupSshKeyOptions} options
340
+ */
341
+ async setupSshKey(options) {
342
+ return this.mcpClient.callTool('setup_ssh_key', options);
343
+ }
344
+
345
+ /**
346
+ * Fleet-server-hosted global dolt push mutex (apra-fleet-f34.2,
347
+ * src/tools/dolt-push-mutex.ts). Serializes cross-sprint `bd dolt push`
348
+ * for sprints launched WITHOUT a supervisor to coordinate through.
349
+ *
350
+ * `acquire` is ticketed (an MCP call cannot long-poll): it returns
351
+ * `{ granted, ticket, token? }` after a bounded wait, and the caller
352
+ * re-`poll`s the SAME ticket until granted. Polling never dequeues the
353
+ * waiter, so FIFO order is preserved. Pass the caller's real `pid` so a
354
+ * crashed holder is reclaimed by the dead-pid probe.
355
+ *
356
+ * @param {{ action: 'acquire'|'poll'|'release'|'renew'|'cancel'|'status',
357
+ * sprint_id?: string, ticket?: string, token?: string,
358
+ * pid?: number, wait_ms?: number }} options
359
+ */
360
+ async doltPushMutex(options) {
361
+ return this.mcpClient.callTool('dolt_push_mutex', options);
362
+ }
363
+
364
+ /**
365
+ * Fleet-server-hosted global child-bead-id allocator (apra-fleet-f34.2,
366
+ * src/tools/child-id-allocator.ts). Mints globally-distinct child ids under
367
+ * a shared parent for sprints launched WITHOUT a supervisor, so two sprints
368
+ * creating children under the same parent never derive the same id.
369
+ *
370
+ * @param {{ action: 'allocate'|'confirm'|'release'|'status',
371
+ * parent_id?: string, token?: string, sprint_id?: string,
372
+ * pid?: number, floor?: number }} options
373
+ */
374
+ async childIdAllocator(options) {
375
+ return this.mcpClient.callTool('child_id_allocator', options);
376
+ }
377
+
378
+ /**
379
+ * Gracefully shut down the fleet server this client is connected to.
380
+ * Self-terminates the server process (deletes the singleton pointer,
381
+ * closes the HTTP transport and all SSH connections) -- does not touch
382
+ * the OS service-manager layer at all, so it works even when service
383
+ * registration (systemd/schtasks) never succeeded.
384
+ *
385
+ * The server closing its own transport as part of shutting down can race
386
+ * this very request's response -- callers should treat ANY outcome
387
+ * (resolve, reject, or timeout) as inconclusive on its own and verify via
388
+ * a direct status check instead. opts.timeoutMs (default 5000) keeps a
389
+ * lost response from hanging the caller up to the SDK's normal 15-minute
390
+ * default.
391
+ * @param {{ timeoutMs?: number }} [opts]
392
+ */
393
+ async shutdownServer(opts = {}) {
394
+ return this.mcpClient.callTool('shutdown_server', {}, { timeoutMs: opts.timeoutMs ?? 5000 });
395
+ }
396
+ }
@@ -0,0 +1,146 @@
1
+ import { TimeoutError, AbortError, TransportClosedError } from './errors.mjs';
2
+
3
+ // Conservative fallback when no timeout hint is supplied by the caller and
4
+ // none can be derived from the request payload. Never infinite: a server
5
+ // that accepts a request and never replies (without closing the transport)
6
+ // must not hang the caller forever.
7
+ export const DEFAULT_REQUEST_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes
8
+
9
+ export class McpClient {
10
+ constructor(transport) {
11
+ this.transport = transport;
12
+ this.pendingRequests = new Map();
13
+ this.nextId = 1;
14
+
15
+ this.transport.on('message', (message) => {
16
+ this.handleMessage(message);
17
+ });
18
+
19
+ this.transport.on('close', () => {
20
+ for (const [id, pending] of this.pendingRequests.entries()) {
21
+ pending.reject(new TransportClosedError('Transport closed', { details: { requestId: id } }));
22
+ }
23
+ this.pendingRequests.clear();
24
+ });
25
+
26
+ this.transport.on('error', (err) => {
27
+ for (const [id, pending] of this.pendingRequests.entries()) {
28
+ pending.reject(err);
29
+ }
30
+ this.pendingRequests.clear();
31
+ });
32
+ }
33
+
34
+ handleMessage(message) {
35
+ if (message.jsonrpc === '2.0' && 'id' in message) {
36
+ const pending = this.pendingRequests.get(message.id);
37
+ if (pending) {
38
+ // A late reply (arriving after the request already timed out
39
+ // or was aborted) has no pending entry left to resolve --
40
+ // this is a silent no-op rather than a crash or corruption
41
+ // of any other in-flight request.
42
+ this.pendingRequests.delete(message.id);
43
+ if ('error' in message) {
44
+ const errMsg = message.error?.message || JSON.stringify(message.error);
45
+ pending.reject(new Error(errMsg));
46
+ } else {
47
+ pending.resolve(message.result);
48
+ }
49
+ }
50
+ }
51
+ }
52
+
53
+ /**
54
+ * @param {string} method
55
+ * @param {object} [params]
56
+ * @param {{ timeoutMs?: number, signal?: AbortSignal }} [opts]
57
+ * - timeoutMs: reject with a TimeoutError (.code === 'TIMEOUT') if no
58
+ * response arrives within this window. Defaults to
59
+ * DEFAULT_REQUEST_TIMEOUT_MS when omitted -- never infinite.
60
+ * - signal: an optional AbortSignal; aborting rejects the pending
61
+ * request with an AbortError (.code === 'ABORTED') and removes it
62
+ * from the pending map.
63
+ *
64
+ * NOTE: this is a *client-side* timeout/abort only. It stops the client
65
+ * from waiting forever and frees local resources, but it cannot cancel
66
+ * the remote job -- the fleet-server process keeps running the request
67
+ * it already accepted. True remote cancellation (and idempotency keys
68
+ * to make retries safe) require fleet-server changes, which are out of
69
+ * scope here (external repo, apra-fleet.exe).
70
+ */
71
+ async request(method, params, opts = {}) {
72
+ const id = this.nextId++;
73
+ const message = {
74
+ jsonrpc: "2.0",
75
+ id: id,
76
+ method: method,
77
+ params: params
78
+ };
79
+
80
+ const timeoutMs = opts.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
81
+ const signal = opts.signal;
82
+
83
+ return new Promise((resolve, reject) => {
84
+ let settled = false;
85
+ let timer = null;
86
+
87
+ const onAbort = () => {
88
+ settleReject(new AbortError(`Request "${method}" (id=${id}) aborted before a response was received.`, {
89
+ details: { method, id }
90
+ }));
91
+ };
92
+
93
+ const cleanup = () => {
94
+ if (settled) return;
95
+ settled = true;
96
+ if (timer) clearTimeout(timer);
97
+ if (signal) signal.removeEventListener('abort', onAbort);
98
+ };
99
+
100
+ const settleResolve = (value) => {
101
+ if (settled) return;
102
+ cleanup();
103
+ resolve(value);
104
+ };
105
+
106
+ const settleReject = (err) => {
107
+ if (settled) return;
108
+ this.pendingRequests.delete(id);
109
+ cleanup();
110
+ reject(err);
111
+ };
112
+
113
+ if (signal) {
114
+ if (signal.aborted) {
115
+ onAbort();
116
+ return;
117
+ }
118
+ signal.addEventListener('abort', onAbort);
119
+ }
120
+
121
+ if (timeoutMs !== Infinity && timeoutMs != null) {
122
+ // Intentionally not unref()'d: a caller awaiting this
123
+ // request should keep the process alive until it settles
124
+ // (resolve, reject, timeout, or abort) rather than letting
125
+ // the process exit while the promise is still pending.
126
+ timer = setTimeout(() => {
127
+ settleReject(new TimeoutError(
128
+ `Request "${method}" (id=${id}) timed out after ${timeoutMs}ms with no response.`,
129
+ { details: { method, id, timeoutMs } }
130
+ ));
131
+ }, timeoutMs);
132
+ }
133
+
134
+ this.pendingRequests.set(id, { resolve: settleResolve, reject: settleReject });
135
+
136
+ this.transport.send(message).catch(err => {
137
+ this.pendingRequests.delete(id);
138
+ settleReject(err);
139
+ });
140
+ });
141
+ }
142
+
143
+ async callTool(name, args, opts = {}) {
144
+ return this.request("tools/call", { name: name, arguments: args }, opts);
145
+ }
146
+ }