dsh-subscriptions 0.1.1 → 0.1.3

package/README.md

@@ -1,4 +1,7 @@
-# DSH Subscription Hub
+# DSH Subscriptions
+
+[![npm version](https://img.shields.io/npm/v/dsh-subscriptions)](https://www.npmjs.com/package/dsh-subscriptions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 Bring your AI subscriptions into
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). One
@@ -23,12 +26,86 @@ reported quota in **Settings → Subscriptions**.
   image generation and editing, and Grok video generation when the matching
   provider is enabled.
 
+## Screenshots
+
+Captured against DSH 0.2.0-rc.2 in the web UI with a local stub serving
+frozen provider responses, so each image shows a product state rather than
+a real account. Identities in the images are fabricated, and the quota
+percentages, catalogs, and reset countdowns are sample data.
+
+### Subscriptions
+
+Per-provider quota windows, account controls, and the status-bar display
+preference live in **Settings → Subscriptions**.
+
+![Subscriptions settings page](docs/images/subscriptions.png)
+
+### Model selection
+
+Logged-in providers join the session model picker with their live catalogs.
+
+![Model picker with subscription models](docs/images/model-picker.png)
+
+Models that advertise reasoning levels get an **Effort** selector in the
+same menu. Levels and defaults come from the provider's live catalog;
+without discovery Codex falls back to a built-in list, and a configured
+default overrides either.
+
+![Reasoning effort selector](docs/images/model-effort.png)
+
+Codex models whose catalog advertises the fast tier get a **Speed** toggle
+in the composer's tool row: Standard or Fast, per session.
+
+![Speed toggle with the Standard/Fast menu open](docs/images/speed-toggle.png)
+
+**Settings → Subscriptions → provider → Manage** edits account aliases,
+pool participation, model allowlists, and the per-model effort, context,
+and tool settings.
+
+![Model settings](docs/images/model-settings.png)
+
+![Provider tools](docs/images/provider-tools.png)
+
+### Quota while you work
+
+The composer's stats row gains a **provider usage** pill showing the
+used percentage and reset window for the provider of the session's current
+model. It shows at most one provider; switching to a non-subscription model
+keeps the most recent subscription selected in the mounted conversation
+view, or stays hidden if there is none. **Always show** instead rotates
+through the providers that report usage every 10 seconds while the current
+model has no quota source, so the pill never disappears.
+
+![Provider usage pill in the stats row](docs/images/usage-pill.png)
+
+Click the pill to expand every provider and account that reports usage —
+the default account is starred, and the current provider is listed first.
+A provider with no usage endpoint, such as GitHub Copilot, has no row, and
+neither do accounts without a usage window. Antigravity previews only the
+current model's windows; the other model windows stay in a closed
+disclosure.
+
+Quota bars include a dark elapsed-time cursor whenever the provider's
+timing places the window in time, including at 0% used and for stale or old
+readings. Compare the colored fill (quota used) with the cursor (time
+elapsed); hover for the percentages and reset countdown. Standard coloring
+turns the fill orange when a fresh reading leads elapsed time by 10 points,
+and Relaxed uses 15; 90% used turns it red and takes priority. Windows
+without known timing omit the cursor, and a stale or old reading keeps its
+cursor without a pace warning. Choose Standard, Relaxed, or Remaining colors
+in **Settings → Subscriptions**.
+
+![Usage dialog with elapsed-time cursors](docs/images/usage-badge.png)
+
 ## Install
 
 Current source is tested with DSH `0.1.7-rc.2`, `0.2.0-rc.1`, and
 `0.2.0-rc.2`. The package's peers admit `>=0.1.7-rc.2 <0.3.0-0`: untested
-versions inside that range install but are unsupported, and versions outside
-it need an explicit `dsh plugin allow-version` exemption. See
+versions inside that range install but are unsupported, and versions
+outside it need an explicit `dsh plugin allow-version` exemption.
+`dsh plugin add` checks those ranges with `includePrerelease` semantics, so
+the admitted set covers every host build from `0.1.7-rc.2` through the
+whole `0.2.x` line, prereleases included, and blocks the `0.3.0` line. See
 [docs/compatibility.md](docs/compatibility.md)
 for the support window and [docs/testing.md](docs/testing.md) for the test
 layers. With `dsh` available, install the plugin into the web profile from
@@ -74,7 +151,7 @@ spec (`#vX.Y.Z`); see the
 
 ## Verification and limits
 
-CI builds, tests, and boots a packed tarball on both supported DSH versions;
+CI builds, tests, and boots a packed tarball on all supported DSH versions;
 it does not run the GitHub source install's `prepare` step. Offline
 provider tests check recorded API responses, so a passing CI run cannot prove
 that a provider still accepts live sign-in or model requests. See
@@ -106,6 +183,40 @@ usage.
 The plugin follows DSH network settings. Its former proxy configuration and
 UI have been retired; an old plugin proxy config file is ignored.
 
+## Usage coloring
+
+**Settings → Subscriptions → Usage coloring** offers one browser-local dropdown:
+
+- **Standard** (default): yellow when used quota leads elapsed time by at least 10 percentage points.
+- **Relaxed**: yellow at a lead of at least 15 points.
+- **Remaining quota only**: no yellow pace warnings.
+
+Every preset shows reported usage of 90% or more in red, before considering pace. For example, 40% used after 25% of a window is a 15-point lead, not a consumption forecast. Preferences apply to all meters, survive reloads and synchronize across tabs of the same origin. They change display only, never account routing or quota enforcement.
+
+A vertical marker shows elapsed time only for an explicit valid start/end interval or a provider-verified fixed duration. A session/weekly label alone does not establish a fixed window; rolling or unknown intervals have no marker. Claude's recognized five-hour/seven-day buckets and Codex's reported quota durations supply fixed-window metadata. Unknown timing falls back to green below 90%, without a marker or yellow warning.
+
+The marker depends on the window's timing alone, not on the reading: it stays at 0% used, for an invalid percentage, and when a refresh failed or the reading is more than five minutes old. Such a reading is not set against the current time, so it gets no yellow pace warning and its tooltip omits the ahead/behind comparison. It retains the last reported green/red color with an accessible stale label; refresh to confirm it. Once the reset time has passed the window has no position and the marker disappears. Invalid percentages show an unavailable state without a fabricated fill. Tooltips explain remaining quota, time progress and reset countdown where available. See the [decision record](.agents/notes/implemented/architecture/2026-10-01-usage-pace-colors.md) and the [cursor note](.agents/notes/implemented/architecture/2026-10-06-usage-cursor-timing-only.md) for rationale and verification limits.
+
+### MiniMax subscription usage
+
+Configure `MINIMAX_API_KEY` for the global service or
+`MINIMAX_CN_API_KEY` for China, using DSH's standard model-key configuration.
+The plugin reuses those credential references; no separate subscription ref is
+required. Quota reads require subscription keys, not `sk-api-*` pay-as-you-go keys. The plugin reads the
+region's `/v1/token_plan/remains` endpoint and displays finite per-model quotas
+with API-provided start/end times. It does not add model routing or OAuth login.
+Rows are labelled with the model name, and the plugin shows the windows the API
+returns for each model. MiniMax documents a five-hour and a weekly window for
+non-video models and only a weekly one for video. Standard (non-video) models
+on time-based plans report an explicit remaining percentage beside zero counts,
+and that percentage is enough for a row. Unlimited, boosted-above-100% and
+unsupported quotas are omitted (a status-3 row also covers a model the plan
+does not include); if none remain, the card reports unavailable rather than
+inventing a percentage. Explicit remaining percentages take priority; older
+responses follow the official CLI's remaining-count compatibility convention. No
+live-account response was used in verification, so a missing model may still
+come from the account or the plan rather than from this plugin.
+
 ## Development
 
 ```sh

package/icon.svg

@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="256" y2="256" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#2f6df6"/>
+      <stop offset="1" stop-color="#0bb6a8"/>
+    </linearGradient>
+  </defs>
+  <rect width="256" height="256" rx="58" fill="url(#bg)"/>
+  <g stroke="#ffffff" stroke-opacity="0.65" stroke-width="7" stroke-linecap="round">
+    <line x1="128" y1="128" x2="54" y2="64"/>
+    <line x1="128" y1="128" x2="202" y2="64"/>
+    <line x1="128" y1="128" x2="42" y2="150"/>
+    <line x1="128" y1="128" x2="214" y2="150"/>
+    <line x1="128" y1="128" x2="78" y2="208"/>
+    <line x1="128" y1="128" x2="178" y2="208"/>
+  </g>
+  <g fill="#ffffff">
+    <circle cx="54" cy="64" r="17"/>
+    <circle cx="202" cy="64" r="17"/>
+    <circle cx="42" cy="150" r="17"/>
+    <circle cx="214" cy="150" r="17"/>
+    <circle cx="78" cy="208" r="17"/>
+    <circle cx="178" cy="208" r="17"/>
+  </g>
+  <circle cx="128" cy="128" r="37" fill="#ffffff"/>
+  <circle cx="128" cy="128" r="37" fill="none" stroke="#0b3b5e" stroke-opacity="0.18" stroke-width="3"/>
+  <circle cx="128" cy="128" r="15" fill="#0e7490"/>
+</svg>

package/lib/client/CursorCard.js

@@ -4,20 +4,17 @@ import { callSubscriptionsAuth } from './subscriptions-rpc.js';
 import { ProviderAccountManager } from './ProviderAccountManager.js';
 import { USAGE_BADGE_REFRESH_EVENT } from './usage-badge-preferences.js';
 import { subscriptionCardStyles as styles } from './subscription-card-styles.js';
+import { UsageMeter } from './UsageMeter.js';
+import { displayUsedPercent } from './usage-pace.js';
 function message(error) {
     return error instanceof Error ? error.message : String(error);
 }
-function barColor(percent) {
-    if (percent >= 95)
-        return 'var(--dsw-alias-state-error-primary)';
-    if (percent >= 80)
-        return 'var(--dsw-alias-state-warn-label)';
-    return 'var(--dsw-alias-state-success-primary)';
-}
 /** Cursor's single connected account, rendered with the same card and Manage dialog as the other providers. */
 export function CursorCard({ rpc, t }) {
     const [status, setStatus] = useState();
     const [usage, setUsage] = useState();
+    const [observedAt, setObservedAt] = useState();
+    const [usageStale, setUsageStale] = useState(false);
     const [authorizeUrl, setAuthorizeUrl] = useState();
     const [error, setError] = useState();
     const [loading, setLoading] = useState(false);
@@ -43,12 +40,17 @@ export function CursorCard({ rpc, t }) {
     const refreshUsage = useCallback(async () => {
         setLoading(true);
         try {
-            setUsage(await callSubscriptionsAuth(rpc, 'cursorUsage', {}));
+            const value = await callSubscriptionsAuth(rpc, 'cursorUsage', {});
+            setUsage(value);
+            // Prefer the server's observation time; a cached reading must not look fresh.
+            setObservedAt(value.observedAt ?? Date.now());
+            setUsageStale(value.stale === true);
             setError(undefined);
             window.dispatchEvent(new Event(USAGE_BADGE_REFRESH_EVENT));
         }
         catch (failure) {
             setError(message(failure));
+            setUsageStale(true);
         }
         finally {
             setLoading(false);
@@ -91,6 +93,8 @@ export function CursorCard({ rpc, t }) {
         try {
             await callSubscriptionsAuth(rpc, 'cursorLogout', {});
             setUsage(undefined);
+            setObservedAt(undefined);
+            setUsageStale(false);
             await refreshStatus();
         }
         catch (failure) {
@@ -101,13 +105,13 @@ export function CursorCard({ rpc, t }) {
     return _jsxs("div", { style: styles.card, children: [_jsxs("div", { style: styles.header, children: [_jsx("span", { style: { ...styles.dot, background: status?.busy ? 'var(--dsw-alias-state-warn-label)'
                                 : connected ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-dimmed)' } }), _jsx("span", { style: styles.name, children: t('cursorTitle') })] }), _jsx("p", { style: styles.status, children: status === undefined ? t('checking') : status.busy ? t('loginInProgress')
                     : connected ? t('loggedInCount', { count: 1 }) : t('notLoggedIn') }), error !== undefined && _jsx("p", { style: styles.error, children: error }), connected && _jsxs("div", { style: styles.account, children: [_jsxs("div", { style: styles.accountHeader, children: [_jsx("span", { style: styles.defaultStar, title: t('defaultBadge'), children: "\u2605" }), _jsx("span", { style: styles.accountName, children: "Cursor" }), status.expiresAt !== undefined && _jsx("span", { style: styles.status, children: t('accountExpires', { date: new Date(status.expiresAt).toLocaleString() }) }), _jsx("button", { type: "button", style: { ...styles.button, marginLeft: 'auto', flexShrink: 0 }, onClick: () => { void logout(); }, children: t('logout') })] }), _jsxs("div", { style: styles.usage, children: [_jsxs("div", { style: styles.usageHeader, children: [_jsx("span", { style: styles.usageTitle, children: t('usageTitle') }), usage?.plan !== undefined && _jsx("span", { style: styles.status, children: t('usagePlan', { plan: usage.plan }) }), _jsx("button", { type: "button", style: styles.usageRefresh, disabled: loading, onClick: () => { void refreshUsage(); }, children: t('usageRefresh') })] }), loading && usage === undefined && _jsx("p", { style: styles.status, children: t('usageLoading') }), usage?.windows?.length === 0 && _jsx("p", { style: styles.status, children: t('usageEmpty') }), usage?.windows?.map((window, index) => {
-                                const percent = Math.min(100, Math.max(0, window.usedPercent));
+                                const percent = displayUsedPercent(window.usedPercent);
                                 const label = window.scope === 'Included' ? t('cursorIncluded')
                                     : window.scope === 'Cursor Models' ? t('cursorModels')
                                         : window.scope === 'Other Models' ? t('cursorOtherModels')
                                             : window.scope === 'Included requests' ? t('cursorIncludedRequests')
                                                 : window.scope ?? t('usageWindow');
-                                return _jsxs("div", { style: styles.usageRow, children: [_jsxs("div", { style: styles.usageMeta, children: [_jsx("span", { children: label }), _jsxs("span", { children: [Math.round(percent), "%", window.resetsAt === undefined ? ''
-                                                            : ` · ${t('usageResets', { date: new Date(window.resetsAt).toLocaleString() })}`] })] }), _jsx("div", { style: styles.usageTrack, children: _jsx("div", { style: { width: `${percent}%`, height: '100%', borderRadius: 3, background: barColor(percent) } }) })] }, index);
+                                return _jsxs("div", { style: styles.usageRow, children: [_jsxs("div", { style: styles.usageMeta, children: [_jsx("span", { children: label }), _jsxs("span", { children: [percent === undefined ? t('usageMeterInvalid') : `${percent}%`, window.resetsAt === undefined ? ''
+                                                            : ` · ${t('usageResets', { date: new Date(window.resetsAt).toLocaleString() })}`] })] }), _jsx(UsageMeter, { window: window, t: t, observedAt: observedAt, stale: usageStale })] }, index);
                             })] })] }), _jsxs("div", { style: styles.actions, children: [status?.authenticated === false && !status.busy && _jsx("button", { type: "button", style: styles.button, onClick: () => { void login(); }, children: t('login') }), _jsx("button", { type: "button", style: styles.button, "aria-haspopup": "dialog", onClick: () => setManage(true), children: t('accountsManage') }), status?.busy === true && _jsx("button", { type: "button", style: styles.button, onClick: () => { void cancel(); }, children: t('cancel') })] }), status?.busy === true && authorizeUrl !== undefined && _jsx("a", { href: authorizeUrl, target: "_blank", rel: "noopener noreferrer", children: t('cursorOpenLogin') }), manage && _jsx(ProviderAccountManager, { provider: "cursor-subscription", name: "Cursor", rpc: rpc, t: t, onClose: () => setManage(false) })] });
 }

package/lib/client/ExternalUsageCards.d.ts

@@ -1,6 +1,16 @@
 import type { ConnectionHandle } from '@deepseek-ai/dsh-api-remotes/client';
-import type { SubscriptionsSectionInjected } from './SubscriptionsSection.js';
+import type { SubscriptionsSectionInjected, UsageWindow } from './SubscriptionsSection.js';
 type Translate = SubscriptionsSectionInjected['t'];
+/**
+ * Row label of one window on an external usage card. A session or weekly
+ * window appends the model it belongs to when the provider names one (MiniMax
+ * reports a window per model), so two models' weekly rows stay distinguishable.
+ * The monthly pool is a scope on an `other` window, not a model.
+ * @param t - section translate.
+ * @param window - the reported window.
+ * @returns the localized label, e.g. "Weekly · general".
+ */
+export declare function externalUsageWindowLabel(t: Translate, window: UsageWindow): string;
 /** Quota cards for API-key providers already available through DSH itself. */
 export declare function ExternalUsageCards({ rpc, t }: {
     rpc: ConnectionHandle['rpc'];

package/lib/client/ExternalUsageCards.js

@@ -3,33 +3,50 @@ import { useCallback, useEffect, useState } from 'react';
 import { callSubscriptionsAuth } from './subscriptions-rpc.js';
 import { subscriptionCardStyles as styles } from './subscription-card-styles.js';
 import { USAGE_BADGE_REFRESH_EVENT } from './usage-badge-preferences.js';
+import { UsageMeter } from './UsageMeter.js';
+import { displayUsedPercent } from './usage-pace.js';
 const SOURCES = [
     { id: 'opencode-go', name: 'OpenCode Go', ref: 'OPENCODE_GO_API_KEY' },
     { id: 'kimi-code', name: 'Kimi Code', ref: 'KIMI_CODING_API_KEY' },
+    { id: 'minimax', name: 'MiniMax', ref: 'MINIMAX_API_KEY' },
+    { id: 'minimax-cn', name: 'MiniMax CN', ref: 'MINIMAX_CN_API_KEY' },
 ];
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }
-function barColor(percent) {
-    if (percent >= 95)
-        return 'var(--dsw-alias-state-error-primary)';
-    if (percent >= 80)
-        return 'var(--dsw-alias-state-warn-label)';
-    return 'var(--dsw-alias-state-success-primary)';
+/**
+ * Row label of one window on an external usage card. A session or weekly
+ * window appends the model it belongs to when the provider names one (MiniMax
+ * reports a window per model), so two models' weekly rows stay distinguishable.
+ * The monthly pool is a scope on an `other` window, not a model.
+ * @param t - section translate.
+ * @param window - the reported window.
+ * @returns the localized label, e.g. "Weekly · general".
+ */
+export function externalUsageWindowLabel(t, window) {
+    const named = window.scope !== undefined && window.scope !== '';
+    if (window.kind === 'other') {
+        return window.scope === 'Monthly' ? t('usageMonthly') : named ? window.scope : t('usageWindow');
+    }
+    const base = window.kind === 'session' ? t('usageSession') : t('usageWeekly');
+    return named ? `${base} · ${window.scope}` : base;
 }
 /** Quota cards for API-key providers already available through DSH itself. */
 export function ExternalUsageCards({ rpc, t }) {
     const [status, setStatus] = useState();
     const [statusError, setStatusError] = useState();
     const [usage, setUsage] = useState({});
+    const [observedAt, setObservedAt] = useState({});
     const [errors, setErrors] = useState({});
     const [loading, setLoading] = useState({});
     const refresh = useCallback(async (source) => {
         setLoading(prev => ({ ...prev, [source]: true }));
-        setErrors(prev => ({ ...prev, [source]: undefined }));
         try {
             const value = await callSubscriptionsAuth(rpc, 'externalUsage', { source });
             setUsage(prev => ({ ...prev, [source]: value }));
+            // Prefer the server's observation time; a cached reading must not look fresh.
+            setObservedAt(prev => ({ ...prev, [source]: value.observedAt ?? Date.now() }));
+            setErrors(prev => ({ ...prev, [source]: undefined }));
             window.dispatchEvent(new Event(USAGE_BADGE_REFRESH_EVENT));
         }
         catch (error) {
@@ -61,12 +78,10 @@ export function ExternalUsageCards({ rpc, t }) {
             return _jsxs("div", { style: styles.card, children: [_jsxs("div", { style: styles.header, children: [_jsx("span", { style: { ...styles.dot, background: configured
                                         ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-dimmed)' } }), _jsx("span", { style: styles.name, children: name })] }), !(status === undefined && statusError !== undefined) && _jsx("p", { style: styles.status, children: status === undefined ? t('checking')
                             : configured ? t('externalUsageConnected') : t('externalUsageNotConfigured') }), statusError !== undefined && _jsx("p", { style: styles.error, children: t('externalUsageUnavailable', { message: statusError }) }), status !== undefined && !configured && _jsx("p", { style: styles.status, children: t('externalUsageConfigure', { ref }) }), configured && _jsxs("div", { style: styles.account, children: [_jsxs("div", { style: styles.accountHeader, children: [_jsx("span", { style: styles.defaultStar, title: t('defaultBadge'), children: "\u2605" }), _jsx("span", { style: styles.accountName, children: t('externalUsageApiKey') })] }), _jsxs("div", { style: styles.usage, children: [_jsxs("div", { style: styles.usageHeader, children: [_jsx("span", { style: styles.usageTitle, children: t('usageTitle') }), snapshot?.plan !== undefined && _jsx("span", { style: styles.usagePlan, children: t('usagePlan', { plan: snapshot.plan }) }), _jsx("button", { type: "button", style: styles.usageRefresh, disabled: loading[id] === true, onClick: () => { void refresh(id); }, children: t('usageRefresh') })] }), loading[id] === true && snapshot === undefined && _jsx("p", { style: styles.status, children: t('usageLoading') }), errors[id] !== undefined && _jsx("p", { style: styles.error, children: t('usageError', { message: errors[id] }) }), snapshot?.windows?.length === 0 && _jsx("p", { style: styles.status, children: t('usageEmpty') }), snapshot?.windows?.map((window, index) => {
-                                        const percent = Math.min(100, Math.max(0, window.usedPercent));
-                                        const label = window.kind === 'session' ? t('usageSession')
-                                            : window.kind === 'weekly' ? t('usageWeekly')
-                                                : window.scope === 'Monthly' ? t('usageMonthly') : window.scope ?? t('usageWindow');
-                                        return _jsxs("div", { style: styles.usageRow, children: [_jsxs("div", { style: styles.usageMeta, children: [_jsx("span", { children: label }), _jsxs("span", { children: [Math.round(percent), "%", window.resetsAt === undefined ? ''
-                                                                    : ` · ${t('usageResets', { date: new Date(window.resetsAt).toLocaleString() })}`] })] }), _jsx("div", { style: styles.usageTrack, children: _jsx("div", { style: { ...styles.usageFill, width: `${percent}%`, background: barColor(percent) } }) })] }, index);
+                                        const percent = displayUsedPercent(window.usedPercent);
+                                        const label = externalUsageWindowLabel(t, window);
+                                        return _jsxs("div", { style: styles.usageRow, children: [_jsxs("div", { style: styles.usageMeta, children: [_jsx("span", { children: label }), _jsxs("span", { children: [percent === undefined ? t('usageMeterInvalid') : `${percent}%`, window.resetsAt === undefined ? ''
+                                                                    : ` · ${t('usageResets', { date: new Date(window.resetsAt).toLocaleString() })}`] })] }), _jsx(UsageMeter, { window: window, t: t, observedAt: observedAt[id], stale: errors[id] !== undefined || snapshot?.stale === true })] }, index);
                                     })] })] }), !configured && _jsx("div", { style: styles.actions, children: _jsx("button", { type: "button", style: styles.button, onClick: () => { void refreshStatus(); }, children: t('usageRefresh') }) })] }, id);
         }) });
 }

package/lib/client/SubscriptionUsageBadge.d.ts

@@ -20,7 +20,11 @@ export interface SubscriptionUsageBadgeInjected {
     } | undefined>;
 }
 /** Props delivered by the slot outlet + inject + the locale seat. */
-export type SubscriptionUsageBadgeProps = PropsRuntime<'conversation.composer.dock'> & Partial<SubscriptionUsageBadgeInjected> & Partial<PropsLocale<'settings.subscriptions'>>;
+export type SubscriptionUsageBadgeProps = PropsRuntime<'conversation.composer.dock'> & Partial<SubscriptionUsageBadgeInjected> & Partial<PropsLocale<'settings.subscriptions'>>
+/** Override the rotation cadence (tests only; the slot never passes it). */
+ & {
+    rotationMs?: number;
+};
 /** One logged-in account's usage windows, as listed in the expanded dialog. */
 export interface AccountUsageDisplay {
     /** Account key (the `usage` endpoint's `account` argument). */
@@ -31,6 +35,8 @@ export interface AccountUsageDisplay {
     /** The account direct routes serve; the collapsed pill reads this one. */
     isDefault: boolean;
     windows: UsageWindow[];
+    observedAt?: number | undefined;
+    stale?: boolean | undefined;
 }
 /** One provider's usage snapshot: every logged-in account that reports windows. */
 export interface ProviderUsageDisplay {
@@ -42,7 +48,7 @@ export interface ProviderUsageDisplay {
 /** The account the collapsed pill reads: the default one, else the first listed. */
 export declare function pillAccountOf(d: ProviderUsageDisplay): AccountUsageDisplay;
 /** Brand display names (short form for the compact badge). */
-export type BadgeProvider = SubscriptionProvider | 'cursor-subscription' | 'opencode-go' | 'kimi-coding';
+export type BadgeProvider = SubscriptionProvider | 'cursor-subscription' | 'opencode-go' | 'kimi-coding' | 'minimax' | 'minimax-cn';
 export interface UsageRosterEntry {
     provider: BadgeProvider;
     account: AccountStatus;
@@ -96,6 +102,19 @@ type ModelSelection = {
 export declare function retainSubscriptionSelection(previous: ModelSelection | undefined, current: ModelSelection | undefined): ModelSelection | undefined;
 /** At most one provider; no known selection or no usage means no badge. */
 export declare function collapsedDisplays(displays: readonly ProviderUsageDisplay[], current: string | undefined): readonly ProviderUsageDisplay[];
+/**
+ * `always` mode: the current model's provider while it reports usage,
+ * otherwise the rotation steps through the providers that do, in display
+ * order, wrapping around. The index is taken modulo the current provider
+ * count, so providers appearing or dropping out stay inside range; the
+ * sequence itself may shift when the roster changes. Unlike `recent`, the
+ * retained subscription does not pin the pill — that retention is exactly
+ * what this mode exists to escape.
+ * @param displays - providers with usage, in display order.
+ * @param current - the provider of the session's current model.
+ * @param step - rotation tick; consecutive ticks advance one provider.
+ */
+export declare function rotatingDisplay(displays: readonly ProviderUsageDisplay[], current: string | undefined, step: number): readonly ProviderUsageDisplay[];
 /** Order for the expanded dialog: the current provider first, the rest in poll order. */
 export declare function expandedDisplays(displays: readonly ProviderUsageDisplay[], current: string | undefined): readonly ProviderUsageDisplay[];
 type Translate = (key: SubscriptionsKey, params?: Record<string, unknown>) => string;
@@ -105,12 +124,14 @@ type Translate = (key: SubscriptionsKey, params?: Record<string, unknown>) => st
  * every provider's accounts and their windows. Returns null when no data is
  * available.
  */
-export declare function SubscriptionUsageBadge({ rpc, currentModel, t }: SubscriptionUsageBadgeProps): import("react").JSX.Element;
+export declare function SubscriptionUsageBadge({ rpc, currentModel, t, rotationMs }: SubscriptionUsageBadgeProps): import("react").JSX.Element;
 /** Preview each account independently; all remaining quotas stay accessible. */
-export declare function AccountWindows({ windows, model, provider, translate }: {
+export declare function AccountWindows({ windows, model, provider, translate, observedAt, stale }: {
     windows: readonly UsageWindow[];
     model: string | undefined;
     provider?: BadgeProvider;
     translate: Translate;
+    observedAt?: number | undefined;
+    stale?: boolean | undefined;
 }): import("react").JSX.Element;
 export {};