@desplega.ai/agent-swarm 2.13.5 → 2.14.1

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 (551) hide show
  1. package/dist/acp-adapter-7jv7w8jh.js +17 -0
  2. package/dist/{acp-targets-w8dbs4nr.js → acp-targets-0ebmg3et.js} +10 -10
  3. package/dist/{actions-8zrcbjrx.js → actions-0ds9dx6c.js} +63 -42
  4. package/dist/{agent-fs-provision-cbt2ttds.js → agent-fs-provision-zpbxa9jc.js} +4 -4
  5. package/dist/{amp-adapter-8x6zp8w4.js → amp-adapter-awh5nn7a.js} +3 -3
  6. package/dist/{anthropic-messages-vdd1zmha.js → anthropic-messages-gtgp9r85.js} +17 -17
  7. package/dist/{app-zfa9dwjw.js → app-nzejkvpp.js} +10 -10
  8. package/dist/{approval-notifications-rv92zmza.js → approval-notifications-hbqtb2w3.js} +11 -11
  9. package/dist/{assistant-q7s7rm1q.js → assistant-1paft129.js} +42 -37
  10. package/dist/{boot-args-schema-g27kpzr1.js → boot-args-schema-zs435mfx.js} +1 -1
  11. package/dist/{boot-reembed-1mjs52nt.js → boot-reembed-7xq2qgg4.js} +1 -1
  12. package/dist/{boot-reembed-m62dpdkg.js → boot-reembed-91qrd4mz.js} +1 -1
  13. package/dist/{boot-scrub-sweep-ss1vcamw.js → boot-scrub-sweep-3h5xscw6.js} +2 -2
  14. package/dist/{boot-seeds-hwnvgbb3.js → boot-seeds-xkxqa8zc.js} +4 -4
  15. package/dist/{boxd-y0szhp0g.js → boxd-464x3w4m.js} +4 -4
  16. package/dist/{claude-adapter-0rjmbhjk.js → claude-adapter-6d8eyf2f.js} +12 -13
  17. package/dist/{claude-managed-adapter-6k032agg.js → claude-managed-adapter-jzxcaf9m.js} +4 -4
  18. package/dist/{claude-managed-setup-6czvve8q.js → claude-managed-setup-5fcx0qh3.js} +10 -10
  19. package/dist/{claude-sdk-session-pr0znb81.js → claude-sdk-session-11vhz1hc.js} +12720 -13882
  20. package/dist/{cli-kr0jpw9c.js → cli-02ba8qx5.js} +1 -1
  21. package/dist/{cli-ywy8yz6t.js → cli-08gfvs58.js} +2 -2
  22. package/dist/{cli-0qt3epg4.js → cli-0dkpdvnn.js} +10 -10
  23. package/dist/{cli-s8dhq7rj.js → cli-0mq8kxfx.js} +5 -5
  24. package/dist/{cli-ybte1fqc.js → cli-0nvqg1hb.js} +1 -1
  25. package/dist/{cli-f9xw9pr4.js → cli-0qyfna7a.js} +5 -5
  26. package/dist/cli-0vxbrxr3.js +1006 -0
  27. package/dist/{cli-ehg90jd1.js → cli-132h67ps.js} +64 -59
  28. package/dist/{cli-f7b9nyvk.js → cli-1e13gvfn.js} +17 -17
  29. package/dist/cli-1hj68b3h.js +30 -0
  30. package/dist/{cli-srktrbby.js → cli-1zbj28py.js} +1 -1
  31. package/dist/{cli-q41qar56.js → cli-20mkgwev.js} +173 -46
  32. package/dist/{cli-v09eza21.js → cli-288k5ep1.js} +15 -15
  33. package/dist/{cli-abby987g.js → cli-2n7qdqfv.js} +3 -3
  34. package/dist/{cli-kezzteka.js → cli-2r62jy9s.js} +1 -1
  35. package/dist/{cli-qmx8bnt4.js → cli-3179w2rz.js} +2 -2
  36. package/dist/cli-3a3hm1z8.js +15 -0
  37. package/dist/cli-3bagv8rt.js +37 -0
  38. package/dist/{cli-zxa1vmx7.js → cli-3bcsc3m7.js} +2 -2
  39. package/dist/{cli-j69pzrrz.js → cli-3g0vbq46.js} +5 -5
  40. package/dist/{cli-69szn7w7.js → cli-3ktfe5jx.js} +71 -47
  41. package/dist/{cli-69zzpjgh.js → cli-44r66df2.js} +1 -1
  42. package/dist/{cli-grbngev5.js → cli-466jjrwe.js} +11 -2
  43. package/dist/{cli-1jq2em7b.js → cli-4y2bekkn.js} +10 -9
  44. package/dist/cli-547fsc36.js +15 -0
  45. package/dist/{cli-6p8p2e6r.js → cli-5pyes68e.js} +1278 -23
  46. package/dist/{cli-ewk3sg68.js → cli-5t00r6c9.js} +3 -3
  47. package/dist/{cli-wzecestt.js → cli-5xjdft4s.js} +4063 -1835
  48. package/dist/{cli-4dyzzkfb.js → cli-643skca1.js} +954 -180
  49. package/dist/{cli-vr4eyq6p.js → cli-6a77m17n.js} +540 -412
  50. package/dist/{cli-v41kn3cd.js → cli-6prwz0zn.js} +4427 -5566
  51. package/dist/{cli-ks06cd0n.js → cli-6xrbpj5j.js} +8 -8
  52. package/dist/{cli-meydjstb.js → cli-6yhjqd6k.js} +4965 -69
  53. package/dist/{cli-bvamr9g0.js → cli-727sq1f9.js} +4 -4
  54. package/dist/{cli-snxhtehz.js → cli-7abeph0b.js} +7 -8
  55. package/dist/{cli-ty3gha1p.js → cli-7b9bwrfg.js} +2 -2
  56. package/dist/{cli-vbge4rsp.js → cli-7dwsn9y5.js} +4 -4
  57. package/dist/{cli-1kvcsd2f.js → cli-7qkbab03.js} +76 -8
  58. package/dist/{cli-8b4rpnwj.js → cli-7svwhw1a.js} +1 -1
  59. package/dist/{cli-jdq3jmny.js → cli-83kf2y60.js} +8 -10
  60. package/dist/{cli-tgc1kgg3.js → cli-84wxwt3z.js} +1 -1
  61. package/dist/{cli-sejvnjvw.js → cli-8crn0510.js} +1 -1
  62. package/dist/{cli-19d6v8er.js → cli-8kemtj1r.js} +172 -18
  63. package/dist/{cli-qrvk9nka.js → cli-967jrz7j.js} +40 -26
  64. package/dist/{cli-cp163xga.js → cli-976m0zcw.js} +72 -50
  65. package/dist/{cli-887vhew6.js → cli-98sea4d9.js} +2716 -2643
  66. package/dist/{cli-xh5fpmg8.js → cli-9txap41q.js} +101 -18
  67. package/dist/{cli-nrt048ys.js → cli-aktk3qt6.js} +40 -3
  68. package/dist/{cli-t0n9svkb.js → cli-b70cpf8f.js} +12 -7
  69. package/dist/{cli-2ap1the6.js → cli-by7s3n4p.js} +1 -1
  70. package/dist/{cli-tt7dkwjj.js → cli-byzq8xht.js} +7 -7
  71. package/dist/{cli-55h8m1x3.js → cli-d1zkys4j.js} +150 -99
  72. package/dist/cli-dr6x9qdk.js +15 -0
  73. package/dist/cli-dt931hb8.js +9740 -0
  74. package/dist/{cli-emdfd8fh.js → cli-dy754erz.js} +9 -1
  75. package/dist/{cli-2wzkvfgm.js → cli-e1wprqnd.js} +3 -3
  76. package/dist/{cli-pedm2kht.js → cli-e2wzzw17.js} +2 -2
  77. package/dist/{cli-1jx0srjt.js → cli-e9p9h14n.js} +1921 -80
  78. package/dist/{cli-evy3egte.js → cli-eaqxkeq0.js} +14 -103
  79. package/dist/{cli-he5nxaa8.js → cli-etykr11s.js} +3062 -728
  80. package/dist/{cli-3vw6dd4g.js → cli-f07sgaax.js} +2 -2
  81. package/dist/{cli-z1vam71h.js → cli-fe8he9cy.js} +2 -2
  82. package/dist/{cli-94gx6ze9.js → cli-h0edykd1.js} +1 -1
  83. package/dist/cli-h5cveb69.js +15 -0
  84. package/dist/{cli-5tq15aa7.js → cli-hamdfjtx.js} +2 -2
  85. package/dist/{cli-kwj3131p.js → cli-hh5m39pt.js} +1 -1
  86. package/dist/{cli-tvyt8w6n.js → cli-j8fmn3wv.js} +11 -11
  87. package/dist/cli-jngvszex.js +1514 -0
  88. package/dist/{cli-9n6g14vs.js → cli-k791mabe.js} +6 -6
  89. package/dist/{cli-6msnpj1z.js → cli-k9m8fckz.js} +10 -10
  90. package/dist/{cli-2vp0z049.js → cli-kz8rar0g.js} +1 -1
  91. package/dist/{cli-94mxerrp.js → cli-n15fhd43.js} +1 -1
  92. package/dist/{cli-htb5bpz2.js → cli-nmdy8bzf.js} +10 -3
  93. package/dist/{cli-t9pzz2eq.js → cli-ntmjzyte.js} +4 -1
  94. package/dist/{cli-avax5mp9.js → cli-ny8f5g7t.js} +19 -7
  95. package/dist/cli-p0g0erm9.js +15 -0
  96. package/dist/{cli-n79j1vxc.js → cli-pgdqhdkw.js} +4 -4
  97. package/dist/cli-ph1jce1b.js +16 -0
  98. package/dist/{cli-ced4azn1.js → cli-phantfg3.js} +771 -401
  99. package/dist/{cli-ebpq3c5z.js → cli-rb1z91g8.js} +10221 -1397
  100. package/dist/{cli-a49frv85.js → cli-redtbppc.js} +1 -1
  101. package/dist/{cli-cmbb2t8a.js → cli-s7bfz1ye.js} +15 -15
  102. package/dist/{cli-8pd1t17c.js → cli-sf5kp73f.js} +18 -18
  103. package/dist/{cli-zbbtp02a.js → cli-sq32dgfe.js} +1837 -7206
  104. package/dist/{cli-k0nebh10.js → cli-tbrjvrrg.js} +1 -1
  105. package/dist/{cli-4gaf3tx5.js → cli-tdd9dvw6.js} +1 -1
  106. package/dist/{cli-7ypg8hka.js → cli-tjrrabez.js} +3 -3
  107. package/dist/{cli-q1h041y8.js → cli-tkrp183j.js} +11 -11
  108. package/dist/{cli-srre41gb.js → cli-trvtxwzt.js} +2 -2
  109. package/dist/{cli-ffn0a515.js → cli-v1rhq77v.js} +68 -25
  110. package/dist/{cli-t879ww0y.js → cli-v3jxx8dv.js} +2 -2
  111. package/dist/{cli-b42yfn17.js → cli-v84kb7af.js} +14 -14
  112. package/dist/{cli-sa02jsqt.js → cli-vp2ksaq9.js} +1 -1
  113. package/dist/{cli-b0m3bg0f.js → cli-vrb8pvrf.js} +6 -6
  114. package/dist/cli-vxxdf2ma.js +15 -0
  115. package/dist/{cli-x2adbg4j.js → cli-w81s97bn.js} +1 -1
  116. package/dist/{cli-4vynxtrb.js → cli-wkzrknpt.js} +10 -3
  117. package/dist/{cli-fw67mnyc.js → cli-wqpvfq2m.js} +1 -1
  118. package/dist/{cli-prz1p3ft.js → cli-wsh5vfa7.js} +9 -9
  119. package/dist/{cli-hd5bm1e1.js → cli-wtwe8vng.js} +45 -45
  120. package/dist/{cli-34fygf87.js → cli-ww8wxfzx.js} +2 -2
  121. package/dist/{cli-e8trbfx1.js → cli-x80zagf5.js} +1 -1
  122. package/dist/{cli-zntvmqmm.js → cli-xd6ntv7x.js} +2 -2
  123. package/dist/{cli-vcpyttcw.js → cli-xmc2nrtv.js} +1 -1
  124. package/dist/{cli-z40t85ms.js → cli-ytgtqsy9.js} +1 -1
  125. package/dist/{cli-r3dxpmyt.js → cli-yvnnyjxm.js} +1 -1
  126. package/dist/{cli-zzq96q57.js → cli-z0c98h7h.js} +2450 -554
  127. package/dist/{cli-ryem5cfq.js → cli-z0effej1.js} +217 -27
  128. package/dist/{cli-0h8skzss.js → cli-zcb64xzv.js} +4 -3
  129. package/dist/{cli-5web09sb.js → cli-zdkcp8p0.js} +8 -10
  130. package/dist/{cli-z3x7h79n.js → cli-zgsd2w2k.js} +20 -22
  131. package/dist/{cli-7r9tvk8v.js → cli-zmfs06hg.js} +15 -9
  132. package/dist/{cli-3860pmrq.js → cli-zvsy4abb.js} +4 -4
  133. package/dist/{cli-5n9w2xzx.js → cli-zyf288rw.js} +2 -2
  134. package/dist/cli.js +64 -65
  135. package/dist/{codex-adapter-bn7eaxk5.js → codex-adapter-seht4h9t.js} +9 -9
  136. package/dist/{codex-hook-nnmezjg9.js → codex-hook-w5nmtrn2.js} +3 -3
  137. package/dist/{codex-login-ktfg1cxk.js → codex-login-67qarfcg.js} +1 -1
  138. package/dist/{codex-session-runner-j1e9hffc.js → codex-session-runner-tq95x3gq.js} +10 -10
  139. package/dist/{commands-amhpafrr.js → commands-0awwqxq5.js} +3 -3
  140. package/dist/{controller-tw7g10j2.js → controller-hgjx521c.js} +4 -4
  141. package/dist/{controllers-connect-2ssqz7f4.js → controllers-connect-j4kdmhfj.js} +28 -29
  142. package/dist/core-8fw1gwg7.js +41 -0
  143. package/dist/{cursor-adapter-d6knjmwa.js → cursor-adapter-0rg8wk6j.js} +2 -2
  144. package/dist/{db-fd6xxm77.js → db-8xs2js3s.js} +3 -3
  145. package/dist/{db-sc59379z.js → db-dd6hj211.js} +4 -2
  146. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-tn1twrha.js} +1 -1
  147. package/dist/{devtools-qxfgbsqz.js → devtools-b8qts77k.js} +1 -1
  148. package/dist/{dispatcher-a2gdqz8c.js → dispatcher-v7drd034.js} +24 -25
  149. package/dist/{docker-a59g3ebm.js → docker-6007r2fj.js} +2 -2
  150. package/dist/dsh-adapter-ah8npj2x.js +11 -0
  151. package/dist/{e2b-qnxyfea6.js → e2b-hg80w0qr.js} +3 -3
  152. package/dist/{e2b-cn7cvjqy.js → e2b-z1g7vpz6.js} +16 -5
  153. package/dist/{easter-egg-3d-a0pphy71.js → easter-egg-3d-8n4w3s9k.js} +1 -1
  154. package/dist/{embedding-space-qepzrach.js → embedding-space-0p921zt3.js} +13 -23
  155. package/dist/{embeddings-d7vr881x.js → embeddings-9s7kbrc6.js} +1 -1
  156. package/dist/emscripten-module-Q67P5WYC-3sde6cre.js +2458 -0
  157. package/dist/{event-bus-7gbsr0g4.js → event-bus-pawddp92.js} +1 -1
  158. package/dist/{execute-6afts2bn.js → execute-x0fy9j0m.js} +1 -1
  159. package/dist/{external-channel-881zq1x4.js → external-channel-ktfvn29c.js} +2 -2
  160. package/dist/ffi-cbfmmtqk.js +85 -0
  161. package/dist/fx-adapter-15vjxvgm.js +20 -0
  162. package/dist/getMachineId-bsd-2rd3pnz7.js +36 -0
  163. package/dist/getMachineId-bsd-3p48mkt1.js +36 -0
  164. package/dist/{getMachineId-bsd-637a7rbk.js → getMachineId-bsd-bk6tmeen.js} +5 -5
  165. package/dist/getMachineId-bsd-pssqgwmm.js +37 -0
  166. package/dist/getMachineId-bsd-v218x3xd.js +36 -0
  167. package/dist/getMachineId-bsd-wbxcazef.js +36 -0
  168. package/dist/getMachineId-bsd-x0942pbz.js +36 -0
  169. package/dist/getMachineId-darwin-5qsy4qcg.js +36 -0
  170. package/dist/getMachineId-darwin-6v7zsshx.js +37 -0
  171. package/dist/getMachineId-darwin-fcc3fjag.js +36 -0
  172. package/dist/getMachineId-darwin-pg84hftj.js +36 -0
  173. package/dist/{getMachineId-darwin-9vytrcnn.js → getMachineId-darwin-tyyevt26.js} +5 -5
  174. package/dist/getMachineId-darwin-wagmbf0d.js +36 -0
  175. package/dist/getMachineId-darwin-zvkmwr3y.js +36 -0
  176. package/dist/{getMachineId-linux-mkzsvyyz.js → getMachineId-linux-2ncg1epd.js} +3 -3
  177. package/dist/getMachineId-linux-2tmt2ptc.js +29 -0
  178. package/dist/getMachineId-linux-empwyp2y.js +29 -0
  179. package/dist/getMachineId-linux-fanqd45b.js +29 -0
  180. package/dist/getMachineId-linux-h6fyga0x.js +29 -0
  181. package/dist/getMachineId-linux-tbhgz1k9.js +29 -0
  182. package/dist/getMachineId-linux-zrbyw7dt.js +29 -0
  183. package/dist/getMachineId-unsupported-29g9dkgv.js +19 -0
  184. package/dist/getMachineId-unsupported-8xfq8djv.js +19 -0
  185. package/dist/getMachineId-unsupported-8y9cag1p.js +19 -0
  186. package/dist/getMachineId-unsupported-a6sjrm02.js +19 -0
  187. package/dist/getMachineId-unsupported-bp3w7ds0.js +19 -0
  188. package/dist/{getMachineId-unsupported-4cfs2n11.js → getMachineId-unsupported-sj6fk8sw.js} +3 -3
  189. package/dist/getMachineId-unsupported-v0p5gdxp.js +19 -0
  190. package/dist/getMachineId-win-hc996p0x.js +38 -0
  191. package/dist/{getMachineId-win-154s3qma.js → getMachineId-win-msq9ad87.js} +6 -6
  192. package/dist/getMachineId-win-tajyqwd6.js +38 -0
  193. package/dist/getMachineId-win-tzc163da.js +38 -0
  194. package/dist/getMachineId-win-xdaa0mgq.js +38 -0
  195. package/dist/getMachineId-win-xk6p98m5.js +38 -0
  196. package/dist/getMachineId-win-xtk658fm.js +38 -0
  197. package/dist/{google-generative-ai-sw77egmr.js → google-generative-ai-nzndg246.js} +1 -1
  198. package/dist/{google-vertex-rrw93g8h.js → google-vertex-ragh3nnw.js} +1 -1
  199. package/dist/grok-adapter-77httan0.js +20 -0
  200. package/dist/handlers-c1jp5b6h.js +39 -0
  201. package/dist/heartbeat-5yaj6dym.js +49 -0
  202. package/dist/{hook-a7eh6zty.js → hook-2jttae8s.js} +13 -14
  203. package/dist/hook-c99nycyh.js +21 -0
  204. package/dist/{http-6aw5wanc.js → http-7y9dbfrr.js} +870 -219
  205. package/dist/{index-kzdqn3dd.js → index-6g9rdcrj.js} +3036 -758
  206. package/dist/index-7dwh9kxh.js +41 -0
  207. package/dist/{index-ym9fgxad.js → index-8p03vx1h.js} +8 -8
  208. package/dist/{index-maddg9ys.js → index-cw8nxnba.js} +4330 -15375
  209. package/dist/{index-yq9hhhhy.js → index-dm7c6hw5.js} +28 -29
  210. package/dist/index-fqf82sbk.js +10584 -0
  211. package/dist/{index-126v2d0t.js → index-g7rthzrv.js} +11 -2923
  212. package/dist/{index-z2g9469g.js → index-h9xnzfhx.js} +114 -33
  213. package/dist/{index-42jq9yy3.js → index-jvfp0j47.js} +516 -10
  214. package/dist/{index-3j803vnb.js → index-q60mhcpd.js} +25094 -20637
  215. package/dist/index-qxcfv8vq.js +17 -0
  216. package/dist/{index-rz8ve510.js → index-t274qhhs.js} +6 -6
  217. package/dist/{index-kdmkfjt7.js → index-t4n9z755.js} +3491 -2487
  218. package/dist/{index-7dgxveck.js → index-tcegcysh.js} +5 -5
  219. package/dist/{index-whysn1wf.js → index-tn1m3q9b.js} +3 -3
  220. package/dist/index-wp9tarbt.js +43 -0
  221. package/dist/{index-xhad0n8m.js → index-xhp7yp3t.js} +1 -1
  222. package/dist/index-z6np2405.js +38 -0
  223. package/dist/{k8s-36gfn847.js → k8s-mr1r12th.js} +2 -2
  224. package/dist/{keepalive-zhbmztqw.js → keepalive-7eyb8y4t.js} +4 -5
  225. package/dist/lead-50cgn8s1.js +81 -0
  226. package/dist/{maintenance-rsp0591h.js → maintenance-tdrd8nwv.js} +1 -1
  227. package/dist/module-ES6BEMUI-6htewwha.js +1210 -0
  228. package/dist/{node-0as4n1ef.js → node-gbx1t3pa.js} +1 -1
  229. package/dist/{node-rxte5hc6.js → node-jkdd5w7m.js} +1 -1
  230. package/dist/{oauth-refresh-sweep-w3cqmxq7.js → oauth-refresh-sweep-f4c7g37h.js} +3 -4
  231. package/dist/{object-webhooks-331hay92.js → object-webhooks-p190rdxp.js} +7 -7
  232. package/dist/{onboard-n2w80m2n.js → onboard-56h4sks6.js} +12 -10
  233. package/dist/{opencode-adapter-z98127cz.js → opencode-adapter-xg3yxfr0.js} +8 -8
  234. package/dist/{otel-impl-xsk35tvf.js → otel-impl-kepzgm4n.js} +36360 -9179
  235. package/dist/{pending-2e6trkxd.js → pending-xgv316w0.js} +25 -26
  236. package/dist/{pi-mono-adapter-wh6yndtm.js → pi-mono-adapter-txe0syzb.js} +19 -22
  237. package/dist/{pricing-refresh-9355dj1t.js → pricing-refresh-041zpyhf.js} +2 -2
  238. package/dist/{rbac-roles-8eajw4s6.js → rbac-roles-8f3jbcaf.js} +2 -2
  239. package/dist/{rbac-roles-58y3m912.js → rbac-roles-cw7rrw5b.js} +3 -3
  240. package/dist/{render-v2-7gskkmd4.js → render-v2-2ezw4mzt.js} +10 -10
  241. package/dist/{resume-0drnmpja.js → resume-p14wdx8m.js} +13 -13
  242. package/dist/{runtime-d2tcmqte.js → runtime-he7c9g1r.js} +1 -1
  243. package/dist/{session-access-0ztys6bd.js → session-access-8jvq86fj.js} +5 -5
  244. package/dist/{session-source-backfill-cdm5s046.js → session-source-backfill-6fe3hcgb.js} +3 -3
  245. package/dist/{setup-pqwb9tcc.js → setup-6v0bn4r1.js} +15 -6
  246. package/dist/thread-buffer-8860v1ta.js +40 -0
  247. package/dist/{token-util-pjgekqxr.js → token-util-hnzceyn9.js} +1 -1
  248. package/dist/{token-pgr2w4s3.js → token-xnc02n6w.js} +21 -14
  249. package/dist/{tree-visibility-rwz67mje.js → tree-visibility-g1a8ff4r.js} +2 -2
  250. package/dist/{user-merge-jobs-mxrhamwt.js → user-merge-jobs-vjsps179.js} +3 -3
  251. package/dist/{virtual-modules-71y1gsmg.js → virtual-modules-mreda4fp.js} +3 -3
  252. package/dist/{work-objects-3k4ykt9j.js → work-objects-hfw15e35.js} +29 -33
  253. package/dist/{worker-follow-up-y0h64xpr.js → worker-follow-up-gbaz2ydz.js} +24 -25
  254. package/dist/worker-hkm8ftqp.js +81 -0
  255. package/dist/{x-d27jj7z7.js → x-k29vmskt.js} +2 -2
  256. package/openapi.json +303 -20
  257. package/package.json +45 -45
  258. package/src/apps/definition.ts +76 -24
  259. package/src/apps/row-store.ts +67 -0
  260. package/src/apps/script-types.ts +131 -21
  261. package/src/apps/store.ts +4 -1
  262. package/src/be/db/model-profiles.ts +103 -12
  263. package/src/be/db/script-runs.ts +33 -0
  264. package/src/be/db/slack-card-groups.ts +147 -0
  265. package/src/be/db/slack-trees.ts +26 -0
  266. package/src/be/db/task-idempotency.ts +63 -0
  267. package/src/be/db/tasks/read.ts +7 -0
  268. package/src/be/db/tasks/write.ts +4 -2
  269. package/src/be/db/workflow-idempotency.ts +6 -1
  270. package/src/be/db/workflows/read.ts +79 -0
  271. package/src/be/db.ts +65 -151
  272. package/src/be/improvements.ts +24 -2
  273. package/src/be/mcp-proxy.ts +45 -11
  274. package/src/be/memory/embedding-space.ts +10 -20
  275. package/src/be/memory/index.ts +35 -0
  276. package/src/be/memory/providers/openai-embedding.ts +10 -0
  277. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  278. package/src/be/migrations/354_durable_objects.sql +9 -0
  279. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  280. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  281. package/src/be/migrations/362_favorites_app.sql +36 -0
  282. package/src/be/model-group-resolution.ts +134 -0
  283. package/src/be/model-tier-resolution.ts +120 -17
  284. package/src/be/model-validation.ts +9 -1
  285. package/src/be/repo-checked-update.ts +58 -5
  286. package/src/be/requester-timezone.ts +10 -0
  287. package/src/be/runtime-pools/routing.ts +22 -8
  288. package/src/be/script-connections.ts +5 -1
  289. package/src/be/script-credential-broker.ts +29 -2
  290. package/src/be/scripts/durable.ts +204 -0
  291. package/src/be/scripts/extract-schema.ts +36 -4
  292. package/src/be/scripts/run-credential.ts +1 -8
  293. package/src/be/scripts/typecheck.ts +32 -7
  294. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  295. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  296. package/src/be/swarm-config-guard.ts +104 -14
  297. package/src/be/users.ts +33 -12
  298. package/src/comb/review-batch.ts +16 -5
  299. package/src/commands/context-preamble.ts +237 -0
  300. package/src/commands/e2b.ts +14 -0
  301. package/src/commands/entrypoint-mcp-config.ts +231 -0
  302. package/src/commands/onboard/agent-fs-version.ts +1 -1
  303. package/src/commands/onboard/compose-generator.ts +2 -1
  304. package/src/commands/onboard/env-generator.ts +16 -7
  305. package/src/commands/runner.ts +23 -7
  306. package/src/commands/setup.tsx +17 -3
  307. package/src/extensions/contract-types.generated.ts +1 -1
  308. package/src/hooks/hook.ts +8 -2
  309. package/src/hooks/native-tool-hooks.ts +4 -2
  310. package/src/http/apps.ts +82 -42
  311. package/src/http/comb.ts +21 -5
  312. package/src/http/config.ts +8 -4
  313. package/src/http/db-query.ts +8 -2
  314. package/src/http/heartbeat.ts +5 -0
  315. package/src/http/index.ts +12 -6
  316. package/src/http/kv.ts +7 -5
  317. package/src/http/mcp-oauth.ts +16 -0
  318. package/src/http/mcp-servers.ts +43 -3
  319. package/src/http/memory.ts +28 -1
  320. package/src/http/metrics.ts +11 -4
  321. package/src/http/onboarding.ts +12 -1
  322. package/src/http/operator-actor.ts +3 -8
  323. package/src/http/poll.ts +20 -1
  324. package/src/http/repos.ts +30 -12
  325. package/src/http/request-principal.ts +27 -1
  326. package/src/http/schedules.ts +59 -11
  327. package/src/http/script-connection-proxy.ts +3 -1
  328. package/src/http/script-runs.ts +21 -10
  329. package/src/http/scripts.ts +177 -26
  330. package/src/http/session-cost-recompute.ts +9 -4
  331. package/src/http/skills.ts +70 -0
  332. package/src/http/status.ts +2 -0
  333. package/src/http/tasks.ts +103 -15
  334. package/src/http/trackers/jira.ts +18 -3
  335. package/src/http/trackers/linear.ts +3 -0
  336. package/src/kv-limits.ts +2 -0
  337. package/src/kv-reserved-namespaces.ts +25 -2
  338. package/src/prompts/base-prompt.ts +10 -6
  339. package/src/prompts/session-templates.ts +52 -3
  340. package/src/prompts/session-turns.ts +30 -0
  341. package/src/providers/acp-targets.ts +1 -1
  342. package/src/providers/amp-adapter.ts +11 -9
  343. package/src/providers/claude-managed-adapter.ts +14 -0
  344. package/src/providers/claude-sdk-session.ts +14 -1
  345. package/src/providers/cursor-adapter.ts +1 -1
  346. package/src/providers/dsh-adapter.ts +1 -1
  347. package/src/providers/opencode-adapter.ts +3 -5
  348. package/src/providers/runtime-dependencies.ts +11 -8
  349. package/src/rbac/legacy-policy.ts +7 -0
  350. package/src/rbac/permissions.ts +27 -0
  351. package/src/realtime/browser.generated.txt +1 -1
  352. package/src/scheduler/schedule-task.ts +1 -0
  353. package/src/scheduler/scheduler.ts +36 -18
  354. package/src/script-workflows/executor.ts +37 -8
  355. package/src/script-workflows/supervisor.ts +14 -0
  356. package/src/scripts-runtime/ctx.ts +5 -1
  357. package/src/scripts-runtime/durable-object-base.ts +19 -0
  358. package/src/scripts-runtime/eval-harness.ts +46 -1
  359. package/src/scripts-runtime/executors/native.ts +13 -1
  360. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  361. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  362. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  363. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  364. package/src/scripts-runtime/executors/types.ts +26 -0
  365. package/src/scripts-runtime/extract-signature.ts +96 -1
  366. package/src/scripts-runtime/loader.ts +11 -5
  367. package/src/scripts-runtime/mcp-client.ts +1 -1
  368. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  369. package/src/scripts-runtime/swarm-config.ts +7 -0
  370. package/src/scripts-runtime/swarm-sdk.ts +4 -1
  371. package/src/scripts-runtime/types/stdlib.d.ts +19 -0
  372. package/src/scripts-runtime/types/swarm-extension.d.ts +3 -0
  373. package/src/scripts-runtime/types/swarm-sdk.d.ts +19 -0
  374. package/src/slack/actions.ts +24 -0
  375. package/src/slack/assistant.ts +8 -0
  376. package/src/slack/blocks.ts +35 -0
  377. package/src/slack/channel-activity.ts +7 -0
  378. package/src/slack/config.ts +4 -0
  379. package/src/slack/enrich.ts +46 -54
  380. package/src/slack/files.ts +173 -23
  381. package/src/slack/handlers.test.ts +17 -19
  382. package/src/slack/handlers.ts +15 -14
  383. package/src/slack/render-v2.ts +265 -19
  384. package/src/slack/responses.ts +62 -5
  385. package/src/slack/session-mirror.ts +10 -5
  386. package/src/slack/task-output.ts +25 -14
  387. package/src/slack/templates.ts +9 -0
  388. package/src/slack/thread-participants.ts +64 -24
  389. package/src/slack/watcher.ts +4 -4
  390. package/src/slack/work-objects.ts +1 -1
  391. package/src/stdio.ts +5 -0
  392. package/src/tasks/follow-up-gate.ts +142 -38
  393. package/src/tasks/worker-follow-up.ts +126 -37
  394. package/src/tests/agents-list-model-display.test.ts +4 -0
  395. package/src/tests/amp-adapter.test.ts +57 -9
  396. package/src/tests/apps-script-types.test.ts +63 -16
  397. package/src/tests/apps-sort-order.test.ts +87 -0
  398. package/src/tests/base-prompt.test.ts +36 -2
  399. package/src/tests/bedrock-model-groups.test.ts +4 -0
  400. package/src/tests/channel-activity.test.ts +9 -0
  401. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  402. package/src/tests/claude-hook-output.test.ts +2 -0
  403. package/src/tests/claude-managed-adapter.test.ts +15 -3
  404. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  405. package/src/tests/codex-gpt6-release.test.ts +4 -0
  406. package/src/tests/comb-review-batch.test.ts +17 -4
  407. package/src/tests/comb-status.test.ts +1 -0
  408. package/src/tests/db-client.test.ts +11 -5
  409. package/src/tests/db-retention-defaults.test.ts +28 -3
  410. package/src/tests/db-task-read-contract.test.ts +1 -0
  411. package/src/tests/db-task-write-contract.test.ts +2 -2
  412. package/src/tests/defer-task.test.ts +23 -1
  413. package/src/tests/dsh-adapter.test.ts +1 -1
  414. package/src/tests/e2b-dispatch.test.ts +13 -1
  415. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  416. package/src/tests/entrypoint-repo-autoclone-args.test.ts +10 -0
  417. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  418. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  419. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  420. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  421. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  422. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  423. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  424. package/src/tests/follow-up-gate-shadow.test.ts +268 -10
  425. package/src/tests/fx-adapter.test.ts +4 -5
  426. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  427. package/src/tests/hook-ping-me-order.test.ts +1 -0
  428. package/src/tests/hook-runtime-close.test.ts +1 -0
  429. package/src/tests/improvements-payload.test.ts +2 -2
  430. package/src/tests/linear-outbound-sync.test.ts +59 -25
  431. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  432. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  433. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  434. package/src/tests/onboard-env.test.ts +1 -1
  435. package/src/tests/openai-compatible-providers.test.ts +5 -0
  436. package/src/tests/openapi-route-headers.test.ts +2 -1
  437. package/src/tests/operator-actor-keyless.test.ts +103 -0
  438. package/src/tests/opus-5-5-registry.test.ts +4 -0
  439. package/src/tests/profile-tier-alias.test.ts +9 -3
  440. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  441. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  442. package/src/tests/runner-context-preamble.test.ts +202 -0
  443. package/src/tests/runner-repo-clone-args.test.ts +125 -0
  444. package/src/tests/scheduler-occurrence.test.ts +60 -9
  445. package/src/tests/script-connections-mcp.test.ts +6 -3
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/scripts-namespaces.test.ts +3 -1
  448. package/src/tests/secret-scrubber.test.ts +8 -2
  449. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  450. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  451. package/src/tests/session-route-posture.test.ts +7 -1
  452. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  453. package/src/tests/slack-identity-resolution.test.ts +10 -3
  454. package/src/tests/slack-inline-output.test.ts +10 -8
  455. package/src/tests/slack-render-v2.test.ts +9 -4
  456. package/src/tests/slack-steering.test.ts +8 -2
  457. package/src/tests/slack-thread-participants.test.ts +11 -1
  458. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  459. package/src/tests/swarm-config-encryption.test.ts +5 -8
  460. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  461. package/src/tests/workflow-system-one-extraction.test.ts +21 -0
  462. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  463. package/src/tests/workflow-wait-filter.test.ts +7 -7
  464. package/src/tests/worktree-reaper.test.ts +15 -4
  465. package/src/tools/app-patch.ts +6 -2
  466. package/src/tools/app-upsert.ts +8 -4
  467. package/src/tools/defer-task.ts +17 -77
  468. package/src/tools/kv/kv-get.ts +2 -0
  469. package/src/tools/kv/kv-list.ts +11 -5
  470. package/src/tools/kv/kv-set.ts +1 -3
  471. package/src/tools/repos/update-repo.ts +37 -19
  472. package/src/tools/schedules/create-schedule.ts +20 -3
  473. package/src/tools/schedules/patch-schedule.ts +30 -4
  474. package/src/tools/schedules/run-schedule-now.ts +21 -1
  475. package/src/tools/schedules/update-schedule.ts +30 -4
  476. package/src/tools/script-apis.ts +9 -4
  477. package/src/tools/script-common.ts +2 -2
  478. package/src/tools/script-run.ts +8 -0
  479. package/src/tools/script-upsert.ts +1 -1
  480. package/src/tools/send-task.ts +17 -3
  481. package/src/tools/slack-download-file.ts +15 -12
  482. package/src/tools/slack-post.ts +14 -3
  483. package/src/tools/slack-read.ts +3 -1
  484. package/src/tools/slack-reply.ts +22 -2
  485. package/src/tools/slack-start-thread.ts +8 -1
  486. package/src/tools/slack-upload-file.ts +99 -96
  487. package/src/tools/swarm-config/set-config.ts +3 -1
  488. package/src/tools/swarm-x.ts +0 -2
  489. package/src/tools/task-action.ts +16 -3
  490. package/src/tools/utils.ts +4 -1
  491. package/src/types.ts +18 -2
  492. package/src/utils/amp-models.ts +20 -4
  493. package/src/utils/constants.ts +20 -0
  494. package/src/utils/deferral-time.ts +61 -0
  495. package/src/utils/request-auth-context.ts +15 -16
  496. package/src/utils/secret-scrubber.ts +7 -5
  497. package/src/workflows/engine.ts +42 -19
  498. package/src/workflows/executors/agent-task.ts +13 -2
  499. package/src/workflows/executors/code-match.ts +11 -31
  500. package/src/workflows/executors/script.ts +13 -0
  501. package/src/workflows/executors/swarm-script.ts +0 -2
  502. package/src/workflows/executors/system-one-extraction.ts +9 -6
  503. package/src/workflows/executors/wait.ts +1 -1
  504. package/src/workflows/foreach-driver.ts +11 -13
  505. package/src/workflows/input.ts +24 -1
  506. package/src/workflows/model-validation.ts +13 -1
  507. package/src/workflows/node-timeout.ts +18 -0
  508. package/src/workflows/predicate-sandbox.ts +171 -0
  509. package/src/workflows/retry-poller.ts +3 -2
  510. package/src/workflows/triggers.ts +21 -11
  511. package/src/workflows/wait-filter.ts +14 -192
  512. package/src/x/composio.ts +10 -1
  513. package/templates/skills/apps/SKILL.md +4 -2
  514. package/templates/skills/apps/content.md +4 -2
  515. package/templates/skills/code-quality/content.md +4 -4
  516. package/templates/skills/heartbeat-runbook/content.md +1 -0
  517. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  518. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  519. package/templates/skills/slack-interaction/content.md +4 -0
  520. package/templates/skills/swarm-docs/content.md +8 -0
  521. package/templates/skills/swarm-scripts/SKILL.md +44 -0
  522. package/templates/skills/swarm-scripts/content.md +44 -0
  523. package/dist/acp-adapter-tbt61zkm.js +0 -17
  524. package/dist/cli-5ss6qqt9.js +0 -45
  525. package/dist/cli-b9ygp1kz.js +0 -459
  526. package/dist/cli-dzzh58sy.js +0 -6996
  527. package/dist/cli-j9ccfveb.js +0 -1849
  528. package/dist/cli-kj0hyr43.js +0 -51
  529. package/dist/cli-m8f4379k.js +0 -173
  530. package/dist/cli-mna6pmfx.js +0 -1485
  531. package/dist/cli-r8ddn0hf.js +0 -25583
  532. package/dist/core-bwp98v4w.js +0 -42
  533. package/dist/dsh-adapter-43ygwqn7.js +0 -9
  534. package/dist/fx-adapter-cr2hq17y.js +0 -20
  535. package/dist/grok-adapter-ayddnbsc.js +0 -20
  536. package/dist/handlers-7ghs84x2.js +0 -41
  537. package/dist/heartbeat-4c022m6a.js +0 -50
  538. package/dist/hook-4k84x499.js +0 -22
  539. package/dist/index-dtt0d634.js +0 -44
  540. package/dist/index-hmszyqkk.js +0 -42
  541. package/dist/index-j6rm1rtn.js +0 -39
  542. package/dist/index-rwwhsmjg.js +0 -13
  543. package/dist/index-t56y945n.js +0 -4
  544. package/dist/index-vfemrwwk.js +0 -10002
  545. package/dist/lead-g2j4q39z.js +0 -83
  546. package/dist/thread-buffer-epx3san4.js +0 -42
  547. package/dist/worker-09gqn9xy.js +0 -83
  548. package/dist/{azure-openai-responses-jeaas6x0.js → azure-openai-responses-e76k86gf.js} +4 -4
  549. package/dist/{openai-codex-responses-70g39cgz.js → openai-codex-responses-z2h941b8.js} +4 -4
  550. package/dist/{openai-completions-cv3hp4h5.js → openai-completions-5bxdkeg9.js} +4 -4
  551. package/dist/{openai-responses-trsvnks6.js → openai-responses-dzf3e8r5.js} +4 -4
