@desplega.ai/agent-swarm 2.12.0 → 2.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (417) hide show
  1. package/dist/acp-adapter-xtj40wd8.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-n7vm5atw.js} +10 -9
  3. package/dist/{actions-c4chgxp6.js → actions-hq6wp9xv.js} +28 -27
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-y0qc1rdd.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-1qqs6h91.js} +3 -3
  6. package/dist/{app-hn5fftf5.js → app-7m4z44rv.js} +10 -8
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-8sr41gjx.js} +11 -10
  8. package/dist/{assistant-cpjgpjvp.js → assistant-hkczwfv6.js} +29 -28
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-8025snev.js} +1 -1
  10. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-15m87nr1.js} +5 -2
  11. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-4bbpxjh1.js} +1 -1
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-eajr97e9.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-9cwy39jx.js} +4 -4
  14. package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
  15. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-g61wa4rt.js} +9 -8
  16. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-znkk0prm.js} +4 -4
  17. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-f1wndkr2.js} +7 -7
  18. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-687xzf21.js} +20763 -19380
  19. package/dist/{cli-ya3kf4gs.js → cli-04103ryh.js} +1 -1
  20. package/dist/{cli-55tc8cj4.js → cli-0a336ze7.js} +5 -5
  21. package/dist/{cli-q8tc22bj.js → cli-0fx95c06.js} +5 -5
  22. package/dist/{cli-mq2fbgva.js → cli-0m77n7ej.js} +3 -3
  23. package/dist/{cli-7yn42w6m.js → cli-0xwb7zpt.js} +2 -2
  24. package/dist/{cli-mcymtvwn.js → cli-13t0smbk.js} +1000 -28
  25. package/dist/{cli-c7j31hq9.js → cli-1b5axkt1.js} +4 -4
  26. package/dist/{cli-yegz2g06.js → cli-1carhg8g.js} +4 -4
  27. package/dist/{cli-j5gtytvg.js → cli-1dr5at77.js} +15 -12
  28. package/dist/cli-2v4xxnx2.js +148 -0
  29. package/dist/{cli-sv2r3bw8.js → cli-32xndx6b.js} +7 -7
  30. package/dist/{cli-h70a2mxy.js → cli-3m8vqehw.js} +53 -13
  31. package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
  32. package/dist/{cli-52nfye5j.js → cli-3zyme1wt.js} +24 -16
  33. package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
  34. package/dist/{cli-b93d81yg.js → cli-4h90xaet.js} +2 -2
  35. package/dist/{cli-5tg94mdw.js → cli-4mj5g29m.js} +9 -12
  36. package/dist/{cli-47hz21se.js → cli-4tbvndmm.js} +4 -5
  37. package/dist/{cli-r0mz92by.js → cli-50whymxq.js} +2 -2
  38. package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
  39. package/dist/{cli-krbcr00p.js → cli-5v6b2am8.js} +59 -5
  40. package/dist/{cli-en6dmkxd.js → cli-6r1dwegd.js} +3 -3
  41. package/dist/{cli-9qe5y107.js → cli-7ewre3dm.js} +15 -6
  42. package/dist/{cli-n3qe7tyr.js → cli-84xtgbn6.js} +35 -2
  43. package/dist/{cli-xm34qj8m.js → cli-8cmjkbvj.js} +2 -2
  44. package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
  45. package/dist/{cli-nja15knq.js → cli-8rbkw18r.js} +3 -3
  46. package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
  47. package/dist/{cli-hhc47ack.js → cli-9xx36trj.js} +4 -4
  48. package/dist/{cli-39qm0rtm.js → cli-a8ts6x1n.js} +29 -150
  49. package/dist/{cli-bp6k9acz.js → cli-aebswqmz.js} +18 -18
  50. package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
  51. package/dist/{cli-q2dywc8h.js → cli-bjmq14k9.js} +4 -4
  52. package/dist/{cli-v9ya390t.js → cli-byxsctca.js} +12 -12
  53. package/dist/{cli-bz97ff9n.js → cli-c0tyzt73.js} +152 -12
  54. package/dist/{cli-fyaq4zdv.js → cli-c8kqmzzf.js} +9 -9
  55. package/dist/{cli-t75xngj1.js → cli-cd9acnvd.js} +12 -12
  56. package/dist/{cli-eqq0hwvx.js → cli-cmgdptmx.js} +3 -3
  57. package/dist/{cli-r14ac1y0.js → cli-cn6fpa1p.js} +1 -1
  58. package/dist/{cli-0k1a0sde.js → cli-cp0m07wb.js} +10 -10
  59. package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
  60. package/dist/{cli-fxd1mwtr.js → cli-cqxwjb93.js} +2 -2
  61. package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
  62. package/dist/{cli-73q4g5nx.js → cli-dd57p1gd.js} +21 -21
  63. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  64. package/dist/{cli-wvjqaqcp.js → cli-fn8aj7gb.js} +1330 -249
  65. package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
  66. package/dist/{cli-0pp1yjg2.js → cli-gedf48yw.js} +11 -11
  67. package/dist/{cli-m5qtmrbc.js → cli-gq6qhmrr.js} +2 -2
  68. package/dist/{cli-5x03v6en.js → cli-grcc2h2g.js} +8 -8
  69. package/dist/{cli-01tvvtad.js → cli-h03j6je3.js} +4 -4
  70. package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
  71. package/dist/{cli-12vek61e.js → cli-h9bejmkf.js} +535 -146
  72. package/dist/{cli-gfy6hbd9.js → cli-hs3mqswp.js} +18 -11
  73. package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
  74. package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
  75. package/dist/{cli-cjqyse9q.js → cli-jhtvt7gn.js} +3 -3
  76. package/dist/{cli-dkvtfgn4.js → cli-mmw2sjaf.js} +76 -17
  77. package/dist/{cli-2z2c4k6q.js → cli-mwxez0pz.js} +22 -0
  78. package/dist/{cli-yfpc6qy9.js → cli-nk8swfpx.js} +47 -16
  79. package/dist/{cli-eq4kew31.js → cli-p7g7wd9n.js} +26 -13
  80. package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
  81. package/dist/{cli-dd2k2mcd.js → cli-qn79645p.js} +1 -1
  82. package/dist/{cli-ma9ys8rt.js → cli-qx1dwrr5.js} +7 -4
  83. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  84. package/dist/{cli-agjbj5x0.js → cli-s6fhqbz1.js} +38 -20
  85. package/dist/{cli-kwr5qv5g.js → cli-sfajkbd7.js} +2 -2
  86. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  87. package/dist/{cli-e8n0hdzd.js → cli-snypfjgj.js} +1 -1
  88. package/dist/{cli-n8f0fs3c.js → cli-t25rq8mg.js} +11 -11
  89. package/dist/{cli-72yms3ey.js → cli-t90k0phh.js} +201 -21
  90. package/dist/{cli-xf4z5bdn.js → cli-tzzas8rb.js} +4 -4
  91. package/dist/{cli-rtmqzat7.js → cli-vdfngx2g.js} +2 -2
  92. package/dist/{cli-9w8712tq.js → cli-vr4eyq6p.js} +43 -14
  93. package/dist/{cli-z4f346g5.js → cli-vx9acp12.js} +1 -1
  94. package/dist/{cli-2amwhyv2.js → cli-w24f3j49.js} +13 -11
  95. package/dist/cli-w41bvvms.js +148 -0
  96. package/dist/{cli-04zc3f7b.js → cli-w6c6dj91.js} +1 -1
  97. package/dist/{cli-fy4gb74g.js → cli-x5yb8zc8.js} +2 -2
  98. package/dist/{cli-2tw284hj.js → cli-xhkek467.js} +3 -3
  99. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  100. package/dist/{cli-hbvgzjq4.js → cli-y6qqbpwc.js} +3 -3
  101. package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
  102. package/dist/{cli-1htmtqc2.js → cli-yeh3g1q6.js} +620 -95
  103. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  104. package/dist/{cli-k5jx8jya.js → cli-z6m6xzxt.js} +2 -2
  105. package/dist/{cli-pe3yxedk.js → cli-zaate0rd.js} +3 -3
  106. package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
  107. package/dist/{cli-e3ahxq5y.js → cli-zvpkrgsc.js} +6 -6
  108. package/dist/cli.js +30 -28
  109. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-ysfg6ty3.js} +8 -8
  110. package/dist/{codex-hook-aqtj17yr.js → codex-hook-c0nvm30r.js} +73 -2
  111. package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
  112. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-823scr6g.js} +9 -9
  113. package/dist/{commands-tsv2vx5b.js → commands-5rbm07fz.js} +3 -3
  114. package/dist/{controller-ye4sdwsy.js → controller-wn3vd217.js} +4 -4
  115. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-34jzhfft.js} +29 -28
  116. package/dist/core-kdehq26g.js +42 -0
  117. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-w1681kp1.js} +2 -2
  118. package/dist/{db-g111qn9j.js → db-6bkgbfwk.js} +3 -3
  119. package/dist/{db-3r1fyr2n.js → db-hcj16x7z.js} +4 -2
  120. package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
  121. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-jgjqrfzv.js} +28 -25
  122. package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
  123. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-g9yqv09y.js} +2 -2
  124. package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
  125. package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
  126. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-w17nsny6.js} +1 -1
  127. package/dist/{embedding-space-kcdn52vz.js → embedding-space-v06fwy7b.js} +6 -6
  128. package/dist/{embeddings-jnzcd91a.js → embeddings-g50dxea4.js} +1 -1
  129. package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
  130. package/dist/{execute-74amghty.js → execute-1n36haw1.js} +1 -1
  131. package/dist/{external-channel-v9zgxnxz.js → external-channel-43tv8pg6.js} +2 -2
  132. package/dist/fx-adapter-bvh05t4a.js +20 -0
  133. package/dist/grok-adapter-my5j8mdf.js +20 -0
  134. package/dist/handlers-wyymeeqh.js +41 -0
  135. package/dist/heartbeat-sf3nk937.js +50 -0
  136. package/dist/{hook-p5reemds.js → hook-dqph1e05.js} +77 -18
  137. package/dist/{hook-k1h73zd7.js → hook-m1m9dm6w.js} +6 -5
  138. package/dist/{http-ms1z5xxy.js → http-w0th1cz9.js} +888 -226
  139. package/dist/index-22khdtby.js +44 -0
  140. package/dist/{index-76zzxtzf.js → index-c0e8en64.js} +1 -1
  141. package/dist/{index-620y7jzq.js → index-e8pz8qdg.js} +3 -3
  142. package/dist/{index-8p0j4h4j.js → index-ez823q84.js} +94 -89
  143. package/dist/{index-fbkqhvvj.js → index-ffba0z8q.js} +217 -165
  144. package/dist/{index-gjn6qfgn.js → index-gkpfgpg7.js} +1 -1
  145. package/dist/{index-4k7m5dgj.js → index-k8ajc0g0.js} +143 -103
  146. package/dist/index-np0582ac.js +40 -0
  147. package/dist/{index-kn63q1gr.js → index-pb03vans.js} +33 -32
  148. package/dist/index-vgkrj1jt.js +39 -0
  149. package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
  150. package/dist/{index-0h6qd4p1.js → index-y4vd4mhn.js} +3 -4
  151. package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
  152. package/dist/{keepalive-031js8jz.js → keepalive-2v06q2e8.js} +5 -4
  153. package/dist/lead-55z813ng.js +79 -0
  154. package/dist/{maintenance-sq9v3qx9.js → maintenance-vx7vjhhy.js} +1 -1
  155. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-g06k4bza.js} +4 -3
  156. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-3dzdq4fm.js} +7 -7
  157. package/dist/{onboard-p25yhh7t.js → onboard-232pazny.js} +4 -4
  158. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-t0paqbh8.js} +8 -7
  159. package/dist/{otel-impl-ff1gf20m.js → otel-impl-kmpkyp4y.js} +2 -2
  160. package/dist/{pending-hxj5yatb.js → pending-x0z3vx1x.js} +27 -26
  161. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-7pmypn6d.js} +93 -22
  162. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-ytjmtyd7.js} +2 -2
  163. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-fgm5mxr2.js} +3 -3
  164. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-xyaxekh3.js} +7 -4
  165. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  166. package/dist/{render-v2-nrdkg9gf.js → render-v2-ws972g4r.js} +12 -8
  167. package/dist/{resume-s6ey36rh.js → resume-m6mjzhkp.js} +13 -12
  168. package/dist/{runtime-x0b4pyam.js → runtime-zzpc0c8a.js} +1 -1
  169. package/dist/{session-access-xv49tk14.js → session-access-vp35xs91.js} +5 -4
  170. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-p73e8zbe.js} +3 -3
  171. package/dist/{setup-mj0krk1p.js → setup-r4kd7rxg.js} +1 -1
  172. package/dist/thread-buffer-cm2nzq6t.js +42 -0
  173. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-07h2tbs2.js} +2 -2
  174. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-96vg9rpe.js} +3 -3
  175. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-vgn3f2x4.js} +3 -3
  176. package/dist/{work-objects-pydhzast.js → work-objects-74hbcx3e.js} +31 -29
  177. package/dist/worker-5pn2vzx6.js +79 -0
  178. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-ezavwn5d.js} +26 -25
  179. package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
  180. package/dist/xlsx-9acfmxr1.js +31534 -0
  181. package/openapi.json +2816 -1464
  182. package/package.json +13 -11
  183. package/src/agentmail/handlers.ts +26 -19
  184. package/src/apps/catalog.generated.json +757 -0
  185. package/src/apps/definition.ts +24 -7
  186. package/src/apps/page-validator.ts +225 -3
  187. package/src/apps/row-store.ts +37 -14
  188. package/src/azure-devops/handlers.ts +2 -0
  189. package/src/be/audit-user.ts +46 -6
  190. package/src/be/db/kv-windows.ts +22 -0
  191. package/src/be/db/session-moves.ts +3 -3
  192. package/src/be/db/session-tree.ts +52 -5
  193. package/src/be/db/skill-audit.ts +17 -0
  194. package/src/be/db/tasks/write.ts +18 -3
  195. package/src/be/db.ts +152 -33
  196. package/src/be/extensions/assets.ts +11 -7
  197. package/src/be/mcp-proxy.ts +5 -4
  198. package/src/be/memory/demotion-evidence.ts +2 -2
  199. package/src/be/memory/providers/sqlite-store.ts +151 -18
  200. package/src/be/memory/search-read-worker.ts +60 -0
  201. package/src/be/memory/search-reader.ts +223 -0
  202. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  203. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  204. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  205. package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
  206. package/src/be/model-tier-resolution.ts +18 -1
  207. package/src/be/multi-runtime.ts +17 -0
  208. package/src/be/primitives/object-embed.ts +250 -0
  209. package/src/be/primitives/objects.ts +29 -9
  210. package/src/be/primitives/sheets/service.ts +138 -6
  211. package/src/be/primitives/sheets/xlsx.ts +367 -0
  212. package/src/be/rbac-roles.ts +3 -0
  213. package/src/be/repo-checked-update.ts +4 -4
  214. package/src/be/repo-merge-policy.ts +26 -9
  215. package/src/be/schedules/validate.ts +26 -0
  216. package/src/be/scripts/boot-reembed.ts +6 -0
  217. package/src/be/scripts/db.ts +17 -5
  218. package/src/be/scripts/embeddings.ts +6 -0
  219. package/src/be/scripts/typecheck.ts +43 -2
  220. package/src/be/seed/schedules-seeder.ts +9 -1
  221. package/src/be/seed/workflows-seeder.ts +9 -1
  222. package/src/be/seed-scripts/index.ts +2 -0
  223. package/src/be/seed-skills/index.ts +12 -0
  224. package/src/be/swarm-config-guard.ts +5 -0
  225. package/src/be/unmapped-identities.ts +95 -1
  226. package/src/bitbucket/handlers.ts +2 -0
  227. package/src/commands/credential-outcome-report.ts +5 -2
  228. package/src/commands/onboard/agent-fs-version.ts +1 -1
  229. package/src/commands/provider-credentials.ts +19 -0
  230. package/src/commands/provider-error-class.ts +4 -1
  231. package/src/commands/rate-limit-outcome.ts +48 -3
  232. package/src/commands/runner.ts +113 -55
  233. package/src/commands/worktree-reaper.ts +600 -0
  234. package/src/event-waits/github.ts +43 -0
  235. package/src/event-waits/index.ts +29 -0
  236. package/src/event-waits/types.ts +51 -0
  237. package/src/extensions/contract-types.generated.ts +1 -1
  238. package/src/extensions/dispatcher.ts +9 -0
  239. package/src/fs/agent-fs-provider.ts +4 -1
  240. package/src/github/handlers.ts +3 -1
  241. package/src/github/pull-request-state.ts +34 -0
  242. package/src/gitlab/handlers.ts +12 -7
  243. package/src/hooks/codex-hook.ts +99 -1
  244. package/src/hooks/hook.ts +85 -11
  245. package/src/hooks/native-tool-hooks.ts +245 -0
  246. package/src/http/agents.ts +4 -0
  247. package/src/http/all-routes.ts +1 -0
  248. package/src/http/api-keys.ts +27 -3
  249. package/src/http/assets.ts +4 -3
  250. package/src/http/comb.ts +2 -2
  251. package/src/http/favorite-owner.ts +2 -2
  252. package/src/http/favorites.ts +3 -2
  253. package/src/http/fs.ts +13 -4
  254. package/src/http/index.ts +2 -0
  255. package/src/http/mcp-bridge.ts +4 -0
  256. package/src/http/objects.ts +265 -0
  257. package/src/http/pages-public.ts +40 -4
  258. package/src/http/pages.ts +3 -3
  259. package/src/http/poll.ts +43 -12
  260. package/src/http/pool-keys.ts +21 -2
  261. package/src/http/repos.ts +7 -6
  262. package/src/http/schedules.ts +38 -9
  263. package/src/http/script-connections.ts +14 -6
  264. package/src/http/script-runs.ts +12 -3
  265. package/src/http/scripts.ts +9 -0
  266. package/src/http/sessions.ts +30 -12
  267. package/src/http/skills.ts +17 -0
  268. package/src/http/task-requester.ts +2 -2
  269. package/src/http/tasks.ts +18 -12
  270. package/src/http/tool-hooks.ts +24 -2
  271. package/src/http/trackers/authorize-gate.ts +2 -2
  272. package/src/http/users.ts +136 -1
  273. package/src/http/workflow-events.ts +13 -0
  274. package/src/http/workflows.ts +21 -11
  275. package/src/linear/sync.ts +3 -1
  276. package/src/mcp-client/http-client.ts +3 -1
  277. package/src/oauth/identity-capture.ts +6 -1
  278. package/src/oauth/mcp-wrapper.ts +10 -3
  279. package/src/oauth/wrapper.ts +15 -3
  280. package/src/prompts/base-prompt.ts +35 -13
  281. package/src/prompts/session-templates.ts +26 -0
  282. package/src/providers/acp-targets.ts +2 -2
  283. package/src/providers/amp-adapter.ts +1 -1
  284. package/src/providers/dsh-adapter.ts +1 -1
  285. package/src/providers/opencode-adapter.ts +1 -0
  286. package/src/providers/opencode-swarm-plugin.ts +50 -1
  287. package/src/providers/pi-mono-adapter.ts +143 -11
  288. package/src/providers/pi-mono-extension.ts +69 -0
  289. package/src/providers/runtime-dependencies.ts +1 -1
  290. package/src/rbac/legacy-policy.ts +5 -0
  291. package/src/rbac/permissions.ts +16 -1
  292. package/src/scheduler/deferred-task-waits.ts +170 -13
  293. package/src/scripts-runtime/executors/types.ts +5 -0
  294. package/src/scripts-runtime/loader.ts +8 -0
  295. package/src/scripts-runtime/mcp-client.ts +4 -0
  296. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  297. package/src/scripts-runtime/swarm-config.ts +8 -0
  298. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  299. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  300. package/src/scripts-runtime/types/swarm-extension.d.ts +8 -7
  301. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  302. package/src/server.ts +4 -0
  303. package/src/slack/enrich.ts +94 -31
  304. package/src/slack/handlers.test.ts +55 -2
  305. package/src/slack/handlers.ts +38 -3
  306. package/src/slack/render-v2.ts +19 -0
  307. package/src/slack/session-mirror.ts +208 -0
  308. package/src/slack/thread-participants.ts +0 -5
  309. package/src/slack/watcher.ts +3 -0
  310. package/src/slack/work-objects.test.ts +2 -1
  311. package/src/slack/work-objects.ts +7 -2
  312. package/src/tests/agentmail-filters.test.ts +4 -3
  313. package/src/tests/agents-list-model-display.test.ts +23 -0
  314. package/src/tests/apps-spike2.test.ts +35 -0
  315. package/src/tests/audit-agent-person.test.ts +825 -0
  316. package/src/tests/audit-updated-by.test.ts +19 -12
  317. package/src/tests/base-prompt.test.ts +1 -0
  318. package/src/tests/claude-hook-output.test.ts +107 -2
  319. package/src/tests/claude-managed-setup.test.ts +1 -1
  320. package/src/tests/codex-adapter.test.ts +6 -6
  321. package/src/tests/codex-gpt6-release.test.ts +4 -4
  322. package/src/tests/db-task-read-contract.test.ts +1 -0
  323. package/src/tests/db-task-write-contract.test.ts +1 -0
  324. package/src/tests/deploy-guard.test.ts +24 -0
  325. package/src/tests/dsh-adapter.test.ts +1 -1
  326. package/src/tests/ensure-token.test.ts +2 -2
  327. package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
  328. package/src/tests/extensions-catalog.test.ts +33 -25
  329. package/src/tests/fake-dns.ts +47 -0
  330. package/src/tests/fixtures/base-prompt-baseline.json +12 -12
  331. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  332. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  333. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  334. package/src/tests/kv-storage.test.ts +3 -0
  335. package/src/tests/latest-model-report.test.ts +138 -0
  336. package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
  337. package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
  338. package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
  339. package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
  340. package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
  341. package/src/tests/mcp-server-ssrf.test.ts +2 -0
  342. package/src/tests/memory-search-reader.test.ts +258 -0
  343. package/src/tests/memory-search-stall.test.ts +202 -20
  344. package/src/tests/model-control.test.ts +4 -4
  345. package/src/tests/model-tier-resolution.test.ts +2 -2
  346. package/src/tests/multi-runtime-registration.test.ts +8 -2
  347. package/src/tests/native-tool-hooks.test.ts +188 -0
  348. package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
  349. package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
  350. package/src/tests/oauth-wrapper.test.ts +1 -2
  351. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  352. package/src/tests/pages-head-v2.test.ts +2 -1
  353. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  354. package/src/tests/poll-probe-readonly.test.ts +108 -0
  355. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  356. package/src/tests/prompt-template-session.test.ts +3 -2
  357. package/src/tests/rbac-roles.test.ts +3 -0
  358. package/src/tests/script-connections-http.test.ts +8 -3
  359. package/src/tests/script-connections.test.ts +6 -0
  360. package/src/tests/seed-model-profiles.test.ts +1 -1
  361. package/src/tests/sessions-tree.test.ts +10 -2
  362. package/src/tests/slack-thread-participants.test.ts +77 -4
  363. package/src/tests/spend-cap-credentials.test.ts +34 -0
  364. package/src/tests/spend-cap-outcome.test.ts +67 -0
  365. package/src/tests/subscription-first.test.ts +119 -0
  366. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  367. package/src/tests/worktree-reaper.test.ts +424 -0
  368. package/src/tools/defer-task.ts +154 -12
  369. package/src/tools/get-task-details.ts +247 -5
  370. package/src/tools/objects.ts +10 -5
  371. package/src/tools/repos/update-repo.ts +6 -6
  372. package/src/tools/schedules/create-schedule.ts +1 -0
  373. package/src/tools/schedules/list-schedules.ts +3 -0
  374. package/src/tools/schedules/patch-schedule.ts +38 -4
  375. package/src/tools/schedules/update-schedule.ts +40 -5
  376. package/src/tools/sheets.ts +66 -0
  377. package/src/tools/skills/skill-create.ts +6 -0
  378. package/src/tools/skills/skill-install-remote.ts +6 -0
  379. package/src/tools/skills/skill-sync-remote.ts +9 -0
  380. package/src/tools/skills/skill-update.ts +9 -1
  381. package/src/tools/tool-config.ts +3 -1
  382. package/src/tools/utils.ts +15 -0
  383. package/src/tools/workflows/create-workflow.ts +9 -4
  384. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  385. package/src/tools/workflows/patch-workflow.ts +5 -2
  386. package/src/tools/workflows/update-workflow.ts +13 -7
  387. package/src/types.ts +96 -12
  388. package/src/utils/credentials.ts +36 -1
  389. package/src/utils/egress-guard.ts +40 -10
  390. package/src/utils/error-tracker.ts +17 -0
  391. package/src/workflows/input.ts +12 -5
  392. package/src/workflows/patch-definition.ts +13 -5
  393. package/src/workflows/triggers.ts +11 -6
  394. package/src/workflows/version.ts +7 -1
  395. package/templates/skills/apps/SKILL.md +191 -2
  396. package/templates/skills/apps/content.md +191 -2
  397. package/templates/skills/boards-and-sheets/config.json +14 -0
  398. package/templates/skills/boards-and-sheets/content.md +174 -0
  399. package/templates/skills/pages/content.md +11 -0
  400. package/templates/skills/swarm-docs/content.md +11 -0
  401. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  402. package/templates/skills/swarm-scripts/content.md +1 -0
  403. package/templates/workflows/ralph-loop/content.md +6 -6
  404. package/dist/acp-adapter-11m13kx4.js +0 -16
  405. package/dist/cli-pr0eze3x.js +0 -149
  406. package/dist/core-dxcy02sc.js +0 -41
  407. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  408. package/dist/grok-adapter-t6m74fb1.js +0 -19
  409. package/dist/handlers-9kwcrc4k.js +0 -38
  410. package/dist/heartbeat-p8pk1msj.js +0 -49
  411. package/dist/index-23cdfzr6.js +0 -39
  412. package/dist/index-g7kkjs5b.js +0 -38
  413. package/dist/index-stk36pa5.js +0 -43
  414. package/dist/lead-mfggjtfk.js +0 -77
  415. package/dist/thread-buffer-temgaqsy.js +0 -41
  416. package/dist/worker-efcemc22.js +0 -77
  417. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -5,9 +5,18 @@ import {
5
5
  getUserById,
6
6
  updateScheduledTask,
7
7
  } from "@/be/db";
