@desplega.ai/agent-swarm 2.11.0 → 2.13.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 (521) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
  3. package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
  19. package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
  20. package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
  21. package/dist/cli-0jkenasr.js +148 -0
  22. package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
  23. package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
  24. package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
  25. package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
  26. package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
  29. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  30. package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
  31. package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
  32. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  33. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  34. package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
  35. package/dist/cli-7dbhnsj9.js +681 -0
  36. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  37. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  38. package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
  39. package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
  40. package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
  41. package/dist/cli-avqkr20b.js +69 -0
  42. package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
  43. package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
  44. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  45. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  46. package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
  47. package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
  48. package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
  49. package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
  50. package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
  51. package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
  52. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  53. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  54. package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
  55. package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
  56. package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
  57. package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
  58. package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
  59. package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
  60. package/dist/cli-hbq0kwxz.js +252 -0
  61. package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
  62. package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
  63. package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
  64. package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
  65. package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
  66. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  67. package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
  68. package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
  69. package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
  70. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  71. package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
  72. package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
  73. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  74. package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
  75. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  76. package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
  77. package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
  78. package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
  79. package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
  80. package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
  81. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  82. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  83. package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
  84. package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
  85. package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
  86. package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
  87. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  88. package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
  89. package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
  90. package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
  91. package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
  92. package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
  93. package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
  94. package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
  95. package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
  96. package/dist/cli-y260hgep.js +186 -0
  97. package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
  98. package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
  99. package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
  100. package/dist/cli-yn4kt85g.js +148 -0
  101. package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
  102. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  103. package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
  104. package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
  105. package/dist/cli.js +27 -22
  106. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
  107. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  108. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  109. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
  110. package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
  111. package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
  112. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
  113. package/dist/core-0fqtbrxa.js +42 -0
  114. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
  115. package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
  116. package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
  117. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  118. package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
  119. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  120. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
  121. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  122. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  123. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
  124. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
  125. package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
  126. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  127. package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
  128. package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
  129. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  130. package/dist/grok-adapter-4q5tssw0.js +20 -0
  131. package/dist/handlers-qxgfvvsf.js +41 -0
  132. package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
  133. package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
  134. package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
  135. package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
  136. package/dist/index-0mcxjdsa.js +44 -0
  137. package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
  138. package/dist/index-dz4q23ag.js +40 -0
  139. package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
  140. package/dist/index-s175jckx.js +39 -0
  141. package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
  142. package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
  143. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  144. package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
  145. package/dist/lead-p3hx7h35.js +79 -0
  146. package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
  147. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
  148. package/dist/object-webhooks-6rdagg0r.js +21 -0
  149. package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
  150. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
  151. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
  152. package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
  153. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
  154. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
  155. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
  156. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
  157. package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
  158. package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
  159. package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
  160. package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
  161. package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
  162. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
  163. package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
  164. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  165. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
  166. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  167. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
  168. package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
  169. package/dist/worker-8rg9gz74.js +79 -0
  170. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
  171. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  172. package/dist/xlsx-9acfmxr1.js +31534 -0
  173. package/openapi.json +5227 -3511
  174. package/package.json +10 -5
  175. package/src/agentmail/handlers.ts +26 -19
  176. package/src/apps/catalog.generated.json +31 -0
  177. package/src/apps/row-store.ts +37 -14
  178. package/src/azure-devops/auth.ts +2 -3
  179. package/src/azure-devops/handlers.ts +2 -0
  180. package/src/be/agent-fs-identity.ts +46 -0
  181. package/src/be/agent-history.ts +215 -0
  182. package/src/be/audit-user.ts +46 -6
  183. package/src/be/db/agents.ts +34 -12
  184. package/src/be/db/kv-windows.ts +22 -0
  185. package/src/be/db/session-moves.ts +3 -3
  186. package/src/be/db/session-tree.ts +52 -5
  187. package/src/be/db/skill-audit.ts +17 -0
  188. package/src/be/db/tasks/write.ts +20 -5
  189. package/src/be/db.ts +116 -23
  190. package/src/be/extensions/assets.ts +11 -7
  191. package/src/be/memory/demotion-evidence.ts +2 -2
  192. package/src/be/memory/providers/sqlite-store.ts +151 -18
  193. package/src/be/memory/search-read-worker.ts +60 -0
  194. package/src/be/memory/search-reader.ts +223 -0
  195. package/src/be/migrations/332_primitive_objects.sql +31 -0
  196. package/src/be/migrations/334_agent_history.sql +23 -0
  197. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  198. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  199. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  200. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  201. package/src/be/model-tier-resolution.ts +18 -1
  202. package/src/be/multi-runtime.ts +17 -0
  203. package/src/be/primitives/boards/elements.ts +717 -0
  204. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  205. package/src/be/primitives/boards/service.ts +121 -0
  206. package/src/be/primitives/object-embed.ts +250 -0
  207. package/src/be/primitives/object-webhooks.ts +348 -0
  208. package/src/be/primitives/objects.ts +706 -0
  209. package/src/be/primitives/sheets/a1.ts +136 -0
  210. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  211. package/src/be/primitives/sheets/engine.ts +199 -0
  212. package/src/be/primitives/sheets/format.ts +106 -0
  213. package/src/be/primitives/sheets/service.ts +547 -0
  214. package/src/be/primitives/sheets/xlsx.ts +367 -0
  215. package/src/be/primitives/write-object.ts +83 -0
  216. package/src/be/rbac-roles.ts +3 -0
  217. package/src/be/repo-checked-update.ts +4 -4
  218. package/src/be/repo-merge-policy.ts +26 -9
  219. package/src/be/script-credential-broker.ts +8 -27
  220. package/src/be/scripts/boot-reembed.ts +6 -0
  221. package/src/be/scripts/db.ts +17 -5
  222. package/src/be/scripts/embeddings.ts +6 -0
  223. package/src/be/scripts/typecheck.ts +257 -0
  224. package/src/be/seed/agent-fs-provision.ts +18 -0
  225. package/src/be/seed/schedules-seeder.ts +9 -1
  226. package/src/be/seed/workflows-seeder.ts +9 -1
  227. package/src/be/seed-scripts/index.ts +2 -0
  228. package/src/be/seed-skills/index.ts +12 -0
  229. package/src/be/swarm-config-guard.ts +1 -0
  230. package/src/be/unmapped-identities.ts +95 -1
  231. package/src/be/users.ts +19 -0
  232. package/src/bitbucket/handlers.ts +2 -0
  233. package/src/commands/onboard/agent-fs-version.ts +1 -1
  234. package/src/commands/onboard/steps/harness.tsx +1 -1
  235. package/src/commands/provider-credentials.ts +1 -0
  236. package/src/e2b/env.ts +3 -1
  237. package/src/event-waits/github.ts +43 -0
  238. package/src/event-waits/index.ts +29 -0
  239. package/src/event-waits/types.ts +51 -0
  240. package/src/extensions/contract-types.generated.ts +1 -1
  241. package/src/extensions/dispatcher.ts +9 -0
  242. package/src/fs/agent-fs-provider.ts +37 -3
  243. package/src/github/handlers.ts +3 -1
  244. package/src/github/pull-request-state.ts +34 -0
  245. package/src/gitlab/auth.ts +3 -4
  246. package/src/gitlab/handlers.ts +12 -7
  247. package/src/heartbeat/heartbeat.ts +11 -11
  248. package/src/hooks/codex-hook.ts +99 -1
  249. package/src/hooks/hook.ts +85 -11
  250. package/src/hooks/native-tool-hooks.ts +245 -0
  251. package/src/http/agent-lifecycle.ts +152 -0
  252. package/src/http/agents.ts +12 -0
  253. package/src/http/all-routes.ts +3 -0
  254. package/src/http/assets.ts +4 -3
  255. package/src/http/auth.ts +2 -1
  256. package/src/http/comb.ts +2 -2
  257. package/src/http/favorite-owner.ts +2 -2
  258. package/src/http/favorites.ts +3 -2
  259. package/src/http/fs.ts +13 -4
  260. package/src/http/index.ts +17 -0
  261. package/src/http/mcp-bridge.ts +4 -0
  262. package/src/http/object-webhooks.ts +101 -0
  263. package/src/http/objects.ts +265 -0
  264. package/src/http/operator-actor.ts +2 -1
  265. package/src/http/pages.ts +3 -3
  266. package/src/http/poll.ts +43 -12
  267. package/src/http/repos.ts +7 -6
  268. package/src/http/schedules.ts +10 -6
  269. package/src/http/script-connections.ts +2 -2
  270. package/src/http/scripts.ts +9 -0
  271. package/src/http/sessions.ts +37 -12
  272. package/src/http/skills.ts +17 -0
  273. package/src/http/task-requester.ts +2 -2
  274. package/src/http/tasks.ts +13 -3
  275. package/src/http/tool-hooks.ts +24 -2
  276. package/src/http/trackers/authorize-gate.ts +2 -2
  277. package/src/http/users.ts +136 -1
  278. package/src/http/workflow-events.ts +13 -0
  279. package/src/http/workflows.ts +47 -5
  280. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  281. package/src/linear/sync.ts +3 -1
  282. package/src/prompts/base-prompt.ts +35 -13
  283. package/src/prompts/session-templates.ts +25 -0
  284. package/src/providers/acp-targets.ts +2 -2
  285. package/src/providers/amp-adapter.ts +1 -1
  286. package/src/providers/dsh-adapter.ts +1 -1
  287. package/src/providers/opencode-adapter.ts +5 -1
  288. package/src/providers/opencode-swarm-plugin.ts +50 -1
  289. package/src/providers/pi-mono-adapter.ts +139 -9
  290. package/src/providers/pi-mono-extension.ts +69 -0
  291. package/src/providers/runtime-dependencies.ts +1 -1
  292. package/src/rbac/legacy-policy.ts +5 -0
  293. package/src/rbac/permissions.ts +16 -1
  294. package/src/scheduler/deferred-task-waits.ts +170 -13
  295. package/src/script-workflows/guest-ctx.ts +32 -0
  296. package/src/script-workflows/workflow-ctx.ts +2 -0
  297. package/src/scripts-runtime/ctx.ts +9 -1
  298. package/src/scripts-runtime/executors/native.ts +106 -21
  299. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  300. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  301. package/src/scripts-runtime/executors/types.ts +5 -0
  302. package/src/scripts-runtime/loader.ts +8 -0
  303. package/src/scripts-runtime/mcp-client.ts +4 -0
  304. package/src/scripts-runtime/sdk-allowlist.ts +101 -0
  305. package/src/scripts-runtime/swarm-config.ts +8 -0
  306. package/src/scripts-runtime/swarm-sdk.ts +55 -3
  307. package/src/scripts-runtime/types/stdlib.d.ts +310 -0
  308. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  309. package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
  310. package/src/server.ts +52 -0
  311. package/src/slack/enrich.ts +81 -21
  312. package/src/slack/handlers.test.ts +55 -2
  313. package/src/slack/handlers.ts +38 -3
  314. package/src/slack/render-v2.ts +19 -0
  315. package/src/slack/session-mirror.ts +208 -0
  316. package/src/slack/thread-participants.ts +0 -5
  317. package/src/slack/watcher.ts +3 -0
  318. package/src/slack/work-objects.test.ts +2 -1
  319. package/src/slack/work-objects.ts +7 -2
  320. package/src/tests/agent-history.test.ts +313 -0
  321. package/src/tests/agentmail-filters.test.ts +4 -3
  322. package/src/tests/audit-agent-person.test.ts +825 -0
  323. package/src/tests/audit-updated-by.test.ts +19 -12
  324. package/src/tests/azure-devops-auth.test.ts +6 -0
  325. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  326. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  327. package/src/tests/claude-hook-output.test.ts +107 -2
  328. package/src/tests/claude-managed-setup.test.ts +1 -1
  329. package/src/tests/codex-adapter.test.ts +6 -6
  330. package/src/tests/codex-gpt6-release.test.ts +4 -4
  331. package/src/tests/credential-check.test.ts +12 -0
  332. package/src/tests/db-task-read-contract.test.ts +3 -0
  333. package/src/tests/db-task-write-contract.test.ts +3 -0
  334. package/src/tests/dsh-adapter.test.ts +1 -1
  335. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  336. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  337. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  338. package/src/tests/e2e-shards.test.ts +137 -0
  339. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  340. package/src/tests/extensions-catalog.test.ts +33 -25
  341. package/src/tests/extensions-heartbeat.test.ts +34 -0
  342. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  343. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  344. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  345. package/src/tests/gitlab-auth.test.ts +10 -0
  346. package/src/tests/heartbeat.test.ts +38 -0
  347. package/src/tests/http-api-integration.test.ts +0 -6
  348. package/src/tests/kv-storage.test.ts +3 -0
  349. package/src/tests/memory-search-reader.test.ts +258 -0
  350. package/src/tests/memory-search-stall.test.ts +197 -20
  351. package/src/tests/model-control.test.ts +4 -4
  352. package/src/tests/model-tier-resolution.test.ts +2 -2
  353. package/src/tests/multi-runtime-registration.test.ts +8 -2
  354. package/src/tests/native-tool-hooks.test.ts +188 -0
  355. package/src/tests/opencode-adapter.test.ts +11 -0
  356. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  357. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  358. package/src/tests/poll-probe-readonly.test.ts +108 -0
  359. package/src/tests/primitives-boards.test.ts +686 -0
  360. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  361. package/src/tests/primitives-objects.test.ts +248 -0
  362. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  363. package/src/tests/prompt-template-session.test.ts +3 -2
  364. package/src/tests/rbac-roles.test.ts +3 -0
  365. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  366. package/src/tests/script-connections.test.ts +4 -0
  367. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  368. package/src/tests/scripts-namespaces.test.ts +211 -0
  369. package/src/tests/secret-scrub-gate.test.ts +1 -0
  370. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  371. package/src/tests/secret-scrubber.test.ts +1 -1
  372. package/src/tests/seed-model-profiles.test.ts +1 -1
  373. package/src/tests/session-tokens.test.ts +27 -0
  374. package/src/tests/sessions-tree.test.ts +10 -2
  375. package/src/tests/sheet-engine.test.ts +58 -0
  376. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  377. package/src/tests/slack-read-boundaries.test.ts +4 -2
  378. package/src/tests/slack-thread-participants.test.ts +66 -4
  379. package/src/tests/task-start-after-commit.test.ts +82 -0
  380. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  381. package/src/tests/ui-logs-parser.test.ts +67 -0
  382. package/src/tests/workflow-retry-v2.test.ts +101 -0
  383. package/src/tests/workflow-tla-races.test.ts +29 -0
  384. package/src/tools/boards.ts +260 -0
  385. package/src/tools/defer-task.ts +154 -12
  386. package/src/tools/objects.ts +196 -0
  387. package/src/tools/repos/update-repo.ts +6 -6
  388. package/src/tools/schedules/create-schedule.ts +1 -0
  389. package/src/tools/schedules/list-schedules.ts +3 -0
  390. package/src/tools/schedules/patch-schedule.ts +12 -3
  391. package/src/tools/schedules/update-schedule.ts +12 -3
  392. package/src/tools/sheets.ts +378 -0
  393. package/src/tools/skills/skill-create.ts +6 -0
  394. package/src/tools/skills/skill-install-remote.ts +6 -0
  395. package/src/tools/skills/skill-sync-remote.ts +9 -0
  396. package/src/tools/skills/skill-update.ts +9 -1
  397. package/src/tools/slack-read.ts +10 -3
  398. package/src/tools/tool-config.ts +25 -0
  399. package/src/tools/utils.ts +15 -0
  400. package/src/tools/workflows/create-workflow.ts +20 -5
  401. package/src/tools/workflows/patch-workflow-node.ts +5 -1
  402. package/src/tools/workflows/patch-workflow.ts +9 -2
  403. package/src/tools/workflows/update-workflow.ts +27 -4
  404. package/src/types.ts +112 -12
  405. package/src/utils/sandboxed-process.ts +47 -2
  406. package/src/utils/secret-scrubber.ts +61 -6
  407. package/src/workflows/engine.ts +35 -21
  408. package/src/workflows/input.ts +36 -1
  409. package/src/workflows/patch-definition.ts +24 -2
  410. package/src/workflows/retry-poller.ts +15 -2
  411. package/src/workflows/triggers.ts +11 -6
  412. package/src/workflows/validation.ts +10 -0
  413. package/src/workflows/version.ts +7 -1
  414. package/templates/ai-toolbox.manifest.json +1 -1
  415. package/templates/skills/agent-browser/SKILL.md +1 -0
  416. package/templates/skills/agent-browser/content.md +1 -0
  417. package/templates/skills/boards-and-sheets/config.json +14 -0
  418. package/templates/skills/boards-and-sheets/content.md +163 -0
  419. package/templates/skills/pages/content.md +5 -0
  420. package/templates/skills/swarm-docs/content.md +15 -1
  421. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  422. package/templates/skills/swarm-scripts/content.md +1 -0
  423. package/templates/skills/tdd-planning/content.md +5 -2
  424. package/dist/acp-adapter-weaaxey3.js +0 -16
  425. package/dist/core-df1n049h.js +0 -39
  426. package/dist/fx-adapter-zwmps9re.js +0 -19
  427. package/dist/grok-adapter-q0avf919.js +0 -19
  428. package/dist/handlers-g5jq0e4q.js +0 -36
  429. package/dist/index-1f6m47mq.js +0 -37
  430. package/dist/index-1p1mpqda.js +0 -36
  431. package/dist/index-tnkd410q.js +0 -41
  432. package/dist/lead-m5e7xt93.js +0 -75
  433. package/dist/thread-buffer-nf55vwx3.js +0 -39
  434. package/dist/worker-ews1nyhw.js +0 -75
  435. package/src/slack/socket-mode-guard.test.ts +0 -25
  436. package/src/tests/agent-activity.test.ts +0 -247
  437. package/src/tests/agent-fs-live-url.test.ts +0 -55
  438. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  439. package/src/tests/approval-sweeps-config.test.ts +0 -47
  440. package/src/tests/cards.test.ts +0 -169
  441. package/src/tests/chat-sdk-facts.test.ts +0 -23
  442. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  443. package/src/tests/core-auth.test.ts +0 -156
  444. package/src/tests/date-utils.test.ts +0 -48
  445. package/src/tests/db-context-versions.test.ts +0 -37
  446. package/src/tests/db-runtime.test.ts +0 -132
  447. package/src/tests/enabled-capabilities.test.ts +0 -20
  448. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  449. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  450. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  451. package/src/tests/github-event-labels.test.ts +0 -24
  452. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  453. package/src/tests/http-log-scrubbing.test.ts +0 -123
  454. package/src/tests/http-semconv-attributes.test.ts +0 -92
  455. package/src/tests/identity.test.ts +0 -117
  456. package/src/tests/inbox-state.test.ts +0 -167
  457. package/src/tests/internal-ai/models.test.ts +0 -54
  458. package/src/tests/launch-password-rejection.test.ts +0 -140
  459. package/src/tests/list-total-cache.test.ts +0 -88
  460. package/src/tests/match-route.test.ts +0 -187
  461. package/src/tests/memory-feature-flags.test.ts +0 -45
  462. package/src/tests/memory-get-tool.test.ts +0 -269
  463. package/src/tests/memory-health-endpoint.test.ts +0 -78
  464. package/src/tests/memory-http-access.test.ts +0 -221
  465. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  466. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  467. package/src/tests/openai-embedding-provider.test.ts +0 -159
  468. package/src/tests/org-identity.test.ts +0 -44
  469. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  470. package/src/tests/pages-browser-sdk.test.ts +0 -76
  471. package/src/tests/pages-feedback-keys.test.ts +0 -121
  472. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  473. package/src/tests/pages-list-endpoint.test.ts +0 -148
  474. package/src/tests/pages-password-mode.test.ts +0 -266
  475. package/src/tests/pages-public-authed-401.test.ts +0 -103
  476. package/src/tests/pages-public-html.test.ts +0 -297
  477. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  478. package/src/tests/pages-view-count.test.ts +0 -245
  479. package/src/tests/prompt-templates-db.test.ts +0 -616
  480. package/src/tests/rbac-engine.test.ts +0 -742
  481. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  482. package/src/tests/route-def-find-route.test.ts +0 -192
  483. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  484. package/src/tests/schedule-validation-helper.test.ts +0 -51
  485. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  486. package/src/tests/scheduler-backoff.test.ts +0 -166
  487. package/src/tests/script-run-token.test.ts +0 -75
  488. package/src/tests/scripts-extract-signature.test.ts +0 -47
  489. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  490. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  491. package/src/tests/short-id.test.ts +0 -23
  492. package/src/tests/skill-files-http.test.ts +0 -222
  493. package/src/tests/skill-get-file-tool.test.ts +0 -110
  494. package/src/tests/skill-script-refs.test.ts +0 -63
  495. package/src/tests/skill-update-scope.test.ts +0 -252
  496. package/src/tests/skills-bundle.test.ts +0 -99
  497. package/src/tests/slack-app-icon.test.ts +0 -94
  498. package/src/tests/slack-assistant-comention.test.ts +0 -139
  499. package/src/tests/slack-delete.test.ts +0 -157
  500. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  501. package/src/tests/slack-manifest.test.ts +0 -23
  502. package/src/tests/slack-task-output.test.ts +0 -90
  503. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  504. package/src/tests/swarm-diff.test.ts +0 -728
  505. package/src/tests/task-lifecycle-events.test.ts +0 -53
  506. package/src/tests/template-asset-config.test.ts +0 -18
  507. package/src/tests/template-fetch.test.ts +0 -490
  508. package/src/tests/themes-page-theme.test.ts +0 -155
  509. package/src/tests/tool-annotations.test.ts +0 -442
  510. package/src/tests/tool-output-agent-id.test.ts +0 -202
  511. package/src/tests/update-profile-agentid.test.ts +0 -248
  512. package/src/tests/whoami-route.test.ts +0 -162
  513. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  514. package/src/tests/workflow-patch.test.ts +0 -169
  515. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  516. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  517. package/src/tests/workflow-step-claims.test.ts +0 -152
  518. package/src/tests/workflow-step-order.test.ts +0 -92
  519. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  520. package/src/tests/workflow-versions.test.ts +0 -240
  521. package/src/tests/workflow-wait.test.ts +0 -26
