@desplega.ai/agent-swarm 2.10.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-c4chgxp6.js} +27 -24
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-hn5fftf5.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-3g6yc8nv.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-cpjgpjvp.js} +29 -26
  10. package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
  11. package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-hce1av1h.js} +1 -1
  12. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-bztbxc4z.js} +1 -1
  13. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-d7xcym0j.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-arrkbe8t.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-68n75y1s.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-ykpyr5p8.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-trd59v7b.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-yjcze0j1.js} +10941 -10412
  21. package/dist/{cli-vq2eg24x.js → cli-01tvvtad.js} +63 -60
  22. package/dist/cli-04zc3f7b.js +68 -0
  23. package/dist/{cli-01k6wpr9.js → cli-0k1a0sde.js} +7 -7
  24. package/dist/{cli-j6te8keb.js → cli-0pp1yjg2.js} +8 -8
  25. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  26. package/dist/{cli-wwp1bd3n.js → cli-12vek61e.js} +564 -97
  27. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  28. package/dist/{cli-124ntmf0.js → cli-1htmtqc2.js} +143 -63
  29. package/dist/{cli-3f8zbtqa.js → cli-2amwhyv2.js} +15 -11
  30. package/dist/{cli-7sf9sb0w.js → cli-2m6yaq6b.js} +1 -1
  31. package/dist/{cli-6cwr32fe.js → cli-2tw284hj.js} +422 -140
  32. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  33. package/dist/{cli-nstkanmx.js → cli-39qm0rtm.js} +8 -8
  34. package/dist/{cli-hnamkvnc.js → cli-3p288654.js} +2 -2
  35. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  38. package/dist/cli-52nfye5j.js +673 -0
  39. package/dist/cli-55tc8cj4.js +252 -0
  40. package/dist/cli-5r95eqbh.js +186 -0
  41. package/dist/{cli-6037prsx.js → cli-5tg94mdw.js} +13 -13
  42. package/dist/{cli-2spnz7ye.js → cli-5x03v6en.js} +11137 -8332
  43. package/dist/{cli-y4ccxtz5.js → cli-5z0g0e8v.js} +153 -6
  44. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  45. package/dist/{cli-539h29es.js → cli-72yms3ey.js} +224 -189
  46. package/dist/{cli-y8p78ekx.js → cli-73q4g5nx.js} +21 -21
  47. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  48. package/dist/{cli-43ms35q9.js → cli-7wy8gbwb.js} +3 -3
  49. package/dist/{cli-7mv4h3sn.js → cli-7yn42w6m.js} +2 -2
  50. package/dist/{cli-gabsjg8x.js → cli-8hp56wat.js} +3 -2
  51. package/dist/cli-8mfdbdhe.js +43 -0
  52. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  53. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  54. package/dist/{cli-2rnd5j3t.js → cli-9qe5y107.js} +2 -2
  55. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  56. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3aaeb78m.js → cli-agjbj5x0.js} +95 -10
  59. package/dist/{cli-th1dkc2v.js → cli-b93d81yg.js} +2 -2
  60. package/dist/{cli-qj39vrc6.js → cli-bhgrhedp.js} +1 -1
  61. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  62. package/dist/{cli-9fjr27ez.js → cli-bp6k9acz.js} +18 -22
  63. package/dist/{cli-5a6pqy45.js → cli-bpje8n65.js} +31 -4
  64. package/dist/{cli-2v2zdm0a.js → cli-bz97ff9n.js} +2 -2
  65. package/dist/{cli-3caf7pmg.js → cli-c7j31hq9.js} +3 -3
  66. package/dist/{cli-t9ga4qmb.js → cli-cah298e5.js} +40 -33
  67. package/dist/{cli-aw83sr40.js → cli-cjqyse9q.js} +3 -3
  68. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  69. package/dist/{cli-nv4xsvmk.js → cli-dkvtfgn4.js} +7 -7
  70. package/dist/{cli-7r162fxe.js → cli-e3ahxq5y.js} +23 -17
  71. package/dist/{cli-3et6fmfe.js → cli-e8n0hdzd.js} +1 -1
  72. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  73. package/dist/{cli-kbtzfrxj.js → cli-en6dmkxd.js} +3 -3
  74. package/dist/{cli-m9cvf7vs.js → cli-eq4kew31.js} +14 -14
  75. package/dist/{cli-fcfbct2j.js → cli-eqq0hwvx.js} +5 -5
  76. package/dist/{cli-7zm3b3f5.js → cli-ercwc8xn.js} +1 -1
  77. package/dist/{cli-vs9vdpy0.js → cli-ex1y88j3.js} +1 -1
  78. package/dist/{cli-mk7c5ac4.js → cli-fxd1mwtr.js} +2 -2
  79. package/dist/{cli-91pkxres.js → cli-fy4gb74g.js} +2 -2
  80. package/dist/{cli-fq2rr3jb.js → cli-fyaq4zdv.js} +6 -6
  81. package/dist/{cli-cc93xzes.js → cli-gfy6hbd9.js} +28 -17
  82. package/dist/{cli-s1khw52h.js → cli-h70a2mxy.js} +71 -17
  83. package/dist/cli-hbvgzjq4.js +69 -0
  84. package/dist/{cli-qx4f057j.js → cli-hhc47ack.js} +4 -4
  85. package/dist/{cli-q5srsxq2.js → cli-j5gtytvg.js} +154 -41
  86. package/dist/{cli-psffsanb.js → cli-js10kdk7.js} +6 -1
  87. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  88. package/dist/{cli-vsw91x06.js → cli-k5jx8jya.js} +10 -6
  89. package/dist/{cli-tr27kwyg.js → cli-krbcr00p.js} +261 -6
  90. package/dist/{cli-5qhfv9rw.js → cli-kwr5qv5g.js} +44 -17
  91. package/dist/{cli-md50mj0r.js → cli-m5qtmrbc.js} +3 -3
  92. package/dist/{cli-vfqvrd82.js → cli-ma9ys8rt.js} +2 -2
  93. package/dist/{cli-w16kwbzw.js → cli-mbwmqb5w.js} +1 -1
  94. package/dist/{cli-w1q68d8x.js → cli-mcymtvwn.js} +322 -72
  95. package/dist/{cli-k3q2va86.js → cli-mq2fbgva.js} +66 -5
  96. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  97. package/dist/{cli-kpgcm7xy.js → cli-n85m2wkq.js} +1 -1
  98. package/dist/{cli-v8z0yga9.js → cli-n8f0fs3c.js} +4 -4
  99. package/dist/{cli-mys27d03.js → cli-nja15knq.js} +3 -3
  100. package/dist/{cli-zk7v5s89.js → cli-pe3yxedk.js} +3 -3
  101. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  102. package/dist/{cli-6237rnyr.js → cli-pqfecppn.js} +1 -1
  103. package/dist/{cli-qrta34nb.js → cli-q2dywc8h.js} +4 -4
  104. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  105. package/dist/{cli-s1zqk1aj.js → cli-q8tc22bj.js} +15 -9
  106. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  107. package/dist/{cli-43evxwj4.js → cli-r0mz92by.js} +9 -4
  108. package/dist/{cli-jrbq4djp.js → cli-r14ac1y0.js} +1 -1
  109. package/dist/{cli-5gpqgs8b.js → cli-rtmqzat7.js} +2 -2
  110. package/dist/{cli-tvgqesec.js → cli-s6zk31gr.js} +4 -4
  111. package/dist/{cli-6ym4jhzp.js → cli-sv2r3bw8.js} +7 -7
  112. package/dist/{cli-wafmk3fn.js → cli-t75xngj1.js} +12 -12
  113. package/dist/{cli-x40a0w9j.js → cli-tdk7jtka.js} +1 -1
  114. package/dist/{cli-zeh2mhkg.js → cli-tm60vtax.js} +1 -1
  115. package/dist/cli-tsfkcd4v.js +30 -0
  116. package/dist/{cli-8st34zhr.js → cli-v9ya390t.js} +57 -19
  117. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  118. package/dist/{cli-p0n7b5rz.js → cli-wvjqaqcp.js} +2907 -151
  119. package/dist/{cli-sb4426be.js → cli-xf4z5bdn.js} +5 -5
  120. package/dist/{cli-p0c3vtch.js → cli-xm34qj8m.js} +772 -515
  121. package/dist/{cli-z0m452jr.js → cli-ya3kf4gs.js} +1 -1
  122. package/dist/{cli-had1p04a.js → cli-yegz2g06.js} +4 -4
  123. package/dist/{cli-k5yewqgd.js → cli-yfpc6qy9.js} +3 -3
  124. package/dist/{cli-q2d3e1k1.js → cli-z4f346g5.js} +1 -1
  125. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  126. package/dist/cli.js +34 -30
  127. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  128. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-wc6e4wct.js} +8 -8
  129. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  130. package/dist/{codex-login-a239g1ah.js → codex-login-1ven7yje.js} +1 -1
  131. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-ppfgjd97.js} +9 -9
  132. package/dist/{commands-d8g349v4.js → commands-tsv2vx5b.js} +3 -3
  133. package/dist/{controller-mwgdmb8y.js → controller-ye4sdwsy.js} +4 -4
  134. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-zn4dg69h.js} +25 -22
  135. package/dist/core-dxcy02sc.js +41 -0
  136. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-q2g9vwts.js} +2 -2
  137. package/dist/{db-wcw0b2j8.js → db-3r1fyr2n.js} +6 -2
  138. package/dist/{db-qpganbeb.js → db-g111qn9j.js} +3 -3
  139. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-t8d86q9x.js} +1 -1
  140. package/dist/{dispatcher-8d8s49yz.js → dispatcher-4q8s0mx8.js} +22 -19
  141. package/dist/{docker-09tkkg0n.js → docker-1b41eysj.js} +51 -14
  142. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-mmcw1z5s.js} +2 -2
  143. package/dist/{e2b-3v1e745x.js → e2b-ew8c5j5v.js} +3 -3
  144. package/dist/{e2b-sm28k0k3.js → e2b-xm60c8ad.js} +6 -6
  145. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-04ke6hcp.js} +1 -1
  146. package/dist/{embedding-space-e48xchqa.js → embedding-space-kcdn52vz.js} +6 -6
  147. package/dist/{embeddings-tgq2afbq.js → embeddings-jnzcd91a.js} +1 -1
  148. package/dist/{event-bus-xr83x566.js → event-bus-v4ywhc2p.js} +1 -1
  149. package/dist/{execute-8rhwrk7f.js → execute-74amghty.js} +8 -4
  150. package/dist/{external-channel-8bt3j2pm.js → external-channel-v9zgxnxz.js} +2 -2
  151. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  152. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  153. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  154. package/dist/grok-adapter-t6m74fb1.js +19 -0
  155. package/dist/handlers-9kwcrc4k.js +38 -0
  156. package/dist/{heartbeat-x0056ra5.js → heartbeat-p8pk1msj.js} +25 -22
  157. package/dist/{hook-a7vmn2st.js → hook-k1h73zd7.js} +5 -5
  158. package/dist/{hook-mrd2ayxv.js → hook-p5reemds.js} +8 -8
  159. package/dist/{http-ym9c5svp.js → http-ms1z5xxy.js} +2549 -224
  160. package/dist/index-23cdfzr6.js +39 -0
  161. package/dist/{index-01ns1pkw.js → index-76zzxtzf.js} +1 -1
  162. package/dist/{index-ny60jcat.js → index-fbkqhvvj.js} +40 -18
  163. package/dist/index-g7kkjs5b.js +38 -0
  164. package/dist/{index-x6azjwm8.js → index-gjn6qfgn.js} +1 -1
  165. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  166. package/dist/{index-p46tvwtx.js → index-kn63q1gr.js} +28 -25
  167. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  168. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  169. package/dist/index-stk36pa5.js +43 -0
  170. package/dist/{k8s-m56sw868.js → k8s-fy8hbhkg.js} +73 -14
  171. package/dist/{keepalive-7yxg8z4c.js → keepalive-031js8jz.js} +4 -4
  172. package/dist/lead-mfggjtfk.js +77 -0
  173. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  174. package/dist/{maintenance-6tefxmk1.js → maintenance-sq9v3qx9.js} +1 -1
  175. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  176. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  177. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  178. package/dist/object-webhooks-r24wwb5y.js +21 -0
  179. package/dist/{onboard-fja65z08.js → onboard-p25yhh7t.js} +5 -5
  180. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  181. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  182. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  183. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  184. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-wcjc4zdk.js} +7 -7
  185. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  186. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-ff1gf20m.js} +2 -2
  187. package/dist/{pending-h01yzpx4.js → pending-hxj5yatb.js} +23 -20
  188. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  189. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-vkp4zz7p.js} +19 -18
  190. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-9w7gx41w.js} +2 -2
  191. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-84aw10nz.js} +3 -3
  192. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-hz74vckp.js} +2 -2
  193. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  194. package/dist/{render-v2-1rgspxzf.js → render-v2-nrdkg9gf.js} +7 -6
  195. package/dist/{resume-tqy61x24.js → resume-s6ey36rh.js} +9 -8
  196. package/dist/{runtime-exkxyx5f.js → runtime-x0b4pyam.js} +2 -2
  197. package/dist/{session-access-3act7vt4.js → session-access-xv49tk14.js} +4 -4
  198. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-r5j988ah.js} +3 -3
  199. package/dist/{setup-ry1vfdef.js → setup-mj0krk1p.js} +1 -1
  200. package/dist/thread-buffer-temgaqsy.js +41 -0
  201. package/dist/tree-visibility-cbrsfaar.js +24 -0
  202. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  203. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  204. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-ns0ryw05.js} +32 -10
  205. package/dist/{work-objects-z2e5tv03.js → work-objects-pydhzast.js} +25 -22
  206. package/dist/worker-efcemc22.js +77 -0
  207. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-9z2xec5e.js} +22 -19
  208. package/dist/{x-wg164ss9.js → x-3dtaf2r9.js} +2 -2
  209. package/openapi.json +2040 -559
  210. package/package.json +15 -11
  211. package/src/azure-devops/auth.ts +2 -3
  212. package/src/be/agent-fs-identity.ts +46 -0
  213. package/src/be/agent-history.ts +215 -0
  214. package/src/be/db/agents.ts +34 -12
  215. package/src/be/db/request-composition.ts +190 -0
  216. package/src/be/db/runtime.ts +15 -0
  217. package/src/be/db/slack-trees.ts +220 -10
  218. package/src/be/db/tasks/human-free.ts +3 -2
  219. package/src/be/db/tasks/write.ts +2 -2
  220. package/src/be/db/workflow-run-retention.ts +101 -0
  221. package/src/be/db-client.ts +23 -1
  222. package/src/be/db-retention-defaults.ts +46 -0
  223. package/src/be/db-retention.ts +55 -6
  224. package/src/be/db.ts +2 -0
  225. package/src/be/mcp-events/catalog.ts +108 -0
  226. package/src/be/mcp-events/dispatcher.ts +202 -0
  227. package/src/be/mcp-events/protocol.ts +296 -0
  228. package/src/be/mcp-events/store.ts +231 -0
  229. package/src/be/mcp-events/webhook.ts +226 -0
  230. package/src/be/memory/providers/sqlite-store.ts +110 -24
  231. package/src/be/memory/review-recall-filter.ts +22 -0
  232. package/src/be/memory/search-candidates.ts +5 -7
  233. package/src/be/memory/types.ts +5 -0
  234. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  235. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  236. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  237. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  238. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  239. package/src/be/migrations/330_request_composition.sql +22 -0
  240. package/src/be/migrations/332_primitive_objects.sql +31 -0
  241. package/src/be/migrations/334_agent_history.sql +23 -0
  242. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  243. package/src/be/model-profile-check.ts +1 -1
  244. package/src/be/multi-runtime.ts +32 -4
  245. package/src/be/primitives/boards/elements.ts +717 -0
  246. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  247. package/src/be/primitives/boards/service.ts +121 -0
  248. package/src/be/primitives/object-webhooks.ts +348 -0
  249. package/src/be/primitives/objects.ts +686 -0
  250. package/src/be/primitives/sheets/a1.ts +136 -0
  251. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  252. package/src/be/primitives/sheets/engine.ts +199 -0
  253. package/src/be/primitives/sheets/format.ts +106 -0
  254. package/src/be/primitives/sheets/service.ts +415 -0
  255. package/src/be/primitives/write-object.ts +83 -0
  256. package/src/be/runtime-pools/controllers.ts +18 -3
  257. package/src/be/runtime-pools/db.ts +15 -4
  258. package/src/be/runtime-pools/supervisor.ts +42 -2
  259. package/src/be/script-credential-broker.ts +8 -27
  260. package/src/be/scripts/typecheck.ts +216 -0
  261. package/src/be/seed/agent-fs-provision.ts +18 -0
  262. package/src/be/swarm-config-guard.ts +10 -2
  263. package/src/be/users.ts +19 -0
  264. package/src/commands/context-preamble.ts +11 -4
  265. package/src/commands/credential-outcome-report.ts +33 -9
  266. package/src/commands/e2b-stack-wizard.tsx +12 -6
  267. package/src/commands/onboard/agent-fs-version.ts +1 -1
  268. package/src/commands/onboard/steps/harness.tsx +1 -1
  269. package/src/commands/provider-credentials.ts +1 -0
  270. package/src/commands/runner.ts +116 -12
  271. package/src/e2b/env.ts +3 -1
  272. package/src/extensions/catalog.generated.json +1 -1
  273. package/src/fs/agent-fs-provider.ts +33 -2
  274. package/src/github/app.ts +59 -14
  275. package/src/gitlab/auth.ts +3 -4
  276. package/src/heartbeat/heartbeat.ts +11 -11
  277. package/src/http/agent-lifecycle.ts +152 -0
  278. package/src/http/agents.ts +12 -0
  279. package/src/http/all-routes.ts +4 -0
  280. package/src/http/auth.ts +2 -1
  281. package/src/http/config.ts +2 -1
  282. package/src/http/core.ts +2 -0
  283. package/src/http/github-token.ts +66 -0
  284. package/src/http/index.ts +36 -0
  285. package/src/http/mcp-user.ts +11 -8
  286. package/src/http/mcp.ts +58 -42
  287. package/src/http/object-webhooks.ts +101 -0
  288. package/src/http/operator-actor.ts +2 -1
  289. package/src/http/prompt-templates.ts +1 -0
  290. package/src/http/request-composition.ts +310 -0
  291. package/src/http/sessions.ts +7 -0
  292. package/src/http/tasks.ts +6 -1
  293. package/src/http/tool-schema-estimate.ts +95 -0
  294. package/src/http/workflows.ts +61 -11
  295. package/src/integrations/chat-sdk/inbound.ts +2 -2
  296. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  297. package/src/prompts/base-prompt.ts +133 -7
  298. package/src/prompts/resolver.ts +41 -2
  299. package/src/providers/acp-targets.ts +2 -2
  300. package/src/providers/amp-adapter.ts +1 -1
  301. package/src/providers/opencode-adapter.ts +76 -2
  302. package/src/providers/opencode-swarm-plugin.ts +22 -3
  303. package/src/providers/pi-mono-adapter.ts +1 -0
  304. package/src/providers/pi-mono-extension.ts +71 -0
  305. package/src/providers/pricing-sources.md +4 -0
  306. package/src/providers/request-composition-hook.ts +312 -0
  307. package/src/providers/types.ts +5 -0
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/runtime-providers/controller-protocol.ts +7 -0
  311. package/src/runtime-providers/docker.ts +80 -12
  312. package/src/runtime-providers/k8s.ts +111 -6
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/script-workflows/guest-ctx.ts +32 -0
  316. package/src/script-workflows/workflow-ctx.ts +2 -0
  317. package/src/scripts-runtime/ctx.ts +9 -1
  318. package/src/scripts-runtime/executors/native.ts +106 -21
  319. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  320. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  321. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  322. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  323. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  324. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  325. package/src/server-user.ts +16 -1
  326. package/src/server.ts +48 -0
  327. package/src/slack/ack.ts +10 -5
  328. package/src/slack/actions.ts +3 -3
  329. package/src/slack/app.ts +2 -0
  330. package/src/slack/assistant.ts +4 -4
  331. package/src/slack/blocks.ts +3 -3
  332. package/src/slack/handlers.ts +3 -3
  333. package/src/slack/reaction-shortcode.ts +23 -2
  334. package/src/slack/render-v2.ts +297 -200
  335. package/src/slack/responses.ts +7 -5
  336. package/src/slack/thread-buffer.ts +3 -3
  337. package/src/slack/tree-visibility.ts +64 -0
  338. package/src/tasks/worker-follow-up.ts +127 -17
  339. package/src/tests/agent-history.test.ts +313 -0
  340. package/src/tests/azure-devops-auth.test.ts +6 -0
  341. package/src/tests/azure-devops-outbound.test.ts +47 -14
  342. package/src/tests/base-prompt.test.ts +149 -1
  343. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  344. package/src/tests/check-playwright-version.test.ts +33 -0
  345. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  346. package/src/tests/context-preamble-budget.test.ts +65 -0
  347. package/src/tests/credential-check.test.ts +12 -0
  348. package/src/tests/credential-outcome-report.test.ts +81 -1
  349. package/src/tests/db-client.test.ts +22 -0
  350. package/src/tests/db-retention-defaults.test.ts +244 -0
  351. package/src/tests/db-retention.test.ts +2 -1
  352. package/src/tests/db-task-read-contract.test.ts +2 -0
  353. package/src/tests/db-task-write-contract.test.ts +2 -0
  354. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  355. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  356. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  357. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  358. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  359. package/src/tests/e2e-shards.test.ts +137 -0
  360. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  361. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  362. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  363. package/src/tests/env-flag.test.ts +4 -2
  364. package/src/tests/event-loop-lag.test.ts +12 -18
  365. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  366. package/src/tests/extensions-heartbeat.test.ts +34 -0
  367. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  368. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  369. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  370. package/src/tests/github-installation-token-route.test.ts +199 -0
  371. package/src/tests/gitlab-auth.test.ts +10 -0
  372. package/src/tests/heartbeat.test.ts +38 -0
  373. package/src/tests/http-api-integration.test.ts +0 -6
  374. package/src/tests/mcp-user-events.test.ts +708 -0
  375. package/src/tests/memory-key-paths.test.ts +4 -1
  376. package/src/tests/memory-search-stall.test.ts +421 -0
  377. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  378. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  379. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  380. package/src/tests/opencode-adapter.test.ts +97 -0
  381. package/src/tests/pi-mono-extension.test.ts +168 -0
  382. package/src/tests/preload-env.test.ts +61 -1
  383. package/src/tests/preload.ts +22 -0
  384. package/src/tests/primitives-boards.test.ts +686 -0
  385. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  386. package/src/tests/primitives-objects.test.ts +248 -0
  387. package/src/tests/prompt-template-resolver.test.ts +85 -0
  388. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  389. package/src/tests/reload-config.test.ts +45 -0
  390. package/src/tests/request-composition.test.ts +447 -0
  391. package/src/tests/runner-max-concurrent.test.ts +86 -0
  392. package/src/tests/runtime-pools-db.test.ts +80 -0
  393. package/src/tests/runtime-provider-registration.test.ts +8 -0
  394. package/src/tests/runtime-providers-docker.test.ts +192 -1
  395. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  396. package/src/tests/runtime-remote-controller.test.ts +64 -1
  397. package/src/tests/runtime-supervisor.test.ts +101 -0
  398. package/src/tests/script-connections.test.ts +8 -0
  399. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  400. package/src/tests/scripts-namespaces.test.ts +211 -0
  401. package/src/tests/secret-scrub-gate.test.ts +1 -0
  402. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  403. package/src/tests/secret-scrubber.test.ts +1 -1
  404. package/src/tests/session-tokens.test.ts +27 -0
  405. package/src/tests/sheet-engine.test.ts +58 -0
  406. package/src/tests/slack-blocks.test.ts +18 -0
  407. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  408. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  409. package/src/tests/slack-reaction-config.test.ts +38 -2
  410. package/src/tests/slack-read-boundaries.test.ts +4 -2
  411. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  412. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  413. package/src/tests/slack-render-v2.test.ts +683 -11
  414. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  415. package/src/tests/task-session-prompts.test.ts +37 -0
  416. package/src/tests/task-start-after-commit.test.ts +82 -0
  417. package/src/tests/ui-logs-parser.test.ts +67 -0
  418. package/src/tests/user-delete-perf.test.ts +36 -9
  419. package/src/tests/webhook-filter.test.ts +327 -0
  420. package/src/tests/workflow-async-v2.test.ts +19 -16
  421. package/src/tests/workflow-e2e.test.ts +1 -9
  422. package/src/tests/workflow-finalization-races.test.ts +553 -0
  423. package/src/tests/workflow-foreach.test.ts +2 -0
  424. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  425. package/src/tests/workflow-http-v2.test.ts +105 -2
  426. package/src/tests/workflow-idempotency.test.ts +41 -0
  427. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  428. package/src/tests/workflow-parallel-park.test.ts +297 -0
  429. package/src/tests/workflow-retry-v2.test.ts +158 -21
  430. package/src/tests/workflow-retry-validation.test.ts +13 -13
  431. package/src/tests/workflow-runs-retention.test.ts +533 -0
  432. package/src/tests/workflow-script-principal.test.ts +7 -2
  433. package/src/tests/workflow-tla-races.test.ts +36 -2
  434. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  435. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  436. package/src/tests/workflow-wait-event.test.ts +28 -2
  437. package/src/tests/workflow-wait-poller.test.ts +94 -0
  438. package/src/tests/workflow-wait-time.test.ts +7 -3
  439. package/src/tests/workflow-wait.ts +44 -0
  440. package/src/tools/boards.ts +260 -0
  441. package/src/tools/objects.ts +191 -0
  442. package/src/tools/sheets.ts +312 -0
  443. package/src/tools/slack-read.ts +10 -3
  444. package/src/tools/tool-config.ts +23 -0
  445. package/src/tools/workflows/create-workflow.ts +18 -4
  446. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  447. package/src/tools/workflows/patch-workflow.ts +4 -0
  448. package/src/tools/workflows/update-workflow.ts +24 -3
  449. package/src/types.ts +216 -2
  450. package/src/utils/credentials.ts +7 -0
  451. package/src/utils/sandboxed-process.ts +47 -2
  452. package/src/utils/secret-scrubber.ts +61 -6
  453. package/src/workflows/checkpoint.ts +18 -0
  454. package/src/workflows/engine.ts +73 -31
  455. package/src/workflows/foreach-driver.ts +42 -4
  456. package/src/workflows/input.ts +29 -1
  457. package/src/workflows/patch-definition.ts +15 -1
  458. package/src/workflows/recovery.ts +6 -1
  459. package/src/workflows/resume.ts +11 -3
  460. package/src/workflows/retry-poller.ts +32 -6
  461. package/src/workflows/successor-routing.ts +108 -0
  462. package/src/workflows/task-step-routing.ts +5 -2
  463. package/src/workflows/triggers.ts +21 -36
  464. package/src/workflows/validation.ts +10 -0
  465. package/src/workflows/wait-poller.ts +6 -2
  466. package/src/workflows/webhook-filter.ts +203 -0
  467. package/templates/ai-toolbox.manifest.json +1 -1
  468. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  469. package/templates/skills/agent-browser/SKILL.md +1 -0
  470. package/templates/skills/agent-browser/content.md +1 -0
  471. package/templates/skills/pages/content.md +5 -0
  472. package/templates/skills/swarm-docs/content.md +8 -1
  473. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  474. package/templates/skills/swarm-scripts/content.md +1 -0
  475. package/templates/skills/tdd-planning/content.md +5 -2
  476. package/dist/acp-adapter-bht22g3k.js +0 -16
  477. package/dist/core-sxy4epp2.js +0 -38
  478. package/dist/fx-adapter-adtdb3jb.js +0 -19
  479. package/dist/grok-adapter-accnn9km.js +0 -19
  480. package/dist/handlers-1x77561e.js +0 -35
  481. package/dist/index-48qzcqzj.js +0 -35
  482. package/dist/index-rkvaambe.js +0 -36
  483. package/dist/index-xj1mq27m.js +0 -40
  484. package/dist/lead-enzn86bz.js +0 -74
  485. package/dist/thread-buffer-3x93yexa.js +0 -38
  486. package/dist/worker-zfcv2wbf.js +0 -74
  487. package/src/slack/socket-mode-guard.test.ts +0 -25
  488. package/src/tests/agent-activity.test.ts +0 -247
  489. package/src/tests/agent-fs-live-url.test.ts +0 -55
  490. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  491. package/src/tests/approval-sweeps-config.test.ts +0 -47
  492. package/src/tests/cards.test.ts +0 -169
  493. package/src/tests/chat-sdk-facts.test.ts +0 -23
  494. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  495. package/src/tests/core-auth.test.ts +0 -156
  496. package/src/tests/date-utils.test.ts +0 -48
  497. package/src/tests/db-context-versions.test.ts +0 -37
  498. package/src/tests/db-runtime.test.ts +0 -131
  499. package/src/tests/enabled-capabilities.test.ts +0 -20
  500. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  501. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  502. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  503. package/src/tests/github-event-labels.test.ts +0 -24
  504. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  505. package/src/tests/http-log-scrubbing.test.ts +0 -123
  506. package/src/tests/http-semconv-attributes.test.ts +0 -92
  507. package/src/tests/identity.test.ts +0 -117
  508. package/src/tests/inbox-state.test.ts +0 -167
  509. package/src/tests/internal-ai/models.test.ts +0 -54
  510. package/src/tests/launch-password-rejection.test.ts +0 -140
  511. package/src/tests/list-total-cache.test.ts +0 -88
  512. package/src/tests/match-route.test.ts +0 -187
  513. package/src/tests/memory-feature-flags.test.ts +0 -45
  514. package/src/tests/memory-get-tool.test.ts +0 -269
  515. package/src/tests/memory-health-endpoint.test.ts +0 -78
  516. package/src/tests/memory-http-access.test.ts +0 -221
  517. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  518. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  519. package/src/tests/openai-embedding-provider.test.ts +0 -159
  520. package/src/tests/org-identity.test.ts +0 -44
  521. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  522. package/src/tests/pages-browser-sdk.test.ts +0 -76
  523. package/src/tests/pages-feedback-keys.test.ts +0 -121
  524. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  525. package/src/tests/pages-list-endpoint.test.ts +0 -148
  526. package/src/tests/pages-password-mode.test.ts +0 -266
  527. package/src/tests/pages-public-authed-401.test.ts +0 -103
  528. package/src/tests/pages-public-html.test.ts +0 -297
  529. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  530. package/src/tests/pages-view-count.test.ts +0 -245
  531. package/src/tests/prompt-templates-db.test.ts +0 -616
  532. package/src/tests/rbac-engine.test.ts +0 -742
  533. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  534. package/src/tests/route-def-find-route.test.ts +0 -192
  535. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  536. package/src/tests/schedule-validation-helper.test.ts +0 -51
  537. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  538. package/src/tests/scheduler-backoff.test.ts +0 -166
  539. package/src/tests/script-run-token.test.ts +0 -75
  540. package/src/tests/scripts-extract-signature.test.ts +0 -47
  541. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  542. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  543. package/src/tests/short-id.test.ts +0 -23
  544. package/src/tests/skill-files-http.test.ts +0 -222
  545. package/src/tests/skill-get-file-tool.test.ts +0 -110
  546. package/src/tests/skill-script-refs.test.ts +0 -63
  547. package/src/tests/skill-update-scope.test.ts +0 -252
  548. package/src/tests/skills-bundle.test.ts +0 -99
  549. package/src/tests/slack-app-icon.test.ts +0 -94
  550. package/src/tests/slack-assistant-comention.test.ts +0 -139
  551. package/src/tests/slack-delete.test.ts +0 -157
  552. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  553. package/src/tests/slack-manifest.test.ts +0 -23
  554. package/src/tests/slack-task-output.test.ts +0 -90
  555. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  556. package/src/tests/swarm-diff.test.ts +0 -728
  557. package/src/tests/task-lifecycle-events.test.ts +0 -53
  558. package/src/tests/template-asset-config.test.ts +0 -18
  559. package/src/tests/template-fetch.test.ts +0 -490
  560. package/src/tests/themes-page-theme.test.ts +0 -155
  561. package/src/tests/tool-annotations.test.ts +0 -442
  562. package/src/tests/tool-output-agent-id.test.ts +0 -202
  563. package/src/tests/update-profile-agentid.test.ts +0 -248
  564. package/src/tests/whoami-route.test.ts +0 -162
  565. package/src/tests/workflow-definition-telemetry.test.ts +0 -134
  566. package/src/tests/workflow-patch.test.ts +0 -169
  567. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  568. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  569. package/src/tests/workflow-step-claims.test.ts +0 -152
  570. package/src/tests/workflow-step-order.test.ts +0 -92
  571. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  572. package/src/tests/workflow-versions.test.ts +0 -240
@@ -0,0 +1,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
+ }