codex-multi-auth 2.19.0 → 2.19.1

package/dist/lib/schemas.d.ts

@@ -9,27 +9,27 @@ export declare const PluginConfigSchema: z.ZodObject<{
     codexRuntimeRotationProxy: z.ZodOptional<z.ZodBoolean>;
     codexTuiV2: z.ZodOptional<z.ZodBoolean>;
     codexTuiColorProfile: z.ZodOptional<z.ZodEnum<{
-        truecolor: "truecolor";
         ansi16: "ansi16";
         ansi256: "ansi256";
+        truecolor: "truecolor";
     }>>;
     codexTuiGlyphMode: z.ZodOptional<z.ZodEnum<{
         ascii: "ascii";
-        unicode: "unicode";
         auto: "auto";
+        unicode: "unicode";
     }>>;
     fastSession: z.ZodOptional<z.ZodBoolean>;
     fastSessionStrategy: z.ZodOptional<z.ZodEnum<{
-        hybrid: "hybrid";
         always: "always";
+        hybrid: "hybrid";
     }>>;
     fastSessionMaxInputItems: z.ZodOptional<z.ZodNumber>;
     retryAllAccountsRateLimited: z.ZodOptional<z.ZodBoolean>;
     retryAllAccountsMaxWaitMs: z.ZodOptional<z.ZodNumber>;
     retryAllAccountsMaxRetries: z.ZodOptional<z.ZodNumber>;
     unsupportedCodexPolicy: z.ZodOptional<z.ZodEnum<{
-        strict: "strict";
         fallback: "fallback";
+        strict: "strict";
     }>>;
     fallbackOnUnsupportedCodexModel: z.ZodOptional<z.ZodBoolean>;
     fallbackToGpt52OnUnsupportedGpt53: z.ZodOptional<z.ZodBoolean>;
@@ -89,10 +89,10 @@ export type PluginConfigFromSchema = z.infer<typeof PluginConfigSchema>;
  * Source of the accountId used for ChatGPT requests.
  */
 declare const AccountIdSourceSchema: z.ZodEnum<{
-    token: "token";
     id_token: "id_token";
-    org: "org";
     manual: "manual";
+    org: "org";
+    token: "token";
 }>;
 export type AccountIdSourceFromSchema = z.infer<typeof AccountIdSourceSchema>;
 /**
@@ -101,10 +101,10 @@ export type AccountIdSourceFromSchema = z.infer<typeof AccountIdSourceSchema>;
  * recorded by `markSwitched` but never originate from the CLI persist path.
  */
 export declare const PersistedSwitchReasonSchema: z.ZodEnum<{
-    manual: "manual";
-    rotation: "rotation";
     best: "best";
+    manual: "manual";
     restore: "restore";
+    rotation: "rotation";
 }>;
 export type PersistedSwitchReason = z.infer<typeof PersistedSwitchReasonSchema>;
 /**
@@ -114,10 +114,10 @@ export declare const AccountMetadataV3Schema: z.ZodObject<{
     recordId: z.ZodOptional<z.ZodString>;
     accountId: z.ZodOptional<z.ZodString>;
     accountIdSource: z.ZodOptional<z.ZodEnum<{
-        token: "token";
         id_token: "id_token";
-        org: "org";
         manual: "manual";
+        org: "org";
+        token: "token";
     }>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     email: z.ZodOptional<z.ZodString>;
@@ -128,19 +128,19 @@ export declare const AccountMetadataV3Schema: z.ZodObject<{
     addedAt: z.ZodNumber;
     lastUsed: z.ZodNumber;
     lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+        best: "best";
+        initial: "initial";
         manual: "manual";
         "rate-limit": "rate-limit";
-        initial: "initial";
-        rotation: "rotation";
-        best: "best";
         restore: "restore";
+        rotation: "rotation";
     }>>;
     rateLimitResetTimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
     coolingDownUntil: z.ZodOptional<z.ZodNumber>;
     cooldownReason: z.ZodOptional<z.ZodEnum<{
-        "rate-limit": "rate-limit";
         "auth-failure": "auth-failure";
         "network-error": "network-error";
+        "rate-limit": "rate-limit";
         "server-error": "server-error";
     }>>;
     authInvalidatedAt: z.ZodOptional<z.ZodNumber>;
@@ -167,10 +167,10 @@ export declare const AccountStorageV3Schema: z.ZodObject<{
         recordId: z.ZodOptional<z.ZodString>;
         accountId: z.ZodOptional<z.ZodString>;
         accountIdSource: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             id_token: "id_token";
-            org: "org";
             manual: "manual";
+            org: "org";
+            token: "token";
         }>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
@@ -181,19 +181,19 @@ export declare const AccountStorageV3Schema: z.ZodObject<{
         addedAt: z.ZodNumber;
         lastUsed: z.ZodNumber;
         lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+            best: "best";
+            initial: "initial";
             manual: "manual";
             "rate-limit": "rate-limit";
-            initial: "initial";
-            rotation: "rotation";
-            best: "best";
             restore: "restore";
+            rotation: "rotation";
         }>>;
         rateLimitResetTimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
         coolingDownUntil: z.ZodOptional<z.ZodNumber>;
         cooldownReason: z.ZodOptional<z.ZodEnum<{
-            "rate-limit": "rate-limit";
             "auth-failure": "auth-failure";
             "network-error": "network-error";
+            "rate-limit": "rate-limit";
             "server-error": "server-error";
         }>>;
         authInvalidatedAt: z.ZodOptional<z.ZodNumber>;
@@ -213,11 +213,11 @@ export declare const AccountStorageV3Schema: z.ZodObject<{
     }, z.core.$strip>>;
     activeIndex: z.ZodNumber;
     activeIndexByFamily: z.ZodOptional<z.ZodObject<{
-        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         codex: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         "gpt-5.1": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>;
     pinnedAccountIndex: z.ZodOptional<z.ZodNumber>;
     affinityGeneration: z.ZodOptional<z.ZodNumber>;
@@ -236,10 +236,10 @@ export declare const AccountStorageV1Schema: z.ZodObject<{
     accounts: z.ZodArray<z.ZodObject<{
         accountId: z.ZodOptional<z.ZodString>;
         accountIdSource: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             id_token: "id_token";
-            org: "org";
             manual: "manual";
+            org: "org";
+            token: "token";
         }>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
@@ -250,29 +250,29 @@ export declare const AccountStorageV1Schema: z.ZodObject<{
         addedAt: z.ZodNumber;
         lastUsed: z.ZodNumber;
         lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+            best: "best";
+            initial: "initial";
             manual: "manual";
             "rate-limit": "rate-limit";
-            initial: "initial";
-            rotation: "rotation";
-            best: "best";
             restore: "restore";
+            rotation: "rotation";
         }>>;
         rateLimitResetTime: z.ZodOptional<z.ZodNumber>;
         coolingDownUntil: z.ZodOptional<z.ZodNumber>;
         cooldownReason: z.ZodOptional<z.ZodEnum<{
-            "rate-limit": "rate-limit";
             "auth-failure": "auth-failure";
             "network-error": "network-error";
+            "rate-limit": "rate-limit";
             "server-error": "server-error";
         }>>;
     }, z.core.$loose>>;
     activeIndex: z.ZodNumber;
     activeIndexByFamily: z.ZodOptional<z.ZodObject<{
-        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         codex: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         "gpt-5.1": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>;
     pinnedAccountIndex: z.ZodOptional<z.ZodNumber>;
     affinityGeneration: z.ZodOptional<z.ZodNumber>;
@@ -285,10 +285,10 @@ export declare const AnyAccountStorageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     accounts: z.ZodArray<z.ZodObject<{
         accountId: z.ZodOptional<z.ZodString>;
         accountIdSource: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             id_token: "id_token";
-            org: "org";
             manual: "manual";
+            org: "org";
+            token: "token";
         }>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
@@ -299,29 +299,29 @@ export declare const AnyAccountStorageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         addedAt: z.ZodNumber;
         lastUsed: z.ZodNumber;
         lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+            best: "best";
+            initial: "initial";
             manual: "manual";
             "rate-limit": "rate-limit";
-            initial: "initial";
-            rotation: "rotation";
-            best: "best";
             restore: "restore";
+            rotation: "rotation";
         }>>;
         rateLimitResetTime: z.ZodOptional<z.ZodNumber>;
         coolingDownUntil: z.ZodOptional<z.ZodNumber>;
         cooldownReason: z.ZodOptional<z.ZodEnum<{
-            "rate-limit": "rate-limit";
             "auth-failure": "auth-failure";
             "network-error": "network-error";
+            "rate-limit": "rate-limit";
             "server-error": "server-error";
         }>>;
     }, z.core.$loose>>;
     activeIndex: z.ZodNumber;
     activeIndexByFamily: z.ZodOptional<z.ZodObject<{
-        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         codex: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         "gpt-5.1": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>;
     pinnedAccountIndex: z.ZodOptional<z.ZodNumber>;
     affinityGeneration: z.ZodOptional<z.ZodNumber>;
@@ -331,10 +331,10 @@ export declare const AnyAccountStorageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         recordId: z.ZodOptional<z.ZodString>;
         accountId: z.ZodOptional<z.ZodString>;
         accountIdSource: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             id_token: "id_token";
-            org: "org";
             manual: "manual";
+            org: "org";
+            token: "token";
         }>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
@@ -345,19 +345,19 @@ export declare const AnyAccountStorageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         addedAt: z.ZodNumber;
         lastUsed: z.ZodNumber;
         lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+            best: "best";
+            initial: "initial";
             manual: "manual";
             "rate-limit": "rate-limit";
-            initial: "initial";
-            rotation: "rotation";
-            best: "best";
             restore: "restore";
+            rotation: "rotation";
         }>>;
         rateLimitResetTimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
         coolingDownUntil: z.ZodOptional<z.ZodNumber>;
         cooldownReason: z.ZodOptional<z.ZodEnum<{
-            "rate-limit": "rate-limit";
             "auth-failure": "auth-failure";
             "network-error": "network-error";
+            "rate-limit": "rate-limit";
             "server-error": "server-error";
         }>>;
         authInvalidatedAt: z.ZodOptional<z.ZodNumber>;
@@ -377,11 +377,11 @@ export declare const AnyAccountStorageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     }, z.core.$strip>>;
     activeIndex: z.ZodNumber;
     activeIndexByFamily: z.ZodOptional<z.ZodObject<{
-        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         codex: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "codex-max": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5-codex": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         "gpt-5.1": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        "gpt-5.2": z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>;
     pinnedAccountIndex: z.ZodOptional<z.ZodNumber>;
     affinityGeneration: z.ZodOptional<z.ZodNumber>;
@@ -396,10 +396,10 @@ export declare const FlaggedAccountMetadataV1Schema: z.ZodObject<{
     recordId: z.ZodOptional<z.ZodString>;
     accountId: z.ZodOptional<z.ZodString>;
     accountIdSource: z.ZodOptional<z.ZodEnum<{
-        token: "token";
         id_token: "id_token";
-        org: "org";
         manual: "manual";
+        org: "org";
+        token: "token";
     }>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     email: z.ZodOptional<z.ZodString>;
@@ -410,19 +410,19 @@ export declare const FlaggedAccountMetadataV1Schema: z.ZodObject<{
     addedAt: z.ZodNumber;
     lastUsed: z.ZodNumber;
     lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+        best: "best";
+        initial: "initial";
         manual: "manual";
         "rate-limit": "rate-limit";
-        initial: "initial";
-        rotation: "rotation";
-        best: "best";
         restore: "restore";
+        rotation: "rotation";
     }>>;
     rateLimitResetTimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
     coolingDownUntil: z.ZodOptional<z.ZodNumber>;
     cooldownReason: z.ZodOptional<z.ZodEnum<{
-        "rate-limit": "rate-limit";
         "auth-failure": "auth-failure";
         "network-error": "network-error";
+        "rate-limit": "rate-limit";
         "server-error": "server-error";
     }>>;
     authInvalidatedAt: z.ZodOptional<z.ZodNumber>;
@@ -452,10 +452,10 @@ export declare const FlaggedAccountStorageV1Schema: z.ZodObject<{
         recordId: z.ZodOptional<z.ZodString>;
         accountId: z.ZodOptional<z.ZodString>;
         accountIdSource: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             id_token: "id_token";
-            org: "org";
             manual: "manual";
+            org: "org";
+            token: "token";
         }>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
@@ -466,19 +466,19 @@ export declare const FlaggedAccountStorageV1Schema: z.ZodObject<{
         addedAt: z.ZodNumber;
         lastUsed: z.ZodNumber;
         lastSwitchReason: z.ZodOptional<z.ZodEnum<{
+            best: "best";
+            initial: "initial";
             manual: "manual";
             "rate-limit": "rate-limit";
-            initial: "initial";
-            rotation: "rotation";
-            best: "best";
             restore: "restore";
+            rotation: "rotation";
         }>>;
         rateLimitResetTimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNumber>>>;
         coolingDownUntil: z.ZodOptional<z.ZodNumber>;
         cooldownReason: z.ZodOptional<z.ZodEnum<{
-            "rate-limit": "rate-limit";
             "auth-failure": "auth-failure";
             "network-error": "network-error";
+            "rate-limit": "rate-limit";
             "server-error": "server-error";
         }>>;
         authInvalidatedAt: z.ZodOptional<z.ZodNumber>;
@@ -520,8 +520,8 @@ export type AccountsJournalEntryFromSchema = z.infer<typeof AccountsJournalEntry
 declare const TokenFailureReasonSchema: z.ZodEnum<{
     http_error: "http_error";
     invalid_response: "invalid_response";
-    network_error: "network_error";
     missing_refresh: "missing_refresh";
+    network_error: "network_error";
     timeout: "timeout";
     unknown: "unknown";
 }>;
@@ -546,8 +546,8 @@ export declare const TokenFailureSchema: z.ZodObject<{
     reason: z.ZodOptional<z.ZodEnum<{
         http_error: "http_error";
         invalid_response: "invalid_response";
-        network_error: "network_error";
         missing_refresh: "missing_refresh";
+        network_error: "network_error";
         timeout: "timeout";
         unknown: "unknown";
     }>>;
@@ -570,8 +570,8 @@ export declare const TokenResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     reason: z.ZodOptional<z.ZodEnum<{
         http_error: "http_error";
         invalid_response: "invalid_response";
-        network_error: "network_error";
         missing_refresh: "missing_refresh";
+        network_error: "network_error";
         timeout: "timeout";
         unknown: "unknown";
     }>>;

package/dist/lib/ui/index.d.ts

@@ -5,5 +5,5 @@ export { displayWidth, truncateToWidth } from "./display-width.js";
 export { formatUiBadge, formatUiHeader, formatUiItem, formatUiKeyValue, formatUiSection, paintUiText, quotaToneFromLeftPercent, type UiTextTone, } from "./format.js";
 export { getUiRuntimeOptions, resetUiRuntimeOptions, setUiRuntimeOptions, type UiRuntimeOptions, } from "./runtime.js";
 export { select, type MenuItem, type SelectOptions } from "./select.js";
-export { createUiTheme, shouldDisableColor, type UiAccent, type UiColorProfile, type UiGlyphMode, type UiPalette, type UiTheme, } from "./theme.js";
+export { createUiTheme, resolveUiColorMode, shouldDisableColor, type ResolvedUiColorMode, type UiAccent, type UiColorMode, type UiColorProfile, type UiGlyphMode, type UiPalette, type UiTheme, } from "./theme.js";
 export { UI_COPY, formatCheckFlaggedLabel } from "./ui-copy.js";

package/dist/lib/ui/index.js

@@ -5,5 +5,5 @@ export { displayWidth, truncateToWidth } from "./display-width.js";
 export { formatUiBadge, formatUiHeader, formatUiItem, formatUiKeyValue, formatUiSection, paintUiText, quotaToneFromLeftPercent, } from "./format.js";
 export { getUiRuntimeOptions, resetUiRuntimeOptions, setUiRuntimeOptions, } from "./runtime.js";
 export { select } from "./select.js";
-export { createUiTheme, shouldDisableColor, } from "./theme.js";
+export { createUiTheme, resolveUiColorMode, shouldDisableColor, } from "./theme.js";
 export { UI_COPY, formatCheckFlaggedLabel } from "./ui-copy.js";

package/dist/lib/ui/runtime.d.ts

@@ -1,10 +1,12 @@
-import { type UiColorProfile, type UiGlyphMode, type UiPalette, type UiAccent, type UiTheme } from "./theme.js";
+import { type UiColorMode, type UiColorProfile, type UiGlyphMode, type UiPalette, type UiAccent, type UiTheme } from "./theme.js";
 export interface UiRuntimeOptions {
     v2Enabled: boolean;
     colorProfile: UiColorProfile;
     glyphMode: UiGlyphMode;
     palette: UiPalette;
     accent: UiAccent;
+    /** Requested background mode; `theme.colorMode` holds the resolved value. */
+    colorMode: UiColorMode;
     theme: UiTheme;
 }
 /**

package/dist/lib/ui/runtime.js

@@ -5,11 +5,13 @@ const DEFAULT_OPTIONS = {
     glyphMode: "ascii",
     palette: "green",
     accent: "green",
+    colorMode: "auto",
     theme: createUiTheme({
         profile: "truecolor",
         glyphMode: "ascii",
         palette: "green",
         accent: "green",
+        colorMode: "auto",
     }),
 };
 let runtimeOptions = { ...DEFAULT_OPTIONS };
@@ -35,13 +37,21 @@ export function setUiRuntimeOptions(options) {
     const glyphMode = options.glyphMode ?? runtimeOptions.glyphMode;
     const palette = options.palette ?? runtimeOptions.palette;
     const accent = options.accent ?? runtimeOptions.accent;
+    const colorMode = options.colorMode ?? runtimeOptions.colorMode;
     runtimeOptions = {
         v2Enabled,
         colorProfile,
         glyphMode,
         palette,
         accent,
-        theme: createUiTheme({ profile: colorProfile, glyphMode, palette, accent }),
+        colorMode,
+        theme: createUiTheme({
+            profile: colorProfile,
+            glyphMode,
+            palette,
+            accent,
+            colorMode,
+        }),
     };
     return runtimeOptions;
 }

package/dist/lib/ui/theme.d.ts

@@ -5,6 +5,8 @@ export type UiColorProfile = "ansi16" | "ansi256" | "truecolor";
 export type UiGlyphMode = "ascii" | "unicode" | "auto";
 export type UiPalette = "green" | "blue";
 export type UiAccent = "green" | "cyan" | "blue" | "yellow";
+export type UiColorMode = "auto" | "dark" | "light";
+export type ResolvedUiColorMode = "dark" | "light";
 interface UiGlyphSet {
     selected: string;
     unselected: string;
@@ -29,9 +31,21 @@ interface UiThemeColors {
 export interface UiTheme {
     profile: UiColorProfile;
     glyphMode: UiGlyphMode;
+    /** Resolved background mode ("auto" is never stored here). */
+    colorMode: ResolvedUiColorMode;
     glyphs: UiGlyphSet;
     colors: UiThemeColors;
 }
