@desplega.ai/agent-swarm 2.10.0 → 2.11.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 (378) hide show
  1. package/dist/acp-adapter-weaaxey3.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-5wyy2b9m.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-4nxq386s.js} +24 -23
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-v6enh76w.js} +4 -4
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-ze3x22qn.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-kyqt8ehw.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-a0db0esw.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-9g5jzq25.js} +26 -25
  10. package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
  11. package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-d7fme4q1.js} +1 -1
  12. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-6wpazmpw.js} +1 -1
  13. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-jrwxeye2.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-52h7yntp.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-kb3dxjex.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-jrrmkv3w.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-0c0y8fqp.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-w2es07qq.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-9ssb7ct4.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-p6t0gyse.js} +10941 -10412
  21. package/dist/{cli-p0n7b5rz.js → cli-075ccjh6.js} +344 -130
  22. package/dist/{cli-3caf7pmg.js → cli-0bgj4rh5.js} +3 -3
  23. package/dist/{cli-7r162fxe.js → cli-14xdms9a.js} +23 -17
  24. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  25. package/dist/{cli-y4ccxtz5.js → cli-1h4njv9y.js} +144 -6
  26. package/dist/{cli-6ym4jhzp.js → cli-27fat7st.js} +7 -7
  27. package/dist/{cli-k3q2va86.js → cli-2aacfdcn.js} +5 -5
  28. package/dist/{cli-vq2eg24x.js → cli-2gvdvsxj.js} +3 -3
  29. package/dist/{cli-sb4426be.js → cli-2jtfm8kh.js} +5 -5
  30. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  31. package/dist/{cli-6237rnyr.js → cli-3bpr3wks.js} +1 -1
  32. package/dist/{cli-5qhfv9rw.js → cli-453497a0.js} +44 -17
  33. package/dist/{cli-2rnd5j3t.js → cli-4aswccje.js} +2 -2
  34. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  35. package/dist/{cli-p0c3vtch.js → cli-4g323fjh.js} +772 -515
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-fcfbct2j.js → cli-4kzp7r0q.js} +5 -5
  38. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  39. package/dist/{cli-zeh2mhkg.js → cli-5ptj757f.js} +1 -1
  40. package/dist/{cli-539h29es.js → cli-6a3j25xd.js} +224 -189
  41. package/dist/{cli-hnamkvnc.js → cli-6c9ve77f.js} +2 -2
  42. package/dist/{cli-3et6fmfe.js → cli-6n7y5ypy.js} +1 -1
  43. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  44. package/dist/{cli-zk7v5s89.js → cli-6tvh1fwq.js} +3 -3
  45. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  46. package/dist/{cli-5a6pqy45.js → cli-7e8sxqv5.js} +1 -1
  47. package/dist/{cli-6037prsx.js → cli-892y3vfp.js} +13 -13
  48. package/dist/cli-8mfdbdhe.js +43 -0
  49. package/dist/{cli-s1zqk1aj.js → cli-8zmpwe79.js} +15 -9
  50. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  51. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  52. package/dist/{cli-7mv4h3sn.js → cli-9g12h1aq.js} +2 -2
  53. package/dist/{cli-aw83sr40.js → cli-9knhkkgr.js} +3 -3
  54. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  55. package/dist/{cli-qj39vrc6.js → cli-9yjhshah.js} +1 -1
  56. package/dist/{cli-6cwr32fe.js → cli-a02habn6.js} +422 -140
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3f8zbtqa.js → cli-a6q6x15h.js} +9 -8
  59. package/dist/{cli-j6te8keb.js → cli-atm0hkes.js} +8 -8
  60. package/dist/{cli-9fjr27ez.js → cli-b82a13ga.js} +13 -13
  61. package/dist/{cli-7zm3b3f5.js → cli-bf0t77nf.js} +1 -1
  62. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  63. package/dist/{cli-mk7c5ac4.js → cli-bq97k63w.js} +2 -2
  64. package/dist/{cli-vfqvrd82.js → cli-cstggwq7.js} +2 -2
  65. package/dist/{cli-md50mj0r.js → cli-czvvnfr9.js} +3 -3
  66. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  67. package/dist/{cli-fq2rr3jb.js → cli-djt6wmrc.js} +6 -6
  68. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  69. package/dist/{cli-z0m452jr.js → cli-f7dhm7hh.js} +1 -1
  70. package/dist/{cli-mys27d03.js → cli-f8yhybxr.js} +3 -3
  71. package/dist/{cli-5gpqgs8b.js → cli-fwjwkw66.js} +2 -2
  72. package/dist/{cli-gabsjg8x.js → cli-g56fxddf.js} +1 -1
  73. package/dist/{cli-y8p78ekx.js → cli-h2qtafm4.js} +18 -18
  74. package/dist/{cli-psffsanb.js → cli-ha4ek2nb.js} +6 -1
  75. package/dist/{cli-th1dkc2v.js → cli-hnh8erra.js} +2 -2
  76. package/dist/{cli-w16kwbzw.js → cli-htymm48w.js} +1 -1
  77. package/dist/{cli-124ntmf0.js → cli-j2r1apqm.js} +138 -59
  78. package/dist/{cli-43ms35q9.js → cli-k3c13za2.js} +3 -3
  79. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  80. package/dist/{cli-v8z0yga9.js → cli-k4r5sfaj.js} +4 -4
  81. package/dist/{cli-91pkxres.js → cli-kbm659dk.js} +2 -2
  82. package/dist/{cli-q5srsxq2.js → cli-m00c47q6.js} +110 -27
  83. package/dist/{cli-3aaeb78m.js → cli-mhrr4d5b.js} +95 -10
  84. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  85. package/dist/{cli-qrta34nb.js → cli-n6ygvrrm.js} +4 -4
  86. package/dist/{cli-k5yewqgd.js → cli-nbakg5xh.js} +3 -3
  87. package/dist/{cli-nstkanmx.js → cli-nc39ym5q.js} +8 -8
  88. package/dist/{cli-01k6wpr9.js → cli-p1a4khta.js} +7 -7
  89. package/dist/{cli-t9ga4qmb.js → cli-p8zqbbt1.js} +40 -33
  90. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  91. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  92. package/dist/{cli-kbtzfrxj.js → cli-q71g5q39.js} +3 -3
  93. package/dist/{cli-vs9vdpy0.js → cli-qncx2r0s.js} +1 -1
  94. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  95. package/dist/{cli-x40a0w9j.js → cli-r813c7rb.js} +1 -1
  96. package/dist/{cli-kpgcm7xy.js → cli-ramn8jae.js} +1 -1
  97. package/dist/{cli-cc93xzes.js → cli-raqw9fw9.js} +28 -17
  98. package/dist/cli-rhsc2zyx.js +68 -0
  99. package/dist/{cli-8st34zhr.js → cli-rpmw4fsv.js} +57 -19
  100. package/dist/{cli-had1p04a.js → cli-rwgwen5v.js} +4 -4
  101. package/dist/{cli-tr27kwyg.js → cli-rytq7dm2.js} +261 -6
  102. package/dist/{cli-s1khw52h.js → cli-s9twe4x0.js} +66 -17
  103. package/dist/{cli-2v2zdm0a.js → cli-t2s7j5cy.js} +2 -2
  104. package/dist/{cli-nv4xsvmk.js → cli-tb4j757d.js} +7 -7
  105. package/dist/{cli-q2d3e1k1.js → cli-thd3005a.js} +1 -1
  106. package/dist/cli-tsfkcd4v.js +30 -0
  107. package/dist/{cli-jrbq4djp.js → cli-v3zcnr8g.js} +1 -1
  108. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  109. package/dist/{cli-qx4f057j.js → cli-vy3fn0mz.js} +4 -4
  110. package/dist/{cli-7sf9sb0w.js → cli-w5dar1bk.js} +1 -1
  111. package/dist/{cli-w1q68d8x.js → cli-wz4e5am2.js} +9 -9
  112. package/dist/{cli-m9cvf7vs.js → cli-xqbqwpxr.js} +14 -14
  113. package/dist/{cli-2spnz7ye.js → cli-ynph3b70.js} +11137 -8332
  114. package/dist/{cli-43evxwj4.js → cli-yvzxbztc.js} +9 -4
  115. package/dist/{cli-vsw91x06.js → cli-yzxqwcvq.js} +3 -6
  116. package/dist/{cli-wafmk3fn.js → cli-zb1hff00.js} +12 -12
  117. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  118. package/dist/{cli-wwp1bd3n.js → cli-zhn4r1rz.js} +519 -75
  119. package/dist/{cli-tvgqesec.js → cli-zqq57pgx.js} +4 -4
  120. package/dist/cli.js +28 -27
  121. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  122. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-ssahg4h4.js} +8 -8
  123. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  124. package/dist/{codex-login-a239g1ah.js → codex-login-9c7aggxe.js} +1 -1
  125. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-xn63q3h7.js} +9 -9
  126. package/dist/{commands-d8g349v4.js → commands-ctey7tr5.js} +3 -3
  127. package/dist/{controller-mwgdmb8y.js → controller-rqhbppg9.js} +4 -4
  128. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-w3qbpbt1.js} +22 -21
  129. package/dist/{core-sxy4epp2.js → core-df1n049h.js} +19 -18
  130. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-r819hf1a.js} +2 -2
  131. package/dist/{db-wcw0b2j8.js → db-2ah39cyx.js} +2 -2
  132. package/dist/{db-qpganbeb.js → db-p5drc1d1.js} +3 -3
  133. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-bc6g0x29.js} +1 -1
  134. package/dist/{dispatcher-8d8s49yz.js → dispatcher-x6w14pde.js} +19 -18
  135. package/dist/{docker-09tkkg0n.js → docker-6c4reetq.js} +51 -14
  136. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-h8qn14n4.js} +2 -2
  137. package/dist/{e2b-sm28k0k3.js → e2b-jg7kyyef.js} +6 -6
  138. package/dist/{e2b-3v1e745x.js → e2b-z4ec0qve.js} +3 -3
  139. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-1y6r9gxy.js} +1 -1
  140. package/dist/{embedding-space-e48xchqa.js → embedding-space-z6ptw3jk.js} +6 -6
  141. package/dist/{embeddings-tgq2afbq.js → embeddings-0sxb1d2h.js} +1 -1
  142. package/dist/{event-bus-xr83x566.js → event-bus-swr88jg5.js} +1 -1
  143. package/dist/{execute-8rhwrk7f.js → execute-6m1ex8ce.js} +8 -4
  144. package/dist/{external-channel-8bt3j2pm.js → external-channel-ezer7pk0.js} +2 -2
  145. package/dist/fx-adapter-zwmps9re.js +19 -0
  146. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  147. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  148. package/dist/grok-adapter-q0avf919.js +19 -0
  149. package/dist/handlers-g5jq0e4q.js +36 -0
  150. package/dist/{heartbeat-x0056ra5.js → heartbeat-6c4fr49t.js} +22 -21
  151. package/dist/{hook-mrd2ayxv.js → hook-02rt5tvq.js} +8 -8
  152. package/dist/{hook-a7vmn2st.js → hook-t1c5avbv.js} +5 -5
  153. package/dist/{http-ym9c5svp.js → http-qa3h32a1.js} +2049 -148
  154. package/dist/index-1f6m47mq.js +37 -0
  155. package/dist/index-1p1mpqda.js +36 -0
  156. package/dist/{index-p46tvwtx.js → index-akbgsdhh.js} +25 -24
  157. package/dist/{index-ny60jcat.js → index-e42j998x.js} +16 -13
  158. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  159. package/dist/{index-01ns1pkw.js → index-kqv9ebfj.js} +1 -1
  160. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  161. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  162. package/dist/{index-x6azjwm8.js → index-qpjk2hxk.js} +1 -1
  163. package/dist/index-tnkd410q.js +41 -0
  164. package/dist/{k8s-m56sw868.js → k8s-7jrh5va2.js} +73 -14
  165. package/dist/{keepalive-7yxg8z4c.js → keepalive-jmf6pn8c.js} +4 -4
  166. package/dist/lead-m5e7xt93.js +75 -0
  167. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  168. package/dist/{maintenance-6tefxmk1.js → maintenance-g7v15tj1.js} +1 -1
  169. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  170. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  171. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-ywgf8tbr.js} +3 -3
  172. package/dist/{onboard-fja65z08.js → onboard-m3fedypq.js} +3 -3
  173. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  174. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  175. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  176. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  177. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-19ktcbb9.js} +7 -7
  178. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  179. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-3ehm1hgc.js} +2 -2
  180. package/dist/{pending-h01yzpx4.js → pending-fwj2fatd.js} +20 -19
  181. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  182. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-xdeesvc4.js} +18 -17
  183. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-4j8dzvxg.js} +2 -2
  184. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-8msjr07m.js} +3 -3
  185. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-n7t2acv8.js} +2 -2
  186. package/dist/{render-v2-1rgspxzf.js → render-v2-j7qggj8h.js} +7 -6
  187. package/dist/{resume-tqy61x24.js → resume-hj1mn65y.js} +9 -8
  188. package/dist/{runtime-exkxyx5f.js → runtime-z31mdsgv.js} +2 -2
  189. package/dist/{session-access-3act7vt4.js → session-access-w38fh09a.js} +4 -4
  190. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-ax6qxv20.js} +3 -3
  191. package/dist/{setup-ry1vfdef.js → setup-dsqmpfcr.js} +1 -1
  192. package/dist/thread-buffer-nf55vwx3.js +39 -0
  193. package/dist/tree-visibility-6vqmnr71.js +24 -0
  194. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  195. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-mvheb3ed.js} +3 -3
  196. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-w2qk2wew.js} +32 -10
  197. package/dist/{work-objects-z2e5tv03.js → work-objects-4ahy5es5.js} +22 -21
  198. package/dist/worker-ews1nyhw.js +75 -0
  199. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-1gs4aw7y.js} +19 -18
  200. package/dist/{x-wg164ss9.js → x-3wr8c5sh.js} +2 -2
  201. package/openapi.json +995 -49
  202. package/package.json +9 -8
  203. package/src/be/db/request-composition.ts +190 -0
  204. package/src/be/db/runtime.ts +15 -0
  205. package/src/be/db/slack-trees.ts +220 -10
  206. package/src/be/db/tasks/human-free.ts +3 -2
  207. package/src/be/db/workflow-run-retention.ts +101 -0
  208. package/src/be/db-client.ts +23 -1
  209. package/src/be/db-retention-defaults.ts +46 -0
  210. package/src/be/db-retention.ts +55 -6
  211. package/src/be/mcp-events/catalog.ts +108 -0
  212. package/src/be/mcp-events/dispatcher.ts +202 -0
  213. package/src/be/mcp-events/protocol.ts +296 -0
  214. package/src/be/mcp-events/store.ts +231 -0
  215. package/src/be/mcp-events/webhook.ts +226 -0
  216. package/src/be/memory/providers/sqlite-store.ts +110 -24
  217. package/src/be/memory/review-recall-filter.ts +22 -0
  218. package/src/be/memory/search-candidates.ts +5 -7
  219. package/src/be/memory/types.ts +5 -0
  220. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  221. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  222. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  223. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  224. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  225. package/src/be/migrations/330_request_composition.sql +22 -0
  226. package/src/be/model-profile-check.ts +1 -1
  227. package/src/be/multi-runtime.ts +32 -4
  228. package/src/be/runtime-pools/controllers.ts +18 -3
  229. package/src/be/runtime-pools/db.ts +15 -4
  230. package/src/be/runtime-pools/supervisor.ts +42 -2
  231. package/src/be/swarm-config-guard.ts +10 -2
  232. package/src/commands/context-preamble.ts +11 -4
  233. package/src/commands/credential-outcome-report.ts +33 -9
  234. package/src/commands/e2b-stack-wizard.tsx +12 -6
  235. package/src/commands/runner.ts +116 -12
  236. package/src/extensions/catalog.generated.json +1 -1
  237. package/src/github/app.ts +59 -14
  238. package/src/http/all-routes.ts +2 -0
  239. package/src/http/config.ts +2 -1
  240. package/src/http/core.ts +2 -0
  241. package/src/http/github-token.ts +66 -0
  242. package/src/http/index.ts +21 -0
  243. package/src/http/mcp-user.ts +11 -8
  244. package/src/http/mcp.ts +58 -42
  245. package/src/http/prompt-templates.ts +1 -0
  246. package/src/http/request-composition.ts +310 -0
  247. package/src/http/tasks.ts +6 -1
  248. package/src/http/tool-schema-estimate.ts +95 -0
  249. package/src/http/workflows.ts +29 -11
  250. package/src/integrations/chat-sdk/inbound.ts +2 -2
  251. package/src/prompts/base-prompt.ts +133 -7
  252. package/src/prompts/resolver.ts +41 -2
  253. package/src/providers/amp-adapter.ts +1 -1
  254. package/src/providers/opencode-adapter.ts +72 -1
  255. package/src/providers/opencode-swarm-plugin.ts +22 -3
  256. package/src/providers/pi-mono-adapter.ts +1 -0
  257. package/src/providers/pi-mono-extension.ts +71 -0
  258. package/src/providers/pricing-sources.md +4 -0
  259. package/src/providers/request-composition-hook.ts +312 -0
  260. package/src/providers/types.ts +5 -0
  261. package/src/runtime-providers/controller-protocol.ts +7 -0
  262. package/src/runtime-providers/docker.ts +80 -12
  263. package/src/runtime-providers/k8s.ts +111 -6
  264. package/src/runtime-providers/types.ts +17 -0
  265. package/src/scheduler/scheduler.ts +1 -1
  266. package/src/server-user.ts +16 -1
  267. package/src/slack/ack.ts +10 -5
  268. package/src/slack/actions.ts +3 -3
  269. package/src/slack/app.ts +2 -0
  270. package/src/slack/assistant.ts +4 -4
  271. package/src/slack/blocks.ts +3 -3
  272. package/src/slack/handlers.ts +3 -3
  273. package/src/slack/reaction-shortcode.ts +23 -2
  274. package/src/slack/render-v2.ts +297 -200
  275. package/src/slack/responses.ts +7 -5
  276. package/src/slack/thread-buffer.ts +3 -3
  277. package/src/slack/tree-visibility.ts +64 -0
  278. package/src/tasks/worker-follow-up.ts +127 -17
  279. package/src/tests/azure-devops-outbound.test.ts +47 -14
  280. package/src/tests/base-prompt.test.ts +149 -1
  281. package/src/tests/check-playwright-version.test.ts +33 -0
  282. package/src/tests/context-preamble-budget.test.ts +65 -0
  283. package/src/tests/credential-outcome-report.test.ts +81 -1
  284. package/src/tests/db-client.test.ts +22 -0
  285. package/src/tests/db-retention-defaults.test.ts +244 -0
  286. package/src/tests/db-retention.test.ts +2 -1
  287. package/src/tests/db-runtime.test.ts +2 -1
  288. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  289. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  290. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  291. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  292. package/src/tests/env-flag.test.ts +4 -2
  293. package/src/tests/event-loop-lag.test.ts +12 -18
  294. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  295. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  296. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  297. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  298. package/src/tests/github-installation-token-route.test.ts +199 -0
  299. package/src/tests/mcp-user-events.test.ts +708 -0
  300. package/src/tests/memory-key-paths.test.ts +4 -1
  301. package/src/tests/memory-search-stall.test.ts +421 -0
  302. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  303. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  304. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  305. package/src/tests/opencode-adapter.test.ts +86 -0
  306. package/src/tests/pi-mono-extension.test.ts +168 -0
  307. package/src/tests/preload-env.test.ts +61 -1
  308. package/src/tests/preload.ts +22 -0
  309. package/src/tests/prompt-template-resolver.test.ts +85 -0
  310. package/src/tests/reload-config.test.ts +45 -0
  311. package/src/tests/request-composition.test.ts +447 -0
  312. package/src/tests/runner-max-concurrent.test.ts +86 -0
  313. package/src/tests/runtime-pools-db.test.ts +80 -0
  314. package/src/tests/runtime-provider-registration.test.ts +8 -0
  315. package/src/tests/runtime-providers-docker.test.ts +192 -1
  316. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  317. package/src/tests/runtime-remote-controller.test.ts +64 -1
  318. package/src/tests/runtime-supervisor.test.ts +101 -0
  319. package/src/tests/script-connections.test.ts +8 -0
  320. package/src/tests/slack-blocks.test.ts +18 -0
  321. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  322. package/src/tests/slack-reaction-config.test.ts +38 -2
  323. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  324. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  325. package/src/tests/slack-render-v2.test.ts +683 -11
  326. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  327. package/src/tests/task-session-prompts.test.ts +37 -0
  328. package/src/tests/user-delete-perf.test.ts +36 -9
  329. package/src/tests/webhook-filter.test.ts +327 -0
  330. package/src/tests/workflow-async-v2.test.ts +19 -16
  331. package/src/tests/workflow-definition-telemetry.test.ts +15 -5
  332. package/src/tests/workflow-e2e.test.ts +1 -9
  333. package/src/tests/workflow-finalization-races.test.ts +553 -0
  334. package/src/tests/workflow-foreach.test.ts +2 -0
  335. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  336. package/src/tests/workflow-http-v2.test.ts +105 -2
  337. package/src/tests/workflow-idempotency.test.ts +41 -0
  338. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  339. package/src/tests/workflow-parallel-park.test.ts +297 -0
  340. package/src/tests/workflow-retry-v2.test.ts +57 -21
  341. package/src/tests/workflow-retry-validation.test.ts +13 -13
  342. package/src/tests/workflow-runs-retention.test.ts +533 -0
  343. package/src/tests/workflow-script-principal.test.ts +7 -2
  344. package/src/tests/workflow-tla-races.test.ts +7 -2
  345. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  346. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  347. package/src/tests/workflow-wait-event.test.ts +28 -2
  348. package/src/tests/workflow-wait-poller.test.ts +94 -0
  349. package/src/tests/workflow-wait-time.test.ts +7 -3
  350. package/src/tests/workflow-wait.test.ts +26 -0
  351. package/src/tests/workflow-wait.ts +44 -0
  352. package/src/tools/workflows/create-workflow.ts +7 -3
  353. package/src/tools/workflows/update-workflow.ts +7 -3
  354. package/src/types.ts +200 -2
  355. package/src/utils/credentials.ts +7 -0
  356. package/src/workflows/checkpoint.ts +18 -0
  357. package/src/workflows/engine.ts +38 -10
  358. package/src/workflows/foreach-driver.ts +42 -4
  359. package/src/workflows/recovery.ts +6 -1
  360. package/src/workflows/resume.ts +11 -3
  361. package/src/workflows/retry-poller.ts +17 -4
  362. package/src/workflows/successor-routing.ts +108 -0
  363. package/src/workflows/task-step-routing.ts +5 -2
  364. package/src/workflows/triggers.ts +21 -36
  365. package/src/workflows/wait-poller.ts +6 -2
  366. package/src/workflows/webhook-filter.ts +203 -0
  367. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  368. package/templates/skills/swarm-docs/content.md +2 -0
  369. package/dist/acp-adapter-bht22g3k.js +0 -16
  370. package/dist/fx-adapter-adtdb3jb.js +0 -19
  371. package/dist/grok-adapter-accnn9km.js +0 -19
  372. package/dist/handlers-1x77561e.js +0 -35
  373. package/dist/index-48qzcqzj.js +0 -35
  374. package/dist/index-rkvaambe.js +0 -36
  375. package/dist/index-xj1mq27m.js +0 -40
  376. package/dist/lead-enzn86bz.js +0 -74
  377. package/dist/thread-buffer-3x93yexa.js +0 -38
  378. package/dist/worker-zfcv2wbf.js +0 -74
