@desplega.ai/agent-swarm 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
  3. package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
  19. package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
  20. package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
  21. package/dist/cli-0jkenasr.js +148 -0
  22. package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
  23. package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
  24. package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
  25. package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
  26. package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
  29. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  30. package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
  31. package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
  32. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  33. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  34. package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
  35. package/dist/cli-7dbhnsj9.js +681 -0
  36. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  37. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  38. package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
  39. package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
  40. package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
  41. package/dist/cli-avqkr20b.js +69 -0
  42. package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
  43. package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
  44. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  45. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  46. package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
  47. package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
  48. package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
  49. package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
  50. package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
  51. package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
  52. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  53. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  54. package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
  55. package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
  56. package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
  57. package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
  58. package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
  59. package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
  60. package/dist/cli-hbq0kwxz.js +252 -0
  61. package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
  62. package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
  63. package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
  64. package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
  65. package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
  66. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  67. package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
  68. package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
  69. package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
  70. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  71. package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
  72. package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
  73. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  74. package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
  75. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  76. package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
  77. package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
  78. package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
  79. package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
  80. package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
  81. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  82. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  83. package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
  84. package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
  85. package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
  86. package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
  87. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  88. package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
  89. package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
  90. package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
  91. package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
  92. package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
  93. package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
  94. package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
  95. package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
  96. package/dist/cli-y260hgep.js +186 -0
  97. package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
  98. package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
  99. package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
  100. package/dist/cli-yn4kt85g.js +148 -0
  101. package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
  102. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  103. package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
  104. package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
  105. package/dist/cli.js +27 -22
  106. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
  107. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  108. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  109. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
  110. package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
  111. package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
  112. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
  113. package/dist/core-0fqtbrxa.js +42 -0
  114. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
  115. package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
  116. package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
  117. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  118. package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
  119. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  120. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
  121. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  122. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  123. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
  124. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
  125. package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
  126. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  127. package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
  128. package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
  129. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  130. package/dist/grok-adapter-4q5tssw0.js +20 -0
  131. package/dist/handlers-qxgfvvsf.js +41 -0
  132. package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
  133. package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
  134. package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
  135. package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
  136. package/dist/index-0mcxjdsa.js +44 -0
  137. package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
  138. package/dist/index-dz4q23ag.js +40 -0
  139. package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
  140. package/dist/index-s175jckx.js +39 -0
  141. package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
  142. package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
  143. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  144. package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
  145. package/dist/lead-p3hx7h35.js +79 -0
  146. package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
  147. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
  148. package/dist/object-webhooks-6rdagg0r.js +21 -0
  149. package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
  150. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
  151. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
  152. package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
  153. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
  154. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
  155. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
  156. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
  157. package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
  158. package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
  159. package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
  160. package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
  161. package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
  162. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
  163. package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
  164. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  165. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
  166. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  167. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
  168. package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
  169. package/dist/worker-8rg9gz74.js +79 -0
  170. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
  171. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  172. package/dist/xlsx-9acfmxr1.js +31534 -0
  173. package/openapi.json +5227 -3511
  174. package/package.json +10 -5
  175. package/src/agentmail/handlers.ts +26 -19
  176. package/src/apps/catalog.generated.json +31 -0
  177. package/src/apps/row-store.ts +37 -14
  178. package/src/azure-devops/auth.ts +2 -3
  179. package/src/azure-devops/handlers.ts +2 -0
  180. package/src/be/agent-fs-identity.ts +46 -0
  181. package/src/be/agent-history.ts +215 -0
  182. package/src/be/audit-user.ts +46 -6
  183. package/src/be/db/agents.ts +34 -12
  184. package/src/be/db/kv-windows.ts +22 -0
  185. package/src/be/db/session-moves.ts +3 -3
  186. package/src/be/db/session-tree.ts +52 -5
  187. package/src/be/db/skill-audit.ts +17 -0
  188. package/src/be/db/tasks/write.ts +20 -5
  189. package/src/be/db.ts +116 -23
  190. package/src/be/extensions/assets.ts +11 -7
  191. package/src/be/memory/demotion-evidence.ts +2 -2
  192. package/src/be/memory/providers/sqlite-store.ts +151 -18
  193. package/src/be/memory/search-read-worker.ts +60 -0
  194. package/src/be/memory/search-reader.ts +223 -0
  195. package/src/be/migrations/332_primitive_objects.sql +31 -0
  196. package/src/be/migrations/334_agent_history.sql +23 -0
  197. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  198. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  199. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  200. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  201. package/src/be/model-tier-resolution.ts +18 -1
  202. package/src/be/multi-runtime.ts +17 -0
  203. package/src/be/primitives/boards/elements.ts +717 -0
  204. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  205. package/src/be/primitives/boards/service.ts +121 -0
  206. package/src/be/primitives/object-embed.ts +250 -0
  207. package/src/be/primitives/object-webhooks.ts +348 -0
  208. package/src/be/primitives/objects.ts +706 -0
  209. package/src/be/primitives/sheets/a1.ts +136 -0
  210. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  211. package/src/be/primitives/sheets/engine.ts +199 -0
  212. package/src/be/primitives/sheets/format.ts +106 -0
  213. package/src/be/primitives/sheets/service.ts +547 -0
  214. package/src/be/primitives/sheets/xlsx.ts +367 -0
  215. package/src/be/primitives/write-object.ts +83 -0
  216. package/src/be/rbac-roles.ts +3 -0
  217. package/src/be/repo-checked-update.ts +4 -4
  218. package/src/be/repo-merge-policy.ts +26 -9
  219. package/src/be/script-credential-broker.ts +8 -27
  220. package/src/be/scripts/boot-reembed.ts +6 -0
  221. package/src/be/scripts/db.ts +17 -5
  222. package/src/be/scripts/embeddings.ts +6 -0
  223. package/src/be/scripts/typecheck.ts +257 -0
  224. package/src/be/seed/agent-fs-provision.ts +18 -0
  225. package/src/be/seed/schedules-seeder.ts +9 -1
  226. package/src/be/seed/workflows-seeder.ts +9 -1
  227. package/src/be/seed-scripts/index.ts +2 -0
  228. package/src/be/seed-skills/index.ts +12 -0
  229. package/src/be/swarm-config-guard.ts +1 -0
  230. package/src/be/unmapped-identities.ts +95 -1
  231. package/src/be/users.ts +19 -0
  232. package/src/bitbucket/handlers.ts +2 -0
  233. package/src/commands/onboard/agent-fs-version.ts +1 -1
  234. package/src/commands/onboard/steps/harness.tsx +1 -1
  235. package/src/commands/provider-credentials.ts +1 -0
  236. package/src/e2b/env.ts +3 -1
  237. package/src/event-waits/github.ts +43 -0
  238. package/src/event-waits/index.ts +29 -0
  239. package/src/event-waits/types.ts +51 -0
  240. package/src/extensions/contract-types.generated.ts +1 -1
  241. package/src/extensions/dispatcher.ts +9 -0
  242. package/src/fs/agent-fs-provider.ts +37 -3
  243. package/src/github/handlers.ts +3 -1
  244. package/src/github/pull-request-state.ts +34 -0
  245. package/src/gitlab/auth.ts +3 -4
  246. package/src/gitlab/handlers.ts +12 -7
  247. package/src/heartbeat/heartbeat.ts +11 -11
  248. package/src/hooks/codex-hook.ts +99 -1
  249. package/src/hooks/hook.ts +85 -11
  250. package/src/hooks/native-tool-hooks.ts +245 -0
  251. package/src/http/agent-lifecycle.ts +152 -0
  252. package/src/http/agents.ts +12 -0
  253. package/src/http/all-routes.ts +3 -0
  254. package/src/http/assets.ts +4 -3
  255. package/src/http/auth.ts +2 -1
  256. package/src/http/comb.ts +2 -2
  257. package/src/http/favorite-owner.ts +2 -2
  258. package/src/http/favorites.ts +3 -2
  259. package/src/http/fs.ts +13 -4
  260. package/src/http/index.ts +17 -0
  261. package/src/http/mcp-bridge.ts +4 -0
  262. package/src/http/object-webhooks.ts +101 -0
  263. package/src/http/objects.ts +265 -0
  264. package/src/http/operator-actor.ts +2 -1
  265. package/src/http/pages.ts +3 -3
  266. package/src/http/poll.ts +43 -12
  267. package/src/http/repos.ts +7 -6
  268. package/src/http/schedules.ts +10 -6
  269. package/src/http/script-connections.ts +2 -2
  270. package/src/http/scripts.ts +9 -0
  271. package/src/http/sessions.ts +37 -12
  272. package/src/http/skills.ts +17 -0
  273. package/src/http/task-requester.ts +2 -2
  274. package/src/http/tasks.ts +13 -3
  275. package/src/http/tool-hooks.ts +24 -2
  276. package/src/http/trackers/authorize-gate.ts +2 -2
  277. package/src/http/users.ts +136 -1
  278. package/src/http/workflow-events.ts +13 -0
  279. package/src/http/workflows.ts +47 -5
  280. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  281. package/src/linear/sync.ts +3 -1
  282. package/src/prompts/base-prompt.ts +35 -13
  283. package/src/prompts/session-templates.ts +25 -0
  284. package/src/providers/acp-targets.ts +2 -2
  285. package/src/providers/amp-adapter.ts +1 -1
  286. package/src/providers/dsh-adapter.ts +1 -1
  287. package/src/providers/opencode-adapter.ts +5 -1
  288. package/src/providers/opencode-swarm-plugin.ts +50 -1
  289. package/src/providers/pi-mono-adapter.ts +139 -9
  290. package/src/providers/pi-mono-extension.ts +69 -0
  291. package/src/providers/runtime-dependencies.ts +1 -1
  292. package/src/rbac/legacy-policy.ts +5 -0
  293. package/src/rbac/permissions.ts +16 -1
  294. package/src/scheduler/deferred-task-waits.ts +170 -13
  295. package/src/script-workflows/guest-ctx.ts +32 -0
  296. package/src/script-workflows/workflow-ctx.ts +2 -0
  297. package/src/scripts-runtime/ctx.ts +9 -1
  298. package/src/scripts-runtime/executors/native.ts +106 -21
  299. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  300. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  301. package/src/scripts-runtime/executors/types.ts +5 -0
  302. package/src/scripts-runtime/loader.ts +8 -0
  303. package/src/scripts-runtime/mcp-client.ts +4 -0
  304. package/src/scripts-runtime/sdk-allowlist.ts +101 -0
  305. package/src/scripts-runtime/swarm-config.ts +8 -0
  306. package/src/scripts-runtime/swarm-sdk.ts +55 -3
  307. package/src/scripts-runtime/types/stdlib.d.ts +310 -0
  308. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  309. package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
  310. package/src/server.ts +52 -0
  311. package/src/slack/enrich.ts +81 -21
  312. package/src/slack/handlers.test.ts +55 -2
  313. package/src/slack/handlers.ts +38 -3
  314. package/src/slack/render-v2.ts +19 -0
  315. package/src/slack/session-mirror.ts +208 -0
  316. package/src/slack/thread-participants.ts +0 -5
  317. package/src/slack/watcher.ts +3 -0
  318. package/src/slack/work-objects.test.ts +2 -1
  319. package/src/slack/work-objects.ts +7 -2
  320. package/src/tests/agent-history.test.ts +313 -0
  321. package/src/tests/agentmail-filters.test.ts +4 -3
  322. package/src/tests/audit-agent-person.test.ts +825 -0
  323. package/src/tests/audit-updated-by.test.ts +19 -12
  324. package/src/tests/azure-devops-auth.test.ts +6 -0
  325. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  326. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  327. package/src/tests/claude-hook-output.test.ts +107 -2
  328. package/src/tests/claude-managed-setup.test.ts +1 -1
  329. package/src/tests/codex-adapter.test.ts +6 -6
  330. package/src/tests/codex-gpt6-release.test.ts +4 -4
  331. package/src/tests/credential-check.test.ts +12 -0
  332. package/src/tests/db-task-read-contract.test.ts +3 -0
  333. package/src/tests/db-task-write-contract.test.ts +3 -0
  334. package/src/tests/dsh-adapter.test.ts +1 -1
  335. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  336. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  337. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  338. package/src/tests/e2e-shards.test.ts +137 -0
  339. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  340. package/src/tests/extensions-catalog.test.ts +33 -25
  341. package/src/tests/extensions-heartbeat.test.ts +34 -0
  342. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  343. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  344. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  345. package/src/tests/gitlab-auth.test.ts +10 -0
  346. package/src/tests/heartbeat.test.ts +38 -0
  347. package/src/tests/http-api-integration.test.ts +0 -6
  348. package/src/tests/kv-storage.test.ts +3 -0
  349. package/src/tests/memory-search-reader.test.ts +258 -0
  350. package/src/tests/memory-search-stall.test.ts +197 -20
  351. package/src/tests/model-control.test.ts +4 -4
  352. package/src/tests/model-tier-resolution.test.ts +2 -2
  353. package/src/tests/multi-runtime-registration.test.ts +8 -2
  354. package/src/tests/native-tool-hooks.test.ts +188 -0
  355. package/src/tests/opencode-adapter.test.ts +11 -0
  356. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  357. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  358. package/src/tests/poll-probe-readonly.test.ts +108 -0
  359. package/src/tests/primitives-boards.test.ts +686 -0
  360. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  361. package/src/tests/primitives-objects.test.ts +248 -0
  362. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  363. package/src/tests/prompt-template-session.test.ts +3 -2
  364. package/src/tests/rbac-roles.test.ts +3 -0
  365. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  366. package/src/tests/script-connections.test.ts +4 -0
  367. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  368. package/src/tests/scripts-namespaces.test.ts +211 -0
  369. package/src/tests/secret-scrub-gate.test.ts +1 -0
  370. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  371. package/src/tests/secret-scrubber.test.ts +1 -1
  372. package/src/tests/seed-model-profiles.test.ts +1 -1
  373. package/src/tests/session-tokens.test.ts +27 -0
  374. package/src/tests/sessions-tree.test.ts +10 -2
  375. package/src/tests/sheet-engine.test.ts +58 -0
  376. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  377. package/src/tests/slack-read-boundaries.test.ts +4 -2
  378. package/src/tests/slack-thread-participants.test.ts +66 -4
  379. package/src/tests/task-start-after-commit.test.ts +82 -0
  380. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  381. package/src/tests/ui-logs-parser.test.ts +67 -0
  382. package/src/tests/workflow-retry-v2.test.ts +101 -0
  383. package/src/tests/workflow-tla-races.test.ts +29 -0
  384. package/src/tools/boards.ts +260 -0
  385. package/src/tools/defer-task.ts +154 -12
  386. package/src/tools/objects.ts +196 -0
  387. package/src/tools/repos/update-repo.ts +6 -6
  388. package/src/tools/schedules/create-schedule.ts +1 -0
  389. package/src/tools/schedules/list-schedules.ts +3 -0
  390. package/src/tools/schedules/patch-schedule.ts +12 -3
  391. package/src/tools/schedules/update-schedule.ts +12 -3
  392. package/src/tools/sheets.ts +378 -0
  393. package/src/tools/skills/skill-create.ts +6 -0
  394. package/src/tools/skills/skill-install-remote.ts +6 -0
  395. package/src/tools/skills/skill-sync-remote.ts +9 -0
  396. package/src/tools/skills/skill-update.ts +9 -1
  397. package/src/tools/slack-read.ts +10 -3
  398. package/src/tools/tool-config.ts +25 -0
  399. package/src/tools/utils.ts +15 -0
  400. package/src/tools/workflows/create-workflow.ts +20 -5
  401. package/src/tools/workflows/patch-workflow-node.ts +5 -1
  402. package/src/tools/workflows/patch-workflow.ts +9 -2
  403. package/src/tools/workflows/update-workflow.ts +27 -4
  404. package/src/types.ts +112 -12
  405. package/src/utils/sandboxed-process.ts +47 -2
  406. package/src/utils/secret-scrubber.ts +61 -6
  407. package/src/workflows/engine.ts +35 -21
  408. package/src/workflows/input.ts +36 -1
  409. package/src/workflows/patch-definition.ts +24 -2
  410. package/src/workflows/retry-poller.ts +15 -2
  411. package/src/workflows/triggers.ts +11 -6
  412. package/src/workflows/validation.ts +10 -0
  413. package/src/workflows/version.ts +7 -1
  414. package/templates/ai-toolbox.manifest.json +1 -1
  415. package/templates/skills/agent-browser/SKILL.md +1 -0
  416. package/templates/skills/agent-browser/content.md +1 -0
  417. package/templates/skills/boards-and-sheets/config.json +14 -0
  418. package/templates/skills/boards-and-sheets/content.md +163 -0
  419. package/templates/skills/pages/content.md +5 -0
  420. package/templates/skills/swarm-docs/content.md +15 -1
  421. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  422. package/templates/skills/swarm-scripts/content.md +1 -0
  423. package/templates/skills/tdd-planning/content.md +5 -2
  424. package/dist/acp-adapter-weaaxey3.js +0 -16
  425. package/dist/core-df1n049h.js +0 -39
  426. package/dist/fx-adapter-zwmps9re.js +0 -19
  427. package/dist/grok-adapter-q0avf919.js +0 -19
  428. package/dist/handlers-g5jq0e4q.js +0 -36
  429. package/dist/index-1f6m47mq.js +0 -37
  430. package/dist/index-1p1mpqda.js +0 -36
  431. package/dist/index-tnkd410q.js +0 -41
  432. package/dist/lead-m5e7xt93.js +0 -75
  433. package/dist/thread-buffer-nf55vwx3.js +0 -39
  434. package/dist/worker-ews1nyhw.js +0 -75
  435. package/src/slack/socket-mode-guard.test.ts +0 -25
  436. package/src/tests/agent-activity.test.ts +0 -247
  437. package/src/tests/agent-fs-live-url.test.ts +0 -55
  438. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  439. package/src/tests/approval-sweeps-config.test.ts +0 -47
  440. package/src/tests/cards.test.ts +0 -169
  441. package/src/tests/chat-sdk-facts.test.ts +0 -23
  442. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  443. package/src/tests/core-auth.test.ts +0 -156
  444. package/src/tests/date-utils.test.ts +0 -48
  445. package/src/tests/db-context-versions.test.ts +0 -37
  446. package/src/tests/db-runtime.test.ts +0 -132
  447. package/src/tests/enabled-capabilities.test.ts +0 -20
  448. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  449. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  450. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  451. package/src/tests/github-event-labels.test.ts +0 -24
  452. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  453. package/src/tests/http-log-scrubbing.test.ts +0 -123
  454. package/src/tests/http-semconv-attributes.test.ts +0 -92
  455. package/src/tests/identity.test.ts +0 -117
  456. package/src/tests/inbox-state.test.ts +0 -167
  457. package/src/tests/internal-ai/models.test.ts +0 -54
  458. package/src/tests/launch-password-rejection.test.ts +0 -140
  459. package/src/tests/list-total-cache.test.ts +0 -88
  460. package/src/tests/match-route.test.ts +0 -187
  461. package/src/tests/memory-feature-flags.test.ts +0 -45
  462. package/src/tests/memory-get-tool.test.ts +0 -269
  463. package/src/tests/memory-health-endpoint.test.ts +0 -78
  464. package/src/tests/memory-http-access.test.ts +0 -221
  465. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  466. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  467. package/src/tests/openai-embedding-provider.test.ts +0 -159
  468. package/src/tests/org-identity.test.ts +0 -44
  469. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  470. package/src/tests/pages-browser-sdk.test.ts +0 -76
  471. package/src/tests/pages-feedback-keys.test.ts +0 -121
  472. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  473. package/src/tests/pages-list-endpoint.test.ts +0 -148
  474. package/src/tests/pages-password-mode.test.ts +0 -266
  475. package/src/tests/pages-public-authed-401.test.ts +0 -103
  476. package/src/tests/pages-public-html.test.ts +0 -297
  477. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  478. package/src/tests/pages-view-count.test.ts +0 -245
  479. package/src/tests/prompt-templates-db.test.ts +0 -616
  480. package/src/tests/rbac-engine.test.ts +0 -742
  481. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  482. package/src/tests/route-def-find-route.test.ts +0 -192
  483. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  484. package/src/tests/schedule-validation-helper.test.ts +0 -51
  485. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  486. package/src/tests/scheduler-backoff.test.ts +0 -166
  487. package/src/tests/script-run-token.test.ts +0 -75
  488. package/src/tests/scripts-extract-signature.test.ts +0 -47
  489. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  490. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  491. package/src/tests/short-id.test.ts +0 -23
  492. package/src/tests/skill-files-http.test.ts +0 -222
  493. package/src/tests/skill-get-file-tool.test.ts +0 -110
  494. package/src/tests/skill-script-refs.test.ts +0 -63
  495. package/src/tests/skill-update-scope.test.ts +0 -252
  496. package/src/tests/skills-bundle.test.ts +0 -99
  497. package/src/tests/slack-app-icon.test.ts +0 -94
  498. package/src/tests/slack-assistant-comention.test.ts +0 -139
  499. package/src/tests/slack-delete.test.ts +0 -157
  500. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  501. package/src/tests/slack-manifest.test.ts +0 -23
  502. package/src/tests/slack-task-output.test.ts +0 -90
  503. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  504. package/src/tests/swarm-diff.test.ts +0 -728
  505. package/src/tests/task-lifecycle-events.test.ts +0 -53
  506. package/src/tests/template-asset-config.test.ts +0 -18
  507. package/src/tests/template-fetch.test.ts +0 -490
  508. package/src/tests/themes-page-theme.test.ts +0 -155
  509. package/src/tests/tool-annotations.test.ts +0 -442
  510. package/src/tests/tool-output-agent-id.test.ts +0 -202
  511. package/src/tests/update-profile-agentid.test.ts +0 -248
  512. package/src/tests/whoami-route.test.ts +0 -162
  513. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  514. package/src/tests/workflow-patch.test.ts +0 -169
  515. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  516. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  517. package/src/tests/workflow-step-claims.test.ts +0 -152
  518. package/src/tests/workflow-step-order.test.ts +0 -92
  519. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  520. package/src/tests/workflow-versions.test.ts +0 -240
  521. package/src/tests/workflow-wait.test.ts +0 -26
@@ -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
+ });