@desplega.ai/agent-swarm 2.8.2 → 2.9.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 (558) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
  20. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
  28. package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
  30. package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
  34. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  35. package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
  36. package/dist/cli-6dp0jkfj.js +754 -0
  37. package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
  38. package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
  39. package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
  40. package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
  41. package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
  42. package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
  43. package/dist/cli-8x8y70av.js +103 -0
  44. package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
  45. package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
  46. package/dist/cli-9ttx00s3.js +137 -0
  47. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  48. package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
  49. package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
  50. package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
  51. package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
  52. package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
  53. package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
  56. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  57. package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
  58. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  59. package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
  60. package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
  61. package/dist/cli-faf46gdq.js +714 -0
  62. package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
  63. package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
  64. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  65. package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
  66. package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
  67. package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
  68. package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
  69. package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
  70. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  71. package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
  72. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  73. package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
  74. package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
  75. package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
  76. package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
  77. package/dist/cli-kj0hyr43.js +51 -0
  78. package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
  79. package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
  80. package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
  81. package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
  82. package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
  83. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  84. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  85. package/dist/cli-nhq5js1b.js +142 -0
  86. package/dist/cli-nmcpzbty.js +296 -0
  87. package/dist/cli-nr46j5pw.js +78 -0
  88. package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
  89. package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
  90. package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
  91. package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
  93. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  94. package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
  97. package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
  98. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  99. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  100. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  101. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  102. package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
  103. package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
  104. package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
  105. package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
  106. package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
  107. package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
  108. package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
  109. package/dist/cli-w7dxb2fj.js +921 -0
  110. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  111. package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
  115. package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
  116. package/dist/cli.js +29 -26
  117. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
  118. package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
  119. package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
  120. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
  121. package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
  122. package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
  123. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
  124. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
  125. package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
  126. package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
  127. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
  128. package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
  129. package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
  130. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
  131. package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
  132. package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
  133. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  134. package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
  135. package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
  136. package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
  137. package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
  138. package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
  139. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  140. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  141. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  142. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  143. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  144. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  145. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  146. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  147. package/dist/grok-adapter-3db1c538.js +19 -0
  148. package/dist/handlers-k22n8mnn.js +33 -0
  149. package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
  150. package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
  151. package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
  152. package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
  153. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  154. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  155. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  156. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  157. package/dist/index-8xcyd3mc.js +33 -0
  158. package/dist/index-9sy2bh6n.js +38 -0
  159. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  160. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  161. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  162. package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
  163. package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
  164. package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
  165. package/dist/index-tx9mc2ap.js +570 -0
  166. package/dist/index-wjd56k1v.js +34 -0
  167. package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
  168. package/dist/lead-atxf3q6e.js +72 -0
  169. package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
  170. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  171. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  172. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  173. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  174. package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
  175. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  176. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  177. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
  178. package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
  179. package/dist/pending-sqkrb836.js +80 -0
  180. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
  181. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
  182. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
  183. package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
  184. package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
  185. package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
  186. package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
  187. package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
  188. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
  189. package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
  190. package/dist/thread-buffer-4yz236d0.js +36 -0
  191. package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
  192. package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
  193. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
  194. package/dist/worker-p4hbtcy3.js +72 -0
  195. package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
  196. package/openapi.json +4518 -2356
  197. package/package.json +11 -8
  198. package/plugin/commands/create-pr.md +1 -1
  199. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  200. package/src/apps/action-runner.ts +21 -1
  201. package/src/apps/catalog.generated.json +626 -17
  202. package/src/apps/page-validator.ts +314 -8
  203. package/src/assets/key.ts +6 -0
  204. package/src/be/agent-fs-user-keys.ts +186 -0
  205. package/src/be/audit-user.ts +27 -13
  206. package/src/be/automation-preflight.test.ts +14 -14
  207. package/src/be/automation-preflight.ts +24 -16
  208. package/src/be/boot-scrub-sweep.ts +143 -14
  209. package/src/be/caller-session-group.ts +86 -0
  210. package/src/be/checklist.ts +375 -0
  211. package/src/be/db/agents.ts +12 -1
  212. package/src/be/db/approvals.ts +26 -0
  213. package/src/be/db/session-moves.ts +23 -0
  214. package/src/be/db/session-tree.ts +78 -19
  215. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  216. package/src/be/db/tasks/read.ts +33 -0
  217. package/src/be/db/tasks/slack-fold.ts +116 -0
  218. package/src/be/db/tasks/write.ts +34 -0
  219. package/src/be/db-queries/mcp-servers.ts +13 -0
  220. package/src/be/db-queries/oauth.ts +6 -0
  221. package/src/be/db-queries/task-artifacts.ts +10 -8
  222. package/src/be/db.ts +74 -22
  223. package/src/be/extensions/assets.ts +17 -13
  224. package/src/be/import/config.ts +54 -0
  225. package/src/be/import/dir-source.ts +372 -0
  226. package/src/be/import/index.ts +149 -0
  227. package/src/be/import/pending.ts +71 -0
  228. package/src/be/import/schema.ts +137 -0
  229. package/src/be/import/seeders.ts +462 -0
  230. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  231. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  232. package/src/be/migrations/293_savings_component_links.sql +58 -0
  233. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  234. package/src/be/migrations/297_import_ownership.sql +34 -0
  235. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  236. package/src/be/migrations/302_checklist_items.sql +23 -0
  237. package/src/be/model-profile-check.ts +10 -2
  238. package/src/be/multi-runtime.ts +8 -1
  239. package/src/be/rbac-roles.ts +8 -1
  240. package/src/be/runtime-pools/demand.ts +20 -2
  241. package/src/be/runtime-pools/reachability.ts +31 -0
  242. package/src/be/runtime-pools/routing.ts +8 -1
  243. package/src/be/runtime-pools/supervisor.ts +6 -7
  244. package/src/be/savings/compute.ts +511 -16
  245. package/src/be/savings/model.ts +282 -14
  246. package/src/be/savings/read.ts +1502 -0
  247. package/src/be/savings/rollup.ts +571 -0
  248. package/src/be/script-credential-broker.ts +2 -2
  249. package/src/be/scripts/run-credential.ts +15 -3
  250. package/src/be/scripts/typecheck.ts +90 -8
  251. package/src/be/seed/agent-fs-provision.ts +104 -19
  252. package/src/be/seed/index.ts +1 -1
  253. package/src/be/seed/registry.ts +27 -8
  254. package/src/be/seed/runner.ts +1 -1
  255. package/src/be/seed/schedules-seeder.ts +24 -6
  256. package/src/be/seed/seed-toggle.ts +32 -0
  257. package/src/be/seed/types.ts +6 -0
  258. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  259. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  260. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  261. package/src/be/steering.ts +27 -4
  262. package/src/be/swarm-config-guard.ts +38 -0
  263. package/src/be/task-citations.ts +8 -5
  264. package/src/be/users.ts +29 -2
  265. package/src/commands/onboard/agent-fs-version.ts +1 -1
  266. package/src/commands/runner.ts +219 -42
  267. package/src/e2b/env.ts +2 -0
  268. package/src/extensions/catalog.generated.json +17 -0
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/github/app.ts +10 -1
  271. package/src/github/handlers.ts +6 -3
  272. package/src/github/reactions.ts +12 -14
  273. package/src/heartbeat/heartbeat.ts +14 -4
  274. package/src/http/agents.ts +19 -10
  275. package/src/http/all-routes.ts +2 -0
  276. package/src/http/approval-requests.ts +24 -4
  277. package/src/http/apps.ts +69 -5
  278. package/src/http/checklist.ts +176 -0
  279. package/src/http/db-query-bounded.ts +256 -11
  280. package/src/http/db-query-shared.ts +9 -0
  281. package/src/http/favorites.ts +14 -2
  282. package/src/http/fs.ts +346 -1
  283. package/src/http/index.ts +37 -2
  284. package/src/http/kv.ts +13 -0
  285. package/src/http/mcp-oauth.ts +1 -1
  286. package/src/http/mcp-servers.ts +15 -2
  287. package/src/http/onboarding.ts +2 -9
  288. package/src/http/poll.ts +59 -1
  289. package/src/http/requested-by.ts +97 -1
  290. package/src/http/savings.ts +676 -190
  291. package/src/http/script-connections.ts +1 -0
  292. package/src/http/scripts.ts +26 -15
  293. package/src/http/sessions.ts +17 -0
  294. package/src/http/slack-events.ts +101 -0
  295. package/src/http/status.ts +25 -7
  296. package/src/http/task-requester.ts +46 -0
  297. package/src/http/tasks.ts +107 -42
  298. package/src/http/users.ts +14 -0
  299. package/src/http/webhooks.ts +15 -0
  300. package/src/integrations/cards/index.ts +151 -0
  301. package/src/integrations/chat-sdk/outbound.ts +39 -13
  302. package/src/integrations/chat-sdk/runtime.ts +7 -1
  303. package/src/integrations/chat-sdk/status.ts +17 -0
  304. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  305. package/src/kv-reserved-namespaces.ts +17 -2
  306. package/src/oauth/presets.ts +29 -2
  307. package/src/prompts/base-prompt.ts +17 -4
  308. package/src/prompts/session-templates.ts +163 -9
  309. package/src/providers/acp-targets.ts +2 -2
  310. package/src/providers/amp-adapter.ts +1 -1
  311. package/src/providers/claude-adapter.ts +0 -20
  312. package/src/providers/claude-flag-settings.ts +12 -10
  313. package/src/providers/claude-managed-adapter.ts +5 -1
  314. package/src/providers/codex-adapter.ts +10 -35
  315. package/src/providers/codex-app-server.ts +2 -11
  316. package/src/providers/opencode-adapter.ts +41 -31
  317. package/src/providers/runtime-dependencies.ts +158 -0
  318. package/src/rbac/legacy-policy.ts +2 -0
  319. package/src/rbac/permissions.ts +10 -1
  320. package/src/scheduler/scheduler.ts +20 -14
  321. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  322. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  323. package/src/scripts-runtime/ctx.ts +1 -1
  324. package/src/scripts-runtime/egress-secrets.ts +2 -2
  325. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  326. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  327. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  328. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  329. package/src/scripts-runtime/stdlib/index.ts +3 -1
  330. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  331. package/src/scripts-runtime/swarm-sdk.ts +187 -17
  332. package/src/scripts-runtime/types/stdlib.d.ts +97 -8
  333. package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
  334. package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
  335. package/src/server.ts +4 -4
  336. package/src/slack/actions.ts +1 -0
  337. package/src/slack/app.ts +87 -46
  338. package/src/slack/assistant.ts +35 -7
  339. package/src/slack/enrich.ts +144 -50
  340. package/src/slack/handlers.ts +43 -99
  341. package/src/slack/http-receiver.ts +284 -0
  342. package/src/slack/inbound-dispatch.ts +43 -7
  343. package/src/slack/inbound-files.ts +33 -14
  344. package/src/slack/message-text.ts +47 -4
  345. package/src/slack/render-v2.ts +2 -1
  346. package/src/slack/socket-ack.ts +17 -10
  347. package/src/slack/steering.ts +5 -0
  348. package/src/slack/templates.ts +9 -0
  349. package/src/slack/thread-buffer-store.ts +58 -0
  350. package/src/slack/thread-buffer.ts +367 -109
  351. package/src/slack/thread-participants.ts +187 -0
  352. package/src/tasks/context-key.ts +24 -0
  353. package/src/tasks/sibling-awareness.ts +13 -1
  354. package/src/tests/agent-fs-live-url.test.ts +15 -0
  355. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  356. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  357. package/src/tests/agentfs-proxy.test.ts +8 -8
  358. package/src/tests/approval-card-resolution.test.ts +396 -0
  359. package/src/tests/approval-requests-notifications.test.ts +1 -1
  360. package/src/tests/approval-respond-auth.test.ts +28 -0
  361. package/src/tests/apps-action-parent-task.test.ts +140 -0
  362. package/src/tests/apps-catalog-additions.test.ts +315 -0
  363. package/src/tests/apps-catalog-files.test.ts +114 -0
  364. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  365. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  366. package/src/tests/apps-catalog-table.test.ts +47 -0
  367. package/src/tests/apps-chart-shell.test.ts +1 -1
  368. package/src/tests/apps-element-assembly.test.ts +52 -3
  369. package/src/tests/apps-session-thread.test.ts +182 -0
  370. package/src/tests/asset-key-invariants.test.ts +14 -0
  371. package/src/tests/base-prompt.test.ts +108 -23
  372. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  373. package/src/tests/caller-session-group.test.ts +199 -0
  374. package/src/tests/cards.test.ts +169 -0
  375. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  376. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  377. package/src/tests/chat-sdk-tools.test.ts +147 -0
  378. package/src/tests/checklist-nudge.test.ts +208 -0
  379. package/src/tests/checklist.test.ts +686 -0
  380. package/src/tests/claude-adapter-binary.test.ts +7 -1
  381. package/src/tests/claude-adapter.test.ts +10 -64
  382. package/src/tests/claude-flag-settings.test.ts +15 -11
  383. package/src/tests/claude-hook-credentials.test.ts +0 -1
  384. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  385. package/src/tests/codex-adapter.test.ts +17 -78
  386. package/src/tests/codex-app-server.test.ts +16 -0
  387. package/src/tests/comb-config-guard.test.ts +21 -0
  388. package/src/tests/comb-default.test.ts +59 -97
  389. package/src/tests/comb-links.test.ts +86 -16
  390. package/src/tests/comb-status.test.ts +24 -27
  391. package/src/tests/create-page-tool.test.ts +101 -1
  392. package/src/tests/create-schedule-key.test.ts +105 -0
  393. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  394. package/src/tests/credential-broker.test.ts +2 -2
  395. package/src/tests/db-query.test.ts +87 -1
  396. package/src/tests/db-task-read-contract.test.ts +3 -0
  397. package/src/tests/db-task-write-contract.test.ts +3 -1
  398. package/src/tests/docs-index-footprint.test.js +3 -3
  399. package/src/tests/dreaming-learnings.test.ts +104 -0
  400. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  401. package/src/tests/extensions-assets.test.ts +7 -3
  402. package/src/tests/extensions-catalog.test.ts +1 -0
  403. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  404. package/src/tests/extensions-pre-task.test.ts +7 -5
  405. package/src/tests/extensions-steering.test.ts +14 -2
  406. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  407. package/src/tests/fetch-resolved-env.test.ts +115 -1
  408. package/src/tests/fixtures/import-package.ts +32 -0
  409. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  410. package/src/tests/fs-routes.test.ts +505 -2
  411. package/src/tests/github-ghes-mock.test.ts +196 -0
  412. package/src/tests/github-host.test.ts +285 -0
  413. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  414. package/src/tests/heartbeat.test.ts +56 -0
  415. package/src/tests/import-config.test.ts +209 -0
  416. package/src/tests/import.test.ts +464 -0
  417. package/src/tests/invites-http.test.ts +144 -1
  418. package/src/tests/kv-http.test.ts +11 -0
  419. package/src/tests/literal-matcher.test.ts +58 -0
  420. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  421. package/src/tests/oauth-presets.test.ts +12 -0
  422. package/src/tests/opencode-adapter.test.ts +53 -6
  423. package/src/tests/pool-affinity.test.ts +50 -0
  424. package/src/tests/prompt-template-session.test.ts +69 -6
  425. package/src/tests/provider-registration.test.ts +2 -55
  426. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  427. package/src/tests/rbac-admission.test.ts +19 -0
  428. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  429. package/src/tests/rbac-engine.test.ts +2 -0
  430. package/src/tests/rbac-roles.test.ts +2 -0
  431. package/src/tests/runner-missing-dependency.test.ts +61 -0
  432. package/src/tests/runner-requester-profile.test.ts +139 -1
  433. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  434. package/src/tests/runtime-pool-routing.test.ts +52 -0
  435. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  436. package/src/tests/savings-compound.test.ts +774 -0
  437. package/src/tests/savings-compute.test.ts +7 -198
  438. package/src/tests/savings-fleet-latency.test.ts +143 -0
  439. package/src/tests/savings-fleet-read.test.ts +195 -0
  440. package/src/tests/savings-fleet-scale.test.ts +222 -0
  441. package/src/tests/savings-fleet-slices.test.ts +122 -0
  442. package/src/tests/savings-model.test.ts +212 -0
  443. package/src/tests/savings-read.test.ts +408 -0
  444. package/src/tests/savings-rollup.test.ts +766 -0
  445. package/src/tests/savings-scripts.test.ts +617 -0
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/script-executor-conformance.test.ts +481 -0
  448. package/src/tests/scripts-http.test.ts +55 -0
  449. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  450. package/src/tests/secret-rules.test.ts +124 -1
  451. package/src/tests/secret-scrub-gate.test.ts +257 -0
  452. package/src/tests/secret-scrubber.test.ts +1 -1
  453. package/src/tests/seed-registry.test.ts +142 -9
  454. package/src/tests/session-source-keys.test.ts +42 -1
  455. package/src/tests/sessions-move.test.ts +70 -0
  456. package/src/tests/sessions-tree.test.ts +98 -0
  457. package/src/tests/sessions.test.ts +69 -0
  458. package/src/tests/slack-config.test.ts +4 -18
  459. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  460. package/src/tests/slack-http-receiver.test.ts +472 -0
  461. package/src/tests/slack-identity-resolution.test.ts +23 -0
  462. package/src/tests/slack-inbound-files.test.ts +2 -1
  463. package/src/tests/slack-inbound-logging.test.ts +64 -0
  464. package/src/tests/slack-leave-thread.test.ts +1 -1
  465. package/src/tests/slack-message-text.test.ts +104 -0
  466. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  467. package/src/tests/slack-render-v2.test.ts +48 -0
  468. package/src/tests/slack-skip-reaction.test.ts +2 -2
  469. package/src/tests/slack-steering.test.ts +22 -10
  470. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  471. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  472. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  473. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  474. package/src/tests/slack-thread-buffer.test.ts +34 -34
  475. package/src/tests/slack-thread-participants.test.ts +447 -0
  476. package/src/tests/slack-tool-blocks.test.ts +167 -0
  477. package/src/tests/status.test.ts +32 -6
  478. package/src/tests/steering-core.test.ts +13 -0
  479. package/src/tests/steering-enabled.test.ts +7 -1
  480. package/src/tests/steering-promotion.test.ts +24 -0
  481. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  482. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  483. package/src/tests/task-artifacts.test.ts +50 -0
  484. package/src/tests/task-session-prompts.test.ts +95 -1
  485. package/src/tests/tool-annotations.test.ts +30 -0
  486. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  487. package/src/tools/chat-post.ts +19 -4
  488. package/src/tools/chat-reply.ts +20 -4
  489. package/src/tools/create-page.ts +21 -4
  490. package/src/tools/get-swarm.ts +18 -2
  491. package/src/tools/join-swarm.ts +2 -1
  492. package/src/tools/kv/kv-write-auth.ts +17 -1
  493. package/src/tools/schedules/create-schedule.ts +22 -4
  494. package/src/tools/slack-post.ts +40 -7
  495. package/src/tools/slack-reply.ts +50 -14
  496. package/src/types.ts +74 -2
  497. package/src/utils/constants.ts +60 -138
  498. package/src/utils/github-host.ts +217 -0
  499. package/src/utils/github-pull-request.ts +8 -5
  500. package/src/utils/literal-matcher.ts +118 -0
  501. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  502. package/src/utils/mcp-server-fetcher.ts +13 -5
  503. package/src/utils/request-auth-context.ts +24 -0
  504. package/src/utils/secret-rules.generated.ts +1 -1
  505. package/src/utils/secret-scrubber.ts +485 -54
  506. package/src/utils/task-attachment-links.ts +9 -12
  507. package/src/vcs/index.ts +3 -0
  508. package/src/workflows/approval-notifications.ts +188 -12
  509. package/src/workflows/executors/swarm-script.ts +23 -19
  510. package/src/workflows/executors/system-one-extraction.ts +14 -7
  511. package/src/workflows/executors/system-one-providers.ts +22 -1
  512. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  513. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  514. package/templates/extensions/README.md +1 -0
  515. package/templates/extensions/sql-admin-only/README.md +19 -0
  516. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  517. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  518. package/templates/import/manifest.schema.json +136 -0
  519. package/templates/import/sources.schema.json +44 -0
  520. package/templates/skills/agent-browser/SKILL.md +1 -1
  521. package/templates/skills/agent-browser/content.md +1 -1
  522. package/templates/skills/apps/SKILL.md +122 -12
  523. package/templates/skills/apps/content.md +122 -12
  524. package/templates/skills/asset-namespaces/content.md +2 -1
  525. package/templates/skills/chat-sdk/content.md +17 -0
  526. package/templates/skills/db-query-guidance/content.md +2 -1
  527. package/templates/skills/scheduling/content.md +27 -0
  528. package/templates/skills/slack-interaction/content.md +12 -2
  529. package/templates/skills/swarm-docs/content.md +1 -0
  530. package/templates/skills/swarm-extensions/config.json +1 -1
  531. package/templates/skills/swarm-extensions/content.md +33 -23
  532. package/templates/skills/swarm-scripts/SKILL.md +18 -4
  533. package/templates/skills/swarm-scripts/content.md +18 -4
  534. package/templates/skills/work-on-task/SKILL.md +1 -1
  535. package/templates/skills/work-on-task/content.md +1 -1
  536. package/templates/skills/workflow-iterate/content.md +4 -7
  537. package/templates/workflows/dreaming/content.md +3 -3
  538. package/dist/acp-adapter-fqzkxyra.js +0 -15
  539. package/dist/claude-adapter-stw7jdcf.js +0 -25
  540. package/dist/cli-4bd1rck6.js +0 -4
  541. package/dist/cli-dns0y538.js +0 -194
  542. package/dist/cli-g5mtmf6t.js +0 -432
  543. package/dist/cli-xf3qw745.js +0 -104
  544. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  545. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  546. package/dist/handlers-nv8edn19.js +0 -32
  547. package/dist/index-ksmyd6kc.js +0 -37
  548. package/dist/index-rjnrje98.js +0 -32
  549. package/dist/index-tv3413wy.js +0 -33
  550. package/dist/lead-3hmddvrm.js +0 -70
  551. package/dist/worker-qgg0m2gw.js +0 -70
  552. package/src/providers/ctx-mode-env.ts +0 -10
  553. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  554. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  555. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  556. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  557. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  558. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -1,16 +1,112 @@
