@desplega.ai/agent-swarm 2.11.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 (382) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-4nxq386s.js → actions-c4chgxp6.js} +24 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-hn5fftf5.js} +5 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-3g6yc8nv.js} +7 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-cpjgpjvp.js} +24 -22
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-hce1av1h.js} +1 -1
  10. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-bztbxc4z.js} +1 -1
  11. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-d7xcym0j.js} +1 -1
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-arrkbe8t.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-ykpyr5p8.js} +8 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-trd59v7b.js} +4 -4
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-yjcze0j1.js} +10 -10
  19. package/dist/{cli-2gvdvsxj.js → cli-01tvvtad.js} +63 -60
  20. package/dist/{cli-rhsc2zyx.js → cli-04zc3f7b.js} +1 -1
  21. package/dist/{cli-p1a4khta.js → cli-0k1a0sde.js} +6 -6
  22. package/dist/{cli-atm0hkes.js → cli-0pp1yjg2.js} +4 -4
  23. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  24. package/dist/{cli-zhn4r1rz.js → cli-12vek61e.js} +72 -49
  25. package/dist/{cli-j2r1apqm.js → cli-1htmtqc2.js} +45 -44
  26. package/dist/{cli-a6q6x15h.js → cli-2amwhyv2.js} +8 -5
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-a02habn6.js → cli-2tw284hj.js} +2 -2
  29. package/dist/{cli-nc39ym5q.js → cli-39qm0rtm.js} +6 -6
  30. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  31. package/dist/cli-52nfye5j.js +673 -0
  32. package/dist/cli-55tc8cj4.js +252 -0
  33. package/dist/cli-5r95eqbh.js +186 -0
  34. package/dist/{cli-892y3vfp.js → cli-5tg94mdw.js} +7 -7
  35. package/dist/{cli-ynph3b70.js → cli-5x03v6en.js} +8 -8
  36. package/dist/{cli-1h4njv9y.js → cli-5z0g0e8v.js} +11 -2
  37. package/dist/{cli-6a3j25xd.js → cli-72yms3ey.js} +16 -16
  38. package/dist/{cli-h2qtafm4.js → cli-73q4g5nx.js} +17 -17
  39. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  40. package/dist/{cli-9g12h1aq.js → cli-7yn42w6m.js} +1 -1
  41. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  42. package/dist/{cli-4aswccje.js → cli-9qe5y107.js} +2 -2
  43. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  44. package/dist/{cli-mhrr4d5b.js → cli-agjbj5x0.js} +1 -1
  45. package/dist/{cli-hnh8erra.js → cli-b93d81yg.js} +2 -2
  46. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  47. package/dist/{cli-b82a13ga.js → cli-bp6k9acz.js} +17 -21
  48. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  49. package/dist/{cli-t2s7j5cy.js → cli-bz97ff9n.js} +2 -2
  50. package/dist/{cli-0bgj4rh5.js → cli-c7j31hq9.js} +3 -3
  51. package/dist/{cli-p8zqbbt1.js → cli-cah298e5.js} +1 -1
  52. package/dist/{cli-9knhkkgr.js → cli-cjqyse9q.js} +3 -3
  53. package/dist/{cli-tb4j757d.js → cli-dkvtfgn4.js} +6 -6
  54. package/dist/{cli-14xdms9a.js → cli-e3ahxq5y.js} +6 -6
  55. package/dist/{cli-6n7y5ypy.js → cli-e8n0hdzd.js} +1 -1
  56. package/dist/{cli-q71g5q39.js → cli-en6dmkxd.js} +3 -3
  57. package/dist/{cli-xqbqwpxr.js → cli-eq4kew31.js} +9 -9
  58. package/dist/{cli-4kzp7r0q.js → cli-eqq0hwvx.js} +3 -3
  59. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  60. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  61. package/dist/{cli-bq97k63w.js → cli-fxd1mwtr.js} +2 -2
  62. package/dist/{cli-kbm659dk.js → cli-fy4gb74g.js} +2 -2
  63. package/dist/{cli-djt6wmrc.js → cli-fyaq4zdv.js} +6 -6
  64. package/dist/{cli-raqw9fw9.js → cli-gfy6hbd9.js} +6 -6
  65. package/dist/{cli-s9twe4x0.js → cli-h70a2mxy.js} +13 -8
  66. package/dist/cli-hbvgzjq4.js +69 -0
  67. package/dist/{cli-vy3fn0mz.js → cli-hhc47ack.js} +4 -4
  68. package/dist/{cli-m00c47q6.js → cli-j5gtytvg.js} +54 -24
  69. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  70. package/dist/{cli-yzxqwcvq.js → cli-k5jx8jya.js} +10 -3
  71. package/dist/{cli-rytq7dm2.js → cli-krbcr00p.js} +3 -3
  72. package/dist/{cli-453497a0.js → cli-kwr5qv5g.js} +2 -2
  73. package/dist/{cli-czvvnfr9.js → cli-m5qtmrbc.js} +2 -2
  74. package/dist/{cli-cstggwq7.js → cli-ma9ys8rt.js} +2 -2
  75. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  76. package/dist/{cli-wz4e5am2.js → cli-mcymtvwn.js} +320 -70
  77. package/dist/{cli-2aacfdcn.js → cli-mq2fbgva.js} +64 -3
  78. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  79. package/dist/{cli-k4r5sfaj.js → cli-n8f0fs3c.js} +4 -4
  80. package/dist/{cli-f8yhybxr.js → cli-nja15knq.js} +3 -3
  81. package/dist/{cli-6tvh1fwq.js → cli-pe3yxedk.js} +3 -3
  82. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  83. package/dist/{cli-n6ygvrrm.js → cli-q2dywc8h.js} +4 -4
  84. package/dist/{cli-8zmpwe79.js → cli-q8tc22bj.js} +5 -5
  85. package/dist/{cli-yvzxbztc.js → cli-r0mz92by.js} +2 -2
  86. package/dist/{cli-v3zcnr8g.js → cli-r14ac1y0.js} +1 -1
  87. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  88. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  89. package/dist/{cli-27fat7st.js → cli-sv2r3bw8.js} +7 -7
  90. package/dist/{cli-zb1hff00.js → cli-t75xngj1.js} +9 -9
  91. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  92. package/dist/{cli-5ptj757f.js → cli-tm60vtax.js} +1 -1
  93. package/dist/{cli-rpmw4fsv.js → cli-v9ya390t.js} +12 -12
  94. package/dist/{cli-075ccjh6.js → cli-wvjqaqcp.js} +2607 -65
  95. package/dist/{cli-2jtfm8kh.js → cli-xf4z5bdn.js} +4 -4
  96. package/dist/{cli-4g323fjh.js → cli-xm34qj8m.js} +2 -2
  97. package/dist/{cli-f7dhm7hh.js → cli-ya3kf4gs.js} +1 -1
  98. package/dist/{cli-rwgwen5v.js → cli-yegz2g06.js} +4 -4
  99. package/dist/{cli-nbakg5xh.js → cli-yfpc6qy9.js} +3 -3
  100. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  101. package/dist/cli.js +24 -21
  102. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-wc6e4wct.js} +8 -8
  103. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  104. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ppfgjd97.js} +9 -9
  105. package/dist/{commands-ctey7tr5.js → commands-tsv2vx5b.js} +3 -3
  106. package/dist/{controller-rqhbppg9.js → controller-ye4sdwsy.js} +4 -4
  107. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-zn4dg69h.js} +25 -23
  108. package/dist/core-dxcy02sc.js +41 -0
  109. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-q2g9vwts.js} +2 -2
  110. package/dist/{db-2ah39cyx.js → db-3r1fyr2n.js} +6 -2
  111. package/dist/{db-p5drc1d1.js → db-g111qn9j.js} +3 -3
  112. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  113. package/dist/{dispatcher-x6w14pde.js → dispatcher-4q8s0mx8.js} +22 -20
  114. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  115. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-mmcw1z5s.js} +2 -2
  116. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  117. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  118. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-04ke6hcp.js} +1 -1
  119. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-kcdn52vz.js} +6 -6
  120. package/dist/{embeddings-0sxb1d2h.js → embeddings-jnzcd91a.js} +1 -1
  121. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  122. package/dist/{execute-6m1ex8ce.js → execute-74amghty.js} +1 -1
  123. package/dist/{external-channel-ezer7pk0.js → external-channel-v9zgxnxz.js} +2 -2
  124. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  125. package/dist/grok-adapter-t6m74fb1.js +19 -0
  126. package/dist/handlers-9kwcrc4k.js +38 -0
  127. package/dist/{heartbeat-6c4fr49t.js → heartbeat-p8pk1msj.js} +25 -23
  128. package/dist/{hook-t1c5avbv.js → hook-k1h73zd7.js} +5 -5
  129. package/dist/{hook-02rt5tvq.js → hook-p5reemds.js} +7 -7
  130. package/dist/{http-qa3h32a1.js → http-ms1z5xxy.js} +565 -141
  131. package/dist/index-23cdfzr6.js +39 -0
  132. package/dist/{index-kqv9ebfj.js → index-76zzxtzf.js} +1 -1
  133. package/dist/{index-e42j998x.js → index-fbkqhvvj.js} +38 -19
  134. package/dist/index-g7kkjs5b.js +38 -0
  135. package/dist/{index-qpjk2hxk.js → index-gjn6qfgn.js} +1 -1
  136. package/dist/{index-akbgsdhh.js → index-kn63q1gr.js} +26 -24
  137. package/dist/index-stk36pa5.js +43 -0
  138. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  139. package/dist/{keepalive-jmf6pn8c.js → keepalive-031js8jz.js} +4 -4
  140. package/dist/lead-mfggjtfk.js +77 -0
  141. package/dist/{maintenance-g7v15tj1.js → maintenance-sq9v3qx9.js} +1 -1
  142. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  143. package/dist/object-webhooks-r24wwb5y.js +21 -0
  144. package/dist/{onboard-m3fedypq.js → onboard-p25yhh7t.js} +5 -5
  145. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-wcjc4zdk.js} +7 -7
  146. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-ff1gf20m.js} +2 -2
  147. package/dist/{pending-fwj2fatd.js → pending-hxj5yatb.js} +23 -21
  148. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-vkp4zz7p.js} +12 -12
  149. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-9w7gx41w.js} +2 -2
  150. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-84aw10nz.js} +3 -3
  151. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-hz74vckp.js} +2 -2
  152. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  153. package/dist/{render-v2-j7qggj8h.js → render-v2-nrdkg9gf.js} +5 -5
  154. package/dist/{resume-hj1mn65y.js → resume-s6ey36rh.js} +9 -9
  155. package/dist/{runtime-z31mdsgv.js → runtime-x0b4pyam.js} +1 -1
  156. package/dist/{session-access-w38fh09a.js → session-access-xv49tk14.js} +4 -4
  157. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-r5j988ah.js} +3 -3
  158. package/dist/{setup-dsqmpfcr.js → setup-mj0krk1p.js} +1 -1
  159. package/dist/thread-buffer-temgaqsy.js +41 -0
  160. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-cbrsfaar.js} +2 -2
  161. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  162. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-ns0ryw05.js} +3 -3
  163. package/dist/{work-objects-4ahy5es5.js → work-objects-pydhzast.js} +25 -23
  164. package/dist/worker-efcemc22.js +77 -0
  165. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-9z2xec5e.js} +22 -20
  166. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  167. package/openapi.json +788 -253
  168. package/package.json +8 -5
  169. package/src/azure-devops/auth.ts +2 -3
  170. package/src/be/agent-fs-identity.ts +46 -0
  171. package/src/be/agent-history.ts +215 -0
  172. package/src/be/db/agents.ts +34 -12
  173. package/src/be/db/tasks/write.ts +2 -2
  174. package/src/be/db.ts +2 -0
  175. package/src/be/migrations/332_primitive_objects.sql +31 -0
  176. package/src/be/migrations/334_agent_history.sql +23 -0
  177. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  178. package/src/be/primitives/boards/elements.ts +717 -0
  179. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  180. package/src/be/primitives/boards/service.ts +121 -0
  181. package/src/be/primitives/object-webhooks.ts +348 -0
  182. package/src/be/primitives/objects.ts +686 -0
  183. package/src/be/primitives/sheets/a1.ts +136 -0
  184. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  185. package/src/be/primitives/sheets/engine.ts +199 -0
  186. package/src/be/primitives/sheets/format.ts +106 -0
  187. package/src/be/primitives/sheets/service.ts +415 -0
  188. package/src/be/primitives/write-object.ts +83 -0
  189. package/src/be/script-credential-broker.ts +8 -27
  190. package/src/be/scripts/typecheck.ts +216 -0
  191. package/src/be/seed/agent-fs-provision.ts +18 -0
  192. package/src/be/users.ts +19 -0
  193. package/src/commands/onboard/agent-fs-version.ts +1 -1
  194. package/src/commands/onboard/steps/harness.tsx +1 -1
  195. package/src/commands/provider-credentials.ts +1 -0
  196. package/src/e2b/env.ts +3 -1
  197. package/src/fs/agent-fs-provider.ts +33 -2
  198. package/src/gitlab/auth.ts +3 -4
  199. package/src/heartbeat/heartbeat.ts +11 -11
  200. package/src/http/agent-lifecycle.ts +152 -0
  201. package/src/http/agents.ts +12 -0
  202. package/src/http/all-routes.ts +2 -0
  203. package/src/http/auth.ts +2 -1
  204. package/src/http/index.ts +15 -0
  205. package/src/http/object-webhooks.ts +101 -0
  206. package/src/http/operator-actor.ts +2 -1
  207. package/src/http/sessions.ts +7 -0
  208. package/src/http/workflows.ts +32 -0
  209. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  210. package/src/providers/acp-targets.ts +2 -2
  211. package/src/providers/amp-adapter.ts +1 -1
  212. package/src/providers/opencode-adapter.ts +4 -1
  213. package/src/rbac/legacy-policy.ts +2 -0
  214. package/src/rbac/permissions.ts +5 -0
  215. package/src/script-workflows/guest-ctx.ts +32 -0
  216. package/src/script-workflows/workflow-ctx.ts +2 -0
  217. package/src/scripts-runtime/ctx.ts +9 -1
  218. package/src/scripts-runtime/executors/native.ts +106 -21
  219. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  220. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  221. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  222. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  223. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  224. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  225. package/src/server.ts +48 -0
  226. package/src/tests/agent-history.test.ts +313 -0
  227. package/src/tests/azure-devops-auth.test.ts +6 -0
  228. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  229. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  230. package/src/tests/credential-check.test.ts +12 -0
  231. package/src/tests/db-task-read-contract.test.ts +2 -0
  232. package/src/tests/db-task-write-contract.test.ts +2 -0
  233. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  234. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  235. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  236. package/src/tests/e2e-shards.test.ts +137 -0
  237. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  238. package/src/tests/extensions-heartbeat.test.ts +34 -0
  239. package/src/tests/gitlab-auth.test.ts +10 -0
  240. package/src/tests/heartbeat.test.ts +38 -0
  241. package/src/tests/http-api-integration.test.ts +0 -6
  242. package/src/tests/opencode-adapter.test.ts +11 -0
  243. package/src/tests/primitives-boards.test.ts +686 -0
  244. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  245. package/src/tests/primitives-objects.test.ts +248 -0
  246. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  247. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  248. package/src/tests/scripts-namespaces.test.ts +211 -0
  249. package/src/tests/secret-scrub-gate.test.ts +1 -0
  250. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  251. package/src/tests/secret-scrubber.test.ts +1 -1
  252. package/src/tests/session-tokens.test.ts +27 -0
  253. package/src/tests/sheet-engine.test.ts +58 -0
  254. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  255. package/src/tests/slack-read-boundaries.test.ts +4 -2
  256. package/src/tests/task-start-after-commit.test.ts +82 -0
  257. package/src/tests/ui-logs-parser.test.ts +67 -0
  258. package/src/tests/workflow-retry-v2.test.ts +101 -0
  259. package/src/tests/workflow-tla-races.test.ts +29 -0
  260. package/src/tools/boards.ts +260 -0
  261. package/src/tools/objects.ts +191 -0
  262. package/src/tools/sheets.ts +312 -0
  263. package/src/tools/slack-read.ts +10 -3
  264. package/src/tools/tool-config.ts +23 -0
  265. package/src/tools/workflows/create-workflow.ts +11 -1
  266. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  267. package/src/tools/workflows/patch-workflow.ts +4 -0
  268. package/src/tools/workflows/update-workflow.ts +17 -0
  269. package/src/types.ts +16 -0
  270. package/src/utils/sandboxed-process.ts +47 -2
  271. package/src/utils/secret-scrubber.ts +61 -6
  272. package/src/workflows/engine.ts +35 -21
  273. package/src/workflows/input.ts +29 -1
  274. package/src/workflows/patch-definition.ts +15 -1
  275. package/src/workflows/retry-poller.ts +15 -2
  276. package/src/workflows/validation.ts +10 -0
  277. package/templates/ai-toolbox.manifest.json +1 -1
  278. package/templates/skills/agent-browser/SKILL.md +1 -0
  279. package/templates/skills/agent-browser/content.md +1 -0
  280. package/templates/skills/pages/content.md +5 -0
  281. package/templates/skills/swarm-docs/content.md +6 -1
  282. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  283. package/templates/skills/swarm-scripts/content.md +1 -0
  284. package/templates/skills/tdd-planning/content.md +5 -2
  285. package/dist/acp-adapter-weaaxey3.js +0 -16
  286. package/dist/core-df1n049h.js +0 -39
  287. package/dist/fx-adapter-zwmps9re.js +0 -19
  288. package/dist/grok-adapter-q0avf919.js +0 -19
  289. package/dist/handlers-g5jq0e4q.js +0 -36
  290. package/dist/index-1f6m47mq.js +0 -37
  291. package/dist/index-1p1mpqda.js +0 -36
  292. package/dist/index-tnkd410q.js +0 -41
  293. package/dist/lead-m5e7xt93.js +0 -75
  294. package/dist/thread-buffer-nf55vwx3.js +0 -39
  295. package/dist/worker-ews1nyhw.js +0 -75
  296. package/src/slack/socket-mode-guard.test.ts +0 -25
  297. package/src/tests/agent-activity.test.ts +0 -247
  298. package/src/tests/agent-fs-live-url.test.ts +0 -55
  299. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  300. package/src/tests/approval-sweeps-config.test.ts +0 -47
  301. package/src/tests/cards.test.ts +0 -169
  302. package/src/tests/chat-sdk-facts.test.ts +0 -23
  303. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  304. package/src/tests/core-auth.test.ts +0 -156
  305. package/src/tests/date-utils.test.ts +0 -48
  306. package/src/tests/db-context-versions.test.ts +0 -37
  307. package/src/tests/db-runtime.test.ts +0 -132
  308. package/src/tests/enabled-capabilities.test.ts +0 -20
  309. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  310. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  311. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  312. package/src/tests/github-event-labels.test.ts +0 -24
  313. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  314. package/src/tests/http-log-scrubbing.test.ts +0 -123
  315. package/src/tests/http-semconv-attributes.test.ts +0 -92
  316. package/src/tests/identity.test.ts +0 -117
  317. package/src/tests/inbox-state.test.ts +0 -167
  318. package/src/tests/internal-ai/models.test.ts +0 -54
  319. package/src/tests/launch-password-rejection.test.ts +0 -140
  320. package/src/tests/list-total-cache.test.ts +0 -88
  321. package/src/tests/match-route.test.ts +0 -187
  322. package/src/tests/memory-feature-flags.test.ts +0 -45
  323. package/src/tests/memory-get-tool.test.ts +0 -269
  324. package/src/tests/memory-health-endpoint.test.ts +0 -78
  325. package/src/tests/memory-http-access.test.ts +0 -221
  326. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  327. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  328. package/src/tests/openai-embedding-provider.test.ts +0 -159
  329. package/src/tests/org-identity.test.ts +0 -44
  330. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  331. package/src/tests/pages-browser-sdk.test.ts +0 -76
  332. package/src/tests/pages-feedback-keys.test.ts +0 -121
  333. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  334. package/src/tests/pages-list-endpoint.test.ts +0 -148
  335. package/src/tests/pages-password-mode.test.ts +0 -266
  336. package/src/tests/pages-public-authed-401.test.ts +0 -103
  337. package/src/tests/pages-public-html.test.ts +0 -297
  338. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  339. package/src/tests/pages-view-count.test.ts +0 -245
  340. package/src/tests/prompt-templates-db.test.ts +0 -616
  341. package/src/tests/rbac-engine.test.ts +0 -742
  342. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  343. package/src/tests/route-def-find-route.test.ts +0 -192
  344. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  345. package/src/tests/schedule-validation-helper.test.ts +0 -51
  346. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  347. package/src/tests/scheduler-backoff.test.ts +0 -166
  348. package/src/tests/script-run-token.test.ts +0 -75
  349. package/src/tests/scripts-extract-signature.test.ts +0 -47
  350. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  351. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  352. package/src/tests/short-id.test.ts +0 -23
  353. package/src/tests/skill-files-http.test.ts +0 -222
  354. package/src/tests/skill-get-file-tool.test.ts +0 -110
  355. package/src/tests/skill-script-refs.test.ts +0 -63
  356. package/src/tests/skill-update-scope.test.ts +0 -252
  357. package/src/tests/skills-bundle.test.ts +0 -99
  358. package/src/tests/slack-app-icon.test.ts +0 -94
  359. package/src/tests/slack-assistant-comention.test.ts +0 -139
  360. package/src/tests/slack-delete.test.ts +0 -157
  361. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  362. package/src/tests/slack-manifest.test.ts +0 -23
  363. package/src/tests/slack-task-output.test.ts +0 -90
  364. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  365. package/src/tests/swarm-diff.test.ts +0 -728
  366. package/src/tests/task-lifecycle-events.test.ts +0 -53
  367. package/src/tests/template-asset-config.test.ts +0 -18
  368. package/src/tests/template-fetch.test.ts +0 -490
  369. package/src/tests/themes-page-theme.test.ts +0 -155
  370. package/src/tests/tool-annotations.test.ts +0 -442
  371. package/src/tests/tool-output-agent-id.test.ts +0 -202
  372. package/src/tests/update-profile-agentid.test.ts +0 -248
  373. package/src/tests/whoami-route.test.ts +0 -162
  374. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  375. package/src/tests/workflow-patch.test.ts +0 -169
  376. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  377. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  378. package/src/tests/workflow-step-claims.test.ts +0 -152
  379. package/src/tests/workflow-step-order.test.ts +0 -92
  380. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  381. package/src/tests/workflow-versions.test.ts +0 -240
  382. package/src/tests/workflow-wait.test.ts +0 -26
