codex-multi-auth 0.1.0

package/dist/lib/ui/confirm.js

@@ -0,0 +1,29 @@
+import { select } from "./select.js";
+import { getUiRuntimeOptions } from "./runtime.js";
+/**
+ * Prompt the user with a Yes/No choice.
+ *
+ * Assumes a single interactive UI context; concurrent prompts may interleave. Does not access the filesystem (no Windows-specific filesystem effects). Callers should redact sensitive tokens from `message` before passing it to this prompt.
+ *
+ * @param message - The prompt text shown to the user
+ * @param defaultYes - If true, "Yes" is presented first and treated as the default ordering
+ * @returns `true` if the user selects "Yes", `false` otherwise
+ */
+export async function confirm(message, defaultYes = false) {
+    const ui = getUiRuntimeOptions();
+    const items = defaultYes
+        ? [
+            { label: "Yes", value: true },
+            { label: "No", value: false },
+        ]
+        : [
+            { label: "No", value: false },
+            { label: "Yes", value: true },
+        ];
+    const result = await select(items, {
+        message,
+        theme: ui.theme,
+    });
+    return result ?? false;
+}
+//# sourceMappingURL=confirm.js.map

package/dist/lib/ui/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../lib/ui/confirm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,UAAU,GAAG,KAAK;IAChE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU;QACvB,CAAC,CAAC;YACA,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;YAC7B,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;SAC7B;QACF,CAAC,CAAC;YACA,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;YAC7B,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC7B,CAAC;IAEJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE;QAClC,OAAO;QACP,KAAK,EAAE,EAAE,CAAC,KAAK;KACf,CAAC,CAAC;IACH,OAAO,MAAM,IAAI,KAAK,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,123 @@
+export declare const UI_COPY: {
+    readonly mainMenu: {
+        readonly title: "Accounts Dashboard";
+        readonly searchSubtitlePrefix: "Search:";
+        readonly quickStart: "Quick Actions";
+        readonly addAccount: "Add New Account";
+        readonly checkAccounts: "Run Health Check";
+        readonly bestAccount: "Pick Best Account";
+        readonly fixIssues: "Auto-Repair Issues";
+        readonly settings: "Settings";
+        readonly moreChecks: "Advanced Checks";
+        readonly refreshChecks: "Refresh All Accounts";
+        readonly checkFlagged: "Check Problem Accounts";
+        readonly accounts: "Saved Accounts";
+        readonly loadingLimits: "Fetching account limits...";
+        readonly noSearchMatches: "No accounts match your search";
+        readonly dangerZone: "Danger Zone";
+        readonly removeAllAccounts: "Delete All Accounts";
+        readonly helpCompact: "↑↓ Move | Enter Select | / Search | 1-9 Switch | Q Back";
+        readonly helpDetailed: "Arrow keys move, Enter selects, / searches, 1-9 switches account, Q goes back";
+    };
+    readonly accountDetails: {
+        readonly back: "Back";
+        readonly enable: "Enable Account";
+        readonly disable: "Disable Account";
+        readonly setCurrent: "Set As Current";
+        readonly refresh: "Re-Login";
+        readonly remove: "Delete Account";
+        readonly help: "↑↓ Move | Enter Select | S Use | R Sign In | D Delete | Q Back";
+    };
+    readonly oauth: {
+        readonly chooseModeTitle: "Sign-In Method";
+        readonly chooseModeSubtitle: "How do you want to sign in?";
+        readonly openBrowser: "Open Browser (Easy)";
+        readonly manualMode: "Manual / Incognito";
+        readonly back: "Back";
+        readonly chooseModeHelp: "↑↓ Move | Enter Select | 1 Easy | 2 Manual | Q Back";
+        readonly goTo: "Go to:";
+        readonly copyOk: "Login link copied.";
+        readonly copyFail: "Could not copy login link.";
+        readonly pastePrompt: "Paste callback URL or code here (Q to cancel):";
+        readonly browserOpened: "Browser opened.";
+        readonly browserOpenFail: "Could not open browser. Use this link:";
+        readonly waitingCallback: "Waiting for login callback on localhost:1455...";
+        readonly callbackMissed: "No callback received. Paste manually.";
+        readonly cancelled: "Sign-in cancelled.";
+        readonly cancelledBackToMenu: "Sign-in cancelled. Going back to menu.";
+    };
+    readonly returnFlow: {
+        readonly continuePrompt: "Press Enter to go back.";
+        readonly actionFailedPrompt: "Action failed. Press Enter to go back.";
+        readonly autoReturn: (seconds: number) => string;
+        readonly paused: "Paused. Press any key to continue.";
+        readonly working: "Running...";
+        readonly done: "Done.";
+        readonly failed: "Failed.";
+    };
+    readonly settings: {
+        readonly title: "Settings";
+        readonly subtitle: "Customize menu, behavior, and backend";
+        readonly help: "↑↓ Move | Enter Select | Q Back";
+        readonly sectionTitle: "Basic";
+        readonly advancedTitle: "Advanced";
+        readonly exitTitle: "Back";
+        readonly accountList: "Account List View";
+        readonly summaryFields: "Summary Line";
+        readonly behavior: "Menu Behavior";
+        readonly theme: "Color Theme";
+        readonly backend: "Backend Controls";
+        readonly back: "Back";
+        readonly previewHeading: "Live Preview";
+        readonly displayHeading: "Options";
+        readonly resetDefault: "Reset to Default";
+        readonly saveAndBack: "Save and Back";
+        readonly backNoSave: "Back Without Saving";
+        readonly accountListTitle: "Account List View";
+        readonly accountListSubtitle: "Choose row details and optional smart sorting";
+        readonly accountListHelp: "Enter Toggle | Number Toggle | M Sort | L Layout | S Save | Q Save+Back";
+        readonly summaryTitle: "Account Details Row";
+        readonly summarySubtitle: "Choose and order detail fields";
+        readonly summaryHelp: "Enter Toggle | 1-3 Toggle | [ ] Reorder | S Save | Q Save+Back";
+        readonly behaviorTitle: "Return Behavior";
+        readonly behaviorSubtitle: "Control how result screens return";
+        readonly behaviorHelp: "Enter Select | 1-3 Delay | P Pause | L AutoFetch | F Status | T TTL | S Save | Q Save+Back";
+        readonly themeTitle: "Color Theme";
+        readonly themeSubtitle: "Pick base color and accent";
+        readonly themeHelp: "Enter Select | 1-2 Base | S Save | Q Save+Back";
+        readonly backendTitle: "Backend Controls";
+        readonly backendSubtitle: "Tune sync, retry, and limit behavior";
+        readonly backendHelp: "Enter Open | 1-4 Category | S Save | R Reset | Q Save+Back";
+        readonly backendCategoriesHeading: "Categories";
+        readonly backendCategoryTitle: "Backend Category";
+        readonly backendCategoryHelp: "Enter Toggle/Adjust | +/- or [ ] Number | 1-9 Toggle | R Reset | Q Back";
+        readonly backendToggleHeading: "Switches";
+        readonly backendNumberHeading: "Numbers";
+        readonly backendDecrease: "Decrease Focused Value";
+        readonly backendIncrease: "Increase Focused Value";
+        readonly backendResetCategory: "Reset Category";
+        readonly backendBackToCategories: "Back to Categories";
+        readonly baseTheme: "Base Color";
+        readonly accentColor: "Accent Color";
+        readonly actionTiming: "Auto Return Delay";
+        readonly moveUp: "Move Focused Field Up";
+        readonly moveDown: "Move Focused Field Down";
+    };
+    readonly fallback: {
+        readonly addAnotherTip: "Tip: Use private mode or sign out before adding another account.";
+        readonly addAnotherQuestion: (count: number) => string;
+        readonly selectModePrompt: "(a) add, (c) check, (b) best, fi(x), (s) settings, (d) deep, (g) problem, (f) fresh, (q) back [a/c/b/x/s/d/g/f/q]: ";
+        readonly invalidModePrompt: "Use one of: a, c, b, x, s, d, g, f, q.";
+    };
+};
+/**
+ * Builds the "Check Problem Accounts" label, appending the flagged count when greater than zero.
+ *
+ * This function is pure and has no side effects, is safe for concurrent use, performs no filesystem
+ * access (including Windows-specific behavior), and does not perform any token redaction.
+ *
+ * @param flaggedCount - The number of flagged accounts to show; if greater than zero the count is appended in parentheses.
+ * @returns The resulting label string: the base label when `flaggedCount` is 0 or less, otherwise the base label followed by ` (count)`.
+ */
+export declare function formatCheckFlaggedLabel(flaggedCount: number): string;
+//# sourceMappingURL=copy.d.ts.map

