@desplega.ai/agent-swarm 2.13.0 → 2.13.2

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 (306) hide show
  1. package/README.md +1 -1
  2. package/dist/acp-adapter-x1qqgzwx.js +17 -0
  3. package/dist/{acp-targets-86f0sh6g.js → acp-targets-mz8c5dnt.js} +10 -10
  4. package/dist/{actions-zv8vcxvr.js → actions-5ft3qp5a.js} +27 -27
  5. package/dist/{agent-fs-provision-jqshb33y.js → agent-fs-provision-6fgz7wvz.js} +4 -4
  6. package/dist/{amp-adapter-gt503ywc.js → amp-adapter-nthn8ezm.js} +3 -3
  7. package/dist/{app-6t4k5rh1.js → app-535m78qw.js} +10 -10
  8. package/dist/{approval-notifications-fcfw063h.js → approval-notifications-dewbk403.js} +11 -11
  9. package/dist/{assistant-9dzybh12.js → assistant-39zyabv2.js} +28 -28
  10. package/dist/{boot-args-schema-xzfp2feg.js → boot-args-schema-bqv5bf77.js} +1 -1
  11. package/dist/{boot-reembed-3jz0p2jk.js → boot-reembed-157c0gcz.js} +1 -1
  12. package/dist/{boot-reembed-r88wngfg.js → boot-reembed-fas7z3zn.js} +1 -1
  13. package/dist/{boot-scrub-sweep-scrqhw48.js → boot-scrub-sweep-tmec0be2.js} +2 -2
  14. package/dist/{boot-seeds-vb2dcrrb.js → boot-seeds-32zm50x2.js} +4 -4
  15. package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
  16. package/dist/{claude-adapter-h3mp9hgs.js → claude-adapter-gwq7x2nj.js} +9 -9
  17. package/dist/{claude-managed-adapter-kpbyj2vb.js → claude-managed-adapter-rkvw6fvq.js} +4 -4
  18. package/dist/{claude-managed-setup-0efr3wkg.js → claude-managed-setup-0vgz4d1j.js} +6 -6
  19. package/dist/{claude-sdk-session-03dw669q.js → claude-sdk-session-5wbwxy8c.js} +20967 -19390
  20. package/dist/{cli-z64t9pe6.js → cli-0f7n3td3.js} +1 -1
  21. package/dist/{cli-j53hpbsm.js → cli-0xwb7zpt.js} +2 -2
  22. package/dist/{cli-wxwv3t11.js → cli-1f48qdnb.js} +55 -13
  23. package/dist/{cli-gfcv679k.js → cli-1gevjrc1.js} +1 -1
  24. package/dist/{cli-0jkenasr.js → cli-2v4xxnx2.js} +1 -1
  25. package/dist/{cli-hc6e4tac.js → cli-2wde56gv.js} +6 -6
  26. package/dist/{cli-mh7pdxe0.js → cli-31vt7baf.js} +17 -17
  27. package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
  28. package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
  29. package/dist/{cli-1dbv9mj9.js → cli-4djg31jh.js} +1 -1
  30. package/dist/{cli-tn91wc6e.js → cli-50whymxq.js} +1 -1
  31. package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
  32. package/dist/{cli-b2jh3dyb.js → cli-5k1hvycs.js} +4 -4
  33. package/dist/{cli-dkejt425.js → cli-62fjschk.js} +7 -7
  34. package/dist/{cli-zqmmy073.js → cli-69eq6gdk.js} +18 -18
  35. package/dist/{cli-qm3ntjqs.js → cli-6rmryz03.js} +13 -13
  36. package/dist/{cli-mz34pxbk.js → cli-7m6bbtab.js} +11 -11
  37. package/dist/{cli-wv20kbr3.js → cli-8a4qg44m.js} +5 -5
  38. package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
  39. package/dist/{cli-9m9kyw77.js → cli-8qvte9hn.js} +2 -2
  40. package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
  41. package/dist/{cli-qec9bynj.js → cli-a6rzw649.js} +3 -3
  42. package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
  43. package/dist/{cli-yn4kt85g.js → cli-b0kqw55g.js} +1 -1
  44. package/dist/{cli-n3qe7tyr.js → cli-b0m3bg0f.js} +134 -3
  45. package/dist/{cli-xfjn2kyq.js → cli-bp2rt28p.js} +9 -9
  46. package/dist/{cli-2jk4s7z1.js → cli-c9bwawf9.js} +3 -3
  47. package/dist/{cli-wndegmns.js → cli-cmgdptmx.js} +3 -3
  48. package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
  49. package/dist/{cli-117g15t4.js → cli-cs26ed89.js} +8 -8
  50. package/dist/{cli-prf7kz78.js → cli-d0jb2qnt.js} +603 -78
  51. package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
  52. package/dist/{cli-wrhbym01.js → cli-d528acsw.js} +6 -6
  53. package/dist/{cli-tstj6e8e.js → cli-dnvmwsvc.js} +310 -88
  54. package/dist/{cli-9fsagra4.js → cli-e87fg3en.js} +1 -1
  55. package/dist/{cli-jj3c5nyb.js → cli-erh1rgh4.js} +116 -56
  56. package/dist/{cli-f1952kjy.js → cli-ewb028rs.js} +4 -4
  57. package/dist/{cli-ct8sz3np.js → cli-f1sdh8ca.js} +6 -6
  58. package/dist/{cli-0b655smz.js → cli-fcwrd7bh.js} +5 -5
  59. package/dist/{cli-eb279wn3.js → cli-fgm2mad9.js} +2 -2
  60. package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
  61. package/dist/{cli-dnh64e8e.js → cli-g0b3ma7r.js} +7 -7
  62. package/dist/{cli-avxh26pd.js → cli-gc7jkf4a.js} +4 -4
  63. package/dist/{cli-2skf1mdf.js → cli-gedf48yw.js} +4 -4
  64. package/dist/{cli-ajjvqhf3.js → cli-getrvmtx.js} +27 -6
  65. package/dist/{cli-c8v2yvej.js → cli-gq6qhmrr.js} +2 -2
  66. package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
  67. package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
  68. package/dist/{cli-avqkr20b.js → cli-j2ybkdk2.js} +2 -2
  69. package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
  70. package/dist/{cli-hgsxnjyg.js → cli-jkkcm72j.js} +13 -13
  71. package/dist/{cli-g6j6ac3h.js → cli-ka13xx6b.js} +2 -2
  72. package/dist/{cli-t35hx078.js → cli-m1wddksc.js} +2 -2
  73. package/dist/{cli-50w82h6m.js → cli-mwxez0pz.js} +1 -0
  74. package/dist/{cli-nc6a8b5b.js → cli-n14r8h4n.js} +2 -2
  75. package/dist/{cli-y4a4458j.js → cli-n46d87mj.js} +3 -3
  76. package/dist/{cli-0dg7ytxm.js → cli-nkfv398a.js} +1096 -75
  77. package/dist/{cli-fhvk2nvp.js → cli-nvqq3232.js} +9 -9
  78. package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
  79. package/dist/{cli-6a40p4kv.js → cli-qn79645p.js} +1 -1
  80. package/dist/{cli-hbq0kwxz.js → cli-r4fphq38.js} +4 -4
  81. package/dist/{cli-47hz21se.js → cli-r8ddn0hf.js} +4 -5
  82. package/dist/{cli-hpb9x72z.js → cli-rvhaahfv.js} +9 -9
  83. package/dist/{cli-qhhb30e8.js → cli-s08zsqva.js} +9 -9
  84. package/dist/{cli-sdh61g52.js → cli-s6fhqbz1.js} +2 -2
  85. package/dist/{cli-y518qkjg.js → cli-sjk85d7v.js} +13 -12
  86. package/dist/{cli-ytc7fpza.js → cli-t25rq8mg.js} +4 -4
  87. package/dist/{cli-sq913bh1.js → cli-t9nxq30h.js} +8 -8
  88. package/dist/{cli-49f5jyhh.js → cli-tbdw3f92.js} +3 -3
  89. package/dist/{cli-1v82d2w6.js → cli-tceqvv6h.js} +4 -4
  90. package/dist/{cli-fz9pcjsw.js → cli-tgmate57.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-7dbhnsj9.js → cli-wdtqkqnq.js} +4 -4
  95. package/dist/{cli-kde4ky90.js → cli-x5yb8zc8.js} +2 -2
  96. package/dist/{cli-w14j2z4k.js → cli-x7aqhxj5.js} +2 -2
  97. package/dist/{cli-kspxjftk.js → cli-xerdrnqs.js} +15 -6
  98. package/dist/{cli-48nvk6sb.js → cli-xhkek467.js} +2 -2
  99. package/dist/{cli-dka73bak.js → cli-xysy1g8x.js} +152 -12
  100. package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
  101. package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
  102. package/dist/{cli-0pazkmd4.js → cli-zm6bkx3e.js} +4 -4
  103. package/dist/{cli-6h88mn9q.js → cli-zqy28rwx.js} +4 -4
  104. package/dist/cli.js +30 -29
  105. package/dist/{codex-adapter-f3yp0kaj.js → codex-adapter-x25xfbnh.js} +8 -8
  106. package/dist/{codex-hook-262cekfp.js → codex-hook-c0nvm30r.js} +2 -2
  107. package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
  108. package/dist/{codex-session-runner-ns4mv70p.js → codex-session-runner-kn5xnrvp.js} +9 -9
  109. package/dist/{commands-5bzf2tfw.js → commands-8n59gxmy.js} +3 -3
  110. package/dist/{controller-5xt7kvfm.js → controller-wn3vd217.js} +3 -3
  111. package/dist/{controllers-connect-0gg13mzp.js → controllers-connect-09gvkrhc.js} +28 -28
  112. package/dist/core-2b8bv6ny.js +42 -0
  113. package/dist/{cursor-adapter-p0c5zv6r.js → cursor-adapter-w1681kp1.js} +2 -2
  114. package/dist/{db-2s68ycq7.js → db-e71keqxk.js} +3 -3
  115. package/dist/{db-q7q639k5.js → db-spg81qtr.js} +2 -2
  116. package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
  117. package/dist/{dispatcher-j2y1q7ae.js → dispatcher-fr4vawwb.js} +25 -25
  118. package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
  119. package/dist/{dsh-adapter-pgnkf4st.js → dsh-adapter-g9yqv09y.js} +2 -2
  120. package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
  121. package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
  122. package/dist/{easter-egg-3d-0kea97jf.js → easter-egg-3d-ac9tv9a6.js} +1 -1
  123. package/dist/{embedding-space-3n6mhhmy.js → embedding-space-an77f45k.js} +6 -6
  124. package/dist/{embeddings-jfmj6yme.js → embeddings-jkrehejr.js} +1 -1
  125. package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
  126. package/dist/{execute-tjrej979.js → execute-3mys4nta.js} +1 -1
  127. package/dist/{external-channel-jy8w2gg3.js → external-channel-s6zxpts9.js} +2 -2
  128. package/dist/fx-adapter-4yet1c4f.js +20 -0
  129. package/dist/grok-adapter-8ge6tw7m.js +20 -0
  130. package/dist/handlers-0r9evrdj.js +41 -0
  131. package/dist/heartbeat-jjpb44e5.js +50 -0
  132. package/dist/{hook-fv1jwrv7.js → hook-68gbs87k.js} +6 -6
  133. package/dist/{hook-bpnncsec.js → hook-y6n23zzj.js} +8 -8
  134. package/dist/{http-bpa26czn.js → http-8c6y008s.js} +404 -146
  135. package/dist/{index-w216g9y9.js → index-0vthtbc2.js} +38 -22
  136. package/dist/index-1v23363p.js +39 -0
  137. package/dist/index-30qw6vyw.js +44 -0
  138. package/dist/index-6bm3w6cn.js +40 -0
  139. package/dist/{index-s8re7mvq.js → index-6h3r0vpe.js} +1 -1
  140. package/dist/{index-620y7jzq.js → index-7dgxveck.js} +3 -3
  141. package/dist/{index-4k7m5dgj.js → index-maddg9ys.js} +143 -103
  142. package/dist/{index-0h6qd4p1.js → index-mbpxhc4w.js} +3 -4
  143. package/dist/index-rz8ve510.js +569 -0
  144. package/dist/{index-mpj0z9e0.js → index-we3nd2t0.js} +1 -1
  145. package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
  146. package/dist/{index-52tgbhrw.js → index-xcw7hjt5.js} +28 -28
  147. package/dist/{index-8p0j4h4j.js → index-ym9fgxad.js} +94 -89
  148. package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
  149. package/dist/{keepalive-d6z12s04.js → keepalive-7e9r5dvp.js} +5 -4
  150. package/dist/lead-3jpc7kcr.js +79 -0
  151. package/dist/{maintenance-7kac6g2g.js → maintenance-d3erjvcg.js} +1 -1
  152. package/dist/{oauth-refresh-sweep-t1xjetbh.js → oauth-refresh-sweep-0qh70988.js} +4 -3
  153. package/dist/{object-webhooks-6rdagg0r.js → object-webhooks-ac7v2q5p.js} +7 -7
  154. package/dist/{onboard-32y1cfxy.js → onboard-5yphtken.js} +4 -4
  155. package/dist/{opencode-adapter-enp3v31n.js → opencode-adapter-0xvyba4m.js} +8 -8
  156. package/dist/{otel-impl-k0tm5ptj.js → otel-impl-svqp691q.js} +2 -2
  157. package/dist/{pending-24zebgvs.js → pending-bn4xe5br.js} +26 -26
  158. package/dist/{pi-mono-adapter-yj72xxxe.js → pi-mono-adapter-763s8a3w.js} +20 -18
  159. package/dist/{pricing-refresh-cf25x38j.js → pricing-refresh-kfc215mf.js} +2 -2
  160. package/dist/{rbac-roles-0wydd22m.js → rbac-roles-3bznvkpt.js} +3 -3
  161. package/dist/{rbac-roles-at6crb3r.js → rbac-roles-6r4h2ghj.js} +2 -2
  162. package/dist/{render-v2-nvcw0jd7.js → render-v2-f3qedbpy.js} +10 -10
  163. package/dist/{resume-y4w0k5v3.js → resume-vcag4ann.js} +13 -13
  164. package/dist/{runtime-vpe43hx0.js → runtime-x0s55z2t.js} +1 -1
  165. package/dist/{session-access-gkyvnfye.js → session-access-nwzve8q2.js} +5 -5
  166. package/dist/{session-source-backfill-3w2st4m2.js → session-source-backfill-jpqfzmgz.js} +2 -2
  167. package/dist/{setup-axxvqtys.js → setup-d2smwaem.js} +1 -1
  168. package/dist/thread-buffer-8fc703jc.js +42 -0
  169. package/dist/{tree-visibility-y4fqvab5.js → tree-visibility-dwzc8en0.js} +2 -2
  170. package/dist/{user-merge-jobs-kcmwvrc6.js → user-merge-jobs-4ce7kma2.js} +3 -3
  171. package/dist/{virtual-modules-7d92dct1.js → virtual-modules-78a6yw71.js} +3 -3
  172. package/dist/{work-objects-f708e069.js → work-objects-m0w1e7q8.js} +28 -28
  173. package/dist/worker-3p2vq107.js +79 -0
  174. package/dist/{worker-follow-up-0by8wztc.js → worker-follow-up-e3t6f895.js} +25 -25
  175. package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
  176. package/openapi.json +1795 -1623
  177. package/package.json +13 -12
  178. package/src/apps/catalog.generated.json +726 -0
  179. package/src/apps/definition.ts +24 -7
  180. package/src/apps/page-validator.ts +225 -3
  181. package/src/be/db.ts +38 -10
  182. package/src/be/mcp-proxy.ts +5 -4
  183. package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
  184. package/src/be/migrations/341_user_token_expiry.sql +4 -0
  185. package/src/be/schedules/validate.ts +26 -0
  186. package/src/be/scripts/run-credential.ts +55 -1
  187. package/src/be/scripts/typecheck.ts +4 -4
  188. package/src/be/scripts/user-code-mode.ts +160 -0
  189. package/src/be/swarm-config-guard.ts +4 -0
  190. package/src/be/users.ts +48 -7
  191. package/src/commands/credential-outcome-report.ts +5 -2
  192. package/src/commands/onboard/agent-fs-version.ts +1 -1
  193. package/src/commands/provider-credentials.ts +19 -0
  194. package/src/commands/provider-error-class.ts +4 -1
  195. package/src/commands/rate-limit-outcome.ts +48 -3
  196. package/src/commands/runner.ts +113 -55
  197. package/src/commands/worktree-reaper.ts +600 -0
  198. package/src/extensions/contract-types.generated.ts +1 -1
  199. package/src/http/agents.ts +4 -0
  200. package/src/http/api-keys.ts +27 -3
  201. package/src/http/pages-public.ts +40 -4
  202. package/src/http/pool-keys.ts +21 -2
  203. package/src/http/schedules.ts +28 -3
  204. package/src/http/script-connection-proxy.ts +18 -6
  205. package/src/http/script-connections.ts +12 -4
  206. package/src/http/script-runs.ts +12 -3
  207. package/src/http/scripts.ts +2 -11
  208. package/src/http/tasks.ts +6 -10
  209. package/src/http/users.ts +1 -0
  210. package/src/integrations/chat-sdk/adapters.ts +29 -0
  211. package/src/integrations/chat-sdk/limits.ts +3 -0
  212. package/src/integrations/chat-sdk/rocketchat/README.md +8 -0
  213. package/src/integrations/chat-sdk/rocketchat/index.ts +790 -0
  214. package/src/integrations/chat-sdk/rocketchat/markdown.ts +210 -0
  215. package/src/integrations/chat-sdk/rocketchat/types.ts +249 -0
  216. package/src/integrations/chat-sdk/runtime.ts +11 -5
  217. package/src/integrations/chat-sdk/schema.ts +37 -3
  218. package/src/integrations/chat-sdk/status.ts +9 -0
  219. package/src/mcp-client/http-client.ts +3 -1
  220. package/src/oauth/identity-capture.ts +6 -1
  221. package/src/oauth/mcp-wrapper.ts +10 -3
  222. package/src/oauth/wrapper.ts +15 -3
  223. package/src/prompts/session-templates.ts +1 -0
  224. package/src/providers/acp-targets.ts +2 -2
  225. package/src/providers/amp-adapter.ts +1 -1
  226. package/src/providers/dsh-adapter.ts +1 -1
  227. package/src/providers/pi-mono-adapter.ts +4 -2
  228. package/src/providers/runtime-dependencies.ts +1 -1
  229. package/src/rbac/legacy-policy.ts +3 -0
  230. package/src/rbac/permissions.ts +9 -0
  231. package/src/scripts-runtime/executors/native.ts +225 -67
  232. package/src/scripts-runtime/mcp-client.ts +2 -1
  233. package/src/scripts-runtime/swarm-sdk.ts +2 -1
  234. package/src/scripts-runtime/types/stdlib.d.ts +4 -4
  235. package/src/scripts-runtime/types/swarm-extension.d.ts +7 -7
  236. package/src/scripts-runtime/types/swarm-sdk.d.ts +4 -4
  237. package/src/server-user.ts +98 -0
  238. package/src/slack/enrich.ts +14 -11
  239. package/src/tests/agents-list-model-display.test.ts +23 -0
  240. package/src/tests/apps-spike2.test.ts +35 -0
  241. package/src/tests/base-prompt.test.ts +1 -0
  242. package/src/tests/chat-sdk-rocketchat-vendored.test.ts +67 -0
  243. package/src/tests/chat-sdk-status-route.test.ts +13 -1
  244. package/src/tests/codex-app-server.test.ts +4 -6
  245. package/src/tests/deploy-guard.test.ts +24 -0
  246. package/src/tests/dsh-adapter.test.ts +1 -1
  247. package/src/tests/ensure-token.test.ts +2 -2
  248. package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
  249. package/src/tests/fake-dns.ts +47 -0
  250. package/src/tests/fixtures/base-prompt-baseline.json +12 -12
  251. package/src/tests/latest-model-report.test.ts +138 -0
  252. package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
  253. package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
  254. package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
  255. package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
  256. package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
  257. package/src/tests/mcp-server-ssrf.test.ts +2 -0
  258. package/src/tests/mcp-user-route.test.ts +10 -1
  259. package/src/tests/memory-search-stall.test.ts +5 -0
  260. package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
  261. package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
  262. package/src/tests/oauth-wrapper.test.ts +1 -2
  263. package/src/tests/pages-head-v2.test.ts +2 -1
  264. package/src/tests/script-connections-http.test.ts +8 -3
  265. package/src/tests/script-connections-mcp.test.ts +14 -10
  266. package/src/tests/script-connections-sql.test.ts +6 -2
  267. package/src/tests/script-connections.test.ts +4 -0
  268. package/src/tests/slack-thread-participants.test.ts +14 -3
  269. package/src/tests/spend-cap-credentials.test.ts +34 -0
  270. package/src/tests/spend-cap-outcome.test.ts +67 -0
  271. package/src/tests/subscription-first.test.ts +119 -0
  272. package/src/tests/worktree-reaper.test.ts +424 -0
  273. package/src/tools/get-task-details.ts +247 -5
  274. package/src/tools/schedules/patch-schedule.ts +26 -1
  275. package/src/tools/schedules/update-schedule.ts +28 -2
  276. package/src/tools/script-common.ts +37 -22
  277. package/src/tools/script-query-types.ts +1 -1
  278. package/src/tools/script-run.ts +1 -1
  279. package/src/tools/script-search.ts +12 -10
  280. package/src/tools/utils.ts +7 -1
  281. package/src/utils/credentials.ts +36 -1
  282. package/src/utils/egress-guard.ts +40 -10
  283. package/src/utils/error-tracker.ts +17 -0
  284. package/templates/skills/apps/SKILL.md +191 -2
  285. package/templates/skills/apps/content.md +191 -2
  286. package/templates/skills/boards-and-sheets/content.md +11 -0
  287. package/templates/skills/chat-sdk/content.md +2 -2
  288. package/templates/skills/pages/content.md +11 -0
  289. package/templates/skills/swarm-docs/content.md +4 -0
  290. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  291. package/templates/skills/swarm-scripts/content.md +1 -0
  292. package/templates/workflows/ralph-loop/content.md +6 -6
  293. package/dist/acp-adapter-cn53011z.js +0 -17
  294. package/dist/cli-pr0eze3x.js +0 -149
  295. package/dist/core-0fqtbrxa.js +0 -42
  296. package/dist/fx-adapter-k6w3jvz9.js +0 -20
  297. package/dist/grok-adapter-4q5tssw0.js +0 -20
  298. package/dist/handlers-qxgfvvsf.js +0 -41
  299. package/dist/heartbeat-6tr2w2da.js +0 -50
  300. package/dist/index-0mcxjdsa.js +0 -44
  301. package/dist/index-dz4q23ag.js +0 -40
  302. package/dist/index-s175jckx.js +0 -39
  303. package/dist/lead-p3hx7h35.js +0 -79
  304. package/dist/thread-buffer-rwa7d4dx.js +0 -42
  305. package/dist/worker-8rg9gz74.js +0 -79
  306. /package/dist/{cli-m4ejz4nj.js → cli-cah298e5.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,
@@ -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(
@@ -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(
@@ -142,11 +142,7 @@ function describeScriptFailure(
142
142
  return undefined;
143
143
  }
144
144
 
145
- export async function proxyScriptsApi(args: {
146
- method: "GET" | "POST" | "PATCH" | "DELETE";
147
- path: string;
148
- body?: unknown;
149
- requestInfo: RequestInfo;
145
+ type ScriptToolRendering = {
150
146
  successMessage: (data: unknown) => string;
151
147
  /** Optional model-facing rendering of the success payload (appended to the text channel). */
152
148
  successDetails?: (data: unknown) => string | undefined;
@@ -162,26 +158,45 @@ export async function proxyScriptsApi(args: {
162
158
  * no pagination) — everything else stays capped.
163
159
  */
164
160
  uncappedDetails?: boolean;
165
- }): Promise<SwarmToolResult> {
161
+ };
162
+
163
+ /**
164
+ * Turn a scripts API response into the tool result. Shared by the agent
165
+ * tools (over HTTP) and the user MCP code-mode tools (in process).
166
+ */
167
+ export function scriptsApiToolResult(
168
+ data: unknown,
169
+ res: { ok: boolean; status: number },
170
+ args: ScriptToolRendering,
171
+ ): SwarmToolResult {
172
+ const toolData = { status: res.status, data };
173
+ const failure = describeScriptFailure(res.ok, res.status, data);
174
+ if (failure) {
175
+ return toolErr(failure.message, {
176
+ details: failure.details ?? capDetails(args.failureDetails?.(data)),
177
+ data: toolData,
178
+ });
179
+ }
180
+
181
+ const successDetails = args.successDetails?.(data);
182
+ return toolOk(args.successMessage(data), {
183
+ details: args.uncappedDetails ? successDetails : capDetails(successDetails),
184
+ data: toolData,
185
+ });
186
+ }
187
+
188
+ export async function proxyScriptsApi(
189
+ args: {
190
+ method: "GET" | "POST" | "PATCH" | "DELETE";
191
+ path: string;
192
+ body?: unknown;
193
+ requestInfo: RequestInfo;
194
+ } & ScriptToolRendering,
195
+ ): Promise<SwarmToolResult> {
166
196
  return proxySwarmApi({
167
197
  ...args,
168
198
  transportError: SCRIPT_TRANSPORT_ERROR,
169
- respond: (data, res) => {
170
- const toolData = { status: res.status, data };
171
- const failure = describeScriptFailure(res.ok, res.status, data);
172
- if (failure) {
173
- return toolErr(failure.message, {
174
- details: failure.details ?? capDetails(args.failureDetails?.(data)),
175
- data: toolData,
176
- });
177
- }
178
-
179
- const successDetails = args.successDetails?.(data);
180
- return toolOk(args.successMessage(data), {
181
- details: args.uncappedDetails ? successDetails : capDetails(successDetails),
182
- data: toolData,
183
- });
184
- },
199
+ respond: (data, res) => scriptsApiToolResult(data, res, args),
185
200
  });
186
201
  }
187
202
 
@@ -11,7 +11,7 @@ import {
11
11
  export const SCRIPT_QUERY_TYPES_DESCRIPTION =
12
12
  "Fetch the auto-generated `swarm-sdk.d.ts` (derived from the live MCP tool registry) + the `stdlib.d.ts` blobs — for IDE-style introspection before authoring or running a script. Pass `name` to also get that script's signature; omit it for the swarm-wide type surface. The same types are used by `script-upsert`'s typecheck pass, so they are authoritative.";
13
13
 
14
- function renderTypeBlobs(data: unknown): string | undefined {
14
+ export function renderTypeBlobs(data: unknown): string | undefined {
15
15
  if (typeof data !== "object" || data === null) return undefined;
16
16
  const body = data as {
17
17
  signature?: unknown;
@@ -13,7 +13,7 @@ import {
13
13
  export const SCRIPT_RUN_DESCRIPTION =
14
14
  "Run a named swarm-shared script (callable across agents and from workflow `swarm-script` nodes), OR inline source (auto-saved as scratch to the catalog). Inline source executes without the `script-upsert` compile-time typecheck. Use for swarm-visible, durable scripts. For local-only throwaway TS, use code-mode `run`. The run ends when the script's default export resolves: a call it did not await gets 2 s more, then is stopped (native) or aborted at once (quickjs), so await every write that must land. A `Promise.race` deadline therefore bounds the run; a nested `script_run` that lost the race keeps running on the server under its own wall.";
15
15
 
16
- function renderRunOutput(data: unknown): string | undefined {
16
+ export function renderRunOutput(data: unknown): string | undefined {
17
17
  if (typeof data !== "object" || data === null) return undefined;
18
18
  const body = data as {
19
19
  result?: unknown;
@@ -6,7 +6,7 @@ import { proxyScriptsApi, scriptScopeSchema, scriptToolOutputSchema } from "./sc
6
6
  export const SCRIPT_SEARCH_DESCRIPTION =
7
7
  "Semantic search over swarm-shared TypeScript scripts (catalog persisted in the agent-swarm DB; callable from agents and workflows). For ephemeral throwaway TS on your local machine, use code-mode instead.";
8
8
 
9
- function renderSearchResults(data: unknown): string | undefined {
9
+ export function renderSearchResults(data: unknown): string | undefined {
10
10
  if (typeof data !== "object" || data === null) return undefined;
11
11
  const results = (data as { results?: unknown[] }).results;
12
12
  if (!Array.isArray(results) || results.length === 0) return undefined;
@@ -20,6 +20,16 @@ function renderSearchResults(data: unknown): string | undefined {
20
20
  .join("\n");
21
21
  }
22
22
 
23
+ export function searchSuccessMessage(data: unknown): string {
24
+ const results =
25
+ typeof data === "object" &&
26
+ data !== null &&
27
+ Array.isArray((data as { results?: unknown[] }).results)
28
+ ? (data as { results: unknown[] }).results
29
+ : [];
30
+ return `Found ${results.length} script(s).`;
31
+ }
32
+
23
33
  export const registerScriptSearchTool = (server: McpServer) => {
24
34
  createToolRegistrar(server)(
25
35
  "script-search",
@@ -40,15 +50,7 @@ export const registerScriptSearchTool = (server: McpServer) => {
40
50
  path: "/api/scripts/search",
41
51
  body: args,
42
52
  requestInfo,
43
- successMessage: (data) => {
44
- const results =
45
- typeof data === "object" &&
46
- data !== null &&
47
- Array.isArray((data as { results?: unknown[] }).results)
48
- ? (data as { results: unknown[] }).results
49
- : [];
50
- return `Found ${results.length} script(s).`;
51
- },
53
+ successMessage: searchSuccessMessage,
52
54
  successDetails: renderSearchResults,
53
55
  }),
54
56
  );
@@ -701,8 +701,14 @@ function canonicalOverflowPayload(toolName: string, result: SwarmToolResult): st
701
701
  * and the full value could never leave the store over MCP. Its oversized
702
702
  * results go out whole; the harness applies its own truncation and the
703
703
  * kv-get nudge steers big-value processing toward scripts.
704
+ *
705
+ * script-get-types is the user MCP's type surface (src/server-user.ts): a user
706
+ * has no kv to read a spill back from, and the declarations only help whole.
704
707
  */
705
- export const CTX_CONTROL_EXEMPT_TOOLS: ReadonlySet<string> = new Set(["kv-get"]);
708
+ export const CTX_CONTROL_EXEMPT_TOOLS: ReadonlySet<string> = new Set([
709
+ "kv-get",
710
+ "script-get-types",
711
+ ]);
706
712
 
707
713
  type ArrayTarget = {
708
714
  path: string;
@@ -233,6 +233,24 @@ export class ModelWindowExhaustedError extends Error {
233
233
  }
234
234
  }
235
235
 
236
+ /**
237
+ * Thrown by `resolveCredentialPools` at task admission when every key of a
238
+ * pool the task may use hit its provider spend cap (OpenRouter key limit, out
239
+ * of credits). No retry helps before the cap resets, so the caller fails the
240
+ * task instead of spawning the CLI, the same as `ModelWindowExhaustedError`.
241
+ */
242
+ export class KeySpendCapError extends Error {
243
+ readonly keyType: string;
244
+
245
+ constructor(keyType: string) {
246
+ super(
247
+ `Every ${keyType} key this task may use hit its provider spend cap. Raise or remove the key's spend limit with the provider, or add another key, then retry.`,
248
+ );
249
+ this.name = "KeySpendCapError";
250
+ this.keyType = keyType;
251
+ }
252
+ }
253
+
236
254
  /**
237
255
  * Thrown by `resolveCredentialPools` when a model profile's credential
238
256
  * allowlist names no key of a pool the worker holds. The caller must not
@@ -438,6 +456,8 @@ export interface AvailabilityInfo {
438
456
  earliestModelResetAt?: string | null;
439
457
  /** Indices excluded because the key's subscription plan cannot run the model. */
440
458
  seatBlockedIndices?: number[];
459
+ /** Rate-limited indices whose limit is a provider spend cap. */
460
+ spendCappedIndices?: number[];
441
461
  }
442
462
 
443
463
  /**
@@ -475,6 +495,7 @@ async function fetchAvailableIndices(
475
495
  modelBlockedIndices?: number[];
476
496
  earliestModelResetAt?: string | null;
477
497
  seatBlockedIndices?: number[];
498
+ spendCappedIndices?: number[];
478
499
  };
479
500
  availableIndicesMap[envVar] = {
480
501
  availableIndices: data.availableIndices,
@@ -482,6 +503,7 @@ async function fetchAvailableIndices(
482
503
  modelBlockedIndices: data.modelBlockedIndices,
483
504
  earliestModelResetAt: data.earliestModelResetAt,
484
505
  seatBlockedIndices: data.seatBlockedIndices,
506
+ spendCappedIndices: data.spendCappedIndices,
485
507
  };
486
508
  if (data.availableIndices.length < totalKeys) {
487
509
  console.log(
@@ -614,6 +636,17 @@ export async function resolveCredentialPools(
614
636
  modelBlockedCount += beforeCount - available.length;
615
637
  }
616
638
 
639
+ // A spend-capped key fails every pick until its cap resets: the best-effort
640
+ // pick skips it, and a pool with only capped keys fails the task now.
641
+ const spendCapped = (info?.spendCappedIndices ?? []).filter(inAllowlist);
642
+ const uncapped =
643
+ available?.length === 0 && spendCapped.length > 0
644
+ ? pool.filter((i) => inAllowlist(i) && !spendCapped.includes(i))
645
+ : undefined;
646
+ if (opts?.enforceModelCapacity && uncapped?.length === 0) {
647
+ throw new KeySpendCapError(envVar);
648
+ }
649
+
617
650
  const seatBlockedIndices = info?.seatBlockedIndices ?? [];
618
651
  const seatBlockedCount = seatBlockedIndices.filter(inAllowlist).length;
619
652
  let seatFallbackIndices: number[] | undefined;
@@ -653,7 +686,9 @@ export async function resolveCredentialPools(
653
686
  ...selectCredential(val, seatFallbackIndices, envVar, allowedIdx),
654
687
  isRateLimitFallback: true,
655
688
  }
656
- : selectCredential(val, available, envVar, allowedIdx);
689
+ : uncapped?.length
690
+ ? { ...selectCredential(val, uncapped, envVar, allowedIdx), isRateLimitFallback: true }
691
+ : selectCredential(val, available, envVar, allowedIdx);
657
692
  env[envVar] = result.selected;
658
693
  const availInfo = available ? ` (${available.length} available of ${result.total})` : "";
659
694
  console.log(