@@ -8,56 +8,15 @@
8
8
  * deep-equal (numbers/strings/booleans/arrays/objects). Missing keys or
9
9
  * type mismatches → no-match. ALL keys must match.
10
10
  *
11
- * 2. **String form** — JS arrow-function body, evaluated in a sandbox. The
12
- * body must evaluate to a function `(payload) => boolean`. Result is
13
- * `!!`-coerced. Throws → no-match. Hard-capped at 50ms wall-clock.
11
+ * 2. **String form** — JS arrow-function source `(payload) => boolean`,
12
+ * evaluated in a QuickJS sandbox (`./predicate-sandbox`). The payload
13
+ * crosses as a JSON copy. Result is `!!`-coerced. Throws, Promise
14
+ * returns, and runs past 50ms → no-match.
14
15
  *
15
16
  * No filter (undefined) → matches anything.
16
- *
17
- * SECURITY:
18
- * - The string-form sandbox shadows dangerous globals (incl. `eval`,
19
- * `Function`, `AsyncFunction`) — STRICTER than `code-match` because filter
20
- * strings are higher-volume and authored by less-trusted workflow authors.
21
- * - Payload is `structuredClone`d before being passed to the user fn so
22
- * side-effects on the cloned argument do not leak back to the bus payload.
23
- * - The 50ms timeout defangs infinite loops and pathological-regex DoS.
24
17
  */
