@desplega.ai/agent-swarm 2.7.8 → 2.7.10

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 (380) hide show
  1. package/dist/acp-adapter-srfhs1s9.js +16 -0
  2. package/dist/{actions-4m1ct4nh.js → actions-b8aqhrsg.js} +20 -19
  3. package/dist/{amp-adapter-txqh7eqj.js → amp-adapter-4c165vgn.js} +3 -3
  4. package/dist/{anthropic-messages-xey2skwx.js → anthropic-messages-jkva0zps.js} +68 -78
  5. package/dist/app-m9khefrh.js +20 -0
  6. package/dist/{assistant-gd08kr9e.js → assistant-rh4v3ntz.js} +22 -21
  7. package/dist/{azure-openai-responses-26t7j9ra.js → azure-openai-responses-wgtqkbr3.js} +5 -10
  8. package/dist/{boot-args-schema-tjrkpbvm.js → boot-args-schema-hwkc8bzv.js} +1 -1
  9. package/dist/{boot-reembed-21hbck22.js → boot-reembed-5y6yw9sj.js} +1 -1
  10. package/dist/{boot-reembed-mdxd3wgp.js → boot-reembed-fdyk55h4.js} +1 -1
  11. package/dist/{boot-scrub-sweep-qy0zr9t2.js → boot-scrub-sweep-r5r8kqsn.js} +4 -4
  12. package/dist/{boot-seeds-n46eaxdv.js → boot-seeds-8f9zt5cm.js} +5 -4
  13. package/dist/{boxd-nv507va8.js → boxd-qbkxy6ap.js} +1 -1
  14. package/dist/{claude-adapter-j37w2eds.js → claude-adapter-s5df247c.js} +8 -8
  15. package/dist/{claude-managed-adapter-8jvcma9a.js → claude-managed-adapter-h74d06yz.js} +4 -4
  16. package/dist/{claude-managed-setup-rzkjmgc1.js → claude-managed-setup-9gsmwzyx.js} +4 -4
  17. package/dist/{claude-sdk-session-4k7w73t0.js → claude-sdk-session-dq1j4nz9.js} +7901 -7718
  18. package/dist/{cli-s4ss5g59.js → cli-0m7rtm11.js} +5 -5
  19. package/dist/{cli-fzachfnf.js → cli-16phend6.js} +5 -5
  20. package/dist/{cli-yqefz277.js → cli-18qt3few.js} +1 -1
  21. package/dist/{cli-snpj5zbj.js → cli-1z4qggfe.js} +9 -36
  22. package/dist/{cli-s0qnd4wv.js → cli-28fq781p.js} +1 -1
  23. package/dist/{cli-1p89xny0.js → cli-2r0jcc3k.js} +1 -1
  24. package/dist/{cli-66ww7fer.js → cli-2tsfpc70.js} +1 -1
  25. package/dist/{cli-rvtm68yy.js → cli-2xv18ywz.js} +2 -2
  26. package/dist/{cli-kyr67fgx.js → cli-36wdfzgn.js} +18608 -9089
  27. package/dist/{cli-t60ajbbp.js → cli-38yww4e9.js} +20 -20
  28. package/dist/{cli-5xaqj21p.js → cli-3kd08rej.js} +1 -1
  29. package/dist/{cli-ae7mrdf9.js → cli-3vjhs18n.js} +4 -6
  30. package/dist/{cli-ssnjfg5p.js → cli-3xcwp3z8.js} +8 -10
  31. package/dist/{cli-rjknb2ae.js → cli-3xddv0rk.js} +6 -6
  32. package/dist/{cli-az48n0nr.js → cli-4caa1x7d.js} +67 -64
  33. package/dist/cli-4vwxp550.js +9321 -0
  34. package/dist/{cli-pz4rk021.js → cli-54vrpgm0.js} +1 -1
  35. package/dist/{cli-gvx71kqv.js → cli-55bkx8hh.js} +3 -3
  36. package/dist/{cli-r9jqcehk.js → cli-5mpy301f.js} +38 -2
  37. package/dist/{cli-bb0mmdk8.js → cli-5wfz00be.js} +35 -12
  38. package/dist/{cli-btfsp3mv.js → cli-5xcb8gxq.js} +9 -11
  39. package/dist/{cli-4t50yq3j.js → cli-6m6b4bep.js} +29 -12
  40. package/dist/cli-6pzk82fd.js +778 -0
  41. package/dist/{cli-8sdejs1f.js → cli-7wz05bx3.js} +797 -255
  42. package/dist/{cli-mkk9rnzz.js → cli-8bpgbr8k.js} +54 -7
  43. package/dist/{cli-fyhr5h4s.js → cli-8ewkreqd.js} +17 -13
  44. package/dist/{cli-p3vsj0d3.js → cli-an1knn2k.js} +15 -10
  45. package/dist/{cli-0ykgn1h5.js → cli-bxz823sz.js} +2 -2
  46. package/dist/{cli-jdv6ypxs.js → cli-bzvs88tv.js} +2 -2
  47. package/dist/{cli-bshb7jas.js → cli-cr14kftt.js} +3 -3
  48. package/dist/{cli-njwac61j.js → cli-cyn9v8zr.js} +12 -2
  49. package/dist/{cli-a22h291q.js → cli-d6521kb5.js} +1 -1
  50. package/dist/{cli-1b7btd38.js → cli-d84byzn8.js} +869 -5
  51. package/dist/{cli-84rj785g.js → cli-eb2azq8n.js} +9 -9
  52. package/dist/{cli-1cxrbkk6.js → cli-ed6yqpf1.js} +7 -9
  53. package/dist/{cli-wx3rhnm0.js → cli-eddnyg3t.js} +1 -1
  54. package/dist/{cli-ga786dzg.js → cli-eqk5p56g.js} +18 -17
  55. package/dist/{cli-mthwvjre.js → cli-f2zenhja.js} +1 -1
  56. package/dist/{cli-ferkkrg9.js → cli-fjggej24.js} +2 -2
  57. package/dist/{cli-g7s47cc5.js → cli-fsgttth8.js} +123 -102
  58. package/dist/{cli-269q28a1.js → cli-g1px1g2e.js} +27 -6
  59. package/dist/{cli-sq4n7af4.js → cli-h49ejvmc.js} +4 -6
  60. package/dist/{cli-5j0m12ns.js → cli-hfkwwy1h.js} +51 -15
  61. package/dist/{cli-agfm16v9.js → cli-hg42n3hx.js} +12 -12
  62. package/dist/{cli-yndmfxb3.js → cli-hxpyc9sn.js} +3 -3
  63. package/dist/{cli-w4xnbm46.js → cli-j7d73g1y.js} +414 -145
  64. package/dist/{cli-gazw7kpa.js → cli-jg24scat.js} +8 -10
  65. package/dist/{cli-5ja3b75e.js → cli-jrp1dt73.js} +1 -1
  66. package/dist/{cli-98rw5dt5.js → cli-jrzkw01m.js} +2 -2
  67. package/dist/{cli-583frbyr.js → cli-kchjb7qy.js} +1 -1
  68. package/dist/{cli-xr8908my.js → cli-kx4c8j05.js} +32 -17
  69. package/dist/{cli-fmjd0t1y.js → cli-m0cy2vyf.js} +2 -2
  70. package/dist/{cli-c0kqky8y.js → cli-m5akxq8q.js} +1 -1
  71. package/dist/{cli-ycscb2ar.js → cli-m88rpzkh.js} +2 -2
  72. package/dist/{cli-ppjxh6ah.js → cli-mp9aa8g5.js} +10 -12
  73. package/dist/{cli-xq9r2wtt.js → cli-mr97t7cc.js} +679 -247
  74. package/dist/{cli-z75yxkjh.js → cli-n07eecjs.js} +3 -3
  75. package/dist/{cli-7cx2m6t2.js → cli-n515ex5z.js} +16 -16
  76. package/dist/{cli-fy6x31ps.js → cli-n5yexkdg.js} +1 -0
  77. package/dist/{cli-bbw9wj9m.js → cli-n9abj89w.js} +17 -16
  78. package/dist/{cli-ypff1qwp.js → cli-n9ftpys4.js} +7 -7
  79. package/dist/{cli-32m9eda8.js → cli-nj3x45rw.js} +111 -109
  80. package/dist/{cli-6vcp76qk.js → cli-p74md7t8.js} +42 -23
  81. package/dist/{cli-rjcbm574.js → cli-pr0eze3x.js} +2 -2
  82. package/dist/{cli-dq8x79v8.js → cli-pyrxt9gw.js} +198 -3
  83. package/dist/{cli-m0hmeqma.js → cli-q581b386.js} +5 -5
  84. package/dist/{cli-8rpcng8j.js → cli-rjyghzg4.js} +8 -10
  85. package/dist/cli-rkc97c6a.js +39 -0
  86. package/dist/{cli-msg9m2ny.js → cli-rt0ag4x1.js} +9 -11
  87. package/dist/{cli-qd57hhhh.js → cli-rvhdmjvt.js} +6 -10
  88. package/dist/{cli-318r69gq.js → cli-t73cas91.js} +440 -9
  89. package/dist/{cli-q4ebh7h7.js → cli-td33w98c.js} +6 -6
  90. package/dist/{cli-zkky4t5g.js → cli-tmft5dz2.js} +2 -2
  91. package/dist/{cli-q26b9wre.js → cli-tph5wt3y.js} +4 -4
  92. package/dist/{cli-3e4snnzf.js → cli-ttbqe3q4.js} +1 -1
  93. package/dist/{cli-wemma3jd.js → cli-v2fwbnsk.js} +7 -7
  94. package/dist/cli-w3bk0dgv.js +5266 -0
  95. package/dist/{cli-8h0ayw8c.js → cli-x9exydey.js} +6 -6
  96. package/dist/{cli-85gzce7b.js → cli-xbtq4d6s.js} +287 -75
  97. package/dist/{cli-eyg1pa00.js → cli-xd5ebp64.js} +7 -7
  98. package/dist/{cli-g83s9ewh.js → cli-xfjrc279.js} +1 -1
  99. package/dist/{cli-7axf41jq.js → cli-xncjscpm.js} +40 -42
  100. package/dist/{cli-9m8hdawy.js → cli-xvymtmv4.js} +4 -4
  101. package/dist/{cli-81p9jd57.js → cli-yab6sh8p.js} +9 -3
  102. package/dist/{cli-srye3vdt.js → cli-ybjdc978.js} +1 -1
  103. package/dist/{cli-z1srzaf6.js → cli-yz7v0sh4.js} +70 -5
  104. package/dist/{cli-nbsf8yvn.js → cli-z9cs5m0w.js} +9 -9
  105. package/dist/{cli-k5671be5.js → cli-zcfpsfzf.js} +5 -5
  106. package/dist/{cli-vf078p3e.js → cli-zfqg6fzn.js} +1 -1
  107. package/dist/{cli-tpksw2nr.js → cli-zjphdj1a.js} +461 -108
  108. package/dist/cli.js +32 -52
  109. package/dist/{cloudflare-workers-ai-system-one-ef2a980q.js → cloudflare-workers-ai-system-one-9y1zx3pt.js} +2 -2
  110. package/dist/{codex-adapter-88z6psm4.js → codex-adapter-yr60sme6.js} +7 -7
  111. package/dist/{codex-login-74wa4hmq.js → codex-login-bcda78ge.js} +2 -2
  112. package/dist/{codex-session-runner-zwbcwzvx.js → codex-session-runner-pch8x584.js} +8 -8
  113. package/dist/{commands-7amxs716.js → commands-phjfbkv0.js} +3 -3
  114. package/dist/{controller-5rkkc37m.js → controller-jkx994pz.js} +4 -4
  115. package/dist/{controllers-connect-m7d4vxxb.js → controllers-connect-c4448kwa.js} +25 -24
  116. package/dist/{cursor-adapter-x1q18693.js → cursor-adapter-ndebqnm8.js} +2 -2
  117. package/dist/{db-athc68zt.js → db-ef32tbfc.js} +6 -2
  118. package/dist/{db-h2fsfve3.js → db-ez6egt6v.js} +3 -3
  119. package/dist/{devin-adapter-r9phbnc9.js → devin-adapter-z46ep5ph.js} +1 -1
  120. package/dist/{dispatcher-b1yz2bnn.js → dispatcher-g3tt9hs9.js} +19 -18
  121. package/dist/{docker-c1a3gqmf.js → docker-866qpzt9.js} +2 -2
  122. package/dist/{dsh-adapter-e33bkxq9.js → dsh-adapter-tcyn3099.js} +2 -2
  123. package/dist/{e2b-fr12yccx.js → e2b-jkwfhbcv.js} +2 -2
  124. package/dist/{e2b-x6ywzak3.js → e2b-s16txnpx.js} +2 -3
  125. package/dist/{easter-egg-3d-pv5qnzc8.js → easter-egg-3d-e36hk5td.js} +1 -1
  126. package/dist/{embedding-space-b4txbwrk.js → embedding-space-4kyh5qqj.js} +6 -6
  127. package/dist/{embeddings-m6zn6tad.js → embeddings-6a8v4a6t.js} +1 -1
  128. package/dist/{event-bus-g0ka3pbw.js → event-bus-e66gh7cc.js} +1 -1
  129. package/dist/{execute-68nwny8m.js → execute-3cbg0twf.js} +1 -1
  130. package/dist/{external-channel-gkckmhzh.js → external-channel-se646snz.js} +2 -2
  131. package/dist/fx-adapter-yw795hqq.js +19 -0
  132. package/dist/{google-generative-ai-v94hr7h0.js → google-generative-ai-h7s3e9kk.js} +7 -12
  133. package/dist/{google-vertex-g7vr6cf8.js → google-vertex-fhxaafzw.js} +7 -12
  134. package/dist/grok-adapter-ttmcss2j.js +19 -0
  135. package/dist/handlers-17wha3ze.js +33 -0
  136. package/dist/heartbeat-gwewgdms.js +42 -0
  137. package/dist/{hook-q5fv0jy2.js → hook-g3nhexsy.js} +16 -11
  138. package/dist/{hook-w0q2wcrv.js → hook-hq93y5ej.js} +5 -5
  139. package/dist/{http-bxat8dg3.js → http-5a9p4h6y.js} +808 -285
  140. package/dist/{index-pxn30mse.js → index-0eny15vj.js} +8 -8
  141. package/dist/{index-6cxzwfen.js → index-0rvk3vd4.js} +71 -71
  142. package/dist/{index-fvzke5kx.js → index-1qw6f2dc.js} +10 -10
  143. package/dist/{index-cqhqpgrv.js → index-3c5pxbge.js} +1 -1
  144. package/dist/{index-k7fj52d3.js → index-6haqt3v5.js} +12302 -11048
  145. package/dist/index-8arwq8mw.js +34 -0
  146. package/dist/{index-h7f61sy9.js → index-e5pfbsys.js} +3 -3
  147. package/dist/{index-bxrexmfy.js → index-hgn3c961.js} +14 -13
  148. package/dist/{index-h39zbx67.js → index-m5gx1xd6.js} +68 -68
  149. package/dist/{index-5fx3b3kw.js → index-rvccek1w.js} +9 -9
  150. package/dist/{index-fm0czesf.js → index-s72rqgsx.js} +1 -1
  151. package/dist/index-tpw054az.js +38 -0
  152. package/dist/{index-514d9pf6.js → index-w7em4ktq.js} +8 -8
  153. package/dist/index-waq75j2j.js +31 -0
  154. package/dist/{keepalive-qnt21cv0.js → keepalive-1j4n4dmk.js} +4 -4
  155. package/dist/lead-re73kdgc.js +72 -0
  156. package/dist/{llama-cpp-classify-s5c47rwh.js → llama-cpp-classify-nfgswa1m.js} +2 -2
  157. package/dist/{maintenance-btdr68y4.js → maintenance-dmghacy5.js} +1 -1
  158. package/dist/{mistral-conversations-3gjpdb4b.js → mistral-conversations-a45tx39a.js} +29 -51
  159. package/dist/{oauth-refresh-sweep-vczabeh4.js → oauth-refresh-sweep-yy06c03c.js} +3 -3
  160. package/dist/{onboard-k33ezyq8.js → onboard-52f9t5dm.js} +68 -16
  161. package/dist/{openai-codex-responses-8pbxq9h5.js → openai-codex-responses-k9gapdze.js} +7 -11
  162. package/dist/{openai-completions-rm00s912.js → openai-completions-xd579js7.js} +50 -58
  163. package/dist/{openai-decisions-8v957r2r.js → openai-decisions-q3hh60wr.js} +2 -2
  164. package/dist/{openai-responses-agxpf96k.js → openai-responses-4d5dx3c7.js} +5 -10
  165. package/dist/{opencode-adapter-3dst2ka7.js → opencode-adapter-krnh9jkn.js} +6 -6
  166. package/dist/{openrouter-images-3ecegv0d.js → openrouter-images-xr9gme9x.js} +4 -3
  167. package/dist/{otel-impl-13am7a65.js → otel-impl-xjqz6wjj.js} +2 -2
  168. package/dist/{pi-messages-pchtw4he.js → pi-messages-hjbv8v10.js} +28 -12
  169. package/dist/{pi-mono-adapter-c53de1gd.js → pi-mono-adapter-dbxyp0qv.js} +23 -26
  170. package/dist/{pricing-refresh-9fcbnq3f.js → pricing-refresh-ctdr74pd.js} +3 -3
  171. package/dist/{rbac-roles-66j5h4y5.js → rbac-roles-ehv8s10n.js} +12 -3
  172. package/dist/{rbac-roles-gw0p9h3j.js → rbac-roles-q0gr8eyj.js} +16 -2
  173. package/dist/{render-v2-fg8bmdn4.js → render-v2-5b6chvcq.js} +9 -4
  174. package/dist/{resume-1c8kr3nh.js → resume-5a5d2845.js} +7 -7
  175. package/dist/{runtime-tzf9j7tc.js → runtime-khxszyfp.js} +1 -1
  176. package/dist/{session-access-d0atq10j.js → session-access-gj0bjhqg.js} +4 -4
  177. package/dist/{session-source-backfill-0vscqmsa.js → session-source-backfill-2sy0krfk.js} +3 -3
  178. package/dist/{setup-tvfa7rwe.js → setup-7ssfakk1.js} +1 -1
  179. package/dist/{typesafe-system-one-0bmqcxfg.js → typesafe-system-one-f2en2knd.js} +2 -2
  180. package/dist/virtual-modules-pjj0knwf.js +362 -0
  181. package/dist/{work-objects-ks71xqeb.js → work-objects-bf3syvhq.js} +22 -21
  182. package/dist/{worker-follow-up-bfx0h9hg.js → worker-follow-up-38xevga6.js} +19 -18
  183. package/dist/worker-r8mz7a65.js +72 -0
  184. package/dist/{x-vmmye1kb.js → x-2fyrt5pp.js} +2 -2
  185. package/openapi.json +1169 -257
  186. package/package.json +9 -11
  187. package/src/apps/catalog.generated.json +354 -82
  188. package/src/apps/page-validator.ts +134 -2
  189. package/src/assets/key.ts +77 -4
  190. package/src/be/connector-codes.ts +21 -6
  191. package/src/be/db/session-labels.ts +57 -0
  192. package/src/be/db/session-tree.ts +51 -7
  193. package/src/be/db/slack-trees.ts +146 -0
  194. package/src/be/db/tasks/read.ts +124 -7
  195. package/src/be/db-client.ts +8 -2
  196. package/src/be/db.ts +99 -86
  197. package/src/be/event-loop-lag.ts +146 -0
  198. package/src/be/improvements.ts +416 -0
  199. package/src/be/mcp-overflow-sweep.ts +2 -1
  200. package/src/be/memory/providers/sqlite-store.ts +39 -8
  201. package/src/be/migrations/274_improvements.sql +27 -0
  202. package/src/be/migrations/275_task_dispatched_by.sql +8 -0
  203. package/src/be/migrations/278_slack_render_v2_reconcile.sql +108 -0
  204. package/src/be/rbac-roles.ts +123 -1
  205. package/src/be/swarm-config-guard.ts +3 -0
  206. package/src/be/users.ts +58 -1
  207. package/src/cli.tsx +5 -25
  208. package/src/commands/codex-login.ts +1 -1
  209. package/src/commands/context-preamble.ts +258 -0
  210. package/src/commands/e2b.ts +0 -1
  211. package/src/commands/onboard/agent-fs-version.ts +1 -1
  212. package/src/commands/onboard/compose-generator.ts +0 -1
  213. package/src/commands/onboard/dashboard-url.ts +31 -0
  214. package/src/commands/onboard/steps/generate.tsx +17 -1
  215. package/src/commands/onboard/steps/post-dashboard.tsx +9 -3
  216. package/src/commands/onboard.tsx +19 -6
  217. package/src/commands/runner.ts +117 -96
  218. package/src/extensions/catalog.generated.json +3 -3
  219. package/src/extensions/contract-types.generated.ts +1 -1
  220. package/src/heartbeat/heartbeat.ts +5 -4
  221. package/src/hooks/hook.ts +13 -5
  222. package/src/http/all-routes.ts +1 -0
  223. package/src/http/approval-requests.ts +2 -44
  224. package/src/http/auth.ts +5 -4
  225. package/src/http/codex-oauth-accounts.ts +31 -23
  226. package/src/http/codex-oauth-device.ts +1 -1
  227. package/src/http/codex-oauth-keep-warm.ts +1 -1
  228. package/src/http/core.ts +9 -3
  229. package/src/http/improvements.ts +317 -0
  230. package/src/http/index.ts +12 -6
  231. package/src/http/memory.ts +9 -4
  232. package/src/http/operator-actor.ts +2 -1
  233. package/src/http/person-responder.ts +66 -0
  234. package/src/http/sessions.ts +65 -10
  235. package/src/http/tasks.ts +1 -1
  236. package/src/http/user-roles.ts +11 -2
  237. package/src/http/users.ts +194 -104
  238. package/src/http/utils.ts +18 -0
  239. package/src/http/webhooks.ts +48 -0
  240. package/src/integrations/chat-sdk/commands.ts +167 -31
  241. package/src/integrations/chat-sdk/inbound.ts +10 -8
  242. package/src/integrations/chat-sdk/message-text.ts +117 -0
  243. package/src/providers/acp-targets.ts +1 -1
  244. package/src/providers/amp-adapter.ts +1 -1
  245. package/src/providers/codex-adapter.ts +8 -1
  246. package/src/providers/codex-models.ts +4 -3
  247. package/src/providers/codex-oauth/auth-json.ts +14 -18
  248. package/src/providers/codex-oauth/storage.ts +2 -2
  249. package/src/providers/cursor-adapter.ts +1 -1
  250. package/src/providers/dsh-adapter.ts +1 -1
  251. package/src/rbac/legacy-policy.ts +2 -0
  252. package/src/rbac/permissions.ts +10 -0
  253. package/src/scheduler/scheduler.ts +4 -1
  254. package/src/scripts-runtime/executors/quickjs-runner.ts +2 -0
  255. package/src/scripts-runtime/executors/quickjs-structured-clone.ts +180 -0
  256. package/src/scripts-runtime/quickjs-compat.ts +0 -1
  257. package/src/scripts-runtime/types/swarm-extension.d.ts +2 -0
  258. package/src/server.ts +2 -0
  259. package/src/slack/ack.ts +20 -14
  260. package/src/slack/app.ts +332 -10
  261. package/src/slack/handlers.ts +9 -2
  262. package/src/slack/index.ts +7 -1
  263. package/src/slack/lifecycle-lock.ts +29 -0
  264. package/src/slack/render-v2.ts +466 -229
  265. package/src/slack/socket-fence.ts +64 -0
  266. package/src/slack/watcher.ts +42 -8
  267. package/src/tests/api-drain-worker-e2e.test.ts +69 -2
  268. package/src/tests/apps-catalog-drift.test.ts +35 -0
  269. package/src/tests/apps-catalog-table.test.ts +203 -0
  270. package/src/tests/apps-element-assembly.test.ts +28 -0
  271. package/src/tests/apps-schema-form.test.ts +151 -0
  272. package/src/tests/apps-smart-links.test.ts +151 -0
  273. package/src/tests/apps-table-filters-migration.test.ts +96 -0
  274. package/src/tests/apps-table-selection-migration.test.ts +95 -0
  275. package/src/tests/chat-sdk-commands.test.ts +359 -2
  276. package/src/tests/chat-sdk-inbound.test.ts +20 -0
  277. package/src/tests/chat-sdk-slack.test.ts +189 -1
  278. package/src/tests/chatgpt-subscription-session-bench.test.ts +2 -2
  279. package/src/tests/claude-worker-parity.test.ts +2 -2
  280. package/src/tests/codex-adapter.test.ts +30 -0
  281. package/src/tests/codex-login.test.ts +2 -2
  282. package/src/tests/codex-oauth-accounts.test.ts +48 -12
  283. package/src/tests/codex-oauth-credential-info.test.ts +77 -1
  284. package/src/tests/codex-oauth-device.test.ts +1 -1
  285. package/src/tests/codex-oauth-keep-warm.test.ts +2 -2
  286. package/src/tests/codex-oauth.test.ts +25 -4
  287. package/src/tests/codex-pool.test.ts +2 -2
  288. package/src/tests/db-client-busy-retry.test.ts +69 -18
  289. package/src/tests/db-client.test.ts +26 -1
  290. package/src/tests/db-task-read-contract.test.ts +4 -0
  291. package/src/tests/db-task-write-contract.test.ts +2 -0
  292. package/src/tests/deploy-one-box.test.ts +39 -1
  293. package/src/tests/docs-index-footprint.test.js +3 -3
  294. package/src/tests/dsh-adapter.test.ts +1 -1
  295. package/src/tests/event-loop-lag.test.ts +184 -0
  296. package/src/tests/extensions-example-comms-adherence-gate.test.ts +115 -0
  297. package/src/tests/fixtures/onboard/content.compose.yml.txt +0 -4
  298. package/src/tests/fixtures/onboard/dev.compose.yml.txt +0 -3
  299. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +0 -11
  300. package/src/tests/fixtures/onboard/full.compose.yml.txt +0 -11
  301. package/src/tests/fixtures/onboard/research.compose.yml.txt +0 -3
  302. package/src/tests/fixtures/onboard/solo.compose.yml.txt +0 -1
  303. package/src/tests/fixtures/prs-app-definition.json.txt +784 -0
  304. package/src/tests/fixtures/prs-filters-migration.patch.json.txt +318 -0
  305. package/src/tests/fixtures/prs-selection-migration.patch.json.txt +373 -0
  306. package/src/tests/fixtures/runner-identity-refresh.ts +3 -0
  307. package/src/tests/fixtures/runner-legacy-resume-prompt.ts +3 -0
  308. package/src/tests/fixtures/runner-task-start-reads.ts +140 -0
  309. package/src/tests/github-webhook-early-ack.test.ts +144 -0
  310. package/src/tests/hook-ping-me-order.test.ts +85 -0
  311. package/src/tests/http-api-integration.test.ts +2 -0
  312. package/src/tests/http-log-scrubbing.test.ts +68 -2
  313. package/src/tests/improvements-payload.test.ts +200 -0
  314. package/src/tests/improvements-route.test.ts +419 -0
  315. package/src/tests/install-sh-setup-url.test.ts +190 -0
  316. package/src/tests/kv-storage.test.ts +92 -1
  317. package/src/tests/memory-key-paths.test.ts +57 -0
  318. package/src/tests/memory-retrieval-purge.test.ts +19 -0
  319. package/src/tests/onboard-dashboard-output.test.ts +109 -0
  320. package/src/tests/onboard-dashboard-url.test.ts +83 -0
  321. package/src/tests/operator-granted-credentials.test.ts +561 -0
  322. package/src/tests/operator-granted-role-wire.test.ts +222 -0
  323. package/src/tests/quickjs-compat.test.ts +1 -1
  324. package/src/tests/rbac-engine.test.ts +2 -0
  325. package/src/tests/runner-context-preamble.test.ts +552 -0
  326. package/src/tests/runner-context-usage.test.ts +0 -1
  327. package/src/tests/runner-legacy-options.test.ts +55 -0
  328. package/src/tests/runner-slot-reconcile.test.ts +38 -0
  329. package/src/tests/runner-task-start-reads.test.ts +58 -0
  330. package/src/tests/script-connections.test.ts +3 -0
  331. package/src/tests/script-executor-conformance.test.ts +188 -0
  332. package/src/tests/send-task-dispatched-by.test.ts +129 -0
  333. package/src/tests/session-dispatched-tasks.test.ts +115 -0
  334. package/src/tests/session-sharing.test.ts +198 -9
  335. package/src/tests/sessions-tree.test.ts +133 -2
  336. package/src/tests/slack-app-icon.test.ts +4 -0
  337. package/src/tests/slack-dm-implicit-mention.test.ts +236 -0
  338. package/src/tests/slack-file-tools-attachments.test.ts +96 -3
  339. package/src/tests/slack-reaction-config.test.ts +39 -0
  340. package/src/tests/slack-read-boundaries.test.ts +4 -3
  341. package/src/tests/slack-render-v2-query-plans.test.ts +262 -3
  342. package/src/tests/slack-render-v2-reconcile.test.ts +201 -0
  343. package/src/tests/slack-render-v2.test.ts +47 -0
  344. package/src/tests/slack-socket-watchdog.test.ts +748 -0
  345. package/src/tests/submit-improvement-tool.test.ts +82 -0
  346. package/src/tests/tool-annotations.test.ts +1 -1
  347. package/src/tests/vcs-identity-inheritance.test.ts +85 -0
  348. package/src/tools/manage-user.ts +88 -58
  349. package/src/tools/send-task.ts +3 -0
  350. package/src/tools/slack-read.ts +61 -33
  351. package/src/tools/submit-improvement.ts +68 -0
  352. package/src/tools/tool-config.ts +3 -0
  353. package/src/tools/utils.ts +16 -7
  354. package/src/types.ts +5 -0
  355. package/src/utils/request-auth-context.ts +6 -1
  356. package/templates/extensions/comms-adherence-gate/README.md +25 -0
  357. package/templates/extensions/comms-adherence-gate/hooks.ts +100 -11
  358. package/templates/extensions/comms-adherence-gate/manifest.json +1 -1
  359. package/templates/skills/apps/SKILL.md +29 -11
  360. package/templates/skills/apps/content.md +29 -11
  361. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  362. package/templates/skills/swarm-scripts/content.md +1 -1
  363. package/templates/skills/work-on-task/SKILL.md +1 -1
  364. package/templates/skills/work-on-task/content.md +1 -1
  365. package/dist/acp-adapter-vg5hqkvj.js +0 -16
  366. package/dist/app-e00m45gn.js +0 -17
  367. package/dist/cli-5c4hjzne.js +0 -873
  368. package/dist/cli-ae0dnfee.js +0 -20222
  369. package/dist/cli-nn3ysbqk.js +0 -428
  370. package/dist/cli-pc5znp64.js +0 -364
  371. package/dist/fx-adapter-m5jbgd5q.js +0 -19
  372. package/dist/grok-adapter-csvv7sac.js +0 -19
  373. package/dist/handlers-8x5gfbzx.js +0 -32
  374. package/dist/heartbeat-6c2y3267.js +0 -41
  375. package/dist/index-hpfte8jd.js +0 -33
  376. package/dist/index-ncf7yb5s.js +0 -30
  377. package/dist/index-vte6dyeh.js +0 -37
  378. package/dist/lead-4bvftzm6.js +0 -71
  379. package/dist/virtual-modules-efxcp740.js +0 -59
  380. package/dist/worker-e7v2bvm9.js +0 -71
