@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
@@ -24,6 +24,7 @@ import {
24
24
  import { ExecutorRegistry } from "../workflows/executors/registry";
25
25
  import { setupWorkflowResumeListener } from "../workflows/resume";
26
26
  import { interpolate } from "../workflows/template";
27
+ import { waitForRunStatus } from "./workflow-wait";
27
28
 
28
29
  const TEST_DB_PATH = "./test-workflow-async-v2.sqlite";
29
30
 
@@ -246,11 +247,8 @@ describe("Workflow Async v2 (Phase 4)", () => {
246
247
  workflowRunStepId: taskStep.id,
247
248
  });
248
249
 
249
- // Give the async handler time to process
250
- await new Promise((resolve) => setTimeout(resolve, 10));
251
-
252
250
  // Workflow should be completed now
253
- const updatedRun = await getWorkflowRun(runId);
251
+ const updatedRun = await waitForRunStatus(runId, "completed");
254
252
  expect(updatedRun!.status).toBe("completed");
255
253
 
256
254
  // Both steps should be completed (task1 + done)
@@ -292,7 +290,10 @@ describe("Workflow Async v2 (Phase 4)", () => {
292
290
  workflowRunId: runId,
293
291
  workflowRunStepId: firstStep.id,
294
292
  });
295
- await new Promise((resolve) => setTimeout(resolve, 10));
293
+ await waitForRunStatus(runId, "waiting", async () => {
294
+ const step = (await getWorkflowRunStepsByRunId(runId)).find((s) => s.nodeId === "task2");
295
+ return !!step && !!(await getTaskByWorkflowRunStepId(step.id));
296
+ });
296
297
 
297
298
  const secondStep = (await getWorkflowRunStepsByRunId(runId)).find(
298
299
  (step) => step.nodeId === "task2",
@@ -333,9 +334,7 @@ describe("Workflow Async v2 (Phase 4)", () => {
333
334
  workflowRunStepId: taskStep.id,
334
335
  });
335
336
 
336
- await new Promise((resolve) => setTimeout(resolve, 10));
337
-
338
- const updatedRun = await getWorkflowRun(runId);
337
+ const updatedRun = await waitForRunStatus(runId, "failed");
339
338
  expect(updatedRun!.status).toBe("failed");
340
339
  expect(updatedRun!.error).toContain("Agent could not complete");
341
340
  });
@@ -364,9 +363,7 @@ describe("Workflow Async v2 (Phase 4)", () => {
364
363
  workflowRunStepId: taskStep.id,
365
364
  });
366
365
 
367
- await new Promise((resolve) => setTimeout(resolve, 10));
368
-
369
- const updatedRun = await getWorkflowRun(runId);
366
+ const updatedRun = await waitForRunStatus(runId, "failed");
370
367
  expect(updatedRun!.status).toBe("failed");
371
368
  expect(updatedRun!.error).toContain("cancelled");
372
369
  });
@@ -528,7 +525,11 @@ describe("Workflow Async v2 (Phase 4)", () => {
528
525
  workflowRunId: runId,
529
526
  workflowRunStepId: reviewSteps.find((s) => s.nodeId === "review-a")!.id,
530
527
  });
531
- await new Promise((r) => setTimeout(r, 10));
528
+ await waitForRunStatus(runId, "waiting", async () =>
529
+ (await getWorkflowRunStepsByRunId(runId)).some(
530
+ (step) => step.nodeId === "review-a" && step.status === "completed",
531
+ ),
532
+ );
532
533
 
533
534
  // After A completes — merge should NOT have been created yet (B, C still pending)
534
535
  steps = await getWorkflowRunStepsByRunId(runId);
@@ -545,7 +546,11 @@ describe("Workflow Async v2 (Phase 4)", () => {
545
546
  workflowRunId: runId,
546
547
  workflowRunStepId: reviewSteps.find((s) => s.nodeId === "review-b")!.id,
547
548
  });
