@desplega.ai/agent-swarm 2.11.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-4nxq386s.js → actions-c4chgxp6.js} +24 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-hn5fftf5.js} +5 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-3g6yc8nv.js} +7 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-cpjgpjvp.js} +24 -22
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-hce1av1h.js} +1 -1
  10. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-bztbxc4z.js} +1 -1
  11. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-d7xcym0j.js} +1 -1
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-arrkbe8t.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-ykpyr5p8.js} +8 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-trd59v7b.js} +4 -4
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-yjcze0j1.js} +10 -10
  19. package/dist/{cli-2gvdvsxj.js → cli-01tvvtad.js} +63 -60
  20. package/dist/{cli-rhsc2zyx.js → cli-04zc3f7b.js} +1 -1
  21. package/dist/{cli-p1a4khta.js → cli-0k1a0sde.js} +6 -6
  22. package/dist/{cli-atm0hkes.js → cli-0pp1yjg2.js} +4 -4
  23. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  24. package/dist/{cli-zhn4r1rz.js → cli-12vek61e.js} +72 -49
  25. package/dist/{cli-j2r1apqm.js → cli-1htmtqc2.js} +45 -44
  26. package/dist/{cli-a6q6x15h.js → cli-2amwhyv2.js} +8 -5
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-a02habn6.js → cli-2tw284hj.js} +2 -2
  29. package/dist/{cli-nc39ym5q.js → cli-39qm0rtm.js} +6 -6
  30. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  31. package/dist/cli-52nfye5j.js +673 -0
  32. package/dist/cli-55tc8cj4.js +252 -0
  33. package/dist/cli-5r95eqbh.js +186 -0
  34. package/dist/{cli-892y3vfp.js → cli-5tg94mdw.js} +7 -7
  35. package/dist/{cli-ynph3b70.js → cli-5x03v6en.js} +8 -8
  36. package/dist/{cli-1h4njv9y.js → cli-5z0g0e8v.js} +11 -2
  37. package/dist/{cli-6a3j25xd.js → cli-72yms3ey.js} +16 -16
  38. package/dist/{cli-h2qtafm4.js → cli-73q4g5nx.js} +17 -17
  39. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  40. package/dist/{cli-9g12h1aq.js → cli-7yn42w6m.js} +1 -1
  41. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  42. package/dist/{cli-4aswccje.js → cli-9qe5y107.js} +2 -2
  43. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  44. package/dist/{cli-mhrr4d5b.js → cli-agjbj5x0.js} +1 -1
  45. package/dist/{cli-hnh8erra.js → cli-b93d81yg.js} +2 -2
  46. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  47. package/dist/{cli-b82a13ga.js → cli-bp6k9acz.js} +17 -21
  48. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  49. package/dist/{cli-t2s7j5cy.js → cli-bz97ff9n.js} +2 -2
  50. package/dist/{cli-0bgj4rh5.js → cli-c7j31hq9.js} +3 -3
  51. package/dist/{cli-p8zqbbt1.js → cli-cah298e5.js} +1 -1
  52. package/dist/{cli-9knhkkgr.js → cli-cjqyse9q.js} +3 -3
  53. package/dist/{cli-tb4j757d.js → cli-dkvtfgn4.js} +6 -6
  54. package/dist/{cli-14xdms9a.js → cli-e3ahxq5y.js} +6 -6
  55. package/dist/{cli-6n7y5ypy.js → cli-e8n0hdzd.js} +1 -1
  56. package/dist/{cli-q71g5q39.js → cli-en6dmkxd.js} +3 -3
  57. package/dist/{cli-xqbqwpxr.js → cli-eq4kew31.js} +9 -9
  58. package/dist/{cli-4kzp7r0q.js → cli-eqq0hwvx.js} +3 -3
  59. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  60. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  61. package/dist/{cli-bq97k63w.js → cli-fxd1mwtr.js} +2 -2
  62. package/dist/{cli-kbm659dk.js → cli-fy4gb74g.js} +2 -2
  63. package/dist/{cli-djt6wmrc.js → cli-fyaq4zdv.js} +6 -6
  64. package/dist/{cli-raqw9fw9.js → cli-gfy6hbd9.js} +6 -6
  65. package/dist/{cli-s9twe4x0.js → cli-h70a2mxy.js} +13 -8
  66. package/dist/cli-hbvgzjq4.js +69 -0
  67. package/dist/{cli-vy3fn0mz.js → cli-hhc47ack.js} +4 -4
  68. package/dist/{cli-m00c47q6.js → cli-j5gtytvg.js} +54 -24
  69. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  70. package/dist/{cli-yzxqwcvq.js → cli-k5jx8jya.js} +10 -3
  71. package/dist/{cli-rytq7dm2.js → cli-krbcr00p.js} +3 -3
  72. package/dist/{cli-453497a0.js → cli-kwr5qv5g.js} +2 -2
  73. package/dist/{cli-czvvnfr9.js → cli-m5qtmrbc.js} +2 -2
  74. package/dist/{cli-cstggwq7.js → cli-ma9ys8rt.js} +2 -2
  75. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  76. package/dist/{cli-wz4e5am2.js → cli-mcymtvwn.js} +320 -70
  77. package/dist/{cli-2aacfdcn.js → cli-mq2fbgva.js} +64 -3
  78. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  79. package/dist/{cli-k4r5sfaj.js → cli-n8f0fs3c.js} +4 -4
  80. package/dist/{cli-f8yhybxr.js → cli-nja15knq.js} +3 -3
  81. package/dist/{cli-6tvh1fwq.js → cli-pe3yxedk.js} +3 -3
  82. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  83. package/dist/{cli-n6ygvrrm.js → cli-q2dywc8h.js} +4 -4
  84. package/dist/{cli-8zmpwe79.js → cli-q8tc22bj.js} +5 -5
  85. package/dist/{cli-yvzxbztc.js → cli-r0mz92by.js} +2 -2
  86. package/dist/{cli-v3zcnr8g.js → cli-r14ac1y0.js} +1 -1
  87. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  88. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  89. package/dist/{cli-27fat7st.js → cli-sv2r3bw8.js} +7 -7
  90. package/dist/{cli-zb1hff00.js → cli-t75xngj1.js} +9 -9
  91. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  92. package/dist/{cli-5ptj757f.js → cli-tm60vtax.js} +1 -1
  93. package/dist/{cli-rpmw4fsv.js → cli-v9ya390t.js} +12 -12
  94. package/dist/{cli-075ccjh6.js → cli-wvjqaqcp.js} +2607 -65
  95. package/dist/{cli-2jtfm8kh.js → cli-xf4z5bdn.js} +4 -4
  96. package/dist/{cli-4g323fjh.js → cli-xm34qj8m.js} +2 -2
  97. package/dist/{cli-f7dhm7hh.js → cli-ya3kf4gs.js} +1 -1
  98. package/dist/{cli-rwgwen5v.js → cli-yegz2g06.js} +4 -4
  99. package/dist/{cli-nbakg5xh.js → cli-yfpc6qy9.js} +3 -3
  100. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  101. package/dist/cli.js +24 -21
  102. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-wc6e4wct.js} +8 -8
  103. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  104. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ppfgjd97.js} +9 -9
  105. package/dist/{commands-ctey7tr5.js → commands-tsv2vx5b.js} +3 -3
  106. package/dist/{controller-rqhbppg9.js → controller-ye4sdwsy.js} +4 -4
  107. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-zn4dg69h.js} +25 -23
  108. package/dist/core-dxcy02sc.js +41 -0
  109. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-q2g9vwts.js} +2 -2
  110. package/dist/{db-2ah39cyx.js → db-3r1fyr2n.js} +6 -2
  111. package/dist/{db-p5drc1d1.js → db-g111qn9j.js} +3 -3
  112. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  113. package/dist/{dispatcher-x6w14pde.js → dispatcher-4q8s0mx8.js} +22 -20
  114. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  115. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-mmcw1z5s.js} +2 -2
  116. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  117. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  118. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-04ke6hcp.js} +1 -1
  119. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-kcdn52vz.js} +6 -6
  120. package/dist/{embeddings-0sxb1d2h.js → embeddings-jnzcd91a.js} +1 -1
  121. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  122. package/dist/{execute-6m1ex8ce.js → execute-74amghty.js} +1 -1
  123. package/dist/{external-channel-ezer7pk0.js → external-channel-v9zgxnxz.js} +2 -2
  124. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  125. package/dist/grok-adapter-t6m74fb1.js +19 -0
  126. package/dist/handlers-9kwcrc4k.js +38 -0
  127. package/dist/{heartbeat-6c4fr49t.js → heartbeat-p8pk1msj.js} +25 -23
  128. package/dist/{hook-t1c5avbv.js → hook-k1h73zd7.js} +5 -5
  129. package/dist/{hook-02rt5tvq.js → hook-p5reemds.js} +7 -7
  130. package/dist/{http-qa3h32a1.js → http-ms1z5xxy.js} +565 -141
  131. package/dist/index-23cdfzr6.js +39 -0
  132. package/dist/{index-kqv9ebfj.js → index-76zzxtzf.js} +1 -1
  133. package/dist/{index-e42j998x.js → index-fbkqhvvj.js} +38 -19
  134. package/dist/index-g7kkjs5b.js +38 -0
  135. package/dist/{index-qpjk2hxk.js → index-gjn6qfgn.js} +1 -1
  136. package/dist/{index-akbgsdhh.js → index-kn63q1gr.js} +26 -24
  137. package/dist/index-stk36pa5.js +43 -0
  138. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  139. package/dist/{keepalive-jmf6pn8c.js → keepalive-031js8jz.js} +4 -4
  140. package/dist/lead-mfggjtfk.js +77 -0
  141. package/dist/{maintenance-g7v15tj1.js → maintenance-sq9v3qx9.js} +1 -1
  142. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  143. package/dist/object-webhooks-r24wwb5y.js +21 -0
  144. package/dist/{onboard-m3fedypq.js → onboard-p25yhh7t.js} +5 -5
  145. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-wcjc4zdk.js} +7 -7
  146. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-ff1gf20m.js} +2 -2
  147. package/dist/{pending-fwj2fatd.js → pending-hxj5yatb.js} +23 -21
  148. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-vkp4zz7p.js} +12 -12
  149. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-9w7gx41w.js} +2 -2
  150. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-84aw10nz.js} +3 -3
  151. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-hz74vckp.js} +2 -2
  152. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  153. package/dist/{render-v2-j7qggj8h.js → render-v2-nrdkg9gf.js} +5 -5
  154. package/dist/{resume-hj1mn65y.js → resume-s6ey36rh.js} +9 -9
  155. package/dist/{runtime-z31mdsgv.js → runtime-x0b4pyam.js} +1 -1
  156. package/dist/{session-access-w38fh09a.js → session-access-xv49tk14.js} +4 -4
  157. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-r5j988ah.js} +3 -3
  158. package/dist/{setup-dsqmpfcr.js → setup-mj0krk1p.js} +1 -1
  159. package/dist/thread-buffer-temgaqsy.js +41 -0
  160. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-cbrsfaar.js} +2 -2
  161. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  162. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-ns0ryw05.js} +3 -3
  163. package/dist/{work-objects-4ahy5es5.js → work-objects-pydhzast.js} +25 -23
  164. package/dist/worker-efcemc22.js +77 -0
  165. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-9z2xec5e.js} +22 -20
  166. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  167. package/openapi.json +788 -253
  168. package/package.json +8 -5
  169. package/src/azure-devops/auth.ts +2 -3
  170. package/src/be/agent-fs-identity.ts +46 -0
  171. package/src/be/agent-history.ts +215 -0
  172. package/src/be/db/agents.ts +34 -12
  173. package/src/be/db/tasks/write.ts +2 -2
  174. package/src/be/db.ts +2 -0
  175. package/src/be/migrations/332_primitive_objects.sql +31 -0
  176. package/src/be/migrations/334_agent_history.sql +23 -0
  177. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  178. package/src/be/primitives/boards/elements.ts +717 -0
  179. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  180. package/src/be/primitives/boards/service.ts +121 -0
  181. package/src/be/primitives/object-webhooks.ts +348 -0
  182. package/src/be/primitives/objects.ts +686 -0
  183. package/src/be/primitives/sheets/a1.ts +136 -0
  184. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  185. package/src/be/primitives/sheets/engine.ts +199 -0
  186. package/src/be/primitives/sheets/format.ts +106 -0
  187. package/src/be/primitives/sheets/service.ts +415 -0
  188. package/src/be/primitives/write-object.ts +83 -0
  189. package/src/be/script-credential-broker.ts +8 -27
  190. package/src/be/scripts/typecheck.ts +216 -0
  191. package/src/be/seed/agent-fs-provision.ts +18 -0
  192. package/src/be/users.ts +19 -0
  193. package/src/commands/onboard/agent-fs-version.ts +1 -1
  194. package/src/commands/onboard/steps/harness.tsx +1 -1
  195. package/src/commands/provider-credentials.ts +1 -0
  196. package/src/e2b/env.ts +3 -1
  197. package/src/fs/agent-fs-provider.ts +33 -2
  198. package/src/gitlab/auth.ts +3 -4
  199. package/src/heartbeat/heartbeat.ts +11 -11
  200. package/src/http/agent-lifecycle.ts +152 -0
  201. package/src/http/agents.ts +12 -0
  202. package/src/http/all-routes.ts +2 -0
  203. package/src/http/auth.ts +2 -1
  204. package/src/http/index.ts +15 -0
  205. package/src/http/object-webhooks.ts +101 -0
  206. package/src/http/operator-actor.ts +2 -1
  207. package/src/http/sessions.ts +7 -0
  208. package/src/http/workflows.ts +32 -0
  209. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  210. package/src/providers/acp-targets.ts +2 -2
  211. package/src/providers/amp-adapter.ts +1 -1
  212. package/src/providers/opencode-adapter.ts +4 -1
  213. package/src/rbac/legacy-policy.ts +2 -0
  214. package/src/rbac/permissions.ts +5 -0
  215. package/src/script-workflows/guest-ctx.ts +32 -0
  216. package/src/script-workflows/workflow-ctx.ts +2 -0
  217. package/src/scripts-runtime/ctx.ts +9 -1
  218. package/src/scripts-runtime/executors/native.ts +106 -21
  219. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  220. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  221. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  222. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  223. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  224. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  225. package/src/server.ts +48 -0
  226. package/src/tests/agent-history.test.ts +313 -0
  227. package/src/tests/azure-devops-auth.test.ts +6 -0
  228. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  229. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  230. package/src/tests/credential-check.test.ts +12 -0
  231. package/src/tests/db-task-read-contract.test.ts +2 -0
  232. package/src/tests/db-task-write-contract.test.ts +2 -0
  233. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  234. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  235. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  236. package/src/tests/e2e-shards.test.ts +137 -0
  237. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  238. package/src/tests/extensions-heartbeat.test.ts +34 -0
  239. package/src/tests/gitlab-auth.test.ts +10 -0
  240. package/src/tests/heartbeat.test.ts +38 -0
  241. package/src/tests/http-api-integration.test.ts +0 -6
  242. package/src/tests/opencode-adapter.test.ts +11 -0
  243. package/src/tests/primitives-boards.test.ts +686 -0
  244. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  245. package/src/tests/primitives-objects.test.ts +248 -0
  246. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  247. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  248. package/src/tests/scripts-namespaces.test.ts +211 -0
  249. package/src/tests/secret-scrub-gate.test.ts +1 -0
  250. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  251. package/src/tests/secret-scrubber.test.ts +1 -1
  252. package/src/tests/session-tokens.test.ts +27 -0
  253. package/src/tests/sheet-engine.test.ts +58 -0
  254. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  255. package/src/tests/slack-read-boundaries.test.ts +4 -2
  256. package/src/tests/task-start-after-commit.test.ts +82 -0
  257. package/src/tests/ui-logs-parser.test.ts +67 -0
  258. package/src/tests/workflow-retry-v2.test.ts +101 -0
  259. package/src/tests/workflow-tla-races.test.ts +29 -0
  260. package/src/tools/boards.ts +260 -0
  261. package/src/tools/objects.ts +191 -0
  262. package/src/tools/sheets.ts +312 -0
  263. package/src/tools/slack-read.ts +10 -3
  264. package/src/tools/tool-config.ts +23 -0
  265. package/src/tools/workflows/create-workflow.ts +11 -1
  266. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  267. package/src/tools/workflows/patch-workflow.ts +4 -0
  268. package/src/tools/workflows/update-workflow.ts +17 -0
  269. package/src/types.ts +16 -0
  270. package/src/utils/sandboxed-process.ts +47 -2
  271. package/src/utils/secret-scrubber.ts +61 -6
  272. package/src/workflows/engine.ts +35 -21
  273. package/src/workflows/input.ts +29 -1
  274. package/src/workflows/patch-definition.ts +15 -1
  275. package/src/workflows/retry-poller.ts +15 -2
  276. package/src/workflows/validation.ts +10 -0
  277. package/templates/ai-toolbox.manifest.json +1 -1
  278. package/templates/skills/agent-browser/SKILL.md +1 -0
  279. package/templates/skills/agent-browser/content.md +1 -0
  280. package/templates/skills/pages/content.md +5 -0
  281. package/templates/skills/swarm-docs/content.md +6 -1
  282. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  283. package/templates/skills/swarm-scripts/content.md +1 -0
  284. package/templates/skills/tdd-planning/content.md +5 -2
  285. package/dist/acp-adapter-weaaxey3.js +0 -16
  286. package/dist/core-df1n049h.js +0 -39
  287. package/dist/fx-adapter-zwmps9re.js +0 -19
  288. package/dist/grok-adapter-q0avf919.js +0 -19
  289. package/dist/handlers-g5jq0e4q.js +0 -36
  290. package/dist/index-1f6m47mq.js +0 -37
  291. package/dist/index-1p1mpqda.js +0 -36
  292. package/dist/index-tnkd410q.js +0 -41
  293. package/dist/lead-m5e7xt93.js +0 -75
  294. package/dist/thread-buffer-nf55vwx3.js +0 -39
  295. package/dist/worker-ews1nyhw.js +0 -75
  296. package/src/slack/socket-mode-guard.test.ts +0 -25
  297. package/src/tests/agent-activity.test.ts +0 -247
  298. package/src/tests/agent-fs-live-url.test.ts +0 -55
  299. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  300. package/src/tests/approval-sweeps-config.test.ts +0 -47
  301. package/src/tests/cards.test.ts +0 -169
  302. package/src/tests/chat-sdk-facts.test.ts +0 -23
  303. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  304. package/src/tests/core-auth.test.ts +0 -156
  305. package/src/tests/date-utils.test.ts +0 -48
  306. package/src/tests/db-context-versions.test.ts +0 -37
  307. package/src/tests/db-runtime.test.ts +0 -132
  308. package/src/tests/enabled-capabilities.test.ts +0 -20
  309. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  310. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  311. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  312. package/src/tests/github-event-labels.test.ts +0 -24
  313. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  314. package/src/tests/http-log-scrubbing.test.ts +0 -123
  315. package/src/tests/http-semconv-attributes.test.ts +0 -92
  316. package/src/tests/identity.test.ts +0 -117
  317. package/src/tests/inbox-state.test.ts +0 -167
  318. package/src/tests/internal-ai/models.test.ts +0 -54
  319. package/src/tests/launch-password-rejection.test.ts +0 -140
  320. package/src/tests/list-total-cache.test.ts +0 -88
  321. package/src/tests/match-route.test.ts +0 -187
  322. package/src/tests/memory-feature-flags.test.ts +0 -45
  323. package/src/tests/memory-get-tool.test.ts +0 -269
  324. package/src/tests/memory-health-endpoint.test.ts +0 -78
  325. package/src/tests/memory-http-access.test.ts +0 -221
  326. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  327. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  328. package/src/tests/openai-embedding-provider.test.ts +0 -159
  329. package/src/tests/org-identity.test.ts +0 -44
  330. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  331. package/src/tests/pages-browser-sdk.test.ts +0 -76
  332. package/src/tests/pages-feedback-keys.test.ts +0 -121
  333. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  334. package/src/tests/pages-list-endpoint.test.ts +0 -148
  335. package/src/tests/pages-password-mode.test.ts +0 -266
  336. package/src/tests/pages-public-authed-401.test.ts +0 -103
  337. package/src/tests/pages-public-html.test.ts +0 -297
  338. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  339. package/src/tests/pages-view-count.test.ts +0 -245
  340. package/src/tests/prompt-templates-db.test.ts +0 -616
  341. package/src/tests/rbac-engine.test.ts +0 -742
  342. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  343. package/src/tests/route-def-find-route.test.ts +0 -192
  344. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  345. package/src/tests/schedule-validation-helper.test.ts +0 -51
  346. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  347. package/src/tests/scheduler-backoff.test.ts +0 -166
  348. package/src/tests/script-run-token.test.ts +0 -75
  349. package/src/tests/scripts-extract-signature.test.ts +0 -47
  350. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  351. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  352. package/src/tests/short-id.test.ts +0 -23
  353. package/src/tests/skill-files-http.test.ts +0 -222
  354. package/src/tests/skill-get-file-tool.test.ts +0 -110
  355. package/src/tests/skill-script-refs.test.ts +0 -63
  356. package/src/tests/skill-update-scope.test.ts +0 -252
  357. package/src/tests/skills-bundle.test.ts +0 -99
  358. package/src/tests/slack-app-icon.test.ts +0 -94
  359. package/src/tests/slack-assistant-comention.test.ts +0 -139
  360. package/src/tests/slack-delete.test.ts +0 -157
  361. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  362. package/src/tests/slack-manifest.test.ts +0 -23
  363. package/src/tests/slack-task-output.test.ts +0 -90
  364. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  365. package/src/tests/swarm-diff.test.ts +0 -728
  366. package/src/tests/task-lifecycle-events.test.ts +0 -53
  367. package/src/tests/template-asset-config.test.ts +0 -18
  368. package/src/tests/template-fetch.test.ts +0 -490
  369. package/src/tests/themes-page-theme.test.ts +0 -155
  370. package/src/tests/tool-annotations.test.ts +0 -442
  371. package/src/tests/tool-output-agent-id.test.ts +0 -202
  372. package/src/tests/update-profile-agentid.test.ts +0 -248
  373. package/src/tests/whoami-route.test.ts +0 -162
  374. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  375. package/src/tests/workflow-patch.test.ts +0 -169
  376. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  377. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  378. package/src/tests/workflow-step-claims.test.ts +0 -152
  379. package/src/tests/workflow-step-order.test.ts +0 -92
  380. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  381. package/src/tests/workflow-versions.test.ts +0 -240
  382. package/src/tests/workflow-wait.test.ts +0 -26
