@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
@@ -14,11 +14,24 @@ import {
14
14
  toolErr,
15
15
  toolOk,
16
16
  } from "@/tools/utils";
17
- import { AgentTaskStatusSchema } from "@/types";
17
+ import { type AgentTask, AgentTaskStatusSchema } from "@/types";
18
18
  import { getUserCommsPrefs } from "@/utils/requester-comms";
19
19
 
20
+ /**
21
+ * Reductions the size fit may apply, each one opted out of by its `include` value:
22
+ * `logs` returns every log row verbatim, `text` returns every text field uncut.
23
+ */
24
+ export const GET_TASK_DETAILS_INCLUDE = ["logs", "text"] as const;
25
+ type GetTaskDetailsInclude = (typeof GET_TASK_DETAILS_INCLUDE)[number];
26
+
20
27
  export const getTaskDetailsInputSchema = z.object({
21
28
  taskId: z.uuid().describe("The ID of the task to get details for."),
29
+ include: z
30
+ .array(z.enum(GET_TASK_DETAILS_INCLUDE))
31
+ .optional()
32
+ .describe(
33
+ 'Opt out of the size fit. A response that fits the budget is never reduced. One that does not is reduced only as far as needed, and `fitted` lists what changed. "logs": every log row verbatim. "text": every text field (task, output, progress, failureReason, requester notes, log values) uncut. A result over the wire limit still spills to KV.',
34
+ ),
22
35
  });
23
36
 
24
37
  // Loosened, output-only mirror of FollowUpConfigSchema / RoutingAffinitySchema
@@ -183,13 +196,231 @@ export const getTaskDetailsOutputSchema = swarmToolOutputSchema({
183
196
  .describe(
184
197
  "Pointer-based artifacts attached to this task via store-progress, ordered by created_at.",
185
198
  ),
199
+ fitted: z
200
+ .looseObject({
201
+ budgetBytes: z.number().optional(),
202
+ logs: z
203
+ .looseObject({
204
+ compacted: z.string().optional(),
205
+ omitted: z.number().optional(),
206
+ omittedByEventType: z.record(z.string(), z.number()).optional(),
207
+ })
208
+ .optional(),
209
+ text: z
210
+ .array(
211
+ z.looseObject({
212
+ field: z.string().optional(),
213
+ originalChars: z.number().optional(),
214
+ keptChars: z.number().optional(),
215
+ }),
216
+ )
217
+ .optional(),
218
+ include: z.array(z.string()).optional(),
219
+ })
220
+ .optional()
221
+ .describe(
222
+ "Present only when the full response passed the size budget: what was reduced to fit, and the include values that return it.",
223
+ ),
186
224
  });
187
225
 
188
226
  type GetTaskDetailsArgs = z.infer<typeof getTaskDetailsInputSchema>;
189
227
 
