@desplega.ai/agent-swarm 2.8.3 → 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 (491) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-pb678g3e.js} +20 -19
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-mkptw0k7.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-t7k39ree.js} +54 -33
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-4vb0xsat.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-kdxttvc3.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-0t2teq6n.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-s8p8hhty.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-s7zz734a.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-kw44j53p.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-mwwmka77.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-4dpkjc2e.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-mdpbjnzq.js → cli-4ghh072d.js} +14 -14
  28. package/dist/{cli-54qr8mcd.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  30. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-4ax9mvvg.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-t5ys4ebm.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-k96cecs7.js → cli-5ntc4we6.js} +2948 -316
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/cli-6dp0jkfj.js +754 -0
  36. package/dist/{cli-k2rw11py.js → cli-7831nhaw.js} +5 -5
  37. package/dist/{cli-7c5tgqhf.js → cli-7cgf614g.js} +10 -10
  38. package/dist/{cli-z8cvws4c.js → cli-7fx9jyfs.js} +852 -55
  39. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  40. package/dist/{cli-0bcgyj5b.js → cli-812paz57.js} +69 -6
  41. package/dist/{cli-ztq5z4e1.js → cli-8axx8vnw.js} +4 -4
  42. package/dist/cli-8x8y70av.js +103 -0
  43. package/dist/{cli-6yygkr0w.js → cli-95930z69.js} +15 -7
  44. package/dist/{cli-sdvcrq5x.js → cli-9a2rtd77.js} +16 -14
  45. package/dist/cli-9ttx00s3.js +137 -0
  46. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  47. package/dist/{cli-am1ptset.js → cli-aa8s22gn.js} +19 -14
  48. package/dist/{cli-4e1hfbpq.js → cli-bk9v1xrv.js} +19 -19
  49. package/dist/{cli-e2w34h6z.js → cli-c07v0qfa.js} +98 -54
  50. package/dist/{cli-dpsfwh7n.js → cli-c5cspahx.js} +24 -24
  51. package/dist/{cli-gpz1d0t2.js → cli-cw7mc1je.js} +4 -4
  52. package/dist/{cli-qmqt520k.js → cli-dd37e0cm.js} +2 -2
  53. package/dist/cli-dqgnbnxs.js +132 -0
  54. package/dist/{cli-tnzebztn.js → cli-dx439zpg.js} +1 -1
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-knva3nmx.js → cli-e9973bf0.js} +8 -6
  57. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  58. package/dist/{cli-crpf163n.js → cli-eepnpee7.js} +16 -26
  59. package/dist/{cli-nx2n3z6p.js → cli-eg437b5p.js} +1 -1
  60. package/dist/{cli-zdaypkq9.js → cli-faf46gdq.js} +285 -97
  61. package/dist/{cli-tas6ckky.js → cli-fgphc007.js} +2 -2
  62. package/dist/{cli-sg27rk2t.js → cli-fnh4b12r.js} +24 -18
  63. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  64. package/dist/{cli-rqfvkx5t.js → cli-g3zzby8t.js} +13 -13
  65. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  66. package/dist/{cli-tf79ryyy.js → cli-gddgcnav.js} +3 -3
  67. package/dist/{cli-rjvsf9qa.js → cli-h474mvp5.js} +11 -11
  68. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  69. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  70. package/dist/{cli-awwptga4.js → cli-jd3kxppb.js} +1 -1
  71. package/dist/{cli-1m96dc36.js → cli-js8zrfyg.js} +3 -3
  72. package/dist/{cli-vx421edw.js → cli-k09cxm6m.js} +9 -7
  73. package/dist/{cli-n5t077me.js → cli-k7pt28ad.js} +10 -3
  74. package/dist/{cli-922z7gwm.js → cli-kaa4bd7x.js} +9 -6
  75. package/dist/cli-kj0hyr43.js +51 -0
  76. package/dist/{cli-c0xjnr8z.js → cli-kmvcm34h.js} +2 -2
  77. package/dist/{cli-0vksaxvr.js → cli-kqh27v2y.js} +2 -2
  78. package/dist/{cli-bj6qhgte.js → cli-m1fbz2wj.js} +30 -37
  79. package/dist/{cli-me0r8gzr.js → cli-mc1fx4xd.js} +27 -25
  80. package/dist/{cli-qps8je6j.js → cli-me4maa4j.js} +46 -6
  81. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  82. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  83. package/dist/{cli-yss07azk.js → cli-nhq5js1b.js} +3 -3
  84. package/dist/cli-nmcpzbty.js +296 -0
  85. package/dist/cli-nr46j5pw.js +78 -0
  86. package/dist/{cli-t4dv07kr.js → cli-pn1v1pb0.js} +1 -1
  87. package/dist/{cli-c71n3bxq.js → cli-pwsax0vp.js} +2 -2
  88. package/dist/{cli-9zmb7ptc.js → cli-pz1c00aa.js} +8 -753
  89. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  90. package/dist/{cli-zeaehgyd.js → cli-q8cfh1t9.js} +2 -2
  91. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  92. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  93. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  94. package/dist/{cli-gn9y6fn7.js → cli-rts1qvb4.js} +2 -2
  95. package/dist/{cli-pxwtcgcp.js → cli-sn4pc4qx.js} +2 -2
  96. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  97. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  98. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  99. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  100. package/dist/{cli-8476gtwf.js → cli-ssvdrk4y.js} +1 -1
  101. package/dist/{cli-c3ng0mb4.js → cli-svc803vq.js} +69 -816
  102. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  103. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  104. package/dist/{cli-bhsfbmk8.js → cli-vvgaz8t6.js} +93 -44
  105. package/dist/{cli-kmemts3w.js → cli-vw5x18yj.js} +39 -69
  106. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  107. package/dist/cli-w7dxb2fj.js +921 -0
  108. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  109. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  110. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  111. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  112. package/dist/{cli-h9yy18gy.js → cli-ymct0ycy.js} +262 -100
  113. package/dist/{cli-dtdht77h.js → cli-zg3z63x3.js} +2 -2
  114. package/dist/cli.js +27 -24
  115. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-44yq2fkn.js} +9 -8
  116. package/dist/{codex-hook-c930c3ea.js → codex-hook-h1zb7cfk.js} +6 -6
  117. package/dist/{codex-login-cbrs1h5w.js → codex-login-cdyrr5y1.js} +1 -1
  118. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-zbh26gbw.js} +10 -9
  119. package/dist/{commands-wn9q06qr.js → commands-54f02v5b.js} +3 -3
  120. package/dist/{controller-fw608czd.js → controller-9gpwcdek.js} +6 -6
  121. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-61re6k1n.js} +26 -25
  122. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-7e4g81vd.js} +2 -2
  123. package/dist/{db-y4wfrzbm.js → db-dg2gc7fd.js} +15 -13
  124. package/dist/{db-0m6v5tq4.js → db-wnh0qjy1.js} +3 -3
  125. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  126. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-jrm24r43.js} +19 -18
  127. package/dist/{docker-j75atvpt.js → docker-9aq30pp2.js} +5 -5
  128. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-1yqk267c.js} +2 -2
  129. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  130. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  131. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  132. package/dist/{embedding-space-wh8de1t9.js → embedding-space-bafjr5f7.js} +6 -6
  133. package/dist/{embeddings-3hpbdtjr.js → embeddings-7xmgqe0e.js} +1 -1
  134. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  135. package/dist/{execute-4bdf8sdy.js → execute-d6jg5ns0.js} +1 -1
  136. package/dist/{external-channel-ts2fwqh0.js → external-channel-frq1xvq2.js} +2 -2
  137. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  138. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  139. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  140. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  141. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  142. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  143. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  144. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  145. package/dist/grok-adapter-3db1c538.js +19 -0
  146. package/dist/handlers-k22n8mnn.js +33 -0
  147. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-6bpa611t.js} +22 -21
  148. package/dist/{hook-ca54yd4s.js → hook-hvm5nf46.js} +5 -5
  149. package/dist/{hook-gaehe2w5.js → hook-w12k146y.js} +14 -14
  150. package/dist/{http-jfg8t2yk.js → http-43tthdvs.js} +1684 -509
  151. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  152. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  153. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  154. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  155. package/dist/index-8xcyd3mc.js +33 -0
  156. package/dist/index-9sy2bh6n.js +38 -0
  157. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  158. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  159. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  160. package/dist/{index-csgrxedz.js → index-fn054vsf.js} +1 -1
  161. package/dist/{index-3yvzbhxd.js → index-ftywhyr0.js} +129 -142
  162. package/dist/{index-3gv6sc4z.js → index-mhq4sh5w.js} +1 -1
  163. package/dist/index-tx9mc2ap.js +570 -0
  164. package/dist/index-wjd56k1v.js +34 -0
  165. package/dist/{keepalive-k2a3qe73.js → keepalive-rk0j0jvh.js} +4 -4
  166. package/dist/lead-atxf3q6e.js +72 -0
  167. package/dist/{maintenance-gb5sd5nc.js → maintenance-g6z6kaxw.js} +1 -1
  168. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  169. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  170. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  171. package/dist/{onboard-jmc5qerv.js → onboard-6fdbvh3v.js} +8 -8
  172. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  173. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  174. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-fdbsvts7.js} +7 -6
  175. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-rvwtc09q.js} +110 -110
  176. package/dist/pending-sqkrb836.js +80 -0
  177. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-asqayqcg.js} +12 -12
  178. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-f5tkgmw2.js} +2 -2
  179. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-06s555fa.js} +3 -3
  180. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-szxsg8t1.js} +10 -3
  181. package/dist/{render-v2-1gfpd8rj.js → render-v2-103p266q.js} +4 -4
  182. package/dist/{resume-w1s1eh5v.js → resume-v7kjewt9.js} +8 -7
  183. package/dist/{runtime-84g5egsc.js → runtime-f1gmk0b7.js} +1 -1
  184. package/dist/{session-access-y6z1txk4.js → session-access-6shev8ts.js} +4 -4
  185. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-bd7spzjd.js} +3 -3
  186. package/dist/{setup-r91gstyk.js → setup-kmxmztdb.js} +1 -1
  187. package/dist/thread-buffer-4yz236d0.js +36 -0
  188. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-57eje5wy.js} +5 -5
  189. package/dist/{work-objects-qcxzg61c.js → work-objects-zr47ygmf.js} +23 -21
  190. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-grrr3fda.js} +19 -18
  191. package/dist/worker-p4hbtcy3.js +72 -0
  192. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  193. package/openapi.json +1211 -155
  194. package/package.json +9 -6
  195. package/plugin/commands/create-pr.md +1 -1
  196. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  197. package/src/apps/action-runner.ts +21 -1
  198. package/src/apps/catalog.generated.json +626 -17
  199. package/src/apps/page-validator.ts +314 -8
  200. package/src/assets/key.ts +6 -0
  201. package/src/be/agent-fs-user-keys.ts +186 -0
  202. package/src/be/audit-user.ts +27 -13
  203. package/src/be/automation-preflight.test.ts +14 -14
  204. package/src/be/automation-preflight.ts +24 -16
  205. package/src/be/boot-scrub-sweep.ts +143 -14
  206. package/src/be/caller-session-group.ts +86 -0
  207. package/src/be/checklist.ts +375 -0
  208. package/src/be/db/agents.ts +12 -1
  209. package/src/be/db/approvals.ts +26 -0
  210. package/src/be/db/session-moves.ts +23 -0
  211. package/src/be/db/session-tree.ts +78 -19
  212. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  213. package/src/be/db/tasks/slack-fold.ts +116 -0
  214. package/src/be/db/tasks/write.ts +34 -0
  215. package/src/be/db-queries/mcp-servers.ts +13 -0
  216. package/src/be/db-queries/oauth.ts +6 -0
  217. package/src/be/db-queries/task-artifacts.ts +10 -8
  218. package/src/be/db.ts +42 -15
  219. package/src/be/extensions/assets.ts +17 -13
  220. package/src/be/import/config.ts +54 -0
  221. package/src/be/import/dir-source.ts +372 -0
  222. package/src/be/import/index.ts +149 -0
  223. package/src/be/import/pending.ts +71 -0
  224. package/src/be/import/schema.ts +137 -0
  225. package/src/be/import/seeders.ts +462 -0
  226. package/src/be/migrations/297_import_ownership.sql +34 -0
  227. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  228. package/src/be/migrations/302_checklist_items.sql +23 -0
  229. package/src/be/multi-runtime.ts +8 -1
  230. package/src/be/rbac-roles.ts +8 -1
  231. package/src/be/runtime-pools/demand.ts +20 -2
  232. package/src/be/runtime-pools/reachability.ts +31 -0
  233. package/src/be/runtime-pools/routing.ts +8 -1
  234. package/src/be/runtime-pools/supervisor.ts +6 -7
  235. package/src/be/savings/read.ts +8 -6
  236. package/src/be/script-credential-broker.ts +2 -2
  237. package/src/be/scripts/typecheck.ts +4 -4
  238. package/src/be/seed/agent-fs-provision.ts +104 -19
  239. package/src/be/seed/index.ts +1 -1
  240. package/src/be/seed/registry.ts +27 -8
  241. package/src/be/seed/runner.ts +1 -1
  242. package/src/be/seed/schedules-seeder.ts +24 -6
  243. package/src/be/seed/seed-toggle.ts +32 -0
  244. package/src/be/seed/types.ts +6 -0
  245. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  246. package/src/be/steering.ts +27 -4
  247. package/src/be/swarm-config-guard.ts +30 -0
  248. package/src/be/task-citations.ts +8 -5
  249. package/src/commands/onboard/agent-fs-version.ts +1 -1
  250. package/src/commands/runner.ts +61 -2
  251. package/src/e2b/env.ts +2 -0
  252. package/src/extensions/catalog.generated.json +17 -0
  253. package/src/extensions/contract-types.generated.ts +1 -1
  254. package/src/github/app.ts +10 -1
  255. package/src/github/handlers.ts +6 -3
  256. package/src/github/reactions.ts +12 -14
  257. package/src/heartbeat/heartbeat.ts +14 -4
  258. package/src/http/agents.ts +19 -10
  259. package/src/http/all-routes.ts +2 -0
  260. package/src/http/approval-requests.ts +24 -4
  261. package/src/http/apps.ts +69 -5
  262. package/src/http/checklist.ts +176 -0
  263. package/src/http/db-query-bounded.ts +256 -11
  264. package/src/http/db-query-shared.ts +9 -0
  265. package/src/http/favorites.ts +14 -2
  266. package/src/http/fs.ts +346 -1
  267. package/src/http/index.ts +29 -1
  268. package/src/http/kv.ts +13 -0
  269. package/src/http/mcp-oauth.ts +1 -1
  270. package/src/http/mcp-servers.ts +15 -2
  271. package/src/http/onboarding.ts +2 -9
  272. package/src/http/poll.ts +45 -0
  273. package/src/http/script-connections.ts +1 -0
  274. package/src/http/sessions.ts +17 -0
  275. package/src/http/slack-events.ts +101 -0
  276. package/src/http/status.ts +25 -7
  277. package/src/http/task-requester.ts +46 -0
  278. package/src/http/tasks.ts +64 -37
  279. package/src/http/users.ts +14 -0
  280. package/src/http/webhooks.ts +15 -0
  281. package/src/integrations/cards/index.ts +151 -0
  282. package/src/integrations/chat-sdk/outbound.ts +39 -13
  283. package/src/integrations/chat-sdk/runtime.ts +7 -1
  284. package/src/integrations/chat-sdk/status.ts +17 -0
  285. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  286. package/src/kv-reserved-namespaces.ts +17 -2
  287. package/src/oauth/presets.ts +29 -2
  288. package/src/prompts/base-prompt.ts +17 -4
  289. package/src/prompts/session-templates.ts +83 -6
  290. package/src/providers/acp-targets.ts +1 -1
  291. package/src/providers/amp-adapter.ts +1 -1
  292. package/src/providers/claude-managed-adapter.ts +5 -1
  293. package/src/providers/codex-adapter.ts +1 -1
  294. package/src/providers/codex-app-server.ts +2 -11
  295. package/src/providers/opencode-adapter.ts +7 -19
  296. package/src/providers/runtime-dependencies.ts +158 -0
  297. package/src/rbac/legacy-policy.ts +2 -0
  298. package/src/rbac/permissions.ts +10 -1
  299. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  300. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  301. package/src/scripts-runtime/egress-secrets.ts +2 -2
  302. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  303. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  304. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -1
  305. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  306. package/src/server.ts +4 -4
  307. package/src/slack/app.ts +87 -46
  308. package/src/slack/assistant.ts +33 -7
  309. package/src/slack/handlers.ts +6 -4
  310. package/src/slack/http-receiver.ts +284 -0
  311. package/src/slack/inbound-dispatch.ts +43 -7
  312. package/src/slack/inbound-files.ts +33 -14
  313. package/src/slack/message-text.ts +47 -4
  314. package/src/slack/render-v2.ts +2 -1
  315. package/src/slack/socket-ack.ts +17 -10
  316. package/src/slack/steering.ts +5 -0
  317. package/src/slack/thread-buffer-store.ts +58 -0
  318. package/src/slack/thread-buffer.ts +341 -57
  319. package/src/tasks/context-key.ts +24 -0
  320. package/src/tasks/sibling-awareness.ts +13 -1
  321. package/src/tests/agent-fs-live-url.test.ts +15 -0
  322. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  323. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  324. package/src/tests/agentfs-proxy.test.ts +8 -8
  325. package/src/tests/approval-card-resolution.test.ts +396 -0
  326. package/src/tests/approval-requests-notifications.test.ts +1 -1
  327. package/src/tests/approval-respond-auth.test.ts +28 -0
  328. package/src/tests/apps-action-parent-task.test.ts +140 -0
  329. package/src/tests/apps-catalog-additions.test.ts +315 -0
  330. package/src/tests/apps-catalog-files.test.ts +114 -0
  331. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  332. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  333. package/src/tests/apps-catalog-table.test.ts +47 -0
  334. package/src/tests/apps-chart-shell.test.ts +1 -1
  335. package/src/tests/apps-element-assembly.test.ts +52 -3
  336. package/src/tests/apps-session-thread.test.ts +182 -0
  337. package/src/tests/asset-key-invariants.test.ts +14 -0
  338. package/src/tests/base-prompt.test.ts +107 -23
  339. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  340. package/src/tests/caller-session-group.test.ts +199 -0
  341. package/src/tests/cards.test.ts +169 -0
  342. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  343. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  344. package/src/tests/chat-sdk-tools.test.ts +147 -0
  345. package/src/tests/checklist-nudge.test.ts +208 -0
  346. package/src/tests/checklist.test.ts +686 -0
  347. package/src/tests/codex-app-server.test.ts +16 -0
  348. package/src/tests/comb-config-guard.test.ts +21 -0
  349. package/src/tests/comb-default.test.ts +59 -97
  350. package/src/tests/comb-links.test.ts +86 -16
  351. package/src/tests/comb-status.test.ts +24 -27
  352. package/src/tests/create-page-tool.test.ts +101 -1
  353. package/src/tests/create-schedule-key.test.ts +105 -0
  354. package/src/tests/credential-broker.test.ts +2 -2
  355. package/src/tests/db-query.test.ts +87 -1
  356. package/src/tests/db-task-read-contract.test.ts +1 -0
  357. package/src/tests/db-task-write-contract.test.ts +2 -1
  358. package/src/tests/docs-index-footprint.test.js +3 -3
  359. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  360. package/src/tests/extensions-assets.test.ts +7 -3
  361. package/src/tests/extensions-catalog.test.ts +1 -0
  362. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  363. package/src/tests/extensions-pre-task.test.ts +3 -3
  364. package/src/tests/extensions-steering.test.ts +14 -2
  365. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  366. package/src/tests/fetch-resolved-env.test.ts +68 -0
  367. package/src/tests/fixtures/import-package.ts +32 -0
  368. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  369. package/src/tests/fs-routes.test.ts +505 -2
  370. package/src/tests/github-ghes-mock.test.ts +196 -0
  371. package/src/tests/github-host.test.ts +285 -0
  372. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  373. package/src/tests/heartbeat.test.ts +56 -0
  374. package/src/tests/import-config.test.ts +209 -0
  375. package/src/tests/import.test.ts +464 -0
  376. package/src/tests/invites-http.test.ts +144 -1
  377. package/src/tests/kv-http.test.ts +11 -0
  378. package/src/tests/literal-matcher.test.ts +58 -0
  379. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  380. package/src/tests/oauth-presets.test.ts +12 -0
  381. package/src/tests/pool-affinity.test.ts +50 -0
  382. package/src/tests/prompt-template-session.test.ts +52 -5
  383. package/src/tests/provider-registration.test.ts +2 -55
  384. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  385. package/src/tests/rbac-admission.test.ts +19 -0
  386. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  387. package/src/tests/rbac-engine.test.ts +2 -0
  388. package/src/tests/rbac-roles.test.ts +2 -0
  389. package/src/tests/runner-missing-dependency.test.ts +61 -0
  390. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  391. package/src/tests/runtime-pool-routing.test.ts +52 -0
  392. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  393. package/src/tests/savings-fleet-slices.test.ts +122 -0
  394. package/src/tests/savings-read.test.ts +41 -0
  395. package/src/tests/savings-scripts.test.ts +9 -3
  396. package/src/tests/script-connections.test.ts +2 -0
  397. package/src/tests/script-executor-conformance.test.ts +41 -4
  398. package/src/tests/secret-scrub-gate.test.ts +257 -0
  399. package/src/tests/seed-registry.test.ts +142 -9
  400. package/src/tests/session-source-keys.test.ts +42 -1
  401. package/src/tests/sessions-move.test.ts +70 -0
  402. package/src/tests/sessions-tree.test.ts +98 -0
  403. package/src/tests/sessions.test.ts +69 -0
  404. package/src/tests/slack-config.test.ts +4 -18
  405. package/src/tests/slack-http-receiver.test.ts +472 -0
  406. package/src/tests/slack-inbound-logging.test.ts +64 -0
  407. package/src/tests/slack-leave-thread.test.ts +1 -1
  408. package/src/tests/slack-message-text.test.ts +104 -0
  409. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  410. package/src/tests/slack-render-v2.test.ts +48 -0
  411. package/src/tests/slack-skip-reaction.test.ts +2 -2
  412. package/src/tests/slack-steering.test.ts +22 -10
  413. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  414. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  415. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  416. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  417. package/src/tests/slack-thread-buffer.test.ts +34 -34
  418. package/src/tests/slack-thread-participants.test.ts +23 -5
  419. package/src/tests/slack-tool-blocks.test.ts +167 -0
  420. package/src/tests/status.test.ts +32 -6
  421. package/src/tests/steering-core.test.ts +13 -0
  422. package/src/tests/steering-enabled.test.ts +7 -1
  423. package/src/tests/steering-promotion.test.ts +24 -0
  424. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  425. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  426. package/src/tests/task-artifacts.test.ts +50 -0
  427. package/src/tests/task-session-prompts.test.ts +95 -1
  428. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  429. package/src/tools/chat-post.ts +19 -4
  430. package/src/tools/chat-reply.ts +20 -4
  431. package/src/tools/create-page.ts +21 -4
  432. package/src/tools/get-swarm.ts +18 -2
  433. package/src/tools/join-swarm.ts +2 -1
  434. package/src/tools/kv/kv-write-auth.ts +17 -1
  435. package/src/tools/schedules/create-schedule.ts +22 -4
  436. package/src/tools/slack-post.ts +40 -7
  437. package/src/tools/slack-reply.ts +50 -14
  438. package/src/types.ts +43 -2
  439. package/src/utils/constants.ts +60 -138
  440. package/src/utils/github-host.ts +217 -0
  441. package/src/utils/github-pull-request.ts +8 -5
  442. package/src/utils/literal-matcher.ts +118 -0
  443. package/src/utils/secret-scrubber.ts +331 -25
  444. package/src/utils/task-attachment-links.ts +9 -12
  445. package/src/vcs/index.ts +3 -0
  446. package/src/workflows/approval-notifications.ts +188 -12
  447. package/src/workflows/executors/system-one-extraction.ts +14 -7
  448. package/src/workflows/executors/system-one-providers.ts +22 -1
  449. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  450. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  451. package/templates/extensions/README.md +1 -0
  452. package/templates/extensions/sql-admin-only/README.md +19 -0
  453. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  454. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  455. package/templates/import/manifest.schema.json +136 -0
  456. package/templates/import/sources.schema.json +44 -0
  457. package/templates/skills/agent-browser/SKILL.md +1 -1
  458. package/templates/skills/agent-browser/content.md +1 -1
  459. package/templates/skills/apps/SKILL.md +122 -12
  460. package/templates/skills/apps/content.md +122 -12
  461. package/templates/skills/asset-namespaces/content.md +2 -1
  462. package/templates/skills/chat-sdk/content.md +17 -0
  463. package/templates/skills/db-query-guidance/content.md +2 -1
  464. package/templates/skills/scheduling/content.md +27 -0
  465. package/templates/skills/slack-interaction/content.md +12 -2
  466. package/templates/skills/swarm-docs/content.md +1 -0
  467. package/templates/skills/swarm-extensions/config.json +1 -1
  468. package/templates/skills/swarm-extensions/content.md +33 -23
  469. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  470. package/templates/skills/swarm-scripts/content.md +13 -0
  471. package/templates/skills/work-on-task/SKILL.md +1 -1
  472. package/templates/skills/work-on-task/content.md +1 -1
  473. package/templates/skills/workflow-iterate/content.md +4 -7
  474. package/templates/workflows/dreaming/content.md +2 -2
  475. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  476. package/dist/claude-adapter-r33pqnzx.js +0 -24
  477. package/dist/cli-dns0y538.js +0 -194
  478. package/dist/fx-adapter-1rnxnf56.js +0 -17
  479. package/dist/grok-adapter-efhmf1r8.js +0 -17
  480. package/dist/handlers-anrr3py9.js +0 -32
  481. package/dist/index-8w2aznds.js +0 -33
  482. package/dist/index-qnjvr362.js +0 -37
  483. package/dist/index-yzxd3sn9.js +0 -32
  484. package/dist/lead-zhxqbfdv.js +0 -69
  485. package/dist/worker-7j2907g6.js +0 -69
  486. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  487. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  488. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  489. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  490. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  491. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -0,0 +1,158 @@
