@desplega.ai/agent-swarm 2.12.0 → 2.13.1

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 (417) hide show
  1. package/dist/acp-adapter-xtj40wd8.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-n7vm5atw.js} +10 -9
  3. package/dist/{actions-c4chgxp6.js → actions-hq6wp9xv.js} +28 -27
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-y0qc1rdd.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-1qqs6h91.js} +3 -3
  6. package/dist/{app-hn5fftf5.js → app-7m4z44rv.js} +10 -8
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-8sr41gjx.js} +11 -10
  8. package/dist/{assistant-cpjgpjvp.js → assistant-hkczwfv6.js} +29 -28
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-8025snev.js} +1 -1
  10. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-15m87nr1.js} +5 -2
  11. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-4bbpxjh1.js} +1 -1
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-eajr97e9.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-9cwy39jx.js} +4 -4
  14. package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
  15. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-g61wa4rt.js} +9 -8
  16. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-znkk0prm.js} +4 -4
  17. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-f1wndkr2.js} +7 -7
  18. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-687xzf21.js} +20763 -19380
  19. package/dist/{cli-ya3kf4gs.js → cli-04103ryh.js} +1 -1
  20. package/dist/{cli-55tc8cj4.js → cli-0a336ze7.js} +5 -5
  21. package/dist/{cli-q8tc22bj.js → cli-0fx95c06.js} +5 -5
  22. package/dist/{cli-mq2fbgva.js → cli-0m77n7ej.js} +3 -3
  23. package/dist/{cli-7yn42w6m.js → cli-0xwb7zpt.js} +2 -2
  24. package/dist/{cli-mcymtvwn.js → cli-13t0smbk.js} +1000 -28
  25. package/dist/{cli-c7j31hq9.js → cli-1b5axkt1.js} +4 -4
  26. package/dist/{cli-yegz2g06.js → cli-1carhg8g.js} +4 -4
  27. package/dist/{cli-j5gtytvg.js → cli-1dr5at77.js} +15 -12
  28. package/dist/cli-2v4xxnx2.js +148 -0
  29. package/dist/{cli-sv2r3bw8.js → cli-32xndx6b.js} +7 -7
  30. package/dist/{cli-h70a2mxy.js → cli-3m8vqehw.js} +53 -13
  31. package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
  32. package/dist/{cli-52nfye5j.js → cli-3zyme1wt.js} +24 -16
  33. package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
  34. package/dist/{cli-b93d81yg.js → cli-4h90xaet.js} +2 -2
  35. package/dist/{cli-5tg94mdw.js → cli-4mj5g29m.js} +9 -12
  36. package/dist/{cli-47hz21se.js → cli-4tbvndmm.js} +4 -5
  37. package/dist/{cli-r0mz92by.js → cli-50whymxq.js} +2 -2
  38. package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
  39. package/dist/{cli-krbcr00p.js → cli-5v6b2am8.js} +59 -5
  40. package/dist/{cli-en6dmkxd.js → cli-6r1dwegd.js} +3 -3
  41. package/dist/{cli-9qe5y107.js → cli-7ewre3dm.js} +15 -6
  42. package/dist/{cli-n3qe7tyr.js → cli-84xtgbn6.js} +35 -2
  43. package/dist/{cli-xm34qj8m.js → cli-8cmjkbvj.js} +2 -2
  44. package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
  45. package/dist/{cli-nja15knq.js → cli-8rbkw18r.js} +3 -3
  46. package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
  47. package/dist/{cli-hhc47ack.js → cli-9xx36trj.js} +4 -4
  48. package/dist/{cli-39qm0rtm.js → cli-a8ts6x1n.js} +29 -150
  49. package/dist/{cli-bp6k9acz.js → cli-aebswqmz.js} +18 -18
  50. package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
  51. package/dist/{cli-q2dywc8h.js → cli-bjmq14k9.js} +4 -4
  52. package/dist/{cli-v9ya390t.js → cli-byxsctca.js} +12 -12
  53. package/dist/{cli-bz97ff9n.js → cli-c0tyzt73.js} +152 -12
  54. package/dist/{cli-fyaq4zdv.js → cli-c8kqmzzf.js} +9 -9
  55. package/dist/{cli-t75xngj1.js → cli-cd9acnvd.js} +12 -12
  56. package/dist/{cli-eqq0hwvx.js → cli-cmgdptmx.js} +3 -3
  57. package/dist/{cli-r14ac1y0.js → cli-cn6fpa1p.js} +1 -1
  58. package/dist/{cli-0k1a0sde.js → cli-cp0m07wb.js} +10 -10
  59. package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
  60. package/dist/{cli-fxd1mwtr.js → cli-cqxwjb93.js} +2 -2
  61. package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
  62. package/dist/{cli-73q4g5nx.js → cli-dd57p1gd.js} +21 -21
  63. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  64. package/dist/{cli-wvjqaqcp.js → cli-fn8aj7gb.js} +1330 -249
  65. package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
  66. package/dist/{cli-0pp1yjg2.js → cli-gedf48yw.js} +11 -11
  67. package/dist/{cli-m5qtmrbc.js → cli-gq6qhmrr.js} +2 -2
  68. package/dist/{cli-5x03v6en.js → cli-grcc2h2g.js} +8 -8
  69. package/dist/{cli-01tvvtad.js → cli-h03j6je3.js} +4 -4
  70. package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
  71. package/dist/{cli-12vek61e.js → cli-h9bejmkf.js} +535 -146
  72. package/dist/{cli-gfy6hbd9.js → cli-hs3mqswp.js} +18 -11
  73. package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
  74. package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
  75. package/dist/{cli-cjqyse9q.js → cli-jhtvt7gn.js} +3 -3
  76. package/dist/{cli-dkvtfgn4.js → cli-mmw2sjaf.js} +76 -17
  77. package/dist/{cli-2z2c4k6q.js → cli-mwxez0pz.js} +22 -0
  78. package/dist/{cli-yfpc6qy9.js → cli-nk8swfpx.js} +47 -16
  79. package/dist/{cli-eq4kew31.js → cli-p7g7wd9n.js} +26 -13
  80. package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
  81. package/dist/{cli-dd2k2mcd.js → cli-qn79645p.js} +1 -1
  82. package/dist/{cli-ma9ys8rt.js → cli-qx1dwrr5.js} +7 -4
  83. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  84. package/dist/{cli-agjbj5x0.js → cli-s6fhqbz1.js} +38 -20
  85. package/dist/{cli-kwr5qv5g.js → cli-sfajkbd7.js} +2 -2
  86. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  87. package/dist/{cli-e8n0hdzd.js → cli-snypfjgj.js} +1 -1
  88. package/dist/{cli-n8f0fs3c.js → cli-t25rq8mg.js} +11 -11
  89. package/dist/{cli-72yms3ey.js → cli-t90k0phh.js} +201 -21
  90. package/dist/{cli-xf4z5bdn.js → cli-tzzas8rb.js} +4 -4
  91. package/dist/{cli-rtmqzat7.js → cli-vdfngx2g.js} +2 -2
  92. package/dist/{cli-9w8712tq.js → cli-vr4eyq6p.js} +43 -14
  93. package/dist/{cli-z4f346g5.js → cli-vx9acp12.js} +1 -1
  94. package/dist/{cli-2amwhyv2.js → cli-w24f3j49.js} +13 -11
  95. package/dist/cli-w41bvvms.js +148 -0
  96. package/dist/{cli-04zc3f7b.js → cli-w6c6dj91.js} +1 -1
  97. package/dist/{cli-fy4gb74g.js → cli-x5yb8zc8.js} +2 -2
  98. package/dist/{cli-2tw284hj.js → cli-xhkek467.js} +3 -3
  99. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  100. package/dist/{cli-hbvgzjq4.js → cli-y6qqbpwc.js} +3 -3
  101. package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
  102. package/dist/{cli-1htmtqc2.js → cli-yeh3g1q6.js} +620 -95
  103. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  104. package/dist/{cli-k5jx8jya.js → cli-z6m6xzxt.js} +2 -2
  105. package/dist/{cli-pe3yxedk.js → cli-zaate0rd.js} +3 -3
  106. package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
  107. package/dist/{cli-e3ahxq5y.js → cli-zvpkrgsc.js} +6 -6
  108. package/dist/cli.js +30 -28
  109. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-ysfg6ty3.js} +8 -8
  110. package/dist/{codex-hook-aqtj17yr.js → codex-hook-c0nvm30r.js} +73 -2
  111. package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
  112. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-823scr6g.js} +9 -9
  113. package/dist/{commands-tsv2vx5b.js → commands-5rbm07fz.js} +3 -3
  114. package/dist/{controller-ye4sdwsy.js → controller-wn3vd217.js} +4 -4
  115. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-34jzhfft.js} +29 -28
  116. package/dist/core-kdehq26g.js +42 -0
  117. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-w1681kp1.js} +2 -2
  118. package/dist/{db-g111qn9j.js → db-6bkgbfwk.js} +3 -3
  119. package/dist/{db-3r1fyr2n.js → db-hcj16x7z.js} +4 -2
  120. package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
  121. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-jgjqrfzv.js} +28 -25
  122. package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
  123. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-g9yqv09y.js} +2 -2
  124. package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
  125. package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
  126. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-w17nsny6.js} +1 -1
  127. package/dist/{embedding-space-kcdn52vz.js → embedding-space-v06fwy7b.js} +6 -6
  128. package/dist/{embeddings-jnzcd91a.js → embeddings-g50dxea4.js} +1 -1
  129. package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
  130. package/dist/{execute-74amghty.js → execute-1n36haw1.js} +1 -1
  131. package/dist/{external-channel-v9zgxnxz.js → external-channel-43tv8pg6.js} +2 -2
  132. package/dist/fx-adapter-bvh05t4a.js +20 -0
  133. package/dist/grok-adapter-my5j8mdf.js +20 -0
  134. package/dist/handlers-wyymeeqh.js +41 -0
  135. package/dist/heartbeat-sf3nk937.js +50 -0
  136. package/dist/{hook-p5reemds.js → hook-dqph1e05.js} +77 -18
  137. package/dist/{hook-k1h73zd7.js → hook-m1m9dm6w.js} +6 -5
  138. package/dist/{http-ms1z5xxy.js → http-w0th1cz9.js} +888 -226
  139. package/dist/index-22khdtby.js +44 -0
  140. package/dist/{index-76zzxtzf.js → index-c0e8en64.js} +1 -1
  141. package/dist/{index-620y7jzq.js → index-e8pz8qdg.js} +3 -3
  142. package/dist/{index-8p0j4h4j.js → index-ez823q84.js} +94 -89
  143. package/dist/{index-fbkqhvvj.js → index-ffba0z8q.js} +217 -165
  144. package/dist/{index-gjn6qfgn.js → index-gkpfgpg7.js} +1 -1
  145. package/dist/{index-4k7m5dgj.js → index-k8ajc0g0.js} +143 -103
  146. package/dist/index-np0582ac.js +40 -0
  147. package/dist/{index-kn63q1gr.js → index-pb03vans.js} +33 -32
  148. package/dist/index-vgkrj1jt.js +39 -0
  149. package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
  150. package/dist/{index-0h6qd4p1.js → index-y4vd4mhn.js} +3 -4
  151. package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
  152. package/dist/{keepalive-031js8jz.js → keepalive-2v06q2e8.js} +5 -4
  153. package/dist/lead-55z813ng.js +79 -0
  154. package/dist/{maintenance-sq9v3qx9.js → maintenance-vx7vjhhy.js} +1 -1
  155. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-g06k4bza.js} +4 -3
  156. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-3dzdq4fm.js} +7 -7
  157. package/dist/{onboard-p25yhh7t.js → onboard-232pazny.js} +4 -4
  158. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-t0paqbh8.js} +8 -7
  159. package/dist/{otel-impl-ff1gf20m.js → otel-impl-kmpkyp4y.js} +2 -2
  160. package/dist/{pending-hxj5yatb.js → pending-x0z3vx1x.js} +27 -26
  161. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-7pmypn6d.js} +93 -22
  162. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-ytjmtyd7.js} +2 -2
  163. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-fgm5mxr2.js} +3 -3
  164. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-xyaxekh3.js} +7 -4
  165. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  166. package/dist/{render-v2-nrdkg9gf.js → render-v2-ws972g4r.js} +12 -8
  167. package/dist/{resume-s6ey36rh.js → resume-m6mjzhkp.js} +13 -12
  168. package/dist/{runtime-x0b4pyam.js → runtime-zzpc0c8a.js} +1 -1
  169. package/dist/{session-access-xv49tk14.js → session-access-vp35xs91.js} +5 -4
  170. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-p73e8zbe.js} +3 -3
  171. package/dist/{setup-mj0krk1p.js → setup-r4kd7rxg.js} +1 -1
  172. package/dist/thread-buffer-cm2nzq6t.js +42 -0
  173. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-07h2tbs2.js} +2 -2
  174. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-96vg9rpe.js} +3 -3
  175. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-vgn3f2x4.js} +3 -3
  176. package/dist/{work-objects-pydhzast.js → work-objects-74hbcx3e.js} +31 -29
  177. package/dist/worker-5pn2vzx6.js +79 -0
  178. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-ezavwn5d.js} +26 -25
  179. package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
  180. package/dist/xlsx-9acfmxr1.js +31534 -0
  181. package/openapi.json +2816 -1464
  182. package/package.json +13 -11
  183. package/src/agentmail/handlers.ts +26 -19
  184. package/src/apps/catalog.generated.json +757 -0
  185. package/src/apps/definition.ts +24 -7
  186. package/src/apps/page-validator.ts +225 -3
  187. package/src/apps/row-store.ts +37 -14
  188. package/src/azure-devops/handlers.ts +2 -0
  189. package/src/be/audit-user.ts +46 -6
  190. package/src/be/db/kv-windows.ts +22 -0
  191. package/src/be/db/session-moves.ts +3 -3
  192. package/src/be/db/session-tree.ts +52 -5
  193. package/src/be/db/skill-audit.ts +17 -0
  194. package/src/be/db/tasks/write.ts +18 -3
  195. package/src/be/db.ts +152 -33
  196. package/src/be/extensions/assets.ts +11 -7
  197. package/src/be/mcp-proxy.ts +5 -4
  198. package/src/be/memory/demotion-evidence.ts +2 -2
  199. package/src/be/memory/providers/sqlite-store.ts +151 -18
  200. package/src/be/memory/search-read-worker.ts +60 -0
  201. package/src/be/memory/search-reader.ts +223 -0
  202. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  203. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  204. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  205. package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
  206. package/src/be/model-tier-resolution.ts +18 -1
  207. package/src/be/multi-runtime.ts +17 -0
  208. package/src/be/primitives/object-embed.ts +250 -0
  209. package/src/be/primitives/objects.ts +29 -9
  210. package/src/be/primitives/sheets/service.ts +138 -6
  211. package/src/be/primitives/sheets/xlsx.ts +367 -0
  212. package/src/be/rbac-roles.ts +3 -0
  213. package/src/be/repo-checked-update.ts +4 -4
  214. package/src/be/repo-merge-policy.ts +26 -9
  215. package/src/be/schedules/validate.ts +26 -0
  216. package/src/be/scripts/boot-reembed.ts +6 -0
  217. package/src/be/scripts/db.ts +17 -5
  218. package/src/be/scripts/embeddings.ts +6 -0
  219. package/src/be/scripts/typecheck.ts +43 -2
  220. package/src/be/seed/schedules-seeder.ts +9 -1
  221. package/src/be/seed/workflows-seeder.ts +9 -1
  222. package/src/be/seed-scripts/index.ts +2 -0
  223. package/src/be/seed-skills/index.ts +12 -0
  224. package/src/be/swarm-config-guard.ts +5 -0
  225. package/src/be/unmapped-identities.ts +95 -1
  226. package/src/bitbucket/handlers.ts +2 -0
  227. package/src/commands/credential-outcome-report.ts +5 -2
  228. package/src/commands/onboard/agent-fs-version.ts +1 -1
  229. package/src/commands/provider-credentials.ts +19 -0
  230. package/src/commands/provider-error-class.ts +4 -1
  231. package/src/commands/rate-limit-outcome.ts +48 -3
  232. package/src/commands/runner.ts +113 -55
  233. package/src/commands/worktree-reaper.ts +600 -0
  234. package/src/event-waits/github.ts +43 -0
  235. package/src/event-waits/index.ts +29 -0
  236. package/src/event-waits/types.ts +51 -0
  237. package/src/extensions/contract-types.generated.ts +1 -1
  238. package/src/extensions/dispatcher.ts +9 -0
  239. package/src/fs/agent-fs-provider.ts +4 -1
  240. package/src/github/handlers.ts +3 -1
  241. package/src/github/pull-request-state.ts +34 -0
  242. package/src/gitlab/handlers.ts +12 -7
  243. package/src/hooks/codex-hook.ts +99 -1
  244. package/src/hooks/hook.ts +85 -11
  245. package/src/hooks/native-tool-hooks.ts +245 -0
  246. package/src/http/agents.ts +4 -0
  247. package/src/http/all-routes.ts +1 -0
  248. package/src/http/api-keys.ts +27 -3
  249. package/src/http/assets.ts +4 -3
  250. package/src/http/comb.ts +2 -2
  251. package/src/http/favorite-owner.ts +2 -2
  252. package/src/http/favorites.ts +3 -2
  253. package/src/http/fs.ts +13 -4
  254. package/src/http/index.ts +2 -0
  255. package/src/http/mcp-bridge.ts +4 -0
  256. package/src/http/objects.ts +265 -0
  257. package/src/http/pages-public.ts +40 -4
  258. package/src/http/pages.ts +3 -3
  259. package/src/http/poll.ts +43 -12
  260. package/src/http/pool-keys.ts +21 -2
  261. package/src/http/repos.ts +7 -6
  262. package/src/http/schedules.ts +38 -9
  263. package/src/http/script-connections.ts +14 -6
  264. package/src/http/script-runs.ts +12 -3
  265. package/src/http/scripts.ts +9 -0
  266. package/src/http/sessions.ts +30 -12
  267. package/src/http/skills.ts +17 -0
  268. package/src/http/task-requester.ts +2 -2
  269. package/src/http/tasks.ts +18 -12
  270. package/src/http/tool-hooks.ts +24 -2
  271. package/src/http/trackers/authorize-gate.ts +2 -2
  272. package/src/http/users.ts +136 -1
  273. package/src/http/workflow-events.ts +13 -0
  274. package/src/http/workflows.ts +21 -11
  275. package/src/linear/sync.ts +3 -1
  276. package/src/mcp-client/http-client.ts +3 -1
  277. package/src/oauth/identity-capture.ts +6 -1
  278. package/src/oauth/mcp-wrapper.ts +10 -3
  279. package/src/oauth/wrapper.ts +15 -3
  280. package/src/prompts/base-prompt.ts +35 -13
  281. package/src/prompts/session-templates.ts +26 -0
  282. package/src/providers/acp-targets.ts +2 -2
  283. package/src/providers/amp-adapter.ts +1 -1
  284. package/src/providers/dsh-adapter.ts +1 -1
  285. package/src/providers/opencode-adapter.ts +1 -0
  286. package/src/providers/opencode-swarm-plugin.ts +50 -1
  287. package/src/providers/pi-mono-adapter.ts +143 -11
  288. package/src/providers/pi-mono-extension.ts +69 -0
  289. package/src/providers/runtime-dependencies.ts +1 -1
  290. package/src/rbac/legacy-policy.ts +5 -0
  291. package/src/rbac/permissions.ts +16 -1
  292. package/src/scheduler/deferred-task-waits.ts +170 -13
  293. package/src/scripts-runtime/executors/types.ts +5 -0
  294. package/src/scripts-runtime/loader.ts +8 -0
  295. package/src/scripts-runtime/mcp-client.ts +4 -0
  296. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  297. package/src/scripts-runtime/swarm-config.ts +8 -0
  298. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  299. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  300. package/src/scripts-runtime/types/swarm-extension.d.ts +8 -7
  301. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  302. package/src/server.ts +4 -0
  303. package/src/slack/enrich.ts +94 -31
  304. package/src/slack/handlers.test.ts +55 -2
  305. package/src/slack/handlers.ts +38 -3
  306. package/src/slack/render-v2.ts +19 -0
  307. package/src/slack/session-mirror.ts +208 -0
  308. package/src/slack/thread-participants.ts +0 -5
  309. package/src/slack/watcher.ts +3 -0
  310. package/src/slack/work-objects.test.ts +2 -1
  311. package/src/slack/work-objects.ts +7 -2
  312. package/src/tests/agentmail-filters.test.ts +4 -3
  313. package/src/tests/agents-list-model-display.test.ts +23 -0
  314. package/src/tests/apps-spike2.test.ts +35 -0
  315. package/src/tests/audit-agent-person.test.ts +825 -0
  316. package/src/tests/audit-updated-by.test.ts +19 -12
  317. package/src/tests/base-prompt.test.ts +1 -0
  318. package/src/tests/claude-hook-output.test.ts +107 -2
  319. package/src/tests/claude-managed-setup.test.ts +1 -1
  320. package/src/tests/codex-adapter.test.ts +6 -6
  321. package/src/tests/codex-gpt6-release.test.ts +4 -4
  322. package/src/tests/db-task-read-contract.test.ts +1 -0
  323. package/src/tests/db-task-write-contract.test.ts +1 -0
  324. package/src/tests/deploy-guard.test.ts +24 -0
  325. package/src/tests/dsh-adapter.test.ts +1 -1
  326. package/src/tests/ensure-token.test.ts +2 -2
  327. package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
  328. package/src/tests/extensions-catalog.test.ts +33 -25
  329. package/src/tests/fake-dns.ts +47 -0
  330. package/src/tests/fixtures/base-prompt-baseline.json +12 -12
  331. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  332. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  333. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  334. package/src/tests/kv-storage.test.ts +3 -0
  335. package/src/tests/latest-model-report.test.ts +138 -0
  336. package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
  337. package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
  338. package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
  339. package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
  340. package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
  341. package/src/tests/mcp-server-ssrf.test.ts +2 -0
  342. package/src/tests/memory-search-reader.test.ts +258 -0
  343. package/src/tests/memory-search-stall.test.ts +202 -20
  344. package/src/tests/model-control.test.ts +4 -4
  345. package/src/tests/model-tier-resolution.test.ts +2 -2
  346. package/src/tests/multi-runtime-registration.test.ts +8 -2
  347. package/src/tests/native-tool-hooks.test.ts +188 -0
  348. package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
  349. package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
  350. package/src/tests/oauth-wrapper.test.ts +1 -2
  351. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  352. package/src/tests/pages-head-v2.test.ts +2 -1
  353. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  354. package/src/tests/poll-probe-readonly.test.ts +108 -0
  355. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  356. package/src/tests/prompt-template-session.test.ts +3 -2
  357. package/src/tests/rbac-roles.test.ts +3 -0
  358. package/src/tests/script-connections-http.test.ts +8 -3
  359. package/src/tests/script-connections.test.ts +6 -0
  360. package/src/tests/seed-model-profiles.test.ts +1 -1
  361. package/src/tests/sessions-tree.test.ts +10 -2
  362. package/src/tests/slack-thread-participants.test.ts +77 -4
  363. package/src/tests/spend-cap-credentials.test.ts +34 -0
  364. package/src/tests/spend-cap-outcome.test.ts +67 -0
  365. package/src/tests/subscription-first.test.ts +119 -0
  366. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  367. package/src/tests/worktree-reaper.test.ts +424 -0
  368. package/src/tools/defer-task.ts +154 -12
  369. package/src/tools/get-task-details.ts +247 -5
  370. package/src/tools/objects.ts +10 -5
  371. package/src/tools/repos/update-repo.ts +6 -6
  372. package/src/tools/schedules/create-schedule.ts +1 -0
  373. package/src/tools/schedules/list-schedules.ts +3 -0
  374. package/src/tools/schedules/patch-schedule.ts +38 -4
  375. package/src/tools/schedules/update-schedule.ts +40 -5
  376. package/src/tools/sheets.ts +66 -0
  377. package/src/tools/skills/skill-create.ts +6 -0
  378. package/src/tools/skills/skill-install-remote.ts +6 -0
  379. package/src/tools/skills/skill-sync-remote.ts +9 -0
  380. package/src/tools/skills/skill-update.ts +9 -1
  381. package/src/tools/tool-config.ts +3 -1
  382. package/src/tools/utils.ts +15 -0
  383. package/src/tools/workflows/create-workflow.ts +9 -4
  384. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  385. package/src/tools/workflows/patch-workflow.ts +5 -2
  386. package/src/tools/workflows/update-workflow.ts +13 -7
  387. package/src/types.ts +96 -12
  388. package/src/utils/credentials.ts +36 -1
  389. package/src/utils/egress-guard.ts +40 -10
  390. package/src/utils/error-tracker.ts +17 -0
  391. package/src/workflows/input.ts +12 -5
  392. package/src/workflows/patch-definition.ts +13 -5
  393. package/src/workflows/triggers.ts +11 -6
  394. package/src/workflows/version.ts +7 -1
  395. package/templates/skills/apps/SKILL.md +191 -2
  396. package/templates/skills/apps/content.md +191 -2
  397. package/templates/skills/boards-and-sheets/config.json +14 -0
  398. package/templates/skills/boards-and-sheets/content.md +174 -0
  399. package/templates/skills/pages/content.md +11 -0
  400. package/templates/skills/swarm-docs/content.md +11 -0
  401. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  402. package/templates/skills/swarm-scripts/content.md +1 -0
  403. package/templates/workflows/ralph-loop/content.md +6 -6
  404. package/dist/acp-adapter-11m13kx4.js +0 -16
  405. package/dist/cli-pr0eze3x.js +0 -149
  406. package/dist/core-dxcy02sc.js +0 -41
  407. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  408. package/dist/grok-adapter-t6m74fb1.js +0 -19
  409. package/dist/handlers-9kwcrc4k.js +0 -38
  410. package/dist/heartbeat-p8pk1msj.js +0 -49
  411. package/dist/index-23cdfzr6.js +0 -39
  412. package/dist/index-g7kkjs5b.js +0 -38
  413. package/dist/index-stk36pa5.js +0 -43
  414. package/dist/lead-mfggjtfk.js +0 -77
  415. package/dist/thread-buffer-temgaqsy.js +0 -41
  416. package/dist/worker-efcemc22.js +0 -77
  417. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -147,12 +147,29 @@ export async function getAgentModelTierOverrides(agentId: string): Promise<Model
