@desplega.ai/agent-swarm 2.13.5 → 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 (414) hide show
  1. package/dist/acp-adapter-99n6z9ky.js +17 -0
  2. package/dist/{acp-targets-w8dbs4nr.js → acp-targets-23exz4z4.js} +10 -10
  3. package/dist/{actions-8zrcbjrx.js → actions-zcr25x27.js} +60 -39
  4. package/dist/{agent-fs-provision-cbt2ttds.js → agent-fs-provision-7fa9e12e.js} +4 -4
  5. package/dist/{amp-adapter-8x6zp8w4.js → amp-adapter-s7ytmv6b.js} +3 -3
  6. package/dist/{app-zfa9dwjw.js → app-5d3sz1hy.js} +7 -7
  7. package/dist/{approval-notifications-rv92zmza.js → approval-notifications-7qgkzkzx.js} +8 -8
  8. package/dist/{assistant-q7s7rm1q.js → assistant-p2yvhc3j.js} +37 -32
  9. package/dist/{boot-args-schema-g27kpzr1.js → boot-args-schema-ry6cb0p7.js} +1 -1
  10. package/dist/{boot-reembed-1mjs52nt.js → boot-reembed-2hkm3vz2.js} +1 -1
  11. package/dist/{boot-reembed-m62dpdkg.js → boot-reembed-c9643ms3.js} +1 -1
  12. package/dist/{boot-scrub-sweep-ss1vcamw.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
  13. package/dist/{boot-seeds-hwnvgbb3.js → boot-seeds-2hzvvzg0.js} +4 -4
  14. package/dist/{boxd-y0szhp0g.js → boxd-9py3x0jb.js} +2 -2
  15. package/dist/{claude-adapter-0rjmbhjk.js → claude-adapter-dnkww93e.js} +9 -9
  16. package/dist/{claude-managed-adapter-6k032agg.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
  17. package/dist/{claude-managed-setup-6czvve8q.js → claude-managed-setup-4byxpp47.js} +5 -5
  18. package/dist/{claude-sdk-session-pr0znb81.js → claude-sdk-session-4wf3dbvs.js} +12467 -12285
  19. package/dist/{cli-t0n9svkb.js → cli-096aftq6.js} +12 -7
  20. package/dist/{cli-2wzkvfgm.js → cli-0e914dp9.js} +3 -3
  21. package/dist/{cli-vcpyttcw.js → cli-0h6m6z5g.js} +1 -1
  22. package/dist/{cli-q41qar56.js → cli-0k7ppk9k.js} +130 -8
  23. package/dist/{cli-ks06cd0n.js → cli-1nfabrt4.js} +8 -8
  24. package/dist/{cli-ebpq3c5z.js → cli-2414h5r9.js} +8 -8
  25. package/dist/{cli-nrt048ys.js → cli-24wervhz.js} +37 -0
  26. package/dist/{cli-pedm2kht.js → cli-2ayk9gn8.js} +2 -2
  27. package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
  28. package/dist/{cli-evy3egte.js → cli-2savn6mm.js} +11 -100
  29. package/dist/{cli-n79j1vxc.js → cli-2zjxake1.js} +4 -4
  30. package/dist/{cli-z3x7h79n.js → cli-37p61fcg.js} +9 -9
  31. package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
  32. package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
  33. package/dist/{cli-34fygf87.js → cli-3wsabyt0.js} +2 -2
  34. package/dist/{cli-grbngev5.js → cli-466jjrwe.js} +11 -2
  35. package/dist/{cli-zxa1vmx7.js → cli-6ajyhxh7.js} +2 -2
  36. package/dist/{cli-bvamr9g0.js → cli-6yy4fepf.js} +4 -4
  37. package/dist/{cli-3vw6dd4g.js → cli-73rmgm45.js} +2 -2
  38. package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
  39. package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
  40. package/dist/{cli-srre41gb.js → cli-7w1fs01q.js} +2 -2
  41. package/dist/{cli-tgc1kgg3.js → cli-84wxwt3z.js} +1 -1
  42. package/dist/{cli-4gaf3tx5.js → cli-84xn7bgz.js} +1 -1
  43. package/dist/{cli-s8dhq7rj.js → cli-879txsac.js} +5 -5
  44. package/dist/{cli-9n6g14vs.js → cli-8vbxjzk0.js} +3 -3
  45. package/dist/{cli-cmbb2t8a.js → cli-91amj3md.js} +2 -2
  46. package/dist/{cli-ewk3sg68.js → cli-930zbczq.js} +3 -3
  47. package/dist/{cli-6msnpj1z.js → cli-9fwznq4p.js} +10 -10
  48. package/dist/{cli-qmx8bnt4.js → cli-9j1t3kf6.js} +2 -2
  49. package/dist/{cli-t879ww0y.js → cli-9j47sgzy.js} +2 -2
  50. package/dist/{cli-0qt3epg4.js → cli-ad00h1st.js} +7 -7
  51. package/dist/{cli-avax5mp9.js → cli-adzmmcvf.js} +19 -7
  52. package/dist/{cli-ffn0a515.js → cli-ayxxkk3p.js} +68 -25
  53. package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
  54. package/dist/{cli-887vhew6.js → cli-cbg0j1yt.js} +2716 -2643
  55. package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
  56. package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
  57. package/dist/{cli-emdfd8fh.js → cli-dy754erz.js} +9 -1
  58. package/dist/{cli-3860pmrq.js → cli-edxfzgah.js} +4 -4
  59. package/dist/{cli-v09eza21.js → cli-ejnhs815.js} +15 -15
  60. package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
  61. package/dist/{cli-b42yfn17.js → cli-f2rwt43y.js} +13 -13
  62. package/dist/{cli-tvyt8w6n.js → cli-f9g96z28.js} +8 -8
  63. package/dist/{cli-zbbtp02a.js → cli-fww016hh.js} +457 -70
  64. package/dist/{cli-vbge4rsp.js → cli-g6a696c0.js} +4 -4
  65. package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
  66. package/dist/{cli-5tq15aa7.js → cli-gcyws2bp.js} +2 -2
  67. package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
  68. package/dist/{cli-cp163xga.js → cli-jcnc5ret.js} +44 -32
  69. package/dist/{cli-j69pzrrz.js → cli-jgq9xptq.js} +5 -5
  70. package/dist/{cli-kwj3131p.js → cli-jwnac23b.js} +1 -1
  71. package/dist/{cli-wzecestt.js → cli-kc7vd07m.js} +616 -289
  72. package/dist/{cli-8pd1t17c.js → cli-kg63yp1r.js} +14 -14
  73. package/dist/{cli-zzq96q57.js → cli-krk8y8c7.js} +727 -139
  74. package/dist/{cli-5web09sb.js → cli-m0ea8ggd.js} +8 -10
  75. package/dist/{cli-qrvk9nka.js → cli-md4tn21h.js} +13 -13
  76. package/dist/{cli-1jq2em7b.js → cli-mv8ft7b0.js} +10 -9
  77. package/dist/{cli-ryem5cfq.js → cli-mw1tmn3x.js} +217 -27
  78. package/dist/{cli-abby987g.js → cli-njvpngc6.js} +3 -3
  79. package/dist/{cli-55h8m1x3.js → cli-phe2vcw5.js} +6 -6
  80. package/dist/{cli-prz1p3ft.js → cli-pq0kv31y.js} +5 -5
  81. package/dist/{cli-q1h041y8.js → cli-q457ga28.js} +6 -6
  82. package/dist/{cli-z40t85ms.js → cli-q5n3deaf.js} +1 -1
  83. package/dist/{cli-7ypg8hka.js → cli-qkbevqer.js} +3 -3
  84. package/dist/{cli-f9xw9pr4.js → cli-qrwjk4xy.js} +5 -5
  85. package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
  86. package/dist/{cli-zntvmqmm.js → cli-r495stwd.js} +2 -2
  87. package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
  88. package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
  89. package/dist/{cli-sejvnjvw.js → cli-rs1rzwp4.js} +1 -1
  90. package/dist/{cli-94mxerrp.js → cli-rzbsh6bw.js} +1 -1
  91. package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
  92. package/dist/{cli-hd5bm1e1.js → cli-shyhb4t5.js} +10 -10
  93. package/dist/{cli-r3dxpmyt.js → cli-srq69pn1.js} +1 -1
  94. package/dist/{cli-7r9tvk8v.js → cli-tc165vrb.js} +8 -3
  95. package/dist/{cli-ced4azn1.js → cli-v4z5v3jd.js} +298 -80
  96. package/dist/{cli-ehg90jd1.js → cli-vxmmttmt.js} +55 -50
  97. package/dist/{cli-tt7dkwjj.js → cli-w4bvtxet.js} +7 -7
  98. package/dist/{cli-x2adbg4j.js → cli-wd7b5hgc.js} +1 -1
  99. package/dist/{cli-htb5bpz2.js → cli-wvbaq052.js} +1 -1
  100. package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
  101. package/dist/{cli-19d6v8er.js → cli-wym6rxgt.js} +165 -6
  102. package/dist/{cli-f7b9nyvk.js → cli-yd7e590v.js} +12 -12
  103. package/dist/{cli-69zzpjgh.js → cli-yjb3cddd.js} +1 -1
  104. package/dist/{cli-5n9w2xzx.js → cli-z8t4485r.js} +2 -2
  105. package/dist/{cli-jdq3jmny.js → cli-ze1ndjs4.js} +4 -6
  106. package/dist/cli.js +28 -28
  107. package/dist/{codex-adapter-bn7eaxk5.js → codex-adapter-eq61radw.js} +8 -8
  108. package/dist/{codex-hook-nnmezjg9.js → codex-hook-8nmepvz6.js} +3 -3
  109. package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
  110. package/dist/{codex-session-runner-j1e9hffc.js → codex-session-runner-rfx355h4.js} +9 -9
  111. package/dist/{commands-amhpafrr.js → commands-d1z0sx62.js} +3 -3
  112. package/dist/{controller-tw7g10j2.js → controller-9hz6d8x3.js} +4 -4
  113. package/dist/{controllers-connect-2ssqz7f4.js → controllers-connect-tz07d2xr.js} +24 -25
  114. package/dist/core-dynsv289.js +41 -0
  115. package/dist/{cursor-adapter-d6knjmwa.js → cursor-adapter-ef22ze3j.js} +2 -2
  116. package/dist/{db-fd6xxm77.js → db-gd81d68c.js} +3 -3
  117. package/dist/{db-sc59379z.js → db-vrckks6q.js} +4 -2
  118. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
  119. package/dist/{dispatcher-a2gdqz8c.js → dispatcher-76as8w2t.js} +21 -22
  120. package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
  121. package/dist/dsh-adapter-ypfvcdyz.js +11 -0
  122. package/dist/{e2b-cn7cvjqy.js → e2b-05kn3kpq.js} +16 -5
  123. package/dist/{e2b-qnxyfea6.js → e2b-dm9r8hpy.js} +3 -3
  124. package/dist/{easter-egg-3d-a0pphy71.js → easter-egg-3d-sg21j15g.js} +1 -1
  125. package/dist/{embedding-space-qepzrach.js → embedding-space-zsdw37bb.js} +13 -23
  126. package/dist/{embeddings-d7vr881x.js → embeddings-p4e3e1m6.js} +1 -1
  127. package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
  128. package/dist/{execute-6afts2bn.js → execute-nztd0af0.js} +1 -1
  129. package/dist/{external-channel-881zq1x4.js → external-channel-717yzn4d.js} +2 -2
  130. package/dist/fx-adapter-9k0hptnz.js +20 -0
  131. package/dist/grok-adapter-skdj2pce.js +20 -0
  132. package/dist/handlers-5btjqkz6.js +39 -0
  133. package/dist/{heartbeat-4c022m6a.js → heartbeat-vfb1gy84.js} +24 -25
  134. package/dist/{hook-a7eh6zty.js → hook-ctz0xmp3.js} +11 -11
  135. package/dist/{hook-4k84x499.js → hook-eh52p7yd.js} +6 -6
  136. package/dist/{http-6aw5wanc.js → http-zregegrx.js} +784 -166
  137. package/dist/{index-xhad0n8m.js → index-5kx15d19.js} +1 -1
  138. package/dist/index-7w8p6em0.js +41 -0
  139. package/dist/index-evay0xyk.js +17 -0
  140. package/dist/{index-yq9hhhhy.js → index-fdym6ryb.js} +25 -26
  141. package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
  142. package/dist/index-vz4semsx.js +38 -0
  143. package/dist/{index-z2g9469g.js → index-x9qf8dg7.js} +108 -28
  144. package/dist/index-y3s0xp2v.js +43 -0
  145. package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
  146. package/dist/{keepalive-zhbmztqw.js → keepalive-zdqay870.js} +4 -5
  147. package/dist/lead-6cscw8a5.js +82 -0
  148. package/dist/{maintenance-rsp0591h.js → maintenance-t5ndg11m.js} +1 -1
  149. package/dist/{node-rxte5hc6.js → node-jkdd5w7m.js} +1 -1
  150. package/dist/{oauth-refresh-sweep-w3cqmxq7.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
  151. package/dist/{object-webhooks-331hay92.js → object-webhooks-mkca91s0.js} +7 -7
  152. package/dist/{onboard-n2w80m2n.js → onboard-ss995244.js} +11 -9
  153. package/dist/{opencode-adapter-z98127cz.js → opencode-adapter-mwpz0278.js} +8 -8
  154. package/dist/{otel-impl-xsk35tvf.js → otel-impl-6n6vva3x.js} +2 -2
  155. package/dist/{pending-2e6trkxd.js → pending-2sxh1t6j.js} +22 -23
  156. package/dist/{pi-mono-adapter-wh6yndtm.js → pi-mono-adapter-sfb7zy43.js} +13 -13
  157. package/dist/{pricing-refresh-9355dj1t.js → pricing-refresh-h79bg4cf.js} +2 -2
  158. package/dist/{rbac-roles-8eajw4s6.js → rbac-roles-ckq0czp4.js} +2 -2
  159. package/dist/{rbac-roles-58y3m912.js → rbac-roles-jg2e260w.js} +3 -3
  160. package/dist/{render-v2-7gskkmd4.js → render-v2-ymbshmn0.js} +7 -7
  161. package/dist/{resume-0drnmpja.js → resume-jdhnt4jk.js} +10 -10
  162. package/dist/{runtime-d2tcmqte.js → runtime-y28jhhnf.js} +1 -1
  163. package/dist/{session-access-0ztys6bd.js → session-access-k4ta5hvp.js} +5 -5
  164. package/dist/{session-source-backfill-cdm5s046.js → session-source-backfill-528j4s8j.js} +3 -3
  165. package/dist/{setup-pqwb9tcc.js → setup-d6pj82fr.js} +15 -6
  166. package/dist/thread-buffer-9w6x5zec.js +40 -0
  167. package/dist/{tree-visibility-rwz67mje.js → tree-visibility-kjxv3nxk.js} +2 -2
  168. package/dist/{user-merge-jobs-mxrhamwt.js → user-merge-jobs-rabbncf6.js} +3 -3
  169. package/dist/{virtual-modules-71y1gsmg.js → virtual-modules-22k51txd.js} +3 -3
  170. package/dist/{work-objects-3k4ykt9j.js → work-objects-xtjbar3r.js} +26 -30
  171. package/dist/{worker-follow-up-y0h64xpr.js → worker-follow-up-fg48vk6d.js} +21 -22
  172. package/dist/worker-g4aj93dt.js +82 -0
  173. package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
  174. package/openapi.json +247 -20
  175. package/package.json +10 -10
  176. package/src/apps/definition.ts +76 -24
  177. package/src/apps/row-store.ts +67 -0
  178. package/src/apps/script-types.ts +131 -21
  179. package/src/apps/store.ts +4 -1
  180. package/src/be/db/script-runs.ts +33 -0
  181. package/src/be/db/slack-card-groups.ts +147 -0
  182. package/src/be/db/slack-trees.ts +26 -0
  183. package/src/be/db/task-idempotency.ts +63 -0
  184. package/src/be/db/tasks/read.ts +2 -0
  185. package/src/be/db/tasks/write.ts +4 -2
  186. package/src/be/db/workflow-idempotency.ts +6 -1
  187. package/src/be/db/workflows/read.ts +79 -0
  188. package/src/be/db.ts +51 -147
  189. package/src/be/improvements.ts +24 -2
  190. package/src/be/mcp-proxy.ts +45 -11
  191. package/src/be/memory/embedding-space.ts +10 -20
  192. package/src/be/memory/index.ts +35 -0
  193. package/src/be/memory/providers/openai-embedding.ts +10 -0
  194. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  195. package/src/be/migrations/354_durable_objects.sql +9 -0
  196. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  197. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  198. package/src/be/migrations/362_favorites_app.sql +36 -0
  199. package/src/be/repo-checked-update.ts +58 -5
  200. package/src/be/requester-timezone.ts +10 -0
  201. package/src/be/script-connections.ts +5 -1
  202. package/src/be/script-credential-broker.ts +29 -2
  203. package/src/be/scripts/durable.ts +204 -0
  204. package/src/be/scripts/extract-schema.ts +29 -4
  205. package/src/be/scripts/run-credential.ts +1 -8
  206. package/src/be/scripts/typecheck.ts +32 -7
  207. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  208. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  209. package/src/be/swarm-config-guard.ts +87 -7
  210. package/src/be/users.ts +33 -12
  211. package/src/comb/review-batch.ts +16 -5
  212. package/src/commands/context-preamble.ts +237 -0
  213. package/src/commands/e2b.ts +14 -0
  214. package/src/commands/entrypoint-mcp-config.ts +231 -0
  215. package/src/commands/onboard/agent-fs-version.ts +1 -1
  216. package/src/commands/onboard/compose-generator.ts +2 -1
  217. package/src/commands/onboard/env-generator.ts +16 -7
  218. package/src/commands/runner.ts +23 -7
  219. package/src/commands/setup.tsx +17 -3
  220. package/src/extensions/contract-types.generated.ts +1 -1
  221. package/src/hooks/hook.ts +8 -2
  222. package/src/hooks/native-tool-hooks.ts +4 -2
  223. package/src/http/apps.ts +82 -42
  224. package/src/http/comb.ts +21 -5
  225. package/src/http/config.ts +8 -4
  226. package/src/http/heartbeat.ts +5 -0
  227. package/src/http/index.ts +12 -6
  228. package/src/http/kv.ts +7 -5
  229. package/src/http/mcp-oauth.ts +16 -0
  230. package/src/http/mcp-servers.ts +43 -3
  231. package/src/http/memory.ts +28 -1
  232. package/src/http/metrics.ts +11 -4
  233. package/src/http/onboarding.ts +12 -1
  234. package/src/http/repos.ts +27 -11
  235. package/src/http/request-principal.ts +27 -1
  236. package/src/http/schedules.ts +36 -8
  237. package/src/http/script-connection-proxy.ts +3 -1
  238. package/src/http/script-runs.ts +21 -10
  239. package/src/http/scripts.ts +177 -26
  240. package/src/http/session-cost-recompute.ts +9 -4
  241. package/src/http/skills.ts +70 -0
  242. package/src/http/status.ts +2 -0
  243. package/src/http/tasks.ts +92 -14
  244. package/src/http/trackers/jira.ts +18 -3
  245. package/src/http/trackers/linear.ts +3 -0
  246. package/src/kv-limits.ts +2 -0
  247. package/src/kv-reserved-namespaces.ts +25 -2
  248. package/src/prompts/session-templates.ts +49 -0
  249. package/src/prompts/session-turns.ts +30 -0
  250. package/src/providers/amp-adapter.ts +1 -1
  251. package/src/providers/claude-managed-adapter.ts +14 -0
  252. package/src/providers/claude-sdk-session.ts +14 -1
  253. package/src/providers/cursor-adapter.ts +1 -1
  254. package/src/providers/dsh-adapter.ts +1 -1
  255. package/src/providers/opencode-adapter.ts +3 -5
  256. package/src/providers/runtime-dependencies.ts +11 -8
  257. package/src/rbac/legacy-policy.ts +7 -0
  258. package/src/rbac/permissions.ts +27 -0
  259. package/src/scheduler/scheduler.ts +36 -18
  260. package/src/script-workflows/executor.ts +37 -8
  261. package/src/script-workflows/supervisor.ts +14 -0
  262. package/src/scripts-runtime/ctx.ts +5 -1
  263. package/src/scripts-runtime/durable-object-base.ts +19 -0
  264. package/src/scripts-runtime/eval-harness.ts +46 -1
  265. package/src/scripts-runtime/executors/native.ts +13 -1
  266. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  267. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  268. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  269. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  270. package/src/scripts-runtime/executors/types.ts +26 -0
  271. package/src/scripts-runtime/extract-signature.ts +96 -1
  272. package/src/scripts-runtime/loader.ts +11 -5
  273. package/src/scripts-runtime/mcp-client.ts +1 -1
  274. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  275. package/src/scripts-runtime/swarm-config.ts +7 -0
  276. package/src/scripts-runtime/swarm-sdk.ts +4 -1
  277. package/src/scripts-runtime/types/stdlib.d.ts +19 -0
  278. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  279. package/src/scripts-runtime/types/swarm-sdk.d.ts +19 -0
  280. package/src/slack/actions.ts +24 -0
  281. package/src/slack/assistant.ts +8 -0
  282. package/src/slack/blocks.ts +35 -0
  283. package/src/slack/channel-activity.ts +7 -0
  284. package/src/slack/enrich.ts +46 -54
  285. package/src/slack/files.ts +173 -23
  286. package/src/slack/handlers.test.ts +17 -19
  287. package/src/slack/handlers.ts +15 -14
  288. package/src/slack/render-v2.ts +264 -19
  289. package/src/slack/responses.ts +61 -5
  290. package/src/slack/session-mirror.ts +10 -5
  291. package/src/slack/task-output.ts +25 -14
  292. package/src/slack/templates.ts +9 -0
  293. package/src/slack/thread-participants.ts +64 -24
  294. package/src/slack/watcher.ts +4 -4
  295. package/src/slack/work-objects.ts +1 -1
  296. package/src/stdio.ts +5 -0
  297. package/src/tests/agents-list-model-display.test.ts +4 -0
  298. package/src/tests/apps-script-types.test.ts +63 -16
  299. package/src/tests/apps-sort-order.test.ts +87 -0
  300. package/src/tests/bedrock-model-groups.test.ts +4 -0
  301. package/src/tests/channel-activity.test.ts +9 -0
  302. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  303. package/src/tests/claude-hook-output.test.ts +2 -0
  304. package/src/tests/claude-managed-adapter.test.ts +15 -3
  305. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  306. package/src/tests/codex-gpt6-release.test.ts +4 -0
  307. package/src/tests/comb-review-batch.test.ts +17 -4
  308. package/src/tests/comb-status.test.ts +1 -0
  309. package/src/tests/db-client.test.ts +11 -5
  310. package/src/tests/db-task-read-contract.test.ts +1 -0
  311. package/src/tests/db-task-write-contract.test.ts +2 -2
  312. package/src/tests/defer-task.test.ts +23 -1
  313. package/src/tests/dsh-adapter.test.ts +1 -1
  314. package/src/tests/e2b-dispatch.test.ts +13 -1
  315. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  316. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  317. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  318. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  319. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  320. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  321. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  322. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  323. package/src/tests/fx-adapter.test.ts +4 -5
  324. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  325. package/src/tests/hook-ping-me-order.test.ts +1 -0
  326. package/src/tests/hook-runtime-close.test.ts +1 -0
  327. package/src/tests/improvements-payload.test.ts +2 -2
  328. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  329. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  330. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  331. package/src/tests/onboard-env.test.ts +1 -1
  332. package/src/tests/openai-compatible-providers.test.ts +5 -0
  333. package/src/tests/openapi-route-headers.test.ts +2 -1
  334. package/src/tests/opus-5-5-registry.test.ts +4 -0
  335. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  336. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  337. package/src/tests/runner-context-preamble.test.ts +202 -0
  338. package/src/tests/runner-repo-clone-args.test.ts +116 -0
  339. package/src/tests/scheduler-occurrence.test.ts +60 -9
  340. package/src/tests/script-connections-mcp.test.ts +6 -3
  341. package/src/tests/script-connections.test.ts +4 -0
  342. package/src/tests/scripts-namespaces.test.ts +3 -1
  343. package/src/tests/secret-scrubber.test.ts +8 -2
  344. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  345. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  346. package/src/tests/session-route-posture.test.ts +7 -1
  347. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  348. package/src/tests/slack-identity-resolution.test.ts +10 -3
  349. package/src/tests/slack-inline-output.test.ts +10 -8
  350. package/src/tests/slack-render-v2.test.ts +9 -4
  351. package/src/tests/slack-steering.test.ts +8 -2
  352. package/src/tests/slack-thread-participants.test.ts +11 -1
  353. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  354. package/src/tests/swarm-config-encryption.test.ts +5 -8
  355. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  356. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  357. package/src/tools/app-patch.ts +6 -2
  358. package/src/tools/app-upsert.ts +8 -4
  359. package/src/tools/defer-task.ts +17 -77
  360. package/src/tools/kv/kv-get.ts +2 -0
  361. package/src/tools/kv/kv-list.ts +11 -5
  362. package/src/tools/kv/kv-set.ts +1 -3
  363. package/src/tools/repos/update-repo.ts +37 -19
  364. package/src/tools/schedules/run-schedule-now.ts +21 -1
  365. package/src/tools/script-apis.ts +9 -4
  366. package/src/tools/script-common.ts +2 -2
  367. package/src/tools/script-run.ts +8 -0
  368. package/src/tools/script-upsert.ts +1 -1
  369. package/src/tools/slack-download-file.ts +15 -12
  370. package/src/tools/slack-post.ts +7 -1
  371. package/src/tools/slack-read.ts +3 -1
  372. package/src/tools/slack-reply.ts +16 -0
  373. package/src/tools/slack-start-thread.ts +8 -1
  374. package/src/tools/slack-upload-file.ts +99 -96
  375. package/src/tools/swarm-config/set-config.ts +3 -1
  376. package/src/tools/swarm-x.ts +0 -2
  377. package/src/tools/utils.ts +3 -0
  378. package/src/types.ts +8 -2
  379. package/src/utils/constants.ts +20 -0
  380. package/src/utils/deferral-time.ts +61 -0
  381. package/src/utils/request-auth-context.ts +15 -16
  382. package/src/utils/secret-scrubber.ts +1 -1
  383. package/src/workflows/engine.ts +6 -11
  384. package/src/workflows/executors/swarm-script.ts +0 -2
  385. package/src/workflows/foreach-driver.ts +6 -12
  386. package/src/workflows/input.ts +24 -1
  387. package/src/workflows/node-timeout.ts +18 -0
  388. package/src/workflows/retry-poller.ts +2 -1
  389. package/src/workflows/triggers.ts +21 -11
  390. package/src/x/composio.ts +10 -1
  391. package/templates/skills/apps/SKILL.md +4 -2
  392. package/templates/skills/apps/content.md +4 -2
  393. package/templates/skills/code-quality/content.md +4 -4
  394. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  395. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  396. package/templates/skills/swarm-docs/content.md +7 -0
  397. package/templates/skills/swarm-scripts/SKILL.md +44 -0
  398. package/templates/skills/swarm-scripts/content.md +44 -0
  399. package/dist/acp-adapter-tbt61zkm.js +0 -17
  400. package/dist/cli-b9ygp1kz.js +0 -459
  401. package/dist/cli-kj0hyr43.js +0 -51
  402. package/dist/cli-m8f4379k.js +0 -173
  403. package/dist/core-bwp98v4w.js +0 -42
  404. package/dist/dsh-adapter-43ygwqn7.js +0 -9
  405. package/dist/fx-adapter-cr2hq17y.js +0 -20
  406. package/dist/grok-adapter-ayddnbsc.js +0 -20
  407. package/dist/handlers-7ghs84x2.js +0 -41
  408. package/dist/index-dtt0d634.js +0 -44
  409. package/dist/index-hmszyqkk.js +0 -42
  410. package/dist/index-j6rm1rtn.js +0 -39
  411. package/dist/index-rwwhsmjg.js +0 -13
  412. package/dist/lead-g2j4q39z.js +0 -83
  413. package/dist/thread-buffer-epx3san4.js +0 -42
  414. package/dist/worker-09gqn9xy.js +0 -83
@@ -1,8 +1,9 @@
1
+ import { basename } from "node:path";
1
2
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
3
  import * as z from "zod";
3
4
  import { getAgentById } from "@/be/db";
4
5
  import { getSlackApp } from "@/slack/app";
5
- import { DEFAULT_DOWNLOAD_DIR, downloadFile, getFileInfo } from "@/slack/files";
6
+ import { DEFAULT_DOWNLOAD_DIR, DOWNLOAD_ROOT, downloadFile, getFileInfo } from "@/slack/files";
6
7
  import { attachableTask, attachSlackFilesForAgent } from "@/slack/inbound-files";
7
8
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
8
9
 
@@ -17,7 +18,7 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
17
18
  {
18
19
  title: "Download file from Slack",
19
20
  description:
20
- "Download a file from Slack by file ID or URL. From a task, the file is stored as an attachment of that task and the result carries a ready-to-run `fetchCommand` to get the bytes into your container. Without a task, the file is saved on the API server's disk, which your container usually can't read.",
21
+ "Download a file from Slack by file ID or Slack file URL. From a task, the file is stored as an attachment of that task and the result carries a ready-to-run `fetchCommand` to get the bytes into your container. Without a task, the file is saved under /workspace/shared/downloads/ on the API server's disk, which your container usually can't read.",
21
22
  // Not read-only: from a task it uploads the file and records an attachment.
22
23
  annotations: { readOnlyHint: false, openWorldHint: true },
23
24
 
@@ -30,7 +31,9 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
30
31
  .string()
31
32
  .url()
32
33
  .optional()
33
- .describe("Direct URL to download (url_private_download from a file object)."),
34
+ .describe(
35
+ "Slack file URL (url_private_download or url_private from a file object). The file ID in it is looked up in Slack.",
36
+ ),
34
37
  taskId: z
35
38
  .uuid()
36
39
  .optional()
@@ -41,7 +44,7 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
41
44
  .string()
42
45
  .optional()
43
46
  .describe(
44
- "Only without a task: where to save the file on the API server (directory or full path). Defaults to /workspace/shared/downloads/{agentId}/slack/.",
47
+ "Only without a task: where to save the file on the API server (directory or full path). Must be inside /workspace/shared/downloads/; a relative path resolves from there. Defaults to /workspace/shared/downloads/{agentId}/slack/.",
45
48
  ),
46
49
  filename: z
47
50
  .string()
@@ -104,14 +107,12 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
104
107
  if (fileId && !info) {
105
108
  return toolErr(`File not found: ${fileId}`);
106
109
  }
107
- const fileInfo = info
108
- ? { id: info.id, name: info.name, mimetype: info.mimetype, size: info.size }
109
- : undefined;
110
+ if (!info) {
111
+ return toolErr("Could not identify the Slack file in that URL; pass fileId instead.");
112
+ }
113
+ const fileInfo = { id: info.id, name: info.name, mimetype: info.mimetype, size: info.size };
110
114
 
111
115
  if (task) {
112
- if (!info) {
113
- return toolErr("Could not identify the Slack file in that URL; pass fileId instead.");
114
- }
115
116
  const outcome = (await attachSlackFilesForAgent(app.client, task, [info], agent.id)).get(
116
117
  info.id,
117
118
  );
@@ -128,7 +129,8 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
128
129
  );
129
130
  }
130
131
 
131
- const downloadUrl = info?.url_private_download ?? url;
132
+ // Always the URL Slack returned for the file, never the caller's URL.
133
+ const downloadUrl = info.url_private_download;
132
134
  if (!downloadUrl) {
133
135
  return toolErr("No download URL available.");
134
136
  }
@@ -138,7 +140,7 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
138
140
 
139
141
  // If it's a directory path, append the filename
140
142
  if (finalSavePath.endsWith("/") || !finalSavePath.includes(".")) {
141
- const actualFilename = filename || fileInfo?.name || `file_${Date.now()}`;
143
+ const actualFilename = basename(filename || info.name || `file_${Date.now()}`);
142
144
  finalSavePath = finalSavePath.endsWith("/")
143
145
  ? `${finalSavePath}${actualFilename}`
144
146
  : `${finalSavePath}/${actualFilename}`;
@@ -148,6 +150,7 @@ export const registerSlackDownloadFileTool = (server: McpServer) => {
148
150
  const result = await downloadFile({
149
151
  file: downloadUrl,
150
152
  savePath: finalSavePath,
153
+ root: DOWNLOAD_ROOT,
151
154
  token,
152
155
  });
153
156
 
@@ -15,7 +15,7 @@ import {
15
15
  } from "@/integrations/cards";
16
16
  import { can } from "@/rbac";
17
17
  import { getSlackApp } from "@/slack/app";
18
- import { buildMrkdwnSectionBlocks, getTaskLink } from "@/slack/blocks";
18
+ import { buildMrkdwnSectionBlocks, findReservedActionId, getTaskLink } from "@/slack/blocks";
19
19
  import { withAutoJoin } from "@/slack/channel-join";
20
20
  import { resolveSlackConversationId } from "@/slack/dm";
21
21
  import { externalChannelToolError, getChannelBlockReason } from "@/slack/external-channel";
@@ -90,6 +90,12 @@ export const registerSlackPostTool = (server: McpServer) => {
90
90
  return toolErr("Posting to Slack channels requires lead privileges.");
91
91
  }
92
92
  if (blocks && card) return toolErr("Provide either blocks or card, not both.");
93
+ const reservedActionId = findReservedActionId(blocks);
94
+ if (reservedActionId) {
95
+ return toolErr(
96
+ `blocks use the action_id "${reservedActionId}", which the swarm reserves for its own buttons. Use another action_id.`,
97
+ );
98
+ }
93
99
  if (!message && !card) return toolErr("Provide a message or a card.");
94
100
  let cardSlack: { blocks: Record<string, unknown>[]; text: string } | undefined;
95
101
  if (card) {
@@ -1,3 +1,4 @@
1
+ import { basename } from "node:path";
1
2
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
3
  import * as z from "zod";
3
4
  import { getAgentById, getInboxMessageById, getTaskById } from "@/be/db";
@@ -346,11 +347,12 @@ export const registerSlackReadTool = (server: McpServer) => {
346
347
  toAttach.push({ raw: f, info: fileInfo });
347
348
  } else if (token && f.url_private_download) {
348
349
  // Auto-download file if token is available
349
- const savePath = `${AUTO_DOWNLOAD_DIR}/${f.id}_${f.name}`;
350
350
  try {
351
+ const savePath = `${AUTO_DOWNLOAD_DIR}/${f.id}_${basename(f.name)}`;
351
352
  const downloadResult = await downloadFile({
352
353
  file: f.url_private_download,
353
354
  savePath,
355
+ root: AUTO_DOWNLOAD_DIR,
354
356
  token,
355
357
  });
356
358
  if (downloadResult.success && downloadResult.savedPath) {
@@ -243,6 +243,22 @@ export const registerSlackReplyTool = (server: McpServer) => {
243
243
  await markTaskSlackReplySent(taskId);
244
244
  console.log(`[Slack] Marked slackReplySent=1 for task ${taskId}`);
245
245
  }
246
+ // The caller's own task also replied when the reply names another
247
+ // task of the same thread (a Lead follow-up that answers under the task
248
+ // it reviews). Without this mark, the caller's outcome card repeats
249
+ // the reply. A task of another thread or another agent keeps its card.
250
+ const sourceTaskId = requestInfo.sourceTaskId;
251
+ if (sourceTaskId && sourceTaskId !== taskId) {
252
+ const sourceTask = await getTaskById(sourceTaskId);
253
+ if (
254
+ sourceTask?.agentId === agent.id &&
255
+ sourceTask.slackChannelId === slackChannelId &&
256
+ sourceTask.slackThreadTs === slackThreadTs
257
+ ) {
258
+ await markTaskSlackReplySent(sourceTaskId);
259
+ console.log(`[Slack] Marked slackReplySent=1 for source task ${sourceTaskId}`);
260
+ }
261
+ }
246
262
 
247
263
  return toolOk("Reply sent successfully.", {
248
264
  details: messageTs ? `Message timestamp: ${messageTs}` : undefined,
@@ -3,7 +3,7 @@ import * as z from "zod";
3
3
  import { getAgentById, getTaskById, recordSlackMessage } from "@/be/db";
4
4
  import { can } from "@/rbac";
5
5
  import { getSlackApp } from "@/slack/app";
6
- import { buildMrkdwnSectionBlocks } from "@/slack/blocks";
6
+ import { buildMrkdwnSectionBlocks, findReservedActionId } from "@/slack/blocks";
7
7
  import { withAutoJoin } from "@/slack/channel-join";
8
8
  import { resolveSlackConversationId } from "@/slack/dm";
9
9
  import { externalChannelToolError, getChannelBlockReason } from "@/slack/external-channel";
@@ -59,6 +59,13 @@ export const registerSlackStartThreadTool = (server: McpServer) => {
59
59
  return toolErr("Posting to Slack channels requires lead privileges.");
60
60
  }
61
61
 
62
+ const reservedActionId = findReservedActionId(blocks);
63
+ if (reservedActionId) {
64
+ return toolErr(
65
+ `blocks use the action_id "${reservedActionId}", which the swarm reserves for its own buttons. Use another action_id.`,
66
+ );
67
+ }
68
+
62
69
  const app = getSlackApp();
63
70
  if (!app) {
64
71
  return toolErr("Slack not configured.");
@@ -1,10 +1,18 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
- import { getAgentById, getInboxMessageById, getTaskById } from "@/be/db";
3
+ import { getAgentById, getInboxMessageById, getSwarmRepoById, getTaskById } from "@/be/db";
4
+ import { vcsRepoId } from "@/be/model-profile-check";
4
5
  import { can } from "@/rbac";
5
6
  import { getSlackApp } from "@/slack/app";
6
7
  import { externalChannelToolError, getChannelBlockReason } from "@/slack/external-channel";
7
- import { MAX_FILE_SIZE, uploadFile } from "@/slack/files";
8
+ import {
9
+ MAX_FILE_SIZE,
10
+ type OpenedFile,
11
+ openFileInside,
12
+ type UploadFileResult,
13
+ uploadFile,
14
+ uploadOpenFile,
15
+ } from "@/slack/files";
8
16
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
9
17
 
10
18
  /**
@@ -26,79 +34,79 @@ function resolveTaskUploadThreadTs(
26
34
  }
27
35
 
28
36
  /**
29
- * Resolves a file path to an absolute path and checks if it exists.
37
+ * Directories that a `filePath` upload may read from: /workspace, plus the working
38
+ * directory of each given task that the agent runs or created (the task `dir` and
39
+ * the clone path of its registered repo). A host-run API has no /workspace, so
40
+ * there the task directory is the only root.
41
+ */
42
+ async function uploadRoots(agentId: string, taskIds: (string | undefined)[]): Promise<string[]> {
43
+ const roots = [WORKSPACE_DIR];
44
+ for (const id of new Set(taskIds.filter((t): t is string => !!t))) {
45
+ const task = await getTaskById(id);
46
+ if (!task || (task.agentId !== agentId && task.creatorAgentId !== agentId)) continue;
47
+ if (task.dir) roots.push(task.dir);
48
+ const repoId = await vcsRepoId(task.vcsRepo);
49
+ const repo = repoId ? await getSwarmRepoById(repoId) : null;
50
+ if (repo) roots.push(repo.clonePath);
51
+ }
52
+ return roots;
53
+ }
54
+
55
+ /**
56
+ * Opens the file that `filePath` names, read on the API server's filesystem.
30
57
  *
31
- * NOTE: existence is checked on the API server's filesystem (where this tool
58
+ * NOTE: the file is read on the API server's filesystem (where this tool
32
59
  * runs), NOT the caller's. Worker/lead containers have their own `/tmp` that
33
60
  * the API server cannot see — the only volume mounted on both is
34
61
  * `/workspace/shared/`. Files outside `/workspace/shared/` must be passed
35
62
  * inline via the `content` (base64) param instead of `filePath`.
36
63
  *
37
- * Handles several common patterns:
64
+ * Candidates, in order:
38
65
  * 1. Relative paths (e.g., "shared/file.png") -> resolved from /workspace
39
- * 2. Absolute paths under /workspace (e.g., "/workspace/shared/file.png") -> used as-is
40
- * 3. Absolute paths that look like they should be under /workspace (e.g., "/tmp/file.png")
41
- * -> tries to find at /workspace/tmp/file.png if not found at original path
66
+ * 2. Absolute paths (e.g., "/workspace/shared/file.png") -> used as-is
67
+ * 3. Absolute paths outside /workspace (e.g., "/tmp/file.png") -> also tried as
68
+ * /workspace/tmp/file.png
42
69
  *
43
- * @param filePath - The path provided by the user
44
- * @returns Object with resolved path and exists flag, or error message
70
+ * The first candidate whose real path is a regular file inside `roots` wins.
45
71
  */
46
- async function resolveAndValidateFilePath(
72
+ async function openUploadFile(
47
73
  filePath: string,
74
+ roots: string[],
48
75
  ): Promise<
49
- { success: true; resolvedPath: string } | { success: false; error: string; triedPaths: string[] }
76
+ | { success: true; file: OpenedFile; resolvedPath: string }
77
+ | { success: false; notFound: boolean; error: string; triedPaths: string[] }
50
78
  > {
51
- const triedPaths: string[] = [];
52
-
53
- // Helper to check if file exists
54
- const fileExists = async (path: string): Promise<boolean> => {
55
- try {
56
- const bunFile = Bun.file(path);
57
- return await bunFile.exists();
58
- } catch {
59
- return false;
60
- }
61
- };
62
-
63
- // Case 1: Relative path - resolve from /workspace
64
- if (!filePath.startsWith("/")) {
65
- const absolutePath = `${WORKSPACE_DIR}/${filePath}`;
66
- triedPaths.push(absolutePath);
67
- if (await fileExists(absolutePath)) {
68
- return { success: true, resolvedPath: absolutePath };
69
- }
70
- return {
71
- success: false,
72
- error: `File not found. Relative paths are resolved from ${WORKSPACE_DIR}.`,
73
- triedPaths,
74
- };
79
+ const triedPaths = filePath.startsWith("/")
80
+ ? [
81
+ filePath,
82
+ ...(filePath.startsWith(`${WORKSPACE_DIR}/`) ? [] : [`${WORKSPACE_DIR}${filePath}`]),
83
+ ]
84
+ : [`${WORKSPACE_DIR}/${filePath}`];
85
+ let refusal: string | undefined;
86
+ for (const candidate of triedPaths) {
87
+ const opened = await openFileInside(candidate, roots);
88
+ if (opened.success) return { success: true, file: opened.file, resolvedPath: candidate };
89
+ if (!opened.notFound) refusal ??= opened.error;
75
90
  }
76
-
77
- // Case 2: Absolute path - try it directly first
78
- triedPaths.push(filePath);
79
- if (await fileExists(filePath)) {
80
- return { success: true, resolvedPath: filePath };
81
- }
82
-
83
- // Case 3: Absolute path didn't exist - try resolving under /workspace
84
- // This helps with paths like /tmp/file.png -> /workspace/tmp/file.png
85
- if (!filePath.startsWith(WORKSPACE_DIR)) {
86
- // Remove leading slash and resolve from workspace
87
- const relativePath = filePath.slice(1); // "/tmp/file.png" -> "tmp/file.png"
88
- const workspacePath = `${WORKSPACE_DIR}/${relativePath}`;
89
- triedPaths.push(workspacePath);
90
- if (await fileExists(workspacePath)) {
91
- return { success: true, resolvedPath: workspacePath };
92
- }
93
- }
94
-
91
+ if (refusal) return { success: false, notFound: false, error: refusal, triedPaths };
95
92
  return {
96
93
  success: false,
97
- error: `File not found at any of the attempted locations.`,
94
+ notFound: true,
95
+ error: filePath.startsWith("/")
96
+ ? "File not found at any of the attempted locations."
97
+ : `File not found. Relative paths are resolved from ${WORKSPACE_DIR}.`,
98
98
  triedPaths,
99
99
  };
100
100
  }
101
101
 
102
+ function uploadResult(result: UploadFileResult) {
103
+ if (!result.success) {
104
+ return toolErr(`Failed to upload file: ${result.error}`);
105
+ }
106
+ const successMsg = `File uploaded successfully${result.fileId ? ` (ID: ${result.fileId})` : ""}.`;
107
+ return toolOk(successMsg, { data: { fileId: result.fileId } });
108
+ }
109
+
102
110
  export const registerSlackUploadFileTool = (server: McpServer) => {
103
111
  createToolRegistrar(server)(
104
112
  "slack-upload-file",
@@ -133,6 +141,7 @@ export const registerSlackUploadFileTool = (server: McpServer) => {
133
141
  "Path to the file to upload. Either filePath OR content must be provided. " +
134
142
  "IMPORTANT: the file is read on the API server's filesystem (where this tool runs), NOT on the caller's. " +
135
143
  "Worker/lead containers do NOT share /tmp or /workspace/personal/ with the API server — the only shared volume is /workspace/shared/. " +
144
+ "The file must be a regular file inside /workspace or the working directory of your current task. " +
136
145
  "Use /workspace/shared/<agent-id>/file.png (or a relative path like 'shared/<agent-id>/file.png'). " +
137
146
  "For files that only live on the caller (e.g. /tmp), pass them inline via `content` (base64) instead.",
138
147
  ),
@@ -243,14 +252,12 @@ export const registerSlackUploadFileTool = (server: McpServer) => {
243
252
  return toolErr("filename is required when using base64 content upload.");
244
253
  }
245
254
 
246
- let fileToUpload: string | Buffer;
247
- let actualFilename: string;
248
-
249
255
  if (filePath) {
250
- // Resolve and validate the file path
251
- const pathResult = await resolveAndValidateFilePath(filePath);
256
+ const roots = await uploadRoots(agent.id, [taskId, requestInfo.sourceTaskId]);
257
+ const pathResult = await openUploadFile(filePath, roots);
252
258
 
253
259
  if (!pathResult.success) {
260
+ if (!pathResult.notFound) return toolErr(pathResult.error);
254
261
  const triedPathsList = pathResult.triedPaths.map((p) => ` - ${p}`).join("\n");
255
262
  const errorMsg =
256
263
  `${pathResult.error}\n` +
@@ -264,48 +271,44 @@ export const registerSlackUploadFileTool = (server: McpServer) => {
264
271
  return toolErr(errorMsg);
265
272
  }
266
273
 
267
- const resolvedPath = pathResult.resolvedPath;
268
- const bunFile = Bun.file(resolvedPath);
269
- const fileSize = bunFile.size;
270
-
271
- if (fileSize > MAX_FILE_SIZE) {
272
- const sizeMB = Math.round(fileSize / 1024 / 1024);
273
- return toolErr(`File too large: ${sizeMB} MB. Maximum is 1 GB.`);
274
- }
275
-
276
- fileToUpload = resolvedPath;
277
- actualFilename = filename || resolvedPath.split("/").pop() || "file";
278
- } else {
279
- // Base64 content mode: decode and check size
274
+ // The handle stays open until the upload has sent every byte.
280
275
  try {
281
- fileToUpload = Buffer.from(content!, "base64");
282
- } catch {
283
- return toolErr("Invalid base64 content.");
284
- }
285
-
286
- if (fileToUpload.length > MAX_FILE_SIZE) {
287
- const sizeMB = Math.round(fileToUpload.length / 1024 / 1024);
288
- return toolErr(`File too large: ${sizeMB} MB. Maximum is 1 GB.`);
276
+ return uploadResult(
277
+ await uploadOpenFile(app.client, pathResult.file, {
278
+ filename: filename || pathResult.resolvedPath.split("/").pop() || "file",
279
+ channelId: slackChannelId,
280
+ threadTs: slackThreadTs,
281
+ initialComment,
282
+ }),
283
+ );
284
+ } finally {
285
+ await pathResult.file.handle.close();
289
286
  }
290
-
291
- actualFilename = filename!;
292
287
  }
293
288
 
289
+ // Base64 content mode: decode and check size
290
+ let fileToUpload: Buffer;
294
291
  try {
295
- const result = await uploadFile(app.client, {
296
- file: fileToUpload,
297
- filename: actualFilename,
298
- channelId: slackChannelId,
299
- threadTs: slackThreadTs,
300
- initialComment,
301
- });
292
+ fileToUpload = Buffer.from(content!, "base64");
293
+ } catch {
294
+ return toolErr("Invalid base64 content.");
295
+ }
302
296
 
303
- if (!result.success) {
304
- return toolErr(`Failed to upload file: ${result.error}`);
305
- }
297
+ if (fileToUpload.length > MAX_FILE_SIZE) {
298
+ const sizeMB = Math.round(fileToUpload.length / 1024 / 1024);
299
+ return toolErr(`File too large: ${sizeMB} MB. Maximum is 1 GB.`);
300
+ }
306
301
 
307
- const successMsg = `File uploaded successfully${result.fileId ? ` (ID: ${result.fileId})` : ""}.`;
308
- return toolOk(successMsg, { data: { fileId: result.fileId } });
302
+ try {
303
+ return uploadResult(
304
+ await uploadFile(app.client, {
305
+ file: fileToUpload,
306
+ filename: filename!,
307
+ channelId: slackChannelId,
308
+ threadTs: slackThreadTs,
309
+ initialComment,
310
+ }),
311
+ );
309
312
  } catch (error) {
310
313
  const errorMsg = error instanceof Error ? error.message : String(error);
311
314
  return toolErr(`Failed to upload file: ${errorMsg}`);
@@ -62,7 +62,9 @@ export const registerSetConfigTool = (server: McpServer) => {
62
62
  envPath: z
63
63
  .string()
64
64
  .optional()
65
- .describe("Optional: file path to write the value as KEY=VALUE in a .env file."),
65
+ .describe(
66
+ "Optional: a path stored with the row as metadata. The server does not write files.",
67
+ ),
66
68
  description: z
67
69
  .string()
68
70
  .optional()
@@ -34,7 +34,6 @@ export const registerSwarmXTool = (server: McpServer) => {
34
34
  .record(z.string(), z.string())
35
35
  .optional()
36
36
  .describe("Optional extra headers. Auth headers are injected by the server."),
37
- baseUrl: z.string().url().optional().describe("Optional Composio API base URL override."),
38
37
  useOrgKey: z
39
38
  .boolean()
40
39
  .default(false)
@@ -62,7 +61,6 @@ export const registerSwarmXTool = (server: McpServer) => {
62
61
  try {
63
62
  result = await executeComposioRequest(
64
63
  composioArgsFromParts({
65
- baseUrl: input.baseUrl,
66
64
  body: input.body,
67
65
  endpoint: input.path,
68
66
  headers: input.headers,
@@ -284,6 +284,9 @@ const scriptAuthoringNudge = (r: SwarmToolResult): string | undefined =>
284
284
 
285
285
  const scriptRunNudge = (r: SwarmToolResult): string | undefined => {
286
286
  const body = (r.data as { data?: { error?: unknown } } | undefined)?.data;
287
+ if (!r.ok && body?.error === "object busy") {
288
+ return "object busy: retry the call later, do not loop.";
289
+ }
287
290
  // nudgeMiddleware permits exactly one steer: timeout durability is more
288
291
  // specific than the generic authoring-contract advice, which stays fallback.
289
292
  return !r.ok && body?.error === "timeout" ? SCRIPT_RUN_TIMEOUT_NUDGE : scriptAuthoringNudge(r);
package/src/types.ts CHANGED
@@ -1033,6 +1033,8 @@ export const AgentTaskSchema = z
1033
1033
  // wake-up task" apart from "done" — see `isDeferredTask` in
1034
1034
  // src/slack/task-output.ts.
1035
1035
  deferredAt: z.iso.datetime().optional(),
1036
+ // The wake-up ceiling `defer-task` booked; the wake event can come sooner.
1037
+ deferredUntil: z.iso.datetime().optional(),
1036
1038
 
1037
1039
  // Context usage aggregates
1038
1040
  compactionCount: z.number().int().min(0).optional(),
@@ -1518,6 +1520,7 @@ export const FavoriteItemTypeSchema = z.enum([
1518
1520
  "key",
1519
1521
  "session",
1520
1522
  "hidden-key",
1523
+ "app",
1521
1524
  ]);
1522
1525
  export type FavoriteItemType = z.infer<typeof FavoriteItemTypeSchema>;
1523
1526
 
@@ -2534,7 +2537,7 @@ export const SwarmRepoSchema = z
2534
2537
  defaultBranch: z.string().default("main"),
2535
2538
  autoClone: z.boolean().default(true),
2536
2539
  hooks: RepoHooksSchema.describe(
2537
- "Worker hook installation. Enabled by default: a repo created without `hooks` stores { enabled: true }. Disable with { enabled: false }. A repo with no stored hooks config reads as disabled.",
2540
+ "Worker hook installation. Enabled by default: a repo created without `hooks` stores { enabled: true }, except a repo a non-lead agent session token creates, which stores { enabled: false }. Disable with { enabled: false }. A repo with no stored hooks config reads as disabled.",
2538
2541
  ),
2539
2542
  guidelines: RepoGuidelinesSchema.nullable().optional(),
2540
2543
  createdAt: z.string(),
@@ -3866,6 +3869,9 @@ export type ScriptRunKind = z.infer<typeof ScriptRunKindSchema>;
3866
3869
 
3867
3870
  export const ScriptRunSchema = z
3868
3871
  .object({
3872
+ objectScriptId: z.string().optional(),
3873
+ objectId: z.string().optional(),
3874
+ objectMethod: z.string().optional(),
3869
3875
  id: z.string().uuid(),
3870
3876
  agentId: z.string(),
3871
3877
  scriptName: z.string().optional(),
@@ -4372,7 +4378,7 @@ export type ExtensionInstallBody = z.infer<typeof ExtensionInstallBodySchema>;
4372
4378
  export type ScriptListItem = Omit<
4373
4379
  ScriptRecord,
4374
4380
  "source" | "signatureJson" | "argsJsonSchema" | "contentHash"
4375
- >;
4381
+ > & { kind: "function" | "durable" };
4376
4382
 
4377
4383
  /** Full record served by `GET /api/scripts/{id}` — includes `source` plus parsed `signature`/`argsJsonSchema`. */
4378
4384
  export type ScriptDetail = Omit<ScriptRecord, "argsJsonSchema"> & {
@@ -78,6 +78,26 @@ export function getMcpBaseUrl(): string {
78
78
  return (raw || `http://localhost:${process.env.PORT || "3013"}`).replace(/\/+$/, "");
79
79
  }
80
80
 
81
+ let apiLoopbackBaseUrl: string | undefined;
82
+
83
+ /** API process only: record this server's loopback URL once it listens. */
84
+ export function setApiLoopbackBaseUrl(url: string): void {
85
+ apiLoopbackBaseUrl = url.replace(/\/+$/, "");
86
+ }
87
+
88
+ /**
89
+ * Base URL that scripts, the script tools and script workflow subprocesses use
90
+ * to call this API. Order: the `SCRIPT_API_BASE_URL` deployment env, then this
91
+ * server's loopback URL once it listens, then {@link getMcpBaseUrl}. Loopback
92
+ * keeps these calls off the public proxy that `MCP_BASE_URL` often names.
93
+ * Never use it for URLs that leave this host.
94
+ */
95
+ export function getScriptApiBaseUrl(): string {
96
+ const override = process.env.SCRIPT_API_BASE_URL?.trim();
97
+ if (override) return override.replace(/\/+$/, "");
98
+ return apiLoopbackBaseUrl ?? getMcpBaseUrl();
99
+ }
100
+
81
101
  /**
82
102
  * Public, browser-/externally-reachable origin of the API server — where
83
103
  * `/api/mcp-oauth/callback`, OAuth redirect URIs, and registered webhook URLs
@@ -0,0 +1,61 @@
1
+ // Pure time formatting for deferral cards, shared by `defer-task` and the
2
+ // channel renderers. Kept apart from the tool so Slack rendering does not load
3
+ // the tool's module graph.
4
+
5
+ export function isValidTimezone(zone: unknown): zone is string {
6
+ if (typeof zone !== "string" || !zone) return false;
7
+ try {
8
+ new Intl.DateTimeFormat("en-US", { timeZone: zone });
9
+ return true;
10
+ } catch {
11
+ return false;
12
+ }
13
+ }
14
+
15
+ /** Date/time parts of `date` as rendered in IANA zone `tz`. */
16
+ function partsInTz(date: Date, tz: string) {
17
+ const fmt = new Intl.DateTimeFormat("en-US", {
18
+ timeZone: tz,
19
+ year: "numeric",
20
+ month: "2-digit",
21
+ day: "2-digit",
22
+ hour: "2-digit",
23
+ minute: "2-digit",
24
+ timeZoneName: "short",
25
+ hourCycle: "h23",
26
+ });
27
+ const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
28
+ return {
29
+ year: parts.year!,
30
+ month: parts.month!,
31
+ day: parts.day!,
32
+ hour: parts.hour!,
33
+ minute: parts.minute!,
34
+ abbreviation: parts.timeZoneName!,
35
+ };
36
+ }
37
+
38
+ /**
39
+ * "today"/"tomorrow" or "MM-dd" plus "HH:MM", both computed in `tz`.
40
+ * Falls back to UTC (parts still computed correctly) if `tz` is not a valid
41
+ * IANA zone — the caller decides whether to label the fallback.
42
+ */
43
+ export function formatDeferralDateTime(
44
+ target: Date,
45
+ now: Date,
46
+ tz: string,
47
+ labelZone = false,
48
+ ): { date: string; time: string } {
49
+ const zone = isValidTimezone(tz) ? tz : "UTC";
50
+ const t = partsInTz(target, zone);
51
+ // Minute precision: this string is read by a human deciding whether to wait,
52
+ // and the wake-up is scheduler-polled anyway, so seconds were false precision.
53
+ const time = `${t.hour}:${t.minute}${labelZone ? ` ${t.abbreviation}` : ""}`;
54
+ const n = partsInTz(now, zone);
55
+ if (t.year === n.year && t.month === n.month && t.day === n.day) return { date: "today", time };
56
+ const tm = partsInTz(new Date(now.getTime() + 86_400_000), zone);
57
+ if (t.year === tm.year && t.month === tm.month && t.day === tm.day) {
58
+ return { date: "tomorrow", time };
59
+ }
60
+ return { date: `${t.month}-${t.day}`, time };
61
+ }