dsh-workbuddy-xdpool 0.3.0 → 0.4.1

package/lib/client.js

@@ -115,6 +115,14 @@ window.__ModuleLoader__.load({
 .dsm-workbuddy-xdpool-usage-status{display:flex;align-items:center;gap:10px;font-size:15px;font-weight:500;color:var(--dsw-alias-label-primary,#e6e6e6)}
 .dsm-workbuddy-xdpool-usage-dot{width:9px;height:9px;border-radius:50%;flex:0 0 auto}
 .dsm-workbuddy-xdpool-usage-hint{padding-left:19px;color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:12px;line-height:18px}
+/* Distribution switch: priority (drain one) vs round-robin (spread). */
+.dsm-workbuddy-xdpool-dist{display:flex;align-items:center;gap:8px;padding-left:19px;flex-wrap:wrap}
+.dsm-workbuddy-xdpool-dist-title{color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:12px;line-height:18px}
+.dsm-workbuddy-xdpool-dist-option{appearance:none;font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,#3a3d45);border-radius:999px;padding:2px 10px;font-size:11px;line-height:18px;background:transparent;color:var(--dsw-alias-label-tertiary,#9aa0a8);transition:color .16s,border-color .16s,background .16s}
+.dsm-workbuddy-xdpool-dist-option:hover:not(:disabled):not(.dsm-workbuddy-xdpool-dist-option-active){color:var(--dsw-alias-label-primary,#e6e6e6);border-color:var(--dsw-alias-label-dimmed,#777)}
+.dsm-workbuddy-xdpool-dist-option:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5686fe);outline-offset:1px}
+.dsm-workbuddy-xdpool-dist-option-active{background:var(--dsw-alias-state-success-subtle,rgba(34,160,107,.14));border-color:var(--dsw-alias-state-success-primary,#22a06b);color:var(--dsw-alias-state-success-primary,#22a06b)}
+.dsm-workbuddy-xdpool-dist-option:disabled{cursor:default;opacity:.6}
 .dsm-workbuddy-xdpool-usage-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
 
 /* Account list (each account = a labeled subpanel, same as dingminhua). */
@@ -143,9 +151,18 @@ window.__ModuleLoader__.load({
 .dsm-workbuddy-xdpool-panel-foot{display:flex;align-items:baseline;justify-content:space-between;gap:10px;margin-top:9px;padding-top:9px;border-top:1px solid var(--dsw-alias-border-l2,#36373b);color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:12px;line-height:18px}
 .dsm-workbuddy-xdpool-panel-foot strong{color:var(--dsw-alias-label-primary,#e6e6e6);font-size:15px;font-variant-numeric:tabular-nums}
 .dsm-workbuddy-xdpool-packages{display:flex;flex-direction:column;gap:5px;margin:0;padding:0;list-style:none}
-.dsm-workbuddy-xdpool-packages li{display:flex;align-items:baseline;justify-content:space-between;gap:10px;color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:12px;line-height:18px}
-.dsm-workbuddy-xdpool-packages-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.dsm-workbuddy-xdpool-packages-value{flex:none;color:var(--dsw-alias-label-tertiary,#999);font-size:11px;font-variant-numeric:tabular-nums}
+/* One credit package: name + amount on the first line, its deadline beneath.
+   A two-row grid keeps the columns aligned across rows; a wrapping flex row
+   dropped the deadline onto a second line that started at the container edge,
+   so the list read as ragged text rather than a table. */
+.dsm-workbuddy-xdpool-packages li{display:grid;grid-template-columns:minmax(0,1fr) auto;column-gap:10px;row-gap:1px;align-items:baseline;color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:12px;line-height:18px}
+.dsm-workbuddy-xdpool-packages-name{grid-column:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dsm-workbuddy-xdpool-packages-value{grid-column:2;justify-self:end;color:var(--dsw-alias-label-tertiary,#999);font-size:11px;font-variant-numeric:tabular-nums}
+/* Per-package deadline: the upstream grants one-off packs at arbitrary clock
+   times, so each row carries its own timestamp; the soon ones are tinted and
+   fold onto their own line so a long package name cannot squeeze them out. */
+.dsm-workbuddy-xdpool-packages-when{grid-column:1/-1;color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:11px;line-height:15px;font-variant-numeric:tabular-nums}
+.dsm-workbuddy-xdpool-packages-when-soon{color:var(--dsw-alias-state-warning-primary,#d97706)}
 .dsm-workbuddy-xdpool-panel-total{position:relative;align-items:center;text-align:center;overflow:hidden}
 .dsm-workbuddy-xdpool-panel-total::before{content:"";position:absolute;top:0;left:0;right:0;height:3px;opacity:.9;background:var(--dsw-alias-state-success-primary,#22a06b)}
 .dsm-workbuddy-xdpool-total-value{color:var(--dsw-alias-state-success-primary,#22a06b);font-size:30px;line-height:34px;font-weight:700;letter-spacing:-.5px;white-space:nowrap;font-variant-numeric:tabular-nums}
@@ -307,6 +324,30 @@ window.__ModuleLoader__.load({
 			}
 			return false;
 		}
+		/** Absolute expiry with the time of day: the upstream grants one-off packages at
+		*  arbitrary clock times, so "expires 09/19 15:36" is what the user needs — a
+		*  date alone would read as if it lapsed at midnight. */
+		function formatExpiry(ms) {
+			if (ms === void 0 || !Number.isFinite(ms)) return "";
+			return new Intl.DateTimeFormat(void 0, {
+				month: "2-digit",
+				day: "2-digit",
+				hour: "2-digit",
+				minute: "2-digit",
+				hour12: false
+			}).format(new Date(ms));
+		}
+		/** Whole days until `ms`, floored at 0; undefined when there is no deadline. */
+		function daysUntil(ms) {
+			if (ms === void 0 || !Number.isFinite(ms)) return void 0;
+			return Math.max(0, Math.floor((ms - Date.now()) / 864e5));
+		}
+		/** True when a one-off package lapses inside the "expiring soon" window. */
+		function isExpiringSoon(pack) {
+			if (pack.monthly === true) return false;
+			const days = daysUntil(pack.expiresAtMs);
+			return days !== void 0 && days <= 3;
+		}
 		function tagFor(model) {
 			const tags = model.tags ?? [];
 			if (tags.includes("free")) return "free";
@@ -522,6 +563,25 @@ window.__ModuleLoader__.load({
 			* The card refuses an empty enable-list: saving one would leave the picker
 			* with nothing to offer and no obvious way back.
 			*/
+			/**
+			* Switch how the pool spreads requests. Written straight through the
+			* settings scope (that is where the host keeps the pool options), so the
+			* change lands without a restart and survives the next card refresh.
+			*/
+			const setDistribution = async (next) => {
+				const write = settingsScope?.set;
+				if (write === void 0) {
+					setError(t?.("row.modelsSaveError", { message: "settings scope is read-only" }) ?? "settings scope is read-only");
+					return;
+				}
+				setFlash(void 0);
+				try {
+					await write.call(settingsScope, "distribution", next);
+					await refresh(activeRegion);
+				} catch (cause) {
+					if (mounted.current) setError(String(cause));
+				}
+			};
 			const saveModels = async () => {
 				if (draft === void 0 || status === void 0) return;
 				if (enabledCount === 0) {
@@ -639,6 +699,31 @@ window.__ModuleLoader__.load({
 										shimHint === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 											className: "dsm-workbuddy-xdpool-usage-hint",
 											children: shimHint
+										}),
+										status === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: "dsm-workbuddy-xdpool-dist",
+											role: "radiogroup",
+											"aria-label": t?.("row.distTitle") ?? "Account usage",
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dsm-workbuddy-xdpool-dist-title",
+												children: t?.("row.distTitle") ?? "Account usage"
+											}), ["priority", "round-robin"].map((option) => {
+												const active = (status.distribution ?? "priority") === option;
+												const label = option === "priority" ? t?.("row.distPriority") ?? "Priority" : t?.("row.distRoundRobin") ?? "Round-robin";
+												const hint = option === "priority" ? t?.("row.distPriorityHint") ?? "" : t?.("row.distRoundRobinHint") ?? "";
+												return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													role: "radio",
+													"aria-checked": active,
+													title: hint,
+													disabled: !modelsEditable,
+													className: `dsm-workbuddy-xdpool-dist-option${active ? " dsm-workbuddy-xdpool-dist-option-active" : ""}`,
+													onClick: () => {
+														setDistribution(option);
+													},
+													children: label
+												}, option);
+											})]
 										})
 									]
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -878,16 +963,30 @@ window.__ModuleLoader__.load({
 							children: "–"
 						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
 							className: "dsm-workbuddy-xdpool-packages",
-							children: packages.map((pack, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dsm-workbuddy-xdpool-packages-name",
-								children: pack.packageName
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dsm-workbuddy-xdpool-packages-value",
-								children: t?.("row.creditsPackage", {
-									remain: formatNumber(pack.remain),
-									size: formatNumber(pack.size)
-								}) ?? `${formatNumber(pack.remain)} / ${formatNumber(pack.size)}`
-							})] }, `${pack.packageName}-${String(index)}`))
+							children: packages.map((pack, index) => {
+								const expiry = formatExpiry(pack.expiresAtMs);
+								const refresh = formatExpiry(pack.cycleRefreshMs);
+								const soon = isExpiringSoon(pack);
+								const when = pack.monthly === true ? refresh === "" ? null : t?.("row.creditsRefreshAt", { time: refresh }) ?? `Refreshes ${refresh}` : expiry === "" ? null : t?.("row.creditsExpiresAt", { time: expiry }) ?? `Expires ${expiry}`;
+								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dsm-workbuddy-xdpool-packages-name",
+										children: pack.packageName
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dsm-workbuddy-xdpool-packages-value",
+										children: t?.("row.creditsPackage", {
+											remain: formatNumber(pack.remain),
+											size: formatNumber(pack.size)
+										}) ?? `${formatNumber(pack.remain)} / ${formatNumber(pack.size)}`
+									}),
+									when === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: `dsm-workbuddy-xdpool-packages-when${soon ? " dsm-workbuddy-xdpool-packages-when-soon" : ""}`,
+										title: t?.("row.creditsExpiresSoonTitle") ?? "Expiring within 3 days",
+										children: when
+									})
+								] }, `${pack.packageName}-${String(index)}`);
+							})
 						}),
 						credits?.expiringSoon !== void 0 && credits.expiringSoon > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dsm-workbuddy-xdpool-panel-foot",
@@ -1082,6 +1181,9 @@ window.__ModuleLoader__.load({
 			"row.creditsPackage": "{remain} / {size}",
 			"row.creditsError": "credits unavailable",
 			"row.creditsSoon": "Expiring in 3 days",
+			"row.creditsExpiresAt": "Expires {time}",
+			"row.creditsExpiresSoonTitle": "Expiring within 3 days",
+			"row.creditsRefreshAt": "Refreshes {time}",
 			"row.checkinTitle": "Daily check-in",
 			"row.checkinClaim": "Check in",
 			"row.checkinClaiming": "Checking in…",
@@ -1116,6 +1218,11 @@ window.__ModuleLoader__.load({
 			"row.imageCapable": "image input",
 			"row.rate": "{rate}x credits",
 			"row.accountsRescan": "Detect accounts again",
+			"row.distTitle": "Account usage",
+			"row.distPriority": "Priority",
+			"row.distPriorityHint": "Drain one account before moving to the next",
+			"row.distRoundRobin": "Round-robin",
+			"row.distRoundRobinHint": "Spread the spend evenly across accounts",
 			"row.accountsScanning": "Detecting…",
 			"row.resetCooldowns": "Clear all cooldowns",
 			"row.resetCooldownsBusy": "Clearing…",
@@ -1160,6 +1267,9 @@ window.__ModuleLoader__.load({
 			"row.creditsPackage": "{remain} / {size}",
 			"row.creditsError": "积分不可用",
 			"row.creditsSoon": "3 天内到期",
+			"row.creditsExpiresAt": "到期 {time}",
+			"row.creditsExpiresSoonTitle": "3 天内到期",
+			"row.creditsRefreshAt": "刷新 {time}",
 			"row.checkinTitle": "每日签到",
 			"row.checkinClaim": "签到",
 			"row.checkinClaiming": "签到中…",
@@ -1194,6 +1304,11 @@ window.__ModuleLoader__.load({
 			"row.imageCapable": "图片输入",
 			"row.rate": "{rate}x 积分",
 			"row.accountsRescan": "重新检测账号",
+			"row.distTitle": "账号使用方式",
+			"row.distPriority": "优先模式",
+			"row.distPriorityHint": "优先用完一个账号再换下一个",
+			"row.distRoundRobin": "轮换模式",
+			"row.distRoundRobinHint": "积分平均分摊到各账号",
 			"row.accountsScanning": "正在检测…",
 			"row.resetCooldowns": "清除所有冷却",
 			"row.resetCooldownsBusy": "正在清除…",

package/lib/index.d.ts

@@ -20,7 +20,12 @@ interface WorkBuddyUpstreamModel {
   contextWindow: number;
   maxTokens: number;
   creditMultiplier?: number;
-  multimodal?: boolean;
+  /** Upstream image-input flag. Both gateways spell it `supportsImages`; some entries
+   * also carry `disabledMultimodal`, the negative spelling. Reading anything else
+   * reported every model as text-only, which made a vision shim register a second
+   * route under the same display name and split the model picker group.
+   */
+  supportsImages?: boolean;
   reasoning?: {
     supportedEfforts?: readonly string[];
     defaultEffort?: string;
@@ -112,7 +117,21 @@ export declare class WorkBuddyUpstreamClient {
   chatStream(credential: WorkBuddyCredential, prepared: string, signal?: AbortSignal): Promise<ChatStreamResult>;
   /** POST the token-refresh endpoint; the caller merges the outcome. */
   refreshToken(credential: WorkBuddyCredential): Promise<WorkBuddyRefreshOutcome>;
-  /** GET the personal model catalog, keeping the `cli` agent's models only. */
+  /**
+   * Fetch the model catalog, keeping the `cli` agent's models only.
+   *
+   * The two gateways are read differently, because they answer differently:
+   *
+   * - **CN** serves the roster at `/v2/enterprises/personal/models` and expects
+   *   the CLI client spelling.
+   * - **Global** serves it as part of the product config at `/v3/config`, and
+   *   only to the DESKTOP client channel. Asking the global host with the CLI UA
+   *   yields a truncated roster, and the CN path answers HTTP 500 there — which
+   *   is what left the international provider on its static fallback.
+   *
+   * Both documents share the `{ models, agents }` entry shape, so the parsing
+   * below is common to the two branches.
+   */
   fetchModels(credential: WorkBuddyCredential, signal?: AbortSignal): Promise<readonly WorkBuddyUpstreamModel[]>;
   /** Read-only credits query, aggregated by package. Does not consume credits. */
   fetchCredits(credential: WorkBuddyCredential): Promise<WorkBuddyCredits>;
@@ -142,6 +161,7 @@ interface TokenRefresher {
 }
 /** Live auth file name the WorkBuddy desktop app writes. */
 export declare const WORKBUDDY_LIVE_FILENAME = "workbuddy-desktop.info";
+/** Snapshot files left behind by previous logins share this prefix. */
 /** Env override for the auth file or its directory. */
 export declare const WORKBUDDY_AUTH_FILE_ENV = "WORKBUDDY_AUTH_FILE";
 /** One parsed WorkBuddy credential. */
@@ -150,6 +170,16 @@ interface WorkBuddyCredential {
   refreshToken: string;
   expiresAtMs: number;
   refreshExpiresAtMs?: number;
+  /**
+   * When the upstream says it issued this token (`auth.lastRefreshTime`).
+   *
+   * This, not `expiresAtMs`, is the reliable freshness signal: the upstream
+   * never rewrites a stored expiry when it revokes a token, so a long-dead
+   * backup can claim to expire later than the token that actually works.
+   * Absent on documents the desktop app did not write (the plugin's own
+   * refreshed copy, older builds).
+   */
+  lastRefreshAtMs?: number;
   nickname?: string;
   uin?: string;
   uid?: string;
@@ -194,13 +224,11 @@ export declare function defaultDesktopAuthDirs(platform?: NodeJS.Platform, home?
  * when there is no usable access token.
  */
 export declare function parseWorkBuddyAuth(text: string, sourcePath: string): WorkBuddyCredential | undefined;
-/**
- * Stable account id. `uin` is the billing identity the upstream keys on and
- * survives re-login; `uid` is the fallback.
- */
 export declare function workbuddyAccountId(credential: Pick<WorkBuddyCredential, 'uin' | 'uid' | 'nickname'>): string;
 /** Every directory the pool should scan, in probe order. */
 export declare function candidateAuthDirs(env?: NodeJS.ProcessEnv): string[];
+/** How the pool chooses which account serves the next request. */
+type AccountDistribution = 'priority' | 'round-robin';
 interface AccountPoolOptions {
   /** Logger for discovery and rotation events. */
   logger?: {
@@ -216,6 +244,17 @@ interface AccountPoolOptions {
   client?: TokenRefresher;
   /** Refresh this long before actual expiry; default five minutes. */
   refreshMarginMs?: number;
+  /**
+   * How requests are spread across the pool.
+   *
+   * - `priority` (default): one account serves every request until it is
+   *   rate-limited, then the next in order takes over. Credits drain one
+   *   account at a time, and a cooled account resumes at the head of the
+   *   queue the moment its window resets.
+   * - `round-robin`: consecutive requests rotate through the pool so the
+   *   spend spreads evenly.
+   */
+  distribution?: AccountDistribution;
 }
 /**
  * Read-only pool of every discovered WorkBuddy account, with rate-limit
@@ -228,6 +267,8 @@ export declare class WorkBuddyAccountPool {
   private readonly client;
   private readonly refreshMarginMs;
   private accounts;
+  private distribution;
+  /** Cursor for round-robin mode; unused under priority distribution. */
   private cursor;
   private lastScanAtMs;
   private preferredId;
@@ -241,6 +282,7 @@ export declare class WorkBuddyAccountPool {
   applyConfig(options: {
     authDirs?: readonly string[];
     cooldownMs?: number;
+    distribution?: AccountDistribution;
   }): void;
   /** Rescan the auth directories and merge newly discovered accounts. */
   scan(): Promise<WorkBuddyAccount[]>;
@@ -257,15 +299,29 @@ export declare class WorkBuddyAccountPool {
    */
   private available;
   /**
-   * Pick the next usable account for an optional model. Scans on first use,
-   * and rescans when every known account is cooling down — a fresh desktop
-   * login is the usual way out of an exhausted pool. A preferred
-   * (user-selected) account that is healthy is tried first; otherwise the
-   * cursor round-robins so consecutive requests spread across accounts and a
-   * still-cooling preferred account is skipped.
+   * Pick the account to serve a request.
+   *
+   * Two distributions, chosen by the `distribution` setting:
+   *
+   * - **priority** (default, and what the card ships with): one account serves
+   *   every request until it is rate-limited, then the next in order takes over.
+   *   Credits drain one account at a time, and a cooling account returns to the
+   *   head of the queue the moment its window resets — it was never consumed, so
+   *   it resumes straight away.
+   * - **round-robin**: consecutive requests rotate through the pool so spend
+   *   spreads evenly across every account.
+   *
+   * In both modes an explicit user selection (`prefer`) heads the list, a
+   * cooling account is skipped for that model only, and an unrecognised setting
+   * falls back to priority.
+   *
+   * Scans on first use, and rescans when every known account is cooling down: a
+   * fresh desktop login is the usual way out of an exhausted pool.
    */
   acquire(modelId?: string, region?: WorkBuddyRegion): Promise<WorkBuddyAccount | undefined>;
   /** Pin the account the plugin card should prefer; tokens stay out of settings. */
+  /** How the pool currently spreads requests. Shown on the card. */
+  currentDistribution(): AccountDistribution;
   prefer(accountId: string | undefined): void;
   /** Best-effort refresh of one account after a session-dead upstream answer. */
   refreshAccount(accountId: string): Promise<void>;
@@ -351,7 +407,7 @@ interface ModelSelection {
   /** Absent = each model follows its upstream image capability. */
   imageModelIds?: readonly string[];
   /** Per-model context-window cap, keyed by model id. */
-  contextBudgets?: Readonly<Record<string, number>>;
+  contextBudgets?: Readonly<Record<string, number | undefined>>;
 }
 //#endregion
 //#region src/shim.d.ts
@@ -452,6 +508,7 @@ interface WorkBuddyStatus {
 }
 interface StatusOptions {
   pool: WorkBuddyAccountPool;
+  /** The catalog to report. Regional callers pass their own region's. */
   catalog: WorkBuddyCatalog;
   client: WorkBuddyUpstreamClient;
   shim?: {
@@ -605,7 +662,7 @@ interface PoolWebModelSelection {
   /** Absent = each model follows its upstream image capability. */
   imageModelIds?: readonly string[];
   /** Per-model context-window cap, keyed by model id. */
-  contextBudgets?: Readonly<Record<string, number>>;
+  contextBudgets?: Readonly<Record<string, number | undefined>>;
 }
 /** The JSON document the pool card renders. */
 interface PoolWebStatus {
@@ -617,6 +674,11 @@ interface PoolWebStatus {
   models: readonly PoolWebModel[];
   /** The saved selection the card diffs its draft against. */
   selection: PoolWebModelSelection;
+  /**
+   * How the pool spreads requests: `priority` drains one account before
+   * moving on, `round-robin` splits the spend evenly.
+   */
+  distribution: PoolDistribution;
   /** Which region this document describes. */
   region: PoolRegion;
   /** Every region holding at least one account, in display order. */
@@ -632,6 +694,8 @@ interface PoolWebStatus {
  * international one (`workbuddy.ai`).
  */
 type PoolRegion = 'cn' | 'global';
+/** How the pool spreads requests across its accounts. */
+type PoolDistribution = 'priority' | 'round-robin';
 //#endregion
 //#region src/index.d.ts
 /** Stable Cordis plugin name. */
@@ -651,6 +715,14 @@ export interface Config {
   authFile?: string;
   /** Rate-limit cooldown per account, milliseconds. */
   cooldownMs?: number;
+  /**
+   * How the pool spreads requests across accounts.
+   *
+   * `priority` (default) drains one account before moving to the next, which
+   * is what a pool of your own accounts is for. `round-robin` splits the
+   * spend evenly instead. Absent reads as `priority`.
+   */
+  distribution?: 'priority' | 'round-robin';
   /**
    * Model ids enabled in the picker. Absent means "every model the catalog
    * advertises" — an unconfigured install should never present an empty model
@@ -668,7 +740,7 @@ export interface Config {
    * advertise more than DSH wants to hand a single turn, so the card lets the
    * user cap a model without touching the catalog.
    */
-  contextBudgets?: Partial<Record<string, number>>;
+  contextBudgets?: Record<string, number>;
 }
 /** Upper bound the card offers as the "default" context window, in tokens. */
 export declare const DEFAULT_CONTEXT_BUDGET = 200000;
@@ -686,7 +758,8 @@ export declare const Config: z<Config>;
 /** Everything the CLI needs from a live plugin instance. */
 export interface WorkBuddyPoolApi {
   pool: WorkBuddyAccountPool;
-  catalog: WorkBuddyCatalog;
+  /** One catalog per region, matching the two registered providers. */
+  catalogs: Readonly<Record<WorkBuddyRegion, WorkBuddyCatalog>>;
   client: WorkBuddyUpstreamClient;
   shim: WorkBuddyShim;
   adapter: WorkBuddyAdapter | undefined;
@@ -699,11 +772,22 @@ export declare function currentApi(): WorkBuddyPoolApi | undefined;
 /** Test seam: install an API instance without booting cordis. */
 export declare function setApi(next: WorkBuddyPoolApi | undefined): void;
 /** Assemble the runtime objects without registering anything. */
+/**
+ * Assemble the runtime objects without registering anything.
+ *
+ * One catalog per region, mirroring the two shims: the CN and global gateways
+ * do not advertise the same roster, and a shared catalog meant the picker showed
+ * whichever list happened to be fetched first (always the CN one, since the
+ * seeding step read `accounts[0]`).
+ */
 export declare function createCore(logger?: {
   warn(...args: unknown[]): void;
 }): {
   pool: WorkBuddyAccountPool;
-  catalog: WorkBuddyCatalog;
+  catalogs: {
+    readonly cn: WorkBuddyCatalog;
+    readonly global: WorkBuddyCatalog;
+  };
   client: WorkBuddyUpstreamClient;
 };
 /**