@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,367 @@
1
+ import { inflateRawSync } from "node:zlib";
2
+ import type { CellObject, WorkSheet } from "xlsx";
3
+ import { ObjectsError } from "../objects";
4
+ import { colName, parseCell, refOf } from "./a1";
5
+ import { MAX_CELLS, MAX_FILE_BYTES, MAX_TABS, type SheetCell, type SheetTab } from "./format";
6
+
7
+ /**
8
+ * xlsx <-> `swarm-sheet/1` on SheetJS CE. Import and export only: the sheet file
9
+ * stays the source of truth. Kept: tab names and order, values, formulas, number
10
+ * formats, column widths, merged ranges. Everything else is reported in `dropped`.
11
+ */
12
+
13
+ export const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
14
+
15
+ /** Compressed upload limit: the same 5 MiB a `.sheet.json` may hold. The service checks it before it reads the body. */
16
+ export const MAX_XLSX_BYTES = MAX_FILE_BYTES;
17
+ /** Sum of every part once inflated. A real 50,000-cell workbook is a few MiB; this stops a zip bomb. */
18
+ export const MAX_INFLATED_BYTES = 16 * 1024 * 1024;
19
+
20
+ const notXlsx = (why: string) => new ObjectsError(`not an xlsx workbook: ${why}`);
21
+
22
+ const refuse = (why: string) => notXlsx(`${why}; refusing it`);
23
+
24
+ /** True when a zip extra-field block holds a ZIP64 record, which SheetJS trusts for sizes. */
25
+ function hasZip64Extra(view: DataView, from: number, length: number): boolean {
26
+ for (let at = from; at + 4 <= from + length; ) {
27
+ if (view.getUint16(at, true) === 0x0001) return true;
28
+ at += 4 + view.getUint16(at + 2, true);
29
+ }
30
+ return false;
31
+ }
32
+
33
+ /**
34
+ * Names of the zip parts, after proving that the archive reads the same to us and to SheetJS
35
+ * and that every part inflates to exactly its declared size under the cap. SheetJS trusts the
36
+ * local headers (name, method, sizes, ZIP64 extras) and the per-disk entry count, and it inflates
37
+ * whatever stream sits at each local header. So an archive where those disagree with the central
38
+ * directory is refused outright, and the rest is measured the way SheetJS walks it.
39
+ */
40
+ function checkedZipParts(bytes: Uint8Array): Set<string> {
41
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
42
+ const names = new Set<string>();
43
+ try {
44
+ // The same last-signature scan SheetJS runs, so both pick one end record.
45
+ let eocd = bytes.length - 4;
46
+ while (eocd >= 0 && view.getUint32(eocd, true) !== 0x06054b50) eocd--;
47
+ if (eocd < 0) throw notXlsx("not a zip archive (no end-of-directory record)");
48
+ const count = view.getUint16(eocd + 8, true); // SheetJS reads this one
49
+ const dirSize = view.getUint32(eocd + 12, true);
50
+ const dirStart = view.getUint32(eocd + 16, true);
51
+ if (
52
+ view.getUint16(eocd + 4, true) !== 0 ||
53
+ view.getUint16(eocd + 6, true) !== 0 ||
54
+ count !== view.getUint16(eocd + 10, true) ||
55
+ count === 0xffff ||
56
+ dirSize === 0xffffffff ||
57
+ dirStart === 0xffffffff
58
+ ) {
59
+ throw refuse("the zip end record has split-disk, inconsistent or ZIP64 counts");
60
+ }
61
+ if (dirStart + dirSize !== eocd)
62
+ throw refuse("the zip directory does not end at the end record");
63
+ let at = dirStart;
64
+ let inflated = 0;
65
+ for (let n = 0; n < count; n++) {
66
+ if (view.getUint32(at, true) !== 0x02014b50) throw notXlsx("broken zip directory");
67
+ const method = view.getUint16(at + 10, true);
68
+ const size = view.getUint32(at + 20, true);
69
+ const fullSize = view.getUint32(at + 24, true);
70
+ const nameLen = view.getUint16(at + 28, true);
71
+ const extraLen = view.getUint16(at + 30, true);
72
+ const next = at + 46 + nameLen + extraLen + view.getUint16(at + 32, true);
73
+ const local = view.getUint32(at + 42, true);
74
+ const name = bytes.subarray(at + 46, at + 46 + nameLen);
75
+ names.add(new TextDecoder().decode(name));
76
+ inflated += fullSize;
77
+ if (inflated > MAX_INFLATED_BYTES) {
78
+ throw new ObjectsError(
79
+ `the workbook inflates to more than ${MAX_INFLATED_BYTES} bytes (16 MiB); refusing it`,
80
+ );
81
+ }
82
+ if (
83
+ size === 0xffffffff ||
84
+ fullSize === 0xffffffff ||
85
+ hasZip64Extra(view, at + 46 + nameLen, extraLen)
86
+ ) {
87
+ throw refuse("a zip part uses ZIP64 sizes");
88
+ }
89
+ if (view.getUint32(local, true) !== 0x04034b50) throw notXlsx("broken zip local header");
90
+ const localNameLen = view.getUint16(local + 26, true);
91
+ const localExtraLen = view.getUint16(local + 28, true);
92
+ // SheetJS takes the part's name and method from the local header and sizes the buffer from its sizes.
93
+ const sameSize = (value: number, declared: number) => value === declared || value === 0;
94
+ if (
95
+ view.getUint16(local + 8, true) !== method ||
96
+ !sameSize(view.getUint32(local + 18, true), size) ||
97
+ !sameSize(view.getUint32(local + 22, true), fullSize) ||
98
+ localNameLen !== nameLen ||
99
+ Buffer.compare(bytes.subarray(local + 30, local + 30 + localNameLen), name) !== 0 ||
100
+ hasZip64Extra(view, local + 30 + localNameLen, localExtraLen)
101
+ ) {
102
+ throw refuse("a zip part's local header disagrees with the directory");
103
+ }
104
+ const start = local + 30 + localNameLen + localExtraLen;
105
+ const data = bytes.subarray(start, start + size);
106
+ let actual: number;
107
+ if (method === 0) actual = data.length;
108
+ else if (method === 8)
109
+ actual = inflateRawSync(data, { maxOutputLength: Math.max(fullSize, 1) }).length;
110
+ else throw notXlsx(`unsupported zip compression method ${method}`);
111
+ if (actual !== fullSize) throw notXlsx("a zip part does not match its declared size");
112
+ at = next;
113
+ }
114
+ if (at !== eocd) throw refuse("the zip directory has bytes the entry count does not cover");
115
+ } catch (error) {
116
+ if (error instanceof ObjectsError) throw error;
117
+ // RangeError (read past the end), zlib errors (bad stream, output past the declared size).
118
+ throw notXlsx(`corrupt zip archive (${(error as Error).message})`);
119
+ }
120
+ return names;
121
+ }
122
+
123
+ /** Run `fn` on the parts of a formula outside string literals and quoted sheet names. `""` and `''` escape a quote. */
124
+ const outsideQuotes = (formula: string, fn: (code: string) => string) =>
125
+ formula
126
+ .split(/("(?:[^"]|"")*"|'(?:[^']|'')*')/)
127
+ .map((part, i) => (i % 2 ? part : fn(part)))
128
+ .join("");
129
+
130
+ // Read with `xlfn: true`: SheetJS would strip `_xlfn.` inside string literals too. We strip both prefixes, outside quotes only.
131
+ const XLPREFIX = /_xl(?:fn|ws)\./g;
132
+
133
+ /** Functions Excel stores with an `_xlfn.` prefix (`_xlfn._xlws.` for the two that sort or filter). Without it Excel shows #NAME?. */
134
+ const XLFN_FUNCTIONS = [
135
+ "CONCAT",
136
+ "IFNA",
137
+ "IFS",
138
+ "MAXIFS",
139
+ "MINIFS",
140
+ "SEQUENCE",
141
+ "STDEV.P",
142
+ "STDEV.S",
143
+ "SWITCH",
144
+ "TEXTJOIN",
145
+ "UNIQUE",
146
+ "VAR.P",
147
+ "VAR.S",
148
+ "XLOOKUP",
149
+ "XMATCH",
150
+ ];
151
+ const XLWS_FUNCTIONS = ["FILTER", "SORT"];
152
+ const prefixFunctions = (formula: string, names: string[], prefix: string) =>
153
+ names.reduce(
154
+ (f, name) =>
155
+ f.replace(new RegExp(`(?<![\\w.])${name.replace(".", "\\.")}\\(`, "gi"), `${prefix}${name}(`),
156
+ formula,
157
+ );
158
+
159
+ // shortcut: a fixed list of post-2007 functions; add a name here when Excel shows #NAME? for one we export.
160
+ const toXlsxFormula = (formula: string) =>
161
+ outsideQuotes(formula.slice(1), (code) =>
162
+ prefixFunctions(
163
+ prefixFunctions(code, XLFN_FUNCTIONS, "_xlfn."),
164
+ XLWS_FUNCTIONS,
165
+ "_xlfn._xlws.",
166
+ ),
167
+ );
168
+
169
+ const ERROR_CODES: Record<string, number> = {
170
+ "#NULL!": 0,
171
+ "#DIV/0!": 7,
172
+ "#VALUE!": 15,
173
+ "#REF!": 23,
174
+ "#NAME?": 29,
175
+ "#NUM!": 36,
176
+ "#N/A": 42,
177
+ };
178
+
179
+ type Zip = Record<string, { content?: string | Uint8Array } | undefined>;
180
+
181
+ /**
182
+ * Whether any `<tag ...>` start tag in `xml` has `attr` inside its own tag.
183
+ * One pass: every step moves past the tag it read, so a crafted run of `<pane ` tokens cannot make it quadratic the way a backtracking regex does.
184
+ */
185
+ function hasTagWith(xml: string, tag: string, attr: string): boolean {
186
+ for (let at = xml.indexOf(tag); at !== -1; at = xml.indexOf(tag, at)) {
187
+ const end = xml.indexOf(">", at);
188
+ if (end === -1) return false;
189
+ if (xml.slice(at, end).includes(attr)) return true;
190
+ at = end + 1;
191
+ }
192
+ return false;
193
+ }
194
+
195
+ /** Whether a `<font>` element holds `<b/>`. Linear for the same reason as `hasTagWith`: each step moves past the `</font>` it reached. */
196
+ function hasBoldFont(styles: string): boolean {
197
+ for (let at = styles.indexOf("<font>"); at !== -1; at = styles.indexOf("<font>", at)) {
198
+ const end = styles.indexOf("</font>", at);
199
+ if (end === -1) return false;
200
+ if (styles.slice(at, end).includes("<b/>")) return true;
201
+ at = end + 7;
202
+ }
203
+ return false;
204
+ }
205
+
206
+ /** Features of the file that a `swarm-sheet/1` workbook does not carry, read from the zip parts. */
207
+ function lostFeatures(names: Set<string>, files: Zip, definedNames: boolean): string[] {
208
+ const found = new Set<string>();
209
+ const text = (name: string) => {
210
+ const content = files[name]?.content;
211
+ return typeof content === "string" ? content : content ? new TextDecoder().decode(content) : "";
212
+ };
213
+ const has = (prefix: string) => [...names].some((name) => name.startsWith(prefix));
214
+ if (has("xl/charts/")) found.add("charts");
215
+ if (has("xl/media/")) found.add("images");
216
+ if (has("xl/comments") || has("xl/threadedComments")) found.add("comments");
217
+ if (has("xl/pivot")) found.add("pivot tables");
218
+ if (has("xl/tables/")) found.add("Excel tables");
219
+ if (names.has("xl/vbaProject.bin")) found.add("macros");
220
+ for (const name of names) {
221
+ if (!/^xl\/worksheets\/[^/]+\.xml$/.test(name)) continue;
222
+ const xml = text(name);
223
+ if (xml.includes("<conditionalFormatting")) found.add("conditional formatting");
224
+ if (xml.includes("<dataValidation")) found.add("data validation");
225
+ if (xml.includes("<autoFilter")) found.add("autofilter");
226
+ if (xml.includes("<hyperlink ")) found.add("hyperlinks");
227
+ if (xml.includes("<sheetProtection")) found.add("sheet protection");
228
+ if (hasTagWith(xml, "<pane ", 'state="frozen"')) found.add("frozen panes");
229
+ }
230
+ const styles = text("xl/styles.xml");
231
+ if (
232
+ /<patternFill patternType="solid"/.test(styles) ||
233
+ hasBoldFont(styles) ||
234
+ /<(left|right|top|bottom) style="/.test(styles)
235
+ ) {
236
+ found.add("cell styling (fills, bold, borders)");
237
+ }
238
+ if (definedNames) found.add("defined names");
239
+ return [...found];
240
+ }
241
+
242
+ /** Parse an xlsx into tabs. The engine recomputes every formula afterwards, so cached results are not kept. */
243
+ export async function parseXlsx(
244
+ bytes: Uint8Array,
245
+ ): Promise<{ tabs: SheetTab[]; dropped: string[] }> {
246
+ const names = checkedZipParts(bytes);
247
+ if (!names.has("xl/workbook.xml")) throw notXlsx("the archive has no xl/workbook.xml");
248
+ const XLSX = await import("xlsx");
249
+ // shortcut: SheetJS parses on the API thread; the file, inflated and cell caps bound it (50,000 cells parse in about 0.2 s). Move it to the engine worker if imports ever stall the API.
250
+ let wb: ReturnType<typeof XLSX.read>;
251
+ try {
252
+ // sheetStubs keeps a formula cell that has no cached value.
253
+ wb = XLSX.read(bytes, {
254
+ type: "array",
255
+ cellFormula: true,
256
+ cellNF: true,
257
+ cellStyles: true,
258
+ xlfn: true,
259
+ sheetStubs: true,
260
+ bookFiles: true,
261
+ });
262
+ } catch (error) {
263
+ throw notXlsx((error as Error).message);
264
+ }
265
+ if (wb.SheetNames.length > MAX_TABS) {
266
+ throw new ObjectsError(
267
+ `the workbook has ${wb.SheetNames.length} tabs; the limit is ${MAX_TABS}`,
268
+ );
269
+ }
270
+ const dropped = new Set<string>();
271
+ let cellTotal = 0;
272
+ const tabs = wb.SheetNames.map((name): SheetTab => {
273
+ const ws = wb.Sheets[name] as WorkSheet;
274
+ const cells: Record<string, SheetCell> = {};
275
+ for (const [ref, entry] of Object.entries(ws)) {
276
+ if (ref.startsWith("!")) continue;
277
+ const cell = entry as CellObject;
278
+ const out: SheetCell = {};
279
+ if (typeof cell.f === "string" && cell.f !== "") {
280
+ // A multi-cell array formula would spill over its own cached cells: keep the values.
281
+ if (cell.F?.includes(":")) dropped.add("array formulas (kept as values)");
282
+ else out.f = `=${outsideQuotes(cell.f, (code) => code.replace(XLPREFIX, ""))}`;
283
+ }
284
+ if (out.f === undefined) {
285
+ if (cell.t === "n" || cell.t === "s") out.v = cell.v as number | string;
286
+ else if (cell.t === "b") out.v = !!cell.v;
287
+ else if (cell.t === "e") {
288
+ out.v = cell.w ?? "#VALUE!";
289
+ dropped.add("error constants (kept as text)");
290
+ }
291
+ }
292
+ // A stub with no formula and no value is an empty styled cell.
293
+ if (out.f === undefined && out.v === undefined) continue;
294
+ if (typeof cell.z === "string" && cell.z !== "General") out.nf = cell.z;
295
+ cells[ref] = out;
296
+ if (++cellTotal > MAX_CELLS) {
297
+ throw new ObjectsError(
298
+ `the workbook has more than ${MAX_CELLS} cells; the limit is ${MAX_CELLS}`,
299
+ );
300
+ }
301
+ }
302
+ const tab: SheetTab = { name, cells };
303
+ const widths: Record<string, number> = {};
304
+ (ws["!cols"] ?? []).forEach((col, i) => {
305
+ const px = col?.wpx ?? (col?.wch ? Math.round(col.wch * 7 + 5) : 0);
306
+ if (px) widths[colName(i + 1)] = px;
307
+ });
308
+ if (Object.keys(widths).length) tab.colWidths = widths;
309
+ if (ws["!merges"]?.length)
310
+ tab.merges = ws["!merges"].map((range) => XLSX.utils.encode_range(range));
311
+ return tab;
312
+ });
313
+ const definedNames = !!wb.Workbook?.Names?.some((n) => !String(n.Name).startsWith("_xlnm"));
314
+ for (const feature of lostFeatures(names, (wb as { files?: Zip }).files ?? {}, definedNames)) {
315
+ dropped.add(feature);
316
+ }
317
+ return { tabs, dropped: [...dropped] };
318
+ }
319
+
320
+ /** Build an xlsx from a workbook's tabs. Formulas keep their cached result. */
321
+ export async function buildXlsx(
322
+ tabs: SheetTab[],
323
+ ): Promise<{ bytes: Uint8Array<ArrayBuffer>; dropped: string[] }> {
324
+ const XLSX = await import("xlsx");
325
+ const wb = XLSX.utils.book_new();
326
+ const dropped = new Set<string>();
327
+ for (const tab of tabs) {
328
+ const ws: WorkSheet = {};
329
+ let rows = 0;
330
+ let cols = 0;
331
+ for (const [ref, c] of Object.entries(tab.cells)) {
332
+ const at = parseCell(ref);
333
+ rows = Math.max(rows, at.row);
334
+ cols = Math.max(cols, at.col);
335
+ let cell: CellObject;
336
+ if (c.e) {
337
+ const text = String(c.v);
338
+ cell = { t: "e", v: ERROR_CODES[text] ?? ERROR_CODES["#VALUE!"], w: text };
339
+ } else if (typeof c.v === "number") cell = { t: "n", v: c.v };
340
+ else if (typeof c.v === "boolean") cell = { t: "b", v: c.v };
341
+ else if (typeof c.v === "string") cell = { t: "s", v: c.v };
342
+ else cell = { t: "z" };
343
+ if (c.f) cell.f = toXlsxFormula(c.f);
344
+ if (c.nf) cell.z = c.nf;
345
+ if (c.s) dropped.add("spilled array cells (written as values; the anchor keeps its formula)");
346
+ ws[ref] = cell;
347
+ }
348
+ ws["!ref"] = rows ? `A1:${refOf(rows, cols)}` : "A1";
349
+ if (tab.colWidths) {
350
+ ws["!cols"] = Array.from({ length: cols }, (_, i) => {
351
+ const px = tab.colWidths?.[colName(i + 1)];
352
+ return px ? { wpx: px } : {};
353
+ });
354
+ }
355
+ if (tab.merges) ws["!merges"] = tab.merges.map((range) => XLSX.utils.decode_range(range));
356
+ // SheetJS CE cannot write the pane element.
357
+ if (tab.freezeRows) dropped.add("frozen panes");
358
+ try {
359
+ XLSX.utils.book_append_sheet(wb, ws, tab.name);
360
+ } catch (error) {
361
+ // A hand-edited file can hold a tab name Excel forbids.
362
+ throw new ObjectsError(`cannot export tab '${tab.name}': ${(error as Error).message}`);
363
+ }
364
+ }
365
+ const out = XLSX.write(wb, { type: "array", bookType: "xlsx", compression: true }) as ArrayBuffer;
366
+ return { bytes: new Uint8Array(out), dropped: [...dropped] };
367
+ }
@@ -0,0 +1,83 @@
1
+ import { FilesError } from "@/fs/provider";
2
+ import {
3
+ clientFor,
4
+ getObject,
5
+ ObjectsError,
6
+ PRIMITIVE_KINDS,
7
+ type PrimitiveObject,
8
+ recordObjectVersion,
9
+ } from "./objects";
10
+
11
+ type Json = Record<string, unknown>;
12
+
13
+ export const MAX_OBJECT_BYTES = 5 * 1024 * 1024;
14
+ /** One write plus three re-read-and-reapply rounds on a 409. */
15
+ export const MAX_WRITE_ATTEMPTS = 4;
16
+
17
+ /**
18
+ * Read an object's file with its agent-fs version, apply `mutate`, and write it
19
+ * back with `If-Match`. On a 409 it re-reads and re-applies, so patches to
20
+ * different parts merge and the same part is last writer wins. The write also
21
+ * re-embeds `swarm.id`, which heals a stock editor save that dropped it.
22
+ */
23
+ export async function mutateObject<T>(input: {
24
+ agentId: string | undefined;
25
+ id?: string;
26
+ path?: string;
27
+ kind: string;
28
+ /** agent-fs commit message. */
29
+ message: string;
30
+ mutate: (content: Json, object: PrimitiveObject) => T;
31
+ }): Promise<{ object: PrimitiveObject; version: number | null; result: T }> {
32
+ const kind = PRIMITIVE_KINDS[input.kind];
33
+ if (!kind) throw new ObjectsError(`unknown kind '${input.kind}'`);
34
+ const { provider, scope } = await clientFor(input.agentId);
35
+ for (let attempt = 1; ; attempt += 1) {
36
+ const { object, missing, content } = await getObject({
37
+ agentId: input.agentId,
38
+ id: input.id,
39
+ path: input.path,
40
+ includeContent: true,
41
+ });
42
+ if (object.kind !== input.kind) {
43
+ throw new ObjectsError(`object ${object.id} is a ${object.kind}, not a ${input.kind}`);
44
+ }
45
+ if (missing) {
46
+ throw new ObjectsError(
47
+ `the file for ${object.kind} ${object.id} at '${object.path}' is missing; run object-reindex`,
48
+ );
49
+ }
50
+ if (!content || typeof content !== "object" || Array.isArray(content)) {
51
+ throw new ObjectsError(`'${object.path}' is not a JSON object`);
52
+ }
53
+ if (object.fileVersion === null) {
54
+ throw new ObjectsError(
55
+ `agent-fs returned no version for '${object.path}'; refusing an unguarded write`,
56
+ );
57
+ }
58
+ const result = input.mutate(content as Json, object);
59
+ const body = JSON.stringify(kind.withId(content as Json, object.id), null, 2);
60
+ if (Buffer.byteLength(body) > MAX_OBJECT_BYTES) {
61
+ throw new ObjectsError(
62
+ `'${object.path}' would exceed ${MAX_OBJECT_BYTES} bytes; nothing written`,
63
+ );
64
+ }
65
+ try {
66
+ const written = await provider.upload(scope(object.path), body, {
67
+ contentType: kind.contentType,
68
+ ifMatch: String(object.fileVersion),
69
+ message: input.message,
70
+ });
71
+ const version = Number.isFinite(Number(written.version)) ? Number(written.version) : null;
72
+ await recordObjectVersion(object.id, version);
73
+ return { object: { ...object, fileVersion: version }, version, result };
74
+ } catch (error) {
75
+ if (!(error instanceof FilesError && error.code === "Conflict")) throw error;
76
+ if (attempt >= MAX_WRITE_ATTEMPTS) {
77
+ throw new ObjectsError(
78
+ `concurrent writers changed '${object.path}' ${attempt} times in a row; retry`,
79
+ );
80
+ }
81
+ }
82
+ }
83
+ }
@@ -44,6 +44,8 @@ export const BUILTIN_ROLES = [
44
44
  "task.steer.own",
45
45
  "comb.presence",
46
46
  "fs.join.own",
47
+ "objects.read",
48
+ "objects.write",
47
49
  ],
