@desplega.ai/agent-swarm 2.9.1 → 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 (502) hide show
  1. package/dist/acp-adapter-weaaxey3.js +16 -0
  2. package/dist/{acp-targets-ny75x1qy.js → acp-targets-5wyy2b9m.js} +9 -9
  3. package/dist/{actions-b9qgrmeq.js → actions-4nxq386s.js} +54 -32
  4. package/dist/{agent-fs-provision-b5dhdsbd.js → agent-fs-provision-v6enh76w.js} +4 -4
  5. package/dist/{amp-adapter-vtax2c9s.js → amp-adapter-ze3x22qn.js} +3 -3
  6. package/dist/{anthropic-messages-r5xf5hqw.js → anthropic-messages-88b7s3n9.js} +189 -37
  7. package/dist/{app-g2z15hax.js → app-kyqt8ehw.js} +7 -6
  8. package/dist/{approval-notifications-yt13wp8r.js → approval-notifications-a0db0esw.js} +7 -6
  9. package/dist/{assistant-2cgfxsgk.js → assistant-9g5jzq25.js} +26 -25
  10. package/dist/{azure-openai-responses-590s1eea.js → azure-openai-responses-jeaas6x0.js} +18 -18
  11. package/dist/{boot-args-schema-3gwy0f60.js → boot-args-schema-d7fme4q1.js} +1 -1
  12. package/dist/{boot-reembed-92g7s5zp.js → boot-reembed-6wpazmpw.js} +1 -1
  13. package/dist/{boot-reembed-mywmyp4s.js → boot-reembed-jrwxeye2.js} +1 -1
  14. package/dist/boot-scrub-sweep-52h7yntp.js +9 -0
  15. package/dist/{boot-seeds-ce7rvgq1.js → boot-seeds-kb3dxjex.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-jrrmkv3w.js} +2 -2
  17. package/dist/{claude-adapter-3m4q7735.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-c217draw.js → claude-managed-setup-9ssb7ct4.js} +4 -4
  20. package/dist/{claude-sdk-session-7fbqm51z.js → claude-sdk-session-p6t0gyse.js} +10941 -10412
  21. package/dist/{cli-2czxfnvj.js → cli-075ccjh6.js} +961 -178
  22. package/dist/{cli-fkef327x.js → cli-0bgj4rh5.js} +3 -3
  23. package/dist/{cli-1jykg0py.js → cli-14xdms9a.js} +41 -28
  24. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  25. package/dist/{cli-bkjdknnp.js → cli-1h4njv9y.js} +177 -7
  26. package/dist/{cli-6ym4jhzp.js → cli-27fat7st.js} +7 -7
  27. package/dist/{cli-kxx4k2jw.js → cli-2aacfdcn.js} +5 -5
  28. package/dist/{cli-fh97xn30.js → cli-2gvdvsxj.js} +3 -3
  29. package/dist/{cli-f9gz2vyj.js → cli-2jtfm8kh.js} +10 -10
  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-bnqncekd.js → cli-453497a0.js} +44 -17
  33. package/dist/{cli-jm0hvmz2.js → cli-4aswccje.js} +2 -2
  34. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  35. package/dist/{cli-vyff45ve.js → cli-4g323fjh.js} +772 -515
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-gfy38pvt.js → cli-4kzp7r0q.js} +8 -8
  38. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  39. package/dist/{cli-mjw0yf82.js → cli-5ptj757f.js} +1 -1
  40. package/dist/{cli-pyjn0qhk.js → cli-6a3j25xd.js} +348 -196
  41. package/dist/{cli-hnamkvnc.js → cli-6c9ve77f.js} +2 -2
  42. package/dist/{cli-mw620q3n.js → cli-6n7y5ypy.js} +1 -1
  43. package/dist/{cli-g0vv9dg4.js → cli-6p8p2e6r.js} +19 -12
  44. package/dist/{cli-jwampxxq.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-p4kckx1z.js → cli-892y3vfp.js} +13 -13
  48. package/dist/cli-8mfdbdhe.js +43 -0
  49. package/dist/{cli-mkwkwq81.js → cli-8zmpwe79.js} +29 -16
  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-f8x9drqr.js → cli-9knhkkgr.js} +19 -5
  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-zr6qy15y.js → cli-a02habn6.js} +427 -145
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-h9yqfzx9.js → cli-a6q6x15h.js} +11 -10
  59. package/dist/{cli-bg63qmsx.js → cli-atm0hkes.js} +11 -11
  60. package/dist/{cli-m7zvgt57.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-xag7btpe.js → cli-bq97k63w.js} +2 -2
  64. package/dist/{cli-pb2ay3sh.js → cli-cstggwq7.js} +5 -5
  65. package/dist/{cli-f3jyzq4g.js → cli-czvvnfr9.js} +3 -3
  66. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  67. package/dist/{cli-nafvvsp8.js → cli-djt6wmrc.js} +9 -9
  68. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  69. package/dist/{cli-8zh9nrew.js → cli-f7dhm7hh.js} +1 -1
  70. package/dist/cli-f8yhybxr.js +321 -0
  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-w4n323t3.js → cli-h2qtafm4.js} +19 -19
  74. package/dist/{cli-psffsanb.js → cli-ha4ek2nb.js} +6 -1
  75. package/dist/{cli-dgs10ttj.js → cli-hnh8erra.js} +2 -2
  76. package/dist/{cli-w16kwbzw.js → cli-htymm48w.js} +1 -1
  77. package/dist/{cli-2xs8tsf7.js → cli-j2r1apqm.js} +152 -67
  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-67mwzr35.js → cli-k4r5sfaj.js} +7 -7
  81. package/dist/{cli-rq5rpv6k.js → cli-kbm659dk.js} +2 -2
  82. package/dist/{cli-j7svy295.js → cli-m00c47q6.js} +114 -31
  83. package/dist/{cli-m7c2380k.js → cli-mhrr4d5b.js} +99 -14
  84. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  85. package/dist/{cli-vt89089n.js → cli-n6ygvrrm.js} +4 -4
  86. package/dist/{cli-jaw5v1sy.js → cli-nbakg5xh.js} +3 -3
  87. package/dist/{cli-nbt14he0.js → cli-nc39ym5q.js} +8 -8
  88. package/dist/{cli-tvc4jag9.js → cli-p1a4khta.js} +8 -8
  89. package/dist/{cli-t9ga4qmb.js → cli-p8zqbbt1.js} +40 -33
  90. package/dist/{cli-fjggej24.js → cli-ph95yejc.js} +2 -2
  91. package/dist/{cli-m0cy2vyf.js → cli-q4z9s6zs.js} +5 -5
  92. package/dist/cli-q71g5q39.js +404 -0
  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-jkw6ptfw.js → cli-raqw9fw9.js} +28 -17
  98. package/dist/cli-rhsc2zyx.js +68 -0
  99. package/dist/{cli-sn650d7x.js → cli-rpmw4fsv.js} +68 -20
  100. package/dist/{boot-scrub-sweep-7dkdzqxx.js → cli-rwgwen5v.js} +9 -10
  101. package/dist/{cli-3j873zxq.js → cli-rytq7dm2.js} +261 -6
  102. package/dist/{cli-zh0e5x7p.js → cli-s9twe4x0.js} +71 -22
  103. package/dist/{cli-2dq9yv8p.js → cli-t2s7j5cy.js} +2 -2
  104. package/dist/{cli-wn13hhdt.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-br0924pw.js → cli-v3zcnr8g.js} +1 -1
  108. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  109. package/dist/{cli-ysvspf5e.js → cli-vy3fn0mz.js} +4 -4
  110. package/dist/{cli-7sf9sb0w.js → cli-w5dar1bk.js} +1 -1
  111. package/dist/{cli-2yjj3e31.js → cli-wz4e5am2.js} +12 -10
  112. package/dist/{cli-td9tb872.js → cli-xqbqwpxr.js} +14 -14
  113. package/dist/{cli-32djehja.js → cli-ynph3b70.js} +11137 -8332
  114. package/dist/{cli-mhapr559.js → cli-yvzxbztc.js} +9 -4
  115. package/dist/{cli-v57d7fmm.js → cli-yzxqwcvq.js} +25 -27
  116. package/dist/{cli-y2ewxhth.js → cli-zb1hff00.js} +16 -16
  117. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  118. package/dist/{cli-ctx0b85j.js → cli-zhn4r1rz.js} +757 -157
  119. package/dist/{cli-6945ywhr.js → cli-zqq57pgx.js} +9 -7
  120. package/dist/cli.js +30 -29
  121. package/dist/{cloudflare-workers-ai-system-one-9y1zx3pt.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  122. package/dist/{codex-adapter-n656pvb8.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-p0fbv5y9.js → codex-session-runner-xn63q3h7.js} +9 -9
  126. package/dist/{commands-gwea8z5p.js → commands-ctey7tr5.js} +3 -3
  127. package/dist/{controller-t67c3grh.js → controller-rqhbppg9.js} +4 -4
  128. package/dist/{controllers-connect-ks155r0h.js → controllers-connect-w3qbpbt1.js} +22 -21
  129. package/dist/core-df1n049h.js +39 -0
  130. package/dist/{cursor-adapter-ygwrtmkv.js → cursor-adapter-r819hf1a.js} +2 -2
  131. package/dist/{db-kpmx06s9.js → db-2ah39cyx.js} +2 -2
  132. package/dist/{db-rb2xqdb1.js → db-p5drc1d1.js} +3 -3
  133. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-bc6g0x29.js} +1 -1
  134. package/dist/{dispatcher-31sm0ej2.js → dispatcher-x6w14pde.js} +19 -18
  135. package/dist/{docker-09tkkg0n.js → docker-6c4reetq.js} +51 -14
  136. package/dist/{dsh-adapter-qyxh0w31.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-00wjscn6.js → easter-egg-3d-1y6r9gxy.js} +1 -1
  140. package/dist/{embedding-space-qhw4g68n.js → embedding-space-z6ptw3jk.js} +6 -6
  141. package/dist/{embeddings-zdv9ke6x.js → embeddings-0sxb1d2h.js} +1 -1
  142. package/dist/{event-bus-xr83x566.js → event-bus-swr88jg5.js} +1 -1
  143. package/dist/{execute-zna8wwr7.js → execute-6m1ex8ce.js} +8 -4
  144. package/dist/{external-channel-1ac6t56s.js → external-channel-ezer7pk0.js} +2 -2
  145. package/dist/fx-adapter-zwmps9re.js +19 -0
  146. package/dist/{google-generative-ai-maq6c9bf.js → google-generative-ai-sw77egmr.js} +13 -13
  147. package/dist/{google-vertex-2jgsw2nb.js → google-vertex-rrw93g8h.js} +13 -13
  148. package/dist/grok-adapter-q0avf919.js +19 -0
  149. package/dist/handlers-g5jq0e4q.js +36 -0
  150. package/dist/{heartbeat-2f6z4kdx.js → heartbeat-6c4fr49t.js} +22 -21
  151. package/dist/{hook-8y0gvtp1.js → hook-02rt5tvq.js} +8 -8
  152. package/dist/{hook-w1skzaqc.js → hook-t1c5avbv.js} +5 -5
  153. package/dist/{http-wghxvpef.js → http-qa3h32a1.js} +2659 -355
  154. package/dist/index-1f6m47mq.js +37 -0
  155. package/dist/index-1p1mpqda.js +36 -0
  156. package/dist/{index-rv89fvzf.js → index-akbgsdhh.js} +25 -24
  157. package/dist/{index-9zkchs9t.js → index-e42j998x.js} +190 -15
  158. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  159. package/dist/{index-s71ez27v.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-8zn8nxn5.js → index-qpjk2hxk.js} +1 -1
  163. package/dist/index-tnkd410q.js +41 -0
  164. package/dist/k8s-7jrh5va2.js +276 -0
  165. package/dist/{keepalive-sh02349h.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-yj0dcjja.js → maintenance-g7v15tj1.js} +1 -1
  169. package/dist/{mistral-conversations-0c30em7t.js → mistral-conversations-w4bncwbt.js} +11 -11
  170. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  171. package/dist/{oauth-refresh-sweep-d9xedk66.js → oauth-refresh-sweep-ywgf8tbr.js} +3 -3
  172. package/dist/{onboard-dpgjn03r.js → onboard-m3fedypq.js} +6 -6
  173. package/dist/{openai-codex-responses-bkcd8pjj.js → openai-codex-responses-70g39cgz.js} +24 -18
  174. package/dist/{openai-completions-f3n69rep.js → openai-completions-cv3hp4h5.js} +33 -26
  175. package/dist/{openai-decisions-q3hh60wr.js → openai-decisions-fyq1p9f9.js} +2 -2
  176. package/dist/{openai-responses-gbh0wfqe.js → openai-responses-trsvnks6.js} +24 -22
  177. package/dist/{opencode-adapter-2d31cpjc.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-1skarpfq.js → otel-impl-3ehm1hgc.js} +2 -2
  180. package/dist/{pending-bfmxtx0g.js → pending-fwj2fatd.js} +20 -19
  181. package/dist/{pi-messages-zebyt7gb.js → pi-messages-zk3g4esn.js} +6 -6
  182. package/dist/{pi-mono-adapter-gvppnasy.js → pi-mono-adapter-xdeesvc4.js} +18 -17
  183. package/dist/{pricing-refresh-c6b325mk.js → pricing-refresh-4j8dzvxg.js} +2 -2
  184. package/dist/{rbac-roles-h80qbdbs.js → rbac-roles-8msjr07m.js} +3 -3
  185. package/dist/{rbac-roles-zfcx68tx.js → rbac-roles-n7t2acv8.js} +2 -2
  186. package/dist/{render-v2-nx20t3rb.js → render-v2-j7qggj8h.js} +7 -6
  187. package/dist/{resume-5ep8agan.js → resume-hj1mn65y.js} +9 -8
  188. package/dist/{runtime-r3pj4mce.js → runtime-z31mdsgv.js} +2 -2
  189. package/dist/{session-access-n7p3m15b.js → session-access-w38fh09a.js} +4 -4
  190. package/dist/{session-source-backfill-v8mt0zwn.js → session-source-backfill-ax6qxv20.js} +3 -3
  191. package/dist/{setup-z1psaqhe.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-f2en2knd.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  195. package/dist/user-merge-jobs-mvheb3ed.js +22 -0
  196. package/dist/{virtual-modules-rrbjdpxn.js → virtual-modules-w2qk2wew.js} +32 -10
  197. package/dist/{work-objects-4aghh73z.js → work-objects-4ahy5es5.js} +22 -21
  198. package/dist/worker-ews1nyhw.js +75 -0
  199. package/dist/{worker-follow-up-166zmex1.js → worker-follow-up-1gs4aw7y.js} +19 -18
  200. package/dist/{x-wg164ss9.js → x-3wr8c5sh.js} +2 -2
  201. package/openapi.json +2576 -388
  202. package/package.json +11 -10
  203. package/src/be/boot-seeds.ts +7 -1
  204. package/src/be/db/model-groups.ts +238 -0
  205. package/src/be/db/model-profiles.ts +26 -8
  206. package/src/be/db/request-composition.ts +190 -0
  207. package/src/be/db/runtime.ts +15 -0
  208. package/src/be/db/session-costs.ts +8 -2
  209. package/src/be/db/slack-trees.ts +220 -10
  210. package/src/be/db/tasks/human-free.ts +3 -2
  211. package/src/be/db/tasks/read.ts +3 -2
  212. package/src/be/db/tasks/write.ts +2 -1
  213. package/src/be/db/user-references.ts +75 -0
  214. package/src/be/db/users/references.ts +185 -0
  215. package/src/be/db/workflow-run-retention.ts +101 -0
  216. package/src/be/db-client.ts +93 -20
  217. package/src/be/db-retention-defaults.ts +46 -0
  218. package/src/be/db-retention.ts +55 -6
  219. package/src/be/db.ts +32 -57
  220. package/src/be/key-window-usage.ts +1 -0
  221. package/src/be/mcp-events/catalog.ts +108 -0
  222. package/src/be/mcp-events/dispatcher.ts +202 -0
  223. package/src/be/mcp-events/protocol.ts +296 -0
  224. package/src/be/mcp-events/store.ts +231 -0
  225. package/src/be/mcp-events/webhook.ts +226 -0
  226. package/src/be/memory/demotion-evidence.ts +34 -0
  227. package/src/be/memory/providers/sqlite-store.ts +110 -24
  228. package/src/be/memory/reranker.ts +34 -12
  229. package/src/be/memory/review-recall-filter.ts +105 -0
  230. package/src/be/memory/search-candidates.ts +16 -5
  231. package/src/be/memory/types.ts +16 -0
  232. package/src/be/migrations/312_task_ui_action_runs_repeatable.sql +6 -0
  233. package/src/be/migrations/314_model_groups.sql +85 -0
  234. package/src/be/migrations/318_superseded_workflow_cut_backfill.sql +22 -0
  235. package/src/be/migrations/319_user_fk_indexes.sql +153 -0
  236. package/src/be/migrations/320_session_costs_kind.sql +4 -0
  237. package/src/be/migrations/321_user_merge_jobs.sql +52 -0
  238. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  239. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  240. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  241. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  242. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  243. package/src/be/migrations/330_request_composition.sql +22 -0
  244. package/src/be/model-profile-check.ts +1 -1
  245. package/src/be/multi-runtime.ts +32 -4
  246. package/src/be/pricing-normalize.ts +2 -0
  247. package/src/be/rbac-roles.ts +6 -4
  248. package/src/be/runtime-pools/controllers.ts +18 -3
  249. package/src/be/runtime-pools/db.ts +35 -9
  250. package/src/be/runtime-pools/supervisor.ts +57 -3
  251. package/src/be/scripts/db.ts +11 -0
  252. package/src/be/scripts/typecheck.ts +2 -0
  253. package/src/be/seed-model-groups.ts +86 -0
  254. package/src/be/seed-model-profiles.ts +20 -13
  255. package/src/be/seed-scripts/catalog/dreaming-gather.ts +165 -1
  256. package/src/be/swarm-config-guard.ts +44 -2
  257. package/src/be/task-ui-spec.ts +102 -1
  258. package/src/be/user-merge-jobs.ts +564 -0
  259. package/src/be/users.ts +41 -23
  260. package/src/commands/context-preamble.ts +11 -4
  261. package/src/commands/credential-outcome-report.ts +33 -9
  262. package/src/commands/e2b-stack-wizard.tsx +12 -6
  263. package/src/commands/onboard/agent-fs-version.ts +1 -1
  264. package/src/commands/onboard/compose-generator.ts +1 -1
  265. package/src/commands/onboard/env-generator.ts +1 -1
  266. package/src/commands/provider-credentials.ts +1 -1
  267. package/src/commands/runner.ts +116 -12
  268. package/src/extensions/catalog.generated.json +1 -1
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/extensions/contract.ts +15 -0
  271. package/src/extensions/dispatcher.ts +14 -4
  272. package/src/github/app.ts +59 -14
  273. package/src/github/handlers.ts +57 -0
  274. package/src/github/types.ts +4 -0
  275. package/src/http/all-routes.ts +4 -0
  276. package/src/http/approval-requests.ts +5 -1
  277. package/src/http/auth.ts +3 -1
  278. package/src/http/config.ts +36 -2
  279. package/src/http/core.ts +2 -0
  280. package/src/http/github-token.ts +66 -0
  281. package/src/http/index.ts +34 -0
  282. package/src/http/mcp-user.ts +11 -8
  283. package/src/http/mcp.ts +58 -42
  284. package/src/http/memory.ts +19 -6
  285. package/src/http/model-groups.ts +277 -0
  286. package/src/http/model-profiles.ts +30 -13
  287. package/src/http/prompt-templates.ts +1 -0
  288. package/src/http/request-composition.ts +310 -0
  289. package/src/http/tasks.ts +46 -6
  290. package/src/http/tool-hooks.ts +140 -0
  291. package/src/http/tool-schema-estimate.ts +95 -0
  292. package/src/http/users.ts +142 -19
  293. package/src/http/workflows.ts +37 -1
  294. package/src/integrations/chat-sdk/inbound.ts +8 -2
  295. package/src/integrations/chat-sdk/limits.ts +8 -3
  296. package/src/prompts/base-prompt.ts +133 -7
  297. package/src/prompts/resolver.ts +41 -2
  298. package/src/providers/acp-targets.ts +2 -2
  299. package/src/providers/amp-adapter.ts +1 -1
  300. package/src/providers/opencode-adapter.ts +72 -1
  301. package/src/providers/opencode-swarm-plugin.ts +22 -3
  302. package/src/providers/pi-mono-adapter.ts +1 -0
  303. package/src/providers/pi-mono-extension.ts +71 -0
  304. package/src/providers/pricing-sources.md +13 -0
  305. package/src/providers/request-composition-hook.ts +312 -0
  306. package/src/providers/types.ts +5 -0
  307. package/src/rbac/legacy-policy.ts +1 -0
  308. package/src/rbac/permissions.ts +5 -0
  309. package/src/runtime-providers/controller-protocol.ts +7 -0
  310. package/src/runtime-providers/docker.ts +80 -12
  311. package/src/runtime-providers/index.ts +7 -5
  312. package/src/runtime-providers/k8s.ts +355 -0
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/scripts-runtime/types/stdlib.d.ts +2 -0
  316. package/src/scripts-runtime/types/swarm-extension.d.ts +16 -1
  317. package/src/scripts-runtime/types/swarm-sdk.d.ts +2 -0
  318. package/src/server-user.ts +16 -1
  319. package/src/slack/ack.ts +10 -5
  320. package/src/slack/actions.ts +36 -13
  321. package/src/slack/app.ts +2 -0
  322. package/src/slack/assistant.ts +4 -4
  323. package/src/slack/blocks.ts +26 -5
  324. package/src/slack/handlers.ts +3 -3
  325. package/src/slack/reaction-shortcode.ts +23 -2
  326. package/src/slack/render-v2.ts +344 -200
  327. package/src/slack/responses.ts +7 -5
  328. package/src/slack/thread-buffer.ts +3 -3
  329. package/src/slack/tree-visibility.ts +64 -0
  330. package/src/tasks/worker-follow-up.ts +127 -17
  331. package/src/tests/acp-adapter.test.ts +26 -0
  332. package/src/tests/azure-devops-outbound.test.ts +47 -14
  333. package/src/tests/base-prompt.test.ts +149 -1
  334. package/src/tests/chat-sdk-relay.test.ts +21 -1
  335. package/src/tests/check-playwright-version.test.ts +33 -0
  336. package/src/tests/check-pr-body.test.ts +43 -0
  337. package/src/tests/context-preamble-budget.test.ts +65 -0
  338. package/src/tests/credential-check.test.ts +14 -6
  339. package/src/tests/credential-outcome-report.test.ts +81 -1
  340. package/src/tests/db-client.test.ts +168 -0
  341. package/src/tests/db-retention-defaults.test.ts +244 -0
  342. package/src/tests/db-retention.test.ts +2 -1
  343. package/src/tests/db-runtime.test.ts +2 -1
  344. package/src/tests/deploy-guard.test.ts +7 -7
  345. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  346. package/src/tests/deploy-select.test.ts +83 -0
  347. package/src/tests/dreaming-gather-corrections.test.ts +467 -0
  348. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  349. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  350. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  351. package/src/tests/env-flag.test.ts +4 -2
  352. package/src/tests/event-loop-lag.test.ts +16 -20
  353. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  354. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  355. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  356. package/src/tests/fixtures/extensions/native-tool-recorder/hooks.ts +26 -0
  357. package/src/tests/fixtures/extensions/native-tool-recorder/manifest.json +10 -0
  358. package/src/tests/fixtures/onboard/content.compose.yml.txt +1 -1
  359. package/src/tests/fixtures/onboard/content.env.txt +1 -1
  360. package/src/tests/fixtures/onboard/dev.compose.yml.txt +1 -1
  361. package/src/tests/fixtures/onboard/dev.env.txt +1 -1
  362. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +1 -1
  363. package/src/tests/fixtures/onboard/full-all.env.txt +1 -1
  364. package/src/tests/fixtures/onboard/full.compose.yml.txt +1 -1
  365. package/src/tests/fixtures/onboard/full.env.txt +1 -1
  366. package/src/tests/fixtures/onboard/research.compose.yml.txt +1 -1
  367. package/src/tests/fixtures/onboard/research.env.txt +1 -1
  368. package/src/tests/fixtures/onboard/solo.compose.yml.txt +1 -1
  369. package/src/tests/fixtures/onboard/solo.env.txt +1 -1
  370. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  371. package/src/tests/github-event-filter.test.ts +8 -0
  372. package/src/tests/github-handlers-inline-comments.test.ts +2 -0
  373. package/src/tests/github-handlers-reactions.test.ts +4 -0
  374. package/src/tests/github-handlers.test.ts +3 -0
  375. package/src/tests/github-installation-token-route.test.ts +199 -0
  376. package/src/tests/github-sender-trust.test.ts +223 -0
  377. package/src/tests/http-users.test.ts +142 -41
  378. package/src/tests/k8s-pool-smoke.test.ts +190 -0
  379. package/src/tests/key-window-usage.test.ts +15 -0
  380. package/src/tests/mcp-user-events.test.ts +708 -0
  381. package/src/tests/memory-key-paths.test.ts +4 -1
  382. package/src/tests/memory-rater-store.test.ts +35 -1
  383. package/src/tests/memory-reranker.test.ts +39 -4
  384. package/src/tests/memory-review-recall-filter.test.ts +205 -0
  385. package/src/tests/memory-search-stall.test.ts +421 -0
  386. package/src/tests/migration-318-superseded-workflow-cut-backfill.test.ts +74 -0
  387. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  388. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  389. package/src/tests/model-groups-api.test.ts +415 -0
  390. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  391. package/src/tests/model-profiles-api.test.ts +1 -0
  392. package/src/tests/opencode-adapter.test.ts +86 -0
  393. package/src/tests/operator-granted-credentials.test.ts +7 -2
  394. package/src/tests/operator-granted-role-wire.test.ts +2 -1
  395. package/src/tests/pi-mono-extension.test.ts +168 -0
  396. package/src/tests/preload-env.test.ts +61 -1
  397. package/src/tests/preload.ts +22 -0
  398. package/src/tests/prompt-template-resolver.test.ts +85 -0
  399. package/src/tests/rbac-engine.test.ts +1 -0
  400. package/src/tests/reload-config.test.ts +45 -0
  401. package/src/tests/request-composition.test.ts +447 -0
  402. package/src/tests/runner-max-concurrent.test.ts +86 -0
  403. package/src/tests/runtime-k8s-pools.test.ts +142 -0
  404. package/src/tests/runtime-pools-db.test.ts +122 -2
  405. package/src/tests/runtime-pools-http.test.ts +47 -2
  406. package/src/tests/runtime-provider-registration.test.ts +13 -14
  407. package/src/tests/runtime-providers-docker.test.ts +192 -1
  408. package/src/tests/runtime-providers-k8s.test.ts +430 -0
  409. package/src/tests/runtime-remote-controller.test.ts +64 -1
  410. package/src/tests/runtime-supervisor.test.ts +101 -0
  411. package/src/tests/script-connections.test.ts +21 -1
  412. package/src/tests/short-id.test.ts +23 -0
  413. package/src/tests/slack-blocks.test.ts +87 -0
  414. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  415. package/src/tests/slack-reaction-config.test.ts +38 -2
  416. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  417. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  418. package/src/tests/slack-render-v2.test.ts +737 -11
  419. package/src/tests/spec-base-url.test.ts +13 -1
  420. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  421. package/src/tests/system-one-decide-session-cost.test.ts +196 -0
  422. package/src/tests/task-session-prompts.test.ts +37 -0
  423. package/src/tests/task-ui-action-route.test.ts +59 -1
  424. package/src/tests/task-ui-script-actions.test.ts +517 -0
  425. package/src/tests/tool-hooks-http.test.ts +187 -0
  426. package/src/tests/ui-spec-script-actions-config.test.ts +196 -0
  427. package/src/tests/user-delete-perf.test.ts +348 -0
  428. package/src/tests/user-merge-jobs.test.ts +680 -0
  429. package/src/tests/vcs-provider.test.ts +25 -5
  430. package/src/tests/vendored-openapi.test.ts +13 -1
  431. package/src/tests/webhook-filter.test.ts +327 -0
  432. package/src/tests/workflow-agent-task-retry.test.ts +62 -0
  433. package/src/tests/workflow-async-v2.test.ts +19 -16
  434. package/src/tests/workflow-definition-telemetry.test.ts +15 -5
  435. package/src/tests/workflow-e2e.test.ts +1 -9
  436. package/src/tests/workflow-finalization-races.test.ts +553 -0
  437. package/src/tests/workflow-foreach-supersede-retry.test.ts +10 -0
  438. package/src/tests/workflow-foreach.test.ts +2 -0
  439. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  440. package/src/tests/workflow-http-v2.test.ts +132 -2
  441. package/src/tests/workflow-idempotency.test.ts +41 -0
  442. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  443. package/src/tests/workflow-parallel-park.test.ts +297 -0
  444. package/src/tests/workflow-replay.test.ts +10 -1
  445. package/src/tests/workflow-retry-v2.test.ts +57 -21
  446. package/src/tests/workflow-retry-validation.test.ts +13 -13
  447. package/src/tests/workflow-runs-retention.test.ts +533 -0
  448. package/src/tests/workflow-script-principal.test.ts +7 -2
  449. package/src/tests/workflow-tla-races.test.ts +7 -2
  450. package/src/tests/workflow-triggers-v2.test.ts +329 -0
  451. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  452. package/src/tests/workflow-wait-event.test.ts +137 -3
  453. package/src/tests/workflow-wait-poller.test.ts +94 -0
  454. package/src/tests/workflow-wait-time.test.ts +7 -3
  455. package/src/tests/workflow-wait.test.ts +26 -0
  456. package/src/tests/workflow-wait.ts +44 -0
  457. package/src/tools/memory-search.ts +14 -3
  458. package/src/tools/store-progress.ts +26 -26
  459. package/src/tools/swarm-config/delete-config.ts +12 -1
  460. package/src/tools/swarm-config/set-config.ts +8 -0
  461. package/src/tools/system-one-decide.ts +113 -3
  462. package/src/tools/utils.ts +4 -1
  463. package/src/tools/workflows/create-workflow.ts +7 -1
  464. package/src/tools/workflows/update-workflow.ts +8 -2
  465. package/src/types.ts +284 -2
  466. package/src/ui-spec/actions.ts +30 -4
  467. package/src/ui-spec/schema.ts +38 -0
  468. package/src/ui-spec/script-actions.ts +340 -0
  469. package/src/ui-spec/script-allowlist.ts +48 -0
  470. package/src/utils/credentials.ts +7 -0
  471. package/src/utils/short-id.ts +20 -14
  472. package/src/utils/task-ui-spec.ts +16 -4
  473. package/src/vcs/index.ts +12 -2
  474. package/src/workflows/checkpoint.ts +18 -0
  475. package/src/workflows/engine.ts +38 -10
  476. package/src/workflows/executors/system-one-decision.ts +2 -2
  477. package/src/workflows/foreach-driver.ts +42 -4
  478. package/src/workflows/recovery.ts +6 -1
  479. package/src/workflows/resume.ts +14 -5
  480. package/src/workflows/retry-poller.ts +17 -4
  481. package/src/workflows/successor-routing.ts +108 -0
  482. package/src/workflows/task-step-routing.ts +35 -12
  483. package/src/workflows/triggers.ts +25 -8
  484. package/src/workflows/wait-poller.ts +6 -2
  485. package/src/workflows/webhook-filter.ts +203 -0
  486. package/templates/extensions/manifest.schema.json +13 -0
  487. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  488. package/templates/skills/swarm-docs/content.md +4 -0
  489. package/templates/skills/ui-spec/content.md +7 -1
  490. package/templates/workflows/dreaming/content.md +1 -1
  491. package/dist/acp-adapter-g909b5hw.js +0 -16
  492. package/dist/cli-b91nz213.js +0 -93
  493. package/dist/fx-adapter-sk7n0fzc.js +0 -19
  494. package/dist/grok-adapter-sjbcm5ew.js +0 -19
  495. package/dist/handlers-yzy0c87x.js +0 -35
  496. package/dist/index-25pvya7q.js +0 -40
  497. package/dist/index-2t4859r5.js +0 -35
  498. package/dist/index-cxca2t8y.js +0 -36
  499. package/dist/lead-gk4h5eg7.js +0 -74
  500. package/dist/thread-buffer-a1re2r9r.js +0 -38
  501. package/dist/worker-3dyyb8ev.js +0 -74
  502. /package/dist/{node-dqm4xgxw.js → node-2wfcey7d.js} +0 -0
@@ -916,7 +916,7 @@ export class SystemOneDecisionExecutor extends BaseExecutor<
916
916
  async decide(
917
917
  config: SystemOneDecisionConfig,
918
918
  ): Promise<
919
- | { ok: true; output: SystemOneDecisionOutput }
919
+ | { ok: true; output: SystemOneDecisionOutput; provider: SystemOneProviderId }
920
920
  | { ok: false; error: string; deploymentRefused?: true }
921
921
  > {
922
922
  const providerId = config.provider ?? (await this.defaultProvider());
@@ -980,7 +980,7 @@ export class SystemOneDecisionExecutor extends BaseExecutor<
980
980
  }
981
981
  throw err;
982
982
  }
