@desplega.ai/agent-swarm 2.12.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 (327) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-86f0sh6g.js} +9 -8
  3. package/dist/{actions-c4chgxp6.js → actions-zv8vcxvr.js} +24 -23
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-jqshb33y.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-gt503ywc.js} +2 -2
  6. package/dist/{app-hn5fftf5.js → app-6t4k5rh1.js} +6 -4
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-fcfw063h.js} +7 -6
  8. package/dist/{assistant-cpjgpjvp.js → assistant-9dzybh12.js} +25 -24
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-h3mp9hgs.js} +7 -6
  15. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-kpbyj2vb.js} +3 -3
  16. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-0efr3wkg.js} +5 -5
  17. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-03dw669q.js} +7 -6
  18. package/dist/{cli-e3ahxq5y.js → cli-0b655smz.js} +4 -4
  19. package/dist/{cli-mcymtvwn.js → cli-0dg7ytxm.js} +89 -11
  20. package/dist/cli-0jkenasr.js +148 -0
  21. package/dist/{cli-c7j31hq9.js → cli-0pazkmd4.js} +3 -3
  22. package/dist/{cli-5tg94mdw.js → cli-117g15t4.js} +8 -11
  23. package/dist/{cli-r14ac1y0.js → cli-1dbv9mj9.js} +1 -1
  24. package/dist/{cli-q8tc22bj.js → cli-1v82d2w6.js} +3 -3
  25. package/dist/{cli-pe3yxedk.js → cli-2jk4s7z1.js} +2 -2
  26. package/dist/{cli-0pp1yjg2.js → cli-2skf1mdf.js} +8 -8
  27. package/dist/{cli-2tw284hj.js → cli-48nvk6sb.js} +1 -1
  28. package/dist/{cli-en6dmkxd.js → cli-49f5jyhh.js} +2 -2
  29. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  30. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  31. package/dist/{cli-yegz2g06.js → cli-6h88mn9q.js} +3 -3
  32. package/dist/{cli-52nfye5j.js → cli-7dbhnsj9.js} +23 -15
  33. package/dist/{cli-04zc3f7b.js → cli-9fsagra4.js} +1 -1
  34. package/dist/{cli-nja15knq.js → cli-9m9kyw77.js} +3 -3
  35. package/dist/{cli-k5jx8jya.js → cli-ajjvqhf3.js} +1 -1
  36. package/dist/{cli-hbvgzjq4.js → cli-avqkr20b.js} +2 -2
  37. package/dist/{cli-yfpc6qy9.js → cli-avxh26pd.js} +46 -15
  38. package/dist/{cli-q2dywc8h.js → cli-b2jh3dyb.js} +4 -4
  39. package/dist/{cli-m5qtmrbc.js → cli-c8v2yvej.js} +2 -2
  40. package/dist/{cli-gfy6hbd9.js → cli-ct8sz3np.js} +17 -10
  41. package/dist/{cli-bz97ff9n.js → cli-dka73bak.js} +1 -1
  42. package/dist/{cli-dkvtfgn4.js → cli-dkejt425.js} +75 -16
  43. package/dist/{cli-sv2r3bw8.js → cli-dnh64e8e.js} +2 -2
  44. package/dist/{cli-kwr5qv5g.js → cli-eb279wn3.js} +2 -2
  45. package/dist/{cli-hhc47ack.js → cli-f1952kjy.js} +2 -2
  46. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  47. package/dist/{cli-eq4kew31.js → cli-fhvk2nvp.js} +24 -11
  48. package/dist/{cli-xf4z5bdn.js → cli-fz9pcjsw.js} +2 -2
  49. package/dist/{cli-fxd1mwtr.js → cli-g6j6ac3h.js} +1 -1
  50. package/dist/{cli-ya3kf4gs.js → cli-gfcv679k.js} +1 -1
  51. package/dist/{cli-55tc8cj4.js → cli-hbq0kwxz.js} +4 -4
  52. package/dist/{cli-39qm0rtm.js → cli-hc6e4tac.js} +28 -149
  53. package/dist/{cli-j5gtytvg.js → cli-hgsxnjyg.js} +13 -10
  54. package/dist/{cli-h70a2mxy.js → cli-hpb9x72z.js} +48 -8
  55. package/dist/{cli-7yn42w6m.js → cli-j53hpbsm.js} +1 -1
  56. package/dist/{cli-12vek61e.js → cli-jj3c5nyb.js} +471 -119
  57. package/dist/{cli-fy4gb74g.js → cli-kde4ky90.js} +1 -1
  58. package/dist/{cli-9qe5y107.js → cli-kspxjftk.js} +1 -1
  59. package/dist/{cli-bp6k9acz.js → cli-mh7pdxe0.js} +16 -16
  60. package/dist/{cli-v9ya390t.js → cli-mz34pxbk.js} +8 -8
  61. package/dist/{cli-ma9ys8rt.js → cli-nc6a8b5b.js} +7 -4
  62. package/dist/{cli-1htmtqc2.js → cli-prf7kz78.js} +49 -49
  63. package/dist/{cli-01tvvtad.js → cli-qec9bynj.js} +3 -3
  64. package/dist/{cli-t75xngj1.js → cli-qhhb30e8.js} +7 -7
  65. package/dist/{cli-73q4g5nx.js → cli-qm3ntjqs.js} +12 -12
  66. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  67. package/dist/{cli-agjbj5x0.js → cli-sdh61g52.js} +37 -19
  68. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  69. package/dist/{cli-5x03v6en.js → cli-sq913bh1.js} +8 -8
  70. package/dist/{cli-b93d81yg.js → cli-t35hx078.js} +1 -1
  71. package/dist/{cli-r0mz92by.js → cli-tn91wc6e.js} +1 -1
  72. package/dist/{cli-wvjqaqcp.js → cli-tstj6e8e.js} +1113 -227
  73. package/dist/{cli-xm34qj8m.js → cli-w14j2z4k.js} +2 -2
  74. package/dist/{cli-eqq0hwvx.js → cli-wndegmns.js} +1 -1
  75. package/dist/{cli-0k1a0sde.js → cli-wrhbym01.js} +6 -6
  76. package/dist/{cli-fyaq4zdv.js → cli-wv20kbr3.js} +6 -6
  77. package/dist/{cli-mq2fbgva.js → cli-wxwv3t11.js} +2 -2
  78. package/dist/{cli-krbcr00p.js → cli-xfjn2kyq.js} +58 -4
  79. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  80. package/dist/{cli-cjqyse9q.js → cli-y4a4458j.js} +3 -3
  81. package/dist/{cli-2amwhyv2.js → cli-y518qkjg.js} +5 -3
  82. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  83. package/dist/cli-yn4kt85g.js +148 -0
  84. package/dist/{cli-n8f0fs3c.js → cli-ytc7fpza.js} +8 -8
  85. package/dist/{cli-e8n0hdzd.js → cli-z64t9pe6.js} +1 -1
  86. package/dist/{cli-72yms3ey.js → cli-zqmmy073.js} +198 -18
  87. package/dist/cli.js +18 -16
  88. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-f3yp0kaj.js} +5 -5
  89. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  90. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-ns4mv70p.js} +5 -5
  91. package/dist/{commands-tsv2vx5b.js → commands-5bzf2tfw.js} +3 -3
  92. package/dist/{controller-ye4sdwsy.js → controller-5xt7kvfm.js} +2 -2
  93. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-0gg13mzp.js} +24 -23
  94. package/dist/core-0fqtbrxa.js +42 -0
  95. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-p0c5zv6r.js} +1 -1
  96. package/dist/{db-g111qn9j.js → db-2s68ycq7.js} +3 -3
  97. package/dist/{db-3r1fyr2n.js → db-q7q639k5.js} +4 -2
  98. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-j2y1q7ae.js} +24 -21
  99. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-pgnkf4st.js} +1 -1
  100. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-0kea97jf.js} +1 -1
  101. package/dist/{embedding-space-kcdn52vz.js → embedding-space-3n6mhhmy.js} +6 -6
  102. package/dist/{embeddings-jnzcd91a.js → embeddings-jfmj6yme.js} +1 -1
  103. package/dist/{execute-74amghty.js → execute-tjrej979.js} +1 -1
  104. package/dist/{external-channel-v9zgxnxz.js → external-channel-jy8w2gg3.js} +2 -2
  105. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  106. package/dist/grok-adapter-4q5tssw0.js +20 -0
  107. package/dist/handlers-qxgfvvsf.js +41 -0
  108. package/dist/{heartbeat-p8pk1msj.js → heartbeat-6tr2w2da.js} +25 -24
  109. package/dist/{hook-p5reemds.js → hook-bpnncsec.js} +76 -17
  110. package/dist/{hook-k1h73zd7.js → hook-fv1jwrv7.js} +6 -5
  111. package/dist/{http-ms1z5xxy.js → http-bpa26czn.js} +785 -181
  112. package/dist/index-0mcxjdsa.js +44 -0
  113. package/dist/{index-kn63q1gr.js → index-52tgbhrw.js} +29 -28
  114. package/dist/index-dz4q23ag.js +40 -0
  115. package/dist/{index-76zzxtzf.js → index-mpj0z9e0.js} +1 -1
  116. package/dist/index-s175jckx.js +39 -0
  117. package/dist/{index-gjn6qfgn.js → index-s8re7mvq.js} +1 -1
  118. package/dist/{index-fbkqhvvj.js → index-w216g9y9.js} +198 -160
  119. package/dist/{keepalive-031js8jz.js → keepalive-d6z12s04.js} +3 -3
  120. package/dist/lead-p3hx7h35.js +79 -0
  121. package/dist/{maintenance-sq9v3qx9.js → maintenance-7kac6g2g.js} +1 -1
  122. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-t1xjetbh.js} +2 -2
  123. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-6rdagg0r.js} +7 -7
  124. package/dist/{onboard-p25yhh7t.js → onboard-32y1cfxy.js} +3 -3
  125. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-enp3v31n.js} +7 -6
  126. package/dist/{otel-impl-ff1gf20m.js → otel-impl-k0tm5ptj.js} +1 -1
  127. package/dist/{pending-hxj5yatb.js → pending-24zebgvs.js} +23 -22
  128. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-yj72xxxe.js} +85 -16
  129. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-cf25x38j.js} +2 -2
  130. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-0wydd22m.js} +3 -3
  131. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-at6crb3r.js} +7 -4
  132. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  133. package/dist/{render-v2-nrdkg9gf.js → render-v2-nvcw0jd7.js} +8 -4
  134. package/dist/{resume-s6ey36rh.js → resume-y4w0k5v3.js} +9 -8
  135. package/dist/{runtime-x0b4pyam.js → runtime-vpe43hx0.js} +1 -1
  136. package/dist/{session-access-xv49tk14.js → session-access-gkyvnfye.js} +5 -4
  137. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-3w2st4m2.js} +2 -2
  138. package/dist/{setup-mj0krk1p.js → setup-axxvqtys.js} +1 -1
  139. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  140. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-y4fqvab5.js} +2 -2
  141. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  142. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-7d92dct1.js} +3 -3
  143. package/dist/{work-objects-pydhzast.js → work-objects-f708e069.js} +27 -25
  144. package/dist/worker-8rg9gz74.js +79 -0
  145. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-0by8wztc.js} +22 -21
  146. package/dist/xlsx-9acfmxr1.js +31534 -0
  147. package/openapi.json +1385 -204
  148. package/package.json +5 -3
  149. package/src/agentmail/handlers.ts +26 -19
  150. package/src/apps/catalog.generated.json +31 -0
  151. package/src/apps/row-store.ts +37 -14
  152. package/src/azure-devops/handlers.ts +2 -0
  153. package/src/be/audit-user.ts +46 -6
  154. package/src/be/db/kv-windows.ts +22 -0
  155. package/src/be/db/session-moves.ts +3 -3
  156. package/src/be/db/session-tree.ts +52 -5
  157. package/src/be/db/skill-audit.ts +17 -0
  158. package/src/be/db/tasks/write.ts +18 -3
  159. package/src/be/db.ts +114 -23
  160. package/src/be/extensions/assets.ts +11 -7
  161. package/src/be/memory/demotion-evidence.ts +2 -2
  162. package/src/be/memory/providers/sqlite-store.ts +151 -18
  163. package/src/be/memory/search-read-worker.ts +60 -0
  164. package/src/be/memory/search-reader.ts +223 -0
  165. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  166. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  167. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  168. package/src/be/model-tier-resolution.ts +18 -1
  169. package/src/be/multi-runtime.ts +17 -0
  170. package/src/be/primitives/object-embed.ts +250 -0
  171. package/src/be/primitives/objects.ts +29 -9
  172. package/src/be/primitives/sheets/service.ts +138 -6
  173. package/src/be/primitives/sheets/xlsx.ts +367 -0
  174. package/src/be/rbac-roles.ts +3 -0
  175. package/src/be/repo-checked-update.ts +4 -4
  176. package/src/be/repo-merge-policy.ts +26 -9
  177. package/src/be/scripts/boot-reembed.ts +6 -0
  178. package/src/be/scripts/db.ts +17 -5
  179. package/src/be/scripts/embeddings.ts +6 -0
  180. package/src/be/scripts/typecheck.ts +43 -2
  181. package/src/be/seed/schedules-seeder.ts +9 -1
  182. package/src/be/seed/workflows-seeder.ts +9 -1
  183. package/src/be/seed-scripts/index.ts +2 -0
  184. package/src/be/seed-skills/index.ts +12 -0
  185. package/src/be/swarm-config-guard.ts +1 -0
  186. package/src/be/unmapped-identities.ts +95 -1
  187. package/src/bitbucket/handlers.ts +2 -0
  188. package/src/commands/onboard/agent-fs-version.ts +1 -1
  189. package/src/event-waits/github.ts +43 -0
  190. package/src/event-waits/index.ts +29 -0
  191. package/src/event-waits/types.ts +51 -0
  192. package/src/extensions/contract-types.generated.ts +1 -1
  193. package/src/extensions/dispatcher.ts +9 -0
  194. package/src/fs/agent-fs-provider.ts +4 -1
  195. package/src/github/handlers.ts +3 -1
  196. package/src/github/pull-request-state.ts +34 -0
  197. package/src/gitlab/handlers.ts +12 -7
  198. package/src/hooks/codex-hook.ts +99 -1
  199. package/src/hooks/hook.ts +85 -11
  200. package/src/hooks/native-tool-hooks.ts +245 -0
  201. package/src/http/all-routes.ts +1 -0
  202. package/src/http/assets.ts +4 -3
  203. package/src/http/comb.ts +2 -2
  204. package/src/http/favorite-owner.ts +2 -2
  205. package/src/http/favorites.ts +3 -2
  206. package/src/http/fs.ts +13 -4
  207. package/src/http/index.ts +2 -0
  208. package/src/http/mcp-bridge.ts +4 -0
  209. package/src/http/objects.ts +265 -0
  210. package/src/http/pages.ts +3 -3
  211. package/src/http/poll.ts +43 -12
  212. package/src/http/repos.ts +7 -6
  213. package/src/http/schedules.ts +10 -6
  214. package/src/http/script-connections.ts +2 -2
  215. package/src/http/scripts.ts +9 -0
  216. package/src/http/sessions.ts +30 -12
  217. package/src/http/skills.ts +17 -0
  218. package/src/http/task-requester.ts +2 -2
  219. package/src/http/tasks.ts +13 -3
  220. package/src/http/tool-hooks.ts +24 -2
  221. package/src/http/trackers/authorize-gate.ts +2 -2
  222. package/src/http/users.ts +136 -1
  223. package/src/http/workflow-events.ts +13 -0
  224. package/src/http/workflows.ts +21 -11
  225. package/src/linear/sync.ts +3 -1
  226. package/src/prompts/base-prompt.ts +35 -13
  227. package/src/prompts/session-templates.ts +25 -0
  228. package/src/providers/acp-targets.ts +1 -1
  229. package/src/providers/amp-adapter.ts +1 -1
  230. package/src/providers/dsh-adapter.ts +1 -1
  231. package/src/providers/opencode-adapter.ts +1 -0
  232. package/src/providers/opencode-swarm-plugin.ts +50 -1
  233. package/src/providers/pi-mono-adapter.ts +139 -9
  234. package/src/providers/pi-mono-extension.ts +69 -0
  235. package/src/providers/runtime-dependencies.ts +1 -1
  236. package/src/rbac/legacy-policy.ts +3 -0
  237. package/src/rbac/permissions.ts +11 -1
  238. package/src/scheduler/deferred-task-waits.ts +170 -13
  239. package/src/scripts-runtime/executors/types.ts +5 -0
  240. package/src/scripts-runtime/loader.ts +8 -0
  241. package/src/scripts-runtime/mcp-client.ts +4 -0
  242. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  243. package/src/scripts-runtime/swarm-config.ts +8 -0
  244. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  245. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  246. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  247. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  248. package/src/server.ts +4 -0
  249. package/src/slack/enrich.ts +81 -21
  250. package/src/slack/handlers.test.ts +55 -2
  251. package/src/slack/handlers.ts +38 -3
  252. package/src/slack/render-v2.ts +19 -0
  253. package/src/slack/session-mirror.ts +208 -0
  254. package/src/slack/thread-participants.ts +0 -5
  255. package/src/slack/watcher.ts +3 -0
  256. package/src/slack/work-objects.test.ts +2 -1
  257. package/src/slack/work-objects.ts +7 -2
  258. package/src/tests/agentmail-filters.test.ts +4 -3
  259. package/src/tests/audit-agent-person.test.ts +825 -0
  260. package/src/tests/audit-updated-by.test.ts +19 -12
  261. package/src/tests/claude-hook-output.test.ts +107 -2
  262. package/src/tests/claude-managed-setup.test.ts +1 -1
  263. package/src/tests/codex-adapter.test.ts +6 -6
  264. package/src/tests/codex-gpt6-release.test.ts +4 -4
  265. package/src/tests/db-task-read-contract.test.ts +1 -0
  266. package/src/tests/db-task-write-contract.test.ts +1 -0
  267. package/src/tests/dsh-adapter.test.ts +1 -1
  268. package/src/tests/extensions-catalog.test.ts +33 -25
  269. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  270. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  271. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  272. package/src/tests/kv-storage.test.ts +3 -0
  273. package/src/tests/memory-search-reader.test.ts +258 -0
  274. package/src/tests/memory-search-stall.test.ts +197 -20
  275. package/src/tests/model-control.test.ts +4 -4
  276. package/src/tests/model-tier-resolution.test.ts +2 -2
  277. package/src/tests/multi-runtime-registration.test.ts +8 -2
  278. package/src/tests/native-tool-hooks.test.ts +188 -0
  279. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  280. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  281. package/src/tests/poll-probe-readonly.test.ts +108 -0
  282. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  283. package/src/tests/prompt-template-session.test.ts +3 -2
  284. package/src/tests/rbac-roles.test.ts +3 -0
  285. package/src/tests/script-connections.test.ts +4 -0
  286. package/src/tests/seed-model-profiles.test.ts +1 -1
  287. package/src/tests/sessions-tree.test.ts +10 -2
  288. package/src/tests/slack-thread-participants.test.ts +66 -4
  289. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  290. package/src/tools/defer-task.ts +154 -12
  291. package/src/tools/objects.ts +10 -5
  292. package/src/tools/repos/update-repo.ts +6 -6
  293. package/src/tools/schedules/create-schedule.ts +1 -0
  294. package/src/tools/schedules/list-schedules.ts +3 -0
  295. package/src/tools/schedules/patch-schedule.ts +12 -3
  296. package/src/tools/schedules/update-schedule.ts +12 -3
  297. package/src/tools/sheets.ts +66 -0
  298. package/src/tools/skills/skill-create.ts +6 -0
  299. package/src/tools/skills/skill-install-remote.ts +6 -0
  300. package/src/tools/skills/skill-sync-remote.ts +9 -0
  301. package/src/tools/skills/skill-update.ts +9 -1
  302. package/src/tools/tool-config.ts +3 -1
  303. package/src/tools/utils.ts +15 -0
  304. package/src/tools/workflows/create-workflow.ts +9 -4
  305. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  306. package/src/tools/workflows/patch-workflow.ts +5 -2
  307. package/src/tools/workflows/update-workflow.ts +13 -7
  308. package/src/types.ts +96 -12
  309. package/src/workflows/input.ts +12 -5
  310. package/src/workflows/patch-definition.ts +13 -5
  311. package/src/workflows/triggers.ts +11 -6
  312. package/src/workflows/version.ts +7 -1
  313. package/templates/skills/boards-and-sheets/config.json +14 -0
  314. package/templates/skills/boards-and-sheets/content.md +163 -0
  315. package/templates/skills/swarm-docs/content.md +9 -0
  316. package/dist/acp-adapter-11m13kx4.js +0 -16
  317. package/dist/core-dxcy02sc.js +0 -41
  318. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  319. package/dist/grok-adapter-t6m74fb1.js +0 -19
  320. package/dist/handlers-9kwcrc4k.js +0 -38
  321. package/dist/index-23cdfzr6.js +0 -39
  322. package/dist/index-g7kkjs5b.js +0 -38
  323. package/dist/index-stk36pa5.js +0 -43
  324. package/dist/lead-mfggjtfk.js +0 -77
  325. package/dist/thread-buffer-temgaqsy.js +0 -41
  326. package/dist/worker-efcemc22.js +0 -77
  327. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -0,0 +1,367 @@
