@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
@@ -62,12 +62,22 @@ export function createAssistant(
62
62
  ): Assistant {
63
63
  return new Assistant({
64
64
  ...(options.threadContextStore ? { threadContextStore: options.threadContextStore } : {}),
65
- threadStarted: async ({ event, body, client, say, setSuggestedPrompts, saveThreadContext }) => {
65
+ threadStarted: async ({
66
+ event,
67
+ body,
68
+ context,
69
+ client,
70
+ say,
71
+ setSuggestedPrompts,
72
+ saveThreadContext,
73
+ }) => {
66
74
  // The greeting is not idempotent: a redelivery after a tolerated socket ack
67
75
  // failure must not post it twice.
68
76
  const eventId = body?.event_id;
69
77
  if (!isAdmittedSlackDelivery() && wasEventSeen(eventId)) {
70
- console.log(`[Slack] dropping Slack retry: event_id=${eventId}`);
78
+ console.log(
79
+ `[Slack] dropping Slack retry: event_id=${eventId ?? "unknown"} channel=${event.assistant_thread.channel_id ?? "unknown"} ts=${event.event_ts ?? "unknown"} thread_ts=${event.assistant_thread.thread_ts ?? "unknown"} retry_num=${context?.retryNum ?? "unknown"} retry_reason=${context?.retryReason ?? "unknown"}`,
80
+ );
71
81
  return ignoreSlackInbound("duplicate_event");
72
82
  }
73
83
  if (await isExternalAssistantThread(client, event.assistant_thread.channel_id, body)) {
@@ -95,11 +105,13 @@ export function createAssistant(
95
105
  }
96
106
  },
97
107
 
98
- threadContextChanged: async ({ event, body, client, saveThreadContext }) => {
108
+ threadContextChanged: async ({ event, body, context, client, saveThreadContext }) => {
99
109
  // Saves are order-dependent: a stale redelivery would overwrite newer context.
100
110
  const eventId = body?.event_id;
101
111
  if (!isAdmittedSlackDelivery() && wasEventSeen(eventId)) {
102
- console.log(`[Slack] dropping Slack retry: event_id=${eventId}`);
112
+ console.log(
113
+ `[Slack] dropping Slack retry: event_id=${eventId ?? "unknown"} channel=${event.assistant_thread.channel_id ?? "unknown"} ts=${event.event_ts ?? "unknown"} thread_ts=${event.assistant_thread.thread_ts ?? "unknown"} retry_num=${context?.retryNum ?? "unknown"} retry_reason=${context?.retryReason ?? "unknown"}`,
114
+ );
103
115
  return ignoreSlackInbound("duplicate_event");
104
116
  }
105
117
  if (await isExternalAssistantThread(client, event.assistant_thread.channel_id, body)) {
@@ -108,13 +120,27 @@ export function createAssistant(
108
120
  await saveThreadContext();
109
121
  },
110
122
 
111
- userMessage: async ({ message, body, say, setStatus, setTitle, getThreadContext, client }) => {
123
+ userMessage: async ({
124
+ message,
125
+ body,
126
+ context,
127
+ say,
128
+ setStatus,
129
+ setTitle,
130
+ getThreadContext,
131
+ client,
132
+ }) => {
133
+ console.log(
134
+ `[Slack] assistant message channel=${message.channel ?? "unknown"} ts=${message.ts ?? "unknown"} thread=${("thread_ts" in message ? message.thread_ts : undefined) ?? "unknown"} event_id=${body?.event_id ?? "unknown"}`,
135
+ );
112
136
  // Slack retries deliveries on 3s timeout / 5xx. Drop duplicates before
113
137
  // any task-creation work runs (DES-293). A delivery admitted from a
114
138
  // durable receipt was already deduplicated by its unique key.
115
139
  const eventId = body?.event_id;
116
140
  if (!isAdmittedSlackDelivery() && wasEventSeen(eventId)) {
117
- console.log(`[Slack] dropping Slack retry: event_id=${eventId}`);
141
+ console.log(
142
+ `[Slack] dropping Slack retry: event_id=${eventId ?? "unknown"} channel=${message.channel ?? "unknown"} ts=${message.ts ?? "unknown"} thread_ts=${("thread_ts" in message ? message.thread_ts : undefined) ?? "unknown"} retry_num=${context?.retryNum ?? "unknown"} retry_reason=${context?.retryReason ?? "unknown"}`,
143
+ );
118
144
  return ignoreSlackInbound("duplicate_event");
119
145
  }
120
146
 
@@ -240,7 +266,7 @@ export function createAssistant(
240
266
  // Follow-up message → buffer text and file metadata until the flush.
241
267
  if (workingAgent && workingAgent.status !== "offline" && isAdditiveSlack()) {
242
268
  noteSlackInboundSideEffect("thread_buffer");
243
- bufferThreadMessage(
269
+ await bufferThreadMessage(
244
270
  channelId,
245
271
  threadTs,
246
272
  messageText,
@@ -373,13 +373,15 @@ function checkRateLimit(userId: string): boolean {
373
373
 
374
374
  export function registerMessageHandler(app: App): void {
375
375
  // Handle all message events
376
- app.event("message", async ({ event, body, client, say }) => {
376
+ app.event("message", async ({ event, body, context, client, say }) => {
377
377
  // Slack retries deliveries on 3s timeout / 5xx. Drop the duplicates
378
378
  // before any task-creation work runs (DES-293). A delivery admitted from a
379
379
  // durable receipt was already deduplicated by its unique key.
380
380
  const eventId = body?.event_id;
381
381
  if (!isAdmittedSlackDelivery() && wasEventSeen(eventId)) {
382
- console.log(`[Slack] dropping Slack retry: event_id=${eventId}`);
382
+ console.log(
383
+ `[Slack] dropping Slack retry: event_id=${eventId ?? "unknown"} channel=${event.channel ?? "unknown"} ts=${event.ts ?? "unknown"} thread_ts=${("thread_ts" in event ? event.thread_ts : undefined) ?? "unknown"} retry_num=${context?.retryNum ?? "unknown"} retry_reason=${context?.retryReason ?? "unknown"}`,
384
+ );
383
385
  return ignoreSlackInbound("duplicate_event");
384
386
  }
385
387
 
@@ -563,7 +565,7 @@ export function registerMessageHandler(app: App): void {
563
565
 
564
566
  noteSlackInboundSideEffect("thread_flush");
565
567
  if (nowMessage || hasFiles) {
566
- bufferThreadMessage(
568
+ await bufferThreadMessage(
567
569
  msg.channel,
568
570
  msg.thread_ts,
569
571
  nowMessage,
@@ -607,7 +609,7 @@ export function registerMessageHandler(app: App): void {
607
609
  if (hasSwarmActivity) {
608
610
  const threadKey = `${msg.channel}:${msg.thread_ts}`;
609
611
  noteSlackInboundSideEffect("thread_buffer");
610
- bufferThreadMessage(
612
+ await bufferThreadMessage(
611
613
  msg.channel,
612
614
  msg.thread_ts,
613
615
  messageText,
@@ -0,0 +1,284 @@
1
+ import type { AckFn, App, Receiver } from "@slack/bolt";
2
+ import { verifySlackRequest } from "@slack/bolt";
3
+ import { scrubSecrets } from "../utils/secret-scrubber";
4
+ import {
5
+ admitSlackInbound,
6
+ recordSlackEventRanInline,
7
+ recordSlackInboundWithheld,
8
+ } from "./inbound-dispatch";
9
+ import { isOrderDependentEvent } from "./socket-ack";
10
+ import { checkInboundWorkspace, getCachedSlackWorkspaceIdentity } from "./workspace-guard";
11
+
12
+ /** Slack's own replay window; applied in both directions. */
13
+ const MAX_TIMESTAMP_SKEW_SEC = 5 * 60;
14
+ /** Slack gives a command or interactive payload 3s to ack. Answer before it does. */
15
+ export const SLACK_HTTP_ACK_TIMEOUT_MS = 2_500;
16
+ const RETRY_AFTER_SEC = "5";
17
+
18
+ export interface SlackHttpInput {
19
+ rawBody: Buffer;
20
+ signature: string | undefined;
21
+ timestamp: string | undefined;
22
+ contentType: string | undefined;
23
+ retryNum: string | undefined;
24
+ retryReason: string | undefined;
25
+ signingSecret: string;
26
+ }
27
+
28
+ export interface SlackHttpResult {
29
+ status: number;
30
+ body?: string;
31
+ contentType?: string;
32
+ headers?: Record<string, string>;
33
+ }
34
+
35
+ const EMPTY_OK: SlackHttpResult = { status: 200 };
36
+
37
+ function jsonResult(
38
+ status: number,
39
+ body: unknown,
40
+ headers?: Record<string, string>,
41
+ ): SlackHttpResult {
42
+ return { status, body: JSON.stringify(body), contentType: "application/json", headers };
43
+ }
44
+
45
+ /** Error bodies carry a stable code only: never the payload, the secret or the verifier's message. */
46
+ function refuse(status: number, error: string, headers?: Record<string, string>): SlackHttpResult {
47
+ return jsonResult(status, { error }, headers);
48
+ }
49
+
50
+ type ParsedBody =
51
+ | { kind: "json"; body: Record<string, unknown> }
52
+ | { kind: "live"; body: Record<string, unknown> }
53
+ | { kind: "ssl_check" };
54
+
55
+ /** JSON is the Events API; a form is a slash command (`command`) or interactivity (`payload`). */
56
+ function parseSlackBody(text: string, contentType: string | undefined): ParsedBody | null {
57
+ const type = (contentType ?? "").split(";")[0]?.trim().toLowerCase();
58
+ try {
59
+ if (type === "application/json") {
60
+ const body: unknown = JSON.parse(text);
61
+ return body && typeof body === "object" && !Array.isArray(body)
62
+ ? { kind: "json", body: body as Record<string, unknown> }
63
+ : null;
64
+ }
65
+ if (type === "application/x-www-form-urlencoded") {
66
+ const form = new URLSearchParams(text);
67
+ if (form.has("ssl_check")) return { kind: "ssl_check" };
68
+ const payload = form.get("payload");
69
+ if (payload !== null) {
70
+ const body: unknown = JSON.parse(payload);
71
+ return body && typeof body === "object" && !Array.isArray(body)
72
+ ? { kind: "live", body: body as Record<string, unknown> }
73
+ : null;
74
+ }
75
+ if (form.has("command")) return { kind: "live", body: Object.fromEntries(form) };
76
+ }
77
+ } catch {
78
+ // Malformed after a valid signature: a 400, not an error to log.
79
+ }
80
+ return null;
81
+ }
82
+
83
+ function parseRetryNum(value: string | undefined): number | null {
84
+ if (!value || !/^\d{1,3}$/.test(value)) return null;
85
+ return Number(value);
86
+ }
87
+
88
+ /** Bolt's ack argument as an HTTP response: empty, text, or JSON. */
89
+ function ackResult(response: unknown): SlackHttpResult {
90
+ if (response === undefined || response === null || response === "") return EMPTY_OK;
91
+ if (typeof response === "string") {
92
+ return { status: 200, body: response, contentType: "text/plain; charset=utf-8" };
93
+ }
94
+ return jsonResult(200, response);
95
+ }
96
+
97
+ /**
98
+ * Bolt `Receiver` for `SLACK_MODE=http`. It owns no port or server: the API
99
+ * route `POST /api/integrations/slack/events` calls `handle()`, and Bolt stays
100
+ * the dispatcher through `app.processEvent`, as in Socket Mode.
101
+ *
102
+ * Gate order, each before any work: valid headers and a fresh timestamp, HMAC v0
103
+ * over the raw bytes, a parseable body, then (for everything but
104
+ * `url_verification`) a resolved and matching workspace identity.
105
+ *
106
+ * Events are stored as durable receipts before the 200, so the ack is a DB
107
+ * insert and a Slack retry (same `event_id`) never creates a second task, also
108
+ * across a restart. Commands and interactivity run live and ack from their
109
+ * handler, as in Socket Mode: Slack never retries them.
110
+ */
111
+ export class SwarmHttpReceiver implements Receiver {
112
+ private app: App | null = null;
113
+ private ready = false;
114
+
115
+ /** `onAdmitted` starts the durable drain after an event was stored. */
116
+ constructor(private readonly onAdmitted: () => void) {}
117
+
118
+ init(app: App): void {
119
+ this.app = app;
120
+ }
121
+
122
+ /** Open for deliveries: this swarm's identity is known and Bolt is initialized. */
123
+ markReady(): void {
124
+ this.ready = true;
125
+ }
126
+
127
+ async start(): Promise<void> {}
128
+
129
+ async stop(): Promise<void> {}
130
+
131
+ async handle(input: SlackHttpInput, now: number = Date.now()): Promise<SlackHttpResult> {
132
+ if (!input.signature || !input.timestamp || !/^\d{1,12}$/.test(input.timestamp)) {
133
+ return refuse(401, "invalid_signature");
134
+ }
135
+ const timestampSec = Number(input.timestamp);
136
+ if (Math.abs(now / 1000 - timestampSec) > MAX_TIMESTAMP_SKEW_SEC) {
137
+ return refuse(401, "invalid_signature");
138
+ }
139
+ const text = input.rawBody.toString("utf8");
140
+ try {
141
+ verifySlackRequest({
142
+ signingSecret: input.signingSecret,
143
+ body: text,
144
+ headers: {
145
+ "x-slack-signature": input.signature,
146
+ "x-slack-request-timestamp": timestampSec,
147
+ },
148
+ nowMilliseconds: now,
149
+ });
150
+ } catch {
151
+ return refuse(401, "invalid_signature");
152
+ }
153
+
154
+ const parsed = parseSlackBody(text, input.contentType);
155
+ if (!parsed) return refuse(400, "malformed_body");
156
+ if (parsed.kind === "ssl_check") return EMPTY_OK;
157
+
158
+ const { body } = parsed;
159
+ // Slack sends this when the operator saves the URL, before any identity exists.
160
+ if (parsed.kind === "json" && body.type === "url_verification") {
161
+ return typeof body.challenge === "string"
162
+ ? jsonResult(200, { challenge: body.challenge })
163
+ : refuse(400, "malformed_body");
164
+ }
165
+ // Control envelopes such as app_rate_limited carry no work.
166
+ if (parsed.kind === "json" && body.type !== "event_callback") return EMPTY_OK;
167
+
168
+ const identity = getCachedSlackWorkspaceIdentity();
169
+ const app = this.app;
170
+ if (!identity || !app || !this.ready) {
171
+ return refuse(503, "workspace_unverified", { "Retry-After": RETRY_AFTER_SEC });
172
+ }
173
+ const ownership = checkInboundWorkspace(body, identity);
174
+ if (!ownership.own) {
175
+ recordSlackInboundWithheld("http", ownership.reason);
176
+ return refuse(403, "foreign_workspace");
177
+ }
178
+
179
+ const retryNum = parseRetryNum(input.retryNum);
180
+ const retryReason = input.retryReason?.slice(0, 128) || null;
181
+ if (parsed.kind === "live") return this.runLive(app, body, retryNum, retryReason);
182
+ return this.admitEvent(app, text, body, retryNum, retryReason);
183
+ }
184
+
185
+ private async admitEvent(
186
+ app: App,
187
+ rawBody: string,
188
+ body: Record<string, unknown>,
189
+ retryNum: number | null,
190
+ retryReason: string | null,
191
+ ): Promise<SlackHttpResult> {
192
+ try {
193
+ if (isOrderDependentEvent(body)) {
194
+ // Last write wins, so it never waits in the queue: run it now and keep
195
+ // only its dedup key. A store failure costs the restart protection, not the event.
196
+ const stored = await recordSlackEventRanInline("http", body, {
197
+ retryNum,
198
+ retryReason,
199
+ }).catch(() => "invalid" as const);
200
+ if (stored !== "duplicate") {
201
+ void app
202
+ .processEvent({
203
+ body,
204
+ ack: async () => {},
205
+ retryNum: retryNum ?? undefined,
206
+ retryReason: retryReason ?? undefined,
207
+ })
208
+ .catch((error: unknown) => logDispatchError(error));
209
+ }
210
+ return EMPTY_OK;
211
+ }
212
+ const result = await admitSlackInbound({
213
+ transport: "http",
214
+ kind: "event",
215
+ rawBody,
216
+ body,
217
+ retryNum,
218
+ retryReason,
219
+ });
220
+ switch (result.status) {
221
+ case "admitted":
222
+ this.onAdmitted();
223
+ return EMPTY_OK;
224
+ case "duplicate":
225
+ return EMPTY_OK;
226
+ case "invalid":
227
+ return refuse(400, result.reason);
228
+ case "rejected":
229
+ return result.reason === "payload_too_large"
230
+ ? refuse(413, "payload_too_large")
231
+ : refuse(503, "backlog_full", { "Retry-After": RETRY_AFTER_SEC });
232
+ }
233
+ } catch (error) {
234
+ // Not stored, so not acked: Slack retries the event.
235
+ console.error(`[Slack] HTTP event could not be stored: ${scrubSecrets(String(error))}`);
236
+ return refuse(503, "store_unavailable", { "Retry-After": RETRY_AFTER_SEC });
237
+ }
238
+ }
239
+
240
+ /**
241
+ * Run a command or interactive payload through Bolt and answer with what its
242
+ * handler acks. A handler that does not ack in time gets an empty 200 (Slack
243
+ * would otherwise show the user a timeout); the handler keeps running.
244
+ */
245
+ private runLive(
246
+ app: App,
247
+ body: Record<string, unknown>,
248
+ retryNum: number | null,
249
+ retryReason: string | null,
250
+ ): Promise<SlackHttpResult> {
251
+ return new Promise<SlackHttpResult>((resolve) => {
252
+ const timer = setTimeout(() => {
253
+ console.warn("[Slack] HTTP handler did not ack in time; answered an empty 200");
254
+ resolve(EMPTY_OK);
255
+ }, SLACK_HTTP_ACK_TIMEOUT_MS);
256
+ const ack: AckFn<unknown> = async (response) => {
257
+ clearTimeout(timer);
258
+ resolve(ackResult(response));
259
+ };
260
+ app
261
+ .processEvent({
262
+ body,
263
+ ack,
264
+ retryNum: retryNum ?? undefined,
265
+ retryReason: retryReason ?? undefined,
266
+ })
267
+ .then(() => {
268
+ // Settled with no ack (no listener matched): do not hold the request.
269
+ clearTimeout(timer);
270
+ resolve(EMPTY_OK);
271
+ })
272
+ .catch((error: unknown) => {
273
+ clearTimeout(timer);
274
+ logDispatchError(error);
275
+ resolve(refuse(500, "handler_failed"));
276
+ });
277
+ });
278
+ }
279
+ }
280
+
281
+ function logDispatchError(error: unknown): void {
282
+ const message = error instanceof Error ? error.message : String(error);
283
+ console.error(`[Slack] HTTP dispatch failed: ${scrubSecrets(message)}`);
284
+ }
@@ -1,6 +1,6 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import { createHash } from "node:crypto";
3
- import type { AnyMiddlewareArgs, Middleware } from "@slack/bolt";
3
+ import { type AnyMiddlewareArgs, ignoreSelf, type Middleware } from "@slack/bolt";
4
4
  import { decryptSecret, encryptSecret, getEncryptionKey } from "../be/crypto";
5
5
  import {
6
6
  admitSlackInboundReceipt,
@@ -165,6 +165,11 @@ function recordOutcome(transport: SlackInboundTransport, outcome: SlackInboundOu
165
165
  }
166
166
  }
167
167
 
168
+ /** Count a delivery that was refused before Bolt saw it (HTTP ingress gates). */
169
+ export function recordSlackInboundWithheld(transport: SlackInboundTransport, code: string): void {
170
+ recordOutcome(transport, { state: "ignored", code });
171
+ }
172
+
168
173
  /** Count a Socket Mode ack that failed because the client was not ready. */
169
174
  export function recordSlackSocketAckNotReady(): void {
170
175
  counters.socket.ackNotReady += 1;
@@ -182,7 +187,9 @@ export function resetSlackInboundCountersForTests(): void {
182
187
  * which Bolt routes to its error handler after this middleware, are observed
183
188
  * here and rethrown unchanged.
184
189
  */
185
- export function slackInboundOutcomeMiddleware(): Middleware<AnyMiddlewareArgs> {
190
+ export function slackInboundOutcomeMiddleware(
191
+ transport: SlackInboundTransport = "socket",
192
+ ): Middleware<AnyMiddlewareArgs> {
186
193
  return async ({ next, body }) => {
187
194
  // The socket gate withholds deliveries that are not ours before Bolt acks
188
195
  // them. This check covers what reaches Bolt another way (receipt replay)
@@ -210,25 +217,44 @@ export function slackInboundOutcomeMiddleware(): Middleware<AnyMiddlewareArgs> {
210
217
  return;
211
218
  }
212
219
 
213
- const state = newDeliveryState("socket", false);
220
+ const state = newDeliveryState(transport, false);
214
221
  state.dispatched = true;
215
222
  if (!ownership.own) {
216
223
  state.ignoredReasons.push(ownership.reason);
217
- recordOutcome("socket", resolveSlackInboundOutcome(state));
224
+ recordOutcome(transport, resolveSlackInboundOutcome(state));
218
225
  return;
219
226
  }
220
227
  await deliveryStorage.run(state, async () => {
221
228
  try {
222
229
  await next();
223
230
  } catch (error) {
224
- recordOutcome("socket", resolveSlackInboundOutcome(state, error));
231
+ recordOutcome(transport, resolveSlackInboundOutcome(state, error));
225
232
  throw error;
226
233
  }
227
- recordOutcome("socket", resolveSlackInboundOutcome(state));
234
+ recordOutcome(transport, resolveSlackInboundOutcome(state));
228
235
  });
229
236
  };
230
237
  }
231
238
 
239
+ /**
240
+ * Bolt's `ignoreSelf` that records what it drops. Installed after
241
+ * `slackInboundOutcomeMiddleware` (with the App's own `ignoreSelf` off), so a
242
+ * bot-authored event is an `ignored` delivery. Left to Bolt, it would end
243
+ * before this module's middleware and read as "never dispatched", which the
244
+ * durable drain retries as a failure.
245
+ */
246
+ export const ignoreSelfAsIgnored: Middleware<AnyMiddlewareArgs> = async (args) => {
247
+ let passed = false;
248
+ await ignoreSelf({
249
+ ...args,
250
+ next: async () => {
251
+ passed = true;
252
+ await args.next();
253
+ },
254
+ });
255
+ if (!passed) ignoreSlackInbound("self_event");
256
+ };
257
+
232
258
  /**
233
259
  * Run `fn` as an admitted durable delivery and resolve its outcome. Never
234
260
  * throws: a thrown error becomes a `failed` or `uncertain` outcome.
@@ -347,13 +373,23 @@ export async function recordSlackSocketEventRanInline(
347
373
  body: unknown,
348
374
  retry: { retryNum?: number | null; retryReason?: string | null } = {},
349
375
  now: Date = new Date(),
376
+ ): Promise<"recorded" | "duplicate" | "invalid"> {
377
+ return recordSlackEventRanInline("socket", body, retry, now);
378
+ }
379
+
380
+ /** `recordSlackSocketEventRanInline` for any transport (the HTTP receiver's order-dependent events). */
381
+ export async function recordSlackEventRanInline(
382
+ transport: SlackInboundTransport,
383
+ body: unknown,
384
+ retry: { retryNum?: number | null; retryReason?: string | null } = {},
385
+ now: Date = new Date(),
350
386
  ): Promise<"recorded" | "duplicate" | "invalid"> {
351
387
  const key = socketEventKey(body);
352
388
  if (!key) return "invalid";
353
389
  return recordSlackInboundInline(
354
390
  {
355
391
  dedupKey: key.dedupKey,
356
- transport: "socket",
392
+ transport,
357
393
  kind: "event",
358
394
  payloadType: key.payloadType,
359
395
  apiAppId: key.apiAppId,
@@ -21,12 +21,16 @@ import { tmpdir } from "node:os";
21
21
  import { join } from "node:path";
22
22
  import type { WebClient } from "@slack/web-api";
23
23
  import { getTaskAttachments, getTaskById, promoteDraftTask, refreshDraftTaskLease } from "../be/db";
24
+ import { createSlackTaskCarryingMessages } from "../be/db/tasks/slack-fold";
24
25
  import { MAX_TASK_ATTACHMENT_BYTES, recordTaskAttachmentUpload } from "../be/task-attachment-store";
25
26
  import type { TaskCreateEvent } from "../extensions/contract";
26
27
  import { providerPath } from "../fs/provider";
27
28
  import { getFileStorageProvider } from "../fs/registry";
28
29
  import { resolveTemplate } from "../prompts/resolver";
29
- import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
30
+ import {
31
+ createTaskWithSiblingAwareness,
32
+ prepareTaskWithSiblingAwareness,
33
+ } from "../tasks/sibling-awareness";
30
34
  import type { AgentTask, CreateTaskOptions, TaskAttachment } from "../types";
31
35
  import { scrubSecrets } from "../utils/secret-scrubber";
32
36
  import { taskAttachmentFetchCommand } from "../utils/task-attachment-links";
@@ -315,43 +319,58 @@ async function downloadSlackFile(
315
319
  * has settled — success or not — so a worker can't start before its
316
320
  * attachments exist. `unattached` lists every file of the message that the
317
321
  * task ended up without: the ones that couldn't be downloaded plus the ones
318
- * that couldn't be stored.
322
+ * that couldn't be stored. `carriedMessageTs` names the messages besides the
323
+ * trigger that the task carries (a buffered burst); they commit with the task.
319
324
  */
320
325
  export async function createSlackTaskWithFiles(
321
326
  description: string,
322
327
  options: CreateTaskOptions,
323
328
  inbound: InboundSlackFiles,
324
329
  slack?: TaskCreateEvent["slack"],
330
+ carriedMessageTs: readonly string[] = [],
325
331
  ): Promise<{ task: AgentTask; unattached: SlackFileFailure[] }> {
326
332
  noteSlackInboundSideEffect("task_created");
327
333
  const context = { origin: "slack" as const, slack };
334
+ const create = async (createOptions: CreateTaskOptions) =>
335
+ carriedMessageTs.length === 0 || !createOptions.slackChannelId
336
+ ? await createTaskWithSiblingAwareness(description, createOptions, context)
337
+ : await createSlackTaskCarryingMessages(
338
+ await prepareTaskWithSiblingAwareness(description, createOptions, context),
339
+ { slackChannelId: createOptions.slackChannelId, messageTs: carriedMessageTs },
340
+ );
328
341
  if (inbound.fetched.length === 0) {
329
- const task = await createTaskWithSiblingAwareness(description, options, context);
342
+ const task = await create(options);
330
343
  return { task, unattached: inbound.failed };
331
344
  }
332
345
 
333
- const task = await createTaskWithSiblingAwareness(
334
- description,
335
- { ...options, status: "draft" },
336
- context,
337
- );
338
- const unattached = [...inbound.failed];
346
+ const task = await create({ ...options, status: "draft" });
347
+ const unattached = [...inbound.failed, ...(await attachSlackFilesToDraft(task.id, inbound))];
348
+ return { task, unattached };
349
+ }
350
+
351
+ /**
352
+ * Attach a user's fetched Slack files to a task held in `draft`, then promote
353
+ * it, whatever the uploads did. Returns the files that could not be stored.
354
+ */
355
+ export async function attachSlackFilesToDraft(
356
+ taskId: string,
357
+ inbound: InboundSlackFiles,
358
+ ): Promise<SlackFileFailure[]> {
339
359
  // Uploads run one after another and can outlast the abandoned-draft sweep's
340
360
  // window; renewing the lease keeps the sweep from promoting a live batch.
341
361
  const lease = setInterval(() => {
342
- void refreshDraftTaskLease(task.id).catch((error) =>
362
+ void refreshDraftTaskLease(taskId).catch((error) =>
343
363
  console.warn(
344
- `[Slack] could not renew the draft lease of task ${task.id}: ${errorText(error)}`,
364
+ `[Slack] could not renew the draft lease of task ${taskId}: ${errorText(error)}`,
345
365
  ),
346
366
  );
347
367
  }, draftLeaseRefreshMs);
348
368
  try {
349
- unattached.push(...(await attachSlackFilesToTask(task.id, inbound.fetched, null)).unattached);
369
+ return (await attachSlackFilesToTask(taskId, inbound.fetched, null)).unattached;
350
370
  } finally {
351
371
  clearInterval(lease);
352
- await promoteDraftTask(task.id);
372
+ await promoteDraftTask(taskId);
353
373
  }
354
- return { task, unattached };
355
374
  }
356
375
 
357
376
  /** Tests shorten the draft lease renewal to observe it; returns the previous interval. */