@desplega.ai/agent-swarm 2.10.0 → 2.12.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 (572) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-c4chgxp6.js} +27 -24
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-hn5fftf5.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-3g6yc8nv.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-cpjgpjvp.js} +29 -26
  10. package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
  11. package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-hce1av1h.js} +1 -1
  12. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-bztbxc4z.js} +1 -1
  13. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-d7xcym0j.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-arrkbe8t.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-68n75y1s.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-ykpyr5p8.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-trd59v7b.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-yjcze0j1.js} +10941 -10412
  21. package/dist/{cli-vq2eg24x.js → cli-01tvvtad.js} +63 -60
  22. package/dist/cli-04zc3f7b.js +68 -0
  23. package/dist/{cli-01k6wpr9.js → cli-0k1a0sde.js} +7 -7
  24. package/dist/{cli-j6te8keb.js → cli-0pp1yjg2.js} +8 -8
  25. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  26. package/dist/{cli-wwp1bd3n.js → cli-12vek61e.js} +564 -97
  27. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  28. package/dist/{cli-124ntmf0.js → cli-1htmtqc2.js} +143 -63
  29. package/dist/{cli-3f8zbtqa.js → cli-2amwhyv2.js} +15 -11
  30. package/dist/{cli-7sf9sb0w.js → cli-2m6yaq6b.js} +1 -1
  31. package/dist/{cli-6cwr32fe.js → cli-2tw284hj.js} +422 -140
  32. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  33. package/dist/{cli-nstkanmx.js → cli-39qm0rtm.js} +8 -8
  34. package/dist/{cli-hnamkvnc.js → cli-3p288654.js} +2 -2
  35. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  38. package/dist/cli-52nfye5j.js +673 -0
  39. package/dist/cli-55tc8cj4.js +252 -0
  40. package/dist/cli-5r95eqbh.js +186 -0
  41. package/dist/{cli-6037prsx.js → cli-5tg94mdw.js} +13 -13
  42. package/dist/{cli-2spnz7ye.js → cli-5x03v6en.js} +11137 -8332
  43. package/dist/{cli-y4ccxtz5.js → cli-5z0g0e8v.js} +153 -6
  44. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  45. package/dist/{cli-539h29es.js → cli-72yms3ey.js} +224 -189
  46. package/dist/{cli-y8p78ekx.js → cli-73q4g5nx.js} +21 -21
  47. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  48. package/dist/{cli-43ms35q9.js → cli-7wy8gbwb.js} +3 -3
  49. package/dist/{cli-7mv4h3sn.js → cli-7yn42w6m.js} +2 -2
  50. package/dist/{cli-gabsjg8x.js → cli-8hp56wat.js} +3 -2
  51. package/dist/cli-8mfdbdhe.js +43 -0
  52. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  53. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  54. package/dist/{cli-2rnd5j3t.js → cli-9qe5y107.js} +2 -2
  55. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  56. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3aaeb78m.js → cli-agjbj5x0.js} +95 -10
  59. package/dist/{cli-th1dkc2v.js → cli-b93d81yg.js} +2 -2
  60. package/dist/{cli-qj39vrc6.js → cli-bhgrhedp.js} +1 -1
  61. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  62. package/dist/{cli-9fjr27ez.js → cli-bp6k9acz.js} +18 -22
  63. package/dist/{cli-5a6pqy45.js → cli-bpje8n65.js} +31 -4
  64. package/dist/{cli-2v2zdm0a.js → cli-bz97ff9n.js} +2 -2
  65. package/dist/{cli-3caf7pmg.js → cli-c7j31hq9.js} +3 -3
  66. package/dist/{cli-t9ga4qmb.js → cli-cah298e5.js} +40 -33
  67. package/dist/{cli-aw83sr40.js → cli-cjqyse9q.js} +3 -3
  68. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  69. package/dist/{cli-nv4xsvmk.js → cli-dkvtfgn4.js} +7 -7
  70. package/dist/{cli-7r162fxe.js → cli-e3ahxq5y.js} +23 -17
  71. package/dist/{cli-3et6fmfe.js → cli-e8n0hdzd.js} +1 -1
  72. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  73. package/dist/{cli-kbtzfrxj.js → cli-en6dmkxd.js} +3 -3
  74. package/dist/{cli-m9cvf7vs.js → cli-eq4kew31.js} +14 -14
  75. package/dist/{cli-fcfbct2j.js → cli-eqq0hwvx.js} +5 -5
  76. package/dist/{cli-7zm3b3f5.js → cli-ercwc8xn.js} +1 -1
  77. package/dist/{cli-vs9vdpy0.js → cli-ex1y88j3.js} +1 -1
  78. package/dist/{cli-mk7c5ac4.js → cli-fxd1mwtr.js} +2 -2
  79. package/dist/{cli-91pkxres.js → cli-fy4gb74g.js} +2 -2
  80. package/dist/{cli-fq2rr3jb.js → cli-fyaq4zdv.js} +6 -6
  81. package/dist/{cli-cc93xzes.js → cli-gfy6hbd9.js} +28 -17
  82. package/dist/{cli-s1khw52h.js → cli-h70a2mxy.js} +71 -17
  83. package/dist/cli-hbvgzjq4.js +69 -0
  84. package/dist/{cli-qx4f057j.js → cli-hhc47ack.js} +4 -4
  85. package/dist/{cli-q5srsxq2.js → cli-j5gtytvg.js} +154 -41
  86. package/dist/{cli-psffsanb.js → cli-js10kdk7.js} +6 -1
  87. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  88. package/dist/{cli-vsw91x06.js → cli-k5jx8jya.js} +10 -6
  89. package/dist/{cli-tr27kwyg.js → cli-krbcr00p.js} +261 -6
  90. package/dist/{cli-5qhfv9rw.js → cli-kwr5qv5g.js} +44 -17
  91. package/dist/{cli-md50mj0r.js → cli-m5qtmrbc.js} +3 -3
  92. package/dist/{cli-vfqvrd82.js → cli-ma9ys8rt.js} +2 -2
  93. package/dist/{cli-w16kwbzw.js → cli-mbwmqb5w.js} +1 -1
  94. package/dist/{cli-w1q68d8x.js → cli-mcymtvwn.js} +322 -72
  95. package/dist/{cli-k3q2va86.js → cli-mq2fbgva.js} +66 -5
  96. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  97. package/dist/{cli-kpgcm7xy.js → cli-n85m2wkq.js} +1 -1
  98. package/dist/{cli-v8z0yga9.js → cli-n8f0fs3c.js} +4 -4
  99. package/dist/{cli-mys27d03.js → cli-nja15knq.js} +3 -3
  100. package/dist/{cli-zk7v5s89.js → cli-pe3yxedk.js} +3 -3
  101. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  102. package/dist/{cli-6237rnyr.js → cli-pqfecppn.js} +1 -1
  103. package/dist/{cli-qrta34nb.js → cli-q2dywc8h.js} +4 -4
  104. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  105. package/dist/{cli-s1zqk1aj.js → cli-q8tc22bj.js} +15 -9
  106. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  107. package/dist/{cli-43evxwj4.js → cli-r0mz92by.js} +9 -4
  108. package/dist/{cli-jrbq4djp.js → cli-r14ac1y0.js} +1 -1
  109. package/dist/{cli-5gpqgs8b.js → cli-rtmqzat7.js} +2 -2
  110. package/dist/{cli-tvgqesec.js → cli-s6zk31gr.js} +4 -4
  111. package/dist/{cli-6ym4jhzp.js → cli-sv2r3bw8.js} +7 -7
  112. package/dist/{cli-wafmk3fn.js → cli-t75xngj1.js} +12 -12
  113. package/dist/{cli-x40a0w9j.js → cli-tdk7jtka.js} +1 -1
  114. package/dist/{cli-zeh2mhkg.js → cli-tm60vtax.js} +1 -1
  115. package/dist/cli-tsfkcd4v.js +30 -0
  116. package/dist/{cli-8st34zhr.js → cli-v9ya390t.js} +57 -19
  117. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  118. package/dist/{cli-p0n7b5rz.js → cli-wvjqaqcp.js} +2907 -151
  119. package/dist/{cli-sb4426be.js → cli-xf4z5bdn.js} +5 -5
  120. package/dist/{cli-p0c3vtch.js → cli-xm34qj8m.js} +772 -515
  121. package/dist/{cli-z0m452jr.js → cli-ya3kf4gs.js} +1 -1
  122. package/dist/{cli-had1p04a.js → cli-yegz2g06.js} +4 -4
  123. package/dist/{cli-k5yewqgd.js → cli-yfpc6qy9.js} +3 -3
  124. package/dist/{cli-q2d3e1k1.js → cli-z4f346g5.js} +1 -1
  125. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  126. package/dist/cli.js +34 -30
  127. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  128. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-wc6e4wct.js} +8 -8
  129. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  130. package/dist/{codex-login-a239g1ah.js → codex-login-1ven7yje.js} +1 -1
  131. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-ppfgjd97.js} +9 -9
  132. package/dist/{commands-d8g349v4.js → commands-tsv2vx5b.js} +3 -3
  133. package/dist/{controller-mwgdmb8y.js → controller-ye4sdwsy.js} +4 -4
  134. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-zn4dg69h.js} +25 -22
  135. package/dist/core-dxcy02sc.js +41 -0
  136. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-q2g9vwts.js} +2 -2
  137. package/dist/{db-wcw0b2j8.js → db-3r1fyr2n.js} +6 -2
  138. package/dist/{db-qpganbeb.js → db-g111qn9j.js} +3 -3
  139. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-t8d86q9x.js} +1 -1
  140. package/dist/{dispatcher-8d8s49yz.js → dispatcher-4q8s0mx8.js} +22 -19
  141. package/dist/{docker-09tkkg0n.js → docker-1b41eysj.js} +51 -14
  142. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-mmcw1z5s.js} +2 -2
  143. package/dist/{e2b-3v1e745x.js → e2b-ew8c5j5v.js} +3 -3
  144. package/dist/{e2b-sm28k0k3.js → e2b-xm60c8ad.js} +6 -6
  145. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-04ke6hcp.js} +1 -1
  146. package/dist/{embedding-space-e48xchqa.js → embedding-space-kcdn52vz.js} +6 -6
  147. package/dist/{embeddings-tgq2afbq.js → embeddings-jnzcd91a.js} +1 -1
  148. package/dist/{event-bus-xr83x566.js → event-bus-v4ywhc2p.js} +1 -1
  149. package/dist/{execute-8rhwrk7f.js → execute-74amghty.js} +8 -4
  150. package/dist/{external-channel-8bt3j2pm.js → external-channel-v9zgxnxz.js} +2 -2
  151. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  152. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  153. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  154. package/dist/grok-adapter-t6m74fb1.js +19 -0
  155. package/dist/handlers-9kwcrc4k.js +38 -0
  156. package/dist/{heartbeat-x0056ra5.js → heartbeat-p8pk1msj.js} +25 -22
  157. package/dist/{hook-a7vmn2st.js → hook-k1h73zd7.js} +5 -5
  158. package/dist/{hook-mrd2ayxv.js → hook-p5reemds.js} +8 -8
  159. package/dist/{http-ym9c5svp.js → http-ms1z5xxy.js} +2549 -224
  160. package/dist/index-23cdfzr6.js +39 -0
  161. package/dist/{index-01ns1pkw.js → index-76zzxtzf.js} +1 -1
  162. package/dist/{index-ny60jcat.js → index-fbkqhvvj.js} +40 -18
  163. package/dist/index-g7kkjs5b.js +38 -0
  164. package/dist/{index-x6azjwm8.js → index-gjn6qfgn.js} +1 -1
  165. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  166. package/dist/{index-p46tvwtx.js → index-kn63q1gr.js} +28 -25
  167. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  168. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  169. package/dist/index-stk36pa5.js +43 -0
  170. package/dist/{k8s-m56sw868.js → k8s-fy8hbhkg.js} +73 -14
  171. package/dist/{keepalive-7yxg8z4c.js → keepalive-031js8jz.js} +4 -4
  172. package/dist/lead-mfggjtfk.js +77 -0
  173. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  174. package/dist/{maintenance-6tefxmk1.js → maintenance-sq9v3qx9.js} +1 -1
  175. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  176. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  177. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  178. package/dist/object-webhooks-r24wwb5y.js +21 -0
  179. package/dist/{onboard-fja65z08.js → onboard-p25yhh7t.js} +5 -5
  180. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  181. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  182. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  183. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  184. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-wcjc4zdk.js} +7 -7
  185. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  186. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-ff1gf20m.js} +2 -2
  187. package/dist/{pending-h01yzpx4.js → pending-hxj5yatb.js} +23 -20
  188. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  189. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-vkp4zz7p.js} +19 -18
  190. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-9w7gx41w.js} +2 -2
  191. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-84aw10nz.js} +3 -3
  192. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-hz74vckp.js} +2 -2
  193. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  194. package/dist/{render-v2-1rgspxzf.js → render-v2-nrdkg9gf.js} +7 -6
  195. package/dist/{resume-tqy61x24.js → resume-s6ey36rh.js} +9 -8
  196. package/dist/{runtime-exkxyx5f.js → runtime-x0b4pyam.js} +2 -2
  197. package/dist/{session-access-3act7vt4.js → session-access-xv49tk14.js} +4 -4
  198. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-r5j988ah.js} +3 -3
  199. package/dist/{setup-ry1vfdef.js → setup-mj0krk1p.js} +1 -1
  200. package/dist/thread-buffer-temgaqsy.js +41 -0
  201. package/dist/tree-visibility-cbrsfaar.js +24 -0
  202. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  203. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  204. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-ns0ryw05.js} +32 -10
  205. package/dist/{work-objects-z2e5tv03.js → work-objects-pydhzast.js} +25 -22
  206. package/dist/worker-efcemc22.js +77 -0
  207. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-9z2xec5e.js} +22 -19
  208. package/dist/{x-wg164ss9.js → x-3dtaf2r9.js} +2 -2
  209. package/openapi.json +2040 -559
  210. package/package.json +15 -11
  211. package/src/azure-devops/auth.ts +2 -3
  212. package/src/be/agent-fs-identity.ts +46 -0
  213. package/src/be/agent-history.ts +215 -0
  214. package/src/be/db/agents.ts +34 -12
  215. package/src/be/db/request-composition.ts +190 -0
  216. package/src/be/db/runtime.ts +15 -0
  217. package/src/be/db/slack-trees.ts +220 -10
  218. package/src/be/db/tasks/human-free.ts +3 -2
  219. package/src/be/db/tasks/write.ts +2 -2
  220. package/src/be/db/workflow-run-retention.ts +101 -0
  221. package/src/be/db-client.ts +23 -1
  222. package/src/be/db-retention-defaults.ts +46 -0
  223. package/src/be/db-retention.ts +55 -6
  224. package/src/be/db.ts +2 -0
  225. package/src/be/mcp-events/catalog.ts +108 -0
  226. package/src/be/mcp-events/dispatcher.ts +202 -0
  227. package/src/be/mcp-events/protocol.ts +296 -0
  228. package/src/be/mcp-events/store.ts +231 -0
  229. package/src/be/mcp-events/webhook.ts +226 -0
  230. package/src/be/memory/providers/sqlite-store.ts +110 -24
  231. package/src/be/memory/review-recall-filter.ts +22 -0
  232. package/src/be/memory/search-candidates.ts +5 -7
  233. package/src/be/memory/types.ts +5 -0
  234. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  235. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  236. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  237. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  238. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  239. package/src/be/migrations/330_request_composition.sql +22 -0
  240. package/src/be/migrations/332_primitive_objects.sql +31 -0
  241. package/src/be/migrations/334_agent_history.sql +23 -0
  242. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  243. package/src/be/model-profile-check.ts +1 -1
  244. package/src/be/multi-runtime.ts +32 -4
  245. package/src/be/primitives/boards/elements.ts +717 -0
  246. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  247. package/src/be/primitives/boards/service.ts +121 -0
  248. package/src/be/primitives/object-webhooks.ts +348 -0
  249. package/src/be/primitives/objects.ts +686 -0
  250. package/src/be/primitives/sheets/a1.ts +136 -0
  251. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  252. package/src/be/primitives/sheets/engine.ts +199 -0
  253. package/src/be/primitives/sheets/format.ts +106 -0
  254. package/src/be/primitives/sheets/service.ts +415 -0
  255. package/src/be/primitives/write-object.ts +83 -0
  256. package/src/be/runtime-pools/controllers.ts +18 -3
  257. package/src/be/runtime-pools/db.ts +15 -4
  258. package/src/be/runtime-pools/supervisor.ts +42 -2
  259. package/src/be/script-credential-broker.ts +8 -27
  260. package/src/be/scripts/typecheck.ts +216 -0
  261. package/src/be/seed/agent-fs-provision.ts +18 -0
  262. package/src/be/swarm-config-guard.ts +10 -2
  263. package/src/be/users.ts +19 -0
  264. package/src/commands/context-preamble.ts +11 -4
  265. package/src/commands/credential-outcome-report.ts +33 -9
  266. package/src/commands/e2b-stack-wizard.tsx +12 -6
  267. package/src/commands/onboard/agent-fs-version.ts +1 -1
  268. package/src/commands/onboard/steps/harness.tsx +1 -1
  269. package/src/commands/provider-credentials.ts +1 -0
  270. package/src/commands/runner.ts +116 -12
  271. package/src/e2b/env.ts +3 -1
  272. package/src/extensions/catalog.generated.json +1 -1
  273. package/src/fs/agent-fs-provider.ts +33 -2
  274. package/src/github/app.ts +59 -14
  275. package/src/gitlab/auth.ts +3 -4
  276. package/src/heartbeat/heartbeat.ts +11 -11
  277. package/src/http/agent-lifecycle.ts +152 -0
  278. package/src/http/agents.ts +12 -0
  279. package/src/http/all-routes.ts +4 -0
  280. package/src/http/auth.ts +2 -1
  281. package/src/http/config.ts +2 -1
  282. package/src/http/core.ts +2 -0
  283. package/src/http/github-token.ts +66 -0
  284. package/src/http/index.ts +36 -0
  285. package/src/http/mcp-user.ts +11 -8
  286. package/src/http/mcp.ts +58 -42
  287. package/src/http/object-webhooks.ts +101 -0
  288. package/src/http/operator-actor.ts +2 -1
  289. package/src/http/prompt-templates.ts +1 -0
  290. package/src/http/request-composition.ts +310 -0
  291. package/src/http/sessions.ts +7 -0
  292. package/src/http/tasks.ts +6 -1
  293. package/src/http/tool-schema-estimate.ts +95 -0
  294. package/src/http/workflows.ts +61 -11
  295. package/src/integrations/chat-sdk/inbound.ts +2 -2
  296. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  297. package/src/prompts/base-prompt.ts +133 -7
  298. package/src/prompts/resolver.ts +41 -2
  299. package/src/providers/acp-targets.ts +2 -2
  300. package/src/providers/amp-adapter.ts +1 -1
  301. package/src/providers/opencode-adapter.ts +76 -2
  302. package/src/providers/opencode-swarm-plugin.ts +22 -3
  303. package/src/providers/pi-mono-adapter.ts +1 -0
  304. package/src/providers/pi-mono-extension.ts +71 -0
  305. package/src/providers/pricing-sources.md +4 -0
  306. package/src/providers/request-composition-hook.ts +312 -0
  307. package/src/providers/types.ts +5 -0
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/runtime-providers/controller-protocol.ts +7 -0
  311. package/src/runtime-providers/docker.ts +80 -12
  312. package/src/runtime-providers/k8s.ts +111 -6
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/script-workflows/guest-ctx.ts +32 -0
  316. package/src/script-workflows/workflow-ctx.ts +2 -0
  317. package/src/scripts-runtime/ctx.ts +9 -1
  318. package/src/scripts-runtime/executors/native.ts +106 -21
  319. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  320. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  321. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  322. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  323. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  324. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  325. package/src/server-user.ts +16 -1
  326. package/src/server.ts +48 -0
  327. package/src/slack/ack.ts +10 -5
  328. package/src/slack/actions.ts +3 -3
  329. package/src/slack/app.ts +2 -0
  330. package/src/slack/assistant.ts +4 -4
  331. package/src/slack/blocks.ts +3 -3
  332. package/src/slack/handlers.ts +3 -3
  333. package/src/slack/reaction-shortcode.ts +23 -2
  334. package/src/slack/render-v2.ts +297 -200
  335. package/src/slack/responses.ts +7 -5
  336. package/src/slack/thread-buffer.ts +3 -3
  337. package/src/slack/tree-visibility.ts +64 -0
  338. package/src/tasks/worker-follow-up.ts +127 -17
  339. package/src/tests/agent-history.test.ts +313 -0
  340. package/src/tests/azure-devops-auth.test.ts +6 -0
  341. package/src/tests/azure-devops-outbound.test.ts +47 -14
  342. package/src/tests/base-prompt.test.ts +149 -1
  343. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  344. package/src/tests/check-playwright-version.test.ts +33 -0
  345. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  346. package/src/tests/context-preamble-budget.test.ts +65 -0
  347. package/src/tests/credential-check.test.ts +12 -0
  348. package/src/tests/credential-outcome-report.test.ts +81 -1
  349. package/src/tests/db-client.test.ts +22 -0
  350. package/src/tests/db-retention-defaults.test.ts +244 -0
  351. package/src/tests/db-retention.test.ts +2 -1
  352. package/src/tests/db-task-read-contract.test.ts +2 -0
  353. package/src/tests/db-task-write-contract.test.ts +2 -0
  354. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  355. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  356. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  357. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  358. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  359. package/src/tests/e2e-shards.test.ts +137 -0
  360. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  361. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  362. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  363. package/src/tests/env-flag.test.ts +4 -2
  364. package/src/tests/event-loop-lag.test.ts +12 -18
  365. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  366. package/src/tests/extensions-heartbeat.test.ts +34 -0
  367. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  368. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  369. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  370. package/src/tests/github-installation-token-route.test.ts +199 -0
  371. package/src/tests/gitlab-auth.test.ts +10 -0
  372. package/src/tests/heartbeat.test.ts +38 -0
  373. package/src/tests/http-api-integration.test.ts +0 -6
  374. package/src/tests/mcp-user-events.test.ts +708 -0
  375. package/src/tests/memory-key-paths.test.ts +4 -1
  376. package/src/tests/memory-search-stall.test.ts +421 -0
  377. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  378. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  379. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  380. package/src/tests/opencode-adapter.test.ts +97 -0
  381. package/src/tests/pi-mono-extension.test.ts +168 -0
  382. package/src/tests/preload-env.test.ts +61 -1
  383. package/src/tests/preload.ts +22 -0
  384. package/src/tests/primitives-boards.test.ts +686 -0
  385. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  386. package/src/tests/primitives-objects.test.ts +248 -0
  387. package/src/tests/prompt-template-resolver.test.ts +85 -0
  388. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  389. package/src/tests/reload-config.test.ts +45 -0
  390. package/src/tests/request-composition.test.ts +447 -0
  391. package/src/tests/runner-max-concurrent.test.ts +86 -0
  392. package/src/tests/runtime-pools-db.test.ts +80 -0
  393. package/src/tests/runtime-provider-registration.test.ts +8 -0
  394. package/src/tests/runtime-providers-docker.test.ts +192 -1
  395. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  396. package/src/tests/runtime-remote-controller.test.ts +64 -1
  397. package/src/tests/runtime-supervisor.test.ts +101 -0
  398. package/src/tests/script-connections.test.ts +8 -0
  399. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  400. package/src/tests/scripts-namespaces.test.ts +211 -0
  401. package/src/tests/secret-scrub-gate.test.ts +1 -0
  402. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  403. package/src/tests/secret-scrubber.test.ts +1 -1
  404. package/src/tests/session-tokens.test.ts +27 -0
  405. package/src/tests/sheet-engine.test.ts +58 -0
  406. package/src/tests/slack-blocks.test.ts +18 -0
  407. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  408. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  409. package/src/tests/slack-reaction-config.test.ts +38 -2
  410. package/src/tests/slack-read-boundaries.test.ts +4 -2
  411. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  412. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  413. package/src/tests/slack-render-v2.test.ts +683 -11
  414. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  415. package/src/tests/task-session-prompts.test.ts +37 -0
  416. package/src/tests/task-start-after-commit.test.ts +82 -0
  417. package/src/tests/ui-logs-parser.test.ts +67 -0
  418. package/src/tests/user-delete-perf.test.ts +36 -9
  419. package/src/tests/webhook-filter.test.ts +327 -0
  420. package/src/tests/workflow-async-v2.test.ts +19 -16
  421. package/src/tests/workflow-e2e.test.ts +1 -9
  422. package/src/tests/workflow-finalization-races.test.ts +553 -0
  423. package/src/tests/workflow-foreach.test.ts +2 -0
  424. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  425. package/src/tests/workflow-http-v2.test.ts +105 -2
  426. package/src/tests/workflow-idempotency.test.ts +41 -0
  427. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  428. package/src/tests/workflow-parallel-park.test.ts +297 -0
  429. package/src/tests/workflow-retry-v2.test.ts +158 -21
  430. package/src/tests/workflow-retry-validation.test.ts +13 -13
  431. package/src/tests/workflow-runs-retention.test.ts +533 -0
  432. package/src/tests/workflow-script-principal.test.ts +7 -2
  433. package/src/tests/workflow-tla-races.test.ts +36 -2
  434. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  435. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  436. package/src/tests/workflow-wait-event.test.ts +28 -2
  437. package/src/tests/workflow-wait-poller.test.ts +94 -0
  438. package/src/tests/workflow-wait-time.test.ts +7 -3
  439. package/src/tests/workflow-wait.ts +44 -0
  440. package/src/tools/boards.ts +260 -0
  441. package/src/tools/objects.ts +191 -0
  442. package/src/tools/sheets.ts +312 -0
  443. package/src/tools/slack-read.ts +10 -3
  444. package/src/tools/tool-config.ts +23 -0
  445. package/src/tools/workflows/create-workflow.ts +18 -4
  446. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  447. package/src/tools/workflows/patch-workflow.ts +4 -0
  448. package/src/tools/workflows/update-workflow.ts +24 -3
  449. package/src/types.ts +216 -2
  450. package/src/utils/credentials.ts +7 -0
  451. package/src/utils/sandboxed-process.ts +47 -2
  452. package/src/utils/secret-scrubber.ts +61 -6
  453. package/src/workflows/checkpoint.ts +18 -0
  454. package/src/workflows/engine.ts +73 -31
  455. package/src/workflows/foreach-driver.ts +42 -4
  456. package/src/workflows/input.ts +29 -1
  457. package/src/workflows/patch-definition.ts +15 -1
  458. package/src/workflows/recovery.ts +6 -1
  459. package/src/workflows/resume.ts +11 -3
  460. package/src/workflows/retry-poller.ts +32 -6
  461. package/src/workflows/successor-routing.ts +108 -0
  462. package/src/workflows/task-step-routing.ts +5 -2
  463. package/src/workflows/triggers.ts +21 -36
  464. package/src/workflows/validation.ts +10 -0
  465. package/src/workflows/wait-poller.ts +6 -2
  466. package/src/workflows/webhook-filter.ts +203 -0
  467. package/templates/ai-toolbox.manifest.json +1 -1
  468. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  469. package/templates/skills/agent-browser/SKILL.md +1 -0
  470. package/templates/skills/agent-browser/content.md +1 -0
  471. package/templates/skills/pages/content.md +5 -0
  472. package/templates/skills/swarm-docs/content.md +8 -1
  473. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  474. package/templates/skills/swarm-scripts/content.md +1 -0
  475. package/templates/skills/tdd-planning/content.md +5 -2
  476. package/dist/acp-adapter-bht22g3k.js +0 -16
  477. package/dist/core-sxy4epp2.js +0 -38
  478. package/dist/fx-adapter-adtdb3jb.js +0 -19
  479. package/dist/grok-adapter-accnn9km.js +0 -19
  480. package/dist/handlers-1x77561e.js +0 -35
  481. package/dist/index-48qzcqzj.js +0 -35
  482. package/dist/index-rkvaambe.js +0 -36
  483. package/dist/index-xj1mq27m.js +0 -40
  484. package/dist/lead-enzn86bz.js +0 -74
  485. package/dist/thread-buffer-3x93yexa.js +0 -38
  486. package/dist/worker-zfcv2wbf.js +0 -74
  487. package/src/slack/socket-mode-guard.test.ts +0 -25
  488. package/src/tests/agent-activity.test.ts +0 -247
  489. package/src/tests/agent-fs-live-url.test.ts +0 -55
  490. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  491. package/src/tests/approval-sweeps-config.test.ts +0 -47
  492. package/src/tests/cards.test.ts +0 -169
  493. package/src/tests/chat-sdk-facts.test.ts +0 -23
  494. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  495. package/src/tests/core-auth.test.ts +0 -156
  496. package/src/tests/date-utils.test.ts +0 -48
  497. package/src/tests/db-context-versions.test.ts +0 -37
  498. package/src/tests/db-runtime.test.ts +0 -131
  499. package/src/tests/enabled-capabilities.test.ts +0 -20
  500. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  501. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  502. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  503. package/src/tests/github-event-labels.test.ts +0 -24
  504. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  505. package/src/tests/http-log-scrubbing.test.ts +0 -123
  506. package/src/tests/http-semconv-attributes.test.ts +0 -92
  507. package/src/tests/identity.test.ts +0 -117
  508. package/src/tests/inbox-state.test.ts +0 -167
  509. package/src/tests/internal-ai/models.test.ts +0 -54
  510. package/src/tests/launch-password-rejection.test.ts +0 -140
  511. package/src/tests/list-total-cache.test.ts +0 -88
  512. package/src/tests/match-route.test.ts +0 -187
  513. package/src/tests/memory-feature-flags.test.ts +0 -45
  514. package/src/tests/memory-get-tool.test.ts +0 -269
  515. package/src/tests/memory-health-endpoint.test.ts +0 -78
  516. package/src/tests/memory-http-access.test.ts +0 -221
  517. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  518. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  519. package/src/tests/openai-embedding-provider.test.ts +0 -159
  520. package/src/tests/org-identity.test.ts +0 -44
  521. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  522. package/src/tests/pages-browser-sdk.test.ts +0 -76
  523. package/src/tests/pages-feedback-keys.test.ts +0 -121
  524. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  525. package/src/tests/pages-list-endpoint.test.ts +0 -148
  526. package/src/tests/pages-password-mode.test.ts +0 -266
  527. package/src/tests/pages-public-authed-401.test.ts +0 -103
  528. package/src/tests/pages-public-html.test.ts +0 -297
  529. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  530. package/src/tests/pages-view-count.test.ts +0 -245
  531. package/src/tests/prompt-templates-db.test.ts +0 -616
  532. package/src/tests/rbac-engine.test.ts +0 -742
  533. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  534. package/src/tests/route-def-find-route.test.ts +0 -192
  535. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  536. package/src/tests/schedule-validation-helper.test.ts +0 -51
  537. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  538. package/src/tests/scheduler-backoff.test.ts +0 -166
  539. package/src/tests/script-run-token.test.ts +0 -75
  540. package/src/tests/scripts-extract-signature.test.ts +0 -47
  541. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  542. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  543. package/src/tests/short-id.test.ts +0 -23
  544. package/src/tests/skill-files-http.test.ts +0 -222
  545. package/src/tests/skill-get-file-tool.test.ts +0 -110
  546. package/src/tests/skill-script-refs.test.ts +0 -63
  547. package/src/tests/skill-update-scope.test.ts +0 -252
  548. package/src/tests/skills-bundle.test.ts +0 -99
  549. package/src/tests/slack-app-icon.test.ts +0 -94
  550. package/src/tests/slack-assistant-comention.test.ts +0 -139
  551. package/src/tests/slack-delete.test.ts +0 -157
  552. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  553. package/src/tests/slack-manifest.test.ts +0 -23
  554. package/src/tests/slack-task-output.test.ts +0 -90
  555. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  556. package/src/tests/swarm-diff.test.ts +0 -728
  557. package/src/tests/task-lifecycle-events.test.ts +0 -53
  558. package/src/tests/template-asset-config.test.ts +0 -18
  559. package/src/tests/template-fetch.test.ts +0 -490
  560. package/src/tests/themes-page-theme.test.ts +0 -155
  561. package/src/tests/tool-annotations.test.ts +0 -442
  562. package/src/tests/tool-output-agent-id.test.ts +0 -202
  563. package/src/tests/update-profile-agentid.test.ts +0 -248
  564. package/src/tests/whoami-route.test.ts +0 -162
  565. package/src/tests/workflow-definition-telemetry.test.ts +0 -134
  566. package/src/tests/workflow-patch.test.ts +0 -169
  567. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  568. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  569. package/src/tests/workflow-step-claims.test.ts +0 -152
  570. package/src/tests/workflow-step-order.test.ts +0 -92
  571. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  572. package/src/tests/workflow-versions.test.ts +0 -240
