@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,5 +1,5 @@
1
1
  import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
- import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
2
+ import { existsSync, mkdtempSync, rmSync } from "node:fs";
3
3
  import { unlink } from "node:fs/promises";
4
4
  import { tmpdir } from "node:os";
5
5
  import { join } from "node:path";
@@ -170,23 +170,20 @@ describe("swarm_config encryption (Phase 4) — template fast-path", () => {
170
170
  expect(raw?.value).not.toBe("now-secret");
171
171
  });
172
172
 
173
- test("writeEnvFile writes plaintext to disk, not ciphertext", async () => {
173
+ test("envPath is stored as metadata and no file is written", async () => {
174
174
  const tmpDir = mkdtempSync(join(tmpdir(), "swarm-config-encryption-"));
175
175
  const envPath = join(tmpDir, "test.env");
176
176
  try {
177
177
  const key = uniqueKey("ENV_FILE_SECRET");
178
- await upsertSwarmConfig({
178
+ const config = await upsertSwarmConfig({
179
179
  scope: "global",
180
180
  key,
181
181
  value: "env-file-plaintext",
182
182
  isSecret: true,
183
183
  envPath,
184
184
  });
185
- const content = readFileSync(envPath, "utf8");
186
- expect(content).toContain(`${key}=env-file-plaintext`);
187
- // Precisely verify the line holds plaintext, not base64 ciphertext.
188
- const line = content.split("\n").find((l) => l.startsWith(`${key}=`));
189
- expect(line).toBe(`${key}=env-file-plaintext`);
185
+ expect(config.envPath).toBe(envPath);
186
+ expect(existsSync(envPath)).toBe(false);
190
187
  } finally {
191
188
  rmSync(tmpDir, { recursive: true, force: true });
192
189
  }
@@ -110,7 +110,7 @@ describe("PUT and DELETE /api/config", () => {
110
110
  for (const headers of [{}, { "X-Agent-ID": LEAD_ID }]) {
111
111
  const response = await put(headers);
112
112
  expect(response.status).toBe(403);
113
- expect(await response.text()).toContain("can only be changed by an admin user");
113
+ expect(await response.text()).toContain("With RBAC enabled, the user must be an admin");
114
114
  }
115
115
  });
116
116
 
@@ -157,14 +157,18 @@ describe("set-config and delete-config tools", () => {
157
157
  test("the lead cannot set it", async () => {
158
158
  const result = await tools.get("set-config")!({ scope: "global", key: KEY, value: PIN }, meta);
159
159
  expect(result.structuredContent?.success).toBe(false);
160
- expect(result.structuredContent?.message).toContain("can only be changed by an admin user");
160
+ expect(result.structuredContent?.message).toContain(
161
+ "requires a user token or dashboard user session",
162
+ );
161
163
  });
162
164
 
163
165
  test("the lead cannot delete it", async () => {
164
166
  const row = await upsertSwarmConfig({ scope: "global", key: KEY, value: PIN });
165
167
  const result = await tools.get("delete-config")!({ id: row.id }, meta);
166
168
  expect(result.structuredContent?.success).toBe(false);
167
- expect(result.structuredContent?.message).toContain("can only be changed by an admin user");
169
+ expect(result.structuredContent?.message).toContain(
170
+ "requires a user token or dashboard user session",
171
+ );
168
172
  });
169
173
  });
170
174
 
@@ -1,4 +1,4 @@
1
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
1
+ import { afterAll, beforeAll, describe, expect, spyOn, test } from "bun:test";
2
2
  import crypto from "node:crypto";
3
3
  import { unlink } from "node:fs/promises";
4
4
  import { z } from "zod";
@@ -7,6 +7,7 @@ import {
7
7
  countWorkflowRuns,
8
8
  createWorkflow,
9
9
  getDb,
10
+ getDbClient,
10
11
  getWorkflowRun,
11
12
  initDb,
12
13
  updateWorkflow,
@@ -1524,22 +1525,45 @@ describe("TriggerConfigSchema", () => {
1524
1525
  });
1525
1526
 
1526
1527
  describe("handleEventTrigger", () => {
1527
- test("starts only enabled workflows subscribed to the Slack event", async () => {
1528
- const matching = await makeWorkflow({
1529
- triggers: [{ type: "event", eventName: "slack.message" }],
1530
- });
1528
+ test("starts each matching enabled workflow once, newest first", async () => {
1529
+ const trigger = { type: "event", eventName: "slack.message" } as const;
1530
+ const older = await makeWorkflow({ triggers: [trigger] });
1531
+ const newer = await makeWorkflow({ triggers: [trigger, trigger] });
1531
1532
  const disabled = await makeWorkflow({
1532
- triggers: [{ type: "event", eventName: "slack.message" }],
1533
+ enabled: false,
1534
+ triggers: [trigger],
1533
1535
  });
1534
- await updateWorkflow(disabled.id, { enabled: false });
1536
+ const otherEvent = await makeWorkflow({
1537
+ triggers: [{ type: "event", eventName: "azure-devops.work_item.assigned" }],
1538
+ });
1539
+ const setUpdated = getDb().prepare("UPDATE workflows SET lastUpdatedAt = ? WHERE id = ?");
1540
+ setUpdated.run("2026-01-01T00:00:00.000Z", older.id);
1541
+ setUpdated.run("2026-01-02T00:00:00.000Z", newer.id);
1535
1542
 
1536
1543
  const payload = { channel: "C123", text: "service is down", ts: "123.456" };
1544
+ const client = getDbClient();
1545
+ const query = spyOn(client, "query");
1546
+ const get = spyOn(client, "get");
1547
+ try {
1548
+ expect(await handleEventTrigger("unsubscribed", payload, registry)).toEqual([]);
1549
+ const reads = [...query.mock.results, ...get.mock.results];
1550
+ const rows = (await Promise.all(reads.map((read) => read.value))).flat();
1551
+ const definitions = rows.filter(
1552
+ (row) => row && typeof row === "object" && "definition" in row,
1553
+ );
1554
+ expect(definitions).toHaveLength(0);
1555
+ } finally {
1556
+ query.mockRestore();
1557
+ get.mockRestore();
1558
+ }
1559
+
1537
1560
  const runIds = await handleEventTrigger("slack.message", payload, registry);
1538
1561
 
1539
- expect(runIds).toHaveLength(1);
1540
- const run = await getWorkflowRun(runIds[0]!);
1541
- expect(run?.workflowId).toBe(matching.id);
1542
- expect(run?.triggerData).toEqual(payload);
1562
+ const runs = await Promise.all(runIds.map((runId) => getWorkflowRun(runId)));
1563
+ expect(runs.map((run) => run?.workflowId)).toEqual([newer.id, older.id]);
1564
+ expect(runs.map((run) => run?.triggerData)).toEqual([payload, payload]);
1565
+ expect(await countWorkflowRuns(disabled.id)).toBe(0);
1566
+ expect(await countWorkflowRuns(otherEvent.id)).toBe(0);
1543
1567
  });
1544
1568
  });
1545
1569
 
@@ -12,6 +12,7 @@ import {
12
12
  unexpectedMigrationDetails,
13
13
  withAppDefinitionLock,
14
14
  } from "@/apps/schema-migrate";
15
+ import { appWriteTypesWarnings } from "@/apps/script-types";
15
16
  import { appDefinitionNeedsRepair, getApp, updateApp } from "@/apps/store";
16
17
  import { snapshotApp } from "@/apps/version";
17
18
  import { getAgentById } from "@/be/db";
@@ -52,6 +53,7 @@ export const registerAppPatchTool = (server: McpServer) => {
52
53
  url: z.string().optional(),
53
54
  app: z.unknown().optional(),
54
55
  migration: AppMigrationReportOutputSchema.optional(),
56
+ warnings: z.array(z.string()).optional(),
55
57
  issues: z
56
58
  .array(z.looseObject({ path: z.string().optional(), message: z.string().optional() }))
57
59
  .optional(),
@@ -148,9 +150,11 @@ export const registerAppPatchTool = (server: McpServer) => {
148
150
  if (!app) return toolErr(`App ${input.appId} not found.`);
149
151
 
150
152
  const url = `/apps/${app.id}`;
153
+ const warnings = await appWriteTypesWarnings(app.id);
154
+ const extra = warnings.length > 0 ? { warnings } : {};
151
155
  return toolOk(`App "${app.name}" patched.`, {
152
- details: JSON.stringify({ appId: app.id, url, app, migration }, null, 2),
153
- data: { appId: app.id, url, app, migration },
156
+ details: JSON.stringify({ appId: app.id, url, app, migration, ...extra }, null, 2),
157
+ data: { appId: app.id, url, app, migration, ...extra },
154
158
  });
155
159
  });
156
160
  },
@@ -12,6 +12,7 @@ import {
12
12
  unexpectedMigrationDetails,
13
13
  withAppDefinitionLock,
14
14
  } from "@/apps/schema-migrate";
15
+ import { appWriteTypesWarnings } from "@/apps/script-types";
15
16
  import { createApp, getApp, updateApp } from "@/apps/store";
16
17
  import { snapshotApp } from "@/apps/version";
17
18
  import { getAgentById } from "@/be/db";
@@ -46,6 +47,7 @@ export const registerAppUpsertTool = (server: McpServer) => {
46
47
  appId: z.string().optional(),
47
48
  url: z.string().optional(),
48
49
  migration: AppMigrationReportOutputSchema.optional(),
50
+ warnings: z.array(z.string()).optional(),
49
51
  issues: z
50
52
  .array(z.looseObject({ path: z.string().optional(), message: z.string().optional() }))
51
53
  .optional(),
@@ -139,9 +141,10 @@ export const registerAppUpsertTool = (server: McpServer) => {
139
141
  }
140
142
  if (!app) return toolErr("Failed to save app.");
141
143
  const url = `/apps/${app.id}`;
144
+ const warnings = await appWriteTypesWarnings(app.id);
142
145
  return toolOk(`App "${app.name}" saved.`, {
143
- details: `App: ${url}`,
144
- data: { appId: app.id, url, migration },
146
+ details: [`App: ${url}`, ...warnings].join("\n"),
147
+ data: { appId: app.id, url, migration, ...(warnings.length > 0 ? { warnings } : {}) },
145
148
  });
146
149
  });
147
150
  }
@@ -167,9 +170,10 @@ export const registerAppUpsertTool = (server: McpServer) => {
167
170
  });
168
171
  if (!app) return toolErr("Failed to save app.");
169
172
  const url = `/apps/${app.id}`;
173
+ const warnings = await appWriteTypesWarnings(app.id);
170
174
  return toolOk(`App "${app.name}" saved.`, {
171
- details: `App: ${url}`,
172
- data: { appId: app.id, url },
175
+ details: [`App: ${url}`, ...warnings].join("\n"),
176
+ data: { appId: app.id, url, ...(warnings.length > 0 ? { warnings } : {}) },
173
177
  });
174
178
  },
175
179
  );
@@ -8,9 +8,9 @@ import {
8
8
  getAgentById,
9
9
  getDbClient,
10
10
  getTaskById,
11
- getUserById,
12
11
  updateAgentStatusFromCapacity,
13
12
  } from "@/be/db";
13
+ import { resolveRequesterTimezone } from "@/be/requester-timezone";
14
14
  import {
15
15
  describeEventWait,
16
16
  type EventMatch,
@@ -32,6 +32,7 @@ import { getTaskOutputValidationError } from "@/tasks/terminal-result-guard";
32
32
  import { assertOwnsTask, ownerCtx } from "@/tools/task-tool-ctx";
33
33
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
34
34
  import { isTerminalTaskStatus } from "@/types";
35
+ import { formatDeferralDateTime } from "@/utils/deferral-time";
35
36
  import { ensure } from "../utils/business-use";
36
37
  import { getCurrentRequestAuth } from "../utils/request-auth-context";
37
38
 
@@ -102,77 +103,6 @@ function renderChecks(checks?: string[]): string {
102
103
  return `\n\nChecks:\n${checks.map((c) => `- ${c}`).join("\n")}`;
103
104
  }
104
105
 
105
- /** Date/time parts of `date` as rendered in IANA zone `tz`. */
106
- function partsInTz(date: Date, tz: string) {
107
- const fmt = new Intl.DateTimeFormat("en-US", {
108
- timeZone: tz,
109
- year: "numeric",
110
- month: "2-digit",
111
- day: "2-digit",
112
- hour: "2-digit",
113
- minute: "2-digit",
114
- second: "2-digit",
115
- hour12: false,
116
- });
117
- const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
118
- // Some locales render midnight as "24" under hour12: false.
119
- const hour = parts.hour === "24" ? "00" : parts.hour;
120
- return {
121
- year: parts.year!,
122
- month: parts.month!,
123
- day: parts.day!,
124
- hour: hour!,
125
- minute: parts.minute!,
126
- second: parts.second!,
127
- };
128
- }
129
-
130
- /**
131
- * "today"/"tomorrow" or "MM-dd" plus "HH:MM", both computed in `tz`.
132
- * Falls back to UTC (parts still computed correctly) if `tz` is not a valid
133
- * IANA zone — the caller decides whether to label the fallback.
134
- */
135
- function formatDeferralDateTime(
136
- target: Date,
137
- now: Date,
138
- tz: string,
139
- ): { date: string; time: string } {
140
- let zone = tz;
141
- try {
142
- Intl.DateTimeFormat("en-US", { timeZone: zone });
143
- } catch {
144
- zone = "UTC";
145
- }
146
- const t = partsInTz(target, zone);
147
- // Minute precision: this string is read by a human deciding whether to wait,
148
- // and the wake-up is scheduler-polled anyway, so seconds were false precision.
149
- const time = `${t.hour}:${t.minute}`;
150
- const n = partsInTz(now, zone);
151
- if (t.year === n.year && t.month === n.month && t.day === n.day) return { date: "today", time };
152
- const tm = partsInTz(new Date(now.getTime() + 86_400_000), zone);
153
- if (t.year === tm.year && t.month === tm.month && t.day === tm.day) {
154
- return { date: "tomorrow", time };
155
- }
156
- return { date: `${t.month}-${t.day}`, time };
157
- }
158
-
159
- /**
160
- * Resolve the requesting human's IANA timezone from `users.timezone` via
161
- * `task.requestedByUserId`. We do not currently capture a Slack profile `tz`
162
- * anywhere in the ingest path (checked `src/slack/enrich.ts`, the only place
163
- * that reads `users.info`) — a user only has a timezone here if someone set
164
- * it explicitly via `manage-user`. Falls back to UTC, flagged as such.
165
- */
166
- async function resolveRequesterTimezone(
167
- requestedByUserId: string | undefined,
168
- ): Promise<{ tz: string; isFallback: boolean }> {
169
- if (requestedByUserId) {
170
- const user = await getUserById(requestedByUserId);
171
- if (user?.timezone) return { tz: user.timezone, isFallback: false };
172
- }
173
- return { tz: "UTC", isFallback: true };
174
- }
175
-
176
106
  /** "Researcher", "Researcher and Picateclas", "A, B and C". */
177
107
  function joinNames(names: string[]): string {
178
108
  if (names.length < 2) return names[0] ?? "";
@@ -181,12 +111,18 @@ function joinNames(names: string[]): string {
181
111
 
182
112
  /**
183
113
  * Who a `wakeOn` deferral is waiting on, in the card's words: the distinct
184
- * agent names behind the watched tasks, or a bare count when none of them is
185
- * assigned (an unassigned watched task has no name a human would recognise).
114
+ * agent names behind the watched tasks, else the title of a single watched
115
+ * task, else a bare count (an unassigned task has no name a human would
116
+ * recognise).
186
117
  */
187
- export function renderWaitingOn(agentNames: string[], watchedCount: number): string {
118
+ export function renderWaitingOn(
119
+ agentNames: string[],
120
+ watchedCount: number,
121
+ titles: string[] = [],
122
+ ): string {
188
123
  const named = joinNames([...new Set(agentNames.filter((name) => name.trim()))]);
189
124
  if (named) return named;
125
+ if (watchedCount === 1 && titles[0]?.trim()) return titles[0].trim();
190
126
  return `${watchedCount} task${watchedCount === 1 ? "" : "s"}`;
191
127
  }
192
128
 
@@ -201,7 +137,8 @@ function renderWhen(nextRunAt: string, tz: string, isFallbackTz: boolean): strin
201
137
  /**
202
138
  * Human-facing deferral text for tasks without an outputSchema — the task's
203
139
  * terminal output, shown in the UI's task-detail output row. Slack reads it
204
- * through `slackTaskOutput`, which drops the wake-up time.
140
+ * through `slackTaskOutput`, which re-renders the wake-up time from
141
+ * `deferredUntil`.
205
142
  *
206
143
  * It answers one question — when does this come back — in the two shapes a
207
144
  * deferral actually has:
@@ -442,6 +379,7 @@ export const registerDeferTaskTool = (server: McpServer) => {
442
379
  }
443
380
  }
444
381
  const watchedAgentNames: string[] = [];
382
+ const watchedTitles: string[] = [];
445
383
  for (const watchedId of watchedTaskIds) {
446
384
  if (watchedId === taskId)
447
385
  throw new DeferAbortedError("Cannot wake on the task being deferred.");
@@ -456,6 +394,7 @@ export const registerDeferTaskTool = (server: McpServer) => {
456
394
  // between the deferral and whoever reads the thread later.
457
395
  const watchedAgent = watched.agentId ? await getAgentById(watched.agentId) : null;
458
396
  if (watchedAgent?.name) watchedAgentNames.push(watchedAgent.name);
397
+ if (watched.title) watchedTitles.push(watched.title);
459
398
  }
460
399
  const schedule = await createScheduledTask({
461
400
  // Unique name (`getScheduledTaskByName` is a unique lookup). The UUID
@@ -542,12 +481,13 @@ export const registerDeferTaskTool = (server: McpServer) => {
542
481
  admitted && eventWait
543
482
  ? describeEventWait(admitted.adapter.source, eventWait.event, admitted.match)
544
483
  : wakeOn
545
- ? renderWaitingOn(watchedAgentNames, watchedTaskIds.length)
484
+ ? renderWaitingOn(watchedAgentNames, watchedTaskIds.length, watchedTitles)
546
485
  : undefined,
547
486
  );
548
487
  const completed = await completeTask(taskId, terminalOutput, {
549
488
  addTags: ["deferred"],
550
489
  deferredAt: new Date().toISOString(),
490
+ deferredUntil: nextRunAt,
551
491
  statusKind: "deferred",
552
492
  });
553
493
  if (!completed) {
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getKv } from "@/be/db";
4
+ import { scrubReservedRead } from "@/kv-reserved-namespaces";
4
5
  import {
5
6
  hasKvViewArgs,
6
7
  joinKvPath,
@@ -192,6 +193,7 @@ export const registerKvGetTool = (server: McpServer) => {
192
193
  // entries go out whole and the harness applies its own truncation; with
193
194
  // path/offset/limit the tool bounds the page itself.
194
195
  const entry = await getKv(resolved.namespace, key);
196
+ if (entry) entry.value = scrubReservedRead(resolved.namespace, entry.value);
195
197
  if (entry && hasKvViewArgs({ path, offset, limit })) {
196
198
  return boundedView(entry, requestInfo.agentId, { path, offset, limit });
197
199
  }
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { countKv, listKv } from "@/be/db";
4
+ import { scrubReservedRead } from "@/kv-reserved-namespaces";
4
5
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
5
6
  import { KvNamespaceSchema, KvValueTypeSchema } from "@/types";
6
7
  import { kvReadAuthError } from "./kv-read-auth";
@@ -72,11 +73,16 @@ export const registerKvListTool = (server: McpServer) => {
72
73
  }
73
74
  const effectiveLimit = Math.min(limit ?? 100, MAX_KV_LIST_LIMIT);
74
75
  const effectivePrefix = prefix && prefix.length > 0 ? prefix : undefined;
75
- const entries = await listKv(resolved.namespace, {
76
- prefix: effectivePrefix,
77
- limit: effectiveLimit,
78
- offset: offset ?? 0,
79
- });
76
+ const entries = (
77
+ await listKv(resolved.namespace, {
78
+ prefix: effectivePrefix,
79
+ limit: effectiveLimit,
80
+ offset: offset ?? 0,
81
+ })
82
+ ).map((entry) => ({
83
+ ...entry,
84
+ value: scrubReservedRead(resolved.namespace, entry.value),
85
+ }));
80
86
  const total = await countKv(resolved.namespace, { prefix: effectivePrefix });
81
87
  return toolOk(
82
88
  entries.length === 0
@@ -1,14 +1,12 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { upsertKv } from "@/be/db";
4
+ import { MAX_KV_BODY_BYTES } from "@/kv-limits";
4
5
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
5
6
  import { KvKeySchema, KvNamespaceSchema, KvValueTypeSchema } from "@/types";
6
7
  import { kvWriteAuthError } from "./kv-write-auth";
7
8
  import { resolveNamespace } from "./resolve-namespace";
8
9
 
9
- // 2 MiB cap — mirrors the HTTP enforcement.
10
- const MAX_KV_BODY_BYTES = 2 * 1024 * 1024;
11
-
12
10
  // Loose, format-pin-free mirror of KvEntrySchema for MCP output validation.
13
11
  const kvEntryOutputSchema = z.looseObject({
14
12
  namespace: z.string().optional(),
@@ -1,10 +1,11 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getAgentById } from "@/be/db";
4
- import { updateSwarmRepoChecked } from "@/be/repo-checked-update";
4
+ import { execConfigRefusal, updateSwarmRepoChecked } from "@/be/repo-checked-update";
5
5
  import { can } from "@/rbac";
6
6
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
7
7
  import { agentsMayMerge, RepoGuidelinesInputSchema, RepoHooksSchema } from "@/types";
8
+ import { getCurrentRequestAuth } from "@/utils/request-auth-context";
8
9
 
9
10
  const swarmRepoOutputShape = z.looseObject({
10
11
  id: z.string().optional(),
@@ -33,15 +34,27 @@ export const registerUpdateRepoTool = (server: McpServer) => {
33
34
  {
34
35
  title: "Update Repo",
35
36
  description:
36
- "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge or mergePolicy: resend their current values to edit other guidelines.",
37
+ "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge or mergePolicy: resend their current values to edit other guidelines. An agent session token also needs the lead role to change url, clonePath or hooks.",
37
38
  annotations: { readOnlyHint: false },
38
39
 
39
40
  inputSchema: z.object({
40
41
  id: z.string().uuid().describe("The repo ID to update."),
41
- url: z.string().optional().describe("New repo URL."),
42
+ url: z
43
+ .string()
44
+ .refine((value) => !value.startsWith("-"), 'url must not start with "-"')
45
+ .optional()
46
+ .describe("New repo URL."),
42
47
  name: z.string().optional().describe("New repo name."),
43
- clonePath: z.string().optional().describe("New clone path."),
44
- defaultBranch: z.string().optional().describe("New default branch."),
48
+ clonePath: z
49
+ .string()
50
+ .refine((value) => !value.startsWith("-"), 'clonePath must not start with "-"')
51
+ .optional()
52
+ .describe("New clone path."),
53
+ defaultBranch: z
54
+ .string()
55
+ .refine((value) => !value.startsWith("-"), 'defaultBranch must not start with "-"')
56
+ .optional()
57
+ .describe("New default branch."),
45
58
  autoClone: z.boolean().optional().describe("Whether to auto-clone."),
46
59
  hooks: RepoHooksSchema.nullable()
47
60
  .optional()
@@ -61,20 +74,25 @@ export const registerUpdateRepoTool = (server: McpServer) => {
61
74
  async ({ id, ...updates }, requestInfo) => {
62
75
  // The comparison with the stored merge policy, the decision and the write share one
63
76
  // transaction, so a stale edit cannot overwrite a merge-policy change committed after it.
64
- const result = await updateSwarmRepoChecked(id, updates, async (existing) => {
65
- const agent = requestInfo.agentId ? await getAgentById(requestInfo.agentId) : null;
66
- const decision = can({
67
- principal: requestInfo.agentId
68
- ? { kind: "agent", agentId: requestInfo.agentId, isLead: agent?.isLead ?? false }
69
- : { kind: "operator" },
70
- verb: "repo.merge-policy.write",
71
- resource: { kind: "none" },
72
- source: "mcp",
73
- });
74
- if (decision.allow) return null;
75
- const current = agentsMayMerge(existing.guidelines);
76
- return `Only lead agents can change allowMerge or mergePolicy (agents may merge: ${current}). Resend the current allowMerge and mergePolicy to keep them while you edit the other guidelines.`;
77
- });
77
+ const result = await updateSwarmRepoChecked(
78
+ id,
79
+ updates,
80
+ async (existing) => {
81
+ const agent = requestInfo.agentId ? await getAgentById(requestInfo.agentId) : null;
82
+ const decision = can({
83
+ principal: requestInfo.agentId
84
+ ? { kind: "agent", agentId: requestInfo.agentId, isLead: agent?.isLead ?? false }
85
+ : { kind: "operator" },
86
+ verb: "repo.merge-policy.write",
87
+ resource: { kind: "none" },
88
+ source: "mcp",
89
+ });
90
+ if (decision.allow) return null;
91
+ const current = agentsMayMerge(existing.guidelines);
92
+ return `Only lead agents can change allowMerge or mergePolicy (agents may merge: ${current}). Resend the current allowMerge and mergePolicy to keep them while you edit the other guidelines.`;
93
+ },
94
+ () => execConfigRefusal(getCurrentRequestAuth(), "mcp"),
95
+ );
78
96
 
79
97
  if (result.kind === "refused") {
80
98
  return toolErr(result.refusal, { data: { repo: null } });
@@ -1,8 +1,10 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
- import { getScheduledTaskById, getScheduledTaskByName } from "@/be/db";
3
+ import { getAgentById, getScheduledTaskById, getScheduledTaskByName } from "@/be/db";
4
+ import { can } from "@/rbac";
4
5
  import { runScheduleNow } from "@/scheduler";
5
6
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
7
+ import { getCurrentRequestAuth } from "@/utils/request-auth-context";
6
8
 
7
9
  export const registerRunScheduleNowTool = (server: McpServer) => {
8
10
  createToolRegistrar(server)(
@@ -47,6 +49,24 @@ export const registerRunScheduleNowTool = (server: McpServer) => {
47
49
  return toolErr("Schedule not found.");
48
50
  }
49
51
 
52
+ // A schedule runs as its creator. An agent-bound token may run it only
53
+ // as its creator or a lead.
54
+ const auth = getCurrentRequestAuth();
55
+ if (auth?.kind === "agent") {
56
+ const caller = await getAgentById(auth.agentId);
57
+ const decision = can({
58
+ principal: { kind: "agent", agentId: auth.agentId, isLead: caller?.isLead === true },
59
+ verb: "schedule.run.any",
60
+ resource: { kind: "owned", ownerAgentId: schedule.createdByAgentId },
61
+ source: "mcp",
62
+ });
63
+ if (!decision.allow) {
64
+ return toolErr(
65
+ `Schedule "${schedule.name}" runs as the agent that created it. Only that agent or a lead can run it.`,
66
+ );
67
+ }
68
+ }
69
+
50
70
  if (!schedule.enabled) {
51
71
  return toolErr(`Schedule "${schedule.name}" is disabled.`, {
52
72
  details: "Enable it first or use it as a template.",
@@ -15,7 +15,12 @@ const scriptApisInputSchema = z.object({
15
15
  "list: endpoints for a script, tokens masked unless includeSecrets=true. create: expose the script as a new endpoint (returns the plaintext token once). update: enable/disable or relabel an endpoint. rotate: issue a new token (returns it once). delete: remove an endpoint.",
16
16
  ),
17
17
  scriptId: z.string().uuid().describe("The script the endpoint(s) belong to."),
18
- endpointId: z.string().optional().describe("Required for update, rotate, and delete."),
18
+ // Endpoint ids are short alphanumeric ids; the id goes into the API path.
19
+ endpointId: z
20
+ .string()
21
+ .regex(/^[A-Za-z0-9_-]+$/, "endpointId must be an endpoint id")
22
+ .optional()
23
+ .describe("Required for update, rotate, and delete."),
19
24
  authMode: z
20
25
  .enum(["none", "bearer"])
21
26
  .optional()
@@ -180,7 +185,7 @@ export const registerScriptApisTool = (server: McpServer) => {
180
185
 
181
186
  const result = await proxyScriptsApi({
182
187
  method: "POST",
183
- path: `/api/scripts/${args.scriptId}/apis/${args.endpointId}/rotate`,
188
+ path: `/api/scripts/${args.scriptId}/apis/${encodeURIComponent(args.endpointId)}/rotate`,
184
189
  requestInfo,
185
190
  successMessage: () => "Token rotated.",
186
191
  successDetails: (data) => {
@@ -209,7 +214,7 @@ export const registerScriptApisTool = (server: McpServer) => {
209
214
 
210
215
  return proxyScriptsApi({
211
216
  method: "PATCH",
212
- path: `/api/scripts/${args.scriptId}/apis/${args.endpointId}`,
217
+ path: `/api/scripts/${args.scriptId}/apis/${encodeURIComponent(args.endpointId)}`,
213
218
  body: { enabled: args.enabled, label: args.label },
214
219
  requestInfo,
215
220
  successMessage: () => "Endpoint updated.",
@@ -227,7 +232,7 @@ export const registerScriptApisTool = (server: McpServer) => {
227
232
 
228
233
  return proxyScriptsApi({
229
234
  method: "DELETE",
230
- path: `/api/scripts/${args.scriptId}/apis/${args.endpointId}`,
235
+ path: `/api/scripts/${args.scriptId}/apis/${encodeURIComponent(args.endpointId)}`,
231
236
  requestInfo,
232
237
  successMessage: () => "Endpoint deleted.",
233
238
  });
@@ -1,6 +1,6 @@
1
1
  import * as z from "zod";
2
2
  import { getApiKey } from "@/utils/api-key";
3
- import { getMcpBaseUrl } from "@/utils/constants";
3
+ import { getScriptApiBaseUrl } from "@/utils/constants";
4
4
  import {
5
5
  type RequestInfo,
6
6
  type SwarmToolData,
@@ -41,7 +41,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
41
41
  }
42
42
 
43
43
  function apiBaseUrl(): string {
44
- return getMcpBaseUrl();
44
+ return getScriptApiBaseUrl();
45
45
  }
46
46
 
47
47
  /** `{path, message}` renders as one `path: message` line; anything else verbatim. */
@@ -22,6 +22,7 @@ export function renderRunOutput(data: unknown): string | undefined {
22
22
  truncated?: { stdout?: boolean; stderr?: boolean };
23
23
  autoSaved?: { slug?: string };
24
24
  kvSaved?: { namespace?: string; key?: string };
25
+ object?: { stateVersion?: number };
25
26
  };
26
27
  const parts: string[] = [];
27
28
  if (body.result !== undefined) {
@@ -34,6 +35,9 @@ export function renderRunOutput(data: unknown): string | undefined {
34
35
  }
35
36
  const notes: string[] = [];
36
37
  if (typeof body.durationMs === "number") notes.push(`${body.durationMs}ms`);
38
+ if (typeof body.object?.stateVersion === "number") {
39
+ notes.push(`object.stateVersion: ${body.object.stateVersion}`);
40
+ }
37
41
  if (body.truncated?.stdout || body.truncated?.stderr) {
38
42
  notes.push("output truncated by the runtime");
39
43
  }
@@ -54,6 +58,10 @@ export const registerScriptRunTool = (server: McpServer) => {
54
58
  annotations: { openWorldHint: true },
55
59
  inputSchema: z.object({
56
60
  name: scriptNameSchema.optional().describe("Name of a reusable script to run."),
61
+ object: z
62
+ .object({ id: z.string().min(1).max(256), method: z.string().min(1).max(128) })
63
+ .optional()
64
+ .describe("Call this object ID and method on the named global DurableObject script."),
57
65
  source: z
58
66
  .string()
59
67
  .min(1)
@@ -26,7 +26,7 @@ export const registerScriptUpsertTool = (server: McpServer) => {
26
26
  .string()
27
27
  .min(1)
28
28
  .describe(
29
- 'TypeScript source, typechecked before saving. Must `export default async function (args, ctx)` — args FIRST, ctx second. Import `ScriptContext` from "swarm-sdk" to type `ctx`. Schemas can import "zod" or "zod/mini"; Mini uses functional forms such as z.optional(z.string()).',
29
+ 'TypeScript source, typechecked before saving. Must `export default async function (args, ctx)` — args FIRST, ctx second. Import `ScriptContext` from "swarm-sdk" to type `ctx`. Schemas can import "zod" or "zod/mini"; Mini uses functional forms such as z.optional(z.string()). A global script can instead `export default class X extends DurableObject<State>` (import `DurableObject` from "swarm-sdk").',
30
30
  ),
31
31
  description: z.string().default("").describe("Human-readable script description."),
32
32
  intent: z.string().default("").describe("Why this script exists."),