+/**
+ * Resolve the effective color mode for a theme.
+ *
+ * Resolution order:
+ *   - `CODEX_TUI_COLOR_MODE` env override (`"auto"`, `"dark"`, or `"light"`)
+ *   - the requested `mode` (`"dark"`/`"light"` win outright)
+ *   - `COLORFGBG` terminal-background detection
+ *   - `"dark"` (preserves the historical dark-on-dark styling by default)
+ */
+export declare function resolveUiColorMode(mode?: UiColorMode, env?: NodeJS.ProcessEnv): ResolvedUiColorMode;
 /**
  * Decide whether ANSI color output should be suppressed (ui-04).
  *
@@ -51,8 +65,11 @@ export declare function shouldDisableColor(env?: NodeJS.ProcessEnv, isTTY?: bool
  *   - glyphMode: glyph rendering mode; defaults to `"ascii"`.
  *   - palette: overall palette variant; defaults to `"green"`.
  *   - accent: accent color selection; defaults to `"green"`.
+ *   - colorMode: background mode; defaults to `"auto"`, which honors
+ *     `CODEX_TUI_COLOR_MODE`, then `COLORFGBG` detection, then `"dark"`.
  *   - disableColor: force the color-stripped theme regardless of env/TTY.
- * @returns The constructed UiTheme object containing `profile`, `glyphMode`, `glyphs`, and `colors`.
+ *   - env: environment override for detection and color gating; defaults to `process.env`.
+ * @returns The constructed UiTheme object containing `profile`, `glyphMode`, resolved `colorMode`, `glyphs`, and `colors`.
  *
  * @remarks
  * - Concurrency: creation is pure and side-effect free, safe to call concurrently.
@@ -64,6 +81,8 @@ export declare function createUiTheme(options?: {
     glyphMode?: UiGlyphMode;
     palette?: UiPalette;
     accent?: UiAccent;
+    colorMode?: UiColorMode;
     disableColor?: boolean;
+    env?: NodeJS.ProcessEnv;
 }): UiTheme;
 export {};