1
+ import { existsSync } from "node:fs";
2
+ import type { ProviderName } from "../types";
3
+ import { scrubSecrets } from "../utils/secret-scrubber";
4
+ import type { ProviderSessionConfig } from "./types";
5
+
6
+ interface DependencyProbes {
7
+ which: (command: string, env: Record<string, string | undefined>, cwd: string) => string | null;
8
+ resolveModule: (specifier: string) => string;
9
+ }
10
+
11
+ const probes: DependencyProbes = {
12
+ which: (command, env, cwd) => Bun.which(command, { PATH: env.PATH, cwd }),
13
+ resolveModule: (specifier) => Bun.resolveSync(specifier, import.meta.dir),
14
+ };
15
+
16
+ /** Keep preflight and the app-server on the same override/package fallback. */
17
+ export function resolveCodexCommand(
18
+ env: Record<string, string | undefined>,
19
+ cwd = process.cwd(),
20
+ dependencies: DependencyProbes = probes,
21
+ ): string {
22
+ const override = env.CODEX_PATH_OVERRIDE || env.CODEX_BINARY;
23
+ if (override) return override;
24
+ const fromPath = dependencies.which("codex", env, cwd);
25
+ if (fromPath) return fromPath;
26
+ try {
27
+ return dependencies.resolveModule("@openai/codex/bin/codex.js");
28
+ } catch {
29
+ return "codex";
30
+ }
31
+ }
32
+
33
+ /** OpenCode is external in compiled workers; source runs may use node_modules. */
34
+ export function resolveOpencodeSdkSpecifier(
35
+ env: Record<string, string | undefined> = process.env,
36
+ ): string {
37
+ if (env.OPENCODE_SDK_PATH) return env.OPENCODE_SDK_PATH;
38
+ for (const root of ["/usr/lib/node_modules", "/usr/local/lib/node_modules"]) {
39
+ const candidate = `${root}/@opencode/sdk/dist/index.js`;
40
+ if (existsSync(candidate)) return candidate;
41
+ }
42
+ return "@opencode/sdk";
43
+ }
44
+
45
+ const acpInstallHints: Record<string, string> = {
46
+ opencode: "Install OpenCode: npm install -g opencode-ai.",
47
+ gemini: "Install Gemini CLI: npm install -g @google/gemini-cli.",
48
+ copilot: "Install GitHub Copilot CLI: npm install -g @github/copilot.",
49
+ qwen: "Install Qwen Code: npm install -g @qwen-code/qwen-code.",
50
+ kiro: "Install Kiro CLI: https://cli.kiro.dev/install.",
51
+ goose: "Install Goose: https://goose-docs.ai/docs/getting-started/installation.",
52
+ custom: "Install the target or set ACP_TARGET_COMMAND to a trusted executable.",
53
+ };
54
+
55
+ /** Runs for every task, including after a live harness/config change. Never spawns a CLI. */
56
+ export async function validateProviderDependencies(
57
+ provider: ProviderName,
58
+ config: ProviderSessionConfig,
59
+ dependencies: DependencyProbes = probes,
60
+ ): Promise<void> {
61
+ const env = config.env ?? process.env;
62
+ const requireExecutable = (command: string, hint: string, pathEnv = env, cwd = config.cwd) => {
63
+ if (!dependencies.which(command, pathEnv, cwd)) {
64
+ throw new Error(
65
+ scrubSecrets(
66
+ `${provider} provider: required executable '${command}' was not found or is not executable. ${hint}`,
67
+ ),
68
+ );
69
+ }
70
+ };
71
+
72
+ switch (provider) {
73
+ case "claude": {
74
+ const { resolveClaudeBinaryArgv, withClaudeRouteEnv } = await import("./claude-adapter");
75
+ const sourceEnv = withClaudeRouteEnv(env);
76
+ const { argv, useClaudeBridge } = resolveClaudeBinaryArgv(sourceEnv);
77
+ requireExecutable(
78
+ argv[0]!,
79
+ useClaudeBridge
80
+ ? "Use worker-full or install @desplega.ai/claude-bridge during image provisioning."
81
+ : "Install Claude Code or set CLAUDE_BINARY to a trusted executable on the worker.",
82
+ sourceEnv,
83
+ );
84
+ return;
85
+ }
86
+ case "codex":
87
+ requireExecutable(
88
+ resolveCodexCommand(env, process.cwd(), dependencies),
89
+ "Install @openai/codex or set CODEX_PATH_OVERRIDE (or CODEX_BINARY) to a trusted executable.",
90
+ env,
91
+ process.cwd(),
92
+ );
93
+ return;
94
+ case "dsh":
95
+ requireExecutable(
96
+ env.DSH_BINARY || "dsh",
97
+ "Use worker-full, install @deepseek-ai/dsh@0.2.2-rc.1, or set DSH_BINARY to a trusted executable.",
98
+ );
99
+ return;
100
+ case "amp":
101
+ requireExecutable(
102
+ env.AMP_BINARY || "amp",
103
+ "Use worker-full, install @ampcode/cli, or set AMP_BINARY to a trusted executable.",
104
+ );
105
+ return;
106
+ case "grok":
107
+ case "fx":
108
+ case "acp": {
109
+ const { resolveAcpTarget, grokTargetProfile, fxTargetProfile } = await import(
110
+ "./acp-targets"
111
+ );
112
+ const target =
113
+ provider === "grok"
114
+ ? grokTargetProfile
115
+ : provider === "fx"
116
+ ? fxTargetProfile
117
+ : resolveAcpTarget(config);
118
+ const hint =
119
+ provider === "grok"
120
+ ? "Use worker-full, install @xai-official/grok@1.0.77, or set GROK_BINARY to a trusted executable."
121
+ : provider === "fx"
122
+ ? "Use worker-full, install the pinned fx release (Dockerfile.worker FX_VERSION), or set FX_BINARY."
123
+ : `ACP_TARGET='${target.target}'. ${acpInstallHints[target.target]}`;
124
+ requireExecutable(target.command(config)[0]!, hint, target.env(config));
125
+ return;
126
+ }
127
+ case "opencode": {
128
+ const specifier = resolveOpencodeSdkSpecifier(env);
129
+ try {
130
+ dependencies.resolveModule(specifier);
131
+ } catch {
132
+ throw new Error(
133
+ scrubSecrets(
134
+ `opencode provider: required @opencode/sdk could not be resolved from '${specifier}'. Install it with 'npm install -g @opencode/sdk' or set OPENCODE_SDK_PATH.`,
135
+ ),
136
+ );
137
+ }
138
+ return;
139
+ }
140
+ case "cursor":
141
+ if (env.CURSOR_RIPGREP_PATH) {
142
+ requireExecutable(
143
+ env.CURSOR_RIPGREP_PATH,
144
+ "Set CURSOR_RIPGREP_PATH to an executable ripgrep binary or unset it to use the SDK default.",
145
+ );
146
+ }
147
+ return;
148
+ // Their SDKs are bundled into the worker; they need no external CLI.
149
+ case "pi":
150
+ case "devin":
151
+ case "claude-managed":
152
+ return;
153
+ default: {
154
+ const unsupported: never = provider;
155
+ throw new Error(`No runtime dependency check for provider '${unsupported}'.`);
156
+ }
157
+ }
158
+ }
@@ -292,6 +292,8 @@ export const LEGACY_POLICY = {
292
292
  "session.read.all": operatorOrUser,
293
293
  "task.progress.write": taskProgressWrite,
294
294
  "favorite.write.own": anyAuthenticated,
295
+ "checklist.write.own": anyAuthenticated,
296
+ "checklist.write.agent": leadOnly,
295
297
  "memory.learning.inject": leadOnly,
296
298
  "memory.edit.any": leadOrResourceOwner,
297
299
  "memory.write.consolidated": leadOnly,
@@ -121,6 +121,14 @@ export const PERMISSIONS = {
121
121
  "Opt in to read every user's tasks and sessions (the dashboard's All users scope). Read-only: writes and steering still need the principal's own access.",
122
122
  namespace: "task",
123
123
  },
124
+ "checklist.write.own": {
125
+ description: "Edit checklist items the caller owns.",
126
+ namespace: "checklist",
127
+ },
128
+ "checklist.write.agent": {
129
+ description: "Change a user's checklist items as an agent. Only the Lead.",
130
+ namespace: "checklist",
131
+ },
124
132
  "favorite.write.own": {
125
133
  description: "Set a favorite the caller owns.",
126
134
  namespace: "favorite",
@@ -322,7 +330,8 @@ export const PERMISSIONS = {
322
330
  namespace: "mcp-oauth",
323
331
  },
324
332
  "kv.write.any": {
325
- description: "Write another agent's task:agent: KV namespace.",
333
+ description:
334
+ "Write another agent's task:agent: KV namespace, or a lead-only family (usecase:*).",
326
335
  namespace: "kv",
327
336
  },
328
337
  "comb.presence": {
@@ -1,3 +1,4 @@
1
+ import { resolveGitHubHost } from "../../utils/github-host";
1
2
  import type { CredentialBinding } from "./types";
2
3
 
3
4
  /**
@@ -7,14 +8,21 @@ import type { CredentialBinding } from "./types";
7
8
  * logic: operators can add more bindings through swarm_config without editing
8
9
  * the runtime code.
9
10
  */
10
- export const DEFAULT_CREDENTIAL_BINDINGS: CredentialBinding[] = [
11
- {
12
- configKey: "GITHUB_TOKEN",
13
- allowedHosts: ["api.github.com"],
14
- headerTemplate: "Authorization: Bearer [REDACTED:GITHUB_TOKEN]",
15
- scope: "global",
16
- scopeId: null,
17
- active: true,
18
- authKind: "config",
19
- },
20
- ];
11
+ export const defaultCredentialBindings = (): CredentialBinding[] => {
12
+ const host = resolveGitHubHost();
13
+ // Fail closed: an invalid GITHUB_URL / GITHUB_API_URL binds GITHUB_TOKEN to no host
14
+ // (never api.github.com), and script runs carry on without it.
15
+ if (!host.ok) return [];
16
+ return [
17
+ {
18
+ configKey: "GITHUB_TOKEN",
19
+ // The configured GitHub API host only: on GHES the PAT never goes to api.github.com.
20
+ allowedHosts: [host.config.apiHost],
21
+ headerTemplate: "Authorization: Bearer [REDACTED:GITHUB_TOKEN]",
22
+ scope: "global",
23
+ scopeId: null,
24
+ active: true,
25
+ authKind: "config",
26
+ },
27
+ ];
28
+ };
@@ -1,5 +1,5 @@
1
1
  export { CredentialBroker } from "./broker";
2
- export { DEFAULT_CREDENTIAL_BINDINGS } from "./default-bindings";
2
+ export { defaultCredentialBindings } from "./default-bindings";
3
3
  export { patchFetchWithCredentialBroker } from "./fetch-patch";
4
4
  export {
5
5
  CREDENTIAL_BINDINGS_CONFIG_KEY,
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  CredentialBroker,
3
- DEFAULT_CREDENTIAL_BINDINGS,
3
+ defaultCredentialBindings,
4
4
  type FailedCredentialBinding,
5
5
  patchFetchWithCredentialBroker,
6
6
  type ResolvedCredentialBinding,
@@ -12,7 +12,7 @@ export async function buildEgressSecrets(): Promise<EgressSecretEntry[]> {
12
12
  const broker = new CredentialBroker(
13
13
  { listActiveBindings: async () => [] },
14
14
  (configKey) => process.env[configKey],
15
- DEFAULT_CREDENTIAL_BINDINGS,
15
+ defaultCredentialBindings(),
16
16
  );
17
17
  return await broker.resolveBindings({});
18
18
  }
@@ -602,7 +602,8 @@ async function bridgeFetch(
602
602
  const delay = backoffMs(attempt, BRIDGE_MIN_DELAY_MS, BRIDGE_MAX_DELAY_MS);
603
603
  // An abort means the run is ending: settle now, never wait and retry.
604
604
  const aborted = signal?.aborted || (error instanceof Error && error.name === "AbortError");
605
- if (aborted || !repeatSafe || attempt > BRIDGE_MAX_RETRIES || !fits(delay)) throw error;
605
+ if (aborted || !repeatSafe || attempt > BRIDGE_MAX_RETRIES || (readOnly && !fits(delay)))
606
+ throw error;
606
607
  previous = { error };
607
608
  await sleep(delay, signal);
608
609
  if (signal?.aborted) throw error;
@@ -614,7 +615,7 @@ async function bridgeFetch(
614
615
  (res.status === 429 ? retryAfterMs(res.headers.get("retry-after")) : undefined) ??
615
616
  backoffMs(attempt, BRIDGE_MIN_DELAY_MS, BRIDGE_MAX_DELAY_MS);
616
617
  // A Retry-After past the budget: hand the 429 back rather than wait.
617
- if (!fits(delay)) return res;
618
+ if ((readOnly || res.status === 429) && !fits(delay)) return res;
618
619
  await res.body?.cancel().catch(() => {});
619
620
  previous = { response: res };
620
621
  await sleep(delay, signal);
@@ -509,13 +509,19 @@ declare module "swarm-sdk" {
509
509
  }): Promise<unknown>;
510
510
 
511
511
  // --- write: slack ---
512
- slack_post(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
512
+ slack_post(args: {
513
+ channelId: string;
514
+ message?: string;
515
+ blocks?: unknown;
516
+ card?: unknown;
517
+ }): Promise<unknown>;
513
518
  slack_reply(args: {
514
519
  channelId?: string;
515
520
  threadTs?: string;
516
- message: string;
521
+ message?: string;
517
522
  taskId?: string;
518
523
  blocks?: unknown;
524
+ card?: unknown;
519
525
  }): Promise<unknown>;
520
526
  slack_startThread(args: {
521
527
  channelId: string;
@@ -536,12 +542,13 @@ declare module "swarm-sdk" {
536
542
  }): Promise<unknown>;
537
543
 
538
544
  // --- write: chat sdk ---
539
- chat_reply(args: { text: string }): Promise<unknown>;
545
+ chat_reply(args: { text?: string; card?: unknown }): Promise<unknown>;
540
546
  chat_post(args: {
541
547
  adapter: "telegram" | "slack" | "discord" | "teams";
542
548
  threadId?: string;
543
549
  channelId?: string;
544
- text: string;
550
+ text?: string;
551
+ card?: unknown;
545
552
  }): Promise<unknown>;
546
553
  chat_openDm(args: {
547
554
  adapter: "telegram" | "slack" | "discord" | "teams";
@@ -344,7 +344,7 @@ declare module "swarm-extension" {
344
344
 
345
345
  export type SteerMode = "steer" | "queue";
346
346
 
347
- export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui";
347
+ export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";
348
348
 
349
349
  export type RequestInfo = {
350
350
  sessionId: string | undefined;
@@ -467,13 +467,19 @@ declare module "swarm-sdk" {
467
467
  }): Promise<unknown>;
468
468
 
469
469
  // --- write: slack ---
470
- slack_post(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
470
+ slack_post(args: {
471
+ channelId: string;
472
+ message?: string;
473
+ blocks?: unknown;
474
+ card?: unknown;
475
+ }): Promise<unknown>;
471
476
  slack_reply(args: {
472
477
  channelId?: string;
473
478
  threadTs?: string;
474
- message: string;
479
+ message?: string;
475
480
  taskId?: string;
476
481
  blocks?: unknown;
482
+ card?: unknown;
477
483
  }): Promise<unknown>;
478
484
  slack_startThread(args: {
479
485
  channelId: string;
@@ -494,12 +500,13 @@ declare module "swarm-sdk" {
494
500
  }): Promise<unknown>;
495
501
 
496
502
  // --- write: chat sdk ---
497
- chat_reply(args: { text: string }): Promise<unknown>;
503
+ chat_reply(args: { text?: string; card?: unknown }): Promise<unknown>;
498
504
  chat_post(args: {
499
505
  adapter: "telegram" | "slack" | "discord" | "teams";
500
506
  threadId?: string;
501
507
  channelId?: string;
502
- text: string;
508
+ text?: string;
509
+ card?: unknown;
503
510
  }): Promise<unknown>;
504
511
  chat_openDm(args: {
505
512
  adapter: "telegram" | "slack" | "discord" | "teams";
package/src/server.ts CHANGED
@@ -305,11 +305,11 @@ export function getEnabledCapabilities(): CAPABILITIES_T[] {
305
305
  );
306
306
  // The Chat SDK channel follows CHAT_SDK_ENABLED, not the CAPABILITIES list.
307
307
  if (isChatSdkEnabled()) capabilities.push("chat-sdk");
308
- // Phase 1 has no HTTP receiver. Do not advertise usable Slack tools to
309
- // workers when HTTP (or an invalid transport) was selected, or when the
310
- // built-in Slack app is off (SLACK_DISABLE, required by the Chat SDK Slack adapter).
308
+ // Do not advertise usable Slack tools to workers when the transport is
309
+ // invalid, or when the built-in Slack app is off (SLACK_DISABLE, required by
310
+ // the Chat SDK Slack adapter).
311
311
  const slack = getSlackConfiguration();
312
- return slack.mode === "socket" && !slack.disabled
312
+ return slack.mode !== null && !slack.disabled
313
313
  ? capabilities
314
314
  : capabilities.filter((capability) => capability !== "slack");
315
315
  }
package/src/slack/app.ts CHANGED
@@ -10,9 +10,14 @@ import {
10
10
  } from "./connection-state";
11
11
  import { installSlackEgressScrub } from "./egress-scrub";
12
12
  import { installSlackExternalChannelGuard } from "./external-channel-egress";
13
- import { recoverSlackInboundAfterRestart, slackInboundOutcomeMiddleware } from "./inbound-dispatch";
13
+ import { SwarmHttpReceiver } from "./http-receiver";
14
+ import {
15
+ ignoreSelfAsIgnored,
16
+ recoverSlackInboundAfterRestart,
17
+ slackInboundOutcomeMiddleware,
18
+ } from "./inbound-dispatch";
14
19
  import { isSlackLifecycleBusy, runSlackLifecycleExclusive } from "./lifecycle-lock";
15
- import { installSocketAckRecovery } from "./socket-ack";
20
+ import { createBoltInboundDrain, installSocketAckRecovery } from "./socket-ack";
16
21
  import { fenceSocketModeClient, type SlackSocketFence } from "./socket-fence";
17
22
  import { getSlackSocketModeBlockReason, SLACK_DEV_SOCKET_MODE_OPT_IN } from "./socket-mode-guard";
18
23
  import { startTaskWatcher, stopTaskWatcher } from "./watcher";
@@ -26,8 +31,10 @@ import {
26
31
 
27
32
  let app: App | null = null;
28
33
  let receiver: SocketModeReceiver | null = null;
34
+ // SLACK_MODE=http: the receiver behind POST /api/integrations/slack/events.
35
+ let httpReceiver: SwarmHttpReceiver | null = null;
29
36
  let initialized = false;
30
- let inboundDrain: ReturnType<typeof installSocketAckRecovery> | null = null;
37
+ let inboundDrain: ReturnType<typeof createBoltInboundDrain> | null = null;
31
38
  // Retires the current client at teardown, so a reconnect it still has in
32
39
  // flight cannot open a socket next to the replacement.
33
40
  let socketFence: SlackSocketFence | null = null;
@@ -297,6 +304,11 @@ export function getSlackApp(): App | null {
297
304
  return app;
298
305
  }
299
306
 
307
+ /** The HTTP receiver of the running app, or null (Socket Mode, stopped, or not started yet). */
308
+ export function getSlackHttpReceiver(): SwarmHttpReceiver | null {
309
+ return httpReceiver;
310
+ }
311
+
300
312
  export async function initSlackApp(): Promise<App | null> {
301
313
  // Prevent double initialization
302
314
  if (initialized) {
@@ -323,24 +335,16 @@ export async function initSlackApp(): Promise<App | null> {
323
335
  return null;
324
336
  }
325
337
 
326
- // Phase 1 establishes the transport contract only. Never fall back to a
327
- // socket when HTTP was explicitly selected; the receiver lands in Phase 3.
328
- if (config.mode === "http") {
329
- console.error(
330
- "[Slack] HTTP mode is configured but unavailable until the HTTP receiver is installed",
331
- );
332
- return null;
333
- }
334
-
335
338
  const botToken = process.env.SLACK_BOT_TOKEN as string;
336
- const appToken = process.env.SLACK_APP_TOKEN as string;
337
339
 
338
- const socketModeBlockReason = getSlackSocketModeBlockReason(process.env);
339
- if (socketModeBlockReason) {
340
- console.error(
341
- `[Slack] SOCKET MODE BLOCKED: ${socketModeBlockReason}. Set ${SLACK_DEV_SOCKET_MODE_OPT_IN}=true to opt in explicitly.`,
342
- );
343
- return null;
340
+ if (config.mode === "socket") {
341
+ const socketModeBlockReason = getSlackSocketModeBlockReason(process.env);
342
+ if (socketModeBlockReason) {
343
+ console.error(
344
+ `[Slack] SOCKET MODE BLOCKED: ${socketModeBlockReason}. Set ${SLACK_DEV_SOCKET_MODE_OPT_IN}=true to opt in explicitly.`,
345
+ );
346
+ return null;
347
+ }
344
348
  }
345
349
 
346
350
  // Every client Bolt builds from here on scrubs outbound text and refuses
@@ -352,29 +356,49 @@ export async function initSlackApp(): Promise<App | null> {
352
356
  const slackApiUrl = process.env.SLACK_API_URL;
353
357
  const clientOptions = slackApiUrl ? { slackApiUrl } : undefined;
354
358
  const logLevel = getNodeEnv() === "development" ? LogLevel.DEBUG : LogLevel.INFO;
355
- // Build the receiver ourselves so its SocketModeClient lifecycle events can
356
- // feed /status. Bolt would otherwise forward clientOptions via installerOptions.
357
- receiver = new SocketModeReceiver({
358
- appToken,
359
- logLevel,
360
- installerOptions: clientOptions ? { clientOptions } : {},
361
- });
362
- trackConnectionState(receiver);
363
- socketFence = fenceSocketModeClient(receiver.client);
364
- app = new App({
365
- token: botToken,
366
- receiver,
367
- socketMode: true,
368
- logLevel,
369
- // Bolt's auth.test runs in startSlackApp(), where a failure is retried
370
- // instead of being cached as a rejected promise for the app's lifetime.
371
- deferInitialization: true,
372
- ...(clientOptions ? { clientOptions } : {}),
373
- });
359
+ if (config.mode === "http") {
360
+ // HTTP ingress only: no SocketModeReceiver, no SLACK_APP_TOKEN read, no
361
+ // watchdog or fence. The route hands events to the receiver, which stores
362
+ // them as receipts for the same durable drain Socket Mode uses.
363
+ httpReceiver = new SwarmHttpReceiver(() => void inboundDrain?.wake());
364
+ app = new App({
365
+ token: botToken,
366
+ receiver: httpReceiver,
367
+ logLevel,
368
+ // Bolt's own ignoreSelf runs before our outcome middleware and ends a
369
+ // bot-authored event without dispatching it, which the durable drain
370
+ // reads as a failure. It is re-added below, after the outcome middleware.
371
+ ignoreSelf: false,
372
+ deferInitialization: true,
373
+ ...(clientOptions ? { clientOptions } : {}),
374
+ });
375
+ inboundDrain = createBoltInboundDrain(app);
376
+ } else {
377
+ const appToken = process.env.SLACK_APP_TOKEN as string;
378
+ // Build the receiver ourselves so its SocketModeClient lifecycle events can
379
+ // feed /status. Bolt would otherwise forward clientOptions via installerOptions.
380
+ receiver = new SocketModeReceiver({
381
+ appToken,
382
+ logLevel,
383
+ installerOptions: clientOptions ? { clientOptions } : {},
384
+ });
385
+ trackConnectionState(receiver);
386
+ socketFence = fenceSocketModeClient(receiver.client);
387
+ app = new App({
388
+ token: botToken,
389
+ receiver,
390
+ socketMode: true,
391
+ logLevel,
392
+ // Bolt's auth.test runs in startSlackApp(), where a failure is retried
393
+ // instead of being cached as a rejected promise for the app's lifetime.
394
+ deferInitialization: true,
395
+ ...(clientOptions ? { clientOptions } : {}),
396
+ });
374
397
 
375
- // Events whose Socket Mode ack failed are stored as receipts; the drain hands
376
- // them back to Bolt, so a crash or a failing listener leaves recoverable work.
377
- inboundDrain = installSocketAckRecovery(receiver.client, app);
398
+ // Events whose Socket Mode ack failed are stored as receipts; the drain hands
399
+ // them back to Bolt, so a crash or a failing listener leaves recoverable work.
400
+ inboundDrain = installSocketAckRecovery(receiver.client, app);
401
+ }
378
402
 
379
403
  // This swarm's installation. Installed last, the gate runs before the ack
380
404
  // recovery wrapper and Bolt: a delivery for any other installation sharing
@@ -382,14 +406,16 @@ export async function initSlackApp(): Promise<App | null> {
382
406
  const authClient = app.client;
383
407
  const enterpriseInstall = isSlackEnterpriseInstall();
384
408
  setSlackWorkspaceIdentitySource(() => resolveSlackIdentity(authClient, enterpriseInstall));
385
- installSocketWorkspaceGate(receiver.client);
409
+ // HTTP mode gates in the route instead, before the ack.
410
+ if (receiver) installSocketWorkspaceGate(receiver.client);
386
411
 
387
412
  // Failed validation must remain retryable without requiring stopSlackApp().
388
413
  initialized = true;
389
414
 
390
415
  // First global middleware: every handler below runs inside it, so each
391
416
  // delivery resolves to an explicit processed/ignored/failed/uncertain outcome.
392
- app.use(slackInboundOutcomeMiddleware());
417
+ app.use(slackInboundOutcomeMiddleware(config.mode === "http" ? "http" : "socket"));
418
+ if (config.mode === "http") app.use(ignoreSelfAsIgnored);
393
419
 
394
420
  // Register handlers
395
421
  const { registerMessageHandler } = await import("./handlers");
@@ -435,13 +461,14 @@ export async function startSlackApp(): Promise<boolean> {
435
461
  const delay = scheduleStartRetry();
436
462
  setSlackConnectionState("disconnected");
437
463
  console.error(
438
- `[Slack] Socket Mode not started: this swarm's workspace is unknown. Retrying in ${seconds(delay)}s`,
464
+ `[Slack] ${httpReceiver ? "HTTP receiver" : "Socket Mode"} not started: this swarm's workspace is unknown. Retrying in ${seconds(delay)}s`,
439
465
  );
440
466
  return false;
441
467
  }
442
468
  startRetryAttempt = 0;
443
469
  // Arm before app.start(): a start that throws is retried by the watchdog.
444
- startSocketWatchdog();
470
+ // HTTP mode has no socket to watch.
471
+ if (!httpReceiver) startSocketWatchdog();
445
472
  // Establish the durable cutoff before Socket Mode can deliver new asks.
446
473
  const { isSlackRenderV2Enabled } = await import("./render-v2");
447
474
  if (isSlackRenderV2Enabled()) await ensureSlackRenderV2Activation();
@@ -449,10 +476,23 @@ export async function startSlackApp(): Promise<boolean> {
449
476
  // pending ones are processed once the app can dispatch them.
450
477
  await recoverSlackInboundAfterRestart();
451
478
  if (generation !== lifecycleGeneration) return false;
479
+ // After recovery: a live delivery must not be swept up as interrupted.
480
+ httpReceiver?.markReady();
452
481
  await current.start();
453
482
  // Abandoned while it waited: the app was already detached and retired.
454
483
  if (generation !== lifecycleGeneration) return false;
455
- console.log("[Slack] Bot connected via Socket Mode");
484
+ if (httpReceiver) {
485
+ // auth.test passed in verifySlackIdentity(): the receiver can take deliveries.
486
+ setSlackConnectionState("connected");
487
+ console.log("[Slack] Bot ready via HTTP receiver");
488
+ } else {
489
+ console.log("[Slack] Bot connected via Socket Mode");
490
+ }
491
+ // Thread replies buffered before the last restart flush as usual, in either mode.
492
+ const { restoreBufferedSlackMessages } = await import("./thread-buffer");
493
+ await restoreBufferedSlackMessages().catch((error) => {
494
+ console.error("[Slack] Failed to restore buffered thread messages:", error);
495
+ });
456
496
  void inboundDrain?.wake();
457
497
  await emitBuiltInIntegrationConnectedOnce("slack");
458
498
  // Abandoned or stopped while telemetry was pending: a watcher started now
@@ -587,6 +627,7 @@ function detachSlackApp(): App | null {
587
627
  const detached = app;
588
628
  app = null;
589
629
  receiver = null;
630
+ httpReceiver = null;
590
631
  setSlackWorkspaceIdentitySource(null);
591
632
  lastSocketActivityAt = null;
592
633
  setSlackConnectionState("disconnected");