@@ -118,6 +118,14 @@ export interface DbClient extends DbExecutor {
118
118
  * rejection is contained and logged, never an unhandled rejection.
119
119
  */
120
120
  afterCommit(fn: () => void | Promise<void>): void;
121
+ /**
122
+ * Run `fn` synchronously if the currently-open outermost transaction rolls
123
+ * back, including a COMMIT that fails; dropped on commit. With no
124
+ * transaction open it does nothing. For undoing process-local state taken
125
+ * inside the transaction. A hook registered inside a savepoint that rolls
126
+ * back runs only if the outer transaction rolls back too.
127
+ */
128
+ afterRollback(fn: () => void): void;
121
129
  }
122
130
 
123
131
  const LOCK_WATCHDOG_MS = 30_000;
@@ -166,6 +174,8 @@ type TxContext = {
166
174
  closed: boolean;
167
175
  /** Hooks to run after COMMIT; dropped on ROLLBACK. */
168
176
  afterCommit: (() => void | Promise<void>)[];
177
+ /** Hooks to run after ROLLBACK; dropped on COMMIT. */
178
+ afterRollback: (() => void)[];
169
179
  };
170
180
 
171
181
  const txContext = new AsyncLocalStorage<TxContext>();
@@ -496,7 +506,7 @@ class BunSqliteClient implements DbClient {
496
506
  deadlineAt?: number,
497
507
  ): Promise<{ ok: true; value: T } | { ok: false; busyBegin: unknown }> {
498
508
  const release = await this.lock.acquire();
499
- const ctx: TxContext = { closed: false, afterCommit: [] };
509
+ const ctx: TxContext = { closed: false, afterCommit: [], afterRollback: [] };
500
510
  let began = false;
501
511
  try {
502
512
  const db = this.getDatabase();
@@ -544,6 +554,13 @@ class BunSqliteClient implements DbClient {
544
554
  } catch {
545
555
  // Connection-level failure while rolling back; surface the original error.
546
556
  }
557
+ for (const hook of ctx.afterRollback) {
558
+ try {
559
+ hook();
560
+ } catch (hookErr) {
561
+ console.error("[db-client] afterRollback hook threw:", hookErr);
562
+ }
563
+ }
547
564
  }
548
565
  throw err;
549
566
  } finally {
@@ -562,6 +579,11 @@ class BunSqliteClient implements DbClient {
562
579
  this.scheduleHook(fn);
563
580
  }
564
581
 
582
+ afterRollback(fn: () => void): void {
583
+ const ctx = txContext.getStore();
584
+ if (ctx && !ctx.closed) ctx.afterRollback.push(fn);
585
+ }
586
+
565
587
  private scheduleHook(fn: () => void | Promise<void>): void {
566
588
  // Queueing behind the FIFO lock keeps hooks ordered after already-queued
567
589
  // operations. The hook runs outside the lock so its own client calls
@@ -0,0 +1,46 @@
1
+ import { getDbClient, getSwarmConfigs, upsertSwarmConfig } from "./db";
2
+ import { wasDbCreatedThisBoot } from "./db/runtime";
3
+ import { DB_RETENTION_TABLES } from "./db-retention";
4
+
5
+ /**
6
+ * New-install seed: store each table's `newInstallDefault` as a global
7
+ * swarm_config row, so retention is on from the first boot and the operator
8
+ * sees and edits the values like any other stored setting.
9
+ *
10
+ * Only the boot that creates the database writes rows. An upgraded install
11
+ * keeps retention exactly as it was, and a row the operator deletes is never
12
+ * written again. A key present in the deployment env, even empty, is left to the env
13
+ * (a stored row would override it), and so is a key that already has a row.
14
+ *
15
+ * Call before `loadGlobalConfigsIntoEnv`, while `process.env` still holds the
16
+ * deployment values and so that the load injects the new rows.
17
+ */
18
+ export async function seedDbRetentionDefaults(
19
+ isNewInstall: boolean = wasDbCreatedThisBoot(),
20
+ ): Promise<string[]> {
21
+ if (!isNewInstall) return [];
22
+ const seeded: string[] = [];
23
+ // One transaction: a failure must not leave a partial set that no later boot completes.
24
+ await getDbClient().transaction(async () => {
25
+ for (const table of DB_RETENTION_TABLES) {
26
+ // Presence, not truthiness: an empty or blank env value is the operator's
27
+ // explicit "off" and must not be replaced by a deleting default.
28
+ if (!("newInstallDefault" in table) || process.env[table.envKey] !== undefined) continue;
29
+ const existing = await getSwarmConfigs({ scope: "global", key: table.envKey });
30
+ if (existing.length > 0) continue;
31
+ await upsertSwarmConfig({
32
+ scope: "global",
33
+ key: table.envKey,
34
+ value: String(table.newInstallDefault),
35
+ description: `New-install default: ${table.table} retention. Rows past it are permanently deleted. Delete this entry to turn the sweep off.`,
36
+ });
37
+ seeded.push(`${table.envKey}=${table.newInstallDefault}`);
38
+ }
39
+ });
40
+ if (seeded.length > 0) {
41
+ console.log(
42
+ `[startup] New database: stored default retention (${seeded.join(", ")}). Rows past these limits are permanently deleted; change or delete each key in Settings → Configuration.`,
43
+ );
44
+ }
45
+ return seeded;
46
+ }
@@ -5,6 +5,11 @@ import { TERMINAL_SCRIPT_RUN_STATUSES } from "../types";
5
5
  import { isEnvFlagEnabled } from "../utils/env-flag";
6
6
  import { scrubSecrets } from "../utils/secret-scrubber";
7
7
  import { getDbClient } from "./db";
8
+ import {
9
+ deleteWorkflowRunRetentionBatch,
10
+ workflowRunRetentionStatements,
11
+ } from "./db/workflow-run-retention";
12
+ import { DbTransactionDeadlineError } from "./db-client";
8
13
  import { DB_RETENTION_TUNING_BOUNDS, MAX_DB_RETENTION_DAYS } from "./swarm-config-guard";
9
14
 
10
15
  const DAY_MS = 24 * 60 * 60 * 1000;
@@ -22,7 +27,7 @@ const YIELD_MS = 25;
22
27
  * from operator configuration: a retention policy must never target a table
23
28
  * that code review has not explicitly approved as safe to delete from.
24
29
  *
25
- * Two policies exist:
30
+ * Three policies exist:
26
31
  * - `age`: the env value is a number of days; rows whose `timeColumn` is older
27
32
  * than that horizon are deleted. Optional narrowing: `terminalStatuses`
28
33
  * deletes only rows whose `statusColumn` is in that list, `keepWhenSet`
@@ -32,6 +37,8 @@ const YIELD_MS = 25;
32
37
  * - `keepLatest`: the env value is a count; within each `partitionBy` group,
33
38
  * only the newest `rankBy` rows are kept. The newest row of a group is
34
39
  * never deleted, because the smallest accepted count is 1.
40
+ * - `workflowRuns`: days since completion, with parent/child protection and
41
+ * transactional dependency cleanup in db/workflow-run-retention.ts.
35
42
  */
36
43
  export const DB_RETENTION_TABLES = [
37
44
  {
@@ -39,6 +46,7 @@ export const DB_RETENTION_TABLES = [
39
46
  policy: "age",
40
47
  timeColumn: "createdAt",
41
48
  envKey: "SESSION_LOG_RETENTION_DAYS",
49
+ newInstallDefault: 30,
42
50
  metricsKey: "sessionLogs",
43
51
  },
44
52
  {
@@ -46,6 +54,7 @@ export const DB_RETENTION_TABLES = [
46
54
  policy: "age",
47
55
  timeColumn: "createdAt",
48
56
  envKey: "AGENT_LOG_RETENTION_DAYS",
57
+ newInstallDefault: 90,
49
58
  metricsKey: "agentLog",
50
59
  },
51
60
  {
@@ -53,6 +62,7 @@ export const DB_RETENTION_TABLES = [
53
62
  policy: "age",
54
63
  timeColumn: "createdAt",
55
64
  envKey: "EVENTS_RETENTION_DAYS",
65
+ newInstallDefault: 90,
56
66
  metricsKey: "events",
57
67
  },
58
68
  {
@@ -66,6 +76,7 @@ export const DB_RETENTION_TABLES = [
66
76
  partitionBy: "agentId, field",
67
77
  rankBy: "version",
68
78
  envKey: "CONTEXT_VERSIONS_KEEP_LATEST",
79
+ newInstallDefault: 100,
69
80
  metricsKey: "contextVersions",
70
81
  initialBatchSize: 50,
71
82
  maxBatchSize: 100,
@@ -89,16 +100,29 @@ export const DB_RETENTION_TABLES = [
89
100
  terminalStatuses: TERMINAL_SCRIPT_RUN_STATUSES,
90
101
  keepWhenSet: "idempotencyKey",
91
102
  envKey: "SCRIPT_RUNS_RETENTION_DAYS",
103
+ newInstallDefault: 30,
92
104
  metricsKey: "scriptRuns",
93
105
  initialBatchSize: 100,
94
106
  maxBatchSize: 500,
95
107
  },
108
+ {
109
+ table: "workflow_runs",
110
+ policy: "workflowRuns",
111
+ envKey: "WORKFLOW_RUNS_RETENTION_DAYS",
112
+ metricsKey: "workflowRuns",
113
+ initialBatchSize: 10,
114
+ minBatchSize: 1,
115
+ maxBatchSize: 100,
116
+ },
96
117
  ] as const satisfies ReadonlyArray<
97
118
  {
98
119
  table: string;
99
120
  envKey: string;
121
+ /** Stored once as a global config row when the database is created; see db-retention-defaults.ts. */
122
+ newInstallDefault?: number;
100
123
  metricsKey: string;
101
124
  initialBatchSize?: number;
125
+ minBatchSize?: number;
102
126
  maxBatchSize?: number;
103
127
  } & (
104
128
  | {
@@ -110,6 +134,7 @@ export const DB_RETENTION_TABLES = [
110
134
  keepWhenSet?: string;
111
135
  }
112
136
  | { policy: "keepLatest"; partitionBy: string; rankBy: string }
137
+ | { policy: "workflowRuns" }
113
138
  )
114
139
  >;
115
140
 
@@ -348,6 +373,10 @@ type SweepStatements = {
348
373
  };
349
374
 
350
375
  export function sweepStatements(table: RetentionTable, value: number, now: Date): SweepStatements {
376
+ if (table.policy === "workflowRuns") {
377
+ const iso = new Date(now.getTime() - value * DAY_MS).toISOString();
378
+ return workflowRunRetentionStatements(`${iso.slice(0, 10)} ${iso.slice(11, 19)}`);
379
+ }
351
380
  if (table.policy === "keepLatest") {
352
381
  // ROW_NUMBER over the (partition, rank DESC) index: rank 1 is the newest
353
382
  // row of its group. The DELETE removes the deepest history first, so an
@@ -429,13 +458,31 @@ async function sweepTable(
429
458
  let slowestStatementMs = 0;
430
459
  let size = batchSizeByTable[table.metricsKey] ?? initialBatchSize(table);
431
460
  const ceiling = maxBatchSize(table);
461
+ const floor = "minBatchSize" in table ? table.minBatchSize : MIN_BATCH_SIZE;
432
462
 
433
463
  try {
434
464
  while (!signal.aborted && Date.now() < deadline) {
435
465
  const limitUsed = size;
436
- // Never wrap multiple batches in a transaction: one autocommit DELETE per
437
- // batch, so the write lock and any event-loop stall end with each statement.
438
- const result = await client.runTimed(statements.deleteSql, [...statements.params, limitUsed]);
466
+ // Release the write lock between batches. Workflow runs need a single
467
+ // transaction per batch to unlink tasks and reclaim their definitions.
468
+ let result: { changes: number; executionMs: number };
469
+ try {
470
+ result =
471
+ table.policy === "workflowRuns"
472
+ ? await deleteWorkflowRunRetentionBatch(
473
+ String(statements.params[0]),
474
+ limitUsed,
475
+ deadline,
476
+ )
477
+ : await client.runTimed(statements.deleteSql, [...statements.params, limitUsed]);
478
+ } catch (err) {
479
+ if (table.policy !== "workflowRuns" || !(err instanceof DbTransactionDeadlineError))
480
+ throw err;
481
+ // The entire batch rolled back. Retry smaller on the next pass/tick;
482
+ // reaching the budget is not a database failure.
483
+ size = Math.max(floor, Math.floor(size / 2));
484
+ break;
485
+ }
439
486
  // Execution time only. Wall time around the call also covers waiting for
440
487
  // the client's FIFO lock and its BUSY backoff sleeps, neither of which
441
488
  // this statement spent in the driver: charging those to the stall metric
@@ -448,7 +495,7 @@ async function sweepTable(
448
495
  batches += 1;
449
496
 
450
497
  if (elapsed > maxStatementMs) {
451
- size = Math.max(MIN_BATCH_SIZE, Math.floor(size / 2));
498
+ size = Math.max(floor, Math.floor(size / 2));
452
499
  } else if (elapsed < maxStatementMs / 5) {
453
500
  size = Math.min(ceiling, size * 2);
454
501
  }
@@ -458,7 +505,9 @@ async function sweepTable(
458
505
  // pass. It does NOT prove the table is drained: each DELETE autocommits,
459
506
  // so another process can commit an already-expired row before the count
460
507
  // below runs. Loop control only — `drained` comes from that count.
461
- if (result.changes < limitUsed) break;
508
+ // Removing a tree root exposes its expired children to the next batch.
509
+ if (result.changes === 0 || (table.policy !== "workflowRuns" && result.changes < limitUsed))
510
+ break;
462
511
  if (signal.aborted || Date.now() >= deadline) break;
463
512
  await yieldTick();
464
513
  }
@@ -0,0 +1,108 @@
1
+ /**
2
+ * MCP Events offered on the user MCP. v1: webhook delivery of task.completed
3
+ * and task.failed for tasks the subscribing user requested.
4
+ */
5
+
6
+ import { parseEnvFlag } from "@/utils/env-flag";
7
+
8
+ /** SEP-3415 extension identifier. */
9
+ export const EVENTS_EXTENSION_ID = "io.modelcontextprotocol/events";
10
+
11
+ /**
12
+ * Kill switch, default on. Off: no capability advertised and every `events/*`
13
+ * request gets -32601 Method not found. Read per session, so a config change
14
+ * applies to new sessions without a restart.
15
+ */
16
+ export function isMcpUserEventsEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
17
+ return parseEnvFlag(env.MCP_USER_EVENTS_ENABLED, true);
18
+ }
19
+
20
+ /**
21
+ * SEP-3415 error codes (draft, "provisional until accepted"). OpenAI's
22
+ * ChatGPT page still cites -32015 for CallbackEndpointError, from an earlier
23
+ * revision of the design sketch that used -32011..-32015.
24
+ */
25
+ export const EventsErrorCode = {
26
+ InvalidParams: -32602,
27
+ NotFound: -32023,
28
+ Forbidden: -32024,
29
+ ResourceExhausted: -32025,
30
+ Unsupported: -32026,
31
+ CallbackEndpointError: -32027,
32
+ } as const;
33
+
34
+ export type TaskEventName = "task.completed" | "task.failed";
35
+
36
+ const ARGUMENTS_SCHEMA = {
37
+ type: "object",
38
+ properties: {
39
+ taskId: {
40
+ type: "string",
41
+ description:
42
+ "Only this task and the tasks created under it. Omit to receive every task you requested.",
43
+ },
44
+ },
45
+ additionalProperties: false,
46
+ } as const;
47
+
48
+ const BASE_PAYLOAD_PROPERTIES = {
49
+ taskId: { type: "string" },
50
+ parentTaskId: { type: ["string", "null"] },
51
+ status: { type: "string" },
52
+ task: { type: "string", description: "The task description, truncated." },
53
+ url: { type: "string", description: "Dashboard link to the task." },
54
+ } as const;
55
+
56
+ export const EVENT_DESCRIPTORS = [
57
+ {
58
+ name: "task.completed",
59
+ description:
60
+ "Fires when a task you requested completes. Read the full result with get-task-details.",
61
+ delivery: ["webhook"],
62
+ inputSchema: ARGUMENTS_SCHEMA,
63
+ payloadSchema: {
64
+ type: "object",
65
+ properties: {
66
+ ...BASE_PAYLOAD_PROPERTIES,
67
+ output: { type: "string", description: "The task output, truncated." },
68
+ truncated: { type: "boolean" },
69
+ },
70
+ required: ["taskId", "status", "url"],
71
+ },
72
+ },
73
+ {
74
+ name: "task.failed",
75
+ description: "Fires when a task you requested fails. Read the details with get-task-details.",
76
+ delivery: ["webhook"],
77
+ inputSchema: ARGUMENTS_SCHEMA,
78
+ payloadSchema: {
79
+ type: "object",
80
+ properties: {
81
+ ...BASE_PAYLOAD_PROPERTIES,
82
+ failureReason: { type: "string", description: "Why the task failed, truncated." },
83
+ truncated: { type: "boolean" },
84
+ },
85
+ required: ["taskId", "status", "url"],
86
+ },
87
+ },
88
+ ] as const;
89
+
90
+ export function isTaskEventName(name: unknown): name is TaskEventName {
91
+ return name === "task.completed" || name === "task.failed";
92
+ }
93
+
94
+ export type TaskEventArguments = { taskId?: string };
95
+
96
+ /** Validates `arguments` against ARGUMENTS_SCHEMA. Returns null when invalid. */
97
+ export function parseTaskEventArguments(raw: unknown): TaskEventArguments | null {
98
+ if (raw === undefined || raw === null) return {};
99
+ if (typeof raw !== "object" || Array.isArray(raw)) return null;
100
+ const entries = Object.entries(raw as Record<string, unknown>);
101
+ const out: TaskEventArguments = {};
102
+ for (const [key, value] of entries) {
103
+ if (key !== "taskId") return null;
104
+ if (typeof value !== "string" || value.length === 0 || value.length > 200) return null;
105
+ out.taskId = value;
106
+ }
107
+ return out;
108
+ }
@@ -0,0 +1,202 @@
1
+ /**
2
+ * Delivers task.completed / task.failed to matching MCP Events webhook
3
+ * subscriptions. Listens on the in-process workflow event bus, which emits
4
+ * post-commit, so a rolled-back completion never reaches a client.
5
+ *
6
+ * Retries are in-process and bounded (5 attempts over about 14 minutes). There
7
+ * is no durable outbox: an event emitted while the API restarts, or whose
8
+ * retries run past a restart, is lost. get-task-details stays the source of
9
+ * truth.
10
+ *
11
+ * shortcut: no durable outbox, upgrade when a client needs at-least-once delivery.
12
+ */
13
+
14
+ import { createHash } from "node:crypto";
15
+ import { getDbClient, getTaskById, getUserById } from "@/be/db";
16
+ import { isLiveUserToken } from "@/be/users";
17
+ import { getAppUrl } from "@/utils/constants";
18
+ import { scrubSecrets } from "@/utils/secret-scrubber";
19
+ import { workflowEventBus } from "@/workflows/event-bus";
20
+ import { isMcpUserEventsEnabled, parseTaskEventArguments, type TaskEventName } from "./catalog";
21
+ import {
22
+ getSubscription,
23
+ listLiveSubscriptions,
24
+ recordDeliveryOutcome,
25
+ type SubscriptionRow,
26
+ unsealSecret,
27
+ } from "./store";
28
+ import { MAX_DELIVERY_BODY_BYTES, parseWebhookSecret, postSignedWebhook } from "./webhook";
29
+
30
+ /** Delays before attempts 2..5. Sum ≈ 14 min, inside SEP-3415's 10-15 min guidance. */
31
+ const DEFAULT_RETRY_DELAYS_MS = [10_000, 60_000, 240_000, 540_000];
32
+ const MAX_OUTPUT_CHARS = 16_000;
33
+ const MAX_TASK_CHARS = 2_000;
34
+ const MAX_ANCESTOR_HOPS = 32;
35
+
36
+ let retryDelaysMs = DEFAULT_RETRY_DELAYS_MS;
37
+ const pendingTimers = new Set<ReturnType<typeof setTimeout>>();
38
+ let listening = false;
39
+
40
+ /** Tests only: shorten the retry schedule. */
41
+ export function __setRetryDelaysForTests(delays: number[] | null): void {
42
+ retryDelaysMs = delays ?? DEFAULT_RETRY_DELAYS_MS;
43
+ }
44
+
45
+ function truncate(text: string, max: number): { text: string; truncated: boolean } {
46
+ return text.length > max
47
+ ? { text: text.slice(0, max), truncated: true }
48
+ : { text, truncated: false };
49
+ }
50
+
51
+ /** True when `taskId` is `filterTaskId` or one of its descendants. */
52
+ async function isUnderTask(taskId: string, filterTaskId: string): Promise<boolean> {
53
+ let current: string | null = taskId;
54
+ for (let hop = 0; current && hop <= MAX_ANCESTOR_HOPS; hop++) {
55
+ if (current === filterTaskId) return true;
56
+ const row: { parentTaskId: string | null } | null = await getDbClient().get<{
57
+ parentTaskId: string | null;
58
+ }>("SELECT parentTaskId FROM agent_tasks WHERE id = ?", [current]);
59
+ current = row?.parentTaskId ?? null;
60
+ }
61
+ return false;
62
+ }
63
+
64
+ function signingSecrets(row: SubscriptionRow, nowIso: string): Buffer[] {
65
+ const secrets = [unsealSecret(row.secretSealed)];
66
+ if (row.previousSecretSealed && row.previousSecretUntil && row.previousSecretUntil > nowIso) {
67
+ secrets.push(unsealSecret(row.previousSecretSealed));
68
+ }
69
+ return secrets.map(parseWebhookSecret).filter((s): s is Buffer => s !== null);
70
+ }
71
+
72
+ /** One attempt; schedules the next on a retryable failure. */
73
+ async function attemptDelivery(
74
+ subscriptionId: string,
75
+ eventId: string,
76
+ body: string,
77
+ attempt: number,
78
+ ): Promise<void> {
79
+ const nowIso = new Date().toISOString();
80
+ // Re-read each attempt: an unsubscribe or expiry mid-retry stops delivery.
81
+ const row = await getSubscription(subscriptionId);
82
+ if (!row || row.expiresAt <= nowIso) return;
83
+ // A revoked connection token stops its subscriptions' deliveries at once.
84
+ if (!(await isLiveUserToken(row.tokenId, row.userId))) return;
85
+ const result = await postSignedWebhook({
86
+ url: row.url,
87
+ subscriptionId: row.id,
88
+ // ChatGPT and the design sketch set webhook-id to the eventId. Ours is
89
+ // already unique per (subscription, event), so it is a per-message id.
90
+ webhookId: eventId,
91
+ secrets: signingSecrets(row, nowIso),
92
+ body,
93
+ });
94
+ const atIso = new Date().toISOString();
95
+ if (result.ok) {
96
+ await recordDeliveryOutcome(row.id, { ok: true, atIso });
97
+ return;
98
+ }
99
+ // 410: the receiver declined this event. 413: too large. Neither is retried.
100
+ if (result.status === 410 || result.status === 413) return;
101
+ await recordDeliveryOutcome(row.id, { ok: false, category: result.category, atIso });
102
+ const delay = retryDelaysMs[attempt];
103
+ if (delay === undefined) return;
104
+ const timer = setTimeout(() => {
105
+ pendingTimers.delete(timer);
106
+ void attemptDelivery(subscriptionId, eventId, body, attempt + 1).catch(logError);
107
+ }, delay);
108
+ timer.unref?.();
109
+ pendingTimers.add(timer);
110
+ }
111
+
112
+ function logError(err: unknown): void {
113
+ console.error(
114
+ "[mcp-events] delivery failed:",
115
+ scrubSecrets(err instanceof Error ? err.message : String(err)),
116
+ );
117
+ }
118
+
119
+ type TaskEventPayload = { taskId?: unknown; output?: unknown; failureReason?: unknown };
120
+
121
+ /**
122
+ * Finds the live subscriptions an event matches and starts one delivery per
123
+ * subscription. Resolves once every first attempt has finished.
124
+ */
125
+ export async function dispatchTaskEvent(name: TaskEventName, payload: unknown): Promise<void> {
126
+ if (!isMcpUserEventsEnabled()) return;
127
+ const { taskId, output, failureReason } = (payload ?? {}) as TaskEventPayload;
128
+ if (typeof taskId !== "string") return;
129
+ const task = await getTaskById(taskId);
130
+ if (!task?.requestedByUserId) return;
131
+ const user = await getUserById(task.requestedByUserId);
132
+ // A deactivated user's subscriptions stay silent until they lapse.
133
+ if (!user || user.status !== "active") return;
134
+
135
+ const now = new Date();
136
+ const subscriptions = await listLiveSubscriptions(user.id, name, now.toISOString());
137
+ if (subscriptions.length === 0) return;
138
+
139
+ const rawDetail = name === "task.completed" ? output : failureReason;
140
+ const detailText = scrubSecrets(typeof rawDetail === "string" ? rawDetail : "");
141
+ const detail = truncate(detailText, MAX_OUTPUT_CHARS);
142
+ const description = truncate(scrubSecrets(task.task ?? ""), MAX_TASK_CHARS);
143
+ const data: Record<string, unknown> = {
144
+ taskId: task.id,
145
+ parentTaskId: task.parentTaskId ?? null,
146
+ status: name === "task.completed" ? "completed" : "failed",
147
+ task: description.text,
148
+ url: `${getAppUrl()}/tasks/${encodeURIComponent(task.id)}`,
149
+ [name === "task.completed" ? "output" : "failureReason"]: detail.text,
150
+ truncated: detail.truncated || description.truncated,
151
+ };
152
+ const timestamp = task.finishedAt ?? now.toISOString();
153
+
154
+ const attempts: Promise<void>[] = [];
155
+ for (const subscription of subscriptions) {
156
+ const args = parseTaskEventArguments(JSON.parse(subscription.argumentsJson));
157
+ if (!args) continue;
158
+ if (args.taskId && !(await isUnderTask(task.id, args.taskId))) continue;
159
+ const eventId = `evt_${createHash("sha256")
160
+ .update(`${subscription.id}\n${name}\n${task.id}`)
161
+ .digest("hex")
162
+ .slice(0, 32)}`;
163
+ let body = JSON.stringify({ eventId, name, timestamp, data, cursor: null });
164
+ if (Buffer.byteLength(body, "utf8") > MAX_DELIVERY_BODY_BYTES) {
165
+ body = JSON.stringify({
166
+ eventId,
167
+ name,
168
+ timestamp,
169
+ data: { ...data, output: undefined, failureReason: undefined, truncated: true },
170
+ cursor: null,
171
+ });
172
+ }
173
+ attempts.push(attemptDelivery(subscription.id, eventId, body, 0).catch(logError));
174
+ }
175
+ await Promise.all(attempts);
176
+ }
177
+
178
+ const onCompleted = (payload: unknown) => {
179
+ void dispatchTaskEvent("task.completed", payload).catch(logError);
180
+ };
181
+ const onFailed = (payload: unknown) => {
182
+ void dispatchTaskEvent("task.failed", payload).catch(logError);
183
+ };
184
+
185
+ /** Subscribes the dispatcher to task lifecycle events. Idempotent, API server only. */
186
+ export function initMcpEventsDispatcher(): void {
187
+ if (listening) return;
188
+ listening = true;
189
+ workflowEventBus.on("task.completed", onCompleted);
190
+ workflowEventBus.on("task.failed", onFailed);
191
+ }
192
+
193
+ /** Unsubscribes and cancels pending retries (tests, shutdown). */
194
+ export function stopMcpEventsDispatcher(): void {
195
+ if (listening) {
196
+ workflowEventBus.off("task.completed", onCompleted);
197
+ workflowEventBus.off("task.failed", onFailed);
198
+ listening = false;
199
+ }
200
+ for (const timer of pendingTimers) clearTimeout(timer);
201
+ pendingTimers.clear();
202
+ }