228
+ /**
229
+ * Payload budget for the agent-facing response, in UTF-8 bytes of the JSON data. The text
230
+ * channel renders that JSON once after the message, and the structured channel carries it once
231
+ * (ctx-control drops the duplicate `details` there before it spills), so a payload under this
232
+ * budget stays under MCP_RESULT_WIRE_LIMIT_BYTES with room for the message and envelope keys.
233
+ */
234
+ const FIT_BUDGET_BYTES = 9_000;
235
+ /** Log events the fit never drops: they carry the task's lifecycle. */
236
+ const LIFECYCLE_EVENTS: ReadonlySet<string> = new Set(["task_created", "task_status_change"]);
237
+ /** A shortened text field keeps at least this many leading characters. */
238
+ const MIN_TEXT_CHARS = 280;
239
+ /** Task text fields the fit may shorten, after the log reductions. */
240
+ const TASK_TEXT_FIELDS = ["task", "output", "progress", "failureReason"] as const;
241
+
242
+ type LogView = Record<string, unknown> & { eventType: string };
243
+ type FitNotice = {
244
+ budgetBytes: number;
245
+ logs?: { compacted: string; omitted?: number; omittedByEventType?: Record<string, number> };
246
+ text?: Array<{ field: string; originalChars: number; keptChars: number }>;
247
+ include?: GetTaskDetailsInclude[];
248
+ };
249
+ type DetailsData = {
250
+ yourAgentId: string | undefined;
251
+ task: AgentTask;
252
+ requestedBy: Record<string, unknown> | undefined;
253
+ logs: LogView[];
254
+ attachments: unknown[];
255
+ fitted?: FitNotice;
256
+ };
257
+
258
+ const jsonBytes = (value: unknown) => Buffer.byteLength(JSON.stringify(value), "utf8");
259
+
260
+ /** The first `chars` characters of `value`, never ending on a lone high surrogate. */
261
+ function head(value: string, chars: number): string {
262
+ const code = value.charCodeAt(chars - 1);
263
+ return value.slice(0, code >= 0xd800 && code <= 0xdbff ? chars - 1 : chars);
264
+ }
265
+
266
+ /**
267
+ * Fit the response under FIT_BUDGET_BYTES with the least loss. A response that already fits is
268
+ * returned unchanged. Otherwise the steps run in order and stop as soon as it fits:
269
+ * 1. log rows drop fields that repeat the task (lossless);
270
+ * 2. the oldest non-lifecycle log rows go, keeping lifecycle events and the newest progress;
271
+ * 3. the longest text field is shortened, repeatedly, never below MIN_TEXT_CHARS.
272
+ * `include` skips steps 1-2 ("logs") or step 3 ("text"). Ids, status, parentTaskId and
273
+ * attachments are never touched, and `fitted` records every reduction.
274
+ */
275
+ function fitToBudget(full: DetailsData, include: ReadonlySet<GetTaskDetailsInclude>): DetailsData {
276
+ if (jsonBytes(full) <= FIT_BUDGET_BYTES) return full;
277
+
278
+ const fitted: FitNotice = { budgetBytes: FIT_BUDGET_BYTES };
279
+ const reduced: GetTaskDetailsInclude[] = [];
280
+ let task: AgentTask = full.task;
281
+ let requestedBy = full.requestedBy;
282
+ let logs = full.logs;
283
+ const view = (): DetailsData => ({
284
+ ...full,
285
+ task,
286
+ requestedBy,
287
+ logs,
288
+ fitted: { ...fitted, include: reduced },
289
+ });
290
+ const fits = () => jsonBytes(view()) <= FIT_BUDGET_BYTES;
291
+
292
+ if (!include.has("logs")) {
293
+ reduced.push("logs");
294
+ const taskAgentId = full.task.agentId;
295
+ const compact: LogView[] = full.logs.map(({ taskId: _sameTask, agentId, ...rest }) =>
296
+ agentId && agentId !== taskAgentId ? { ...rest, agentId } : rest,
297
+ );
298
+ logs = compact;
299
+ fitted.logs = {
300
+ compacted:
301
+ "Log rows omit taskId (always this task) and agentId where it equals task.agentId.",
302
+ };
303
+
304
+ if (!fits()) {
305
+ let newestProgress = -1;
306
+ compact.forEach((log, i) => {
307
+ if (log.eventType === "task_progress") newestProgress = i;
308
+ });
309
+ // Oldest first, so the newest context survives.
310
+ const droppable = compact
311
+ .map((_log, i) => i)
312
+ .filter((i) => i !== newestProgress && !LIFECYCLE_EVENTS.has(compact[i]?.eventType ?? ""));
313
+ const { compacted } = fitted.logs;
314
+ // Sets the notice with the rows, so every size check measures the omitted counts too.
315
+ const without = (count: number) => {
316
+ const drop = new Set(droppable.slice(0, count));
317
+ const byEventType: Record<string, number> = {};
318
+ for (const i of drop) {
319
+ const type = compact[i]?.eventType ?? "unknown";
320
+ byEventType[type] = (byEventType[type] ?? 0) + 1;
321
+ }
322
+ fitted.logs =
323
+ count > 0
324
+ ? { compacted, omitted: count, omittedByEventType: byEventType }
325
+ : { compacted };
326
+ return compact.filter((_, i) => !drop.has(i));
327
+ };
328
+ let low = 1;
329
+ let high = droppable.length;
330
+ while (low < high) {
331
+ const mid = Math.floor((low + high) / 2);
332
+ logs = without(mid);
333
+ if (fits()) high = mid;
334
+ else low = mid + 1;
335
+ }
336
+ const dropped = Math.min(low, droppable.length);
337
+ logs = without(dropped);
338
+ }
339
+ }
340
+
341
+ if (!fits() && !include.has("text")) {
342
+ reduced.push("text");
343
+ fitted.text = [];
344
+ task = { ...task };
345
+ if (requestedBy) {
346
+ const comms = requestedBy.comms;
347
+ requestedBy = {
348
+ ...requestedBy,
349
+ ...(comms && typeof comms === "object" ? { comms: { ...comms } } : {}),
350
+ };
351
+ }
352
+ const shortenLogs = !include.has("logs");
353
+ if (shortenLogs) logs = logs.map((log) => ({ ...log }));
354
+
355
+ type Slot = { field: string; value: string; set: (next: string) => void };
356
+ const slots = (): Slot[] => {
357
+ const out: Slot[] = [];
358
+ const mutableTask = task as Record<string, unknown>;
359
+ for (const key of TASK_TEXT_FIELDS) {
360
+ const value = mutableTask[key];
361
+ if (typeof value === "string") {
362
+ out.push({ field: `task.${key}`, value, set: (next) => (mutableTask[key] = next) });
363
+ }
364
+ }
365
+ // Requester notes and comms preferences (tone, verbosity, ...) are free text too.
366
+ const owner = requestedBy;
367
+ const comms = owner?.comms as Record<string, unknown> | undefined;
368
+ for (const [prefix, record] of [
369
+ ["requestedBy", owner],
370
+ ["requestedBy.comms", comms],
371
+ ] as const) {
372
+ if (!record) continue;
373
+ for (const [key, value] of Object.entries(record)) {
374
+ if (typeof value === "string" && key !== "name" && key !== "email" && key !== "role") {
375
+ out.push({ field: `${prefix}.${key}`, value, set: (next) => (record[key] = next) });
376
+ }
377
+ }
378
+ }
379
+ if (shortenLogs) {
380
+ logs.forEach((log, i) => {
381
+ for (const key of ["newValue", "oldValue", "metadata"]) {
382
+ const value = log[key];
383
+ if (typeof value === "string") {
384
+ out.push({ field: `logs[${i}].${key}`, value, set: (next) => (log[key] = next) });
385
+ }
386
+ }
387
+ });
388
+ }
389
+ return out;
390
+ };
391
+
392
+ const original = new Map<string, number>();
393
+ for (let round = 0; round < 40 && !fits(); round++) {
394
+ const over = jsonBytes(view()) - FIT_BUDGET_BYTES;
395
+ const longest = slots().reduce<Slot | undefined>(
396
+ (best, slot) => (!best || slot.value.length > best.value.length ? slot : best),
397
+ undefined,
398
+ );
399
+ if (!longest || longest.value.length <= MIN_TEXT_CHARS + 120) break;
400
+ const first = original.get(longest.field) ?? longest.value.length;
401
+ original.set(longest.field, first);
402
+ // The previous marker is cut away with the tail; 120 chars of slack cover the new one.
403
+ const keep = Math.max(MIN_TEXT_CHARS, longest.value.length - over - 120);
404
+ longest.set(
405
+ `${head(longest.value, keep)}… [cut, ${first} chars in full; include "text" for all]`,
406
+ );
407
+ const existing = fitted.text.find((entry) => entry.field === longest.field);
408
+ if (existing) existing.keptChars = keep;
409
+ else fitted.text.push({ field: longest.field, originalChars: first, keptChars: keep });
410
+ }
411
+ // Nothing was long enough to cut: report no text reduction.
412
+ if (fitted.text.length === 0) {
413
+ delete fitted.text;
414
+ reduced.pop();
415
+ }
416
+ }
417
+
418
+ return view();
419
+ }
420
+
190
421
  export async function getTaskDetailsHandler(
191
422
  ctx: ToolCtx,
192
- { taskId }: GetTaskDetailsArgs,
423
+ { taskId, include }: GetTaskDetailsArgs,
193
424
  ): Promise<SwarmToolResult> {
194
425
  const task = await getTaskById(taskId);
195
426
  const agentId = ctx.kind === "owner" ? ctx.agentId : undefined;
@@ -218,7 +449,7 @@ export async function getTaskDetailsHandler(
218
449
  }
219
450
  : undefined;
220
451
 
221
- const data = {
452
+ const full: DetailsData = {
222
453
  yourAgentId: agentId,
223
454
  task,
224
455
  requestedBy,
@@ -226,7 +457,18 @@ export async function getTaskDetailsHandler(
226
457
  attachments,
227
458
  };
228
459
 
229
- return toolOk(`Task "${taskId}" (${task.status}) details retrieved.`, {
460
+ // Script and extension calls never reach a model context, so they keep the full shape.
461
+ const origin = ctx.kind === "owner" ? ctx.requestInfo?.callOrigin : undefined;
462
+ const data =
463
+ origin === "script-sdk" || origin === "extension"
464
+ ? full
465
+ : fitToBudget(full, new Set(include ?? []));
466
+ const reducedParts = data.fitted?.include ?? [];
467
+ const fitNote = reducedParts.length
468
+ ? ` Fitted to the size budget; include ${JSON.stringify(reducedParts)} for the rest.`
469
+ : "";
470
+
471
+ return toolOk(`Task "${taskId}" (${task.status}) details retrieved.${fitNote}`, {
230
472
  details: JSON.stringify(data),
231
473
  data,
232
474
  });
@@ -238,7 +480,7 @@ export const registerGetTaskDetailsTool = (server: McpServer) => {
238
480
  {
239
481
  title: "Get task details",
240
482
  description:
241
- "Returns detailed information about a specific task, including output, failure reason, and log history.",
483
+ 'Returns detailed information about a specific task, including output, failure reason, attachments and log history. A response over the size budget is fitted with the least loss: log rows drop fields that repeat the task, then the oldest non-lifecycle rows, then the longest text is cut. `fitted` lists each reduction; include ["logs", "text"] returns the rest.',
242
484
  annotations: { readOnlyHint: true },
243
485
  inputSchema: getTaskDetailsInputSchema,
244
486
  outputSchema: getTaskDetailsOutputSchema,
@@ -162,8 +162,12 @@ export const registerObjectReindexTool = (server: McpServer) => {
162
162
  title: "Reindex primitive objects",
163
163
  annotations: { readOnlyHint: false, idempotentHint: true },
164
164
  description:
165
- "Rebuild the object index from the files on your default agent-fs drive. Keeps each file's embedded id; a file with no id (for example a stock Excalidraw save) keeps the id of the row at its path, else gets a new one written back. Rows whose file is gone are reported as `missing`, never deleted. Files whose version matches the index are checked, not re-read (`unchanged`); one call reads at most 50 changed files, 16 MiB, or 20 seconds of work, so run it again while `truncated` is true (`cutBy` names the limit). agent-fs file.changed webhooks keep the index current between runs when the swarm can register them.",
166
- inputSchema: z.object({ kind: KindSchema.optional() }),
165
+ "Rebuild the object index from the files on your default agent-fs drive. Keeps each file's embedded id; a file with no id (for example a stock Excalidraw save) keeps the id of the row at its path, else gets a new one written back. Rows whose file is gone are reported as `missing`, never deleted. Without `prefix` it touches every id-less file of the kind on the drive, including files other people put there: pass `prefix` (same path-prefix match as object-list; end it with `/` for one folder, or give one file's path) to limit it, and `dryRun: true` to get the same report with nothing written. Files whose version matches the index are checked, not re-read (`unchanged`); one call reads at most 50 changed files, 16 MiB, or 20 seconds of work, so run it again while `truncated` is true (`cutBy` names the limit). agent-fs file.changed webhooks keep the index current between runs when the swarm can register them.",
166
+ inputSchema: z.object({
167
+ kind: KindSchema.optional(),
168
+ prefix: z.string().optional(),
169
+ dryRun: z.boolean().optional(),
170
+ }),
167
171
  outputSchema: swarmToolOutputSchema({
168
172
  yourAgentId: z.string().optional(),
169
173
  scanned: z.number().optional(),
@@ -174,16 +178,17 @@ export const registerObjectReindexTool = (server: McpServer) => {
174
178
  conflicts: z.array(z.looseObject({ path: z.string(), reason: z.string() })).optional(),
175
179
  truncated: z.boolean().optional(),
176
180
  cutBy: z.enum(["files", "reads", "time", "bytes"]).nullable().optional(),
181
+ dryRun: z.boolean().optional(),
177
182
  }),
178
183
  },
179
- async ({ kind }, requestInfo) => {
184
+ async ({ kind, prefix, dryRun }, requestInfo) => {
180
185
  const result = await refusing(requestInfo.agentId, () =>
181
- reindexObjects({ agentId: requestInfo.agentId, kind }),
186
+ reindexObjects({ agentId: requestInfo.agentId, kind, prefix, dryRun }),
182
187
  );
183
188
  if ("error" in result) return result.error;
184
189
  const report = result.value;
185
190
  return toolOk(
186
- `Scanned ${report.scanned} files: ${report.unchanged} unchanged, ${report.adopted.length} adopted, ${report.restored.length} restored, ${report.missing.length} missing, ${report.conflicts.length} skipped${report.truncated ? ` (truncated: ${report.cutBy} limit)` : ""}.`,
191
+ `${report.dryRun ? "Dry run, nothing written. " : ""}Scanned ${report.scanned} files: ${report.unchanged} unchanged, ${report.adopted.length} adopted, ${report.restored.length} restored, ${report.missing.length} missing, ${report.conflicts.length} skipped${report.truncated ? ` (truncated: ${report.cutBy} limit)` : ""}.`,
187
192
  { data: { yourAgentId: requestInfo.agentId, ...report } },
188
193
  );
189
194
  },
@@ -4,7 +4,7 @@ import { getAgentById } from "@/be/db";
4
4
  import { updateSwarmRepoChecked } from "@/be/repo-checked-update";
5
5
  import { can } from "@/rbac";
6
6
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
7
- import { RepoGuidelinesInputSchema, RepoHooksSchema } from "@/types";
7
+ import { agentsMayMerge, RepoGuidelinesInputSchema, RepoHooksSchema } from "@/types";
8
8
 
9
9
  const swarmRepoOutputShape = z.looseObject({
10
10
  id: z.string().optional(),
@@ -33,7 +33,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
33
33
  {
34
34
  title: "Update Repo",
35
35
  description:
36
- "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge: resend its current value to edit other guidelines.",
36
+ "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge or mergePolicy: resend their current values to edit other guidelines.",
37
37
  annotations: { readOnlyHint: false },
38
38
 
39
39
  inputSchema: z.object({
@@ -51,7 +51,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
51
51
  guidelines: RepoGuidelinesInputSchema.nullable()
52
52
  .optional()
53
53
  .describe(
54
- "Repository guidelines: prChecks (commands before PR), mergeChecks (conditions before merge), allowMerge (default false), review (guidance for reviewers). Pass null to clear.",
54
+ "Repository guidelines: prChecks (commands before PR), mergeChecks (conditions before merge), allowMerge (default false), review (guidance for reviewers), mergePolicy (per-repo merge policy record: autoMerge, agentsMayMerge, notify). Pass null to clear.",
55
55
  ),
56
56
  }),
57
57
  outputSchema: swarmToolOutputSchema({
@@ -59,7 +59,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
59
59
  }),
60
60
  },
61
61
  async ({ id, ...updates }, requestInfo) => {
62
- // The comparison with the stored allowMerge, the decision and the write share one
62
+ // The comparison with the stored merge policy, the decision and the write share one
63
63
  // transaction, so a stale edit cannot overwrite a merge-policy change committed after it.
64
64
  const result = await updateSwarmRepoChecked(id, updates, async (existing) => {
65
65
  const agent = requestInfo.agentId ? await getAgentById(requestInfo.agentId) : null;
@@ -72,8 +72,8 @@ export const registerUpdateRepoTool = (server: McpServer) => {
72
72
  source: "mcp",
73
73
  });
74
74
  if (decision.allow) return null;
75
- const current = existing.guidelines?.allowMerge === true;
76
- return `Only lead agents can change allowMerge (it is currently ${current}). Resend ${current} to keep it while you edit the other guidelines.`;
75
+ const current = agentsMayMerge(existing.guidelines);
76
+ return `Only lead agents can change allowMerge or mergePolicy (agents may merge: ${current}). Resend the current allowMerge and mergePolicy to keep them while you edit the other guidelines.`;
77
77
  });
78
78
 
79
79
  if (result.kind === "refused") {
@@ -326,6 +326,7 @@ export const registerCreateScheduleTool = (server: McpServer) => {
326
326
  nextRunAt = calculateNextRun(tempSchedule, new Date());
327
327
  }
328
328
 
329
+ // Not the audit task: a schedule fires its tasks as requested by created_by.
329
330
  const createdBy =
330
331
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
331
332
  undefined;
@@ -22,6 +22,9 @@ const scheduleRowShape = {
22
22
  lastRunAt: z.string().optional(),
23
23
  nextRunAt: z.string().optional(),
24
24
  createdByAgentId: z.string().optional(),
25
+ updatedByAgentId: z.string().optional(),
26
+ createdBy: z.string().optional(),
27
+ updatedBy: z.string().optional(),
25
28
  parentTaskId: z.string().optional(),
26
29
  timezone: z.string().optional(),
27
30
  consecutiveErrors: z.number().optional(),
@@ -14,7 +14,11 @@ import {
14
14
  } from "@/be/db";
15
15
  import { modelProfileRefError, scheduleProfileUpdate } from "@/be/db/model-profiles";
16
16
  import { explicitModelErrorForAgent } from "@/be/model-validation";
17
- import { mergeScheduleTiming, validateRecurringTiming } from "@/be/schedules/validate";
17
+ import {
18
+ changesScheduleTarget,
19
+ mergeScheduleTiming,
20
+ validateRecurringTiming,
21
+ } from "@/be/schedules/validate";
18
22
  import { getScript } from "@/be/scripts/db";
19
23
  import { can } from "@/rbac";
20
24
  import { calculateNextRun } from "@/scheduler";
@@ -214,6 +218,27 @@ export const registerPatchScheduleTool = (server: McpServer) => {
214
218
  );
215
219
  }
216
220
 
221
+ // A schedule fires as its creator. Only the creator or a lead picks what it runs.
222
+ if (
223
+ changesScheduleTarget(schedule, {
224
+ targetType,
225
+ taskTemplate,
226
+ workflowId,
227
+ scriptName,
228
+ scriptArgs,
229
+ }) &&
230
+ !can({
231
+ principal: { kind: "agent", agentId: caller.id, isLead: caller.isLead },
232
+ verb: "schedule.target.update.any",
233
+ resource: { kind: "owned", ownerAgentId: schedule.createdByAgentId },
234
+ source: "mcp",
235
+ }).allow
236
+ ) {
237
+ return toolErr(
238
+ `Schedule "${schedule.name}" runs as the agent that created it. Only that agent or a lead can change its targetType, taskTemplate, workflowId, scriptName or scriptArgs.`,
239
+ );
240
+ }
241
+
217
242
  // Reject updates on completed one-time schedules
218
243
  if (schedule.scheduleType === "one_time" && !schedule.enabled && schedule.lastRunAt) {
219
244
  return toolErr(
@@ -378,10 +403,19 @@ export const registerPatchScheduleTool = (server: McpServer) => {
378
403
  }
379
404
 
380
405
  const updatedBy =
381
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
406
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
382
407
  undefined;
383
- if (key !== undefined) updateData.key = await authorizeAssetKeyWrite(key, updatedBy);
384
- const updated = await updateScheduledTask(schedule.id, { ...updateData, updatedBy });
408
+ if (key !== undefined) {
409
+ updateData.key = await authorizeAssetKeyWrite(
410
+ key,
411
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
412
+ );
413
+ }
414
+ const updated = await updateScheduledTask(schedule.id, {
415
+ ...updateData,
416
+ updatedBy: updatedBy ?? null,
417
+ updatedByAgentId: requestInfo.agentId ?? null,
418
+ });
385
419
 
386
420
  if (!updated) {
387
421
  return toolErr("Failed to update schedule.");
@@ -14,7 +14,11 @@ import {
14
14
  } from "@/be/db";
15
15
  import { modelProfileRefError, scheduleProfileUpdate } from "@/be/db/model-profiles";
16
16
  import { explicitModelErrorForAgent } from "@/be/model-validation";
17
- import { mergeScheduleTiming, validateRecurringTiming } from "@/be/schedules/validate";
17
+ import {
18
+ changesScheduleTarget,
19
+ mergeScheduleTiming,
20
+ validateRecurringTiming,
21
+ } from "@/be/schedules/validate";
18
22
  import { getScript } from "@/be/scripts/db";
19
23
  import { can } from "@/rbac";
20
24
  import { calculateNextRun } from "@/scheduler";
@@ -140,7 +144,8 @@ export const registerUpdateScheduleTool = (server: McpServer) => {
140
144
  {
141
145
  title: "Update Scheduled Task",
142
146
  annotations: { idempotentHint: true },
143
- description: "Update an existing scheduled task. Any registered agent can update schedules.",
147
+ description:
148
+ "Update an existing scheduled task. Any registered agent can update schedules; only the creator or a lead can change what one runs (targetType, taskTemplate, workflowId, scriptName, scriptArgs).",
144
149
  inputSchema: updateScheduleInputSchema,
145
150
  outputSchema: swarmToolOutputSchema({
146
151
  yourAgentId: z.string().optional(),
@@ -213,6 +218,27 @@ export const registerUpdateScheduleTool = (server: McpServer) => {
213
218
  );
214
219
  }
215
220
 
221
+ // A schedule fires as its creator. Only the creator or a lead picks what it runs.
222
+ if (
223
+ changesScheduleTarget(schedule, {
224
+ targetType,
225
+ taskTemplate,
226
+ workflowId,
227
+ scriptName,
228
+ scriptArgs,
229
+ }) &&
230
+ !can({
231
+ principal: { kind: "agent", agentId: caller.id, isLead: caller.isLead },
232
+ verb: "schedule.target.update.any",
233
+ resource: { kind: "owned", ownerAgentId: schedule.createdByAgentId },
234
+ source: "mcp",
235
+ }).allow
236
+ ) {
237
+ return toolErr(
238
+ `Schedule "${schedule.name}" runs as the agent that created it. Only that agent or a lead can change its targetType, taskTemplate, workflowId, scriptName or scriptArgs.`,
239
+ );
240
+ }
241
+
216
242
  // Reject updates on completed one-time schedules
217
243
  if (schedule.scheduleType === "one_time" && !schedule.enabled && schedule.lastRunAt) {
218
244
  return toolErr(
@@ -377,10 +403,19 @@ export const registerUpdateScheduleTool = (server: McpServer) => {
377
403
  }
378
404
 
379
405
  const updatedBy =
380
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
406
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
381
407
  undefined;
382
- if (key !== undefined) updateData.key = await authorizeAssetKeyWrite(key, updatedBy);
383
- const updated = await updateScheduledTask(schedule.id, { ...updateData, updatedBy });
408
+ if (key !== undefined) {
409
+ updateData.key = await authorizeAssetKeyWrite(
410
+ key,
411
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
412
+ );
413
+ }
414
+ const updated = await updateScheduledTask(schedule.id, {
415
+ ...updateData,
416
+ updatedBy: updatedBy ?? null,
417
+ updatedByAgentId: requestInfo.agentId ?? null,
418
+ });
384
419
 
385
420
  if (!updated) {
386
421
  return toolErr("Failed to update schedule.");
@@ -6,8 +6,10 @@ import {
6
6
  appendSheetRows,
7
7
  clearSheetRange,
8
8
  createSheet,
9
+ exportSheetXlsx,
9
10
  getSheet,
10
11
  getSheetRange,
12
+ importSheetXlsx,
11
13
  listSheets,
12
14
  setSheetRange,
13
15
  } from "@/be/primitives/sheets/service";
@@ -59,6 +61,8 @@ const dataShape = {
59
61
  changed: z.number().optional(),
60
62
  recalculated: z.number().optional(),
61
63
  cleared: z.number().optional(),
64
+ path: z.string().optional(),
65
+ dropped: z.array(z.string()).optional(),
62
66
  };
63
67
 
64
68
  const outputSchema = swarmToolOutputSchema(dataShape);
@@ -310,3 +314,65 @@ export const registerSheetAddTabTool = (server: McpServer) => {
310
314
  },
311
315
  );
312
316
  };
317
+
318
+ const dropMessage = (dropped: string[]) =>
319
+ dropped.length ? `Dropped: ${dropped.join(", ")}.` : "Nothing dropped.";
320
+
321
+ export const registerSheetImportXlsxTool = (server: McpServer) => {
322
+ createToolRegistrar(server)(
323
+ "sheet-import-xlsx",
324
+ {
325
+ title: "Import xlsx as sheet",
326
+ annotations: WRITE,
327
+ description:
328
+ "Import an `.xlsx` file from your default agent-fs drive as a new sheet, as your own agent-fs identity. Create-only: refuses when the sheet path exists. Keeps tabs, values, formulas (recomputed), number formats, column widths and merges. `dropped` lists what the file had that a sheet cannot hold (styles, charts, comments, frozen panes, and so on). Limits: 5 MiB file, 20 tabs, 50,000 cells; nothing is created when a limit refuses.",
329
+ inputSchema: z.object({
330
+ sourcePath: z.string().min(1).describe("Drive path of the `.xlsx` file to import."),
331
+ path: z.string().min(1).describe("Drive path for the new sheet, ending in `.sheet.json`."),
332
+ title: z.string().max(200).optional(),
333
+ }),
334
+ outputSchema,
335
+ },
336
+ async ({ sourcePath, path, title }, requestInfo) => {
337
+ const result = await refusing(requestInfo.agentId, () =>
338
+ importSheetXlsx({ agentId: requestInfo.agentId, sourcePath, path, title }),
339
+ );
340
+ if ("error" in result) return result.error;
341
+ const { object, link, dropped } = result.value;
342
+ return toolOk(
343
+ `Imported ${sourcePath} as sheet ${object.id} at ${object.path}${link ? ` (${link})` : ""}. ${dropMessage(dropped)}`,
344
+ { data: { yourAgentId: requestInfo.agentId, ...result.value } },
345
+ );
346
+ },
347
+ );
348
+ };
349
+
350
+ export const registerSheetExportXlsxTool = (server: McpServer) => {
351
+ createToolRegistrar(server)(
352
+ "sheet-export-xlsx",
353
+ {
354
+ title: "Export sheet as xlsx",
355
+ annotations: WRITE,
356
+ description:
357
+ "Export a sheet to an `.xlsx` file on your default agent-fs drive. Writes formulas with their cached values, number formats, column widths and merges. `dropped` lists what the file cannot carry (frozen panes, spilled array cells). Create-only: refuses when `targetPath` exists unless `overwrite` is true.",
358
+ inputSchema: z.object({
359
+ id: z.string().min(1).optional().describe(ID),
360
+ path: z.string().min(1).optional().describe(PATH),
361
+ targetPath: z.string().min(1).describe("Drive path for the new file, ending in `.xlsx`."),
362
+ overwrite: z.boolean().optional().describe("Replace `targetPath` when it exists."),
363
+ }),
364
+ outputSchema,
365
+ },
366
+ async ({ id, path, targetPath, overwrite }, requestInfo) => {
367
+ const result = await refusing(requestInfo.agentId, () =>
368
+ exportSheetXlsx({ agentId: requestInfo.agentId, id, path, targetPath, overwrite }),
369
+ );
370
+ if ("error" in result) return result.error;
371
+ const r = result.value;
372
+ return toolOk(
373
+ `Exported to ${r.path}${r.link ? ` (${r.link})` : ""}. ${dropMessage(r.dropped)}`,
374
+ { data: { yourAgentId: requestInfo.agentId, ...r } },
375
+ );
376
+ },
377
+ );
378
+ };
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { createSkill, getAgentById, installSkill } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { can } from "@/rbac";
@@ -72,6 +73,11 @@ export const registerSkillCreateTool = (server: McpServer) => {
72
73
  agent: parsed.agent,
73
74
  disableModelInvocation: parsed.disableModelInvocation,
74
75
  userInvocable: parsed.userInvocable,
76
+ createdByAgentId: requestInfo.agentId,
77
+ createdBy: await resolveTaskAuditUserId(
78
+ requestInfo.auditSourceTaskId,
79
+ requestInfo.agentId,
80
+ ),
75
81
  });
76
82
 
77
83
  // Auto-install for the creating agent
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { resolveTaskAuditUserId } from "@/be/audit-user";
3
4
  import { createSkill, getAgentById } from "@/be/db";
4
5
  import { parseSkillContent } from "@/be/skill-parser";
5
6
  import { can } from "@/rbac";
@@ -112,6 +113,11 @@ export const registerSkillInstallRemoteTool = (server: McpServer) => {
112
113
  agent: parsedMeta.agent,
113
114
  disableModelInvocation: parsedMeta.disableModelInvocation,
114
115
  userInvocable: parsedMeta.userInvocable,
116
+ createdByAgentId: requestInfo.agentId,
117
+ createdBy: await resolveTaskAuditUserId(
118
+ requestInfo.auditSourceTaskId,
119
+ requestInfo.agentId,
120
+ ),
115
121
  });
116
122
 
117
123
  return toolOk(`Installed remote skill "${skill.name}".`, {