@@ -0,0 +1,378 @@
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
+ exportSheetXlsx,
10
+ getSheet,
11
+ getSheetRange,
12
+ importSheetXlsx,
13
+ listSheets,
14
+ setSheetRange,
15
+ } from "@/be/primitives/sheets/service";
16
+ import { FilesError } from "@/fs/provider";
17
+ import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
18
+
19
+ // Loose, format-pin-free mirror of PrimitiveObject for MCP output validation.
20
+ const objectOutputSchema = z.looseObject({
21
+ id: z.string().optional(),
22
+ kind: z.string().optional(),
23
+ path: z.string().optional(),
24
+ title: z.string().nullable().optional(),
25
+ fileVersion: z.number().nullable().optional(),
26
+ link: z.string().nullable().optional(),
27
+ });
28
+
29
+ const CellValue = z.union([z.number(), z.string(), z.boolean(), z.null()]);
30
+ const Grid = z.array(z.array(CellValue));
31
+
32
+ const RANGE_HELP =
33
+ "A1 range such as `Tasks!B2:C3`, `A1:C10` (first tab), `'My tab'!A:A` (whole column, capped to the used range) or `B2`.";
34
+
35
+ /** Refusals (bad input, no agent-fs identity, agent-fs errors) become toolErr; bugs still throw. */
36
+ async function refusing<T>(
37
+ agentId: string | undefined,
38
+ run: () => Promise<T>,
39
+ ): Promise<{ value: T } | { error: ReturnType<typeof toolErr> }> {
40
+ try {
41
+ return { value: await run() };
42
+ } catch (error) {
43
+ if (error instanceof ObjectsError || error instanceof FilesError) {
44
+ return { error: toolErr(error.message, { data: { yourAgentId: agentId } }) };
45
+ }
46
+ throw error;
47
+ }
48
+ }
49
+
50
+ const dataShape = {
51
+ yourAgentId: z.string().optional(),
52
+ object: objectOutputSchema.optional(),
53
+ objects: z.array(objectOutputSchema).optional(),
54
+ total: z.number().optional(),
55
+ link: z.string().nullable().optional(),
56
+ version: z.number().optional(),
57
+ tabs: z.array(z.unknown()).optional(),
58
+ range: z.string().optional(),
59
+ values: z.array(z.array(z.unknown())).optional(),
60
+ formulas: z.array(z.array(z.unknown())).optional(),
61
+ changed: z.number().optional(),
62
+ recalculated: z.number().optional(),
63
+ cleared: z.number().optional(),
64
+ path: z.string().optional(),
65
+ dropped: z.array(z.string()).optional(),
66
+ };
67
+
68
+ const outputSchema = swarmToolOutputSchema(dataShape);
69
+
70
+ const ID = "Object id (from sheet-create or sheet-list).";
71
+ const PATH = "Drive path of the `.sheet.json` file, instead of `id`.";
72
+ const WRITE = { readOnlyHint: false, idempotentHint: false } as const;
73
+
74
+ export const registerSheetCreateTool = (server: McpServer) => {
75
+ createToolRegistrar(server)(
76
+ "sheet-create",
77
+ {
78
+ title: "Create sheet",
79
+ annotations: WRITE,
80
+ description:
81
+ "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.",
82
+ inputSchema: z.object({
83
+ path: z
84
+ .string()
85
+ .min(1)
86
+ .describe("Drive path ending in `.sheet.json`, e.g. /qa/tracker.sheet.json."),
87
+ title: z.string().max(200).optional(),
88
+ tabs: z
89
+ .array(z.object({ name: z.string().min(1).max(31), rows: Grid.optional() }))
90
+ .optional()
91
+ .describe("Tabs to create, each with an optional `rows` grid written from A1."),
92
+ }),
93
+ outputSchema,
94
+ },
95
+ async ({ path, title, tabs }, requestInfo) => {
96
+ const result = await refusing(requestInfo.agentId, () =>
97
+ createSheet({ agentId: requestInfo.agentId, path, title, tabs }),
98
+ );
99
+ if ("error" in result) return result.error;
100
+ const { object, link } = result.value;
101
+ return toolOk(`Created sheet ${object.id} at ${object.path}${link ? ` (${link})` : ""}.`, {
102
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
103
+ });
104
+ },
105
+ );
106
+ };
107
+
108
+ export const registerSheetGetTool = (server: McpServer) => {
109
+ createToolRegistrar(server)(
110
+ "sheet-get",
111
+ {
112
+ title: "Get sheet",
113
+ annotations: { readOnlyHint: true },
114
+ description:
115
+ "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.",
116
+ inputSchema: z.object({
117
+ id: z.string().min(1).optional().describe(ID),
118
+ path: z.string().min(1).optional().describe(PATH),
119
+ }),
120
+ outputSchema,
121
+ },
122
+ async ({ id, path }, requestInfo) => {
123
+ const result = await refusing(requestInfo.agentId, () =>
124
+ getSheet({ agentId: requestInfo.agentId, id, path }),
125
+ );
126
+ if ("error" in result) return result.error;
127
+ const { object, tabs, version } = result.value;
128
+ return toolOk(
129
+ `Sheet ${object.id} at ${object.path}: ${tabs.length} tab(s), version ${version}.`,
130
+ {
131
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
132
+ },
133
+ );
134
+ },
135
+ );
136
+ };
137
+
138
+ export const registerSheetListTool = (server: McpServer) => {
139
+ createToolRegistrar(server)(
140
+ "sheet-list",
141
+ {
142
+ title: "List sheets",
143
+ annotations: { readOnlyHint: true },
144
+ description:
145
+ "List sheets on your default agent-fs drive, newest first. Filter by path `prefix`. Pagination via limit (max 200) and offset.",
146
+ inputSchema: z.object({
147
+ prefix: z.string().optional(),
148
+ limit: z.number().int().positive().max(200).optional(),
149
+ offset: z.number().int().nonnegative().optional(),
150
+ }),
151
+ outputSchema,
152
+ },
153
+ async ({ prefix, limit, offset }, requestInfo) => {
154
+ const result = await refusing(requestInfo.agentId, () =>
155
+ listSheets({ agentId: requestInfo.agentId, prefix, limit, offset }),
156
+ );
157
+ if ("error" in result) return result.error;
158
+ const { objects, total } = result.value;
159
+ return toolOk(`Found ${objects.length} of ${total} sheets.`, {
160
+ details:
161
+ objects.length > 0 ? objects.map((o) => `- ${o.id} at ${o.path}`).join("\n") : undefined,
162
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
163
+ });
164
+ },
165
+ );
166
+ };
167
+
168
+ export const registerSheetGetRangeTool = (server: McpServer) => {
169
+ createToolRegistrar(server)(
170
+ "sheet-get-range",
171
+ {
172
+ title: "Read sheet range",
173
+ annotations: { readOnlyHint: true },
174
+ description:
175
+ "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.",
176
+ inputSchema: z.object({
177
+ id: z.string().min(1).optional().describe(ID),
178
+ path: z.string().min(1).optional().describe(PATH),
179
+ range: z.string().min(1).describe(RANGE_HELP),
180
+ formulas: z
181
+ .boolean()
182
+ .optional()
183
+ .describe(
184
+ "Also return `formulas[][]`: the formula text where a cell has one, else the value.",
185
+ ),
186
+ }),
187
+ outputSchema,
188
+ },
189
+ async ({ id, path, range, formulas }, requestInfo) => {
190
+ const result = await refusing(requestInfo.agentId, () =>
191
+ getSheetRange({ agentId: requestInfo.agentId, id, path, range, formulas }),
192
+ );
193
+ if ("error" in result) return result.error;
194
+ return toolOk(`Read ${result.value.range} at version ${result.value.version}.`, {
195
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
196
+ });
197
+ },
198
+ );
199
+ };
200
+
201
+ export const registerSheetSetRangeTool = (server: McpServer) => {
202
+ createToolRegistrar(server)(
203
+ "sheet-set-range",
204
+ {
205
+ title: "Write sheet range",
206
+ annotations: WRITE,
207
+ description:
208
+ "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.",
209
+ inputSchema: z.object({
210
+ id: z.string().min(1).optional().describe(ID),
211
+ path: z.string().min(1).optional().describe(PATH),
212
+ range: z.string().min(1).describe(RANGE_HELP),
213
+ values: Grid.describe("Rows of cell values, all the same length (at most 10,000 cells)."),
214
+ }),
215
+ outputSchema,
216
+ },
217
+ async ({ id, path, range, values }, requestInfo) => {
218
+ const result = await refusing(requestInfo.agentId, () =>
219
+ setSheetRange({ agentId: requestInfo.agentId, id, path, range, values }),
220
+ );
221
+ if ("error" in result) return result.error;
222
+ const r = result.value;
223
+ return toolOk(
224
+ `Wrote ${r.range}: ${r.changed} changed, ${r.recalculated} recalculated, version ${r.version}.`,
225
+ { data: { yourAgentId: requestInfo.agentId, ...r } },
226
+ );
227
+ },
228
+ );
229
+ };
230
+
231
+ export const registerSheetAppendRowsTool = (server: McpServer) => {
232
+ createToolRegistrar(server)(
233
+ "sheet-append-rows",
234
+ {
235
+ title: "Append sheet rows",
236
+ annotations: WRITE,
237
+ description:
238
+ "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.",
239
+ inputSchema: z.object({
240
+ id: z.string().min(1).optional().describe(ID),
241
+ path: z.string().min(1).optional().describe(PATH),
242
+ tab: z.string().min(1).describe("Tab name."),
243
+ rows: Grid.describe("Rows to append (at most 10,000 cells)."),
244
+ }),
245
+ outputSchema,
246
+ },
247
+ async ({ id, path, tab, rows }, requestInfo) => {
248
+ const result = await refusing(requestInfo.agentId, () =>
249
+ appendSheetRows({ agentId: requestInfo.agentId, id, path, tab, rows }),
250
+ );
251
+ if ("error" in result) return result.error;
252
+ return toolOk(`Appended ${result.value.range}, version ${result.value.version}.`, {
253
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
254
+ });
255
+ },
256
+ );
257
+ };
258
+
259
+ export const registerSheetClearRangeTool = (server: McpServer) => {
260
+ createToolRegistrar(server)(
261
+ "sheet-clear-range",
262
+ {
263
+ title: "Clear sheet range",
264
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
265
+ description:
266
+ "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.",
267
+ inputSchema: z.object({
268
+ id: z.string().min(1).optional().describe(ID),
269
+ path: z.string().min(1).optional().describe(PATH),
270
+ range: z.string().min(1).describe(RANGE_HELP),
271
+ }),
272
+ outputSchema,
273
+ },
274
+ async ({ id, path, range }, requestInfo) => {
275
+ const result = await refusing(requestInfo.agentId, () =>
276
+ clearSheetRange({ agentId: requestInfo.agentId, id, path, range }),
277
+ );
278
+ if ("error" in result) return result.error;
279
+ const r = result.value;
280
+ return toolOk(`Cleared ${r.cleared} cell(s) in ${r.range}, version ${r.version}.`, {
281
+ data: { yourAgentId: requestInfo.agentId, ...r },
282
+ });
283
+ },
284
+ );
285
+ };
286
+
287
+ export const registerSheetAddTabTool = (server: McpServer) => {
288
+ createToolRegistrar(server)(
289
+ "sheet-add-tab",
290
+ {
291
+ title: "Add sheet tab",
292
+ annotations: WRITE,
293
+ description:
294
+ "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.",
295
+ inputSchema: z.object({
296
+ id: z.string().min(1).optional().describe(ID),
297
+ path: z.string().min(1).optional().describe(PATH),
298
+ name: z.string().min(1).max(31).describe("New tab name."),
299
+ after: z.string().optional().describe("Insert after this tab; default: at the end."),
300
+ }),
301
+ outputSchema,
302
+ },
303
+ async ({ id, path, name, after }, requestInfo) => {
304
+ const result = await refusing(requestInfo.agentId, () =>
305
+ addSheetTab({ agentId: requestInfo.agentId, id, path, name, after }),
306
+ );
307
+ if ("error" in result) return result.error;
308
+ return toolOk(
309
+ `Tabs now: ${result.value.tabs.join(", ")} (version ${result.value.version}).`,
310
+ {
311
+ data: { yourAgentId: requestInfo.agentId, ...result.value },
312
+ },
313
+ );
314
+ },
315
+ );
316
+ };
317
+
318
+ const dropMessage = (dropped: string[]) =>
319
+ dropped.length ? `Dropped: ${dropped.join(", ")}.` : "Nothing dropped.";
320
+
321
+ export const registerSheetImportXlsxTool = (server: McpServer) => {
322
+ createToolRegistrar(server)(
323
+ "sheet-import-xlsx",
324
+ {
325
+ title: "Import xlsx as sheet",
326
+ annotations: WRITE,
327
+ description:
328
+ "Import an `.xlsx` file from your default agent-fs drive as a new sheet, as your own agent-fs identity. Create-only: refuses when the sheet path exists. Keeps tabs, values, formulas (recomputed), number formats, column widths and merges. `dropped` lists what the file had that a sheet cannot hold (styles, charts, comments, frozen panes, and so on). Limits: 5 MiB file, 20 tabs, 50,000 cells; nothing is created when a limit refuses.",
329
+ inputSchema: z.object({
330
+ sourcePath: z.string().min(1).describe("Drive path of the `.xlsx` file to import."),
331
+ path: z.string().min(1).describe("Drive path for the new sheet, ending in `.sheet.json`."),
332
+ title: z.string().max(200).optional(),
333
+ }),
334
+ outputSchema,
335
+ },
336
+ async ({ sourcePath, path, title }, requestInfo) => {
337
+ const result = await refusing(requestInfo.agentId, () =>
338
+ importSheetXlsx({ agentId: requestInfo.agentId, sourcePath, path, title }),
339
+ );
340
+ if ("error" in result) return result.error;
341
+ const { object, link, dropped } = result.value;
342
+ return toolOk(
343
+ `Imported ${sourcePath} as sheet ${object.id} at ${object.path}${link ? ` (${link})` : ""}. ${dropMessage(dropped)}`,
344
+ { data: { yourAgentId: requestInfo.agentId, ...result.value } },
345
+ );
346
+ },
347
+ );
348
+ };
349
+
350
+ export const registerSheetExportXlsxTool = (server: McpServer) => {
351
+ createToolRegistrar(server)(
352
+ "sheet-export-xlsx",
353
+ {
354
+ title: "Export sheet as xlsx",
355
+ annotations: WRITE,
356
+ description:
357
+ "Export a sheet to an `.xlsx` file on your default agent-fs drive. Writes formulas with their cached values, number formats, column widths and merges. `dropped` lists what the file cannot carry (frozen panes, spilled array cells). Create-only: refuses when `targetPath` exists unless `overwrite` is true.",
358
+ inputSchema: z.object({
359
+ id: z.string().min(1).optional().describe(ID),
360
+ path: z.string().min(1).optional().describe(PATH),
361
+ targetPath: z.string().min(1).describe("Drive path for the new file, ending in `.xlsx`."),
362
+ overwrite: z.boolean().optional().describe("Replace `targetPath` when it exists."),
363
+ }),
364
+ outputSchema,
365
+ },
366
+ async ({ id, path, targetPath, overwrite }, requestInfo) => {
367
+ const result = await refusing(requestInfo.agentId, () =>
368
+ exportSheetXlsx({ agentId: requestInfo.agentId, id, path, targetPath, overwrite }),
369
+ );
370
+ if ("error" in result) return result.error;
371
+ const r = result.value;
372
+ return toolOk(
373
+ `Exported to ${r.path}${r.link ? ` (${r.link})` : ""}. ${dropMessage(r.dropped)}`,
374
+ { data: { yourAgentId: requestInfo.agentId, ...r } },
375
+ );
376
+ },
377
+ );
378
+ };
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { createSkill, getAgentById, installSkill } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { can } from "@/rbac";
@@ -72,6 +73,11 @@ export const registerSkillCreateTool = (server: McpServer) => {
72
73
  agent: parsed.agent,
73
74
  disableModelInvocation: parsed.disableModelInvocation,
74
75
  userInvocable: parsed.userInvocable,
76
+ createdByAgentId: requestInfo.agentId,
77
+ createdBy: await resolveTaskAuditUserId(
78
+ requestInfo.auditSourceTaskId,
79
+ requestInfo.agentId,
80
+ ),
75
81
  });
