dsh-connect-trae 1.4.2 → 2.0.1

package/lib/index.d.ts

@@ -33,6 +33,62 @@ interface TraeDiscoveredModel {
 /** Parse only capabilities explicitly advertised by Trae's remote model API. */
 declare function parseTraeRemoteModel(value: unknown): TraeDiscoveredModel | undefined;
 //#endregion
+//#region src/paths.d.ts
+type TraeEdition = 'cn' | 'sg' | 'solo' | 'solo-sg';
+/**
+ * Where a local sign-in was persisted. `desktop` candidates hold an Electron
+ * `globalStorage/storage.json` whose auth value is encrypted; `cli` candidates
+ * hold a bare JWT written by the Trae CLI, which needs no decryption.
+ */
+type TraeCredentialSource = 'desktop' | 'cli';
+interface TraeStorageCandidate {
+  edition: TraeEdition;
+  path: string;
+  source: TraeCredentialSource;
+}
+declare function traeStorageCandidates(platform?: NodeJS.Platform, home?: string, env?: NodeJS.ProcessEnv): TraeStorageCandidate[];
+//#endregion
+//#region src/region.d.ts
+/** Storage/routing bucket: the CN service or the international (ai) service. */
+type TraeRegion = 'cn' | 'ai';
+/** One region's upstream gateway bases. */
+interface TraeRegionGateways {
+  /** Chat + agent API base (the `llm_utils_chat` / raw-chat family). */
+  readonly chat: string;
+  /** SOLO remote model directory base (`/api/remote/v1`). */
+  readonly remote: string;
+  /** Pay/status API base; the credential's own host is preferred when known. */
+  readonly pay: string;
+}
+/**
+ * Verified gateway bases per region (docs/INTL_SG_EVIDENCE.md §2).
+ * The AI gateway is shared by both international installs (Trae desktop and
+ * TRAE SOLO); its mchost shards (`api16/api22-normal-alisg.mchost.guru`)
+ * answer the same bytes but stay internal — `coresg-normal.trae.ai` is the
+ * single stable entry point.
+ */
+declare const REGION_GATEWAYS: Readonly<Record<TraeRegion, TraeRegionGateways>>;
+/** Region for an edition label: the international installs belong to `ai`. */
+declare function regionOfEdition(edition: TraeEdition): TraeRegion;
+/**
+ * Region from the credential's `userRegion` claim. The desktop storage spells
+ * it as an object (`{"region":"CN","_aiRegion":"CN"}`); the app logs also
+ * spell the bare value lowercase (`"sg"`). Both are accepted, case-blind.
+ */
+declare function regionOfUserRegion(value: unknown): TraeRegion | undefined;
+/** Region from a credential host (`.trae.ai` → ai, `.trae.cn`/`.trae.com.cn` → cn). */
+declare function regionOfHost(host: string | undefined): TraeRegion | undefined;
+/**
+ * Region of a credential: the `userRegion` claim wins, the host suffix is the
+ * fallback, and the edition label is the last resort. Every level is derived
+ * from data the credential itself carries, so no user configuration is needed.
+ */
+declare function regionOfCredential(credential: {
+  edition: TraeEdition;
+  host?: string;
+  userRegion?: string;
+}): TraeRegion;
+//#endregion
 //#region src/catalog.d.ts
 type TraeInputModality = 'text' | 'image';
 /**
@@ -56,6 +112,21 @@ interface TraeModelInfo {
 }
 /** Bootstrap catalog: identity only where current Trae metadata has not been fetched yet. */
 declare const FALLBACK_TRAE_MODELS: readonly TraeModelInfo[];
+/**
+ * Bootstrap catalog for the international (ai) region, captured from the
+ * live `coresg-normal.trae.ai/api/remote/v1/models` directory on 2026-09-15
+ * (docs/INTL_SG_EVIDENCE.md §3). The two rosters barely overlap (the CN list
+ * has no Gemini/GPT/MiniMax entries), so an international account must never
+ * be seeded with the CN list. Like the CN fallback it is replaced by the live
+ * refresh; image input stays the user's explicit opt-in (`imageModelIds`).
+ */
+declare const FALLBACK_TRAE_MODELS_AI: readonly TraeModelInfo[];
+/**
+ * Static fallback directory for a region. Each region keeps its own model
+ * slot in settings; the fallback must match the region so an account never
+ * shows the other region's roster.
+ */
+declare function fallbackModelsFor(region: TraeRegion): readonly TraeModelInfo[];
 /** Exact DSH modalities for one catalog entry; absent metadata is text-only. */
 declare function traeInputModalities(model: Pick<TraeModelInfo, 'input'>): TraeInputModality[];
 /**
@@ -127,6 +198,12 @@ declare function sanitizeCatalog(catalog: readonly TraeModelInfo[]): TraeModelIn
 declare function deriveCatalog(catalog: readonly TraeModelInfo[], enabled: ReadonlySet<string>, budgets?: Readonly<Record<string, TraeContextBudget | undefined>>): TraeModelInfo[];
 declare class TraeCatalog {
   private models;
+  /**
+   * @param region Seeds the static fallback for this region; each region's
+   * provider must never serve the other region's roster before its first live
+   * refresh lands.
+   */
+  constructor(region?: TraeRegion);
   current(): readonly TraeModelInfo[];
   set(models: readonly TraeModelInfo[]): void;
 }
