dsh-connect-trae 4.14.2 → 4.16.0

package/lib/client.js

@@ -7684,13 +7684,22 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			return value.toLocaleString("en-US", { maximumFractionDigits: 0 });
 		}
 		/**
-		* The soonest expiry the chosen tier names, or undefined when none carries one.
-		*
-		* Read from the tier the shared ladder picked, so the time shown always belongs
-		* to the horizon the headline claims — the two cannot disagree.
+		* The notice this panel would render, or undefined when there is nothing to say.
+		*
+		* THE ONE GUARD THE RENDER READS. An earlier version asked
+		* `signedIn?.credits?.expiry !== undefined`, which is true whenever upstream sent
+		* the four buckets — even with every `packs` count at 0. The box then rendered
+		* with an empty `<span>` inside and the `lapsed` border (the tone fallback),
+		* i.e. a warning-shaped rectangle containing nothing. Every empty-bucket
+		* document produced one, which is the blank box in the reported screenshot.
+		*
+		* Putting the whole lookup here means the render cannot ask a weaker question
+		* than the copy does: "is there a box" and "is there a sentence" are now the
+		* same boolean.
 		*/
-		function soonestExpiryOf(expiry) {
-			return expiryNotice(expiry)?.soonestExpiresAtMs;
+		function expiryNoticeOf(signedIn) {
+			const expiry = signedIn?.credits?.expiry;
+			return expiry === void 0 ? void 0 : expiryNotice(expiry);
 		}
 		/**
 		* The notice's headline sentence, naming the amount and the pack count.
@@ -8255,12 +8264,12 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 								}, row.id);
 							}) })]
 						}),
-						activeRegion === "cn" && signedIn?.credits?.expiry !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: `dsm-trae-expiry ${expiryToneClass(expiryNotice(signedIn.credits.expiry)?.tier ?? "lapsed")}`,
+						activeRegion === "cn" && expiryNoticeOf(signedIn) !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: `dsm-trae-expiry ${expiryToneClass(expiryNoticeOf(signedIn).tier)}`,
 							role: "status",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: expiryMessageOf(signedIn.credits.expiry, t) }), soonestExpiryOf(signedIn.credits.expiry) === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: expiryMessageOf(signedIn.credits.expiry, t) }), expiryNoticeOf(signedIn).soonestExpiresAtMs === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "dsm-trae-expiry-detail",
-								children: t("row.expiryEarliest", { time: formatDateTime(soonestExpiryOf(signedIn.credits.expiry)) })
+								children: t("row.expiryEarliest", { time: formatDateTime(expiryNoticeOf(signedIn).soonestExpiresAtMs) })
 							})]
 						}) : null,
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -9545,6 +9554,17 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 		*
 		* @module dsh-connect-trae/client/TraeModelLabel
 		*/
+		/**
+		* Every provider id this plugin owns, in panel order.
+		*
+		* Exported because on a `keyed` host the label seat is one registration PER
+		* provider id — the registration side needs the same list the component uses to
+		* decide "is this row mine", and a second literal would drift from
+		* `providerOfPanel`. Derived rather than typed out: `trae-enterprise` is the id
+		* most easily forgotten, and forgetting it means that panel's rows silently fall
+		* through to the host's plain fallback.
+		*/
+		const TRAE_MODEL_LABEL_PROVIDERS = TRAE_PANELS.map(providerOfPanel);
 		/** How long a fetched snapshot is trusted, in milliseconds. */
 		const CACHE_MS = 6e4;
 		/** How often a mounted label re-reads the clock, in milliseconds. */
@@ -9816,6 +9836,17 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 		* host's own presentation — catalog name plus that model's optional badge — for
 		* any provider that is not ours.
 		*
+		* WHAT CHANGES WHEN THE HOST KEYS THE SLOT — and why the number stays. On a host
+		* that declares this slot `keyed`, the seat is registered once per provider id
+		* (`./model-label-seat.ts`), each `key` is its own cell, and priority stops
+		* deciding WHO IS VISIBLE: qoder's `-101` and workbuddy's `-105` no longer share
+		* a cell with this `-102`, so none of the three can shadow another and the
+		* armistice below stops being a race. Priority keeps exactly one meaning inside
+		* a cell — the tie-breaker between two registrations claiming the SAME provider
+		* id, where an equal value throws and the lowest renders. The value is therefore
+		* kept as this plugin's rank for its own rows, not as a bid in an auction that
+		* no longer happens.
+		*
 		* WHY A DISTINCT PRIORITY IS NOT ENOUGH ON ITS OWN. It removes the cross-plugin
 		* collision, but issue #74's error was a SECOND registration of THIS plugin
 		* against its own first one (the report's stack shows
@@ -9824,90 +9855,155 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 		* slot's declaration lifetime collapses and re-declares, so a callback that
 		* registers unconditionally double-registers. `index.tsx` therefore also
 		* disposes its previous entry before every attempt. Priority alone would have
-		* made the throw rarer and harder to read, not absent.
+		* made the throw rarer and harder to read, not absent. (On a `keyed` host the
+		* same rule applies per key: re-registering one provider's seat twice at one
+		* priority throws just as loudly.)
 		*/
 		const MODEL_LABEL_PRIORITY = -102;
-		/** The tone colours, mapped onto the same theme tokens the host's Tag paints. */
+		/** The four tones the host understands, as a lookup for narrowing. */
+		const HOST_BADGE_TONE_NAMES = [
+			"neutral",
+			"info",
+			"success",
+			"warning"
+		];
+		/**
+		* The tone palette, transcribed from the host's `Tag.module.css` (0.2.2-rc.1).
+		*
+		* TWO TOKENS ARE EASY TO MISCOPY, AND BOTH WERE: `info` paints
+		* `state-business-primary` (not `brand-primary`) and `warning` paints
+		* `state-warn-primary` (not `state-warn-secondary`). A near-miss token still
+		* "looks blue" or "looks amber", which is why this survived a review — but two
+		* capsules on one row are compared directly, so the drift is visible.
+		*
+		* The fill is the tone's own colour mixed into transparent (10%, or 12% for
+		* `warning`), and there is NO border: the host's capsule is a fill only.
+		*/
 		const HOST_BADGE_TONES = {
 			neutral: {
 				color: "var(--dsw-alias-label-secondary)",
-				background: "var(--dsw-alias-bg-layer-2)",
-				border: "var(--dsw-alias-border-l2)"
+				background: "var(--dsw-alias-bg-module-platform)"
 			},
 			info: {
-				color: "var(--dsw-alias-brand-primary)",
-				background: "var(--dsw-alias-bg-layer-2)",
-				border: "var(--dsw-alias-border-l2)"
+				color: "var(--dsw-alias-state-business-primary)",
+				background: "color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent)"
 			},
 			success: {
 				color: "var(--dsw-alias-state-success-primary)",
-				background: "var(--dsw-alias-bg-layer-2)",
-				border: "var(--dsw-alias-border-l2)"
+				background: "color-mix(in srgb, var(--dsw-alias-state-success-primary) 10%, transparent)"
 			},
 			warning: {
-				color: "var(--dsw-alias-state-warn-secondary)",
-				background: "var(--dsw-alias-bg-layer-2)",
-				border: "var(--dsw-alias-border-l2)"
+				color: "var(--dsw-alias-state-warn-primary)",
+				background: "color-mix(in srgb, var(--dsw-alias-state-warn-primary) 12%, transparent)"
 			}
 		};
+		/** Whether a value is one of the host's four tone literals. */
+		function isHostBadgeTone(value) {
+			return typeof value === "string" && HOST_BADGE_TONE_NAMES.includes(value);
+		}
 		/**
 		* The one line a badge shows, in the reader's language.
 		*
-		* The host contract requires an English entry, so that is the last resort; the
-		* active language and its base tag (`de-DE` → `de`) come first, matching what
-		* the host's own resolver does. An empty string is treated as absent — a blank
-		* chip would be a decoration that says nothing.
+		* `text` is `unknown` because it comes off the wire. A literal is used as-is; a
+		* table is looked up exactly the way the host's `resolveText` does it — active
+		* language, then its base tag (`pt-BR` → `pt-br` → `pt`), then the required
+		* `en`. Anything else (a number, an array, a nested object) is not text, so it
+		* reads as absent rather than being stringified into `[object Object]`.
+		*
+		* A BLANK string is treated as absent, which is deliberately STRICTER than the
+		* host: `resolveText` returns `''` untouched (it only fills in missing keys), so
+		* `{ en: '' }` paints a real, empty capsule. Refusing that here means a
+		* decoration never says nothing — a rule this component adds, not the host's.
 		*/
 		function resolveHostBadgeText(text) {
 			if (typeof text === "string") return text.trim() === "" ? void 0 : text;
+			if (typeof text !== "object" || text === null || Array.isArray(text)) return void 0;
+			const table = text;
 			const language = uiLanguage().toLowerCase();
 			const base = language.split("-")[0] ?? "";
-			const picked = text[language] ?? (base === "" ? void 0 : text[base]) ?? text.en;
-			return picked === void 0 || picked.trim() === "" ? void 0 : picked;
+			const candidates = [
+				table[language],
+				base === "" ? void 0 : table[base],
+				table["en"]
+			];
+			for (const candidate of candidates) {
+				if (typeof candidate !== "string") continue;
+				if (candidate.trim() !== "") return candidate;
+			}
 		}
-		/** One provider-authored selector badge, drawn where the host's own label draws it. */
+		/**
+		* Read one provider-authored badge, or `undefined` when there is nothing to say.
+		*
+		* THE WHOLE POINT IS THAT THIS DOES NOT THROW. `badge` arrives from another
+		* plugin's catalog, so its shape is that plugin's business: a `null`, an unknown
+		* tone, a missing `text` and a numeric `text` are all things a third party can
+		* ship. A throw here does not lose the capsule — it retires THIS COMPONENT from
+		* the `single` cell, which strips the name off every row in the picker. The
+		* degradation is therefore total: anything unreadable becomes the plain name.
+		*/
+		function readHostBadge(badge) {
+			if (typeof badge !== "object" || badge === null || Array.isArray(badge)) return void 0;
+			const label = resolveHostBadgeText(badge.text);
+			if (label === void 0) return void 0;
+			const tone = badge.tone;
+			return {
+				tone: isHostBadgeTone(tone) ? tone : "neutral",
+				label
+			};
+		}
+		/**
+		* One provider-authored selector badge, drawn where the host's own label draws it.
+		*
+		* Styled INLINE rather than by class, because a slot component renders OUTSIDE
+		* the card: the card's stylesheet is only mounted while the card is, so a picker
+		* opened on a page that never mounted it would otherwise get an uncoloured
+		* capsule. The geometry is the host's `Tag` verbatim — `padding: 1px 8px`,
+		* `font-size: 11px`, `line-height: 17px`, `border-radius: 999px`,
+		* `corner-shape: round`.
+		*
+		* NO `max-width` / `text-overflow`, deliberately: the host does not truncate, so
+		* truncating here would show "限时免…" at exactly the row width where the host
+		* showed the whole thing — less consistent, not more.
+		*/
 		function HostBadge(props) {
-			const tone = HOST_BADGE_TONES[props.badge.tone] ?? HOST_BADGE_TONES.neutral;
+			const tone = HOST_BADGE_TONES[props.badge.tone];
+			const style = {
+				display: "inline-flex",
+				alignItems: "center",
+				flex: "none",
+				borderRadius: "999px",
+				padding: "1px 8px",
+				fontSize: "11px",
+				lineHeight: "17px",
+				fontWeight: 500,
+				whiteSpace: "nowrap",
+				color: tone.color,
+				background: tone.background,
+				cornerShape: "round"
+			};
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				className: "dsm-trae-model-label-host-badge",
-				style: {
-					flex: "none",
-					borderRadius: "999px",
-					padding: "0 6px",
-					fontSize: "10px",
-					fontWeight: 500,
-					lineHeight: "15px",
-					whiteSpace: "nowrap",
-					border: `1px solid ${tone.border}`,
-					color: tone.color,
-					background: tone.background,
-					maxWidth: "8em",
-					overflow: "hidden",
-					textOverflow: "ellipsis"
-				},
-				children: props.label
+				className: `dsm-trae-model-label-host-badge dsm-trae-model-label-host-badge-${props.badge.tone}`,
+				style,
+				children: props.badge.label
 			});
 		}
 		function TraeModelLabel(props) {
 			const { provider, model } = props;
 			const panel = panelOfProvider(provider.id);
 			if (panel === void 0) {
-				const badgeInfo = model.badge;
-				const label = badgeInfo === void 0 ? void 0 : resolveHostBadgeText(badgeInfo.text);
-				if (badgeInfo === void 0 || label === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: model.name });
-				const badge = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HostBadge, {
-					badge: badgeInfo,
-					label
+				const badge = readHostBadge(model.badge);
+				if (badge === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: model.name });
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: "dsm-trae-model-label",
+					style: {
+						display: "inline-flex",
+						alignItems: "center",
+						gap: "5px",
+						whiteSpace: "nowrap",
+						verticalAlign: "baseline"
+					},
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: model.name }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HostBadge, { badge })]
 				});