package/dist/lib/ui/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../lib/ui/copy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAmDI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAwDA,MAAM;;;;CAK1B,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/lib/ui/copy.js

@@ -0,0 +1,127 @@
+export const UI_COPY = {
+    mainMenu: {
+        title: "Accounts Dashboard",
+        searchSubtitlePrefix: "Search:",
+        quickStart: "Quick Actions",
+        addAccount: "Add New Account",
+        checkAccounts: "Run Health Check",
+        bestAccount: "Pick Best Account",
+        fixIssues: "Auto-Repair Issues",
+        settings: "Settings",
+        moreChecks: "Advanced Checks",
+        refreshChecks: "Refresh All Accounts",
+        checkFlagged: "Check Problem Accounts",
+        accounts: "Saved Accounts",
+        loadingLimits: "Fetching account limits...",
+        noSearchMatches: "No accounts match your search",
+        dangerZone: "Danger Zone",
+        removeAllAccounts: "Delete All Accounts",
+        helpCompact: "↑↓ Move | Enter Select | / Search | 1-9 Switch | Q Back",
+        helpDetailed: "Arrow keys move, Enter selects, / searches, 1-9 switches account, Q goes back",
+    },
+    accountDetails: {
+        back: "Back",
+        enable: "Enable Account",
+        disable: "Disable Account",
+        setCurrent: "Set As Current",
+        refresh: "Re-Login",
+        remove: "Delete Account",
+        help: "↑↓ Move | Enter Select | S Use | R Sign In | D Delete | Q Back",
+    },
+    oauth: {
+        chooseModeTitle: "Sign-In Method",
+        chooseModeSubtitle: "How do you want to sign in?",
+        openBrowser: "Open Browser (Easy)",
+        manualMode: "Manual / Incognito",
+        back: "Back",
+        chooseModeHelp: "↑↓ Move | Enter Select | 1 Easy | 2 Manual | Q Back",
+        goTo: "Go to:",
+        copyOk: "Login link copied.",
+        copyFail: "Could not copy login link.",
+        pastePrompt: "Paste callback URL or code here (Q to cancel):",
+        browserOpened: "Browser opened.",
+        browserOpenFail: "Could not open browser. Use this link:",
+        waitingCallback: "Waiting for login callback on localhost:1455...",
+        callbackMissed: "No callback received. Paste manually.",
+        cancelled: "Sign-in cancelled.",
+        cancelledBackToMenu: "Sign-in cancelled. Going back to menu.",
+    },
+    returnFlow: {
+        continuePrompt: "Press Enter to go back.",
+        actionFailedPrompt: "Action failed. Press Enter to go back.",
+        autoReturn: (seconds) => `Returning in ${seconds}s... Press any key to pause.`,
+        paused: "Paused. Press any key to continue.",
+        working: "Running...",
+        done: "Done.",
+        failed: "Failed.",
+    },
+    settings: {
+        title: "Settings",
+        subtitle: "Customize menu, behavior, and backend",
+        help: "↑↓ Move | Enter Select | Q Back",
+        sectionTitle: "Basic",
+        advancedTitle: "Advanced",
+        exitTitle: "Back",
+        accountList: "Account List View",
+        summaryFields: "Summary Line",
+        behavior: "Menu Behavior",
+        theme: "Color Theme",
+        backend: "Backend Controls",
+        back: "Back",
+        previewHeading: "Live Preview",
+        displayHeading: "Options",
+        resetDefault: "Reset to Default",
+        saveAndBack: "Save and Back",
+        backNoSave: "Back Without Saving",
+        accountListTitle: "Account List View",
+        accountListSubtitle: "Choose row details and optional smart sorting",
+        accountListHelp: "Enter Toggle | Number Toggle | M Sort | L Layout | S Save | Q Save+Back",
+        summaryTitle: "Account Details Row",
+        summarySubtitle: "Choose and order detail fields",
+        summaryHelp: "Enter Toggle | 1-3 Toggle | [ ] Reorder | S Save | Q Save+Back",
+        behaviorTitle: "Return Behavior",
+        behaviorSubtitle: "Control how result screens return",
+        behaviorHelp: "Enter Select | 1-3 Delay | P Pause | L AutoFetch | F Status | T TTL | S Save | Q Save+Back",
+        themeTitle: "Color Theme",
+        themeSubtitle: "Pick base color and accent",
+        themeHelp: "Enter Select | 1-2 Base | S Save | Q Save+Back",
+        backendTitle: "Backend Controls",
+        backendSubtitle: "Tune sync, retry, and limit behavior",
+        backendHelp: "Enter Open | 1-4 Category | S Save | R Reset | Q Save+Back",
+        backendCategoriesHeading: "Categories",
+        backendCategoryTitle: "Backend Category",
+        backendCategoryHelp: "Enter Toggle/Adjust | +/- or [ ] Number | 1-9 Toggle | R Reset | Q Back",
+        backendToggleHeading: "Switches",
+        backendNumberHeading: "Numbers",
+        backendDecrease: "Decrease Focused Value",
+        backendIncrease: "Increase Focused Value",
+        backendResetCategory: "Reset Category",
+        backendBackToCategories: "Back to Categories",
+        baseTheme: "Base Color",
+        accentColor: "Accent Color",
+        actionTiming: "Auto Return Delay",
+        moveUp: "Move Focused Field Up",
+        moveDown: "Move Focused Field Down",
+    },
+    fallback: {
+        addAnotherTip: "Tip: Use private mode or sign out before adding another account.",
+        addAnotherQuestion: (count) => `Add another account? (${count} added) (y/n): `,
+        selectModePrompt: "(a) add, (c) check, (b) best, fi(x), (s) settings, (d) deep, (g) problem, (f) fresh, (q) back [a/c/b/x/s/d/g/f/q]: ",
+        invalidModePrompt: "Use one of: a, c, b, x, s, d, g, f, q.",
+    },
+};
+/**
+ * Builds the "Check Problem Accounts" label, appending the flagged count when greater than zero.
+ *
+ * This function is pure and has no side effects, is safe for concurrent use, performs no filesystem
+ * access (including Windows-specific behavior), and does not perform any token redaction.
+ *
+ * @param flaggedCount - The number of flagged accounts to show; if greater than zero the count is appended in parentheses.
+ * @returns The resulting label string: the base label when `flaggedCount` is 0 or less, otherwise the base label followed by ` (count)`.
+ */
+export function formatCheckFlaggedLabel(flaggedCount) {
+    return flaggedCount > 0
+        ? `${UI_COPY.mainMenu.checkFlagged} (${flaggedCount})`
+        : UI_COPY.mainMenu.checkFlagged;
+}
+//# sourceMappingURL=copy.js.map