@@ -172,11 +249,28 @@ interface TraeShimOptions {
 declare function createTraeShim(options: TraeShimOptions): TraeShim;
 //#endregion
 //#region src/adapter.d.ts
+/** Provider route this bundle owns for the domestic (CN) gateway. */
 declare const TRAE_PROVIDER = "trae";
+/**
+ * Provider route this bundle owns for the international (trae.ai) gateway.
+ * Named `-global` to match the plugin family's convention (`workbuddy-global`);
+ * the internal region bucket stays `ai`, which is the gateway/protocol name.
+ */
+declare const TRAE_AI_PROVIDER = "trae-global";
+/** The provider id each region registers as. */
+declare const TRAE_PROVIDERS: Readonly<Record<TraeRegion, string>>;
+/** Human-readable provider names, shown in the DSH model picker. */
+declare const TRAE_PROVIDER_DISPLAY_NAMES: Readonly<Record<TraeRegion, string>>;
+/** Region a provider route id belongs to. */
+declare function regionOfTraeProvider(provider: string): TraeRegion | undefined;
 declare const TRAE_STREAM_IDLE_TIMEOUT_MS = 300000;
 interface TraeAdapterOptions {
   shim: TraeShim;
   catalog: TraeCatalog;
+  /** Provider route id this instance serves; defaults to the CN route. */
+  provider?: string;
+  /** pi-ai provider name and profile display name; defaults to the CN name. */
+  displayName?: string;
   resolveAttachments?: () => AttachmentStore | undefined;
 }
 interface TraeAdapter {
@@ -185,21 +279,6 @@ interface TraeAdapter {
 }
 declare function createTraeAdapter(options: TraeAdapterOptions): TraeAdapter;
 //#endregion
-//#region src/paths.d.ts
-type TraeEdition = 'cn' | 'sg' | 'solo' | 'solo-sg';
-/**
- * Where a local sign-in was persisted. `desktop` candidates hold an Electron
- * `globalStorage/storage.json` whose auth value is encrypted; `cli` candidates
- * hold a bare JWT written by the Trae CLI, which needs no decryption.
- */
-type TraeCredentialSource = 'desktop' | 'cli';
-interface TraeStorageCandidate {
-  edition: TraeEdition;
-  path: string;
-  source: TraeCredentialSource;
-}
-declare function traeStorageCandidates(platform?: NodeJS.Platform, home?: string, env?: NodeJS.ProcessEnv): TraeStorageCandidate[];
-//#endregion
 //#region src/auth.d.ts
 interface TraeCredential {
   accessToken: string;
@@ -207,6 +286,12 @@ interface TraeCredential {
   userId: string;
   accountName?: string;
   host: string;
+  /**
+   * Region claim from the decrypted storage document (`userRegion.region`,
+   * 'CN' | 'SG', possibly lowercase). Drives the routing bucket together with
+   * `host`; see `regionOfCredential`.
+   */
+  userRegion?: string;
   expiresAtMs: number;
   refreshExpiresAtMs?: number;
   edition: TraeEdition;
@@ -224,6 +309,14 @@ interface TraeCredentialStoreOptions {
   edition?: TraeEdition | 'auto';
   accountId?: string;
   ownPath?: string;
+  /**
+   * Region this store serves. When set, only credentials whose own claim maps
+   * to this region are discovered, selected, or refreshed — the two regions'
+   * stores run side by side without seeing each other's accounts.
+   */
+  region?: TraeRegion;
+  /** Legacy single-copy path read as a migration source; injectable for tests. */
+  legacyOwnPath?: string;
   refresh: (credential: TraeCredential) => Promise<TraeRefreshOutcome>;
   refreshMarginMs?: number;
 }
@@ -231,6 +324,8 @@ interface TraeAccountChoice {
   id: string;
   accountName: string;
   edition: TraeEdition;
+  /** Routing bucket of this account (`cn` | `ai`), derived from its credential. */
+  region: TraeRegion;
   source: 'desktop' | 'dsh' | 'cli';
   tokenExpiresAtMs: number;
   selected: boolean;
@@ -246,17 +341,50 @@ interface TraeCandidateFailure {
   reason: 'missing' | 'unreadable' | 'invalid';
   message?: string;
 }
-declare function traeOwnAuthPath(): string;
+/**
+ * Plugin-owned copy path for one region. Each region's store refreshes into
+ * its own file so two simultaneously signed-in regions never overwrite each
+ * other's refreshed token.
+ */
+declare function traeOwnAuthPath(region: TraeRegion): string;
+/**
+ * Pre-dual-provider single-copy path. Still read as a migration source (a
+ * legacy credential serves the region it belongs to until that region's own
+ * first refresh writes the per-region file), and removed by `logout`.
+ */
+declare function legacyTraeOwnAuthPath(): string;
 declare function normalizeTraeCredential(raw: unknown, edition: TraeEdition, source: TraeCredential['source']): TraeCredential | undefined;
 declare class TraeCredentialStore {
   private storagePathOverride;
   private edition;
   private accountId;
-  private readonly ownPath;
+  private readonly region;
+  private readonly ownPathExplicit;
+  private readonly legacyOwnPath;
+  private readonly legacyOwnPathExplicit;
   private readonly refresh;
   private readonly refreshMarginMs;
   private inflight;
   constructor(options: TraeCredentialStoreOptions);
+  /** Whether a credential's own claim belongs to this store's region. */
+  private matchesRegion;
+  /**
+   * The path this store refreshes into: the per-region file for a
+   * region-scoped store, the legacy single file otherwise, or an explicitly
+   * injected path in tests.
+   */
+  ownAuthPath(): string;
+  /**
+   * Every plugin-owned copy to read, most preferred first. A region-scoped
+   * store reads the legacy single copy as its migration source (readAll's
+   * region filter drops it when it carries the other region's credential); an
+   * unscoped store reads everything so diagnostics see both regions.
+   *
+   * With an explicitly injected own path the legacy source is read ONLY when
+   * it was injected too — a test that pins one file must not accidentally see
+   * the real machine's legacy copy.
+   */
+  private ownCandidates;
   setSource(storagePath: string | undefined, edition?: TraeEdition | 'auto', accountId?: string): void;
   selectAccount(accountId: string | undefined): void;
   candidates(): TraeStorageCandidate[];
@@ -277,7 +405,20 @@ declare class TraeCredentialStore {
     source?: TraeCredential['source'];
   }>;
   desktopFilePresent(): Promise<boolean>;
+  /**
+   * Remove every plugin-owned copy this store could read (per-region file,
+   * legacy single file, and their lock siblings); the desktop storage files
+   * are untouched. A region store's logout therefore also clears the legacy
+   * migration source — deliberate: `logout` is the user's "forget what the
+   * plugin stored" action, not a per-account toggle.
+   */
   logout(): Promise<void>;
+  /**
+   * Every local credential of this store's region, deduplicated by account id.
+   * A region-scoped store sees only its own region's credentials: the other
+   * region's accounts are invisible to selection, refresh, and status alike,
+   * which is what keeps the two regions' providers from cross-billing.
+   */
   private readAll;
   /**
    * Which paths were tried and why each one failed. Read-only and token-free:
@@ -292,7 +433,11 @@ declare class TraeCredentialStore {
   /** Parse one candidate file's text into a credential, or throw. */
   private credentialFrom;
   private readDesktopAll;
-  private readOwn;
+  /**
+   * Every readable plugin-owned copy, in candidate order; absent or corrupt
+   * files are skipped rather than propagated.
+   */
+  private readOwns;
   private refreshNow;
 }
 //#endregion
@@ -332,6 +477,37 @@ declare function readTraeIdentity(candidate: TraeStorageCandidate, options?: Tra
  * a candidate that exists but fails to parse still surfaces its own error.
  */
 declare function pickTraeStorageIdentity(candidates: readonly TraeStorageCandidate[], options?: TraeIdentityReadOptions): Promise<TraeIdentity>;
+/**
+ * Deterministic identity for a machine that only has the Trae CLI (`traecli`).
+ *
+ * A CLI-only machine has no desktop `storage.json`, so the desktop identity
+ * reader has nothing to read — yet the request headers still need stable
+ * machine/device ids. Everything here comes from identifiers the CLI itself
+ * persists (never a per-request random value):
+ *
+ *   - `argv.json`'s `crash-reporter-id` — a stable per-install UUID the CLI
+ *     writes on first run; used directly as the device id.
+ *   - `builtin/ide_version.json`'s `version` — the CLI build, sent as
+ *     `x-app-version` (the desktop reader gets this from `product.json`).
+ *   - a SHA-256 over the device id, host name and user name for `machineId`,
+ *     matching the 64-char hex shape the official clients send.
+ *
+ * When `crash-reporter-id` is absent the device id falls back to the same
+ * hash (still deterministic). A machine with no CLI home at all keeps failing
+ * loudly — a fabricated identity is worse than a visible "not signed in".
+ */
+declare function readTraeCliIdentity(edition: TraeEdition, options?: TraeIdentityReadOptions): Promise<TraeIdentity>;
+/**
+ * Resolve the request identity for one region: the desktop storage identity
+ * when any desktop install exists, otherwise the CLI home's deterministic
+ * identity (see {@link readTraeCliIdentity}).
+ *
+ * This is the seam the WSL2 / CLI-only case needs: `traecli` writes its token
+ * to `~/.trae-cn/trae-jwt-token` and no `storage.json` exists anywhere, so
+ * desktop-only resolution used to fail every directory refresh and chat
+ * request even though the account itself was found.
+ */
+declare function resolveTraeIdentity(candidates: readonly TraeStorageCandidate[], edition: TraeEdition, options?: TraeIdentityReadOptions): Promise<TraeIdentity>;
 /** Headers derived from actual persisted identity, never a new random identity per request. */
 declare function identityHeaders(identity: TraeIdentity): Record<string, string>;
 //#endregion
@@ -456,11 +632,19 @@ type TraeHeaderProfile = 'agent-task' | 'model-detail' | 'raw-chat' | 'native-cu
 declare const TRAE_VERSION_CODE_FALLBACK = "20260716";
 /** Keep a purely numeric build version; fall back when it cannot bind. */
 declare function normalizeTraeVersionCode(buildVersion: string | undefined): string;
-declare function buildTraeCnHeaders(credential: TraeCredential, identity: TraeIdentity, options?: {
+/**
+ * Headers shared by every Trae edition. The same shape is accepted by both
+ * gateways (verified read-only on the international gateway 2026-09-15,
+ * docs/INTL_SG_EVIDENCE.md §2.3: identical `x-app-id`, identity headers, and
+ * `Cloud-IDE-JWT` auth), so there is no per-edition branch any more.
+ */
+declare function buildTraeHeaders(credential: TraeCredential, identity: TraeIdentity, options?: {
   appId?: string;
   requestId?: string;
   profile?: TraeHeaderProfile;
 }): Record<string, string>;
+/** Backwards-compatible alias; the headers are no longer CN-specific. */
+declare const buildTraeCnHeaders: typeof buildTraeHeaders;
 declare function traeEndpoint(baseUrl: string, path: string): string;
 //#endregion
 //#region src/raw-chat.d.ts
@@ -749,8 +933,18 @@ declare class TraeGatedUpstreamClient implements TraeUpstreamClient {
 }
 //#endregion
 //#region src/refresh.d.ts
-/** Refresh only editions whose client contract is currently evidenced. */
-declare function refreshTraeCredential(credential: TraeCredential, signal?: AbortSignal): Promise<TraeRefreshOutcome>;
+/** Stable device identity for the DeviceInfo body, sourced from the app's own storage. */
+interface TraeRefreshDevice {
+  deviceId: string;
+  machineId: string;
+}
+/**
+ * Exchange a refresh token for a fresh access token, following the calling
+ * edition's verified contract. `device` is only used by editions whose
+ * official client sends a DeviceInfo body; when it cannot be resolved the
+ * field is omitted rather than sent empty.
+ */
+declare function refreshTraeCredential(credential: TraeCredential, signal?: AbortSignal, device?: TraeRefreshDevice): Promise<TraeRefreshOutcome>;
 //#endregion
 //#region src/sse.d.ts
 interface SseEvent {
@@ -874,11 +1068,13 @@ declare class TraeDelegatingUpstreamClient implements TraeUpstreamClient {
 /**
  * Read-only Trae usage/credits client.
  *
- * Sources the verified `api.trae.cn` pay/ug endpoints (see
- * `docs/USAGE_API_RESEARCH.md`). All queries are read-only and do not consume
- * Trae credits. The per-session consumption detail table is deliberately not
- * included: the endpoint returns no rows for the current account, so we only
- * expose what is actually retrievable.
+ * CN sources the verified `api.trae.cn` pay/ug endpoints (see
+ * `docs/USAGE_API_RESEARCH.md`); the international (ai) region is
+ * subscription-based and reads `ide_user_pay_status` on its own gateway
+ * (verified 2026-09-15, docs/INTL_SG_EVIDENCE.md §4). All queries are
+ * read-only and do not consume Trae credits. The per-session consumption
+ * detail table is deliberately not included: the endpoint returns no rows
+ * for the current account, so we only expose what is actually retrievable.
  */
 declare const TRAE_PAY_BASE = "https://api.trae.cn";
 interface TraeUsageOptions {
@@ -887,6 +1083,28 @@ interface TraeUsageOptions {
   baseUrl?: string;
   timeoutMs?: number;
 }
+/**
+ * Subscription/pay status of an international (ai) account, parsed from the
+ * `ide_user_pay_status` answer. The international region has no Work-credit
+ * packs, so this — not `snapshot` — is its usage surface.
+ */
+interface TraePayStatus {
+  isDollarUsageBilling: boolean;
+  hasPackage: boolean;
+  isPayFreshman: boolean;
+  inTrial: boolean;
+  trialEndTimeMs: number;
+  enableSoloLite: boolean;
+  enableSoloBuilder: boolean;
+  enableSoloCoder: boolean;
+  enableSoloWeb: boolean;
+  /** The fission (referral) program window and cap, when exposed. */
+  fission?: {
+    startTimeMs: number;
+    expireTimeMs: number;
+    maxUsage: number;
+  };
+}
 interface TraeUsageSummary {
   totalAmount: number;
   consumedAmount: number;
@@ -940,8 +1158,29 @@ declare class TraeUsageClient {
   private readonly baseUrl;
   private readonly timeoutMs;
   constructor(options: TraeUsageOptions);
+  /** Region of the current credential; `cn` when unresolvable. */
+  private currentRegion;
+  /**
+   * Pay base for the current credential's region. An explicit baseUrl (tests,
+   * diagnostics) pins the endpoint; otherwise CN uses `api.trae.cn` and the
+   * international region its own verified pay gateway.
+   */
+  private payBase;
   private authedHeaders;
   private post;
+  /**
+   * Subscription/pay status of an international (ai) account. The CN region
+   * never calls this (its contract is unverified there); the ai region uses
+   * this instead of the Work-credit `snapshot`.
+   */
+  payStatus(signal?: AbortSignal): Promise<TraePayStatus>;
+  /**
+   * The Work-credit endpoints are CN-only. The international region is
+   * subscription-based and must read {@link payStatus} instead; guarding here
+   * keeps the card's degraded `creditsError` message diagnosable rather than
+   * letting an ai credential hit an unverified path on its pay gateway.
+   */
+  private requireCnRegion;
   /** Total entitlements / credits and per-pack breakdown. */
   snapshot(signal?: AbortSignal): Promise<TraeUsageSnapshot>;
   /** Daily check-in status. */
@@ -953,13 +1192,23 @@ declare class TraeUsageClient {
 }
 //#endregion
 //#region src/status-paths.d.ts
-/**
- * Node-free constants and types shared by the Host and browser halves.
- * Mirrors the `dsh-workbuddy-connect` status-route pattern so the plugin card
- * stays consistent with that project's external presentation.
- */
 /** Plugin-owned usage endpoint consumed by its browser half. */
 declare const TRAE_USAGE_PATH = "/plugins/dsh-connect-trae/usage";
+/** Query parameter naming the region a card request addresses. */
+declare const TRAE_REGION_PARAM = "region";
+/** Every region, in card tab order. */
+declare const TRAE_REGIONS: readonly TraeRegion[];
+/**
+ * Address one region's status route. The two regions are separate provider
+ * stacks; every card request carries the region whose tab the user is on.
+ */
+declare function withTraeRegion(path: string, region: TraeRegion): string;
+/**
+ * Read the region parameter off a status-route URL. Absent means the domestic
+ * tab (`cn`); a present-but-unknown value returns undefined so the route can
+ * answer 400 instead of guessing.
+ */
+declare function regionOfTraeStatusUrl(url: string): TraeRegion | undefined;
 /** One credit pack and its remaining credit. */
 interface TraeWebCreditAccount {
   displayDesc: string;
@@ -1006,6 +1255,8 @@ interface TraeWebAccount {
   id: string;
   accountName: string;
   edition: 'cn' | 'sg' | 'solo' | 'solo-sg';
+  /** Routing bucket of this account, derived from its credential. */
+  region: TraeRegion;
   source: 'desktop' | 'dsh' | 'cli';
   tokenExpiresAtMs: number;
   selected: boolean;
@@ -1018,6 +1269,23 @@ interface TraeWebSearchPath {
   reason: 'missing' | 'unreadable' | 'invalid';
   message?: string;
 }
+/** Subscription status of an international (ai) account, rendered instead of the CN credit packs. */
+interface TraeWebPayStatus {
+  isDollarUsageBilling: boolean;
+  hasPackage: boolean;
+  isPayFreshman: boolean;
+  inTrial: boolean;
+  trialEndTimeMs: number;
+  enableSoloLite: boolean;
+  enableSoloBuilder: boolean;
+  enableSoloCoder: boolean;
+  enableSoloWeb: boolean;
+  fission?: {
+    startTimeMs: number;
+    expireTimeMs: number;
+    maxUsage: number;
+  };
+}
 /** The JSON document the plugin card renders. */
 type TraeWebUsage = {
   status: 'signed-out';
@@ -1029,6 +1297,8 @@ type TraeWebUsage = {
   accountId: string;
   accountName: string;
   tokenExpiresAtMs: number;
+  /** Which per-region model directory and selection this account owns. */
+  region: TraeRegion;
   accounts: readonly TraeWebAccount[];
   models: readonly TraeWebModel[];
   enabledModelIds: readonly string[];
@@ -1039,29 +1309,43 @@ type TraeWebUsage = {
   };
   credits?: TraeWebCredits;
   creditsError?: string;
+  /** Subscription status of an international account (region ai only). */
+  payStatus?: TraeWebPayStatus;
+  payStatusError?: string;
 } | {
   status: 'error';
   message: string;
 };
 //#endregion
 //#region src/web-status.d.ts
-/** Constructor dependencies. */
+/**
+ * Constructor dependencies. Everything region-specific is addressed by the
+ * region the request names: the two regions are separate provider stacks, so
+ * the card must be served the directory, selection, and credits of the tab the
+ * user is on.
+ */
 interface TraeUsageRouteOptions {
-  store: TraeCredentialStore;
-  client: TraeUsageClient;
-  /** The last-refreshed Trae raw directory (one entry per upstream model) for card display. */
-  displayModels(): readonly TraeModelInfo[];
-  /** The user's model selection stored as model id (= Trae name). */
-  enabledModelIds(): readonly string[];
-  discoverModels?(signal?: AbortSignal): Promise<readonly TraeModelInfo[]>;
-  rawDiagnostic?(): TraeRawDiagnostic;
+  /** The region-scoped credential store backing each region's requests. */
+  store(region: TraeRegion): TraeCredentialStore;
+  /** The region-scoped usage client (CN work credits / international pay status). */
+  client(region: TraeRegion): TraeUsageClient;
+  /** The requested region's last-refreshed raw directory (one entry per upstream model). */
+  displayModels(region: TraeRegion): readonly TraeModelInfo[];
+  /** The user's model selection in the requested region, stored as model id (= Trae name). */
+  enabledModelIds(region: TraeRegion): readonly string[];
+  /** Re-read one region's live directory from the upstream. */
+  discoverModels?(region: TraeRegion, signal?: AbortSignal): Promise<readonly TraeModelInfo[]>;
+  /** Raw-Chat capability state of the requested region. */
+  rawDiagnostic?(region: TraeRegion): TraeRawDiagnostic;
 }
 /**
- * Assemble the card's usage document. Sign-in state is read-only; credit is a
- * live billing answer whose failure degrades to `creditsError` rather than
- * failing the whole document.
+ * Assemble one region's card document. `region` is the tab the card is on; the
+ * region-scoped store already answers with only that region's accounts, so the
+ * document's model slots and account list are that region's by construction.
+ * Sign-in state is read-only; credit is a live billing answer whose failure
+ * degrades to `creditsError` rather than failing the whole document.
  */
-declare function traeWebUsage(deps: TraeUsageRouteOptions): Promise<TraeWebUsage>;
+declare function traeWebUsage(deps: TraeUsageRouteOptions, region: TraeRegion): Promise<TraeWebUsage>;
 /** Mount the GET usage route on an optional webServer context. */
 declare function registerTraeUsageRoute(ctx: Context, deps: TraeUsageRouteOptions): void;
 //#endregion
@@ -1077,23 +1361,64 @@ declare const inject: string[];
  * so no branding is needed for either host generation.
  */
 declare const TRAE_SETTINGS_NS = "trae";
+/** One region's saved model state: its own directory and the user's selection within it. */
+interface TraeRegionState {
+  /** The last-refreshed raw directory for this region; what the card displays. */
+  lastCatalog?: TraeModelInfo[];
+  /** The user's selection in this region, as model ids (= Trae name). */
+  enabledModelIds?: string[];
+  /** Models the user explicitly enabled for image input in this region. */
+  imageModelIds?: string[];
+  /** Local DSH context budget per model in this region. */
+  contextBudgets?: Record<string, number>;
+}
 interface Config {
   authFile?: string;
   edition?: 'auto' | 'cn' | 'sg' | 'solo' | 'solo-sg';
-  /** Stable local account selector; tokens remain outside settings. */
+  /**
+   * @deprecated Legacy single-slot account selector from before the dual
+   * provider split. It is attributed to whichever region the account actually
+   * belongs to (resolved once at startup from the local account scan); new
+   * writes go to {@link Config.accounts}.
+   */
   accountId?: string;
-  /** The last-refreshed Trae raw directory; what the plugin card displays. */
+  /**
+   * Per-region account selections, keyed `cn` | `ai`. Each region's tab writes
+   * its own slot; tokens remain outside settings.
+   */
+  accounts?: Partial<Record<TraeRegion, string>>;
+  /**
+   * Per-region model state, keyed `cn` | `ai`. The CN and international apps
+   * expose different rosters, so each keeps its own directory and selection
+   * and switching accounts never drops the other region's picks.
+   */
+  regions?: Partial<Record<TraeRegion, TraeRegionState>>;
+  /**
+   * @deprecated Legacy single-slot fields from before the region split. They
+   * predate international support and are read as the CN region's state when
+   * `regions.cn` is absent; new writes go to `regions`.
+   */
   lastCatalog?: TraeModelInfo[];
-  /** The user's ordinary-model selection, as model id (= Trae name). */
+  /** @deprecated See {@link Config.lastCatalog}. */
   enabledModelIds?: string[];
-  /** Local DSH context budget per model; a value may only select an advertised window. */
+  /** @deprecated See {@link Config.lastCatalog}. */
   contextBudgets?: Record<string, number>;
-  /** Models the user explicitly enabled for image input; text is always enabled. */
+  /** @deprecated See {@link Config.lastCatalog}. */
   imageModelIds?: string[];
-  /** Legacy generated runtime catalog; kept for backwards compatibility. */
+  /** @deprecated Legacy generated runtime catalog; kept for backwards compatibility. */
   models?: TraeModelInfo[];
 }
+/**
+ * One region's saved state. A config written before the region split has only
+ * the flat fields: those were always captured from the CN endpoint (the
+ * plugin had no international support), so they are read as the CN state and
+ * only when no explicit CN slot exists. The ai region never inherits them —
+ * that inheritance is exactly the bug where a stale CN directory would be
+ * intersected with the international catalog and silently drop the user's
+ * picks (the same failure workbuddy fixed with its region split).
+ */
+declare function regionStateOf(config: Config, region: TraeRegion): TraeRegionState;
 declare const Config: z<Config>;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, hashTraeRawChatArg, identityHeaders, inject, mergeTraeModelSources, name, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeIdentity, refreshTraeCredential, registerTraeUsageRoute, resolveTraeRawRuntime, sanitizeCatalog, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_REGIONS, TRAE_REGION_PARAM, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeRefreshDevice, type TraeRegion, type TraeRegionGateways, TraeRegionState, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, withTraeRegion };