@desplega.ai/agent-swarm 2.11.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-4nxq386s.js → actions-c4chgxp6.js} +24 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-hn5fftf5.js} +5 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-3g6yc8nv.js} +7 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-cpjgpjvp.js} +24 -22
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-hce1av1h.js} +1 -1
  10. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-bztbxc4z.js} +1 -1
  11. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-d7xcym0j.js} +1 -1
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-arrkbe8t.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-ykpyr5p8.js} +8 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-trd59v7b.js} +4 -4
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-yjcze0j1.js} +10 -10
  19. package/dist/{cli-2gvdvsxj.js → cli-01tvvtad.js} +63 -60
  20. package/dist/{cli-rhsc2zyx.js → cli-04zc3f7b.js} +1 -1
  21. package/dist/{cli-p1a4khta.js → cli-0k1a0sde.js} +6 -6
  22. package/dist/{cli-atm0hkes.js → cli-0pp1yjg2.js} +4 -4
  23. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  24. package/dist/{cli-zhn4r1rz.js → cli-12vek61e.js} +72 -49
  25. package/dist/{cli-j2r1apqm.js → cli-1htmtqc2.js} +45 -44
  26. package/dist/{cli-a6q6x15h.js → cli-2amwhyv2.js} +8 -5
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-a02habn6.js → cli-2tw284hj.js} +2 -2
  29. package/dist/{cli-nc39ym5q.js → cli-39qm0rtm.js} +6 -6
  30. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  31. package/dist/cli-52nfye5j.js +673 -0
  32. package/dist/cli-55tc8cj4.js +252 -0
  33. package/dist/cli-5r95eqbh.js +186 -0
  34. package/dist/{cli-892y3vfp.js → cli-5tg94mdw.js} +7 -7
  35. package/dist/{cli-ynph3b70.js → cli-5x03v6en.js} +8 -8
  36. package/dist/{cli-1h4njv9y.js → cli-5z0g0e8v.js} +11 -2
  37. package/dist/{cli-6a3j25xd.js → cli-72yms3ey.js} +16 -16
  38. package/dist/{cli-h2qtafm4.js → cli-73q4g5nx.js} +17 -17
  39. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  40. package/dist/{cli-9g12h1aq.js → cli-7yn42w6m.js} +1 -1
  41. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  42. package/dist/{cli-4aswccje.js → cli-9qe5y107.js} +2 -2
  43. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  44. package/dist/{cli-mhrr4d5b.js → cli-agjbj5x0.js} +1 -1
  45. package/dist/{cli-hnh8erra.js → cli-b93d81yg.js} +2 -2
  46. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  47. package/dist/{cli-b82a13ga.js → cli-bp6k9acz.js} +17 -21
  48. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  49. package/dist/{cli-t2s7j5cy.js → cli-bz97ff9n.js} +2 -2
  50. package/dist/{cli-0bgj4rh5.js → cli-c7j31hq9.js} +3 -3
  51. package/dist/{cli-p8zqbbt1.js → cli-cah298e5.js} +1 -1
  52. package/dist/{cli-9knhkkgr.js → cli-cjqyse9q.js} +3 -3
  53. package/dist/{cli-tb4j757d.js → cli-dkvtfgn4.js} +6 -6
  54. package/dist/{cli-14xdms9a.js → cli-e3ahxq5y.js} +6 -6
  55. package/dist/{cli-6n7y5ypy.js → cli-e8n0hdzd.js} +1 -1
  56. package/dist/{cli-q71g5q39.js → cli-en6dmkxd.js} +3 -3
  57. package/dist/{cli-xqbqwpxr.js → cli-eq4kew31.js} +9 -9
  58. package/dist/{cli-4kzp7r0q.js → cli-eqq0hwvx.js} +3 -3
  59. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  60. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  61. package/dist/{cli-bq97k63w.js → cli-fxd1mwtr.js} +2 -2
  62. package/dist/{cli-kbm659dk.js → cli-fy4gb74g.js} +2 -2
  63. package/dist/{cli-djt6wmrc.js → cli-fyaq4zdv.js} +6 -6
  64. package/dist/{cli-raqw9fw9.js → cli-gfy6hbd9.js} +6 -6
  65. package/dist/{cli-s9twe4x0.js → cli-h70a2mxy.js} +13 -8
  66. package/dist/cli-hbvgzjq4.js +69 -0
  67. package/dist/{cli-vy3fn0mz.js → cli-hhc47ack.js} +4 -4
  68. package/dist/{cli-m00c47q6.js → cli-j5gtytvg.js} +54 -24
  69. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  70. package/dist/{cli-yzxqwcvq.js → cli-k5jx8jya.js} +10 -3
  71. package/dist/{cli-rytq7dm2.js → cli-krbcr00p.js} +3 -3
  72. package/dist/{cli-453497a0.js → cli-kwr5qv5g.js} +2 -2
  73. package/dist/{cli-czvvnfr9.js → cli-m5qtmrbc.js} +2 -2
  74. package/dist/{cli-cstggwq7.js → cli-ma9ys8rt.js} +2 -2
  75. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  76. package/dist/{cli-wz4e5am2.js → cli-mcymtvwn.js} +320 -70
  77. package/dist/{cli-2aacfdcn.js → cli-mq2fbgva.js} +64 -3
  78. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  79. package/dist/{cli-k4r5sfaj.js → cli-n8f0fs3c.js} +4 -4
  80. package/dist/{cli-f8yhybxr.js → cli-nja15knq.js} +3 -3
  81. package/dist/{cli-6tvh1fwq.js → cli-pe3yxedk.js} +3 -3
  82. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  83. package/dist/{cli-n6ygvrrm.js → cli-q2dywc8h.js} +4 -4
  84. package/dist/{cli-8zmpwe79.js → cli-q8tc22bj.js} +5 -5
  85. package/dist/{cli-yvzxbztc.js → cli-r0mz92by.js} +2 -2
  86. package/dist/{cli-v3zcnr8g.js → cli-r14ac1y0.js} +1 -1
  87. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  88. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  89. package/dist/{cli-27fat7st.js → cli-sv2r3bw8.js} +7 -7
  90. package/dist/{cli-zb1hff00.js → cli-t75xngj1.js} +9 -9
  91. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  92. package/dist/{cli-5ptj757f.js → cli-tm60vtax.js} +1 -1
  93. package/dist/{cli-rpmw4fsv.js → cli-v9ya390t.js} +12 -12
  94. package/dist/{cli-075ccjh6.js → cli-wvjqaqcp.js} +2607 -65
  95. package/dist/{cli-2jtfm8kh.js → cli-xf4z5bdn.js} +4 -4
  96. package/dist/{cli-4g323fjh.js → cli-xm34qj8m.js} +2 -2
  97. package/dist/{cli-f7dhm7hh.js → cli-ya3kf4gs.js} +1 -1
  98. package/dist/{cli-rwgwen5v.js → cli-yegz2g06.js} +4 -4
  99. package/dist/{cli-nbakg5xh.js → cli-yfpc6qy9.js} +3 -3
  100. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  101. package/dist/cli.js +24 -21
  102. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-wc6e4wct.js} +8 -8
  103. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  104. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ppfgjd97.js} +9 -9
  105. package/dist/{commands-ctey7tr5.js → commands-tsv2vx5b.js} +3 -3
  106. package/dist/{controller-rqhbppg9.js → controller-ye4sdwsy.js} +4 -4
  107. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-zn4dg69h.js} +25 -23
  108. package/dist/core-dxcy02sc.js +41 -0
  109. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-q2g9vwts.js} +2 -2
  110. package/dist/{db-2ah39cyx.js → db-3r1fyr2n.js} +6 -2
  111. package/dist/{db-p5drc1d1.js → db-g111qn9j.js} +3 -3
  112. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  113. package/dist/{dispatcher-x6w14pde.js → dispatcher-4q8s0mx8.js} +22 -20
  114. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  115. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-mmcw1z5s.js} +2 -2
  116. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  117. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  118. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-04ke6hcp.js} +1 -1
  119. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-kcdn52vz.js} +6 -6
  120. package/dist/{embeddings-0sxb1d2h.js → embeddings-jnzcd91a.js} +1 -1
  121. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  122. package/dist/{execute-6m1ex8ce.js → execute-74amghty.js} +1 -1
  123. package/dist/{external-channel-ezer7pk0.js → external-channel-v9zgxnxz.js} +2 -2
  124. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  125. package/dist/grok-adapter-t6m74fb1.js +19 -0
  126. package/dist/handlers-9kwcrc4k.js +38 -0
  127. package/dist/{heartbeat-6c4fr49t.js → heartbeat-p8pk1msj.js} +25 -23
  128. package/dist/{hook-t1c5avbv.js → hook-k1h73zd7.js} +5 -5
  129. package/dist/{hook-02rt5tvq.js → hook-p5reemds.js} +7 -7
  130. package/dist/{http-qa3h32a1.js → http-ms1z5xxy.js} +565 -141
  131. package/dist/index-23cdfzr6.js +39 -0
  132. package/dist/{index-kqv9ebfj.js → index-76zzxtzf.js} +1 -1
  133. package/dist/{index-e42j998x.js → index-fbkqhvvj.js} +38 -19
  134. package/dist/index-g7kkjs5b.js +38 -0
  135. package/dist/{index-qpjk2hxk.js → index-gjn6qfgn.js} +1 -1
  136. package/dist/{index-akbgsdhh.js → index-kn63q1gr.js} +26 -24
  137. package/dist/index-stk36pa5.js +43 -0
  138. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  139. package/dist/{keepalive-jmf6pn8c.js → keepalive-031js8jz.js} +4 -4
  140. package/dist/lead-mfggjtfk.js +77 -0
  141. package/dist/{maintenance-g7v15tj1.js → maintenance-sq9v3qx9.js} +1 -1
  142. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  143. package/dist/object-webhooks-r24wwb5y.js +21 -0
  144. package/dist/{onboard-m3fedypq.js → onboard-p25yhh7t.js} +5 -5
  145. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-wcjc4zdk.js} +7 -7
  146. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-ff1gf20m.js} +2 -2
  147. package/dist/{pending-fwj2fatd.js → pending-hxj5yatb.js} +23 -21
  148. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-vkp4zz7p.js} +12 -12
  149. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-9w7gx41w.js} +2 -2
  150. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-84aw10nz.js} +3 -3
  151. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-hz74vckp.js} +2 -2
  152. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  153. package/dist/{render-v2-j7qggj8h.js → render-v2-nrdkg9gf.js} +5 -5
  154. package/dist/{resume-hj1mn65y.js → resume-s6ey36rh.js} +9 -9
  155. package/dist/{runtime-z31mdsgv.js → runtime-x0b4pyam.js} +1 -1
  156. package/dist/{session-access-w38fh09a.js → session-access-xv49tk14.js} +4 -4
  157. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-r5j988ah.js} +3 -3
  158. package/dist/{setup-dsqmpfcr.js → setup-mj0krk1p.js} +1 -1
  159. package/dist/thread-buffer-temgaqsy.js +41 -0
  160. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-cbrsfaar.js} +2 -2
  161. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  162. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-ns0ryw05.js} +3 -3
  163. package/dist/{work-objects-4ahy5es5.js → work-objects-pydhzast.js} +25 -23
  164. package/dist/worker-efcemc22.js +77 -0
  165. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-9z2xec5e.js} +22 -20
  166. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  167. package/openapi.json +788 -253
  168. package/package.json +8 -5
  169. package/src/azure-devops/auth.ts +2 -3
  170. package/src/be/agent-fs-identity.ts +46 -0
  171. package/src/be/agent-history.ts +215 -0
  172. package/src/be/db/agents.ts +34 -12
  173. package/src/be/db/tasks/write.ts +2 -2
  174. package/src/be/db.ts +2 -0
  175. package/src/be/migrations/332_primitive_objects.sql +31 -0
  176. package/src/be/migrations/334_agent_history.sql +23 -0
  177. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  178. package/src/be/primitives/boards/elements.ts +717 -0
  179. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  180. package/src/be/primitives/boards/service.ts +121 -0
  181. package/src/be/primitives/object-webhooks.ts +348 -0
  182. package/src/be/primitives/objects.ts +686 -0
  183. package/src/be/primitives/sheets/a1.ts +136 -0
  184. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  185. package/src/be/primitives/sheets/engine.ts +199 -0
  186. package/src/be/primitives/sheets/format.ts +106 -0
  187. package/src/be/primitives/sheets/service.ts +415 -0
  188. package/src/be/primitives/write-object.ts +83 -0
  189. package/src/be/script-credential-broker.ts +8 -27
  190. package/src/be/scripts/typecheck.ts +216 -0
  191. package/src/be/seed/agent-fs-provision.ts +18 -0
  192. package/src/be/users.ts +19 -0
  193. package/src/commands/onboard/agent-fs-version.ts +1 -1
  194. package/src/commands/onboard/steps/harness.tsx +1 -1
  195. package/src/commands/provider-credentials.ts +1 -0
  196. package/src/e2b/env.ts +3 -1
  197. package/src/fs/agent-fs-provider.ts +33 -2
  198. package/src/gitlab/auth.ts +3 -4
  199. package/src/heartbeat/heartbeat.ts +11 -11
  200. package/src/http/agent-lifecycle.ts +152 -0
  201. package/src/http/agents.ts +12 -0
  202. package/src/http/all-routes.ts +2 -0
  203. package/src/http/auth.ts +2 -1
  204. package/src/http/index.ts +15 -0
  205. package/src/http/object-webhooks.ts +101 -0
  206. package/src/http/operator-actor.ts +2 -1
  207. package/src/http/sessions.ts +7 -0
  208. package/src/http/workflows.ts +32 -0
  209. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  210. package/src/providers/acp-targets.ts +2 -2
  211. package/src/providers/amp-adapter.ts +1 -1
  212. package/src/providers/opencode-adapter.ts +4 -1
  213. package/src/rbac/legacy-policy.ts +2 -0
  214. package/src/rbac/permissions.ts +5 -0
  215. package/src/script-workflows/guest-ctx.ts +32 -0
  216. package/src/script-workflows/workflow-ctx.ts +2 -0
  217. package/src/scripts-runtime/ctx.ts +9 -1
  218. package/src/scripts-runtime/executors/native.ts +106 -21
  219. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  220. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  221. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  222. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  223. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  224. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  225. package/src/server.ts +48 -0
  226. package/src/tests/agent-history.test.ts +313 -0
  227. package/src/tests/azure-devops-auth.test.ts +6 -0
  228. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  229. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  230. package/src/tests/credential-check.test.ts +12 -0
  231. package/src/tests/db-task-read-contract.test.ts +2 -0
  232. package/src/tests/db-task-write-contract.test.ts +2 -0
  233. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  234. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  235. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  236. package/src/tests/e2e-shards.test.ts +137 -0
  237. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  238. package/src/tests/extensions-heartbeat.test.ts +34 -0
  239. package/src/tests/gitlab-auth.test.ts +10 -0
  240. package/src/tests/heartbeat.test.ts +38 -0
  241. package/src/tests/http-api-integration.test.ts +0 -6
  242. package/src/tests/opencode-adapter.test.ts +11 -0
  243. package/src/tests/primitives-boards.test.ts +686 -0
  244. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  245. package/src/tests/primitives-objects.test.ts +248 -0
  246. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  247. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  248. package/src/tests/scripts-namespaces.test.ts +211 -0
  249. package/src/tests/secret-scrub-gate.test.ts +1 -0
  250. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  251. package/src/tests/secret-scrubber.test.ts +1 -1
  252. package/src/tests/session-tokens.test.ts +27 -0
  253. package/src/tests/sheet-engine.test.ts +58 -0
  254. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  255. package/src/tests/slack-read-boundaries.test.ts +4 -2
  256. package/src/tests/task-start-after-commit.test.ts +82 -0
  257. package/src/tests/ui-logs-parser.test.ts +67 -0
  258. package/src/tests/workflow-retry-v2.test.ts +101 -0
  259. package/src/tests/workflow-tla-races.test.ts +29 -0
  260. package/src/tools/boards.ts +260 -0
  261. package/src/tools/objects.ts +191 -0
  262. package/src/tools/sheets.ts +312 -0
  263. package/src/tools/slack-read.ts +10 -3
  264. package/src/tools/tool-config.ts +23 -0
  265. package/src/tools/workflows/create-workflow.ts +11 -1
  266. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  267. package/src/tools/workflows/patch-workflow.ts +4 -0
  268. package/src/tools/workflows/update-workflow.ts +17 -0
  269. package/src/types.ts +16 -0
  270. package/src/utils/sandboxed-process.ts +47 -2
  271. package/src/utils/secret-scrubber.ts +61 -6
  272. package/src/workflows/engine.ts +35 -21
  273. package/src/workflows/input.ts +29 -1
  274. package/src/workflows/patch-definition.ts +15 -1
  275. package/src/workflows/retry-poller.ts +15 -2
  276. package/src/workflows/validation.ts +10 -0
  277. package/templates/ai-toolbox.manifest.json +1 -1
  278. package/templates/skills/agent-browser/SKILL.md +1 -0
  279. package/templates/skills/agent-browser/content.md +1 -0
  280. package/templates/skills/pages/content.md +5 -0
  281. package/templates/skills/swarm-docs/content.md +6 -1
  282. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  283. package/templates/skills/swarm-scripts/content.md +1 -0
  284. package/templates/skills/tdd-planning/content.md +5 -2
  285. package/dist/acp-adapter-weaaxey3.js +0 -16
  286. package/dist/core-df1n049h.js +0 -39
  287. package/dist/fx-adapter-zwmps9re.js +0 -19
  288. package/dist/grok-adapter-q0avf919.js +0 -19
  289. package/dist/handlers-g5jq0e4q.js +0 -36
  290. package/dist/index-1f6m47mq.js +0 -37
  291. package/dist/index-1p1mpqda.js +0 -36
  292. package/dist/index-tnkd410q.js +0 -41
  293. package/dist/lead-m5e7xt93.js +0 -75
  294. package/dist/thread-buffer-nf55vwx3.js +0 -39
  295. package/dist/worker-ews1nyhw.js +0 -75
  296. package/src/slack/socket-mode-guard.test.ts +0 -25
  297. package/src/tests/agent-activity.test.ts +0 -247
  298. package/src/tests/agent-fs-live-url.test.ts +0 -55
  299. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  300. package/src/tests/approval-sweeps-config.test.ts +0 -47
  301. package/src/tests/cards.test.ts +0 -169
  302. package/src/tests/chat-sdk-facts.test.ts +0 -23
  303. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  304. package/src/tests/core-auth.test.ts +0 -156
  305. package/src/tests/date-utils.test.ts +0 -48
  306. package/src/tests/db-context-versions.test.ts +0 -37
  307. package/src/tests/db-runtime.test.ts +0 -132
  308. package/src/tests/enabled-capabilities.test.ts +0 -20
  309. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  310. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  311. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  312. package/src/tests/github-event-labels.test.ts +0 -24
  313. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  314. package/src/tests/http-log-scrubbing.test.ts +0 -123
  315. package/src/tests/http-semconv-attributes.test.ts +0 -92
  316. package/src/tests/identity.test.ts +0 -117
  317. package/src/tests/inbox-state.test.ts +0 -167
  318. package/src/tests/internal-ai/models.test.ts +0 -54
  319. package/src/tests/launch-password-rejection.test.ts +0 -140
  320. package/src/tests/list-total-cache.test.ts +0 -88
  321. package/src/tests/match-route.test.ts +0 -187
  322. package/src/tests/memory-feature-flags.test.ts +0 -45
  323. package/src/tests/memory-get-tool.test.ts +0 -269
  324. package/src/tests/memory-health-endpoint.test.ts +0 -78
  325. package/src/tests/memory-http-access.test.ts +0 -221
  326. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  327. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  328. package/src/tests/openai-embedding-provider.test.ts +0 -159
  329. package/src/tests/org-identity.test.ts +0 -44
  330. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  331. package/src/tests/pages-browser-sdk.test.ts +0 -76
  332. package/src/tests/pages-feedback-keys.test.ts +0 -121
  333. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  334. package/src/tests/pages-list-endpoint.test.ts +0 -148
  335. package/src/tests/pages-password-mode.test.ts +0 -266
  336. package/src/tests/pages-public-authed-401.test.ts +0 -103
  337. package/src/tests/pages-public-html.test.ts +0 -297
  338. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  339. package/src/tests/pages-view-count.test.ts +0 -245
  340. package/src/tests/prompt-templates-db.test.ts +0 -616
  341. package/src/tests/rbac-engine.test.ts +0 -742
  342. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  343. package/src/tests/route-def-find-route.test.ts +0 -192
  344. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  345. package/src/tests/schedule-validation-helper.test.ts +0 -51
  346. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  347. package/src/tests/scheduler-backoff.test.ts +0 -166
  348. package/src/tests/script-run-token.test.ts +0 -75
  349. package/src/tests/scripts-extract-signature.test.ts +0 -47
  350. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  351. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  352. package/src/tests/short-id.test.ts +0 -23
  353. package/src/tests/skill-files-http.test.ts +0 -222
  354. package/src/tests/skill-get-file-tool.test.ts +0 -110
  355. package/src/tests/skill-script-refs.test.ts +0 -63
  356. package/src/tests/skill-update-scope.test.ts +0 -252
  357. package/src/tests/skills-bundle.test.ts +0 -99
  358. package/src/tests/slack-app-icon.test.ts +0 -94
  359. package/src/tests/slack-assistant-comention.test.ts +0 -139
  360. package/src/tests/slack-delete.test.ts +0 -157
  361. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  362. package/src/tests/slack-manifest.test.ts +0 -23
  363. package/src/tests/slack-task-output.test.ts +0 -90
  364. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  365. package/src/tests/swarm-diff.test.ts +0 -728
  366. package/src/tests/task-lifecycle-events.test.ts +0 -53
  367. package/src/tests/template-asset-config.test.ts +0 -18
  368. package/src/tests/template-fetch.test.ts +0 -490
  369. package/src/tests/themes-page-theme.test.ts +0 -155
  370. package/src/tests/tool-annotations.test.ts +0 -442
  371. package/src/tests/tool-output-agent-id.test.ts +0 -202
  372. package/src/tests/update-profile-agentid.test.ts +0 -248
  373. package/src/tests/whoami-route.test.ts +0 -162
  374. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  375. package/src/tests/workflow-patch.test.ts +0 -169
  376. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  377. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  378. package/src/tests/workflow-step-claims.test.ts +0 -152
  379. package/src/tests/workflow-step-order.test.ts +0 -92
  380. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  381. package/src/tests/workflow-versions.test.ts +0 -240
  382. package/src/tests/workflow-wait.test.ts +0 -26