8
+ import {
9
+ describeEventWait,
10
+ type EventMatch,
11
+ EXTERNAL_EVENT_ADAPTERS,
12
+ type ExternalEvent,
13
+ type ExternalEventAdapter,
14
+ getExternalEventAdapter,
15
+ matchKeyOf,
16
+ } from "@/event-waits";
8
17
  import type { PreparedTaskCreate } from "@/tasks/sibling-awareness";
9
18
  import { type AgentTask, type ScheduledTask, SUPERSEDED_WORKFLOW_TASK_REASON } from "@/types";
10
- import { workflowEventBus } from "@/workflows/event-bus";
19
+ import { type PrefixHandler, workflowEventBus } from "@/workflows/event-bus";
11
20
  import { createStandaloneScheduleTask, prepareStandaloneScheduleTask } from "./schedule-task";
12
21
 
13
22
  export type TaskWakeEvent = "task.completed" | "task.failed" | "settled";
@@ -21,7 +30,33 @@ type TaskWait = {
21
30
 
22
31
  type WaitMember = { taskId: string; taskStatus: string | null; deferred: number };
23
32
 
24
- type WakeReason = "ceiling" | "task.completed" | "task.failed" | "task.cancelled" | "task.skipped";
33
+ type WakeReason =
34
+ | "ceiling"
35
+ | "task.completed"
36
+ | "task.failed"
37
+ | "task.cancelled"
38
+ | "task.skipped"
39
+ | `external:${string}`;
40
+
41
+ type WaitTable = "deferred_task_waits" | "deferred_event_waits";
42
+
43
+ /** An external-event wait: the sibling of a task wait, keyed by the same one-time schedule. */
44
+ type EventWait = {
45
+ scheduleId: string;
46
+ source: string;
47
+ event: string;
48
+ matchKey: string;
49
+ matchJson: string;
50
+ status: "pending" | "fired";
51
+ };
52
+
53
+ /** The wake reason for an external event; it is also what the wait row records as `firedBy`. */
54
+ export function externalWakeReason(source: string, event: string): WakeReason {
55
+ return `external:${source}:${event}`;
56
+ }
57
+
58
+ /** Pending external waits one agent may hold, so a runaway agent cannot flood the webhook fan-out. */
59
+ export const MAX_PENDING_EVENT_WAITS_PER_AGENT = 20;
25
60
 
26
61
  /**
27
62
  * A member's status as waits see it. A workflow step cut by a supersede is
@@ -42,21 +77,49 @@ const WAIT_MEMBER_STATUS_SQL = `CASE
42
77
  * Pure reads: callers run it once outside the transaction (to build the task
43
78
  * through the extension pre-hooks) and once more under the write lock, where
44
79
  * the answer is authoritative. An event only identifies a candidate wait; it
45
- * never proves the set is ready.
80
+ * never proves the set is ready. An external wait reads no provider here (no network
81
+ * under the write lock): its caller confirms the event first, then dispatches.
46
82
  */
47
83
  async function resolveWaitCause(
48
84
  scheduleId: string,
49
85
  reason: WakeReason,
50
- ): Promise<{ wait: TaskWait; cause: string; matchedTaskIds: string[] } | undefined> {
86
+ ): Promise<
87
+ { table: WaitTable; mode?: "all" | "any"; cause: string; matchedTaskIds: string[] } | undefined
88
+ > {
51
89
  const client = getDbClient();
52
90
  const wait = await client.get<TaskWait>(
53
91
  "SELECT * FROM deferred_task_waits WHERE scheduleId = ?",
54
92
  [scheduleId],
55
93
  );
56
- if (!wait || wait.status !== "pending") return undefined;
94
+ if (!wait) {
95
+ const eventWait = await client.get<EventWait>(
96
+ "SELECT * FROM deferred_event_waits WHERE scheduleId = ?",
97
+ [scheduleId],
98
+ );
99
+ if (!eventWait || eventWait.status !== "pending") return undefined;
100
+ if (reason === "ceiling")
101
+ return { table: "deferred_event_waits", cause: "ceiling expired", matchedTaskIds: [] };
102
+ if (reason !== externalWakeReason(eventWait.source, eventWait.event)) return undefined;
103
+ return {
104
+ table: "deferred_event_waits",
105
+ cause: describeEventWait(
106
+ eventWait.source,
107
+ eventWait.event,
108
+ JSON.parse(eventWait.matchJson) as EventMatch,
109
+ ),
110
+ matchedTaskIds: [],
111
+ };
112
+ }
113
+ if (wait.status !== "pending") return undefined;
57
114
  if (reason !== "ceiling" && wait.eventName !== "settled" && wait.eventName !== reason)
58
115
  return undefined;
59
- if (reason === "ceiling") return { wait, cause: "ceiling expired", matchedTaskIds: [] };
116
+ if (reason === "ceiling")
117
+ return {
118
+ table: "deferred_task_waits",
119
+ mode: wait.mode,
120
+ cause: "ceiling expired",
121
+ matchedTaskIds: [],
122
+ };
60
123
  const members = await client.query<WaitMember>(
61
124
  `SELECT m.taskId, ${WAIT_MEMBER_STATUS_SQL} AS taskStatus, EXISTS (
62
125
  SELECT 1 FROM scheduled_tasks d
@@ -81,7 +144,12 @@ async function resolveWaitCause(
81
144
  members.length === 1
82
145
  ? `task.${matched[0]!.taskStatus} for task ${matched[0]!.taskId}`
83
146
  : `${wait.mode} tasks matched ${wait.eventName}: ${matched.map((member) => `${member.taskId} (${member.taskStatus})`).join(", ")}`;
84
- return { wait, cause, matchedTaskIds: matched.map((member) => member.taskId) };
147
+ return {
148
+ table: "deferred_task_waits",
149
+ mode: wait.mode,
150
+ cause,
151
+ matchedTaskIds: matched.map((member) => member.taskId),
152
+ };
85
153
  }
86
154
 
87
155
  function wakeSchedule(schedule: ScheduledTask, cause: string): ScheduledTask {
@@ -120,9 +188,11 @@ export async function prepareDeferredTaskWait(
120
188
  const client = getDbClient();
121
189
  // Keep ordinary schedule dispatch off the write-lock path.
122
190
  if (
123
- !(await client.get<TaskWait>("SELECT * FROM deferred_task_waits WHERE scheduleId = ?", [
124
- scheduleId,
125
- ]))
191
+ !(await client.get(
192
+ `SELECT 1 AS found FROM deferred_task_waits WHERE scheduleId = ?
193
+ UNION ALL SELECT 1 FROM deferred_event_waits WHERE scheduleId = ?`,
194
+ [scheduleId, scheduleId],
195
+ ))
126
196
  )
127
197
  return undefined;
128
198
  // Extension pre-hooks must run outside the transaction, so build the wake-up task
@@ -152,7 +222,7 @@ export async function dispatchDeferredTaskWait(
152
222
  if (!schedule?.enabled) return {};
153
223
  const now = new Date().toISOString();
154
224
  const claimed = await client.run(
155
- "UPDATE deferred_task_waits SET status = 'fired', firedBy = ?, resolvedAt = ?, updated_at = ? WHERE scheduleId = ? AND status = 'pending'",
225
+ `UPDATE ${resolved.table} SET status = 'fired', firedBy = ?, resolvedAt = ?, updated_at = ? WHERE scheduleId = ? AND status = 'pending'`,
156
226
  [reason, now, now, scheduleId],
157
227
  );
158
228
  if (!claimed.changes) return {};
@@ -165,7 +235,7 @@ export async function dispatchDeferredTaskWait(
165
235
  extraTags,
166
236
  preparedForWait,
167
237
  );
168
- await client.run("UPDATE deferred_task_waits SET childTaskId = ? WHERE scheduleId = ?", [
238
+ await client.run(`UPDATE ${resolved.table} SET childTaskId = ? WHERE scheduleId = ?`, [
169
239
  task.id,
170
240
  scheduleId,
171
241
  ]);
@@ -183,7 +253,7 @@ export async function dispatchDeferredTaskWait(
183
253
  waiterTaskId: schedule.parentTaskId ?? null,
184
254
  wakeTaskId: task.id,
185
255
  wakeAgentId: task.agentId ?? null,
186
- mode: resolved.wait.mode,
256
+ mode: resolved.mode,
187
257
  },
188
258
  });
189
259
  }
@@ -286,12 +356,86 @@ export async function reapSpentDeferredSchedules(now = new Date()): Promise<numb
286
356
  AND NOT EXISTS (
287
357
  SELECT 1 FROM deferred_task_waits w
288
358
  WHERE w.scheduleId = scheduled_tasks.id AND w.status = 'pending'
359
+ )
360
+ AND NOT EXISTS (
361
+ SELECT 1 FROM deferred_event_waits e
362
+ WHERE e.scheduleId = scheduled_tasks.id AND e.status = 'pending'
289
363
  )`,
290
364
  [cutoff],
291
365
  );
292
366
  return result.changes;
293
367
  }
294
368
 
369
+ /**
370
+ * Fire pending external-event waits. A webhook names the candidate target (`only`)
371
+ * and sets `trustEvent`: an adapter without `confirm` fires on it, one with `confirm`
372
+ * still has to read the provider first. With no `trustEvent` (boot, and the recheck
373
+ * after a wait is created, which catches a delivery missed while the API was down or
374
+ * before the wait existed) only adapters that can `confirm` are checked. A read that
375
+ * fails leaves the wait pending: the ceiling still wakes the agent.
376
+ */
377
+ export async function reconcileDeferredEventWaits(
378
+ only?: { source: string; event: string; matchKey: string },
379
+ trustEvent = false,
380
+ ): Promise<void> {
381
+ const waits = await getDbClient().query<
382
+ Pick<EventWait, "scheduleId" | "source" | "event" | "matchKey" | "matchJson">
383
+ >(
384
+ `SELECT w.scheduleId, w.source, w.event, w.matchKey, w.matchJson FROM deferred_event_waits w
385
+ JOIN scheduled_tasks s ON s.id = w.scheduleId
386
+ WHERE w.status = 'pending' AND s.enabled = 1
387
+ ${only ? "AND w.source = ? AND w.event = ? AND w.matchKey = ?" : ""}`,
388
+ only ? [only.source, only.event, only.matchKey] : [],
389
+ );
390
+ const satisfied = new Map<string, boolean>();
391
+ for (const wait of waits) {
392
+ const adapter = getExternalEventAdapter(wait.source);
393
+ if (!adapter || (!adapter.confirm && !trustEvent)) continue;
394
+ const key = `${wait.source}|${wait.event}|${wait.matchKey}`;
395
+ try {
396
+ if (!satisfied.has(key))
397
+ satisfied.set(
398
+ key,
399
+ adapter.confirm
400
+ ? await adapter.confirm(wait.event, JSON.parse(wait.matchJson) as EventMatch)
401
+ : true,
402
+ );
403
+ if (satisfied.get(key))
404
+ await dispatchDeferredTaskWait(
405
+ wait.scheduleId,
406
+ externalWakeReason(wait.source, wait.event),
407
+ );
408
+ } catch (err) {
409
+ // A broken wait must not stop the others or the ceiling poller.
410
+ console.error(`[Scheduler] External event wake failed for ${wait.scheduleId}:`, err);
411
+ }
412
+ }
413
+ }
414
+
415
+ /** One bus listener per adapter, kept so `stop` can detach exactly what `init` attached. */
416
+ const externalEventListeners = new Map<ExternalEventAdapter, PrefixHandler>();
417
+
418
+ function externalEventListener(adapter: ExternalEventAdapter): PrefixHandler {
419
+ return (busEvent, payload) => {
420
+ // The bus emit loop has no guard: a throwing adapter must not 500 the webhook or skip later handlers.
421
+ let events: ExternalEvent[];
422
+ try {
423
+ events = adapter.fromBusEvent(busEvent, payload);
424
+ } catch (err) {
425
+ console.error(`[Scheduler] ${adapter.source} adapter failed to read ${busEvent}:`, err);
426
+ return;
427
+ }
428
+ for (const { event, match } of events) {
429
+ void reconcileDeferredEventWaits(
430
+ { source: adapter.source, event, matchKey: matchKeyOf(match) },
431
+ true,
432
+ ).catch((err) => {
433
+ console.error("[Scheduler] External event wake failed:", err);
434
+ });
435
+ }
436
+ };
437
+ }
438
+
295
439
  function onTaskEvent(payload: unknown): void {
296
440
  if (
297
441
  !payload ||
@@ -315,7 +459,16 @@ export async function initDeferredTaskWaits(): Promise<void> {
315
459
  workflowEventBus.on("task.superseded", onTaskEvent);
316
460
  // The resume may be committed after its parent's supersede event.
317
461
  workflowEventBus.on("task.created", onTaskEvent);
462
+ for (const adapter of EXTERNAL_EVENT_ADAPTERS) {
463
+ const listener = externalEventListener(adapter);
464
+ externalEventListeners.set(adapter, listener);
465
+ workflowEventBus.onPrefix(adapter.busPrefix, listener);
466
+ }
318
467
  await reconcileDeferredTaskWaits();
468
+ // Provider reads can be slow or down: never hold boot on them.
469
+ void reconcileDeferredEventWaits().catch((err) => {
470
+ console.error("[Scheduler] External event boot reconcile failed:", err);
471
+ });
319
472
  }
320
473
 
321
474
  export function stopDeferredTaskWaits(): void {
@@ -325,4 +478,8 @@ export function stopDeferredTaskWaits(): void {
325
478
  workflowEventBus.off("task.skipped", onTaskEvent);
326
479
  workflowEventBus.off("task.superseded", onTaskEvent);
327
480
  workflowEventBus.off("task.created", onTaskEvent);
481
+ for (const [adapter, listener] of externalEventListeners) {
482
+ workflowEventBus.offPrefix(adapter.busPrefix, listener);
483
+ }
484
+ externalEventListeners.clear();
328
485
  }
@@ -23,6 +23,11 @@ export type SwarmConfigPayload = {
23
23
  * context like the agent identity — scripts never supply or override it.
24
24
  */
25
25
  runtimeInstanceId?: { value: string; isSecret: false };
26
+ /**
27
+ * Task the run acts for; sent as `X-Audit-Source-Task-Id`, read only by the
28
+ * audit resolvers. Never `X-Source-Task-Id`, which rescopes kv and send-task.
29
+ */
30
+ auditSourceTaskId?: { value: string; isSecret: false };
26
31
  /**
27
32
  * Per-process secret set only by the in-process extension `ctx.swarm` SDK. The
28
33
  * bridge requires it to grant the `extension` call origin. Never sent to scripts.
@@ -63,6 +63,11 @@ export type RunScriptInput = {
63
63
  apiKey?: string;
64
64
  /** Per-boot runtime identity of the invoking worker; system context, never script input. */
65
65
  runtimeInstanceId?: string;
66
+ /**
67
+ * Task the run acts for, sent as `X-Audit-Source-Task-Id` on its `ctx.swarm`
68
+ * calls so their writes get the same audit person. The api re-checks ownership.
69
+ */
70
+ sourceTaskId?: string;
66
71
  signal?: AbortSignal;
67
72
  timeoutMs?: number;
68
73
  mcpBaseUrl?: string;
@@ -109,6 +114,9 @@ async function buildConfigPayload(input: RunScriptInput): Promise<SwarmConfigPay
109
114
  ...(input.runtimeInstanceId
110
115
  ? { runtimeInstanceId: { value: input.runtimeInstanceId, isSecret: false as const } }
111
116
  : {}),
117
+ ...(input.sourceTaskId
118
+ ? { auditSourceTaskId: { value: input.sourceTaskId, isSecret: false as const } }
119
+ : {}),
112
120
  },
113
121
  user: input.userConfig ?? {},
114
122
  egressSecrets: input.egressSecrets ?? (await buildEgressSecrets()),
@@ -36,6 +36,10 @@ function headers(config: SwarmConfig): Record<string, string> {
36
36
  return {
37
37
  Authorization: `Bearer ${Redacted.value(config.apiKey)}`,
38
38
  "X-Agent-ID": Redacted.value(config.agentId),
39
+ // Audit-only header: X-Source-Task-Id would also rescope kv, parent send-task, etc.
40
+ ...(config.auditSourceTaskId
41
+ ? { "X-Audit-Source-Task-Id": Redacted.value(config.auditSourceTaskId) }
42
+ : {}),
39
43
  "Content-Type": "application/json",
40
44
  };
41
45
  }
@@ -49,6 +49,8 @@ export const SDK_TOOL_NAME_MAP = {
49
49
  sheets_appendRows: "sheet-append-rows",
50
50
  sheets_clearRange: "sheet-clear-range",
51
51
  sheets_addTab: "sheet-add-tab",
52
+ sheets_importXlsx: "sheet-import-xlsx",
53
+ sheets_exportXlsx: "sheet-export-xlsx",
52
54
  // ── boards (also ctx.boards, see SDK_NAMESPACES) ──
53
55
  boards_create: "board-create",
54
56
  boards_get: "board-get",
@@ -268,7 +270,18 @@ export type SdkNamespaceRegistry = Readonly<Record<string, readonly string[]>>;
268
270
  */
269
271
  export const SDK_NAMESPACES: SdkNamespaceRegistry = Object.freeze({
270
272
  objects: ["create", "get", "list", "reindex"],
271
- sheets: ["create", "get", "list", "getRange", "setRange", "appendRows", "clearRange", "addTab"],
273
+ sheets: [
274
+ "create",
275
+ "get",
276
+ "list",
277
+ "getRange",
278
+ "setRange",
279
+ "appendRows",
280
+ "clearRange",
281
+ "addTab",
282
+ "importXlsx",
283
+ "exportXlsx",
284
+ ],
272
285
  boards: ["create", "get", "list", "addElements", "updateElements", "removeElements"],
273
286
  });
274
287
 
@@ -7,6 +7,8 @@ export class SwarmConfig {
7
7
  readonly mcpBaseUrl: RedactedValue<string>;
8
8
  /** Per-boot runtime identity of the invoking worker; system context, never script input. */
9
9
  readonly runtimeInstanceId: RedactedValue<string> | undefined;
10
+ /** Task the run acts for; system context, sent as `X-Audit-Source-Task-Id`. */
11
+ readonly auditSourceTaskId: RedactedValue<string> | undefined;
10
12
  /** Per-process extension bridge secret; present only for in-process extension SDKs. */
11
13
  readonly extensionToken: RedactedValue<string> | undefined;
12
14
 
@@ -31,6 +33,12 @@ export class SwarmConfig {
31
33
  isSecret: payload.system.runtimeInstanceId.isSecret,
32
34
  })
33
35
  : undefined;
36
+ this.auditSourceTaskId = payload.system.auditSourceTaskId
37
+ ? Redacted.make(payload.system.auditSourceTaskId.value, {
38
+ type: "system",
39
+ isSecret: payload.system.auditSourceTaskId.isSecret,
40
+ })
41
+ : undefined;
34
42
  this.extensionToken = payload.system.extensionToken
35
43
  ? Redacted.make(payload.system.extensionToken.value, {
36
44
  type: "system",
@@ -30,6 +30,10 @@ function headers(config: SwarmConfig): Record<string, string> {
30
30
  ...(config.runtimeInstanceId
31
31
  ? { "X-Runtime-Instance-ID": Redacted.value(config.runtimeInstanceId) }
32
32
  : {}),
33
+ // Audit-only header: X-Source-Task-Id would also rescope kv, parent send-task, etc.
34
+ ...(config.auditSourceTaskId
35
+ ? { "X-Audit-Source-Task-Id": Redacted.value(config.auditSourceTaskId) }
36
+ : {}),
33
37
  ...(config.extensionToken
34
38
  ? { "X-Extension-Token": Redacted.value(config.extensionToken) }
35
39
  : {}),
@@ -248,8 +248,17 @@ declare module "swarm-sdk" {
248
248
  truncated: boolean;
249
249
  /** Which limit cut this call short; null when the pass finished. */
250
250
  cutBy: "files" | "reads" | "time" | "bytes" | null;
251
+ /** True when nothing was written: `adopted` and `restored` list what a real run would change. */
252
+ dryRun: boolean;
251
253
  }
252
254
 
255
+ /** `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. */
256
+ export type PrimitiveReindexArgs = {
257
+ kind?: PrimitiveObjectKind;
258
+ prefix?: string;
259
+ dryRun?: boolean;
260
+ };
261
+
253
262
  /**
254
263
  * Primitive objects: agent-fs files on your default drive with a stable id.
255
264
  * Calls run as your own agent-fs identity. Each method throws on a refusal.
@@ -273,9 +282,7 @@ declare module "swarm-sdk" {
273
282
  offset?: number;
274
283
  }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
275
284
  /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
276
- reindex(args?: {
277
- kind?: PrimitiveObjectKind;
278
- }): Promise<{ message: string } & PrimitiveReindexReport>;
285
+ reindex(args?: PrimitiveReindexArgs): Promise<{ message: string } & PrimitiveReindexReport>;
279
286
  }
280
287
 
281
288
  /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
@@ -306,6 +313,36 @@ declare module "swarm-sdk" {
306
313
  freezeRows: number;
307
314
  }
308
315
 
316
+ export interface SheetImportXlsxArgs {
317
+ /** An `.xlsx` on the drive. */
318
+ sourcePath: string;
319
+ /** The new sheet; must end in `.sheet.json`. */
320
+ path: string;
321
+ title?: string;
322
+ }
323
+
324
+ export interface SheetImportXlsxResult {
325
+ message: string;
326
+ object: PrimitiveObject;
327
+ link: string | null;
328
+ /** What the file had that a sheet cannot hold. */
329
+ dropped: string[];
330
+ }
331
+
332
+ export interface SheetExportXlsxArgs extends SheetRef {
333
+ targetPath: string;
334
+ /** Replace `targetPath` when it exists. */
335
+ overwrite?: boolean;
336
+ }
337
+
338
+ export interface SheetExportXlsxResult {
339
+ message: string;
340
+ path: string;
341
+ link: string | null;
342
+ /** What the sheet had that xlsx cannot carry. */
343
+ dropped: string[];
344
+ }
345
+
309
346
  export interface SheetResult {
310
347
  message: string;
311
348
  /** agent-fs version after the call. */
@@ -345,6 +382,10 @@ declare module "swarm-sdk" {
345
382
  addTab(
346
383
  args: SheetRef & { name: string; after?: string },
347
384
  ): Promise<SheetResult & { tabs: string[] }>;
385
+ /** 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. */
386
+ importXlsx(args: SheetImportXlsxArgs): Promise<SheetImportXlsxResult>;
387
+ /** Create-only unless `overwrite`. `targetPath` must end in `.xlsx`. `dropped` names what xlsx cannot carry (frozen panes, spilled array cells). */
388
+ exportXlsx(args: SheetExportXlsxArgs): Promise<SheetExportXlsxResult>;
348
389
  }
349
390
 
350
391
  /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
@@ -550,7 +591,7 @@ declare module "swarm-sdk" {
550
591
  limit?: number;
551
592
  offset?: number;
552
593
  }): Promise<unknown>;
553
- objects_reindex(args?: { kind?: PrimitiveObjectKind }): Promise<unknown>;
594
+ objects_reindex(args?: PrimitiveReindexArgs): Promise<unknown>;
554
595
  // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
555
596
  sheets_create(args: SheetCreateArgs): Promise<unknown>;
556
597
  sheets_get(args: SheetRef): Promise<unknown>;
@@ -560,6 +601,8 @@ declare module "swarm-sdk" {
560
601
  sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
561
602
  sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
562
603
  sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
604
+ sheets_importXlsx(args: SheetImportXlsxArgs): Promise<unknown>;
605
+ sheets_exportXlsx(args: SheetExportXlsxArgs): Promise<unknown>;
563
606
  // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
564
607
  boards_create(args: BoardCreateArgs): Promise<unknown>;
565
608
  boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
@@ -118,13 +118,13 @@ declare module "swarm-extension" {
118
118
  sourceAgentId?: string | undefined;
119
119
  role?: string | undefined;
120
120
  harnessProvider?:
121
+ | "codex"
121
122
  | "pi"
123
+ | "opencode"
122
124
  | "claude"
123
125
  | "claude-managed"
124
- | "codex"
125
126
  | "grok"
126
127
  | "fx"
127
- | "opencode"
128
128
  | "dsh"
129
129
  | "cursor"
130
130
  | "amp"
@@ -286,13 +286,13 @@ declare module "swarm-extension" {
286
286
  requestedByUserId?: string | undefined;
287
287
  swarmVersion?: string | undefined;
288
288
  provider?:
289
+ | "codex"
289
290
  | "pi"
291
+ | "opencode"
290
292
  | "claude"
291
293
  | "claude-managed"
292
- | "codex"
293
294
  | "grok"
294
295
  | "fx"
295
- | "opencode"
296
296
  | "dsh"
297
297
  | "cursor"
298
298
  | "amp"
@@ -309,13 +309,13 @@ declare module "swarm-extension" {
309
309
  sourceAgentId?: string | undefined;
310
310
  role?: string | undefined;
311
311
  harnessProvider?:
312
+ | "codex"
312
313
  | "pi"
314
+ | "opencode"
313
315
  | "claude"
314
316
  | "claude-managed"
315
- | "codex"
316
317
  | "grok"
317
318
  | "fx"
318
- | "opencode"
319
319
  | "dsh"
320
320
  | "cursor"
321
321
  | "amp"
@@ -351,8 +351,9 @@ declare module "swarm-extension" {
351
351
  agentId: string | undefined;
352
352
  runtimeInstanceId: string | undefined;
353
353
  sourceTaskId: string | undefined;
354
+ auditSourceTaskId: string | undefined;
354
355
  contextKey: string | undefined;
355
- callOrigin: "mcp" | "native" | "extension" | "script-sdk";
356
+ callOrigin: "native" | "mcp" | "extension" | "script-sdk";
356
357
  harness?: string | undefined;
357
358
  };
358
359
 
@@ -206,8 +206,17 @@ declare module "swarm-sdk" {
206
206
  truncated: boolean;
207
207
  /** Which limit cut this call short; null when the pass finished. */
208
208
  cutBy: "files" | "reads" | "time" | "bytes" | null;
209
+ /** True when nothing was written: `adopted` and `restored` list what a real run would change. */
210
+ dryRun: boolean;
209
211
  }
210
212
 
213
+ /** `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. */
214
+ export type PrimitiveReindexArgs = {
215
+ kind?: PrimitiveObjectKind;
216
+ prefix?: string;
217
+ dryRun?: boolean;
218
+ };
219
+
211
220
  /**
212
221
  * Primitive objects: agent-fs files on your default drive with a stable id.
213
222
  * Calls run as your own agent-fs identity. Each method throws on a refusal.
@@ -231,9 +240,7 @@ declare module "swarm-sdk" {
231
240
  offset?: number;
232
241
  }): Promise<{ message: string; objects: PrimitiveObject[]; total: number }>;
233
242
  /** Rebuild the index from the drive. Ids survive; rows whose file is gone are reported, not deleted. */
234
- reindex(args?: {
235
- kind?: PrimitiveObjectKind;
236
- }): Promise<{ message: string } & PrimitiveReindexReport>;
243
+ reindex(args?: PrimitiveReindexArgs): Promise<{ message: string } & PrimitiveReindexReport>;
237
244
  }
238
245
 
239
246
  /** A spreadsheet cell value. A string starting with `=` is a formula; null clears the cell. */
@@ -264,6 +271,36 @@ declare module "swarm-sdk" {
264
271
  freezeRows: number;
265
272
  }
266
273
 
274
+ export interface SheetImportXlsxArgs {
275
+ /** An `.xlsx` on the drive. */
276
+ sourcePath: string;
277
+ /** The new sheet; must end in `.sheet.json`. */
278
+ path: string;
279
+ title?: string;
280
+ }
281
+
282
+ export interface SheetImportXlsxResult {
283
+ message: string;
284
+ object: PrimitiveObject;
285
+ link: string | null;
286
+ /** What the file had that a sheet cannot hold. */
287
+ dropped: string[];
288
+ }
289
+
290
+ export interface SheetExportXlsxArgs extends SheetRef {
291
+ targetPath: string;
292
+ /** Replace `targetPath` when it exists. */
293
+ overwrite?: boolean;
294
+ }
295
+
296
+ export interface SheetExportXlsxResult {
297
+ message: string;
298
+ path: string;
299
+ link: string | null;
300
+ /** What the sheet had that xlsx cannot carry. */
301
+ dropped: string[];
302
+ }
303
+
267
304
  export interface SheetResult {
268
305
  message: string;
269
306
  /** agent-fs version after the call. */
@@ -303,6 +340,10 @@ declare module "swarm-sdk" {
303
340
  addTab(
304
341
  args: SheetRef & { name: string; after?: string },
305
342
  ): Promise<SheetResult & { tabs: string[] }>;
343
+ /** 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. */
344
+ importXlsx(args: SheetImportXlsxArgs): Promise<SheetImportXlsxResult>;
345
+ /** Create-only unless `overwrite`. `targetPath` must end in `.xlsx`. `dropped` names what xlsx cannot carry (frozen panes, spilled array cells). */
346
+ exportXlsx(args: SheetExportXlsxArgs): Promise<SheetExportXlsxResult>;
306
347
  }
307
348
 
308
349
  /** Palette names (Excalidraw's open-color) or a #rrggbb background. */
@@ -508,7 +549,7 @@ declare module "swarm-sdk" {
508
549
  limit?: number;
509
550
  offset?: number;
510
551
  }): Promise<unknown>;
511
- objects_reindex(args?: { kind?: PrimitiveObjectKind }): Promise<unknown>;
552
+ objects_reindex(args?: PrimitiveReindexArgs): Promise<unknown>;
512
553
  // --- sheets (prefer ctx.sheets.*, which unwraps and throws) ---
513
554
  sheets_create(args: SheetCreateArgs): Promise<unknown>;
514
555
  sheets_get(args: SheetRef): Promise<unknown>;
@@ -518,6 +559,8 @@ declare module "swarm-sdk" {
518
559
  sheets_appendRows(args: SheetRef & { tab: string; rows: SheetCellInput[][] }): Promise<unknown>;
519
560
  sheets_clearRange(args: SheetRangeArgs): Promise<unknown>;
520
561
  sheets_addTab(args: SheetRef & { name: string; after?: string }): Promise<unknown>;
562
+ sheets_importXlsx(args: SheetImportXlsxArgs): Promise<unknown>;
563
+ sheets_exportXlsx(args: SheetExportXlsxArgs): Promise<unknown>;
521
564
  // --- boards (prefer ctx.boards.*, which unwraps and throws) ---
522
565
  boards_create(args: BoardCreateArgs): Promise<unknown>;
523
566
  boards_get(args: BoardRef & { detail?: "summary" | "full" }): Promise<unknown>;
package/src/server.ts CHANGED
@@ -163,8 +163,10 @@ import {
163
163
  registerSheetAppendRowsTool,
164
164
  registerSheetClearRangeTool,
165
165
  registerSheetCreateTool,
166
+ registerSheetExportXlsxTool,
166
167
  registerSheetGetRangeTool,
167
168
  registerSheetGetTool,
169
+ registerSheetImportXlsxTool,
168
170
  registerSheetListTool,
169
171
  registerSheetSetRangeTool,
170
172
  } from "./tools/sheets";
@@ -725,6 +727,8 @@ export async function createServer(
725
727
  registerSheetAppendRowsTool(server);
726
728
  registerSheetClearRangeTool(server);
727
729
  registerSheetAddTabTool(server);
730
+ registerSheetImportXlsxTool(server);
731
+ registerSheetExportXlsxTool(server);
728
732
  registerBoardCreateTool(server);
729
733
  registerBoardGetTool(server);
730
734
  registerBoardListTool(server);