@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
@@ -0,0 +1,686 @@
1
+ import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
2
+ import { closeDb, getDbClient, initDb, upsertSwarmConfig } from "../be/db";
3
+ import { type BoardElement, measureText } from "../be/primitives/boards/elements";
4
+ import {
5
+ addBoardElements,
6
+ createBoard,
7
+ getBoard,
8
+ listBoards,
9
+ removeBoardElements,
10
+ updateBoardElements,
11
+ } from "../be/primitives/boards/service";
12
+ import { createObject } from "../be/primitives/objects";
13
+ import { MAX_OBJECT_BYTES, mutateObject } from "../be/primitives/write-object";
14
+
15
+ const OWN_KEY = "af_boards_own_key";
16
+ const ORG = "org-boards";
17
+ const DRIVE = "drive-boards";
18
+
19
+ // In-memory agent-fs: raw GET/PUT with If-None-Match / If-Match versions.
20
+ const files = new Map<string, { body: string; version: number }>();
21
+ // Runs before a guarded write is checked, so a test can race it.
22
+ let beforeWrite: ((path: string) => void) | undefined;
23
+
24
+ const fake = Bun.serve({
25
+ port: 0,
26
+ async fetch(req) {
27
+ if (req.headers.get("authorization") !== `Bearer ${OWN_KEY}`) {
28
+ return new Response("unauthorized", { status: 401 });
29
+ }
30
+ const raw = new URL(req.url).pathname.match(/^\/orgs\/[^/]+\/drives\/[^/]+\/files\/(.+)\/raw$/);
31
+ if (!raw) return new Response("not found", { status: 404 });
32
+ const path = decodeURIComponent(raw[1] ?? "");
33
+ if (req.method === "GET") {
34
+ const current = files.get(path);
35
+ if (!current) return new Response("not found", { status: 404 });
36
+ return new Response(current.body, {
37
+ headers: { "x-agent-fs-version": String(current.version) },
38
+ });
39
+ }
40
+ const ifMatch = req.headers.get("if-match");
41
+ if (ifMatch) beforeWrite?.(path);
42
+ const current = files.get(path);
43
+ if (req.headers.get("if-none-match") === "*" && current) {
44
+ return new Response("exists", { status: 409 });
45
+ }
46
+ if (ifMatch && String(current?.version) !== ifMatch) {
47
+ return new Response("version mismatch", { status: 409 });
48
+ }
49
+ const version = (current?.version ?? 0) + 1;
50
+ files.set(path, { body: await req.text(), version });
51
+ return Response.json({ path, version }, { headers: { "x-agent-fs-version": String(version) } });
52
+ },
53
+ });
54
+
55
+ const agentId = crypto.randomUUID();
56
+
57
+ beforeAll(async () => {
58
+ initDb(":memory:");
59
+ const global = { scope: "global" as const, scopeId: null, isSecret: false };
60
+ await upsertSwarmConfig({
61
+ ...global,
62
+ key: "AGENT_FS_API_URL",
63
+ value: `http://127.0.0.1:${fake.port}`,
64
+ });
65
+ await upsertSwarmConfig({ ...global, key: "AGENT_FS_DEFAULT_ORG_ID", value: ORG });
66
+ await upsertSwarmConfig({ ...global, key: "AGENT_FS_DEFAULT_DRIVE_ID", value: DRIVE });
67
+ await upsertSwarmConfig({
68
+ scope: "agent",
69
+ scopeId: agentId,
70
+ key: "AGENT_FS_API_KEY",
71
+ value: OWN_KEY,
72
+ isSecret: true,
73
+ });
74
+ });
75
+
76
+ afterAll(() => {
77
+ fake.stop(true);
78
+ closeDb();
79
+ });
80
+
81
+ beforeEach(async () => {
82
+ files.clear();
83
+ beforeWrite = undefined;
84
+ await getDbClient().run("DELETE FROM primitive_objects");
85
+ });
86
+
87
+ type Scene = { elements: BoardElement[]; swarm?: { id?: string } };
88
+ const scene = (path: string): Scene => JSON.parse(files.get(path)?.body ?? "null");
89
+ const byId = (s: Scene, id: string) => {
90
+ const element = s.elements.find((e) => e.id === id);
91
+ if (!element) throw new Error(`no element ${id}`);
92
+ return element;
93
+ };
94
+
95
+ // Fields stock Excalidraw 0.18 reads on every element, plus the per-type ones.
96
+ // shortcut: a field check, not Excalidraw's own restoreElements; switch when
97
+ // @excalidraw/excalidraw lands as a devDependency (embed PR).
98
+ const COMMON = [
99
+ "id",
100
+ "type",
101
+ "x",
102
+ "y",
103
+ "width",
104
+ "height",
105
+ "angle",
106
+ "strokeColor",
107
+ "backgroundColor",
108
+ "fillStyle",
109
+ "strokeWidth",
110
+ "strokeStyle",
111
+ "roughness",
112
+ "opacity",
113
+ "groupIds",
114
+ "frameId",
115
+ "index",
116
+ "roundness",
117
+ "seed",
118
+ "version",
119
+ "versionNonce",
120
+ "isDeleted",
121
+ "boundElements",
122
+ "updated",
123
+ "link",
124
+ "locked",
125
+ ];
126
+ const BY_TYPE: Record<string, string[]> = {
127
+ text: [
128
+ "text",
129
+ "originalText",
130
+ "fontSize",
131
+ "fontFamily",
132
+ "textAlign",
133
+ "verticalAlign",
134
+ "containerId",
135
+ "autoResize",
136
+ "lineHeight",
137
+ ],
138
+ arrow: [
139
+ "points",
140
+ "lastCommittedPoint",
141
+ "startBinding",
142
+ "endBinding",
143
+ "startArrowhead",
144
+ "endArrowhead",
145
+ "elbowed",
146
+ ],
147
+ };
148
+
149
+ function expectValidScene(s: Scene) {
150
+ const ids = new Set(s.elements.map((e) => e.id));
151
+ expect(ids.size).toBe(s.elements.length);
152
+ for (const e of s.elements) {
153
+ for (const field of [...COMMON, ...(BY_TYPE[e.type] ?? [])]) {
154
+ expect(e, `${e.type} ${e.id} lacks ${field}`).toHaveProperty(field);
155
+ }
156
+ for (const n of [e.x, e.y, e.width, e.height]) expect(Number.isFinite(n)).toBe(true);
157
+ }
158
+ const indexes = s.elements.map((e) => e.index as string);
159
+ expect(indexes.every((i) => typeof i === "string")).toBe(true);
160
+ expect([...indexes].sort()).toEqual(indexes);
161
+ expect(new Set(indexes).size).toBe(indexes.length);
162
+ }
163
+
164
+ function expectArrowBound(s: Scene, arrowId: string, fromId: string, toId: string) {
165
+ const arrow = byId(s, arrowId);
166
+ expect(arrow.startBinding?.elementId).toBe(fromId);
167
+ expect(arrow.endBinding?.elementId).toBe(toId);
168
+ expect(byId(s, fromId).boundElements).toContainEqual({ type: "arrow", id: arrowId });
169
+ expect(byId(s, toId).boundElements).toContainEqual({ type: "arrow", id: arrowId });
170
+ }
171
+
172
+ const fourShapes = [
173
+ { key: "req", type: "rectangle" as const, label: "Request\nSlack · GitHub", color: "gray" },
174
+ { key: "lead", type: "diamond" as const, label: "Lead triages", color: "orange" },
175
+ { key: "work", type: "ellipse" as const, label: "Worker runs", color: "#a5d8ff" },
176
+ { key: "note", type: "text" as const, label: "Workers talk HTTP only" },
177
+ ];
178
+ const threeArrows = [
179
+ { from: "req", to: "lead", label: "send-task" },
180
+ { from: "lead", to: "work", label: "assign" },
181
+ { from: "work", to: "note" },
182
+ ];
183
+
184
+ describe("boards", () => {
185
+ test("create writes shapes, bound labels and two-way bound arrows", async () => {
186
+ const { object, added } = await createBoard({
187
+ agentId,
188
+ path: "/boards/flow.excalidraw",
189
+ title: "Flow",
190
+ shapes: fourShapes,
191
+ arrows: threeArrows,
192
+ });
193
+ expect(object.fileVersion).toBe(1);
194
+ expect(Object.keys(added).sort()).toEqual(
195
+ ["arrows[0]", "arrows[1]", "arrows[2]", "lead", "note", "req", "work"].sort(),
196
+ );
197
+ const s = scene("boards/flow.excalidraw");
198
+ expect(s.swarm).toMatchObject({ id: object.id, kind: "board", title: "Flow" });
199
+ expectValidScene(s);
200
+ // 4 shapes + 3 container labels + 3 arrows + 2 arrow labels.
201
+ expect(s.elements).toHaveLength(12);
202
+ expectArrowBound(s, added["arrows[0]"] ?? "", added.req ?? "", added.lead ?? "");
203
+ expectArrowBound(s, added["arrows[1]"] ?? "", added.lead ?? "", added.work ?? "");
204
+ expectArrowBound(s, added["arrows[2]"] ?? "", added.work ?? "", added.note ?? "");
205
+
206
+ for (const key of ["req", "lead", "work"]) {
207
+ const shape = byId(s, added[key] ?? "");
208
+ const ref = shape.boundElements?.find((r) => r.type === "text");
209
+ const label = byId(s, ref?.id ?? "");
210
+ expect(label.containerId).toBe(shape.id);
211
+ // The label fits inside the shape's bound-text box (diamond: half the width).
212
+ const scale = shape.type === "diamond" ? 0.5 : shape.type === "ellipse" ? Math.SQRT1_2 : 1;
213
+ expect(label.width).toBeLessThanOrEqual(shape.width * scale);
214
+ expect(label.height).toBeLessThanOrEqual(shape.height * scale);
215
+ }
216
+ expect(byId(s, added.req ?? "")).toMatchObject({
217
+ strokeColor: "#495057",
218
+ backgroundColor: "#e9ecef",
219
+ });
220
+ expect(byId(s, added.work ?? "").backgroundColor).toBe("#a5d8ff");
221
+ // Auto layout: one row, no overlaps.
222
+ const row = ["req", "lead", "work"].map((k) => byId(s, added[k] ?? ""));
223
+ for (let i = 1; i < row.length; i++) {
224
+ const prev = row[i - 1] as BoardElement;
225
+ expect((row[i] as BoardElement).x).toBeGreaterThan(prev.x + prev.width);
226
+ }
227
+ });
228
+
229
+ test("get summarizes live elements with folded labels and bindings; list filters boards", async () => {
230
+ const { object, added } = await createBoard({
231
+ agentId,
232
+ path: "b/one.excalidraw",
233
+ shapes: fourShapes,
234
+ arrows: threeArrows,
235
+ });
236
+ await createObject({ agentId, kind: "board", path: "c/two.excalidraw" });
237
+ const got = await getBoard({ agentId, id: object.id });
238
+ expect(got.version).toBe(1);
239
+ expect(got.elements).toHaveLength(7);
240
+ const summary = got.elements as Array<{ id: string; text: string | null; boundTo: unknown[] }>;
241
+ expect(summary.find((e) => e.id === added.lead)).toMatchObject({
242
+ text: "Lead triages",
243
+ boundTo: [added["arrows[0]"], added["arrows[1]"]],
244
+ });
245
+ expect(summary.find((e) => e.id === added["arrows[0]"])).toMatchObject({
246
+ text: "send-task",
247
+ boundTo: [added.req, added.lead],
248
+ });
249
+ const full = await getBoard({ agentId, path: "/b/one.excalidraw", detail: "full" });
250
+ expect(full.elements).toHaveLength(12);
251
+ expect((await listBoards({ agentId })).total).toBe(2);
252
+ expect((await listBoards({ agentId, prefix: "b/" })).objects.map((o) => o.id)).toEqual([
253
+ object.id,
254
+ ]);
255
+ });
256
+
257
+ test("addElements lays out below existing content and binds to an existing shape", async () => {
258
+ const { object, added } = await createBoard({
259
+ agentId,
260
+ path: "grow.excalidraw",
261
+ shapes: [{ key: "a", type: "rectangle", x: 100, y: 50, label: "A" }],
262
+ });
263
+ const before = byId(scene("grow.excalidraw"), added.a ?? "");
264
+ const next = await addBoardElements({
265
+ agentId,
266
+ id: object.id,
267
+ shapes: [
268
+ { key: "b", type: "rectangle", label: "B" },
269
+ { key: "c", type: "ellipse", label: "C" },
270
+ { key: "d", type: "diamond", label: "D" },
271
+ { key: "e", type: "rectangle", label: "E" },
272
+ ],
273
+ arrows: [{ from: added.a ?? "", to: "b" }],
274
+ layout: "grid",
275
+ });
276
+ expect(next.version).toBe(2);
277
+ const s = scene("grow.excalidraw");
278
+ expectValidScene(s);
279
+ const a = byId(s, added.a ?? "");
280
+ expect(a.version).toBe((before.version ?? 0) + 1);
281
+ expect(a.versionNonce).not.toBe(before.versionNonce);
282
+ expectArrowBound(s, next.added["arrows[0]"] ?? "", a.id, next.added.b ?? "");
283
+ const grid = ["b", "c", "d", "e"].map((k) => byId(s, next.added[k] ?? ""));
284
+ for (const shape of grid) expect(shape.y).toBeGreaterThanOrEqual(a.y + a.height);
285
+ // 2x2 grid: two distinct columns and two distinct rows of cells.
286
+ const [b, c, d] = grid as [BoardElement, BoardElement, BoardElement];
287
+ expect(b.y + b.height / 2).toBeCloseTo(c.y + c.height / 2);
288
+ expect(d.y).toBeGreaterThan(b.y + b.height);
289
+ });
290
+
291
+ test("updateElements bumps versions, refits labels and reroutes bound arrows", async () => {
292
+ const { object, added } = await createBoard({
293
+ agentId,
294
+ path: "edit.excalidraw",
295
+ shapes: [
296
+ { key: "a", type: "rectangle", x: 0, y: 0, label: "A" },
297
+ { key: "b", type: "rectangle", x: 400, y: 0, label: "B" },
298
+ ],
299
+ arrows: [{ from: "a", to: "b", label: "go" }],
300
+ });
301
+ const arrowId = added["arrows[0]"] ?? "";
302
+ const before = scene("edit.excalidraw");
303
+ const longLabel = "A much longer label that cannot fit in the default box width";
304
+ const result = await updateBoardElements({
305
+ agentId,
306
+ path: "edit.excalidraw",
307
+ patches: [
308
+ { elementId: added.b ?? "", x: 400, y: 300, color: "green" },
309
+ { elementId: added.a ?? "", label: longLabel },
310
+ { elementId: arrowId, label: "assign" },
311
+ ],
312
+ });
313
+ expect(result.updated).toEqual([added.b, added.a, arrowId]);
314
+ expect(result.version).toBe(2);
315
+ expect(result.object.id).toBe(object.id);
316
+ const s = scene("edit.excalidraw");
317
+ expectValidScene(s);
318
+ for (const id of [added.a, added.b, arrowId]) {
319
+ const was = byId(before, id ?? "");
320
+ const now = byId(s, id ?? "");
321
+ expect(now.version).toBeGreaterThan(was.version ?? 0);
322
+ expect(now.versionNonce).not.toBe(was.versionNonce);
323
+ }
324
+ const a = byId(s, added.a ?? "");
325
+ const aLabel = s.elements.find((e) => e.containerId === a.id) as BoardElement;
326
+ expect(aLabel.text).toBe(longLabel);
327
+ expect(a.width).toBeGreaterThanOrEqual(aLabel.width);
328
+ expect(aLabel.x + aLabel.width / 2).toBeCloseTo(a.x + a.width / 2);
329
+ // B moved down: the arrow now leaves A's bottom and ends at B's top.
330
+ const b = byId(s, added.b ?? "");
331
+ expect(b.strokeColor).toBe("#2f9e44");
332
+ const arrow = byId(s, arrowId);
333
+ const end = arrow.points?.[1] ?? [0, 0];
334
+ expect(arrow.y).toBeCloseTo(a.y + a.height + 4);
335
+ expect(arrow.y + (end[1] ?? 0)).toBeCloseTo(b.y - 4);
336
+ expect(s.elements.find((e) => e.containerId === arrowId)?.text).toBe("assign");
337
+ });
338
+
339
+ // Regression: a label created by one patch was invisible to later patches in
340
+ // the same call, so a second set duplicated it and arrow re-routing left it behind.
341
+ describe("updateElements: a label set earlier in the call is visible to later patches", () => {
342
+ async function board(path: string) {
343
+ const { added } = await createBoard({
344
+ agentId,
345
+ path,
346
+ shapes: [
347
+ { key: "a", type: "rectangle", x: 0, y: 0 },
348
+ { key: "b", type: "rectangle", x: 400, y: 0 },
349
+ ],
350
+ arrows: [{ from: "a", to: "b" }],
351
+ });
352
+ return { a: added.a ?? "", b: added.b ?? "", arrow: added["arrows[0]"] ?? "" };
353
+ }
354
+
355
+ // Exactly one live bound text with `text` (or none), with matching two-way refs.
356
+ function expectLabel(s: Scene, containerId: string, text: string | null) {
357
+ const texts = s.elements.filter((e) => e.type === "text" && e.containerId === containerId);
358
+ const live = texts.filter((e) => !e.isDeleted);
359
+ const refs = (byId(s, containerId).boundElements ?? []).filter((r) => r.type === "text");
360
+ if (text === null) {
361
+ expect(live).toHaveLength(0);
362
+ expect(refs).toHaveLength(0);
363
+ return undefined;
364
+ }
365
+ expect(live.map((e) => e.text)).toEqual([text]);
366
+ expect(refs).toEqual([{ type: "text", id: live[0]?.id ?? "" }]);
367
+ return live[0] as BoardElement;
368
+ }
369
+
370
+ function expectArrowLabelCentered(s: Scene, arrowId: string, label: BoardElement) {
371
+ const arrow = byId(s, arrowId);
372
+ const end = arrow.points?.[1] ?? [0, 0];
373
+ expect(label.x + label.width / 2).toBeCloseTo(arrow.x + (end[0] ?? 0) / 2);
374
+ expect(label.y + label.height / 2).toBeCloseTo(arrow.y + (end[1] ?? 0) / 2);
375
+ }
376
+
377
+ for (const order of ["label then move", "move then label"] as const) {
378
+ test(`arrow label follows a moved end (${order})`, async () => {
379
+ const ids = await board("reroute.excalidraw");
380
+ const label = { elementId: ids.arrow, label: "go" };
381
+ const move = { elementId: ids.b, y: 600 };
382
+ await updateBoardElements({
383
+ agentId,
384
+ path: "reroute.excalidraw",
385
+ patches: order === "label then move" ? [label, move] : [move, label],
386
+ });
387
+ const s = scene("reroute.excalidraw");
388
+ expectValidScene(s);
389
+ const text = expectLabel(s, ids.arrow, "go") as BoardElement;
390
+ expectArrowLabelCentered(s, ids.arrow, text);
391
+ expect(text.y + text.height / 2).toBeGreaterThan(300);
392
+ });
393
+ }
394
+
395
+ test("a shape label set, then moved and resized, stays centered", async () => {
396
+ const ids = await board("shape-move.excalidraw");
397
+ await updateBoardElements({
398
+ agentId,
399
+ path: "shape-move.excalidraw",
400
+ patches: [
401
+ { elementId: ids.a, label: "new" },
402
+ { elementId: ids.a, x: 50, y: 500, width: 300 },
403
+ ],
404
+ });
405
+ const s = scene("shape-move.excalidraw");
406
+ expectValidScene(s);
407
+ const a = byId(s, ids.a);
408
+ const text = expectLabel(s, ids.a, "new") as BoardElement;
409
+ expect(text.x + text.width / 2).toBeCloseTo(a.x + a.width / 2);
410
+ expect(text.y + text.height / 2).toBeCloseTo(a.y + a.height / 2);
411
+ });
412
+
413
+ for (const target of ["a", "arrow"] as const) {
414
+ const kind = target === "a" ? "shape" : "arrow";
415
+ test(`setting a ${kind} label twice keeps one live text`, async () => {
416
+ const ids = await board(`twice-${target}.excalidraw`);
417
+ const result = await updateBoardElements({
418
+ agentId,
419
+ path: `twice-${target}.excalidraw`,
420
+ patches: [
421
+ { elementId: ids[target], label: "first" },
422
+ { elementId: ids[target], label: "second" },
423
+ ],
424
+ });
425
+ expect(result.version).toBe(2);
426
+ const s = scene(`twice-${target}.excalidraw`);
427
+ expectValidScene(s);
428
+ const text = expectLabel(s, ids[target], "second") as BoardElement;
429
+ expect(text.version).toBe(1);
430
+ if (target === "arrow") expectArrowLabelCentered(s, ids.arrow, text);
431
+ expect((await getBoard({ agentId, path: `twice-${target}.excalidraw` })).elements).toEqual(
432
+ expect.arrayContaining([expect.objectContaining({ id: ids[target], text: "second" })]),
433
+ );
434
+ });
435
+
436
+ test(`setting then clearing a new ${kind} label leaves no text, not even a tombstone`, async () => {
437
+ const ids = await board(`clear-${target}.excalidraw`);
438
+ await updateBoardElements({
439
+ agentId,
440
+ path: `clear-${target}.excalidraw`,
441
+ patches: [
442
+ { elementId: ids[target], label: "temp" },
443
+ { elementId: ids[target], label: "" },
444
+ ],
445
+ });
446
+ const s = scene(`clear-${target}.excalidraw`);
447
+ expectValidScene(s);
448
+ expectLabel(s, ids[target], null);
449
+ expect(s.elements.filter((e) => e.containerId === ids[target])).toHaveLength(0);
450
+ });
451
+
452
+ test(`clearing a stored ${kind} label then setting a new one keeps one live text`, async () => {
453
+ const ids = await board(`reset-${target}.excalidraw`);
454
+ await updateBoardElements({
455
+ agentId,
456
+ path: `reset-${target}.excalidraw`,
457
+ patches: [{ elementId: ids[target], label: "old" }],
458
+ });
459
+ const oldId = expectLabel(scene(`reset-${target}.excalidraw`), ids[target], "old")?.id;
460
+ await updateBoardElements({
461
+ agentId,
462
+ path: `reset-${target}.excalidraw`,
463
+ patches: [
464
+ { elementId: ids[target], label: "" },
465
+ { elementId: ids[target], label: "new" },
466
+ { elementId: ids[target], label: "newer" },
467
+ ],
468
+ });
469
+ const s = scene(`reset-${target}.excalidraw`);
470
+ expectValidScene(s);
471
+ const text = expectLabel(s, ids[target], "newer") as BoardElement;
472
+ expect(text.id).not.toBe(oldId);
473
+ expect(byId(s, oldId ?? "").isDeleted).toBe(true);
474
+ });
475
+ }
476
+ });
477
+
478
+ test("updateElements refuses bad patches and writes nothing", async () => {
479
+ const { object, added } = await createBoard({
480
+ agentId,
481
+ path: "refuse.excalidraw",
482
+ shapes: [
483
+ { key: "a", type: "rectangle", label: "A" },
484
+ { key: "b", type: "rectangle", label: "B" },
485
+ ],
486
+ arrows: [{ from: "a", to: "b" }],
487
+ });
488
+ const s = scene("refuse.excalidraw");
489
+ const label = s.elements.find((e) => e.containerId === added.a);
490
+ const refusals: Array<[unknown, string]> = [
491
+ [{ elementId: "nope" }, "no live element 'nope'"],
492
+ [{ elementId: added["arrows[0]"], x: 5 }, "arrows follow the shapes"],
493
+ [{ elementId: label?.id }, "is the label of"],
494
+ [{ elementId: added.a, color: "chartreuse" }, "not a palette name"],
495
+ ];
496
+ for (const [patch, message] of refusals) {
497
+ await expect(
498
+ updateBoardElements({ agentId, id: object.id, patches: [patch as never] }),
499
+ ).rejects.toThrow(message);
500
+ }
501
+ expect(files.get("refuse.excalidraw")?.version).toBe(1);
502
+ });
503
+
504
+ test("removeElements sets isDeleted, takes labels along and unbinds arrows", async () => {
505
+ const { object, added } = await createBoard({
506
+ agentId,
507
+ path: "rm.excalidraw",
508
+ shapes: [
509
+ { key: "a", type: "rectangle", label: "A" },
510
+ { key: "b", type: "rectangle", label: "B" },
511
+ { key: "c", type: "rectangle", label: "C" },
512
+ ],
513
+ arrows: [
514
+ { from: "a", to: "b", label: "ab" },
515
+ { from: "b", to: "c" },
516
+ ],
517
+ });
518
+ const removed = await removeBoardElements({
519
+ agentId,
520
+ id: object.id,
521
+ elementIds: [added.a ?? "", added["arrows[1]"] ?? ""],
522
+ });
523
+ expect(removed.removed).toEqual([added.a, added["arrows[1]"]]);
524
+ const s = scene("rm.excalidraw");
525
+ expectValidScene(s);
526
+ const a = byId(s, added.a ?? "");
527
+ expect(a.isDeleted).toBe(true);
528
+ expect(s.elements.find((e) => e.containerId === a.id)?.isDeleted).toBe(true);
529
+ const ab = byId(s, added["arrows[0]"] ?? "");
530
+ expect(ab.isDeleted).toBe(false);
531
+ expect(ab.startBinding).toBeNull();
532
+ expect(ab.endBinding?.elementId).toBe(added.b);
533
+ expect(byId(s, added.c ?? "").boundElements?.some((r) => r.id === added["arrows[1]"])).toBe(
534
+ false,
535
+ );
536
+ // Summaries drop deleted elements.
537
+ const got = await getBoard({ agentId, id: object.id });
538
+ expect(got.elements.map((e) => e.id).sort()).toEqual(
539
+ [added.b, added.c, added["arrows[0]"]].sort() as string[],
540
+ );
541
+ await expect(
542
+ removeBoardElements({ agentId, id: object.id, elementIds: [added.a ?? ""] }),
543
+ ).rejects.toThrow("no live element");
544
+ });
545
+
546
+ test("invalid element input refuses before any write", async () => {
547
+ await expect(
548
+ createBoard({
549
+ agentId,
550
+ path: "bad.excalidraw",
551
+ shapes: [{ key: "a", type: "rectangle" }],
552
+ arrows: [{ from: "a", to: "ghost" }],
553
+ }),
554
+ ).rejects.toThrow("'ghost' is not a shape key");
555
+ expect(files.has("bad.excalidraw")).toBe(false);
556
+ const { object } = await createBoard({ agentId, path: "bad.excalidraw" });
557
+ const cases: Array<[Parameters<typeof addBoardElements>[0], string]> = [
558
+ [{ agentId, id: object.id, shapes: [{ type: "text" }] }, "needs a non-empty label"],
559
+ [
560
+ {
561
+ agentId,
562
+ id: object.id,
563
+ shapes: [
564
+ { key: "x", type: "rectangle" },
565
+ { key: "x", type: "ellipse" },
566
+ ],
567
+ },
568
+ "duplicate key",
569
+ ],
570
+ [
571
+ {
572
+ agentId,
573
+ id: object.id,
574
+ shapes: [{ key: "x", type: "rectangle" }],
575
+ arrows: [{ from: "x", to: "x" }],
576
+ },
577
+ "two different shapes",
578
+ ],
579
+ [{ agentId, id: object.id }, "at least one shape or arrow"],
580
+ [{ agentId, id: "no-such-board", shapes: [{ type: "rectangle" }] }, "no object with id"],
581
+ [{ agentId, shapes: [{ type: "rectangle" }] }, "pass `id` or `path`"],
582
+ ];
583
+ for (const [input, message] of cases) {
584
+ await expect(addBoardElements(input)).rejects.toThrow(message);
585
+ }
586
+ expect(files.get("bad.excalidraw")?.version).toBe(1);
587
+ });
588
+
589
+ test("a stock Excalidraw save that dropped swarm.id still resolves by path and heals", async () => {
590
+ const { object } = await createBoard({ agentId, path: "stock.excalidraw" });
591
+ files.set("stock.excalidraw", {
592
+ body: JSON.stringify({
593
+ type: "excalidraw",
594
+ version: 2,
595
+ source: "https://excalidraw.com",
596
+ elements: [],
597
+ }),
598
+ version: 2,
599
+ });
600
+ const got = await getBoard({ agentId, path: "stock.excalidraw" });
601
+ expect(got.object.id).toBe(object.id);
602
+ const next = await addBoardElements({
603
+ agentId,
604
+ path: "stock.excalidraw",
605
+ shapes: [{ type: "rectangle", label: "back" }],
606
+ });
607
+ expect(next.version).toBe(3);
608
+ expect(scene("stock.excalidraw").swarm?.id).toBe(object.id);
609
+ });
610
+
611
+ test("a 409 re-reads and re-applies, so a concurrent write merges", async () => {
612
+ const { object } = await createBoard({ agentId, path: "race.excalidraw" });
613
+ let raced = false;
614
+ beforeWrite = (path) => {
615
+ if (raced) return;
616
+ raced = true;
617
+ // Another writer lands one element between our read and our write.
618
+ const current = files.get(path);
619
+ const s = JSON.parse(current?.body ?? "{}");
620
+ s.elements.push({
621
+ id: "theirs",
622
+ type: "rectangle",
623
+ x: 0,
624
+ y: 0,
625
+ width: 10,
626
+ height: 10,
627
+ index: "a0",
628
+ });
629
+ files.set(path, { body: JSON.stringify(s), version: (current?.version ?? 0) + 1 });
630
+ };
631
+ const result = await addBoardElements({
632
+ agentId,
633
+ id: object.id,
634
+ shapes: [{ key: "mine", type: "rectangle", label: "mine" }],
635
+ });
636
+ expect(result.version).toBe(3);
637
+ const ids = scene("race.excalidraw").elements.map((e) => e.id);
638
+ expect(ids).toContain("theirs");
639
+ expect(ids).toContain(result.added.mine);
640
+ const row = await getDbClient().get<{ fileVersion: number }>(
641
+ "SELECT fileVersion FROM primitive_objects WHERE id = ?",
642
+ [object.id],
643
+ );
644
+ expect(row?.fileVersion).toBe(3);
645
+ });
646
+
647
+ test("the 4th conflict in a row refuses and writes nothing of ours", async () => {
648
+ const { object } = await createBoard({ agentId, path: "busy.excalidraw" });
649
+ let conflicts = 0;
650
+ beforeWrite = (path) => {
651
+ conflicts += 1;
652
+ const current = files.get(path);
653
+ if (current) files.set(path, { ...current, version: current.version + 1 });
654
+ };
655
+ await expect(
656
+ addBoardElements({ agentId, id: object.id, shapes: [{ type: "rectangle" }] }),
657
+ ).rejects.toThrow("concurrent writers");
658
+ expect(conflicts).toBe(4);
659
+ expect(scene("busy.excalidraw").elements).toEqual([]);
660
+ });
661
+
662
+ test("a write over the size cap refuses", async () => {
663
+ const { object } = await createBoard({ agentId, path: "big.excalidraw" });
664
+ await expect(
665
+ mutateObject({
666
+ agentId,
667
+ id: object.id,
668
+ kind: "board",
669
+ message: "too big",
670
+ mutate: (content) => {
671
+ content.padding = "x".repeat(MAX_OBJECT_BYTES);
672
+ },
673
+ }),
674
+ ).rejects.toThrow("would exceed");
675
+ expect(files.get("big.excalidraw")?.version).toBe(1);
676
+ });
677
+
678
+ test("text measuring scales with length, lines and font size", () => {
679
+ const one = measureText("Lead", 20);
680
+ expect(measureText("Lead triages", 20).width).toBeGreaterThan(one.width);
681
+ expect(measureText("Lead\ntriages", 20).height).toBe(Math.ceil(2 * 20 * 1.25));
682
+ expect(measureText("Lead", 40).width).toBeGreaterThanOrEqual(2 * one.width - 1);
683
+ // Narrow and wide glyphs differ (a real table, not a monospace fallback).
684
+ expect(measureText("iiii", 20).width).toBeLessThan(measureText("WWWW", 20).width);
685
+ });
686
+ });