@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
@@ -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
+ }
@@ -23,6 +23,7 @@ import { getSuccessors } from "./definition";
23
23
  import type { ExecutorRegistry } from "./executors/registry";
24
24
  import { resolveStepNode } from "./foreach-body";
25
25
  import { type ForeachSettleResult, resolveForeachParent, settleForeachChild } from "./foreach-join";
26
+ import { claimAndOweWalk, type SuccessorWalkDebt } from "./successor-routing";
26
27
 
27
28
  export interface TaskStepRoutingResult {
28
29
  /**
@@ -37,6 +38,8 @@ export interface TaskStepRoutingResult {
37
38
  successors: WorkflowNode[];
38
39
  /** True when this call failed the run: nothing may route or re-park it. */
39
40
  runFailed: boolean;
41
+ /** This claim's hold on the run; pass it to the `walkGraph` that routes `successors`. */
42
+ successorDebt?: SuccessorWalkDebt;
40
43
  }
41
44
 
42
45
  const UNCLAIMED: TaskStepRoutingResult = {
@@ -143,7 +146,7 @@ export async function checkpointPortStepAndResolveSuccessors(
143
146
  ctx: Record<string, unknown>,
144
147
  registry?: ExecutorRegistry,
145
148
  ): Promise<PortStepRoutingResult> {
146
- return await getDbClient().transaction(async (): Promise<PortStepRoutingResult> => {
149
+ return await claimAndOweWalk(runId, async () => {
147
150
  const current = await getWorkflowRunStep(stepId);
148
151
  if (!current || current.status !== "waiting") return UNCLAIMED;
149
152
  const run = await getWorkflowRun(runId);
@@ -301,7 +304,7 @@ export async function completeTaskStepAndResolveSuccessors(
301
304
  // The task step, optional foreach join checkpoint, workflow context, and
302
305
  // running status must commit together. A crash after this transaction is
303
306
  // recoverable through the running-run graph re-walk.
304
- return await getDbClient().transaction(async (): Promise<TaskStepRoutingResult> => {
307
+ return await claimAndOweWalk(runId, async () => {
305
308
  // Re-read inside the transaction: callers checked `waiting` before their
306
309
  // own awaits, so the claim is only authoritative here.
307
310
  const current = await getWorkflowRunStep(step.id);
@@ -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
 
@@ -13,9 +14,6 @@ const DEFAULT_HMAC_HEADER = "X-Hub-Signature-256";
13
14
  /** Fallback header names checked (case-insensitive) after the trigger's configured header. */
14
15
  const FALLBACK_HMAC_HEADERS = ["x-hub-signature-256", "x-signature", "x-webhook-signature"];
15
16
 
16
- /** Header read for a webhook trigger's `events` allowlist when it configures no `eventHeader`. */
17
- const DEFAULT_EVENT_HEADER = "X-GitHub-Event";
18
-
19
17
  /** A bag of HTTP headers — values may be a string, a string array, or absent. */
20
18
  export type HeaderBag = Record<string, string | string[] | undefined>;
21
19
 
@@ -155,24 +153,10 @@ export async function verifyWebhookRequest(
155
153
  }
156
154
  }
157
155
 
158
- /**
159
- * Event of a delivery a webhook trigger's `events` allowlist does not admit,
160
- * or `undefined` when the delivery may start a run. A missing header counts
161
- * as not admitted (`null`): an allowlist is a closed gate.
162
- */
163
- function filteredWebhookEvent(
164
- trigger: WebhookTriggerConfig,
165
- headers: HeaderBag,
166
- ): string | null | undefined {
167
- if (!trigger.events || trigger.events.length === 0) return undefined;
168
- const event = getHeader(headers, trigger.eventHeader || DEFAULT_EVENT_HEADER) ?? null;
169
- return event !== null && trigger.events.includes(event) ? undefined : event;
170
- }
171
-
172
- /** Outcome of a webhook delivery: a started run, or a delivery the trigger's `events` allowlist dropped. */
156
+ /** Outcome of a webhook delivery: a started run, or a delivery the trigger filter dropped. */
173
157
  export type WebhookTriggerResult =
174
158
  | { runId: string; skipped?: undefined }
175
- | { runId?: undefined; skipped: true; reason: "event-not-allowed"; event: string | null };
159
+ | (WebhookDeliverySkip & { runId?: undefined });
176
160
 
177
161
  export interface HandleWebhookTriggerOptions {
178
162
  /**
@@ -196,13 +180,12 @@ export interface HandleWebhookTriggerOptions {
196
180
  * trigger — being reachable over `/api/webhooks/:workflowId` is opt-in
197
181
  * 3. If `hmacSecret` / `verification` is set, resolves the signature header +
198
182
  * secret and verifies the signature against the raw body bytes
199
- * 4. If the trigger sets an `events` allowlist, drops a delivery whose event
200
- * header is missing or not listed: no run is persisted, and the caller
201
- * gets a `skipped` result to acknowledge with a 2xx
202
- * 5. Parses the raw body as JSON (falling back to the raw string when the
203
- * body is non-JSON) so downstream `{{trigger.deep.path}}` interpolation
204
- * can traverse the object — matches the shape produced by the
205
- * `trigger-workflow` MCP tool.
183
+ * 4. Parses the raw body as JSON (falling back to the raw string when the
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
206
189
  * 6. Starts the workflow execution with the parsed payload
207
190
  */
208
191
  export async function handleWebhookTrigger(
@@ -246,19 +229,21 @@ export async function handleWebhookTrigger(
246
229
  typeof payload === "string" ? payload : JSON.stringify(payload),
247
230
  headers,
248
231
  );
249
-
250
- // After verification, so a bad signature is still a 401 for any event.
251
- // Before the run is persisted, so a dropped delivery writes no rows.
252
- const filtered = filteredWebhookEvent(webhookTrigger, headers);
253
- if (filtered !== undefined) {
254
- return { skipped: true, reason: "event-not-allowed", event: filtered };
255
- }
256
232
  }
257
233
 
258
- // Parse the raw body so downstream nodes can interpolate deep paths
259
- // (e.g. `{{trigger.message.from}}`). A non-JSON body falls back to the raw
260
- // 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.
261
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
+ }
262
247
 
263
248
  const runId = await startWorkflowExecution(workflow, triggerData, registry, {
264
249
  triggerType: "event",
@@ -1,5 +1,15 @@
1
1
  import type { ExecutorMeta, WorkflowNode } from "../types";
2
+ import type { ExecutorResult } from "./executors/base";
2
3
  import type { ExecutorRegistry } from "./executors/registry";
4
+ import { validateJsonSchema } from "./json-schema-validator";
5
+
6
+ /** Validate successful output before step validation or checkpointing. */
7
+ export function validateOutputSchema(node: WorkflowNode, result: ExecutorResult): string | null {
8
+ if (!node.outputSchema || result.status !== "success") return null;
9
+
10
+ const errors = validateJsonSchema(node.outputSchema as Record<string, unknown>, result.output);
11
+ return errors.length > 0 ? `Output schema validation failed: ${errors.join("; ")}` : null;
12
+ }
3
13
 
4
14
  export type ValidationOutcome = "pass" | "halt" | "retry";
5
15
 
@@ -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;
@@ -0,0 +1,203 @@
1
+ import { WEBHOOK_FILTER_PRESETS, WebhookDeliveryFilterSchema } from "../types";
2
+
3
+ /**
4
+ * Delivery filter for a webhook trigger.
5
+ *
6
+ * Runs only after signature verification, and a miss must not persist a run.
7
+ * Clauses are AND-ed. `events` / `eventHeader` are a deprecated alias that
8
+ * compiles to one clause (a header, or JSON body `type` for the
9
+ * standard-webhooks preset). `filter` adds header and body clauses.
10
+ * The first miss is the skip reason.
11
+ */
12
+
13
+ export type WebhookHeaderBag = Record<string, string | string[] | undefined>;
14
+
15
+ export const WEBHOOK_FILTER_INVALID_MESSAGE = "Webhook trigger filter is invalid";
16
+ export const WEBHOOK_PRESET_INVALID_MESSAGE = "Webhook trigger preset is invalid";
17
+ export const WEBHOOK_EVENTS_INVALID_MESSAGE = "Webhook trigger events allowlist is invalid";
18
+ export const WEBHOOK_EVENT_HEADER_INVALID_MESSAGE = "Webhook trigger eventHeader is invalid";
19
+
20
+ type FilterScalar = string | number | boolean | null;
21
+ type PresetName = (typeof WEBHOOK_FILTER_PRESETS)[number];
22
+
23
+ type EventSource = { source: "header" | "body"; path: string };
24
+
25
+ const EVENT_SOURCES: Record<PresetName, EventSource> = {
26
+ github: { source: "header", path: "X-GitHub-Event" },
27
+ gitlab: { source: "header", path: "X-Gitlab-Event" },
28
+ "standard-webhooks": { source: "body", path: "type" },
29
+ };
30
+
31
+ type Clause = EventSource & {
32
+ allowed: readonly FilterScalar[];
33
+ origin: "events" | "filter";
34
+ };
35
+
36
+ export type WebhookDeliverySkip =
37
+ | { skipped: true; reason: "event-not-allowed"; event: string | null }
38
+ | {
39
+ skipped: true;
40
+ reason: "filter-not-matched";
41
+ match: { source: "header" | "body"; path: string };
42
+ };
43
+
44
+ export type WebhookDeliveryDecision =
45
+ | { action: "allow" }
46
+ | { action: "skip"; skip: WebhookDeliverySkip }
47
+ | { action: "invalid"; message: string };
48
+
49
+ type DeliveryTrigger = {
50
+ events?: unknown;
51
+ eventHeader?: unknown;
52
+ preset?: unknown;
53
+ filter?: unknown;
54
+ };
55
+
56
+ /** Case-insensitive header name. The first value wins when a header is repeated. */
57
+ function headerValue(headers: WebhookHeaderBag, name: string): string | undefined {
58
+ const target = name.toLowerCase();
59
+ for (const [key, value] of Object.entries(headers)) {
60
+ if (key.toLowerCase() !== target) continue;
61
+ const first = Array.isArray(value) ? value[0] : value;
62
+ return typeof first === "string" ? first : undefined;
63
+ }
64
+ return undefined;
65
+ }
66
+
67
+ function isPreset(value: unknown): value is PresetName {
68
+ return typeof value === "string" && (WEBHOOK_FILTER_PRESETS as readonly string[]).includes(value);
69
+ }
70
+
71
+ function listed(value: FilterScalar | readonly FilterScalar[]): readonly FilterScalar[] {
72
+ if (
73
+ typeof value === "string" ||
74
+ typeof value === "number" ||
75
+ typeof value === "boolean" ||
76
+ value === null
77
+ ) {
78
+ return [value];
79
+ }
80
+ return value;
81
+ }
82
+
83
+ function valueAllowed(value: unknown, allowed: readonly FilterScalar[]): boolean {
84
+ return allowed.some((candidate) => Object.is(candidate, value));
85
+ }
86
+
87
+ /**
88
+ * Dot path. A numeric segment indexes an array (`commits.0.id`, no leading
89
+ * zeros) and is an ordinary key on an object. Inherited properties do not match.
90
+ */
91
+ function readBodyPath(
92
+ body: unknown,
93
+ path: string,
94
+ ): { found: true; value: unknown } | { found: false } {
95
+ let current: unknown = body;
96
+ for (const segment of path.split(".")) {
97
+ if (Array.isArray(current)) {
98
+ if (!/^(0|[1-9]\d*)$/.test(segment) || !Object.hasOwn(current, segment)) {
99
+ return { found: false };
100
+ }
101
+ current = current[Number(segment)];
102
+ continue;
103
+ }
104
+ if (current === null || typeof current !== "object") return { found: false };
105
+ if (!Object.hasOwn(current, segment)) return { found: false };
106
+ current = (current as Record<string, unknown>)[segment];
107
+ }
108
+ return { found: true, value: current };
109
+ }
110
+
111
+ function clauseMatches(clause: Clause, headers: WebhookHeaderBag, body: unknown): boolean {
112
+ if (clause.source === "header") {
113
+ return valueAllowed(headerValue(headers, clause.path), clause.allowed);
114
+ }
115
+ const read = readBodyPath(body, clause.path);
116
+ return read.found && valueAllowed(read.value, clause.allowed);
117
+ }
118
+
119
+ function observedEvent(clause: Clause, headers: WebhookHeaderBag, body: unknown): string | null {
120
+ if (clause.source === "header") return headerValue(headers, clause.path) ?? null;
121
+ const read = readBodyPath(body, clause.path);
122
+ return read.found && typeof read.value === "string" ? read.value : null;
123
+ }
124
+
125
+ function invalid(message: string): WebhookDeliveryDecision {
126
+ return { action: "invalid", message };
127
+ }
128
+
129
+ /**
130
+ * Decide whether a verified delivery may start a run.
131
+ * `body` is the parsed JSON value, or the raw payload when it is not JSON.
132
+ */
133
+ export function decideWebhookDelivery(
134
+ trigger: DeliveryTrigger,
135
+ headers: WebhookHeaderBag,
136
+ body: unknown,
137
+ ): WebhookDeliveryDecision {
138
+ if (trigger.preset !== undefined && !isPreset(trigger.preset)) {
139
+ return invalid(WEBHOOK_PRESET_INVALID_MESSAGE);
140
+ }
141
+ if (
142
+ trigger.eventHeader !== undefined &&
143
+ (typeof trigger.eventHeader !== "string" || trigger.eventHeader.length === 0)
144
+ ) {
145
+ return invalid(WEBHOOK_EVENT_HEADER_INVALID_MESSAGE);
146
+ }
147
+ if (trigger.events != null) {
148
+ if (
149
+ !Array.isArray(trigger.events) ||
150
+ trigger.events.some((event) => typeof event !== "string")
151
+ ) {
152
+ return invalid(WEBHOOK_EVENTS_INVALID_MESSAGE);
153
+ }
154
+ }
155
+
156
+ const clauses: Clause[] = [];
157
+ const events = Array.isArray(trigger.events) ? (trigger.events as string[]) : [];
158
+ if (events.length > 0) {
159
+ const preset: PresetName = isPreset(trigger.preset) ? trigger.preset : "github";
160
+ const source: EventSource =
161
+ typeof trigger.eventHeader === "string"
162
+ ? { source: "header", path: trigger.eventHeader }
163
+ : EVENT_SOURCES[preset];
164
+ clauses.push({ ...source, allowed: events, origin: "events" });
165
+ }
166
+
167
+ // `null` is a stored JSON value, not an omitted filter. Rows are loaded
168
+ // without re-validating the trigger, so a null filter must fail closed.
169
+ if (trigger.filter !== undefined) {
170
+ const parsed = WebhookDeliveryFilterSchema.safeParse(trigger.filter);
171
+ if (!parsed.success) return invalid(WEBHOOK_FILTER_INVALID_MESSAGE);
172
+ for (const [name, allowed] of Object.entries(parsed.data.headers ?? {})) {
173
+ clauses.push({ source: "header", path: name, allowed: listed(allowed), origin: "filter" });
174
+ }
175
+ for (const [path, allowed] of Object.entries(parsed.data.body ?? {})) {
176
+ clauses.push({ source: "body", path, allowed: listed(allowed), origin: "filter" });
177
+ }
178
+ }
179
+
180
+ for (const clause of clauses) {
181
+ if (clauseMatches(clause, headers, body)) continue;
182
+ if (clause.origin === "events") {
183
+ return {
184
+ action: "skip",
185
+ skip: {
186
+ skipped: true,
187
+ reason: "event-not-allowed",
188
+ event: observedEvent(clause, headers, body),
189
+ },
190
+ };
191
+ }
192
+ return {
193
+ action: "skip",
194
+ skip: {
195
+ skipped: true,
196
+ reason: "filter-not-matched",
197
+ match: { source: clause.source, path: clause.path },
198
+ },
199
+ };
200
+ }
201
+
202
+ return { action: "allow" };
203
+ }
@@ -60,7 +60,7 @@
60
60
  "templates/skills/tackle-gh-comments/content.md": "5aff640173081dc5b965d023f2d53526a57ad5135229ac46eb248b496675eb34",
61
61
  "templates/skills/tackle-gh-comments/files/scripts/gh-pr-comments.ts": "85efca9bea5899ddf54fdb24586547f70939be43587d3137406b362fc51ba240",
62
62
  "templates/skills/tdd-planning/config.json": "d03fce2559b03f02ba962d9d79c6363238380ba7a89a1e2ebe316cbe9b6b4616",
63
- "templates/skills/tdd-planning/content.md": "87808dca0db0b224ac9dcb3722805fd61f64f6bde033847de3ec14ad3584d8ca",
63
+ "templates/skills/tdd-planning/content.md": "00f04fe2e44af076acb13988cdcba30aeb76e8f01f027b8f2cc4970a09915552",
64
64
  "templates/skills/tdd-planning/files/template.md": "61f0f6aad195067b1f13289f02523f5ef606ed33f22db94bda923dcd0bd0674c",
65
65
  "templates/skills/v-implementing/config.json": "e11fb54b78bebeb32a43c8ac92bd6754114445018fcfb2014d6c69691764574c",
66
66
  "templates/skills/v-implementing/content.md": "0d24db3e54bd6836766005d756512aa5f5af19108fb39889d33f4dbadf1ac455",
@@ -263,7 +263,13 @@ const shortcode = (raw: string): string | null => {
263
263
 
264
264
  /** The acceptance reactions the engine may have put on the message, deduplicated. */
265
265
  export const acceptanceReactions = (): string[] => [
266
- ...new Set(ACCEPTANCE_REACTIONS.map(([key, fallback]) => shortcode(envOf(key)) ?? fallback)),
266
+ ...new Set(
267
+ ACCEPTANCE_REACTIONS.flatMap(([key, fallback]) => {
268
+ const raw = process.env[key];
269
+ if (raw !== undefined && raw.trim() === "") return [];
270
+ return [shortcode(raw ?? "") ?? fallback];
271
+ }),
272
+ ),
267
273
  ];
268
274
 
269
275
  const slackCall = async (
@@ -405,9 +411,7 @@ export const askModel = async (
405
411
  } | null;
406
412
  if (res?.success === false || body?.success === false) {
407
413
  const why = `${target.provider}: ${String(body?.message ?? body?.error ?? `HTTP ${res?.status}`).slice(0, 200)}`;
408
- throw body?.providerUnavailable === true
409
- ? new ProviderUnavailableError(why)
410
- : new Error(why);
414
+ throw body?.providerUnavailable === true ? new ProviderUnavailableError(why) : new Error(why);
411
415
  }
412
416
  const answer = body?.answers?.reason;
413
417
  const reason = typeof answer?.choice === "string" ? answer.choice : "";
@@ -41,6 +41,7 @@ agent-browser close
41
41
  ```
42
42
 
43
43
  - Re-run `snapshot` after every navigation or state change. Refs are only valid for the snapshot that produced them.
44
+ - Pass `--session <task-or-name>` on every `agent-browser` command, including the first `open`. Parallel tasks in one container share the `default` session and collide without it.
44
45
  - Run one browser session at a time. Call `store-progress` between page batches so the heartbeat watchdog sees you.
45
46
  - The browser is headless. Local servers inside the worker container are reachable at `http://localhost:<port>`.
46
47
  - The image launches Chromium with `--no-sandbox,--disable-dev-shm-usage` through `AGENT_BROWSER_ARGS`. If you pass your own `--args`, include `--no-sandbox` again or Chrome will not start.
@@ -36,6 +36,7 @@ agent-browser close
36
36
  ```
37
37
 
38
38
  - Re-run `snapshot` after every navigation or state change. Refs are only valid for the snapshot that produced them.
39
+ - Pass `--session <task-or-name>` on every `agent-browser` command, including the first `open`. Parallel tasks in one container share the `default` session and collide without it.
39
40
  - Run one browser session at a time. Call `store-progress` between page batches so the heartbeat watchdog sees you.
40
41
  - The browser is headless. Local servers inside the worker container are reachable at `http://localhost:<port>`.
41
42
  - The image launches Chromium with `--no-sandbox,--disable-dev-shm-usage` through `AGENT_BROWSER_ARGS`. If you pass your own `--args`, include `--no-sandbox` again or Chrome will not start.
@@ -78,6 +78,11 @@ writing CSS from scratch.
78
78
  page-session cookie via the launch endpoint) before the page can call the
79
79
  swarm API.
80
80
 
81
+ ## Known limits
82
+
83
+ - The page CSP sets `connect-src 'self'`, so `fetch` to another origin is blocked. Inline the data you need, or read it through the Browser SDK.
84
+ - The pages API returns 403 for a page owned by another agent. To restyle someone else's page, create a new page you own.
85
+
81
86
  ---
82
87
 
83
88
  # Design system
@@ -63,10 +63,15 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
63
63
  - [Choosing an AI operating model](https://docs.agent-swarm.dev/docs/guides/choosing-an-ai-operating-model). Reference.
64
64
  - [Small tech team operating model](https://docs.agent-swarm.dev/docs/guides/small-tech-team-operating-model). Reference.
65
65
  - [Customer renewal review](https://docs.agent-swarm.dev/docs/guides/customer-renewal-review). Reference.
66
+ - [Customer commitment tracking](https://docs.agent-swarm.dev/docs/guides/customer-commitment-tracking). Reference.
67
+ - [Reviewing supplier invoice and purchase order discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-invoice-discrepancy-review). Reference.
68
+ - [Handing off unresolved operational work between shifts with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-operations-shift-handoff). Reference.
69
+ - [Reviewing a supplier's security evidence before onboarding with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-security-evidence-review). Reference.
66
70
  - [Deployment Guide](https://docs.agent-swarm.dev/docs/guides/deployment). When: Someone wants to run Agent Swarm on their own server with Docker Compose.
67
71
  - [One-click deploy](https://docs.agent-swarm.dev/docs/guides/one-click-deploy). When: Someone has no server yet and wants Agent Swarm running in the cloud with HTTPS.
68
72
  - [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
69
73
  - [Worker Recovery: What Happens to Running Work When a Worker Stops](https://docs.agent-swarm.dev/docs/guides/worker-recovery-decision). Reference.
74
+ - [Deleting and Restoring Agents](https://docs.agent-swarm.dev/docs/guides/agent-deletion). Reference.
70
75
  - [Rootless Podman](https://docs.agent-swarm.dev/docs/guides/podman-rootless). When: Someone wants to run Agent Swarm under rootless Podman.
71
76
  - [Published Artifacts](https://docs.agent-swarm.dev/docs/guides/published-artifacts). Reference.
72
77
  - [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
@@ -77,10 +82,11 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
77
82
  - [Evals Harness](https://docs.agent-swarm.dev/docs/guides/evals-harness). Reference.
78
83
  - [Personalization & Status](https://docs.agent-swarm.dev/docs/guides/personalization). Reference.
79
84
  - [Secrets Encryption](https://docs.agent-swarm.dev/docs/guides/secrets-encryption). When: Someone asks how swarm secrets are stored, encrypted or backed up.
80
- - [Harness Configuration](https://docs.agent-swarm.dev/docs/guides/harness-configuration). When: Someone wants agents to run on a different AI provider or coding CLI.
85
+ - [Harness Configuration](https://docs.agent-swarm.dev/docs/guides/harness-configuration). When: Someone wants agents to run on a different harness or coding CLI.
81
86
  - [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
82
87
  - [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
83
88
  - [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
89
+ - [MCP Events on the User MCP](https://docs.agent-swarm.dev/docs/guides/mcp-events). Reference.
84
90
  - [Claude Code Mod](https://docs.agent-swarm.dev/docs/guides/claude-code-mod). Reference.
85
91
  - [Observability with OpenTelemetry](https://docs.agent-swarm.dev/docs/guides/observability-opentelemetry). When: Someone wants swarm traces and metrics in SigNoz or another OpenTelemetry backend.
86
92
  - [Host Requirements & Disk Cleanup](https://docs.agent-swarm.dev/docs/guides/host-requirements). When: Someone asks how big a host their self-hosted swarm needs, or their disk is filling up with Docker images.
@@ -111,6 +117,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
111
117
  - [Multi-runtime agents](https://docs.agent-swarm.dev/docs/guides/multi-runtime-agents). Reference.
112
118
  - [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
113
119
  - [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
120
+ - [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
114
121
  - [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
115
122
 
116
123
  ## Other docs
@@ -70,6 +70,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
70
70
  - Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
71
71
  - Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
72
72
  - SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
73
+ - When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
73
74
  - `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
74
75
  - A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
75
76
  - Return compact structured data. Raw logs, full HTML, big JSON arrays, and file contents stay inside the script.
@@ -65,6 +65,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
65
65
  - Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
66
66
  - Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
67
67
  - SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
68
+ - When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
68
69
  - `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
69
70
  - A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
70
71
  - Return compact structured data. Raw logs, full HTML, big JSON arrays, and file contents stay inside the script.
@@ -12,6 +12,8 @@ This skill enforces a disciplined TDD workflow:
12
12
 
13
13
  **No implementation code is written without a failing test first.** This is non-negotiable.
14
14
 
15
+ **Write the test at the level the repo asks for.** When the repo proves behavior through a black-box e2e suite and limits new unit tests, RED is a failing e2e scenario, not a new unit test. In agent-swarm that is a scenario in `scripts/e2e/scenarios/`, run alone with `bun run e2e --only <name>`. A new unit test there may import only the code listed in `scripts/unit-test-allowlist.txt` (worker runtime, tooling, rule corpora), and `bun run check:unit-test-allowlist` fails the PR otherwise.
16
+
15
17
  ## Working Agreement
16
18
 
17
19
  These instructions establish a working agreement between you and the user. The key principles are:
@@ -78,6 +80,7 @@ The autonomy mode is passed by the invoking command. If not specified, default t
78
80
  - **CRITICAL**: Read files yourself before spawning sub-tasks
79
81
 
80
82
  2. **Analyze test infrastructure:**
83
+ - Does the repo's CLAUDE.md or AGENTS.md require e2e scenarios over unit tests? That decides what every RED phase writes.
81
84
  - What testing framework is used? (Jest, pytest, Go testing, etc.)
82
85
  - Where do tests live? (co-located, `__tests__/`, `tests/`, etc.)
83
86
  - What's the test command? (`npm test`, `make test`, `pytest`, etc.)
@@ -106,8 +109,8 @@ The autonomy mode is passed by the invoking command. If not specified, default t
106
109
 
107
110
  ### Step 2: Test Strategy Design
108
111
 
109
- 1. **Identify testable units:**
110
- - What are the smallest testable pieces?
112
+ 1. **Identify testable behaviors:**
113
+ - What are the smallest behaviors a test can check, at the level the repo asks for (an e2e scenario where it has one)?
111
114
  - What inputs/outputs can be verified?
112
115
  - What edge cases matter?
113
116