983
- return { ok: true, output: decision };
983
+ return { ok: true, output: decision, provider: providerId };
984
984
  }
985
985
 
986
986
  /**
@@ -49,6 +49,7 @@ import {
49
49
  import { getSecretInputKeys } from "./input";
50
50
  import { resolveNodeTimeoutMs, startStepDeadline } from "./node-timeout";
51
51
  import { rebuildNodeExecutionInput } from "./step-input";
52
+ import { claimAndOweWalk, type SuccessorWalkDebt } from "./successor-routing";
52
53
 
53
54
  export { FOREACH_ITEMS_WAIT_FOR };
54
55
 
@@ -69,6 +70,12 @@ export interface ForeachDriveResult {
69
70
  successors: WorkflowNode[];
70
71
  /** How many children this drive claimed (queued or orphaned). */
71
72
  claimed: number;
73
+ /**
74
+ * The join's hold on the run, taken in the transaction that closed it, when
75
+ * `successors` is nonempty. Pass it to the `walkGraph` that routes them, or
76
+ * release it.
77
+ */
78
+ successorDebt?: SuccessorWalkDebt;
72
79
  }
73
80
 
74
81
  const NOT_JOINED: ForeachDriveResult = { joined: false, successors: [], claimed: 0 };
@@ -125,6 +132,23 @@ export async function driveForeach(
125
132
  parentNodeId: string,
126
133
  registry: ExecutorRegistry,
127
134
  options: { ctx?: Record<string, unknown> } = {},
135
+ ): Promise<ForeachDriveResult> {
136
+ const owed: { debt?: SuccessorWalkDebt } = {};
137
+ try {
138
+ return await driveForeachOwed(runId, parentNodeId, registry, options, owed);
139
+ } catch (err) {
140
+ // The join closed, then the drive's cleanup threw: no walk takes the hold.
141
+ owed.debt?.release();
142
+ throw err;
143
+ }
144
+ }
145
+
146
+ async function driveForeachOwed(
147
+ runId: string,
148
+ parentNodeId: string,
149
+ registry: ExecutorRegistry,
150
+ options: { ctx?: Record<string, unknown> },
151
+ owed: { debt?: SuccessorWalkDebt },
128
152
  ): Promise<ForeachDriveResult> {
129
153
  const run = await getWorkflowRun(runId);
130
154
  if (!run || (run.status !== "running" && run.status !== "waiting")) return NOT_JOINED;
@@ -176,12 +200,20 @@ export async function driveForeach(
176
200
  item: items.find((candidate) => candidate[itemKeyField] === childItemKey(child)),
177
201
  });