76
82
 
77
83
  // Auto-install for the creating agent
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { createSkill, getAgentById } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { can } from "@/rbac";
@@ -112,6 +113,11 @@ export const registerSkillInstallRemoteTool = (server: McpServer) => {
112
113
  agent: parsedMeta.agent,
113
114
  disableModelInvocation: parsedMeta.disableModelInvocation,
114
115
  userInvocable: parsedMeta.userInvocable,
116
+ createdByAgentId: requestInfo.agentId,
117
+ createdBy: await resolveTaskAuditUserId(
118
+ requestInfo.auditSourceTaskId,
119
+ requestInfo.agentId,
120
+ ),
115
121
  });
116
122
 
117
123
  return toolOk(`Installed remote skill "${skill.name}".`, {
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { getSkillById, listSkills, updateSkill } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
@@ -46,6 +47,12 @@ export const registerSkillSyncRemoteTool = (server: McpServer) => {
46
47
 
47
48
  let updated = 0;
48
49
  const errors: string[] = [];
50
+ // A content change is attributed to the caller; a lastFetchedAt-only
51
+ // touch is a fetch, not an edit, and leaves the audit pair alone.
52
+ const updatedBy = await resolveTaskAuditUserId(
53
+ requestInfo.auditSourceTaskId,
54
+ requestInfo.agentId,
55
+ );
49
56
 
50
57
  for (const skill of skills) {
51
58
  if (skill.isComplex) continue; // Skip complex skills (handled by npx)
@@ -80,6 +87,8 @@ export const registerSkillSyncRemoteTool = (server: McpServer) => {
80
87
  userInvocable: parsed.userInvocable,
81
88
  sourceHash: newHash,
82
89
  lastFetchedAt: now,
90
+ updatedByAgentId: requestInfo.agentId ?? null,
91
+ updatedBy,
83
92
  });
84
93
  updated++;
85
94
  } else {
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { getAgentById, getSkillById, updateSkill } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { can } from "@/rbac";
@@ -114,7 +115,14 @@ export const registerSkillUpdateTool = (server: McpServer) => {
114
115
  updates.scope = args.scope;
115
116
  }
116
117
 
117
- const skill = await updateSkill(args.skillId, updates);
118
+ const skill = await updateSkill(args.skillId, {
119
+ ...updates,
120
+ updatedByAgentId: requestInfo.agentId,
121
+ updatedBy: await resolveTaskAuditUserId(
122
+ requestInfo.auditSourceTaskId,
123
+ requestInfo.agentId,
124
+ ),
125
+ });
118
126
  if (!skill) {
119
127
  return toolErr("Update failed.", {
120
128
  details: "Failed to update skill.",
@@ -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,31 @@ 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 (10)
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
+ "sheet-import-xlsx",
240
+ "sheet-export-xlsx",
241
+ // Boards (6)
242
+ "board-create",
243
+ "board-get",
244
+ "board-list",
245
+ "board-add-elements",
246
+ "board-update-elements",
247
+ "board-remove-elements",
248
+
224
249
  // Reusable scripts and extensions (13)
225
250
  "script-upsert",
226
251
  "script-delete",
@@ -50,6 +50,13 @@ export type RequestInfo = {
50
50
  /** Calling worker process, when multi-runtime mode is on. */
51
51
  runtimeInstanceId: string | undefined;
52
52
  sourceTaskId: string | undefined;
53
+ /**
54
+ * Task for audit attribution only: `sourceTaskId`, else the
55
+ * `X-Audit-Source-Task-Id` header script `ctx.swarm` calls send. Use it only
56
+ * for a `created_by` / `updated_by` value; never as task context, a
57
+ * requester, or an authorization identity (those use `sourceTaskId`).
58
+ */
59
+ auditSourceTaskId: string | undefined;
53
60
  contextKey: string | undefined;
54
61
  /** `native`: a harness built-in tool call reported through `POST /api/tool-hooks`. */
55
62
  callOrigin: "mcp" | "script-sdk" | "extension" | "native";
@@ -60,6 +67,7 @@ export type RequestInfo = {
60
67
  export const getRequestInfo = (req: Meta): RequestInfo => {
61
68
  const agentIdHeader = req.requestInfo?.headers?.["x-agent-id"];
62
69
  const sourceTaskIdHeader = req.requestInfo?.headers?.["x-source-task-id"];
70
+ const auditSourceTaskIdHeader = req.requestInfo?.headers?.["x-audit-source-task-id"];
63
71
  const contextKeyHeader = req.requestInfo?.headers?.["x-context-key"];
64
72
  const runtimeHeader = req.requestInfo?.headers?.["x-runtime-instance-id"];
65
73
  const runtimeInstanceId = Array.isArray(runtimeHeader) ? runtimeHeader[0] : runtimeHeader;
@@ -90,6 +98,13 @@ export const getRequestInfo = (req: Meta): RequestInfo => {
90
98
  agentId,
91
99
  runtimeInstanceId: typeof runtimeInstanceId === "string" ? runtimeInstanceId : undefined,
92
100
  sourceTaskId,
101
+ auditSourceTaskId:
102
+ sourceTaskId ??
103
+ (Array.isArray(auditSourceTaskIdHeader)
104
+ ? auditSourceTaskIdHeader[0]
105
+ : typeof auditSourceTaskIdHeader === "string"
106
+ ? auditSourceTaskIdHeader
107
+ : undefined),
93
108
  contextKey,
94
109
  callOrigin: extensionRequestOrigins.has(req)
95
110
  ? "extension"
@@ -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
 
@@ -53,7 +58,7 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
53
58
  "Other JSON-Schema keywords (oneOf/anyOf/$ref/pattern/format/additionalProperties) are silently ignored.\n" +
54
59
  "- WEBHOOK VERIFICATION: Webhook triggers use hmacSecret for all verification formats. " +
55
60
  "Omit verification for legacy HMAC-SHA256 over the raw body with fallback header scanning; " +
56
- "or set verification to { format: 'hmac-sha256', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
61
+ "or set verification to { format: 'hmac-sha256', header }, { format: 'hmac-sha1', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
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" +
@@ -78,7 +83,7 @@ export const registerCreateWorkflowTool = (server: McpServer) => {
78
83
  .array(TriggerConfigSchema)
79
84
  .optional()
80
85
  .describe(
81
- "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.",
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, hmac-sha1, timestamped-hmac-sha256, token-equality, standard-webhooks.",
82
87
  ),
83
88
  cooldown: CooldownConfigSchema.optional().describe(
84
89
  "Optional cooldown configuration to prevent re-triggering too frequently",
@@ -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,10 +151,20 @@ 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
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
160
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
151
161
  undefined;
152
- const assetKey = key ? await authorizeAssetKeyWrite(key, createdBy) : undefined;
162
+ const assetKey = key
163
+ ? await authorizeAssetKeyWrite(
164
+ key,
165
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
166
+ )
167
+ : undefined;
153
168
 
154
169
  const workflow = await createWorkflow(
155
170
  {
@@ -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
 
@@ -37,7 +38,7 @@ export const registerPatchWorkflowNodeTool = (server: McpServer) => {
37
38
  async ({ id, nodeId, ...nodeFields }, requestInfo) => {
38
39
  try {
39
40
  const updatedBy =
40
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
41
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
41
42
  undefined;
42
43
 
43
44
  const result = await patchWorkflowDefinition({
@@ -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;