@@ -0,0 +1,180 @@
1
+ /** Runs inside QuickJS, before user code; cloned values never cross the host bridge. */
2
+ export const SANDBOX_STRUCTURED_CLONE = `(() => {
3
+ "use strict";
4
+
5
+ // Capture intrinsics before a script can replace methods, constructors or accessors.
6
+ const uncurry = (fn) => Function.prototype.call.bind(fn);
7
+ const descriptor = Object.getOwnPropertyDescriptor;
8
+ const define = Object.defineProperty;
9
+ const keys = Object.keys;
10
+ const hasOwn = uncurry(Object.prototype.hasOwnProperty);
11
+ const isArray = Array.isArray;
12
+ const isView = ArrayBuffer.isView;
13
+ const isError = Error.isError;
14
+ const instanceOf = uncurry(Function.prototype[Symbol.hasInstance]);
15
+ const NativeObject = Object;
16
+ const NativeArray = Array;
17
+ const NativeError = Error;
18
+ const NativeTypeError = TypeError;
19
+ const NativeMap = Map;
20
+ const NativeSet = Set;
21
+ const NativeWeakMap = WeakMap;
22
+ const NativeArrayBuffer = ArrayBuffer;
23
+ const NativeUint8Array = Uint8Array;
24
+ const NativeDataView = DataView;
25
+ const NativeDate = Date;
26
+ const NativeRegExp = RegExp;
27
+ const regexpPrototype = RegExp.prototype;
28
+ const toString = String;
29
+ const mapHas = uncurry(Map.prototype.has);
30
+ const mapSet = uncurry(Map.prototype.set);
31
+ const mapForEach = uncurry(Map.prototype.forEach);
32
+ const setHas = uncurry(Set.prototype.has);
33
+ const setAdd = uncurry(Set.prototype.add);
34
+ const setForEach = uncurry(Set.prototype.forEach);
35
+ const memoHas = uncurry(WeakMap.prototype.has);
36
+ const memoGet = uncurry(WeakMap.prototype.get);
37
+ const memoSet = uncurry(WeakMap.prototype.set);
38
+ const dateValue = uncurry(Date.prototype.getTime);
39
+ const regexpSource = uncurry(descriptor(RegExp.prototype, "source").get);
40
+ const bufferLength = uncurry(descriptor(ArrayBuffer.prototype, "byteLength").get);
41
+ const bufferResizable = uncurry(descriptor(ArrayBuffer.prototype, "resizable").get);
42
+ const dataBuffer = uncurry(descriptor(DataView.prototype, "buffer").get);
43
+ const dataOffset = uncurry(descriptor(DataView.prototype, "byteOffset").get);
44
+ const dataLength = uncurry(descriptor(DataView.prototype, "byteLength").get);
45
+ const typedPrototype = Object.getPrototypeOf(Uint8Array.prototype);
46
+ const typedName = uncurry(descriptor(typedPrototype, Symbol.toStringTag).get);
47
+ const typedBuffer = uncurry(descriptor(typedPrototype, "buffer").get);
48
+ const typedOffset = uncurry(descriptor(typedPrototype, "byteOffset").get);
49
+ const typedLength = uncurry(descriptor(typedPrototype, "length").get);
50
+ const typedValues = uncurry(typedPrototype.values);
51
+ const setBytes = uncurry(Uint8Array.prototype.set);
52
+ const errorTypes = { Error, EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError };
53
+ const viewTypes = {
54
+ Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array,
55
+ Uint32Array, Float16Array, Float32Array, Float64Array, BigInt64Array, BigUint64Array,
56
+ };
57
+ const boxedValues = [Boolean, Number, String, BigInt, Symbol].map(Type => uncurry(Type.prototype.valueOf));
58
+ const regexpFlags = [
59
+ ["hasIndices", "d"], ["global", "g"], ["ignoreCase", "i"], ["multiline", "m"],
60
+ ["dotAll", "s"], ["unicode", "u"], ["unicodeSets", "v"], ["sticky", "y"],
61
+ ].map(([name, flag]) => [uncurry(descriptor(RegExp.prototype, name).get), flag]);
62
+ const unsupportedTypes = [Promise, WeakMap, WeakSet, WeakRef, FinalizationRegistry, SharedArrayBuffer];
63
+ const brandKey = {};
64
+ const noBrand = {};
65
+ const probe = (read, value) => {
66
+ try { return read(value); } catch { return noBrand; }
67
+ };
68
+ const fail = (message = "Value cannot be cloned") => {
69
+ const error = new NativeError(message);
70
+ error.name = "DataCloneError";
71
+ throw error;
72
+ };
73
+ const property = (target, key, value) => define(target, key, {
74
+ value, enumerable: true, writable: true, configurable: true,
75
+ });
76
+
77
+ function structuredClone(value, options) {
78
+ if (arguments.length === 0) throw new NativeTypeError("structuredClone requires a value");
79
+ // QuickJS has no transferable host objects. Reject rather than silently ignoring detachment.
80
+ const transfer = options == null ? undefined : options.transfer;
81
+ if (transfer !== undefined) {
82
+ for (const entry of transfer) fail("quickjs structuredClone does not support transfers");
83
+ }
84
+ const memory = new NativeWeakMap();
85
+ const remember = (source, target) => { memoSet(memory, source, target); return target; };
86
+ const clone = (source) => {
87
+ const type = typeof source;
88
+ if (type === "symbol" || type === "function") return fail();
89
+ if (source === null || type !== "object") return source;
90
+ if (memoHas(memory, source)) return memoGet(memory, source);
91
+
92
+ if (isView(source)) {
93
+ const name = typedName(source);
94
+ if (name !== undefined) {
95
+ // The intrinsic rejects detached or out-of-bounds views; property getters may lie.
96
+ try { typedValues(source); } catch { return fail(); }
97
+ return remember(source, new viewTypes[name](clone(typedBuffer(source)), typedOffset(source), typedLength(source)));
98
+ }
99
+ let buffer, offset, length;
100
+ try { buffer = dataBuffer(source); offset = dataOffset(source); length = dataLength(source); }
101
+ catch { return fail(); }
102
+ return remember(source, new NativeDataView(clone(buffer), offset, length));
103
+ }
104
+
105
+ const byteLength = probe(bufferLength, source);
106
+ if (byteLength !== noBrand) {
107
+ let bytes;
108
+ try { bytes = new NativeUint8Array(source); } catch { return fail(); }
109
+ // JS cannot recover whether a view over a resizable buffer tracks its length.
110
+ if (bufferResizable(source)) return fail("quickjs structuredClone does not support resizable buffers");
111
+ const target = new NativeArrayBuffer(byteLength);
112
+ setBytes(new NativeUint8Array(target), bytes);
113
+ return remember(source, target);
114
+ }
115
+
116
+ if (isError(source)) {
117
+ const name = source.name;
118
+ const Type = typeof name === "string" && hasOwn(errorTypes, name) ? errorTypes[name] : NativeError;
119
+ const target = remember(source, new Type());
120
+ const message = descriptor(source, "message");
121
+ if (message && hasOwn(message, "value")) {
122
+ if (typeof message.value === "symbol") throw new NativeTypeError("Cannot convert a Symbol value to a string");
123
+ define(target, "message", { value: toString(message.value), writable: true, configurable: true });
124
+ }
125
+ const stack = descriptor(source, "stack");
126
+ if (stack && typeof stack.value === "string") {
127
+ define(target, "stack", { value: stack.value, writable: true, configurable: true });
128
+ }
129
+ return target;
130
+ }
131
+
132
+ if (probe((value) => mapHas(value, brandKey), source) !== noBrand) {
133
+ const target = remember(source, new NativeMap());
134
+ // Snapshot entries before cloning any value: getters can mutate the original collection.
135
+ const entries = [];
136
+ mapForEach(source, (value, key) => { entries[entries.length] = [key, value]; });
137
+ for (let i = 0; i < entries.length; i++) mapSet(target, clone(entries[i][0]), clone(entries[i][1]));
138
+ return target;
139
+ }
140
+ if (probe((value) => setHas(value, brandKey), source) !== noBrand) {
141
+ const target = remember(source, new NativeSet());
142
+ const entries = [];
143
+ setForEach(source, value => { entries[entries.length] = value; });
144
+ for (let i = 0; i < entries.length; i++) setAdd(target, clone(entries[i]));
145
+ return target;
146
+ }
147
+ const time = probe(dateValue, source);
148
+ if (time !== noBrand) return remember(source, new NativeDate(time));
149
+ const pattern = source === regexpPrototype ? noBrand : probe(regexpSource, source);
150
+ if (pattern !== noBrand) {
151
+ let flags = "";
152
+ for (let i = 0; i < regexpFlags.length; i++) {
153
+ if (regexpFlags[i][0](source)) flags += regexpFlags[i][1];
154
+ }
155
+ return remember(source, new NativeRegExp(pattern, flags));
156
+ }
157
+ for (let i = 0; i < boxedValues.length; i++) {
158
+ const primitive = probe(boxedValues[i], source);
159
+ if (primitive !== noBrand) {
160
+ if (typeof primitive === "symbol") return fail();
161
+ return remember(source, NativeObject(primitive));
162
+ }
163
+ }
164
+ for (let i = 0; i < unsupportedTypes.length; i++) {
165
+ if (instanceOf(unsupportedTypes[i], source)) return fail();
166
+ }
167
+
168
+ const target = remember(source, isArray(source) ? new NativeArray(source.length) : {});
169
+ const names = keys(source);
170
+ for (let i = 0; i < names.length; i++) {
171
+ const name = names[i];
172
+ // A prior getter can delete a later property. Symbol keys are never read.
173
+ if (hasOwn(source, name)) property(target, name, clone(source[name]));
174
+ }
175
+ return target;
176
+ };
177
+ return clone(value);
178
+ }
179
+ define(globalThis, "structuredClone", { value: structuredClone, writable: true, configurable: true });
180
+ })();`;
@@ -52,7 +52,6 @@ const UNSUPPORTED_GLOBALS = new Set([
52
52
  "performance",
53
53
  "queueMicrotask",
54
54
  "setImmediate",
55
- "structuredClone",
56
55
  ]);