25
18
 
26
- // ─── Sandbox config ─────────────────────────────────────────
27
-
28
- /**
29
- * Globals to shadow when invoking the user filter via `new Function`.
30
- *
31
- * - `PARAM_SHADOW_KEYS`: passed as parameter names to `new Function` so they
32
- * resolve to `undefined` at call time. `"use strict"` forbids `eval`,
33
- * `arguments`, `Function`, `AsyncFunction` as parameter names — we shadow
34
- * those via `var`-declared locals inside the function body instead.
35
- * - `BODY_SHADOW_KEYS`: shadowed via `var X = undefined;` at the top of the
36
- * body so identifier resolution finds the local before climbing to the
37
- * global scope. This blocks `eval()`, `Function(...)`, and the
38
- * constructor-chain escape `payload.constructor.constructor(...)` because
39
- * the inner `Function` resolves to undefined.
40
- *
41
- * STRICTER than `src/workflows/executors/code-match.ts:19-30` because filter
42
- * strings are higher-volume and authored by less-trusted workflow authors.
43
- */
44
- const PARAM_SHADOW_KEYS = [
45
- "require",
46
- "process",
47
- "Bun",
48
- "globalThis",
49
- "global",
50
- "fetch",
51
- "setTimeout",
52
- "setInterval",
53
- ] as const;
54
-
55
- const PARAM_SHADOW_VALUES = PARAM_SHADOW_KEYS.map(() => undefined);
56
-
57
- // Identifier names that strict mode reserves as parameter names. Shadowed via
58
- // `var X = undefined;` declarations at the top of the function body.
59
- const BODY_SHADOW_KEYS = ["eval", "Function", "AsyncFunction"] as const;
60
- const BODY_SHADOW_PREAMBLE = BODY_SHADOW_KEYS.map((k) => `var ${k} = undefined;`).join(" ");
19
+ import { checkPredicateSyntax, evaluatePredicate } from "./predicate-sandbox";
61
20
 
