@desplega.ai/agent-swarm 2.10.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-c4chgxp6.js} +27 -24
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-hn5fftf5.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-3g6yc8nv.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-cpjgpjvp.js} +29 -26
  10. package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
  11. package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-hce1av1h.js} +1 -1
  12. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-bztbxc4z.js} +1 -1
  13. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-d7xcym0j.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-arrkbe8t.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-68n75y1s.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-ykpyr5p8.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-trd59v7b.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-yjcze0j1.js} +10941 -10412
  21. package/dist/{cli-vq2eg24x.js → cli-01tvvtad.js} +63 -60
  22. package/dist/cli-04zc3f7b.js +68 -0
  23. package/dist/{cli-01k6wpr9.js → cli-0k1a0sde.js} +7 -7
  24. package/dist/{cli-j6te8keb.js → cli-0pp1yjg2.js} +8 -8
  25. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  26. package/dist/{cli-wwp1bd3n.js → cli-12vek61e.js} +564 -97
  27. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  28. package/dist/{cli-124ntmf0.js → cli-1htmtqc2.js} +143 -63
  29. package/dist/{cli-3f8zbtqa.js → cli-2amwhyv2.js} +15 -11
  30. package/dist/{cli-7sf9sb0w.js → cli-2m6yaq6b.js} +1 -1
  31. package/dist/{cli-6cwr32fe.js → cli-2tw284hj.js} +422 -140
  32. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  33. package/dist/{cli-nstkanmx.js → cli-39qm0rtm.js} +8 -8
  34. package/dist/{cli-hnamkvnc.js → cli-3p288654.js} +2 -2
  35. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  38. package/dist/cli-52nfye5j.js +673 -0
  39. package/dist/cli-55tc8cj4.js +252 -0
  40. package/dist/cli-5r95eqbh.js +186 -0
  41. package/dist/{cli-6037prsx.js → cli-5tg94mdw.js} +13 -13
  42. package/dist/{cli-2spnz7ye.js → cli-5x03v6en.js} +11137 -8332
  43. package/dist/{cli-y4ccxtz5.js → cli-5z0g0e8v.js} +153 -6
  44. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  45. package/dist/{cli-539h29es.js → cli-72yms3ey.js} +224 -189
  46. package/dist/{cli-y8p78ekx.js → cli-73q4g5nx.js} +21 -21
  47. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  48. package/dist/{cli-43ms35q9.js → cli-7wy8gbwb.js} +3 -3
  49. package/dist/{cli-7mv4h3sn.js → cli-7yn42w6m.js} +2 -2
  50. package/dist/{cli-gabsjg8x.js → cli-8hp56wat.js} +3 -2
  51. package/dist/cli-8mfdbdhe.js +43 -0
  52. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  53. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  54. package/dist/{cli-2rnd5j3t.js → cli-9qe5y107.js} +2 -2
  55. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  56. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3aaeb78m.js → cli-agjbj5x0.js} +95 -10
  59. package/dist/{cli-th1dkc2v.js → cli-b93d81yg.js} +2 -2
  60. package/dist/{cli-qj39vrc6.js → cli-bhgrhedp.js} +1 -1
  61. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  62. package/dist/{cli-9fjr27ez.js → cli-bp6k9acz.js} +18 -22
  63. package/dist/{cli-5a6pqy45.js → cli-bpje8n65.js} +31 -4
  64. package/dist/{cli-2v2zdm0a.js → cli-bz97ff9n.js} +2 -2
  65. package/dist/{cli-3caf7pmg.js → cli-c7j31hq9.js} +3 -3
  66. package/dist/{cli-t9ga4qmb.js → cli-cah298e5.js} +40 -33
  67. package/dist/{cli-aw83sr40.js → cli-cjqyse9q.js} +3 -3
  68. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  69. package/dist/{cli-nv4xsvmk.js → cli-dkvtfgn4.js} +7 -7
  70. package/dist/{cli-7r162fxe.js → cli-e3ahxq5y.js} +23 -17
  71. package/dist/{cli-3et6fmfe.js → cli-e8n0hdzd.js} +1 -1
  72. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  73. package/dist/{cli-kbtzfrxj.js → cli-en6dmkxd.js} +3 -3
  74. package/dist/{cli-m9cvf7vs.js → cli-eq4kew31.js} +14 -14
  75. package/dist/{cli-fcfbct2j.js → cli-eqq0hwvx.js} +5 -5
  76. package/dist/{cli-7zm3b3f5.js → cli-ercwc8xn.js} +1 -1
  77. package/dist/{cli-vs9vdpy0.js → cli-ex1y88j3.js} +1 -1
  78. package/dist/{cli-mk7c5ac4.js → cli-fxd1mwtr.js} +2 -2
  79. package/dist/{cli-91pkxres.js → cli-fy4gb74g.js} +2 -2
  80. package/dist/{cli-fq2rr3jb.js → cli-fyaq4zdv.js} +6 -6
  81. package/dist/{cli-cc93xzes.js → cli-gfy6hbd9.js} +28 -17
  82. package/dist/{cli-s1khw52h.js → cli-h70a2mxy.js} +71 -17
  83. package/dist/cli-hbvgzjq4.js +69 -0
  84. package/dist/{cli-qx4f057j.js → cli-hhc47ack.js} +4 -4
  85. package/dist/{cli-q5srsxq2.js → cli-j5gtytvg.js} +154 -41
  86. package/dist/{cli-psffsanb.js → cli-js10kdk7.js} +6 -1
  87. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  88. package/dist/{cli-vsw91x06.js → cli-k5jx8jya.js} +10 -6
  89. package/dist/{cli-tr27kwyg.js → cli-krbcr00p.js} +261 -6
  90. package/dist/{cli-5qhfv9rw.js → cli-kwr5qv5g.js} +44 -17
  91. package/dist/{cli-md50mj0r.js → cli-m5qtmrbc.js} +3 -3
  92. package/dist/{cli-vfqvrd82.js → cli-ma9ys8rt.js} +2 -2
  93. package/dist/{cli-w16kwbzw.js → cli-mbwmqb5w.js} +1 -1
  94. package/dist/{cli-w1q68d8x.js → cli-mcymtvwn.js} +322 -72
  95. package/dist/{cli-k3q2va86.js → cli-mq2fbgva.js} +66 -5
  96. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  97. package/dist/{cli-kpgcm7xy.js → cli-n85m2wkq.js} +1 -1
  98. package/dist/{cli-v8z0yga9.js → cli-n8f0fs3c.js} +4 -4
  99. package/dist/{cli-mys27d03.js → cli-nja15knq.js} +3 -3
  100. package/dist/{cli-zk7v5s89.js → cli-pe3yxedk.js} +3 -3
  101. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  102. package/dist/{cli-6237rnyr.js → cli-pqfecppn.js} +1 -1
  103. package/dist/{cli-qrta34nb.js → cli-q2dywc8h.js} +4 -4
  104. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  105. package/dist/{cli-s1zqk1aj.js → cli-q8tc22bj.js} +15 -9
  106. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  107. package/dist/{cli-43evxwj4.js → cli-r0mz92by.js} +9 -4
  108. package/dist/{cli-jrbq4djp.js → cli-r14ac1y0.js} +1 -1
  109. package/dist/{cli-5gpqgs8b.js → cli-rtmqzat7.js} +2 -2
  110. package/dist/{cli-tvgqesec.js → cli-s6zk31gr.js} +4 -4
  111. package/dist/{cli-6ym4jhzp.js → cli-sv2r3bw8.js} +7 -7
  112. package/dist/{cli-wafmk3fn.js → cli-t75xngj1.js} +12 -12
  113. package/dist/{cli-x40a0w9j.js → cli-tdk7jtka.js} +1 -1
  114. package/dist/{cli-zeh2mhkg.js → cli-tm60vtax.js} +1 -1
  115. package/dist/cli-tsfkcd4v.js +30 -0
  116. package/dist/{cli-8st34zhr.js → cli-v9ya390t.js} +57 -19
  117. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  118. package/dist/{cli-p0n7b5rz.js → cli-wvjqaqcp.js} +2907 -151
  119. package/dist/{cli-sb4426be.js → cli-xf4z5bdn.js} +5 -5
  120. package/dist/{cli-p0c3vtch.js → cli-xm34qj8m.js} +772 -515
  121. package/dist/{cli-z0m452jr.js → cli-ya3kf4gs.js} +1 -1
  122. package/dist/{cli-had1p04a.js → cli-yegz2g06.js} +4 -4
  123. package/dist/{cli-k5yewqgd.js → cli-yfpc6qy9.js} +3 -3
  124. package/dist/{cli-q2d3e1k1.js → cli-z4f346g5.js} +1 -1
  125. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  126. package/dist/cli.js +34 -30
  127. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  128. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-wc6e4wct.js} +8 -8
  129. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  130. package/dist/{codex-login-a239g1ah.js → codex-login-1ven7yje.js} +1 -1
  131. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-ppfgjd97.js} +9 -9
  132. package/dist/{commands-d8g349v4.js → commands-tsv2vx5b.js} +3 -3
  133. package/dist/{controller-mwgdmb8y.js → controller-ye4sdwsy.js} +4 -4
  134. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-zn4dg69h.js} +25 -22
  135. package/dist/core-dxcy02sc.js +41 -0
  136. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-q2g9vwts.js} +2 -2
  137. package/dist/{db-wcw0b2j8.js → db-3r1fyr2n.js} +6 -2
  138. package/dist/{db-qpganbeb.js → db-g111qn9j.js} +3 -3
  139. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-t8d86q9x.js} +1 -1
  140. package/dist/{dispatcher-8d8s49yz.js → dispatcher-4q8s0mx8.js} +22 -19
  141. package/dist/{docker-09tkkg0n.js → docker-1b41eysj.js} +51 -14
  142. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-mmcw1z5s.js} +2 -2
  143. package/dist/{e2b-3v1e745x.js → e2b-ew8c5j5v.js} +3 -3
  144. package/dist/{e2b-sm28k0k3.js → e2b-xm60c8ad.js} +6 -6
  145. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-04ke6hcp.js} +1 -1
  146. package/dist/{embedding-space-e48xchqa.js → embedding-space-kcdn52vz.js} +6 -6
  147. package/dist/{embeddings-tgq2afbq.js → embeddings-jnzcd91a.js} +1 -1
  148. package/dist/{event-bus-xr83x566.js → event-bus-v4ywhc2p.js} +1 -1
  149. package/dist/{execute-8rhwrk7f.js → execute-74amghty.js} +8 -4
  150. package/dist/{external-channel-8bt3j2pm.js → external-channel-v9zgxnxz.js} +2 -2
  151. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  152. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  153. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  154. package/dist/grok-adapter-t6m74fb1.js +19 -0
  155. package/dist/handlers-9kwcrc4k.js +38 -0
  156. package/dist/{heartbeat-x0056ra5.js → heartbeat-p8pk1msj.js} +25 -22
  157. package/dist/{hook-a7vmn2st.js → hook-k1h73zd7.js} +5 -5
  158. package/dist/{hook-mrd2ayxv.js → hook-p5reemds.js} +8 -8
  159. package/dist/{http-ym9c5svp.js → http-ms1z5xxy.js} +2549 -224
  160. package/dist/index-23cdfzr6.js +39 -0
  161. package/dist/{index-01ns1pkw.js → index-76zzxtzf.js} +1 -1
  162. package/dist/{index-ny60jcat.js → index-fbkqhvvj.js} +40 -18
  163. package/dist/index-g7kkjs5b.js +38 -0
  164. package/dist/{index-x6azjwm8.js → index-gjn6qfgn.js} +1 -1
  165. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  166. package/dist/{index-p46tvwtx.js → index-kn63q1gr.js} +28 -25
  167. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  168. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  169. package/dist/index-stk36pa5.js +43 -0
  170. package/dist/{k8s-m56sw868.js → k8s-fy8hbhkg.js} +73 -14
  171. package/dist/{keepalive-7yxg8z4c.js → keepalive-031js8jz.js} +4 -4
  172. package/dist/lead-mfggjtfk.js +77 -0
  173. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  174. package/dist/{maintenance-6tefxmk1.js → maintenance-sq9v3qx9.js} +1 -1
  175. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  176. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  177. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  178. package/dist/object-webhooks-r24wwb5y.js +21 -0
  179. package/dist/{onboard-fja65z08.js → onboard-p25yhh7t.js} +5 -5
  180. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  181. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  182. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  183. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  184. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-wcjc4zdk.js} +7 -7
  185. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  186. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-ff1gf20m.js} +2 -2
  187. package/dist/{pending-h01yzpx4.js → pending-hxj5yatb.js} +23 -20
  188. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  189. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-vkp4zz7p.js} +19 -18
  190. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-9w7gx41w.js} +2 -2
  191. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-84aw10nz.js} +3 -3
  192. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-hz74vckp.js} +2 -2
  193. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  194. package/dist/{render-v2-1rgspxzf.js → render-v2-nrdkg9gf.js} +7 -6
  195. package/dist/{resume-tqy61x24.js → resume-s6ey36rh.js} +9 -8
  196. package/dist/{runtime-exkxyx5f.js → runtime-x0b4pyam.js} +2 -2
  197. package/dist/{session-access-3act7vt4.js → session-access-xv49tk14.js} +4 -4
  198. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-r5j988ah.js} +3 -3
  199. package/dist/{setup-ry1vfdef.js → setup-mj0krk1p.js} +1 -1
  200. package/dist/thread-buffer-temgaqsy.js +41 -0
  201. package/dist/tree-visibility-cbrsfaar.js +24 -0
  202. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  203. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  204. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-ns0ryw05.js} +32 -10
  205. package/dist/{work-objects-z2e5tv03.js → work-objects-pydhzast.js} +25 -22
  206. package/dist/worker-efcemc22.js +77 -0
  207. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-9z2xec5e.js} +22 -19
  208. package/dist/{x-wg164ss9.js → x-3dtaf2r9.js} +2 -2
  209. package/openapi.json +2040 -559
  210. package/package.json +15 -11
  211. package/src/azure-devops/auth.ts +2 -3
  212. package/src/be/agent-fs-identity.ts +46 -0
  213. package/src/be/agent-history.ts +215 -0
  214. package/src/be/db/agents.ts +34 -12
  215. package/src/be/db/request-composition.ts +190 -0
  216. package/src/be/db/runtime.ts +15 -0
  217. package/src/be/db/slack-trees.ts +220 -10
  218. package/src/be/db/tasks/human-free.ts +3 -2
  219. package/src/be/db/tasks/write.ts +2 -2
  220. package/src/be/db/workflow-run-retention.ts +101 -0
  221. package/src/be/db-client.ts +23 -1
  222. package/src/be/db-retention-defaults.ts +46 -0
  223. package/src/be/db-retention.ts +55 -6
  224. package/src/be/db.ts +2 -0
  225. package/src/be/mcp-events/catalog.ts +108 -0
  226. package/src/be/mcp-events/dispatcher.ts +202 -0
  227. package/src/be/mcp-events/protocol.ts +296 -0
  228. package/src/be/mcp-events/store.ts +231 -0
  229. package/src/be/mcp-events/webhook.ts +226 -0
  230. package/src/be/memory/providers/sqlite-store.ts +110 -24
  231. package/src/be/memory/review-recall-filter.ts +22 -0
  232. package/src/be/memory/search-candidates.ts +5 -7
  233. package/src/be/memory/types.ts +5 -0
  234. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  235. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  236. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  237. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  238. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  239. package/src/be/migrations/330_request_composition.sql +22 -0
  240. package/src/be/migrations/332_primitive_objects.sql +31 -0
  241. package/src/be/migrations/334_agent_history.sql +23 -0
  242. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  243. package/src/be/model-profile-check.ts +1 -1
  244. package/src/be/multi-runtime.ts +32 -4
  245. package/src/be/primitives/boards/elements.ts +717 -0
  246. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  247. package/src/be/primitives/boards/service.ts +121 -0
  248. package/src/be/primitives/object-webhooks.ts +348 -0
  249. package/src/be/primitives/objects.ts +686 -0
  250. package/src/be/primitives/sheets/a1.ts +136 -0
  251. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  252. package/src/be/primitives/sheets/engine.ts +199 -0
  253. package/src/be/primitives/sheets/format.ts +106 -0
  254. package/src/be/primitives/sheets/service.ts +415 -0
  255. package/src/be/primitives/write-object.ts +83 -0
  256. package/src/be/runtime-pools/controllers.ts +18 -3
  257. package/src/be/runtime-pools/db.ts +15 -4
  258. package/src/be/runtime-pools/supervisor.ts +42 -2
  259. package/src/be/script-credential-broker.ts +8 -27
  260. package/src/be/scripts/typecheck.ts +216 -0
  261. package/src/be/seed/agent-fs-provision.ts +18 -0
  262. package/src/be/swarm-config-guard.ts +10 -2
  263. package/src/be/users.ts +19 -0
  264. package/src/commands/context-preamble.ts +11 -4
  265. package/src/commands/credential-outcome-report.ts +33 -9
  266. package/src/commands/e2b-stack-wizard.tsx +12 -6
  267. package/src/commands/onboard/agent-fs-version.ts +1 -1
  268. package/src/commands/onboard/steps/harness.tsx +1 -1
  269. package/src/commands/provider-credentials.ts +1 -0
  270. package/src/commands/runner.ts +116 -12
  271. package/src/e2b/env.ts +3 -1
  272. package/src/extensions/catalog.generated.json +1 -1
  273. package/src/fs/agent-fs-provider.ts +33 -2
  274. package/src/github/app.ts +59 -14
  275. package/src/gitlab/auth.ts +3 -4
  276. package/src/heartbeat/heartbeat.ts +11 -11
  277. package/src/http/agent-lifecycle.ts +152 -0
  278. package/src/http/agents.ts +12 -0
  279. package/src/http/all-routes.ts +4 -0
  280. package/src/http/auth.ts +2 -1
  281. package/src/http/config.ts +2 -1
  282. package/src/http/core.ts +2 -0
  283. package/src/http/github-token.ts +66 -0
  284. package/src/http/index.ts +36 -0
  285. package/src/http/mcp-user.ts +11 -8
  286. package/src/http/mcp.ts +58 -42
  287. package/src/http/object-webhooks.ts +101 -0
  288. package/src/http/operator-actor.ts +2 -1
  289. package/src/http/prompt-templates.ts +1 -0
  290. package/src/http/request-composition.ts +310 -0
  291. package/src/http/sessions.ts +7 -0
  292. package/src/http/tasks.ts +6 -1
  293. package/src/http/tool-schema-estimate.ts +95 -0
  294. package/src/http/workflows.ts +61 -11
  295. package/src/integrations/chat-sdk/inbound.ts +2 -2
  296. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  297. package/src/prompts/base-prompt.ts +133 -7
  298. package/src/prompts/resolver.ts +41 -2
  299. package/src/providers/acp-targets.ts +2 -2
  300. package/src/providers/amp-adapter.ts +1 -1
  301. package/src/providers/opencode-adapter.ts +76 -2
  302. package/src/providers/opencode-swarm-plugin.ts +22 -3
  303. package/src/providers/pi-mono-adapter.ts +1 -0
  304. package/src/providers/pi-mono-extension.ts +71 -0
  305. package/src/providers/pricing-sources.md +4 -0
  306. package/src/providers/request-composition-hook.ts +312 -0
  307. package/src/providers/types.ts +5 -0
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/runtime-providers/controller-protocol.ts +7 -0
  311. package/src/runtime-providers/docker.ts +80 -12
  312. package/src/runtime-providers/k8s.ts +111 -6
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/script-workflows/guest-ctx.ts +32 -0
  316. package/src/script-workflows/workflow-ctx.ts +2 -0
  317. package/src/scripts-runtime/ctx.ts +9 -1
  318. package/src/scripts-runtime/executors/native.ts +106 -21
  319. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  320. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  321. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  322. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  323. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  324. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  325. package/src/server-user.ts +16 -1
  326. package/src/server.ts +48 -0
  327. package/src/slack/ack.ts +10 -5
  328. package/src/slack/actions.ts +3 -3
  329. package/src/slack/app.ts +2 -0
  330. package/src/slack/assistant.ts +4 -4
  331. package/src/slack/blocks.ts +3 -3
  332. package/src/slack/handlers.ts +3 -3
  333. package/src/slack/reaction-shortcode.ts +23 -2
  334. package/src/slack/render-v2.ts +297 -200
  335. package/src/slack/responses.ts +7 -5
  336. package/src/slack/thread-buffer.ts +3 -3
  337. package/src/slack/tree-visibility.ts +64 -0
  338. package/src/tasks/worker-follow-up.ts +127 -17
  339. package/src/tests/agent-history.test.ts +313 -0
  340. package/src/tests/azure-devops-auth.test.ts +6 -0
  341. package/src/tests/azure-devops-outbound.test.ts +47 -14
  342. package/src/tests/base-prompt.test.ts +149 -1
  343. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  344. package/src/tests/check-playwright-version.test.ts +33 -0
  345. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  346. package/src/tests/context-preamble-budget.test.ts +65 -0
  347. package/src/tests/credential-check.test.ts +12 -0
  348. package/src/tests/credential-outcome-report.test.ts +81 -1
  349. package/src/tests/db-client.test.ts +22 -0
  350. package/src/tests/db-retention-defaults.test.ts +244 -0
  351. package/src/tests/db-retention.test.ts +2 -1
  352. package/src/tests/db-task-read-contract.test.ts +2 -0
  353. package/src/tests/db-task-write-contract.test.ts +2 -0
  354. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  355. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  356. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  357. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  358. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  359. package/src/tests/e2e-shards.test.ts +137 -0
  360. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  361. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  362. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  363. package/src/tests/env-flag.test.ts +4 -2
  364. package/src/tests/event-loop-lag.test.ts +12 -18
  365. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  366. package/src/tests/extensions-heartbeat.test.ts +34 -0
  367. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  368. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  369. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  370. package/src/tests/github-installation-token-route.test.ts +199 -0
  371. package/src/tests/gitlab-auth.test.ts +10 -0
  372. package/src/tests/heartbeat.test.ts +38 -0
  373. package/src/tests/http-api-integration.test.ts +0 -6
  374. package/src/tests/mcp-user-events.test.ts +708 -0
  375. package/src/tests/memory-key-paths.test.ts +4 -1
  376. package/src/tests/memory-search-stall.test.ts +421 -0
  377. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  378. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  379. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  380. package/src/tests/opencode-adapter.test.ts +97 -0
  381. package/src/tests/pi-mono-extension.test.ts +168 -0
  382. package/src/tests/preload-env.test.ts +61 -1
  383. package/src/tests/preload.ts +22 -0
  384. package/src/tests/primitives-boards.test.ts +686 -0
  385. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  386. package/src/tests/primitives-objects.test.ts +248 -0
  387. package/src/tests/prompt-template-resolver.test.ts +85 -0
  388. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  389. package/src/tests/reload-config.test.ts +45 -0
  390. package/src/tests/request-composition.test.ts +447 -0
  391. package/src/tests/runner-max-concurrent.test.ts +86 -0
  392. package/src/tests/runtime-pools-db.test.ts +80 -0
  393. package/src/tests/runtime-provider-registration.test.ts +8 -0
  394. package/src/tests/runtime-providers-docker.test.ts +192 -1
  395. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  396. package/src/tests/runtime-remote-controller.test.ts +64 -1
  397. package/src/tests/runtime-supervisor.test.ts +101 -0
  398. package/src/tests/script-connections.test.ts +8 -0
  399. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  400. package/src/tests/scripts-namespaces.test.ts +211 -0
  401. package/src/tests/secret-scrub-gate.test.ts +1 -0
  402. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  403. package/src/tests/secret-scrubber.test.ts +1 -1
  404. package/src/tests/session-tokens.test.ts +27 -0
  405. package/src/tests/sheet-engine.test.ts +58 -0
  406. package/src/tests/slack-blocks.test.ts +18 -0
  407. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  408. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  409. package/src/tests/slack-reaction-config.test.ts +38 -2
  410. package/src/tests/slack-read-boundaries.test.ts +4 -2
  411. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  412. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  413. package/src/tests/slack-render-v2.test.ts +683 -11
  414. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  415. package/src/tests/task-session-prompts.test.ts +37 -0
  416. package/src/tests/task-start-after-commit.test.ts +82 -0
  417. package/src/tests/ui-logs-parser.test.ts +67 -0
  418. package/src/tests/user-delete-perf.test.ts +36 -9
  419. package/src/tests/webhook-filter.test.ts +327 -0
  420. package/src/tests/workflow-async-v2.test.ts +19 -16
  421. package/src/tests/workflow-e2e.test.ts +1 -9
  422. package/src/tests/workflow-finalization-races.test.ts +553 -0
  423. package/src/tests/workflow-foreach.test.ts +2 -0
  424. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  425. package/src/tests/workflow-http-v2.test.ts +105 -2
  426. package/src/tests/workflow-idempotency.test.ts +41 -0
  427. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  428. package/src/tests/workflow-parallel-park.test.ts +297 -0
  429. package/src/tests/workflow-retry-v2.test.ts +158 -21
  430. package/src/tests/workflow-retry-validation.test.ts +13 -13
  431. package/src/tests/workflow-runs-retention.test.ts +533 -0
  432. package/src/tests/workflow-script-principal.test.ts +7 -2
  433. package/src/tests/workflow-tla-races.test.ts +36 -2
  434. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  435. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  436. package/src/tests/workflow-wait-event.test.ts +28 -2
  437. package/src/tests/workflow-wait-poller.test.ts +94 -0
  438. package/src/tests/workflow-wait-time.test.ts +7 -3
  439. package/src/tests/workflow-wait.ts +44 -0
  440. package/src/tools/boards.ts +260 -0
  441. package/src/tools/objects.ts +191 -0
  442. package/src/tools/sheets.ts +312 -0
  443. package/src/tools/slack-read.ts +10 -3
  444. package/src/tools/tool-config.ts +23 -0
  445. package/src/tools/workflows/create-workflow.ts +18 -4
  446. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  447. package/src/tools/workflows/patch-workflow.ts +4 -0
  448. package/src/tools/workflows/update-workflow.ts +24 -3
  449. package/src/types.ts +216 -2
  450. package/src/utils/credentials.ts +7 -0
  451. package/src/utils/sandboxed-process.ts +47 -2
  452. package/src/utils/secret-scrubber.ts +61 -6
  453. package/src/workflows/checkpoint.ts +18 -0
  454. package/src/workflows/engine.ts +73 -31
  455. package/src/workflows/foreach-driver.ts +42 -4
  456. package/src/workflows/input.ts +29 -1
  457. package/src/workflows/patch-definition.ts +15 -1
  458. package/src/workflows/recovery.ts +6 -1
  459. package/src/workflows/resume.ts +11 -3
  460. package/src/workflows/retry-poller.ts +32 -6
  461. package/src/workflows/successor-routing.ts +108 -0
  462. package/src/workflows/task-step-routing.ts +5 -2
  463. package/src/workflows/triggers.ts +21 -36
  464. package/src/workflows/validation.ts +10 -0
  465. package/src/workflows/wait-poller.ts +6 -2
  466. package/src/workflows/webhook-filter.ts +203 -0
  467. package/templates/ai-toolbox.manifest.json +1 -1
  468. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  469. package/templates/skills/agent-browser/SKILL.md +1 -0
  470. package/templates/skills/agent-browser/content.md +1 -0
  471. package/templates/skills/pages/content.md +5 -0
  472. package/templates/skills/swarm-docs/content.md +8 -1
  473. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  474. package/templates/skills/swarm-scripts/content.md +1 -0
  475. package/templates/skills/tdd-planning/content.md +5 -2
  476. package/dist/acp-adapter-bht22g3k.js +0 -16
  477. package/dist/core-sxy4epp2.js +0 -38
  478. package/dist/fx-adapter-adtdb3jb.js +0 -19
  479. package/dist/grok-adapter-accnn9km.js +0 -19
  480. package/dist/handlers-1x77561e.js +0 -35
  481. package/dist/index-48qzcqzj.js +0 -35
  482. package/dist/index-rkvaambe.js +0 -36
  483. package/dist/index-xj1mq27m.js +0 -40
  484. package/dist/lead-enzn86bz.js +0 -74
  485. package/dist/thread-buffer-3x93yexa.js +0 -38
  486. package/dist/worker-zfcv2wbf.js +0 -74
  487. package/src/slack/socket-mode-guard.test.ts +0 -25
  488. package/src/tests/agent-activity.test.ts +0 -247
  489. package/src/tests/agent-fs-live-url.test.ts +0 -55
  490. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  491. package/src/tests/approval-sweeps-config.test.ts +0 -47
  492. package/src/tests/cards.test.ts +0 -169
  493. package/src/tests/chat-sdk-facts.test.ts +0 -23
  494. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  495. package/src/tests/core-auth.test.ts +0 -156
  496. package/src/tests/date-utils.test.ts +0 -48
  497. package/src/tests/db-context-versions.test.ts +0 -37
  498. package/src/tests/db-runtime.test.ts +0 -131
  499. package/src/tests/enabled-capabilities.test.ts +0 -20
  500. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  501. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  502. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  503. package/src/tests/github-event-labels.test.ts +0 -24
  504. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  505. package/src/tests/http-log-scrubbing.test.ts +0 -123
  506. package/src/tests/http-semconv-attributes.test.ts +0 -92
  507. package/src/tests/identity.test.ts +0 -117
  508. package/src/tests/inbox-state.test.ts +0 -167
  509. package/src/tests/internal-ai/models.test.ts +0 -54
  510. package/src/tests/launch-password-rejection.test.ts +0 -140
  511. package/src/tests/list-total-cache.test.ts +0 -88
  512. package/src/tests/match-route.test.ts +0 -187
  513. package/src/tests/memory-feature-flags.test.ts +0 -45
  514. package/src/tests/memory-get-tool.test.ts +0 -269
  515. package/src/tests/memory-health-endpoint.test.ts +0 -78
  516. package/src/tests/memory-http-access.test.ts +0 -221
  517. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  518. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  519. package/src/tests/openai-embedding-provider.test.ts +0 -159
  520. package/src/tests/org-identity.test.ts +0 -44
  521. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  522. package/src/tests/pages-browser-sdk.test.ts +0 -76
  523. package/src/tests/pages-feedback-keys.test.ts +0 -121
  524. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  525. package/src/tests/pages-list-endpoint.test.ts +0 -148
  526. package/src/tests/pages-password-mode.test.ts +0 -266
  527. package/src/tests/pages-public-authed-401.test.ts +0 -103
  528. package/src/tests/pages-public-html.test.ts +0 -297
  529. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  530. package/src/tests/pages-view-count.test.ts +0 -245
  531. package/src/tests/prompt-templates-db.test.ts +0 -616
  532. package/src/tests/rbac-engine.test.ts +0 -742
  533. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  534. package/src/tests/route-def-find-route.test.ts +0 -192
  535. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  536. package/src/tests/schedule-validation-helper.test.ts +0 -51
  537. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  538. package/src/tests/scheduler-backoff.test.ts +0 -166
  539. package/src/tests/script-run-token.test.ts +0 -75
  540. package/src/tests/scripts-extract-signature.test.ts +0 -47
  541. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  542. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  543. package/src/tests/short-id.test.ts +0 -23
  544. package/src/tests/skill-files-http.test.ts +0 -222
  545. package/src/tests/skill-get-file-tool.test.ts +0 -110
  546. package/src/tests/skill-script-refs.test.ts +0 -63
  547. package/src/tests/skill-update-scope.test.ts +0 -252
  548. package/src/tests/skills-bundle.test.ts +0 -99
  549. package/src/tests/slack-app-icon.test.ts +0 -94
  550. package/src/tests/slack-assistant-comention.test.ts +0 -139
  551. package/src/tests/slack-delete.test.ts +0 -157
  552. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  553. package/src/tests/slack-manifest.test.ts +0 -23
  554. package/src/tests/slack-task-output.test.ts +0 -90
  555. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  556. package/src/tests/swarm-diff.test.ts +0 -728
  557. package/src/tests/task-lifecycle-events.test.ts +0 -53
  558. package/src/tests/template-asset-config.test.ts +0 -18
  559. package/src/tests/template-fetch.test.ts +0 -490
  560. package/src/tests/themes-page-theme.test.ts +0 -155
  561. package/src/tests/tool-annotations.test.ts +0 -442
  562. package/src/tests/tool-output-agent-id.test.ts +0 -202
  563. package/src/tests/update-profile-agentid.test.ts +0 -248
  564. package/src/tests/whoami-route.test.ts +0 -162
  565. package/src/tests/workflow-definition-telemetry.test.ts +0 -134
  566. package/src/tests/workflow-patch.test.ts +0 -169
  567. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  568. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  569. package/src/tests/workflow-step-claims.test.ts +0 -152
  570. package/src/tests/workflow-step-order.test.ts +0 -92
  571. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  572. package/src/tests/workflow-versions.test.ts +0 -240