package/dist/lib/ui/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../lib/ui/copy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,QAAQ,EAAE;QACT,KAAK,EAAE,oBAAoB;QAC3B,oBAAoB,EAAE,SAAS;QAC/B,UAAU,EAAE,eAAe;QAC3B,UAAU,EAAE,iBAAiB;QAC7B,aAAa,EAAE,kBAAkB;QACjC,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,oBAAoB;QAC/B,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,iBAAiB;QAC7B,aAAa,EAAE,sBAAsB;QACrC,YAAY,EAAE,wBAAwB;QACtC,QAAQ,EAAE,gBAAgB;QAC1B,aAAa,EAAE,4BAA4B;QAC3C,eAAe,EAAE,+BAA+B;QAChD,UAAU,EAAE,aAAa;QACzB,iBAAiB,EAAE,qBAAqB;QACxC,WAAW,EAAE,yDAAyD;QACtE,YAAY,EAAE,+EAA+E;KAC7F;IACD,cAAc,EAAE;QACf,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,iBAAiB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,gEAAgE;KACtE;IACD,KAAK,EAAE;QACN,eAAe,EAAE,gBAAgB;QACjC,kBAAkB,EAAE,6BAA6B;QACjD,WAAW,EAAE,qBAAqB;QAClC,UAAU,EAAE,oBAAoB;QAChC,IAAI,EAAE,MAAM;QACZ,cAAc,EAAE,qDAAqD;QACrE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,oBAAoB;QAC5B,QAAQ,EAAE,4BAA4B;QACtC,WAAW,EAAE,gDAAgD;QAC7D,aAAa,EAAE,iBAAiB;QAChC,eAAe,EAAE,wCAAwC;QACzD,eAAe,EAAE,iDAAiD;QAClE,cAAc,EAAE,uCAAuC;QACvD,SAAS,EAAE,oBAAoB;QAC/B,mBAAmB,EAAE,wCAAwC;KAC7D;IACD,UAAU,EAAE;QACX,cAAc,EAAE,yBAAyB;QACzC,kBAAkB,EAAE,wCAAwC;QAC5D,UAAU,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,gBAAgB,OAAO,8BAA8B;QACtF,MAAM,EAAE,oCAAoC;QAC5C,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,SAAS;KACjB;IACD,QAAQ,EAAE;QACT,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,uCAAuC;QACjD,IAAI,EAAE,iCAAiC;QACvC,YAAY,EAAE,OAAO;QACrB,aAAa,EAAE,UAAU;QACzB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,cAAc;QAC7B,QAAQ,EAAE,eAAe;QACzB,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,MAAM;QACZ,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,SAAS;QACzB,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,eAAe;QAC5B,UAAU,EAAE,qBAAqB;QACjC,gBAAgB,EAAE,mBAAmB;QACrC,mBAAmB,EAAE,+CAA+C;QACpE,eAAe,EAAE,yEAAyE;QAC1F,YAAY,EAAE,qBAAqB;QACnC,eAAe,EAAE,gCAAgC;QACjD,WAAW,EAAE,gEAAgE;QAC7E,aAAa,EAAE,iBAAiB;QAChC,gBAAgB,EAAE,mCAAmC;QACrD,YAAY,EAAE,4FAA4F;QAC1G,UAAU,EAAE,aAAa;QACzB,aAAa,EAAE,4BAA4B;QAC3C,SAAS,EAAE,gDAAgD;QAC3D,YAAY,EAAE,kBAAkB;QAChC,eAAe,EAAE,sCAAsC;QACvD,WAAW,EAAE,4DAA4D;QACzE,wBAAwB,EAAE,YAAY;QACtC,oBAAoB,EAAE,kBAAkB;QACxC,mBAAmB,EAAE,yEAAyE;QAC9F,oBAAoB,EAAE,UAAU;QAChC,oBAAoB,EAAE,SAAS;QAC/B,eAAe,EAAE,wBAAwB;QACzC,eAAe,EAAE,wBAAwB;QACzC,oBAAoB,EAAE,gBAAgB;QACtC,uBAAuB,EAAE,oBAAoB;QAC7C,SAAS,EAAE,YAAY;QACvB,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,mBAAmB;QACjC,MAAM,EAAE,uBAAuB;QAC/B,QAAQ,EAAE,yBAAyB;KACnC;IACD,QAAQ,EAAE;QACT,aAAa,EAAE,kEAAkE;QACjF,kBAAkB,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,yBAAyB,KAAK,iBAAiB;QACtF,gBAAgB,EACf,qHAAqH;QACtH,iBAAiB,EAAE,wCAAwC;KAC3D;CACQ,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC3D,OAAO,YAAY,GAAG,CAAC;QACtB,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,KAAK,YAAY,GAAG;QACtD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,62 @@
+import type { UiRuntimeOptions } from "./runtime.js";
+export type UiTextTone = "primary" | "heading" | "accent" | "muted" | "success" | "warning" | "danger" | "normal";
+/**
+ * Colorize a text string according to the UI theme and tone.
+ *
+ * If `ui.v2Enabled` is false or the tone maps to no color, the original `text` is returned unchanged.
+ *
+ * Concurrency: pure and side-effect-free; safe to call concurrently.
+ * Filesystem: performs no I/O and behaves identically on Windows and other platforms.
+ * Token redaction: this function only wraps `text` with theme color tokens and does not redact or alter token contents.
+ *
+ * @param ui - Runtime UI options (used to determine theme colors and whether v2 styling is enabled)
+ * @param text - The text to colorize
+ * @param tone - The text tone to apply; when the tone maps to no color (e.g., "normal") the text is returned as-is
+ * @returns The input `text` wrapped with the theme color start token for `tone` and the theme reset token, or the original `text` if no color is applied
+ */
+export declare function paintUiText(ui: UiRuntimeOptions, text: string, tone?: UiTextTone): string;
+export declare function formatUiHeader(ui: UiRuntimeOptions, title: string): string[];
+export declare function formatUiSection(ui: UiRuntimeOptions, title: string): string[];
+export declare function formatUiItem(ui: UiRuntimeOptions, text: string, tone?: UiTextTone): string;
+/**
+ * Format a key/value pair for display, applying muted styling to the key and a configurable tone to the value when v2 UI is enabled.
+ *
+ * @param ui - Runtime UI options that control theming and v2 behavior
+ * @param key - The label for the value; a trailing colon is added when v2 is enabled
+ * @param value - The value text to display
+ * @param valueTone - Tone to apply to the value (e.g., "accent", "success"); "normal" leaves the value uncolored
+ *
+ * Concurrency: pure and safe to call concurrently.
+ * Windows: ANSI or truecolor sequences may not be interpreted on older Windows terminals.
+ * Redaction: this function does not redact sensitive tokens; callers must provide already-redacted values if needed.
+ *
+ * @returns The formatted key/value string, optionally wrapped with theme color sequences when v2 is enabled
+ */
+export declare function formatUiKeyValue(ui: UiRuntimeOptions, key: string, value: string, valueTone?: UiTextTone): string;
+/**
+ * Format a badge label for the UI, applying tone-specific styling when v2 UI is enabled.
+ *
+ * @param ui - Runtime UI options that control styling, color profile, and v2 enablement
+ * @param label - Text to display inside the badge (will be wrapped in square brackets)
+ * @param tone - Visual tone for the badge; must not be `"normal"` or `"heading"`
+ * @returns The badge string; when v2 is disabled this is `"[label]"`, otherwise the label wrapped with start/end styling sequences
+ *
+ * @remarks
+ * Concurrency: safe to call concurrently; function is pure with respect to provided inputs.
+ * Windows filesystem: output contains ANSI/ANSI256/truecolor escape sequences when v2 is enabled—terminal support may vary on Windows consoles.
+ * Token redaction: this function does not perform any secret/token redaction; callers should redact sensitive values in `label` before calling if needed.
+ */
+export declare function formatUiBadge(ui: UiRuntimeOptions, label: string, tone?: Exclude<UiTextTone, "normal" | "heading">): string;
+/**
+ * Selects a UI tone representing quota health based on remaining percentage.
+ *
+ * @param leftPercent - Percentage of quota remaining (typically 0–100)
+ * @returns `'success'` if `leftPercent` > 35, `'warning'` if `leftPercent` ≤ 35 and > 15, `'danger'` if `leftPercent` ≤ 15
+ *
+ * @remarks
+ * Concurrency: pure and side-effect-free; safe to call from concurrent contexts.
+ * Windows filesystem: no filesystem interaction.
+ * Token redaction: does not handle or emit sensitive tokens.
+ */
+export declare function quotaToneFromLeftPercent(leftPercent: number): Extract<UiTextTone, "success" | "warning" | "danger">;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/ui/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../lib/ui/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,UAAU,GACnB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAuGZ;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAqB,GAAG,MAAM,CAKnG;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO5E;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAG7E;AAED,wBAAgB,YAAY,CAC3B,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,UAAqB,GACzB,MAAM,CAIR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC/B,EAAE,EAAE,gBAAgB,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,UAAqB,GAC9B,MAAM,CAKR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC5B,EAAE,EAAE,gBAAgB,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAY,GACxD,MAAM,CAKR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,CAIvD"}