62
21
  const FILTER_TIMEOUT_MS = 50;
63
22
 
@@ -120,135 +79,21 @@ function matchObjectFilter(payload: unknown, filter: Record<string, unknown>): b
120
79
  // ─── String-form helpers ────────────────────────────────────
121
80
 
122
81
  /**
123
- * Run the user fn with a 50ms wall-clock cap. Returns `null` on timeout / throw.
124
- *
125
- * Note: this is a soft timeout — a tight CPU-bound loop in the user fn cannot
126
- * be pre-empted by JS (single-threaded). The cap works because the timeout
127
- * timer fires AFTER the synchronous fn returns or throws; if the fn never
128
- * returns we still return `null` to the caller via the race below, but the
129
- * fn itself keeps running on the event loop until it yields. In practice the
130
- * sandbox blocks `setTimeout`/`setInterval`/async patterns, so an infinite
131
- * loop will block the listener until the JIT or GC interrupts it; we accept
132
- * that bounded risk per the plan's security note. The race ensures we DO NOT
133
- * propagate a hung promise into the caller.
82
+ * Validate a string filter at executor-init time. Throws if the filter source
83
+ * is too long or does not parse.
134
84
  */
135
- async function runWithTimeout<T>(fn: () => T): Promise<T | null> {
136
- return new Promise<T | null>((resolve) => {
137
- let settled = false;
138
- const timer = setTimeout(() => {
139
- if (settled) return;
140
- settled = true;
141
- resolve(null);
142
- }, FILTER_TIMEOUT_MS);
143
-
144
- // Run synchronously on the next microtask so we can race the timer.
145
- queueMicrotask(() => {
146
- if (settled) return;
147
- try {
148
- const v = fn();
149
- // If v is a Promise, the contract says "filters are synchronous":
150
- // attach a no-op catch IMMEDIATELY (so a sync rejection from inside
151
- // the user fn doesn't crash the runtime) and resolve to a sentinel
152
- // that the caller treats as "no-match". We wrap in a marker object
153
- // so the outer `await` can't unwrap a Thenable for us.
154
- const then =
155
- v !== null && typeof v === "object" ? (v as { then?: unknown }).then : undefined;
156
- if (typeof then === "function") {
157
- then.call(v, undefined, () => {});
158
- settled = true;
159
- clearTimeout(timer);
160
- resolve({ __asyncRejected: true } as T);
161
- return;
162
- }
163
- if (settled) return;
164
- settled = true;
165
- clearTimeout(timer);
166
- resolve(v);
167
- } catch {
168
- if (settled) return;
169
- settled = true;
170
- clearTimeout(timer);
171
- resolve(null);
172
- }
173
- });
174
- });
175
- }
176
-
177
- const ASYNC_SENTINEL = "__asyncRejected";
178
-
179
- function isAsyncSentinel(value: unknown): boolean {
180
- return (
181
- value !== null &&
182
- typeof value === "object" &&
183
- (value as Record<string, unknown>)[ASYNC_SENTINEL] === true
184
- );
185
- }
186
-
187
- /**
188
- * Compile and validate a string filter at executor-init time. Throws if the
189
- * filter does not parse as `(${filter})`. Returns a callable.
190
- */
191
- export function compileStringFilter(filter: string): (payload: unknown) => unknown {
85
+ export async function compileStringFilter(filter: string): Promise<void> {
192
86
  // Length cap is enforced by the Zod schema (`.max(2048)`); this is a
193
87
  // defense-in-depth check.
194
88
  if (filter.length > 2048) {
195
89
  throw new Error(`wait filter source exceeds 2KB cap (${filter.length} bytes)`);
196
90
  }
197
- // Compile — surfaces SyntaxError early.
198
- //
199
- // We do NOT use `"use strict"` here because strict-mode FORBIDS declaring
200
- // `eval`, `Function`, etc. as bindings (the very thing we need to do). We
201
- // use sloppy mode + var-shadowing inside an IIFE-style wrapper so the user
202
- // fn body sees `eval`, `Function`, `AsyncFunction` (and the param-shadowed
203
- // `process`, `require`, etc.) as `undefined`.
204
- //
205
- // The user's fn itself is wrapped as `(filter)(payload)`. If the user
206
- // writes their own `"use strict"` directive, it applies only inside the
207
- // IIFE — that's fine, because by then the shadowed names are already
208
- // bound to undefined in the enclosing scope.
209
- let fn: (...args: unknown[]) => unknown;
210
91
  try {
211
- fn = new Function(
212
- ...PARAM_SHADOW_KEYS,
213
- "payload",
214
- `${BODY_SHADOW_PREAMBLE} return (${filter})(payload);`,
215
- ) as (...args: unknown[]) => unknown;
92
+ await checkPredicateSyntax(filter);
216
93
  } catch (err) {
217
94
  const msg = err instanceof Error ? err.message : String(err);
218
95
  throw new Error(`wait filter compile error: ${msg}`);
219
96
  }
220
- return (payload: unknown) => fn(...PARAM_SHADOW_VALUES, payload);
221
- }
222
-
223
- // ─── Prototype-stripping helper ─────────────────────────────
224
-
225
- /**
226
- * Recursively rebuild `obj` with `null` prototypes on every plain object so
227
- * the user fn cannot reach the global `Function` constructor via
228
- * `payload.constructor.constructor(...)`. Arrays keep `Array.prototype` so
229
- * `.some()`, `.map()`, etc. still work for legitimate predicates — Array's
230
- * constructor chain still leaks `Function`, but that's a known acceptable
231
- * trade-off (callers needing array methods accept the residual surface).
232
- *
233
- * For deep safety on arrays, callers can use object form filters instead.
234
- *
235
- * Returns primitives and arrays unchanged in shape; rebuilds objects.
236
- */
237
- function nullifyPrototypes(value: unknown): unknown {
238
- if (value === null || typeof value !== "object") return value;
239
- if (Array.isArray(value)) {
240
- // Array methods like `.some` are useful for filter authors. Array's
241
- // constructor IS still reachable via `payload.someArr.constructor`. The
242
- // fix below also nullifies the per-element objects so most legitimate
243
- // queries are safe; users who need stricter deep-blocking should use
244
- // the object-form filter.
245
- return value.map(nullifyPrototypes);
246
- }
247
- const out = Object.create(null) as Record<string, unknown>;
248
- for (const [k, v] of Object.entries(value)) {
249
- out[k] = nullifyPrototypes(v);
250
- }
251
- return out;
252
97
  }
253
98
 
254
99
  // ─── Public matcher ─────────────────────────────────────────
@@ -270,38 +115,15 @@ export async function matchesFilter(payload: unknown, filter: unknown): Promise<
270
115
 
271
116
  // String form.
272
117
  if (typeof filter === "string") {
273
- let userFn: (payload: unknown) => unknown;
118
+ if (filter.length > 2048) return false;
274
119
  try {
275
- userFn = compileStringFilter(filter);
120
+ const result = await evaluatePredicate(filter, payload, "filter", {
121
+ timeoutMs: FILTER_TIMEOUT_MS,
122
+ });
123
+ return result.ok && result.value;
276
124
  } catch {
277
125
  return false;
278
126
  }
279
-
280
- // Defensive copy with null-prototype: prevents (a) mutation leaking back
281
- // to the bus payload, and (b) the `payload.constructor.constructor`
282
- // escape from reaching the global Function constructor through the
283
- // prototype chain.
284
- let cloned: unknown;
285
- try {
286
- const cloneOnce = structuredClone(payload);
287
- cloned = nullifyPrototypes(cloneOnce);
288
- } catch {
289
- // Some payloads (functions, symbols) cannot be structuredClone'd —
290
- // fall back to the raw payload but still apply nullifyPrototypes if
291
- // possible.
292
- try {
293
- cloned = nullifyPrototypes(payload);
294
- } catch {
295
- cloned = payload;
296
- }
297
- }
298
-
299
- const result = await runWithTimeout(() => userFn(cloned));
300
- if (result === null) return false; // timeout / throw
301
- // The runWithTimeout helper substitutes a sentinel for Promise returns
302
- // (filters are synchronous by contract — async predicates → no-match).
303
- if (isAsyncSentinel(result)) return false;
304
- return !!result;
305
127
  }
306
128
 
307
129
  // Anything else (array, number, etc.) → no match.
package/src/x/composio.ts CHANGED
@@ -86,6 +86,7 @@ export function parseComposioArgs(
86
86
  if ((method === "GET" || method === "HEAD") && parsed.body !== undefined) {
87
87
  throw new Error(`${method} requests cannot include --body`);
88
88
  }
89
+ buildComposioUrl(parsed.baseUrl, parsed.endpoint, []);
89
90
 
90
91
  return parsed;
91
92
  }
@@ -131,6 +132,8 @@ export async function executeComposioRequest(
131
132
  body: args.body === undefined ? undefined : JSON.stringify(args.body),
132
133
  headers,
133
134
  method: args.method,
135
+ // A redirect would carry the key header to the new host.
136
+ redirect: "manual",
134
137
  });