57
56
  const RESPONSE_BODY_METHODS = new Set(["arrayBuffer", "blob", "formData", "bytes"]);
58
57
  const LOCALE_METHODS = new Set(["toLocaleString", "toLocaleDateString", "toLocaleTimeString"]);
@@ -66,6 +66,7 @@ declare module "swarm-extension" {
66
66
  workflowRunId?: string | undefined;
67
67
  workflowRunStepId?: string | undefined;
68
68
  sourceTaskId?: string | undefined;
69
+ dispatchedByTaskId?: string | undefined;
69
70
  outputSchema?: Record<string, unknown> | undefined;
70
71
  inheritParentOutputSchema?: boolean | undefined;
71
72
  inheritParentRequester?: boolean | undefined;
@@ -192,6 +193,7 @@ declare module "swarm-extension" {
192
193
  mentionChannelId?: string | undefined;
193
194
  dir?: string | undefined;
194
195
  parentTaskId?: string | undefined;
196
+ dispatchedByTaskId?: string | undefined;
195
197
  claudeSessionId?: string | undefined;
196
198
  model?: string | undefined;
197
199
  modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;
package/src/server.ts CHANGED
@@ -173,6 +173,7 @@ import { registerSlackUpdateTool } from "./tools/slack-update";
173
173
  import { registerSlackUploadFileTool } from "./tools/slack-upload-file";
174
174
  import { registerSteerTaskTool } from "./tools/steer-task";
175
175
  import { registerStoreProgressTool } from "./tools/store-progress";
176
+ import { registerSubmitImprovementTool } from "./tools/submit-improvement";
176
177
  // Swarm config tools
177
178
  import {
178
179
  registerDeleteConfigTool,
@@ -495,6 +496,7 @@ export async function createServer(
495
496
  registerStoreProgressTool(server);
496
497
  registerMyAgentInfoTool(server);
497
498
  registerCancelTaskTool(server);
499
+ registerSubmitImprovementTool(server);
498
500
 
499
501
  // User identity tools
500
502
  registerResolveUserTool(server);
package/src/slack/ack.ts CHANGED
@@ -116,20 +116,26 @@ export async function finalizeSlackMessageReaction(
116
116
  event?: SlackReactionEvent,
117
117
  ): Promise<void> {
118
118
  const names = new Set(ACCEPTANCE_EVENTS.map((acceptanceEvent) => reactionName(acceptanceEvent)));
119
- for (const name of names) {
120
- try {
121
- await client.reactions.remove({ channel, name, timestamp });
122
- } catch (error) {
123
- const code = slackErrorCode(error);
124
- if (code === "no_reaction" || code === "message_not_found" || code === "invalid_name")
125
- continue;
126
- console.log(
127
- scrubSecrets(
128
- `[Slack] ${name} acknowledgement reaction removal failed: ${error instanceof Error ? error.message : error}`,
129
- ),
130
- );
131
- }
132
- }
119
+ // Each removal targets a different name and absorbs its own error, so the
120
+ // (at most ACCEPTANCE_EVENTS.length) calls run together. The outcome
121
+ // reaction still waits for all of them: an outcome name that matches an
122
+ // acceptance name must not be removed after it is added.
123
+ await Promise.all(
124
+ Array.from(names, async (name) => {
125
+ try {
126
+ await client.reactions.remove({ channel, name, timestamp });
127
+ } catch (error) {
128
+ const code = slackErrorCode(error);
129
+ if (code === "no_reaction" || code === "message_not_found" || code === "invalid_name")
130
+ return;
131
+ console.log(
132
+ scrubSecrets(
133
+ `[Slack] ${name} acknowledgement reaction removal failed: ${error instanceof Error ? error.message : error}`,
134
+ ),
135
+ );
136
+ }
137
+ }),
138
+ );
133
139
 
134
140
  await addReaction(client, channel, timestamp, outcome, event);
135
141
  }
package/src/slack/app.ts CHANGED
@@ -1,12 +1,19 @@
1
1
  import { App, LogLevel, SocketModeReceiver } from "@slack/bolt";
2
2
  import { emitBuiltInIntegrationConnectedOnce, ensureSlackRenderV2Activation } from "../be/db";
3
3
  import { getNodeEnv } from "../utils/node-env";
4
+ import { scrubSecrets } from "../utils/secret-scrubber";
4
5
  import { getSlackConfiguration } from "./config";
5
- import { type SlackConnectionState, setSlackConnectionState } from "./connection-state";
6
+ import {
7
+ getSlackConnectionState,
8
+ type SlackConnectionState,
9
+ setSlackConnectionState,
10
+ } from "./connection-state";
6
11
  import { installSlackEgressScrub } from "./egress-scrub";
7
12
  import { installSlackExternalChannelGuard } from "./external-channel-egress";
8
13
  import { recoverSlackInboundAfterRestart, slackInboundOutcomeMiddleware } from "./inbound-dispatch";
14
+ import { isSlackLifecycleBusy, runSlackLifecycleExclusive } from "./lifecycle-lock";
9
15
  import { installSocketAckRecovery } from "./socket-ack";
16
+ import { fenceSocketModeClient, type SlackSocketFence } from "./socket-fence";
10
17
  import { getSlackSocketModeBlockReason, SLACK_DEV_SOCKET_MODE_OPT_IN } from "./socket-mode-guard";
11
18
  import { startTaskWatcher, stopTaskWatcher } from "./watcher";
12
19
 
@@ -14,6 +21,14 @@ let app: App | null = null;
14
21
  let receiver: SocketModeReceiver | null = null;
15
22
  let initialized = false;
16
23
  let inboundDrain: ReturnType<typeof installSocketAckRecovery> | null = null;
24
+ // Retires the current client at teardown, so a reconnect it still has in
25
+ // flight cannot open a socket next to the replacement.
26
+ let socketFence: SlackSocketFence | null = null;
27
+ // Bumped at each teardown. A start that sees a new generation was abandoned
28
+ // by the watchdog (or overtaken by a stop) and must not touch shared state.
29
+ let lifecycleGeneration = 0;
30
+ // Last sign of life on the current socket: Slack's hello or any envelope.
31
+ let lastSocketActivityAt: number | null = null;
17
32
 
18
33
  const SOCKET_EVENT_STATES: Record<string, SlackConnectionState> = {
19
34
  connecting: "connecting",
@@ -27,9 +42,240 @@ function trackConnectionState(owner: SocketModeReceiver): void {
27
42
  for (const [event, state] of Object.entries(SOCKET_EVENT_STATES)) {
28
43
  owner.client.on(event, () => {
29
44
  // Ignore late events from a receiver that stopSlackApp() already replaced.
30
- if (receiver === owner) setSlackConnectionState(state);
45
+ if (receiver !== owner) return;
46
+ setSlackConnectionState(state);
47
+ if (state === "connected") lastSocketActivityAt = Date.now();
31
48
  });
32
49
  }
50
+ owner.client.on("slack_event", () => {
51
+ if (receiver === owner) lastSocketActivityAt = Date.now();
52
+ });
53
+ }
54
+
55
+ // ─── Socket watchdog ──────────────────────────────────────────────────────────
56
+ // @slack/socket-mode treats a RequestError/HTTPError from apps.connections.open
57
+ // as unrecoverable during a reconnect, and its reconnect promise has no catch.
58
+ // The client then stops retrying for good and the state sticks in
59
+ // `connecting`. Upstream will not fix it (slackapi/node-slack-sdk#2656), so the
60
+ // watchdog rebuilds the whole Slack app when the socket stays down.
61
+
62
+ export interface SlackSocketWatchdogOptions {
63
+ /** How often the watchdog checks the socket. */
64
+ tickMs: number;
65
+ /** How long the socket must be down before the first restart. */
66
+ downAfterMs: number;
67
+ /** With no hello or envelope for this long, a `connected` socket also needs `isActive()`. */
68
+ staleActivityMs: number;
69
+ /** Delay after the first restart; it doubles after each further attempt. */
70
+ backoffBaseMs: number;
71
+ /** Cap on the delay between restarts. */
72
+ backoffMaxMs: number;
73
+ /**
74
+ * Bound on one restart (teardown + start) under the lifecycle lock. A
75
+ * restart still running then is abandoned, so a config reload or a shutdown
76
+ * waiting on the lock gets it.
77
+ */
78
+ restartTimeoutMs: number;
79
+ /**
80
+ * Bound on stopSlackApp()'s wait for the lifecycle lock. Shutdown must
81
+ * finish inside the pod's termination grace, which is shorter than
82
+ * `restartTimeoutMs`.
83
+ */
84
+ stopLockWaitMs: number;
85
+ }
86
+
87
+ export const SLACK_SOCKET_WATCHDOG_DEFAULTS: SlackSocketWatchdogOptions = {
88
+ tickMs: 5_000,
89
+ downAfterMs: 60_000,
90
+ staleActivityMs: 10 * 60_000,
91
+ backoffBaseMs: 30_000,
92
+ backoffMaxMs: 5 * 60_000,
93
+ restartTimeoutMs: 2 * 60_000,
94
+ stopLockWaitMs: 10_000,
95
+ };
96
+
97
+ export interface SlackSocketWatchdogDeps {
98
+ now: () => number;
99
+ getState: () => SlackConnectionState;
100
+ /** Last hello or envelope on the current socket, in epoch ms. */
101
+ getLastActivityAt: () => number | null;
102
+ /** The socket-mode client's own view: is its websocket open? */
103
+ isSocketActive: () => boolean;
104
+ /** True while a config reload (or another restart) holds the Slack lifecycle lock. */
105
+ isLifecycleBusy: () => boolean;
106
+ restart: () => Promise<void>;
107
+ log: (line: string) => void;
108
+ }
109
+
110
+ export interface SlackSocketWatchdog {
111
+ tick: () => Promise<void>;
112
+ /** Restart attempts since the socket was last healthy. */
113
+ attempts: () => number;
114
+ }
115
+
116
+ /** Delay before restart attempt `attempt + 1`: base * 2^(attempt-1), capped. */
117
+ export function slackWatchdogBackoffMs(
118
+ attempt: number,
119
+ options: SlackSocketWatchdogOptions,
120
+ ): number {
121
+ return Math.min(options.backoffBaseMs * 2 ** Math.max(0, attempt - 1), options.backoffMaxMs);
122
+ }
123
+
124
+ /**
125
+ * The watchdog state machine, with no timers of its own: the caller drives
126
+ * `tick()`. Operators search the two log lines, so keep their
127
+ * text stable.
128
+ */
129
+ export function createSlackSocketWatchdog(
130
+ deps: SlackSocketWatchdogDeps,
131
+ options: SlackSocketWatchdogOptions = SLACK_SOCKET_WATCHDOG_DEFAULTS,
132
+ ): SlackSocketWatchdog {
133
+ let downSince: number | null = null;
134
+ let attempts = 0;
135
+ let nextAttemptAt = 0;
136
+ let restarting = false;
137
+
138
+ function isHealthy(now: number): boolean {
139
+ if (deps.getState() !== "connected") return false;
140
+ // A quiet night is normal. Only a quiet socket that the client itself
141
+ // reports as closed counts as down.
142
+ const lastActivityAt = deps.getLastActivityAt();
143
+ if (lastActivityAt === null || now - lastActivityAt < options.staleActivityMs) return true;
144
+ return deps.isSocketActive();
145
+ }
146
+
147
+ async function tick(): Promise<void> {
148
+ if (restarting || deps.isLifecycleBusy()) return;
149
+ const now = deps.now();
150
+ if (isHealthy(now)) {
151
+ if (attempts > 0 && downSince !== null) {
152
+ deps.log(`[Slack] watchdog: recovered after ${seconds(now - downSince)}s`);
153
+ }
154
+ downSince = null;
155
+ attempts = 0;
156
+ nextAttemptAt = 0;
157
+ return;
158
+ }
159
+ downSince ??= now;
160
+ if (now - downSince < options.downAfterMs || now < nextAttemptAt) return;
161
+ attempts += 1;
162
+ nextAttemptAt = now + slackWatchdogBackoffMs(attempts, options);
163
+ deps.log(
164
+ `[Slack] watchdog: socket down for ${seconds(now - downSince)}s, restarting (attempt ${attempts})`,
165
+ );
166
+ restarting = true;
167
+ try {
168
+ await deps.restart();
169
+ } catch (error) {
170
+ // The error can carry request config or a token; scrub before it leaves.
171
+ const message = error instanceof Error ? error.message : String(error);
172
+ console.error(`[Slack] watchdog: restart failed: ${scrubSecrets(message)}`);
173
+ } finally {
174
+ restarting = false;
175
+ }
176
+ }
177
+
178
+ return { tick, attempts: () => attempts };
179
+ }
180
+
181
+ function seconds(ms: number): number {
182
+ return Math.round(ms / 1000);
183
+ }
184
+
185
+ function isLiveSocketActive(): boolean {
186
+ return receiver?.client.websocket?.isActive() ?? false;
187
+ }
188
+
189
+ let watchdogTimer: ReturnType<typeof setInterval> | null = null;
190
+ let watchdogOptions: SlackSocketWatchdogOptions = SLACK_SOCKET_WATCHDOG_DEFAULTS;
191
+
192
+ /**
193
+ * Rebuild the Slack app under the lifecycle lock, bounded by
194
+ * `restartTimeoutMs`. The web client can retry apps.connections.open for many
195
+ * minutes, and every config reload waits on the lock meanwhile. A restart
196
+ * that runs out of time is abandoned: its client is retired first, so it can
197
+ * never open a socket later, and the watchdog tries again after its backoff.
198
+ */
199
+ async function restartSlackAppForWatchdog(owner: ReturnType<typeof setInterval>): Promise<void> {
200
+ await runSlackLifecycleExclusive(async () => {
201
+ // stopSlackApp() won the lock first and disarmed this watchdog (shutdown,
202
+ // or a reload that armed a new one). Restarting now would bring back an
203
+ // app that the caller already stopped.
204
+ if (watchdogTimer !== owner) return;
205
+ // A config reload that won the lock may have just brought the socket back.
206
+ if (getSlackConnectionState() === "connected" && isLiveSocketActive()) return;
207
+ let abandoned = false;
208
+ const restart = (async () => {
209
+ await teardownSlackApp();
210
+ // A teardown that outlived the timeout must not start an app outside the
211
+ // lock, and one that a forced stopSlackApp() disarmed must not start one at all.
212
+ if (!abandoned && watchdogTimer === owner) await startSlackApp();
213
+ })();
214
+ const timeoutMs = watchdogOptions.restartTimeoutMs;
215
+ let timer: ReturnType<typeof setTimeout> | undefined;
216
+ const timedOut = new Promise<true>((resolve) => {
217
+ timer = setTimeout(() => resolve(true), timeoutMs);
218
+ });
219
+ try {
220
+ const outcome = await Promise.race([restart.then(() => false as const), timedOut]);
221
+ if (!outcome) return;
222
+ } finally {
223
+ clearTimeout(timer);
224
+ }
225
+ abandoned = true;
226
+ // The abandoned restart settles later, if ever; its error is no longer news.
227
+ void restart.catch(() => {});
228
+ abandonSlackApp();
229
+ throw new Error(`restart did not finish within ${seconds(timeoutMs)}s; abandoned it`);
230
+ });
231
+ }
232
+
233
+ function startSocketWatchdog(): void {
234
+ if (watchdogTimer) return;
235
+ let timer: ReturnType<typeof setInterval> | null = null;
236
+ const watchdog = createSlackSocketWatchdog(
237
+ {
238
+ now: Date.now,
239
+ getState: getSlackConnectionState,
240
+ getLastActivityAt: () => lastSocketActivityAt,
241
+ isSocketActive: isLiveSocketActive,
242
+ isLifecycleBusy: isSlackLifecycleBusy,
243
+ restart: () => (timer ? restartSlackAppForWatchdog(timer) : Promise.resolve()),
244
+ log: (line) => console.log(line),
245
+ },
246
+ watchdogOptions,
247
+ );
248
+ timer = setInterval(() => {
249
+ if (getSlackConfiguration().mode !== "socket") {
250
+ stopSocketWatchdog();
251
+ return;
252
+ }
253
+ void watchdog.tick();
254
+ }, watchdogOptions.tickMs);
255
+ // Never keep the process (or a test run) alive for the watchdog alone.
256
+ timer.unref?.();
257
+ watchdogTimer = timer;
258
+ }
259
+
260
+ function stopSocketWatchdog(): void {
261
+ if (watchdogTimer) clearInterval(watchdogTimer);
262
+ watchdogTimer = null;
263
+ }
264
+
265
+ /** Test hook: shorter thresholds for the next watchdog start. Pass nothing to reset. */
266
+ export function _setSlackSocketWatchdogOptionsForTests(
267
+ options?: Partial<SlackSocketWatchdogOptions>,
268
+ ): void {
269
+ watchdogOptions = { ...SLACK_SOCKET_WATCHDOG_DEFAULTS, ...options };
270
+ }
271
+
272
+ /** Test hook: the live socket-mode client, to inject reconnect faults. */
273
+ export function _getSlackSocketClientForTests(): SocketModeReceiver["client"] | null {
274
+ return receiver?.client ?? null;
275
+ }
276
+
277
+ export function isSlackSocketWatchdogRunning(): boolean {
278
+ return watchdogTimer !== null;
33
279
  }
34
280
 
35
281
  export function getSlackApp(): App | null {
@@ -99,6 +345,7 @@ export async function initSlackApp(): Promise<App | null> {
99
345
  installerOptions: clientOptions ? { clientOptions } : {},
100
346
  });
101
347
  trackConnectionState(receiver);
348
+ socketFence = fenceSocketModeClient(receiver.client);
102
349
  app = new App({
103
350
  token: botToken,
104
351
  receiver,
@@ -145,21 +392,31 @@ export async function initSlackApp(): Promise<App | null> {
145
392
  }
146
393
 
147
394
  export async function startSlackApp(): Promise<boolean> {
395
+ const generation = lifecycleGeneration;
148
396
  if (!app) {
149
397
  await initSlackApp();
150
398
  }
151
399
 
152
- if (app) {
400
+ const current = app;
401
+ if (current && generation === lifecycleGeneration) {
402
+ // Arm before app.start(): a start that throws is retried by the watchdog.
403
+ startSocketWatchdog();
153
404
  // Establish the durable cutoff before Socket Mode can deliver new asks.
154
405
  const { isSlackRenderV2Enabled } = await import("./render-v2");
155
406
  if (isSlackRenderV2Enabled()) await ensureSlackRenderV2Activation();
156
407
  // Receipts stored before the last restart: interrupted ones turn uncertain,
157
408
  // pending ones are processed once the app can dispatch them.
158
409
  await recoverSlackInboundAfterRestart();
159
- await app.start();
410
+ if (generation !== lifecycleGeneration) return false;
411
+ await current.start();
412
+ // Abandoned while it waited: the app was already detached and retired.
413
+ if (generation !== lifecycleGeneration) return false;
160
414
  console.log("[Slack] Bot connected via Socket Mode");
161
415
  void inboundDrain?.wake();
162
416
  await emitBuiltInIntegrationConnectedOnce("slack");
417
+ // Abandoned or stopped while telemetry was pending: a watcher started now
418
+ // would outlive the stop and leak its timer.
419
+ if (generation !== lifecycleGeneration) return false;
163
420
 
164
421
  // Start watching for task completions
165
422
  await startTaskWatcher();
@@ -169,17 +426,82 @@ export async function startSlackApp(): Promise<boolean> {
169
426
  return false;
170
427
  }
171
428
 
429
+ /**
430
+ * Stop the app and disarm the watchdog. Takes the Slack lifecycle lock, so a
431
+ * watchdog restart in flight finishes first and cannot bring the app back
432
+ * after this returns. The wait for the lock is bounded by `stopLockWaitMs`:
433
+ * after that, the stop disarms the watchdog and drops the app without the
434
+ * lock, and stops again once the lock frees.
435
+ */
172
436
  export async function stopSlackApp(): Promise<void> {
173
- stopTaskWatcher();
174
- inboundDrain?.stop();
175
- inboundDrain = null;
437
+ const locked = runSlackLifecycleExclusive(stopSlackAppUnderLifecycleLock);
438
+ const waitMs = watchdogOptions.stopLockWaitMs;
439
+ let timer: ReturnType<typeof setTimeout> | undefined;
440
+ const timedOut = new Promise<true>((resolve) => {
441
+ timer = setTimeout(() => resolve(true), waitMs);
442
+ });
443
+ try {
444
+ const outcome = await Promise.race([locked.then(() => false as const), timedOut]);
445
+ if (!outcome) return;
446
+ } finally {
447
+ clearTimeout(timer);
448
+ }
449
+ // The late stop under the lock still runs; its error is no longer news.
450
+ void locked.catch(() => {});
451
+ console.error(
452
+ `[Slack] stop: lifecycle lock still held after ${seconds(waitMs)}s; stopping without it`,
453
+ );
454
+ // The restart holding the lock sees the disarmed watchdog and starts nothing.
455
+ stopSocketWatchdog();
456
+ abandonSlackApp();
457
+ }
176
458
 
177
- if (app) {
178
- await app.stop();
179
- app = null;
459
+ /**
460
+ * stopSlackApp() for a caller that already holds the lifecycle lock (the
461
+ * config reload). The lock is not reentrant: taking it again would deadlock.
462
+ */
463
+ export async function stopSlackAppUnderLifecycleLock(): Promise<void> {
464
+ stopSocketWatchdog();
465
+ await teardownSlackApp();
466
+ }
467
+
468
+ /** Stop the app but keep the watchdog armed; the watchdog restart uses this. */
469
+ async function teardownSlackApp(): Promise<void> {
470
+ const stopping = detachSlackApp();
471
+ if (stopping) {
472
+ await stopping.stop();
180
473
  console.log("[Slack] Bot disconnected");
181
474
  }
475
+ }
476
+
477
+ /**
478
+ * Drop a restart that ran out of time, without waiting: app.stop() can block
479
+ * on the stalled client too. The retired client opens no socket, and the
480
+ * detached stop closes any socket it already has.
481
+ */
482
+ function abandonSlackApp(): void {
483
+ const stalled = detachSlackApp();
484
+ void stalled?.stop().catch((error: unknown) => {
485
+ const message = error instanceof Error ? error.message : String(error);
486
+ console.error(`[Slack] watchdog: stopping the abandoned app failed: ${scrubSecrets(message)}`);
487
+ });
488
+ }
489
+
490
+ /** Clear the module state synchronously and return the app to stop. */
491
+ function detachSlackApp(): App | null {
492
+ // Retire the client first: app.stop() cannot cancel a start that is still
493
+ // waiting for apps.connections.open.
494
+ socketFence?.retire();
495
+ socketFence = null;
496
+ lifecycleGeneration += 1;
497
+ stopTaskWatcher();
498
+ inboundDrain?.stop();
499
+ inboundDrain = null;
500
+ const detached = app;
501
+ app = null;
182
502
  receiver = null;
503
+ lastSocketActivityAt = null;
183
504
  setSlackConnectionState("disconnected");
184
505
  initialized = false;
506
+ return detached;
185
507
  }