@apralabs/apra-fleet 0.3.6 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,371 @@
1
+ import http from 'node:http';
2
+ import crypto from 'node:crypto';
3
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
5
+ import { fleetEvents } from './event-bus.js';
6
+ import { getOrCreateKey } from './jwt.js';
7
+ import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
8
+ import { sessionRegistry } from './session-registry.js';
9
+ import { getAgent, findAgentByName } from './registry.js';
10
+ import { DEFAULT_PORT, DEFAULT_HOST } from '../paths.js';
11
+ import { serverVersion } from '../version.js';
12
+ import { logLine } from '../utils/log-helpers.js';
13
+ function parseBody(req) {
14
+ return new Promise((resolve, reject) => {
15
+ const chunks = [];
16
+ req.on('data', (chunk) => chunks.push(chunk));
17
+ req.on('end', () => {
18
+ try {
19
+ const text = Buffer.concat(chunks).toString('utf8');
20
+ resolve(text ? JSON.parse(text) : undefined);
21
+ }
22
+ catch (err) {
23
+ reject(err);
24
+ }
25
+ });
26
+ req.on('error', reject);
27
+ });
28
+ }
29
+ function listenOnPort(server, port, host) {
30
+ return new Promise((resolve, reject) => {
31
+ server.listen(port, host, () => {
32
+ const addr = server.address();
33
+ resolve(addr.port);
34
+ });
35
+ server.once('error', reject);
36
+ });
37
+ }
38
+ function isInitializeRequest(body) {
39
+ if (!body)
40
+ return false;
41
+ if (Array.isArray(body)) {
42
+ return body.some((msg) => msg.method === 'initialize');
43
+ }
44
+ return body.method === 'initialize';
45
+ }
46
+ function extractBearer(req) {
47
+ const auth = req.headers.authorization;
48
+ if (!auth?.startsWith('Bearer '))
49
+ return null;
50
+ return auth.slice(7);
51
+ }
52
+ export async function createHttpTransport(options) {
53
+ const { registerTools, preferredPort } = options;
54
+ const sessions = new Map();
55
+ const startedAt = Date.now();
56
+ // LOW-1: Track event listener references for cleanup in close()
57
+ const eventCleanups = [];
58
+ async function handleSessionRequest(req, res) {
59
+ const sessionId = req.headers['mcp-session-id'];
60
+ if (!sessionId) {
61
+ res.writeHead(400);
62
+ res.end('Missing mcp-session-id header');
63
+ return;
64
+ }
65
+ const session = sessions.get(sessionId);
66
+ if (!session) {
67
+ res.writeHead(404);
68
+ res.end('Session not found');
69
+ return;
70
+ }
71
+ await session.transport.handleRequest(req, res);
72
+ }
73
+ const httpServer = http.createServer(async (req, res) => {
74
+ const url = req.url ?? '/';
75
+ if (url === '/health' && req.method === 'GET') {
76
+ const body = JSON.stringify({
77
+ status: 'ok',
78
+ version: serverVersion,
79
+ pid: process.pid,
80
+ uptime: Math.floor((Date.now() - startedAt) / 1000),
81
+ sessions: sessions.size,
82
+ });
83
+ res.writeHead(200, { 'Content-Type': 'application/json' });
84
+ res.end(body);
85
+ return;
86
+ }
87
+ if (url === '/shutdown' && req.method === 'POST') {
88
+ // Admin-only endpoint: require the local signing key (~/.apra-fleet/fleet.key,
89
+ // mode 0o600) as a bearer token. This is not a member JWT -- it's proof the
90
+ // caller can read a file only the same OS user can read, matching this
91
+ // server's existing 127.0.0.1-only trust boundary. See apra-fleet-2xs.11.
92
+ const rawToken = extractBearer(req);
93
+ if (rawToken === null || rawToken !== getOrCreateKey()) {
94
+ logLine('session', 'unauthorized /shutdown attempt rejected');
95
+ res.writeHead(401, { 'Content-Type': 'application/json' });
96
+ res.end(JSON.stringify({ error: 'unauthorized' }));
97
+ return;
98
+ }
99
+ const body = JSON.stringify({ status: 'shutting-down' });
100
+ res.writeHead(200, { 'Content-Type': 'application/json' });
101
+ res.end(body);
102
+ setTimeout(() => {
103
+ process.emit('SIGINT');
104
+ }, 100);
105
+ return;
106
+ }
107
+ if (url !== '/mcp' && !url.startsWith('/mcp?')) {
108
+ res.writeHead(404);
109
+ res.end();
110
+ return;
111
+ }
112
+ if (req.method === 'POST') {
113
+ // JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
114
+ const rawToken = extractBearer(req);
115
+ const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
116
+ const memberParam = parsedUrl.searchParams.get('member');
117
+ let postClaims = null;
118
+ if (rawToken !== null) {
119
+ postClaims = getTokenIssuer().verify(rawToken);
120
+ if (!postClaims) {
121
+ logLine('session', `jwt verify failed for member_param=${memberParam ?? 'none'} url=${req.url}`);
122
+ res.writeHead(401, { 'Content-Type': 'application/json' });
123
+ res.end(JSON.stringify({ error: 'invalid token' }));
124
+ return;
125
+ }
126
+ }
127
+ if (rawToken === null && memberParam !== null) {
128
+ logLine('session', 'member identity from URL param: ' + memberParam);
129
+ }
130
+ let parsedBody;
131
+ try {
132
+ parsedBody = await parseBody(req);
133
+ }
134
+ catch {
135
+ res.writeHead(400);
136
+ res.end('Bad request body');
137
+ return;
138
+ }
139
+ if (isInitializeRequest(parsedBody)) {
140
+ logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
141
+ const body = parsedBody;
142
+ const clientInfo = body?.params?.clientInfo ?? {};
143
+ const clientCaps = body?.params?.capabilities ?? {};
144
+ const capKeys = Object.keys(clientCaps).join(',');
145
+ // apra-fleet-eft.74.1: the explicit interactive opt-in handshake. Only a
146
+ // client that declares the provider-branded `claude/channel` capability
147
+ // at initialize can receive the `notifications/claude/channel`
148
+ // server-push that execute_prompt's interactive routing depends on. A
149
+ // plain subprocess connect-back (a Doer's tool-access MCP session) still
150
+ // presents a valid member JWT and registers a live `server` below, but
151
+ // it does NOT declare this capability -- so it must never be flagged
152
+ // interactive-routable. Mirrors the capability the server itself
153
+ // advertises (experimental['claude/channel']).
154
+ const channelCapable = !!clientCaps
155
+ ?.experimental?.['claude/channel'];
156
+ // Identity keying is unified on the member UUID. The URL ?member= param
157
+ // (unauthenticated local fallback) historically carried the friendly
158
+ // name; new URLs carry the UUID, and legacy friendly names are resolved
159
+ // to the UUID via the agent registry here.
160
+ let fallbackMemberId = null;
161
+ let fallbackWorkFolder = '';
162
+ if (postClaims === null && memberParam !== null) {
163
+ const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
164
+ fallbackMemberId = agent?.id ?? memberParam;
165
+ fallbackWorkFolder = agent?.workFolder ?? '';
166
+ if (agent && agent.id !== memberParam) {
167
+ logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
168
+ }
169
+ }
170
+ // Unauthenticated sessions (PM/tools, URL-param fallback) can only come
171
+ // from this machine (server binds 127.0.0.1), so they belong to the
172
+ // local workspace. Authenticated sessions use the JWT's workspace_id.
173
+ const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
174
+ const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
175
+ const sessionTransport = new StreamableHTTPServerTransport({
176
+ sessionIdGenerator: () => crypto.randomUUID(),
177
+ onsessioninitialized: (sid) => {
178
+ sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId });
179
+ const hasMember = !!(postClaims || fallbackMemberId);
180
+ logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
181
+ // Register interactive member session when JWT claims are present.
182
+ //
183
+ // apra-fleet-eft.28.5: carry forward the launch-time pid captured
184
+ // by register_member (which registered `server: null, pid: <proc>`
185
+ // before this connect-back). Without this, the connect-back
186
+ // registration overwrote that entry with pid=undefined, so the
187
+ // execute_prompt interactive liveness check (eft.28.1) had no PID to
188
+ // test and a dead-but-connected session hung the dispatch for the
189
+ // full timeout_s -- the exact real-fleet repro in eft.28. Preserving
190
+ // the pid lets the liveness check detect the dead backing process
191
+ // and re-dispatch fresh instead of blocking.
192
+ if (postClaims) {
193
+ // apra-fleet-eft.50.1: fall back to the durable launch-pid anchor
194
+ // when the live SessionState was already unregistered before this
195
+ // connect-back (so get()?.pid is undefined). Without this last
196
+ // fallback a reconnect on a dispatch RETRY re-registered with
197
+ // pid=undefined, blinding the interactive liveness check on
198
+ // attempt 2+ and reproducing eft.28's silent hang.
199
+ const priorPid = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id)?.pid
200
+ ?? sessionRegistry.lastKnownPid(postClaims.workspace_id, postClaims.member_id);
201
+ sessionRegistry.register({
202
+ ...postClaims,
203
+ server: sessionServer,
204
+ sessionId: sid,
205
+ status: 'online',
206
+ pid: postClaims.pid ?? priorPid,
207
+ channelCapable,
208
+ });
209
+ logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
210
+ }
211
+ else if (fallbackMemberId) {
212
+ // apra-fleet-eft.50.1: same durable launch-pid fallback as the
213
+ // JWT branch above, so a URL-param reconnect on a retry keeps a
214
+ // pid for the interactive liveness check to test.
215
+ const priorPid = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId)?.pid
216
+ ?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
217
+ sessionRegistry.register({
218
+ member_id: fallbackMemberId,
219
+ workspace_id: sessionWorkspaceId,
220
+ role: 'doer',
221
+ work_folder: fallbackWorkFolder,
222
+ server: sessionServer,
223
+ sessionId: sid,
224
+ status: 'online',
225
+ pid: priorPid,
226
+ channelCapable,
227
+ });
228
+ logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
229
+ }
230
+ },
231
+ onsessionclosed: (sid) => {
232
+ logLine('session', `closed sid=${sid}`);
233
+ // LOW-2: Close the McpServer when its session closes
234
+ const s = sessions.get(sid);
235
+ if (s) {
236
+ s.server.server?.close().catch(() => { });
237
+ }
238
+ sessions.delete(sid);
239
+ // Unregister interactive member session -- but only if the registry
240
+ // entry still points at THIS session. If the member reconnected
241
+ // (new sid) before this stale session's close event fired, the
242
+ // registry now holds the NEW session's sessionId and must not be
243
+ // clobbered by the old one closing late (apra-fleet-2xs.10).
244
+ if (postClaims) {
245
+ const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
246
+ if (current?.sessionId === sid) {
247
+ sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
248
+ logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
249
+ }
250
+ else {
251
+ logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
252
+ }
253
+ }
254
+ else if (fallbackMemberId) {
255
+ const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
256
+ if (current?.sessionId === sid) {
257
+ sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
258
+ logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
259
+ }
260
+ else {
261
+ logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
262
+ }
263
+ }
264
+ },
265
+ });
266
+ await registerTools(sessionServer);
267
+ await sessionServer.connect(sessionTransport);
268
+ await sessionTransport.handleRequest(req, res, parsedBody);
269
+ return;
270
+ }
271
+ const sessionId = req.headers['mcp-session-id'];
272
+ if (!sessionId) {
273
+ res.writeHead(400);
274
+ res.end('Missing mcp-session-id header');
275
+ return;
276
+ }
277
+ const session = sessions.get(sessionId);
278
+ if (!session) {
279
+ res.writeHead(404);
280
+ res.end('Session not found');
281
+ return;
282
+ }
283
+ await session.transport.handleRequest(req, res, parsedBody);
284
+ return;
285
+ }
286
+ // GET and DELETE: look up session and delegate
287
+ if (req.method === 'GET' || req.method === 'DELETE') {
288
+ await handleSessionRequest(req, res);
289
+ return;
290
+ }
291
+ res.writeHead(405);
292
+ res.end('Method not allowed');
293
+ });
294
+ // Subscribe to fleet events and broadcast to connected sessions in the SAME
295
+ // workspace only. All events on this bus originate from the local
296
+ // orchestrator, i.e. from the local workspace -- a session authenticated
297
+ // with a foreign workspace_id must never see them.
298
+ const fleetEventTypes = [
299
+ 'credential:stored',
300
+ 'task:completed',
301
+ 'member:status-changed',
302
+ 'stall:detected',
303
+ ];
304
+ for (const eventType of fleetEventTypes) {
305
+ const handler = (payload) => {
306
+ const data = { event: eventType, ...payload };
307
+ const eventWorkspaceId = localWorkspaceId();
308
+ for (const [, session] of sessions) {
309
+ if (session.workspaceId !== eventWorkspaceId)
310
+ continue;
311
+ session.server.sendLoggingMessage({
312
+ level: 'info',
313
+ logger: 'apra-fleet-events',
314
+ data,
315
+ }).catch(() => { });
316
+ }
317
+ };
318
+ fleetEvents.on(eventType, handler);
319
+ // LOW-1: Store cleanup so close() can unsubscribe
320
+ eventCleanups.push(() => fleetEvents.off(eventType, handler));
321
+ }
322
+ // Start listening: try preferred port, fall back to OS-assigned port.
323
+ // Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
324
+ // apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
325
+ // logged opt-in: several unauthenticated code paths in this file (the
326
+ // ?member= URL-param fallback, /shutdown's admin-key check) were
327
+ // written assuming only same-machine callers can reach this server.
328
+ const targetPort = preferredPort ?? DEFAULT_PORT;
329
+ const bindHost = DEFAULT_HOST;
330
+ if (bindHost !== '127.0.0.1') {
331
+ logLine('session', `WARNING: binding to ${bindHost} (not loopback-only) -- unauthenticated requests (the ?member= URL-param fallback, /shutdown) are now reachable from any host that can route to this address, not just this machine. Set APRA_FLEET_HOST=127.0.0.1 (or unset it) to restore the loopback-only default.`);
332
+ }
333
+ let port;
334
+ try {
335
+ port = await listenOnPort(httpServer, targetPort, bindHost);
336
+ }
337
+ catch (err) {
338
+ if (err.code === 'EADDRINUSE') {
339
+ port = await listenOnPort(httpServer, 0, bindHost);
340
+ }
341
+ else {
342
+ throw err;
343
+ }
344
+ }
345
+ // Same-machine callers (register_member's own local MCP connection) always
346
+ // use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
347
+ // still accepts loopback connections. This is not "the LAN address";
348
+ // fnz.4's enrollment flow is responsible for advertising a reachable
349
+ // LAN/host address to the JOINING machine separately.
350
+ const url = `http://127.0.0.1:${port}/mcp`;
351
+ return {
352
+ httpServer,
353
+ port,
354
+ url,
355
+ sessions,
356
+ close() {
357
+ // LOW-1: Unsubscribe all fleet event listeners
358
+ for (const cleanup of eventCleanups)
359
+ cleanup();
360
+ // LOW-2: Close all active session McpServers before shutting down
361
+ for (const [, session] of sessions) {
362
+ session.server.server?.close().catch(() => { });
363
+ }
364
+ sessions.clear();
365
+ return new Promise((resolve, reject) => {
366
+ httpServer.close((err) => (err ? reject(err) : resolve()));
367
+ });
368
+ },
369
+ };
370
+ }
371
+ //# sourceMappingURL=http-transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-transport.js","sourceRoot":"","sources":["../../src/services/http-transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ export interface MemberSnapshotEntry {
2
+ memberId: string;
3
+ status: string;
4
+ }
5
+ /**
6
+ * Shape actually delivered over the SSE stream: the raw relay_queue row
7
+ * (src/hub-service/relay-queue.ts's RelayEnvelope), NOT the nested
8
+ * from/to envelope shape used on SUBMISSION (POST /ws/:id/envelopes). The
9
+ * hub stores and forwards a flat row -- target_member_id and
10
+ * origin_member_id, not a nested `to`/`from` object -- so this type (and
11
+ * every reader of it) must match that flat shape, not the wire-protocol
12
+ * doc's submission-side JSON example.
13
+ */
14
+ export interface InboundRelayEnvelope {
15
+ envelope_id: string;
16
+ kind: string;
17
+ payload: unknown;
18
+ correlation_id?: string | null;
19
+ target_member_id: string;
20
+ origin_member_id?: string | null;
21
+ }
22
+ export interface HubClientDeps {
23
+ fetch: typeof fetch;
24
+ now(): number;
25
+ setTimeout(fn: () => void, ms: number): unknown;
26
+ clearTimeout(handle: unknown): void;
27
+ random(): number;
28
+ hubUrl: string;
29
+ machineId: string;
30
+ workspaceId: string;
31
+ jwt: string;
32
+ getMemberSnapshot(): MemberSnapshotEntry[];
33
+ onEnvelope(envelope: InboundRelayEnvelope): void | Promise<void>;
34
+ onLog?(message: string): void;
35
+ }
36
+ /** Exponential backoff with full jitter, base 1s / cap 60s
37
+ * (docs/hub-spoke-wire-protocol.md section 2). `attempt` is 0-indexed
38
+ * consecutive failed reconnect attempts since the last successfully
39
+ * processed heartbeat ack. */
40
+ export declare function computeBackoffMs(attempt: number, random: () => number, base?: number, cap?: number): number;
41
+ /**
42
+ * Short-lived seen-envelope_id cache (wire-protocol.md section 5): tier 2
43
+ * must no-op a duplicate at-least-once redelivery rather than re-executing
44
+ * an already-completed request.
45
+ */
46
+ export declare class SeenEnvelopeCache {
47
+ private ttlMs;
48
+ private now;
49
+ private seen;
50
+ constructor(ttlMs: number, now: () => number);
51
+ hasSeen(envelopeId: string): boolean;
52
+ markSeen(envelopeId: string): void;
53
+ private evict;
54
+ }
55
+ /**
56
+ * Incremental SSE `data:`-frame parser. Frames are separated by a blank
57
+ * line per the SSE spec; a frame with no `data:` line (e.g. a bare
58
+ * keep-alive comment) yields nothing. Malformed JSON in a data frame is
59
+ * skipped, not thrown -- a single corrupt frame must not kill the stream.
60
+ */
61
+ export declare class SseFrameParser {
62
+ private buffer;
63
+ push(chunk: string): unknown[];
64
+ }
65
+ export interface HubClientHandle {
66
+ stop(): void;
67
+ }
68
+ export declare function createHubClient(deps: HubClientDeps): HubClientHandle;
69
+ //# sourceMappingURL=hub-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-client.d.ts","sourceRoot":"","sources":["../../src/services/hub-client.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,MAAM,IAAI,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;IAC3C,UAAU,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAOD;;;+BAG+B;AAC/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,IAAI,SAAkB,EAAE,GAAG,SAAiB,GAAG,MAAM,CAG5H;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,GAAG;IAF9C,OAAO,CAAC,IAAI,CAA6B;gBAErB,KAAK,EAAE,MAAM,EAAU,GAAG,EAAE,MAAM,MAAM;IAE5D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,KAAK;CAMd;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;CAiB/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAsIpE"}