@desplega.ai/agent-swarm 2.10.0 → 2.12.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 (572) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-c4chgxp6.js} +27 -24
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-hn5fftf5.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-3g6yc8nv.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-cpjgpjvp.js} +29 -26
  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-hce1av1h.js} +1 -1
  12. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-bztbxc4z.js} +1 -1
  13. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-d7xcym0j.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-arrkbe8t.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-68n75y1s.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-ykpyr5p8.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-trd59v7b.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-yjcze0j1.js} +10941 -10412
  21. package/dist/{cli-vq2eg24x.js → cli-01tvvtad.js} +63 -60
  22. package/dist/cli-04zc3f7b.js +68 -0
  23. package/dist/{cli-01k6wpr9.js → cli-0k1a0sde.js} +7 -7
  24. package/dist/{cli-j6te8keb.js → cli-0pp1yjg2.js} +8 -8
  25. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  26. package/dist/{cli-wwp1bd3n.js → cli-12vek61e.js} +564 -97
  27. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  28. package/dist/{cli-124ntmf0.js → cli-1htmtqc2.js} +143 -63
  29. package/dist/{cli-3f8zbtqa.js → cli-2amwhyv2.js} +15 -11
  30. package/dist/{cli-7sf9sb0w.js → cli-2m6yaq6b.js} +1 -1
  31. package/dist/{cli-6cwr32fe.js → cli-2tw284hj.js} +422 -140
  32. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  33. package/dist/{cli-nstkanmx.js → cli-39qm0rtm.js} +8 -8
  34. package/dist/{cli-hnamkvnc.js → cli-3p288654.js} +2 -2
  35. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  38. package/dist/cli-52nfye5j.js +673 -0
  39. package/dist/cli-55tc8cj4.js +252 -0
  40. package/dist/cli-5r95eqbh.js +186 -0
  41. package/dist/{cli-6037prsx.js → cli-5tg94mdw.js} +13 -13
  42. package/dist/{cli-2spnz7ye.js → cli-5x03v6en.js} +11137 -8332
  43. package/dist/{cli-y4ccxtz5.js → cli-5z0g0e8v.js} +153 -6
  44. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  45. package/dist/{cli-539h29es.js → cli-72yms3ey.js} +224 -189
  46. package/dist/{cli-y8p78ekx.js → cli-73q4g5nx.js} +21 -21
  47. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  48. package/dist/{cli-43ms35q9.js → cli-7wy8gbwb.js} +3 -3
  49. package/dist/{cli-7mv4h3sn.js → cli-7yn42w6m.js} +2 -2
  50. package/dist/{cli-gabsjg8x.js → cli-8hp56wat.js} +3 -2
  51. package/dist/cli-8mfdbdhe.js +43 -0
  52. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  53. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  54. package/dist/{cli-2rnd5j3t.js → cli-9qe5y107.js} +2 -2
  55. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  56. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3aaeb78m.js → cli-agjbj5x0.js} +95 -10
  59. package/dist/{cli-th1dkc2v.js → cli-b93d81yg.js} +2 -2
  60. package/dist/{cli-qj39vrc6.js → cli-bhgrhedp.js} +1 -1
  61. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  62. package/dist/{cli-9fjr27ez.js → cli-bp6k9acz.js} +18 -22
  63. package/dist/{cli-5a6pqy45.js → cli-bpje8n65.js} +31 -4
  64. package/dist/{cli-2v2zdm0a.js → cli-bz97ff9n.js} +2 -2
  65. package/dist/{cli-3caf7pmg.js → cli-c7j31hq9.js} +3 -3
  66. package/dist/{cli-t9ga4qmb.js → cli-cah298e5.js} +40 -33
  67. package/dist/{cli-aw83sr40.js → cli-cjqyse9q.js} +3 -3
  68. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  69. package/dist/{cli-nv4xsvmk.js → cli-dkvtfgn4.js} +7 -7
  70. package/dist/{cli-7r162fxe.js → cli-e3ahxq5y.js} +23 -17
  71. package/dist/{cli-3et6fmfe.js → cli-e8n0hdzd.js} +1 -1
  72. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  73. package/dist/{cli-kbtzfrxj.js → cli-en6dmkxd.js} +3 -3
  74. package/dist/{cli-m9cvf7vs.js → cli-eq4kew31.js} +14 -14
  75. package/dist/{cli-fcfbct2j.js → cli-eqq0hwvx.js} +5 -5
  76. package/dist/{cli-7zm3b3f5.js → cli-ercwc8xn.js} +1 -1
  77. package/dist/{cli-vs9vdpy0.js → cli-ex1y88j3.js} +1 -1
  78. package/dist/{cli-mk7c5ac4.js → cli-fxd1mwtr.js} +2 -2
  79. package/dist/{cli-91pkxres.js → cli-fy4gb74g.js} +2 -2
  80. package/dist/{cli-fq2rr3jb.js → cli-fyaq4zdv.js} +6 -6
  81. package/dist/{cli-cc93xzes.js → cli-gfy6hbd9.js} +28 -17
  82. package/dist/{cli-s1khw52h.js → cli-h70a2mxy.js} +71 -17
  83. package/dist/cli-hbvgzjq4.js +69 -0
  84. package/dist/{cli-qx4f057j.js → cli-hhc47ack.js} +4 -4
  85. package/dist/{cli-q5srsxq2.js → cli-j5gtytvg.js} +154 -41
  86. package/dist/{cli-psffsanb.js → cli-js10kdk7.js} +6 -1
  87. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  88. package/dist/{cli-vsw91x06.js → cli-k5jx8jya.js} +10 -6
  89. package/dist/{cli-tr27kwyg.js → cli-krbcr00p.js} +261 -6
  90. package/dist/{cli-5qhfv9rw.js → cli-kwr5qv5g.js} +44 -17
  91. package/dist/{cli-md50mj0r.js → cli-m5qtmrbc.js} +3 -3
  92. package/dist/{cli-vfqvrd82.js → cli-ma9ys8rt.js} +2 -2
  93. package/dist/{cli-w16kwbzw.js → cli-mbwmqb5w.js} +1 -1
  94. package/dist/{cli-w1q68d8x.js → cli-mcymtvwn.js} +322 -72
  95. package/dist/{cli-k3q2va86.js → cli-mq2fbgva.js} +66 -5
  96. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  97. package/dist/{cli-kpgcm7xy.js → cli-n85m2wkq.js} +1 -1
  98. package/dist/{cli-v8z0yga9.js → cli-n8f0fs3c.js} +4 -4
  99. package/dist/{cli-mys27d03.js → cli-nja15knq.js} +3 -3
  100. package/dist/{cli-zk7v5s89.js → cli-pe3yxedk.js} +3 -3
  101. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  102. package/dist/{cli-6237rnyr.js → cli-pqfecppn.js} +1 -1
  103. package/dist/{cli-qrta34nb.js → cli-q2dywc8h.js} +4 -4
  104. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  105. package/dist/{cli-s1zqk1aj.js → cli-q8tc22bj.js} +15 -9
  106. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  107. package/dist/{cli-43evxwj4.js → cli-r0mz92by.js} +9 -4
  108. package/dist/{cli-jrbq4djp.js → cli-r14ac1y0.js} +1 -1
  109. package/dist/{cli-5gpqgs8b.js → cli-rtmqzat7.js} +2 -2
  110. package/dist/{cli-tvgqesec.js → cli-s6zk31gr.js} +4 -4
  111. package/dist/{cli-6ym4jhzp.js → cli-sv2r3bw8.js} +7 -7
  112. package/dist/{cli-wafmk3fn.js → cli-t75xngj1.js} +12 -12
  113. package/dist/{cli-x40a0w9j.js → cli-tdk7jtka.js} +1 -1
  114. package/dist/{cli-zeh2mhkg.js → cli-tm60vtax.js} +1 -1
  115. package/dist/cli-tsfkcd4v.js +30 -0
  116. package/dist/{cli-8st34zhr.js → cli-v9ya390t.js} +57 -19
  117. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  118. package/dist/{cli-p0n7b5rz.js → cli-wvjqaqcp.js} +2907 -151
  119. package/dist/{cli-sb4426be.js → cli-xf4z5bdn.js} +5 -5
  120. package/dist/{cli-p0c3vtch.js → cli-xm34qj8m.js} +772 -515
  121. package/dist/{cli-z0m452jr.js → cli-ya3kf4gs.js} +1 -1
  122. package/dist/{cli-had1p04a.js → cli-yegz2g06.js} +4 -4
  123. package/dist/{cli-k5yewqgd.js → cli-yfpc6qy9.js} +3 -3
  124. package/dist/{cli-q2d3e1k1.js → cli-z4f346g5.js} +1 -1
  125. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  126. package/dist/cli.js +34 -30
  127. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  128. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-wc6e4wct.js} +8 -8
  129. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  130. package/dist/{codex-login-a239g1ah.js → codex-login-1ven7yje.js} +1 -1
  131. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-ppfgjd97.js} +9 -9
  132. package/dist/{commands-d8g349v4.js → commands-tsv2vx5b.js} +3 -3
  133. package/dist/{controller-mwgdmb8y.js → controller-ye4sdwsy.js} +4 -4
  134. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-zn4dg69h.js} +25 -22
  135. package/dist/core-dxcy02sc.js +41 -0
  136. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-q2g9vwts.js} +2 -2
  137. package/dist/{db-wcw0b2j8.js → db-3r1fyr2n.js} +6 -2
  138. package/dist/{db-qpganbeb.js → db-g111qn9j.js} +3 -3
  139. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-t8d86q9x.js} +1 -1
  140. package/dist/{dispatcher-8d8s49yz.js → dispatcher-4q8s0mx8.js} +22 -19
  141. package/dist/{docker-09tkkg0n.js → docker-1b41eysj.js} +51 -14
  142. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-mmcw1z5s.js} +2 -2
  143. package/dist/{e2b-3v1e745x.js → e2b-ew8c5j5v.js} +3 -3
  144. package/dist/{e2b-sm28k0k3.js → e2b-xm60c8ad.js} +6 -6
  145. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-04ke6hcp.js} +1 -1
  146. package/dist/{embedding-space-e48xchqa.js → embedding-space-kcdn52vz.js} +6 -6
  147. package/dist/{embeddings-tgq2afbq.js → embeddings-jnzcd91a.js} +1 -1
  148. package/dist/{event-bus-xr83x566.js → event-bus-v4ywhc2p.js} +1 -1
  149. package/dist/{execute-8rhwrk7f.js → execute-74amghty.js} +8 -4
  150. package/dist/{external-channel-8bt3j2pm.js → external-channel-v9zgxnxz.js} +2 -2
  151. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  152. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  153. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  154. package/dist/grok-adapter-t6m74fb1.js +19 -0
  155. package/dist/handlers-9kwcrc4k.js +38 -0
  156. package/dist/{heartbeat-x0056ra5.js → heartbeat-p8pk1msj.js} +25 -22
  157. package/dist/{hook-a7vmn2st.js → hook-k1h73zd7.js} +5 -5
  158. package/dist/{hook-mrd2ayxv.js → hook-p5reemds.js} +8 -8
  159. package/dist/{http-ym9c5svp.js → http-ms1z5xxy.js} +2549 -224
  160. package/dist/index-23cdfzr6.js +39 -0
  161. package/dist/{index-01ns1pkw.js → index-76zzxtzf.js} +1 -1
  162. package/dist/{index-ny60jcat.js → index-fbkqhvvj.js} +40 -18
  163. package/dist/index-g7kkjs5b.js +38 -0
  164. package/dist/{index-x6azjwm8.js → index-gjn6qfgn.js} +1 -1
  165. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  166. package/dist/{index-p46tvwtx.js → index-kn63q1gr.js} +28 -25
  167. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  168. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  169. package/dist/index-stk36pa5.js +43 -0
  170. package/dist/{k8s-m56sw868.js → k8s-fy8hbhkg.js} +73 -14
  171. package/dist/{keepalive-7yxg8z4c.js → keepalive-031js8jz.js} +4 -4
  172. package/dist/lead-mfggjtfk.js +77 -0
  173. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  174. package/dist/{maintenance-6tefxmk1.js → maintenance-sq9v3qx9.js} +1 -1
  175. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  176. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  177. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  178. package/dist/object-webhooks-r24wwb5y.js +21 -0
  179. package/dist/{onboard-fja65z08.js → onboard-p25yhh7t.js} +5 -5
  180. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  181. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  182. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  183. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  184. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-wcjc4zdk.js} +7 -7
  185. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  186. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-ff1gf20m.js} +2 -2
  187. package/dist/{pending-h01yzpx4.js → pending-hxj5yatb.js} +23 -20
  188. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  189. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-vkp4zz7p.js} +19 -18
  190. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-9w7gx41w.js} +2 -2
  191. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-84aw10nz.js} +3 -3
  192. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-hz74vckp.js} +2 -2
  193. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  194. package/dist/{render-v2-1rgspxzf.js → render-v2-nrdkg9gf.js} +7 -6
  195. package/dist/{resume-tqy61x24.js → resume-s6ey36rh.js} +9 -8
  196. package/dist/{runtime-exkxyx5f.js → runtime-x0b4pyam.js} +2 -2
  197. package/dist/{session-access-3act7vt4.js → session-access-xv49tk14.js} +4 -4
  198. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-r5j988ah.js} +3 -3
  199. package/dist/{setup-ry1vfdef.js → setup-mj0krk1p.js} +1 -1
  200. package/dist/thread-buffer-temgaqsy.js +41 -0
  201. package/dist/tree-visibility-cbrsfaar.js +24 -0
  202. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  203. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  204. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-ns0ryw05.js} +32 -10
  205. package/dist/{work-objects-z2e5tv03.js → work-objects-pydhzast.js} +25 -22
  206. package/dist/worker-efcemc22.js +77 -0
  207. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-9z2xec5e.js} +22 -19
  208. package/dist/{x-wg164ss9.js → x-3dtaf2r9.js} +2 -2
  209. package/openapi.json +2040 -559
  210. package/package.json +15 -11
  211. package/src/azure-devops/auth.ts +2 -3
  212. package/src/be/agent-fs-identity.ts +46 -0
  213. package/src/be/agent-history.ts +215 -0
  214. package/src/be/db/agents.ts +34 -12
  215. package/src/be/db/request-composition.ts +190 -0
  216. package/src/be/db/runtime.ts +15 -0
  217. package/src/be/db/slack-trees.ts +220 -10
  218. package/src/be/db/tasks/human-free.ts +3 -2
  219. package/src/be/db/tasks/write.ts +2 -2
  220. package/src/be/db/workflow-run-retention.ts +101 -0
  221. package/src/be/db-client.ts +23 -1
  222. package/src/be/db-retention-defaults.ts +46 -0
  223. package/src/be/db-retention.ts +55 -6
  224. package/src/be/db.ts +2 -0
  225. package/src/be/mcp-events/catalog.ts +108 -0
  226. package/src/be/mcp-events/dispatcher.ts +202 -0
  227. package/src/be/mcp-events/protocol.ts +296 -0
  228. package/src/be/mcp-events/store.ts +231 -0
  229. package/src/be/mcp-events/webhook.ts +226 -0
  230. package/src/be/memory/providers/sqlite-store.ts +110 -24
  231. package/src/be/memory/review-recall-filter.ts +22 -0
  232. package/src/be/memory/search-candidates.ts +5 -7
  233. package/src/be/memory/types.ts +5 -0
  234. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  235. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  236. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  237. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  238. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  239. package/src/be/migrations/330_request_composition.sql +22 -0
  240. package/src/be/migrations/332_primitive_objects.sql +31 -0
  241. package/src/be/migrations/334_agent_history.sql +23 -0
  242. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  243. package/src/be/model-profile-check.ts +1 -1
  244. package/src/be/multi-runtime.ts +32 -4
  245. package/src/be/primitives/boards/elements.ts +717 -0
  246. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  247. package/src/be/primitives/boards/service.ts +121 -0
  248. package/src/be/primitives/object-webhooks.ts +348 -0
  249. package/src/be/primitives/objects.ts +686 -0
  250. package/src/be/primitives/sheets/a1.ts +136 -0
  251. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  252. package/src/be/primitives/sheets/engine.ts +199 -0
  253. package/src/be/primitives/sheets/format.ts +106 -0
  254. package/src/be/primitives/sheets/service.ts +415 -0
  255. package/src/be/primitives/write-object.ts +83 -0
  256. package/src/be/runtime-pools/controllers.ts +18 -3
  257. package/src/be/runtime-pools/db.ts +15 -4
  258. package/src/be/runtime-pools/supervisor.ts +42 -2
  259. package/src/be/script-credential-broker.ts +8 -27
  260. package/src/be/scripts/typecheck.ts +216 -0
  261. package/src/be/seed/agent-fs-provision.ts +18 -0
  262. package/src/be/swarm-config-guard.ts +10 -2
  263. package/src/be/users.ts +19 -0
  264. package/src/commands/context-preamble.ts +11 -4
  265. package/src/commands/credential-outcome-report.ts +33 -9
  266. package/src/commands/e2b-stack-wizard.tsx +12 -6
  267. package/src/commands/onboard/agent-fs-version.ts +1 -1
  268. package/src/commands/onboard/steps/harness.tsx +1 -1
  269. package/src/commands/provider-credentials.ts +1 -0
  270. package/src/commands/runner.ts +116 -12
  271. package/src/e2b/env.ts +3 -1
  272. package/src/extensions/catalog.generated.json +1 -1
  273. package/src/fs/agent-fs-provider.ts +33 -2
  274. package/src/github/app.ts +59 -14
  275. package/src/gitlab/auth.ts +3 -4
  276. package/src/heartbeat/heartbeat.ts +11 -11
  277. package/src/http/agent-lifecycle.ts +152 -0
  278. package/src/http/agents.ts +12 -0
  279. package/src/http/all-routes.ts +4 -0
  280. package/src/http/auth.ts +2 -1
  281. package/src/http/config.ts +2 -1
  282. package/src/http/core.ts +2 -0
  283. package/src/http/github-token.ts +66 -0
  284. package/src/http/index.ts +36 -0
  285. package/src/http/mcp-user.ts +11 -8
  286. package/src/http/mcp.ts +58 -42
  287. package/src/http/object-webhooks.ts +101 -0
  288. package/src/http/operator-actor.ts +2 -1
  289. package/src/http/prompt-templates.ts +1 -0
  290. package/src/http/request-composition.ts +310 -0
  291. package/src/http/sessions.ts +7 -0
  292. package/src/http/tasks.ts +6 -1
  293. package/src/http/tool-schema-estimate.ts +95 -0
  294. package/src/http/workflows.ts +61 -11
  295. package/src/integrations/chat-sdk/inbound.ts +2 -2
  296. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  297. package/src/prompts/base-prompt.ts +133 -7
  298. package/src/prompts/resolver.ts +41 -2
  299. package/src/providers/acp-targets.ts +2 -2
  300. package/src/providers/amp-adapter.ts +1 -1
  301. package/src/providers/opencode-adapter.ts +76 -2
  302. package/src/providers/opencode-swarm-plugin.ts +22 -3
  303. package/src/providers/pi-mono-adapter.ts +1 -0
  304. package/src/providers/pi-mono-extension.ts +71 -0
  305. package/src/providers/pricing-sources.md +4 -0
  306. package/src/providers/request-composition-hook.ts +312 -0
  307. package/src/providers/types.ts +5 -0
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/runtime-providers/controller-protocol.ts +7 -0
  311. package/src/runtime-providers/docker.ts +80 -12
  312. package/src/runtime-providers/k8s.ts +111 -6
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/script-workflows/guest-ctx.ts +32 -0
  316. package/src/script-workflows/workflow-ctx.ts +2 -0
  317. package/src/scripts-runtime/ctx.ts +9 -1
  318. package/src/scripts-runtime/executors/native.ts +106 -21
  319. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  320. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  321. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  322. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  323. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  324. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  325. package/src/server-user.ts +16 -1
  326. package/src/server.ts +48 -0
  327. package/src/slack/ack.ts +10 -5
  328. package/src/slack/actions.ts +3 -3
  329. package/src/slack/app.ts +2 -0
  330. package/src/slack/assistant.ts +4 -4
  331. package/src/slack/blocks.ts +3 -3
  332. package/src/slack/handlers.ts +3 -3
  333. package/src/slack/reaction-shortcode.ts +23 -2
  334. package/src/slack/render-v2.ts +297 -200
  335. package/src/slack/responses.ts +7 -5
  336. package/src/slack/thread-buffer.ts +3 -3
  337. package/src/slack/tree-visibility.ts +64 -0
  338. package/src/tasks/worker-follow-up.ts +127 -17
  339. package/src/tests/agent-history.test.ts +313 -0
  340. package/src/tests/azure-devops-auth.test.ts +6 -0
  341. package/src/tests/azure-devops-outbound.test.ts +47 -14
  342. package/src/tests/base-prompt.test.ts +149 -1
  343. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  344. package/src/tests/check-playwright-version.test.ts +33 -0
  345. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  346. package/src/tests/context-preamble-budget.test.ts +65 -0
  347. package/src/tests/credential-check.test.ts +12 -0
  348. package/src/tests/credential-outcome-report.test.ts +81 -1
  349. package/src/tests/db-client.test.ts +22 -0
  350. package/src/tests/db-retention-defaults.test.ts +244 -0
  351. package/src/tests/db-retention.test.ts +2 -1
  352. package/src/tests/db-task-read-contract.test.ts +2 -0
  353. package/src/tests/db-task-write-contract.test.ts +2 -0
  354. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  355. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  356. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  357. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  358. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  359. package/src/tests/e2e-shards.test.ts +137 -0
  360. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  361. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  362. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  363. package/src/tests/env-flag.test.ts +4 -2
  364. package/src/tests/event-loop-lag.test.ts +12 -18
  365. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  366. package/src/tests/extensions-heartbeat.test.ts +34 -0
  367. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  368. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  369. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  370. package/src/tests/github-installation-token-route.test.ts +199 -0
  371. package/src/tests/gitlab-auth.test.ts +10 -0
  372. package/src/tests/heartbeat.test.ts +38 -0
  373. package/src/tests/http-api-integration.test.ts +0 -6
  374. package/src/tests/mcp-user-events.test.ts +708 -0
  375. package/src/tests/memory-key-paths.test.ts +4 -1
  376. package/src/tests/memory-search-stall.test.ts +421 -0
  377. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  378. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  379. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  380. package/src/tests/opencode-adapter.test.ts +97 -0
  381. package/src/tests/pi-mono-extension.test.ts +168 -0
  382. package/src/tests/preload-env.test.ts +61 -1
  383. package/src/tests/preload.ts +22 -0
  384. package/src/tests/primitives-boards.test.ts +686 -0
  385. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  386. package/src/tests/primitives-objects.test.ts +248 -0
  387. package/src/tests/prompt-template-resolver.test.ts +85 -0
  388. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  389. package/src/tests/reload-config.test.ts +45 -0
  390. package/src/tests/request-composition.test.ts +447 -0
  391. package/src/tests/runner-max-concurrent.test.ts +86 -0
  392. package/src/tests/runtime-pools-db.test.ts +80 -0
  393. package/src/tests/runtime-provider-registration.test.ts +8 -0
  394. package/src/tests/runtime-providers-docker.test.ts +192 -1
  395. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  396. package/src/tests/runtime-remote-controller.test.ts +64 -1
  397. package/src/tests/runtime-supervisor.test.ts +101 -0
  398. package/src/tests/script-connections.test.ts +8 -0
  399. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  400. package/src/tests/scripts-namespaces.test.ts +211 -0
  401. package/src/tests/secret-scrub-gate.test.ts +1 -0
  402. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  403. package/src/tests/secret-scrubber.test.ts +1 -1
  404. package/src/tests/session-tokens.test.ts +27 -0
  405. package/src/tests/sheet-engine.test.ts +58 -0
  406. package/src/tests/slack-blocks.test.ts +18 -0
  407. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  408. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  409. package/src/tests/slack-reaction-config.test.ts +38 -2
  410. package/src/tests/slack-read-boundaries.test.ts +4 -2
  411. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  412. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  413. package/src/tests/slack-render-v2.test.ts +683 -11
  414. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  415. package/src/tests/task-session-prompts.test.ts +37 -0
  416. package/src/tests/task-start-after-commit.test.ts +82 -0
  417. package/src/tests/ui-logs-parser.test.ts +67 -0
  418. package/src/tests/user-delete-perf.test.ts +36 -9
  419. package/src/tests/webhook-filter.test.ts +327 -0
  420. package/src/tests/workflow-async-v2.test.ts +19 -16
  421. package/src/tests/workflow-e2e.test.ts +1 -9
  422. package/src/tests/workflow-finalization-races.test.ts +553 -0
  423. package/src/tests/workflow-foreach.test.ts +2 -0
  424. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  425. package/src/tests/workflow-http-v2.test.ts +105 -2
  426. package/src/tests/workflow-idempotency.test.ts +41 -0
  427. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  428. package/src/tests/workflow-parallel-park.test.ts +297 -0
  429. package/src/tests/workflow-retry-v2.test.ts +158 -21
  430. package/src/tests/workflow-retry-validation.test.ts +13 -13
  431. package/src/tests/workflow-runs-retention.test.ts +533 -0
  432. package/src/tests/workflow-script-principal.test.ts +7 -2
  433. package/src/tests/workflow-tla-races.test.ts +36 -2
  434. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  435. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  436. package/src/tests/workflow-wait-event.test.ts +28 -2
  437. package/src/tests/workflow-wait-poller.test.ts +94 -0
  438. package/src/tests/workflow-wait-time.test.ts +7 -3
  439. package/src/tests/workflow-wait.ts +44 -0
  440. package/src/tools/boards.ts +260 -0
  441. package/src/tools/objects.ts +191 -0
  442. package/src/tools/sheets.ts +312 -0
  443. package/src/tools/slack-read.ts +10 -3
  444. package/src/tools/tool-config.ts +23 -0
  445. package/src/tools/workflows/create-workflow.ts +18 -4
  446. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  447. package/src/tools/workflows/patch-workflow.ts +4 -0
  448. package/src/tools/workflows/update-workflow.ts +24 -3
  449. package/src/types.ts +216 -2
  450. package/src/utils/credentials.ts +7 -0
  451. package/src/utils/sandboxed-process.ts +47 -2
  452. package/src/utils/secret-scrubber.ts +61 -6
  453. package/src/workflows/checkpoint.ts +18 -0
  454. package/src/workflows/engine.ts +73 -31
  455. package/src/workflows/foreach-driver.ts +42 -4
  456. package/src/workflows/input.ts +29 -1
  457. package/src/workflows/patch-definition.ts +15 -1
  458. package/src/workflows/recovery.ts +6 -1
  459. package/src/workflows/resume.ts +11 -3
  460. package/src/workflows/retry-poller.ts +32 -6
  461. package/src/workflows/successor-routing.ts +108 -0
  462. package/src/workflows/task-step-routing.ts +5 -2
  463. package/src/workflows/triggers.ts +21 -36
  464. package/src/workflows/validation.ts +10 -0
  465. package/src/workflows/wait-poller.ts +6 -2
  466. package/src/workflows/webhook-filter.ts +203 -0
  467. package/templates/ai-toolbox.manifest.json +1 -1
  468. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  469. package/templates/skills/agent-browser/SKILL.md +1 -0
  470. package/templates/skills/agent-browser/content.md +1 -0
  471. package/templates/skills/pages/content.md +5 -0
  472. package/templates/skills/swarm-docs/content.md +8 -1
  473. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  474. package/templates/skills/swarm-scripts/content.md +1 -0
  475. package/templates/skills/tdd-planning/content.md +5 -2
  476. package/dist/acp-adapter-bht22g3k.js +0 -16
  477. package/dist/core-sxy4epp2.js +0 -38
  478. package/dist/fx-adapter-adtdb3jb.js +0 -19
  479. package/dist/grok-adapter-accnn9km.js +0 -19
  480. package/dist/handlers-1x77561e.js +0 -35
  481. package/dist/index-48qzcqzj.js +0 -35
  482. package/dist/index-rkvaambe.js +0 -36
  483. package/dist/index-xj1mq27m.js +0 -40
  484. package/dist/lead-enzn86bz.js +0 -74
  485. package/dist/thread-buffer-3x93yexa.js +0 -38
  486. package/dist/worker-zfcv2wbf.js +0 -74
  487. package/src/slack/socket-mode-guard.test.ts +0 -25
  488. package/src/tests/agent-activity.test.ts +0 -247
  489. package/src/tests/agent-fs-live-url.test.ts +0 -55
  490. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  491. package/src/tests/approval-sweeps-config.test.ts +0 -47
  492. package/src/tests/cards.test.ts +0 -169
  493. package/src/tests/chat-sdk-facts.test.ts +0 -23
  494. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  495. package/src/tests/core-auth.test.ts +0 -156
  496. package/src/tests/date-utils.test.ts +0 -48
  497. package/src/tests/db-context-versions.test.ts +0 -37
  498. package/src/tests/db-runtime.test.ts +0 -131
  499. package/src/tests/enabled-capabilities.test.ts +0 -20
  500. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  501. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  502. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  503. package/src/tests/github-event-labels.test.ts +0 -24
  504. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  505. package/src/tests/http-log-scrubbing.test.ts +0 -123
  506. package/src/tests/http-semconv-attributes.test.ts +0 -92
  507. package/src/tests/identity.test.ts +0 -117
  508. package/src/tests/inbox-state.test.ts +0 -167
  509. package/src/tests/internal-ai/models.test.ts +0 -54
  510. package/src/tests/launch-password-rejection.test.ts +0 -140
  511. package/src/tests/list-total-cache.test.ts +0 -88
  512. package/src/tests/match-route.test.ts +0 -187
  513. package/src/tests/memory-feature-flags.test.ts +0 -45
  514. package/src/tests/memory-get-tool.test.ts +0 -269
  515. package/src/tests/memory-health-endpoint.test.ts +0 -78
  516. package/src/tests/memory-http-access.test.ts +0 -221
  517. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  518. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  519. package/src/tests/openai-embedding-provider.test.ts +0 -159
  520. package/src/tests/org-identity.test.ts +0 -44
  521. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  522. package/src/tests/pages-browser-sdk.test.ts +0 -76
  523. package/src/tests/pages-feedback-keys.test.ts +0 -121
  524. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  525. package/src/tests/pages-list-endpoint.test.ts +0 -148
  526. package/src/tests/pages-password-mode.test.ts +0 -266
  527. package/src/tests/pages-public-authed-401.test.ts +0 -103
  528. package/src/tests/pages-public-html.test.ts +0 -297
  529. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  530. package/src/tests/pages-view-count.test.ts +0 -245
  531. package/src/tests/prompt-templates-db.test.ts +0 -616
  532. package/src/tests/rbac-engine.test.ts +0 -742
  533. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  534. package/src/tests/route-def-find-route.test.ts +0 -192
  535. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  536. package/src/tests/schedule-validation-helper.test.ts +0 -51
  537. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  538. package/src/tests/scheduler-backoff.test.ts +0 -166
  539. package/src/tests/script-run-token.test.ts +0 -75
  540. package/src/tests/scripts-extract-signature.test.ts +0 -47
  541. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  542. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  543. package/src/tests/short-id.test.ts +0 -23
  544. package/src/tests/skill-files-http.test.ts +0 -222
  545. package/src/tests/skill-get-file-tool.test.ts +0 -110
  546. package/src/tests/skill-script-refs.test.ts +0 -63
  547. package/src/tests/skill-update-scope.test.ts +0 -252
  548. package/src/tests/skills-bundle.test.ts +0 -99
  549. package/src/tests/slack-app-icon.test.ts +0 -94
  550. package/src/tests/slack-assistant-comention.test.ts +0 -139
  551. package/src/tests/slack-delete.test.ts +0 -157
  552. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  553. package/src/tests/slack-manifest.test.ts +0 -23
  554. package/src/tests/slack-task-output.test.ts +0 -90
  555. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  556. package/src/tests/swarm-diff.test.ts +0 -728
  557. package/src/tests/task-lifecycle-events.test.ts +0 -53
  558. package/src/tests/template-asset-config.test.ts +0 -18
  559. package/src/tests/template-fetch.test.ts +0 -490
  560. package/src/tests/themes-page-theme.test.ts +0 -155
  561. package/src/tests/tool-annotations.test.ts +0 -442
  562. package/src/tests/tool-output-agent-id.test.ts +0 -202
  563. package/src/tests/update-profile-agentid.test.ts +0 -248
  564. package/src/tests/whoami-route.test.ts +0 -162
  565. package/src/tests/workflow-definition-telemetry.test.ts +0 -134
  566. package/src/tests/workflow-patch.test.ts +0 -169
  567. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  568. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  569. package/src/tests/workflow-step-claims.test.ts +0 -152
  570. package/src/tests/workflow-step-order.test.ts +0 -92
  571. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  572. package/src/tests/workflow-versions.test.ts +0 -240