1
+ import { type RetryOptions, retry } from "./retry";
2
+
3
+ export type FetchRetryOptions = RetryOptions & {
4
+ /**
5
+ * Sends an `Idempotency-Key` header, the same value on every attempt: `true`
6
+ * generates a UUID per call, a string is used as is. A POST or PATCH with
7
+ * the header also retries 502/503/504 and network errors. The key only
8
+ * prevents a duplicate when the server dedupes by it.
9
+ */
10
+ idempotencyKey?: boolean | string;
11
+ };
12
+
1
13
  export type RuntimeFetchOptions = RequestInit & {
14
+ /** `false`: one attempt. `true` or omitted: method-aware defaults. An object tunes them. */
15
+ retry?: boolean | FetchRetryOptions;
16
+ /** @deprecated Use `retry: { retries }`. Total attempts, so `retries: 1` is one attempt. */
2
17
  retries?: number;
18
+ /** Per-attempt timeout. Default 30000. */
3
19
  timeoutMs?: number;
4
20
  };
5
21
 
22
+ /** Methods a server must treat as idempotent, so a repeat after a 5xx is safe. */
23
+ export const IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([
24
+ "GET",
25
+ "HEAD",
26
+ "OPTIONS",
27
+ "PUT",
28
+ "DELETE",
29
+ ]);
30
+ const TRANSIENT_5XX = new Set([502, 503, 504]);
31
+
32
+ /**
33
+ * Default fetch retry rule. 429 always retries (the server refused before any
34
+ * work). 502/503/504 and network errors retry only when a repeat is safe: an
35
+ * idempotent method, or a request carrying an `Idempotency-Key`.
36
+ */
37
+ export function shouldRetryFetch(value: unknown, repeatSafe: boolean): boolean {
38
+ if (value instanceof Response) {
39
+ return value.status === 429 || (repeatSafe && TRANSIENT_5XX.has(value.status));
40
+ }
41
+ return repeatSafe;
42
+ }
43
+
44
+ /** A body that fetch can send again. A stream or async iterable is read once. */
45
+ function isReplayableBody(body: unknown): boolean {
46
+ return (
47
+ body === undefined ||
48
+ body === null ||
49
+ typeof body === "string" ||
50
+ body instanceof URLSearchParams ||
51
+ body instanceof ArrayBuffer ||
52
+ ArrayBuffer.isView(body) ||
53
+ body instanceof Blob ||
54
+ body instanceof FormData
55
+ );
56
+ }
57
+
58
+ function resolveRetry(
59
+ option: RuntimeFetchOptions["retry"],
60
+ legacyAttempts: number | undefined,
61
+ ): FetchRetryOptions {
62
+ if (option === false) return { retries: 0 };
63
+ if (option && typeof option === "object") return option;
64
+ if (option === undefined && legacyAttempts !== undefined) {
65
+ return { retries: Math.max(0, legacyAttempts - 1) };
66
+ }
67
+ return {};
68
+ }
69
+
6
70
  export async function runtimeFetch(
7
71
  input: string | URL | Request,
8
72
  options: RuntimeFetchOptions = {},
9
73
  ): Promise<Response> {
10
- const { retries = 3, timeoutMs = 30_000, signal, ...init } = options;
11
- let lastError: unknown;
74
+ const {
75
+ retry: retryOption,
76
+ retries: legacyAttempts,
77
+ timeoutMs = 30_000,
78
+ signal,
79
+ ...init
80
+ } = options;
81
+ const {
82
+ idempotencyKey,
83
+ retryOn: userRetryOn,
84
+ ...retryOptions
85
+ } = resolveRetry(retryOption, legacyAttempts);
86
+ const inputRequest = input instanceof Request ? input : undefined;
87
+
88
+ if (idempotencyKey) {
89
+ const headers = new Headers(init.headers ?? inputRequest?.headers);
90
+ if (!headers.has("idempotency-key")) {
91
+ headers.set(
92
+ "idempotency-key",
93
+ idempotencyKey === true ? crypto.randomUUID() : String(idempotencyKey),
94
+ );
95
+ }
96
+ init.headers = headers;
97
+ }
98
+ const method = (init.method ?? inputRequest?.method ?? "GET").toUpperCase();
99
+ const hasKey = new Headers(init.headers ?? inputRequest?.headers).has("idempotency-key");
100
+ const repeatSafe = IDEMPOTENT_METHODS.has(method) || hasKey;
101
+ const replayable =
102
+ init.body !== undefined
103
+ ? isReplayableBody(init.body)
104
+ : !inputRequest || inputRequest.body === null || !inputRequest.bodyUsed;
105
+ // A Request with an unread body is cloned per attempt; the clone tees it.
106
+ const target = (): string | URL | Request =>
107
+ inputRequest && inputRequest.body !== null ? (inputRequest.clone() as Request) : input;
12
108
 
13
- for (let attempt = 0; attempt < retries; attempt++) {
109
+ const attempt = async (): Promise<Response> => {
14
110
  if (signal?.aborted) {
15
111
  throw signal.reason ?? new DOMException("This operation was aborted", "AbortError");
16
112
  }
@@ -19,26 +115,28 @@ export async function runtimeFetch(
19
115
  const onAbort = () => controller.abort();
20
116
  signal?.addEventListener("abort", onAbort, { once: true });
21
117
  if (signal?.aborted) controller.abort();
22
-
23
118
  try {
24
- const res = await fetch(input, { ...init, signal: controller.signal });
25
- if (!res.ok && attempt < retries - 1 && res.status >= 500) {
26
- lastError = new Error(`fetch failed with ${res.status}`);
27
- continue;
28
- }
29
- return res;
119
+ return await fetch(target(), { ...init, signal: controller.signal });
30
120
  } catch (error) {
31
- // Caller abort is terminal — only the controller's own timeout abort retries.
121
+ // Caller abort is terminal; the retry rule below sees `signal.aborted`.
32
122
  if (signal?.aborted) throw signal.reason ?? error;
33
- lastError = error;
34
- if (attempt === retries - 1) break;
123
+ throw error;
35
124
  } finally {
36
125
  clearTimeout(timeout);
37
126
  signal?.removeEventListener("abort", onAbort);
38
127
  }
39
- }
128
+ };
40
129
 
41
- throw lastError instanceof Error ? lastError : new Error(String(lastError));
130
+ if (!replayable) return attempt();
131
+ return retry(attempt, {
132
+ ...retryOptions,
133
+ signal: signal ?? retryOptions.signal,
134
+ retryOn: async (value, attemptNumber) => {
135
+ if (signal?.aborted) return false;
136
+ if (userRetryOn) return userRetryOn(value, attemptNumber);
137
+ return shouldRetryFetch(value, repeatSafe);
138
+ },
139
+ });
42
140
  }
43
141
 
44
142
  export async function runtimeFetchJson(
@@ -2,6 +2,7 @@ import { Redacted } from "../redacted";
2
2
  import { runtimeFetch, runtimeFetchJson } from "./fetch";
3
3
  import { glob } from "./glob";
4
4
  import { grep } from "./grep";
5
+ import { retry } from "./retry";
5
6
  import { table } from "./table";
6
7
 
7
8
  export const stdlib = {
@@ -10,7 +11,8 @@ export const stdlib = {
10
11
  grep,
11
12
  glob,
12
13
  table,
14
+ retry,
13
15
  Redacted,
14
16
  };
15
17
 
16
- export { runtimeFetch as fetch, runtimeFetchJson as fetchJson, glob, grep, table, Redacted };
18
+ export { runtimeFetch as fetch, runtimeFetchJson as fetchJson, glob, grep, table, retry, Redacted };
@@ -0,0 +1,174 @@
1
+ /**
2
+ * `retry` for scripts: calls a sync or async function until it succeeds, a
3
+ * retry is not warranted, attempts run out, or the time budget is spent.
4
+ *
5
+ * The quickjs executor has its own copy in `executors/quickjs-prelude.ts`
6
+ * (it sleeps through `__host_sleep`). Keep the two in step; the executor
7
+ * conformance tests run the same scripts against both.
8
+ */
9
+
10
+ export type RetryOptions = {
11
+ /** Retries after the first call. Default 3, so at most 4 calls. */
12
+ retries?: number;
13
+ /** First backoff delay in ms. Doubles on each retry, with jitter. Default 200. */
14
+ minDelayMs?: number;
15
+ /** Cap on a single wait, including a `Retry-After` wait. Default 5000. */
16
+ maxDelayMs?: number;
17
+ /** Total time across all calls and waits, in ms. Default 30000. */
18
+ budgetMs?: number;
19
+ /**
20
+ * Decides whether to retry. Gets the thrown error or the returned value and
21
+ * the 1-based attempt number. Replaces the default rule.
22
+ */
23
+ retryOn?: (errorOrResult: unknown, attempt: number) => boolean | Promise<boolean>;
24
+ /** Stops the retries: once it aborts, the wait ends and `retry` rejects with its reason. */
25
+ signal?: AbortSignal;
26
+ };
27
+
28
+ /** Statuses the default rule (and the swarm bridge) treat as transient. */
29
+ export const RETRYABLE_STATUSES: ReadonlySet<number> = new Set([429, 502, 503, 504]);
30
+
31
+ const DEFAULTS = { retries: 3, minDelayMs: 200, maxDelayMs: 5_000, budgetMs: 30_000 };
32
+
33
+ /** Parses a `Retry-After` header (seconds or HTTP date) into ms; undefined if absent or invalid. */
34
+ export function retryAfterMs(
35
+ value: string | null | undefined,
36
+ now = Date.now(),
37
+ ): number | undefined {
38
+ if (value === null || value === undefined) return undefined;
39
+ const trimmed = String(value).trim();
40
+ if (trimmed === "") return undefined;
41
+ if (/^\d+(\.\d+)?$/.test(trimmed)) return Math.round(Number(trimmed) * 1000);
42
+ const date = Date.parse(trimmed);
43
+ return Number.isNaN(date) ? undefined : Math.max(0, date - now);
44
+ }
45
+
46
+ /** Exponential backoff with equal jitter: a value in [d/2, d], d = min(max, min * 2^(attempt-1)). */
47
+ export function backoffMs(attempt: number, minDelayMs: number, maxDelayMs: number): number {
48
+ const ceiling = Math.min(maxDelayMs, minDelayMs * 2 ** (attempt - 1));
49
+ return Math.round(ceiling / 2 + (Math.random() * ceiling) / 2);
50
+ }
51
+
52
+ type StatusInfo = { status: number; retryAfter?: string | null };
53
+
54
+ /**
55
+ * Reads the status of a failed fetch `Response`, a `ctx.api` raw result
56
+ * (`ok: false`), or a `ctx.swarm` envelope (`success: false`).
57
+ */
58
+ function failedStatus(value: unknown): StatusInfo | undefined {
59
+ if (!value || typeof value !== "object") return undefined;
60
+ const candidate = value as {
61
+ status?: unknown;
62
+ ok?: unknown;
63
+ success?: unknown;
64
+ headers?: unknown;
65
+ };
66
+ if (typeof candidate.status !== "number") return undefined;
67
+ if (candidate.ok !== false && candidate.success !== false) return undefined;
68
+ const headers = candidate.headers as
69
+ | { get?: (name: string) => string | null }
70
+ | Record<string, unknown>
71
+ | undefined;
72
+ let retryAfter: string | null | undefined;
73
+ if (headers && typeof headers.get === "function") {
74
+ retryAfter = (headers as { get: (name: string) => string | null }).get("retry-after");
75
+ } else if (headers && typeof headers === "object") {
76
+ const raw = (headers as Record<string, unknown>)["retry-after"];
77
+ retryAfter = typeof raw === "string" ? raw : undefined;
78
+ }
79
+ return { status: candidate.status, retryAfter };
80
+ }
81
+
82
+ /** The default rule for a returned value: a failed response with a transient status. */
83
+ export function isRetryableResult(value: unknown): boolean {
84
+ const info = failedStatus(value);
85
+ return info !== undefined && RETRYABLE_STATUSES.has(info.status);
86
+ }
87
+
88
+ function checkNumber(name: string, value: unknown, fallback: number, integer = false): number {
89
+ if (value === undefined) return fallback;
90
+ if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
91
+ throw new TypeError(`retry: \`${name}\` must be a non-negative number`);
92
+ }
93
+ if (integer && !Number.isInteger(value)) {
94
+ throw new TypeError(`retry: \`${name}\` must be a non-negative integer`);
95
+ }
96
+ return value;
97
+ }
98
+
99
+ function abortReason(signal: AbortSignal): unknown {
100
+ return signal.reason ?? new DOMException("This operation was aborted", "AbortError");
101
+ }
102
+
103
+ /** Waits `ms`, or rejects with the signal's reason as soon as it aborts. */
104
+ function sleep(ms: number, signal?: AbortSignal): Promise<void> {
105
+ return new Promise((resolve, reject) => {
106
+ if (signal?.aborted) return reject(abortReason(signal));
107
+ const onAbort = () => {
108
+ clearTimeout(timer);
109
+ reject(abortReason(signal as AbortSignal));
110
+ };
111
+ const timer = setTimeout(() => {
112
+ signal?.removeEventListener("abort", onAbort);
113
+ resolve();
114
+ }, ms);
115
+ signal?.addEventListener("abort", onAbort, { once: true });
116
+ });
117
+ }
118
+
119
+ async function retryCall<T>(
120
+ fn: (attempt: number) => T | Promise<T>,
121
+ options: RetryOptions = {},
122
+ ): Promise<Awaited<T>> {
123
+ if (typeof fn !== "function") throw new TypeError("retry: first argument must be a function");
124
+ const retries = checkNumber("retries", options.retries, DEFAULTS.retries, true);
125
+ const minDelayMs = checkNumber("minDelayMs", options.minDelayMs, DEFAULTS.minDelayMs);
126
+ const maxDelayMs = checkNumber("maxDelayMs", options.maxDelayMs, DEFAULTS.maxDelayMs);
127
+ const budgetMs = checkNumber("budgetMs", options.budgetMs, DEFAULTS.budgetMs);
128
+ const retryOn = options.retryOn;
129
+ if (retryOn !== undefined && typeof retryOn !== "function") {
130
+ throw new TypeError("retry: `retryOn` must be a function");
131
+ }
132
+ const signal = options.signal;
133
+ const started = Date.now();
134
+
135
+ for (let attempt = 1; ; attempt++) {
136
+ if (signal?.aborted) throw abortReason(signal);
137
+ let threw = false;
138
+ let value: unknown;
139
+ try {
140
+ // `await` turns a sync throw and an async rejection into the same catch.
141
+ value = await fn(attempt);
142
+ } catch (error) {
143
+ threw = true;
144
+ value = error;
145
+ }
146
+ const settle = (): Awaited<T> => {
147
+ if (threw) throw value;
148
+ return value as Awaited<T>;
149
+ };
150
+ if (attempt > retries) return settle();
151
+ const again = retryOn ? await retryOn(value, attempt) : threw || isRetryableResult(value);
152
+ if (!again) return settle();
153
+
154
+ const info = threw ? undefined : failedStatus(value);
155
+ const waitFor = info?.status === 429 ? retryAfterMs(info.retryAfter) : undefined;
156
+ const delay =
157
+ waitFor !== undefined
158
+ ? Math.min(maxDelayMs, waitFor)
159
+ : backoffMs(attempt, minDelayMs, maxDelayMs);
160
+ if (Date.now() - started + delay > budgetMs) return settle();
161
+ await sleep(delay, signal);
162
+ }
163
+ }
164
+
165
+ function wrap<A extends unknown[], T>(
166
+ fn: (...args: A) => T | Promise<T>,
167
+ options?: RetryOptions,
168
+ ): (...args: A) => Promise<Awaited<T>> {
169
+ if (typeof fn !== "function")
170
+ throw new TypeError("retry.wrap: first argument must be a function");
171
+ return (...args: A) => retryCall(() => fn(...args), options);
172
+ }
173
+
174
+ export const retry = Object.assign(retryCall, { wrap });
@@ -2,6 +2,7 @@ import { scrubObject } from "../utils/secret-scrubber";
2
2
  import { Redacted } from "./redacted";
3
3
  import { readScriptSdkJsonResponse } from "./response-limit";
4
4
  import { isSdkToolAllowed, mcpToolNameForSdkMethod } from "./sdk-allowlist";
5
+ import { backoffMs, retryAfterMs } from "./stdlib/retry";
5
6
  import type { SwarmConfig } from "./swarm-config";
6
7
 
7
8
  type BridgeRequest = {
@@ -474,11 +475,159 @@ function bridgeRequestFor(name: string, args: unknown): BridgeRequest | null {
474
475
  }
475
476
  }
476
477
 
478
+ // ── transient-failure retries ──
479
+ // Every ctx.swarm call retries a 429 (the rate limiter refused it before any
480
+ // work ran). A 502/503/504 or a network error retries only when a repeat is
481
+ // safe: a read, or a write whose route dedupes by its `Idempotency-Key`
482
+ // header (workflow_trigger with `idempotencyKey`). Any other write may have
483
+ // landed, and a second call would repeat it. script_run's `idempotencyKey`
484
+ // does not count: it overwrites a KV entry and does not dedupe the run.
485
+ const BRIDGE_MAX_RETRIES = 3;
486
+ const BRIDGE_MIN_DELAY_MS = 250;
487
+ const BRIDGE_MAX_DELAY_MS = 2_000;
488
+ /** Total retry time per call, so retries cannot eat the script's wall clock. */
489
+ const BRIDGE_RETRY_BUDGET_MS = 5_000;
490
+ const READ_RETRY_STATUSES = new Set([502, 503, 504]);
491
+
492
+ // MCP tool names that only read. Prefix/suffix rules cover get-* / list-* /
493
+ // *-get / *-list / *-search; the set lists the rest. A tool missing here is
494
+ // treated as a write, which is the safe default. tool-annotations.test.ts
495
+ // fails when a tool annotated `readOnlyHint: true` is missing here.
496
+ // read-messages may mark messages read; repeating that is harmless.
497
+ const READ_TOOL_PATTERN = /^(get|list)-|-(get|list|search)$/;
498
+ const READ_TOOLS = new Set([
499
+ "db-query",
500
+ "kv-get",
501
+ "kv-list",
502
+ "my-agent-info",
503
+ "script-query-types",
504
+ "skill-get-file",
505
+ "slack-read",
506
+ "slack-list-channels",
507
+ "chat-read-thread",
508
+ "app-rows-list",
509
+ "app-row-get",
510
+ "app-history",
511
+ "app-diff",
512
+ "context-history",
513
+ "context-diff",
514
+ "extension-catalog",
515
+ "tracker-status",
516
+ "tracker-sync-status",
517
+ "app-query",
518
+ "resolve-user",
519
+ "room-decode",
520
+ "read-messages",
521
+ "check-model-profile",
522
+ "preview-prompt-template",
523
+ ]);
524
+ // GET routes that change state: polling claims work.
525
+ const NON_READ_GET_METHODS = new Set(["task_poll"]);
526
+
527
+ export function isReadOnlyBridgeCall(name: string, method: string): boolean {
528
+ if (method === "GET") return !NON_READ_GET_METHODS.has(name);
529
+ const tool = mcpToolNameForSdkMethod(name);
530
+ return READ_TOOL_PATTERN.test(tool) || READ_TOOLS.has(tool);
531
+ }
532
+
533
+ function hasIdempotencyKey(headers: Record<string, string> | undefined): boolean {
534
+ return Object.keys(headers ?? {}).some((key) => key.toLowerCase() === "idempotency-key");
535
+ }
536
+
537
+ /** A keyed write may repeat, but it stays a write: only a read gets the retry deadline. */
538
+ function bridgeSafety(readOnly: boolean, keyed: boolean) {
539
+ return { repeatSafe: readOnly || keyed, readOnly };
540
+ }
541
+
542
+ /** Waits `ms`, or less when `signal` aborts first. */
543
+ function sleep(ms: number, signal: AbortSignal | undefined): Promise<void> {
544
+ return new Promise((resolve) => {
545
+ const done = () => {
546
+ clearTimeout(timer);
547
+ signal?.removeEventListener("abort", done);
548
+ resolve();
549
+ };
550
+ const timer = setTimeout(done, ms);
551
+ signal?.addEventListener("abort", done, { once: true });
552
+ });
553
+ }
554
+
555
+ /**
556
+ * What a retry that ran out of budget hands back: the failure the caller would
557
+ * have seen with no retry, the earlier status with a note in place of its
558
+ * already-cancelled body.
559
+ */
560
+ function budgetSpentResponse(previous: Response): Response {
561
+ return Response.json(
562
+ {
563
+ error: `HTTP ${previous.status}; the retry did not answer within the ${BRIDGE_RETRY_BUDGET_MS}ms retry budget`,
564
+ },
565
+ { status: previous.status, statusText: previous.statusText },
566
+ );
567
+ }
568
+
569
+ /**
570
+ * `signal` is the run's own signal (quickjs aborts it when the run ends): an
571
+ * aborted run gets the current outcome at once, never another wait or attempt.
572
+ *
573
+ * `repeatSafe`: a 502/503/504 or a network error may be retried (a read, or a
574
+ * keyed write). `readOnly`: the call only reads.
575
+ *
576
+ * The first attempt runs unbounded, as it did before retries existed. A retry
577
+ * of a read is cut off when the retry budget is spent, and the caller gets
578
+ * the earlier failure. A write's retry, keyed or not, is never cut off: it may
579
+ * be the write's first real run (after a 429) or start the work a keyed route
580
+ * dedupes, and cutting it off reports a failure for work that went ahead.
581
+ */
582
+ async function bridgeFetch(
583
+ url: string,
584
+ init: RequestInit,
585
+ { repeatSafe, readOnly }: { repeatSafe: boolean; readOnly: boolean },
586
+ signal: AbortSignal | undefined,
587
+ ): Promise<Response> {
588
+ const started = Date.now();
589
+ const remaining = () => BRIDGE_RETRY_BUDGET_MS - (Date.now() - started);
590
+ const fits = (delay: number) => delay <= remaining();
591
+ let previous: { response: Response } | { error: unknown } | undefined;
592
+ for (let attempt = 1; ; attempt++) {
593
+ const budget = previous && readOnly ? AbortSignal.timeout(Math.max(1, remaining())) : undefined;
594
+ let res: Response;
595
+ try {
596
+ res = await fetch(url, budget ? { ...init, signal: budget } : init);
597
+ } catch (error) {
598
+ if (budget?.aborted && !signal?.aborted && previous) {
599
+ if ("error" in previous) throw previous.error;
600
+ return budgetSpentResponse(previous.response);
601
+ }
602
+ const delay = backoffMs(attempt, BRIDGE_MIN_DELAY_MS, BRIDGE_MAX_DELAY_MS);
603
+ // An abort means the run is ending: settle now, never wait and retry.
604
+ const aborted = signal?.aborted || (error instanceof Error && error.name === "AbortError");
605
+ if (aborted || !repeatSafe || attempt > BRIDGE_MAX_RETRIES || (readOnly && !fits(delay)))
606
+ throw error;
607
+ previous = { error };
608
+ await sleep(delay, signal);
609
+ if (signal?.aborted) throw error;
610
+ continue;
611
+ }
612
+ const retryable = res.status === 429 || (repeatSafe && READ_RETRY_STATUSES.has(res.status));
613
+ if (!retryable || attempt > BRIDGE_MAX_RETRIES || signal?.aborted) return res;
614
+ const delay =
615
+ (res.status === 429 ? retryAfterMs(res.headers.get("retry-after")) : undefined) ??
616
+ backoffMs(attempt, BRIDGE_MIN_DELAY_MS, BRIDGE_MAX_DELAY_MS);
617
+ // A Retry-After past the budget: hand the 429 back rather than wait.
618
+ if ((readOnly || res.status === 429) && !fits(delay)) return res;
619
+ await res.body?.cancel().catch(() => {});
620
+ previous = { response: res };
621
+ await sleep(delay, signal);
622
+ if (signal?.aborted) return res;
623
+ }
624
+ }
625
+
477
626
  async function callBridgeApi(
478
627
  name: string,
479
628
  args: unknown,
480
629
  config: SwarmConfig,
481
- options: { throwOnError?: boolean; preserveData?: boolean } = {},
630
+ options: { throwOnError?: boolean; preserveData?: boolean; signal?: AbortSignal } = {},
482
631
  ): Promise<unknown> {
483
632
  const baseUrl = Redacted.value(config.mcpBaseUrl).replace(/\/$/, "");
484
633
  const request = bridgeRequestFor(name, args);
@@ -486,11 +635,16 @@ async function callBridgeApi(
486
635
  // Tools without a specific REST route go through the generic MCP bridge
487
636
  if (!request) {
488
637
  const mcpToolName = mcpToolNameForSdkMethod(name);
489
- const res = await fetch(`${baseUrl}/api/mcp-bridge`, {
490
- method: "POST",
491
- headers: headers(config),
492
- body: JSON.stringify({ tool: mcpToolName, args: args ?? {} }),
493
- });
638
+ const res = await bridgeFetch(
639
+ `${baseUrl}/api/mcp-bridge`,
640
+ {
641
+ method: "POST",
642
+ headers: headers(config),
643
+ body: JSON.stringify({ tool: mcpToolName, args: args ?? {} }),
644
+ },
645
+ bridgeSafety(isReadOnlyBridgeCall(name, "POST"), false),
646
+ options.signal,
647
+ );
494
648
  const data = await readScriptSdkJsonResponse(res, `ctx.swarm.${name}`);
495
649
  if (!res.ok && options.throwOnError) {
496
650
  const message =
@@ -519,11 +673,16 @@ async function callBridgeApi(
519
673
  });
520
674
  }
521
675
 
522
- const res = await fetch(`${baseUrl}${request.path}`, {
523
- method: request.method,
524
- headers: { ...headers(config), ...request.headers },
525
- body: request.body === undefined ? undefined : JSON.stringify(request.body),
526
- });
676
+ const res = await bridgeFetch(
677
+ `${baseUrl}${request.path}`,
678
+ {
679
+ method: request.method,
680
+ headers: { ...headers(config), ...request.headers },
681
+ body: request.body === undefined ? undefined : JSON.stringify(request.body),
682
+ },
683
+ bridgeSafety(isReadOnlyBridgeCall(name, request.method), hasIdempotencyKey(request.headers)),
684
+ options.signal,
685
+ );
527
686
  const data = await readScriptSdkJsonResponse(res, `ctx.swarm.${name}`);
528
687
  if (!res.ok && options.throwOnError) {
529
688
  const message =
@@ -536,7 +695,12 @@ async function callBridgeApi(
536
695
  return options.preserveData ? result : scrubObject(result);
537
696
  }
538
697
 
539
- async function callTool(name: string, args: unknown, config: SwarmConfig): Promise<unknown> {
698
+ async function callTool(
699
+ name: string,
700
+ args: unknown,
701
+ config: SwarmConfig,
702
+ signal: AbortSignal | undefined,
703
+ ): Promise<unknown> {
540
704
  if (!isSdkToolAllowed(name)) {
541
705
  throw new Error(
542
706
  `Tool '${name}' is not exposed to scripts (lifecycle/cred tool); use the MCP surface directly if you're an agent`,
@@ -544,11 +708,11 @@ async function callTool(name: string, args: unknown, config: SwarmConfig): Promi
544
708
  }
545
709
 
546
710
  if (name === "script_search" || name === "script_run") {
547
- return callBridgeApi(name, args, config, { throwOnError: true });
711
+ return callBridgeApi(name, args, config, { throwOnError: true, signal });
548
712
  }
549
713
 
550
714
  if (name === "kv_getOrNull") {
551
- const result = (await callBridgeApi(name, args, config)) as {
715
+ const result = (await callBridgeApi(name, args, config, { signal })) as {
552
716
  success: boolean;
553
717
  status: number;
554
718
  data: unknown;
@@ -564,7 +728,7 @@ async function callTool(name: string, args: unknown, config: SwarmConfig): Promi
564
728
  return result.data;
565
729
  }
566
730
 
567
- return callBridgeApi(name, args, config);
731
+ return callBridgeApi(name, args, config, { signal });
568
732
  }
569
733
 
570
734
  type RoomMethods = Record<
@@ -573,11 +737,17 @@ type RoomMethods = Record<
573
737
  >;
574
738
  type RuntimeSwarmSdk = Record<string, (args?: unknown) => Promise<unknown>> & { room: RoomMethods };
575
739
 
576
- export function createSwarmSdk(config: SwarmConfig): RuntimeSwarmSdk {
740
+ /** `signal`: the run's abort signal; it stops bridge retries when the run ends. */
741
+ export function createSwarmSdk(
742
+ config: SwarmConfig,
743
+ options: { signal?: AbortSignal } = {},
744
+ ): RuntimeSwarmSdk {
745
+ const { signal } = options;
577
746
  const roomCall = (method: keyof RoomMethods) => async (args?: unknown) => {
578
747
  const result = (await callBridgeApi(`room_${method}`, args, config, {
579
748
  throwOnError: true,
580
749
  preserveData: true,
750
+ signal,
581
751
  })) as { data: { room?: unknown } };
582
752
  return method === "decode" ? result.data : result.data.room;
583
753
  };
@@ -592,7 +762,7 @@ export function createSwarmSdk(config: SwarmConfig): RuntimeSwarmSdk {
592
762
  get(target, prop) {
593
763
  if (typeof prop !== "string") return undefined;
594
764
  if (prop in target) return target[prop];
595
- return (args?: unknown) => callTool(prop, args, config);
765
+ return (args?: unknown) => callTool(prop, args, config, signal);
596
766
  },
597
767
  }) as RuntimeSwarmSdk;
598
768
  }