@desplega.ai/agent-swarm 2.8.1 → 2.8.3
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/dist/acp-adapter-xq6s2z6t.js +14 -0
- package/dist/{actions-pwjpn0j6.js → actions-ewz7bp4g.js} +20 -19
- package/dist/{amp-adapter-cq9jgj6x.js → amp-adapter-f25tqhnf.js} +3 -3
- package/dist/{app-cnfffgwg.js → app-mkptw0k7.js} +4 -4
- package/dist/{assistant-kpn317y1.js → assistant-c47rfe77.js} +23 -22
- package/dist/{boot-args-schema-pbbnhmc3.js → boot-args-schema-4vb0xsat.js} +1 -1
- package/dist/{boot-reembed-9m0ysxma.js → boot-reembed-1ghy2sab.js} +1 -1
- package/dist/{boot-reembed-majbn53m.js → boot-reembed-htr73hbs.js} +1 -1
- package/dist/{boot-scrub-sweep-app8g8ym.js → boot-scrub-sweep-yrytg42z.js} +4 -4
- package/dist/{boot-seeds-pbtmvcjm.js → boot-seeds-n2b3dx4e.js} +4 -4
- package/dist/{boxd-qbkxy6ap.js → boxd-jmfqgkqa.js} +2 -2
- package/dist/{claude-adapter-wn1g3qp5.js → claude-adapter-r33pqnzx.js} +8 -9
- package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-hddmxjyj.js} +4 -4
- package/dist/{claude-managed-setup-pd47nzch.js → claude-managed-setup-hfvry1bd.js} +5 -5
- package/dist/{claude-sdk-session-3a2a6589.js → claude-sdk-session-0hamqzc7.js} +10 -11
- package/dist/{cli-v1dv1r37.js → cli-0bcgyj5b.js} +74 -3
- package/dist/{cli-a3b239vq.js → cli-0vksaxvr.js} +2 -2
- package/dist/{cli-mrt48bx7.js → cli-15204js0.js} +1 -1
- package/dist/{cli-8aes17e4.js → cli-1m96dc36.js} +3 -3
- package/dist/{cli-2r0jcc3k.js → cli-2d0cghfn.js} +1 -1
- package/dist/{cli-wk18cm92.js → cli-4ax9mvvg.js} +4 -4
- package/dist/{cli-9wngrawf.js → cli-4dpkjc2e.js} +6 -6
- package/dist/{cli-x1wa213s.js → cli-4e1hfbpq.js} +5 -5
- package/dist/{cli-7349va39.js → cli-500c09j9.js} +921 -431
- package/dist/{cli-m4dqmnbp.js → cli-54qr8mcd.js} +2 -2
- package/dist/{cli-m88rpzkh.js → cli-5a7szzfh.js} +2 -2
- package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
- package/dist/{cli-vj75tyaw.js → cli-6yygkr0w.js} +7 -7
- package/dist/{cli-7b8sbmag.js → cli-7c5tgqhf.js} +5 -5
- package/dist/{cli-2gxeg5gr.js → cli-8476gtwf.js} +1 -1
- package/dist/{cli-yncmerje.js → cli-922z7gwm.js} +4 -4
- package/dist/{cli-jrzkw01m.js → cli-93t5s4zq.js} +2 -2
- package/dist/{cli-sn7rtnj4.js → cli-9zmb7ptc.js} +9 -9
- package/dist/{cli-tk7cjj8h.js → cli-am1ptset.js} +3 -3
- package/dist/{cli-cyhbbd1z.js → cli-awwptga4.js} +1 -1
- package/dist/{cli-89cqnasv.js → cli-bhsfbmk8.js} +19 -7
- package/dist/{cli-9vhebtjz.js → cli-bj6qhgte.js} +15 -32
- package/dist/{cli-g70vxtjh.js → cli-c0xjnr8z.js} +2 -2
- package/dist/{cli-vqptjbr7.js → cli-c3ng0mb4.js} +14 -14
- package/dist/{cli-re4raaj0.js → cli-c71n3bxq.js} +11 -6
- package/dist/{cli-7p1kvkck.js → cli-crpf163n.js} +25 -18
- package/dist/{cli-k0wwfqbg.js → cli-dns0y538.js} +4 -0
- package/dist/{cli-d3p5vwbk.js → cli-dpsfwh7n.js} +13 -21
- package/dist/{cli-xzm9vcfg.js → cli-dtdht77h.js} +2 -2
- package/dist/{cli-bb431xey.js → cli-e2w34h6z.js} +231 -68
- package/dist/{cli-eddnyg3t.js → cli-emekyyhr.js} +1 -1
- package/dist/{cli-d84byzn8.js → cli-f1kwb5fc.js} +109 -33
- package/dist/{cli-0jzra9ad.js → cli-gn9y6fn7.js} +2 -2
- package/dist/{cli-tqegb8eq.js → cli-gpz1d0t2.js} +4 -4
- package/dist/{cli-7w69ne2f.js → cli-h9yy18gy.js} +239 -67
- package/dist/{cli-m5akxq8q.js → cli-j8cjdzan.js} +1 -1
- package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
- package/dist/{cli-k26bkr9t.js → cli-k2rw11py.js} +3 -3
- package/dist/{cli-93k32c37.js → cli-k96cecs7.js} +377 -61
- package/dist/{cli-3vjhs18n.js → cli-kd56bmk4.js} +1 -1
- package/dist/{cli-k0615eh8.js → cli-kmemts3w.js} +13 -13
- package/dist/{cli-pcad4cb1.js → cli-knva3nmx.js} +2 -2
- package/dist/{cli-b085njxz.js → cli-kw44j53p.js} +15 -14
- package/dist/{cli-bsywb58a.js → cli-mdpbjnzq.js} +10 -10
- package/dist/{cli-syybb0p1.js → cli-me0r8gzr.js} +35 -76
- package/dist/{cli-4r05hnqa.js → cli-mwwmka77.js} +15 -15
- package/dist/{cli-1xh9a7hn.js → cli-n5t077me.js} +2 -2
- package/dist/{cli-rvhdmjvt.js → cli-nx2n3z6p.js} +1 -1
- package/dist/{cli-28fq781p.js → cli-pe4d96rb.js} +1 -1
- package/dist/{cli-3rkdne1h.js → cli-pxwtcgcp.js} +2 -2
- package/dist/{cli-zcsw143p.js → cli-qmqt520k.js} +2 -2
- package/dist/{cli-2zp0et3v.js → cli-qps8je6j.js} +70 -19
- package/dist/{cli-xae4g51r.js → cli-rh15cakt.js} +1 -1
- package/dist/{cli-k93bq1wq.js → cli-rjvsf9qa.js} +5 -5
- package/dist/{cli-6mma83xa.js → cli-rqfvkx5t.js} +7 -7
- package/dist/{cli-dy32zecz.js → cli-s7zz734a.js} +1 -1
- package/dist/{cli-yn2bbre9.js → cli-s8p8hhty.js} +2 -2
- package/dist/{cli-vbh10fqa.js → cli-sdvcrq5x.js} +5 -5
- package/dist/{cli-b5rs97a6.js → cli-sg27rk2t.js} +5 -5
- package/dist/{cli-d6521kb5.js → cli-skmhsnqh.js} +1 -1
- package/dist/{cli-5mrq3ake.js → cli-t4dv07kr.js} +1 -1
- package/dist/{cli-hxpyc9sn.js → cli-t5ys4ebm.js} +3 -3
- package/dist/{cli-qmqk2yc2.js → cli-tas6ckky.js} +2 -2
- package/dist/{cli-p1w18yhx.js → cli-tf79ryyy.js} +1 -1
- package/dist/{cli-kc7v1nfv.js → cli-tnzebztn.js} +1 -1
- package/dist/{cli-gax7fk3t.js → cli-vx421edw.js} +3 -3
- package/dist/{cli-kchjb7qy.js → cli-x3ex5bqf.js} +1 -1
- package/dist/cli-yss07azk.js +142 -0
- package/dist/{cli-0ntbxyaa.js → cli-z8cvws4c.js} +363 -47
- package/dist/{cli-tacge1w0.js → cli-zdaypkq9.js} +146 -52
- package/dist/{cli-b8e9nb04.js → cli-zeaehgyd.js} +2 -2
- package/dist/{cli-jcpr5smb.js → cli-ztq5z4e1.js} +4 -4
- package/dist/cli.js +21 -21
- package/dist/{codex-adapter-nha71q3n.js → codex-adapter-2brxx5ta.js} +7 -8
- package/dist/{codex-hook-h3vk6xzr.js → codex-hook-c930c3ea.js} +2 -2
- package/dist/{codex-login-bcda78ge.js → codex-login-cbrs1h5w.js} +1 -1
- package/dist/{codex-session-runner-ak9x1k1h.js → codex-session-runner-y9anfj0r.js} +8 -9
- package/dist/{commands-f587qpq8.js → commands-wn9q06qr.js} +3 -3
- package/dist/{controller-hxx8wwy1.js → controller-fw608czd.js} +4 -4
- package/dist/{controllers-connect-k5sg9m9h.js → controllers-connect-63j5rdcm.js} +20 -20
- package/dist/{cursor-adapter-n5nc3mfe.js → cursor-adapter-6mb9jme8.js} +2 -2
- package/dist/{db-nzf8zb5z.js → db-0m6v5tq4.js} +3 -3
- package/dist/{db-amm8w15a.js → db-y4wfrzbm.js} +4 -2
- package/dist/{devin-adapter-xedz98zv.js → devin-adapter-r0yx3gv8.js} +1 -1
- package/dist/{dispatcher-89zrts8f.js → dispatcher-9tq2zzdj.js} +17 -17
- package/dist/{docker-866qpzt9.js → docker-j75atvpt.js} +2 -2
- package/dist/{dsh-adapter-nrhbrjz8.js → dsh-adapter-t09sv4tq.js} +2 -2
- package/dist/{e2b-s16txnpx.js → e2b-7s9dscap.js} +3 -3
- package/dist/{e2b-jkwfhbcv.js → e2b-a7vzs2vj.js} +3 -3
- package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-fbwvmwhe.js} +1 -1
- package/dist/{embedding-space-ezwenjmj.js → embedding-space-wh8de1t9.js} +6 -6
- package/dist/{embeddings-np74ht6g.js → embeddings-3hpbdtjr.js} +1 -1
- package/dist/{event-bus-e66gh7cc.js → event-bus-tr6h3gv8.js} +1 -1
- package/dist/{execute-b3mrb1mv.js → execute-4bdf8sdy.js} +1 -1
- package/dist/{external-channel-z46yx9d7.js → external-channel-ts2fwqh0.js} +2 -2
- package/dist/fx-adapter-1rnxnf56.js +17 -0
- package/dist/grok-adapter-efhmf1r8.js +17 -0
- package/dist/handlers-anrr3py9.js +32 -0
- package/dist/{heartbeat-dt9qw9c8.js → heartbeat-2ze5fzpc.js} +20 -20
- package/dist/{hook-8k6fbz9b.js → hook-ca54yd4s.js} +5 -5
- package/dist/{hook-jgcgygex.js → hook-gaehe2w5.js} +8 -8
- package/dist/{http-haw4r8ne.js → http-jfg8t2yk.js} +3839 -122
- package/dist/{index-tvfafeyy.js → index-3gv6sc4z.js} +1 -1
- package/dist/{index-tez78qj3.js → index-3yvzbhxd.js} +100 -23
- package/dist/index-8w2aznds.js +33 -0
- package/dist/{index-5gk12my8.js → index-csgrxedz.js} +1 -1
- package/dist/index-qnjvr362.js +37 -0
- package/dist/index-yzxd3sn9.js +32 -0
- package/dist/{keepalive-xn6s7rmg.js → keepalive-k2a3qe73.js} +4 -4
- package/dist/lead-zhxqbfdv.js +69 -0
- package/dist/{maintenance-vdts800b.js → maintenance-gb5sd5nc.js} +1 -1
- package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
- package/dist/{oauth-refresh-sweep-094c8wfk.js → oauth-refresh-sweep-y7rm6bkb.js} +3 -3
- package/dist/{onboard-v99eh56m.js → onboard-jmc5qerv.js} +4 -4
- package/dist/{opencode-adapter-dsagkhtw.js → opencode-adapter-7eade9ev.js} +6 -7
- package/dist/{otel-impl-q7yr9yp0.js → otel-impl-8j1xhxqd.js} +2 -2
- package/dist/{pi-mono-adapter-546cd1cc.js → pi-mono-adapter-yqmaf32x.js} +14 -13
- package/dist/{pricing-refresh-7dh2yase.js → pricing-refresh-1nj722h6.js} +2 -2
- package/dist/{rbac-roles-mdmc96p4.js → rbac-roles-b1mtr6dr.js} +3 -3
- package/dist/{rbac-roles-npbmdh77.js → rbac-roles-n1f3frk1.js} +2 -2
- package/dist/{render-v2-twhhwmms.js → render-v2-1gfpd8rj.js} +4 -4
- package/dist/{resume-5gsrjd5e.js → resume-w1s1eh5v.js} +7 -7
- package/dist/{runtime-1hv06jsn.js → runtime-84g5egsc.js} +1 -1
- package/dist/{session-access-m191x30x.js → session-access-y6z1txk4.js} +4 -4
- package/dist/{session-source-backfill-nt923ask.js → session-source-backfill-gxxwfh12.js} +3 -3
- package/dist/{setup-wv467afy.js → setup-r91gstyk.js} +1 -1
- package/dist/{virtual-modules-gazyapte.js → virtual-modules-cgnj6kme.js} +3 -3
- package/dist/{work-objects-8zkrpy13.js → work-objects-qcxzg61c.js} +20 -20
- package/dist/worker-7j2907g6.js +69 -0
- package/dist/{worker-follow-up-cecqszem.js → worker-follow-up-y2d2h7km.js} +19 -17
- package/dist/{x-2fyrt5pp.js → x-qhxq2ama.js} +2 -2
- package/openapi.json +2908 -351
- package/package.json +4 -4
- package/src/apps/catalog.generated.json +120 -1
- package/src/apps/definition.ts +38 -11
- package/src/apps/page-validator.ts +88 -0
- package/src/be/db/model-profiles.ts +110 -11
- package/src/be/db/tasks/read.ts +53 -0
- package/src/be/db/workflow-run-definitions.ts +19 -8
- package/src/be/db-client.ts +43 -5
- package/src/be/db.ts +40 -9
- package/src/be/migrations/284_model_profile_fallbacks.sql +9 -0
- package/src/be/migrations/289_automation_savings_daily.sql +47 -0
- package/src/be/migrations/291_task_slack_participants.sql +4 -0
- package/src/be/migrations/293_savings_component_links.sql +58 -0
- package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
- package/src/be/model-profile-check.ts +53 -20
- package/src/be/runtime-pools/routing.ts +1 -0
- package/src/be/savings/calibrate.ts +468 -0
- package/src/be/savings/compute.ts +677 -0
- package/src/be/savings/model.ts +674 -0
- package/src/be/savings/read.ts +1500 -0
- package/src/be/savings/rollup.ts +571 -0
- package/src/be/scripts/run-credential.ts +15 -3
- package/src/be/scripts/typecheck.ts +91 -4
- package/src/be/seed/agent-fs-provision.ts +48 -11
- package/src/be/seed/workflows-seeder.ts +67 -23
- package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
- package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
- package/src/be/skill-parser.ts +19 -7
- package/src/be/swarm-config-guard.ts +8 -0
- package/src/be/users.ts +29 -2
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/provider-error-class.ts +97 -0
- package/src/commands/runner.ts +258 -58
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/http/all-routes.ts +2 -0
- package/src/http/fs.ts +8 -2
- package/src/http/index.ts +11 -0
- package/src/http/model-profiles.ts +43 -10
- package/src/http/poll.ts +15 -1
- package/src/http/requested-by.ts +97 -1
- package/src/http/savings-calibration.ts +277 -0
- package/src/http/savings.ts +849 -0
- package/src/http/scripts.ts +26 -15
- package/src/http/tasks.ts +89 -9
- package/src/http/trackers/authorize-gate.ts +41 -0
- package/src/http/trackers/jira.ts +26 -4
- package/src/http/trackers/linear.ts +26 -4
- package/src/integrations/chat-sdk/limits.ts +6 -1
- package/src/jira/oauth.ts +7 -1
- package/src/linear/README.md +2 -1
- package/src/linear/oauth.ts +7 -1
- package/src/prompts/session-templates.ts +80 -3
- package/src/providers/acp-targets.ts +1 -1
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/claude-adapter.ts +0 -20
- package/src/providers/claude-flag-settings.ts +12 -10
- package/src/providers/codex-adapter.ts +12 -34
- package/src/providers/opencode-adapter.ts +34 -12
- package/src/providers/pi-mono-adapter.ts +6 -5
- package/src/providers/types.ts +7 -0
- package/src/scheduler/scheduler.ts +20 -14
- package/src/scripts-runtime/ctx.ts +1 -1
- package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
- package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
- package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
- package/src/scripts-runtime/sdk-allowlist.ts +11 -1
- package/src/scripts-runtime/stdlib/fetch.ts +113 -15
- package/src/scripts-runtime/stdlib/index.ts +3 -1
- package/src/scripts-runtime/stdlib/retry.ts +174 -0
- package/src/scripts-runtime/swarm-sdk.ts +192 -17
- package/src/scripts-runtime/types/stdlib.d.ts +95 -4
- package/src/scripts-runtime/types/swarm-extension.d.ts +60 -0
- package/src/scripts-runtime/types/swarm-sdk.d.ts +69 -2
- package/src/slack/actions.ts +1 -0
- package/src/slack/assistant.ts +2 -0
- package/src/slack/enrich.ts +144 -50
- package/src/slack/handlers.ts +37 -95
- package/src/slack/templates.ts +9 -0
- package/src/slack/thread-buffer.ts +45 -71
- package/src/slack/thread-participants.ts +187 -0
- package/src/tasks/worker-follow-up.ts +142 -3
- package/src/tests/agent-fs-provision-seeder.test.ts +81 -0
- package/src/tests/apps-chart-shell.test.ts +170 -0
- package/src/tests/apps-icon.test.ts +156 -2
- package/src/tests/base-prompt.test.ts +5 -4
- package/src/tests/chat-sdk-relay.test.ts +12 -0
- package/src/tests/claude-adapter-binary.test.ts +7 -1
- package/src/tests/claude-adapter.test.ts +10 -64
- package/src/tests/claude-flag-settings.test.ts +15 -11
- package/src/tests/claude-hook-credentials.test.ts +0 -1
- package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
- package/src/tests/codex-adapter.test.ts +28 -78
- package/src/tests/comb-default.test.ts +6 -0
- package/src/tests/core-auth.test.ts +7 -6
- package/src/tests/create-task-vcs-repo.test.ts +136 -0
- package/src/tests/db-client-busy-retry.test.ts +58 -6
- package/src/tests/db-task-read-contract.test.ts +2 -0
- package/src/tests/db-task-write-contract.test.ts +1 -0
- package/src/tests/deploy-guard.test.ts +154 -0
- package/src/tests/docs-index-footprint.test.js +3 -3
- package/src/tests/dreaming-learnings.test.ts +104 -0
- package/src/tests/extensions-pre-task.test.ts +4 -2
- package/src/tests/fetch-resolved-env.test.ts +47 -1
- package/src/tests/fixtures/app-shell-charts-definition.json.txt +180 -0
- package/src/tests/model-profile-fallbacks.test.ts +482 -0
- package/src/tests/model-profiles-api.test.ts +1 -0
- package/src/tests/opencode-adapter.test.ts +53 -6
- package/src/tests/pi-mono-session-cost-on-abort.test.ts +115 -0
- package/src/tests/prompt-template-session.test.ts +17 -1
- package/src/tests/provider-error-class.test.ts +174 -0
- package/src/tests/runner-provider-fallback.test.ts +197 -0
- package/src/tests/runner-requester-profile.test.ts +139 -1
- package/src/tests/savings-calibration-api.test.ts +264 -0
- package/src/tests/savings-calibration.test.ts +201 -0
- package/src/tests/savings-compound.test.ts +774 -0
- package/src/tests/savings-compute.test.ts +215 -0
- package/src/tests/savings-fleet-latency.test.ts +143 -0
- package/src/tests/savings-fleet-read.test.ts +195 -0
- package/src/tests/savings-fleet-scale.test.ts +222 -0
- package/src/tests/savings-model.test.ts +499 -0
- package/src/tests/savings-read.test.ts +367 -0
- package/src/tests/savings-rollup.test.ts +766 -0
- package/src/tests/savings-scripts.test.ts +611 -0
- package/src/tests/script-connections.test.ts +4 -0
- package/src/tests/script-executor-conformance.test.ts +444 -0
- package/src/tests/scripts-http.test.ts +55 -0
- package/src/tests/scripts-runtime-fetch.test.ts +2 -2
- package/src/tests/sdk-allowlist.test.ts +40 -0
- package/src/tests/secret-rules.test.ts +124 -1
- package/src/tests/secret-scrubber.test.ts +1 -1
- package/src/tests/seed-workflows.test.ts +167 -11
- package/src/tests/skill-parser.test.ts +45 -0
- package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
- package/src/tests/slack-identity-resolution.test.ts +23 -0
- package/src/tests/slack-inbound-files.test.ts +2 -1
- package/src/tests/slack-thread-participants.test.ts +429 -0
- package/src/tests/tool-annotations.test.ts +30 -0
- package/src/tests/tracker-oauth-authorize-auth.test.ts +262 -0
- package/src/tests/workflow-definition-pinning.test.ts +128 -3
- package/src/tests/workflow-script-principal.test.ts +94 -4
- package/src/tools/app-upsert.ts +1 -1
- package/src/tools/model-profiles/list-model-profiles.ts +4 -2
- package/src/tools/update-profile.ts +1 -1
- package/src/types.ts +146 -33
- package/src/utils/constants.ts +2 -0
- package/src/utils/mcp-server-fetcher.test.ts +89 -0
- package/src/utils/mcp-server-fetcher.ts +13 -5
- package/src/utils/request-auth-context.ts +24 -0
- package/src/utils/secret-rules.generated.ts +1 -1
- package/src/utils/secret-scrubber.ts +154 -29
- package/src/workflows/executors/swarm-script.ts +23 -19
- package/templates/skills/apps/SKILL.md +62 -3
- package/templates/skills/apps/content.md +62 -3
- package/templates/skills/swarm-docs/content.md +2 -0
- package/templates/skills/swarm-scripts/SKILL.md +5 -4
- package/templates/skills/swarm-scripts/content.md +5 -4
- package/templates/skills/work-on-task/SKILL.md +1 -1
- package/templates/skills/work-on-task/content.md +1 -1
- package/templates/workflows/dreaming/content.md +1 -1
- package/dist/acp-adapter-pdy3qsvg.js +0 -15
- package/dist/cli-4bd1rck6.js +0 -4
- package/dist/cli-jywyhqws.js +0 -104
- package/dist/fx-adapter-3q12snn6.js +0 -18
- package/dist/grok-adapter-ahb1w033.js +0 -18
- package/dist/handlers-vbww69re.js +0 -32
- package/dist/index-4xwaf5th.js +0 -32
- package/dist/index-f0hcrs8e.js +0 -33
- package/dist/index-s4ewdma4.js +0 -37
- package/dist/lead-6ygbfhbh.js +0 -70
- package/dist/worker-mz5z7kj0.js +0 -70
- package/src/providers/ctx-mode-env.ts +0 -10
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from "node:http";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { getDbClient, getSwarmConfigs, upsertSwarmConfig } from "../be/db";
|
|
4
|
+
import { type DbParam, DbTransactionDeadlineError } from "../be/db-client";
|
|
5
|
+
import { calibrate, type DerivedCurveSet } from "../be/savings/calibrate";
|
|
6
|
+
import type { SavingsSql } from "../be/savings/compute";
|
|
7
|
+
import {
|
|
8
|
+
type CurveSet,
|
|
9
|
+
SAVINGS_CALIBRATION_KEY,
|
|
10
|
+
SAVINGS_TIERS,
|
|
11
|
+
SHIPPED_CALIBRATION,
|
|
12
|
+
StoredCalibrationSchema,
|
|
13
|
+
} from "../be/savings/model";
|
|
14
|
+
import { ensureConfigAdmin } from "./config";
|
|
15
|
+
import { DbQueryConcurrencyCapError, DbQueryTimeoutError } from "./db-query-shared";
|
|
16
|
+
import { route } from "./route-def";
|
|
17
|
+
import { boundedSql, clearCalibrationCache } from "./savings";
|
|
18
|
+
import { json, jsonError } from "./utils";
|
|
19
|
+
|
|
20
|
+
/** A run that has not finished by now is abandoned with a 504. */
|
|
21
|
+
const DEADLINE_MS = 120_000;
|
|
22
|
+
let deadlineMs = DEADLINE_MS;
|
|
23
|
+
let running = false;
|
|
24
|
+
|
|
25
|
+
/** Test hook: shrink the deadline. */
|
|
26
|
+
export function setCalibrationDeadlineMs(ms: number | null): void {
|
|
27
|
+
deadlineMs = ms ?? DEADLINE_MS;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
class DeadlineError extends Error {}
|
|
31
|
+
|
|
32
|
+
const plain = (c: CurveSet): DerivedCurveSet =>
|
|
33
|
+
Object.fromEntries(
|
|
34
|
+
SAVINGS_TIERS.map((t) => [t, { usd: [...c[t].usd], hrs: [...c[t].hrs] }]),
|
|
35
|
+
) as DerivedCurveSet;
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* `boundedSql` (child process, per-query budget, shared concurrency cap) under one
|
|
39
|
+
* wall-clock deadline for the whole run. A full concurrency cap is waited out, not read as empty.
|
|
40
|
+
*/
|
|
41
|
+
function deadlineSql(deadlineAt: number): SavingsSql {
|
|
42
|
+
return async <T>(sql: string, params: DbParam[]) => {
|
|
43
|
+
for (let attempt = 0; ; attempt++) {
|
|
44
|
+
const left = deadlineAt - Date.now();
|
|
45
|
+
if (left <= 0) throw new DeadlineError();
|
|
46
|
+
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
47
|
+
const query = boundedSql<T>(sql, params);
|
|
48
|
+
query.catch(() => {}); // an abandoned query's late failure is not an unhandled rejection
|
|
49
|
+
try {
|
|
50
|
+
return await Promise.race([
|
|
51
|
+
query,
|
|
52
|
+
new Promise<never>((_, reject) => {
|
|
53
|
+
timer = setTimeout(() => reject(new DeadlineError()), left);
|
|
54
|
+
}),
|
|
55
|
+
]);
|
|
56
|
+
} catch (err) {
|
|
57
|
+
if (!(err instanceof DbQueryConcurrencyCapError)) throw err;
|
|
58
|
+
// Never sleep past the deadline: the next turn then fails on time.
|
|
59
|
+
const nap = Math.min(250 * 2 ** attempt, 2000, Math.max(0, deadlineAt - Date.now()));
|
|
60
|
+
await new Promise((r) => setTimeout(r, nap));
|
|
61
|
+
} finally {
|
|
62
|
+
clearTimeout(timer);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
const TierCurvesSchema = z.object({ usd: z.array(z.number()), hrs: z.array(z.number()) });
|
|
69
|
+
const CurveSetSchema = z.object(
|
|
70
|
+
Object.fromEntries(SAVINGS_TIERS.map((t) => [t, TierCurvesSchema])) as Record<
|
|
71
|
+
(typeof SAVINGS_TIERS)[number],
|
|
72
|
+
typeof TierCurvesSchema
|
|
73
|
+
>,
|
|
74
|
+
);
|
|
75
|
+
const WindowSchema = z.object({ start: z.string(), end: z.string(), sessions: z.number().int() });
|
|
76
|
+
|
|
77
|
+
const StoredSchema = z.object({
|
|
78
|
+
calibratedAt: z.string(),
|
|
79
|
+
model: z.string(),
|
|
80
|
+
curve: CurveSetSchema,
|
|
81
|
+
window: WindowSchema.optional(),
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
const GapSchema = z.object({
|
|
85
|
+
tier: z.enum(SAVINGS_TIERS),
|
|
86
|
+
key: z.enum(["usd", "hrs"]),
|
|
87
|
+
median: z.number().describe("Median absolute deviation from the shipped curve, as a fraction."),
|
|
88
|
+
max: z.number(),
|
|
89
|
+
over5pct: z.number().int().describe("Turn counts more than 5% from the shipped curve."),
|
|
90
|
+
points: z.number().int(),
|
|
91
|
+
weighted: z
|
|
92
|
+
.number()
|
|
93
|
+
.describe("Session-weighted mean of derived over shipped; 1 means the same price."),
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
const getRoute = route({
|
|
97
|
+
method: "get",
|
|
98
|
+
path: "/api/savings/calibration",
|
|
99
|
+
pattern: ["api", "savings", "calibration"],
|
|
100
|
+
summary: "The savings curve in use",
|
|
101
|
+
description:
|
|
102
|
+
"Which curve prices the savings endpoints: the one shipped with the release, or one derived from this deployment's sessions and stored by `POST /api/savings/calibration`. Reports the stored row's metadata (a malformed row is reported as invalid and ignored by the savings endpoints).",
|
|
103
|
+
tags: ["Savings"],
|
|
104
|
+
responses: {
|
|
105
|
+
200: {
|
|
106
|
+
description: "The active calibration",
|
|
107
|
+
schema: z.object({
|
|
108
|
+
source: z.enum(["shipped", "deployment"]),
|
|
109
|
+
active: StoredSchema.omit({ window: true }),
|
|
110
|
+
stored: z
|
|
111
|
+
.object({
|
|
112
|
+
valid: z.boolean(),
|
|
113
|
+
updatedAt: z.string(),
|
|
114
|
+
calibratedAt: z.string().optional(),
|
|
115
|
+
model: z.string().optional(),
|
|
116
|
+
window: WindowSchema.optional(),
|
|
117
|
+
})
|
|
118
|
+
.nullable(),
|
|
119
|
+
}),
|
|
120
|
+
},
|
|
121
|
+
},
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
const postRoute = route({
|
|
125
|
+
method: "post",
|
|
126
|
+
path: "/api/savings/calibration",
|
|
127
|
+
pattern: ["api", "savings", "calibration"],
|
|
128
|
+
summary: "Derive the savings curve from this deployment's sessions",
|
|
129
|
+
description:
|
|
130
|
+
"Reads the window's opus sessions through the bounded query executor, derives the per-tier cost and hours curve, and compares it to the shipped one. Read-only unless `apply` is true, which also requires `config.write.any`: then the curve is stored in the global `SAVINGS_CURVE_CALIBRATION` config row and the savings endpoints use it within seconds. Nothing is stored when the data cannot support a curve or the derived mean cost is more than 3x or less than a third of the shipped one. One run at a time; a run past 120 s is abandoned with 504.",
|
|
131
|
+
tags: ["Savings"],
|
|
132
|
+
body: z.object({
|
|
133
|
+
days: z.number().int().min(1).max(90).default(30),
|
|
134
|
+
end: z.iso.datetime().optional().describe("End of the window (ISO 8601); default now."),
|
|
135
|
+
apply: z.boolean().default(false),
|
|
136
|
+
}),
|
|
137
|
+
responses: {
|
|
138
|
+
200: {
|
|
139
|
+
description: "The derived curve, or why there is none",
|
|
140
|
+
schema: z.object({
|
|
141
|
+
window: z.object({ start: z.string(), end: z.string(), days: z.number().int() }),
|
|
142
|
+
sessions: z.number().int().describe("Opus sessions of 1 to 61 turns used."),
|
|
143
|
+
refusals: z
|
|
144
|
+
.array(z.string())
|
|
145
|
+
.describe("Why no curve was derived, or why a derived one was not applied."),
|
|
146
|
+
calibration: StoredSchema.nullable().describe("The derived curve; null when refused."),
|
|
147
|
+
speed: z.record(z.string(), z.number()).nullable(),
|
|
148
|
+
repriceMatch: z.number().nullable(),
|
|
149
|
+
meanRatio: z
|
|
150
|
+
.number()
|
|
151
|
+
.nullable()
|
|
152
|
+
.describe("Derived smart-tier mean cost over the shipped one."),
|
|
153
|
+
gaps: z.array(GapSchema),
|
|
154
|
+
applied: z.boolean(),
|
|
155
|
+
}),
|
|
156
|
+
},
|
|
157
|
+
400: { description: "Invalid days, end or apply" },
|
|
158
|
+
403: { description: "`apply` without permission to write config" },
|
|
159
|
+
408: { description: "A session query ran past its time budget" },
|
|
160
|
+
409: { description: "Another calibration run is in progress" },
|
|
161
|
+
504: { description: "The run passed its 120 s deadline" },
|
|
162
|
+
},
|
|
163
|
+
rbac: {
|
|
164
|
+
ungated:
|
|
165
|
+
"a dry run only reads sessions; apply:true is gated by config.write.any in the handler",
|
|
166
|
+
},
|
|
167
|
+
});
|
|
168
|
+
|
|
169
|
+
export async function handleSavingsCalibration(
|
|
170
|
+
req: IncomingMessage,
|
|
171
|
+
res: ServerResponse,
|
|
172
|
+
pathSegments: string[],
|
|
173
|
+
queryParams: URLSearchParams,
|
|
174
|
+
): Promise<boolean> {
|
|
175
|
+
if (getRoute.match(req.method, pathSegments)) {
|
|
176
|
+
const [row] = await getSwarmConfigs({ scope: "global", key: SAVINGS_CALIBRATION_KEY });
|
|
177
|
+
let parsed: z.infer<typeof StoredCalibrationSchema> | null = null;
|
|
178
|
+
try {
|
|
179
|
+
const result = StoredCalibrationSchema.safeParse(JSON.parse(row?.value ?? "null"));
|
|
180
|
+
parsed = result.success ? result.data : null;
|
|
181
|
+
} catch {
|
|
182
|
+
// malformed JSON: reported below as an invalid row
|
|
183
|
+
}
|
|
184
|
+
const active = parsed ?? { ...SHIPPED_CALIBRATION, curve: plain(SHIPPED_CALIBRATION.curve) };
|
|
185
|
+
getRoute.respond(res, 200, {
|
|
186
|
+
source: parsed ? "deployment" : "shipped",
|
|
187
|
+
active: { calibratedAt: active.calibratedAt, model: active.model, curve: active.curve },
|
|
188
|
+
stored: row
|
|
189
|
+
? {
|
|
190
|
+
valid: parsed !== null,
|
|
191
|
+
updatedAt: row.lastUpdatedAt,
|
|
192
|
+
...(parsed
|
|
193
|
+
? {
|
|
194
|
+
calibratedAt: parsed.calibratedAt,
|
|
195
|
+
model: parsed.model,
|
|
196
|
+
...(parsed.window ? { window: parsed.window } : {}),
|
|
197
|
+
}
|
|
198
|
+
: {}),
|
|
199
|
+
}
|
|
200
|
+
: null,
|
|
201
|
+
});
|
|
202
|
+
return true;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
if (!postRoute.match(req.method, pathSegments)) return false;
|
|
206
|
+
const parsed = await postRoute.parse(req, res, pathSegments, queryParams);
|
|
207
|
+
if (!parsed) return true;
|
|
208
|
+
const { days, end, apply } = parsed.body;
|
|
209
|
+
// One clock for the whole request: the permission check, every query, the derivation and the write.
|
|
210
|
+
const deadlineAt = Date.now() + deadlineMs;
|
|
211
|
+
if (apply && !(await ensureConfigAdmin(req, res, "config.write.any"))) return true;
|
|
212
|
+
if (running) {
|
|
213
|
+
jsonError(res, "A calibration run is already in progress", 409);
|
|
214
|
+
return true;
|
|
215
|
+
}
|
|
216
|
+
running = true;
|
|
217
|
+
try {
|
|
218
|
+
const run = await calibrate(deadlineSql(deadlineAt), {
|
|
219
|
+
days,
|
|
220
|
+
end: end ? new Date(end) : new Date(),
|
|
221
|
+
});
|
|
222
|
+
// The derivation between queries is CPU work no query race can cut short.
|
|
223
|
+
if (Date.now() >= deadlineAt) throw new DeadlineError();
|
|
224
|
+
const refusals = run.refusal ? [run.refusal] : [];
|
|
225
|
+
let applied = false;
|
|
226
|
+
if (apply && run.calibration) {
|
|
227
|
+
if (run.applyBlocked) {
|
|
228
|
+
refusals.push(`not applied: ${run.applyBlocked}`);
|
|
229
|
+
} else {
|
|
230
|
+
StoredCalibrationSchema.parse(run.calibration);
|
|
231
|
+
// The outer transaction owns the deadline (upsertSwarmConfig's own one becomes a
|
|
232
|
+
// savepoint inside it): BEGIN stops retrying and COMMIT is skipped once it has
|
|
233
|
+
// passed, so a 504 is never followed by a late write.
|
|
234
|
+
await getDbClient().transaction(
|
|
235
|
+
() =>
|
|
236
|
+
upsertSwarmConfig({
|
|
237
|
+
scope: "global",
|
|
238
|
+
key: SAVINGS_CALIBRATION_KEY,
|
|
239
|
+
value: JSON.stringify(run.calibration),
|
|
240
|
+
// Read by the API only; keep the ~9 KB blob out of every agent's environment.
|
|
241
|
+
exportToEnv: false,
|
|
242
|
+
description: "Savings session curve derived from this deployment's sessions",
|
|
243
|
+
}),
|
|
244
|
+
{ deadlineAt },
|
|
245
|
+
);
|
|
246
|
+
clearCalibrationCache();
|
|
247
|
+
applied = true;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
postRoute.respond(res, 200, {
|
|
251
|
+
window: run.window,
|
|
252
|
+
sessions: run.sessions,
|
|
253
|
+
refusals,
|
|
254
|
+
calibration: run.calibration,
|
|
255
|
+
speed: run.speed,
|
|
256
|
+
repriceMatch: run.repriceMatch,
|
|
257
|
+
meanRatio: run.meanRatio,
|
|
258
|
+
gaps: run.gaps,
|
|
259
|
+
applied,
|
|
260
|
+
});
|
|
261
|
+
} catch (err) {
|
|
262
|
+
if (err instanceof DeadlineError || err instanceof DbTransactionDeadlineError) {
|
|
263
|
+
jsonError(
|
|
264
|
+
res,
|
|
265
|
+
`Calibration passed its ${deadlineMs / 1000} s deadline; use a shorter window`,
|
|
266
|
+
504,
|
|
267
|
+
);
|
|
268
|
+
} else if (err instanceof DbQueryTimeoutError) {
|
|
269
|
+
json(res, { error: "db_query_timeout", message: err.message }, 408);
|
|
270
|
+
} else {
|
|
271
|
+
throw err;
|
|
272
|
+
}
|
|
273
|
+
} finally {
|
|
274
|
+
running = false;
|
|
275
|
+
}
|
|
276
|
+
return true;
|
|
277
|
+
}
|