@@ -0,0 +1,82 @@
1
+ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2
+ import { unlink } from "node:fs/promises";
3
+ import {
4
+ closeDb,
5
+ createAgent,
6
+ createTaskExtended,
7
+ getDbClient,
8
+ getTaskById,
9
+ initDb,
10
+ startTask,
11
+ } from "../be/db";
12
+ import { onTaskStarted } from "../be/task-lifecycle-events";
13
+ import type { AgentTask } from "../types";
14
+
15
+ const TEST_DB_PATH = "./test-task-start-after-commit.sqlite";
16
+ const workerId = crypto.randomUUID();
17
+ let received: AgentTask[] = [];
18
+ onTaskStarted((task) => {
19
+ if (task.agentId === workerId) received.push(task);
20
+ });
21
+
22
+ async function removeTestDb(): Promise<void> {
23
+ for (const suffix of ["", "-wal", "-shm"]) {
24
+ await unlink(TEST_DB_PATH + suffix).catch(() => {});
25
+ }
26
+ }
27
+
28
+ describe("startTask lifecycle notifications", () => {
29
+ beforeEach(async () => {
30
+ closeDb();
31
+ await removeTestDb();
32
+ initDb(TEST_DB_PATH);
33
+ await createAgent({ id: workerId, name: "Start Worker", isLead: false, status: "idle" });
34
+ received = [];
35
+ });
36
+
37
+ afterEach(async () => {
38
+ closeDb();
39
+ await removeTestDb();
40
+ });
41
+
42
+ test("does not notify subscribers when the enclosing transaction rolls back", async () => {
43
+ const task = await createTaskExtended("rolled back start", { agentId: workerId });
44
+
45
+ await expect(
46
+ getDbClient().transaction(async () => {
47
+ await startTask(task.id);
48
+ throw new Error("rollback");
49
+ }),
50
+ ).rejects.toThrow("rollback");
51
+ await new Promise((resolve) => setTimeout(resolve, 0));
52
+
53
+ expect((await getTaskById(task.id))?.status).toBe("pending");
54
+ expect(received).toEqual([]);
55
+ });
56
+
57
+ test("notifies once after the enclosing transaction commits", async () => {
58
+ const task = await createTaskExtended("committed start", { agentId: workerId });
59
+
60
+ await getDbClient().transaction(async () => {
61
+ await startTask(task.id);
62
+ await Promise.resolve();
63
+ expect(received).toEqual([]);
64
+ });
65
+ await new Promise((resolve) => setTimeout(resolve, 0));
66
+
67
+ expect((await getTaskById(task.id))?.status).toBe("in_progress");
68
+ expect(received).toHaveLength(1);
69
+ expect(received[0]).toMatchObject({ id: task.id, status: "in_progress" });
70
+ });
71
+
72
+ test("notifies outside a transaction without repeating an existing start", async () => {
73
+ const task = await createTaskExtended("standalone start", { agentId: workerId });
74
+
75
+ await startTask(task.id);
76
+ await startTask(task.id);
77
+ await new Promise((resolve) => setTimeout(resolve, 0));
78
+
79
+ expect(received).toHaveLength(1);
80
+ expect(received[0]?.id).toBe(task.id);
81
+ });
82
+ });
@@ -1699,6 +1699,73 @@ describe.each([
1699
1699
  });