548
- await new Promise((r) => setTimeout(r, 10));
549
+ await waitForRunStatus(runId, "waiting", async () =>
550
+ (await getWorkflowRunStepsByRunId(runId)).some(
551
+ (step) => step.nodeId === "review-b" && step.status === "completed",
552
+ ),
553
+ );
549
554
 
550
555
  // After B completes — merge STILL should not exist (C still pending)
551
556
  steps = await getWorkflowRunStepsByRunId(runId);
@@ -562,11 +567,9 @@ describe("Workflow Async v2 (Phase 4)", () => {
562
567
  workflowRunId: runId,
563
568
  workflowRunStepId: reviewSteps.find((s) => s.nodeId === "review-c")!.id,
564
569
  });
565
- await new Promise((r) => setTimeout(r, 10));
570
+ await waitForRunStatus(runId, "completed");
566
571
 
567
572
  // Now ALL 3 are done — merge should execute exactly ONCE
568
- // Allow extra time for serialized queue processing
569
- await new Promise((r) => setTimeout(r, 10));
570
573
 
571
574
  steps = await getWorkflowRunStepsByRunId(runId);
572
575
  const mergeSteps = steps.filter((s) => s.nodeId === "merge");
@@ -22,6 +22,7 @@ import { SwarmScriptExecutor } from "../workflows/executors/swarm-script";
22
22
  import { setupWorkflowResumeListener } from "../workflows/resume";
23
23
  import { interpolate } from "../workflows/template";
24
24
  import { SKIP_SANDBOX_SPAWN_TESTS } from "./sandbox-spawn-test-helpers";
25
+ import { waitForRunStatus } from "./workflow-wait";
25
26
 
26
27
  const spawnDescribe = describe.skipIf(SKIP_SANDBOX_SPAWN_TESTS);
27
28
 
@@ -81,15 +82,6 @@ async function saveScript(name: string, source: string) {
81
82
  });
82
83
  }
83
84
 