1
+ import { inflateRawSync } from "node:zlib";
2
+ import type { CellObject, WorkSheet } from "xlsx";
3
+ import { ObjectsError } from "../objects";
4
+ import { colName, parseCell, refOf } from "./a1";
5
+ import { MAX_CELLS, MAX_FILE_BYTES, MAX_TABS, type SheetCell, type SheetTab } from "./format";
6
+
7
+ /**
8
+ * xlsx <-> `swarm-sheet/1` on SheetJS CE. Import and export only: the sheet file
9
+ * stays the source of truth. Kept: tab names and order, values, formulas, number
10
+ * formats, column widths, merged ranges. Everything else is reported in `dropped`.
11
+ */
12
+
13
+ export const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
14
+
15
+ /** Compressed upload limit: the same 5 MiB a `.sheet.json` may hold. The service checks it before it reads the body. */
16
+ export const MAX_XLSX_BYTES = MAX_FILE_BYTES;
17
+ /** Sum of every part once inflated. A real 50,000-cell workbook is a few MiB; this stops a zip bomb. */
18
+ export const MAX_INFLATED_BYTES = 16 * 1024 * 1024;
19
+
20
+ const notXlsx = (why: string) => new ObjectsError(`not an xlsx workbook: ${why}`);
21
+
22
+ const refuse = (why: string) => notXlsx(`${why}; refusing it`);
23
+
24
+ /** True when a zip extra-field block holds a ZIP64 record, which SheetJS trusts for sizes. */
25
+ function hasZip64Extra(view: DataView, from: number, length: number): boolean {
26
+ for (let at = from; at + 4 <= from + length; ) {
27
+ if (view.getUint16(at, true) === 0x0001) return true;
28
+ at += 4 + view.getUint16(at + 2, true);
29
+ }
30
+ return false;
31
+ }
32
+
33
+ /**
34
+ * Names of the zip parts, after proving that the archive reads the same to us and to SheetJS
35
+ * and that every part inflates to exactly its declared size under the cap. SheetJS trusts the
36
+ * local headers (name, method, sizes, ZIP64 extras) and the per-disk entry count, and it inflates
37
+ * whatever stream sits at each local header. So an archive where those disagree with the central
38
+ * directory is refused outright, and the rest is measured the way SheetJS walks it.
39
+ */
40
+ function checkedZipParts(bytes: Uint8Array): Set<string> {
41
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
42
+ const names = new Set<string>();
43
+ try {
44
+ // The same last-signature scan SheetJS runs, so both pick one end record.
45
+ let eocd = bytes.length - 4;
46
+ while (eocd >= 0 && view.getUint32(eocd, true) !== 0x06054b50) eocd--;
47
+ if (eocd < 0) throw notXlsx("not a zip archive (no end-of-directory record)");
48
+ const count = view.getUint16(eocd + 8, true); // SheetJS reads this one
49
+ const dirSize = view.getUint32(eocd + 12, true);
50
+ const dirStart = view.getUint32(eocd + 16, true);
51
+ if (
52
+ view.getUint16(eocd + 4, true) !== 0 ||
53
+ view.getUint16(eocd + 6, true) !== 0 ||
54
+ count !== view.getUint16(eocd + 10, true) ||
55
+ count === 0xffff ||
56
+ dirSize === 0xffffffff ||
57
+ dirStart === 0xffffffff
58
+ ) {
59
+ throw refuse("the zip end record has split-disk, inconsistent or ZIP64 counts");
60
+ }
61
+ if (dirStart + dirSize !== eocd)
62
+ throw refuse("the zip directory does not end at the end record");
63
+ let at = dirStart;
64
+ let inflated = 0;
65
+ for (let n = 0; n < count; n++) {
66
+ if (view.getUint32(at, true) !== 0x02014b50) throw notXlsx("broken zip directory");
67
+ const method = view.getUint16(at + 10, true);
68
+ const size = view.getUint32(at + 20, true);
69
+ const fullSize = view.getUint32(at + 24, true);
70
+ const nameLen = view.getUint16(at + 28, true);
71
+ const extraLen = view.getUint16(at + 30, true);
72
+ const next = at + 46 + nameLen + extraLen + view.getUint16(at + 32, true);
73
+ const local = view.getUint32(at + 42, true);
74
+ const name = bytes.subarray(at + 46, at + 46 + nameLen);
75
+ names.add(new TextDecoder().decode(name));
76
+ inflated += fullSize;
77
+ if (inflated > MAX_INFLATED_BYTES) {
78
+ throw new ObjectsError(
79
+ `the workbook inflates to more than ${MAX_INFLATED_BYTES} bytes (16 MiB); refusing it`,
80
+ );
81
+ }
82
+ if (
83
+ size === 0xffffffff ||
84
+ fullSize === 0xffffffff ||
85
+ hasZip64Extra(view, at + 46 + nameLen, extraLen)
86
+ ) {
87
+ throw refuse("a zip part uses ZIP64 sizes");
88
+ }
89
+ if (view.getUint32(local, true) !== 0x04034b50) throw notXlsx("broken zip local header");
90
+ const localNameLen = view.getUint16(local + 26, true);
91
+ const localExtraLen = view.getUint16(local + 28, true);
92
+ // SheetJS takes the part's name and method from the local header and sizes the buffer from its sizes.
93
+ const sameSize = (value: number, declared: number) => value === declared || value === 0;
94
+ if (
95
+ view.getUint16(local + 8, true) !== method ||
96
+ !sameSize(view.getUint32(local + 18, true), size) ||
97
+ !sameSize(view.getUint32(local + 22, true), fullSize) ||
98
+ localNameLen !== nameLen ||
99
+ Buffer.compare(bytes.subarray(local + 30, local + 30 + localNameLen), name) !== 0 ||
100
+ hasZip64Extra(view, local + 30 + localNameLen, localExtraLen)
101
+ ) {
102
+ throw refuse("a zip part's local header disagrees with the directory");
103
+ }
104
+ const start = local + 30 + localNameLen + localExtraLen;
105
+ const data = bytes.subarray(start, start + size);
106
+ let actual: number;
107
+ if (method === 0) actual = data.length;
108
+ else if (method === 8)
109
+ actual = inflateRawSync(data, { maxOutputLength: Math.max(fullSize, 1) }).length;
110
+ else throw notXlsx(`unsupported zip compression method ${method}`);
111
+ if (actual !== fullSize) throw notXlsx("a zip part does not match its declared size");
112
+ at = next;
113
+ }
114
+ if (at !== eocd) throw refuse("the zip directory has bytes the entry count does not cover");
115
+ } catch (error) {
116
+ if (error instanceof ObjectsError) throw error;
117
+ // RangeError (read past the end), zlib errors (bad stream, output past the declared size).
118
+ throw notXlsx(`corrupt zip archive (${(error as Error).message})`);
119
+ }
120
+ return names;
121
+ }
122
+
123
+ /** Run `fn` on the parts of a formula outside string literals and quoted sheet names. `""` and `''` escape a quote. */
124
+ const outsideQuotes = (formula: string, fn: (code: string) => string) =>
125
+ formula
126
+ .split(/("(?:[^"]|"")*"|'(?:[^']|'')*')/)
127
+ .map((part, i) => (i % 2 ? part : fn(part)))
128
+ .join("");
129
+
130
+ // Read with `xlfn: true`: SheetJS would strip `_xlfn.` inside string literals too. We strip both prefixes, outside quotes only.
131
+ const XLPREFIX = /_xl(?:fn|ws)\./g;
132
+
133
+ /** Functions Excel stores with an `_xlfn.` prefix (`_xlfn._xlws.` for the two that sort or filter). Without it Excel shows #NAME?. */
134
+ const XLFN_FUNCTIONS = [
135
+ "CONCAT",
136
+ "IFNA",
137
+ "IFS",
138
+ "MAXIFS",
139
+ "MINIFS",
140
+ "SEQUENCE",
141
+ "STDEV.P",
142
+ "STDEV.S",
143
+ "SWITCH",
144
+ "TEXTJOIN",
145
+ "UNIQUE",
146
+ "VAR.P",
147
+ "VAR.S",
148
+ "XLOOKUP",
149
+ "XMATCH",
150
+ ];
151
+ const XLWS_FUNCTIONS = ["FILTER", "SORT"];
152
+ const prefixFunctions = (formula: string, names: string[], prefix: string) =>
153
+ names.reduce(
154
+ (f, name) =>
155
+ f.replace(new RegExp(`(?<![\\w.])${name.replace(".", "\\.")}\\(`, "gi"), `${prefix}${name}(`),
156
+ formula,
157
+ );
158
+
159
+ // shortcut: a fixed list of post-2007 functions; add a name here when Excel shows #NAME? for one we export.
160
+ const toXlsxFormula = (formula: string) =>
161
+ outsideQuotes(formula.slice(1), (code) =>
162
+ prefixFunctions(
163
+ prefixFunctions(code, XLFN_FUNCTIONS, "_xlfn."),
164
+ XLWS_FUNCTIONS,
165
+ "_xlfn._xlws.",
166
+ ),
167
+ );
168
+
169
+ const ERROR_CODES: Record<string, number> = {
170
+ "#NULL!": 0,
171
+ "#DIV/0!": 7,
172
+ "#VALUE!": 15,
173
+ "#REF!": 23,
174
+ "#NAME?": 29,
175
+ "#NUM!": 36,
176
+ "#N/A": 42,
177
+ };
178
+
179
+ type Zip = Record<string, { content?: string | Uint8Array } | undefined>;
180
+
181
+ /**
182
+ * Whether any `<tag ...>` start tag in `xml` has `attr` inside its own tag.
183
+ * One pass: every step moves past the tag it read, so a crafted run of `<pane ` tokens cannot make it quadratic the way a backtracking regex does.
184
+ */
185
+ function hasTagWith(xml: string, tag: string, attr: string): boolean {
186
+ for (let at = xml.indexOf(tag); at !== -1; at = xml.indexOf(tag, at)) {
187
+ const end = xml.indexOf(">", at);
188
+ if (end === -1) return false;
189
+ if (xml.slice(at, end).includes(attr)) return true;
190
+ at = end + 1;
191
+ }
192
+ return false;
193
+ }
194
+
195
+ /** Whether a `<font>` element holds `<b/>`. Linear for the same reason as `hasTagWith`: each step moves past the `</font>` it reached. */
196
+ function hasBoldFont(styles: string): boolean {
197
+ for (let at = styles.indexOf("<font>"); at !== -1; at = styles.indexOf("<font>", at)) {
198
+ const end = styles.indexOf("</font>", at);
199
+ if (end === -1) return false;
200
+ if (styles.slice(at, end).includes("<b/>")) return true;
201
+ at = end + 7;
202
+ }
203
+ return false;
204
+ }
205
+
206
+ /** Features of the file that a `swarm-sheet/1` workbook does not carry, read from the zip parts. */
207
+ function lostFeatures(names: Set<string>, files: Zip, definedNames: boolean): string[] {
208
+ const found = new Set<string>();
209
+ const text = (name: string) => {
210
+ const content = files[name]?.content;
211
+ return typeof content === "string" ? content : content ? new TextDecoder().decode(content) : "";
212
+ };
213
+ const has = (prefix: string) => [...names].some((name) => name.startsWith(prefix));
214
+ if (has("xl/charts/")) found.add("charts");
215
+ if (has("xl/media/")) found.add("images");
216
+ if (has("xl/comments") || has("xl/threadedComments")) found.add("comments");
217
+ if (has("xl/pivot")) found.add("pivot tables");
218
+ if (has("xl/tables/")) found.add("Excel tables");
219
+ if (names.has("xl/vbaProject.bin")) found.add("macros");
220
+ for (const name of names) {
221
+ if (!/^xl\/worksheets\/[^/]+\.xml$/.test(name)) continue;
222
+ const xml = text(name);
223
+ if (xml.includes("<conditionalFormatting")) found.add("conditional formatting");
224
+ if (xml.includes("<dataValidation")) found.add("data validation");
225
+ if (xml.includes("<autoFilter")) found.add("autofilter");
226
+ if (xml.includes("<hyperlink ")) found.add("hyperlinks");
227
+ if (xml.includes("<sheetProtection")) found.add("sheet protection");
228
+ if (hasTagWith(xml, "<pane ", 'state="frozen"')) found.add("frozen panes");
229
+ }
230
+ const styles = text("xl/styles.xml");
231
+ if (
232
+ /<patternFill patternType="solid"/.test(styles) ||
233
+ hasBoldFont(styles) ||
234
+ /<(left|right|top|bottom) style="/.test(styles)
235
+ ) {
236
+ found.add("cell styling (fills, bold, borders)");
237
+ }
238
+ if (definedNames) found.add("defined names");
239
+ return [...found];
240
+ }
241
+
242
+ /** Parse an xlsx into tabs. The engine recomputes every formula afterwards, so cached results are not kept. */
243
+ export async function parseXlsx(
244
+ bytes: Uint8Array,
245
+ ): Promise<{ tabs: SheetTab[]; dropped: string[] }> {
246
+ const names = checkedZipParts(bytes);
247
+ if (!names.has("xl/workbook.xml")) throw notXlsx("the archive has no xl/workbook.xml");
248
+ const XLSX = await import("xlsx");
249
+ // shortcut: SheetJS parses on the API thread; the file, inflated and cell caps bound it (50,000 cells parse in about 0.2 s). Move it to the engine worker if imports ever stall the API.
250
+ let wb: ReturnType<typeof XLSX.read>;
251
+ try {
252
+ // sheetStubs keeps a formula cell that has no cached value.
253
+ wb = XLSX.read(bytes, {
254
+ type: "array",
255
+ cellFormula: true,
256
+ cellNF: true,
257
+ cellStyles: true,
258
+ xlfn: true,
259
+ sheetStubs: true,
260
+ bookFiles: true,
261
+ });
262
+ } catch (error) {
263
+ throw notXlsx((error as Error).message);
264
+ }
265
+ if (wb.SheetNames.length > MAX_TABS) {
266
+ throw new ObjectsError(
267
+ `the workbook has ${wb.SheetNames.length} tabs; the limit is ${MAX_TABS}`,
268
+ );
269
+ }
270
+ const dropped = new Set<string>();
271
+ let cellTotal = 0;
272
+ const tabs = wb.SheetNames.map((name): SheetTab => {
273
+ const ws = wb.Sheets[name] as WorkSheet;
274
+ const cells: Record<string, SheetCell> = {};
275
+ for (const [ref, entry] of Object.entries(ws)) {
276
+ if (ref.startsWith("!")) continue;
277
+ const cell = entry as CellObject;
278
+ const out: SheetCell = {};
279
+ if (typeof cell.f === "string" && cell.f !== "") {
280
+ // A multi-cell array formula would spill over its own cached cells: keep the values.
281
+ if (cell.F?.includes(":")) dropped.add("array formulas (kept as values)");
282
+ else out.f = `=${outsideQuotes(cell.f, (code) => code.replace(XLPREFIX, ""))}`;
283
+ }
284
+ if (out.f === undefined) {
285
+ if (cell.t === "n" || cell.t === "s") out.v = cell.v as number | string;
286
+ else if (cell.t === "b") out.v = !!cell.v;
287
+ else if (cell.t === "e") {
288
+ out.v = cell.w ?? "#VALUE!";
289
+ dropped.add("error constants (kept as text)");
290
+ }
291
+ }
292
+ // A stub with no formula and no value is an empty styled cell.
293
+ if (out.f === undefined && out.v === undefined) continue;
294
+ if (typeof cell.z === "string" && cell.z !== "General") out.nf = cell.z;
295
+ cells[ref] = out;
296
+ if (++cellTotal > MAX_CELLS) {
297
+ throw new ObjectsError(
298
+ `the workbook has more than ${MAX_CELLS} cells; the limit is ${MAX_CELLS}`,
299
+ );
300
+ }
301
+ }
302
+ const tab: SheetTab = { name, cells };
303
+ const widths: Record<string, number> = {};
304
+ (ws["!cols"] ?? []).forEach((col, i) => {
305
+ const px = col?.wpx ?? (col?.wch ? Math.round(col.wch * 7 + 5) : 0);
306
+ if (px) widths[colName(i + 1)] = px;
307
+ });
308
+ if (Object.keys(widths).length) tab.colWidths = widths;
309
+ if (ws["!merges"]?.length)
310
+ tab.merges = ws["!merges"].map((range) => XLSX.utils.encode_range(range));
311
+ return tab;
312
+ });
313
+ const definedNames = !!wb.Workbook?.Names?.some((n) => !String(n.Name).startsWith("_xlnm"));
314
+ for (const feature of lostFeatures(names, (wb as { files?: Zip }).files ?? {}, definedNames)) {
315
+ dropped.add(feature);
316
+ }
317
+ return { tabs, dropped: [...dropped] };
318
+ }
319
+
320
+ /** Build an xlsx from a workbook's tabs. Formulas keep their cached result. */
321
+ export async function buildXlsx(
322
+ tabs: SheetTab[],
323
+ ): Promise<{ bytes: Uint8Array<ArrayBuffer>; dropped: string[] }> {
324
+ const XLSX = await import("xlsx");
325
+ const wb = XLSX.utils.book_new();
326
+ const dropped = new Set<string>();
327
+ for (const tab of tabs) {
328
+ const ws: WorkSheet = {};
329
+ let rows = 0;
330
+ let cols = 0;
331
+ for (const [ref, c] of Object.entries(tab.cells)) {
332
+ const at = parseCell(ref);
333
+ rows = Math.max(rows, at.row);
334
+ cols = Math.max(cols, at.col);
335
+ let cell: CellObject;
336
+ if (c.e) {
337
+ const text = String(c.v);
338
+ cell = { t: "e", v: ERROR_CODES[text] ?? ERROR_CODES["#VALUE!"], w: text };
339
+ } else if (typeof c.v === "number") cell = { t: "n", v: c.v };
340
+ else if (typeof c.v === "boolean") cell = { t: "b", v: c.v };
341
+ else if (typeof c.v === "string") cell = { t: "s", v: c.v };
342
+ else cell = { t: "z" };
343
+ if (c.f) cell.f = toXlsxFormula(c.f);
344
+ if (c.nf) cell.z = c.nf;
345
+ if (c.s) dropped.add("spilled array cells (written as values; the anchor keeps its formula)");
346
+ ws[ref] = cell;
347
+ }
348
+ ws["!ref"] = rows ? `A1:${refOf(rows, cols)}` : "A1";
349
+ if (tab.colWidths) {
350
+ ws["!cols"] = Array.from({ length: cols }, (_, i) => {
351
+ const px = tab.colWidths?.[colName(i + 1)];
352
+ return px ? { wpx: px } : {};
353
+ });
354
+ }
355
+ if (tab.merges) ws["!merges"] = tab.merges.map((range) => XLSX.utils.decode_range(range));
356
+ // SheetJS CE cannot write the pane element.
357
+ if (tab.freezeRows) dropped.add("frozen panes");
358
+ try {
359
+ XLSX.utils.book_append_sheet(wb, ws, tab.name);
360
+ } catch (error) {
361
+ // A hand-edited file can hold a tab name Excel forbids.
362
+ throw new ObjectsError(`cannot export tab '${tab.name}': ${(error as Error).message}`);
363
+ }
364
+ }
365
+ const out = XLSX.write(wb, { type: "array", bookType: "xlsx", compression: true }) as ArrayBuffer;
366
+ return { bytes: new Uint8Array(out), dropped: [...dropped] };
367
+ }
@@ -44,6 +44,8 @@ export const BUILTIN_ROLES = [
44
44
  "task.steer.own",
45
45
  "comb.presence",
46
46
  "fs.join.own",
47
+ "objects.read",
48
+ "objects.write",
47
49
  ],