1700
1700
  });
1701
1701
 
1702
+ describe("claude pre-tool updates", () => {
1703
+ function line(id: string, n: number, messageId: string, block: unknown, cli = "claude") {
1704
+ return log(id, cli, n, {
1705
+ type: "assistant",
1706
+ message: { id: messageId, role: "assistant", content: [block] },
1707
+ });
1708
+ }
1709
+ const think = (text: string) => ({ type: "thinking", thinking: text });
1710
+ const read = { type: "tool_use", id: "t1", name: "Read", input: {} };
1711
+ const shape = (logs: SessionLogRecord[]) =>
1712
+ parseSessionLogs(logs)
1713
+ .flatMap((m) => m.content)
1714
+ .map((b) => (b.type === "text" ? `${b.progress ? "progress" : "text"}:${b.text}` : b.type));
1715
+
1716
+ test("the last of 2+ thinking blocks before a tool_use is a progress line; nothing is dropped", () => {
1717
+ // The live shape from the Phase 1 sample: thinking(404) thinking(203) tool_use.
1718
+ const logs = [
1719
+ line("a1", 1, "msg_1", think("Weigh the two configs.")),
1720
+ line("a2", 2, "msg_1", think("Reading the config.")),
1721
+ line("a3", 3, "msg_1", read),
1722
+ ];
1723
+ expect(shape(logs)).toEqual(["thinking", "progress:Reading the config.", "tool_use"]);
1724
+ const items = normalizeSessionLogs(logs).items;
1725
+ expect(items.find((i) => i.recId === "a2")).toMatchObject({ kind: "text", progress: true });
1726
+ });
1727
+
1728
+ test("one thinking block before a tool_use stays reasoning", () => {
1729
+ expect(
1730
+ shape([line("a1", 1, "msg_1", think("Just read it.")), line("a2", 2, "msg_1", read)]),
1731
+ ).toEqual(["thinking", "tool_use"]);
1732
+ });
1733
+
1734
+ test("blocks group by message.id: thinking in another message does not count", () => {
1735
+ expect(
1736
+ shape([
1737
+ line("a1", 1, "msg_1", think("first call")),
1738
+ line("a2", 2, "msg_2", think("second call")),
1739
+ line("a3", 3, "msg_2", read),
1740
+ ]),
1741
+ ).toEqual(["thinking", "thinking", "tool_use"]);
1742
+ });
1743
+
1744
+ test("text between thinking and the tool_use, or no tool_use, keeps reasoning", () => {
1745
+ expect(
1746
+ shape([
1747
+ line("a1", 1, "msg_1", think("a")),
1748
+ line("a2", 2, "msg_1", think("b")),
1749
+ line("a3", 3, "msg_1", { type: "text", text: "Done." }),
1750
+ line("a4", 4, "msg_1", read),
1751
+ ]),
1752
+ ).toEqual(["thinking", "thinking", "text:Done.", "tool_use"]);
1753
+ expect(shape([line("a1", 1, "msg_1", think("a")), line("a2", 2, "msg_1", think("b"))])).toEqual(
1754
+ ["thinking", "thinking"],
1755
+ );
1756
+ });
1757
+
1758
+ test("the rule is Claude's: pi lines of the same shape stay reasoning", () => {
1759
+ expect(
1760
+ shape([
1761
+ line("a1", 1, "msg_1", think("a"), "pi"),
1762
+ line("a2", 2, "msg_1", think("b"), "pi"),
1763
+ line("a3", 3, "msg_1", read, "pi"),
1764
+ ]),
1765
+ ).toEqual(["thinking", "thinking", "tool_use"]);
1766
+ });
1767
+ });
1768
+
1702
1769
  describe("per-call usage", () => {
1703
1770
  const claudeUsage = {
1704
1771
  input_tokens: 6,
@@ -238,6 +238,107 @@ describe("Workflow Retry v2 (Phase 4)", () => {
238
238
  });
239
239
 
240
240
  describe("Retry Poller", () => {
241
+ test("rejects schema-invalid retry output without running successors", async () => {
242
+ const workflow = await makeWorkflow({
243
+ nodes: [
244
+ {
245
+ id: "n1",
246
+ type: "fail-once",
247
+ config: { failUntilAttempt: 1 },
248
+ outputSchema: {
249
+ type: "object",
250
+ properties: { attempt: { type: "string" } },
251
+ required: ["attempt"],
252
+ },
253
+ retry: { strategy: "static", maxRetries: 3, baseDelayMs: 1, maxDelayMs: 1 },
254
+ next: "successor",
255
+ },
256
+ {
257
+ id: "successor",
258
+ type: "notify",
259
+ config: { channel: "test", template: "must not run" },
260
+ },
261
+ ],
262
+ });
263
+
264
+ failCounter = 0;
265
+ notifyCounter = 0;
266
+ const runId = await startWorkflowExecution(workflow, {}, registry);
267
+ const [initialStep] = await getWorkflowRunStepsByRunId(runId);
268
+ expect(initialStep?.status).toBe("failed");
269
+ expect(initialStep?.error).toBe("Intentional failure #1");
270
+ expect(initialStep?.nextRetryAt).toBeTruthy();
271
+
272
+ try {
273
+ startRetryPoller(registry, 1);
274
+ await waitUntil(
275
+ async () => {
276
+ const [step] = await getWorkflowRunStepsByRunId(runId);
277
+ return failCounter >= 2 && step?.status !== "running";
278
+ },
279
+ () => "the retry did not settle",
280
+ );
281
+ } finally {
282
+ stopRetryPoller();
283
+ }
284
+
285
+ const run = (await getWorkflowRun(runId))!;
286
+ const steps = await getWorkflowRunStepsByRunId(runId);
287
+ expect(run.status).toBe("failed");
288
+ expect(run.error).toContain("Output schema validation failed");
289
+ expect(run.context).not.toHaveProperty("n1");
290
+ expect(steps).toHaveLength(1);
291
+ expect(steps[0]?.status).toBe("failed");
292
+ expect(steps[0]?.error).toContain("attempt");
293
+ expect(steps[0]?.output).toBeUndefined();
294
+ expect(steps[0]?.nextRetryAt).toBeUndefined();
295
+ expect(failCounter).toBe(2);
296
+ expect(notifyCounter).toBe(0);
297
+ });
298
+
299
+ test("checkpoints schema-valid retry output and runs successors", async () => {
300
+ const workflow = await makeWorkflow({
301
+ nodes: [
302
+ {
303
+ id: "n1",
304
+ type: "fail-once",
305
+ config: { failUntilAttempt: 1 },
306
+ outputSchema: {
307
+ type: "object",
308
+ properties: { attempt: { type: "number" } },
309
+ required: ["attempt"],
310
+ },
311
+ retry: { strategy: "static", maxRetries: 3, baseDelayMs: 1, maxDelayMs: 1 },
312
+ next: "successor",
313
+ },
314
+ {
315
+ id: "successor",
316
+ type: "notify",
317
+ config: { channel: "test", template: "run after valid output" },
318
+ },
319
+ ],
320
+ });
321
+
322
+ failCounter = 0;
323
+ notifyCounter = 0;
324
+ const runId = await startWorkflowExecution(workflow, {}, registry);
325
+ try {
326
+ startRetryPoller(registry, 1);
327
+ await waitForRunStatus(runId, "completed");
328
+ } finally {
329
+ stopRetryPoller();
330
+ }
331
+
332
+ const steps = await getWorkflowRunStepsByRunId(runId);
333
+ const retriedStep = steps.find((step) => step.nodeId === "n1")!;
334
+ expect(retriedStep.status).toBe("completed");
335
+ expect(retriedStep.output).toEqual({ attempt: 2 });
336
+ expect(retriedStep.nextRetryAt).toBeUndefined();
337
+ expect(steps.find((step) => step.nodeId === "successor")?.status).toBe("completed");
338
+ expect(failCounter).toBe(2);
339
+ expect(notifyCounter).toBe(1);
340
+ });
341
+
241
342
  test("rehydrates completed step outputs before interpolating retry inputs", async () => {
242
343
  const workflow = await makeWorkflow({
243
344
  nodes: [
@@ -391,4 +391,33 @@ describe("TLA+ workflow counterexamples", () => {
391
391
  stopRetryPoller();
392
392
  }
393
393
  });
394
+
395
+ test("CX8: the join does not fire while a branch is pending its retry", async () => {
396
+ plans.clear();
397
+ calls.length = 0;
398
+ const def = fanOut(true);
399
+ plans.set("A", ["fail", "ok"]);
400
+ plans.set("B", ["ok"]);
401
+ const { runId, walk } = await newRun(def);
402
+
403
+ // XFail (A retry pending) -> XCkOk (B) -> WBatchEnd. No poller is running.
404
+ await walk(["T"]);
405
+ const [stepA] = await stepsOf(runId, "A");
406
+ expect(stepA?.status).toBe("failed");
407
+ expect(stepA?.nextRetryAt).toBeTruthy();
408
+ const joinCallsBeforeRetry = callsOf("M");
409
+
410
+ // P1..P9: the poller retries A; A succeeds and walks to M.
411
+ await sleep(5);
412
+ startRetryPoller(registry, 1);
413
+ try {
414
+ await waitForRunStatus(runId, "completed");
415
+ } finally {
416
+ stopRetryPoller();
417
+ }
418
+
419
+ expect(joinCallsBeforeRetry).toBe(0);
420
+ expect(callsOf("M")).toBe(1);
421
+ expect(callsOf("A")).toBe(2);
422
+ });
394
423
  });
@@ -0,0 +1,260 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import * as z from "zod";
3
+ import { LAYOUTS, PALETTE, SHAPE_TYPES } 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 { objectOutputSchema, refusing } from "@/tools/objects";
13
+ import { createToolRegistrar, swarmToolOutputSchema, toolOk } from "@/tools/utils";
14
+
15
+ const Coord = z.number().min(-1_000_000).max(1_000_000);
16
+ const Size = z.number().positive().max(10_000);
17
+ const Color = z
18
+ .string()
19
+ .max(32)
20
+ .describe(`A palette name (${Object.keys(PALETTE).join(", ")}) or #rrggbb (background).`);
21
+
22
+ const ShapeSchema = z.object({
23
+ key: z
24
+ .string()
25
+ .min(1)
26
+ .max(64)
27
+ .optional()
28
+ .describe("Your name for the shape, so arrows in the same call can point at it."),
29
+ type: z.enum(SHAPE_TYPES),
30
+ x: Coord.optional(),
31
+ y: Coord.optional(),
32
+ width: Size.optional().describe("Minimum width; a shape grows to fit its label."),
33
+ height: Size.optional().describe("Minimum height; a shape grows to fit its label."),
34
+ label: z.string().max(2000).optional().describe("Text inside the shape; required for `text`."),
35
+ color: Color.optional(),
36
+ });
37
+
38
+ const ArrowSchema = z.object({
39
+ from: z
40
+ .string()
41
+ .min(1)
42
+ .max(64)
43
+ .describe("A shape `key` from this call or an existing element id."),
44
+ to: z.string().min(1).max(64).describe("A shape `key` from this call or an existing element id."),
45
+ label: z.string().max(500).optional(),
46
+ });
47
+
48
+ const Shapes = z.array(ShapeSchema).max(200).optional();
49
+ const Arrows = z.array(ArrowSchema).max(200).optional();
50
+ const LayoutSchema = z
51
+ .enum(LAYOUTS)
52
+ .optional()
53
+ .describe("How shapes without x/y are placed, below existing content. Default `row`.");
54
+ const IdOrPath = {
55
+ id: z.string().min(1).optional().describe("Board object id."),
56
+ path: z.string().min(1).optional().describe("Board path on your default drive."),
57
+ };
58
+
59
+ const boardOut = {
60
+ yourAgentId: z.string().optional(),
61
+ object: objectOutputSchema.optional(),
62
+ version: z.number().nullable().optional(),
63
+ };
64
+ const Added = z.record(z.string(), z.string());
65
+
66
+ const where = (o: { path: string; link: string | null }) =>
67
+ `${o.path}${o.link ? ` (${o.link})` : ""}`;
68
+
69
+ export const registerBoardCreateTool = (server: McpServer) => {
70
+ createToolRegistrar(server)(
71
+ "board-create",
72
+ {
73
+ title: "Create board",
74
+ annotations: { readOnlyHint: false, idempotentHint: false },
75
+ description:
76
+ "Create an Excalidraw board (`.excalidraw`) on your default agent-fs drive, as your own agent-fs identity, optionally with shapes and bound arrows. Create-only: refuses when the path exists. `added` maps each shape key (or `shapes[i]`) and `arrows[i]` to its element id.",
77
+ inputSchema: z.object({
78
+ path: z.string().min(1).describe("Drive path ending in .excalidraw."),
79
+ title: z.string().max(200).optional(),
80
+ shapes: Shapes,
81
+ arrows: Arrows,
82
+ layout: LayoutSchema,
83
+ }),
84
+ outputSchema: swarmToolOutputSchema({ ...boardOut, added: Added.optional() }),
85
+ },
86
+ async (args, requestInfo) => {
87
+ const agentId = requestInfo.agentId;
88
+ const result = await refusing(agentId, () => createBoard({ agentId, ...args }));
89
+ if ("error" in result) return result.error;
90
+ const { object, added } = result.value;
91
+ return toolOk(`Created board ${object.id} at ${where(object)}.`, {
92
+ data: { yourAgentId: agentId, object, version: object.fileVersion, added },
93
+ });
94
+ },
95
+ );
96
+ };
97
+
98
+ export const registerBoardGetTool = (server: McpServer) => {
99
+ createToolRegistrar(server)(
100
+ "board-get",
101
+ {
102
+ title: "Get board",
103
+ annotations: { readOnlyHint: true },
104
+ description:
105
+ "Read a board by `id` or `path`. `detail: summary` (default) lists live elements as id, type, text, x, y, width, height and boundTo (arrow: [from, to]; shape: its arrow ids); a shape's label folds into its text. `detail: full` returns the raw Excalidraw elements.",
106
+ inputSchema: z.object({
107
+ ...IdOrPath,
108
+ detail: z.enum(["summary", "full"]).optional(),
109
+ }),
110
+ outputSchema: swarmToolOutputSchema({
111
+ ...boardOut,
112
+ elements: z.array(z.looseObject({})).optional(),
113
+ }),
114
+ },
115
+ async (args, requestInfo) => {
116
+ const agentId = requestInfo.agentId;
117
+ const result = await refusing(agentId, () => getBoard({ agentId, ...args }));
118
+ if ("error" in result) return result.error;
119
+ const { object, version, elements } = result.value;
120
+ return toolOk(
121
+ `Board ${object.id} at ${where(object)}: ${elements.length} elements, version ${version}.`,
122
+ {
123
+ data: { yourAgentId: agentId, object, version, elements },
124
+ },
125
+ );
126
+ },
127
+ );
128
+ };
129
+
130
+ export const registerBoardListTool = (server: McpServer) => {
131
+ createToolRegistrar(server)(
132
+ "board-list",
133
+ {
134
+ title: "List boards",
135
+ annotations: { readOnlyHint: true },
136
+ description:
137
+ "List boards on your default agent-fs drive, newest first. Filter by path `prefix`. Pagination via limit (max 200) and offset.",
138
+ inputSchema: z.object({
139
+ prefix: z.string().optional(),
140
+ limit: z.number().int().positive().max(200).optional(),
141
+ offset: z.number().int().nonnegative().optional(),
142
+ }),
143
+ outputSchema: swarmToolOutputSchema({
144
+ yourAgentId: z.string().optional(),
145
+ objects: z.array(objectOutputSchema).optional(),
146
+ total: z.number().optional(),
147
+ }),
148
+ },
149
+ async (args, requestInfo) => {
150
+ const agentId = requestInfo.agentId;
151
+ const result = await refusing(agentId, () => listBoards({ agentId, ...args }));
152
+ if ("error" in result) return result.error;
153
+ const { objects, total } = result.value;
154
+ return toolOk(`Found ${objects.length} of ${total} boards.`, {
155
+ details:
156
+ objects.length > 0
157
+ ? objects.map((o) => `- ${o.id} at ${where(o)}`).join("\n")
158
+ : undefined,
159
+ data: { yourAgentId: agentId, objects, total },
160
+ });
161
+ },
162
+ );
163
+ };
164
+
165
+ export const registerBoardAddElementsTool = (server: McpServer) => {
166
+ createToolRegistrar(server)(
167
+ "board-add-elements",
168
+ {
169
+ title: "Add board elements",
170
+ annotations: { readOnlyHint: false, idempotentHint: false },
171
+ description:
172
+ "Add shapes (rectangle, ellipse, diamond, text) and arrows to a board. Arrows bind both ends to shapes, named by a `key` from this call or an existing element id. Shapes without x/y are laid out below existing content. Writes with the file version and re-applies on a concurrent change (3 retries).",
173
+ inputSchema: z.object({ ...IdOrPath, shapes: Shapes, arrows: Arrows, layout: LayoutSchema }),
174
+ outputSchema: swarmToolOutputSchema({ ...boardOut, added: Added.optional() }),
175
+ },
176
+ async (args, requestInfo) => {
177
+ const agentId = requestInfo.agentId;
178
+ const result = await refusing(agentId, () => addBoardElements({ agentId, ...args }));
179
+ if ("error" in result) return result.error;
180
+ const { object, version, added } = result.value;
181
+ return toolOk(
182
+ `Added ${Object.keys(added).length} elements to board ${object.id}, version ${version}.`,
183
+ {
184
+ data: { yourAgentId: agentId, object, version, added },
185
+ },
186
+ );
187
+ },
188
+ );
189
+ };
190
+
191
+ export const registerBoardUpdateElementsTool = (server: McpServer) => {
192
+ createToolRegistrar(server)(
193
+ "board-update-elements",
194
+ {
195
+ title: "Update board elements",
196
+ annotations: { readOnlyHint: false, idempotentHint: true },
197
+ description:
198
+ "Patch board elements by id: label (empty string removes a shape's label), x, y, width, height, color. Bound labels and arrows follow; arrows themselves take only label and color. Each touched element gets a new version, so an open editor repaints it.",
199
+ inputSchema: z.object({
200
+ ...IdOrPath,
201
+ patches: z
202
+ .array(
203
+ z.object({
204
+ elementId: z.string().min(1),
205
+ label: z.string().max(2000).optional(),
206
+ x: Coord.optional(),
207
+ y: Coord.optional(),
208
+ width: Size.optional(),
209
+ height: Size.optional(),
210
+ color: Color.optional(),
211
+ }),
212
+ )
213
+ .min(1)
214
+ .max(200),
215
+ }),
216
+ outputSchema: swarmToolOutputSchema({ ...boardOut, updated: z.array(z.string()).optional() }),
217
+ },
218
+ async (args, requestInfo) => {
219
+ const agentId = requestInfo.agentId;
220
+ const result = await refusing(agentId, () => updateBoardElements({ agentId, ...args }));
221
+ if ("error" in result) return result.error;
222
+ const { object, version, updated } = result.value;
223
+ return toolOk(
224
+ `Updated ${updated.length} elements on board ${object.id}, version ${version}.`,
225
+ {
226
+ data: { yourAgentId: agentId, object, version, updated },
227
+ },
228
+ );
229
+ },
230
+ );
231
+ };
232
+
233
+ export const registerBoardRemoveElementsTool = (server: McpServer) => {
234
+ createToolRegistrar(server)(
235
+ "board-remove-elements",
236
+ {
237
+ title: "Remove board elements",
238
+ annotations: { readOnlyHint: false, idempotentHint: true, destructiveHint: true },
239
+ description:
240
+ "Remove board elements by id (sets `isDeleted: true`, the Excalidraw convention). A shape's label goes with it and its arrows are unbound; a removed arrow leaves its shapes. Refuses unknown ids before writing.",
241
+ inputSchema: z.object({
242
+ ...IdOrPath,
243
+ elementIds: z.array(z.string().min(1)).min(1).max(500),
244
+ }),
245
+ outputSchema: swarmToolOutputSchema({ ...boardOut, removed: z.array(z.string()).optional() }),
246
+ },
247
+ async (args, requestInfo) => {
248
+ const agentId = requestInfo.agentId;
249
+ const result = await refusing(agentId, () => removeBoardElements({ agentId, ...args }));
250
+ if ("error" in result) return result.error;
251
+ const { object, version, removed } = result.value;
252
+ return toolOk(
253
+ `Removed ${removed.length} elements from board ${object.id}, version ${version}.`,
254
+ {
255
+ data: { yourAgentId: agentId, object, version, removed },
256
+ },
257
+ );
258
+ },
259
+ );
260
+ };