dsh-connect-trae 2.3.0 → 2.4.0

package/lib/client.js

@@ -265,6 +265,10 @@ window.__ModuleLoader__.load({
 .dsm-trae-checkin-label{color:var(--dsw-alias-label-primary,#e6e6e6);font-size:13px;line-height:18px;font-weight:600}
 .dsm-trae-checkin-hint{color:var(--dsw-alias-label-tertiary,#9aa0a8);font-size:12px;line-height:17px}
 .dsm-trae-checkin-button{flex:none}
+/* The "this machine already used today's check-in" note is INFORMATIONAL, not
+   an error: it is Trae's one-per-device-per-day rule, and the day is simply
+   spent. Rendering it in the error colour would read as a plugin fault. */
+.dsm-trae-checkin-note{margin:8px 0 0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary,#c6c9d0)}
 `;
 		//#endregion
 		//#region src/client/TraeUsageCard.tsx
@@ -389,6 +393,14 @@ window.__ModuleLoader__.load({
 			/** Last claim refusal, shown until the next successful refresh. */
 			const [claimError, setClaimError] = (0, react.useState)(void 0);
 			/**
+			* Whether this MACHINE has spent today's check-in while the selected account
+			* has not been paid — the "switched account" state. Kept separate from
+			* `claimError` because it is not a failure: it is the upstream's one-per-
+			* device-per-day rule, and rendering it through the "签到失败：…" line would
+			* present a normal rule as a plugin fault.
+			*/
+			const [deviceSpentNotice, setDeviceSpentNotice] = (0, react.useState)(false);
+			/**
 			* A refused or unpersisted settings write, surfaced instead of silently
 			* reverting. On 0.1.7 a rejected write resolves normally, so without this
 			* the control would flip and then quietly snap back on the next snapshot.
@@ -469,6 +481,7 @@ window.__ModuleLoader__.load({
 			*/
 			(0, react.useEffect)(() => {
 				setClaimError(void 0);
+				setDeviceSpentNotice(false);
 			}, [activeRegion]);
 			(0, react.useEffect)(() => {
 				if (!open || !activeRegionOn || status.status !== "signed-in") return;
@@ -536,13 +549,21 @@ window.__ModuleLoader__.load({
 			* (it stops an obviously pointless click), not the protection.
 			*
 			* A refusal is not thrown away: the route answers `claimed: false` with the
-			* upstream's business code and message, and the card shows it. The upstream
-			* also reports success for an already-claimed day, so `alreadyCheckedIn`
-			* refreshes the state without pretending a new reward landed.
+			* upstream's business code and message, and the card shows it. Three answers
+			* are distinguished rather than collapsed into "failed":
+			*
+			*  - `alreadyCheckedIn` — this ACCOUNT was already paid today; show it as
+			*    claimed and refresh, never as an error.
+			*  - `deviceCheckedIn` (code 9095) — this MACHINE already spent today's
+			*    check-in, so this account cannot claim here today. That is the normal
+			*    outcome after switching accounts, and saying "check-in failed" would
+			*    blame the plugin for an upstream rule.
+			*  - anything else — a real refusal, reported verbatim.
 			*/
 			const claimCheckin = async () => {
 				setClaiming(true);
 				setClaimError(void 0);
+				setDeviceSpentNotice(false);
 				try {
 					const response = await fetch(withTraeRegion(TRAE_CHECKIN_PATH, activeRegion), {
 						method: "POST",
@@ -551,6 +572,11 @@ window.__ModuleLoader__.load({
 					});
 					const body = await response.json().catch(() => void 0);
 					if (!response.ok) throw new Error(body?.error ?? `HTTP ${response.status}`);
+					if (body?.claimed === false && body.deviceCheckedIn === true) {
+						await refreshUsage(activeRegion);
+						if (mounted.current) setDeviceSpentNotice(true);
+						return;
+					}
 					if (body?.claimed === false && body.alreadyCheckedIn !== true) throw new Error(body.message === void 0 || body.message === "" ? t("row.checkinRefused", { code: String(body.code ?? "") }) : `${t("row.checkinRefused", { code: String(body.code ?? "") })}: ${body.message}`);
 					await refreshUsage(activeRegion);
 				} catch (error) {
@@ -637,6 +663,23 @@ window.__ModuleLoader__.load({
 			const savedEnabledIds = status.status === "signed-in" ? new Set(status.enabledModelIds) : /* @__PURE__ */ new Set();
 			const activeEnabledIds = draft?.enabledIds ?? savedEnabledIds;
 			const activeImageIds = draft?.imageIds ?? savedImageIds;
+			/**
+			* Effective image capability of one row, mirroring what the Host reports to
+			* DSH: the user's opt-in unioned with Trae's own `multimodal` flag (issue
+			* #16). Rendering the union is what keeps this checkbox truthful — showing the
+			* raw `imageModelIds` would draw an unticked box next to a model the plugin
+			* is in fact advertising as image-capable.
+			*/
+			const rowAcceptsImage = (model) => activeImageIds.has(model.id) || model.multimodal === true;
+			/**
+			* A row Trae itself declares multimodal needs no manual opt-in, so its box is
+			* shown ticked and read-only rather than offering a toggle that the union
+			* would immediately undo. Turning image input off for such a model is
+			* deliberately not supported: the flag is the vendor's own capability answer,
+			* and enabling it only lets DSH attach an image the user still has to pick per
+			* message — it never sends one by itself.
+			*/
+			const rowImageIsAutomatic = (model) => model.multimodal === true;
 			const activeContextBudgets = draft?.contextBudgets ?? savedContextBudgets;
 			const dirty = draft !== void 0;
 			/** Apply an edit to the ACTIVE tab's draft, seeding it from the current view. */
@@ -699,7 +742,8 @@ window.__ModuleLoader__.load({
 						enabled: regionOn(activeRegion),
 						lastCatalog: visibleModels.map((model) => ({
 							...model,
-							input: ["text"]
+							input: ["text"],
+							...model.multimodal === void 0 ? {} : { multimodal: model.multimodal }
 						})),
 						enabledModelIds: [...activeEnabledIds],
 						imageModelIds: [...activeImageIds].filter((id) => activeEnabledIds.has(id)),
@@ -955,10 +999,11 @@ window.__ModuleLoader__.load({
 									children: t("row.creditsError", { message: status.creditsError })
 								}),
 								status.checkin === void 0 ? null : (() => {
-									const done = status.checkin.checkedIn || status.checkin.didCheckedIn;
+									const accountClaimed = status.checkin.checkedIn;
+									const deviceSpent = !accountClaimed && (status.checkin.didCheckedIn || deviceSpentNotice);
 									const reward = formatNumber(status.checkin.credits);
 									const bonus = status.checkin.extraCredits === void 0 ? "" : ` + ${formatNumber(status.checkin.extraCredits)}`;
-									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 										className: "dsm-trae-checkin",
 										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 											className: "dsm-trae-checkin-copy",
@@ -967,18 +1012,22 @@ window.__ModuleLoader__.load({
 												children: t("row.checkinLabel")
 											}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 												className: "dsm-trae-checkin-hint",
-												children: [t("row.checkinReward", { reward: `${reward}${bonus}` }), done ? ` · ${t("row.checkinDoneHint")}` : ""]
+												children: [t("row.checkinReward", { reward: `${reward}${bonus}` }), accountClaimed ? ` · ${t("row.checkinDoneHint")}` : ""]
 											})]
 										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 											type: "button",
 											className: "dsm-btn dsm-btn-primary dsm-trae-checkin-button",
-											disabled: !status.checkin.enabled || done || claiming,
+											disabled: !status.checkin.enabled || accountClaimed || deviceSpent || claiming,
 											onClick: () => {
 												claimCheckin();
 											},
-											children: claiming ? t("row.checkinClaiming") : done ? t("row.checkinClaimed") : t("row.checkinClaim")
+											children: claiming ? t("row.checkinClaiming") : accountClaimed ? t("row.checkinClaimed") : t("row.checkinClaim")
 										})]
-									});
+									}), deviceSpent ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+										className: "dsm-trae-checkin-note",
+										role: "status",
+										children: t("row.checkinDeviceSpent")
+									}) : null] });
 								})(),
 								status.checkin !== void 0 && !status.checkin.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 									className: "dsm-trae-usage-error",
@@ -1046,8 +1095,9 @@ window.__ModuleLoader__.load({
 															className: "dsm-trae-model-image",
 															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 																type: "checkbox",
-																checked: activeImageIds.has(model.id),
-																disabled: settingsScope?.getSnapshot().writable !== true || saving,
+																checked: rowAcceptsImage(model),
+																disabled: rowImageIsAutomatic(model) || settingsScope?.getSnapshot().writable !== true || saving,
+																title: rowImageIsAutomatic(model) ? t("row.modelImageAuto") : void 0,
 																onChange: () => {
 																	toggleImage(model.id);
 																}
@@ -1210,6 +1260,7 @@ window.__ModuleLoader__.load({
 			"row.checkinDoneHint": "come back tomorrow",
 			"row.checkinRefused": "Trae refused the check-in (code {code})",
 			"row.checkinError": "Check-in failed: {message}",
+			"row.checkinDeviceSpent": "This machine already used today's check-in — Trae allows one per device per day, so this account cannot claim here today. Claim it on another device or from the account that checked in, or come back tomorrow.",
 			"row.checkinDisabled": "This account has no check-in activity available.",
 			"row.regionCn": "CN",
 			"row.regionAi": "International",
@@ -1238,11 +1289,12 @@ window.__ModuleLoader__.load({
 			"row.contextBudget": "DSH context budget",
 			"row.modelOutput": "Output {output}",
 			"row.modelImage": "Image",
+			"row.modelImageAuto": "Enabled automatically: Trae marks this model multimodal.",
 			"row.modelRate": "{rate}x credits",
 			"row.modelReasoning": "Reasoning: {efforts}",
 			"row.modelReasoningSupported": "Reasoning: supported",
 			"row.modelUnknown": "Unknown",
-			"row.modelCapabilityPending": "Image input is enabled only for models you select.",
+			"row.modelCapabilityPending": "Image input follows Trae's own multimodal flag, plus anything you tick yourself.",
 			"row.cheer": "Star on GitHub"
 		};
 		const zh = {
@@ -1288,6 +1340,7 @@ window.__ModuleLoader__.load({
 			"row.checkinDoneHint": "明天再来",
 			"row.checkinRefused": "Trae 拒绝了本次签到（业务码 {code}）",
 			"row.checkinError": "签到失败：{message}",
+			"row.checkinDeviceSpent": "本机今日的签到已用掉——Trae 按「每台设备每天一次」限制，所以当前账号在本机今天无法再签。可换一台设备领取，或用今天已签到的那台设备/账号，或明天再来。",
 			"row.checkinDisabled": "该账号当前没有可用的签到活动。",
 			"row.regionCn": "国内版",
 			"row.regionAi": "国际版",
@@ -1316,11 +1369,12 @@ window.__ModuleLoader__.load({
 			"row.contextBudget": "DSH 上下文预算",
 			"row.modelOutput": "最大输出 {output}",
 			"row.modelImage": "图片",
+			"row.modelImageAuto": "已自动开启：Trae 把该模型标为多模态。",
 			"row.modelRate": "积分 {rate}x",
 			"row.modelReasoning": "推理强度：{efforts}",
 			"row.modelReasoningSupported": "推理：支持",
 			"row.modelUnknown": "未知",
-			"row.modelCapabilityPending": "仅对你手动勾选的模型启用图片输入。",
+			"row.modelCapabilityPending": "图片输入跟随 Trae 自身的多模态标注，并叠加你手动勾选的模型。",
 			"row.cheer": "鼓励一下"
 		};
 		//#endregion

package/lib/index.d.ts

@@ -46,6 +46,15 @@ interface TraeStorageCandidate {
   path: string;
   source: TraeCredentialSource;
 }
+/**
+ * One edition's plausible Windows directory spellings, in probe order.
+ *
+ * Exported so the identity reader and the credential scanner probe the SAME
+ * names: the two resolve different files (the install's `product.json` vs the
+ * per-user `storage.json`) but they describe one installation, and a spelling
+ * that works for one but not the other is a bug rather than a preference.
+ */
+declare function traeWindowsAppNames(edition: TraeEdition): readonly string[];
 declare function traeStorageCandidates(platform?: NodeJS.Platform, home?: string, env?: NodeJS.ProcessEnv): TraeStorageCandidate[];
 //#endregion
 //#region src/region.d.ts
@@ -111,6 +120,23 @@ interface TraeModelInfo {
   wireConfigName?: string;
   /** The directory function this model must be called through (see {@link TraeWireModel.function}). */
   wireFunction?: string;
+  /**
+   * Trae's own `multimodal` flag for this model, carried through from the
+   * directory that advertised it. It is the upstream's answer to "does this
+   * model read images", and {@link applyImageSelection} unions it with the
+   * user's explicit opt-ins.
+   *
+   * Deliberately NOT the same thing as `input`: `input` is what DSH is told
+   * this route accepts, while this field records what Trae said. Keeping both
+   * lets a future refresh re-derive `input` without losing the upstream fact,
+   * and lets the card explain WHY a model is image-capable.
+   *
+   * Absent means the directory did not say (an older `lastCatalog` saved before
+   * this field existed, a fallback row, or a directory entry that omitted the
+   * key). Absent is treated as false, never as "assume capable": sending an
+   * image to a model that cannot read one burns credits for a silent failure.
+   */
+  multimodal?: boolean;
 }
 /**
  * Bootstrap catalog: identity only where current Trae metadata has not been
@@ -166,7 +192,7 @@ declare function traeInputModalities(model: Pick<TraeModelInfo, 'input'>): TraeI
  * model discovery) use this decorated name.
  */
 declare function traeModelDisplayName(model: Pick<TraeModelInfo, 'name' | 'creditMultiplier'>): string;
-/** Apply the user's explicit image opt-ins; upstream and saved row hints are ignored. */
+/** Apply the user's explicit image opt-ins plus Trae's own multimodal flag. */
 declare function applyImageSelection(models: readonly TraeModelInfo[], selected: ReadonlySet<string>): TraeModelInfo[];
 /** One row from `get_detail_param`: the authoritative llm_utils_chat wire id + display name. */
 interface TraeWireModel {
@@ -230,7 +256,7 @@ type TraeContextBudget = number;
  * never to a fabricated number. Everything else keeps the dev window.
  */
 declare function applyContextBudgets(catalog: readonly TraeModelInfo[], budgets?: Readonly<Record<string, TraeContextBudget | undefined>>): TraeModelInfo[];
-/** Convert Trae metadata into text-only model rows; image support is user-owned configuration. */
+/** Convert Trae metadata into catalog rows; image input is decided by {@link applyImageSelection}. */
 declare function discoveredCatalog(models: readonly TraeDiscoveredModel[]): TraeModelInfo[];
 /**
  * Drop rows saved by older releases that generated `@1m` variant models, so a
@@ -576,6 +602,8 @@ interface TraeObservedModelConfig {
 declare function parseObservedModelConfig(line: string): TraeObservedModelConfig | undefined;
 //#endregion
 //#region src/model-cache.d.ts
+/** Basename of the SQLite cache sitting beside the credential document. */
+declare const TRAE_STATE_DB_FILENAME = "state.vscdb";
 interface TraeCachedModelConfig {
   name: string;
   customConfig?: Record<string, unknown>;
@@ -594,11 +622,54 @@ interface TraeCachedModelReadOptions {
   home?: string;
   /** Environment override for testing; defaults to process.env. */
   env?: NodeJS.ProcessEnv;
+  /**
+   * The credential candidate whose account is being read. Supplying it pins the
+   * lookup to the installation the credential actually came from, which is the
+   * only way to stay correct when several editions are installed: `storage.json`
+   * and `state.vscdb` live in the SAME `globalStorage` directory, so the cache
+   * belongs to whichever candidate yielded the sign-in.
+   */
+  candidate?: TraeStorageCandidate;
+  /** Injectable for tests; defaults to node:fs existsSync. */
+  exists?: (path: string) => boolean;
+  /**
+   * Injectable `sqlite3` runner for tests; defaults to promisified `execFile`.
+   * Mirrors the `fetchImpl` injection used elsewhere in this plugin, and exists
+   * so a test can assert the exact argv — in particular WHICH database path was
+   * chosen, which no assertion on the candidate list alone can prove.
+   */
+  runSqlite?: (database: string, sql: string) => Promise<{
+    stdout: string;
+  }>;
 }
+/**
+ * The cache paths to try, most-specific first.
+ *
+ * `state.vscdb` is a SIBLING of the credential document (both sit in
+ * `globalStorage`), so a candidate's own path is the authority for its cache —
+ * this is why the database is derived from {@link traeStorageCandidates} rather
+ * than re-spelled here.
+ *
+ * It previously hardcoded the single macOS spelling `Trae CN`, which was wrong
+ * in two ways on Windows: `paths.ts` probes `Trae CN` AND `trae-cn`, and the
+ * edition actually installed is often SOLO (`TRAE SOLO CN`). This module would
+ * then point at a directory that does not exist. That went unnoticed only
+ * because the Windows `sqlite3` dependency is absent, so the lookup failed and
+ * callers fell back — masking the wrong path behind a different error. Sharing
+ * one path table means a spelling that works for sign-in also works for the
+ * cache.
+ */
+declare function traeStateDatabaseCandidates(options?: TraeCachedModelReadOptions): string[];
 /**
  * Read Trae's own current user's model map via sqlite3 without exposing
  * secrets. The sqlite3 command line is a macOS prerequisite; on Windows it is
  * typically absent, so the call fails and callers fall back gracefully.
+ *
+ * Every candidate database is tried in order and the first that EXISTS is
+ * queried. Existence is checked before spawning because a missing file and a
+ * missing `sqlite3` binary are different problems: choosing the wrong directory
+ * would otherwise surface as a confusing `sqlite3` failure, hiding a path bug
+ * behind a dependency error.
  */
 declare function readTraeCachedModel(functionName: string, modelName: string, userId: string, options?: TraeCachedModelReadOptions): Promise<TraeCachedModelConfig | undefined>;
 //#endregion
@@ -634,6 +705,55 @@ interface TraeModelDetailRequest {
 /** Build the exact request shape observed in successful current Trae CN logs. */
 declare function buildTraeModelDetailRequest(configName?: string, custom?: boolean): TraeModelDetailRequest;
 //#endregion
+//#region src/redact.d.ts
+/**
+ * Redaction helpers for diagnostics that a user may paste into a public issue.
+ *
+ * A verification report is only useful if it can be shared, and it is only safe
+ * to share if it carries no personal identifiers. Paths are the hard case:
+ * `C:\Users\<real name>\AppData\Roaming\Trae CN\...` contains both a real
+ * account name AND the single most diagnostic token in the whole report (the
+ * Trae data directory spelling). Redacting the whole path would make the report
+ * worthless; printing it whole would leak the user's name. So the user segment
+ * is replaced and the meaningful tail is preserved.
+ *
+ * @module dsh-connect-trae/redact
+ */
+/**
+ * Replace the user segment of a path with `<user>`, keeping the rest intact.
+ *
+ * Handles the shapes a Trae install can produce:
+ *   - `C:\Users\<name>\...` and `C:\Documents and Settings\<name>\...` (Windows)
+ *   - `/Users/<name>/...` and `/home/<name>/...` (macOS / Linux)
+ *
+ * Anything after that segment — edition directory, `User\globalStorage`,
+ * `storage.json` — is preserved verbatim, because that is what a report is
+ * actually read for. Cross-platform on purpose: the function is called by
+ * Windows-focused diagnostics, but the same helpers run in tests and on other
+ * hosts, and a report from the wrong platform must not leak either.
+ */
+declare function maskUserPath(path: string): string;
+/**
+ * Describe a name by shape instead of by value: a character count, plus whether
+ * it is purely numeric.
+ *
+ * This is the deliberate middle ground for account names. A Trae account name
+ * is often a real name or a phone number, so it must never be printed; but the
+ * report still needs to show that an account WAS resolved, and the shape
+ * distinguishes a real nickname from a generated `用户<n>` id — which is the
+ * only thing a reader needs to judge whether account discovery worked.
+ */
+declare function describeNameShape(name: unknown): string;
+/**
+ * Describe an identifier by shape instead of by value.
+ *
+ * A device id (`x-device-id`) is a stable installation identifier and is
+ * directly tied to the upstream's per-device rules, so it is never printed.
+ * Its shape still proves which resolution path ran: a real `icube-dc` id is
+ * 15 digits, while the fallback is a 32-character hex hash.
+ */
+declare function describeIdShape(value: unknown): string;
+//#endregion
 //#region src/protocol.d.ts
 declare const TRAE_CN_AGENT_TASK_PATH = "/api/agent/v3/create_agent_task";
 declare const TRAE_CN_TITLE_PATH = "/api/agent/v3/llm_utils_chat";
@@ -1239,15 +1359,32 @@ interface TraeUsageSnapshot {
   packs: TraeUsagePack[];
 }
 interface TraeCheckinStatus {
+  /**
+   * Whether the account's REWARD PACK for today already exists. This is the
+   * account-wide answer and it is the one that decides whether there is
+   * anything left to claim: a day with `checkedIn: true` has already been paid
+   * out, whichever device produced it.
+   */
   checkedIn: boolean;
   /** Reward for one check-in, as reported by the upstream (`credits`). */
   credits: number;
   enabled: boolean;
   /**
-   * Whether today's reward was claimed in a previous session. The upstream
-   * reports `did_checked_in` separately from `checked_in`: the app uses the
-   * former to keep the claim button disabled for the rest of the Beijing day
-   * even when the status read happens to report `checked_in: false`.
+   * Whether THIS device's claim for today was already recorded. The upstream
+   * keys this on the `x-device-id` the request carries — not on the account —
+   * so it answers `true` for the device that claimed and `false` for the same
+   * account and day read from any other device.
+   *
+   * Measured 2026-09-26 on a live CN account whose claim had succeeded minutes
+   * earlier: `did_checked_in` was `true` with the claiming device id and
+   * `false` with the header omitted, with a synthetic id, and with another
+   * install's id. Repeating the read never flips it, so it is not "have I seen
+   * you before" state either — only an actual claim sets it.
+   *
+   * It is therefore NOT a "today is done" signal on its own (claiming again
+   * answers the upstream's own 9095 "该设备今日已参与签到" refusal); it is
+   * evidence that this exact device is already accounted for, which is what
+   * makes a claim safe to skip.
    */
   didCheckedIn: boolean;
   /** Bonus credit granted on top of the base reward, when the upstream reports one. */
@@ -1323,6 +1460,12 @@ declare class TraeUsageClient {
   /**
    * Daily check-in status. Read-only, and answered with or without the device
    * header — the claim is what needs it.
+   *
+   * The read DOES carry the header whenever this installation has one, and
+   * that is deliberate rather than incidental: `did_checked_in` is answered
+   * per device, so omitting the header would make a device that already claimed
+   * today look identical to one that never has (measured 2026-09-26, see
+   * {@link TraeCheckinStatus.didCheckedIn}).
    */
   checkinStatus(signal?: AbortSignal): Promise<TraeCheckinStatus>;
   /**
@@ -1398,15 +1541,33 @@ interface TraeWebModel {
     defaultEffort?: string;
   };
   maxContextWindow?: number;
+  /**
+   * Trae's own image-capability flag, as the runtime catalog carries it. The
+   * card renders these rows with their image checkbox already ticked so the
+   * control matches what DSH is actually told (issue #16); absent means the
+   * directory did not declare it, which is not a capability claim either way.
+   */
+  multimodal?: boolean;
 }
 /**
  * Daily check-in state rendered below the credit stats.
  *
- * `didCheckedIn` is not redundant with `checkedIn`: the upstream reports them
- * separately, and the official client keeps the claim button disabled for the
- * rest of the Beijing day off `did_checked_in` even when a status read comes
- * back `checked_in: false`. The card mirrors that rule so a stale-looking
- * status cannot invite a pointless second claim.
+ * The two booleans answer DIFFERENT questions and must never be collapsed into
+ * one "done" flag — doing that was a shipped bug (see CHANGELOG 2.3.1):
+ *
+ *  - `checkedIn` is ACCOUNT-level: today's reward pack exists for this account,
+ *    so there is nothing left to claim and the balance already includes it.
+ *  - `didCheckedIn` is DEVICE-level: this MACHINE already spent its one
+ *    check-in for the day, whichever account spent it. The upstream keys it on
+ *    the `x-device-id` in the request and answers it per device, not per
+ *    account (measured 2026-09-26: the same account and Beijing day answered
+ *    `false` with the header omitted, with a synthetic id, and with another
+ *    install's id, and `true` for the device that actually claimed).
+ *
+ * So `didCheckedIn && !checkedIn` is the "switched account" case: the device's
+ * daily check-in is used up, but THIS account was never rewarded. Claiming
+ * again is refused upstream (business code 9095, "该设备今日已参与签到"), so
+ * the card disables the button — but it must say that, not "claimed today".
  */
 interface TraeWebCheckin {
   checkedIn: boolean;
@@ -1419,8 +1580,19 @@ interface TraeWebCheckin {
 interface TraeWebCheckinClaim {
   /** False when the upstream answered a non-zero business code (e.g. 9004). */
   claimed: boolean;
-  /** True when today was already claimed, so nothing was sent upstream. */
+  /**
+   * True only when THIS ACCOUNT's reward for today already exists, so nothing
+   * was sent upstream. Distinct from {@link TraeWebCheckinClaim.deviceCheckedIn}:
+   * a device that already claimed for another account leaves this false.
+   */
   alreadyCheckedIn: boolean;
+  /**
+   * True when today's check-in was already spent on this DEVICE (by this or
+   * another account), so no claim was sent or the upstream refused it with
+   * 9095. Not an error: it is the truthful answer to "can this account claim
+   * here today?" — no, and the reason is the machine, not the account.
+   */
+  deviceCheckedIn?: boolean;
   code?: number;
   message?: string;
   /** The refreshed check-in state, present whenever the claim path ran. */
@@ -1731,4 +1903,4 @@ declare function asVolatile<S>(schema: S): S;
 declare const Config: z<Config>;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, 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 TraeCheckinClaim, 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 TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };
+export { Config, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_AI_PROVIDER, TRAE_CHECKIN_PATH, 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_STATE_DB_FILENAME, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeAdapter, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, 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 TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, discoveredCatalog, fallbackModelsFor, hashTraeRawChatArg, identityHeaders, inject, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, pickTraeStorageIdentity, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, sanitizeCatalog, settingsNamespaceOf, traeEndpoint, traeInputModalities, traeModelDisplayName, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, withTraeRegion };