Every agent's model. One place. Codex on DeepSeek, Claude Code on Kimi, from the menu bar.
routing: a wallet's row says what of it lapses first, as the Usage card does (#3964)
yetone5ced5b1aa01c
diff --git a/docs/subsystems/provider-plugins.md b/docs/subsystems/provider-plugins.mdindex deac995d0..e4cb759a4 100644--- a/docs/subsystems/provider-plugins.md+++ b/docs/subsystems/provider-plugins.md@@ -44,7 +44,7 @@ A usage window's `used` (percent) may be left out when the plugin can't tell it:## A wallet's balance-A prepaid wallet (SuperMagic's points, [#3950](https://github.com/yetone/magpie/issues/3950)) has a balance and nothing it is a share of. A usage window may send `balance` (a number, in `unit`) and leave out `used`, `limit` and `aside`: `{name: "积分", balance: 6291, unit: "积分"}`. The host passes a finite number on, at least 0, and anything else as `null` (`usageOf` in [`host.js`](../../internal/plugin/host.js)); `plugin.UsageWindow.Balance` and `provider.QuotaWindow.Balance` are `*float64`. [`quotaOfPlugin`](../../internal/provider/plugin_usage.go) keeps the figure and does not make the window `Text` or `Aside`, so the account is known to routing with no `Used` invented. `allowanceOf` copies it into `Limit.Balance`, and an empty wallet (0) counts as used up. `Allowance.Left(model)` is the least balance of the windows that count the model, with its unit. `weighRouted` sets `routes.Seat.Left` to it and `Seat.LeftIn` to the account's provider and unit; Smart, `pace` and `usage` put the seat with more left first where they would otherwise tie (`byLeft` in [`strategies.go`](../../internal/routes/strategies.go)), and only when every seat that has a balance shares one `LeftIn`, so balances in two units or two providers are never weighed against each other. The card, the Routing page (`Weighed.Balance`) and the CLI show the figure ("6,291 积分 left", `provider.BalanceText`) and no meter. Tests: `TestPluginWalletBalanceIsAReading`, `TestPluginHostPassesABalanceOn`, `TestWalletsGoByWhatTheyHaveLeft`, `TestWalletWithMoreLeftGoesFirst`, `usage-wallet-balance.test.cjs`, `routing-wallet-balance.test.cjs`.+A prepaid wallet (SuperMagic's points, [#3950](https://github.com/yetone/magpie/issues/3950)) has a balance and nothing it is a share of. A usage window may send `balance` (a number, in `unit`) and leave out `used`, `limit` and `aside`: `{name: "积分", balance: 6291, unit: "积分"}`. The host passes a finite number on, at least 0, and anything else as `null` (`usageOf` in [`host.js`](../../internal/plugin/host.js)); `plugin.UsageWindow.Balance` and `provider.QuotaWindow.Balance` are `*float64`. [`quotaOfPlugin`](../../internal/provider/plugin_usage.go) keeps the figure and does not make the window `Text` or `Aside`, so the account is known to routing with no `Used` invented. `allowanceOf` copies it into `Limit.Balance`, and an empty wallet (0) counts as used up. `Allowance.Left(model)` is the least balance of the windows that count the model, with its unit. `weighRouted` sets `routes.Seat.Left` to it and `Seat.LeftIn` to the account's provider and unit; Smart, `pace` and `usage` put the seat with more left first where they would otherwise tie (`byLeft` in [`strategies.go`](../../internal/routes/strategies.go)), and only when every seat that has a balance shares one `LeftIn`, so balances in two units or two providers are never weighed against each other. The card, the Routing page (`Weighed.Balance`) and the CLI show the figure ("6,291 积分 left", `provider.BalanceText`) and no meter. A wallet window's `runsOutAt`/`runsOut` (its soonest batch to lapse) and the rows set aside after it (`aside` text: SuperMagic's day's, timed and permanent points) are display only: the card says them, and the Routing page reads them from the same card (`cardOf` in the routing plugin's `client.js`, live requests only), its row saying the lapse after the figure ("6,291 积分 left · 185 积分 expire 23:59", `runsOutText`, #3964) and its tooltip and account list each window (`winsOf`). Routing goes by the balance alone. Tests: `TestPluginWalletBalanceIsAReading`, `TestPluginHostPassesABalanceOn`, `TestWalletsGoByWhatTheyHaveLeft`, `TestWalletWithMoreLeftGoesFirst`, `usage-wallet-balance.test.cjs`, `routing-wallet-balance.test.cjs`, `routing-wallet-lapse.test.cjs`.## Cache a vendor doesn't countdiff --git a/internal/gui/assets/plugins/routing/client.js b/internal/gui/assets/plugins/routing/client.jsindex e4d117ae0..2ad3c2505 100644--- a/internal/gui/assets/plugins/routing/client.js+++ b/internal/gui/assets/plugins/routing/client.js@@ -495,7 +495,17 @@ function routingPage(part) {// a prepaid wallet tells what it has left in its unit, no share (#3950):// "6,291 points left", whichever way the meters readconst balText = (w) => (countFormat.format(w.balance) + " " + t(w.unit || "")).trim();- const quota = (w, used, left, vars) => w.balance != null ? t(left, { n: balText(w), ...vars })+ // and what of it is lost first, as the Usage card says it from the+ // wallet's window (runsOutText): "6,291 points left · 185 points expire+ // 23:59", the day's batch otherwise unseen beside the total (#3964).+ // Live only, as winsOf: a kept day's figure was read long ago+ const lapses = (w) => {+ const ws = day ? [] : (cardOf(w)?.windows || []).filter((x) => x.balance != null && (x.unit || "") === (w.unit || ""));+ const x = ws.find((x) => x.balance === w.balance) || (ws.length === 1 ? ws[0] : null);+ const out = x ? runsOutText(x) : "";+ return out ? " · " + out : "";+ };+ const quota = (w, used, left, vars) => w.balance != null ? t(left, { n: balText(w), ...vars }) + lapses(w): (w.limit > 0 ? quotaCount(w) + " · " : "") + t(quotaLeft ? left : used, { n: pct(share(w)), ...vars });const fill = (w) => Math.max(0, Math.min(100, share(w))) + "%";const FAIL = { rate: "rate limited", credit: "out of credit", quota: "quota used up", other: "failed", auth: "sign-in required", canceled: "canceled", foreign: "another account's reasoning", floor: "reply too short", verify: "needs verification", refused: "refused (safety filter)", shape: "request not understood", proxy: "proxy not reachable", effort: "reasoning effort not in its plan", overflow: "too long for its model", room: "reply asked past the window left", slow: "slow to start", prompt: "agent's prompt turned away", restricted: "account restricted by the vendor" };diff --git a/internal/gui/tests/routing-wallet-lapse.test.cjs b/internal/gui/tests/routing-wallet-lapse.test.cjsnew file mode 100644index 000000000..4bcbbb447--- /dev/null+++ b/internal/gui/tests/routing-wallet-lapse.test.cjs@@ -0,0 +1,142 @@+// Run with Node's test runner and Playwright on the module path; see README.md.+// #3964 (MYCF711): a prepaid wallet's points come in batches that are lost+// on their own days. SuperMagic's plugin (magpie-magicrew-auth daca18e)+// sends its balance window with the soonest batch (runsOutAt, runsOut:+// 185 points at 23:59 today) and the day's, timed and permanent points as+// rows set aside. The Usage card said all of it; the Routing page's rows+// said only the total, "6,291 积分 left". Now the row says what goes+// first too, as the Usage card words it: "6,291 积分 left · 185 积分+// expire 23:59", on the stage and in the accounts listed below, and the+// tooltip and the list name the four rows. A wallet whose card tells no+// lapse, and an account with a share, read as before. Every language, at+// a window's width and at 420px, in both engines.+const assert = require("node:assert/strict");+const fs = require("node:fs/promises");+const path = require("node:path");+const { test } = require("node:test");+const { chromium, webkit } = require("playwright");++const assets = path.resolve(__dirname, "../assets");+const now = new Date();+const ago = (s) => new Date(now.getTime() - s * 1000).toISOString();+const later = (h) => new Date(now.getTime() + h * 3600e3).toISOString();+// as the gateway sends them (Weighed)+const seat = (who, balance) => ({ id: `magicrew#${who}`, provider: "magicrew", name: "SuperMagic", who, kind: "account", agent: "magicrew", model: "magic-1", plan: "积分制",+ known: true, used: 0, balance, unit: "积分", renews: ["0001-01-01T00:00:00Z"], pace: 100 / 168 });+const share = { id: "claude#[email protected]", provider: "claude", name: "Claude", who: "[email protected]", kind: "account", agent: "claude", model: "magic-1", plan: "Max",+ known: true, used: 40, renews: [later(30)], pace: 1 };+// as /api/usage/quotas sends the plugin's reading: the balance window with+// its soonest batch, then the rows set aside as text (quotaOfPlugin)+const text = (name, display) => ({ name, used: 0, remaining: 100, display, unit: "积分", text: true });+const quotas = [+ { kind: "subscription", provider: "magicrew", name: "SuperMagic", user: "[email protected]", plan: "积分制", windows: [+ { name: "积分余额", used: 0, remaining: 100, display: "6,291 积分", unit: "积分", balance: 6291, runsOutAt: later(3), runsOut: 185 },+ text("今日积分", "185 / 200 积分 · 今日 23:59 到期"),+ text("限时积分", "1,106 积分 · 最早 2026-11-03 到期"),+ text("永久积分", "5,000 积分"),+ ] },+ { kind: "subscription", provider: "magicrew", name: "SuperMagic", user: "[email protected]", plan: "积分制", windows: [+ { name: "积分余额", used: 0, remaining: 100, display: "750 积分", unit: "积分", balance: 750, runsOutAt: later(30), runsOut: 50 },+ ] },+ { kind: "subscription", provider: "magicrew", name: "SuperMagic", user: "[email protected]", plan: "积分制", windows: [+ { name: "积分余额", used: 0, remaining: 100, display: "300 积分", unit: "积分", balance: 300 },+ ] },+ { kind: "subscription", provider: "claude", name: "Claude", user: "[email protected]", windows: [{ name: "5 hours", used: 40, remaining: 60, resetsAt: later(30) }] },+];++function serve(lang) {+ const order = [seat("[email protected]", 6291), seat("[email protected]", 750), seat("[email protected]", 300), share];+ const route = {+ id: 1, seq: 1, time: ago(1), agent: "codex", model: "magic-1", provider: "magicrew", done: true, status: 200, ms: 900, tokens: 1200, order,+ tries: [{ id: order[0].id, model: "magic-1", start: ago(1), done: true, status: 200, ms: 900 }],+ };+ return async (request) => {+ const url = new URL(request.request().url());+ const json = (data) => request.fulfill({ json: data });+ if (url.pathname === "/boot.js") return request.fulfill({ contentType: "text/javascript", body: `window.bootPrefs = {lang:"${lang}",theme:"light",web:true};` });+ if (url.pathname === "/wails/runtime.js") return request.fulfill({ contentType: "text/javascript", body: "export const Window = {};" });+ if (url.pathname === "/api/state") return json({ agents: [{ id: "codex", name: "Codex", path: "/test/config.toml", fields: [] }], profiles: [], settings: { lang, theme: "light" } });+ if (url.pathname === "/api/gateway/trace") {+ if (url.searchParams.get("wait")) return new Promise(() => {}); // nothing more comes+ return json({ mine: true, now: now.toISOString(), seq: 1, totals: { requests: 1 }, routes: [route] });+ }+ if (url.pathname === "/api/usage/quotas") return json(quotas);+ if (url.pathname === "/api/gateway/history") return json({ cut: false, days: [], routes: [] });+ if (url.pathname === "/api/groups") return json({ groups: [] });+ if (url.pathname === "/api/providers") return json({ providers: [], excluded: [], gateway: { running: true, window: true } });+ if (url.pathname.startsWith("/api/")) return json({});+ const file = path.join(assets, url.pathname === "/" ? "index.html" : url.pathname);+ const contentType = { ".html": "text/html", ".js": "text/javascript", ".css": "text/css", ".svg": "image/svg+xml", ".png": "image/png" }[path.extname(file)];+ await request.fulfill({ body: await fs.readFile(file), contentType });+ };+}++for (const engine of (process.env.BROWSER ? [process.env.BROWSER] : ["chromium", "webkit"])) {+ test(`${engine}: a wallet's row says what of it is lost first, beside its total`, async (t) => {+ const browser = await (engine === "webkit" ? webkit.launch() : chromium.launch({ channel: "chromium" }));+ t.after(() => browser.close());+ for (const lang of ["en", "zh", "zh-TW", "ja", "de"]) {+ for (const width of [1100, 420]) {+ await t.test(`${lang} at ${width}px`, async () => {+ const page = await browser.newPage({ viewport: { width, height: 900 }, reducedMotion: "reduce" });+ try {+ page.setDefaultTimeout(5000);+ const errors = [];+ page.on("pageerror", (error) => errors.push(error.message));+ await page.route("**/*", serve(lang));+ await page.goto("http://magpie.test/?view=routing");+ const req = page.locator(".rt-req").first();+ await req.waitFor();+ if (await req.getAttribute("aria-pressed") !== "true") await req.click();+ const tr = (key, vars) => page.evaluate(([lang, key, vars]) => {+ const s = (lang !== "en" && I18N[lang]?.[key]) || key;+ return s.replace(/\{(\w+)\}/g, (_, k) => vars[k] ?? `{${k}}`);+ }, [lang, key, vars]);+ // the Usage card's own words for a window's soonest lapse+ const lapse = (i) => page.evaluate((w) => runsOutText(w), quotas[i].windows[0]);+ const bigOut = await lapse(0), smallOut = await lapse(1);+ assert.ok(bigOut.includes("185 积分") && smallOut.includes("50 积分"), `${bigOut} / ${smallOut}`);+ const big = await tr("{n} left", { n: "6,291 积分" }) + " · " + bigOut;+ const small = await tr("{n} left", { n: "750 积分" }) + " · " + smallOut;+ const none = await tr("{n} left", { n: "300 积分" });+ // the stage's rows: the one behind the first says its figure and its lapse+ const row = (id) => page.locator(`.rt-accts > li[title^="${id}"]`).first();+ // the Usage page's readings come in beside the trace, and the stage is+ // drawn again with them: read the row until it says what it should,+ // or until it has had time to, and compare what it said last+ await page.locator(".rt-act .wins").first().waitFor();+ const settled = async (id, want) => {+ let got = "";+ for (let i = 0; i < 20 && got !== want; i++) {+ if (i) await page.waitForTimeout(100);+ got = (await row(id).locator("em").textContent()) || "";+ }+ return got;+ };+ assert.equal(await settled("magicrew#[email protected]", small), small);+ assert.equal(await settled("magicrew#[email protected]", none), none, "a wallet with no lapse told reads as before");+ assert.ok(!(await row("claude#[email protected]").locator("em").textContent()).includes("积分"), "an account with a share has no lapse");+ // the tooltip names the four rows the Usage card shows+ const tip = await row("magicrew#[email protected]").getAttribute("title");+ for (const s of ["185 / 200 积分 · 今日 23:59 到期", "1,106 积分 · 最早 2026-11-03 到期", "5,000 积分"]) assert.ok(tip.includes(s), tip);+ // the accounts listed below: the figure and its lapse, then when it was read+ const acts = page.locator(".rt-act");+ await acts.filter({ hasText: "6,291" }).first().waitFor();+ const list = await acts.evaluateAll((as) => as.map((a) => ({ st: a.querySelector(".st")?.textContent || "", wins: a.querySelector(".wins")?.innerText || "" })));+ const b = list.find((a) => a.st.startsWith(big + " · "));+ assert.ok(b, `${big}: ${JSON.stringify(list)}`);+ assert.ok(b.wins.includes("185 / 200 积分 · 今日 23:59 到期") && b.wins.includes("5,000 积分"), b.wins);+ assert.ok(list.some((a) => a.st.startsWith(small + " · ")), JSON.stringify(list));+ // no lapse told: its figure, then when it was read, and nothing between+ assert.ok(list.some((a) => a.st.startsWith(none + " · ") && a.st.split(" · ").length === 2), JSON.stringify(list));+ const over = await page.evaluate(() => document.documentElement.scrollWidth - innerWidth);+ assert.ok(over <= 1, `${over}px past`);+ assert.deepEqual(errors, []);+ } finally {+ await page.close();+ }+ });+ }+ }+ });+}