147
147
  }
148
148
  }
149
149
 
150
+ function storedModelTierOverrides(overrides: ModelTierOverrides): string | null {
151
+ return Object.keys(overrides).length > 0 ? JSON.stringify(overrides) : null;
152
+ }
153
+
154
+ /** Read-only twin of `setAgentModelTierOverrides`: true when that call would write. */
155
+ export async function modelTierOverridesDiffer(
156
+ agentId: string,
157
+ overrides: ModelTierOverrides,
158
+ ): Promise<boolean> {
159
+ const next = storedModelTierOverrides(overrides);
160
+ const row = await getDbClient().get<{ id: string }>(
161
+ "SELECT id FROM agents WHERE id = ? AND modelTierOverrides IS NOT ?",
162
+ [agentId, next],
163
+ );
164
+ return row !== null;
165
+ }
166
+
150
167
  /** Store the worker's overrides; no write when unchanged. Empty object clears. */
151
168
  export async function setAgentModelTierOverrides(
152
169
  agentId: string,
153
170
  overrides: ModelTierOverrides,
154
171
  ): Promise<void> {
155
- const next = Object.keys(overrides).length > 0 ? JSON.stringify(overrides) : null;
172
+ const next = storedModelTierOverrides(overrides);
156
173
  await getDbClient().run(
157
174
  "UPDATE agents SET modelTierOverrides = ? WHERE id = ? AND modelTierOverrides IS NOT ?",
158
175
  [next, agentId, next],
@@ -343,6 +343,23 @@ export async function touchRuntimeInstance(id: string, agentId: string): Promise
343
343
  return result.changes > 0;
344
344
  }
345
345
 
346
+ /**
347
+ * Read-only twin of `touchRuntimeInstance` for the idle poll: true when the
348
+ * runtime is live and was touched within a tenth of the stale threshold
349
+ * (30 s at the 5 min default). Every liveness reader compares against the
350
+ * full threshold, so skipping the touch then changes nothing they see.
351
+ */
352
+ export async function isRuntimeInstanceFresh(id: string, agentId: string): Promise<boolean> {
353
+ const freshCutoff = new Date(Date.now() - runtimeStaleThresholdMinutes() * 6_000).toISOString();
354
+ const row = await getDbClient().get<{ id: string }>(
355
+ `SELECT id FROM runtime_instances
356
+ WHERE id = ? AND agent_id = ? AND status = 'active' AND last_seen_at >= ?
357
+ AND ${WORKSPACE_CONFIRMED_SQL}`,
358
+ [id, agentId, freshCutoff],
359
+ );
360
+ return row !== null;
361
+ }
362
+
346
363
  /** Mark one runtime instance offline (scoped to its agent, like touch). */
347
364
  export async function markRuntimeInstanceOffline(
348
365
  id: string,
@@ -0,0 +1,250 @@
1
+ import { FilesError } from "@/fs/provider";
2
+ import { buildAgentFsLiveUrl } from "@/utils/constants";
3
+ import { agentFsClientFor } from "../agent-fs-identity";
4
+ import { getDbClient, getSwarmConfigs } from "../db";
5
+ import { parseScene } from "./boards/elements";
6
+ import {
7
+ ObjectsError,
8
+ PRIMITIVE_KINDS,
9
+ type PrimitiveObject,
10
+ recordObjectVersion,
11
+ } from "./objects";
12
+ import { appendSheetRows, type CellInput, clearSheetRange, setSheetRange } from "./sheets/service";
13
+ import { MAX_OBJECT_BYTES } from "./write-object";
14
+
15
+ /**
16
+ * Objects for people: the embed routes (src/http/objects.ts) read and save a
17
+ * board or sheet on behalf of a dashboard or page viewer. Swarm RBAC is the
18
+ * gate; agent-fs sees the object's owner agent as the writer, with its own
19
+ * key. Only objects on the swarm's shared drive are reachable, where agents
20
+ * are already editors, so a viewer cannot reach an agent's private drive.
21
+ */
22
+
23
+ type Json = Record<string, unknown>;
24
+ type Row = Omit<PrimitiveObject, "link">;
25
+
26
+ /** A refusal with the HTTP status the route returns. */
27
+ export class ObjectEmbedError extends Error {
28
+ constructor(
29
+ readonly status: 400 | 403 | 404 | 409 | 413 | 503,
30
+ message: string,
31
+ /** The file's current agent-fs version, on a 409. */
32
+ readonly version?: number | null,
33
+ ) {
34
+ super(message);
35
+ }
36
+ }
37
+
38
+ /** Who saves through an embed: the agent-fs commit message and `updated_by`. */
39
+ export type EmbedActor = { via: "app" | "page"; userId: string | null; name: string | null };
40
+
41
+ const versionOf = (value: string | null | undefined): number | null =>
42
+ value && Number.isFinite(Number(value)) ? Number(value) : null;
43
+
44
+ /** The swarm's shared drive, resolved like agent-fs provisioning does: global config, then env. */
45
+ async function sharedDrive(): Promise<{ orgId: string; driveId: string } | null> {
46
+ const value = async (key: string) =>
47
+ (await getSwarmConfigs({ scope: "global", key }))[0]?.value?.trim() || process.env[key]?.trim();
48
+ const orgId = (await value("AGENT_FS_DEFAULT_ORG_ID")) || (await value("AGENT_FS_SHARED_ORG_ID"));
49
+ const driveId = await value("AGENT_FS_DEFAULT_DRIVE_ID");
50
+ return orgId && driveId ? { orgId, driveId } : null;
51
+ }
52
+
53
+ /** Look up the object, check its drive, and open an agent-fs client as its owner agent. */
54
+ async function open(id: string) {
55
+ const row = await getDbClient().get<Row>("SELECT * FROM primitive_objects WHERE id = ?", [id]);
56
+ if (!row) throw new ObjectEmbedError(404, `no object with id '${id}'`);
57
+ const shared = await sharedDrive();
58
+ if (!shared || shared.orgId !== row.orgId || shared.driveId !== row.driveId) {
59
+ throw new ObjectEmbedError(403, "this object is not on the swarm's shared agent-fs drive");
60
+ }
61
+ if (row.deletedAt) throw new ObjectEmbedError(404, `object '${id}' was deleted on agent-fs`);
62
+ const client = row.ownerAgentId ? await agentFsClientFor(row.ownerAgentId) : undefined;
63
+ if (!client || !row.ownerAgentId) {
64
+ throw new ObjectEmbedError(503, "owner agent has no agent-fs key");
65
+ }
66
+ if (client.identity.orgId !== row.orgId || client.identity.driveId !== row.driveId) {
67
+ throw new ObjectEmbedError(
68
+ 503,
69
+ "owner agent's default agent-fs drive is not the object's drive",
70
+ );
71
+ }
72
+ const scope = { taskId: "", name: "", key: row.path, orgId: row.orgId, driveId: row.driveId };
73
+ return { row, owner: row.ownerAgentId, provider: client.provider, scope };
74
+ }
75
+
76
+ const withLink = (row: Row): PrimitiveObject => ({ ...row, link: buildAgentFsLiveUrl(row) });
77
+
78
+ /** agent-fs keeps this drive's rows fresh through `file.changed` (object-webhooks.ts). */
79
+ async function driveWatched(orgId: string, driveId: string): Promise<boolean> {
80
+ const hook = await getDbClient().get<{ status: string }>(
81
+ "SELECT status FROM agent_fs_object_webhooks WHERE orgId = ? AND driveId = ?",
82
+ [orgId, driveId],
83
+ );
84
+ return hook?.status === "active";
85
+ }
86
+
87
+ /** The row records the person behind the last save; a save with no person clears it. */
88
+ async function recordEditor(id: string, userId: string | null): Promise<void> {
89
+ await getDbClient().run("UPDATE primitive_objects SET updated_by = ? WHERE id = ?", [userId, id]);
90
+ }
91
+
92
+ /** Service refusals become 400, except the CAS give-up, which is a 409 the caller retries. */
93
+ function asEmbedError(error: unknown): unknown {
94
+ if (!(error instanceof ObjectsError)) return error;
95
+ // The sheet and object services raise this one refusal after their last 409 retry.
96
+ const status = error.message.startsWith("concurrent writers") ? 409 : 400;
97
+ return new ObjectEmbedError(status, error.message);
98
+ }
99
+
100
+ export type ObjectRead =
101
+ | { object: PrimitiveObject; version: number | null; unchanged: true }
102
+ | { object: PrimitiveObject; version: number | null; unchanged: false; content: unknown };
103
+
104
+ /**
105
+ * Read an object with its content. With `knownVersion`, answer `unchanged`
106
+ * without a download when the file is still at that version: from the row
107
+ * alone when webhooks keep it fresh, else from one agent-fs `stat`.
108
+ */
109
+ export async function readObject(id: string, knownVersion?: number): Promise<ObjectRead> {
110
+ const { row, provider, scope } = await open(id);
111
+ if (knownVersion !== undefined) {
112
+ if (row.fileVersion === knownVersion && (await driveWatched(row.orgId, row.driveId))) {
113
+ return { object: withLink(row), version: knownVersion, unchanged: true };
114
+ }
115
+ let current: number | null = null;
116
+ try {
117
+ current = await provider.currentVersion(scope);
118
+ } catch (error) {
119
+ if (error instanceof FilesError && error.code === "Unauthorized") throw error;
120
+ // No stat (older agent-fs, a flaky call): fall through to a full read.
121
+ }
122
+ if (current !== null && current === knownVersion) {
123
+ return { object: withLink(row), version: current, unchanged: true };
124
+ }
125
+ }
126
+ let response: Response;
127
+ try {
128
+ response = await provider.download(scope);
129
+ } catch (error) {
130
+ if (error instanceof FilesError && error.code === "NotFound") {
131
+ throw new ObjectEmbedError(404, `the file for object '${id}' is missing on agent-fs`);
132
+ }
133
+ throw error;
134
+ }
135
+ const version = versionOf(response.headers.get("x-agent-fs-version")) ?? row.fileVersion;
136
+ const text = await response.text();
137
+ let content: unknown = text;
138
+ try {
139
+ content = JSON.parse(text);
140
+ } catch {
141
+ // Not JSON (a hand-edited file): return the raw text.
142
+ }
143
+ return { object: withLink({ ...row, fileVersion: version }), version, unchanged: false, content };
144
+ }
145
+
146
+ /**
147
+ * Replace a board's scene, guarded by `ifMatch`. No re-read and re-apply: a
148
+ * full scene from an editor cannot merge, so a 409 hands back the current
149
+ * version and the editor decides. The write keeps `swarm.id` and the title.
150
+ */
151
+ export async function saveBoardContent(input: {
152
+ id: string;
153
+ content: unknown;
154
+ ifMatch: number;
155
+ actor: EmbedActor;
156
+ }): Promise<{ object: PrimitiveObject; version: number | null }> {
157
+ const { row, provider, scope } = await open(input.id);
158
+ if (row.kind !== "board") {
159
+ throw new ObjectEmbedError(
160
+ 400,
161
+ `object ${row.id} is a ${row.kind}; only a board takes a full save`,
162
+ );
163
+ }
164
+ let scene: Json;
165
+ try {
166
+ scene = parseScene(input.content, row.path);
167
+ } catch (error) {
168
+ throw asEmbedError(error);
169
+ }
170
+ if (scene.type !== undefined && scene.type !== "excalidraw") {
171
+ throw new ObjectEmbedError(
172
+ 400,
173
+ "content is not an Excalidraw scene (type must be 'excalidraw')",
174
+ );
175
+ }
176
+ const doc = PRIMITIVE_KINDS.board?.withId(scene, row.id) ?? scene;
177
+ const swarm = doc.swarm as Json;
178
+ if (swarm.title === undefined && row.title) swarm.title = row.title;
179
+ const body = JSON.stringify(doc, null, 2);
180
+ if (Buffer.byteLength(body) > MAX_OBJECT_BYTES) {
181
+ throw new ObjectEmbedError(
182
+ 413,
183
+ `the board would exceed ${MAX_OBJECT_BYTES} bytes; nothing written`,
184
+ );
185
+ }
186
+ let written: { version?: string };
187
+ try {
188
+ written = await provider.upload(scope, body, {
189
+ contentType: "application/json",
190
+ ifMatch: String(input.ifMatch),
191
+ message: `edit via ${input.actor.via} by ${input.actor.name ?? "operator"}`,
192
+ });
193
+ } catch (error) {
194
+ if (!(error instanceof FilesError && error.code === "Conflict")) throw error;
195
+ const current = await provider.currentVersion(scope).catch(() => null);
196
+ throw new ObjectEmbedError(
197
+ 409,
198
+ `the board changed on agent-fs since version ${input.ifMatch}; reload it`,
199
+ current,
200
+ );
201
+ }
202
+ const version = versionOf(written.version);
203
+ await recordObjectVersion(row.id, version);
204
+ await recordEditor(row.id, input.actor.userId);
205
+ return { object: withLink({ ...row, fileVersion: version }), version };
206
+ }
207
+
208
+ export type SheetOp =
209
+ | { op: "setRange"; range: string; values: CellInput[][] }
210
+ | { op: "clearRange"; range: string }
211
+ | { op: "appendRows"; tab: string; rows: CellInput[][] };
212
+
213
+ export type SheetOpResult = {
214
+ op: SheetOp["op"];
215
+ range: string;
216
+ version: number;
217
+ changed?: number;
218
+ recalculated?: number;
219
+ cleared?: number;
220
+ };
221
+
222
+ /** Run one cell patch through the sheet service (server-side recalc, CAS retry) as the owner. */
223
+ export async function applySheetOp(input: {
224
+ id: string;
225
+ op: SheetOp;
226
+ actor: EmbedActor;
227
+ }): Promise<SheetOpResult> {
228
+ const { row, owner } = await open(input.id);
229
+ if (row.kind !== "sheet") {
230
+ throw new ObjectEmbedError(400, `object ${row.id} is a ${row.kind}, not a sheet`);
231
+ }
232
+ const target = { agentId: owner, id: row.id };
233
+ const { op } = input;
234
+ let result: Omit<SheetOpResult, "op">;
235
+ try {
236
+ if (op.op === "setRange") {
237
+ result = await setSheetRange({ ...target, range: op.range, values: op.values });
238
+ } else if (op.op === "clearRange") {
239
+ result = await clearSheetRange({ ...target, range: op.range });
240
+ } else {
241
+ result = await appendSheetRows({ ...target, tab: op.tab, rows: op.rows });
242
+ }
243
+ } catch (error) {
244
+ throw asEmbedError(error);
245
+ }
246
+ // shortcut: the agent-fs commit message stays the sheet service's `sheet <op>`; pass the
247
+ // actor through mutate() when the history view needs who edited a sheet.
248
+ await recordEditor(row.id, input.actor.userId);
249
+ return { op: op.op, ...result };
250
+ }
@@ -124,7 +124,7 @@ function kindFor(kind: string): PrimitiveKind {
124
124
  return def;
125
125
  }
126
126
 
127
- function normalizePath(path: string): string {
127
+ export function normalizePath(path: string): string {
128
128
  try {
129
129
  return normalizeStoredKey(path);
130
130
  } catch (error) {
@@ -345,11 +345,17 @@ export type ReindexReport = {
345
345
  truncated: boolean;
346
346
  /** Which limit cut this call short; null when the pass finished. */
347
347
  cutBy: "files" | "reads" | "time" | "bytes" | null;
348
+ /** True when nothing was written: `adopted` and `restored` list what a real run would change. */
349
+ dryRun: boolean;
348
350
  };
349
351
 
350
352
  export async function reindexObjects(input: {
351
353
  agentId: string | undefined;
352
354
  kind?: string;
355
+ /** Only files whose path starts with this (same match as object-list `prefix`). */
356
+ prefix?: string;
357
+ /** Report what would change; write no file and no row. */
358
+ dryRun?: boolean;
353
359
  /** Override the per-call budget (tests). */
354
360
  limits?: Partial<ReindexLimits>;
355
361
  }): Promise<ReindexReport> {
@@ -364,11 +370,14 @@ export async function reindexObjects(input: {
364
370
  }
365
371
  reindexing.add(lock);
366
372
  try {
367
- const report = await reindexDrive(client, kinds, input.agentId, {
368
- ...REINDEX_LIMITS,
369
- ...input.limits,
370
- });
371
- watchDrive(client.orgId, client.driveId);
373
+ const report = await reindexDrive(
374
+ client,
375
+ kinds,
376
+ input.agentId,
377
+ { ...REINDEX_LIMITS, ...input.limits },
378
+ { prefix: input.prefix?.replace(/^\/+/, "") ?? "", dryRun: input.dryRun === true },
379
+ );
380
+ if (!report.dryRun) watchDrive(client.orgId, client.driveId);
372
381
  return report;
373
382
  } finally {
374
383
  reindexing.delete(lock);
@@ -380,6 +389,7 @@ async function reindexDrive(
380
389
  kinds: string[],
381
390
  agentId: string | undefined,
382
391
  limits: ReindexLimits,
392
+ { prefix, dryRun }: { prefix: string; dryRun: boolean },
383
393
  ): Promise<ReindexReport> {
384
394
  const db = getDbClient();
385
395
  const report: ReindexReport = {
@@ -391,7 +401,9 @@ async function reindexDrive(
391
401
  conflicts: [],
392
402
  truncated: false,
393
403
  cutBy: null,
404
+ dryRun,
394
405
  };
406
+ const inScope = (path: string) => path.startsWith(prefix);
395
407
  const startedAt = Date.now();
396
408
  let reads = 0;
397
409
  let bytes = 0;
@@ -404,8 +416,10 @@ async function reindexDrive(
404
416
  if (report.truncated) break;
405
417
  const kind = kindFor(kindName);
406
418
  const all = (await provider.glob(kind.glob)).map((p) => p.replace(/^\/+/, ""));
407
- const paths = all.slice(0, MAX_REINDEX_FILES - report.scanned);
408
- if (paths.length < all.length) cut("files");
419
+ const scoped = all.filter(inScope);
420
+ const paths = scoped.slice(0, MAX_REINDEX_FILES - report.scanned);
421
+ if (paths.length < scoped.length) cut("files");
422
+ // The whole drive, not just the prefix: a copy inside the prefix of a file outside it is still a copy.
409
423
  const onDrive = new Set(all);
410
424
  // Ids already given to a file in this pass: a copied file must not steal one.
411
425
  const claimed = new Map<string, string>();
@@ -473,6 +487,11 @@ async function reindexDrive(
473
487
  // Stock Excalidraw save (id dropped) or a copy: keep the path's id, else a new one.
474
488
  const embedded = kind.readId(json);
475
489
  id = atPath && atPath.id !== embedded ? atPath.id : crypto.randomUUID();
490
+ if (dryRun) {
491
+ report.adopted.push(path);
492
+ claimed.set(id, path);
493
+ continue;
494
+ }
476
495
  try {
477
496
  ({ version = null } = await provider.upload(
478
497
  scope(path),
@@ -494,6 +513,7 @@ async function reindexDrive(
494
513
  }
495
514
 
496
515
  claimed.set(id, path);
516
+ if (dryRun) continue;
497
517
  const title = swarmBlock(json).title;
498
518
  await saveRow({
499
519
  id,
@@ -512,7 +532,7 @@ async function reindexDrive(
512
532
  "SELECT path FROM primitive_objects WHERE orgId = ? AND driveId = ? AND kind = ? ORDER BY path",
513
533
  [orgId, driveId, kindName],
514
534
  );
515
- report.missing.push(...rows.map((r) => r.path).filter((p) => !onDrive.has(p)));
535
+ report.missing.push(...rows.map((r) => r.path).filter((p) => inScope(p) && !onDrive.has(p)));
516
536
  }
517
537
  }
518
538
  return report;
@@ -1,11 +1,14 @@
1
1
  import { FilesError } from "@/fs/provider";
2
+ import { buildAgentFsLiveUrl } from "@/utils/constants";
2
3
  import { agentFsClientFor } from "../../agent-fs-identity";
3
4
  import { getDbClient } from "../../db";
4
5
  import {
6
+ clientFor,
5
7
  createObject,
6
8
  getObject,
7
9
  listObjects,
8
10
  NO_AGENT_FS_IDENTITY,
11
+ normalizePath,
9
12
  ObjectsError,
10
13
  type PrimitiveObject,
11
14
  } from "../objects";
@@ -24,6 +27,7 @@ import type { EnginePatch } from "./engine-worker";
24
27
  import {
25
28
  checkTabName,
26
29
  constantInput,
30
+ emptySheet,
27
31
  MAX_CELLS,
28
32
  MAX_FILE_BYTES,
29
33
  MAX_RANGE_CELLS,
@@ -34,6 +38,7 @@ import {
34
38
  type SheetTab,
35
39
  usedExtent,
36
40
  } from "./format";
41
+ import { buildXlsx, MAX_XLSX_BYTES, parseXlsx, XLSX_MIME } from "./xlsx";
37
42
 
38
43
  /** One sheet call: the caller and the file, by `id` or `path`. */
39
44
  export type SheetTarget = { agentId: string | undefined; id?: string; path?: string };
@@ -53,6 +58,16 @@ const refuse = <T>(run: () => T): T => {
53
58
  }
54
59
  };
55
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
+
56
71
  async function load(target: SheetTarget) {
57
72
  const { object, missing, content } = await getObject({ ...target, includeContent: true });
58
73
  if (object.kind !== "sheet") {
@@ -65,7 +80,16 @@ async function load(target: SheetTarget) {
65
80
  }
66
81
  const parsed = SheetDocSchema.safeParse(content);
67
82
  if (!parsed.success) {
68
- const issue = parsed.error.issues[0];
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];
69
93
  throw new ObjectsError(
70
94
  `${object.path} is not a valid swarm-sheet/1 workbook: ${issue?.path.join(".") || "document"}: ${issue?.message}`,
71
95
  );
@@ -76,6 +100,15 @@ async function load(target: SheetTarget) {
76
100
  return { object, version: object.fileVersion, doc: parsed.data };
77
101
  }
78
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
+
79
112
  async function save(
80
113
  agentId: string | undefined,
81
114
  object: PrimitiveObject,
@@ -83,10 +116,7 @@ async function save(
83
116
  version: number,
84
117
  op: string,
85
118
  ) {
86
- const body = JSON.stringify(doc, null, 2);
87
- if (Buffer.byteLength(body) > MAX_FILE_BYTES) {
88
- throw new ObjectsError(`the sheet would exceed ${MAX_FILE_BYTES} bytes (5 MiB)`);
89
- }
119
+ const body = sheetBody(doc);
90
120
  const client = agentId ? await agentFsClientFor(agentId) : undefined;
91
121
  if (!client) throw new ObjectsError(NO_AGENT_FS_IDENTITY);
92
122
  const { orgId, driveId } = client.identity;
@@ -152,7 +182,11 @@ function inputFor(value: CellInput): string {
152
182
  }
153
183
 
154
184
  /** Recalculate `doc` with `patches` and report which cells moved. */
155
- async function recalc(agentId: string | undefined, doc: SheetDoc, patches: EnginePatch[]) {
185
+ async function recalc(
186
+ agentId: string | undefined,
187
+ doc: Pick<SheetDoc, "tabs">,
188
+ patches: EnginePatch[],
189
+ ) {
156
190
  const { cells, changed } = await sheetEngine().recalc(doc.tabs, patches, {
157
191
  maxCells: MAX_CELLS,
158
192
  caller: agentId,
@@ -413,3 +447,101 @@ export async function addSheetTab(target: SheetTarget & { name: string; after?:
413
447
  });
414
448
  return { ...result, version };
415
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
+ }