@desplega.ai/agent-swarm 2.13.4 → 2.14.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 (526) hide show
  1. package/dist/acp-adapter-99n6z9ky.js +17 -0
  2. package/dist/{acp-targets-zrk9k0n7.js → acp-targets-23exz4z4.js} +10 -10
  3. package/dist/{actions-acqqj9jn.js → actions-zcr25x27.js} +61 -40
  4. package/dist/{agent-fs-provision-zmaykqnd.js → agent-fs-provision-7fa9e12e.js} +4 -4
  5. package/dist/{amp-adapter-a7ts8tmw.js → amp-adapter-s7ytmv6b.js} +3 -3
  6. package/dist/{anthropic-messages-88b7s3n9.js → anthropic-messages-vdd1zmha.js} +10 -10
  7. package/dist/{app-tmwa442h.js → app-5d3sz1hy.js} +7 -7
  8. package/dist/{approval-notifications-6psaaaye.js → approval-notifications-7qgkzkzx.js} +8 -8
  9. package/dist/{assistant-564v6emv.js → assistant-p2yvhc3j.js} +37 -32
  10. package/dist/{boot-args-schema-n099e0f2.js → boot-args-schema-ry6cb0p7.js} +1 -1
  11. package/dist/{boot-reembed-epvg4fp9.js → boot-reembed-2hkm3vz2.js} +1 -1
  12. package/dist/{boot-reembed-chx66qfk.js → boot-reembed-c9643ms3.js} +1 -1
  13. package/dist/{boot-scrub-sweep-dhkfp0a7.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
  14. package/dist/{boot-seeds-m74fc07r.js → boot-seeds-2hzvvzg0.js} +4 -4
  15. package/dist/{boxd-451q55ys.js → boxd-9py3x0jb.js} +2 -2
  16. package/dist/{claude-adapter-hw63yj3j.js → claude-adapter-dnkww93e.js} +9 -9
  17. package/dist/{claude-managed-adapter-z5s7fx6p.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
  18. package/dist/{claude-managed-setup-wee1762m.js → claude-managed-setup-4byxpp47.js} +5 -5
  19. package/dist/{claude-sdk-session-cktyqkpk.js → claude-sdk-session-4wf3dbvs.js} +13163 -12195
  20. package/dist/{cli-5rxsb3wq.js → cli-096aftq6.js} +12 -7
  21. package/dist/{cli-5rgm8p39.js → cli-0e914dp9.js} +3 -3
  22. package/dist/{cli-bzcwwebm.js → cli-0h6m6z5g.js} +1 -1
  23. package/dist/{cli-cah298e5.js → cli-0k7ppk9k.js} +231 -124
  24. package/dist/{cli-ja450998.js → cli-1nfabrt4.js} +8 -8
  25. package/dist/{cli-jzerrzgc.js → cli-2414h5r9.js} +8 -8
  26. package/dist/{cli-b768ek79.js → cli-24wervhz.js} +38 -0
  27. package/dist/{cli-93n305hm.js → cli-2ayk9gn8.js} +2 -2
  28. package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
  29. package/dist/{cli-d5pc8ep0.js → cli-2savn6mm.js} +11 -100
  30. package/dist/{cli-jbrc98qb.js → cli-2zjxake1.js} +4 -4
  31. package/dist/{cli-4q2c8rxw.js → cli-37p61fcg.js} +15 -9
  32. package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
  33. package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
  34. package/dist/{cli-x2cem5vy.js → cli-3wsabyt0.js} +2 -2
  35. package/dist/{cli-dqgnbnxs.js → cli-466jjrwe.js} +16 -2
  36. package/dist/{cli-zhwjdhjr.js → cli-6ajyhxh7.js} +2 -2
  37. package/dist/{cli-3bxrrh53.js → cli-6yy4fepf.js} +4 -4
  38. package/dist/{cli-hhtbandk.js → cli-73rmgm45.js} +2 -2
  39. package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
  40. package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
  41. package/dist/{cli-m1sns1da.js → cli-7w1fs01q.js} +2 -2
  42. package/dist/{cli-xwsm6xkr.js → cli-84wxwt3z.js} +1 -1
  43. package/dist/{cli-qzz6tz8s.js → cli-84xn7bgz.js} +1 -1
  44. package/dist/{cli-49aq3cyn.js → cli-879txsac.js} +5 -5
  45. package/dist/{cli-bv4vvnmg.js → cli-8vbxjzk0.js} +3 -3
  46. package/dist/{cli-7by7vp6m.js → cli-91amj3md.js} +3 -3
  47. package/dist/{cli-60dwk8tx.js → cli-930zbczq.js} +3 -3
  48. package/dist/{cli-7g3fg4gf.js → cli-9fwznq4p.js} +10 -10
  49. package/dist/{cli-4pbwg7sn.js → cli-9j1t3kf6.js} +2 -2
  50. package/dist/{cli-tzw1jr2t.js → cli-9j47sgzy.js} +2 -2
  51. package/dist/{cli-0fgvnb0x.js → cli-ad00h1st.js} +7 -7
  52. package/dist/{cli-kj84fqxz.js → cli-adzmmcvf.js} +19 -7
  53. package/dist/{cli-3tzmh38q.js → cli-ayxxkk3p.js} +68 -25
  54. package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
  55. package/dist/{cli-8cas2xvp.js → cli-cbg0j1yt.js} +2716 -2643
  56. package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
  57. package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
  58. package/dist/{cli-jg5txpm6.js → cli-dy754erz.js} +83 -1
  59. package/dist/{cli-tsc3pdfd.js → cli-edxfzgah.js} +4 -4
  60. package/dist/{cli-hyqksecw.js → cli-ejnhs815.js} +15 -15
  61. package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
  62. package/dist/{cli-ea7nz50q.js → cli-f2rwt43y.js} +14 -14
  63. package/dist/{cli-zjdhrzm0.js → cli-f9g96z28.js} +8 -8
  64. package/dist/{cli-rmgvwcmy.js → cli-fww016hh.js} +534 -70
  65. package/dist/{cli-rv3y60bt.js → cli-g6a696c0.js} +4 -4
  66. package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
  67. package/dist/{cli-p436yrzp.js → cli-gcyws2bp.js} +2 -2
  68. package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
  69. package/dist/{cli-0p76my9q.js → cli-jcnc5ret.js} +44 -32
  70. package/dist/{cli-tr19nyn9.js → cli-jgq9xptq.js} +7 -7
  71. package/dist/{cli-pz1dp12c.js → cli-jwnac23b.js} +1 -1
  72. package/dist/{cli-904wk98s.js → cli-kc7vd07m.js} +917 -350
  73. package/dist/{cli-t0jmkcah.js → cli-kg63yp1r.js} +14 -14
  74. package/dist/{cli-ts5yv7dn.js → cli-krk8y8c7.js} +835 -157
  75. package/dist/{cli-jyhbvdga.js → cli-m0ea8ggd.js} +8 -10
  76. package/dist/{cli-944w9wb4.js → cli-md4tn21h.js} +20 -15
  77. package/dist/{cli-zexwhj3f.js → cli-mv8ft7b0.js} +10 -9
  78. package/dist/{cli-phdzn699.js → cli-mw1tmn3x.js} +217 -27
  79. package/dist/{cli-5ashycw3.js → cli-njvpngc6.js} +3 -3
  80. package/dist/{cli-9ah37a8a.js → cli-phe2vcw5.js} +10 -7
  81. package/dist/{cli-eds5xnsz.js → cli-phmy14hb.js} +2 -2
  82. package/dist/{cli-n1kjs58m.js → cli-pq0kv31y.js} +5 -5
  83. package/dist/{cli-pz1nq5xm.js → cli-q457ga28.js} +6 -6
  84. package/dist/{cli-s33bzmk0.js → cli-q5n3deaf.js} +1 -1
  85. package/dist/{cli-4fpa0zns.js → cli-qkbevqer.js} +3 -3
  86. package/dist/{cli-29h5239w.js → cli-qrwjk4xy.js} +5 -5
  87. package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
  88. package/dist/{cli-3xqad83h.js → cli-r495stwd.js} +2 -2
  89. package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
  90. package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
  91. package/dist/{cli-fkpnx3vf.js → cli-rs1rzwp4.js} +3 -2
  92. package/dist/{cli-h9d3sdnc.js → cli-rzbsh6bw.js} +1 -1
  93. package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
  94. package/dist/{cli-cq4am6vg.js → cli-shyhb4t5.js} +10 -10
  95. package/dist/{cli-gtj12v95.js → cli-srq69pn1.js} +1 -1
  96. package/dist/{cli-azj9t1f9.js → cli-tc165vrb.js} +48 -5
  97. package/dist/{cli-gse7bp3z.js → cli-v4z5v3jd.js} +300 -81
  98. package/dist/{cli-p3knvk62.js → cli-vxmmttmt.js} +132 -53
  99. package/dist/{cli-404am6f3.js → cli-w4bvtxet.js} +7 -7
  100. package/dist/{cli-gkv0r2hq.js → cli-wd7b5hgc.js} +71 -9
  101. package/dist/{cli-akm6y2a8.js → cli-wvbaq052.js} +1 -1
  102. package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
  103. package/dist/{cli-ka48vpev.js → cli-wym6rxgt.js} +165 -6
  104. package/dist/{cli-nc4pbwmp.js → cli-yd7e590v.js} +12 -12
  105. package/dist/{cli-3zrwrnz7.js → cli-yjb3cddd.js} +1 -1
  106. package/dist/{cli-7gbff32z.js → cli-z8t4485r.js} +2 -2
  107. package/dist/{cli-hdhpdrka.js → cli-ze1ndjs4.js} +4 -6
  108. package/dist/{cli-50wa8k4h.js → cli-zy9bb22b.js} +1 -2
  109. package/dist/cli.js +28 -28
  110. package/dist/{codex-adapter-2fs2c0n6.js → codex-adapter-eq61radw.js} +8 -8
  111. package/dist/{codex-hook-jxjv6dy5.js → codex-hook-8nmepvz6.js} +3 -3
  112. package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
  113. package/dist/{codex-session-runner-r55tmx4c.js → codex-session-runner-rfx355h4.js} +9 -9
  114. package/dist/{commands-0mxdy9x8.js → commands-d1z0sx62.js} +3 -3
  115. package/dist/{controller-g3vkfhr4.js → controller-9hz6d8x3.js} +4 -4
  116. package/dist/{controllers-connect-4wdmncqt.js → controllers-connect-tz07d2xr.js} +24 -25
  117. package/dist/core-dynsv289.js +41 -0
  118. package/dist/{cursor-adapter-t9qb96q2.js → cursor-adapter-ef22ze3j.js} +2 -2
  119. package/dist/{db-487vvyv9.js → db-gd81d68c.js} +3 -3
  120. package/dist/{db-76p7w3gr.js → db-vrckks6q.js} +4 -2
  121. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
  122. package/dist/{dispatcher-64rp6w67.js → dispatcher-76as8w2t.js} +21 -22
  123. package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
  124. package/dist/dsh-adapter-ypfvcdyz.js +11 -0
  125. package/dist/{e2b-dc8f6ctq.js → e2b-05kn3kpq.js} +16 -5
  126. package/dist/{e2b-3ykbe805.js → e2b-dm9r8hpy.js} +3 -3
  127. package/dist/{easter-egg-3d-jrrwyf55.js → easter-egg-3d-sg21j15g.js} +1 -1
  128. package/dist/{embedding-space-001hhhpk.js → embedding-space-zsdw37bb.js} +13 -23
  129. package/dist/{embeddings-esj19cnw.js → embeddings-p4e3e1m6.js} +1 -1
  130. package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
  131. package/dist/{execute-301hkxqg.js → execute-nztd0af0.js} +1 -1
  132. package/dist/{external-channel-w10e2j05.js → external-channel-717yzn4d.js} +2 -2
  133. package/dist/fx-adapter-9k0hptnz.js +20 -0
  134. package/dist/grok-adapter-skdj2pce.js +20 -0
  135. package/dist/handlers-5btjqkz6.js +39 -0
  136. package/dist/{heartbeat-tbrj7vhq.js → heartbeat-vfb1gy84.js} +24 -25
  137. package/dist/{hook-tx917rqw.js → hook-ctz0xmp3.js} +11 -11
  138. package/dist/{hook-3am1sq68.js → hook-eh52p7yd.js} +6 -6
  139. package/dist/{http-3rmemtqy.js → http-zregegrx.js} +902 -198
  140. package/dist/{index-s7xtvc0f.js → index-5kx15d19.js} +1 -1
  141. package/dist/index-7w8p6em0.js +41 -0
  142. package/dist/index-evay0xyk.js +17 -0
  143. package/dist/{index-2jw11t8s.js → index-fdym6ryb.js} +25 -26
  144. package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
  145. package/dist/index-vz4semsx.js +38 -0
  146. package/dist/{index-gfnq66t1.js → index-x9qf8dg7.js} +294 -29
  147. package/dist/index-y3s0xp2v.js +43 -0
  148. package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
  149. package/dist/{keepalive-9px3t7qj.js → keepalive-zdqay870.js} +4 -5
  150. package/dist/lead-6cscw8a5.js +82 -0
  151. package/dist/{maintenance-vwqjwst6.js → maintenance-t5ndg11m.js} +1 -1
  152. package/dist/{node-2wfcey7d.js → node-0as4n1ef.js} +3 -3
  153. package/dist/{node-zd6shky9.js → node-dhxbt01p.js} +3 -3
  154. package/dist/{node-z67yjre7.js → node-jkdd5w7m.js} +290 -70
  155. package/dist/{node-hjn5n1yp.js → node-t0ct2zpw.js} +3 -5
  156. package/dist/{oauth-refresh-sweep-yqry3wn4.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
  157. package/dist/{object-webhooks-8s1wtths.js → object-webhooks-mkca91s0.js} +7 -7
  158. package/dist/{onboard-hb8czx0p.js → onboard-ss995244.js} +11 -9
  159. package/dist/{opencode-adapter-djd6m6dk.js → opencode-adapter-mwpz0278.js} +8 -8
  160. package/dist/{otel-impl-2ymwyczz.js → otel-impl-6n6vva3x.js} +2 -2
  161. package/dist/{pending-nxavtvx7.js → pending-2sxh1t6j.js} +22 -23
  162. package/dist/{pi-mono-adapter-d2cpmcy4.js → pi-mono-adapter-sfb7zy43.js} +13 -13
  163. package/dist/{pricing-refresh-1yz8jkqv.js → pricing-refresh-h79bg4cf.js} +2 -2
  164. package/dist/{rbac-roles-7s6m31xw.js → rbac-roles-ckq0czp4.js} +2 -2
  165. package/dist/{rbac-roles-dbpx0x9v.js → rbac-roles-jg2e260w.js} +3 -3
  166. package/dist/{render-v2-7y20rjrn.js → render-v2-ymbshmn0.js} +7 -7
  167. package/dist/{resume-wz546x47.js → resume-jdhnt4jk.js} +10 -10
  168. package/dist/{runtime-cb5bd9tz.js → runtime-y28jhhnf.js} +1 -1
  169. package/dist/{session-access-4vcft8kq.js → session-access-k4ta5hvp.js} +5 -5
  170. package/dist/{session-source-backfill-57b50tpw.js → session-source-backfill-528j4s8j.js} +3 -3
  171. package/dist/{setup-e1tevjyj.js → setup-d6pj82fr.js} +15 -6
  172. package/dist/thread-buffer-9w6x5zec.js +40 -0
  173. package/dist/{tree-visibility-07wf1nct.js → tree-visibility-kjxv3nxk.js} +2 -2
  174. package/dist/{user-merge-jobs-n20qpv6s.js → user-merge-jobs-rabbncf6.js} +3 -3
  175. package/dist/{virtual-modules-6fxmn1yv.js → virtual-modules-22k51txd.js} +3 -3
  176. package/dist/{work-objects-eg7y48pe.js → work-objects-xtjbar3r.js} +26 -30
  177. package/dist/{worker-follow-up-jnvnnf2b.js → worker-follow-up-fg48vk6d.js} +21 -22
  178. package/dist/worker-g4aj93dt.js +82 -0
  179. package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
  180. package/openapi.json +633 -25
  181. package/package.json +10 -10
  182. package/src/apps/definition.ts +76 -24
  183. package/src/apps/row-store.ts +67 -0
  184. package/src/apps/script-types.ts +131 -21
  185. package/src/apps/store.ts +4 -1
  186. package/src/apps/sync.ts +20 -5
  187. package/src/azure-devops/boards-sync.ts +1 -1
  188. package/src/be/db/script-runs.ts +33 -0
  189. package/src/be/db/slack-card-groups.ts +147 -0
  190. package/src/be/db/slack-trees.ts +38 -1
  191. package/src/be/db/task-idempotency.ts +63 -0
  192. package/src/be/db/tasks/read.ts +27 -1
  193. package/src/be/db/tasks/write.ts +51 -14
  194. package/src/be/db/users/avatar.ts +12 -0
  195. package/src/be/db/workflow-idempotency.ts +6 -1
  196. package/src/be/db/workflows/read.ts +79 -0
  197. package/src/be/db.ts +129 -152
  198. package/src/be/improvements.ts +24 -2
  199. package/src/be/mcp-proxy.ts +45 -11
  200. package/src/be/memory/embedding-space.ts +10 -20
  201. package/src/be/memory/index.ts +35 -0
  202. package/src/be/memory/providers/openai-embedding.ts +10 -0
  203. package/src/be/migrations/344_user_avatar.sql +4 -0
  204. package/src/be/migrations/345_task_status_kind.sql +6 -0
  205. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  206. package/src/be/migrations/354_durable_objects.sql +9 -0
  207. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  208. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  209. package/src/be/migrations/362_favorites_app.sql +36 -0
  210. package/src/be/primitives/object-embed.ts +2 -2
  211. package/src/be/primitives/objects.ts +2 -2
  212. package/src/be/repo-checked-update.ts +58 -5
  213. package/src/be/requester-timezone.ts +10 -0
  214. package/src/be/runtime-pools/supervisor.ts +1 -0
  215. package/src/be/script-connections.ts +5 -1
  216. package/src/be/script-credential-broker.ts +29 -2
  217. package/src/be/scripts/durable.ts +204 -0
  218. package/src/be/scripts/extract-schema.ts +29 -4
  219. package/src/be/scripts/run-credential.ts +1 -8
  220. package/src/be/scripts/typecheck.ts +33 -8
  221. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  222. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  223. package/src/be/swarm-config-guard.ts +91 -7
  224. package/src/be/users.ts +33 -12
  225. package/src/bitbucket/handlers.ts +1 -1
  226. package/src/comb/review-batch.ts +16 -5
  227. package/src/commands/context-preamble.ts +237 -0
  228. package/src/commands/credential-outcome-report.ts +96 -0
  229. package/src/commands/e2b.ts +14 -0
  230. package/src/commands/entrypoint-mcp-config.ts +231 -0
  231. package/src/commands/onboard/agent-fs-version.ts +1 -1
  232. package/src/commands/onboard/compose-generator.ts +2 -1
  233. package/src/commands/onboard/env-generator.ts +16 -7
  234. package/src/commands/runner.ts +72 -10
  235. package/src/commands/setup.tsx +17 -3
  236. package/src/event-waits/github.ts +39 -6
  237. package/src/event-waits/index.ts +4 -2
  238. package/src/event-waits/types.ts +10 -3
  239. package/src/extensions/contract-types.generated.ts +1 -1
  240. package/src/github/app.ts +177 -13
  241. package/src/github/handlers.ts +7 -2
  242. package/src/github/pull-request-state.ts +100 -11
  243. package/src/gitlab/handlers.ts +2 -2
  244. package/src/heartbeat/heartbeat.ts +6 -1
  245. package/src/hooks/hook.ts +8 -2
  246. package/src/hooks/native-tool-hooks.ts +4 -2
  247. package/src/http/api-keys.ts +26 -0
  248. package/src/http/apps.ts +82 -42
  249. package/src/http/asset-key-write.ts +45 -0
  250. package/src/http/assets.ts +4 -3
  251. package/src/http/comb.ts +21 -5
  252. package/src/http/config.ts +8 -4
  253. package/src/http/github-token.ts +27 -6
  254. package/src/http/heartbeat.ts +5 -0
  255. package/src/http/index.ts +12 -6
  256. package/src/http/kv.ts +7 -5
  257. package/src/http/mcp-oauth.ts +16 -0
  258. package/src/http/mcp-servers.ts +43 -3
  259. package/src/http/memory.ts +28 -1
  260. package/src/http/metrics.ts +11 -4
  261. package/src/http/onboarding.ts +12 -1
  262. package/src/http/pages.ts +4 -10
  263. package/src/http/repos.ts +27 -11
  264. package/src/http/request-principal.ts +27 -1
  265. package/src/http/schedules.ts +42 -14
  266. package/src/http/script-connection-proxy.ts +3 -1
  267. package/src/http/script-runs.ts +21 -10
  268. package/src/http/scripts.ts +177 -26
  269. package/src/http/session-cost-recompute.ts +9 -4
  270. package/src/http/sessions.ts +7 -2
  271. package/src/http/skills.ts +70 -0
  272. package/src/http/status.ts +2 -0
  273. package/src/http/tasks.ts +115 -19
  274. package/src/http/trackers/jira.ts +18 -3
  275. package/src/http/trackers/linear.ts +3 -0
  276. package/src/http/users.ts +5 -0
  277. package/src/http/webhooks.ts +19 -1
  278. package/src/http/workflows.ts +5 -10
  279. package/src/integrations/chat-sdk/commands.ts +3 -1
  280. package/src/jira/sync.ts +1 -1
  281. package/src/kv-limits.ts +2 -0
  282. package/src/kv-reserved-namespaces.ts +25 -2
  283. package/src/linear/sync.ts +5 -3
  284. package/src/prompts/session-templates.ts +50 -0
  285. package/src/prompts/session-turns.ts +30 -0
  286. package/src/providers/acp-targets.ts +2 -2
  287. package/src/providers/amp-adapter.ts +1 -1
  288. package/src/providers/claude-adapter.ts +5 -0
  289. package/src/providers/claude-managed-adapter.ts +14 -0
  290. package/src/providers/claude-sdk-session.ts +19 -1
  291. package/src/providers/cursor-adapter.ts +1 -1
  292. package/src/providers/dsh-adapter.ts +1 -1
  293. package/src/providers/opencode-adapter.ts +3 -5
  294. package/src/providers/runtime-dependencies.ts +11 -8
  295. package/src/rbac/legacy-policy.ts +7 -0
  296. package/src/rbac/permissions.ts +27 -0
  297. package/src/scheduler/deferred-task-waits.ts +74 -13
  298. package/src/scheduler/scheduler.ts +36 -18
  299. package/src/script-workflows/executor.ts +37 -8
  300. package/src/script-workflows/supervisor.ts +14 -0
  301. package/src/scripts-runtime/ctx.ts +5 -1
  302. package/src/scripts-runtime/durable-object-base.ts +19 -0
  303. package/src/scripts-runtime/eval-harness.ts +46 -1
  304. package/src/scripts-runtime/executors/native.ts +13 -1
  305. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  306. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  307. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  308. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  309. package/src/scripts-runtime/executors/types.ts +26 -0
  310. package/src/scripts-runtime/extract-signature.ts +96 -1
  311. package/src/scripts-runtime/loader.ts +11 -5
  312. package/src/scripts-runtime/mcp-client.ts +1 -1
  313. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  314. package/src/scripts-runtime/swarm-config.ts +7 -0
  315. package/src/scripts-runtime/swarm-sdk.ts +12 -2
  316. package/src/scripts-runtime/types/stdlib.d.ts +27 -1
  317. package/src/scripts-runtime/types/swarm-extension.d.ts +20 -2
  318. package/src/scripts-runtime/types/swarm-sdk.d.ts +27 -1
  319. package/src/slack/actions.ts +25 -1
  320. package/src/slack/assistant.ts +8 -0
  321. package/src/slack/blocks.ts +35 -0
  322. package/src/slack/channel-activity.ts +7 -0
  323. package/src/slack/enrich.ts +46 -54
  324. package/src/slack/files.ts +173 -23
  325. package/src/slack/handlers.test.ts +17 -19
  326. package/src/slack/handlers.ts +15 -14
  327. package/src/slack/render-v2.ts +403 -17
  328. package/src/slack/responses.ts +61 -5
  329. package/src/slack/session-mirror.ts +10 -5
  330. package/src/slack/task-output.ts +25 -14
  331. package/src/slack/templates.ts +9 -0
  332. package/src/slack/thread-participants.ts +64 -24
  333. package/src/slack/watcher.ts +4 -4
  334. package/src/slack/work-objects.ts +1 -1
  335. package/src/stdio.ts +5 -0
  336. package/src/tests/agents-list-model-display.test.ts +4 -0
  337. package/src/tests/api-drain-worker-e2e.test.ts +0 -2
  338. package/src/tests/approval-auto-cancellation-migration.test.ts +8 -19
  339. package/src/tests/approval-card-resolution.test.ts +2 -17
  340. package/src/tests/approval-requests-notifications.test.ts +41 -27
  341. package/src/tests/approval-requests.test.ts +137 -369
  342. package/src/tests/apps-script-types.test.ts +63 -16
  343. package/src/tests/apps-sort-order.test.ts +87 -0
  344. package/src/tests/apps-sync-engine.test.ts +5 -3
  345. package/src/tests/apps-table-filters-migration.test.ts +44 -25
  346. package/src/tests/bedrock-model-groups.test.ts +4 -0
  347. package/src/tests/bitbucket-handlers.test.ts +2 -0
  348. package/src/tests/channel-activity.test.ts +9 -0
  349. package/src/tests/chat-sdk-commands.test.ts +1 -0
  350. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  351. package/src/tests/claude-adapter.test.ts +35 -0
  352. package/src/tests/claude-hook-output.test.ts +2 -0
  353. package/src/tests/claude-managed-adapter.test.ts +15 -3
  354. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  355. package/src/tests/codex-adapter.test.ts +3 -92
  356. package/src/tests/codex-gpt6-release.test.ts +4 -9
  357. package/src/tests/codex-oauth-credential-info.test.ts +35 -18
  358. package/src/tests/codex-oauth.test.ts +0 -6
  359. package/src/tests/codex-pool.test.ts +5 -214
  360. package/src/tests/codex-rate-limit-parse.test.ts +0 -7
  361. package/src/tests/codex-swarm-events.test.ts +11 -54
  362. package/src/tests/comb-review-batch.test.ts +17 -4
  363. package/src/tests/comb-status.test.ts +1 -0
  364. package/src/tests/db-client-busy-retry.test.ts +49 -16
  365. package/src/tests/db-client.test.ts +11 -5
  366. package/src/tests/db-task-read-contract.test.ts +1 -0
  367. package/src/tests/db-task-write-contract.test.ts +2 -2
  368. package/src/tests/defer-task.test.ts +24 -1
  369. package/src/tests/dsh-adapter.test.ts +1 -1
  370. package/src/tests/e2b-dispatch.test.ts +13 -1
  371. package/src/tests/e2e-shards.test.ts +9 -9
  372. package/src/tests/enabled-tools.test.ts +0 -2
  373. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  374. package/src/tests/fixtures/base-prompt-baseline.json +6 -6
  375. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  376. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  377. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  378. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  379. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  380. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  381. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  382. package/src/tests/fx-adapter.test.ts +4 -5
  383. package/src/tests/github-app-worker-auth-helper.test.ts +147 -1
  384. package/src/tests/gitlab-handlers.test.ts +2 -0
  385. package/src/tests/heartbeat-jev-gate.test.ts +9 -241
  386. package/src/tests/heartbeat-reroute-decision.test.ts +2 -0
  387. package/src/tests/heartbeat-supersede-resume.test.ts +2 -0
  388. package/src/tests/heartbeat.test.ts +1 -0
  389. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  390. package/src/tests/hook-ping-me-order.test.ts +1 -0
  391. package/src/tests/hook-runtime-close.test.ts +1 -0
  392. package/src/tests/improvements-payload.test.ts +2 -2
  393. package/src/tests/key-usage-selection.test.ts +302 -0
  394. package/src/tests/memory-e2e.test.ts +34 -103
  395. package/src/tests/memory-key-paths.test.ts +5 -0
  396. package/src/tests/memory-rater-llm.test.ts +33 -149
  397. package/src/tests/memory-store.test.ts +24 -125
  398. package/src/tests/memory.test.ts +31 -100
  399. package/src/tests/merge-gate-detect-changes.test.ts +108 -2
  400. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  401. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  402. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  403. package/src/tests/onboard-env.test.ts +1 -1
  404. package/src/tests/openai-compatible-providers.test.ts +5 -0
  405. package/src/tests/openapi-route-headers.test.ts +2 -1
  406. package/src/tests/opus-5-5-registry.test.ts +4 -0
  407. package/src/tests/otel-service-name.test.ts +0 -9
  408. package/src/tests/otel-session-cost-metrics.test.ts +1 -38
  409. package/src/tests/pool-session-logs.test.ts +8 -42
  410. package/src/tests/pre-push-affected-tests.test.ts +106 -0
  411. package/src/tests/prompt-template-session.test.ts +3 -0
  412. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  413. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  414. package/src/tests/runner-api-drain.test.ts +2 -17
  415. package/src/tests/runner-context-preamble.test.ts +202 -0
  416. package/src/tests/runner-repo-clone-args.test.ts +116 -0
  417. package/src/tests/runner-terminal-window-report.test.ts +132 -0
  418. package/src/tests/runtime-supervisor-failures.test.ts +1 -0
  419. package/src/tests/sandboxed-process.test.ts +26 -21
  420. package/src/tests/schedule-http-triage-tools.test.ts +12 -9
  421. package/src/tests/scheduled-tasks.test.ts +14 -51
  422. package/src/tests/scheduler-occurrence.test.ts +60 -9
  423. package/src/tests/script-connections-mcp.test.ts +6 -3
  424. package/src/tests/script-connections.test.ts +4 -0
  425. package/src/tests/script-executor-conformance.test.ts +4 -48
  426. package/src/tests/script-executor-quickjs-pool.test.ts +9 -7
  427. package/src/tests/script-native-startup.test.ts +21 -25
  428. package/src/tests/scripts-namespaces.test.ts +3 -1
  429. package/src/tests/secret-rules.test.ts +4 -2
  430. package/src/tests/secret-scrubber.test.ts +8 -2
  431. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  432. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  433. package/src/tests/session-logs.test.ts +1 -260
  434. package/src/tests/session-route-posture.test.ts +7 -1
  435. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  436. package/src/tests/slack-identity-resolution.test.ts +10 -3
  437. package/src/tests/slack-inline-output.test.ts +10 -8
  438. package/src/tests/slack-render-v2.test.ts +14 -152
  439. package/src/tests/slack-steering.test.ts +8 -2
  440. package/src/tests/slack-thread-participants.test.ts +11 -1
  441. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  442. package/src/tests/swarm-config-encryption.test.ts +5 -8
  443. package/src/tests/task-cascade-fail.test.ts +1 -0
  444. package/src/tests/task-supersede-resume.test.ts +1 -0
  445. package/src/tests/test-proc.ts +5 -2
  446. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  447. package/src/tests/window-stream-reporter.test.ts +122 -0
  448. package/src/tests/workflow-agent-task-retry.test.ts +1 -3
  449. package/src/tests/workflow-cascade-cancel.test.ts +1 -0
  450. package/src/tests/workflow-retry-v2.test.ts +34 -43
  451. package/src/tests/workflow-retry-validation.test.ts +8 -48
  452. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  453. package/src/tests/worktree-reaper.test.ts +2 -2
  454. package/src/tools/app-patch.ts +6 -2
  455. package/src/tools/app-upsert.ts +8 -4
  456. package/src/tools/cancel-task.ts +2 -2
  457. package/src/tools/defer-task.ts +24 -79
  458. package/src/tools/get-task-details.ts +8 -4
  459. package/src/tools/get-tasks.ts +13 -2
  460. package/src/tools/kv/kv-get.ts +2 -0
  461. package/src/tools/kv/kv-list.ts +11 -5
  462. package/src/tools/kv/kv-set.ts +1 -3
  463. package/src/tools/manage-user.ts +9 -0
  464. package/src/tools/repos/update-repo.ts +37 -19
  465. package/src/tools/schedules/run-schedule-now.ts +21 -1
  466. package/src/tools/script-apis.ts +9 -4
  467. package/src/tools/script-common.ts +2 -2
  468. package/src/tools/script-run.ts +8 -0
  469. package/src/tools/script-upsert.ts +1 -1
  470. package/src/tools/slack-download-file.ts +15 -12
  471. package/src/tools/slack-post.ts +7 -1
  472. package/src/tools/slack-read.ts +3 -1
  473. package/src/tools/slack-reply.ts +16 -0
  474. package/src/tools/slack-start-thread.ts +8 -1
  475. package/src/tools/slack-upload-file.ts +99 -96
  476. package/src/tools/store-progress.ts +5 -3
  477. package/src/tools/swarm-config/set-config.ts +3 -1
  478. package/src/tools/swarm-x.ts +0 -2
  479. package/src/tools/utils.ts +3 -0
  480. package/src/types.ts +101 -2
  481. package/src/utils/constants.ts +32 -0
  482. package/src/utils/credentials.ts +42 -5
  483. package/src/utils/deferral-time.ts +61 -0
  484. package/src/utils/error-tracker.ts +6 -0
  485. package/src/utils/key-usage.ts +114 -0
  486. package/src/utils/request-auth-context.ts +15 -16
  487. package/src/utils/sandboxed-process.ts +1 -0
  488. package/src/utils/secret-scrubber.ts +1 -1
  489. package/src/workflows/engine.ts +6 -11
  490. package/src/workflows/executors/swarm-script.ts +0 -2
  491. package/src/workflows/foreach-driver.ts +6 -12
  492. package/src/workflows/input.ts +24 -1
  493. package/src/workflows/node-timeout.ts +18 -0
  494. package/src/workflows/resume.ts +5 -2
  495. package/src/workflows/retry-poller.ts +2 -1
  496. package/src/workflows/triggers.ts +21 -11
  497. package/src/x/composio.ts +10 -1
  498. package/templates/skills/apps/SKILL.md +6 -2
  499. package/templates/skills/apps/content.md +6 -2
  500. package/templates/skills/boards-and-sheets/content.md +4 -2
  501. package/templates/skills/code-quality/content.md +4 -4
  502. package/templates/skills/pages/content.md +7 -0
  503. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  504. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  505. package/templates/skills/swarm-docs/content.md +8 -0
  506. package/templates/skills/swarm-scripts/SKILL.md +45 -0
  507. package/templates/skills/swarm-scripts/content.md +45 -0
  508. package/dist/acp-adapter-mr4temec.js +0 -17
  509. package/dist/cli-1vmhnncj.js +0 -173
  510. package/dist/cli-kj0hyr43.js +0 -51
  511. package/dist/cli-ysv0k1we.js +0 -459
  512. package/dist/core-gsvj5f3z.js +0 -42
  513. package/dist/dsh-adapter-8abzqk5c.js +0 -9
  514. package/dist/fx-adapter-4sjrbdne.js +0 -20
  515. package/dist/grok-adapter-3a0ezfee.js +0 -20
  516. package/dist/handlers-ef3k11hb.js +0 -41
  517. package/dist/index-aetfyx6p.js +0 -13
  518. package/dist/index-e6bq0exk.js +0 -42
  519. package/dist/index-hf2k1vge.js +0 -39
  520. package/dist/index-taxmejj3.js +0 -44
  521. package/dist/lead-5vt6f174.js +0 -83
  522. package/dist/thread-buffer-686pa1p1.js +0 -42
  523. package/dist/worker-4vp616ms.js +0 -83
  524. package/src/tests/apps-table-selection-migration.test.ts +0 -95
  525. package/src/tests/extensions-example-heartbeat-remediate.test.ts +0 -69
  526. package/src/tests/extensions-example-rewrite-and-suppress.test.ts +0 -70
@@ -5,7 +5,7 @@
5
5
  * previously lived in `src/slack/handlers.ts` (Q17.E):
6
6
  *
7
7
  * * `enrichSlackUserEmail(slackUserId)` — kv-backed cache of the user's
8
- * email + display name from `client.users.info`. 24h TTL on success;
8
+ * email, display name and timezone from `client.users.info`. 24h TTL on success;
9
9
  * failures are NEVER cached so rate-limit recovery just works on retry.
10
10
  *
11
11
  * * `resolveSlackUserId(client, slackUserId, ctx)` — the three-step cascade
@@ -26,6 +26,7 @@ import { getKv, upsertKv } from "../be/db";
26
26
  import { type IdentityResolution, resolveIdentity } from "../be/identity";
27
27
  import { recordUnmappedIdentity } from "../be/unmapped-identities";
28
28
  import {
29
+ fillMissingUserTimezone,
29
30
  findOrCreateUserByEmail,
30
31
  findUserByEmail,
31
32
  findUserByExternalId,
@@ -33,6 +34,7 @@ import {
33
34
  linkIdentity,
34
35
  } from "../be/users";
35
36
  import type { SlackParticipantTrust } from "../types";
37
+ import { isValidTimezone } from "../utils/deferral-time";
36
38
 
37
39
  const ENRICHMENT_NAMESPACE = "integration:user-enrichment:slack";
38
40
  const ENRICHMENT_TTL_MS = 24 * 60 * 60 * 1000; // 24h
@@ -42,67 +44,55 @@ const ENRICHMENT_TTL_MS = 24 * 60 * 60 * 1000; // 24h
42
44
  * Q17.E. We keep `name` so future People-page renders don't need to refetch.
43
45
  */
44
46
  interface EnrichedSlackUser {
45
- email: string;
47
+ email: string | null;
46
48
  name: string | null;
49
+ timezone: string | null;
47
50
  fetchedAt: string;
48
51
  }
49
52
 
50
- /**
51
- * Fetch a Slack user's email, caching successful results for 24h in the
52
- * `integration:user-enrichment:slack` kv namespace.
53
- *
54
- * Returns `null` (without caching) when:
55
- * * `client.users.info` throws (network / 5xx / rate-limit).
56
- * * The profile is missing `profile.email` (bot accounts, restricted users).
57
- *
58
- * Caching null would defeat retry-on-recovery, so we intentionally skip the
59
- * cache write on every failure path.
60
- */
61
- export async function enrichSlackUserEmail(
53
+ /** Old cached profiles lack the timezone field. Refresh them on the next lookup. */
54
+ async function enrichSlackUser(
62
55
  client: WebClient,
63
56
  slackUserId: string,
64
- ): Promise<string | null> {
65
- // Cache hit — return the persisted email straight through.
66
- const cached = await getKv(ENRICHMENT_NAMESPACE, slackUserId);
67
- if (cached !== null) {
68
- const payload = cached.value as EnrichedSlackUser;
69
- if (payload?.email) {
70
- return payload.email;
71
- }
72
- // Defensive: if a stale row landed without email somehow, fall through to
73
- // refetch rather than handing back `null` from cache.
74
- }
57
+ ): Promise<EnrichedSlackUser | null> {
58
+ const cached = (await getKv(ENRICHMENT_NAMESPACE, slackUserId))?.value as
59
+ | EnrichedSlackUser
60
+ | undefined;
61
+ if (cached?.email && cached.timezone !== undefined) return cached;
75
62
 
76
- // Cache miss — hit the Slack API.
77
- let email: string | null = null;
78
- let name: string | null = null;
63
+ let profile: EnrichedSlackUser;
79
64
  try {
80
- const result = await client.users.info({ user: slackUserId });
81
- email = result.user?.profile?.email ?? null;
82
- name = result.user?.profile?.real_name ?? result.user?.real_name ?? null;
65
+ const { user } = await client.users.info({ user: slackUserId });
66
+ profile = {
67
+ email: user?.profile?.email ?? null,
68
+ name: user?.profile?.real_name ?? user?.real_name ?? null,
69
+ timezone: isValidTimezone(user?.tz) ? user.tz : null,
70
+ fetchedAt: new Date().toISOString(),
71
+ };
83
72
  } catch (error) {
84
- console.error(`[Slack] enrichSlackUserEmail failed for ${slackUserId}:`, error);
85
- return null;
73
+ console.error(`[Slack] enrichSlackUser failed for ${slackUserId}:`, error);
74
+ return cached?.email ? cached : null;
86
75
  }
87
76
 
88
- if (!email) {
89
- // Q17.E: do NOT cache the no-email case.
90
- return null;
77
+ // A linked user can supply a timezone even when Slack withholds their email.
78
+ // Leave no-email results uncached so an email can be discovered on retry.
79
+ if (profile.email) {
80
+ await upsertKv({
81
+ namespace: ENRICHMENT_NAMESPACE,
82
+ key: slackUserId,
83
+ value: profile,
84
+ valueType: "json",
85
+ expiresAt: Date.now() + ENRICHMENT_TTL_MS,
86
+ });
91
87
  }
88
+ return profile;
89
+ }
92
90
 
93
- await upsertKv({
94
- namespace: ENRICHMENT_NAMESPACE,
95
- key: slackUserId,
96
- value: {
97
- email,
98
- name,
99
- fetchedAt: new Date().toISOString(),
100
- } satisfies EnrichedSlackUser,
101
- valueType: "json",
102
- expiresAt: Date.now() + ENRICHMENT_TTL_MS,
103
- });
104
-
105
- return email;
91
+ export async function enrichSlackUserEmail(
92
+ client: WebClient,
93
+ slackUserId: string,
94
+ ): Promise<string | null> {
95
+ return (await enrichSlackUser(client, slackUserId))?.email ?? null;
106
96
  }
107
97
 
108
98
  /** Audit-trail actor for the auto-link cascade. */
@@ -163,7 +153,8 @@ export async function resolveSlackParticipant(
163
153
  const foreignTeam = sameTeam === false;
164
154
 
165
155
  let user = await findUserByExternalId("slack", slackUserId);
166
- const email = user?.email || (await enrichSlackUserEmail(client, slackUserId));
156
+ const profile = user?.email && user.timezone ? null : await enrichSlackUser(client, slackUserId);
157
+ const email = user?.email || profile?.email;
167
158
 
168
159
  // Another team's profile email is set by that team, not verified as owned by
169
160
  // this sender, so it never links to an existing user. An operator can link
@@ -172,10 +163,7 @@ export async function resolveSlackParticipant(
172
163
  const linkable = !eventContext.userTeam || sameTeam === true;
173
164
  if (!user && email && linkable) {
174
165
  if (isCompanyEmail(email, domains)) {
175
- // Pull the cached name back out for the user-row hints. The kv read is
176
- // cheap (single primary-key lookup) and avoids a second `users.info`.
177
- const cached = await getKv(ENRICHMENT_NAMESPACE, slackUserId);
178
- const name = (cached?.value as EnrichedSlackUser | undefined)?.name ?? undefined;
166
+ const name = profile?.name ?? undefined;
179
167
  user = (await findOrCreateUserByEmail(email, { name, role: "member" }, SLACK_WEBHOOK_ACTOR))
180
168
  .user;
181
169
  } else {
@@ -197,6 +185,10 @@ export async function resolveSlackParticipant(
197
185
  }
198
186
  }
199
187
 
188
+ if (user && !user.timezone && profile?.timezone) {
189
+ await fillMissingUserTimezone(user.id, profile.timezone);
190
+ }
191
+
200
192
  if (!user && !email) {
201
193
  await recordUnmappedIdentity("slack", slackUserId, eventContext);
202
194
  }
@@ -1,6 +1,6 @@
1
- import { createWriteStream } from "node:fs";
2
- import { mkdir } from "node:fs/promises";
3
- import { dirname } from "node:path";
1
+ import { constants } from "node:fs";
2
+ import { type FileHandle, lstat, mkdir, open, realpath, stat } from "node:fs/promises";
3
+ import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
4
4
  import type { WebClient } from "@slack/web-api";
5
5
 
6
6
  /**
@@ -8,10 +8,15 @@ import type { WebClient } from "@slack/web-api";
8
8
  */
9
9
  export const MAX_FILE_SIZE = 1073741824;
10
10
 
11
+ /**
12
+ * Directory that `slack-download-file` saves inside when there is no task.
13
+ */
14
+ export const DOWNLOAD_ROOT = "/workspace/shared/downloads";
15
+
11
16
  /**
12
17
  * Default download directory for Slack files
13
18
  */
14
- export const DEFAULT_DOWNLOAD_DIR = `/workspace/shared/downloads/${process.env.AGENT_ID || "default"}/slack`;
19
+ export const DEFAULT_DOWNLOAD_DIR = `${DOWNLOAD_ROOT}/${process.env.AGENT_ID || "default"}/slack`;
15
20
 
16
21
  /**
17
22
  * File object from Slack API (partial, commonly used fields)
@@ -69,8 +74,10 @@ export interface UploadFileResult {
69
74
  export interface DownloadFileOptions {
70
75
  /** The file object or URL to download from */
71
76
  file: SlackFile | string;
72
- /** Where to save the file. If a directory, uses the original filename. */
77
+ /** Where to save the file. If a directory, uses the original filename. A relative path resolves from `root`. */
73
78
  savePath: string;
79
+ /** Directory the saved file must stay inside. */
80
+ root: string;
74
81
  /** Bot token for authorization */
75
82
  token: string;
76
83
  }
@@ -167,6 +174,113 @@ export async function uploadFile(
167
174
  }
168
175
  }
169
176
 
177
+ /** A regular file opened for reading. The caller closes `handle`. */
178
+ export interface OpenedFile {
179
+ handle: FileHandle;
180
+ size: number;
181
+ }
182
+
183
+ /**
184
+ * Open `path` for reading when its real path is inside one of `roots`.
185
+ * Refuses a symlink at the last part, a file that is not regular, a file over
186
+ * MAX_FILE_SIZE, and a path that leads out of the roots after the open (for
187
+ * example, a parent directory that changed into a symlink).
188
+ */
189
+ export async function openFileInside(
190
+ path: string,
191
+ roots: string[],
192
+ ): Promise<
193
+ { success: true; file: OpenedFile } | { success: false; notFound: boolean; error: string }
194
+ > {
195
+ const outside = {
196
+ success: false as const,
197
+ notFound: false,
198
+ error: `${path} must be a regular file inside ${roots.join(" or ")}.`,
199
+ };
200
+ const inRoots = (real: string) => realRoots.some((root) => isInside(root, real));
201
+ const realRoots: string[] = [];
202
+ for (const root of roots) {
203
+ const real = await realpath(root).catch(() => undefined);
204
+ // A root of "/" would allow every file.
205
+ if (real && real !== "/") realRoots.push(real);
206
+ }
207
+ const real = await realpath(path).catch(() => undefined);
208
+ if (!real) return { success: false, notFound: true, error: `File not found: ${path}` };
209
+ if (!inRoots(real)) return outside;
210
+
211
+ // O_NONBLOCK: opening a FIFO must not hang. O_NOFOLLOW: the last part is not a link.
212
+ let handle: FileHandle;
213
+ try {
214
+ handle = await open(real, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
215
+ } catch {
216
+ return { success: false, notFound: false, error: `Cannot read file: ${path}` };
217
+ }
218
+ try {
219
+ const info = await handle.stat();
220
+ const again = await realpath(real).catch(() => undefined);
221
+ const now = again ? await stat(again).catch(() => undefined) : undefined;
222
+ if (
223
+ !info.isFile() ||
224
+ !again ||
225
+ !inRoots(again) ||
226
+ now?.dev !== info.dev ||
227
+ now?.ino !== info.ino
228
+ ) {
229
+ await handle.close();
230
+ return outside;
231
+ }
232
+ if (info.size > MAX_FILE_SIZE) {
233
+ await handle.close();
234
+ const sizeMB = Math.round(info.size / 1024 / 1024);
235
+ return {
236
+ success: false,
237
+ notFound: false,
238
+ error: `File too large: ${sizeMB} MB. Maximum is 1 GB.`,
239
+ };
240
+ }
241
+ return { success: true, file: { handle, size: info.size } };
242
+ } catch (error) {
243
+ await handle.close();
244
+ throw error;
245
+ }
246
+ }
247
+
248
+ /**
249
+ * Upload an open file to Slack without reading it into memory. It runs the
250
+ * external upload in three steps (get the upload URL, send the bytes from the
251
+ * file descriptor, complete the upload), because `filesUploadV2` reads every
252
+ * input into one buffer. The file must stay open until this resolves.
253
+ */
254
+ export async function uploadOpenFile(
255
+ client: WebClient,
256
+ file: OpenedFile,
257
+ options: Omit<UploadFileOptions, "file" | "channelId"> & { channelId: string },
258
+ ): Promise<UploadFileResult> {
259
+ const { filename, channelId, threadTs, initialComment, title } = options;
260
+ try {
261
+ const ticket = await client.files.getUploadURLExternal({ filename, length: file.size });
262
+ if (!ticket.upload_url || !ticket.file_id) {
263
+ return { success: false, error: "Slack returned no upload URL" };
264
+ }
265
+ const sent = await fetch(ticket.upload_url, {
266
+ method: "POST",
267
+ body: Bun.file(file.handle.fd).slice(0, file.size),
268
+ });
269
+ if (!sent.ok) {
270
+ return { success: false, error: `Upload failed with HTTP ${sent.status}` };
271
+ }
272
+ await client.files.completeUploadExternal({
273
+ files: [{ id: ticket.file_id, title: title || filename }],
274
+ channel_id: channelId,
275
+ ...(threadTs ? { thread_ts: threadTs } : {}),
276
+ ...(initialComment ? { initial_comment: initialComment } : {}),
277
+ });
278
+ return { success: true, fileId: ticket.file_id };
279
+ } catch (error) {
280
+ return { success: false, error: error instanceof Error ? error.message : String(error) };
281
+ }
282
+ }
283
+
170
284
  /**
171
285
  * Download a file from Slack.
172
286
  *
@@ -174,7 +288,7 @@ export async function uploadFile(
174
288
  * @returns Download result with saved path or error
175
289
  */
176
290
  export async function downloadFile(options: DownloadFileOptions): Promise<DownloadFileResult> {
177
- const { file, savePath, token } = options;
291
+ const { file, savePath, token, root } = options;
178
292
 
179
293
  try {
180
294
  // Get the download URL
@@ -187,15 +301,32 @@ export async function downloadFile(options: DownloadFileOptions): Promise<Downlo
187
301
  };
188
302
  }
189
303
 
304
+ // The bot token goes only to Slack's own file hosts.
305
+ if (!isSlackFileUrl(downloadUrl)) {
306
+ return { success: false, error: "The download URL is not a Slack file URL" };
307
+ }
308
+
190
309
  // Determine final save path
191
310
  let finalPath = savePath;
192
311
  if (typeof file !== "string" && (savePath.endsWith("/") || !savePath.includes("."))) {
193
312
  // savePath is a directory, append the filename
194
- finalPath = savePath.endsWith("/") ? `${savePath}${file.name}` : `${savePath}/${file.name}`;
313
+ const name = basename(file.name);
314
+ finalPath = savePath.endsWith("/") ? `${savePath}${name}` : `${savePath}/${name}`;
315
+ }
316
+ finalPath = resolve(root, finalPath);
317
+ if (!isInside(resolve(root), finalPath)) {
318
+ return { success: false, error: `The save path must be inside ${root}` };
195
319
  }
196
320
 
197
- // Ensure directory exists
321
+ // Ensure directory exists, then check that no symlink leads out of root
322
+ await mkdir(root, { recursive: true });
323
+ if ((await lstat(root)).isSymbolicLink()) {
324
+ return { success: false, error: `${root} must not be a symlink` };
325
+ }
198
326
  await mkdir(dirname(finalPath), { recursive: true });
327
+ if (!isInside(await realpath(root), await realpath(dirname(finalPath)))) {
328
+ return { success: false, error: `The save path must be inside ${root}` };
329
+ }
199
330
 
200
331
  // Download the file using fetch with Authorization header
201
332
  const response = await fetch(downloadUrl, {
@@ -220,26 +351,19 @@ export async function downloadFile(options: DownloadFileOptions): Promise<Downlo
220
351
  };
221
352
  }
222
353
 
223
- const writer = createWriteStream(finalPath);
224
- const reader = body.getReader();
225
-
354
+ // O_NOFOLLOW: never write through a symlink at the final path.
355
+ const handle = await open(
356
+ finalPath,
357
+ constants.O_WRONLY | constants.O_CREAT | constants.O_TRUNC | constants.O_NOFOLLOW,
358
+ );
226
359
  try {
227
- while (true) {
228
- const { done, value } = await reader.read();
229
- if (done) break;
230
- writer.write(value);
360
+ for await (const chunk of body) {
361
+ await handle.write(chunk);
231
362
  }
232
- writer.end();
233
363
  } finally {
234
- reader.releaseLock();
364
+ await handle.close();
235
365
  }
236
366
 
237
- // Wait for write to complete
238
- await new Promise<void>((resolve, reject) => {
239
- writer.on("finish", resolve);
240
- writer.on("error", reject);
241
- });
242
-
243
367
  return {
244
368
  success: true,
245
369
  savedPath: finalPath,
@@ -253,6 +377,32 @@ export async function downloadFile(options: DownloadFileOptions): Promise<Downlo
253
377
  }
254
378
  }
255
379
 
380
+ /** True when `child` is `parent` itself or a path below it. */
381
+ function isInside(parent: string, child: string): boolean {
382
+ const rel = relative(parent, child);
383
+ return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
384
+ }
385
+
386
+ /**
387
+ * True for an https URL on a Slack host (`slack.com`, `slack-gov.com` and their
388
+ * subdomains), or on the origin of `SLACK_API_URL` when that override is set.
389
+ */
390
+ function isSlackFileUrl(url: string): boolean {
391
+ let parsed: URL;
392
+ try {
393
+ parsed = new URL(url);
394
+ } catch {
395
+ return false;
396
+ }
397
+ const apiUrl = process.env.SLACK_API_URL;
398
+ if (apiUrl && URL.canParse(apiUrl) && new URL(apiUrl).origin === parsed.origin) return true;
399
+ if (parsed.protocol !== "https:") return false;
400
+ const host = parsed.hostname;
401
+ return ["slack.com", "slack-gov.com"].some(
402
+ (domain) => host === domain || host.endsWith(`.${domain}`),
403
+ );
404
+ }
405
+
256
406
  /**
257
407
  * Check if a file is an image based on mimetype or extension.
258
408
  *
@@ -20,7 +20,7 @@ import {
20
20
  checkUserAccess,
21
21
  isBotMessage,
22
22
  isSwarmThreadRoot,
23
- type isUserAllowed,
23
+ isUserAllowed,
24
24
  LOOKUP_USER_TEAM,
25
25
  registerMessageHandler,
26
26
  type UserFilterConfig,
@@ -198,30 +198,28 @@ describe("isUserAllowed", () => {
198
198
  let enrichSpy: ReturnType<typeof spyOn<typeof slackEnrichModule, "enrichSlackUserEmail">>;
199
199
  let logSpy: ReturnType<typeof spyOn<typeof console, "log">>;
200
200
 
201
- // handlers.ts reads SLACK_ALLOWED_* once at module load, so each case evaluates a fresh
202
- // copy under its own env and calls the production two-argument isUserAllowed. The copy
203
- // shares ./enrich with this file, so the enrichSlackUserEmail spy still applies.
201
+ // isUserAllowed reads SLACK_ALLOWED_* on each call, so each case gets a wrapper that
202
+ // applies its own env for the duration of the call and then restores the old values.
204
203
  const ENV_KEYS = ["SLACK_ALLOWED_EMAIL_DOMAINS", "SLACK_ALLOWED_USER_IDS"] as const;
205
- let loadCount = 0;
206
204
  async function loadIsUserAllowed(env: {
207
205
  SLACK_ALLOWED_EMAIL_DOMAINS?: string;
208
206
  SLACK_ALLOWED_USER_IDS?: string;
209
207
  }): Promise<typeof isUserAllowed> {
210
- const saved = ENV_KEYS.map((key) => [key, process.env[key]] as const);
211
- try {
212
- for (const key of ENV_KEYS) {
213
- if (env[key] === undefined) delete process.env[key];
214
- else process.env[key] = env[key];
215
- }
216
- loadCount += 1;
217
- const fresh = (await import(`./handlers?env=${loadCount}`)) as typeof import("./handlers");
218
- return fresh.isUserAllowed;
219
- } finally {
220
- for (const [key, value] of saved) {
221
- if (value === undefined) delete process.env[key];
222
- else process.env[key] = value;
208
+ return async (...args) => {
209
+ const saved = ENV_KEYS.map((key) => [key, process.env[key]] as const);
210
+ try {
211
+ for (const key of ENV_KEYS) {
212
+ if (env[key] === undefined) delete process.env[key];
213
+ else process.env[key] = env[key];
214
+ }
215
+ return await isUserAllowed(...args);
216
+ } finally {
217
+ for (const [key, value] of saved) {
218
+ if (value === undefined) delete process.env[key];
219
+ else process.env[key] = value;
220
+ }
223
221
  }
224
- }
222
+ };
225
223
  }
226
224
 
227
225
  beforeEach(() => {
@@ -81,17 +81,6 @@ const SlackRouteModifySchema = z
81
81
  })
82
82
  .strict();
83
83
 
84
- // User filtering configuration from environment variables
85
- const allowedEmailDomains = (process.env.SLACK_ALLOWED_EMAIL_DOMAINS || "")
86
- .split(",")
87
- .map((d) => d.trim().toLowerCase())
88
- .filter(Boolean);
89
-
90
- const allowedUserIds = (process.env.SLACK_ALLOWED_USER_IDS || "")
91
- .split(",")
92
- .map((id) => id.trim())
93
- .filter(Boolean);
94
-
95
84
  /**
96
85
  * Configuration for user filtering.
97
86
  */
@@ -100,7 +89,19 @@ export interface UserFilterConfig {
100
89
  allowedUserIds: string[];
101
90
  }
102
91
 
103
- const envUserFilterConfig: UserFilterConfig = { allowedEmailDomains, allowedUserIds };
92
+ /** The SLACK_ALLOWED_* env vars, read on each call so a config reload applies at once. */
93
+ function envUserFilterConfig(): UserFilterConfig {
94
+ return {
95
+ allowedEmailDomains: (process.env.SLACK_ALLOWED_EMAIL_DOMAINS || "")
96
+ .split(",")
97
+ .map((d) => d.trim().toLowerCase())
98
+ .filter(Boolean),
99
+ allowedUserIds: (process.env.SLACK_ALLOWED_USER_IDS || "")
100
+ .split(",")
101
+ .map((id) => id.trim())
102
+ .filter(Boolean),
103
+ };
104
+ }
104
105
 
105
106
  /**
106
107
  * Core logic for checking if a user is allowed based on email and/or user ID.
@@ -158,14 +159,14 @@ export const LOOKUP_USER_TEAM: unique symbol = Symbol.for("agent-swarm.slack.loo
158
159
  * Check if a user is allowed to interact with the swarm.
159
160
  * Returns true if filtering is disabled, user is in whitelist, or user's email domain is allowed.
160
161
  * The allow/deny decision is `checkUserAccess`; this wrapper only adds the lazy email lookup
161
- * and the deny logs. The config comes from the SLACK_ALLOWED_* env vars, read at module load.
162
+ * and the deny logs. The config comes from the SLACK_ALLOWED_* env vars, read on each call.
162
163
  */
163
164
  export async function isUserAllowed(
164
165
  client: WebClient,
165
166
  userId: string,
166
167
  userTeam?: string | typeof LOOKUP_USER_TEAM,
167
168
  ): Promise<boolean> {
168
- const config = envUserFilterConfig;
169
+ const config = envUserFilterConfig();
169
170
  // Decide without an email first: filtering off and allowlisted IDs pass, and with no
170
171
  // email domains configured an unlisted ID is denied. Only domain checks need a lookup.
171
172
  const allowedWithoutEmail = checkUserAccess(userId, null, config);