@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,136 @@
1
+ /** A1 references and ranges. Pure: no engine, no I/O. */
2
+
3
+ export const MAX_ROW = 1_048_576;
4
+ export const MAX_COL = 16_384;
5
+
6
+ export class A1Error extends Error {}
7
+
8
+ export function colName(col: number): string {
9
+ let name = "";
10
+ for (let n = col; n > 0; n = Math.floor((n - 1) / 26)) {
11
+ name = String.fromCharCode(65 + ((n - 1) % 26)) + name;
12
+ }
13
+ return name;
14
+ }
15
+
16
+ function colNumber(name: string): number {
17
+ let n = 0;
18
+ for (const ch of name.toUpperCase()) n = n * 26 + ch.charCodeAt(0) - 64;
19
+ return n;
20
+ }
21
+
22
+ export const refOf = (row: number, col: number): string => `${colName(col)}${row}`;
23
+
24
+ export function parseCell(ref: string): { row: number; col: number } {
25
+ const m = /^\$?([A-Za-z]{1,3})\$?(\d{1,7})$/.exec(ref.trim());
26
+ const row = m ? Number(m[2]) : 0;
27
+ const col = m?.[1] ? colNumber(m[1]) : 0;
28
+ if (!m || row < 1 || row > MAX_ROW || col < 1 || col > MAX_COL) {
29
+ throw new A1Error(`bad cell reference '${ref}' (rows 1-${MAX_ROW}, columns A-XFD)`);
30
+ }
31
+ return { row, col };
32
+ }
33
+
34
+ export type A1Range = {
35
+ /** Unset when the range names no tab: the caller picks the first tab. */
36
+ tab?: string;
37
+ r1: number;
38
+ c1: number;
39
+ r2: number;
40
+ c2: number;
41
+ /** A whole-column or whole-row range (`A:A`, `2:4`): cap it to the used range before use. */
42
+ open: boolean;
43
+ };
44
+
45
+ const bound = (ref: string) => {
46
+ const m = /^\$?([A-Za-z]{1,3})$/.exec(ref);
47
+ return m?.[1] ? { col: colNumber(m[1]) } : { row: Number(/^\$?(\d{1,7})$/.exec(ref)?.[1]) };
48
+ };
49
+
50
+ /** `Tab!A1:C10`, `'My tab'!A:A`, `B2`, `3:5`. Corners may come in any order. */
51
+ export function parseRange(spec: string): A1Range {
52
+ let tab: string | undefined;
53
+ let rest = spec.trim();
54
+ if (rest.startsWith("'")) {
55
+ const m = /^'((?:[^']|'')+)'!(.+)$/.exec(rest);
56
+ if (!m) throw new A1Error(`bad range '${spec}': a quoted tab name must be followed by '!'`);
57
+ tab = (m[1] ?? "").replaceAll("''", "'");
58
+ rest = m[2] ?? "";
59
+ } else if (rest.includes("!")) {
60
+ const i = rest.lastIndexOf("!");
61
+ tab = rest.slice(0, i);
62
+ rest = rest.slice(i + 1);
63
+ if (!tab) throw new A1Error(`bad range '${spec}': empty tab name`);
64
+ }
65
+ const parts = rest.split(":");
66
+ const [a = "", b = a] = parts;
67
+ if (parts.length > 2 || !a || !b) throw new A1Error(`bad range '${spec}'`);
68
+ try {
69
+ const p = parseCell(a);
70
+ const q = parseCell(b);
71
+ return {
72
+ tab,
73
+ r1: Math.min(p.row, q.row),
74
+ c1: Math.min(p.col, q.col),
75
+ r2: Math.max(p.row, q.row),
76
+ c2: Math.max(p.col, q.col),
77
+ open: false,
78
+ };
79
+ } catch {
80
+ // Not a cell pair: try `A:C` / `2:4` below.
81
+ }
82
+ if (parts.length !== 2)
83
+ throw new A1Error(`bad range '${spec}' (expected e.g. 'Tab!A1:C10' or 'B2')`);
84
+ const x = bound(a);
85
+ const y = bound(b);
86
+ if ("col" in x && "col" in y && x.col && y.col && x.col <= MAX_COL && y.col <= MAX_COL) {
87
+ return {
88
+ tab,
89
+ r1: 1,
90
+ c1: Math.min(x.col, y.col),
91
+ r2: MAX_ROW,
92
+ c2: Math.max(x.col, y.col),
93
+ open: true,
94
+ };
95
+ }
96
+ if ("row" in x && "row" in y && x.row && y.row && x.row <= MAX_ROW && y.row <= MAX_ROW) {
97
+ return {
98
+ tab,
99
+ r1: Math.min(x.row, y.row),
100
+ c1: 1,
101
+ r2: Math.max(x.row, y.row),
102
+ c2: MAX_COL,
103
+ open: true,
104
+ };
105
+ }
106
+ throw new A1Error(`bad range '${spec}' (expected e.g. 'Tab!A1:C10', 'A:A' or 'B2')`);
107
+ }
108
+
109
+ /** Clip an open range to the used extent. Returns null when nothing in the tab lies inside it. */
110
+ export function capToUsed(range: A1Range, used: { rows: number; cols: number }): A1Range | null {
111
+ if (!range.open) return range;
112
+ const r2 = Math.min(range.r2, used.rows);
113
+ const c2 = Math.min(range.c2, used.cols);
114
+ return r2 < range.r1 || c2 < range.c1 ? null : { ...range, r2, c2 };
115
+ }
116
+
117
+ export const quoteTab = (name: string): string =>
118
+ /^[A-Za-z_][A-Za-z0-9_]*$/.test(name) ? name : `'${name.replaceAll("'", "''")}'`;
119
+
120
+ export function formatRange(tab: string, r: Pick<A1Range, "r1" | "c1" | "r2" | "c2">): string {
121
+ const cells =
122
+ r.r1 === r.r2 && r.c1 === r.c2
123
+ ? refOf(r.r1, r.c1)
124
+ : `${refOf(r.r1, r.c1)}:${refOf(r.r2, r.c2)}`;
125
+ return `${quoteTab(tab)}!${cells}`;
126
+ }
127
+
128
+ export const areaOf = (r: Pick<A1Range, "r1" | "c1" | "r2" | "c2">): number =>
129
+ (r.r2 - r.r1 + 1) * (r.c2 - r.c1 + 1);
130
+
131
+ /** Throws when a block anchored in range runs past the last row or column. */
132
+ export function assertInBounds(r: Pick<A1Range, "r2" | "c2">): void {
133
+ if (r.r2 > MAX_ROW || r.c2 > MAX_COL) {
134
+ throw new A1Error(`the range runs past row ${MAX_ROW} or column ${colName(MAX_COL)}`);
135
+ }
136
+ }
@@ -0,0 +1,194 @@
1
+ /**
2
+ * Worker thread entry for the sheet engine. It holds the IronCalc wasm module
3
+ * and runs one recalculation at a time, so a 10k-cell workbook (about 0.7 s of
4
+ * CPU) never stalls the API event loop.
5
+ *
6
+ * The compiled API binary must list this file as an extra entrypoint
7
+ * (see Dockerfile).
8
+ */
9
+ import { initSync, Model } from "@ironcalc/wasm";
10
+ import wasmPath from "@ironcalc/wasm/wasm_bg.wasm" with { type: "file" };
11
+ import { parseCell, refOf } from "./a1";
12
+ import { constantInput, type SheetCell, type SheetTab } from "./format";
13
+
14
+ declare const self: Worker;
15
+
16
+ /** `input` is what a person would type: a formula, a constant, or "" to clear the cell. */
17
+ export type EnginePatch = { tab: string; row: number; col: number; input: string };
18
+ export type EngineRequest = {
19
+ id: number;
20
+ tabs: SheetTab[];
21
+ patches: EnginePatch[];
22
+ /** Refuse when the recalculated workbook (spills included) holds more cells. */
23
+ maxCells: number;
24
+ };
25
+ export type EngineMessage =
26
+ | { type: "ready" }
27
+ | {
28
+ type: "result";
29
+ id: number;
30
+ /** New `cells` per tab, same order as the request. */
31
+ cells: Array<Record<string, SheetCell>>;
32
+ /** Every `Tab!A1` whose stored cell differs from the request's. */
33
+ changed: string[];
34
+ }
35
+ /** `fatal`: a wasm trap, so the instance memory is suspect and the host respawns the worker. */
36
+ | { type: "error"; id?: number; message: string; fatal?: boolean };
37
+
38
+ const NUMBER = 1;
39
+ const BOOLEAN = 4;
40
+ const ERROR = 16;
41
+ const FULL_PRECISION = "0.00000000000000000";
42
+
43
+ initSync({ module: await Bun.file(wasmPath).arrayBuffer() });
44
+
45
+ type Area = { sheet: number; row: number; column: number; width: number; height: number };
46
+ const area = (sheet: number, row: number, column: number): Area => ({
47
+ sheet,
48
+ row,
49
+ column,
50
+ width: 1,
51
+ height: 1,
52
+ });
53
+
54
+ function build(tabs: SheetTab[]): Model {
55
+ const model = new Model("sheet", "en", "UTC", "en");
56
+ // Without the pause every setUserInput re-evaluates: 1k cells take 0.9 s, 10k never finish.
57
+ model.pauseEvaluation();
58
+ tabs.forEach((tab, i) => {
59
+ if (i > 0) model.newSheet();
60
+ model.renameSheet(i, tab.name);
61
+ });
62
+ tabs.forEach((tab, sheet) => {
63
+ for (const [ref, cell] of Object.entries(tab.cells)) {
64
+ if (cell.s) continue; // a cached spill cell: the anchor's formula regenerates it
65
+ const { row, col } = parseCell(ref);
66
+ const input = cell.f ?? (cell.e ? "" : constantInput(cell.v));
67
+ if (cell.nf) model.updateRangeStyle(area(sheet, row, col), "num_fmt", cell.nf);
68
+ if (input !== "") model.setUserInput(sheet, row, col, input);
69
+ }
70
+ });
71
+ return model;
72
+ }
73
+
74
+ /** A cell out of an evaluated model, or null when it is empty. */
75
+ function read(model: Model, sheet: number, row: number, col: number, spillOf?: string) {
76
+ const content = model.getCellContent(sheet, row, col);
77
+ const display = model.getFormattedCellValue(sheet, row, col);
78
+ if (content === "" && display === "") return null;
79
+ const type = model.getCellType(sheet, row, col);
80
+ const fmt = model.getCellStyle(sheet, row, col).style.num_fmt;
81
+ const nf = fmt && fmt.toLowerCase() !== "general" ? fmt : undefined;
82
+ const cell: SheetCell = {};
83
+ if (content.startsWith("=")) cell.f = content;
84
+ if (type === NUMBER) {
85
+ // A constant's content is the exact text typed. A computed number prints at 9 digits
86
+ // under General, so read it at full precision and round to 14 significant digits.
87
+ const typed = Number(content);
88
+ if (!cell.f && !spillOf && content.trim() !== "" && Number.isFinite(typed)) cell.v = typed;
89
+ else {
90
+ const at = area(sheet, row, col);
91
+ model.updateRangeStyle(at, "num_fmt", FULL_PRECISION);
92
+ const raw = Number(model.getFormattedCellValue(sheet, row, col));
93
+ model.updateRangeStyle(at, "num_fmt", nf ?? "General");
94
+ cell.v = Number.isFinite(raw) ? Number(raw.toPrecision(14)) : display;
95
+ }
96
+ } else if (type === BOOLEAN) cell.v = display === "TRUE";
97
+ else {
98
+ cell.v = display;
99
+ if (type === ERROR) cell.e = true;
100
+ }
101
+ if (nf) {
102
+ cell.nf = nf;
103
+ cell.t = display;
104
+ }
105
+ if (spillOf) cell.s = spillOf;
106
+ return cell;
107
+ }
108
+
109
+ const FIELDS = ["f", "v", "e", "nf", "t", "s"] as const;
110
+ const same = (a: SheetCell | undefined, b: SheetCell | undefined) =>
111
+ FIELDS.every((field) => a?.[field] === b?.[field]) && !!a === !!b;
112
+
113
+ function recalc(request: EngineRequest) {
114
+ const model = build(request.tabs);
115
+ try {
116
+ return evaluate(model, request);
117
+ } finally {
118
+ model.free();
119
+ }
120
+ }
121
+
122
+ function evaluate(model: Model, { tabs, patches, maxCells }: EngineRequest) {
123
+ const touched = tabs.map(() => new Set<string>());
124
+ for (const patch of patches) {
125
+ const sheet = tabs.findIndex((tab) => tab.name === patch.tab);
126
+ if (sheet < 0) throw new Error(`no such tab: ${patch.tab}`);
127
+ // rangeClearAll, not rangeClearContents: clearing a text cell (built with the `'` prefix) leaves a stray `'` that reads back as 0.
128
+ // A cleared cell is dropped from the file either way, so losing its style costs nothing.
129
+ if (patch.input === "") model.rangeClearAll(sheet, patch.row, patch.col, patch.row, patch.col);
130
+ else model.setUserInput(sheet, patch.row, patch.col, patch.input);
131
+ touched[sheet]?.add(refOf(patch.row, patch.col));
132
+ }
133
+ model.resumeEvaluation();
134
+ model.evaluate();
135
+
136
+ let total = 0;
137
+ const changed: string[] = [];
138
+ const cells = tabs.map((tab, sheet) => {
139
+ const before = tab.cells;
140
+ const keys = new Set([
141
+ ...Object.keys(before).filter((ref) => !before[ref]?.s),
142
+ ...(touched[sheet] ?? []),
143
+ ]);
144
+ const after = new Map<string, SheetCell>();
145
+ const put = (ref: string, cell: SheetCell | null) => {
146
+ if (!cell) return;
147
+ after.set(ref, cell);
148
+ if (++total > maxCells) throw new Error(`the workbook would exceed ${maxCells} cells`);
149
+ };
150
+ for (const ref of keys) {
151
+ const { row, col } = parseCell(ref);
152
+ const cell = read(model, sheet, row, col);
153
+ put(ref, cell);
154
+ const shape = cell?.f ? model.getCellArrayStructure(sheet, row, col) : "SingleCell";
155
+ if (typeof shape === "object" && "DynamicAnchor" in shape) {
156
+ const [width, height] = shape.DynamicAnchor;
157
+ for (let r = row; r < row + height; r++) {
158
+ for (let c = col; c < col + width; c++) {
159
+ if (r !== row || c !== col) put(refOf(r, c), read(model, sheet, r, c, ref));
160
+ }
161
+ }
162
+ }
163
+ }
164
+ // Row-major so the file diffs cleanly.
165
+ const ordered = [...after].sort(([a], [b]) => {
166
+ const p = parseCell(a);
167
+ const q = parseCell(b);
168
+ return p.row - q.row || p.col - q.col;
169
+ });
170
+ for (const [ref, cell] of ordered) {
171
+ if (!same(cell, before[ref])) changed.push(`${tab.name}!${ref}`);
172
+ }
173
+ for (const ref of Object.keys(before)) if (!after.has(ref)) changed.push(`${tab.name}!${ref}`);
174
+ return Object.fromEntries(ordered);
175
+ });
176
+ return { cells, changed };
177
+ }
178
+
179
+ self.onmessage = (event: MessageEvent<EngineRequest>) => {
180
+ const { id } = event.data;
181
+ try {
182
+ const { cells, changed } = recalc(event.data);
183
+ self.postMessage({ type: "result", id, cells, changed } satisfies EngineMessage);
184
+ } catch (error) {
185
+ self.postMessage({
186
+ type: "error",
187
+ id,
188
+ message: error instanceof Error ? error.message : String(error),
189
+ fatal: error instanceof WebAssembly.RuntimeError,
190
+ } satisfies EngineMessage);
191
+ }
192
+ };
193
+
194
+ self.postMessage({ type: "ready" } satisfies EngineMessage);
@@ -0,0 +1,199 @@
1
+ import { ObjectsError } from "../objects";
2
+ import { refOf } from "./a1";
3
+ import type { EngineMessage, EnginePatch, EngineRequest } from "./engine-worker";
4
+ import type { SheetCell, SheetTab } from "./format";
5
+
6
+ /**
7
+ * Host side of the sheet engine: one long-lived Bun worker holds IronCalc.
8
+ * Calls run one at a time, each with its own timeout. A call that times out
9
+ * kills the worker; the next call starts a fresh one.
10
+ */
11
+
12
+ export const ENGINE_TIMEOUT_MS = 10_000;
13
+ /** Calls waiting or running at once. Bounds the queue wait to about this many timeouts. */
14
+ export const MAX_ENGINE_CALLS = 8;
15
+ /** Calls one caller may have waiting or running, so one agent cannot fill the queue. */
16
+ export const MAX_ENGINE_CALLS_PER_CALLER = 2;
17
+
18
+ /** In the compiled API binary every `import.meta.url` is the binary; see the Dockerfile compile step. */
19
+ function workerSpecifier(): string {
20
+ if (import.meta.url.includes("/$bunfs/")) return "./be/primitives/sheets/engine-worker.ts";
21
+ return new URL("./engine-worker.ts", import.meta.url).href;
22
+ }
23
+
24
+ /**
25
+ * Cells the workbook holds once `patches` land, before any new spill. Cached spill cells
26
+ * count too, so the figure never undercounts what the stored file already holds.
27
+ */
28
+ function cellsAfter(tabs: SheetTab[], patches: EnginePatch[]): number {
29
+ const refs = new Map(tabs.map((tab) => [tab.name, new Set(Object.keys(tab.cells))]));
30
+ for (const patch of patches) {
31
+ const tab = refs.get(patch.tab);
32
+ if (!tab) continue; // the worker refuses an unknown tab
33
+ const ref = refOf(patch.row, patch.col);
34
+ if (patch.input === "") tab.delete(ref);
35
+ else tab.add(ref);
36
+ }
37
+ let total = 0;
38
+ for (const tab of refs.values()) total += tab.size;
39
+ return total;
40
+ }
41
+
42
+ const ARRAY_SIZE =
43
+ /\b(?:SEQUENCE|RANDARRAY|MAKEARRAY)\(\s*(\d+(?:\.\d+)?)\s*(?:,\s*(\d+(?:\.\d+)?)\s*[,)])?/gi;
44
+
45
+ /**
46
+ * Cells that array formulas in `patches` ask for with literal sizes, such as `=SEQUENCE(1000000)`.
47
+ * shortcut: literal sizes only; a computed size (`=SEQUENCE(A1)`) is still caught after
48
+ * evaluation by the worker's cell cap and the timeout. Upgrade to a formula AST walk if
49
+ * computed-size spills show up in practice.
50
+ */
51
+ function literalSpill(patches: EnginePatch[]): number {
52
+ let total = 0;
53
+ for (const { input } of patches) {
54
+ if (!input.startsWith("=")) continue;
55
+ for (const match of input.matchAll(ARRAY_SIZE)) {
56
+ total += Math.ceil(Number(match[1])) * Math.ceil(Number(match[2] ?? 1));
57
+ }
58
+ }
59
+ return total;
60
+ }
61
+
62
+ export type RecalcResult = { cells: Array<Record<string, SheetCell>>; changed: string[] };
63
+
64
+ export class SheetEngine {
65
+ private worker: Promise<Worker> | undefined;
66
+ private queue: Promise<unknown> = Promise.resolve();
67
+ private nextId = 1;
68
+ private pending = new Map<string, number>();
69
+ private total = 0;
70
+
71
+ private spawn(): Promise<Worker> {
72
+ const worker = new Worker(workerSpecifier());
73
+ // An idle engine must not keep the API process (or a test run) alive.
74
+ (worker as Worker & { unref?: () => void }).unref?.();
75
+ return new Promise<Worker>((resolve, reject) => {
76
+ const timer = setTimeout(() => {
77
+ worker.terminate();
78
+ reject(new ObjectsError("sheet engine failed to start in time; retry"));
79
+ }, ENGINE_TIMEOUT_MS);
80
+ worker.addEventListener("message", function onReady(event: MessageEvent<EngineMessage>) {
81
+ if (event.data.type !== "ready") return;
82
+ clearTimeout(timer);
83
+ worker.removeEventListener("message", onReady);
84
+ resolve(worker);
85
+ });
86
+ worker.addEventListener(
87
+ "error",
88
+ (event) => {
89
+ clearTimeout(timer);
90
+ reject(new Error(`sheet engine failed to start: ${event.message}`));
91
+ },
92
+ { once: true },
93
+ );
94
+ });
95
+ }
96
+
97
+ private kill(): void {
98
+ const pending = this.worker;
99
+ this.worker = undefined;
100
+ pending?.then((worker) => worker.terminate()).catch(() => {});
101
+ }
102
+
103
+ /** Apply `patches` to `tabs` and return the recomputed cells. */
104
+ recalc(
105
+ tabs: SheetTab[],
106
+ patches: EnginePatch[],
107
+ options: { maxCells: number; timeoutMs?: number; caller?: string },
108
+ ): Promise<RecalcResult> {
109
+ // Refuse before queueing: a call that cannot fit never holds a workbook in memory or a queue slot.
110
+ const caller = options.caller ?? "";
111
+ const mine = this.pending.get(caller) ?? 0;
112
+ if (this.total >= MAX_ENGINE_CALLS || mine >= MAX_ENGINE_CALLS_PER_CALLER) {
113
+ return Promise.reject(
114
+ new ObjectsError("sheet engine is busy with other recalculations; retry in a few seconds"),
115
+ );
116
+ }
117
+ const cells = cellsAfter(tabs, patches);
118
+ const spill = literalSpill(patches);
119
+ if (cells + spill > options.maxCells) {
120
+ const spilled = spill > 0 ? ` (${spill} of them spilled by array formulas)` : "";
121
+ return Promise.reject(
122
+ new ObjectsError(
123
+ `the workbook would exceed ${options.maxCells} cells: this write leaves ${cells + spill}${spilled}`,
124
+ ),
125
+ );
126
+ }
127
+ this.pending.set(caller, mine + 1);
128
+ this.total++;
129
+ const release = () => {
130
+ this.total--;
131
+ const left = (this.pending.get(caller) ?? 1) - 1;
132
+ if (left > 0) this.pending.set(caller, left);
133
+ else this.pending.delete(caller);
134
+ };
135
+ const run = async (): Promise<RecalcResult> => {
136
+ this.worker ??= this.spawn();
137
+ let worker: Worker;
138
+ try {
139
+ worker = await this.worker;
140
+ } catch (error) {
141
+ this.worker = undefined;
142
+ throw error;
143
+ }
144
+ const id = this.nextId++;
145
+ const timeoutMs = options.timeoutMs ?? ENGINE_TIMEOUT_MS;
146
+ return new Promise<RecalcResult>((resolve, reject) => {
147
+ const done = () => {
148
+ clearTimeout(timer);
149
+ worker.removeEventListener("message", onMessage);
150
+ worker.removeEventListener("error", onError);
151
+ };
152
+ const timer = setTimeout(() => {
153
+ done();
154
+ this.kill();
155
+ reject(
156
+ new ObjectsError(
157
+ `sheet engine timed out after ${timeoutMs} ms; the workbook is too heavy to recalculate`,
158
+ ),
159
+ );
160
+ }, timeoutMs);
161
+ const onMessage = (event: MessageEvent<EngineMessage>) => {
162
+ const message = event.data;
163
+ if (message.type === "result" && message.id === id) {
164
+ done();
165
+ resolve({ cells: message.cells, changed: message.changed });
166
+ } else if (message.type === "error" && message.id === id) {
167
+ done();
168
+ if (message.fatal) this.kill();
169
+ reject(new ObjectsError(message.message));
170
+ }
171
+ };
172
+ const onError = (event: ErrorEvent) => {
173
+ done();
174
+ this.kill();
175
+ reject(new Error(`sheet engine crashed: ${event.message}`));
176
+ };
177
+ worker.addEventListener("message", onMessage);
178
+ worker.addEventListener("error", onError);
179
+ const request: EngineRequest = { id, tabs, patches, maxCells: options.maxCells };
180
+ worker.postMessage(request);
181
+ });
182
+ };
183
+ // One call at a time: the timeout clock starts when the worker is free, not when the call queues.
184
+ const result = this.queue.then(run, run).finally(release);
185
+ this.queue = result.catch(() => {});
186
+ return result;
187
+ }
188
+
189
+ /** Stop the worker. The next call starts a new one. */
190
+ stop(): void {
191
+ this.kill();
192
+ }
193
+ }
194
+
195
+ let shared: SheetEngine | undefined;
196
+ export const sheetEngine = (): SheetEngine => {
197
+ shared ??= new SheetEngine();
198
+ return shared;
199
+ };
@@ -0,0 +1,106 @@
1
+ import * as z from "zod";
2
+ import { A1Error, parseCell } from "./a1";
3
+
4
+ /**
5
+ * `swarm-sheet/1`: a workbook as one `.sheet.json` file. Cells are a sparse
6
+ * A1-keyed map per tab holding the cached result next to the formula, so a read
7
+ * never needs the engine. Fields: `v` value, `f` formula, `e` error flag, `nf`
8
+ * number format, `t` formatted text (only with `nf`), `s` spill anchor (the cell
9
+ * holds a cached spilled value, the formula lives at the anchor).
10
+ */
11
+ export const SHEET_FORMAT = "swarm-sheet/1";
12
+
13
+ export const MAX_TABS = 20;
14
+ export const MAX_CELLS = 50_000;
15
+ export const MAX_FILE_BYTES = 5 * 1024 * 1024;
16
+ export const MAX_RANGE_CELLS = 10_000;
17
+
18
+ const CellSchema = z.looseObject({
19
+ v: z.union([z.number(), z.string(), z.boolean(), z.null()]).optional(),
20
+ f: z.string().startsWith("=").optional(),
21
+ e: z.boolean().optional(),
22
+ nf: z.string().optional(),
23
+ t: z.string().optional(),
24
+ s: z.string().optional(),
25
+ });
26
+
27
+ const TabSchema = z.looseObject({
28
+ name: z.string().min(1),
29
+ colWidths: z.record(z.string(), z.number()).optional(),
30
+ freezeRows: z.number().int().nonnegative().optional(),
31
+ merges: z.array(z.string()).optional(),
32
+ cells: z.record(
33
+ z.string().refine((ref) => {
34
+ try {
35
+ parseCell(ref);
36
+ return true;
37
+ } catch {
38
+ return false;
39
+ }
40
+ }, "cell keys are A1 references"),
41
+ CellSchema,
42
+ ),
43
+ });
44
+
45
+ export const SheetDocSchema = z.looseObject({
46
+ format: z.literal(SHEET_FORMAT),
47
+ swarm: z.looseObject({
48
+ id: z.string().min(1),
49
+ kind: z.literal("sheet"),
50
+ title: z.string().optional(),
51
+ }),
52
+ tabs: z.array(TabSchema).min(1).max(MAX_TABS),
53
+ });
54
+
55
+ export type SheetCell = z.infer<typeof CellSchema>;
56
+ export type SheetTab = z.infer<typeof TabSchema>;
57
+ export type SheetDoc = z.infer<typeof SheetDocSchema>;
58
+
59
+ export const cellCount = (doc: Pick<SheetDoc, "tabs">): number =>
60
+ doc.tabs.reduce((n, tab) => n + Object.keys(tab.cells).length, 0);
61
+
62
+ /** Excel's tab-name rules: 1-31 characters, none of `[]:*?/\`, no edge apostrophes. */
63
+ export function checkTabName(name: string): string {
64
+ if (name.length < 1 || name.length > 31 || /[[\]:*?/\\]/.test(name) || /^'|'$/.test(name)) {
65
+ throw new A1Error(
66
+ `invalid tab name '${name}': 1-31 characters, none of []:*?/\\ , no leading or trailing apostrophe`,
67
+ );
68
+ }
69
+ return name;
70
+ }
71
+
72
+ export function newTab(name: string): SheetTab {
73
+ return { name: checkTabName(name), cells: {} };
74
+ }
75
+
76
+ /** The file `object-create` writes for kind `sheet`: one empty `Sheet1`. */
77
+ export const emptySheet = (id: string, title?: string): SheetDoc => ({
78
+ format: SHEET_FORMAT,
79
+ swarm: { id, kind: "sheet", ...(title ? { title } : {}) },
80
+ tabs: [newTab("Sheet1")],
81
+ });
82
+
83
+ /** Used extent of a tab: the last row and column holding a cell (0 when empty). */
84
+ export function usedExtent(tab: SheetTab): { rows: number; cols: number } {
85
+ let rows = 0;
86
+ let cols = 0;
87
+ for (const ref of Object.keys(tab.cells)) {
88
+ const { row, col } = parseCell(ref);
89
+ if (row > rows) rows = row;
90
+ if (col > cols) cols = col;
91
+ }
92
+ return { rows, cols };
93
+ }
94
+
95
+ /**
96
+ * What a person would type to store this constant. Every string gets the `'` text
97
+ * prefix: the engine otherwise coerces `$12`, ` 007`, `12%` and `1e3` to numbers.
98
+ * The engine strips one leading `'` and keeps the rest as text. Formulas never
99
+ * come through here (`cell.f` and `inputFor` handle them), and "" clears the cell.
100
+ */
101
+ export function constantInput(v: SheetCell["v"] | undefined): string {
102
+ if (v === null || v === undefined) return "";
103
+ if (typeof v === "boolean") return v ? "TRUE" : "FALSE";
104
+ if (typeof v === "number") return String(v);
105
+ return v === "" ? "" : `'${v}`;
106
+ }