@@ -216,6 +216,236 @@ declare module "swarm-sdk" {
216
216
  state: unknown;
217
217
  }
218
218
 
219
+ export type PrimitiveObjectKind = "board" | "sheet";
220
+
221
+ export interface PrimitiveObject {
222
+ id: string;
223
+ kind: PrimitiveObjectKind;
224
+ orgId: string;
225
+ driveId: string;
226
+ /** agent-fs path, no leading slash. */
227
+ path: string;
228
+ title: string | null;
229
+ fileVersion: number | null;
230
+ ownerAgentId: string | null;
231
+ /** Set when agent-fs reported the file deleted. */
232
+ deletedAt: string | null;
233
+ createdAt: string;
234
+ updatedAt: string;
235
+ /** Live app link to the file. */
236
+ link: string | null;
237
+ }
238
+
239
+ export interface PrimitiveReindexReport {
240
+ scanned: number;
241
+ /** Files whose version matched the index: checked, not re-read. */
242
+ unchanged: number;
243
+ adopted: string[];
244
+ restored: string[];
245
+ missing: string[];
246
+ conflicts: Array<{ path: string; reason: string }>;
247
+ /** More files remain (at most 50 reads, 16 MiB or 20 s per call): run again. */
248
+ truncated: boolean;
249
+ /** Which limit cut this call short; null when the pass finished. */
250
+ cutBy: "files" | "reads" | "time" | "bytes" | null;
251
+ }
252
+
253
+ /**
254
+ * Primitive objects: agent-fs files on your default drive with a stable id.
255
+ * Calls run as your own agent-fs identity. Each method throws on a refusal.
256
+ */
257
+ export interface ObjectsNamespace {
258
+ /** Create-only. `board` writes an empty Excalidraw scene; the path must end in `.excalidraw`. */
259
+ create(args: {
260
+ kind: PrimitiveObjectKind;
261
+ path: string;
262
+ title?: string;
263
+ }): Promise<{ message: string; object: PrimitiveObject }>;
264
+ get(args: {
265
+ id?: string;
266
+ path?: string;
267
+ includeContent?: boolean;
268
+ }): Promise<{ message: string; object: PrimitiveObject; missing: boolean; content?: unknown }>;
269
+ list(args?: {
270
+ kind?: PrimitiveObjectKind;
271
+ prefix?: string;
272
+ limit?: number;
273
+ offset?: number;
274
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
275
+ /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
276
+ reindex(args?: {
277
+ kind?: PrimitiveObjectKind;
278
+ }): Promise<{ message: string } & PrimitiveReindexReport>;
279
+ }
280
+
281
+ /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
282
+ export type SheetCellInput = number | string | boolean | null;
283
+
284
+ /** Identify the sheet by `id` or `path`. */
285
+ export interface SheetRef {
286
+ id?: string;
287
+ path?: string;
288
+ }
289
+
290
+ export interface SheetRangeArgs extends SheetRef {
291
+ /** A1 range: `Tasks!B2:C3`, `B2`, or a whole column `'My tab'!A:A` (capped to the used range). */
292
+ range: string;
293
+ }
294
+
295
+ export interface SheetCreateArgs {
296
+ /** Create-only; must end in `.sheet.json`. Default is one tab `Sheet1`; `rows` seed a tab from A1. */
297
+ path: string;
298
+ title?: string;
299
+ tabs?: Array<{ name: string; rows?: SheetCellInput[][] }>;
300
+ }
301
+
302
+ export interface SheetTabSummary {
303
+ name: string;
304
+ rows: number;
305
+ cols: number;
306
+ freezeRows: number;
307
+ }
308
+
309
+ export interface SheetResult {
310
+ message: string;
311
+ /** agent-fs version after the call. */
312
+ version: number;
313
+ }
314
+
315
+ /**
316
+ * Sheets: `swarm-sheet/1` workbooks on your default agent-fs drive, recomputed by a spreadsheet engine.
317
+ * Writes retry on a concurrent edit, then throw. Each method throws on a refusal.
318
+ */
319
+ export interface SheetsNamespace {
320
+ create(
321
+ args: SheetCreateArgs,
322
+ ): Promise<{ message: string; object: PrimitiveObject; link: string | null }>;
323
+ get(
324
+ args: SheetRef,
325
+ ): Promise<SheetResult & { object: PrimitiveObject; tabs: SheetTabSummary[] }>;
326
+ list(args?: {
327
+ prefix?: string;
328
+ limit?: number;
329
+ offset?: number;
330
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
331
+ /** Cached values (at most 10,000 cells). `formulas: true` also returns formula text. */
332
+ getRange(
333
+ args: SheetRangeArgs & { formulas?: boolean },
334
+ ): Promise<
335
+ SheetResult & { range: string; values: SheetCellInput[][]; formulas?: SheetCellInput[][] }
336
+ >;
337
+ /** A single-cell `range` is the top-left corner; a larger one must match `values`. `'=` stores literal text beginning with `=`. */
338
+ setRange(
339
+ args: SheetRangeArgs & { values: SheetCellInput[][] },
340
+ ): Promise<SheetResult & { range: string; changed: number; recalculated: number }>;
341
+ appendRows(
342
+ args: SheetRef & { tab: string; rows: SheetCellInput[][] },
343
+ ): Promise<SheetResult & { range: string }>;
344
+ clearRange(args: SheetRangeArgs): Promise<SheetResult & { range: string; cleared: number }>;
345
+ addTab(
346
+ args: SheetRef & { name: string; after?: string },
347
+ ): Promise<SheetResult & { tabs: string[] }>;
348
+ }
349
+
350
+ /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
351
+ export type BoardColor =
352
+ | "blue"
353
+ | "green"
354
+ | "yellow"
355
+ | "red"
356
+ | "violet"
357
+ | "orange"
358
+ | "gray"
359
+ | "teal"
360
+ | (string & {});
361
+
362
+ export interface BoardShape {
363
+ /** Your name for the shape, so arrows in the same call can point at it. */
364
+ key?: string;
365
+ type: "rectangle" | "ellipse" | "diamond" | "text";
366
+ x?: number;
367
+ y?: number;
368
+ /** Minimum size; a shape grows to fit its label. */
369
+ width?: number;
370
+ height?: number;
371
+ /** Text inside the shape; required for `text`. */
372
+ label?: string;
373
+ color?: BoardColor;
374
+ }
375
+
376
+ /** `from` / `to`: a shape key from the same call or an existing element id. */
377
+ export interface BoardArrow {
378
+ from: string;
379
+ to: string;
380
+ label?: string;
381
+ }
382
+
383
+ export interface BoardElementPatch {
384
+ elementId: string;
385
+ /** An empty string removes a shape's label. */
386
+ label?: string;
387
+ x?: number;
388
+ y?: number;
389
+ width?: number;
390
+ height?: number;
391
+ color?: BoardColor;
392
+ }
393
+
394
+ export interface BoardElementSummary {
395
+ id: string;
396
+ type: string;
397
+ /** Free text, or a shape's label; null when it has none. */
398
+ text: string | null;
399
+ x: number;
400
+ y: number;
401
+ width: number;
402
+ height: number;
403
+ /** Arrow: [from, to] element ids (null when unbound). Shape: ids of its bound arrows. */
404
+ boundTo: Array<string | null>;
405
+ }
406
+
407
+ export type BoardLayout = "row" | "column" | "grid";
408
+ export type BoardRef = { id: string; path?: string } | { id?: string; path: string };
409
+
410
+ /** What a board call returns besides its own fields. */
411
+ export interface BoardResult {
412
+ message: string;
413
+ object: PrimitiveObject;
414
+ version: number | null;
415
+ }
416
+ export type BoardAdded = BoardResult & { added: Record<string, string> };
417
+ export type BoardElements<E> = BoardResult & { elements: E[] };
418
+ export interface BoardAddArgs {
419
+ shapes?: BoardShape[];
420
+ arrows?: BoardArrow[];
421
+ /** How shapes without x/y are placed, below existing content. Default `row`. */
422
+ layout?: BoardLayout;
423
+ }
424
+ export type BoardCreateArgs = BoardAddArgs & { path: string; title?: string };
425
+ export type BoardPatchArgs = BoardRef & { patches: BoardElementPatch[] };
426
+ export type BoardRemoveArgs = BoardRef & { elementIds: string[] };
427
+ export type BoardListArgs = { prefix?: string; limit?: number; offset?: number };
428
+ export type BoardList = { message: string; objects: PrimitiveObject[]; total: number };
429
+
430
+ /**
431
+ * Excalidraw boards (`.excalidraw`) on your default agent-fs drive, edited as
432
+ * element JSON. Writes guard on the file version and re-apply on a concurrent
433
+ * change. Each method throws on a refusal.
434
+ */
435
+ export interface BoardsNamespace {
436
+ /** Create-only. `added` maps each shape key (or `shapes[i]`) and `arrows[i]` to its element id. */
437
+ create(args: BoardCreateArgs): Promise<BoardAdded>;
438
+ get(args: BoardRef & { detail?: "summary" }): Promise<BoardElements<BoardElementSummary>>;
439
+ /** Raw Excalidraw elements (live only) instead of summaries. */
440
+ get(args: BoardRef & { detail: "full" }): Promise<BoardElements<Record<string, unknown>>>;
441
+ list(args?: BoardListArgs): Promise<BoardList>;
442
+ /** Arrows bind both ends to shapes. */
443
+ addElements(args: BoardRef & BoardAddArgs): Promise<BoardAdded>;
444
+ updateElements(args: BoardPatchArgs): Promise<BoardResult & { updated: string[] }>;
445
+ /** Sets `isDeleted: true`; a shape takes its label with it and unbinds its arrows. */
446
+ removeElements(args: BoardRemoveArgs): Promise<BoardResult & { removed: string[] }>;
447
+ }
448
+
219
449
  export interface SwarmSdk {
220
450
  // --- memory ---
221
451
  memory_search(args: {
@@ -307,6 +537,36 @@ declare module "swarm-sdk" {
307
537
  state?: unknown;
308
538
  }): Promise<unknown>;
309
539
  room_decode(args: { value: unknown }): Promise<unknown>;
540
+ // --- primitive objects (prefer ctx.objects.*, which unwraps and throws) ---
541
+ objects_create(args: {
542
+ kind: PrimitiveObjectKind;
543
+ path: string;
544
+ title?: string;
545
+ }): Promise<unknown>;
546
+ objects_get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<unknown>;
547
+ objects_list(args?: {
548
+ kind?: PrimitiveObjectKind;
549
+ prefix?: string;
550
+ limit?: number;
551
+ offset?: number;
552
+ }): Promise<unknown>;
553
+ objects_reindex(args?: { kind?: PrimitiveObjectKind }): Promise<unknown>;
554
+ // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
555
+ sheets_create(args: SheetCreateArgs): Promise<unknown>;
556
+ sheets_get(args: SheetRef): Promise<unknown>;
557
+ sheets_list(args?: { prefix?: string; limit?: number; offset?: number }): Promise<unknown>;
558
+ sheets_getRange(args: SheetRangeArgs & { formulas?: boolean }): Promise<unknown>;
559
+ sheets_setRange(args: SheetRangeArgs & { values: SheetCellInput[][] }): Promise<unknown>;
560
+ sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
561
+ sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
562
+ sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
563
+ // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
564
+ boards_create(args: BoardCreateArgs): Promise<unknown>;
565
+ boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
566
+ boards_list(args?: BoardListArgs): Promise<unknown>;
567
+ boards_addElements(args: BoardRef & BoardAddArgs): Promise<unknown>;
568
+ boards_updateElements(args: BoardPatchArgs): Promise<unknown>;
569
+ boards_removeElements(args: BoardRemoveArgs): Promise<unknown>;
310
570
  // --- repos ---
311
571
  repo_list(args?: Record<string, unknown>): Promise<unknown>;
312
572
  // --- schedules ---
@@ -955,6 +1215,13 @@ declare module "swarm-sdk" {
955
1215
  sh(command: string, options?: ScriptShOptions): Promise<ScriptShResult>;
956
1216
  stdlib: ScriptStdlib;
957
1217
  logger: ScriptLogger;
1218
+ // Each SDK_NAMESPACES entry (src/scripts-runtime/sdk-allowlist.ts) needs a typed `<ns>` key here.
1219
+ /** Primitive objects on your default agent-fs drive (object-* tools). */
1220
+ objects: ObjectsNamespace;
1221
+ /** Sheets on your default agent-fs drive (sheet-* tools). */
1222
+ sheets: SheetsNamespace;
1223
+ /** Excalidraw boards on your default agent-fs drive (board-* tools). */
1224
+ boards: BoardsNamespace;
958
1225
  }
959
1226
 
960
1227
  /**
@@ -174,6 +174,236 @@ 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
+ }
210
+
211
+ /**
212
+ * Primitive objects: agent-fs files on your default drive with a stable id.
213
+ * Calls run as your own agent-fs identity. Each method throws on a refusal.
214
+ */
215
+ export interface ObjectsNamespace {
216
+ /** Create-only. `board` writes an empty Excalidraw scene; the path must end in `.excalidraw`. */
217
+ create(args: {
218
+ kind: PrimitiveObjectKind;
219
+ path: string;
220
+ title?: string;
221
+ }): Promise<{ message: string; object: PrimitiveObject }>;
222
+ get(args: {
223
+ id?: string;
224
+ path?: string;
225
+ includeContent?: boolean;
226
+ }): Promise<{ message: string; object: PrimitiveObject; missing: boolean; content?: unknown }>;
227
+ list(args?: {
228
+ kind?: PrimitiveObjectKind;
229
+ prefix?: string;
230
+ limit?: number;
231
+ offset?: number;
232
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
233
+ /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
234
+ reindex(args?: {
235
+ kind?: PrimitiveObjectKind;
236
+ }): Promise<{ message: string } & PrimitiveReindexReport>;
237
+ }
238
+
239
+ /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
240
+ export type SheetCellInput = number | string | boolean | null;
241
+
242
+ /** Identify the sheet by `id` or `path`. */
243
+ export interface SheetRef {
244
+ id?: string;
245
+ path?: string;
246
+ }
247
+
248
+ export interface SheetRangeArgs extends SheetRef {
249
+ /** A1 range: `Tasks!B2:C3`, `B2`, or a whole column `'My tab'!A:A` (capped to the used range). */
250
+ range: string;
251
+ }
252
+
253
+ export interface SheetCreateArgs {
254
+ /** Create-only; must end in `.sheet.json`. Default is one tab `Sheet1`; `rows` seed a tab from A1. */
255
+ path: string;
256
+ title?: string;
257
+ tabs?: Array<{ name: string; rows?: SheetCellInput[][] }>;
258
+ }
259
+
260
+ export interface SheetTabSummary {
261
+ name: string;
262
+ rows: number;
263
+ cols: number;
264
+ freezeRows: number;
265
+ }
266
+
267
+ export interface SheetResult {
268
+ message: string;
269
+ /** agent-fs version after the call. */
270
+ version: number;
271
+ }
272
+
273
+ /**
274
+ * Sheets: `swarm-sheet/1` workbooks on your default agent-fs drive, recomputed by a spreadsheet engine.
275
+ * Writes retry on a concurrent edit, then throw. Each method throws on a refusal.
276
+ */
277
+ export interface SheetsNamespace {
278
+ create(
279
+ args: SheetCreateArgs,
280
+ ): Promise<{ message: string; object: PrimitiveObject; link: string | null }>;
281
+ get(
282
+ args: SheetRef,
283
+ ): Promise<SheetResult & { object: PrimitiveObject; tabs: SheetTabSummary[] }>;
284
+ list(args?: {
285
+ prefix?: string;
286
+ limit?: number;
287
+ offset?: number;
288
+ }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
289
+ /** Cached values (at most 10,000 cells). `formulas: true` also returns formula text. */
290
+ getRange(
291
+ args: SheetRangeArgs & { formulas?: boolean },
292
+ ): Promise<
293
+ SheetResult & { range: string; values: SheetCellInput[][]; formulas?: SheetCellInput[][] }
294
+ >;
295
+ /** A single-cell `range` is the top-left corner; a larger one must match `values`. `'=` stores literal text beginning with `=`. */
296
+ setRange(
297
+ args: SheetRangeArgs & { values: SheetCellInput[][] },
298
+ ): Promise<SheetResult & { range: string; changed: number; recalculated: number }>;
299
+ appendRows(
300
+ args: SheetRef & { tab: string; rows: SheetCellInput[][] },
301
+ ): Promise<SheetResult & { range: string }>;
302
+ clearRange(args: SheetRangeArgs): Promise<SheetResult & { range: string; cleared: number }>;
303
+ addTab(
304
+ args: SheetRef & { name: string; after?: string },
305
+ ): Promise<SheetResult & { tabs: string[] }>;
306
+ }
307
+
308
+ /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
309
+ export type BoardColor =
310
+ | "blue"
311
+ | "green"
312
+ | "yellow"
313
+ | "red"
314
+ | "violet"
315
+ | "orange"
316
+ | "gray"
317
+ | "teal"
318
+ | (string & {});
319
+
320
+ export interface BoardShape {
321
+ /** Your name for the shape, so arrows in the same call can point at it. */
322
+ key?: string;
323
+ type: "rectangle" | "ellipse" | "diamond" | "text";
324
+ x?: number;
325
+ y?: number;
326
+ /** Minimum size; a shape grows to fit its label. */
327
+ width?: number;
328
+ height?: number;
329
+ /** Text inside the shape; required for `text`. */
330
+ label?: string;
331
+ color?: BoardColor;
332
+ }
333
+
334
+ /** `from` / `to`: a shape key from the same call or an existing element id. */
335
+ export interface BoardArrow {
336
+ from: string;
337
+ to: string;
338
+ label?: string;
339
+ }
340
+
341
+ export interface BoardElementPatch {
342
+ elementId: string;
343
+ /** An empty string removes a shape's label. */
344
+ label?: string;
345
+ x?: number;
346
+ y?: number;
347
+ width?: number;
348
+ height?: number;
349
+ color?: BoardColor;
350
+ }
351
+
352
+ export interface BoardElementSummary {
353
+ id: string;
354
+ type: string;
355
+ /** Free text, or a shape's label; null when it has none. */
356
+ text: string | null;
357
+ x: number;
358
+ y: number;
359
+ width: number;
360
+ height: number;
361
+ /** Arrow: [from, to] element ids (null when unbound). Shape: ids of its bound arrows. */
362
+ boundTo: Array<string | null>;
363
+ }
364
+
365
+ export type BoardLayout = "row" | "column" | "grid";
366
+ export type BoardRef = { id: string; path?: string } | { id?: string; path: string };
367
+
368
+ /** What a board call returns besides its own fields. */
369
+ export interface BoardResult {
370
+ message: string;
371
+ object: PrimitiveObject;
372
+ version: number | null;
373
+ }
374
+ export type BoardAdded = BoardResult & { added: Record<string, string> };
375
+ export type BoardElements<E> = BoardResult & { elements: E[] };
376
+ export interface BoardAddArgs {
377
+ shapes?: BoardShape[];
378
+ arrows?: BoardArrow[];
379
+ /** How shapes without x/y are placed, below existing content. Default `row`. */
380
+ layout?: BoardLayout;
381
+ }
382
+ export type BoardCreateArgs = BoardAddArgs & { path: string; title?: string };
383
+ export type BoardPatchArgs = BoardRef & { patches: BoardElementPatch[] };
384
+ export type BoardRemoveArgs = BoardRef & { elementIds: string[] };
385
+ export type BoardListArgs = { prefix?: string; limit?: number; offset?: number };
386
+ export type BoardList = { message: string; objects: PrimitiveObject[]; total: number };
387
+
388
+ /**
389
+ * Excalidraw boards (`.excalidraw`) on your default agent-fs drive, edited as
390
+ * element JSON. Writes guard on the file version and re-apply on a concurrent
391
+ * change. Each method throws on a refusal.
392
+ */
393
+ export interface BoardsNamespace {
394
+ /** Create-only. `added` maps each shape key (or `shapes[i]`) and `arrows[i]` to its element id. */
395
+ create(args: BoardCreateArgs): Promise<BoardAdded>;
396
+ get(args: BoardRef & { detail?: "summary" }): Promise<BoardElements<BoardElementSummary>>;
397
+ /** Raw Excalidraw elements (live only) instead of summaries. */
398
+ get(args: BoardRef & { detail: "full" }): Promise<BoardElements<Record<string, unknown>>>;
399
+ list(args?: BoardListArgs): Promise<BoardList>;
400
+ /** Arrows bind both ends to shapes. */
401
+ addElements(args: BoardRef & BoardAddArgs): Promise<BoardAdded>;
402
+ updateElements(args: BoardPatchArgs): Promise<BoardResult & { updated: string[] }>;
403
+ /** Sets `isDeleted: true`; a shape takes its label with it and unbinds its arrows. */
404
+ removeElements(args: BoardRemoveArgs): Promise<BoardResult & { removed: string[] }>;
405
+ }
406
+
177
407
  export interface SwarmSdk {
178
408
  // --- memory ---
179
409
  memory_search(args: {
@@ -265,6 +495,36 @@ declare module "swarm-sdk" {
265
495
  state?: unknown;
266
496
  }): Promise<unknown>;
267
497
  room_decode(args: { value: unknown }): Promise<unknown>;
498
+ // --- primitive objects (prefer ctx.objects.*, which unwraps and throws) ---
499
+ objects_create(args: {
500
+ kind: PrimitiveObjectKind;
501
+ path: string;
502
+ title?: string;
503
+ }): Promise<unknown>;
504
+ objects_get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<unknown>;
505
+ objects_list(args?: {
506
+ kind?: PrimitiveObjectKind;
507
+ prefix?: string;
508
+ limit?: number;
509
+ offset?: number;
510
+ }): Promise<unknown>;
511
+ objects_reindex(args?: { kind?: PrimitiveObjectKind }): Promise<unknown>;
512
+ // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
513
+ sheets_create(args: SheetCreateArgs): Promise<unknown>;
514
+ sheets_get(args: SheetRef): Promise<unknown>;
515
+ sheets_list(args?: { prefix?: string; limit?: number; offset?: number }): Promise<unknown>;
516
+ sheets_getRange(args: SheetRangeArgs & { formulas?: boolean }): Promise<unknown>;
517
+ sheets_setRange(args: SheetRangeArgs & { values: SheetCellInput[][] }): Promise<unknown>;
518
+ sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
519
+ sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
520
+ sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
521
+ // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
522
+ boards_create(args: BoardCreateArgs): Promise<unknown>;
523
+ boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
524
+ boards_list(args?: BoardListArgs): Promise<unknown>;
525
+ boards_addElements(args: BoardRef & BoardAddArgs): Promise<unknown>;
526
+ boards_updateElements(args: BoardPatchArgs): Promise<unknown>;
527
+ boards_removeElements(args: BoardRemoveArgs): Promise<unknown>;
268
528
  // --- repos ---
269
529
  repo_list(args?: Record<string, unknown>): Promise<unknown>;
270
530
  // --- schedules ---
@@ -913,6 +1173,13 @@ declare module "swarm-sdk" {
913
1173
  sh(command: string, options?: ScriptShOptions): Promise<ScriptShResult>;
914
1174
  stdlib: ScriptStdlib;
915
1175
  logger: ScriptLogger;
1176
+ // Each SDK_NAMESPACES entry (src/scripts-runtime/sdk-allowlist.ts) needs a typed `<ns>` key here.
1177
+ /** Primitive objects on your default agent-fs drive (object-* tools). */
1178
+ objects: ObjectsNamespace;
1179
+ /** Sheets on your default agent-fs drive (sheet-* tools). */
1180
+ sheets: SheetsNamespace;
1181
+ /** Excalidraw boards on your default agent-fs drive (board-* tools). */
1182
+ boards: BoardsNamespace;
916
1183
  }
917
1184
 
918
1185
  /**
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,16 @@ 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
+ registerSheetGetRangeTool,
167
+ registerSheetGetTool,
168
+ registerSheetListTool,
169
+ registerSheetSetRangeTool,
170
+ } from "./tools/sheets";
147
171
  // Skills capability
148
172
  import {
149
173
  registerSkillCreateTool,
@@ -245,6 +269,7 @@ export const ALL_CAPABILITIES = [
245
269
  "kapso",
246
270
  "chat-sdk",
247
271
  "swarm-x",
272
+ "primitives",
248
273
  ] as const;
249
274
 
250
275
  type CAPABILITIES_T = (typeof ALL_CAPABILITIES)[number];
@@ -276,6 +301,7 @@ const DEFAULT_CAPABILITIES: string = [
276
301
  // "agentmail",
277
302
  // "kapso",
278
303
  // "chat-sdk", (added by getEnabledCapabilities when CHAT_SDK_ENABLED is true)
304
+ // "primitives", (scripts still reach object-* through the full-surface bridge)
279
305
  ].join(",");
280
306
 
281
307
  // Note: unknown names are kept (they never match hasCapability); workers
@@ -685,6 +711,28 @@ export async function createServer(
685
711
  registerRoomDecodeTool(server);
686
712
  }
687
713
 
714
+ // Primitives capability: object-*, sheet-* and board-* tools over agent-fs files (src/be/primitives/).
715
+ if (hasCapability("primitives")) {
716
+ registerObjectCreateTool(server);
717
+ registerObjectGetTool(server);
718
+ registerObjectListTool(server);
719
+ registerObjectReindexTool(server);
720
+ registerSheetCreateTool(server);
721
+ registerSheetGetTool(server);
722
+ registerSheetListTool(server);
723
+ registerSheetGetRangeTool(server);
724
+ registerSheetSetRangeTool(server);
725
+ registerSheetAppendRowsTool(server);
726
+ registerSheetClearRangeTool(server);
727
+ registerSheetAddTabTool(server);
728
+ registerBoardCreateTool(server);
729
+ registerBoardGetTool(server);
730
+ registerBoardListTool(server);
731
+ registerBoardAddElementsTool(server);
732
+ registerBoardUpdateElementsTool(server);
733
+ registerBoardRemoveElementsTool(server);
734
+ }
735
+
688
736
  // Slack capability - Slack integration tools (no-op if Slack is not configured)
689
737
  if (hasCapability("slack")) {
690
738
  registerSlackReplyTool(server);