135
138
  } catch (err) {
136
139
  return {
@@ -183,9 +186,11 @@ export function composioArgsFromParts(input: {
183
186
  throw new Error(`${method} requests cannot include a body`);
184
187
  }
185
188
  assertRelativeComposioPath(input.endpoint);
189
+ const baseUrl = input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL;
190
+ buildComposioUrl(baseUrl, input.endpoint, []);
186
191
 
187
192
  return {
188
- baseUrl: input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL,
193
+ baseUrl,
189
194
  body: input.body,
190
195
  endpoint: input.endpoint,
191
196
  headers: input.headers ?? {},
@@ -228,6 +233,10 @@ function buildComposioUrl(
228
233
  const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
229
234
  const cleanEndpoint = endpoint.replace(/^\/+/, "");
230
235
  const url = new URL(cleanEndpoint, normalizedBase);
236
+ // The key header is bound to the base URL's host: a path must not change it.
237
+ if (url.origin !== new URL(normalizedBase).origin) {
238
+ throw new Error("endpoint must be a Composio API path on the configured base URL");
239
+ }
231
240
  for (const [key, value] of query) {
232
241
  url.searchParams.append(key, value);
233
242
  }
@@ -34,6 +34,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
34
34
 
35
35
  For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
36
36
 
37
+ When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
38
+
37
39
  `app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
38
40
 
39
41
  ### Reading an app's callable surface
@@ -179,7 +181,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
179
181
 
180
182
  Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
181
183
 
182
- Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-10 models and at most 20 reusable elements; each declared model has 1-40 columns. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
184
+ Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
183
185
 
184
186
  ### Reusable elements
185
187
 
@@ -411,7 +413,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
411
413
 
412
414
  For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
413
415
 
414
- Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
416
+ Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
415
417
 
416
418
  ### Pages, routes, and page trees
417
419
 
@@ -29,6 +29,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
29
29
 
30
30
  For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
31
31
 
32
+ When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
33
+
32
34
  `app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
33
35
 
34
36
  ### Reading an app's callable surface
@@ -174,7 +176,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
174
176
 
175
177
  Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
176
178
 
177
- Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-10 models and at most 20 reusable elements; each declared model has 1-40 columns. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
179
+ Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
178
180
 
179
181
  ### Reusable elements
180
182
 
@@ -406,7 +408,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
406
408
 
407
409
  For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
408
410
 
409
- Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
411
+ Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
410
412
 
411
413
  ### Pages, routes, and page trees
412
414
 
@@ -17,7 +17,7 @@ The task's `vcsProvider` field or the remote URL tells you the provider.
17
17
 
18
18
  ## Before you push
19
19
 
20
- 1. Run every command in the Repository Guidelines section "PR Checks" of your system prompt, one after the other. When no guidelines exist, run the checklist in the repo's CLAUDE.md. When neither exists, ask the lead before you push.
20
+ 1. Run every command in the Repository Guidelines section "PR Checks" of your system prompt, one after the other. Follow each check's own scope: a check the guidelines run once before the PR opens does not rerun on later fix pushes. When no guidelines exist, run the checklist in the repo's CLAUDE.md. When neither exists, ask the lead before you push.
21
21
  2. A failing check: fix the cause and run the check again. Push only when every check passes.
22
22
  3. Git hooks stay on. `--no-verify` and any other bypass flag are out.
23
23
  4. `main` and `master` are never force-pushed.
@@ -38,9 +38,9 @@ A workflow or task brief that opens a PR names this section instead of restating
38
38
 
39
39
  ## After you open a PR
40
40
 
41
- 1. Wait about 30 seconds, then read CI: `gh pr checks <number>` or `glab mr view --json pipelines`.
42
- 2. Red CI: read the failing job, fix, push, read CI again. Repeat until green.
43
- 3. Put the PR URL and the CI status in your task output.
41
+ 1. Put the PR URL and the head SHA in your task output.
42
+ 2. When the Repository Guidelines or a repo skill say the deployment handles red CI, review rounds and merge-queue ejections with workflows, your task ends here. Do not wait for CI: no `gh pr checks --watch`, `gh run watch` or sleep loops. A red check or a review round comes back to you as a new task.
43
+ 3. Otherwise, wait about 30 seconds, then read CI: `gh pr checks <number>` or `glab mr view --json pipelines`. Red CI: read the failing job, fix, push, read CI again. Repeat until green, and put the CI status in your task output.
44
44
 
45
45
  ## Merge policy
46
46
 
@@ -9,6 +9,7 @@ Lead only. The heartbeat runbook is your `heartbeatMd` profile field. The server
9
9
  - After a server restart: a `boot-triage` task arrives about 90 seconds later, only when the restart cut off work or left failures, orphans or superseded tasks to check. A clean boot creates none.
10
10
  - The system status is gathered for you. You never create a checklist or boot-triage task yourself.
11
11
  - The runbook text is part of every checklist task prompt. Every line you keep costs tokens on every tick.
12
+ - A heartbeat cut off mid-run (graceful shutdown, restart) leaves a superseded row and a resume task that re-reads all live state. Checkpoint as you go: after each runbook section you finish, `store-progress` the sections done and the PR refs you verified. On a resume, read that checkpoint first and skip the sections it names.
12
13
 
13
14
  Edit the runbook with a native Edit of its mirror `/workspace/HEARTBEAT.md`. The PostToolUse hook PUTs the file to the `heartbeatMd` field. An edit to any of the four mirrors (`SOUL.md`, `IDENTITY.md`, `TOOLS.md`, `HEARTBEAT.md`) PUTs all four, so an `update-profile` write to `heartbeatMd` is overwritten by the stale mirror the next time you edit one of them in the same session. The hook logs a refused write (for example a 400 from the tracked-item date check) to stderr only, so verify every edit by DB anchor: `SELECT instr(heartbeatMd, '<fragment of the new line>') FROM agents WHERE id = '<your agent id>'`. A 0 means the write was refused: PUT `{"heartbeatMd": <file text>}` to `$MCP_BASE_URL/api/agents/$AGENT_ID/profile` with `Authorization: Bearer $API_KEY` and `X-Agent-ID: $AGENT_ID` to read the error, fix the line, and re-check.
14
15
 
@@ -7,6 +7,8 @@ description: Guardrails for polling, scheduled jobs, and long-running external o
7
7
 
8
8
  Use these rules whenever a scheduled or regular task polls or waits on a long-running operation. They prevent heartbeat collisions, lost work, duplicate delivery, and sessions that fail after holding an external job open too long.
9
9
 
10
+ Before you poll a pull request's CI at all, check whether you need to. When the Repository Guidelines or a repo skill say workflows handle red CI, review rounds and merge-queue ejections, end the task at push instead (`code-quality`, "After you open a PR"). The rules below cover the waits that remain.
11
+
10
12
  ## Rule 1 — Never use `ScheduleWakeup` with `delaySeconds >= 300`
11
13
 
12
14
  The runtime heartbeat staleness threshold may sit near the same window as the model prompt-cache TTL. Sleeping for five minutes or longer can therefore look like a dead worker and cause the heartbeat sweep to fail the task mid-poll.
@@ -2,6 +2,8 @@
2
2
 
3
3
  Use these rules whenever a scheduled or regular task polls or waits on a long-running operation. They prevent heartbeat collisions, lost work, duplicate delivery, and sessions that fail after holding an external job open too long.
4
4
 
5
+ Before you poll a pull request's CI at all, check whether you need to. When the Repository Guidelines or a repo skill say workflows handle red CI, review rounds and merge-queue ejections, end the task at push instead (`code-quality`, "After you open a PR"). The rules below cover the waits that remain.
6
+
5
7
  ## Rule 1 — Never use `ScheduleWakeup` with `delaySeconds >= 300`
6
8
 
7
9
  The runtime heartbeat staleness threshold may sit near the same window as the model prompt-cache TTL. Sleeping for five minutes or longer can therefore look like a dead worker and cause the heartbeat sweep to fail the task mid-poll.
@@ -37,6 +37,10 @@ The task carries `slackChannelId` and `slackThreadTs` in its metadata. A follow-
37
37
 
38
38
  Files attached to your task already come with download commands in the task message. Use those before `slack-download-file`. `slack-read` on your task also attaches the files in the thread and gives each one a `fetchCommand`. Don't look for Slack files under `/app/shared` or `/workspace/shared/downloads`: those paths are the API server's disk.
39
39
 
40
+ ### Bulk history (lead)
41
+
42
+ `slack-read` returns at most 100 messages of a thread or a channel, with no cursor. A worker that needs more than that asks the lead; it never reads channel history around `slack-read`. As the lead, first call `slack-read` with the `channelId`: if it refuses the channel (permission, external or unverified), stop there. Only after it succeeds, for the full history, page the Slack Web API from a script, with the bot token through a script credential binding: `conversations.history` with the channel id, following `response_metadata.next_cursor` until it is empty. Write the collected messages to a file, not into a message or the task output.
43
+
40
44
  ## Message limits
41
45
 
42
46
  - Text sent without `blocks` is split into sections under Slack's 3,000-character section limit for you. With explicit `blocks`, keep each section's text at or under 3,000 characters yourself.
@@ -71,6 +71,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
71
71
  - [Reviewing purchase order and supplier confirmation differences with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-order-confirmation-review). Reference.
72
72
  - [Reviewing marketplace partner payout discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-payout-exception-review). Reference.
73
73
  - [Preparing marketplace moderation appeals for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-moderation-appeals). Reference.
74
+ - [Preparing a suspected marketplace fraud alert for human investigation with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-fraud-alert-investigation). Reference.
74
75
  - [Reviewing customer billing disputes with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-billing-dispute-review). Reference.
75
76
  - [Preparing unmatched bank transactions for finance review with AI agents](https://docs.agent-swarm.dev/docs/guides/agent-assisted-bank-reconciliation-review). Reference.
76
77
  - [Reviewing a proposed customer pricing change with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-pricing-change-review). Reference.
@@ -87,10 +88,14 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
87
88
  - [Coordinating a guest accessibility request between guest support and property operations with AI agents](https://docs.agent-swarm.dev/docs/guides/guest-accessibility-request-handoff). Reference.
88
89
  - [Reviewing supplier performance across delivery, quality and service records with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-performance-review). Reference.
89
90
  - [Reviewing a supplier ingredient specification change with AI agents](https://docs.agent-swarm.dev/docs/guides/food-supplier-ingredient-change-review). Reference.
91
+ - [Preparing a batch traceability packet for a mock recall with AI agents](https://docs.agent-swarm.dev/docs/guides/food-batch-traceability-exercise). Reference.
90
92
  - [Preparing a bid or no-bid review for an incoming RFP with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-rfp-bid-qualification). Reference.
93
+ - [Reviewing why sales opportunities were won or lost with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-win-loss-review). Reference.
91
94
  - [Preparing contractor credential expiry checks for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/contractor-license-expiry-review). Reference.
92
95
  - [Coordinating a departing employee's access review across HR and IT with AI agents](https://docs.agent-swarm.dev/docs/guides/employee-offboarding-access-review). Reference.
96
+ - [Preparing workforce training completion evidence for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-training-completion-evidence-review). Reference.
93
97
  - [Briefing sales and leadership on competitor changes with AI agents](https://docs.agent-swarm.dev/docs/guides/competitor-change-brief). Reference.
98
+ - [Preparing a business continuity tabletop exercise with AI agents](https://docs.agent-swarm.dev/docs/guides/business-continuity-tabletop-preparation). Reference.
94
99
  - [Deployment Guide](https://docs.agent-swarm.dev/docs/guides/deployment). When: Someone wants to run Agent Swarm on their own server with Docker Compose.
95
100
  - [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.
96
101
  - [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
@@ -101,6 +106,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
101
106
  - [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
102
107
  - [agent-fs Co-deployment](https://docs.agent-swarm.dev/docs/guides/agent-fs-co-deployment). When: Someone wants shared persistent files for agents on a self-hosted swarm.
103
108
  - [Self-Hosted SSO](https://docs.agent-swarm.dev/docs/guides/self-hosted-sso). When: Someone wants their self-hosted swarm dashboard behind single sign-on.
109
+ - [Reviewing why actual demand differed from a forecast with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-demand-forecast-accuracy-review). Reference.
104
110
  - [AI operations governance for small companies](https://docs.agent-swarm.dev/docs/guides/ai-operations-governance). Reference.
105
111
  - [Repo merge policy](https://docs.agent-swarm.dev/docs/guides/repo-merge-policy). Reference.
106
112
  - [E2B Provider Smoke Tests](https://docs.agent-swarm.dev/docs/guides/e2b-provider-smoke-tests). Reference.
@@ -111,6 +117,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
111
117
  - [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
112
118
  - [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
113
119
  - [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
120
+ - [Connect Your AI Client with the User MCP](https://docs.agent-swarm.dev/docs/guides/user-mcp). When: Someone wants to send or check swarm tasks from ChatGPT, Claude, Codex, Cursor or another AI assistant they already use.
114
121
  - [MCP Events on the User MCP](https://docs.agent-swarm.dev/docs/guides/mcp-events). Reference.
115
122
  - [Claude Code Mod](https://docs.agent-swarm.dev/docs/guides/claude-code-mod). Reference.
116
123
  - [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.
@@ -143,6 +150,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
143
150
  - [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
144
151
  - [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
145
152
  - [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
153
+ - [Investigating a payroll discrepancy for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-payroll-discrepancy-review). Reference.
146
154
  - [Preparing a service capacity planning brief with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-service-capacity-planning). Reference.
147
155
  - [Preparing a property maintenance request for human triage with AI agents](https://docs.agent-swarm.dev/docs/guides/maintenance-work-order-triage). Reference.
148
156
  - [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
@@ -101,6 +101,7 @@ The route runs the same typecheck and scope rules as the tool.
101
101
  - `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
102
102
  - Retries: `ctx.swarm` calls retry a 429 on any call, and a 502/503/504 or network error on reads and on writes that send an idempotency key (such as `workflow_trigger` with `idempotencyKey`), within about 5 s. `ctx.stdlib.fetch` retries a 429 on any method and a 502/503/504 or network error on GET, HEAD, OPTIONS, PUT and DELETE. A POST or PATCH retries those only with an `Idempotency-Key` header: pass `retry: { idempotencyKey: true }` to send one UUID on every attempt. The key prevents a duplicate only when the server dedupes by it. `retry: false` makes one attempt. Wrap anything else, sync or async, in `ctx.stdlib.retry(fn, { retries, minDelayMs, maxDelayMs, budgetMs, retryOn })`; it rethrows the last error or returns the last result when attempts run out.
103
103
  - `ctx.logger`: `log`, `warn`, `error`. Keep logs short.
104
+ - `ctx.caller`: who started this run. `{ kind: "agent", agentId }` for a direct call, `{ kind: "script", agentId }` for a call from another script. Frozen.
104
105
 
105
106
  ### Files and shell
106
107
 
@@ -126,6 +127,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
126
127
  - Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
127
128
  - When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
128
129
 
130
+ ### Durable objects
131
+
132
+ A durable object is a named instance of a global script class. Each instance keeps its own JSON state between calls. Only one call runs on an instance at a time, so you do not need your own KV locks.
133
+
134
+ ```ts
135
+ import { DurableObject } from "swarm-sdk";
136
+
137
+ export default class Counter extends DurableObject<{ n: number }> {
138
+ initialState() { return { n: 0 }; }
139
+ async add(args: { by: number }) { this.state.n += args.by; return this.state.n; }
140
+ }
141
+ ```
142
+
143
+ Save it with `script_upsert` in `scope: "global"`. The API refuses a DurableObject class in agent scope and in an inline `script_run`. Call one instance by id:
144
+
145
+ ```ts
146
+ script_run({ name: "counter", object: { id: "team-a", method: "add" }, args: { by: 2 } })
147
+ // → result: 2, object: { id: "team-a", stateVersion: 1, destroyed: false }
148
+ ```
149
+
150
+ - **Methods**: each callable method takes `(args, ctx)` and returns a JSON value. You cannot call `constructor`, `initialState`, `migrate`, `destroy`, a name that starts with `_`, a static method, a getter or an arrow-function field. The API refuses such a call before it runs any code.
151
+ - **First call**: an id with no state starts from `initialState()`.
152
+ - **State rules**:
153
+ - `this.state` must be JSON, at most 2 MiB.
154
+ - The API saves it only when the method returns without an error. A thrown error keeps the old state.
155
+ - The API saves `this.state` as it is when the method returns. A change made later, by work the method did not await, is lost.
156
+ - **Versions**: every call runs the latest saved version of the script. When the stored state comes from an older version, `migrate(state, fromVersion)` runs once before the method, if you define it.
157
+ - **Destroy**: `this.destroy()` deletes the state when the method returns. The next call on that id starts again from `initialState()`.
158
+ - **Idle expiry**: `static idleTtlSec = 3600` deletes the state after 1 hour with no call. Without it, state is kept until `destroy()`.
159
+ - **Read the state**: `kv_get({ namespace: "durable:<scriptId>", key: "state/<id>" })` returns `{ codeVersion, stateVersion, state }`, with secrets scrubbed. KV writes on a `durable:` namespace are refused. Change state only through a method.
160
+ - **Errors**:
161
+ - `object busy` (409): another call held the instance for 30 s (5 s for a call from a script). Retry the call later. Do not loop.
162
+ - `already in this call chain` (409): a method called its own instance, directly or through other scripts. Restructure the call. Do not retry.
163
+ - `call depth exceeds 16` (400): a chain of nested script runs is too deep.
164
+
165
+ | Cloudflare Durable Objects | Swarm durable objects |
166
+ |---|---|
167
+ | `this.ctx.storage` key-value API | One JSON `this.state` snapshot per instance |
168
+ | `fetch()` and RPC from a Worker | `script_run` with `object: { id, method }` |
169
+ | `env` bindings | `ctx` (the same `ctx` as other scripts), passed to each method |
170
+ | Alarms | Not available yet |
171
+ | Methods take any arguments | Methods take `(args, ctx)` |
172
+
129
173
  ## Inline script pattern
130
174
 
131
175
  ```typescript
@@ -96,6 +96,7 @@ The route runs the same typecheck and scope rules as the tool.
96
96
  - `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
97
97
  - Retries: `ctx.swarm` calls retry a 429 on any call, and a 502/503/504 or network error on reads and on writes that send an idempotency key (such as `workflow_trigger` with `idempotencyKey`), within about 5 s. `ctx.stdlib.fetch` retries a 429 on any method and a 502/503/504 or network error on GET, HEAD, OPTIONS, PUT and DELETE. A POST or PATCH retries those only with an `Idempotency-Key` header: pass `retry: { idempotencyKey: true }` to send one UUID on every attempt. The key prevents a duplicate only when the server dedupes by it. `retry: false` makes one attempt. Wrap anything else, sync or async, in `ctx.stdlib.retry(fn, { retries, minDelayMs, maxDelayMs, budgetMs, retryOn })`; it rethrows the last error or returns the last result when attempts run out.
98
98
  - `ctx.logger`: `log`, `warn`, `error`. Keep logs short.
99
+ - `ctx.caller`: who started this run. `{ kind: "agent", agentId }` for a direct call, `{ kind: "script", agentId }` for a call from another script. Frozen.
99
100
 
100
101
  ### Files and shell
101
102
 
@@ -121,6 +122,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
121
122
  - Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
122
123
  - When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
123
124
 
125
+ ### Durable objects
126
+
127
+ A durable object is a named instance of a global script class. Each instance keeps its own JSON state between calls. Only one call runs on an instance at a time, so you do not need your own KV locks.
128
+
129
+ ```ts
130
+ import { DurableObject } from "swarm-sdk";
131
+
132
+ export default class Counter extends DurableObject<{ n: number }> {
133
+ initialState() { return { n: 0 }; }
134
+ async add(args: { by: number }) { this.state.n += args.by; return this.state.n; }
135
+ }
136
+ ```
137
+
138
+ Save it with `script_upsert` in `scope: "global"`. The API refuses a DurableObject class in agent scope and in an inline `script_run`. Call one instance by id:
139
+
140
+ ```ts
141
+ script_run({ name: "counter", object: { id: "team-a", method: "add" }, args: { by: 2 } })
142
+ // → result: 2, object: { id: "team-a", stateVersion: 1, destroyed: false }
143
+ ```
144
+
145
+ - **Methods**: each callable method takes `(args, ctx)` and returns a JSON value. You cannot call `constructor`, `initialState`, `migrate`, `destroy`, a name that starts with `_`, a static method, a getter or an arrow-function field. The API refuses such a call before it runs any code.
146
+ - **First call**: an id with no state starts from `initialState()`.
147
+ - **State rules**:
148
+ - `this.state` must be JSON, at most 2 MiB.
149
+ - The API saves it only when the method returns without an error. A thrown error keeps the old state.
150
+ - The API saves `this.state` as it is when the method returns. A change made later, by work the method did not await, is lost.
151
+ - **Versions**: every call runs the latest saved version of the script. When the stored state comes from an older version, `migrate(state, fromVersion)` runs once before the method, if you define it.
152
+ - **Destroy**: `this.destroy()` deletes the state when the method returns. The next call on that id starts again from `initialState()`.
153
+ - **Idle expiry**: `static idleTtlSec = 3600` deletes the state after 1 hour with no call. Without it, state is kept until `destroy()`.
154
+ - **Read the state**: `kv_get({ namespace: "durable:<scriptId>", key: "state/<id>" })` returns `{ codeVersion, stateVersion, state }`, with secrets scrubbed. KV writes on a `durable:` namespace are refused. Change state only through a method.
155
+ - **Errors**:
156
+ - `object busy` (409): another call held the instance for 30 s (5 s for a call from a script). Retry the call later. Do not loop.
157
+ - `already in this call chain` (409): a method called its own instance, directly or through other scripts. Restructure the call. Do not retry.
158
+ - `call depth exceeds 16` (400): a chain of nested script runs is too deep.
159
+
160
+ | Cloudflare Durable Objects | Swarm durable objects |
161
+ |---|---|
162
+ | `this.ctx.storage` key-value API | One JSON `this.state` snapshot per instance |
163
+ | `fetch()` and RPC from a Worker | `script_run` with `object: { id, method }` |
164
+ | `env` bindings | `ctx` (the same `ctx` as other scripts), passed to each method |
165
+ | Alarms | Not available yet |
166
+ | Methods take any arguments | Methods take `(args, ctx)` |
167
+
124
168
  ## Inline script pattern
125
169
 
126
170
  ```typescript
@@ -1,17 +0,0 @@
1
- import {
2
- ACPAdapter2
3
- } from "./cli-887vhew6.js";
4
- import"./cli-0qt3epg4.js";
5
- import"./cli-f7b9nyvk.js";
6
- import"./cli-prz1p3ft.js";
7
- import"./cli-1jq2em7b.js";
8
- import"./cli-k0nebh10.js";
9
- import"./cli-0h8skzss.js";
10
- import"./cli-srre41gb.js";
11
- import"./cli-0726awxw.js";
12
- import"./cli-zntvmqmm.js";
13
- import"./cli-9n6g14vs.js";
14
- import"./cli-ywy8yz6t.js";
15
- export {
16
- ACPAdapter2 as ACPAdapter
17
- };