@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,717 @@
1
+ import { generateNKeysBetween } from "fractional-indexing";
2
+ import { ObjectsError } from "../objects";
3
+ import metrics from "./excalifont-metrics.json";
4
+
5
+ /**
6
+ * Raw Excalidraw element JSON, built without a browser or the Excalidraw
7
+ * package. Text sizes come from a committed Excalifont advance-width table
8
+ * (scripts/gen-excalifont-metrics.ts), so they are estimates: the embed
9
+ * re-measures on open (`restoreElements(…, { refreshDimensions: true })`).
10
+ */
11
+
12
+ export const SHAPE_TYPES = ["rectangle", "ellipse", "diamond", "text"] as const;
13
+ export type ShapeType = (typeof SHAPE_TYPES)[number];
14
+ export const LAYOUTS = ["row", "column", "grid"] as const;
15
+ export type Layout = (typeof LAYOUTS)[number];
16
+
17
+ /** Open-color pairs, Excalidraw's own palette: [stroke, background]. */
18
+ export const PALETTE: Readonly<Record<string, readonly [string, string]>> = {
19
+ blue: ["#1971c2", "#a5d8ff"],
20
+ green: ["#2f9e44", "#b2f2bb"],
21
+ yellow: ["#f08c00", "#ffec99"],
22
+ red: ["#e03131", "#ffc9c9"],
23
+ violet: ["#6741d9", "#d0bfff"],
24
+ orange: ["#e8590c", "#ffd8a8"],
25
+ gray: ["#495057", "#e9ecef"],
26
+ teal: ["#0c8599", "#96f2d7"],
27
+ };
28
+
29
+ export type ShapeInput = {
30
+ key?: string;
31
+ type: ShapeType;
32
+ x?: number;
33
+ y?: number;
34
+ width?: number;
35
+ height?: number;
36
+ label?: string;
37
+ color?: string;
38
+ };
39
+ export type ArrowInput = { from: string; to: string; label?: string };
40
+ export type ElementPatch = {
41
+ elementId: string;
42
+ label?: string;
43
+ x?: number;
44
+ y?: number;
45
+ width?: number;
46
+ height?: number;
47
+ color?: string;
48
+ };
49
+
50
+ type Binding = { elementId: string; focus: number; gap: number };
51
+ type BoundRef = { id: string; type: string };
52
+
53
+ /** One Excalidraw element. Unknown fields from stock Excalidraw pass through. */
54
+ export type BoardElement = {
55
+ id: string;
56
+ type: string;
57
+ x: number;
58
+ y: number;
59
+ width: number;
60
+ height: number;
61
+ version?: number;
62
+ versionNonce?: number;
63
+ updated?: number;
64
+ isDeleted?: boolean;
65
+ index?: string | null;
66
+ boundElements?: BoundRef[] | null;
67
+ containerId?: string | null;
68
+ startBinding?: Binding | null;
69
+ endBinding?: Binding | null;
70
+ text?: string;
71
+ originalText?: string;
72
+ fontSize?: number;
73
+ points?: number[][];
74
+ strokeColor?: string;
75
+ backgroundColor?: string;
76
+ [key: string]: unknown;
77
+ };
78
+
79
+ export type Scene = { elements: BoardElement[]; [key: string]: unknown };
80
+
81
+ export type ElementSummary = {
82
+ id: string;
83
+ type: string;
84
+ text: string | null;
85
+ x: number;
86
+ y: number;
87
+ width: number;
88
+ height: number;
89
+ /** Arrow: `[from, to]` element ids (null when unbound). Shape: ids of its bound arrows. */
90
+ boundTo: Array<string | null>;
91
+ };
92
+
93
+ const STROKE = "#1e1e1e";
94
+ const FONT_FAMILY_EXCALIFONT = 5;
95
+ const LINE_HEIGHT = metrics.lineHeight;
96
+ const SHAPE_FONT_SIZE = 20;
97
+ const ARROW_FONT_SIZE = 16;
98
+ // Excalidraw's BOUND_TEXT_PADDING, plus breathing room around a label.
99
+ const BOUND_TEXT_PADDING = 5;
100
+ const LABEL_MARGIN = 20;
101
+ const DEFAULT_SIZE = { width: 200, height: 80 };
102
+ const BINDING_GAP = 4;
103
+ const LAYOUT_GAP = 80;
104
+ // Sum-of-advances is within ~3% of a real measure (kerning); round up past it.
105
+ const WIDTH_SAFETY = 1.05;
106
+ const HEX = /^#[0-9a-fA-F]{6}$/;
107
+ const ID_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-";
108
+
109
+ const widths = metrics.widths as Record<string, number>;
110
+
111
+ /** Estimated Excalifont text box, as Excalidraw lays it out (no wrapping). */
112
+ export function measureText(text: string, fontSize: number): { width: number; height: number } {
113
+ const lines = text.split("\n");
114
+ const em = Math.max(
115
+ ...lines.map((line) =>
116
+ [...line].reduce((sum, char) => {
117
+ const known = widths[char];
118
+ if (known !== undefined) return sum + known;
119
+ // CJK and emoji render in Excalidraw's fallback fonts at about one em.
120
+ return sum + ((char.codePointAt(0) ?? 0) >= 0x2e80 ? metrics.wide : metrics.fallback);
121
+ }, 0),
122
+ ),
123
+ );
124
+ return {
125
+ width: Math.max(1, Math.ceil(em * fontSize * WIDTH_SAFETY)),
126
+ height: Math.ceil(lines.length * fontSize * LINE_HEIGHT),
127
+ };
128
+ }
129
+
130
+ const randomInt = (): number => (crypto.getRandomValues(new Uint32Array(1))[0] ?? 1) >>> 1 || 1;
131
+
132
+ function newElementId(): string {
133
+ const bytes = crypto.getRandomValues(new Uint8Array(21));
134
+ return Array.from(bytes, (b) => ID_ALPHABET[b & 63]).join("");
135
+ }
136
+
137
+ function colorPair(color: string | undefined, where: string): [string, string] | undefined {
138
+ if (color === undefined) return undefined;
139
+ const named = Object.hasOwn(PALETTE, color) ? PALETTE[color] : undefined;
140
+ if (named) return [named[0], named[1]];
141
+ if (HEX.test(color)) return [STROKE, color];
142
+ throw new ObjectsError(
143
+ `${where}: color '${color}' is not a palette name (${Object.keys(PALETTE).join(", ")}) or #rrggbb`,
144
+ );
145
+ }
146
+
147
+ function baseElement(
148
+ type: string,
149
+ geometry: { x: number; y: number; width: number; height: number },
150
+ now: number,
151
+ ): BoardElement {
152
+ return {
153
+ id: newElementId(),
154
+ type,
155
+ ...geometry,
156
+ angle: 0,
157
+ strokeColor: STROKE,
158
+ backgroundColor: "transparent",
159
+ fillStyle: "solid",
160
+ strokeWidth: 2,
161
+ strokeStyle: "solid",
162
+ roughness: 1,
163
+ opacity: 100,
164
+ groupIds: [],
165
+ frameId: null,
166
+ index: null,
167
+ roundness:
168
+ type === "rectangle"
169
+ ? { type: 3 }
170
+ : type === "diamond" || type === "arrow"
171
+ ? { type: 2 }
172
+ : null,
173
+ seed: randomInt(),
174
+ version: 1,
175
+ versionNonce: randomInt(),
176
+ isDeleted: false,
177
+ boundElements: [],
178
+ updated: now,
179
+ link: null,
180
+ locked: false,
181
+ };
182
+ }
183
+
184
+ function textElement(
185
+ text: string,
186
+ fontSize: number,
187
+ at: { x: number; y: number },
188
+ containerId: string | null,
189
+ now: number,
190
+ ): BoardElement {
191
+ const size = measureText(text, fontSize);
192
+ return {
193
+ ...baseElement("text", { ...at, ...size }, now),
194
+ boundElements: null,
195
+ text,
196
+ originalText: text,
197
+ fontSize,
198
+ fontFamily: FONT_FAMILY_EXCALIFONT,
199
+ textAlign: containerId ? "center" : "left",
200
+ verticalAlign: containerId ? "middle" : "top",
201
+ containerId,
202
+ autoResize: true,
203
+ lineHeight: LINE_HEIGHT,
204
+ };
205
+ }
206
+
207
+ /** Smallest container that fits a label inside Excalidraw's bound-text box for that shape. */
208
+ function fitContainer(
209
+ type: string,
210
+ label: { width: number; height: number },
211
+ min: { width: number; height: number },
212
+ ): { width: number; height: number } {
213
+ const inner = {
214
+ width: label.width + 2 * BOUND_TEXT_PADDING + LABEL_MARGIN,
215
+ height: label.height + 2 * BOUND_TEXT_PADDING + LABEL_MARGIN,
216
+ };
217
+ // Excalidraw's getBoundTextMaxWidth: an ellipse fits w/2·√2, a diamond w/2.
218
+ const scale = type === "ellipse" ? Math.SQRT2 : type === "diamond" ? 2 : 1;
219
+ return {
220
+ width: Math.max(min.width, Math.ceil(inner.width * scale)),
221
+ height: Math.max(min.height, Math.ceil(inner.height * scale)),
222
+ };
223
+ }
224
+
225
+ const center = (e: BoardElement) => ({ x: e.x + e.width / 2, y: e.y + e.height / 2 });
226
+
227
+ function centerLabel(container: BoardElement, label: BoardElement): void {
228
+ if (container.type === "arrow") {
229
+ const points = container.points ?? [[0, 0]];
230
+ const first = points[0] ?? [0, 0];
231
+ const last = points[points.length - 1] ?? first;
232
+ label.x = container.x + ((first[0] ?? 0) + (last[0] ?? 0)) / 2 - label.width / 2;
233
+ label.y = container.y + ((first[1] ?? 0) + (last[1] ?? 0)) / 2 - label.height / 2;
234
+ return;
235
+ }
236
+ const c = center(container);
237
+ label.x = c.x - label.width / 2;
238
+ label.y = c.y - label.height / 2;
239
+ }
240
+
241
+ type Box = { x: number; y: number; width: number; height: number; bound: boolean };
242
+
243
+ /** Straight arrow between the facing sides of two boxes, on the dominant axis. */
244
+ function route(from: Box, to: Box): { start: [number, number]; end: [number, number] } {
245
+ const a = { x: from.x + from.width / 2, y: from.y + from.height / 2 };
246
+ const b = { x: to.x + to.width / 2, y: to.y + to.height / 2 };
247
+ const dx = b.x - a.x;
248
+ const dy = b.y - a.y;
249
+ const gapFrom = from.bound ? BINDING_GAP : 0;
250
+ const gapTo = to.bound ? BINDING_GAP : 0;
251
+ if (Math.abs(dx) >= Math.abs(dy)) {
252
+ const s = dx >= 0 ? 1 : -1;
253
+ return {
254
+ start: [a.x + s * (from.width / 2 + gapFrom), a.y],
255
+ end: [b.x - s * (to.width / 2 + gapTo), b.y],
256
+ };
257
+ }
258
+ const s = dy >= 0 ? 1 : -1;
259
+ return {
260
+ start: [a.x, a.y + s * (from.height / 2 + gapFrom)],
261
+ end: [b.x, b.y - s * (to.height / 2 + gapTo)],
262
+ };
263
+ }
264
+
265
+ function placeArrow(arrow: BoardElement, from: Box, to: Box): void {
266
+ const { start, end } = route(from, to);
267
+ arrow.x = start[0];
268
+ arrow.y = start[1];
269
+ arrow.points = [
270
+ [0, 0],
271
+ [end[0] - start[0], end[1] - start[1]],
272
+ ];
273
+ arrow.width = Math.abs(end[0] - start[0]);
274
+ arrow.height = Math.abs(end[1] - start[1]);
275
+ }
276
+
277
+ function boxOf(element: BoardElement): Box {
278
+ return { x: element.x, y: element.y, width: element.width, height: element.height, bound: true };
279
+ }
280
+
281
+ /** An arrow's unbound end as a zero-size box at its current absolute point. */
282
+ function pointBox(arrow: BoardElement, end: "start" | "end"): Box {
283
+ const points = arrow.points ?? [[0, 0]];
284
+ const p = (end === "start" ? points[0] : points[points.length - 1]) ?? [0, 0];
285
+ return { x: arrow.x + (p[0] ?? 0), y: arrow.y + (p[1] ?? 0), width: 0, height: 0, bound: false };
286
+ }
287
+
288
+ export function parseScene(content: unknown, path: string): Scene {
289
+ if (!content || typeof content !== "object" || Array.isArray(content)) {
290
+ throw new ObjectsError(`'${path}' is not an Excalidraw scene (not a JSON object)`);
291
+ }
292
+ const scene = content as Scene;
293
+ if (scene.elements === undefined) scene.elements = [];
294
+ if (!Array.isArray(scene.elements)) {
295
+ throw new ObjectsError(`'${path}' is not an Excalidraw scene (elements is not an array)`);
296
+ }
297
+ for (const element of scene.elements) {
298
+ if (!element || typeof element.id !== "string" || typeof element.type !== "string") {
299
+ throw new ObjectsError(`'${path}' has an element without a string id and type`);
300
+ }
301
+ }
302
+ return scene;
303
+ }
304
+
305
+ const live = (scene: Scene) => scene.elements.filter((e) => !e.isDeleted);
306
+
307
+ function liveById(scene: Scene): Map<string, BoardElement> {
308
+ return new Map(live(scene).map((e) => [e.id, e]));
309
+ }
310
+
311
+ const labelOf = (scene: Scene, container: BoardElement): BoardElement | undefined =>
312
+ live(scene).find((e) => e.type === "text" && e.containerId === container.id);
313
+
314
+ function bump(elements: Iterable<BoardElement>, now: number): void {
315
+ for (const element of new Set(elements)) {
316
+ element.version = (typeof element.version === "number" ? element.version : 0) + 1;
317
+ element.versionNonce = randomInt();
318
+ element.updated = now;
319
+ }
320
+ }
321
+
322
+ function addRef(element: BoardElement, ref: BoundRef): void {
323
+ const refs = Array.isArray(element.boundElements) ? element.boundElements : [];
324
+ if (!refs.some((r) => r.id === ref.id)) refs.push(ref);
325
+ element.boundElements = refs;
326
+ }
327
+
328
+ function dropRef(element: BoardElement, id: string): void {
329
+ if (Array.isArray(element.boundElements)) {
330
+ element.boundElements = element.boundElements.filter((r) => r.id !== id);
331
+ }
332
+ }
333
+
334
+ /** Give appended elements fractional `index` keys above every existing one. */
335
+ function assignIndexes(scene: Scene, added: BoardElement[]): void {
336
+ if (added.length === 0) return;
337
+ const existing = scene.elements
338
+ .filter((e) => !added.includes(e))
339
+ .map((e) => e.index)
340
+ .filter((i): i is string => typeof i === "string")
341
+ .sort();
342
+ let keys: string[];
343
+ try {
344
+ keys = generateNKeysBetween(existing[existing.length - 1] ?? null, null, added.length);
345
+ } catch {
346
+ // An invalid stored index: Excalidraw repairs order on load (syncInvalidIndices).
347
+ keys = generateNKeysBetween(null, null, added.length);
348
+ }
349
+ added.forEach((element, i) => {
350
+ element.index = keys[i] ?? null;
351
+ });
352
+ }
353
+
354
+ /** Where shapes without coordinates start: below the scene's live content. */
355
+ function layoutOrigin(scene: Scene): { x: number; y: number } {
356
+ const elements = live(scene);
357
+ if (elements.length === 0) return { x: 0, y: 0 };
358
+ return {
359
+ x: Math.min(...elements.map((e) => e.x)),
360
+ y: Math.max(...elements.map((e) => e.y + e.height)) + LAYOUT_GAP,
361
+ };
362
+ }
363
+
364
+ function layoutPositions(
365
+ sizes: Array<{ width: number; height: number }>,
366
+ layout: Layout,
367
+ origin: { x: number; y: number },
368
+ ): Array<{ x: number; y: number }> {
369
+ if (layout === "grid") {
370
+ const cols = Math.max(1, Math.ceil(Math.sqrt(sizes.length)));
371
+ const cellW = Math.max(...sizes.map((s) => s.width), 0);
372
+ const cellH = Math.max(...sizes.map((s) => s.height), 0);
373
+ return sizes.map((s, i) => ({
374
+ x: origin.x + (i % cols) * (cellW + LAYOUT_GAP) + (cellW - s.width) / 2,
375
+ y: origin.y + Math.floor(i / cols) * (cellH + LAYOUT_GAP) + (cellH - s.height) / 2,
376
+ }));
377
+ }
378
+ let cursor = 0;
379
+ return sizes.map((s) => {
380
+ const at =
381
+ layout === "row"
382
+ ? { x: origin.x + cursor, y: origin.y }
383
+ : { x: origin.x, y: origin.y + cursor };
384
+ cursor += (layout === "row" ? s.width : s.height) + LAYOUT_GAP;
385
+ return at;
386
+ });
387
+ }
388
+
389
+ /**
390
+ * Append shapes and arrows to `scene` in place. Arrow ends name a shape `key`
391
+ * from this call or an existing element id; both ends are bound two-way.
392
+ * Returns `added`: each shape's key (or `shapes[i]`) and `arrows[i]` → element id.
393
+ */
394
+ export function addElements(
395
+ scene: Scene,
396
+ input: { shapes?: ShapeInput[]; arrows?: ArrowInput[]; layout?: Layout },
397
+ now = Date.now(),
398
+ ): Record<string, string> {
399
+ const shapes = input.shapes ?? [];
400
+ const arrows = input.arrows ?? [];
401
+ const byKey = new Map<string, BoardElement>();
402
+ const keys = new Set<string>();
403
+ const added: Record<string, string> = {};
404
+ const appended: BoardElement[] = [];
405
+ const touched: BoardElement[] = [];
406
+ const existing = liveById(scene);
407
+
408
+ // Size every shape first, so the layout can use real sizes.
409
+ const planned = shapes.map((shape, i) => {
410
+ const where = `shapes[${i}]`;
411
+ if (shape.key !== undefined) {
412
+ if (keys.has(shape.key)) throw new ObjectsError(`${where}: duplicate key '${shape.key}'`);
413
+ keys.add(shape.key);
414
+ }
415
+ const label = shape.label ?? "";
416
+ if (shape.type === "text" && label.trim() === "") {
417
+ throw new ObjectsError(`${where}: a text shape needs a non-empty label`);
418
+ }
419
+ const colors = colorPair(shape.color, where);
420
+ const min = {
421
+ width: shape.width ?? DEFAULT_SIZE.width,
422
+ height: shape.height ?? DEFAULT_SIZE.height,
423
+ };
424
+ const labelSize = label ? measureText(label, SHAPE_FONT_SIZE) : { width: 0, height: 0 };
425
+ const size = shape.type === "text" ? labelSize : fitContainer(shape.type, labelSize, min);
426
+ return { shape, label, colors, size };
427
+ });
428
+
429
+ const auto = planned.filter((p) => p.shape.x === undefined || p.shape.y === undefined);
430
+ const positions = layoutPositions(
431
+ auto.map((p) => p.size),
432
+ input.layout ?? "row",
433
+ layoutOrigin(scene),
434
+ );
435
+
436
+ for (const [i, p] of planned.entries()) {
437
+ const slot = auto.indexOf(p);
438
+ const at = slot >= 0 ? positions[slot] : undefined;
439
+ const x = p.shape.x ?? at?.x ?? 0;
440
+ const y = p.shape.y ?? at?.y ?? 0;
441
+ let element: BoardElement;
442
+ if (p.shape.type === "text") {
443
+ element = textElement(p.label, SHAPE_FONT_SIZE, { x, y }, null, now);
444
+ if (p.colors) element.strokeColor = p.colors[0];
445
+ appended.push(element);
446
+ } else {
447
+ element = baseElement(p.shape.type, { x, y, ...p.size }, now);
448
+ if (p.colors) [element.strokeColor, element.backgroundColor] = p.colors;
449
+ appended.push(element);
450
+ if (p.label) {
451
+ const text = textElement(p.label, SHAPE_FONT_SIZE, { x, y }, element.id, now);
452
+ centerLabel(element, text);
453
+ addRef(element, { type: "text", id: text.id });
454
+ appended.push(text);
455
+ }
456
+ }
457
+ if (p.shape.key !== undefined) byKey.set(p.shape.key, element);
458
+ added[p.shape.key ?? `shapes[${i}]`] = element.id;
459
+ }
460
+
461
+ const resolve = (ref: string, where: string): BoardElement => {
462
+ const element = byKey.get(ref) ?? existing.get(ref);
463
+ if (!element) {
464
+ throw new ObjectsError(
465
+ `${where}: '${ref}' is not a shape key in this call or a live element id`,
466
+ );
467
+ }
468
+ if (element.type === "arrow" || element.type === "line" || element.containerId) {
469
+ throw new ObjectsError(
470
+ `${where}: '${ref}' is a ${element.containerId ? "label" : element.type}; bind arrows to shapes`,
471
+ );
472
+ }
473
+ return element;
474
+ };
475
+
476
+ for (const [i, input] of arrows.entries()) {
477
+ const where = `arrows[${i}]`;
478
+ const from = resolve(input.from, `${where}.from`);
479
+ const to = resolve(input.to, `${where}.to`);
480
+ if (from === to) throw new ObjectsError(`${where}: an arrow needs two different shapes`);
481
+ const arrow: BoardElement = {
482
+ ...baseElement("arrow", { x: 0, y: 0, width: 0, height: 0 }, now),
483
+ points: [],
484
+ lastCommittedPoint: null,
485
+ startBinding: { elementId: from.id, focus: 0, gap: BINDING_GAP },
486
+ endBinding: { elementId: to.id, focus: 0, gap: BINDING_GAP },
487
+ startArrowhead: null,
488
+ endArrowhead: "arrow",
489
+ elbowed: false,
490
+ };
491
+ placeArrow(arrow, boxOf(from), boxOf(to));
492
+ addRef(from, { type: "arrow", id: arrow.id });
493
+ addRef(to, { type: "arrow", id: arrow.id });
494
+ for (const end of [from, to]) if (!appended.includes(end)) touched.push(end);
495
+ appended.push(arrow);
496
+ if (input.label) {
497
+ const text = textElement(input.label, ARROW_FONT_SIZE, { x: 0, y: 0 }, arrow.id, now);
498
+ text.textAlign = "center";
499
+ text.verticalAlign = "middle";
500
+ centerLabel(arrow, text);
501
+ addRef(arrow, { type: "text", id: text.id });
502
+ appended.push(text);
503
+ }
504
+ added[`arrows[${i}]`] = arrow.id;
505
+ }
506
+
507
+ scene.elements.push(...appended);
508
+ assignIndexes(scene, appended);
509
+ bump(touched, now);
510
+ return added;
511
+ }
512
+
513
+ /** Re-route every live arrow bound to `element` from its ends' current geometry. */
514
+ function rerouteArrows(scene: Scene, element: BoardElement, touched: BoardElement[]): void {
515
+ const byId = liveById(scene);
516
+ for (const arrow of live(scene)) {
517
+ if (arrow.type !== "arrow") continue;
518
+ const startId = arrow.startBinding?.elementId;
519
+ const endId = arrow.endBinding?.elementId;
520
+ if (startId !== element.id && endId !== element.id) continue;
521
+ const start = startId ? byId.get(startId) : undefined;
522
+ const end = endId ? byId.get(endId) : undefined;
523
+ // shortcut: re-routing straightens a multi-point arrow; keep bends when hand-drawn routes matter.
524
+ placeArrow(
525
+ arrow,
526
+ start ? boxOf(start) : pointBox(arrow, "start"),
527
+ end ? boxOf(end) : pointBox(arrow, "end"),
528
+ );
529
+ touched.push(arrow);
530
+ const label = labelOf(scene, arrow);
531
+ if (label) {
532
+ centerLabel(arrow, label);
533
+ touched.push(label);
534
+ }
535
+ }
536
+ }
537
+
538
+ /**
539
+ * Set or clear `element`'s label. A new label joins `scene.elements` at once,
540
+ * so later patches in the same call (and arrow re-routing) see it; it is also
541
+ * recorded in `appended` so the caller indexes it once at the end.
542
+ */
543
+ function setLabel(
544
+ scene: Scene,
545
+ element: BoardElement,
546
+ label: string,
547
+ now: number,
548
+ touched: BoardElement[],
549
+ appended: BoardElement[],
550
+ ): void {
551
+ if (element.type === "text") {
552
+ if (label.trim() === "")
553
+ throw new ObjectsError(`${element.id}: a text element needs a non-empty label`);
554
+ const size = measureText(label, element.fontSize ?? SHAPE_FONT_SIZE);
555
+ Object.assign(element, { text: label, originalText: label, ...size });
556
+ return;
557
+ }
558
+ const existing = labelOf(scene, element);
559
+ if (label === "") {
560
+ if (existing) {
561
+ dropRef(element, existing.id);
562
+ if (appended.includes(existing)) {
563
+ // Created earlier in this call and never persisted: drop it, no tombstone.
564
+ scene.elements.splice(scene.elements.indexOf(existing), 1);
565
+ appended.splice(appended.indexOf(existing), 1);
566
+ } else {
567
+ existing.isDeleted = true;
568
+ touched.push(existing);
569
+ }
570
+ }
571
+ return;
572
+ }
573
+ const fontSize = element.type === "arrow" ? ARROW_FONT_SIZE : SHAPE_FONT_SIZE;
574
+ if (existing) {
575
+ Object.assign(existing, {
576
+ text: label,
577
+ originalText: label,
578
+ ...measureText(label, existing.fontSize ?? fontSize),
579
+ });
580
+ touched.push(existing);
581
+ return;
582
+ }
583
+ const text = textElement(label, fontSize, { x: element.x, y: element.y }, element.id, now);
584
+ text.textAlign = "center";
585
+ text.verticalAlign = "middle";
586
+ addRef(element, { type: "text", id: text.id });
587
+ scene.elements.push(text);
588
+ appended.push(text);
589
+ }
590
+
591
+ /** Apply patches in place. Returns the patched ids. */
592
+ export function updateElements(scene: Scene, patches: ElementPatch[], now = Date.now()): string[] {
593
+ const byId = liveById(scene);
594
+ const touched: BoardElement[] = [];
595
+ const appended: BoardElement[] = [];
596
+ for (const [i, patch] of patches.entries()) {
597
+ const where = `patches[${i}]`;
598
+ const element = byId.get(patch.elementId);
599
+ if (!element) throw new ObjectsError(`${where}: no live element '${patch.elementId}'`);
600
+ if (element.type === "text" && element.containerId) {
601
+ throw new ObjectsError(
602
+ `${where}: '${element.id}' is the label of '${element.containerId}'; patch that element`,
603
+ );
604
+ }
605
+ const moves = [patch.x, patch.y, patch.width, patch.height].some((v) => v !== undefined);
606
+ if (element.type === "arrow" && moves) {
607
+ throw new ObjectsError(
608
+ `${where}: arrows follow the shapes they bind; move or resize the shapes`,
609
+ );
610
+ }
611
+ touched.push(element);
612
+ const colors = colorPair(patch.color, where);
613
+ if (colors) {
614
+ element.strokeColor = colors[0];
615
+ if (element.type !== "text" && element.type !== "arrow") element.backgroundColor = colors[1];
616
+ }
617
+ if (patch.x !== undefined) element.x = patch.x;
618
+ if (patch.y !== undefined) element.y = patch.y;
619
+ if (patch.width !== undefined) element.width = patch.width;
620
+ if (patch.height !== undefined) element.height = patch.height;
621
+ if (patch.label !== undefined) setLabel(scene, element, patch.label, now, touched, appended);
622
+ const label = element.type === "text" ? undefined : labelOf(scene, element);
623
+ if (label) {
624
+ // A smaller explicit size still has to fit the label.
625
+ if (element.type !== "arrow") {
626
+ Object.assign(element, fitContainer(element.type, label, element));
627
+ }
628
+ centerLabel(element, label);
629
+ touched.push(label);
630
+ }
631
+ if (element.type !== "arrow" && (moves || patch.label !== undefined))
632
+ rerouteArrows(scene, element, touched);
633
+ }
634
+ assignIndexes(scene, appended);
635
+ bump(
636
+ touched.filter((e) => !appended.includes(e)),
637
+ now,
638
+ );
639
+ return patches.map((p) => p.elementId);
640
+ }
641
+
642
+ /**
643
+ * Mark elements deleted in place (`isDeleted: true`, the Excalidraw
644
+ * convention). A shape takes its label with it and unbinds its arrows; an
645
+ * arrow leaves its shapes' `boundElements`.
646
+ */
647
+ export function removeElements(scene: Scene, elementIds: string[], now = Date.now()): string[] {
648
+ const byId = liveById(scene);
649
+ const unknown = elementIds.filter((id) => !byId.has(id));
650
+ if (unknown.length > 0) throw new ObjectsError(`no live element: ${unknown.join(", ")}`);
651
+ const touched: BoardElement[] = [];
652
+ for (const id of new Set(elementIds)) {
653
+ const element = byId.get(id);
654
+ if (!element || element.isDeleted) continue;
655
+ element.isDeleted = true;
656
+ touched.push(element);
657
+ if (element.containerId) {
658
+ const container = byId.get(element.containerId);
659
+ if (container) {
660
+ dropRef(container, element.id);
661
+ touched.push(container);
662
+ }
663
+ }
664
+ const label = labelOf(scene, element);
665
+ if (label) {
666
+ label.isDeleted = true;
667
+ touched.push(label);
668
+ }
669
+ if (element.type === "arrow") {
670
+ for (const binding of [element.startBinding, element.endBinding]) {
671
+ const end = binding ? byId.get(binding.elementId) : undefined;
672
+ if (end) {
673
+ dropRef(end, element.id);
674
+ touched.push(end);
675
+ }
676
+ }
677
+ continue;
678
+ }
679
+ for (const arrow of live(scene)) {
680
+ if (arrow.type !== "arrow") continue;
681
+ if (arrow.startBinding?.elementId === element.id) arrow.startBinding = null;
682
+ else if (arrow.endBinding?.elementId === element.id) arrow.endBinding = null;
683
+ else continue;
684
+ touched.push(arrow);
685
+ }
686
+ }
687
+ bump(touched, now);
688
+ return [...new Set(elementIds)];
689
+ }
690
+
691
+ /** One line per live element; a shape's label folds into its `text`. */
692
+ export function summarize(scene: Scene): ElementSummary[] {
693
+ const elements = live(scene);
694
+ const labels = new Map(
695
+ elements
696
+ .filter((e) => e.type === "text" && e.containerId)
697
+ .map((e) => [e.containerId, e.text ?? ""]),
698
+ );
699
+ const liveIds = new Set(elements.map((e) => e.id));
700
+ return elements
701
+ .filter((e) => !(e.type === "text" && e.containerId))
702
+ .map((e) => ({
703
+ id: e.id,
704
+ type: e.type,
705
+ text: e.type === "text" ? (e.text ?? "") : (labels.get(e.id) ?? null),
706
+ x: e.x,
707
+ y: e.y,
708
+ width: e.width,
709
+ height: e.height,
710
+ boundTo:
711
+ e.type === "arrow"
712
+ ? [e.startBinding?.elementId ?? null, e.endBinding?.elementId ?? null]
713
+ : (e.boundElements ?? [])
714
+ .filter((r) => r.type === "arrow" && liveIds.has(r.id))
715
+ .map((r) => r.id),
716
+ }));
717
+ }