package/src/be/db.ts CHANGED
@@ -299,6 +299,7 @@ export {
299
299
  SESSION_ACTIVITY_REFRESH_MIN_INTERVAL_MS,
300
300
  } from "./db/active-sessions";
301
301
  export {
302
+ AgentDeletedError,
302
303
  buildRoutingAffinityFromAgent,
303
304
  createAgent,
304
305
  deleteAgent,
@@ -315,6 +316,7 @@ export {
315
316
  getRemainingCapacity,
316
317
  hasCapacity,
317
318
  incrementEmptyPollCount,
319
+ isAgentDeleted,
318
320
  isAgentEligibleForTask,
319
321
  isExtensionAgent,
320
322
  isPoolAffinityEnforcementEnabled,
@@ -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
+ }
@@ -0,0 +1,296 @@
1
+ /**
2
+ * `events/list`, `events/subscribe` and `events/unsubscribe` for the user MCP
3
+ * (SEP-3415 draft, webhook delivery only).
4
+ *
5
+ * Backward compatibility: nothing here runs unless a client sends an
6
+ * `events/*` request. The only change a non-events client sees is the added
7
+ * capability keys in the `initialize` result.
8
+ */
9
+
10
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
11
+ import type { ServerCapabilities } from "@modelcontextprotocol/sdk/types.js";
12
+ import * as z from "zod";
13
+ import { getTaskById } from "@/be/db";
14
+ import type { User } from "@/types";
15
+ import {
16
+ EVENT_DESCRIPTORS,
17
+ EVENTS_EXTENSION_ID,
18
+ EventsErrorCode,
19
+ isTaskEventName,
20
+ parseTaskEventArguments,
21
+ } from "./catalog";
22
+ import {
23
+ canonicalJson,
24
+ countLiveSubscriptions,
25
+ deleteExpiredSubscriptions,
26
+ deleteSubscription,
27
+ getSubscription,
28
+ latestVerification,
29
+ subscriptionIdFor,
30
+ upsertSubscription,
31
+ } from "./store";
32
+ import { callbackUrlProblem, parseWebhookSecret, verifyCallbackEndpoint } from "./webhook";
33
+
34
+ export const MAX_SUBSCRIPTIONS_PER_USER = 25;
35
+ export const DEFAULT_TTL_MS = 60 * 60 * 1000;
36
+ export const MIN_TTL_MS = 60 * 1000;
37
+ export const MAX_TTL_MS = 24 * 60 * 60 * 1000;
38
+ /** How long a passed verification challenge covers this user's later subscribes to the URL. */
39
+ export const VERIFICATION_CACHE_MS = 24 * 60 * 60 * 1000;
40
+ /** Dual-signing window after a client rotates its secret. */
41
+ export const ROTATION_GRACE_MS = 10 * 60 * 1000;
42
+
43
+ class EventsRpcError extends Error {
44
+ constructor(
45
+ readonly code: number,
46
+ message: string,
47
+ readonly data?: Record<string, unknown>,
48
+ ) {
49
+ super(message);
50
+ }
51
+ }
52
+
53
+ function invalidParams(message: string): EventsRpcError {
54
+ return new EventsRpcError(EventsErrorCode.InvalidParams, message);
55
+ }
56
+
57
+ function resourceExhausted(): EventsRpcError {
58
+ return new EventsRpcError(EventsErrorCode.ResourceExhausted, "Too many subscriptions", {
59
+ limit: "subscriptions",
60
+ max: MAX_SUBSCRIPTIONS_PER_USER,
61
+ });
62
+ }
63
+
64
+ // Loose params: validation happens in the handler so a bad request gets
65
+ // InvalidParams with a useful message instead of a schema-parse InternalError.
66
+ const EventsListRequestSchema = z.object({
67
+ method: z.literal("events/list"),
68
+ params: z.unknown().optional(),
69
+ });
70
+ const EventsSubscribeRequestSchema = z.object({
71
+ method: z.literal("events/subscribe"),
72
+ params: z.unknown().optional(),
73
+ });
74
+ const EventsUnsubscribeRequestSchema = z.object({
75
+ method: z.literal("events/unsubscribe"),
76
+ params: z.unknown().optional(),
77
+ });
78
+
79
+ type SubscriptionKey = {
80
+ name: "task.completed" | "task.failed";
81
+ arguments: { taskId?: string };
82
+ argumentsJson: string;
83
+ url: string;
84
+ };
85
+
86
+ function asRecord(value: unknown): Record<string, unknown> {
87
+ return value !== null && typeof value === "object" && !Array.isArray(value)
88
+ ? (value as Record<string, unknown>)
89
+ : {};
90
+ }
91
+
92
+ function parseKey(rawParams: unknown): SubscriptionKey & { delivery: Record<string, unknown> } {
93
+ const params = asRecord(rawParams);
94
+ if (typeof params.name !== "string") throw invalidParams("name is required");
95
+ if (!isTaskEventName(params.name)) {
96
+ throw new EventsRpcError(EventsErrorCode.NotFound, `Unknown event: ${params.name}`, {
97
+ kind: "event",
98
+ });
99
+ }
100
+ const args = parseTaskEventArguments(params.arguments);
101
+ if (!args) throw invalidParams("arguments do not match the event's inputSchema");
102
+ const delivery = asRecord(params.delivery);
103
+ if (delivery.mode !== undefined && delivery.mode !== "webhook") {
104
+ throw new EventsRpcError(EventsErrorCode.Unsupported, "Only webhook delivery is offered", {
105
+ feature: "deliveryMode",
106
+ value: delivery.mode,
107
+ });
108
+ }
109
+ const urlProblem = callbackUrlProblem(delivery.url);
110
+ if (urlProblem) throw invalidParams(urlProblem);
111
+ return {
112
+ name: params.name,
113
+ arguments: args,
114
+ argumentsJson: canonicalJson(args),
115
+ url: delivery.url as string,
116
+ delivery,
117
+ };
118
+ }
119
+
120
+ /** Client suggestion → granted TTL. Never grants no-expiry; clamps instead of rejecting. */
121
+ export function grantTtlMs(raw: unknown): number {
122
+ if (raw === undefined) return DEFAULT_TTL_MS;
123
+ if (raw === null) return MAX_TTL_MS;
124
+ if (typeof raw !== "number" || !Number.isFinite(raw))
125
+ throw invalidParams("ttlMs must be a number");
126
+ return Math.min(MAX_TTL_MS, Math.max(MIN_TTL_MS, Math.floor(raw)));
127
+ }
128
+
129
+ export type EventsAuthorizer = (method: string) => Promise<boolean>;
130
+
131
+ /** Verification POSTs allowed per user, and in total, per rolling hour. */
132
+ export const VERIFICATIONS_PER_USER_PER_HOUR = 30;
133
+ export const VERIFICATIONS_PER_HOUR = 1000;
134
+ const HOUR_MS = 60 * 60 * 1000;
135
+ // shortcut: in-memory and per API process, upgrade if the API runs several replicas.
136
+ const verificationLog = new Map<string, number[]>();
137
+
138
+ /** Records one verification POST unless the user or global hourly budget is spent. */
139
+ function takeVerificationBudget(userId: string, now: number): boolean {
140
+ const recent = (key: string) =>
141
+ (verificationLog.get(key) ?? []).filter((at) => at > now - HOUR_MS);
142
+ const mine = recent(userId);
143
+ const all = recent("*");
144
+ if (mine.length >= VERIFICATIONS_PER_USER_PER_HOUR || all.length >= VERIFICATIONS_PER_HOUR) {
145
+ return false;
146
+ }
147
+ verificationLog.set(userId, [...mine, now]);
148
+ verificationLog.set("*", [...all, now]);
149
+ return true;
150
+ }
151
+
152
+ async function handleSubscribe(
153
+ user: User,
154
+ tokenId: string,
155
+ authorize: EventsAuthorizer,
156
+ rawParams: unknown,
157
+ ) {
158
+ const key = parseKey(rawParams);
159
+ const secretText = key.delivery.secret;
160
+ const secret = parseWebhookSecret(secretText);
161
+ if (!secret) {
162
+ throw invalidParams("delivery.secret must be whsec_ followed by base64 of 24 to 64 bytes");
163
+ }
164
+ const ttlMs = grantTtlMs(asRecord(rawParams).ttlMs);
165
+ if (!(await authorize("events/subscribe"))) {
166
+ throw new EventsRpcError(EventsErrorCode.Forbidden, "Forbidden");
167
+ }
168
+ if (key.arguments.taskId) {
169
+ const task = await getTaskById(key.arguments.taskId);
170
+ // One answer for "missing" and "not yours", so the filter is not an existence oracle.
171
+ if (!task || task.requestedByUserId !== user.id) {
172
+ throw new EventsRpcError(EventsErrorCode.Forbidden, "taskId is not one of your tasks");
173
+ }
174
+ }
175
+
176
+ const now = Date.now();
177
+ const nowIso = new Date(now).toISOString();
178
+ await deleteExpiredSubscriptions(nowIso);
179
+ const id = subscriptionIdFor(user.id, key.url, key.name, key.argumentsJson);
180
+ const previous = await getSubscription(id);
181
+ const refreshing = previous !== null && previous.expiresAt > nowIso;
182
+ // Checked again inside the upsert transaction; this early check keeps a
183
+ // capped user from sending verification POSTs to new URLs.
184
+ if (
185
+ !refreshing &&
186
+ (await countLiveSubscriptions(user.id, nowIso)) >= MAX_SUBSCRIPTIONS_PER_USER
187
+ ) {
188
+ throw resourceExhausted();
189
+ }
190
+
191
+ let verifiedAt = await latestVerification(
192
+ user.id,
193
+ key.url,
194
+ new Date(now - VERIFICATION_CACHE_MS).toISOString(),
195
+ nowIso,
196
+ );
197
+ if (!verifiedAt) {
198
+ // Unsubscribe or expiry frees a live slot, so the live cap alone does not
199
+ // bound challenge POSTs; this budget does.
200
+ if (!takeVerificationBudget(user.id, now)) {
201
+ throw new EventsRpcError(EventsErrorCode.ResourceExhausted, "Too many verifications", {
202
+ limit: "verifications",
203
+ max: VERIFICATIONS_PER_USER_PER_HOUR,
204
+ });
205
+ }
206
+ const failure = await verifyCallbackEndpoint({ url: key.url, subscriptionId: id, secret });
207
+ if (failure) {
208
+ throw new EventsRpcError(
209
+ EventsErrorCode.CallbackEndpointError,
210
+ "Callback endpoint verification failed",
211
+ { reason: failure },
212
+ );
213
+ }
214
+ verifiedAt = nowIso;
215
+ }
216
+
217
+ const row = await upsertSubscription({
218
+ id,
219
+ userId: user.id,
220
+ tokenId,
221
+ eventName: key.name,
222
+ argumentsJson: key.argumentsJson,
223
+ url: key.url,
224
+ secret: secretText as string,
225
+ verifiedAt,
226
+ expiresAt: new Date(now + ttlMs).toISOString(),
227
+ nowIso,
228
+ rotationGraceUntil: new Date(now + ROTATION_GRACE_MS).toISOString(),
229
+ maxActivePerUser: MAX_SUBSCRIPTIONS_PER_USER,
230
+ });
231
+ if (row === "limit") throw resourceExhausted();
232
+
233
+ return {
234
+ resultType: "complete",
235
+ id: row.id,
236
+ refreshBefore: row.expiresAt,
237
+ // task.* events are emit-only: no replay, so no cursor.
238
+ cursor: null,
239
+ truncated: false,
240
+ ...(refreshing
241
+ ? {
242
+ deliveryStatus: {
243
+ active: true,
244
+ lastDeliveryAt: row.lastDeliveryAt,
245
+ lastError: row.lastError,
246
+ ...(row.failedSince ? { failedSince: row.failedSince } : {}),
247
+ },
248
+ }
249
+ : {}),
250
+ };
251
+ }
252
+
253
+ async function handleUnsubscribe(user: User, authorize: EventsAuthorizer, rawParams: unknown) {
254
+ const key = parseKey(rawParams);
255
+ if (!(await authorize("events/unsubscribe"))) {
256
+ throw new EventsRpcError(EventsErrorCode.Forbidden, "Forbidden");
257
+ }
258
+ // Idempotent: an unknown or already-expired key is a successful no-op.
259
+ await deleteSubscription(
260
+ subscriptionIdFor(user.id, key.url, key.name, key.argumentsJson),
261
+ user.id,
262
+ );
263
+ return { resultType: "complete" };
264
+ }
265
+
266
+ /**
267
+ * Advertises the events capability and registers the `events/*` handlers on
268
+ * one user session's server. Call before `connect`.
269
+ *
270
+ * Two capability keys, because the two documents disagree: SEP-3415 puts the
271
+ * extension under `capabilities.extensions[EVENTS_EXTENSION_ID]`, while the
272
+ * design sketch and OpenAI's ChatGPT guide use `capabilities.events` in the
273
+ * `initialize` result.
274
+ */
275
+ export function registerUserEvents(
276
+ server: McpServer,
277
+ user: User,
278
+ tokenId: string,
279
+ authorize: EventsAuthorizer,
280
+ ): void {
281
+ server.server.registerCapabilities({
282
+ events: {},
283
+ extensions: { [EVENTS_EXTENSION_ID]: {} },
284
+ } as ServerCapabilities);
285
+
286
+ server.server.setRequestHandler(EventsListRequestSchema, async () => ({
287
+ resultType: "complete",
288
+ events: EVENT_DESCRIPTORS,
289
+ }));
290
+ server.server.setRequestHandler(EventsSubscribeRequestSchema, async (request) =>
291
+ handleSubscribe(user, tokenId, authorize, request.params),
292
+ );
293
+ server.server.setRequestHandler(EventsUnsubscribeRequestSchema, async (request) =>
294
+ handleUnsubscribe(user, authorize, request.params),
295
+ );
296
+ }