178
202
  if (!outcome) continue;
179
- const settled = await settleForeachChild(def, runId, child.id, outcome, ctx, {
180
- from: ["running"],
181
- });
203
+ // The join's successors have no step row until a walk starts them:
204
+ // owe that walk from the commit that closes the join.
205
+ const settled = await claimAndOweWalk(runId, () =>
206
+ settleForeachChild(def, runId, child.id, outcome, ctx, { from: ["running"] }),
207
+ );
182
208
  ownedChildren.delete(child.id);
183
209
  if (settled.joined) {
184
- return { joined: true, successors: settled.successors, claimed: claimedTotal };
210
+ owed.debt = settled.successorDebt;
211
+ return {
212
+ joined: true,
213
+ successors: settled.successors,
214
+ claimed: claimedTotal,
215
+ successorDebt: settled.successorDebt,
216
+ };
185
217
  }
186
218
  if (settled.runFailed) {
187
219
  failedFast = child.nodeId;
@@ -270,12 +302,16 @@ export async function runForeachDrive(
270
302
  registry: ExecutorRegistry,
271
303
  ): Promise<ForeachDriveResult> {
272
304
  const release = holdWorkflowRun(runId);
305
+ let debt: SuccessorWalkDebt | undefined;
273
306
  try {
274
307
  const drive = await driveForeach(runId, parentNodeId, registry);
275
308
  if (!drive.joined) {
276
309
  await parkRunIfRunning(runId);
277
310
  return drive;
278
311
  }
312
+ // The join's debt keeps other finalizers off the run until the walk below
313
+ // takes it over.
314
+ debt = drive.successorDebt;
279
315
  const run = await getWorkflowRun(runId);
280
316
  const workflow = run ? await getRenderedWorkflow(run) : null;
281
317
  if (!run || !workflow) return drive;
@@ -289,6 +325,7 @@ export async function runForeachDrive(
289
325
  registry,
290
326
  workflow.id,
291
327
  getSecretInputKeys(workflow.input),
328
+ { successorDebt: debt },
292
329
  );
293
330
  } else {
294
331
  const { finalizeOrWait } = await import("./resume");
@@ -296,6 +333,7 @@ export async function runForeachDrive(
296
333
  }
297
334
  return drive;
298
335
  } finally {
336
+ debt?.release();
299
337
  release();
300
338
  }
301
339
  }
@@ -19,6 +19,7 @@ import {
19
19
  } from "../be/db/workflow-runs";
20
20
  import type { WorkflowRunStep } from "../types";
21
21
  import { shapeApprovalResolution } from "./approval-resolution";
22
+ import { adoptStoredContext } from "./checkpoint";
22
23
  import { loadCompletedStepRouting } from "./completed-step-routing";
23
24
  import { FAILED_TASK_OUTPUT_PREFIX } from "./constants";
24
25
  import {
@@ -38,6 +39,7 @@ import {
38
39
  resumeFromChildRun,
39
40
  resumeWaitState,
40
41
  } from "./resume";
42
+ import { hasOwedSuccessors } from "./successor-routing";
41
43
  import {
42
44
  checkpointPortStepAndResolveSuccessors,
43
45
  completeTaskStepAndResolveSuccessors,
@@ -233,7 +235,7 @@ async function completeIfSettled(runId: string, ctx: Record<string, unknown>): P
233
235
  if (run?.status !== "running") return false;
234
236
  if (await getRunLineageBlock(runId)) return false;
235
237
  const steps = await getWorkflowRunStepsByRunId(runId);
236
- if (retryPendingNodeIds(steps).size > 0) return false;
238
+ if (retryPendingNodeIds(steps).size > 0 || hasOwedSuccessors(runId)) return false;
237
239
  const latest = new Map<string, WorkflowRunStep>();
238
240
  for (const step of steps) latest.set(step.nodeId, step);
239
241
  for (const step of latest.values()) {
@@ -241,6 +243,7 @@ async function completeIfSettled(runId: string, ctx: Record<string, unknown>): P
241
243
  return false;
242
244
  }
243
245
  }
246
+ await adoptStoredContext(runId, ctx);
244
247
  await updateWorkflowRun(runId, {
245
248
  status: "completed",
246
249
  context: ctx,
@@ -344,6 +347,7 @@ async function recoverWaitingRuns(registry: ExecutorRegistry): Promise<number> {
344
347
  registry,
345
348
  workflow.id,
346
349
  secretKeys,
350
+ { successorDebt: routing.successorDebt },
347
351
  );
348
352
  }
349
353
  recovered++;
@@ -445,6 +449,7 @@ async function recoverApprovalWaitingRuns(registry: ExecutorRegistry): Promise<n
445
449
  registry,
446
450
  workflow.id,
447
451
  secretKeys,
452
+ { successorDebt: routing.successorDebt },
448
453
  );
449
454
  } else {
450
455
  await finalizeOrWait(stuck.runId);
@@ -70,6 +70,7 @@ import {
70
70
  import { getSecretInputKeys } from "./input";
71
71
  import { getMaxWorkflowStepsPerRun } from "./limits";
72
72
  import { findWorkflowReadinessProblems, formatReadinessProblems } from "./readiness";
73
+ import { hasOwedSuccessors } from "./successor-routing";
73
74
  import {
74
75
  checkpointPortStepAndResolveSuccessors,
75
76
  completeTaskStepAndResolveSuccessors,
@@ -297,6 +298,7 @@ async function resumeFromTaskCompletionUnguarded(
297
298
  registry,
298
299
  workflow.id,
299
300
  secretKeys,
301
+ { successorDebt: routing.successorDebt },
300
302
  );
301
303
  } else {
302
304
  await finalizeOrWait(run.id);
@@ -318,9 +320,10 @@ export async function finalizeOrWait(runId: string): Promise<void> {
318
320
  if (status !== "running" && status !== "waiting") return;
319
321
  if (await getRunLineageBlock(runId)) return;
320
322
  const steps = await getWorkflowRunStepsByRunId(runId);
321
- // A branch still executing belongs to a live walk, which finalizes the
322
- // run itself; its finalizer only acts on a `running` run.
323
- if (hasRunningStep(steps)) {
323
+ // A branch still executing, or a completed step whose successors have no
324
+ // row yet, belongs to a live walk, which finalizes the run itself; its
325
+ // finalizer only acts on a `running` run.
326
+ if (hasRunningStep(steps) || hasOwedSuccessors(runId)) {
324
327
  if (status === "waiting") await updateWorkflowRun(runId, { status: "running" });
325
328
  return;
326
329
  }
@@ -439,6 +442,7 @@ async function handleTaskFailureUnguarded(
439
442
  registry,
440
443
  workflow.id,
441
444
  secretKeys,
445
+ { successorDebt: routing.successorDebt },
442
446
  );
443
447
  } else {
444
448
  await finalizeOrWait(run.id);
@@ -960,6 +964,7 @@ async function resumeFromApprovalResolutionUnguarded(
960
964
  registry,
961
965
  workflow.id,
962
966
  secretKeys,
967
+ { successorDebt: routing.successorDebt },
963
968
  );
964
969
  } else {
965
970
  await finalizeOrWait(run.id);
@@ -1088,6 +1093,7 @@ async function resumeClaimedWait(
1088
1093
  registry,
1089
1094
  workflow.id,
1090
1095
  secretKeys,
1096
+ { successorDebt: routing.successorDebt },
1091
1097
  );
1092
1098
  } else {
1093
1099
  await finalizeOrWait(run.id);
@@ -1184,6 +1190,7 @@ export async function resumeFromChildRun(
1184
1190
  registry,
1185
1191
  workflow.id,
1186
1192
  secretKeys,
1193
+ { successorDebt: routing.successorDebt },
1187
1194
  );
1188
1195
  } else {
1189
1196
  await finalizeOrWait(run.id);
@@ -1196,6 +1203,7 @@ const CHILD_RETRY_SCHEDULED = {
1196
1203
  claimed: true,
1197
1204
  runFailed: false,
1198
1205
  successors: [] as WorkflowNode[],
1206
+ successorDebt: undefined,
1199
1207
  } as const;
1200
1208
 
1201
1209
  /** The `node.retry` of a top-level `sub-workflow` node; foreach items retry through their parent. */
@@ -1370,8 +1378,9 @@ async function processBusEvent(eventName: string, payload: unknown): Promise<voi
1370
1378
  }
1371
1379
  }
1372
1380
 
1373
- // Clean up: if all waits for this event resolved, drop the listener.
1374
- if (set.size === 0) {
1381
+ // Resuming can replace this set with a new wait for the same event. Only
1382
+ // clean up the set this handler processed, never its replacement.
1383
+ if (set.size === 0 && waitsByEvent.get(eventName) === set) {
1375
1384
  waitsByEvent.delete(eventName);
1376
1385
  const listener = listenersByEvent.get(eventName);
1377
1386
  if (listener) {
@@ -8,7 +8,12 @@ import {
8
8
  } from "../be/db";
9
9
  import { disarmWorkflowTreeRetries, getRunLineageBlock } from "../be/db/workflow-runs";
10
10
  import type { RetryPolicy } from "../types";
11
- import { checkpointStep, checkpointStepFailure, checkpointStepWaiting } from "./checkpoint";
11
+ import {
12
+ adoptStoredContext,
13
+ checkpointStep,
14
+ checkpointStepFailure,
15
+ checkpointStepWaiting,
16
+ } from "./checkpoint";
12
17
  import { getSuccessors, resolveValidationPort } from "./definition";
13
18
  import {
14
19
  failRunOnUnreadableReplay,
@@ -21,9 +26,12 @@ import type { ExecutorRegistry } from "./executors/registry";
21
26
  import { FOREACH_ITEMS_WAIT_FOR, parkAndDriveForeach, runForeachDrive } from "./foreach-driver";
22
27
  import { resolveForeachParent } from "./foreach-join";
23
28
  import { rebuildNodeExecutionInput } from "./step-input";
29
+ import { hasOwedSuccessors } from "./successor-routing";
24
30
  import { runStepValidation } from "./validation";
25
31
 
26
32
  let pollerTimeout: ReturnType<typeof setTimeout> | null = null;
33
+ /** Bumped by every stop, so a tick in flight can tell that its poller was stopped. */
34
+ let pollerGeneration = 0;
27
35
 
28
36
  /**
29
37
  * Start the retry poller.
@@ -33,6 +41,7 @@ let pollerTimeout: ReturnType<typeof setTimeout> | null = null;
33
41
  */
34
42
  export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000): void {
35
43
  if (pollerTimeout !== null) return; // Already running
44
+ const generation = pollerGeneration;
36
45
 
37
46
  async function poll(): Promise<void> {
38
47
  try {
@@ -160,6 +169,8 @@ export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000):
160
169
  drive.successors,
161
170
  registry,
162
171
  workflow.id,
172
+ undefined,
173
+ { successorDebt: drive.successorDebt },
163
174
  );
164
175
  } else {
165
176
  await completeRunIfSettled(run.id, ctx);
@@ -268,8 +279,8 @@ export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000):
268
279
  console.error("[workflows] Retry poller error:", err);
269
280
  }
270
281
 
271
- // Schedule next tick after completion
272
- pollerTimeout = setTimeout(poll, intervalMs);
282
+ // Schedule next tick after completion, unless the poller was stopped mid-tick
283
+ if (generation === pollerGeneration) pollerTimeout = setTimeout(poll, intervalMs);
273
284
  }
274
285
 
275
286
  // Start the first tick
@@ -346,7 +357,8 @@ async function completeRunIfSettled(runId: string, ctx: Record<string, unknown>)
346
357
  s.status === "waiting" ||
347
358
  (s.status === "failed" && s.nextRetryAt != null),
348
359
  );
349
- if (live) return;
360
+ if (live || hasOwedSuccessors(runId)) return;
361
+ await adoptStoredContext(runId, ctx);
350
362
  await updateWorkflowRun(runId, {
351
363
  status: "completed",
352
364
  context: ctx,
@@ -361,6 +373,7 @@ const RETRYABLE_RUN_STATUSES = new Set(["running", "waiting", "failed"]);
361
373
  * Stop the retry poller (for clean shutdown).
362
374
  */
363
375
  export function stopRetryPoller(): void {
376
+ pollerGeneration++;
364
377
  if (pollerTimeout !== null) {
365
378
  clearTimeout(pollerTimeout);
366
379
  pollerTimeout = null;
@@ -0,0 +1,108 @@
1
+ /**
2
+ * Successor routing owed on a run, in this process.
3
+ *
4
+ * A step that completed has successors with no step row until a walk claims
5
+ * them, so step rows alone can read as "nothing left to do". Every run
6
+ * finalizer checks `hasOwedSuccessors` inside its transaction and leaves the
7
+ * run to the walk that owes them: that walk's own finalizer settles the run.
8
+ */
9
+
10
+ import { getDbClient } from "../be/db";
11
+ import type { WorkflowNode } from "../types";
12
+
13
+ /** Open holds per run: claims waiting for their walk plus walks still routing. */
14
+ const owed = new Map<string, number>();
15
+
16
+ function add(runId: string, delta: number): void {
17
+ const next = (owed.get(runId) ?? 0) + delta;
18
+ if (next > 0) owed.set(runId, next);
19
+ else owed.delete(runId);
20
+ }
21
+
22
+ export function hasOwedSuccessors(runId: string): boolean {
23
+ return owed.has(runId);
24
+ }
25
+
26
+ /**
27
+ * One claim's hold on its run. Only the walk handed this object takes it over,
28
+ * so no other walk on the run can release it.
29
+ */
30
+ export interface SuccessorWalkDebt {
31
+ readonly runId: string;
32
+ /** Drop the hold. Idempotent. */
33
+ release(): void;
34
+ /** True once a walk took the hold over. */
35
+ takenOver: boolean;
36
+ }
37
+
38
+ /**
39
+ * Hold the run for a walk the caller starts right after its transaction.
40
+ * Call it inside the transaction that completes the step, so no finalizer can
41
+ * read the completed row without also seeing the debt. The caller must then
42
+ * pass the debt to `walkGraph` (`options.successorDebt`), or release it: a
43
+ * claim that never walks keeps the run from finalizing.
44
+ */
45
+ export function oweSuccessorWalk(runId: string): SuccessorWalkDebt {
46
+ add(runId, 1);
47
+ let released = false;
48
+ return {
49
+ runId,
50
+ takenOver: false,
51
+ release() {
52
+ if (released) return;
53
+ released = true;
54
+ add(runId, -1);
55
+ },
56
+ };
57
+ }
58
+
59
+ /**
60
+ * Hold the run while a walk routes successors. Takes over `debt`, the hold of
61
+ * the claim this walk routes, else takes a new one. The release is idempotent;
62
+ * run it before the holder's own finalizer.
63
+ */
64
+ export function holdSuccessorRouting(runId: string, debt?: SuccessorWalkDebt): () => void {
65
+ if (debt && debt.runId === runId && !debt.takenOver) {
66
+ debt.takenOver = true;
67
+ return () => debt.release();
68
+ }
69
+ return oweSuccessorWalk(runId).release;
70
+ }
71
+
72
+ /** The fields of a claim result that decide whether it owes a walk. */
73
+ interface SuccessorClaim {
74
+ claimed: boolean;
75
+ runFailed: boolean;
76
+ successors: WorkflowNode[];
77
+ }
78
+
79
+ /**
80
+ * Run a claim that completes a step and hands its successors to the caller.
81
+ * The successors have no step row until the caller's walk claims them, so the
82
+ * claim holds the run against finalizers from inside its own transaction.
83
+ * Callers pass a claimed result with successors straight to `walkGraph`, with
84
+ * `successorDebt` in its options, or release the debt.
85
+ */
86
+ export async function claimAndOweWalk<T extends SuccessorClaim>(
87
+ runId: string,
88
+ claim: () => Promise<T>,
89
+ ): Promise<T & { successorDebt?: SuccessorWalkDebt }> {
90
+ let debt: SuccessorWalkDebt | undefined;
91
+ try {
92
+ return await getDbClient().transaction(async () => {
93
+ const result = await claim();
94
+ if (result.claimed && !result.runFailed && result.successors.length > 0) {
95
+ debt = oweSuccessorWalk(runId);
96
+ // Inside a caller's transaction the claim publishes only at its
97
+ // COMMIT; a rollback there (or a failed COMMIT) must drop the hold too.
98
+ getDbClient().afterRollback(debt.release);
99
+ return { ...result, successorDebt: debt };
100
+ }
101
+ return result;
102
+ });
103
+ } catch (err) {
104
+ // This claim's own savepoint rolled back while the outer transaction lives on.
105
+ debt?.release();
106
+ throw err;
107
+ }
108
+ }
@@ -2,6 +2,7 @@ import {
2
2
  detachTaskFromWorkflowRunStep,
3
3
  getDbClient,
4
4
  getTaskById,
5
+ getTaskByWorkflowRunStepId,
5
6
  getWorkflowRun,
6
7
  getWorkflowRunStep,
7
8
  markWorkflowStepTaskSuperseded,
@@ -22,6 +23,7 @@ import { getSuccessors } from "./definition";
22
23
  import type { ExecutorRegistry } from "./executors/registry";
23
24
  import { resolveStepNode } from "./foreach-body";
24
25
  import { type ForeachSettleResult, resolveForeachParent, settleForeachChild } from "./foreach-join";
26
+ import { claimAndOweWalk, type SuccessorWalkDebt } from "./successor-routing";
25
27
 
26
28
  export interface TaskStepRoutingResult {
27
29
  /**
@@ -36,6 +38,8 @@ export interface TaskStepRoutingResult {
36
38
  successors: WorkflowNode[];
37
39
  /** True when this call failed the run: nothing may route or re-park it. */
38
40
  runFailed: boolean;
41
+ /** This claim's hold on the run; pass it to the `walkGraph` that routes `successors`. */
42
+ successorDebt?: SuccessorWalkDebt;
39
43
  }
40
44
 
41
45
  const UNCLAIMED: TaskStepRoutingResult = {
@@ -142,7 +146,7 @@ export async function checkpointPortStepAndResolveSuccessors(
142
146
  ctx: Record<string, unknown>,
143
147
  registry?: ExecutorRegistry,
144
148
  ): Promise<PortStepRoutingResult> {
145
- return await getDbClient().transaction(async (): Promise<PortStepRoutingResult> => {
149
+ return await claimAndOweWalk(runId, async () => {
146
150
  const current = await getWorkflowRunStep(stepId);
147
151
  if (!current || current.status !== "waiting") return UNCLAIMED;
148
152
  const run = await getWorkflowRun(runId);
@@ -284,6 +288,8 @@ async function isSupersedeCut(taskId: string, reason: string): Promise<boolean>
284
288
  /**
285
289
  * Persist an agent-task result and resolve its next nodes. Synthetic foreach
286
290
  * children never checkpoint into workflow context; only their parent join does.
291
+ * With `failureReason` (a failed task the workflow carries on without), a
292
+ * supersede cut on the step's task moves to `superseded`.
287
293
  */
288
294
  export async function completeTaskStepAndResolveSuccessors(
289
295
  def: WorkflowDefinition,
@@ -298,7 +304,7 @@ export async function completeTaskStepAndResolveSuccessors(
298
304
  // The task step, optional foreach join checkpoint, workflow context, and
299
305
  // running status must commit together. A crash after this transaction is
300
306
  // recoverable through the running-run graph re-walk.
301
- return await getDbClient().transaction(async (): Promise<TaskStepRoutingResult> => {
307
+ return await claimAndOweWalk(runId, async () => {
302
308
  // Re-read inside the transaction: callers checked `waiting` before their
303
309
  // own awaits, so the claim is only authoritative here.
304
310
  const current = await getWorkflowRunStep(step.id);
@@ -308,11 +314,19 @@ export async function completeTaskStepAndResolveSuccessors(
308
314
  // A late result inside a cancelled tree routes nothing and revives nothing.
309
315
  if (await getRunLineageBlock(runId)) return UNCLAIMED;
310
316
 
317
+ // Read before the step settles: the task stays bound, so the step's task
318
+ // is the one whose failure this call absorbs.
319
+ const failedTaskId =
320
+ failureReason !== undefined
321
+ ? (ownerTaskId ?? (await getTaskByWorkflowRunStepId(step.id))?.id)
322
+ : undefined;
323
+
324
+ let result: TaskStepRoutingResult;
311
325
  if (resolveForeachParent(def, step.nodeId)) {
312
326
  // onNodeFailure:"continue" completions persist the failure reason as
313
327
  // explicit metadata — the join classifies children on THIS, not on
314
328
  // whether user-controlled output text happens to start with "[FAILED:".
315
- return toRoutingResult(
329
+ result = toRoutingResult(
316
330
  await settleForeachChild(
317
331
  def,
318
332
  runId,
@@ -326,16 +340,25 @@ export async function completeTaskStepAndResolveSuccessors(
326
340
  { registry },
327
341
  ),
328
342
  );
343
+ } else {
344
+ await checkpointStep(runId, step.id, step.nodeId, { output }, ctx);
345
+ await updateWorkflowRun(runId, { status: "running" });
346
+ result = {
347
+ claimed: true,
348
+ foreachChild: false,
349
+ joined: true,
350
+ successors: getSuccessors(def, step.nodeId),
351
+ runFailed: false,
352
+ };
329
353
  }
330
354
 
331
- await checkpointStep(runId, step.id, step.nodeId, { output }, ctx);
332
- await updateWorkflowRun(runId, { status: "running" });
333
- return {
334
- claimed: true,
335
- foreachChild: false,
336
- joined: true,
337
- successors: getSuccessors(def, step.nodeId),
338
- runFailed: false,
339
- };
355
+ // The workflow absorbed the failure (onNodeFailure "continue" or a
356
+ // collect-outcomes fan-out): the step ends `completed` and the run goes on,
357
+ // so a supersede cut behind it is not a real failure either. A cut whose
358
+ // step ends `failed` never reaches here and stays `failed`.
359
+ if (failedTaskId && result.claimed && !result.runFailed) {
360
+ await markWorkflowStepTaskSuperseded(failedTaskId);
361
+ }
362
+ return result;
340
363
  });
341
364
  }
@@ -4,6 +4,7 @@ import type { ScheduledTask, TriggerConfig } from "../types";
4
4
  import { startWorkflowExecution } from "./engine";
5
5
  import type { ExecutorRegistry } from "./executors/registry";
6
6
  import { resolveInputValue } from "./input";
7
+ import { decideWebhookDelivery, type WebhookDeliverySkip } from "./webhook-filter";
7
8
 
8
9
  type WebhookTriggerConfig = Extract<TriggerConfig, { type: "webhook" }>;
9
10
 
@@ -152,6 +153,11 @@ export async function verifyWebhookRequest(
152
153
  }
153
154
  }
154
155
 
156
+ /** Outcome of a webhook delivery: a started run, or a delivery the trigger filter dropped. */
157
+ export type WebhookTriggerResult =
158
+ | { runId: string; skipped?: undefined }
159
+ | (WebhookDeliverySkip & { runId?: undefined });
160
+
155
161
  export interface HandleWebhookTriggerOptions {
156
162
  /**
157
163
  * Skip the "workflow must declare a webhook trigger" gate. ONLY for callers
@@ -175,10 +181,12 @@ export interface HandleWebhookTriggerOptions {
175
181
  * 3. If `hmacSecret` / `verification` is set, resolves the signature header +
176
182
  * secret and verifies the signature against the raw body bytes
177
183
  * 4. Parses the raw body as JSON (falling back to the raw string when the
178
- * body is non-JSON) so downstream `{{trigger.deep.path}}` interpolation
179
- * can traverse the object — matches the shape produced by the
180
- * `trigger-workflow` MCP tool.
181
- * 5. Starts the workflow execution with the parsed payload
184
+ * body is non-JSON) so the delivery filter and downstream
185
+ * `{{trigger.deep.path}}` interpolation see the same value
186
+ * 5. Applies `filter` and the deprecated `events` allowlist. A miss returns
187
+ * a `skipped` result and does not persist a run. A trigger whose filter
188
+ * or preset is not the documented shape fails closed with 500
189
+ * 6. Starts the workflow execution with the parsed payload
182
190
  */
183
191
  export async function handleWebhookTrigger(
184
192
  workflowId: string,
@@ -186,7 +194,7 @@ export async function handleWebhookTrigger(
186
194
  headers: HeaderBag,
187
195
  registry: ExecutorRegistry,
188
196
  options: HandleWebhookTriggerOptions = {},
189
- ): Promise<{ runId: string }> {
197
+ ): Promise<WebhookTriggerResult> {
190
198
  const workflow = await getWorkflow(workflowId);
191
199
  if (!workflow) {
192
200
  throw new WebhookError("Workflow not found", 404);
@@ -223,10 +231,19 @@ export async function handleWebhookTrigger(
223
231
  );
224
232
  }
225
233
 
226
- // Parse the raw body so downstream nodes can interpolate deep paths
227
- // (e.g. `{{trigger.message.from}}`). A non-JSON body falls back to the raw
228
- // string so non-JSON webhooks don't break.
234
+ // Parse after verification. A non-JSON body stays a string: body clauses
235
+ // miss on it, and a delivery with no body clause still starts a run.
236
+ // Downstream `{{trigger.deep.path}}` uses this value.
229
237
  const triggerData = parseTriggerPayload(payload);
238
+ if (webhookTrigger) {
239
+ // After verification, so a bad signature is still a 401. Before the run
240
+ // is persisted, so a dropped delivery writes no rows.
241
+ const decision = decideWebhookDelivery(webhookTrigger, headers, triggerData);
242
+ if (decision.action === "invalid") {
243
+ throw new WebhookError(decision.message, 500);
244
+ }
245
+ if (decision.action === "skip") return decision.skip;
246
+ }
230
247
 
231
248
  const runId = await startWorkflowExecution(workflow, triggerData, registry, {
232
249
  triggerType: "event",
@@ -3,6 +3,8 @@ import type { ExecutorRegistry } from "./executors/registry";
3
3
  import { resumeWaitState } from "./resume";
4
4
 
5
5
  let pollerTimeout: ReturnType<typeof setTimeout> | null = null;
6
+ /** Bumped by every stop, so a tick in flight can tell that its poller was stopped. */
7
+ let pollerGeneration = 0;
6
8
 
7
9
  /**
8
10
  * Start the wait-state poller.
@@ -24,6 +26,7 @@ let pollerTimeout: ReturnType<typeof setTimeout> | null = null;
24
26
  */
25
27
  export function startWaitPoller(registry: ExecutorRegistry, intervalMs = 5000): void {
26
28
  if (pollerTimeout !== null) return; // Already running
29
+ const generation = pollerGeneration;
27
30
 
28
31
  async function poll(): Promise<void> {
29
32
  try {
@@ -46,8 +49,8 @@ export function startWaitPoller(registry: ExecutorRegistry, intervalMs = 5000):
46
49
  console.error("[workflows] Wait poller tick error:", err);
47
50
  }
48
51
 
49
- // Schedule the next tick after this one completes.
50
- pollerTimeout = setTimeout(poll, intervalMs);
52
+ // Schedule the next tick after this one completes, unless the poller was stopped mid-tick.
53
+ if (generation === pollerGeneration) pollerTimeout = setTimeout(poll, intervalMs);
51
54
  }
52
55
 
53
56
  // Start the first tick.
@@ -56,6 +59,7 @@ export function startWaitPoller(registry: ExecutorRegistry, intervalMs = 5000):
56
59
 
57
60
  /** Stop the wait poller (clean shutdown). */
58
61
  export function stopWaitPoller(): void {
62
+ pollerGeneration++;
59
63
  if (pollerTimeout !== null) {
60
64
  clearTimeout(pollerTimeout);
61
65
  pollerTimeout = null;