package/dist/lib/ui/format.js

@@ -0,0 +1,205 @@
+const TONE_TO_COLOR = {
+    primary: "primary",
+    heading: "heading",
+    accent: "accent",
+    muted: "muted",
+    success: "success",
+    warning: "warning",
+    danger: "danger",
+    normal: null,
+};
+/**
+ * Produce the ANSI/ANSI256/truecolor start and theme reset sequences for a badge given UI options and tone.
+ *
+ * @param ui - Runtime UI options used to select color profile, palette, accent, and the theme reset sequence
+ * @param tone - Badge tone: "primary", "accent", "success", "warning", "danger", or "muted"
+ * @returns The `start` escape sequence to begin badge styling and the `end` reset sequence from the theme
+ *
+ * Concurrency: pure and safe for concurrent use.
+ * Windows consoles: returned ANSI sequences may not be interpreted on older Windows terminals and can appear verbatim.
+ * Token redaction: returned strings contain raw ANSI codes and should be treated as presentation data (avoid leaking in sensitive logs).
+ */
+function badgeStyleForTone(ui, tone) {
+    const end = ui.theme.colors.reset;
+    const isBlue = ui.palette === "blue";
+    const accent = ui.accent;
+    if (ui.colorProfile === "truecolor") {
+        const accentStart = (() => {
+            if (accent === "cyan")
+                return "\x1b[48;2;8;89;106m\x1b[38;2;224;242;254m\x1b[1m";
+            if (accent === "blue")
+                return "\x1b[48;2;30;64;175m\x1b[38;2;219;234;254m\x1b[1m";
+            if (accent === "yellow")
+                return "\x1b[48;2;120;53;15m\x1b[38;2;255;247;237m\x1b[1m";
+            return "\x1b[48;2;20;83;45m\x1b[38;2;220;252;231m\x1b[1m";
+        })();
+        const successStart = isBlue
+            ? "\x1b[48;2;30;64;175m\x1b[38;2;219;234;254m\x1b[1m"
+            : "\x1b[48;2;20;83;45m\x1b[38;2;220;252;231m\x1b[1m";
+        switch (tone) {
+            case "primary":
+            case "accent":
+                return { start: accentStart, end };
+            case "success":
+                return { start: successStart, end };
+            case "warning":
+                return { start: "\x1b[48;2;120;53;15m\x1b[38;2;255;247;237m\x1b[1m", end };
+            case "danger":
+                return { start: "\x1b[48;2;127;29;29m\x1b[38;2;254;226;226m\x1b[1m", end };
+            case "muted":
+                return { start: "\x1b[48;2;51;65;85m\x1b[38;2;226;232;240m\x1b[1m", end };
+        }
+    }
+    if (ui.colorProfile === "ansi256") {
+        const accentStart = (() => {
+            if (accent === "cyan")
+                return "\x1b[48;5;23m\x1b[38;5;159m\x1b[1m";
+            if (accent === "blue")
+                return "\x1b[48;5;19m\x1b[38;5;153m\x1b[1m";
+            if (accent === "yellow")
+                return "\x1b[48;5;94m\x1b[38;5;230m\x1b[1m";
+            return "\x1b[48;5;22m\x1b[38;5;157m\x1b[1m";
+        })();
+        const successStart = isBlue
+            ? "\x1b[48;5;19m\x1b[38;5;153m\x1b[1m"
+            : "\x1b[48;5;22m\x1b[38;5;157m\x1b[1m";
+        switch (tone) {
+            case "primary":
+            case "accent":
+                return { start: accentStart, end };
+            case "success":
+                return { start: successStart, end };
+            case "warning":
+                return { start: "\x1b[48;5;94m\x1b[38;5;230m\x1b[1m", end };
+            case "danger":
+                return { start: "\x1b[48;5;88m\x1b[38;5;224m\x1b[1m", end };
+            case "muted":
+                return { start: "\x1b[48;5;240m\x1b[38;5;255m\x1b[1m", end };
+        }
+    }
+    const accentStart = (() => {
+        if (accent === "cyan")
+            return "\x1b[46m\x1b[30m\x1b[1m";
+        if (accent === "blue")
+            return "\x1b[44m\x1b[97m\x1b[1m";
+        if (accent === "yellow")
+            return "\x1b[43m\x1b[30m\x1b[1m";
+        return "\x1b[42m\x1b[30m\x1b[1m";
+    })();
+    const successStart = isBlue ? "\x1b[44m\x1b[97m\x1b[1m" : "\x1b[42m\x1b[30m\x1b[1m";
+    switch (tone) {
+        case "primary":
+        case "accent":
+            return { start: accentStart, end };
+        case "success":
+            return { start: successStart, end };
+        case "warning":
+            return { start: "\x1b[43m\x1b[30m\x1b[1m", end };
+        case "danger":
+            return { start: "\x1b[41m\x1b[97m\x1b[1m", end };
+        case "muted":
+            return { start: "\x1b[100m\x1b[97m\x1b[1m", end };
+    }
+}
+/**
+ * Colorize a text string according to the UI theme and tone.
+ *
+ * If `ui.v2Enabled` is false or the tone maps to no color, the original `text` is returned unchanged.
+ *
+ * Concurrency: pure and side-effect-free; safe to call concurrently.
+ * Filesystem: performs no I/O and behaves identically on Windows and other platforms.
+ * Token redaction: this function only wraps `text` with theme color tokens and does not redact or alter token contents.
+ *
+ * @param ui - Runtime UI options (used to determine theme colors and whether v2 styling is enabled)
+ * @param text - The text to colorize
+ * @param tone - The text tone to apply; when the tone maps to no color (e.g., "normal") the text is returned as-is
+ * @returns The input `text` wrapped with the theme color start token for `tone` and the theme reset token, or the original `text` if no color is applied
+ */
+export function paintUiText(ui, text, tone = "normal") {
+    if (!ui.v2Enabled)
+        return text;
+    const colorKey = TONE_TO_COLOR[tone];
+    if (!colorKey)
+        return text;
+    return `${ui.theme.colors[colorKey]}${text}${ui.theme.colors.reset}`;
+}
+export function formatUiHeader(ui, title) {
+    if (!ui.v2Enabled)
+        return [title];
+    const divider = "-".repeat(Math.max(8, title.length));
+    return [
+        paintUiText(ui, title, "heading"),
+        paintUiText(ui, divider, "muted"),
+    ];
+}
+export function formatUiSection(ui, title) {
+    if (!ui.v2Enabled)
+        return [title];
+    return [paintUiText(ui, title, "accent")];
+}
+export function formatUiItem(ui, text, tone = "normal") {
+    if (!ui.v2Enabled)
+        return `- ${text}`;
+    const bullet = paintUiText(ui, ui.theme.glyphs.bullet, "muted");
+    return `${bullet} ${paintUiText(ui, text, tone)}`;
+}
+/**
+ * Format a key/value pair for display, applying muted styling to the key and a configurable tone to the value when v2 UI is enabled.
+ *
+ * @param ui - Runtime UI options that control theming and v2 behavior
+ * @param key - The label for the value; a trailing colon is added when v2 is enabled
+ * @param value - The value text to display
+ * @param valueTone - Tone to apply to the value (e.g., "accent", "success"); "normal" leaves the value uncolored
+ *
+ * Concurrency: pure and safe to call concurrently.
+ * Windows: ANSI or truecolor sequences may not be interpreted on older Windows terminals.
+ * Redaction: this function does not redact sensitive tokens; callers must provide already-redacted values if needed.
+ *
+ * @returns The formatted key/value string, optionally wrapped with theme color sequences when v2 is enabled
+ */
+export function formatUiKeyValue(ui, key, value, valueTone = "normal") {
+    if (!ui.v2Enabled)
+        return `${key}: ${value}`;
+    const keyText = paintUiText(ui, `${key}:`, "muted");
+    const valueText = paintUiText(ui, value, valueTone);
+    return `${keyText} ${valueText}`;
+}
+/**
+ * Format a badge label for the UI, applying tone-specific styling when v2 UI is enabled.
+ *
+ * @param ui - Runtime UI options that control styling, color profile, and v2 enablement
+ * @param label - Text to display inside the badge (will be wrapped in square brackets)
+ * @param tone - Visual tone for the badge; must not be `"normal"` or `"heading"`
+ * @returns The badge string; when v2 is disabled this is `"[label]"`, otherwise the label wrapped with start/end styling sequences
+ *
+ * @remarks
+ * Concurrency: safe to call concurrently; function is pure with respect to provided inputs.
+ * Windows filesystem: output contains ANSI/ANSI256/truecolor escape sequences when v2 is enabled—terminal support may vary on Windows consoles.
+ * Token redaction: this function does not perform any secret/token redaction; callers should redact sensitive values in `label` before calling if needed.
+ */
+export function formatUiBadge(ui, label, tone = "accent") {
+    const text = `[${label}]`;
+    if (!ui.v2Enabled)
+        return text;
+    const style = badgeStyleForTone(ui, tone);
+    return `${style.start}${text}${style.end}`;
+}
+/**
+ * Selects a UI tone representing quota health based on remaining percentage.
+ *
+ * @param leftPercent - Percentage of quota remaining (typically 0–100)
+ * @returns `'success'` if `leftPercent` > 35, `'warning'` if `leftPercent` ≤ 35 and > 15, `'danger'` if `leftPercent` ≤ 15
+ *
+ * @remarks
+ * Concurrency: pure and side-effect-free; safe to call from concurrent contexts.
+ * Windows filesystem: no filesystem interaction.
+ * Token redaction: does not handle or emit sensitive tokens.
+ */
+export function quotaToneFromLeftPercent(leftPercent) {
+    if (leftPercent <= 15)
+        return "danger";
+    if (leftPercent <= 35)
+        return "warning";
+    return "success";
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/ui/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../lib/ui/format.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,43 @@
+import { 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;
+    theme: UiTheme;
+}
+/**
+ * Update UI runtime options and recompute the derived theme.
+ *
+ * Unspecified fields in `options` retain their current values; the exported `runtimeOptions`
+ * object is replaced with a new object containing the resolved fields and a newly created
+ * `theme` based on `colorProfile`, `glyphMode`, `palette`, and `accent`.
+ *
+ * Concurrency: callers should synchronize externally if multiple callers may update options
+ * concurrently (updates are a single replacement and may race). Filesystem: this function
+ * performs no filesystem operations and is unaffected by Windows filesystem semantics.
+ * Token handling: this function does not perform token redaction or logging—sensitive
+ * values should be redacted by the caller before passing them in.
+ *
+ * @param options - Partial runtime options (omit `theme`); any omitted fields keep their current values
+ * @returns The resolved `UiRuntimeOptions` including the recomputed `theme`
+ */
+export declare function setUiRuntimeOptions(options: Partial<Omit<UiRuntimeOptions, "theme">>): UiRuntimeOptions;
+/**
+ * Accesses the current UI runtime options.
+ *
+ * The returned object reflects the current in-memory runtime configuration; concurrent callers may observe updates made by others, so external synchronization is recommended when mutating options. This function performs no filesystem I/O (including on Windows) and the runtime options contain no sensitive tokens that require redaction.
+ *
+ * @returns The current UiRuntimeOptions object
+ */
+export declare function getUiRuntimeOptions(): UiRuntimeOptions;
+/**
+ * Reset the UI runtime options to the default configuration.
+ *
+ * This replaces the global runtime options with a fresh shallow copy of DEFAULT_OPTIONS. Concurrent callers may observe the updated options immediately; callers that need isolation should clone the returned object. This operation performs no filesystem access (including on Windows). The runtime options contain only configuration fields and do not include sensitive tokens.
+ *
+ * @returns The new runtime options object set to the defaults
+ */
+export declare function resetUiRuntimeOptions(): UiRuntimeOptions;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../lib/ui/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CACf;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,GAC/C,gBAAgB,CAelB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAGxD"}