-				return props.placement === "trigger" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
-					badge,
-					" ",
-					model.name
-				] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
-					model.name,
-					" ",
-					badge
-				] });
 			}
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TraeModelLabelInner, {
 				modelId: model.id,
@@ -9958,6 +10054,114 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 			});
 		}
 		//#endregion
+		//#region src/client/model-label-seat.ts
+		/**
+		* Read the declared kind of a slot, or `undefined` when it cannot be read.
+		*
+		* `spec()` is the documented read-only accessor (`SlotRegistry.spec`), present
+		* on 0.1.7 and on 0.2.2. It is also the only way to learn the kind: the
+		* declaration lives in the host package, and a plugin's own `SlotMap`
+		* augmentation says what this plugin HOPES the slot is, not what the running
+		* host declared.
+		*
+		* Anything unexpected — no `spec` method on an older line, a throw from a
+		* service that is not ready, a kind this build does not know — returns
+		* `undefined`, and the caller falls back to the single-cell shape. That is the
+		* conservative direction: it is what every released version of this plugin
+		* already does.
+		*
+		* @param slots - The `slots` service (typed loosely: the accessor is optional).
+		* @param key - The slot key to inspect.
+		* @returns The declared kind, or `undefined`.
+		*/
+		function declaredSlotKind(slots, key) {
+			const face = slots;
+			if (face === void 0 || typeof face.spec !== "function") return void 0;
+			let spec;
+			try {
+				spec = face.spec(key);
+			} catch {
+				return;
+			}
+			const kind = spec?.kind;
+			if (kind === "single" || kind === "list" || kind === "keyed" || kind === "chain") return kind;
+		}
+		/**
+		* The registrations this plugin should make for the model-label seat.
+		*
+		* `keyed` yields ONE seat per provider id: each is its own cell, each renders
+		* only the rows whose owner props carry that provider id, and a provider this
+		* plugin does not own falls through to the owner's own fallback (the catalog
+		* name, plus that model's `badge` on hosts that have one).
+		*
+		* Every other kind — including `undefined`, i.e. a host that cannot be
+		* inspected — yields the single historical seat. That is not a degraded mode:
+		* it is what `single` requires, and on a not-yet-declared slot it is what the
+		* inject callback is about to find.
+		*
+		* An empty provider list under `keyed` would silently disable the label, so it
+		* falls back to the single seat instead: a wrong-shaped registration that still
+		* draws something beats a correct-shaped registration that draws nothing.
+		*
+		* @param params - Slot key, declared kind, this plugin's provider ids, priority.
+		* @returns One or more `register()` option objects, in registration order.
+		*/
+		function modelLabelSeats(params) {
+			const { name, kind, providerIds, priority } = params;
+			if (kind === "list" || kind === "chain") return [];
+			if (kind === "keyed" && providerIds.length > 0) return providerIds.map((id) => ({
+				name,
+				key: id,
+				priority
+			}));
+			return [{
+				name,
+				priority
+			}];
+		}
+		/**
+		* Claim every planned seat, atomically, and hand back ONE disposer.
+		*
+		* WHY ATOMIC. The seat list is 2-3 entries on a `keyed` host, and `register()`
+		* can throw on any ONE of them — a rival plugin claiming the same provider id at
+		* the same priority, or the declaration collapsing mid-loop. A plain `.map()`
+		* would then leave the earlier seats landed on the ledger with their disposers
+		* unreachable (they were only ever held by the array that the throw discarded),
+		* which is worse than failing outright: the component stays mounted, the caller
+		* believes registration failed, and nothing will ever release those cells. On a
+		* `single` host it also means the identity keeps a live entry that the next
+		* `inject` re-run cannot displace without a priority clash.
+		*
+		* So a partial failure is rolled back in reverse order before the error is
+		* rethrown, exactly as if it had never been attempted. The rethrow is important:
+		* each caller already has a catch that logs, and swallowing here would hide the
+		* refusal from the diagnostics that exist to explain it.
+		*
+		* A disposal that itself throws must not mask the original error, hence the
+		* inner catch — the registry treats a second dispose as a no-op, and a broken
+		* one must not turn one failure into a crash.
+		*
+		* @param seats - The plan from {@link modelLabelSeats}, in registration order.
+		* @param register - Claims one seat and returns its disposer.
+		* @returns One disposer that releases every seat, in reverse registration order.
+		*/
+		function registerModelLabelSeats(seats, register) {
+			const claimed = [];
+			try {
+				for (const seat of seats) claimed.push(register(seat));
+			} catch (error) {
+				for (const dispose of [...claimed].reverse()) try {
+					dispose();
+				} catch {}
+				throw error;
+			}
+			return () => {
+				for (const dispose of [...claimed].reverse()) try {
+					dispose();
+				} catch {}
+			};
+		}
+		//#endregion
 		//#region src/client/index.tsx
 		/** Stable browser-plugin name. */
 		const name = "dsh-connect-trae-client";
