codex-multi-auth 2.18.0 → 2.19.1

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-multi-auth",
-	"version": "2.18.0",
+	"version": "2.19.1",
   "description": "Install and operate codex-multi-auth for the official @openai/codex CLI with multi-account OAuth rotation, switching, health checks, and recovery tools.",
   "interface": {
     "composerIcon": "./assets/codex-multi-auth-icon.svg"

package/README.md

@@ -33,7 +33,7 @@ Using OpenCode rather than the Codex CLI? The sibling project [`oc-codex-multi-a
 
 ## Install
 
-Requirements: Node.js >= 18.17, and the official Codex CLI on `PATH` (`npm i -g @openai/codex`, Homebrew, or a release binary).
+Requirements: Node.js >= 22.19, and the official Codex CLI on `PATH` (`npm i -g @openai/codex`, Homebrew, or a release binary).
 
 ```bash
 npm i -g codex-multi-auth
@@ -137,7 +137,7 @@ Common symptoms — wrong active account, OAuth callback port `1455` already bou
 
 ## Release notes
 
-- Current stable: [v2.18.0](docs/releases/v2.18.0.md) — `npm i -g codex-multi-auth`
+- Current stable: [v2.19.1](docs/releases/v2.19.1.md) — `npm i -g codex-multi-auth`
 - Earlier stable lines: [v2.6.0](docs/releases/v2.6.0.md), [v2.5.0](docs/releases/v2.5.0.md)
 - Full release archive: [docs/README.md#release-history](docs/README.md#release-history)
 

package/dist/lib/account-policy.d.ts

@@ -20,7 +20,9 @@ export declare function getAccountPolicyPath(): string;
 export declare function getAccountPolicyKey(account: Pick<AccountMetadataV3, "accountId" | "email"> & {
     refreshToken?: string | null;
 }, _index?: number): string;
-export declare function loadAccountPolicyStore(): Promise<AccountPolicyStore>;
+export declare function loadAccountPolicyStore(options?: {
+    strict?: boolean;
+}): Promise<AccountPolicyStore>;
 export declare function saveAccountPolicyStore(store: AccountPolicyStore, baseline?: AccountPolicyStore): Promise<void>;
 /**
  * Run a policy-store read→mutate→write inside the write queue (in-process

package/dist/lib/account-policy.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { existsSync, promises as fs } from "node:fs";
+import { promises as fs } from "node:fs";
 import { basename, join } from "node:path";
 import { logWarn } from "./logger.js";
 import { getCodexMultiAuthDir } from "./runtime-paths.js";
@@ -100,14 +100,30 @@ export function getAccountPolicyKey(account, _index) {
         (refreshFallback ? `refresh:${refreshFallback}` : "unknown");
     return `sha256:${createHash("sha256").update(identity).digest("hex")}`;
 }
-export async function loadAccountPolicyStore() {
+export async function loadAccountPolicyStore(options = {}) {
     const path = getAccountPolicyPath();
-    if (!existsSync(path))
-        return emptyStore();
     try {
-        return normalizeStore(JSON.parse(await readFileWithRetry(path)));
+        const parsed = JSON.parse(await readFileWithRetry(path));
+        if (options.strict) {
+            if (!isRecord(parsed) || parsed.version !== 1 || !isRecord(parsed.accounts)) {
+                throw new Error("Invalid account policy store");
+            }
+            for (const [key, row] of Object.entries(parsed.accounts)) {
+                if (!key.startsWith("sha256:"))
+                    continue;
+                // Legacy rows may omit flags; explicit malformed values are not OFF.
+                if (!isRecord(row) || ["autoPrime", "paused", "drained"].some(flag => flag in row && typeof row[flag] !== "boolean")) {
+                    throw new Error("Invalid account policy row");
+                }
+            }
+        }
+        return normalizeStore(parsed);
     }
     catch (error) {
+        if (error.code === "ENOENT")
+            return emptyStore();
+        if (options.strict)
+            throw error;
         logWarn(`Failed to load account policies from ${basename(path)}: ${error instanceof Error ? error.message : String(error)}`);
         return emptyStore();
     }

package/dist/lib/codex-manager/commands/history.js

@@ -107,7 +107,9 @@ function parseRollout(rolloutPath, deps, previewLimit) {
         if (typeof record.timestamp === "string") {
             updatedAt = record.timestamp;
         }
-        if (record.type === "session_meta") {
+        // Forked rollouts append the parent's session_meta after their own, so
+        // only the first one describes this rollout.
+        if (record.type === "session_meta" && !hasSessionMeta) {
             const payload = record.payload;
             const metaId = readStringField(payload, "id");
             if (metaId)

package/dist/lib/codex-manager/commands/status.js

@@ -1,3 +1,4 @@
+import { subscriptionStatus, formatSubscriptionStatus } from "../formatters/subscription-status.js";
 import { resetSnapshotQuota } from "../../runtime/reset-credits.js";
 import { resetTargetForStoredAccount } from "../../runtime/account-reset-credits.js";
 import { subscriptionQuotaPreference, compareSubscriptionQuota, usesSubscriptionReserve, SUBSCRIPTION_RESERVE_PERCENT } from "../../runtime/subscription-quota-order.js";
@@ -87,7 +88,8 @@ export async function runStatusCommand(deps) {
     const modelInventory = await deps.loadModelInventory?.();
     const resetCredits = await deps.loadResetCreditState?.().catch(() => null);
     const resetSnapshot = (account) => { const target = resetTargetForStoredAccount(account); return target ? resetCredits?.snapshots[target.key] : undefined; };
-    const accountPolicies = await (deps.loadAccountPolicies ?? loadAccountPolicyStore)().catch(() => ({ version: 1, accounts: {} }));
+    let policiesUnavailable = false;
+    const accountPolicies = await (deps.loadAccountPolicies ?? loadAccountPolicyStore)({ strict: true }).catch(() => { policiesUnavailable = true; return { version: 1, accounts: {} }; });
     if (!deps.json && deps.loadModelInventory)
         for (const line of formatModelInventory(modelInventory ?? null))
             logInfo(line);
@@ -136,6 +138,7 @@ export async function runStatusCommand(deps) {
     const now = deps.getNow?.() ?? Date.now();
     const activeIndex = storage.accounts.length ? deps.resolveActiveIndex(storage, "codex") : -1;
     const quotaCache = await deps.loadQuotaCache?.() ?? null;
+    const subscriptionStatuses = storage.accounts.map(account => subscriptionStatus(account, findQuotaCacheEntryForAccount(quotaCache, account, storage.accounts), policiesUnavailable ? undefined : accountPolicies.accounts[getAccountPolicyKey(account)] ?? {}, now));
     const forecastQuotas = storage.accounts.map(account => {
         const cached = findQuotaCacheEntryForAccount(quotaCache, account, storage.accounts);
         const reset = resetSnapshot(account);
@@ -217,6 +220,7 @@ export async function runStatusCommand(deps) {
             const markers = buildAccountMarkers(account, i, activeIndex, runtimeCurrent, now, quotaCache, storage.accounts, deps.formatRateLimitEntry);
             return {
                 index: i,
+                subscription: subscriptionStatuses[i],
                 resetCreditsAvailable: resetSnapshot(account)?.availableCount ?? null,
                 resetCreditsCheckedAt: resetSnapshot(account)?.updatedAt ?? null,
                 label: formatAccountLabel(account, i),
@@ -335,8 +339,9 @@ export async function runStatusCommand(deps) {
             : `inference not yet recorded; ${activity}`;
         logInfo(`${paint(`${i + 1}. ${label}`, "heading")}${paint(markerLabel, markers.some(m => /disabled|cooldown|exhausted|limited|invalid/.test(m)) ? "warning" : "success")} ${paint(lastUsed, "muted")}`);
         logInfo(`   ${paint(`priority tier: ${accountPolicies.accounts[getAccountPolicyKey(account, i)]?.priority ?? 1}`, "accent")}`);
-        if (accountPolicies.accounts[getAccountPolicyKey(account, i)]?.autoPrime)
-            logInfo("   automatic first-use priming: on (router checks every 15 minutes)");
+        const subscription = subscriptionStatuses[i];
+        if (subscription)
+            logInfo(`   ${formatSubscriptionStatus(subscription)}`);
         if (appBindStatus?.nativeOpenai) {
             const preference = quotaPreferences[i];
             const order = automaticOrder.get(i);

package/dist/lib/codex-manager/dashboard-settings-data.js

@@ -22,6 +22,7 @@ export function cloneDashboardSettingsData(settings, deps) {
         menuSortQuickSwitchVisibleRow: settings.menuSortQuickSwitchVisibleRow ?? true,
         uiThemePreset: settings.uiThemePreset ?? "green",
         uiAccentColor: settings.uiAccentColor ?? "green",
+        uiColorMode: settings.uiColorMode ?? "auto",
         menuShowStatusBadge: settings.menuShowStatusBadge ?? true,
         menuShowCurrentBadge: settings.menuShowCurrentBadge ?? true,
         menuShowLastUsed: settings.menuShowLastUsed ?? true,
@@ -71,6 +72,7 @@ export function dashboardSettingsDataEqual(left, right, deps) {
             (right.menuSortQuickSwitchVisibleRow ?? true) &&
         (left.uiThemePreset ?? "green") === (right.uiThemePreset ?? "green") &&
         (left.uiAccentColor ?? "green") === (right.uiAccentColor ?? "green") &&
+        (left.uiColorMode ?? "auto") === (right.uiColorMode ?? "auto") &&
         (left.menuShowStatusBadge ?? true) ===
             (right.menuShowStatusBadge ?? true) &&
         (left.menuShowCurrentBadge ?? true) ===

package/dist/lib/codex-manager/formatters/subscription-status.d.ts

@@ -0,0 +1,16 @@
+import type { AccountPolicy } from "../../account-policy.js";
+import type { QuotaCacheEntry } from "../../quota-cache.js";
+import type { AccountMetadataV3 } from "../../storage.js";
+/** Display only observed evidence; never age a placeholder into a running timer. */
+export declare function subscriptionStatus(account: AccountMetadataV3, entry: QuotaCacheEntry | null, policy: Partial<AccountPolicy> | undefined, now: number): {
+    planType: string | null;
+    planLabel: string;
+    selectedWorkspace: string;
+    autoPrime: boolean | null;
+    primingState: "awaiting-first-use" | "completed" | "failed" | "not-applicable" | "timer-running" | "unknown" | "used";
+    primingFailure: "network error" | "response too large" | "stream ended early" | "timed out" | "upstream failed" | null;
+    automaticBlock: string | null;
+    freshness: string;
+    observedAt: number | null;
+};
+export declare function formatSubscriptionStatus(value: ReturnType<typeof subscriptionStatus>): string;

package/dist/lib/codex-manager/formatters/subscription-status.js

@@ -0,0 +1,69 @@
+import { needsSubscriptionFirstUse } from "../../runtime/subscription-first-use.js";
+const PLAN_LABELS = new Map([
+    ["free", "Free"], ["plus", "Plus"], ["pro", "Pro 200"],
+    ["prolite", "Pro 100"], ["promax", "Pro 500"], ["team", "Business"],
+    ["business", "Business"], ["enterprise", "Enterprise"], ["edu", "Edu"],
+]);
+const STATE_LABELS = {
+    unknown: "Priming status unknown",
+    "awaiting-first-use": "Awaiting first use",
+    "timer-running": "Reset timer running",
+    used: "Usage recorded",
+    completed: "First-use completed; timer not yet verified",
+    failed: "Priming failed",
+    "not-applicable": "Priming not applicable",
+};
+/** Display only observed evidence; never age a placeholder into a running timer. */
+export function subscriptionStatus(account, entry, policy, now) {
+    const workspace = account.workspaces?.[account.currentWorkspaceIndex ?? 0];
+    const selectedWorkspace = workspace
+        ? workspace.name?.replace(/\s*\(role:.*$|\s*\[id:.*$/g, "").trim() || "Unnamed workspace"
+        : account.workspaces?.length ? "Invalid workspace selection" : "Stored binding (workspace unknown)";
+    const freshness = !entry ? "missing"
+        : entry.updatedAt > now || now - entry.updatedAt > 30 * 60000 ? "stale" : "fresh";
+    const planType = entry?.planType?.trim().toLowerCase() ?? null;
+    const planLabel = PLAN_LABELS.get(planType ?? "") ?? "Unknown plan";
+    let primingState = "unknown";
+    if (entry && freshness === "fresh" && entry.status === 200) {
+        const windows = [entry.primary, entry.secondary].filter(w => w.windowMinutes !== 0);
+        if (!planType || !PLAN_LABELS.has(planType))
+            primingState = "unknown";
+        else if (!["plus", "pro", "prolite", "promax"].includes(planType))
+            primingState = "not-applicable";
+        else if (entry.primingFailure)
+            primingState = "failed";
+        else if (entry.primingCompleted)
+            primingState = "completed";
+        else if (windows.some(w => typeof w.usedPercent === "number" && w.usedPercent > 0)) {
+            primingState = "used";
+        }
+        else if (windows.some(w => typeof w.windowMinutes === "number" && w.windowMinutes > 0 &&
+            typeof w.resetAtMs === "number" && w.resetAtMs > now &&
+            w.resetAtMs - entry.updatedAt < w.windowMinutes * 60000 - 2000)) {
+            primingState = "timer-running";
+        }
+        else if (needsSubscriptionFirstUse(entry, entry.updatedAt)) {
+            primingState = "awaiting-first-use";
+        }
+    }
+    const automaticBlock = account.enabled === false ? "account disabled"
+        : account.authInvalidatedAt ? "sign-in required"
+            : policy?.paused ? "paused"
+                : policy?.drained ? "drained"
+                    : (account.coolingDownUntil ?? 0) > now ? "cooling down"
+                        : account.workspaces?.length && (!workspace || workspace.enabled === false) ? "workspace unavailable"
+                            : null;
+    return {
+        planType, planLabel, selectedWorkspace,
+        autoPrime: policy ? policy.autoPrime === true : null,
+        primingState, primingFailure: entry?.primingFailure ?? null,
+        automaticBlock, freshness, observedAt: entry?.updatedAt ?? null,
+    };
+}
+export function formatSubscriptionStatus(value) {
+    const freshness = value.freshness === "stale" ? " (stale; run check accounts)"
+        : value.freshness === "missing" ? " (not observed)" : "";
+    const autoPrime = value.autoPrime === null ? "unknown" : value.autoPrime ? "ON" : "OFF";
+    const block = value.automaticBlock ? `; blocked: ${value.automaticBlock}` : "";
+    return `${value.selectedWorkspace} · ${value.planLabel}${freshness} · Auto-prime ${autoPrime} · ${STATE_LABELS[value.primingState]}${block}`;
+}

package/dist/lib/codex-manager/formatters/text-style.js

@@ -8,7 +8,10 @@ export function stylePromptText(text, tone) {
     const ui = getUiRuntimeOptions();
     if (ui.v2Enabled) {
         if (tone === "muted") {
-            return `${ui.theme.colors.dim}${paintUiText(ui, text, "muted")}${ui.theme.colors.reset}`;
+            // In light mode the muted foreground is already dark; stacking the
+            // dim attribute on top makes the text faint again on light themes.
+            const dim = ui.theme.colorMode === "light" ? "" : ui.theme.colors.dim;
+            return `${dim}${paintUiText(ui, text, "muted")}${ui.theme.colors.reset}`;
         }
         const mapped = tone === "accent" ? "primary" : tone;
         return paintUiText(ui, text, mapped);

package/dist/lib/codex-manager/health-check.js

@@ -1,3 +1,6 @@
+import { subscriptionStatus, formatSubscriptionStatus } from "./formatters/subscription-status.js";
+import { getAccountPolicyKey, loadAccountPolicyStore } from "../account-policy.js";
+import { automaticCheckWorkspaceId } from "../runtime/automatic-account-checks.js";
 import { refreshAndPrintResetCredits } from "../runtime/account-reset-credits.js";
 import { mapWithConcurrency } from "../concurrency.js";
 import { withCheckProgress } from "../ui/check-progress.js";
@@ -16,7 +19,7 @@ import { loadAccounts, saveAccounts, setStoragePath } from "../storage.js";
 import { applyTokenAccountIdentity, hasLikelyInvalidRefreshToken, hasUsableAccessToken, } from "./account-credentials.js";
 import { saveAccountsWithRetry } from "./forecast-report-shared.js";
 import { formatModelInspection, formatQuotaSnapshotForDashboard, formatResultSummary, inspectRequestedModel, normalizeFailureDetail, styleAccountDetailText, stylePromptText, } from "./formatters/index.js";
-import { cloneQuotaCacheData, DEFAULT_LIVE_PROBE_MODEL, pruneUnsafeQuotaEmailCacheEntry, updateQuotaCacheForAccount, } from "./quota-cache-helpers.js";
+import { cloneQuotaCacheData, DEFAULT_LIVE_PROBE_MODEL, pruneUnsafeQuotaEmailCacheEntry, updateQuotaCacheForWorkspace, } from "./quota-cache-helpers.js";
 function appendAuthInvalidationMarker(account, detail) {
     return typeof account.authInvalidatedAt === "number" &&
         Number.isFinite(account.authInvalidatedAt)
@@ -44,6 +47,8 @@ export async function runHealthCheck(options = {}) {
     let quotaEmailFallbackState = liveProbe && quotaCache
         ? buildQuotaEmailFallbackState(storage.accounts)
         : null;
+    const policies = await loadAccountPolicyStore({ strict: true }).catch(() => null);
+    const subscriptionLine = (account, snapshot) => formatSubscriptionStatus(subscriptionStatus(account, { ...snapshot, updatedAt: snapshot.observedAt ?? Date.now() }, policies ? policies.accounts[getAccountPolicyKey(account)] ?? {} : undefined, Date.now()));
     let changed = false;
     let ok = 0;
     let failed = 0;
@@ -62,7 +67,7 @@ export async function runHealthCheck(options = {}) {
     const quickProbes = new Map();
     if (liveProbe && !forceRefresh) {
         const candidates = storage.accounts.flatMap((account, index) => {
-            const accountId = account.accountId ?? extractAccountId(account.accessToken);
+            const accountId = automaticCheckWorkspaceId(account);
             return hasUsableAccessToken(account, now) && account.accessToken && accountId
                 ? [{ index, accountId, accessToken: account.accessToken }] : [];
         });
@@ -104,14 +109,14 @@ export async function runHealthCheck(options = {}) {
             if (liveProbe) {
                 const currentAccessToken = account.accessToken;
                 const probeAccountId = currentAccessToken
-                    ? (account.accountId ?? extractAccountId(currentAccessToken))
+                    ? automaticCheckWorkspaceId(account)
                     : undefined;
                 if (!probeAccountId || !currentAccessToken) {
                     warnings += 1;
                     signedInOnly += 1;
                     healthTone = "warning";
                     healthDetail =
-                        "signed in (live check skipped: missing account ID)";
+                        "signed in (live check skipped: missing account ID or unavailable selected workspace)";
                 }
                 else {
                     try {
@@ -124,10 +129,10 @@ export async function runHealthCheck(options = {}) {
                             model: modelInspection.normalized,
                         }), console.log);
                         if (workingQuotaCache) {
-                            quotaCacheChanged =
-                                updateQuotaCacheForAccount(workingQuotaCache, account, snapshot, storage.accounts, quotaEmailFallbackState ?? undefined) || quotaCacheChanged;
+                            updateQuotaCacheForWorkspace(workingQuotaCache, account, probeAccountId, snapshot, storage.accounts);
+                            quotaCacheChanged = true;
                         }
-                        healthDetail = formatQuotaSnapshotForDashboard(snapshot, display);
+                        healthDetail = formatQuotaSnapshotForDashboard(snapshot, display) + " | " + subscriptionLine(account, snapshot);
                         if (snapshot.primingFailure) {
                             healthTone = "warning";
                             warnings += 1;
@@ -210,13 +215,13 @@ export async function runHealthCheck(options = {}) {
             let healthyMessage = "working now";
             let healthyTone = "success";
             if (liveProbe) {
-                const probeAccountId = account.accountId ?? tokenAccountId;
+                const probeAccountId = automaticCheckWorkspaceId(account);
                 if (!probeAccountId) {
                     warnings += 1;
                     signedInOnly += 1;
                     healthyTone = "warning";
                     healthyMessage =
-                        "signed in (live check skipped: missing account ID)";
+                        "signed in (live check skipped: missing account ID or unavailable selected workspace)";
                 }
                 else {
                     try {
@@ -226,10 +231,10 @@ export async function runHealthCheck(options = {}) {
                             model: modelInspection.normalized,
                         }), console.log);
                         if (workingQuotaCache) {
-                            quotaCacheChanged =
-                                updateQuotaCacheForAccount(workingQuotaCache, account, snapshot, storage.accounts, quotaEmailFallbackState ?? undefined) || quotaCacheChanged;
+                            updateQuotaCacheForWorkspace(workingQuotaCache, account, probeAccountId, snapshot, storage.accounts);
+                            quotaCacheChanged = true;
                         }
-                        healthyMessage = formatQuotaSnapshotForDashboard(snapshot, display);
+                        healthyMessage = formatQuotaSnapshotForDashboard(snapshot, display) + " | " + subscriptionLine(account, snapshot);
                         if (snapshot.primingFailure) {
                             healthyTone = "warning";
                             warnings += 1;

package/dist/lib/codex-manager/quota-cache-helpers.js

@@ -1,4 +1,5 @@
 import { buildQuotaEmailFallbackState, findQuotaCacheEntryForAccount, quotaWorkspaceKey, hasSafeQuotaEmailFallback, hasUniqueQuotaAccountId, normalizeQuotaAccountId, normalizeQuotaEmail, } from "../quota-readiness.js";
+import { mergeQuotaCacheEntry, } from "../quota-cache.js";
 import { DEFAULT_MODEL, DEFAULT_PROBE_MODEL, } from "../request/helpers/model-map.js";
 import { getRateLimitResetTimeForFamily } from "../runtime/account-status.js";
 /**
@@ -41,7 +42,10 @@ export function getPersistedQuotaViewForAccount(cache, account, accounts, now, e
 /** Retain only quota fields from a probe, never its credentials or response body. */
 function quotaEntryFromSnapshot(snapshot) {
     return {
-        updatedAt: Date.now(),
+        ...(snapshot.primingCompleted ? { primingCompleted: true } : {}),
+        ...(snapshot.primingFailure ? { primingFailure: snapshot.primingFailure } : {}),
+        ...(snapshot.primingCompleted || snapshot.primingFailure ? { primingObservedAt: snapshot.primingObservedAt ?? Date.now() } : {}),
+        updatedAt: snapshot.observedAt ?? Date.now(),
         status: snapshot.status,
         model: snapshot.model,
         planType: snapshot.planType,
@@ -64,14 +68,14 @@ export function updateQuotaCacheForAccount(cache, account, snapshot, accounts, e
     const accountId = normalizeQuotaAccountId(account.accountId);
     const hasUniqueAccountId = accountId !== null && hasUniqueQuotaAccountId(accounts, account);
     if (hasUniqueAccountId) {
-        cache.byAccountId[accountId] = nextEntry;
+        cache.byAccountId[accountId] = mergeQuotaCacheEntry(cache.byAccountId[accountId], nextEntry);
         changed = true;
     }
     const email = normalizeQuotaEmail(account.email);
     if (email &&
         hasSafeQuotaEmailFallback(emailFallbackState, account) &&
         !hasUniqueAccountId) {
-        cache.byEmail[email] = nextEntry;
+        cache.byEmail[email] = mergeQuotaCacheEntry(cache.byEmail[email], nextEntry);
         changed = true;
     }
     else if (email && cache.byEmail[email]) {
@@ -86,7 +90,7 @@ export function updateQuotaCacheForWorkspace(cache, account, workspaceId, snapsh
     if (!key)
         return;
     cache.byWorkspace ??= {};
-    cache.byWorkspace[key] = quotaEntryFromSnapshot(snapshot);
+    cache.byWorkspace[key] = mergeQuotaCacheEntry(cache.byWorkspace[key], quotaEntryFromSnapshot(snapshot));
     if (workspaceId === normalizeQuotaAccountId(account.accountId)) {
         updateQuotaCacheForAccount(cache, account, snapshot, accounts);
     }

package/dist/lib/codex-manager/settings-hub/dashboard.d.ts

@@ -1,6 +1,6 @@
 import { type DashboardDisplaySettings } from "../../dashboard-settings.js";
 export declare const BEHAVIOR_PANEL_KEYS: readonly ["actionAutoReturnMs", "actionPauseOnKey", "menuAutoFetchLimits", "menuShowFetchStatus", "menuQuotaTtlMs"];
-export declare const THEME_PANEL_KEYS: readonly ["uiThemePreset", "uiAccentColor"];
+export declare const THEME_PANEL_KEYS: readonly ["uiThemePreset", "uiAccentColor", "uiColorMode"];
 export declare function applyUiThemeFromDashboardSettings(settings: DashboardDisplaySettings): void;
 export declare function promptDashboardDisplaySettings(initial: DashboardDisplaySettings): Promise<DashboardDisplaySettings | null>;
 export declare function configureDashboardDisplaySettings(currentSettings?: DashboardDisplaySettings): Promise<DashboardDisplaySettings>;

package/dist/lib/codex-manager/settings-hub/dashboard.js

@@ -93,6 +93,7 @@ const ACCENT_COLOR_OPTIONS = [
     "blue",
     "yellow",
 ];
+const COLOR_MODE_OPTIONS = ["auto", "dark", "light"];
 const ACCOUNT_LIST_PANEL_KEYS = [
     "menuShowStatusBadge",
     "menuShowCurrentBadge",
@@ -121,6 +122,7 @@ export const BEHAVIOR_PANEL_KEYS = [
 export const THEME_PANEL_KEYS = [
     "uiThemePreset",
     "uiAccentColor",
+    "uiColorMode",
 ];
 export function applyUiThemeFromDashboardSettings(settings) {
     const current = getUiRuntimeOptions();
@@ -130,6 +132,7 @@ export function applyUiThemeFromDashboardSettings(settings) {
         glyphMode: current.glyphMode,
         palette: settings.uiThemePreset ?? "green",
         accent: settings.uiAccentColor ?? "green",
+        colorMode: settings.uiColorMode ?? "auto",
     });
 }
 /* c8 ignore start - interactive prompt flows are covered by integration tests */
@@ -215,6 +218,7 @@ export async function promptThemeSettings(initial) {
         applyUiThemeFromDashboardSettings,
         THEME_PRESET_OPTIONS,
         ACCENT_COLOR_OPTIONS,
+        COLOR_MODE_OPTIONS,
         THEME_PANEL_KEYS,
         UI_COPY,
     });

package/dist/lib/codex-manager/settings-panels.d.ts

@@ -50,6 +50,7 @@ export declare function promptThemeSettingsPanelEntry(params: {
     applyUiThemeFromDashboardSettings: ThemeSettingsPanelDeps["applyUiThemeFromDashboardSettings"];
     THEME_PRESET_OPTIONS: ThemeSettingsPanelDeps["THEME_PRESET_OPTIONS"];
     ACCENT_COLOR_OPTIONS: ThemeSettingsPanelDeps["ACCENT_COLOR_OPTIONS"];
+    COLOR_MODE_OPTIONS: ThemeSettingsPanelDeps["COLOR_MODE_OPTIONS"];
     THEME_PANEL_KEYS: ThemeSettingsPanelDeps["THEME_PANEL_KEYS"];
     UI_COPY: ThemeSettingsPanelDeps["UI_COPY"];
 }): Promise<DashboardDisplaySettings | null>;

package/dist/lib/codex-manager/settings-panels.js

@@ -66,6 +66,7 @@ export async function promptThemeSettingsPanelEntry(params) {
         applyUiThemeFromDashboardSettings: params.applyUiThemeFromDashboardSettings,
         THEME_PRESET_OPTIONS: params.THEME_PRESET_OPTIONS,
         ACCENT_COLOR_OPTIONS: params.ACCENT_COLOR_OPTIONS,
+        COLOR_MODE_OPTIONS: params.COLOR_MODE_OPTIONS,
         THEME_PANEL_KEYS: params.THEME_PANEL_KEYS,
         UI_COPY: params.UI_COPY,
     });

package/dist/lib/codex-manager/theme-settings-panel.d.ts

@@ -1,4 +1,4 @@
-import type { DashboardAccentColor, DashboardDisplaySettings, DashboardThemePreset } from "../dashboard-settings.js";
+import type { DashboardAccentColor, DashboardColorMode, DashboardDisplaySettings, DashboardThemePreset } from "../dashboard-settings.js";
 import type { UI_COPY } from "../ui/ui-copy.js";
 export interface ThemeSettingsPanelDeps {
     cloneDashboardSettings: (settings: DashboardDisplaySettings) => DashboardDisplaySettings;
@@ -6,6 +6,7 @@ export interface ThemeSettingsPanelDeps {
     applyUiThemeFromDashboardSettings: (settings: DashboardDisplaySettings) => void;
     THEME_PRESET_OPTIONS: readonly DashboardThemePreset[];
     ACCENT_COLOR_OPTIONS: readonly DashboardAccentColor[];
+    COLOR_MODE_OPTIONS: readonly DashboardColorMode[];
     THEME_PANEL_KEYS: readonly (keyof DashboardDisplaySettings)[];
     UI_COPY: typeof UI_COPY;
 }

package/dist/lib/codex-manager/theme-settings-panel.js

@@ -14,6 +14,7 @@ export async function promptThemeSettingsPanel(initial, deps) {
         const ui = getUiRuntimeOptions();
         const palette = draft.uiThemePreset ?? "green";
         const accent = draft.uiAccentColor ?? "green";
+        const colorMode = draft.uiColorMode ?? "auto";
         const paletteItems = deps.THEME_PRESET_OPTIONS.map((candidate, index) => {
             const color = palette === candidate ? "green" : "yellow";
             return {
@@ -33,6 +34,21 @@ export async function promptThemeSettingsPanel(initial, deps) {
                 color,
             };
         });
+        const colorModeItems = deps.COLOR_MODE_OPTIONS.map((candidate) => {
+            const color = colorMode === candidate ? "green" : "yellow";
+            const key = candidate === "auto" ? "A" : candidate === "dark" ? "D" : "L";
+            const hint = candidate === "auto"
+                ? "Detect from COLORFGBG; dark when unknown."
+                : candidate === "dark"
+                    ? "Pale text on a dark terminal background."
+                    : "Dark text on a light terminal background.";
+            return {
+                label: `${colorMode === candidate ? "[x]" : "[ ]"} ${key}. ${candidate}`,
+                hint,
+                value: { type: "set-color-mode", colorMode: candidate },
+                color,
+            };
+        });
         const items = [
             {
                 label: deps.UI_COPY.settings.baseTheme,
@@ -48,6 +64,13 @@ export async function promptThemeSettingsPanel(initial, deps) {
             },
             ...accentItems,
             { label: "", value: { type: "cancel" }, separator: true },
+            {
+                label: deps.UI_COPY.settings.terminalBackground,
+                value: { type: "cancel" },
+                kind: "heading",
+            },
+            ...colorModeItems,
+            { label: "", value: { type: "cancel" }, separator: true },
             {
                 label: deps.UI_COPY.settings.resetDefault,
                 value: { type: "reset" },
@@ -74,6 +97,10 @@ export async function promptThemeSettingsPanel(initial, deps) {
             if (value.type === "set-accent" && focus.type === "set-accent") {
                 return value.accent === focus.accent;
             }
+            if (value.type === "set-color-mode" &&
+                focus.type === "set-color-mode") {
+                return value.colorMode === focus.colorMode;
+            }
             return true;
         });
         const result = await select(items, {
@@ -98,6 +125,12 @@ export async function promptThemeSettingsPanel(initial, deps) {
                     return { type: "save" };
                 if (lower === "r")
                     return { type: "reset" };
+                if (lower === "a")
+                    return { type: "set-color-mode", colorMode: "auto" };
+                if (lower === "d")
+                    return { type: "set-color-mode", colorMode: "dark" };
+                if (lower === "l")
+                    return { type: "set-color-mode", colorMode: "light" };
                 if (raw === "1")
                     return { type: "set-palette", palette: "green" };
                 if (raw === "2")
@@ -123,6 +156,12 @@ export async function promptThemeSettingsPanel(initial, deps) {
             deps.applyUiThemeFromDashboardSettings(draft);
             continue;
         }
+        if (result.type === "set-color-mode") {
+            draft = { ...draft, uiColorMode: result.colorMode };
+            focus = result;
+            deps.applyUiThemeFromDashboardSettings(draft);
+            continue;
+        }
         draft = { ...draft, uiAccentColor: result.accent };
         focus = result;
         deps.applyUiThemeFromDashboardSettings(draft);

package/dist/lib/dashboard-settings.d.ts

@@ -1,5 +1,6 @@
 export type DashboardThemePreset = "green" | "blue";
 export type DashboardAccentColor = "green" | "cyan" | "blue" | "yellow";
+export type DashboardColorMode = "auto" | "dark" | "light";
 export type DashboardAccountSortMode = "manual" | "ready-first";
 type DashboardLayoutMode = "compact-details" | "expanded-rows";
 type DashboardFocusStyle = "row-invert";
@@ -18,6 +19,7 @@ export interface DashboardDisplaySettings {
     menuSortQuickSwitchVisibleRow?: boolean;
     uiThemePreset?: DashboardThemePreset;
     uiAccentColor?: DashboardAccentColor;
+    uiColorMode?: DashboardColorMode;
     menuShowStatusBadge?: boolean;
     menuShowCurrentBadge?: boolean;
     menuShowLastUsed?: boolean;

package/dist/lib/dashboard-settings.js

@@ -19,6 +19,7 @@ export const DEFAULT_DASHBOARD_DISPLAY_SETTINGS = {
     menuSortQuickSwitchVisibleRow: true,
     uiThemePreset: "green",
     uiAccentColor: "green",
+    uiColorMode: "auto",
     menuShowStatusBadge: true,
     menuShowCurrentBadge: true,
     menuShowLastUsed: true,
@@ -102,6 +103,22 @@ function normalizeAccentColor(value) {
             return "green";
     }
 }
+/**
+ * Normalize an input value into a dashboard terminal-background mode.
+ *
+ * @param value - Input value to coerce into a color mode
+ * @returns `'dark'` or `'light'` if `value` matches one of those strings; otherwise `'auto'` (terminal detection)
+ */
+function normalizeColorMode(value) {
+    switch (value) {
+        case "dark":
+            return "dark";
+        case "light":
+            return "light";
+        default:
+            return "auto";
+    }
+}
 /**
  * Validate a dashboard layout mode, allowing only "expanded-rows".
  *
@@ -249,6 +266,7 @@ export function normalizeDashboardDisplaySettings(value) {
         menuSortQuickSwitchVisibleRow: normalizeBoolean(value.menuSortQuickSwitchVisibleRow, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuSortQuickSwitchVisibleRow ?? true),
         uiThemePreset: normalizeThemePreset(value.uiThemePreset),
         uiAccentColor: normalizeAccentColor(value.uiAccentColor),
+        uiColorMode: normalizeColorMode(value.uiColorMode),
         menuShowStatusBadge: normalizeBoolean(value.menuShowStatusBadge, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowStatusBadge ?? true),
         menuShowCurrentBadge: normalizeBoolean(value.menuShowCurrentBadge, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowCurrentBadge ?? true),
         menuShowLastUsed: normalizeBoolean(value.menuShowLastUsed, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowLastUsed ?? true),

package/dist/lib/model-route-policy.d.ts

@@ -37,15 +37,15 @@ export declare function resolveModelRoute(model: string, catalogs: RouteCatalog[
 export declare function buildVisibleModelUnion(catalogs: RouteCatalog[]): RouteModel[];
 /** Whitelist capability metadata; never persist model instructions or arbitrary fields. */
 export declare function modelEntitlements(model: RouteModel): {
+    model: string;
+    checkedAt?: number | undefined;
+    probes?: {
+        [k: string]: "downgraded" | "unsupported" | "unverified" | "verified";
+    } | undefined;
     serviceTiers: {
         id: string;
         name: string;
     }[];
     reasoningLevels: string[];
     accessPrograms: string[];
-    probes?: {
-        [k: string]: "verified" | "unsupported" | "unverified" | "downgraded";
-    } | undefined;
-    checkedAt?: number | undefined;
-    model: string;
 };