@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
@@ -174,6 +174,277 @@ declare module "swarm-sdk" {
174
174
  state: unknown;
175
175
  }
176
176
 
177
+ export type PrimitiveObjectKind = "board" | "sheet";
178
+
179
+ export interface PrimitiveObject {
180
+ id: string;
181
+ kind: PrimitiveObjectKind;
182
+ orgId: string;
183
+ driveId: string;
184
+ /** agent-fs path, no leading slash. */
185
+ path: string;
186
+ title: string | null;
187
+ fileVersion: number | null;
188
+ ownerAgentId: string | null;
189
+ /** Set when agent-fs reported the file deleted. */
190
+ deletedAt: string | null;
191
+ createdAt: string;
192
+ updatedAt: string;
193
+ /** Live app link to the file. */
194
+ link: string | null;
195
+ }
196
+
197
+ export interface PrimitiveReindexReport {
198
+ scanned: number;
199
+ /** Files whose version matched the index: checked, not re-read. */
200
+ unchanged: number;
201
+ adopted: string[];
202
+ restored: string[];
203
+ missing: string[];
204
+ conflicts: Array<{ path: string; reason: string }>;
205
+ /** More files remain (at most 50 reads, 16 MiB or 20 s per call): run again. */
206
+ truncated: boolean;
207
+ /** Which limit cut this call short; null when the pass finished. */
208
+ cutBy: "files" | "reads" | "time" | "bytes" | null;
209
+ /** True when nothing was written: `adopted` and `restored` list what a real run would change. */
210
+ dryRun: boolean;
211
+ }
212
+
213
+ /** `prefix`: only paths that start with it (as in `list`); without it every id-less file on the drive gets an id. `dryRun`: report, write nothing. */
214
+ export type PrimitiveReindexArgs = {
215
+ kind?: PrimitiveObjectKind;
216
+ prefix?: string;
217
+ dryRun?: boolean;
218
+ };
219
+
220
+ /**
221
+ * Primitive objects: agent-fs files on your default drive with a stable id.
222
+ * Calls run as your own agent-fs identity. Each method throws on a refusal.
223
+ */
224
+ export interface ObjectsNamespace {
225
+ /** Create-only. `board` writes an empty Excalidraw scene; the path must end in `.excalidraw`. */
226
+ create(args: {
227
+ kind: PrimitiveObjectKind;
228
+ path: string;
229
+ title?: string;
230
+ }): Promise<{ message: string; object: PrimitiveObject }>;
231
+ get(args: {
232
+ id?: string;
233
+ path?: string;
234
+ includeContent?: boolean;
235
+ }): Promise<{ message: string; object: PrimitiveObject; missing: boolean; content?: unknown }>;
236
+ list(args?: {
237
+ kind?: PrimitiveObjectKind;
238
+ prefix?: string;
239
+ limit?: number;
240
+ offset?: number;
241
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
242
+ /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
243
+ reindex(args?: PrimitiveReindexArgs): Promise<{ message: string } & PrimitiveReindexReport>;
244
+ }
245
+
246
+ /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
247
+ export type SheetCellInput = number | string | boolean | null;
248
+
249
+ /** Identify the sheet by `id` or `path`. */
250
+ export interface SheetRef {
251
+ id?: string;
252
+ path?: string;
253
+ }
254
+
255
+ export interface SheetRangeArgs extends SheetRef {
256
+ /** A1 range: `Tasks!B2:C3`, `B2`, or a whole column `'My tab'!A:A` (capped to the used range). */
257
+ range: string;
258
+ }
259
+
260
+ export interface SheetCreateArgs {
261
+ /** Create-only; must end in `.sheet.json`. Default is one tab `Sheet1`; `rows` seed a tab from A1. */
262
+ path: string;
263
+ title?: string;
264
+ tabs?: Array<{ name: string; rows?: SheetCellInput[][] }>;
265
+ }
266
+
267
+ export interface SheetTabSummary {
268
+ name: string;
269
+ rows: number;
270
+ cols: number;
271
+ freezeRows: number;
272
+ }
273
+
274
+ export interface SheetImportXlsxArgs {
275
+ /** An `.xlsx` on the drive. */
276
+ sourcePath: string;
277
+ /** The new sheet; must end in `.sheet.json`. */
278
+ path: string;
279
+ title?: string;
280
+ }
281
+
282
+ export interface SheetImportXlsxResult {
283
+ message: string;
284
+ object: PrimitiveObject;
285
+ link: string | null;
286
+ /** What the file had that a sheet cannot hold. */
287
+ dropped: string[];
288
+ }
289
+
290
+ export interface SheetExportXlsxArgs extends SheetRef {
291
+ targetPath: string;
292
+ /** Replace `targetPath` when it exists. */
293
+ overwrite?: boolean;
294
+ }
295
+
296
+ export interface SheetExportXlsxResult {
297
+ message: string;
298
+ path: string;
299
+ link: string | null;
300
+ /** What the sheet had that xlsx cannot carry. */
301
+ dropped: string[];
302
+ }
303
+
304
+ export interface SheetResult {
305
+ message: string;
306
+ /** agent-fs version after the call. */
307
+ version: number;
308
+ }
309
+
310
+ /**
311
+ * Sheets: `swarm-sheet/1` workbooks on your default agent-fs drive, recomputed by a spreadsheet engine.
312
+ * Writes retry on a concurrent edit, then throw. Each method throws on a refusal.
313
+ */
314
+ export interface SheetsNamespace {
315
+ create(
316
+ args: SheetCreateArgs,
317
+ ): Promise<{ message: string; object: PrimitiveObject; link: string | null }>;
318
+ get(
319
+ args: SheetRef,
320
+ ): Promise<SheetResult & { object: PrimitiveObject; tabs: SheetTabSummary[] }>;
321
+ list(args?: {
322
+ prefix?: string;
323
+ limit?: number;
324
+ offset?: number;
325
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
326
+ /** Cached values (at most 10,000 cells). `formulas: true` also returns formula text. */
327
+ getRange(
328
+ args: SheetRangeArgs & { formulas?: boolean },
329
+ ): Promise<
330
+ SheetResult & { range: string; values: SheetCellInput[][]; formulas?: SheetCellInput[][] }
331
+ >;
332
+ /** A single-cell `range` is the top-left corner; a larger one must match `values`. `'=` stores literal text beginning with `=`. */
333
+ setRange(
334
+ args: SheetRangeArgs & { values: SheetCellInput[][] },
335
+ ): Promise<SheetResult & { range: string; changed: number; recalculated: number }>;
336
+ appendRows(
337
+ args: SheetRef & { tab: string; rows: SheetCellInput[][] },
338
+ ): Promise<SheetResult & { range: string }>;
339
+ clearRange(args: SheetRangeArgs): Promise<SheetResult & { range: string; cleared: number }>;
340
+ addTab(
341
+ args: SheetRef & { name: string; after?: string },
342
+ ): Promise<SheetResult & { tabs: string[] }>;
343
+ /** Create-only. Reads an `.xlsx` on the drive. `dropped` names what a sheet cannot hold (styles, charts, comments, frozen panes, ...). Limits: 5 MiB, 20 tabs, 50,000 cells. */
344
+ importXlsx(args: SheetImportXlsxArgs): Promise<SheetImportXlsxResult>;
345
+ /** Create-only unless `overwrite`. `targetPath` must end in `.xlsx`. `dropped` names what xlsx cannot carry (frozen panes, spilled array cells). */
346
+ exportXlsx(args: SheetExportXlsxArgs): Promise<SheetExportXlsxResult>;
347
+ }
348
+
349
+ /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
350
+ export type BoardColor =
351
+ | "blue"
352
+ | "green"
353
+ | "yellow"
354
+ | "red"
355
+ | "violet"
356
+ | "orange"
357
+ | "gray"
358
+ | "teal"
359
+ | (string & {});
360
+
361
+ export interface BoardShape {
362
+ /** Your name for the shape, so arrows in the same call can point at it. */
363
+ key?: string;
364
+ type: "rectangle" | "ellipse" | "diamond" | "text";
365
+ x?: number;
366
+ y?: number;
367
+ /** Minimum size; a shape grows to fit its label. */
368
+ width?: number;
369
+ height?: number;
370
+ /** Text inside the shape; required for `text`. */
371
+ label?: string;
372
+ color?: BoardColor;
373
+ }
374
+
375
+ /** `from` / `to`: a shape key from the same call or an existing element id. */
376
+ export interface BoardArrow {
377
+ from: string;
378
+ to: string;
379
+ label?: string;
380
+ }
381
+
382
+ export interface BoardElementPatch {
383
+ elementId: string;
384
+ /** An empty string removes a shape's label. */
385
+ label?: string;
386
+ x?: number;
387
+ y?: number;
388
+ width?: number;
389
+ height?: number;
390
+ color?: BoardColor;
391
+ }
392
+
393
+ export interface BoardElementSummary {
394
+ id: string;
395
+ type: string;
396
+ /** Free text, or a shape's label; null when it has none. */
397
+ text: string | null;
398
+ x: number;
399
+ y: number;
400
+ width: number;
401
+ height: number;
402
+ /** Arrow: [from, to] element ids (null when unbound). Shape: ids of its bound arrows. */
403
+ boundTo: Array<string | null>;
404
+ }
405
+
406
+ export type BoardLayout = "row" | "column" | "grid";
407
+ export type BoardRef = { id: string; path?: string } | { id?: string; path: string };
408
+
409
+ /** What a board call returns besides its own fields. */
410
+ export interface BoardResult {
411
+ message: string;
412
+ object: PrimitiveObject;
413
+ version: number | null;
414
+ }
415
+ export type BoardAdded = BoardResult & { added: Record<string, string> };
416
+ export type BoardElements<E> = BoardResult & { elements: E[] };
417
+ export interface BoardAddArgs {
418
+ shapes?: BoardShape[];
419
+ arrows?: BoardArrow[];
420
+ /** How shapes without x/y are placed, below existing content. Default `row`. */
421
+ layout?: BoardLayout;
422
+ }
423
+ export type BoardCreateArgs = BoardAddArgs & { path: string; title?: string };
424
+ export type BoardPatchArgs = BoardRef & { patches: BoardElementPatch[] };
425
+ export type BoardRemoveArgs = BoardRef & { elementIds: string[] };
426
+ export type BoardListArgs = { prefix?: string; limit?: number; offset?: number };
427
+ export type BoardList = { message: string; objects: PrimitiveObject[]; total: number };
428
+
429
+ /**
430
+ * Excalidraw boards (`.excalidraw`) on your default agent-fs drive, edited as
431
+ * element JSON. Writes guard on the file version and re-apply on a concurrent
432
+ * change. Each method throws on a refusal.
433
+ */
434
+ export interface BoardsNamespace {
435
+ /** Create-only. `added` maps each shape key (or `shapes[i]`) and `arrows[i]` to its element id. */
436
+ create(args: BoardCreateArgs): Promise<BoardAdded>;
437
+ get(args: BoardRef & { detail?: "summary" }): Promise<BoardElements<BoardElementSummary>>;
438
+ /** Raw Excalidraw elements (live only) instead of summaries. */
439
+ get(args: BoardRef & { detail: "full" }): Promise<BoardElements<Record<string, unknown>>>;
440
+ list(args?: BoardListArgs): Promise<BoardList>;
441
+ /** Arrows bind both ends to shapes. */
442
+ addElements(args: BoardRef & BoardAddArgs): Promise<BoardAdded>;
443
+ updateElements(args: BoardPatchArgs): Promise<BoardResult & { updated: string[] }>;
444
+ /** Sets `isDeleted: true`; a shape takes its label with it and unbinds its arrows. */
445
+ removeElements(args: BoardRemoveArgs): Promise<BoardResult & { removed: string[] }>;
446
+ }
447
+
177
448
  export interface SwarmSdk {
178
449
  // --- memory ---
179
450
  memory_search(args: {
@@ -265,6 +536,38 @@ declare module "swarm-sdk" {
265
536
  state?: unknown;
266
537
  }): Promise<unknown>;
267
538
  room_decode(args: { value: unknown }): Promise<unknown>;
539
+ // --- primitive objects (prefer ctx.objects.*, which unwraps and throws) ---
540
+ objects_create(args: {
541
+ kind: PrimitiveObjectKind;
542
+ path: string;
543
+ title?: string;
544
+ }): Promise<unknown>;
545
+ objects_get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<unknown>;
546
+ objects_list(args?: {
547
+ kind?: PrimitiveObjectKind;
548
+ prefix?: string;
549
+ limit?: number;
550
+ offset?: number;
551
+ }): Promise<unknown>;
552
+ objects_reindex(args?: PrimitiveReindexArgs): Promise<unknown>;
553
+ // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
554
+ sheets_create(args: SheetCreateArgs): Promise<unknown>;
555
+ sheets_get(args: SheetRef): Promise<unknown>;
556
+ sheets_list(args?: { prefix?: string; limit?: number; offset?: number }): Promise<unknown>;
557
+ sheets_getRange(args: SheetRangeArgs & { formulas?: boolean }): Promise<unknown>;
558
+ sheets_setRange(args: SheetRangeArgs & { values: SheetCellInput[][] }): Promise<unknown>;
559
+ sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
560
+ sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
561
+ sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
562
+ sheets_importXlsx(args: SheetImportXlsxArgs): Promise<unknown>;
563
+ sheets_exportXlsx(args: SheetExportXlsxArgs): Promise<unknown>;
564
+ // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
565
+ boards_create(args: BoardCreateArgs): Promise<unknown>;
566
+ boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
567
+ boards_list(args?: BoardListArgs): Promise<unknown>;
568
+ boards_addElements(args: BoardRef & BoardAddArgs): Promise<unknown>;
569
+ boards_updateElements(args: BoardPatchArgs): Promise<unknown>;
570
+ boards_removeElements(args: BoardRemoveArgs): Promise<unknown>;
268
571
  // --- repos ---
269
572
  repo_list(args?: Record<string, unknown>): Promise<unknown>;
270
573
  // --- schedules ---
@@ -913,6 +1216,13 @@ declare module "swarm-sdk" {
913
1216
  sh(command: string, options?: ScriptShOptions): Promise<ScriptShResult>;
914
1217
  stdlib: ScriptStdlib;
915
1218
  logger: ScriptLogger;
1219
+ // Each SDK_NAMESPACES entry (src/scripts-runtime/sdk-allowlist.ts) needs a typed `<ns>` key here.
1220
+ /** Primitive objects on your default agent-fs drive (object-* tools). */
1221
+ objects: ObjectsNamespace;
1222
+ /** Sheets on your default agent-fs drive (sheet-* tools). */
1223
+ sheets: SheetsNamespace;
1224
+ /** Excalidraw boards on your default agent-fs drive (board-* tools). */
1225
+ boards: BoardsNamespace;
916
1226
  }
917
1227
 
918
1228
  /**
package/src/server.ts CHANGED
@@ -24,6 +24,14 @@ import { registerAppRollbackTool } from "./tools/app-rollback";
24
24
  import { registerAppRowTools } from "./tools/app-rows";
25
25
  import { registerAppSyncTool } from "./tools/app-sync";
26
26
  import { registerAppUpsertTool } from "./tools/app-upsert";
27
+ import {
28
+ registerBoardAddElementsTool,
29
+ registerBoardCreateTool,
30
+ registerBoardGetTool,
31
+ registerBoardListTool,
32
+ registerBoardRemoveElementsTool,
33
+ registerBoardUpdateElementsTool,
34
+ } from "./tools/boards";
27
35
  import { registerCancelApprovalRequestTool } from "./tools/cancel-approval-request";
28
36
  import { registerCancelTaskTool } from "./tools/cancel-task";
29
37
  import { registerChatOpenDmTool } from "./tools/chat-open-dm";
@@ -89,6 +97,12 @@ import { registerCheckModelProfileTool } from "./tools/model-profiles/check-mode
89
97
  import { registerListModelProfilesTool } from "./tools/model-profiles/list-model-profiles";
90
98
  import { registerMyAgentInfoTool } from "./tools/my-agent-info";
91
99
  import { registerGetOauthAccessTokenTool } from "./tools/oauth-access-token";
100
+ import {
101
+ registerObjectCreateTool,
102
+ registerObjectGetTool,
103
+ registerObjectListTool,
104
+ registerObjectReindexTool,
105
+ } from "./tools/objects";
92
106
  import { registerPollTaskTool } from "./tools/poll-task";
93
107
  import { registerPostMessageTool } from "./tools/post-message";
94
108
  // Prompt template tools
@@ -144,6 +158,18 @@ import { registerScriptRunsTools } from "./tools/script-runs";
144
158
  import { registerScriptSearchTool } from "./tools/script-search";
145
159
  import { registerScriptUpsertTool } from "./tools/script-upsert";
146
160
  import { registerSendTaskTool } from "./tools/send-task";
161
+ import {
162
+ registerSheetAddTabTool,
163
+ registerSheetAppendRowsTool,
164
+ registerSheetClearRangeTool,
165
+ registerSheetCreateTool,
166
+ registerSheetExportXlsxTool,
167
+ registerSheetGetRangeTool,
168
+ registerSheetGetTool,
169
+ registerSheetImportXlsxTool,
170
+ registerSheetListTool,
171
+ registerSheetSetRangeTool,
172
+ } from "./tools/sheets";
147
173
  // Skills capability
148
174
  import {
149
175
  registerSkillCreateTool,
@@ -245,6 +271,7 @@ export const ALL_CAPABILITIES = [
245
271
  "kapso",
246
272
  "chat-sdk",
247
273
  "swarm-x",
274
+ "primitives",
248
275
  ] as const;
249
276
 
250
277
  type CAPABILITIES_T = (typeof ALL_CAPABILITIES)[number];
@@ -276,6 +303,7 @@ const DEFAULT_CAPABILITIES: string = [
276
303
  // "agentmail",
277
304
  // "kapso",
278
305
  // "chat-sdk", (added by getEnabledCapabilities when CHAT_SDK_ENABLED is true)
306
+ // "primitives", (scripts still reach object-* through the full-surface bridge)
279
307
  ].join(",");
280
308
 
281
309
  // Note: unknown names are kept (they never match hasCapability); workers
@@ -685,6 +713,30 @@ export async function createServer(
685
713
  registerRoomDecodeTool(server);
686
714
  }
687
715
 
716
+ // Primitives capability: object-*, sheet-* and board-* tools over agent-fs files (src/be/primitives/).
717
+ if (hasCapability("primitives")) {
718
+ registerObjectCreateTool(server);
719
+ registerObjectGetTool(server);
720
+ registerObjectListTool(server);
721
+ registerObjectReindexTool(server);
722
+ registerSheetCreateTool(server);
723
+ registerSheetGetTool(server);
724
+ registerSheetListTool(server);
725
+ registerSheetGetRangeTool(server);
726
+ registerSheetSetRangeTool(server);
727
+ registerSheetAppendRowsTool(server);
728
+ registerSheetClearRangeTool(server);
729
+ registerSheetAddTabTool(server);
730
+ registerSheetImportXlsxTool(server);
731
+ registerSheetExportXlsxTool(server);
732
+ registerBoardCreateTool(server);
733
+ registerBoardGetTool(server);
734
+ registerBoardListTool(server);
735
+ registerBoardAddElementsTool(server);
736
+ registerBoardUpdateElementsTool(server);
737
+ registerBoardRemoveElementsTool(server);
738
+ }
739
+
688
740
  // Slack capability - Slack integration tools (no-op if Slack is not configured)
689
741
  if (hasCapability("slack")) {
690
742
  registerSlackReplyTool(server);
@@ -138,11 +138,12 @@ export interface SlackParticipantResolution {
138
138
  *
139
139
  * 1. Existing `(slack, <userId>)` alias, else the Slack profile email.
140
140
  * 2. A company-domain email links or creates the user (`role: "member"`);
141
- * any other email links an existing user and never creates one.
141
+ * any other email links an existing user and never creates one. A sender
142
+ * from another Slack team is never linked by email.
142
143
  * 3. No email: recorded in the unmapped tracker, trust `unknown`.
143
144
  *
144
- * Trust: `users.metadata.audience` wins; then another Slack team (`userTeam`
145
- * differs from `ourTeamId`) is external; then the email domain decides, and
145
+ * Trust: `users.metadata.audience` wins; then another Slack team (see
146
+ * `isOurSlackTeam`) is external; then the email domain decides, and
146
147
  * no email is `unknown`. With no company domains configured, linked users are
147
148
  * internal and nobody is created.
148
149
  */
@@ -153,20 +154,24 @@ export async function resolveSlackParticipant(
153
154
  sampleEventType: string;
154
155
  sampleContext: string;
155
156
  userTeam?: string;
156
- ourTeamId?: string;
157
157
  },
158
158
  ): Promise<SlackParticipantResolution> {
159
159
  const domains = getCompanyEmailDomains();
160
- const foreignTeam =
161
- !!eventContext.userTeam &&
162
- !!eventContext.ourTeamId &&
163
- eventContext.userTeam !== eventContext.ourTeamId;
160
+ const sameTeam = eventContext.userTeam
161
+ ? await isOurSlackTeam(client, eventContext.userTeam, slackUserId)
162
+ : undefined;
163
+ const foreignTeam = sameTeam === false;
164
164
 
165
165
  let user = await findUserByExternalId("slack", slackUserId);
166
166
  const email = user?.email || (await enrichSlackUserEmail(client, slackUserId));
167
167
 
168
- if (!user && email) {
169
- if (!foreignTeam && isCompanyEmail(email, domains)) {
168
+ // Another team's profile email is set by that team, not verified as owned by
169
+ // this sender, so it never links to an existing user. An operator can link
170
+ // the alias by hand. With our own team unknown (`auth.test` failed), a sender
171
+ // that carries a team is not linked either; trust below still reads the email.
172
+ const linkable = !eventContext.userTeam || sameTeam === true;
173
+ if (!user && email && linkable) {
174
+ if (isCompanyEmail(email, domains)) {
170
175
  // Pull the cached name back out for the user-row hints. The kv read is
171
176
  // cheap (single primary-key lookup) and avoids a second `users.info`.
172
177
  const cached = await getKv(ENRICHMENT_NAMESPACE, slackUserId);
@@ -228,26 +233,81 @@ export async function resolveSlackUserId(
228
233
  // email must not get a member row.
229
234
  eventContext: { sampleEventType: string; sampleContext: string; userTeam: string | undefined },
230
235
  ): Promise<string | undefined> {
231
- const ourTeamId = eventContext.userTeam ? await getOurSlackTeamId(client) : undefined;
232
- return (await resolveSlackParticipant(client, slackUserId, { ...eventContext, ourTeamId }))
233
- .userId;
236
+ return (await resolveSlackParticipant(client, slackUserId, eventContext)).userId;
234
237
  }
235
238
 
236
- /** Our own Slack team id (`auth.test`), cached per process. */
237
- let cachedTeamId: string | undefined;
238
- export async function getOurSlackTeamId(client: WebClient): Promise<string | undefined> {
239
- if (cachedTeamId) return cachedTeamId;
239
+ interface OurSlackTeam {
240
+ teamId?: string;
241
+ enterpriseId?: string;
242
+ /** Installed on the whole Enterprise Grid org, not one workspace. */
243
+ orgInstall: boolean;
244
+ }
245
+
246
+ /** Our own Slack team (`auth.test`), cached per process once it names a team. */
247
+ let cachedTeam: OurSlackTeam | undefined;
248
+ async function getOurSlackTeam(client: WebClient): Promise<OurSlackTeam | undefined> {
249
+ if (cachedTeam) return cachedTeam;
240
250
  try {
241
- cachedTeamId = ((await client.auth.test()).team_id as string | undefined) ?? undefined;
251
+ const result = await client.auth.test();
252
+ const teamId = result.team_id || undefined;
253
+ const enterpriseId = result.enterprise_id || undefined;
254
+ // Slack does not document `team_id` for an org-wide install; it may be absent or
255
+ // the enterprise id. Either way a sender's `user_team` is a workspace id.
256
+ const orgInstall =
257
+ result.is_enterprise_install === true ||
258
+ (!!enterpriseId && (!teamId || teamId === enterpriseId));
259
+ if (teamId || enterpriseId) cachedTeam = { teamId, enterpriseId, orgInstall };
242
260
  } catch (error) {
243
261
  console.error("[Slack] auth.test failed while reading the team id:", error);
244
262
  }
245
- return cachedTeamId;
263
+ return cachedTeam;
246
264
  }
247
265
 
248
- /** Reset the team-id cache between tests. */
266
+ /** Reset the team cache between tests. */
249
267
  export function resetSlackTeamIdCacheForTesting(): void {
250
- cachedTeamId = undefined;
268
+ cachedTeam = undefined;
269
+ }
270
+
271
+ /**
272
+ * A Slack user's workspace (`users.info` `user.team_id`) and Enterprise Grid org, or
273
+ * `undefined` when the lookup fails.
274
+ * shortcut: uncached, as it runs only for events without `user_team` and org-wide
275
+ * installs; cache it next to the email if `users.info` rate limits show up.
276
+ */
277
+ export async function getSlackUserTeam(
278
+ client: WebClient,
279
+ slackUserId: string,
280
+ ): Promise<{ teamId?: string; enterpriseId?: string } | undefined> {
281
+ try {
282
+ const { user } = await client.users.info({ user: slackUserId });
283
+ if (!user) return undefined;
284
+ return {
285
+ teamId: user.team_id || undefined,
286
+ enterpriseId: user.enterprise_user?.enterprise_id || undefined,
287
+ };
288
+ } catch (error) {
289
+ console.error(`[Slack] users.info failed while reading the team of ${slackUserId}:`, error);
290
+ return undefined;
291
+ }
292
+ }
293
+
294
+ /**
295
+ * Whether a sender on Slack team `userTeam` is on our Slack team: `undefined` when
296
+ * our own team is unknown (`auth.test` failed). A workspace install compares team
297
+ * ids. An org-wide install compares the sender's Enterprise Grid org, and a sender
298
+ * whose org cannot be read is not ours.
299
+ */
300
+ export async function isOurSlackTeam(
301
+ client: WebClient,
302
+ userTeam: string,
303
+ slackUserId: string,
304
+ ): Promise<boolean | undefined> {
305
+ const ours = await getOurSlackTeam(client);
306
+ if (!ours) return undefined;
307
+ if (userTeam === ours.teamId) return true;
308
+ if (!ours.orgInstall) return false;
309
+ const sender = await getSlackUserTeam(client, slackUserId);
310
+ return !!sender?.enterpriseId && sender.enterpriseId === ours.enterpriseId;
251
311
  }
252
312
 
253
313
  /**
@@ -21,6 +21,7 @@ import {
21
21
  isBotMessage,
22
22
  isSwarmThreadRoot,
23
23
  type isUserAllowed,
24
+ LOOKUP_USER_TEAM,
24
25
  registerMessageHandler,
25
26
  type UserFilterConfig,
26
27
  } from "./handlers";
@@ -192,7 +193,8 @@ describe("checkUserAccess", () => {
192
193
 
193
194
  describe("isUserAllowed", () => {
194
195
  const usersInfo = mock(async () => ({ ok: true, user: {} }));
195
- const client = { users: { info: usersInfo } } as never;
196
+ const authTest = mock(async () => ({ ok: true, team_id: "T_OURS" }));
197
+ const client = { auth: { test: authTest }, users: { info: usersInfo } } as never;
196
198
  let enrichSpy: ReturnType<typeof spyOn<typeof slackEnrichModule, "enrichSlackUserEmail">>;
197
199
  let logSpy: ReturnType<typeof spyOn<typeof console, "log">>;
198
200
 
@@ -288,12 +290,63 @@ describe("isUserAllowed", () => {
288
290
  expect(loggedLines()).toEqual([]);
289
291
  });
290
292
 
291
- test("denies and logs a domain that is not allowed", async () => {
293
+ test("denies and logs a domain that is not allowed, or a sender from another team", async () => {
292
294
  enrichSpy.mockResolvedValue("person@evil.com");
293
295
  const allowed = await loadIsUserAllowed(env);
294
296
  expect(await allowed(client, "U_OTHER")).toBe(false);
297
+
298
+ // An allowed domain admits a sender from this team, never one from another team.
299
+ slackEnrichModule.resetSlackTeamIdCacheForTesting();
300
+ enrichSpy.mockResolvedValue("person@company.com");
301
+ expect(await allowed(client, "U_SAME", "T_OURS")).toBe(true);
302
+ expect(await allowed(client, "U_PARTNER", "T_PARTNER")).toBe(false);
303
+
304
+ // An event with no `user_team` (Work Object details) reads the team from users.info.
305
+ const teams: Record<string, { team_id?: string; enterprise_user?: object }> = {
306
+ U_SAME: { team_id: "T_OURS" },
307
+ U_PARTNER: { team_id: "T_PARTNER" },
308
+ U_GRID: { team_id: "T_WS2", enterprise_user: { enterprise_id: "E_ORG" } },
309
+ U_GUEST: { team_id: "T_GUEST", enterprise_user: { enterprise_id: "E_GUEST" } },
310
+ };
311
+ usersInfo.mockImplementation((async ({ user }: { user: string }) => {
312
+ if (!teams[user]) throw new Error("users.info failed");
313
+ return { ok: true, user: teams[user] };
314
+ }) as never);
315
+ try {
316
+ expect(await allowed(client, "U_SAME", LOOKUP_USER_TEAM)).toBe(true);
317
+ expect(await allowed(client, "U_PARTNER", LOOKUP_USER_TEAM)).toBe(false);
318
+ expect(await allowed(client, "U_GONE", LOOKUP_USER_TEAM)).toBe(false);
319
+
320
+ // auth.test failed: our team is unknown, so no team matches it.
321
+ slackEnrichModule.resetSlackTeamIdCacheForTesting();
322
+ authTest.mockImplementationOnce(async () => {
323
+ throw new Error("auth.test failed");
324
+ });
325
+ expect(await allowed(client, "U_SAME", LOOKUP_USER_TEAM)).toBe(false);
326
+
327
+ // Org-wide install: auth.test may name the org, and senders carry a workspace id,
328
+ // so the sender's org decides.
329
+ slackEnrichModule.resetSlackTeamIdCacheForTesting();
330
+ authTest.mockImplementationOnce(async () => ({
331
+ ok: true,
332
+ team_id: "E_ORG",
333
+ enterprise_id: "E_ORG",
334
+ is_enterprise_install: true,
335
+ }));
336
+ expect(await allowed(client, "U_GRID", "T_WS2")).toBe(true);
337
+ expect(await allowed(client, "U_GRID", LOOKUP_USER_TEAM)).toBe(true);
338
+ expect(await allowed(client, "U_GUEST", "T_GUEST")).toBe(false);
339
+ } finally {
340
+ usersInfo.mockImplementation(async () => ({ ok: true, user: {} }));
341
+ slackEnrichModule.resetSlackTeamIdCacheForTesting();
342
+ }
295
343
  expect(loggedLines()).toEqual([
296
344
  '[Slack] User U_OTHER email domain "evil.com" not in allowed list',
345
+ "[Slack] User U_PARTNER is from another Slack team, denying email-domain access",
346
+ "[Slack] User U_PARTNER is from another Slack team, denying email-domain access",
347
+ "[Slack] User U_GONE has no readable Slack team, denying email-domain access",
348
+ "[Slack] User U_SAME: our own Slack team is unknown, denying email-domain access",
349
+ "[Slack] User U_GUEST is from another Slack team, denying email-domain access",
297
350
  ]);
298
351
  });
299
352
  });