@@ -10009,10 +10213,19 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 		* the same priority. That refusal is OUR fault and we can fix it rather than
 		* report it, so each run releases whatever this identity already holds.
 		*
+		* ONE DISPOSER PER CALL, HOWEVER MANY ENTRIES IT OWNS. A `keyed` host makes this
+		* plugin claim one cell per provider id (see `./model-label-seat.ts`), and those
+		* cells must live and die together — a partial teardown would leave a cell
+		* occupied by a component whose siblings are gone, visible as some rows
+		* decorated and others not. Folding them into one disposer is
+		* `registerModelLabelSeats`'s job, so the contract here stays the simple one:
+		* whatever `register` returns is the whole ownership of this identity, and
+		* `SlotHold` keeps exactly one.
+		*
 		* @param ctx - The applying plugin's context (module scope has none).
 		* @param identity - Stable key for this seat.
 		* @param slotKey - The host slot to register into.
-		* @param register - Performs the registration, returning its disposer.
+		* @param register - Performs the registration(s), returning ONE disposer for all.
 		* @param describe - Names the seat in the failure log.
 		*/
 		function registerSlotEntry(ctx, identity, slotKey, register, describe) {
@@ -10277,16 +10490,31 @@ ${u} ${p}-pool .sw input:checked+.sw-track::after{transform:translateX(16px)}
 				* non-interactive inline content such as a coloured name or badge" while the
 				* picker keeps owning clicks, focus and check marks.
 				*
+				* HOW MANY SEATS, AND WHY THAT IS READ AT MOUNT. On a `single` host this slot
+				* holds ONE cell: a second registration at the same priority throws, a second
+				* registration at any other priority is silently discarded, and whoever holds
+				* the cell must draw EVERY provider's rows. On a `keyed` host each
+				* `options.key` is its own cell, so one seat per provider id gives this
+				* plugin exactly its own rows and leaves every other provider to the owner's
+				* own fallback. Which shape is legal is the HOST's declaration, so the kind
+				* is read from `ctx.slots.spec(...)` at mount and the seat list is derived
+				* from it (`./model-label-seat.ts`). One build serves both lines.
+				*
 				* Registered unconditionally: the component renders the plain name for a
 				* provider that is not ours, so there is nothing to gate on. Its own
 				* try/catch keeps a host that does not serve this slot from taking the card
 				* down with it.
 				*/
 				const registerModelLabel = () => {
-					registerSlotEntry(ctx, "conversation.input.model.label", "conversation.input.model.label", () => ctx.slots.register({
-						name: "conversation.input.model.label",
-						priority: MODEL_LABEL_PRIORITY
-					}, TraeModelLabel), "model label slot");
+					registerSlotEntry(ctx, "conversation.input.model.label", "conversation.input.model.label", () => {
+						const registry = ctx.slots;
+						return registerModelLabelSeats(modelLabelSeats({
+							name: "conversation.input.model.label",
+							kind: declaredSlotKind(ctx.slots, "conversation.input.model.label"),
+							providerIds: TRAE_MODEL_LABEL_PROVIDERS,
+							priority: MODEL_LABEL_PRIORITY
+						}), (seat) => registry.register(seat, TraeModelLabel));
+					}, "model label slot");
 				};
 				registerModelLabel();
 				/**

package/lib/index.d.ts

@@ -3408,6 +3408,69 @@ declare class TraeGatedUpstreamClient implements TraeUpstreamClient {
   chatStream(bodyJson: string, signal?: AbortSignal): Promise<TraeChatResult>;
 }
 //#endregion
+//#region src/model-badge.d.ts
+/**
+ * Emphasis of a selector badge, spelled out locally.
+ *
+ * Deliberately NOT imported from `@deepseek-ai/dsh-llm`: `LlmModelBadge` does
+ * not exist on 0.1.x, so importing it would make this file uncompilable on the
+ * host range the plugin still declares. The four literals below are the host's
+ * complete vocabulary, and {@link TRAE_BADGE_TONES} is what the test checks
+ * them against.
+ */
+type TraeBadgeTone = 'neutral' | 'info' | 'success' | 'warning';
+/** Every tone the host understands; the test asserts this list is complete. */
+declare const TRAE_BADGE_TONES: readonly TraeBadgeTone[];
+/**
+ * One selector badge.
+ *
+ * `text` is a translation table rather than a literal so the capsule reads in
+ * the reader's language. `en` is REQUIRED (the host falls back to it for any
+ * language it cannot find) and both keys are lowercase language ids, matching
+ * the host's `localeKey()` lookup.
+ */
+interface TraeModelBadge {
+  text: {
+    readonly en: string;
+    readonly zh: string;
+  };
+  tone: TraeBadgeTone;
+}
+/**
+ * The badge one catalog row should carry, or `undefined` for none.
+ *
+ * WHY THE PROMOTION, AND NOT THE PRICE. A badge is the ONE thing a sibling can
+ * draw on this plugin's behalf, so it has to be the thing a user would act on.
+ * "This model is 50% off right now" changes the choice; a price that has been
+ * identical for months does not.
+ *
+ * WHY THE CLOCK IS READ HERE. `activityDiscount` rides along UNRESOLVED on the
+ * model entry precisely so the judgement happens where the row is drawn
+ * (`src/promo.ts` explains why freezing it at parse time would leave a night-time
+ * discount hanging there the next morning). `listModels()` IS that moment on the
+ * host side — it runs when the host builds the catalog — and the plugin asks the
+ * host to re-read the catalog via `llm/models-updated` whenever the card's own
+ * clock crosses a window boundary. So this is not "catalog data that ignores the
+ * clock"; it is a clock judgement made at each catalog rebuild.
+ *
+ * A NOTE ON WHAT WAS TRIED FIRST AND REJECTED. An earlier version advertised
+ * `creditMultiplier === 0` as "免费"/"Free". It never fired: every path that
+ * parses upstream's `consumption_rate` runs it through `finitePositive`
+ * (`src/solo.ts`, `src/model-metadata.ts`), which requires `> 0`, so a rate of
+ * `0` arrives as `undefined`. A multiplier of exactly `0` can only come from a
+ * saved `lastCatalog`, never from the live directory. Do not reintroduce a
+ * price-derived badge from that field.
+ *
+ * @param model - the catalog row about to be advertised.
+ * @param now - the clock the promotion is judged against. Passed in rather than
+ *        read from `Date.now()` so the caller owns the "one clock for the whole
+ *        catalog" decision and the tests can move time.
+ * @returns the badge, or `undefined` — never `null`. A `null` makes the host
+ *          registry throw inside `listModels`, which drops this provider's
+ *          ENTIRE catalog into `failures`, not just the decorated row.
+ */
+declare function traeModelBadge(model: Pick<TraeModelInfo, 'activityDiscount'>, now: Date): TraeModelBadge | undefined;
+//#endregion
 //#region src/refresh.d.ts
 /**
  * Stable device identity for the DeviceInfo body, sourced from the app's own
@@ -4867,4 +4930,4 @@ declare function asVolatile<S>(schema: S): S;
 declare const Config: z<Config>;
 declare function apply(ctx: Context$1, config: Config): void;
 //#endregion
-export { Config, FALLBACK_CONTEXT_WINDOW, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, MAX_PROBE_INPUT_TOKENS, type PiAiGeneration, type PiAiRuntimeInfo, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_ACCOUNT_STATUS_PATH, TRAE_AI_PROVIDER, TRAE_CHANNEL_PRIORITY, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_COMMON_FUNCTIONS, TRAE_ENTERPRISE_PROVIDER, TRAE_MODELS_TEST_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_OFFICIAL_ROSTER_PATH, TRAE_PANELS, TRAE_PAY_BASE, TRAE_PROBE_TIMEOUT_MS, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_PROVIDER_IDS, TRAE_PROVIDER_ID_DISPLAY_NAMES, TRAE_PROVIDER_ROUTES, 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, type TraeFailure, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelGroup, type TraeModelInfo, type TraeModelProbeVerdict, type TraeModelView, type TraeModelsTestResponse, type TraeObservedModelConfig, type TraeOfficialChannel, type TraeOfficialFilterResult, type TraeOfficialRoster, TraeOfficialRosterClient, type TraeOfficialVerdict, type TraeOrderableModel, type TraePanel, type TraeProbeResult, type TraeProbeVerdict, type TraeProviderRoute, 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 TraeWebAccountState, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, type TraeWireTarget, UnconfiguredTraeUpstreamClient, adaptLegacyPiAiContext, adaptModernPiAiContext, apply, applyContextBudgets, applyImageSelection, applyOfficialRoster, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyProbeError, classifyProbeResult, classifyTraeRawChatFailure, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, creditPosition, decidePiAiGeneration, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, describeTraeFailure, discoveredCatalog, displayNameOfTraeProvider, fallbackModelsFor, filterTraeModels, generationOf, groupTraeModels, hashTraeRawChatArg, identityHeaders, inject, isEnterpriseAccount, isPromotableWireModel, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionCreditPosition, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeToolSchema, normalizeTraeToolSchemas, normalizeTraeVersionCode, officialVerdictOf, orderTraeModels, panelOfKey, panelOfProvider, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeOfficialRoster, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, piAiRuntimeInfo, pickTraeStorageIdentity, prepareSoloBody, probeBody, probeModelsSequentially, probeOneModel, probeTraeRawChatCapability, providerOfPanel, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionCreditPositionOf, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfPanel, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, routeOfTraeProvider, sanitizeCatalog, scopeTraeModels, servedContextWindow, settingsNamespaceOf, sidebarPanelEnabled, thinkingEffortsOf, traeEndpoint, traeInputModalities, traeModelCallChannel, traeModelDisplayName, traeModelInView, traeModelMatchesQuery, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, wireTargetsOf, withChatCallableFunctions, withContextAdaptation, withTraeRegion };
+export { Config, FALLBACK_CONTEXT_WINDOW, FALLBACK_TRAE_MODELS, FALLBACK_TRAE_MODELS_AI, MAX_PROBE_INPUT_TOKENS, type PiAiGeneration, type PiAiRuntimeInfo, REGION_GATEWAYS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_ACCOUNT_STATUS_PATH, TRAE_AI_PROVIDER, TRAE_BADGE_TONES, TRAE_CHANNEL_PRIORITY, TRAE_CHECKIN_PATH, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_COMMON_FUNCTIONS, TRAE_ENTERPRISE_PROVIDER, TRAE_MODELS_TEST_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_OFFICIAL_ROSTER_PATH, TRAE_PANELS, TRAE_PAY_BASE, TRAE_PROBE_TIMEOUT_MS, TRAE_PROVIDER, TRAE_PROVIDERS, TRAE_PROVIDER_DISPLAY_NAMES, TRAE_PROVIDER_IDS, TRAE_PROVIDER_ID_DISPLAY_NAMES, TRAE_PROVIDER_ROUTES, 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 TraeBadgeTone, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinClaim, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, type TraeFailure, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelBadge, type TraeModelDetailRequest, type TraeModelGroup, type TraeModelInfo, type TraeModelProbeVerdict, type TraeModelView, type TraeModelsTestResponse, type TraeObservedModelConfig, type TraeOfficialChannel, type TraeOfficialFilterResult, type TraeOfficialRoster, TraeOfficialRosterClient, type TraeOfficialVerdict, type TraeOrderableModel, type TraePanel, type TraeProbeResult, type TraeProbeVerdict, type TraeProviderRoute, 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 TraeWebAccountState, type TraeWebActivity, type TraeWebCheckin, type TraeWebCheckinClaim, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, type TraeWireTarget, UnconfiguredTraeUpstreamClient, adaptLegacyPiAiContext, adaptModernPiAiContext, apply, applyContextBudgets, applyImageSelection, applyOfficialRoster, applyReasoningEffort, asVolatile, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyProbeError, classifyProbeResult, classifyTraeRawChatFailure, configuredAccountsOf, createTraeAdapter, createTraeRawGateway, createTraeShim, creditPosition, decidePiAiGeneration, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, describeIdShape, describeNameShape, describeTraeFailure, discoveredCatalog, displayNameOfTraeProvider, fallbackModelsFor, filterTraeModels, generationOf, groupTraeModels, hashTraeRawChatArg, identityHeaders, inject, isEnterpriseAccount, isPromotableWireModel, legacyTraeOwnAuthPath, maskUserPath, mergeTraeModelSources, name, nextRegionCreditPosition, nextRegionEnabled, nextRegionSlots, normalizeTraeCredential, normalizeTraeToolSchema, normalizeTraeToolSchemas, normalizeTraeVersionCode, officialVerdictOf, orderTraeModels, panelOfKey, panelOfProvider, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeOfficialRoster, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, piAiRuntimeInfo, pickTraeStorageIdentity, prepareSoloBody, probeBody, probeModelsSequentially, probeOneModel, probeTraeRawChatCapability, providerOfPanel, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeCliIdentity, readTraeIdentity, refreshTraeCredential, regionCreditPositionOf, regionEnabled, regionEnabledOf, regionOfCredential, regionOfEdition, regionOfHost, regionOfPanel, regionOfTraeProvider, regionOfTraeStatusUrl, regionOfUserRegion, regionStateOf, registerTraeUsageRoute, resolveTraeIdentity, resolveTraeRawRuntime, routeOfTraeProvider, sanitizeCatalog, scopeTraeModels, servedContextWindow, settingsNamespaceOf, sidebarPanelEnabled, thinkingEffortsOf, traeEndpoint, traeInputModalities, traeModelBadge, traeModelCallChannel, traeModelDisplayName, traeModelInView, traeModelMatchesQuery, traeOwnAuthPath, traeRawChatExtraInfo, traeStateDatabaseCandidates, traeStorageCandidates, traeWebUsage, traeWindowsAppNames, unwrapVolatile, unwrapVolatileDeep, wireTargetsOf, withChatCallableFunctions, withContextAdaptation, withTraeRegion };