@@ -0,0 +1,191 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import * as z from "zod";
3
+ import {
4
+ createObject,
5
+ getObject,
6
+ listObjects,
7
+ ObjectsError,
8
+ PRIMITIVE_KIND_NAMES,
9
+ type PrimitiveObject,
10
+ reindexObjects,
11
+ } from "@/be/primitives/objects";
12
+ import { FilesError } from "@/fs/provider";
13
+ import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
14
+
15
+ // Loose, format-pin-free mirror of PrimitiveObject for MCP output validation.
16
+ export const objectOutputSchema = z.looseObject({
17
+ id: z.string().optional(),
18
+ kind: z.string().optional(),
19
+ orgId: z.string().optional(),
20
+ driveId: z.string().optional(),
21
+ path: z.string().optional(),
22
+ title: z.string().nullable().optional(),
23
+ fileVersion: z.number().nullable().optional(),
24
+ ownerAgentId: z.string().nullable().optional(),
25
+ deletedAt: z.string().nullable().optional(),
26
+ createdAt: z.string().optional(),
27
+ updatedAt: z.string().optional(),
28
+ link: z.string().nullable().optional(),
29
+ });
30
+
31
+ const KindSchema = z.enum(PRIMITIVE_KIND_NAMES);
32
+
33
+ /** Refusals (bad input, no agent-fs identity, agent-fs errors) become toolErr; bugs still throw. */
34
+ export 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 summary = (o: PrimitiveObject) =>
49
+ `${o.kind} ${o.id} at ${o.path}${o.link ? ` (${o.link})` : ""}`;
50
+
51
+ export const registerObjectCreateTool = (server: McpServer) => {
52
+ createToolRegistrar(server)(
53
+ "object-create",
54
+ {
55
+ title: "Create primitive object",
56
+ annotations: { readOnlyHint: false, idempotentHint: false },
57
+ description:
58
+ "Create a primitive object file on your default agent-fs drive, as your own agent-fs identity, and give it a stable id. Create-only: refuses when the path exists (use object-reindex to adopt an existing file). Kind `board` writes an empty Excalidraw scene and needs a `.excalidraw` path. Kind `sheet` writes an empty `swarm-sheet/1` workbook and needs a `.sheet.json` path (edit it with the sheet-* tools).",
59
+ inputSchema: z.object({
60
+ kind: KindSchema.describe(
61
+ "Object kind. `board`: an Excalidraw scene (.excalidraw). `sheet`: a spreadsheet (.sheet.json).",
62
+ ),
63
+ path: z.string().min(1).describe("Drive path, e.g. /boards/roadmap.excalidraw."),
64
+ title: z.string().max(200).optional(),
65
+ }),
66
+ outputSchema: swarmToolOutputSchema({
67
+ yourAgentId: z.string().optional(),
68
+ object: objectOutputSchema.optional(),
69
+ }),
70
+ },
71
+ async ({ kind, path, title }, requestInfo) => {
72
+ const result = await refusing(requestInfo.agentId, () =>
73
+ createObject({ agentId: requestInfo.agentId, kind, path, title }),
74
+ );
75
+ if ("error" in result) return result.error;
76
+ return toolOk(`Created ${summary(result.value)}.`, {
77
+ data: { yourAgentId: requestInfo.agentId, object: result.value },
78
+ });
79
+ },
80
+ );
81
+ };
82
+
83
+ export const registerObjectGetTool = (server: McpServer) => {
84
+ createToolRegistrar(server)(
85
+ "object-get",
86
+ {
87
+ title: "Get primitive object",
88
+ description:
89
+ "Get a primitive object on your default agent-fs drive by `id` or `path`. `missing: true` means the row exists but the file is gone. `includeContent` returns the parsed file.",
90
+ annotations: { readOnlyHint: true },
91
+ inputSchema: z.object({
92
+ id: z.string().min(1).optional(),
93
+ path: z.string().min(1).optional(),
94
+ includeContent: z.boolean().optional(),
95
+ }),
96
+ outputSchema: swarmToolOutputSchema({
97
+ yourAgentId: z.string().optional(),
98
+ object: objectOutputSchema.optional(),
99
+ missing: z.boolean().optional(),
100
+ content: z.unknown().optional(),
101
+ }),
102
+ },
103
+ async ({ id, path, includeContent }, requestInfo) => {
104
+ const result = await refusing(requestInfo.agentId, () =>
105
+ getObject({ agentId: requestInfo.agentId, id, path, includeContent }),
106
+ );
107
+ if ("error" in result) return result.error;
108
+ const { object, missing, content } = result.value;
109
+ return toolOk(
110
+ missing ? `File for ${summary(object)} is missing.` : `Found ${summary(object)}.`,
111
+ {
112
+ data: {
113
+ yourAgentId: requestInfo.agentId,
114
+ object,
115
+ missing,
116
+ ...(content === undefined ? {} : { content }),
117
+ },
118
+ },
119
+ );
120
+ },
121
+ );
122
+ };
123
+
124
+ export const registerObjectListTool = (server: McpServer) => {
125
+ createToolRegistrar(server)(
126
+ "object-list",
127
+ {
128
+ title: "List primitive objects",
129
+ description:
130
+ "List primitive objects on your default agent-fs drive, newest first. Hides objects whose file agent-fs reported deleted. Filter by `kind` and path `prefix`. Pagination via limit (max 200) and offset.",
131
+ annotations: { readOnlyHint: true },
132
+ inputSchema: z.object({
133
+ kind: KindSchema.optional(),
134
+ prefix: z.string().optional(),
135
+ limit: z.number().int().positive().max(200).optional(),
136
+ offset: z.number().int().nonnegative().optional(),
137
+ }),
138
+ outputSchema: swarmToolOutputSchema({
139
+ yourAgentId: z.string().optional(),
140
+ objects: z.array(objectOutputSchema).optional(),
141
+ total: z.number().optional(),
142
+ }),
143
+ },
144
+ async ({ kind, prefix, limit, offset }, requestInfo) => {
145
+ const result = await refusing(requestInfo.agentId, () =>
146
+ listObjects({ agentId: requestInfo.agentId, kind, prefix, limit, offset }),
147
+ );
148
+ if ("error" in result) return result.error;
149
+ const { objects, total } = result.value;
150
+ return toolOk(`Found ${objects.length} of ${total} objects.`, {
151
+ details: objects.length > 0 ? objects.map((o) => `- ${summary(o)}`).join("\n") : undefined,
152
+ data: { yourAgentId: requestInfo.agentId, objects, total },
153
+ });
154
+ },
155
+ );
156
+ };
157
+
158
+ export const registerObjectReindexTool = (server: McpServer) => {
159
+ createToolRegistrar(server)(
160
+ "object-reindex",
161
+ {
162
+ title: "Reindex primitive objects",
163
+ annotations: { readOnlyHint: false, idempotentHint: true },
164
+ description:
165
+ "Rebuild the object index from the files on your default agent-fs drive. Keeps each file's embedded id; a file with no id (for example a stock Excalidraw save) keeps the id of the row at its path, else gets a new one written back. Rows whose file is gone are reported as `missing`, never deleted. Files whose version matches the index are checked, not re-read (`unchanged`); one call reads at most 50 changed files, 16 MiB, or 20 seconds of work, so run it again while `truncated` is true (`cutBy` names the limit). agent-fs file.changed webhooks keep the index current between runs when the swarm can register them.",
166
+ inputSchema: z.object({ kind: KindSchema.optional() }),
167
+ outputSchema: swarmToolOutputSchema({
168
+ yourAgentId: z.string().optional(),
169
+ scanned: z.number().optional(),
170
+ unchanged: z.number().optional(),
171
+ adopted: z.array(z.string()).optional(),
172
+ restored: z.array(z.string()).optional(),
173
+ missing: z.array(z.string()).optional(),
174
+ conflicts: z.array(z.looseObject({ path: z.string(), reason: z.string() })).optional(),
175
+ truncated: z.boolean().optional(),
176
+ cutBy: z.enum(["files", "reads", "time", "bytes"]).nullable().optional(),
177
+ }),
178
+ },
179
+ async ({ kind }, requestInfo) => {
180
+ const result = await refusing(requestInfo.agentId, () =>
181
+ reindexObjects({ agentId: requestInfo.agentId, kind }),
182
+ );
183
+ if ("error" in result) return result.error;
184
+ const report = result.value;
185
+ return toolOk(
186
+ `Scanned ${report.scanned} files: ${report.unchanged} unchanged, ${report.adopted.length} adopted, ${report.restored.length} restored, ${report.missing.length} missing, ${report.conflicts.length} skipped${report.truncated ? ` (truncated: ${report.cutBy} limit)` : ""}.`,
187
+ { data: { yourAgentId: requestInfo.agentId, ...report } },
188
+ );
189
+ },
190
+ );
191
+ };
@@ -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
 
@@ -87,7 +92,7 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
87
92
  .record(z.string(), InputValueSchema)
88
93
  .optional()
89
94
  .describe(
90
- "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).",
91
96
  ),
92
97
  dir: z
93
98
  .string()
@@ -146,6 +151,11 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
146
151
  return toolErr(`Invalid definition: ${modelErrors.join("; ")}`);
147
152
  }
148
153
 
154
+ const refKeys = serverRefInputKeys(input);
155
+ if (refKeys.length > 0 && !(await agentMaySetServerRefInput(requestInfo.agentId))) {
156
+ return toolErr(serverRefInputDeniedMessage(refKeys));
157
+ }
158
+
149
159
  const createdBy =
150
160
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
151
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";
@@ -143,6 +148,18 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
143
148
  }
144
149
  }
145
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
+
146
163
  const updatedBy =
147
164
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
148
165
  undefined;