48
50
  },
49
51
  {
@@ -58,6 +60,7 @@ export const BUILTIN_ROLES = [
58
60
  "session.presence",
59
61
  "comb.presence",
60
62
  "fs.join.own",
63
+ "objects.read",
61
64
  ],
62
65
  },
63
66
  {
@@ -1,6 +1,6 @@
1
1
  import type { SwarmRepo } from "@/types";
2
2
  import { getDbClient, getSwarmRepoById, updateSwarmRepo } from "./db";
3
- import { changesAllowMerge } from "./repo-merge-policy";
3
+ import { changesMergePolicy } from "./repo-merge-policy";
4
4
 
5
5
  export type CheckedRepoUpdate<Refusal> =
6
6
  | { kind: "updated"; repo: SwarmRepo }
@@ -8,12 +8,12 @@ export type CheckedRepoUpdate<Refusal> =
8
8
  | { kind: "refused"; refusal: Refusal };
9
9
 
10
10
  /**
11
- * Applies a repo update whose `allowMerge` change the caller must be authorized for. The
11
+ * Applies a repo update whose merge-policy change (`allowMerge` or `mergePolicy`) the caller must be authorized for. The
12
12
  * guidelines `authorize` compares against, the decision and the write share one BEGIN IMMEDIATE
13
13
  * transaction, so a stale edit cannot overwrite a merge-policy change that committed after the
14
14
  * caller's read: the later writer waits, then decides against the committed value.
15
15
  *
16
- * `authorize` runs only when the update changes `allowMerge`. It returns a refusal to stop the
16
+ * `authorize` runs only when the update changes the merge policy. It returns a refusal to stop the
17
17
  * update, or null to allow it. It runs inside the transaction: read only what it needs through
18
18
  * the usual helpers (they join the transaction) and do no slow I/O.
19
19
  */
@@ -25,7 +25,7 @@ export async function updateSwarmRepoChecked<Refusal>(
25
25
  return await getDbClient().transaction(async (): Promise<CheckedRepoUpdate<Refusal>> => {
26
26
  if (updates.guidelines !== undefined) {
27
27
  const existing = await getSwarmRepoById(id);
28
- if (existing && changesAllowMerge(existing.guidelines, updates.guidelines)) {
28
+ if (existing && changesMergePolicy(existing.guidelines, updates.guidelines)) {
29
29
  const refusal = await authorize(existing);
30
30
  if (refusal !== null) return { kind: "refused", refusal };
31
31
  }
@@ -1,15 +1,32 @@
1
- import type { RepoGuidelines } from "@/types";
1
+ import { agentsMayMerge, type RepoGuidelines } from "@/types";
2
+
3
+ type MergePolicyFields = Pick<RepoGuidelines, "allowMerge" | "mergePolicy">;
4
+
5
+ /** Stable JSON: object keys sorted, so a reordered resend of the same record compares equal. */
6
+ function canonical(value: unknown): string {
7
+ return JSON.stringify(value ?? null, (_key, v) =>
8
+ v && typeof v === "object" && !Array.isArray(v)
9
+ ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : 1)))
10
+ : v,
11
+ );
12
+ }
2
13
 
3
14
  /**
4
- * True when writing `incoming` would change a repo's effective `allowMerge`. An omitted
5
- * `guidelines` leaves it alone, `null` clears it (so it reads false), and a missing flag
6
- * reads false. Only the lead, the operator or a user may make such a change: the flag is
7
- * rendered into every agent's prompt as the merge policy.
15
+ * True when writing `incoming` would change a repo's merge policy: its raw `allowMerge`
16
+ * flag (a record's `agentsMayMerge` can mask it, but other readers use it directly), its effective
17
+ * `agentsMayMerge` (the record's flag, else `allowMerge`) or any part of its `mergePolicy`
18
+ * record. An omitted `guidelines` leaves it alone and `null` clears it. A resend that drops
19
+ * a stored `mergePolicy` counts as a change. Only the lead, the operator or a user may make
20
+ * such a change: the policy is rendered into every agent's prompt and read by the merge scripts.
8
21
  */
9
- export function changesAllowMerge(
10
- current: Pick<RepoGuidelines, "allowMerge"> | null | undefined,
11
- incoming: Pick<RepoGuidelines, "allowMerge"> | null | undefined,
22
+ export function changesMergePolicy(
23
+ current: MergePolicyFields | null | undefined,
24
+ incoming: MergePolicyFields | null | undefined,
12
25
  ): boolean {
13
26
  if (incoming === undefined) return false;
14
- return (incoming?.allowMerge === true) !== (current?.allowMerge === true);
27
+ return (
28
+ (current?.allowMerge === true) !== (incoming?.allowMerge === true) ||
29
+ agentsMayMerge(current) !== agentsMayMerge(incoming) ||
30
+ canonical(current?.mergePolicy) !== canonical(incoming?.mergePolicy)
31
+ );
15
32
  }
@@ -28,6 +28,9 @@ export type ScriptRow = {
28
28
  fsMode: "none" | "workspace-rw";
29
29
  executor: "native" | "quickjs" | null;
30
30
  createdByAgentId: string | null;
31
+ updatedByAgentId: string | null;
32
+ created_by: string | null;
33
+ updated_by: string | null;
31
34
  createdAt: string;
32
35
  updatedAt: string;
33
36
  };
@@ -40,6 +43,9 @@ export function toScriptRecord(row: ScriptRow) {
40
43
  typeChecked: row.typeChecked === 1,
41
44
  executor: row.executor ?? null,
42
45
  createdByAgentId: row.createdByAgentId ?? null,
46
+ updatedByAgentId: row.updatedByAgentId ?? null,
47
+ createdBy: row.created_by ?? null,
48
+ updatedBy: row.updated_by ?? null,
43
49
  };
44
50
  }
45
51
 
@@ -15,9 +15,11 @@ import { computeContentHash, getDbClient } from "../db";
15
15
  import { registerStoredSecret, scriptApiSecretName } from "../secret-registry";
16
16
  import { embedScript } from "./embeddings";
17
17
 
18
- type ScriptRow = Omit<ScriptRecord, "isScratch" | "typeChecked"> & {
18
+ type ScriptRow = Omit<ScriptRecord, "isScratch" | "typeChecked" | "createdBy" | "updatedBy"> & {
19
19
  isScratch: number;
20
20
  typeChecked: number;
21
+ created_by: string | null;
22
+ updated_by: string | null;
21
23
  };
22
24
 
23
25
  type ScriptVersionRow = ScriptVersionRecord;
@@ -38,9 +40,11 @@ type ScriptWriteArgs = ScriptIdentity & {
38
40
  typeChecked?: boolean;
39
41
  fsMode?: ScriptFsMode;
40
42
  executor?: ScriptExecutorName | null;
43
+ /** The writing agent: `createdByAgentId` on insert, `updatedByAgentId` on every update. */
41
44
  agentId?: string | null;
42
45
  changeReason?: string | null;
43
46
  embeddingMode?: "sync" | "skip";
47
+ /** The person behind the write: `created_by` on insert, `updated_by` on every update. */
44
48
  createdBy?: string | null;
45
49
  };
46
50
 
@@ -66,6 +70,9 @@ function rowToScript(row: ScriptRow): ScriptRecord {
66
70
  typeChecked: row.typeChecked === 1,
67
71
  executor: row.executor ?? null,
68
72
  createdByAgentId: row.createdByAgentId ?? null,
73
+ updatedByAgentId: row.updatedByAgentId ?? null,
74
+ createdBy: row.created_by ?? null,
75
+ updatedBy: row.updated_by ?? null,
69
76
  };
70
77
  }
71
78
 
@@ -125,9 +132,9 @@ export async function insertScript(args: ScriptWriteArgs): Promise<ScriptRecord>
125
132
  `INSERT INTO scripts (
126
133
  id, "key", name, scope, scopeId, source, description, intent, signatureJson,
127
134
  argsJsonSchema, contentHash, isScratch, typeChecked, fsMode, executor, createdByAgentId, createdAt, updatedAt,
128
- created_by, updated_by
135
+ created_by, updated_by, updatedByAgentId
129
136
  )
130
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
137
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
131
138
  RETURNING *`,
132
139
  [
133
140
  id,
@@ -150,6 +157,7 @@ export async function insertScript(args: ScriptWriteArgs): Promise<ScriptRecord>
150
157
  now,
151
158
  args.createdBy ?? null,
152
159
  args.createdBy ?? null,
160
+ args.agentId ?? null,
153
161
  ],
154
162
  );
155
163
 
@@ -221,7 +229,8 @@ export async function upsertScriptByName(args: ScriptWriteArgs): Promise<UpsertS
221
229
  const row = await getDbClient().get<ScriptRow>(
222
230
  `UPDATE scripts
223
231
  SET description = ?, intent = ?, signatureJson = ?, argsJsonSchema = ?,
224
- isScratch = ?, typeChecked = ?, fsMode = ?, executor = ?, updatedAt = ?, updated_by = ?
232
+ isScratch = ?, typeChecked = ?, fsMode = ?, executor = ?, updatedAt = ?, updated_by = ?,
233
+ updatedByAgentId = ?
225
234
  WHERE id = ?
226
235
  RETURNING *`,
227
236
  [
@@ -235,6 +244,7 @@ export async function upsertScriptByName(args: ScriptWriteArgs): Promise<UpsertS
235
244
  executor ?? null,
236
245
  new Date().toISOString(),
237
246
  args.createdBy ?? null,
247
+ args.agentId ?? null,
238
248
  existing.id,
239
249
  ],
240
250
  );
@@ -271,7 +281,8 @@ export async function upsertScriptByName(args: ScriptWriteArgs): Promise<UpsertS
271
281
  const row = await tx.get<ScriptRow>(
272
282
  `UPDATE scripts
273
283
  SET source = ?, description = ?, intent = ?, signatureJson = ?, argsJsonSchema = ?,
274
- contentHash = ?, version = ?, isScratch = ?, typeChecked = ?, fsMode = ?, executor = ?, updatedAt = ?, updated_by = ?
284
+ contentHash = ?, version = ?, isScratch = ?, typeChecked = ?, fsMode = ?, executor = ?, updatedAt = ?, updated_by = ?,
285
+ updatedByAgentId = ?
275
286
  WHERE id = ?
276
287
  RETURNING *`,
277
288
  [
@@ -288,6 +299,7 @@ export async function upsertScriptByName(args: ScriptWriteArgs): Promise<UpsertS
288
299
  executor ?? null,
289
300
  now,
290
301
  args.createdBy ?? null,
302
+ args.agentId ?? null,
291
303
  existing.id,
292
304
  ],
293
305
  );
@@ -30,6 +30,9 @@ type ScriptEmbeddingCandidateRow = ScriptEmbeddingRow & {
30
30
  fsMode: "none" | "workspace-rw";
31
31
  executor: "native" | "quickjs" | null;
32
32
  createdByAgentId: string | null;
33
+ updatedByAgentId: string | null;
34
+ created_by: string | null;
35
+ updated_by: string | null;
33
36
  createdAt: string;
34
37
  updatedAt: string;
35
38
  };
@@ -73,6 +76,9 @@ function rowToScript(row: ScriptEmbeddingCandidateRow): ScriptRecord {
73
76
  fsMode: row.fsMode,
74
77
  executor: row.executor ?? null,
75
78
  createdByAgentId: row.createdByAgentId ?? null,
79
+ updatedByAgentId: row.updatedByAgentId ?? null,
80
+ createdBy: row.created_by ?? null,
81
+ updatedBy: row.updated_by ?? null,
76
82
  createdAt: row.createdAt,
77
83
  updatedAt: row.updatedAt,
78
84
  };
@@ -220,8 +220,13 @@ export interface PrimitiveReindexReport {
220
220
  truncated: boolean;
221
221
  /** Which limit cut this call short; null when the pass finished. */
222
222
  cutBy: "files" | "reads" | "time" | "bytes" | null;
223
+ /** True when nothing was written: \`adopted\` and \`restored\` list what a real run would change. */
224
+ dryRun: boolean;
223
225
  }
224
226
 
227
+ /** \`prefix\`: only paths that start with it (as in \`list\`); without it every id-less file on the drive gets an id. \`dryRun\`: report, write nothing. */
228
+ export type PrimitiveReindexArgs = { kind?: PrimitiveObjectKind; prefix?: string; dryRun?: boolean };
229
+
225
230
  /**
226
231
  * Primitive objects: agent-fs files on your default drive with a stable id.
227
232
  * Calls run as your own agent-fs identity. Each method throws on a refusal.
@@ -232,7 +237,7 @@ export interface ObjectsNamespace {
232
237
  get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<{ message: string; object: PrimitiveObject; missing: boolean; content?: unknown }>;
233
238
  list(args?: { kind?: PrimitiveObjectKind; prefix?: string; limit?: number; offset?: number }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
234
239
  /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
235
- reindex(args?: { kind?: PrimitiveObjectKind }): Promise<{ message: string } & PrimitiveReindexReport>;
240
+ reindex(args?: PrimitiveReindexArgs): Promise<{ message: string } & PrimitiveReindexReport>;
236
241
  }
237
242
 
238
243
  /** A spreadsheet cell value. A string starting with \`=\` is a formula; null clears the cell. */
@@ -263,6 +268,36 @@ export interface SheetTabSummary {
263
268
  freezeRows: number;
264
269
  }
265
270
 
271
+ export interface SheetImportXlsxArgs {
272
+ /** An \`.xlsx\` on the drive. */
273
+ sourcePath: string;
274
+ /** The new sheet; must end in \`.sheet.json\`. */
275
+ path: string;
276
+ title?: string;
277
+ }
278
+
279
+ export interface SheetImportXlsxResult {
280
+ message: string;
281
+ object: PrimitiveObject;
282
+ link: string | null;
283
+ /** What the file had that a sheet cannot hold. */
284
+ dropped: string[];
285
+ }
286
+
287
+ export interface SheetExportXlsxArgs extends SheetRef {
288
+ targetPath: string;
289
+ /** Replace \`targetPath\` when it exists. */
290
+ overwrite?: boolean;
291
+ }
292
+
293
+ export interface SheetExportXlsxResult {
294
+ message: string;
295
+ path: string;
296
+ link: string | null;
297
+ /** What the sheet had that xlsx cannot carry. */
298
+ dropped: string[];
299
+ }
300
+
266
301
  export interface SheetResult {
267
302
  message: string;
268
303
  /** agent-fs version after the call. */
@@ -284,6 +319,10 @@ export interface SheetsNamespace {
284
319
  appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<SheetResult & { range: string }>;
285
320
  clearRange(args: SheetRangeArgs): Promise<SheetResult & { range: string; cleared: number }>;
286
321
  addTab(args: SheetRef & { name: string; after?: string }): Promise<SheetResult & { tabs: string[] }>;
322
+ /** Create-only. Reads an \`.xlsx\` on the drive. \`dropped\` names what a sheet cannot hold (styles, charts, comments, frozen panes, ...). Limits: 5 MiB, 20 tabs, 50,000 cells. */
323
+ importXlsx(args: SheetImportXlsxArgs): Promise<SheetImportXlsxResult>;
324
+ /** Create-only unless \`overwrite\`. \`targetPath\` must end in \`.xlsx\`. \`dropped\` names what xlsx cannot carry (frozen panes, spilled array cells). */
325
+ exportXlsx(args: SheetExportXlsxArgs): Promise<SheetExportXlsxResult>;
287
326
  }
288
327
 
289
328
  /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
@@ -413,7 +452,7 @@ export interface SwarmSdk {
413
452
  objects_create(args: { kind: PrimitiveObjectKind; path: string; title?: string }): Promise<unknown>;
414
453
  objects_get(args: { id?: string; path?: string; includeContent?: boolean }): Promise<unknown>;
415
454
  objects_list(args?: { kind?: PrimitiveObjectKind; prefix?: string; limit?: number; offset?: number }): Promise<unknown>;
416
- objects_reindex(args?: { kind?: PrimitiveObjectKind }): Promise<unknown>;
455
+ objects_reindex(args?: PrimitiveReindexArgs): Promise<unknown>;
417
456
  // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
418
457
  sheets_create(args: SheetCreateArgs): Promise<unknown>;
419
458
  sheets_get(args: SheetRef): Promise<unknown>;
@@ -423,6 +462,8 @@ export interface SwarmSdk {
423
462
  sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
424
463
  sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
425
464
  sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
465
+ sheets_importXlsx(args: SheetImportXlsxArgs): Promise<unknown>;
466
+ sheets_exportXlsx(args: SheetExportXlsxArgs): Promise<unknown>;
426
467
  // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
427
468
  boards_create(args: BoardCreateArgs): Promise<unknown>;
428
469
  boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;