@@ -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
  /**
@@ -2,6 +2,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
3
3
  import * as z from "zod";
4
4
  import pkg from "../package.json";
5
+ import { isMcpUserEventsEnabled } from "./be/mcp-events/catalog";
6
+ import { registerUserEvents } from "./be/mcp-events/protocol";
5
7
  import { enqueueAdmissionRow } from "./be/rbac-audit";
6
8
  import { getUserGrant } from "./be/rbac-roles";
7
9
  import { MCP_MAX_TOOL_INPUT_ELEMENTS } from "./mcp-limits";
@@ -97,7 +99,11 @@ async function maybeDenyUserToolAdmission(
97
99
  return toolErr(`Forbidden: ${decision.reason}`);
98
100
  }
99
101
 
100
- export function createUserServer(user: User): McpServer {
102
+ /**
103
+ * `tokenId` is the aswt_ token that opened the session. Without it the session
104
+ * offers no MCP Events: a subscription must be bound to a revocable token.
105
+ */
106
+ export function createUserServer(user: User, tokenId?: string): McpServer {
101
107
  const server = new McpServer(
102
108
  {
103
109
  name: `${pkg.name}-user`,
@@ -114,6 +120,15 @@ export function createUserServer(user: User): McpServer {
114
120
 
115
121
  const registerTool = createToolRegistrar(server);
116
122
 
123
+ if (tokenId && isMcpUserEventsEnabled()) {
124
+ // Subscribing is a read on the user's own tasks.
125
+ const eventsAdmission = { annotations: { readOnlyHint: true } };
126
+ registerUserEvents(server, user, tokenId, async (method) => {
127
+ const denied = await maybeDenyUserToolAdmission(user, method, eventsAdmission);
128
+ return denied === undefined;
129
+ });
130
+ }
131
+
117
132
  const sendTaskConfig = {
118
133
  title: "Send a task",
119
134
  annotations: { destructiveHint: false },