48
50
  },
49
51
  {
@@ -58,6 +60,7 @@ export const BUILTIN_ROLES = [
58
60
  "session.presence",
59
61
  "comb.presence",
60
62
  "fs.join.own",
63
+ "objects.read",
61
64
  ],
62
65
  },
63
66
  {
@@ -1,6 +1,6 @@
1
1
  import type { SwarmRepo } from "@/types";
2
2
  import { getDbClient, getSwarmRepoById, updateSwarmRepo } from "./db";
3
- import { changesAllowMerge } from "./repo-merge-policy";
3
+ import { changesMergePolicy } from "./repo-merge-policy";
4
4
 
5
5
  export type CheckedRepoUpdate<Refusal> =
6
6
  | { kind: "updated"; repo: SwarmRepo }
@@ -8,12 +8,12 @@ export type CheckedRepoUpdate<Refusal> =
8
8
  | { kind: "refused"; refusal: Refusal };
9
9
 
10
10
  /**
11
- * Applies a repo update whose `allowMerge` change the caller must be authorized for. The
11
+ * Applies a repo update whose merge-policy change (`allowMerge` or `mergePolicy`) the caller must be authorized for. The
12
12
  * guidelines `authorize` compares against, the decision and the write share one BEGIN IMMEDIATE
13
13
  * transaction, so a stale edit cannot overwrite a merge-policy change that committed after the
14
14
  * caller's read: the later writer waits, then decides against the committed value.
15
15
  *
16
- * `authorize` runs only when the update changes `allowMerge`. It returns a refusal to stop the
16
+ * `authorize` runs only when the update changes the merge policy. It returns a refusal to stop the
17
17
  * update, or null to allow it. It runs inside the transaction: read only what it needs through
18
18
  * the usual helpers (they join the transaction) and do no slow I/O.
19
19
  */
@@ -25,7 +25,7 @@ export async function updateSwarmRepoChecked<Refusal>(
25
25
  return await getDbClient().transaction(async (): Promise<CheckedRepoUpdate<Refusal>> => {
26
26
  if (updates.guidelines !== undefined) {
27
27
  const existing = await getSwarmRepoById(id);
28
- if (existing && changesAllowMerge(existing.guidelines, updates.guidelines)) {
28
+ if (existing && changesMergePolicy(existing.guidelines, updates.guidelines)) {
29
29
  const refusal = await authorize(existing);
30
30
  if (refusal !== null) return { kind: "refused", refusal };
31
31
  }
@@ -1,15 +1,32 @@
1
- import type { RepoGuidelines } from "@/types";
1
+ import { agentsMayMerge, type RepoGuidelines } from "@/types";
2
+
3
+ type MergePolicyFields = Pick<RepoGuidelines, "allowMerge" | "mergePolicy">;
4
+
5
+ /** Stable JSON: object keys sorted, so a reordered resend of the same record compares equal. */
6
+ function canonical(value: unknown): string {
7
+ return JSON.stringify(value ?? null, (_key, v) =>
8
+ v && typeof v === "object" && !Array.isArray(v)
9
+ ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : 1)))
10
+ : v,
11
+ );
12
+ }
2
13
 
3
14
  /**
4
- * True when writing `incoming` would change a repo's effective `allowMerge`. An omitted
5
- * `guidelines` leaves it alone, `null` clears it (so it reads false), and a missing flag
6
- * reads false. Only the lead, the operator or a user may make such a change: the flag is
7
- * rendered into every agent's prompt as the merge policy.
15
+ * True when writing `incoming` would change a repo's merge policy: its raw `allowMerge`
16
+ * flag (a record's `agentsMayMerge` can mask it, but other readers use it directly), its effective
17
+ * `agentsMayMerge` (the record's flag, else `allowMerge`) or any part of its `mergePolicy`
18
+ * record. An omitted `guidelines` leaves it alone and `null` clears it. A resend that drops
19
+ * a stored `mergePolicy` counts as a change. Only the lead, the operator or a user may make
20
+ * such a change: the policy is rendered into every agent's prompt and read by the merge scripts.
8
21
  */
9
- export function changesAllowMerge(
10
- current: Pick<RepoGuidelines, "allowMerge"> | null | undefined,
11
- incoming: Pick<RepoGuidelines, "allowMerge"> | null | undefined,
22
+ export function changesMergePolicy(
23
+ current: MergePolicyFields | null | undefined,
24
+ incoming: MergePolicyFields | null | undefined,
12
25
  ): boolean {
13
26
  if (incoming === undefined) return false;
14
- return (incoming?.allowMerge === true) !== (current?.allowMerge === true);
27
+ return (
28
+ (current?.allowMerge === true) !== (incoming?.allowMerge === true) ||
29
+ agentsMayMerge(current) !== agentsMayMerge(incoming) ||
30
+ canonical(current?.mergePolicy) !== canonical(incoming?.mergePolicy)
31
+ );
15
32
  }
@@ -10,7 +10,8 @@ import {
10
10
  import type { EgressSecretEntry, ScriptAgentFsDescriptor } from "@/scripts-runtime/executors/types";
11
11
  import { AGENT_FS_API_KEY_CONFIG } from "@/scripts-runtime/script-fs";
12
12
  import { registerVolatileSecret } from "@/utils/secret-scrubber";
13
- import { getResolvedConfig, getSwarmConfigs } from "./db";
13
+ import { resolveAgentFsIdentity } from "./agent-fs-identity";
14
+ import { getResolvedConfig } from "./db";
14
15
  import { resolveOAuthBindingToken } from "./oauth-credential-bindings";
15
16
  import { listRelationalCredentialBindings } from "./script-connections";
16
17
  import { isApiOnlyConfigKey, isInternalConfigKey } from "./swarm-config-guard";
@@ -54,48 +55,28 @@ function toScriptUserConfig(configs: Awaited<ReturnType<typeof getResolvedConfig
54
55
  /**
55
56
  * The agent's default agent-fs drive for `ctx.fs` / `ctx.sh`, and the egress
56
57
  * entry that lets the patched fetch put the agent's key on agent-fs requests.
57
- *
58
- * The key comes only from the invoking agent's own agent-scoped row. A global
59
- * or repo row, the API env and `API_AGENT_FS_API_KEY` would all run the script
60
- * as some other agent-fs identity, so without an own key there is no mount.
61
- * The non-secret coordinates keep the store-progress lookup: config, then env.
58
+ * Identity rules (own agent-scoped key only): `resolveAgentFsIdentity`.
62
59
  */
63
60
  async function agentFsMount(
64
61
  agentId: string | undefined,
65
62
  configMap: Map<string, string>,
66
63
  ): Promise<{ descriptor: ScriptAgentFsDescriptor; entry: EgressSecretEntry } | undefined> {
67
- if (!agentId) return undefined;
68
- const [own] = await getSwarmConfigs({
69
- scope: "agent",
70
- scopeId: agentId,
71
- key: AGENT_FS_API_KEY_CONFIG,
72
- });
73
- const key = own?.value?.trim();
74
- if (!key) return undefined;
75
- const value = (name: string) => configMap.get(name)?.trim() || process.env[name]?.trim();
76
- const apiUrl = value("AGENT_FS_API_URL")?.replace(/\/+$/, "");
77
- const orgId = value("AGENT_FS_DEFAULT_ORG_ID");
78
- const driveId = value("AGENT_FS_DEFAULT_DRIVE_ID");
79
- if (!apiUrl || !orgId || !driveId) return undefined;
80
- let host: string;
81
- try {
82
- host = new URL(apiUrl).hostname;
83
- } catch {
84
- return undefined;
85
- }
64
+ const identity = await resolveAgentFsIdentity(agentId, configMap);
65
+ if (!agentId || !identity) return undefined;
66
+ const { apiUrl, apiKey, orgId, driveId } = identity;
86
67
  const placeholder = placeholderForConfigKey(AGENT_FS_API_KEY_CONFIG);
87
68
  return {
88
69
  descriptor: { apiUrl, orgId, driveId },
89
70
  entry: {
90
71
  configKey: AGENT_FS_API_KEY_CONFIG,
91
- allowedHosts: [host],
72
+ allowedHosts: [new URL(apiUrl).hostname],
92
73
  headerTemplate: `Authorization: Bearer ${placeholder}`,
93
74
  scope: "agent",
94
75
  scopeId: agentId,
95
76
  active: true,
96
77
  authKind: "config",
97
78
  placeholder,
98
- value: key,
79
+ value: apiKey,
99
80
  },
100
81
  };
101
82
  }
@@ -28,6 +28,9 @@ export type ScriptRow = {
28
28
  fsMode: "none" | "workspace-rw";
29
29
  executor: "native" | "quickjs" | null;
30
30
  createdByAgentId: string | null;
31
+ updatedByAgentId: string | null;
32
+ created_by: string | null;
33
+ updated_by: string | null;
31
34
  createdAt: string;
32
35
  updatedAt: string;
33
36
  };
@@ -40,6 +43,9 @@ export function toScriptRecord(row: ScriptRow) {
40
43
  typeChecked: row.typeChecked === 1,
41
44
  executor: row.executor ?? null,
42
45
  createdByAgentId: row.createdByAgentId ?? null,
46
+ updatedByAgentId: row.updatedByAgentId ?? null,
47
+ createdBy: row.created_by ?? null,
48
+ updatedBy: row.updated_by ?? null,
43
49
  };
44
50
  }
45
51