@desplega.ai/agent-swarm 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
  3. package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
  19. package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
  20. package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
  21. package/dist/cli-0jkenasr.js +148 -0
  22. package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
  23. package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
  24. package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
  25. package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
  26. package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
  29. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  30. package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
  31. package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
  32. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  33. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  34. package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
  35. package/dist/cli-7dbhnsj9.js +681 -0
  36. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  37. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  38. package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
  39. package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
  40. package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
  41. package/dist/cli-avqkr20b.js +69 -0
  42. package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
  43. package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
  44. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  45. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  46. package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
  47. package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
  48. package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
  49. package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
  50. package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
  51. package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
  52. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  53. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  54. package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
  55. package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
  56. package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
  57. package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
  58. package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
  59. package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
  60. package/dist/cli-hbq0kwxz.js +252 -0
  61. package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
  62. package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
  63. package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
  64. package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
  65. package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
  66. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  67. package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
  68. package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
  69. package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
  70. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  71. package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
  72. package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
  73. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  74. package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
  75. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  76. package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
  77. package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
  78. package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
  79. package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
  80. package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
  81. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  82. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  83. package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
  84. package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
  85. package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
  86. package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
  87. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  88. package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
  89. package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
  90. package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
  91. package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
  92. package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
  93. package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
  94. package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
  95. package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
  96. package/dist/cli-y260hgep.js +186 -0
  97. package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
  98. package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
  99. package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
  100. package/dist/cli-yn4kt85g.js +148 -0
  101. package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
  102. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  103. package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
  104. package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
  105. package/dist/cli.js +27 -22
  106. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
  107. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  108. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  109. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
  110. package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
  111. package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
  112. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
  113. package/dist/core-0fqtbrxa.js +42 -0
  114. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
  115. package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
  116. package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
  117. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  118. package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
  119. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  120. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
  121. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  122. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  123. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
  124. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
  125. package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
  126. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  127. package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
  128. package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
  129. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  130. package/dist/grok-adapter-4q5tssw0.js +20 -0
  131. package/dist/handlers-qxgfvvsf.js +41 -0
  132. package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
  133. package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
  134. package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
  135. package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
  136. package/dist/index-0mcxjdsa.js +44 -0
  137. package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
  138. package/dist/index-dz4q23ag.js +40 -0
  139. package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
  140. package/dist/index-s175jckx.js +39 -0
  141. package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
  142. package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
  143. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  144. package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
  145. package/dist/lead-p3hx7h35.js +79 -0
  146. package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
  147. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
  148. package/dist/object-webhooks-6rdagg0r.js +21 -0
  149. package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
  150. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
  151. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
  152. package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
  153. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
  154. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
  155. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
  156. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
  157. package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
  158. package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
  159. package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
  160. package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
  161. package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
  162. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
  163. package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
  164. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  165. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
  166. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  167. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
  168. package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
  169. package/dist/worker-8rg9gz74.js +79 -0
  170. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
  171. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  172. package/dist/xlsx-9acfmxr1.js +31534 -0
  173. package/openapi.json +5227 -3511
  174. package/package.json +10 -5
  175. package/src/agentmail/handlers.ts +26 -19
  176. package/src/apps/catalog.generated.json +31 -0
  177. package/src/apps/row-store.ts +37 -14
  178. package/src/azure-devops/auth.ts +2 -3
  179. package/src/azure-devops/handlers.ts +2 -0
  180. package/src/be/agent-fs-identity.ts +46 -0
  181. package/src/be/agent-history.ts +215 -0
  182. package/src/be/audit-user.ts +46 -6
  183. package/src/be/db/agents.ts +34 -12
  184. package/src/be/db/kv-windows.ts +22 -0
  185. package/src/be/db/session-moves.ts +3 -3
  186. package/src/be/db/session-tree.ts +52 -5
  187. package/src/be/db/skill-audit.ts +17 -0
  188. package/src/be/db/tasks/write.ts +20 -5
  189. package/src/be/db.ts +116 -23
  190. package/src/be/extensions/assets.ts +11 -7
  191. package/src/be/memory/demotion-evidence.ts +2 -2
  192. package/src/be/memory/providers/sqlite-store.ts +151 -18
  193. package/src/be/memory/search-read-worker.ts +60 -0
  194. package/src/be/memory/search-reader.ts +223 -0
  195. package/src/be/migrations/332_primitive_objects.sql +31 -0
  196. package/src/be/migrations/334_agent_history.sql +23 -0
  197. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  198. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  199. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  200. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  201. package/src/be/model-tier-resolution.ts +18 -1
  202. package/src/be/multi-runtime.ts +17 -0
  203. package/src/be/primitives/boards/elements.ts +717 -0
  204. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  205. package/src/be/primitives/boards/service.ts +121 -0
  206. package/src/be/primitives/object-embed.ts +250 -0
  207. package/src/be/primitives/object-webhooks.ts +348 -0
  208. package/src/be/primitives/objects.ts +706 -0
  209. package/src/be/primitives/sheets/a1.ts +136 -0
  210. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  211. package/src/be/primitives/sheets/engine.ts +199 -0
  212. package/src/be/primitives/sheets/format.ts +106 -0
  213. package/src/be/primitives/sheets/service.ts +547 -0
  214. package/src/be/primitives/sheets/xlsx.ts +367 -0
  215. package/src/be/primitives/write-object.ts +83 -0
  216. package/src/be/rbac-roles.ts +3 -0
  217. package/src/be/repo-checked-update.ts +4 -4
  218. package/src/be/repo-merge-policy.ts +26 -9
  219. package/src/be/script-credential-broker.ts +8 -27
  220. package/src/be/scripts/boot-reembed.ts +6 -0
  221. package/src/be/scripts/db.ts +17 -5
  222. package/src/be/scripts/embeddings.ts +6 -0
  223. package/src/be/scripts/typecheck.ts +257 -0
  224. package/src/be/seed/agent-fs-provision.ts +18 -0
  225. package/src/be/seed/schedules-seeder.ts +9 -1
  226. package/src/be/seed/workflows-seeder.ts +9 -1
  227. package/src/be/seed-scripts/index.ts +2 -0
  228. package/src/be/seed-skills/index.ts +12 -0
  229. package/src/be/swarm-config-guard.ts +1 -0
  230. package/src/be/unmapped-identities.ts +95 -1
  231. package/src/be/users.ts +19 -0
  232. package/src/bitbucket/handlers.ts +2 -0
  233. package/src/commands/onboard/agent-fs-version.ts +1 -1
  234. package/src/commands/onboard/steps/harness.tsx +1 -1
  235. package/src/commands/provider-credentials.ts +1 -0
  236. package/src/e2b/env.ts +3 -1
  237. package/src/event-waits/github.ts +43 -0
  238. package/src/event-waits/index.ts +29 -0
  239. package/src/event-waits/types.ts +51 -0
  240. package/src/extensions/contract-types.generated.ts +1 -1
  241. package/src/extensions/dispatcher.ts +9 -0
  242. package/src/fs/agent-fs-provider.ts +37 -3
  243. package/src/github/handlers.ts +3 -1
  244. package/src/github/pull-request-state.ts +34 -0
  245. package/src/gitlab/auth.ts +3 -4
  246. package/src/gitlab/handlers.ts +12 -7
  247. package/src/heartbeat/heartbeat.ts +11 -11
  248. package/src/hooks/codex-hook.ts +99 -1
  249. package/src/hooks/hook.ts +85 -11
  250. package/src/hooks/native-tool-hooks.ts +245 -0
  251. package/src/http/agent-lifecycle.ts +152 -0
  252. package/src/http/agents.ts +12 -0
  253. package/src/http/all-routes.ts +3 -0
  254. package/src/http/assets.ts +4 -3
  255. package/src/http/auth.ts +2 -1
  256. package/src/http/comb.ts +2 -2
  257. package/src/http/favorite-owner.ts +2 -2
  258. package/src/http/favorites.ts +3 -2
  259. package/src/http/fs.ts +13 -4
  260. package/src/http/index.ts +17 -0
  261. package/src/http/mcp-bridge.ts +4 -0
  262. package/src/http/object-webhooks.ts +101 -0
  263. package/src/http/objects.ts +265 -0
  264. package/src/http/operator-actor.ts +2 -1
  265. package/src/http/pages.ts +3 -3
  266. package/src/http/poll.ts +43 -12
  267. package/src/http/repos.ts +7 -6
  268. package/src/http/schedules.ts +10 -6
  269. package/src/http/script-connections.ts +2 -2
  270. package/src/http/scripts.ts +9 -0
  271. package/src/http/sessions.ts +37 -12
  272. package/src/http/skills.ts +17 -0
  273. package/src/http/task-requester.ts +2 -2
  274. package/src/http/tasks.ts +13 -3
  275. package/src/http/tool-hooks.ts +24 -2
  276. package/src/http/trackers/authorize-gate.ts +2 -2
  277. package/src/http/users.ts +136 -1
  278. package/src/http/workflow-events.ts +13 -0
  279. package/src/http/workflows.ts +47 -5
  280. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  281. package/src/linear/sync.ts +3 -1
  282. package/src/prompts/base-prompt.ts +35 -13
  283. package/src/prompts/session-templates.ts +25 -0
  284. package/src/providers/acp-targets.ts +2 -2
  285. package/src/providers/amp-adapter.ts +1 -1
  286. package/src/providers/dsh-adapter.ts +1 -1
  287. package/src/providers/opencode-adapter.ts +5 -1
  288. package/src/providers/opencode-swarm-plugin.ts +50 -1
  289. package/src/providers/pi-mono-adapter.ts +139 -9
  290. package/src/providers/pi-mono-extension.ts +69 -0
  291. package/src/providers/runtime-dependencies.ts +1 -1
  292. package/src/rbac/legacy-policy.ts +5 -0
  293. package/src/rbac/permissions.ts +16 -1
  294. package/src/scheduler/deferred-task-waits.ts +170 -13
  295. package/src/script-workflows/guest-ctx.ts +32 -0
  296. package/src/script-workflows/workflow-ctx.ts +2 -0
  297. package/src/scripts-runtime/ctx.ts +9 -1
  298. package/src/scripts-runtime/executors/native.ts +106 -21
  299. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  300. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  301. package/src/scripts-runtime/executors/types.ts +5 -0
  302. package/src/scripts-runtime/loader.ts +8 -0
  303. package/src/scripts-runtime/mcp-client.ts +4 -0
  304. package/src/scripts-runtime/sdk-allowlist.ts +101 -0
  305. package/src/scripts-runtime/swarm-config.ts +8 -0
  306. package/src/scripts-runtime/swarm-sdk.ts +55 -3
  307. package/src/scripts-runtime/types/stdlib.d.ts +310 -0
  308. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  309. package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
  310. package/src/server.ts +52 -0
  311. package/src/slack/enrich.ts +81 -21
  312. package/src/slack/handlers.test.ts +55 -2
  313. package/src/slack/handlers.ts +38 -3
  314. package/src/slack/render-v2.ts +19 -0
  315. package/src/slack/session-mirror.ts +208 -0
  316. package/src/slack/thread-participants.ts +0 -5
  317. package/src/slack/watcher.ts +3 -0
  318. package/src/slack/work-objects.test.ts +2 -1
  319. package/src/slack/work-objects.ts +7 -2
  320. package/src/tests/agent-history.test.ts +313 -0
  321. package/src/tests/agentmail-filters.test.ts +4 -3
  322. package/src/tests/audit-agent-person.test.ts +825 -0
  323. package/src/tests/audit-updated-by.test.ts +19 -12
  324. package/src/tests/azure-devops-auth.test.ts +6 -0
  325. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  326. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  327. package/src/tests/claude-hook-output.test.ts +107 -2
  328. package/src/tests/claude-managed-setup.test.ts +1 -1
  329. package/src/tests/codex-adapter.test.ts +6 -6
  330. package/src/tests/codex-gpt6-release.test.ts +4 -4
  331. package/src/tests/credential-check.test.ts +12 -0
  332. package/src/tests/db-task-read-contract.test.ts +3 -0
  333. package/src/tests/db-task-write-contract.test.ts +3 -0
  334. package/src/tests/dsh-adapter.test.ts +1 -1
  335. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  336. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  337. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  338. package/src/tests/e2e-shards.test.ts +137 -0
  339. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  340. package/src/tests/extensions-catalog.test.ts +33 -25
  341. package/src/tests/extensions-heartbeat.test.ts +34 -0
  342. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  343. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  344. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  345. package/src/tests/gitlab-auth.test.ts +10 -0
  346. package/src/tests/heartbeat.test.ts +38 -0
  347. package/src/tests/http-api-integration.test.ts +0 -6
  348. package/src/tests/kv-storage.test.ts +3 -0
  349. package/src/tests/memory-search-reader.test.ts +258 -0
  350. package/src/tests/memory-search-stall.test.ts +197 -20
  351. package/src/tests/model-control.test.ts +4 -4
  352. package/src/tests/model-tier-resolution.test.ts +2 -2
  353. package/src/tests/multi-runtime-registration.test.ts +8 -2
  354. package/src/tests/native-tool-hooks.test.ts +188 -0
  355. package/src/tests/opencode-adapter.test.ts +11 -0
  356. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  357. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  358. package/src/tests/poll-probe-readonly.test.ts +108 -0
  359. package/src/tests/primitives-boards.test.ts +686 -0
  360. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  361. package/src/tests/primitives-objects.test.ts +248 -0
  362. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  363. package/src/tests/prompt-template-session.test.ts +3 -2
  364. package/src/tests/rbac-roles.test.ts +3 -0
  365. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  366. package/src/tests/script-connections.test.ts +4 -0
  367. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  368. package/src/tests/scripts-namespaces.test.ts +211 -0
  369. package/src/tests/secret-scrub-gate.test.ts +1 -0
  370. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  371. package/src/tests/secret-scrubber.test.ts +1 -1
  372. package/src/tests/seed-model-profiles.test.ts +1 -1
  373. package/src/tests/session-tokens.test.ts +27 -0
  374. package/src/tests/sessions-tree.test.ts +10 -2
  375. package/src/tests/sheet-engine.test.ts +58 -0
  376. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  377. package/src/tests/slack-read-boundaries.test.ts +4 -2
  378. package/src/tests/slack-thread-participants.test.ts +66 -4
  379. package/src/tests/task-start-after-commit.test.ts +82 -0
  380. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  381. package/src/tests/ui-logs-parser.test.ts +67 -0
  382. package/src/tests/workflow-retry-v2.test.ts +101 -0
  383. package/src/tests/workflow-tla-races.test.ts +29 -0
  384. package/src/tools/boards.ts +260 -0
  385. package/src/tools/defer-task.ts +154 -12
  386. package/src/tools/objects.ts +196 -0
  387. package/src/tools/repos/update-repo.ts +6 -6
  388. package/src/tools/schedules/create-schedule.ts +1 -0
  389. package/src/tools/schedules/list-schedules.ts +3 -0
  390. package/src/tools/schedules/patch-schedule.ts +12 -3
  391. package/src/tools/schedules/update-schedule.ts +12 -3
  392. package/src/tools/sheets.ts +378 -0
  393. package/src/tools/skills/skill-create.ts +6 -0
  394. package/src/tools/skills/skill-install-remote.ts +6 -0
  395. package/src/tools/skills/skill-sync-remote.ts +9 -0
  396. package/src/tools/skills/skill-update.ts +9 -1
  397. package/src/tools/slack-read.ts +10 -3
  398. package/src/tools/tool-config.ts +25 -0
  399. package/src/tools/utils.ts +15 -0
  400. package/src/tools/workflows/create-workflow.ts +20 -5
  401. package/src/tools/workflows/patch-workflow-node.ts +5 -1
  402. package/src/tools/workflows/patch-workflow.ts +9 -2
  403. package/src/tools/workflows/update-workflow.ts +27 -4
  404. package/src/types.ts +112 -12
  405. package/src/utils/sandboxed-process.ts +47 -2
  406. package/src/utils/secret-scrubber.ts +61 -6
  407. package/src/workflows/engine.ts +35 -21
  408. package/src/workflows/input.ts +36 -1
  409. package/src/workflows/patch-definition.ts +24 -2
  410. package/src/workflows/retry-poller.ts +15 -2
  411. package/src/workflows/triggers.ts +11 -6
  412. package/src/workflows/validation.ts +10 -0
  413. package/src/workflows/version.ts +7 -1
  414. package/templates/ai-toolbox.manifest.json +1 -1
  415. package/templates/skills/agent-browser/SKILL.md +1 -0
  416. package/templates/skills/agent-browser/content.md +1 -0
  417. package/templates/skills/boards-and-sheets/config.json +14 -0
  418. package/templates/skills/boards-and-sheets/content.md +163 -0
  419. package/templates/skills/pages/content.md +5 -0
  420. package/templates/skills/swarm-docs/content.md +15 -1
  421. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  422. package/templates/skills/swarm-scripts/content.md +1 -0
  423. package/templates/skills/tdd-planning/content.md +5 -2
  424. package/dist/acp-adapter-weaaxey3.js +0 -16
  425. package/dist/core-df1n049h.js +0 -39
  426. package/dist/fx-adapter-zwmps9re.js +0 -19
  427. package/dist/grok-adapter-q0avf919.js +0 -19
  428. package/dist/handlers-g5jq0e4q.js +0 -36
  429. package/dist/index-1f6m47mq.js +0 -37
  430. package/dist/index-1p1mpqda.js +0 -36
  431. package/dist/index-tnkd410q.js +0 -41
  432. package/dist/lead-m5e7xt93.js +0 -75
  433. package/dist/thread-buffer-nf55vwx3.js +0 -39
  434. package/dist/worker-ews1nyhw.js +0 -75
  435. package/src/slack/socket-mode-guard.test.ts +0 -25
  436. package/src/tests/agent-activity.test.ts +0 -247
  437. package/src/tests/agent-fs-live-url.test.ts +0 -55
  438. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  439. package/src/tests/approval-sweeps-config.test.ts +0 -47
  440. package/src/tests/cards.test.ts +0 -169
  441. package/src/tests/chat-sdk-facts.test.ts +0 -23
  442. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  443. package/src/tests/core-auth.test.ts +0 -156
  444. package/src/tests/date-utils.test.ts +0 -48
  445. package/src/tests/db-context-versions.test.ts +0 -37
  446. package/src/tests/db-runtime.test.ts +0 -132
  447. package/src/tests/enabled-capabilities.test.ts +0 -20
  448. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  449. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  450. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  451. package/src/tests/github-event-labels.test.ts +0 -24
  452. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  453. package/src/tests/http-log-scrubbing.test.ts +0 -123
  454. package/src/tests/http-semconv-attributes.test.ts +0 -92
  455. package/src/tests/identity.test.ts +0 -117
  456. package/src/tests/inbox-state.test.ts +0 -167
  457. package/src/tests/internal-ai/models.test.ts +0 -54
  458. package/src/tests/launch-password-rejection.test.ts +0 -140
  459. package/src/tests/list-total-cache.test.ts +0 -88
  460. package/src/tests/match-route.test.ts +0 -187
  461. package/src/tests/memory-feature-flags.test.ts +0 -45
  462. package/src/tests/memory-get-tool.test.ts +0 -269
  463. package/src/tests/memory-health-endpoint.test.ts +0 -78
  464. package/src/tests/memory-http-access.test.ts +0 -221
  465. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  466. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  467. package/src/tests/openai-embedding-provider.test.ts +0 -159
  468. package/src/tests/org-identity.test.ts +0 -44
  469. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  470. package/src/tests/pages-browser-sdk.test.ts +0 -76
  471. package/src/tests/pages-feedback-keys.test.ts +0 -121
  472. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  473. package/src/tests/pages-list-endpoint.test.ts +0 -148
  474. package/src/tests/pages-password-mode.test.ts +0 -266
  475. package/src/tests/pages-public-authed-401.test.ts +0 -103
  476. package/src/tests/pages-public-html.test.ts +0 -297
  477. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  478. package/src/tests/pages-view-count.test.ts +0 -245
  479. package/src/tests/prompt-templates-db.test.ts +0 -616
  480. package/src/tests/rbac-engine.test.ts +0 -742
  481. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  482. package/src/tests/route-def-find-route.test.ts +0 -192
  483. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  484. package/src/tests/schedule-validation-helper.test.ts +0 -51
  485. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  486. package/src/tests/scheduler-backoff.test.ts +0 -166
  487. package/src/tests/script-run-token.test.ts +0 -75
  488. package/src/tests/scripts-extract-signature.test.ts +0 -47
  489. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  490. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  491. package/src/tests/short-id.test.ts +0 -23
  492. package/src/tests/skill-files-http.test.ts +0 -222
  493. package/src/tests/skill-get-file-tool.test.ts +0 -110
  494. package/src/tests/skill-script-refs.test.ts +0 -63
  495. package/src/tests/skill-update-scope.test.ts +0 -252
  496. package/src/tests/skills-bundle.test.ts +0 -99
  497. package/src/tests/slack-app-icon.test.ts +0 -94
  498. package/src/tests/slack-assistant-comention.test.ts +0 -139
  499. package/src/tests/slack-delete.test.ts +0 -157
  500. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  501. package/src/tests/slack-manifest.test.ts +0 -23
  502. package/src/tests/slack-task-output.test.ts +0 -90
  503. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  504. package/src/tests/swarm-diff.test.ts +0 -728
  505. package/src/tests/task-lifecycle-events.test.ts +0 -53
  506. package/src/tests/template-asset-config.test.ts +0 -18
  507. package/src/tests/template-fetch.test.ts +0 -490
  508. package/src/tests/themes-page-theme.test.ts +0 -155
  509. package/src/tests/tool-annotations.test.ts +0 -442
  510. package/src/tests/tool-output-agent-id.test.ts +0 -202
  511. package/src/tests/update-profile-agentid.test.ts +0 -248
  512. package/src/tests/whoami-route.test.ts +0 -162
  513. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  514. package/src/tests/workflow-patch.test.ts +0 -169
  515. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  516. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  517. package/src/tests/workflow-step-claims.test.ts +0 -152
  518. package/src/tests/workflow-step-order.test.ts +0 -92
  519. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  520. package/src/tests/workflow-versions.test.ts +0 -240
  521. package/src/tests/workflow-wait.test.ts +0 -26
