@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,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
+ }
@@ -0,0 +1,348 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { AgentFsProvider } from "@/fs/agent-fs-provider";
3
+ import { type FileScope, FilesError } from "@/fs/provider";
4
+ import { getPublicMcpBaseUrl } from "@/utils/constants";
5
+ import { registerVolatileSecret, scrubSecrets } from "@/utils/secret-scrubber";
6
+ import { getEncryptionKey } from "../crypto/key-bootstrap";
7
+ import { decryptSecret, encryptSecret } from "../crypto/secrets-cipher";
8
+ import { getDbClient } from "../db";
9
+ import {
10
+ AgentFsRequestError,
11
+ agentFsRequest,
12
+ resolveAgentFsServiceCredentials,
13
+ } from "../seed/agent-fs-provision";
14
+ import { applyFileChange, type FileChangeResult } from "./objects";
15
+
16
+ /**
17
+ * Keeps `primitive_objects` in sync with agent-fs: one signed `file.changed`
18
+ * webhook per drive that holds objects, registered with the API's own
19
+ * agent-fs key (org admin; agents are only drive editors). Everything here is
20
+ * best-effort. Without agent-fs, a base URL agent-fs accepts or a
21
+ * webhook-capable agent-fs, objects still work and object-reindex is the fallback.
22
+ */
23
+
24
+ /** Receiver route: `POST /api/objects/agent-fs-webhook/{id}`, id = row id. */
25
+ export const OBJECT_WEBHOOK_PATH = "/api/objects/agent-fs-webhook/";
26
+
27
+ const SECRET_NAME = "AGENT_FS_OBJECT_WEBHOOK_SECRET";
28
+ // A replica that claimed registration and died frees the claim after this.
29
+ const LEASE_MS = 2 * 60_000;
30
+ // A failed registration is retried no sooner than this (next object call or boot).
31
+ const RETRY_AFTER_MS = 60 * 60_000;
32
+ // shortcut: boot re-checks at most this many drives; page when a swarm has more.
33
+ const MAX_BOOT_DRIVES = 50;
34
+
35
+ type HookRow = {
36
+ id: string;
37
+ orgId: string;
38
+ driveId: string;
39
+ subscriptionId: string | null;
40
+ url: string | null;
41
+ secretCiphertext: string | null;
42
+ status: "pending" | "active" | "failed";
43
+ lastError: string | null;
44
+ claimedAt: string | null;
45
+ attemptedAt: string | null;
46
+ };
47
+
48
+ type ServiceCredentials = { apiUrl: string; apiKey: string; orgId: string };
49
+
50
+ export type EnsureResult = {
51
+ status: "active" | "registered" | "skipped" | "busy" | "failed";
52
+ reason?: string;
53
+ };
54
+
55
+ const warned = new Set<string>();
56
+
57
+ /** One warning per drive and reason per process, so a broken setup does not flood logs. */
58
+ function warnOnce(driveId: string, reason: string): void {
59
+ const key = `${driveId}\u0000${reason}`;
60
+ if (warned.has(key)) return;
61
+ warned.add(key);
62
+ console.warn(
63
+ `[objects] agent-fs webhook for drive ${driveId} not registered: ${reason}. object-reindex keeps objects in sync.`,
64
+ );
65
+ }
66
+
67
+ const errorText = (error: unknown) =>
68
+ scrubSecrets(error instanceof Error ? error.message : String(error));
69
+
70
+ const asRecord = (value: unknown): Record<string, unknown> =>
71
+ value && typeof value === "object" && !Array.isArray(value)
72
+ ? (value as Record<string, unknown>)
73
+ : {};
74
+
75
+ /**
76
+ * Make sure agent-fs sends this drive's `file.changed` events to the swarm.
77
+ * Idempotent across calls, boots and replicas: one row per drive, one replica
78
+ * holds the registration claim, and an existing swarm hook on the drive is
79
+ * reused instead of creating another. Never throws.
80
+ */
81
+ export async function ensureObjectWebhook(orgId: string, driveId: string): Promise<EnsureResult> {
82
+ try {
83
+ return await ensure(orgId, driveId);
84
+ } catch (error) {
85
+ const reason = errorText(error);
86
+ warnOnce(driveId, reason);
87
+ return { status: "failed", reason };
88
+ }
89
+ }
90
+
91
+ /** Boot pass over every drive that already holds objects. Never throws. */
92
+ export async function ensureObjectWebhooksForKnownDrives(): Promise<EnsureResult[]> {
93
+ try {
94
+ const drives = await getDbClient().query<{ orgId: string; driveId: string }>(
95
+ "SELECT DISTINCT orgId, driveId FROM primitive_objects ORDER BY orgId, driveId LIMIT ?",
96
+ [MAX_BOOT_DRIVES],
97
+ );
98
+ const results: EnsureResult[] = [];
99
+ for (const { orgId, driveId } of drives) {
100
+ results.push(await ensureObjectWebhook(orgId, driveId));
101
+ }
102
+ return results;
103
+ } catch (error) {
104
+ console.warn(`[objects] agent-fs webhook boot check failed: ${errorText(error)}`);
105
+ return [];
106
+ }
107
+ }
108
+
109
+ function skipped(driveId: string, reason: string): EnsureResult {
110
+ warnOnce(driveId, reason);
111
+ return { status: "skipped", reason };
112
+ }
113
+
114
+ async function ensure(orgId: string, driveId: string): Promise<EnsureResult> {
115
+ // agent-fs decides whether it can reach this URL: public https, or a host
116
+ // in its AGENT_FS_WEBHOOK_ALLOWED_HOSTS. A refusal fails once and retries later.
117
+ const base = getPublicMcpBaseUrl();
118
+ const service = await resolveAgentFsServiceCredentials();
119
+ if (!service) {
120
+ return skipped(driveId, "the API has no agent-fs URL, service key or org configured");
121
+ }
122
+ if (service.orgId !== orgId) {
123
+ return skipped(driveId, "the drive is outside the swarm's agent-fs org");
124
+ }
125
+
126
+ const db = getDbClient();
127
+ const now = Date.now();
128
+ const nowIso = new Date(now).toISOString();
129
+ await db.run(
130
+ `INSERT INTO agent_fs_object_webhooks (id, orgId, driveId, status, createdAt, updatedAt)
131
+ VALUES (?, ?, ?, 'pending', ?, ?) ON CONFLICT(orgId, driveId) DO NOTHING`,
132
+ [randomUUID(), orgId, driveId, nowIso, nowIso],
133
+ );
134
+ const row = await db.get<HookRow>(
135
+ "SELECT * FROM agent_fs_object_webhooks WHERE orgId = ? AND driveId = ?",
136
+ [orgId, driveId],
137
+ );
138
+ if (!row) throw new Error("webhook row vanished after insert");
139
+ const url = `${base}${OBJECT_WEBHOOK_PATH}${row.id}`;
140
+ if (row.status === "active" && row.url === url && row.secretCiphertext) {
141
+ return { status: "active" };
142
+ }
143
+
144
+ // One replica registers. A lapsed lease or an old failure frees the claim.
145
+ const { changes } = await db.run(
146
+ `UPDATE agent_fs_object_webhooks SET claimedAt = ?
147
+ WHERE id = ? AND (claimedAt IS NULL OR claimedAt < ?)
148
+ AND NOT (status = 'failed' AND attemptedAt > ?)`,
149
+ [
150
+ nowIso,
151
+ row.id,
152
+ new Date(now - LEASE_MS).toISOString(),
153
+ new Date(now - RETRY_AFTER_MS).toISOString(),
154
+ ],
155
+ );
156
+ if (changes === 0) {
157
+ return {
158
+ status: "busy",
159
+ reason:
160
+ row.status === "failed"
161
+ ? `last attempt failed (${row.lastError ?? "unknown"}); retrying later`
162
+ : "another replica is registering",
163
+ };
164
+ }
165
+
166
+ const doneIso = new Date().toISOString();
167
+ try {
168
+ const { subscriptionId, secret } = await register(service, row, base, url);
169
+ registerVolatileSecret(secret, SECRET_NAME);
170
+ await db.run(
171
+ `UPDATE agent_fs_object_webhooks
172
+ SET subscriptionId = ?, url = ?, secretCiphertext = ?, status = 'active',
173
+ lastError = NULL, claimedAt = NULL, attemptedAt = ?, updatedAt = ?
174
+ WHERE id = ?`,
175
+ [subscriptionId, url, encryptSecret(secret, getEncryptionKey()), doneIso, doneIso, row.id],
176
+ );
177
+ console.log(`[objects] agent-fs webhook registered for drive ${driveId}`);
178
+ return { status: "registered" };
179
+ } catch (error) {
180
+ const reason = errorText(error);
181
+ // The stored secret stays: deliveries to the old URL still verify.
182
+ await db.run(
183
+ `UPDATE agent_fs_object_webhooks
184
+ SET status = 'failed', lastError = ?, claimedAt = NULL, attemptedAt = ?, updatedAt = ?
185
+ WHERE id = ?`,
186
+ [reason, doneIso, doneIso, row.id],
187
+ );
188
+ warnOnce(driveId, reason);
189
+ return { status: "failed", reason };
190
+ }
191
+ }
192
+
193
+ /**
194
+ * Register or update the drive's hook. Reuses, in order: the subscription
195
+ * this row registered, then any swarm hook on the drive under this base URL
196
+ * (left by a lost row or an old row id). Creates one only when neither exists.
197
+ */
198
+ async function register(
199
+ service: ServiceCredentials,
200
+ row: HookRow,
201
+ base: string,
202
+ url: string,
203
+ ): Promise<{ subscriptionId: string; secret: string }> {
204
+ const ops = async (body: Record<string, unknown>) =>
205
+ asRecord(
206
+ await agentFsRequest(service.apiUrl, `/orgs/${encodeURIComponent(service.orgId)}/ops`, {
207
+ method: "POST",
208
+ headers: { authorization: `Bearer ${service.apiKey}` },
209
+ body: { driveId: row.driveId, ...body },
210
+ }),
211
+ );
212
+ const settings = { url, eventTypes: ["file.changed"] };
213
+
214
+ let existingId = row.subscriptionId;
215
+ if (!existingId) {
216
+ const { webhooks } = await ops({ op: "webhook-list", scope: "drive" });
217
+ const ours = (Array.isArray(webhooks) ? webhooks : [])
218
+ .map(asRecord)
219
+ .find(
220
+ (hook) =>
221
+ typeof hook.url === "string" && hook.url.startsWith(`${base}${OBJECT_WEBHOOK_PATH}`),
222
+ );
223
+ existingId = typeof ours?.id === "string" ? ours.id : null;
224
+ }
225
+
226
+ if (existingId) {
227
+ const knownSecret =
228
+ existingId === row.subscriptionId && row.secretCiphertext
229
+ ? readSecret(row.secretCiphertext)
230
+ : null;
231
+ try {
232
+ const updated = await ops({
233
+ op: "webhook-update",
234
+ id: existingId,
235
+ ...settings,
236
+ enabled: true,
237
+ ...(knownSecret ? {} : { rotateSecret: true }),
238
+ });
239
+ const secret = typeof updated.secret === "string" ? updated.secret : knownSecret;
240
+ if (!secret) throw new Error("agent-fs webhook-update returned no signing secret");
241
+ return { subscriptionId: existingId, secret };
242
+ } catch (error) {
243
+ // Deleted on the agent-fs side: create a new one below.
244
+ if (!(error instanceof AgentFsRequestError && error.status === 404)) throw error;
245
+ }
246
+ }
247
+
248
+ const created = await ops({
249
+ op: "webhook-create",
250
+ scope: "drive",
251
+ ...settings,
252
+ description: "agent-swarm: keeps object pointers in sync",
253
+ });
254
+ if (typeof created.id !== "string" || typeof created.secret !== "string") {
255
+ throw new Error("agent-fs webhook-create returned no id or signing secret");
256
+ }
257
+ return { subscriptionId: created.id, secret: created.secret };
258
+ }
259
+
260
+ function readSecret(ciphertext: string): string | null {
261
+ try {
262
+ const secret = decryptSecret(ciphertext, getEncryptionKey());
263
+ registerVolatileSecret(secret, SECRET_NAME);
264
+ return secret;
265
+ } catch {
266
+ // Encryption key changed: the caller rotates the secret.
267
+ return null;
268
+ }
269
+ }
270
+
271
+ /** The signing secret for a receiver row, or null when the row is unknown or not registered. */
272
+ export async function objectWebhookSecret(
273
+ hookId: string,
274
+ ): Promise<{ secret: string; orgId: string; driveId: string } | null> {
275
+ const row = await getDbClient().get<HookRow>(
276
+ "SELECT * FROM agent_fs_object_webhooks WHERE id = ?",
277
+ [hookId],
278
+ );
279
+ if (!row?.secretCiphertext) return null;
280
+ const secret = readSecret(row.secretCiphertext);
281
+ return secret ? { secret, orgId: row.orgId, driveId: row.driveId } : null;
282
+ }
283
+
284
+ export type ObjectWebhookOutcome =
285
+ | { status: 200; result: FileChangeResult }
286
+ | { status: 400 | 503; error: string };
287
+
288
+ /**
289
+ * Handle one verified delivery body. 200 for every event the swarm has
290
+ * settled (applied or ignored); 503 when agent-fs could not be read, so
291
+ * agent-fs retries the delivery.
292
+ */
293
+ export async function handleObjectWebhookEvent(
294
+ hook: { orgId: string; driveId: string },
295
+ envelope: unknown,
296
+ ): Promise<ObjectWebhookOutcome> {
297
+ const { type, data: rawData } = asRecord(envelope);
298
+ if (type !== "file.changed") {
299
+ return {
300
+ status: 200,
301
+ result: { action: "ignored", path: "", reason: `event ${String(type)}` },
302
+ };
303
+ }
304
+ const data = asRecord(rawData);
305
+ const { path, version, operation } = data;
306
+ if (typeof path !== "string" || typeof operation !== "string" || !Number.isSafeInteger(version)) {
307
+ return { status: 400, error: "file.changed data needs path, version and operation" };
308
+ }
309
+ if (data.orgId !== hook.orgId || data.driveId !== hook.driveId) {
310
+ return {
311
+ status: 200,
312
+ result: { action: "ignored", path, reason: "event for another drive than this hook" },
313
+ };
314
+ }
315
+
316
+ const service = await resolveAgentFsServiceCredentials();
317
+ const provider = service
318
+ ? new AgentFsProvider({ ...service, orgId: hook.orgId, driveId: hook.driveId })
319
+ : null;
320
+ const scope = (filePath: string): FileScope => ({
321
+ taskId: "",
322
+ name: "",
323
+ key: filePath,
324
+ orgId: hook.orgId,
325
+ driveId: hook.driveId,
326
+ });
327
+ const noService = () =>
328
+ new FilesError("Provider", "the API has no agent-fs service key to read the file");
329
+ try {
330
+ const result = await applyFileChange(
331
+ { orgId: hook.orgId, driveId: hook.driveId, path, version: version as number, operation },
332
+ {
333
+ download: async (filePath) => {
334
+ if (!provider) throw noService();
335
+ return provider.download(scope(filePath));
336
+ },
337
+ exists: async (filePath) => {
338
+ if (!provider) throw noService();
339
+ return provider.exists(scope(filePath));
340
+ },
341
+ },
342
+ );
343
+ return { status: 200, result };
344
+ } catch (error) {
345
+ if (error instanceof FilesError) return { status: 503, error: errorText(error) };
346
+ throw error;
347
+ }
348
+ }