84
- async function waitForRunStatus(runId: string, status: string): Promise<void> {
85
- const deadline = Date.now() + 5_000;
86
- while (Date.now() < deadline) {
87
- if ((await getWorkflowRun(runId))?.status === status) return;
88
- await new Promise((resolve) => setTimeout(resolve, 25));
89
- }
90
- throw new Error(`Timed out waiting for workflow run ${runId} to reach ${status}`);
91
- }
92
-
93
85
  beforeAll(async () => {
94
86
  savedEnv = { ...process.env };
95
87
  await removeDbFiles();
@@ -0,0 +1,553 @@
1
+ import { afterAll, afterEach, beforeAll, describe, expect, spyOn, test } from "bun:test";
2
+ import { AsyncLocalStorage } from "node:async_hooks";
3
+ import { unlink } from "node:fs/promises";
4
+ import { z } from "zod";
5
+ import * as db from "../be/db";
6
+ import {
7
+ closeDb,
8
+ completeTask,
9
+ createAgent,
10
+ createWorkflow,
11
+ getDb,
12
+ getDbClient,
13
+ getTaskByWorkflowRunStepId,
14
+ getWorkflowRun,
15
+ getWorkflowRunStepsByRunId,
16
+ initDb,
17
+ } from "../be/db";
18
+ import type { ExecutorMeta, WorkflowDefinition, WorkflowNode } from "../types";
19
+ import { startWorkflowExecution, walkGraph } from "../workflows/engine";
20
+ import { InProcessEventBus } from "../workflows/event-bus";
21
+ import { AgentTaskExecutor } from "../workflows/executors/agent-task";
22
+ import {
23
+ BaseExecutor,
24
+ type ExecutorDependencies,
25
+ type ExecutorResult,
26
+ } from "../workflows/executors/base";
27
+ import {
28
+ type ForeachConfigSchema,
29
+ ForeachExecutor,
30
+ type ForeachOutput,
31
+ } from "../workflows/executors/foreach";
32
+ import { ExecutorRegistry } from "../workflows/executors/registry";
33
+ import { runForeachDrive } from "../workflows/foreach-driver";
34
+ import * as foreachJoin from "../workflows/foreach-join";
35
+ import { recoverIncompleteRuns } from "../workflows/recovery";
36
+ import { finalizeOrWait, setupWorkflowResumeListener } from "../workflows/resume";
37
+ import { startRetryPoller, stopRetryPoller } from "../workflows/retry-poller";
38
+ import {
39
+ hasOwedSuccessors,
40
+ holdSuccessorRouting,
41
+ oweSuccessorWalk,
42
+ } from "../workflows/successor-routing";
43
+ import { completeTaskStepAndResolveSuccessors } from "../workflows/task-step-routing";
44
+ import { interpolate } from "../workflows/template";
45
+
46
+ // Two walkers live on one run: the walk that started it and a task-completion
47
+ // resume, or two resumes at once. Each holds its own in-memory context and
48
+ // decides from step rows whether the run is over.
49
+
50
+ const TEST_DB_PATH = `./test-workflow-finalization-races-${crypto.randomUUID()}.sqlite`;
51
+
52
+ /** Every executor call, as `runId:nodeId`. */
53
+ const calls: string[] = [];
54
+
55
+ /** Node ids whose next execution fails. */
56
+ const failOnce = new Set<string>();
57
+
58
+ /** Holds the next `slow` execution open until released. */
59
+ let slowGate: { entered: (runId: string) => void; release: Promise<void> } | undefined;
60
+
61
+ class RecordExecutor extends BaseExecutor<
62
+ typeof RecordExecutor.configSchema,
63
+ typeof RecordExecutor.outputSchema
64
+ > {
65
+ static readonly configSchema = z.object({});
66
+ static readonly outputSchema = z.object({ node: z.string() });
67
+
68
+ readonly type = "record";
69
+ readonly mode = "instant" as const;
70
+ readonly configSchema = RecordExecutor.configSchema;
71
+ readonly outputSchema = RecordExecutor.outputSchema;
72
+
73
+ protected async execute(
74
+ _config: z.infer<typeof RecordExecutor.configSchema>,
75
+ _context: Readonly<Record<string, unknown>>,
76
+ meta: { runId: string; nodeId: string },
77
+ ): Promise<ExecutorResult<z.infer<typeof RecordExecutor.outputSchema>>> {
78
+ calls.push(`${meta.runId}:${meta.nodeId}`);
79
+ if (failOnce.delete(meta.nodeId)) return { status: "failed", error: `${meta.nodeId} failed` };
80
+ if (meta.nodeId === "slow" && slowGate) {
81
+ const gate = slowGate;
82
+ slowGate = undefined;
83
+ gate.entered(meta.runId);
84
+ await gate.release;
85
+ }
86
+ return { status: "success", output: { node: meta.nodeId } };
87
+ }
88
+ }
89
+
90
+ /** While true, a fan-out item parks like an async body instead of finishing. */
91
+ let parkFanItems = false;
92
+
93
+ /** A foreach body: instant, unless `parkFanItems` parks the item. */
94
+ class FanItemExecutor extends RecordExecutor {
95
+ override readonly type = "fan-item";
96
+
97
+ protected override async execute(
98
+ config: Record<string, never>,
99
+ context: Readonly<Record<string, unknown>>,
100
+ meta: { runId: string; nodeId: string },
101
+ ): Promise<ExecutorResult<{ node: string }>> {
102
+ if (!parkFanItems) return super.execute(config, context, meta);
103
+ return {
104
+ status: "success",
105
+ async: true,
106
+ waitFor: "test.never",
107
+ } as unknown as ExecutorResult<{ node: string }>;
108
+ }
109
+ }
110
+
111
+ /** The foreach executor, failing once for a node in `failOnce`. */
112
+ class FlakyForeachExecutor extends ForeachExecutor {
113
+ protected override async execute(
114
+ config: z.infer<typeof ForeachConfigSchema>,
115
+ context: Readonly<Record<string, unknown>>,
116
+ meta: ExecutorMeta,
117
+ ): Promise<ExecutorResult<ForeachOutput>> {
118
+ if (failOnce.delete(meta.nodeId)) return { status: "failed", error: `${meta.nodeId} failed` };
119
+ return super.execute(config, context, meta);
120
+ }
121
+ }
122
+
123
+ /** Parks on an approval request, as human-in-the-loop does. */
124
+ class ApprovalExecutor extends BaseExecutor<z.ZodObject, z.ZodObject> {
125
+ readonly type = "test-approval";
126
+ readonly mode = "async" as const;
127
+ readonly configSchema = z.object({});
128
+ readonly outputSchema = z.object({});
129
+
130
+ protected async execute(
131
+ _config: Record<string, never>,
132
+ _context: Readonly<Record<string, unknown>>,
133
+ meta: { runId: string; stepId: string },
134
+ ): Promise<ExecutorResult<Record<string, never>>> {
135
+ const requestId = crypto.randomUUID();
136
+ await this.deps.db.createApprovalRequest({
137
+ id: requestId,
138
+ title: "Ship?",
139
+ questions: [{ id: "q1", type: "approval", label: "Ship?", required: true }],
140
+ approvers: { policy: "any" as const },
141
+ workflowRunId: meta.runId,
142
+ workflowRunStepId: meta.stepId,
143
+ });
144
+ return {
145
+ status: "success",
146
+ async: true,
147
+ waitFor: "approval.resolved",
148
+ correlationId: requestId,
149
+ } as unknown as ExecutorResult<Record<string, never>>;
150
+ }
151
+ }
152
+
153
+ let agentId: string;
154
+
155
+ beforeAll(async () => {
156
+ await removeDbFiles();
157
+ initDb(TEST_DB_PATH);
158
+ agentId = (await createAgent({ name: "Ada", status: "idle" })).id;
159
+ });
160
+
161
+ // A gate its test never reached must not hold the next test's `slow`.
162
+ afterEach(() => {
163
+ slowGate = undefined;
164
+ parkFanItems = false;
165
+ failOnce.clear();
166
+ });
167
+
168
+ afterAll(async () => {
169
+ closeDb();
170
+ await removeDbFiles();
171
+ });
172
+
173
+ const record = (id: string, next?: string | string[]): WorkflowNode => ({
174
+ id,
175
+ type: "record",
176
+ config: {},
177
+ ...(next ? { next } : {}),
178
+ });
179
+
180
+ /** `sweep`, a fan-out over the trigger items, then `after`. */
181
+ const fanOut = (): WorkflowNode[] => [
182
+ record("sweep", "fan"),
183
+ {
184
+ id: "fan",
185
+ type: "foreach",
186
+ config: { over: "{{trigger.items}}", itemKey: "id", body: { type: "fan-item", config: {} } },
187
+ next: "after",
188
+ },
189
+ record("after"),
190
+ ];
191
+
192
+ const task = (id: string, next?: string): WorkflowNode => ({
193
+ id,
194
+ type: "agent-task",
195
+ config: { agentId, template: `Do ${id}` },
196
+ ...(next ? { next } : {}),
197
+ });
198
+
199
+ function harness() {
200
+ const bus = new InProcessEventBus();
201
+ const deps: ExecutorDependencies = {
202
+ db,
203
+ eventBus: bus,
204
+ interpolate: (template, ctx) => interpolate(template, ctx).result,
205
+ };
206
+ const registry = new ExecutorRegistry();
207
+ registry.register(new AgentTaskExecutor(deps));
208
+ registry.register(new RecordExecutor(deps));
209
+ registry.register(new FlakyForeachExecutor(deps));
210
+ registry.register(new FanItemExecutor(deps));
211
+ registry.register(new ApprovalExecutor(deps));
212
+ setupWorkflowResumeListener(bus, registry);
213
+ return { bus, registry };
214
+ }
215
+
216
+ async function start(nodes: WorkflowNode[], h = harness(), trigger: Record<string, unknown> = {}) {
217
+ const definition: WorkflowDefinition = { nodes };
218
+ const workflow = await createWorkflow({
219
+ name: `finalization-races-${crypto.randomUUID()}`,
220
+ definition,
221
+ });
222
+ const runId = await startWorkflowExecution(workflow, trigger, h.registry);
223
+ return { ...h, runId };
224
+ }
225
+
226
+ const executions = (runId: string, nodeId: string) =>
227
+ calls.filter((call) => call === `${runId}:${nodeId}`).length;
228
+
229
+ async function stepStatuses(runId: string, nodeId: string) {
230
+ return (await getWorkflowRunStepsByRunId(runId))
231
+ .filter((step) => step.nodeId === nodeId)
232
+ .map((step) => step.status);
233
+ }
234
+
235
+ /**
236
+ * Complete the tasks these nodes dispatched, then deliver every completion
237
+ * event in one synchronous burst, in the order given, so the resume handlers
238
+ * run interleaved.
239
+ */
240
+ async function completeTasksTogether(runId: string, bus: InProcessEventBus, nodeIds: string[]) {
241
+ const steps = await getWorkflowRunStepsByRunId(runId);
242
+ const events: Array<Record<string, unknown>> = [];
243
+ for (const nodeId of nodeIds) {
244
+ const step = steps.find((candidate) => candidate.nodeId === nodeId);
245
+ const dispatched = step ? await getTaskByWorkflowRunStepId(step.id) : null;
246
+ if (!step || !dispatched) throw new Error(`No dispatched task for ${nodeId}`);
247
+ await completeTask(dispatched.id, "done");
248
+ events.push({
249
+ taskId: dispatched.id,
250
+ output: "done",
251
+ workflowRunId: runId,
252
+ workflowRunStepId: step.id,
253
+ });
254
+ }
255
+ for (const event of events) bus.emit("task.completed", event);
256
+ }
257
+
258
+ describe("two walkers finalize one workflow run", () => {
259
+ test("a task completing while its batch sibling still runs keeps its output and the sibling's successor", async () => {
260
+ const entered = Promise.withResolvers<string>();
261
+ const release = Promise.withResolvers<void>();
262
+ slowGate = { entered: entered.resolve, release: release.promise };
263
+ const h = harness();
264
+ const walk = start(
265
+ [record("sweep", ["slow", "park"]), record("slow", "after"), task("park"), record("after")],
266
+ h,
267
+ );
268
+
269
+ // `slow` is in flight in the first walk when the parked task completes.
270
+ const runId = await entered.promise;
271
+ await waitFor(async () => (await stepStatuses(runId, "park"))[0] === "waiting");
272
+ await completeTasksTogether(runId, h.bus, ["park"]);
273
+ await waitFor(async () => (await stepStatuses(runId, "park"))[0] === "completed");
274
+
275
+ release.resolve();
276
+ await walk;
277
+
278
+ const run = await getWorkflowRun(runId);
279
+ expect(run?.context).toHaveProperty("park");
280
+ expect(run?.context).toHaveProperty("slow");
281
+ // The parked sibling does not stop this walk from routing `slow`'s branch.
282
+ expect(executions(runId, "after")).toBe(1);
283
+ expect(run?.context).toHaveProperty("after");
284
+ // The resume left the run `running` for this walk to finalize.
285
+ expect(run?.status).toBe("completed");
286
+ });
287
+
288
+ // A retry walk or a foreach drive on the same run, holding nothing of its
289
+ // own, finishes between a claim's commit and the claim's walk.
290
+ test("an unrelated walk finishing between a claim and its walk does not finish the run", async () => {
291
+ const h = harness();
292
+ const nodes = [record("sweep", "branch"), task("branch", "after"), record("after")];
293
+ const { runId } = await start(nodes, h);
294
+ const definition: WorkflowDefinition = { nodes };
295
+ const step = (await getWorkflowRunStepsByRunId(runId)).find((s) => s.nodeId === "branch");
296
+ const dispatched = step ? await getTaskByWorkflowRunStepId(step.id) : null;
297
+ if (!step || !dispatched) throw new Error("No dispatched branch task");
298
+ const ctx = ((await getWorkflowRun(runId))?.context ?? {}) as Record<string, unknown>;
299
+
300
+ const routing = await completeTaskStepAndResolveSuccessors(
301
+ definition,
302
+ runId,
303
+ step,
304
+ { taskId: dispatched.id, taskOutput: "done" },
305
+ ctx,
306
+ undefined,
307
+ undefined,
308
+ h.registry,
309
+ );
310
+ expect(routing.successors.map((n) => n.id)).toEqual(["after"]);
311
+
312
+ await walkGraph(definition, runId, { ...ctx }, [], h.registry);
313
+ expect((await getWorkflowRun(runId))?.status).toBe("running");
314
+
315
+ await walkGraph(definition, runId, ctx, routing.successors, h.registry, undefined, undefined, {
316
+ successorDebt: routing.successorDebt,
317
+ });
318
+ expect(executions(runId, "after")).toBe(1);
319
+ expect((await getWorkflowRun(runId))?.status).toBe("completed");
320
+ expect(hasOwedSuccessors(runId)).toBe(false);
321
+ });
322
+
323
+ test("two parked siblings resuming together both keep their output in the run context", async () => {
324
+ const { bus, runId } = await start([
325
+ record("sweep", ["left", "right"]),
326
+ task("left"),
327
+ task("right"),
328
+ ]);
329
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
330
+
331
+ await completeTasksTogether(runId, bus, ["left", "right"]);
332
+ await waitFor(async () => (await getWorkflowRun(runId))?.status === "completed");
333
+
334
+ const context = (await getWorkflowRun(runId))?.context;
335
+ expect(context).toHaveProperty("left");
336
+ expect(context).toHaveProperty("right");
337
+ });
338
+
339
+ // `branch` owes `after`; `leaf` has nothing to route and goes straight to
340
+ // the finalizer. Either can reach the database first.
341
+ test.each([
342
+ [["branch", "leaf"]],
343
+ [["leaf", "branch"]],
344
+ ])("a leaf sibling resuming next to a branch with a successor does not finish the run early (%p)", async (order) => {
345
+ const { bus, runId } = await start([
346
+ record("sweep", ["branch", "leaf"]),
347
+ task("branch", "after"),
348
+ task("leaf"),
349
+ record("after"),
350
+ ]);
351
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
352
+
353
+ await completeTasksTogether(runId, bus, order);
354
+ await waitFor(async () => (await getWorkflowRun(runId))?.status === "completed");
355
+ // A walker the early finalize cut off would settle within this window.
356
+ await Bun.sleep(100);
357
+
358
+ expect(executions(runId, "after")).toBe(1);
359
+ expect(await stepStatuses(runId, "after")).toEqual(["completed"]);
360
+ expect((await getWorkflowRun(runId))?.context).toHaveProperty("after");
361
+ });
362
+ });
363
+
364
+ describe("successors owed from the commit that closes them", () => {
365
+ // The retry poller requeues a retried item and drives it; the drive's
366
+ // settlement closes the join. Fail-fast (the default) re-reads the run once
367
+ // the batch is done, the first await after that commit.
368
+ test("a finalizer between a drive's join and its walk does not finish the run", async () => {
369
+ parkFanItems = true;
370
+ const h = harness();
371
+ const { runId } = await start(fanOut(), h, { items: [{ id: "a" }] });
372
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
373
+ parkFanItems = false;
374
+ await getDbClient().run(
375
+ "UPDATE workflow_run_steps SET status = 'pending' WHERE runId = ? AND nodeId LIKE 'fan#%'",
376
+ [runId],
377
+ );
378
+
379
+ let joined = false;
380
+ const settle = foreachJoin.settleForeachChild;
381
+ const settleSpy = spyOn(foreachJoin, "settleForeachChild").mockImplementation(
382
+ async (...args) => {
383
+ const result = await settle(...args);
384
+ joined ||= result.joined;
385
+ return result;
386
+ },
387
+ );
388
+ const read = db.getWorkflowRun;
389
+ const readSpy = spyOn(db, "getWorkflowRun").mockImplementation(async (id) => {
390
+ if (joined) {
391
+ joined = false;
392
+ await finalizeOrWait(runId);
393
+ }
394
+ return read(id);
395
+ });
396
+ try {
397
+ const drive = await runForeachDrive(runId, "fan", h.registry);
398
+ expect(drive.joined).toBe(true);
399
+ } finally {
400
+ settleSpy.mockRestore();
401
+ readSpy.mockRestore();
402
+ }
403
+
404
+ expect(executions(runId, "after")).toBe(1);
405
+ const run = await getWorkflowRun(runId);
406
+ expect(run?.context).toHaveProperty("after");
407
+ expect(run?.status).toBe("completed");
408
+ expect(hasOwedSuccessors(runId)).toBe(false);
409
+ });
410
+
411
+ // The approval recovery sweep claims the step inside its own transaction.
412
+ test("a claim whose outer transaction fails at COMMIT drops its hold", async () => {
413
+ const h = harness();
414
+ const { runId } = await start(
415
+ [
416
+ { id: "review", type: "test-approval", config: {}, next: { approved: "after" } },
417
+ record("after"),
418
+ ],
419
+ h,
420
+ );
421
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
422
+ await getDbClient().run(
423
+ "UPDATE approval_requests SET status = 'approved', resolvedAt = ? WHERE workflowRunId = ?",
424
+ [new Date().toISOString(), runId],
425
+ );
426
+
427
+ // The commit that would publish the claim fails, as a disk error would.
428
+ const raw = getDb();
429
+ const run = raw.run.bind(raw);
430
+ let failedCommits = 0;
431
+ const commitSpy = spyOn(raw, "run").mockImplementation(((sql: string, ...params: never[]) => {
432
+ if (sql === "COMMIT" && failedCommits === 0 && hasOwedSuccessors(runId)) {
433
+ failedCommits++;
434
+ throw new Error("disk I/O error");
435
+ }
436
+ return run(sql, ...params);
437
+ }) as typeof raw.run);
438
+ try {
439
+ await recoverIncompleteRuns(h.registry);
440
+ } finally {
441
+ commitSpy.mockRestore();
442
+ }
443
+ expect(failedCommits).toBe(1);
444
+ expect(await stepStatuses(runId, "review")).toEqual(["waiting"]);
445
+ expect(hasOwedSuccessors(runId)).toBe(false);
446
+
447
+ // The next sweep routes the step, and the run can finish.
448
+ await recoverIncompleteRuns(h.registry);
449
+ expect(executions(runId, "after")).toBe(1);
450
+ expect((await getWorkflowRun(runId))?.status).toBe("completed");
451
+ });
452
+ });
453
+
454
+ describe("a retried step's successors", () => {
455
+ // The poller commits the retried step, then walks its successors. A
456
+ // finalizer queued on the database while that commit is open runs next.
457
+ test("a finalizer queued at the retried step's commit leaves its successor to the poller", async () => {
458
+ failOnce.add("flaky");
459
+ const h = harness();
460
+ const { runId } = await start(
461
+ [
462
+ record("sweep", "flaky"),
463
+ {
464
+ ...record("flaky", "after"),
465
+ retry: { maxRetries: 1, strategy: "static", baseDelayMs: 0, maxDelayMs: 0 },
466
+ },
467
+ record("after"),
468
+ ],
469
+ h,
470
+ );
471
+ const flaky = (await getWorkflowRunStepsByRunId(runId)).find((s) => s.nodeId === "flaky");
472
+ expect(flaky?.nextRetryAt).toBeTruthy();
473
+
474
+ const outside = AsyncLocalStorage.snapshot();
475
+ let finalizer: Promise<void> | undefined;
476
+ const write = db.updateWorkflowRunStep;
477
+ const spy = spyOn(db, "updateWorkflowRunStep").mockImplementation(async (id, patch) => {
478
+ const result = await write(id, patch);
479
+ if (!finalizer && id === flaky?.id && patch.status === "completed") {
480
+ finalizer = outside(() => finalizeOrWait(runId));
481
+ }
482
+ return result;
483
+ });
484
+ startRetryPoller(h.registry, 10);
485
+ try {
486
+ await waitFor(async () => (await getWorkflowRun(runId))?.status === "completed");
487
+ } finally {
488
+ stopRetryPoller();
489
+ spy.mockRestore();
490
+ }
491
+ await finalizer;
492
+
493
+ expect(finalizer).toBeDefined();
494
+ expect(executions(runId, "after")).toBe(1);
495
+ expect((await getWorkflowRun(runId))?.context).toHaveProperty("after");
496
+ });
497
+
498
+ // The poller re-executes the fan-out; its instant items close the join
499
+ // inside the drive, and the poller walks the join's successors.
500
+ test("a retried fan-out that joins inline routes its successor and finishes the run", async () => {
501
+ failOnce.add("fan");
502
+ const h = harness();
503
+ const nodes = fanOut();
504
+ nodes[1] = {
505
+ ...nodes[1]!,
506
+ retry: { maxRetries: 1, strategy: "static", baseDelayMs: 0, maxDelayMs: 0 },
507
+ };
508
+ const { runId } = await start(nodes, h, { items: [{ id: "a" }] });
509
+ expect(await stepStatuses(runId, "fan")).toEqual(["failed"]);
510
+
511
+ startRetryPoller(h.registry, 10);
512
+ try {
513
+ await waitFor(async () => (await getWorkflowRun(runId))?.status === "completed");
514
+ } finally {
515
+ stopRetryPoller();
516
+ }
517
+ expect(executions(runId, "after")).toBe(1);
518
+ expect(hasOwedSuccessors(runId)).toBe(false);
519
+ });
520
+ });
521
+
522
+ describe("successor routing holds", () => {
523
+ test("a walk without the claim's debt holds and releases only its own share", () => {
524
+ const runId = crypto.randomUUID();
525
+ const debt = oweSuccessorWalk(runId);
526
+ holdSuccessorRouting(runId)();
527
+ expect(hasOwedSuccessors(runId)).toBe(true);
528
+
529
+ const routed = holdSuccessorRouting(runId, debt);
530
+ // A second walk handed the same debt takes a hold of its own.
531
+ const other = holdSuccessorRouting(runId, debt);
532
+ routed();
533
+ routed();
534
+ expect(hasOwedSuccessors(runId)).toBe(true);
535
+ other();
536
+ expect(hasOwedSuccessors(runId)).toBe(false);
537
+ });
538
+ });
539
+
540
+ async function waitFor(predicate: () => boolean | Promise<boolean>): Promise<void> {
541
+ const deadline = Date.now() + 2_000;
542
+ while (Date.now() < deadline) {
543
+ if (await predicate()) return;
544
+ await Bun.sleep(10);
545
+ }
546
+ throw new Error("Timed out waiting for workflow state");
547
+ }
548
+
549
+ async function removeDbFiles(): Promise<void> {
550
+ for (const suffix of ["", "-wal", "-shm"]) {
551
+ await unlink(TEST_DB_PATH + suffix).catch(() => {});
552
+ }
553
+ }
@@ -706,6 +706,8 @@ describe("workflow foreach", () => {
706
706
  try {
707
707
  startRetryPoller(registry, 10);
708
708
  await waitFor(async () => (await foreachChildren(runId)).length === 2);
709
+ // Child rows land before their tasks, and the tick is still in flight.
710
+ await waitFor(async () => (await taskCountForForeachChildren(runId)) === 2);
709
711
  } finally {
710
712
  stopRetryPoller();
711
713
  }