@@ -0,0 +1,547 @@
1
+ import { FilesError } from "@/fs/provider";
2
+ import { buildAgentFsLiveUrl } from "@/utils/constants";
3
+ import { agentFsClientFor } from "../../agent-fs-identity";
4
+ import { getDbClient } from "../../db";
5
+ import {
6
+ clientFor,
7
+ createObject,
8
+ getObject,
9
+ listObjects,
10
+ NO_AGENT_FS_IDENTITY,
11
+ normalizePath,
12
+ ObjectsError,
13
+ type PrimitiveObject,
14
+ } from "../objects";
15
+ import {
16
+ A1Error,
17
+ areaOf,
18
+ assertInBounds,
19
+ capToUsed,
20
+ formatRange,
21
+ parseCell,
22
+ parseRange,
23
+ refOf,
24
+ } from "./a1";
25
+ import { sheetEngine } from "./engine";
26
+ import type { EnginePatch } from "./engine-worker";
27
+ import {
28
+ checkTabName,
29
+ constantInput,
30
+ emptySheet,
31
+ MAX_CELLS,
32
+ MAX_FILE_BYTES,
33
+ MAX_RANGE_CELLS,
34
+ MAX_TABS,
35
+ newTab,
36
+ type SheetDoc,
37
+ SheetDocSchema,
38
+ type SheetTab,
39
+ usedExtent,
40
+ } from "./format";
41
+ import { buildXlsx, MAX_XLSX_BYTES, parseXlsx, XLSX_MIME } from "./xlsx";
42
+
43
+ /** One sheet call: the caller and the file, by `id` or `path`. */
44
+ export type SheetTarget = { agentId: string | undefined; id?: string; path?: string };
45
+
46
+ export type CellInput = number | string | boolean | null;
47
+
48
+ /** First try plus three retries on an agent-fs 409, then refuse. */
49
+ const MAX_ATTEMPTS = 4;
50
+
51
+ /** Wrap `A1Error` as a refusal the tool layer returns as `toolErr`. */
52
+ const refuse = <T>(run: () => T): T => {
53
+ try {
54
+ return run();
55
+ } catch (error) {
56
+ if (error instanceof A1Error) throw new ObjectsError(error.message);
57
+ throw error;
58
+ }
59
+ };
60
+
61
+ /** A workbook file before `SheetDocSchema` parses it; only its `swarm` block is read. */
62
+ type UnparsedWorkbook = { swarm?: unknown };
63
+
64
+ /** The workbook's `swarm.id`, or undefined when a save dropped it. */
65
+ function embeddedId(content: UnparsedWorkbook): string | undefined {
66
+ const { swarm } = content;
67
+ const id = swarm && typeof swarm === "object" ? (swarm as { id?: unknown }).id : undefined;
68
+ return typeof id === "string" && id.length > 0 ? id : undefined;
69
+ }
70
+
71
+ async function load(target: SheetTarget) {
72
+ const { object, missing, content } = await getObject({ ...target, includeContent: true });
73
+ if (object.kind !== "sheet") {
74
+ throw new ObjectsError(`object ${object.id} is a ${object.kind}, not a sheet`);
75
+ }
76
+ if (missing) {
77
+ throw new ObjectsError(
78
+ `the file for ${object.path} is missing on the drive; run object-reindex`,
79
+ );
80
+ }
81
+ const parsed = SheetDocSchema.safeParse(content);
82
+ if (!parsed.success) {
83
+ const { issues } = parsed.error;
84
+ // Only the swarm block is wrong and it carries no id: a save outside the sheet tools
85
+ // (a hand edit, another app) dropped it, and reindex writes it back. Any other shape
86
+ // error keeps the generic refusal, since reindex would not fix it.
87
+ if (issues.every((i) => i.path[0] === "swarm") && !embeddedId(content as UnparsedWorkbook)) {
88
+ throw new ObjectsError(
89
+ `${object.path} has no embedded swarm.id, so a save outside the sheet tools dropped it; run object-reindex (ctx.objects.reindex) with prefix '${object.path}' to write the id back, then retry`,
90
+ );
91
+ }
92
+ const issue = issues[0];
93
+ throw new ObjectsError(
94
+ `${object.path} is not a valid swarm-sheet/1 workbook: ${issue?.path.join(".") || "document"}: ${issue?.message}`,
95
+ );
96
+ }
97
+ if (object.fileVersion === null) {
98
+ throw new ObjectsError(`agent-fs returned no version for ${object.path}; cannot write safely`);
99
+ }
100
+ return { object, version: object.fileVersion, doc: parsed.data };
101
+ }
102
+
103
+ /** The exact bytes a sheet file holds, size-checked. Save and the import preflight both use it, so they cannot disagree. */
104
+ function sheetBody(doc: SheetDoc): string {
105
+ const body = JSON.stringify(doc, null, 2);
106
+ if (Buffer.byteLength(body) > MAX_FILE_BYTES) {
107
+ throw new ObjectsError(`the sheet would exceed ${MAX_FILE_BYTES} bytes (5 MiB)`);
108
+ }
109
+ return body;
110
+ }
111
+
112
+ async function save(
113
+ agentId: string | undefined,
114
+ object: PrimitiveObject,
115
+ doc: SheetDoc,
116
+ version: number,
117
+ op: string,
118
+ ) {
119
+ const body = sheetBody(doc);
120
+ const client = agentId ? await agentFsClientFor(agentId) : undefined;
121
+ if (!client) throw new ObjectsError(NO_AGENT_FS_IDENTITY);
122
+ const { orgId, driveId } = client.identity;
123
+ const saved = await client.provider.upload(
124
+ { taskId: "", name: "", key: object.path, orgId, driveId },
125
+ body,
126
+ { contentType: "application/json", ifMatch: String(version), message: `sheet ${op}` },
127
+ );
128
+ // shortcut: agent-fs always returns the new version; if it ever stops, guess version + 1 until the next read corrects it.
129
+ const next = saved.version ? Number(saved.version) : version + 1;
130
+ // The row is a cache of the file (see objects.ts): keep its version close to the file's.
131
+ await getDbClient().run(
132
+ "UPDATE primitive_objects SET fileVersion = ?, updatedAt = ? WHERE id = ?",
133
+ [next, new Date().toISOString(), object.id],
134
+ );
135
+ return next;
136
+ }
137
+
138
+ /**
139
+ * Read, apply, write with `If-Match`. On a 409 read again and re-apply, so edits
140
+ * to different cells merge and the same cell is last writer wins. `apply`
141
+ * returns the new document, or none when nothing changed (no write, no new version).
142
+ */
143
+ async function mutate<T>(
144
+ target: SheetTarget,
145
+ op: string,
146
+ apply: (doc: SheetDoc) => Promise<{ doc?: SheetDoc; result: T }>,
147
+ ): Promise<{ version: number; result: T }> {
148
+ for (let attempt = 1; ; attempt++) {
149
+ const { object, version, doc } = await load(target);
150
+ const { doc: next, result } = await apply(structuredClone(doc));
151
+ if (!next) return { version, result };
152
+ try {
153
+ return { version: await save(target.agentId, object, next, version, op), result };
154
+ } catch (error) {
155
+ if (!(error instanceof FilesError && error.code === "Conflict")) throw error;
156
+ if (attempt >= MAX_ATTEMPTS) {
157
+ throw new ObjectsError(
158
+ `concurrent writers changed ${object.path} ${MAX_ATTEMPTS} times; retry`,
159
+ );
160
+ }
161
+ }
162
+ }
163
+ }
164
+
165
+ function findTab(doc: SheetDoc, name: string | undefined): SheetTab {
166
+ if (name === undefined) return doc.tabs[0] as SheetTab;
167
+ const tab =
168
+ doc.tabs.find((t) => t.name === name) ??
169
+ doc.tabs.find((t) => t.name.toLowerCase() === name.toLowerCase());
170
+ if (!tab) {
171
+ throw new ObjectsError(`no tab '${name}' (tabs: ${doc.tabs.map((t) => t.name).join(", ")})`);
172
+ }
173
+ return tab;
174
+ }
175
+
176
+ /** What a person would type for a value: `=...` is a formula, `'=` escapes a literal, null clears. */
177
+ function inputFor(value: CellInput): string {
178
+ if (typeof value !== "string") return constantInput(value);
179
+ if (value.length > 1 && value.startsWith("=")) return value;
180
+ if (value.startsWith("'=")) return value;
181
+ return constantInput(value);
182
+ }
183
+
184
+ /** Recalculate `doc` with `patches` and report which cells moved. */
185
+ async function recalc(
186
+ agentId: string | undefined,
187
+ doc: Pick<SheetDoc, "tabs">,
188
+ patches: EnginePatch[],
189
+ ) {
190
+ const { cells, changed } = await sheetEngine().recalc(doc.tabs, patches, {
191
+ maxCells: MAX_CELLS,
192
+ caller: agentId,
193
+ });
194
+ doc.tabs.forEach((tab, i) => {
195
+ tab.cells = cells[i] ?? {};
196
+ });
197
+ return changed;
198
+ }
199
+
200
+ function checkArea(range: { r1: number; c1: number; r2: number; c2: number }, what: string) {
201
+ const area = areaOf(range);
202
+ if (area > MAX_RANGE_CELLS) {
203
+ throw new ObjectsError(
204
+ `${what} covers ${area} cells; the limit is ${MAX_RANGE_CELLS} per call`,
205
+ );
206
+ }
207
+ }
208
+
209
+ const tabSummary = (tab: SheetTab) => {
210
+ const { rows, cols } = usedExtent(tab);
211
+ return { name: tab.name, rows, cols, freezeRows: tab.freezeRows ?? 0 };
212
+ };
213
+
214
+ export async function createSheet(input: {
215
+ agentId: string | undefined;
216
+ path: string;
217
+ title?: string;
218
+ tabs?: Array<{ name: string; rows?: CellInput[][] }>;
219
+ }) {
220
+ const { tabs } = input;
221
+ if (tabs) {
222
+ // Refuse before the file exists, so a bad request leaves nothing behind.
223
+ refuse(() => {
224
+ if (tabs.length === 0 || tabs.length > MAX_TABS)
225
+ throw new A1Error(`tabs: 1-${MAX_TABS} tabs`);
226
+ const seen = new Set<string>();
227
+ for (const tab of tabs) {
228
+ if (seen.has(checkTabName(tab.name).toLowerCase()))
229
+ throw new A1Error(`duplicate tab '${tab.name}'`);
230
+ seen.add(tab.name.toLowerCase());
231
+ const cells = (tab.rows ?? []).reduce((n, row) => n + row.length, 0);
232
+ if (cells > MAX_RANGE_CELLS)
233
+ throw new A1Error(
234
+ `tab '${tab.name}' has ${cells} initial cells; the limit is ${MAX_RANGE_CELLS}`,
235
+ );
236
+ }
237
+ });
238
+ }
239
+ const created = await createObject({
240
+ agentId: input.agentId,
241
+ kind: "sheet",
242
+ path: input.path,
243
+ title: input.title,
244
+ });
245
+ if (!tabs) return { object: created, link: created.link };
246
+ try {
247
+ const { version } = await mutate(
248
+ { agentId: input.agentId, id: created.id },
249
+ "create tabs",
250
+ async (doc) => {
251
+ doc.tabs = tabs.map((t) => newTab(t.name));
252
+ const patches = tabs.flatMap((t) =>
253
+ (t.rows ?? []).flatMap((row, r) =>
254
+ row.map((value, c) => ({
255
+ tab: t.name,
256
+ row: r + 1,
257
+ col: c + 1,
258
+ input: inputFor(value),
259
+ })),
260
+ ),
261
+ );
262
+ await recalc(input.agentId, doc, patches);
263
+ return { doc, result: null };
264
+ },
265
+ );
266
+ return { object: { ...created, fileVersion: version }, link: created.link };
267
+ } catch (error) {
268
+ if (error instanceof ObjectsError) {
269
+ throw new ObjectsError(
270
+ `created ${created.path} (id ${created.id}) but could not write its tabs: ${error.message}`,
271
+ );
272
+ }
273
+ throw error;
274
+ }
275
+ }
276
+
277
+ export async function getSheet(target: SheetTarget) {
278
+ const { object, version, doc } = await load(target);
279
+ return { object, version, tabs: doc.tabs.map(tabSummary) };
280
+ }
281
+
282
+ export const listSheets = (input: {
283
+ agentId: string | undefined;
284
+ prefix?: string;
285
+ limit?: number;
286
+ offset?: number;
287
+ }) => listObjects({ ...input, kind: "sheet" });
288
+
289
+ export async function getSheetRange(target: SheetTarget & { range: string; formulas?: boolean }) {
290
+ const { version, doc } = await load(target);
291
+ const spec = refuse(() => parseRange(target.range));
292
+ const tab = findTab(doc, spec.tab);
293
+ const range = capToUsed(spec, usedExtent(tab));
294
+ if (!range)
295
+ return {
296
+ range: formatRange(tab.name, { ...spec, r2: spec.r1, c2: spec.c1 }),
297
+ values: [],
298
+ version,
299
+ };
300
+ checkArea(range, "the range");
301
+ const values: CellInput[][] = [];
302
+ const formulas: CellInput[][] = [];
303
+ for (let r = range.r1; r <= range.r2; r++) {
304
+ const row: CellInput[] = [];
305
+ const formulaRow: CellInput[] = [];
306
+ for (let c = range.c1; c <= range.c2; c++) {
307
+ const cell = tab.cells[refOf(r, c)];
308
+ const value = cell?.v ?? null;
309
+ row.push(value);
310
+ formulaRow.push(cell?.f ?? value);
311
+ }
312
+ values.push(row);
313
+ formulas.push(formulaRow);
314
+ }
315
+ return {
316
+ range: formatRange(tab.name, range),
317
+ values,
318
+ ...(target.formulas ? { formulas } : {}),
319
+ version,
320
+ };
321
+ }
322
+
323
+ export async function setSheetRange(
324
+ target: SheetTarget & { range: string; values: CellInput[][] },
325
+ ) {
326
+ const spec = refuse(() => parseRange(target.range));
327
+ if (spec.open)
328
+ throw new ObjectsError(
329
+ "setRange needs a bounded range such as 'Tab!B2:C3', not a whole column or row",
330
+ );
331
+ const rows = target.values.length;
332
+ const cols = Math.max(0, ...target.values.map((row) => row.length));
333
+ if (rows === 0 || cols === 0) throw new ObjectsError("values is empty");
334
+ if (target.values.some((row) => row.length !== cols))
335
+ throw new ObjectsError("values must be a rectangle: every row needs the same length");
336
+ const single = spec.r1 === spec.r2 && spec.c1 === spec.c2;
337
+ // A single cell names the top-left corner; a bigger range must match the values exactly.
338
+ const range = single ? { ...spec, r2: spec.r1 + rows - 1, c2: spec.c1 + cols - 1 } : spec;
339
+ const height = range.r2 - range.r1 + 1;
340
+ const width = range.c2 - range.c1 + 1;
341
+ // Compare both sides: equal area with another shape (1x4 into 2x2) would write outside the named range.
342
+ if (height !== rows || width !== cols) {
343
+ throw new ObjectsError(`values is ${rows}x${cols} but the range is ${height}x${width}`);
344
+ }
345
+ refuse(() => assertInBounds(range));
346
+ checkArea(range, "the range");
347
+ const { version, result } = await mutate(target, "set range", async (doc) => {
348
+ const tab = findTab(doc, spec.tab);
349
+ const patches = target.values.flatMap((row, i) =>
350
+ row.map((value, j) => ({
351
+ tab: tab.name,
352
+ row: range.r1 + i,
353
+ col: range.c1 + j,
354
+ input: inputFor(value),
355
+ })),
356
+ );
357
+ const changed = await recalc(target.agentId, doc, patches);
358
+ const inRange = (ref: string) => {
359
+ const [name, a1] = [ref.slice(0, ref.lastIndexOf("!")), ref.slice(ref.lastIndexOf("!") + 1)];
360
+ const { row, col } = parseCell(a1);
361
+ return (
362
+ name === tab.name &&
363
+ row >= range.r1 &&
364
+ row <= range.r2 &&
365
+ col >= range.c1 &&
366
+ col <= range.c2
367
+ );
368
+ };
369
+ const direct = changed.filter(inRange).length;
370
+ return {
371
+ doc: changed.length ? doc : undefined,
372
+ result: {
373
+ range: formatRange(tab.name, range),
374
+ changed: direct,
375
+ recalculated: changed.length - direct,
376
+ },
377
+ };
378
+ });
379
+ return { ...result, version };
380
+ }
381
+
382
+ export async function appendSheetRows(target: SheetTarget & { tab: string; rows: CellInput[][] }) {
383
+ const cells = target.rows.reduce((n, row) => n + row.length, 0);
384
+ if (cells === 0) throw new ObjectsError("rows is empty");
385
+ if (cells > MAX_RANGE_CELLS)
386
+ throw new ObjectsError(`rows hold ${cells} cells; the limit is ${MAX_RANGE_CELLS} per call`);
387
+ const { version, result } = await mutate(target, "append rows", async (doc) => {
388
+ const tab = findTab(doc, target.tab);
389
+ const first = usedExtent(tab).rows + 1;
390
+ const cols = Math.max(...target.rows.map((row) => row.length));
391
+ const range = { r1: first, c1: 1, r2: first + target.rows.length - 1, c2: cols };
392
+ refuse(() => assertInBounds(range));
393
+ const patches = target.rows.flatMap((row, i) =>
394
+ row.flatMap((value, j) =>
395
+ value === null
396
+ ? []
397
+ : [{ tab: tab.name, row: first + i, col: j + 1, input: inputFor(value) }],
398
+ ),
399
+ );
400
+ const changed = await recalc(target.agentId, doc, patches);
401
+ return {
402
+ doc: changed.length ? doc : undefined,
403
+ result: { range: formatRange(tab.name, range) },
404
+ };
405
+ });
406
+ return { ...result, version };
407
+ }
408
+
409
+ export async function clearSheetRange(target: SheetTarget & { range: string }) {
410
+ const spec = refuse(() => parseRange(target.range));
411
+ const { version, result } = await mutate(target, "clear range", async (doc) => {
412
+ const tab = findTab(doc, spec.tab);
413
+ const range = capToUsed(spec, usedExtent(tab));
414
+ if (!range)
415
+ return {
416
+ result: { range: formatRange(tab.name, { ...spec, r2: spec.r1, c2: spec.c1 }), cleared: 0 },
417
+ };
418
+ checkArea(range, "the range");
419
+ // A spill cell (`s`) is the anchor's output: clearing the anchor removes it.
420
+ const patches = Object.entries(tab.cells).flatMap(([ref, cell]) => {
421
+ const { row, col } = parseCell(ref);
422
+ const inside = row >= range.r1 && row <= range.r2 && col >= range.c1 && col <= range.c2;
423
+ return inside && !cell.s ? [{ tab: tab.name, row, col, input: "" }] : [];
424
+ });
425
+ if (patches.length === 0)
426
+ return { result: { range: formatRange(tab.name, range), cleared: 0 } };
427
+ await recalc(target.agentId, doc, patches);
428
+ return { doc, result: { range: formatRange(tab.name, range), cleared: patches.length } };
429
+ });
430
+ return { ...result, version };
431
+ }
432
+
433
+ export async function addSheetTab(target: SheetTarget & { name: string; after?: string }) {
434
+ const { version, result } = await mutate(target, "add tab", async (doc) => {
435
+ refuse(() => checkTabName(target.name));
436
+ if (doc.tabs.some((t) => t.name.toLowerCase() === target.name.toLowerCase())) {
437
+ throw new ObjectsError(`a tab named '${target.name}' already exists`);
438
+ }
439
+ if (doc.tabs.length >= MAX_TABS)
440
+ throw new ObjectsError(`a sheet holds at most ${MAX_TABS} tabs`);
441
+ const at =
442
+ target.after === undefined
443
+ ? doc.tabs.length
444
+ : doc.tabs.indexOf(findTab(doc, target.after)) + 1;
445
+ doc.tabs.splice(at, 0, newTab(target.name));
446
+ return { doc, result: { tabs: doc.tabs.map((t) => t.name) } };
447
+ });
448
+ return { ...result, version };
449
+ }
450
+
451
+ /** Read an `.xlsx` off the drive. Refuses a missing file or one over the size limit before parsing. */
452
+ async function readXlsx(agentId: string | undefined, sourcePath: string): Promise<Uint8Array> {
453
+ if (!/\.xlsx$/i.test(sourcePath)) throw new ObjectsError("sourcePath must end in .xlsx");
454
+ const { provider, scope } = await clientFor(agentId);
455
+ const source = normalizePath(sourcePath);
456
+ let response: Response;
457
+ try {
458
+ response = await provider.download(scope(source));
459
+ } catch (error) {
460
+ if (error instanceof FilesError && error.code === "NotFound") {
461
+ throw new ObjectsError(`no file at '${source}' on this drive`);
462
+ }
463
+ throw error;
464
+ }
465
+ const tooBig = () =>
466
+ new ObjectsError(`${source} is over the ${MAX_XLSX_BYTES} byte limit (5 MiB) for an xlsx`);
467
+ if (Number(response.headers.get("content-length")) > MAX_XLSX_BYTES) {
468
+ await response.body?.cancel();
469
+ throw tooBig();
470
+ }
471
+ // shortcut: a body with no content-length is read whole before the check; agent-fs caps files at 50 MiB.
472
+ const bytes = new Uint8Array(await response.arrayBuffer());
473
+ if (bytes.length > MAX_XLSX_BYTES) throw tooBig();
474
+ return bytes;
475
+ }
476
+
477
+ /**
478
+ * Import an `.xlsx` from the drive as a new sheet. Parse and recalculate first, so a bad
479
+ * file or an over-limit workbook leaves nothing behind. `dropped` names what the file had
480
+ * that a sheet cannot hold.
481
+ */
482
+ export async function importSheetXlsx(input: {
483
+ agentId: string | undefined;
484
+ sourcePath: string;
485
+ path: string;
486
+ title?: string;
487
+ }) {
488
+ if (!input.path.endsWith(".sheet.json")) {
489
+ throw new ObjectsError("a sheet path must end with '.sheet.json'");
490
+ }
491
+ const bytes = await readXlsx(input.agentId, input.sourcePath);
492
+ const { tabs, dropped } = await parseXlsx(bytes);
493
+ const draft = { tabs };
494
+ await recalc(input.agentId, draft, []);
495
+ // Size the file createObject writes and save rewrites with these tabs, not a compact stand-in.
496
+ sheetBody({ ...emptySheet(crypto.randomUUID(), input.title), tabs: draft.tabs });
497
+ const created = await createObject({
498
+ agentId: input.agentId,
499
+ kind: "sheet",
500
+ path: input.path,
501
+ title: input.title,
502
+ });
503
+ try {
504
+ const { version } = await mutate(
505
+ { agentId: input.agentId, id: created.id },
506
+ "import xlsx",
507
+ async (doc) => {
508
+ doc.tabs = draft.tabs;
509
+ return { doc, result: null };
510
+ },
511
+ );
512
+ return { object: { ...created, fileVersion: version }, link: created.link, dropped };
513
+ } catch (error) {
514
+ if (error instanceof ObjectsError) {
515
+ throw new ObjectsError(
516
+ `created ${created.path} (id ${created.id}) but could not write the imported tabs: ${error.message}`,
517
+ );
518
+ }
519
+ throw error;
520
+ }
521
+ }
522
+
523
+ /** Export a sheet to an `.xlsx` on the drive. Create-only unless `overwrite`. */
524
+ export async function exportSheetXlsx(
525
+ target: SheetTarget & { targetPath: string; overwrite?: boolean },
526
+ ) {
527
+ if (!/\.xlsx$/i.test(target.targetPath)) throw new ObjectsError("targetPath must end in .xlsx");
528
+ const { object, doc } = await load(target);
529
+ const { bytes, dropped } = await buildXlsx(doc.tabs);
530
+ const { provider, orgId, driveId, scope } = await clientFor(target.agentId);
531
+ const path = normalizePath(target.targetPath);
532
+ try {
533
+ await provider.upload(scope(path), bytes, {
534
+ contentType: XLSX_MIME,
535
+ ifNoneMatch: target.overwrite ? undefined : "*",
536
+ message: `export ${object.path}`,
537
+ });
538
+ } catch (error) {
539
+ if (error instanceof FilesError && error.code === "Conflict") {
540
+ throw new ObjectsError(
541
+ `a file already exists at '${path}'; pass overwrite: true to replace it`,
542
+ );
543
+ }
544
+ throw error;
545
+ }
546
+ return { path, link: buildAgentFsLiveUrl({ orgId, driveId, path }), dropped };
547
+ }