@@ -0,0 +1,312 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import * as z from "zod";
3
+ import { ObjectsError } from "@/be/primitives/objects";
4
+ import {
5
+ addSheetTab,
6
+ appendSheetRows,
7
+ clearSheetRange,
8
+ createSheet,
9
+ getSheet,
10
+ getSheetRange,
11
+ listSheets,
12
+ setSheetRange,
13
+ } from "@/be/primitives/sheets/service";
14
+ import { FilesError } from "@/fs/provider";
15
+ import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
16
+
17
+ // Loose, format-pin-free mirror of PrimitiveObject for MCP output validation.
18
+ const objectOutputSchema = z.looseObject({
19
+ id: z.string().optional(),
20
+ kind: z.string().optional(),
21
+ path: z.string().optional(),
22
+ title: z.string().nullable().optional(),
23
+ fileVersion: z.number().nullable().optional(),
24
+ link: z.string().nullable().optional(),
25
+ });
26
+
27
+ const CellValue = z.union([z.number(), z.string(), z.boolean(), z.null()]);
28
+ const Grid = z.array(z.array(CellValue));
29
+
30
+ const RANGE_HELP =
31
+ "A1 range such as `Tasks!B2:C3`, `A1:C10` (first tab), `'My tab'!A:A` (whole column, capped to the used range) or `B2`.";
32
+
33
+ /** Refusals (bad input, no agent-fs identity, agent-fs errors) become toolErr; bugs still throw. */
34
+ async function refusing<T>(
35
+ agentId: string | undefined,
36
+ run: () => Promise<T>,
37
+ ): Promise<{ value: T } | { error: ReturnType<typeof toolErr> }> {
38
+ try {
39
+ return { value: await run() };
40
+ } catch (error) {
41
+ if (error instanceof ObjectsError || error instanceof FilesError) {
42
+ return { error: toolErr(error.message, { data: { yourAgentId: agentId } }) };
43
+ }
44
+ throw error;
45
+ }
46
+ }
47
+
48
+ const dataShape = {
49
+ yourAgentId: z.string().optional(),
50
+ object: objectOutputSchema.optional(),
51
+ objects: z.array(objectOutputSchema).optional(),
52
+ total: z.number().optional(),
53
+ link: z.string().nullable().optional(),
54
+ version: z.number().optional(),
55
+ tabs: z.array(z.unknown()).optional(),
56
+ range: z.string().optional(),
57
+ values: z.array(z.array(z.unknown())).optional(),
58
+ formulas: z.array(z.array(z.unknown())).optional(),
59
+ changed: z.number().optional(),
60
+ recalculated: z.number().optional(),
61
+ cleared: z.number().optional(),
62
+ };
63
+
64
+ const outputSchema = swarmToolOutputSchema(dataShape);
65
+
66
+ const ID = "Object id (from sheet-create or sheet-list).";
67
+ const PATH = "Drive path of the `.sheet.json` file, instead of `id`.";
68
+ const WRITE = { readOnlyHint: false, idempotentHint: false } as const;
69
+
70
+ export const registerSheetCreateTool = (server: McpServer) => {
71
+ createToolRegistrar(server)(
72
+ "sheet-create",
73
+ {
74
+ title: "Create sheet",
75
+ annotations: WRITE,
76
+ description:
77
+ "Create a spreadsheet (`swarm-sheet/1`, a `.sheet.json` file) on your default agent-fs drive, as your own agent-fs identity. Create-only: refuses when the path exists. Optional `tabs` name the tabs (default one tab `Sheet1`) and may seed each with `rows` from A1. Formulas recompute with a spreadsheet engine; limits: 20 tabs, 50,000 cells, 5 MiB.",
78
+ inputSchema: z.object({
79
+ path: z
80
+ .string()
81
+ .min(1)
82
+ .describe("Drive path ending in `.sheet.json`, e.g. /qa/tracker.sheet.json."),
83
+ title: z.string().max(200).optional(),
84
+ tabs: z
85
+ .array(z.object({ name: z.string().min(1).max(31), rows: Grid.optional() }))
86
+ .optional()
87
+ .describe("Tabs to create, each with an optional `rows` grid written from A1."),
88
+ }),
89
+ outputSchema,
90
+ },
91
+ async ({ path, title, tabs }, requestInfo) => {
92
+ const result = await refusing(requestInfo.agentId, () =>
93
+ createSheet({ agentId: requestInfo.agentId, path, title, tabs }),
94
+ );
95
+ if ("error" in result) return result.error;
96
+ const { object, link } = result.value;
97
+ return toolOk(`Created sheet ${object.id} at ${object.path}${link ? ` (${link})` : ""}.`, {
98
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
99
+ });
100
+ },
101
+ );
102
+ };
103
+
104
+ export const registerSheetGetTool = (server: McpServer) => {
105
+ createToolRegistrar(server)(
106
+ "sheet-get",
107
+ {
108
+ title: "Get sheet",
109
+ annotations: { readOnlyHint: true },
110
+ description:
111
+ "Get a sheet's object, current agent-fs `version` and its tabs (name, used rows and columns, frozen rows). Read cells with sheet-get-range.",
112
+ inputSchema: z.object({
113
+ id: z.string().min(1).optional().describe(ID),
114
+ path: z.string().min(1).optional().describe(PATH),
115
+ }),
116
+ outputSchema,
117
+ },
118
+ async ({ id, path }, requestInfo) => {
119
+ const result = await refusing(requestInfo.agentId, () =>
120
+ getSheet({ agentId: requestInfo.agentId, id, path }),
121
+ );
122
+ if ("error" in result) return result.error;
123
+ const { object, tabs, version } = result.value;
124
+ return toolOk(
125
+ `Sheet ${object.id} at ${object.path}: ${tabs.length} tab(s), version ${version}.`,
126
+ {
127
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
128
+ },
129
+ );
130
+ },
131
+ );
132
+ };
133
+
134
+ export const registerSheetListTool = (server: McpServer) => {
135
+ createToolRegistrar(server)(
136
+ "sheet-list",
137
+ {
138
+ title: "List sheets",
139
+ annotations: { readOnlyHint: true },
140
+ description:
141
+ "List sheets on your default agent-fs drive, newest first. Filter by path `prefix`. Pagination via limit (max 200) and offset.",
142
+ inputSchema: z.object({
143
+ prefix: z.string().optional(),
144
+ limit: z.number().int().positive().max(200).optional(),
145
+ offset: z.number().int().nonnegative().optional(),
146
+ }),
147
+ outputSchema,
148
+ },
149
+ async ({ prefix, limit, offset }, requestInfo) => {
150
+ const result = await refusing(requestInfo.agentId, () =>
151
+ listSheets({ agentId: requestInfo.agentId, prefix, limit, offset }),
152
+ );
153
+ if ("error" in result) return result.error;
154
+ const { objects, total } = result.value;
155
+ return toolOk(`Found ${objects.length} of ${total} sheets.`, {
156
+ details:
157
+ objects.length > 0 ? objects.map((o) => `- ${o.id} at ${o.path}`).join("\n") : undefined,
158
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
159
+ });
160
+ },
161
+ );
162
+ };
163
+
164
+ export const registerSheetGetRangeTool = (server: McpServer) => {
165
+ createToolRegistrar(server)(
166
+ "sheet-get-range",
167
+ {
168
+ title: "Read sheet range",
169
+ annotations: { readOnlyHint: true },
170
+ description:
171
+ "Read cached values from a range (at most 10,000 cells). Formula cells return their computed value; an error cell returns its error text such as `#DIV/0!`; spilled cells (SEQUENCE, UNIQUE, ...) are included. `formulas: true` also returns the formulas.",
172
+ inputSchema: z.object({
173
+ id: z.string().min(1).optional().describe(ID),
174
+ path: z.string().min(1).optional().describe(PATH),
175
+ range: z.string().min(1).describe(RANGE_HELP),
176
+ formulas: z
177
+ .boolean()
178
+ .optional()
179
+ .describe(
180
+ "Also return `formulas[][]`: the formula text where a cell has one, else the value.",
181
+ ),
182
+ }),
183
+ outputSchema,
184
+ },
185
+ async ({ id, path, range, formulas }, requestInfo) => {
186
+ const result = await refusing(requestInfo.agentId, () =>
187
+ getSheetRange({ agentId: requestInfo.agentId, id, path, range, formulas }),
188
+ );
189
+ if ("error" in result) return result.error;
190
+ return toolOk(`Read ${result.value.range} at version ${result.value.version}.`, {
191
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
192
+ });
193
+ },
194
+ );
195
+ };
196
+
197
+ export const registerSheetSetRangeTool = (server: McpServer) => {
198
+ createToolRegistrar(server)(
199
+ "sheet-set-range",
200
+ {
201
+ title: "Write sheet range",
202
+ annotations: WRITE,
203
+ description:
204
+ "Write a rectangle of `values` and recompute every formula. A string starting with `=` is a formula; start with `'=` to store literal text that begins with `=`; other strings stay text even when they look like numbers, so send numbers as numbers; null clears the cell. A single-cell `range` is the top-left corner; a larger `range` must match the values' size. Retries on a concurrent write: other cells merge, the same cell is last writer wins.",
205
+ inputSchema: z.object({
206
+ id: z.string().min(1).optional().describe(ID),
207
+ path: z.string().min(1).optional().describe(PATH),
208
+ range: z.string().min(1).describe(RANGE_HELP),
209
+ values: Grid.describe("Rows of cell values, all the same length (at most 10,000 cells)."),
210
+ }),
211
+ outputSchema,
212
+ },
213
+ async ({ id, path, range, values }, requestInfo) => {
214
+ const result = await refusing(requestInfo.agentId, () =>
215
+ setSheetRange({ agentId: requestInfo.agentId, id, path, range, values }),
216
+ );
217
+ if ("error" in result) return result.error;
218
+ const r = result.value;
219
+ return toolOk(
220
+ `Wrote ${r.range}: ${r.changed} changed, ${r.recalculated} recalculated, version ${r.version}.`,
221
+ { data: { yourAgentId: requestInfo.agentId, ...r } },
222
+ );
223
+ },
224
+ );
225
+ };
226
+
227
+ export const registerSheetAppendRowsTool = (server: McpServer) => {
228
+ createToolRegistrar(server)(
229
+ "sheet-append-rows",
230
+ {
231
+ title: "Append sheet rows",
232
+ annotations: WRITE,
233
+ description:
234
+ "Append rows below the last used row of a tab, starting at column A. Same value rules as sheet-set-range; null skips a cell. Returns the range written.",
235
+ inputSchema: z.object({
236
+ id: z.string().min(1).optional().describe(ID),
237
+ path: z.string().min(1).optional().describe(PATH),
238
+ tab: z.string().min(1).describe("Tab name."),
239
+ rows: Grid.describe("Rows to append (at most 10,000 cells)."),
240
+ }),
241
+ outputSchema,
242
+ },
243
+ async ({ id, path, tab, rows }, requestInfo) => {
244
+ const result = await refusing(requestInfo.agentId, () =>
245
+ appendSheetRows({ agentId: requestInfo.agentId, id, path, tab, rows }),
246
+ );
247
+ if ("error" in result) return result.error;
248
+ return toolOk(`Appended ${result.value.range}, version ${result.value.version}.`, {
249
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
250
+ });
251
+ },
252
+ );
253
+ };
254
+
255
+ export const registerSheetClearRangeTool = (server: McpServer) => {
256
+ createToolRegistrar(server)(
257
+ "sheet-clear-range",
258
+ {
259
+ title: "Clear sheet range",
260
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
261
+ description:
262
+ "Clear the contents of a range and recompute dependents. A whole-column or whole-row range is capped to the used range. Spilled cells go when their anchor is cleared.",
263
+ inputSchema: z.object({
264
+ id: z.string().min(1).optional().describe(ID),
265
+ path: z.string().min(1).optional().describe(PATH),
266
+ range: z.string().min(1).describe(RANGE_HELP),
267
+ }),
268
+ outputSchema,
269
+ },
270
+ async ({ id, path, range }, requestInfo) => {
271
+ const result = await refusing(requestInfo.agentId, () =>
272
+ clearSheetRange({ agentId: requestInfo.agentId, id, path, range }),
273
+ );
274
+ if ("error" in result) return result.error;
275
+ const r = result.value;
276
+ return toolOk(`Cleared ${r.cleared} cell(s) in ${r.range}, version ${r.version}.`, {
277
+ data: { yourAgentId: requestInfo.agentId, ...r },
278
+ });
279
+ },
280
+ );
281
+ };
282
+
283
+ export const registerSheetAddTabTool = (server: McpServer) => {
284
+ createToolRegistrar(server)(
285
+ "sheet-add-tab",
286
+ {
287
+ title: "Add sheet tab",
288
+ annotations: WRITE,
289
+ description:
290
+ "Add an empty tab (1-31 characters, none of `[]:*?/\\`), at the end or after the tab named `after`. A sheet holds at most 20 tabs.",
291
+ inputSchema: z.object({
292
+ id: z.string().min(1).optional().describe(ID),
293
+ path: z.string().min(1).optional().describe(PATH),
294
+ name: z.string().min(1).max(31).describe("New tab name."),
295
+ after: z.string().optional().describe("Insert after this tab; default: at the end."),
296
+ }),
297
+ outputSchema,
298
+ },
299
+ async ({ id, path, name, after }, requestInfo) => {
300
+ const result = await refusing(requestInfo.agentId, () =>
301
+ addSheetTab({ agentId: requestInfo.agentId, id, path, name, after }),
302
+ );
303
+ if ("error" in result) return result.error;
304
+ return toolOk(
305
+ `Tabs now: ${result.value.tabs.join(", ")} (version ${result.value.version}).`,
306
+ {
307
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
308
+ },
309
+ );
310
+ },
311
+ );
312
+ };
@@ -78,9 +78,9 @@ export const registerSlackReadTool = (server: McpServer) => {
78
78
  .describe("Maximum number of messages to retrieve (default: 20, max: 100)."),
79
79
  includeFiles: z
80
80
  .boolean()
81
- .default(true)
81
+ .optional()
82
82
  .describe(
83
- "Include file attachments in the response (default: true). From a task, they are also stored as attachments of that task.",
83
+ "Include and download file attachments. Defaults to false for direct channelId reads, and true for taskId or inboxMessageId reads. From a task, files are also stored as attachments of that task.",
84
84
  ),
85
85
  }),
