@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.
- package/README.md +1 -1
- package/dist/acp-adapter-x1qqgzwx.js +17 -0
- package/dist/{acp-targets-86f0sh6g.js → acp-targets-mz8c5dnt.js} +10 -10
- package/dist/{actions-zv8vcxvr.js → actions-5ft3qp5a.js} +27 -27
- package/dist/{agent-fs-provision-jqshb33y.js → agent-fs-provision-6fgz7wvz.js} +4 -4
- package/dist/{amp-adapter-gt503ywc.js → amp-adapter-nthn8ezm.js} +3 -3
- package/dist/{app-6t4k5rh1.js → app-535m78qw.js} +10 -10
- package/dist/{approval-notifications-fcfw063h.js → approval-notifications-dewbk403.js} +11 -11
- package/dist/{assistant-9dzybh12.js → assistant-39zyabv2.js} +28 -28
- package/dist/{boot-args-schema-xzfp2feg.js → boot-args-schema-bqv5bf77.js} +1 -1
- package/dist/{boot-reembed-3jz0p2jk.js → boot-reembed-157c0gcz.js} +1 -1
- package/dist/{boot-reembed-r88wngfg.js → boot-reembed-fas7z3zn.js} +1 -1
- package/dist/{boot-scrub-sweep-scrqhw48.js → boot-scrub-sweep-tmec0be2.js} +2 -2
- package/dist/{boot-seeds-vb2dcrrb.js → boot-seeds-32zm50x2.js} +4 -4
- package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
- package/dist/{claude-adapter-h3mp9hgs.js → claude-adapter-gwq7x2nj.js} +9 -9
- package/dist/{claude-managed-adapter-kpbyj2vb.js → claude-managed-adapter-rkvw6fvq.js} +4 -4
- package/dist/{claude-managed-setup-0efr3wkg.js → claude-managed-setup-0vgz4d1j.js} +6 -6
- package/dist/{claude-sdk-session-03dw669q.js → claude-sdk-session-5wbwxy8c.js} +20967 -19390
- package/dist/{cli-z64t9pe6.js → cli-0f7n3td3.js} +1 -1
- package/dist/{cli-j53hpbsm.js → cli-0xwb7zpt.js} +2 -2
- package/dist/{cli-wxwv3t11.js → cli-1f48qdnb.js} +55 -13
- package/dist/{cli-gfcv679k.js → cli-1gevjrc1.js} +1 -1
- package/dist/{cli-0jkenasr.js → cli-2v4xxnx2.js} +1 -1
- package/dist/{cli-hc6e4tac.js → cli-2wde56gv.js} +6 -6
- package/dist/{cli-mh7pdxe0.js → cli-31vt7baf.js} +17 -17
- package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
- package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
- package/dist/{cli-1dbv9mj9.js → cli-4djg31jh.js} +1 -1
- package/dist/{cli-tn91wc6e.js → cli-50whymxq.js} +1 -1
- package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
- package/dist/{cli-b2jh3dyb.js → cli-5k1hvycs.js} +4 -4
- package/dist/{cli-dkejt425.js → cli-62fjschk.js} +7 -7
- package/dist/{cli-zqmmy073.js → cli-69eq6gdk.js} +18 -18
- package/dist/{cli-qm3ntjqs.js → cli-6rmryz03.js} +13 -13
- package/dist/{cli-mz34pxbk.js → cli-7m6bbtab.js} +11 -11
- package/dist/{cli-wv20kbr3.js → cli-8a4qg44m.js} +5 -5
- package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
- package/dist/{cli-9m9kyw77.js → cli-8qvte9hn.js} +2 -2
- package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
- package/dist/{cli-qec9bynj.js → cli-a6rzw649.js} +3 -3
- package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
- package/dist/{cli-yn4kt85g.js → cli-b0kqw55g.js} +1 -1
- package/dist/{cli-n3qe7tyr.js → cli-b0m3bg0f.js} +134 -3
- package/dist/{cli-xfjn2kyq.js → cli-bp2rt28p.js} +9 -9
- package/dist/{cli-2jk4s7z1.js → cli-c9bwawf9.js} +3 -3
- package/dist/{cli-wndegmns.js → cli-cmgdptmx.js} +3 -3
- package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
- package/dist/{cli-117g15t4.js → cli-cs26ed89.js} +8 -8
- package/dist/{cli-prf7kz78.js → cli-d0jb2qnt.js} +603 -78
- package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
- package/dist/{cli-wrhbym01.js → cli-d528acsw.js} +6 -6
- package/dist/{cli-tstj6e8e.js → cli-dnvmwsvc.js} +310 -88
- package/dist/{cli-9fsagra4.js → cli-e87fg3en.js} +1 -1
- package/dist/{cli-jj3c5nyb.js → cli-erh1rgh4.js} +116 -56
- package/dist/{cli-f1952kjy.js → cli-ewb028rs.js} +4 -4
- package/dist/{cli-ct8sz3np.js → cli-f1sdh8ca.js} +6 -6
- package/dist/{cli-0b655smz.js → cli-fcwrd7bh.js} +5 -5
- package/dist/{cli-eb279wn3.js → cli-fgm2mad9.js} +2 -2
- package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
- package/dist/{cli-dnh64e8e.js → cli-g0b3ma7r.js} +7 -7
- package/dist/{cli-avxh26pd.js → cli-gc7jkf4a.js} +4 -4
- package/dist/{cli-2skf1mdf.js → cli-gedf48yw.js} +4 -4
- package/dist/{cli-ajjvqhf3.js → cli-getrvmtx.js} +27 -6
- package/dist/{cli-c8v2yvej.js → cli-gq6qhmrr.js} +2 -2
- package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
- package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
- package/dist/{cli-avqkr20b.js → cli-j2ybkdk2.js} +2 -2
- package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
- package/dist/{cli-hgsxnjyg.js → cli-jkkcm72j.js} +13 -13
- package/dist/{cli-g6j6ac3h.js → cli-ka13xx6b.js} +2 -2
- package/dist/{cli-t35hx078.js → cli-m1wddksc.js} +2 -2
- package/dist/{cli-50w82h6m.js → cli-mwxez0pz.js} +1 -0
- package/dist/{cli-nc6a8b5b.js → cli-n14r8h4n.js} +2 -2
- package/dist/{cli-y4a4458j.js → cli-n46d87mj.js} +3 -3
- package/dist/{cli-0dg7ytxm.js → cli-nkfv398a.js} +1096 -75
- package/dist/{cli-fhvk2nvp.js → cli-nvqq3232.js} +9 -9
- package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
- package/dist/{cli-6a40p4kv.js → cli-qn79645p.js} +1 -1
- package/dist/{cli-hbq0kwxz.js → cli-r4fphq38.js} +4 -4
- package/dist/{cli-47hz21se.js → cli-r8ddn0hf.js} +4 -5
- package/dist/{cli-hpb9x72z.js → cli-rvhaahfv.js} +9 -9
- package/dist/{cli-qhhb30e8.js → cli-s08zsqva.js} +9 -9
- package/dist/{cli-sdh61g52.js → cli-s6fhqbz1.js} +2 -2
- package/dist/{cli-y518qkjg.js → cli-sjk85d7v.js} +13 -12
- package/dist/{cli-ytc7fpza.js → cli-t25rq8mg.js} +4 -4
- package/dist/{cli-sq913bh1.js → cli-t9nxq30h.js} +8 -8
- package/dist/{cli-49f5jyhh.js → cli-tbdw3f92.js} +3 -3
- package/dist/{cli-1v82d2w6.js → cli-tceqvv6h.js} +4 -4
- package/dist/{cli-fz9pcjsw.js → cli-tgmate57.js} +4 -4
- package/dist/{cli-rtmqzat7.js → cli-vdfngx2g.js} +2 -2
- package/dist/{cli-9w8712tq.js → cli-vr4eyq6p.js} +43 -14
- package/dist/{cli-z4f346g5.js → cli-vx9acp12.js} +1 -1
- package/dist/{cli-7dbhnsj9.js → cli-wdtqkqnq.js} +4 -4
- package/dist/{cli-kde4ky90.js → cli-x5yb8zc8.js} +2 -2
- package/dist/{cli-w14j2z4k.js → cli-x7aqhxj5.js} +2 -2
- package/dist/{cli-kspxjftk.js → cli-xerdrnqs.js} +15 -6
- package/dist/{cli-48nvk6sb.js → cli-xhkek467.js} +2 -2
- package/dist/{cli-dka73bak.js → cli-xysy1g8x.js} +152 -12
- package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
- package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
- package/dist/{cli-0pazkmd4.js → cli-zm6bkx3e.js} +4 -4
- package/dist/{cli-6h88mn9q.js → cli-zqy28rwx.js} +4 -4
- package/dist/cli.js +30 -29
- package/dist/{codex-adapter-f3yp0kaj.js → codex-adapter-x25xfbnh.js} +8 -8
- package/dist/{codex-hook-262cekfp.js → codex-hook-c0nvm30r.js} +2 -2
- package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
- package/dist/{codex-session-runner-ns4mv70p.js → codex-session-runner-kn5xnrvp.js} +9 -9
- package/dist/{commands-5bzf2tfw.js → commands-8n59gxmy.js} +3 -3
- package/dist/{controller-5xt7kvfm.js → controller-wn3vd217.js} +3 -3
- package/dist/{controllers-connect-0gg13mzp.js → controllers-connect-09gvkrhc.js} +28 -28
- package/dist/core-2b8bv6ny.js +42 -0
- package/dist/{cursor-adapter-p0c5zv6r.js → cursor-adapter-w1681kp1.js} +2 -2
- package/dist/{db-2s68ycq7.js → db-e71keqxk.js} +3 -3
- package/dist/{db-q7q639k5.js → db-spg81qtr.js} +2 -2
- package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
- package/dist/{dispatcher-j2y1q7ae.js → dispatcher-fr4vawwb.js} +25 -25
- package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
- package/dist/{dsh-adapter-pgnkf4st.js → dsh-adapter-g9yqv09y.js} +2 -2
- package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
- package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
- package/dist/{easter-egg-3d-0kea97jf.js → easter-egg-3d-ac9tv9a6.js} +1 -1
- package/dist/{embedding-space-3n6mhhmy.js → embedding-space-an77f45k.js} +6 -6
- package/dist/{embeddings-jfmj6yme.js → embeddings-jkrehejr.js} +1 -1
- package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
- package/dist/{execute-tjrej979.js → execute-3mys4nta.js} +1 -1
- package/dist/{external-channel-jy8w2gg3.js → external-channel-s6zxpts9.js} +2 -2
- package/dist/fx-adapter-4yet1c4f.js +20 -0
- package/dist/grok-adapter-8ge6tw7m.js +20 -0
- package/dist/handlers-0r9evrdj.js +41 -0
- package/dist/heartbeat-jjpb44e5.js +50 -0
- package/dist/{hook-fv1jwrv7.js → hook-68gbs87k.js} +6 -6
- package/dist/{hook-bpnncsec.js → hook-y6n23zzj.js} +8 -8
- package/dist/{http-bpa26czn.js → http-8c6y008s.js} +404 -146
- package/dist/{index-w216g9y9.js → index-0vthtbc2.js} +38 -22
- package/dist/index-1v23363p.js +39 -0
- package/dist/index-30qw6vyw.js +44 -0
- package/dist/index-6bm3w6cn.js +40 -0
- package/dist/{index-s8re7mvq.js → index-6h3r0vpe.js} +1 -1
- package/dist/{index-620y7jzq.js → index-7dgxveck.js} +3 -3
- package/dist/{index-4k7m5dgj.js → index-maddg9ys.js} +143 -103
- package/dist/{index-0h6qd4p1.js → index-mbpxhc4w.js} +3 -4
- package/dist/index-rz8ve510.js +569 -0
- package/dist/{index-mpj0z9e0.js → index-we3nd2t0.js} +1 -1
- package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
- package/dist/{index-52tgbhrw.js → index-xcw7hjt5.js} +28 -28
- package/dist/{index-8p0j4h4j.js → index-ym9fgxad.js} +94 -89
- package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
- package/dist/{keepalive-d6z12s04.js → keepalive-7e9r5dvp.js} +5 -4
- package/dist/lead-3jpc7kcr.js +79 -0
- package/dist/{maintenance-7kac6g2g.js → maintenance-d3erjvcg.js} +1 -1
- package/dist/{oauth-refresh-sweep-t1xjetbh.js → oauth-refresh-sweep-0qh70988.js} +4 -3
- package/dist/{object-webhooks-6rdagg0r.js → object-webhooks-ac7v2q5p.js} +7 -7
- package/dist/{onboard-32y1cfxy.js → onboard-5yphtken.js} +4 -4
- package/dist/{opencode-adapter-enp3v31n.js → opencode-adapter-0xvyba4m.js} +8 -8
- package/dist/{otel-impl-k0tm5ptj.js → otel-impl-svqp691q.js} +2 -2
- package/dist/{pending-24zebgvs.js → pending-bn4xe5br.js} +26 -26
- package/dist/{pi-mono-adapter-yj72xxxe.js → pi-mono-adapter-763s8a3w.js} +20 -18
- package/dist/{pricing-refresh-cf25x38j.js → pricing-refresh-kfc215mf.js} +2 -2
- package/dist/{rbac-roles-0wydd22m.js → rbac-roles-3bznvkpt.js} +3 -3
- package/dist/{rbac-roles-at6crb3r.js → rbac-roles-6r4h2ghj.js} +2 -2
- package/dist/{render-v2-nvcw0jd7.js → render-v2-f3qedbpy.js} +10 -10
- package/dist/{resume-y4w0k5v3.js → resume-vcag4ann.js} +13 -13
- package/dist/{runtime-vpe43hx0.js → runtime-x0s55z2t.js} +1 -1
- package/dist/{session-access-gkyvnfye.js → session-access-nwzve8q2.js} +5 -5
- package/dist/{session-source-backfill-3w2st4m2.js → session-source-backfill-jpqfzmgz.js} +2 -2
- package/dist/{setup-axxvqtys.js → setup-d2smwaem.js} +1 -1
- package/dist/thread-buffer-8fc703jc.js +42 -0
- package/dist/{tree-visibility-y4fqvab5.js → tree-visibility-dwzc8en0.js} +2 -2
- package/dist/{user-merge-jobs-kcmwvrc6.js → user-merge-jobs-4ce7kma2.js} +3 -3
- package/dist/{virtual-modules-7d92dct1.js → virtual-modules-78a6yw71.js} +3 -3
- package/dist/{work-objects-f708e069.js → work-objects-m0w1e7q8.js} +28 -28
- package/dist/worker-3p2vq107.js +79 -0
- package/dist/{worker-follow-up-0by8wztc.js → worker-follow-up-e3t6f895.js} +25 -25
- package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
- package/openapi.json +1795 -1623
- package/package.json +13 -12
- package/src/apps/catalog.generated.json +726 -0
- package/src/apps/definition.ts +24 -7
- package/src/apps/page-validator.ts +225 -3
- package/src/be/db.ts +38 -10
- package/src/be/mcp-proxy.ts +5 -4
- package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
- package/src/be/migrations/341_user_token_expiry.sql +4 -0
- package/src/be/schedules/validate.ts +26 -0
- package/src/be/scripts/run-credential.ts +55 -1
- package/src/be/scripts/typecheck.ts +4 -4
- package/src/be/scripts/user-code-mode.ts +160 -0
- package/src/be/swarm-config-guard.ts +4 -0
- package/src/be/users.ts +48 -7
- package/src/commands/credential-outcome-report.ts +5 -2
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/provider-credentials.ts +19 -0
- package/src/commands/provider-error-class.ts +4 -1
- package/src/commands/rate-limit-outcome.ts +48 -3
- package/src/commands/runner.ts +113 -55
- package/src/commands/worktree-reaper.ts +600 -0
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/http/agents.ts +4 -0
- package/src/http/api-keys.ts +27 -3
- package/src/http/pages-public.ts +40 -4
- package/src/http/pool-keys.ts +21 -2
- package/src/http/schedules.ts +28 -3
- package/src/http/script-connection-proxy.ts +18 -6
- package/src/http/script-connections.ts +12 -4
- package/src/http/script-runs.ts +12 -3
- package/src/http/scripts.ts +2 -11
- package/src/http/tasks.ts +6 -10
- package/src/http/users.ts +1 -0
- package/src/integrations/chat-sdk/adapters.ts +29 -0
- package/src/integrations/chat-sdk/limits.ts +3 -0
- package/src/integrations/chat-sdk/rocketchat/README.md +8 -0
- package/src/integrations/chat-sdk/rocketchat/index.ts +790 -0
- package/src/integrations/chat-sdk/rocketchat/markdown.ts +210 -0
- package/src/integrations/chat-sdk/rocketchat/types.ts +249 -0
- package/src/integrations/chat-sdk/runtime.ts +11 -5
- package/src/integrations/chat-sdk/schema.ts +37 -3
- package/src/integrations/chat-sdk/status.ts +9 -0
- package/src/mcp-client/http-client.ts +3 -1
- package/src/oauth/identity-capture.ts +6 -1
- package/src/oauth/mcp-wrapper.ts +10 -3
- package/src/oauth/wrapper.ts +15 -3
- package/src/prompts/session-templates.ts +1 -0
- package/src/providers/acp-targets.ts +2 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/dsh-adapter.ts +1 -1
- package/src/providers/pi-mono-adapter.ts +4 -2
- package/src/providers/runtime-dependencies.ts +1 -1
- package/src/rbac/legacy-policy.ts +3 -0
- package/src/rbac/permissions.ts +9 -0
- package/src/scripts-runtime/executors/native.ts +225 -67
- package/src/scripts-runtime/mcp-client.ts +2 -1
- package/src/scripts-runtime/swarm-sdk.ts +2 -1
- package/src/scripts-runtime/types/stdlib.d.ts +4 -4
- package/src/scripts-runtime/types/swarm-extension.d.ts +7 -7
- package/src/scripts-runtime/types/swarm-sdk.d.ts +4 -4
- package/src/server-user.ts +98 -0
- package/src/slack/enrich.ts +14 -11
- package/src/tests/agents-list-model-display.test.ts +23 -0
- package/src/tests/apps-spike2.test.ts +35 -0
- package/src/tests/base-prompt.test.ts +1 -0
- package/src/tests/chat-sdk-rocketchat-vendored.test.ts +67 -0
- package/src/tests/chat-sdk-status-route.test.ts +13 -1
- package/src/tests/codex-app-server.test.ts +4 -6
- package/src/tests/deploy-guard.test.ts +24 -0
- package/src/tests/dsh-adapter.test.ts +1 -1
- package/src/tests/ensure-token.test.ts +2 -2
- package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
- package/src/tests/fake-dns.ts +47 -0
- package/src/tests/fixtures/base-prompt-baseline.json +12 -12
- package/src/tests/latest-model-report.test.ts +138 -0
- package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
- package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
- package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
- package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
- package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
- package/src/tests/mcp-server-ssrf.test.ts +2 -0
- package/src/tests/mcp-user-route.test.ts +10 -1
- package/src/tests/memory-search-stall.test.ts +5 -0
- package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
- package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
- package/src/tests/oauth-wrapper.test.ts +1 -2
- package/src/tests/pages-head-v2.test.ts +2 -1
- package/src/tests/script-connections-http.test.ts +8 -3
- package/src/tests/script-connections-mcp.test.ts +14 -10
- package/src/tests/script-connections-sql.test.ts +6 -2
- package/src/tests/script-connections.test.ts +4 -0
- package/src/tests/slack-thread-participants.test.ts +14 -3
- package/src/tests/spend-cap-credentials.test.ts +34 -0
- package/src/tests/spend-cap-outcome.test.ts +67 -0
- package/src/tests/subscription-first.test.ts +119 -0
- package/src/tests/worktree-reaper.test.ts +424 -0
- package/src/tools/get-task-details.ts +247 -5
- package/src/tools/schedules/patch-schedule.ts +26 -1
- package/src/tools/schedules/update-schedule.ts +28 -2
- package/src/tools/script-common.ts +37 -22
- package/src/tools/script-query-types.ts +1 -1
- package/src/tools/script-run.ts +1 -1
- package/src/tools/script-search.ts +12 -10
- package/src/tools/utils.ts +7 -1
- package/src/utils/credentials.ts +36 -1
- package/src/utils/egress-guard.ts +40 -10
- package/src/utils/error-tracker.ts +17 -0
- package/templates/skills/apps/SKILL.md +191 -2
- package/templates/skills/apps/content.md +191 -2
- package/templates/skills/boards-and-sheets/content.md +11 -0
- package/templates/skills/chat-sdk/content.md +2 -2
- package/templates/skills/pages/content.md +11 -0
- package/templates/skills/swarm-docs/content.md +4 -0
- package/templates/skills/swarm-scripts/SKILL.md +1 -0
- package/templates/skills/swarm-scripts/content.md +1 -0
- package/templates/workflows/ralph-loop/content.md +6 -6
- package/dist/acp-adapter-cn53011z.js +0 -17
- package/dist/cli-pr0eze3x.js +0 -149
- package/dist/core-0fqtbrxa.js +0 -42
- package/dist/fx-adapter-k6w3jvz9.js +0 -20
- package/dist/grok-adapter-4q5tssw0.js +0 -20
- package/dist/handlers-qxgfvvsf.js +0 -41
- package/dist/heartbeat-6tr2w2da.js +0 -50
- package/dist/index-0mcxjdsa.js +0 -44
- package/dist/index-dz4q23ag.js +0 -40
- package/dist/index-s175jckx.js +0 -39
- package/dist/lead-p3hx7h35.js +0 -79
- package/dist/thread-buffer-rwa7d4dx.js +0 -42
- package/dist/worker-8rg9gz74.js +0 -79
- /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
|
|
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
|
-
|
|
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
|
-
|
|
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 {
|
|
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 {
|
|
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:
|
|
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
|
-
|
|
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
|
-
}
|
|
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;
|
package/src/tools/script-run.ts
CHANGED
|
@@ -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:
|
|
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
|
);
|
package/src/tools/utils.ts
CHANGED
|
@@ -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([
|
|
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;
|
package/src/utils/credentials.ts
CHANGED
|
@@ -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
|
-
:
|
|
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(
|