86
86
  outputSchema: swarmToolOutputSchema({
@@ -90,7 +90,14 @@ export const registerSlackReadTool = (server: McpServer) => {
90
90
  }),
91
91
  },
92
92
  async (
93
- { inboxMessageId, taskId, channelId, threadTs, limit = 20, includeFiles = true },
93
+ {
94
+ inboxMessageId,
95
+ taskId,
96
+ channelId,
97
+ threadTs,
98
+ limit = 20,
99
+ includeFiles = Boolean(inboxMessageId || taskId),
100
+ },
94
101
  requestInfo,
95
102
  _meta,
96
103
  ) => {
@@ -221,6 +221,29 @@ export const DEFERRED_TOOLS = new Set([
221
221
  "room-reset",
222
222
  "room-decode",
223
223
 
224
+ // Primitive objects (4)
225
+ "object-create",
226
+ "object-get",
227
+ "object-list",
228
+ "object-reindex",
229
+
230
+ // Sheets (8)
231
+ "sheet-create",
232
+ "sheet-get",
233
+ "sheet-list",
234
+ "sheet-get-range",
235
+ "sheet-set-range",
236
+ "sheet-append-rows",
237
+ "sheet-clear-range",
238
+ "sheet-add-tab",
239
+ // Boards (6)
240
+ "board-create",
241
+ "board-get",
242
+ "board-list",
243
+ "board-add-elements",
244
+ "board-update-elements",
245
+ "board-remove-elements",
246
+
224
247
  // Reusable scripts and extensions (13)
225
248
  "script-upsert",
226
249
  "script-delete",
@@ -19,6 +19,11 @@ import {
19
19
  } from "@/types";
20
20
  import { getExecutorRegistry } from "@/workflows";
21
21
  import { validateDefinition } from "@/workflows/definition";
22
+ import {
23
+ agentMaySetServerRefInput,
24
+ serverRefInputDeniedMessage,
25
+ serverRefInputKeys,
26
+ } from "@/workflows/input";
22
27
  import { workflowModelErrors } from "@/workflows/model-validation";
23
28
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
24
29
 
@@ -57,8 +62,12 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
57
62
  "{ format: 'token-equality', header }, or { format: 'standard-webhooks', toleranceSeconds? } " +
58
63
  "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret). Example: { type: 'webhook', hmacSecret: 'secret.SUPERAGENT_WEBHOOK_SECRET', " +
59
64
  "verification: { format: 'timestamped-hmac-sha256', header: 'X-Superagent-Signature', toleranceSeconds: 300 } }.\n" +
60
- "- WEBHOOK EVENT FILTER: optional events: ['pull_request'] on a webhook trigger drops other deliveries after signature verification, " +
61
- "before any run is saved (2xx skipped reply). The event is read from eventHeader (default X-GitHub-Event).\n" +
65
+ "- WEBHOOK DELIVERY FILTER: optional filter on a webhook trigger drops deliveries after signature verification and before any run is saved " +
66
+ "(200 { skipped: true, reason }). filter.headers and filter.body are allowlists (a string or an array of scalars); every field must match. " +
67
+ "Header names are case-insensitive; values and JSON paths are exact, with no type coercion. " +
68
+ 'preset "github" | "gitlab" | "standard-webhooks" selects where the deprecated events allowlist is read ' +
69
+ "(X-GitHub-Event, X-Gitlab-Event, or JSON body type). events and eventHeader still work and are AND-ed with filter; eventHeader overrides preset. " +
70
+ "Omit filter and events to accept every delivery.\n" +
62
71
  "- WAIT NODE: type 'wait' pauses a workflow for a duration or until a named workflowEventBus event arrives. " +
63
72
  "See runbooks/workflows.md#wait-nodes for config shapes, ordering caveats, and built-in event names.",
64
73
  inputSchema: z.object({
@@ -74,7 +83,7 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
74
83
  .array(TriggerConfigSchema)
75
84
  .optional()
76
85
  .describe(
77
- "Optional trigger configurations (webhook, schedule, event). Webhook verification formats: legacy omitted verification, hmac-sha256, timestamped-hmac-sha256, token-equality, standard-webhooks.",
86
+ "Optional trigger configurations (webhook, schedule, event). A webhook trigger accepts filter (headers and body allowlists) and preset (github, gitlab, standard-webhooks). events and eventHeader remain a deprecated alias of one filter clause. Verification formats: legacy omitted verification, hmac-sha256, timestamped-hmac-sha256, token-equality, standard-webhooks.",
78
87
  ),
79
88
  cooldown: CooldownConfigSchema.optional().describe(
80
89
  "Optional cooldown configuration to prevent re-triggering too frequently",
@@ -83,7 +92,7 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
83
92
  .record(z.string(), InputValueSchema)
84
93
  .optional()
85
94
  .describe(
86
- "Optional input values resolved at execution time (env vars like VAR_NAME, secrets secret.NAME, or literals)",
95
+ "Optional input values resolved at execution time (env vars like VAR_NAME, secrets secret.NAME, or literals). Env var and secret references require config.read.secrets (the lead agent).",
87
96
  ),
88
97
  dir: z
89
98
  .string()
@@ -142,6 +151,11 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
142
151
  return toolErr(`Invalid definition: ${modelErrors.join("; ")}`);
143
152
  }
144
153
 
154
+ const refKeys = serverRefInputKeys(input);
155
+ if (refKeys.length > 0 && !(await agentMaySetServerRefInput(requestInfo.agentId))) {
156
+ return toolErr(serverRefInputDeniedMessage(refKeys));
157
+ }
158
+
145
159
  const createdBy =
146
160
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
147
161
  undefined;
@@ -10,6 +10,7 @@ import {
10
10
  } from "@/tools/utils";
11
11
  import { WorkflowNodePatchSchema } from "@/types";
12
12
  import { getExecutorRegistry } from "@/workflows";
13
+ import { agentMaySetServerRefInput } from "@/workflows/input";
13
14
  import { patchWorkflowDefinition } from "@/workflows/patch-definition";
14
15
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
15
16
 
@@ -45,6 +46,8 @@ export const registerPatchWorkflowNodeTool = (server: McpServer) => {
45
46
  patch: { update: [{ nodeId, node: nodeFields }] },
46
47
  registry: getExecutorRegistry(),
47
48
  snapshotAgentId: requestInfo.agentId,
49
+ serverRefInputAllowed:
50
+ !!requestInfo.agentId && (await agentMaySetServerRefInput(requestInfo.agentId)),
48
51
  updates: updatedBy !== undefined ? { updatedBy } : {},
49
52
  });
50
53
  if (!result.ok) {
@@ -52,6 +55,7 @@ export const registerPatchWorkflowNodeTool = (server: McpServer) => {
52
55
  if (result.reason === "patch") {
53
56
  return toolErr(`Patch errors: ${result.errors.join("; ")}`);
54
57
  }
58
+ if (result.reason === "forbidden") return toolErr(result.errors.join("; "));
55
59
  return toolErr(`Invalid definition: ${result.errors.join("; ")}`);
56
60
  }
57
61
  const { workflow, version } = result;
@@ -13,6 +13,7 @@ import {
13
13
  import type { WorkflowPatch } from "@/types";
14
14
  import { AssetKeySchema, WorkflowNodePatchSchema } from "@/types";
15
15
  import { getExecutorRegistry } from "@/workflows";
16
+ import { agentMaySetServerRefInput } from "@/workflows/input";
16
17
  import { patchWorkflowDefinition } from "@/workflows/patch-definition";
17
18
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
18
19
 
@@ -108,6 +109,8 @@ export const registerPatchWorkflowTool = (server: McpServer) => {
108
109
  },
109
110
  registry: getExecutorRegistry(),
110
111
  snapshotAgentId: requestInfo.agentId,
112
+ serverRefInputAllowed:
113
+ !!requestInfo.agentId && (await agentMaySetServerRefInput(requestInfo.agentId)),
111
114
  updates,
112
115
  });
113
116
  if (!result.ok) {
@@ -115,6 +118,7 @@ export const registerPatchWorkflowTool = (server: McpServer) => {
115
118
  if (result.reason === "patch") {
116
119
  return toolErr(`Patch errors: ${result.errors.join("; ")}`);
117
120
  }
121
+ if (result.reason === "forbidden") return toolErr(result.errors.join("; "));
118
122
  return toolErr(`Invalid definition: ${result.errors.join("; ")}`);
119
123
  }
120
124
  const { workflow, version } = result;
@@ -19,6 +19,11 @@ import {
19
19
  } from "@/types";
20
20
  import { getExecutorRegistry } from "@/workflows";
21
21
  import { definitionNodeIds, validateDefinition } from "@/workflows/definition";
22
+ import {
23
+ agentMaySetServerRefInput,
24
+ serverRefInputDeniedMessage,
25
+ serverRefInputKeys,
26
+ } from "@/workflows/input";
22
27
  import { workflowModelErrors } from "@/workflows/model-validation";
23
28
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
24
29
  import { snapshotAndUpdateWorkflow } from "@/workflows/version";
@@ -40,8 +45,12 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
40
45
  "or set verification to { format: 'hmac-sha256', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
41
46
  "{ format: 'token-equality', header }, or { format: 'standard-webhooks', toleranceSeconds? } " +
42
47
  "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret). " +
43
- "WEBHOOK EVENT FILTER: optional events: ['pull_request'] on a webhook trigger drops other deliveries after signature verification, " +
44
- "before any run is saved (2xx skipped reply). The event is read from eventHeader (default X-GitHub-Event).",
48
+ "WEBHOOK DELIVERY FILTER: optional filter on a webhook trigger drops deliveries after signature verification and before any run is saved " +
49
+ "(200 { skipped: true, reason }). filter.headers and filter.body are allowlists (a string or an array of scalars); every field must match. " +
50
+ "Header names are case-insensitive; values and JSON paths are exact, with no type coercion. " +
51
+ 'preset "github" | "gitlab" | "standard-webhooks" selects where the deprecated events allowlist is read ' +
52
+ "(X-GitHub-Event, X-Gitlab-Event, or JSON body type). events and eventHeader still work and are AND-ed with filter; eventHeader overrides preset. " +
53
+ "Omit filter and events to accept every delivery.",
45
54
  inputSchema: z.object({
46
55
  id: z.string().uuid().describe("Workflow ID to update"),
47
56
  key: AssetKeySchema.optional().describe("Move to a logical namespace."),
@@ -52,7 +61,7 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
52
61
  .array(TriggerConfigSchema)
53
62
  .optional()
54
63
  .describe(
55
- "New trigger configurations. Webhook verification formats: legacy omitted verification, hmac-sha256, timestamped-hmac-sha256, token-equality, standard-webhooks.",
64
+ "Replacement trigger list. A webhook trigger accepts filter (headers and body allowlists) and preset (github, gitlab, standard-webhooks). events and eventHeader remain a deprecated alias of one filter clause. Verification formats: legacy omitted verification, hmac-sha256, timestamped-hmac-sha256, token-equality, standard-webhooks.",
56
65
  ),
57
66
  cooldown: CooldownConfigSchema.optional()
58
67
  .nullable()
@@ -139,6 +148,18 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
139
148
  }
140
149
  }
141
150
 
151
+ // New ref input, or a new definition over stored ref input, decides
152
+ // where server-resolved values go: both need config.read.secrets.
153
+ const refKeys = serverRefInputKeys(
154
+ input !== undefined ? input : definition ? existing.input : undefined,
155
+ );
156
+ if (
157
+ refKeys.length > 0 &&
158
+ !(requestInfo.agentId && (await agentMaySetServerRefInput(requestInfo.agentId)))
159
+ ) {
160
+ return toolErr(serverRefInputDeniedMessage(refKeys));
161
+ }
162
+
142
163
  const updatedBy =
143
164
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
144
165
  undefined;