codex-multi-auth 0.1.0

package/dist/lib/dashboard-settings.js

@@ -0,0 +1,327 @@
+import { existsSync, promises as fs } from "node:fs";
+import { join } from "node:path";
+import { getCodexMultiAuthDir } from "./runtime-paths.js";
+import { logWarn } from "./logger.js";
+import { sleep } from "./utils.js";
+import { getUnifiedSettingsPath, loadUnifiedDashboardSettings, saveUnifiedDashboardSettings, } from "./unified-settings.js";
+export const DASHBOARD_DISPLAY_SETTINGS_VERSION = 1;
+export const DEFAULT_DASHBOARD_DISPLAY_SETTINGS = {
+    showPerAccountRows: true,
+    showQuotaDetails: true,
+    showForecastReasons: true,
+    showRecommendations: true,
+    showLiveProbeNotes: true,
+    actionAutoReturnMs: 2_000,
+    actionPauseOnKey: true,
+    menuAutoFetchLimits: true,
+    menuSortEnabled: true,
+    menuSortMode: "ready-first",
+    menuSortPinCurrent: false,
+    menuSortQuickSwitchVisibleRow: true,
+    uiThemePreset: "green",
+    uiAccentColor: "green",
+    menuShowStatusBadge: true,
+    menuShowCurrentBadge: true,
+    menuShowLastUsed: true,
+    menuShowQuotaSummary: true,
+    menuShowQuotaCooldown: true,
+    menuShowFetchStatus: true,
+    menuShowDetailsForUnselectedRows: false,
+    menuLayoutMode: "compact-details",
+    menuQuotaTtlMs: 5 * 60_000,
+    menuFocusStyle: "row-invert",
+    menuHighlightCurrentRow: true,
+    menuStatuslineFields: ["last-used", "limits", "status"],
+};
+const DASHBOARD_SETTINGS_PATH = join(getCodexMultiAuthDir(), "dashboard-settings.json");
+const RETRYABLE_READ_CODES = new Set(["EBUSY", "EPERM", "EAGAIN"]);
+const LEGACY_READ_MAX_ATTEMPTS = 4;
+const LEGACY_READ_BASE_DELAY_MS = 20;
+/**
+ * Checks whether a value is a non-null object that can be treated as a string-keyed record.
+ *
+ * @param value - Value to test
+ * @returns `true` if `value` is an object and not `null` (narrowed to `Record<string, unknown>`), `false` otherwise.
+ */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isRetryableReadError(error) {
+    const code = error?.code;
+    return typeof code === "string" && RETRYABLE_READ_CODES.has(code);
+}
+async function readLegacySettingsFile(path) {
+    let lastError;
+    for (let attempt = 0; attempt < LEGACY_READ_MAX_ATTEMPTS; attempt += 1) {
+        try {
+            return await fs.readFile(path, "utf8");
+        }
+        catch (error) {
+            if (!isRetryableReadError(error) || attempt + 1 >= LEGACY_READ_MAX_ATTEMPTS) {
+                throw error;
+            }
+            lastError = error;
+            await sleep(LEGACY_READ_BASE_DELAY_MS * 2 ** attempt);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error("Failed to read legacy dashboard settings");
+}
+/**
+ * Coerces a value to a boolean, using a provided fallback when the input is not a boolean.
+ *
+ * @param value - The input to evaluate; only `true` and `false` are accepted as boolean values
+ * @param fallback - The boolean to return when `value` is not a boolean
+ * @returns The boolean `value` if it is a boolean, otherwise `fallback`
+ */
+function normalizeBoolean(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
+/**
+ * Normalize an input value into a dashboard theme preset.
+ *
+ * @param value - Untrusted input to coerce to a theme preset
+ * @returns `"blue"` if `value` is exactly `"blue"`, `"green"` otherwise
+ */
+function normalizeThemePreset(value) {
+    return value === "blue" ? "blue" : "green";
+}
+/**
+ * Normalize an input value into an allowed dashboard accent color, defaulting to green.
+ *
+ * @param value - Input value to coerce into an accent color
+ * @returns `'cyan'`, `'blue'`, or `'yellow'` if `value` matches one of those strings; otherwise `'green'`
+ */
+function normalizeAccentColor(value) {
+    switch (value) {
+        case "cyan":
+            return "cyan";
+        case "blue":
+            return "blue";
+        case "yellow":
+            return "yellow";
+        default:
+            return "green";
+    }
+}
+/**
+ * Validate a dashboard layout mode, allowing only "expanded-rows".
+ *
+ * @param value - Candidate value to validate as a layout mode
+ * @param fallback - Value to return when `value` is not `"expanded-rows"`
+ * @returns `"expanded-rows"` if `value` strictly equals that string, otherwise `fallback`
+ */
+function normalizeLayoutMode(value, fallback) {
+    return value === "expanded-rows" ? "expanded-rows" : fallback;
+}
+/**
+ * Coerces an arbitrary value into the dashboard focus style.
+ *
+ * @param value - Value to coerce into a DashboardFocusStyle
+ * @returns The normalized focus style; always `'row-invert'`.
+ */
+function normalizeFocusStyle(value) {
+    return value === "row-invert" ? "row-invert" : "row-invert";
+}
+/**
+ * Normalize a numeric TTL (milliseconds) into a validated, rounded, bounded integer.
+ *
+ * @param value - The input value to normalize; if not a finite number, the function falls back.
+ * @param fallback - Value returned when `value` is not a finite number.
+ * @returns A rounded integer number of milliseconds between 60,000 and 1,800,000 (30 minutes), or `fallback` if `value` is invalid.
+ */
+function normalizeQuotaTtlMs(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const rounded = Math.round(value);
+    return Math.max(60_000, Math.min(30 * 60_000, rounded));
+}
+/**
+ * Normalize a candidate account sort mode to a known mode.
+ *
+ * @param value - The input value to validate as an account sort mode
+ * @param fallback - Mode to use if `value` is not a recognized sort mode
+ * @returns The validated `DashboardAccountSortMode`: `ready-first` or `manual` if `value` matches, otherwise `fallback`
+ */
+function normalizeAccountSortMode(value, fallback) {
+    if (value === "ready-first" || value === "manual") {
+        return value;
+    }
+    return fallback;
+}
+/**
+ * Coerces an untrusted value to an integer millisecond timeout between 0 and 10000.
+ *
+ * This rounds and clamps numeric input; if the input is not a finite number the provided
+ * fallback is returned. Safe to call concurrently. Filesystem semantics, Windows atomicity,
+ * and unified-settings token redaction are not applicable to this operation.
+ *
+ * @param value - The untrusted input to normalize
+ * @param fallback - The numeric fallback to use when `value` is invalid
+ * @returns A millisecond timeout value between 0 and 10000 inclusive
+ */
+function normalizeAutoReturnMs(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const rounded = Math.round(value);
+    return Math.max(0, Math.min(10_000, rounded));
+}
+/**
+ * Coerces an arbitrary value into a deduplicated, order-preserving list of allowed statusline fields.
+ *
+ * @param value - The input to normalize; may be any value. Non-string entries, unknown fields, and duplicates are discarded.
+ * @returns An array of `DashboardStatuslineField` in their original order with duplicates removed. If the input is not an array or yields no valid fields, returns the default statusline fields.
+ */
+function normalizeStatuslineFields(value) {
+    const defaultFields = [...(DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuStatuslineFields ?? [])];
+    if (!Array.isArray(value))
+        return defaultFields;
+    const allowed = new Set(["last-used", "limits", "status"]);
+    const fields = [];
+    for (const entry of value) {
+        if (typeof entry !== "string")
+            continue;
+        if (!allowed.has(entry))
+            continue;
+        const typed = entry;
+        if (!fields.includes(typed)) {
+            fields.push(typed);
+        }
+    }
+    return fields.length > 0 ? fields : defaultFields;
+}
+/**
+ * Convert a DashboardDisplaySettings object into a plain record suitable for JSON serialization and persistence.
+ *
+ * @param value - The dashboard display settings to serialize
+ * @returns A shallow Record<string, unknown> containing the same keys and values as `value`, ready for JSON encoding
+ *
+ * Notes:
+ * - This function performs no I/O and is safe to call concurrently.
+ * - It does not perform any token redaction or platform-specific path normalization; behavior is identical across platforms (including Windows).
+ */
+function toJsonRecord(value) {
+    const record = {};
+    for (const [key, fieldValue] of Object.entries(value)) {
+        record[key] = fieldValue;
+    }
+    return record;
+}
+/**
+ * Filesystem path to the unified dashboard settings file.
+ *
+ * This path is the canonical location used by the load/save helpers. Callers should assume the file may be concurrently modified by other processes and use atomic write strategies when persisting. On Windows the returned path may contain backslashes; redact any sensitive tokens before logging or external reporting.
+ *
+ * @returns The absolute path to the unified dashboard settings file.
+ */
+export function getDashboardSettingsPath() {
+    return getUnifiedSettingsPath();
+}
+/**
+ * Normalize an untrusted value into a complete, validated DashboardDisplaySettings object.
+ *
+ * Produces a settings object where missing or invalid fields are replaced with sensible defaults,
+ * layout-derived fields are resolved, numeric values are clamped to allowed ranges, and enumerations
+ * are coerced to allowed values.
+ *
+ * Concurrency: pure and deterministic; safe to call concurrently. This function performs no I/O,
+ * so Windows filesystem semantics do not apply. It does not perform token redaction or any
+ * sensitive-data filtering.
+ *
+ * @param value - The input to normalize (may be any type, typically parsed JSON or a partial settings record)
+ * @returns A DashboardDisplaySettings object with all fields validated and defaulted
+ */
+export function normalizeDashboardDisplaySettings(value) {
+    if (!isRecord(value)) {
+        return { ...DEFAULT_DASHBOARD_DISPLAY_SETTINGS };
+    }
+    const derivedLayoutMode = normalizeLayoutMode(value.menuLayoutMode, value.menuShowDetailsForUnselectedRows === true ? "expanded-rows" : "compact-details");
+    return {
+        showPerAccountRows: normalizeBoolean(value.showPerAccountRows, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.showPerAccountRows),
+        showQuotaDetails: normalizeBoolean(value.showQuotaDetails, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.showQuotaDetails),
+        showForecastReasons: normalizeBoolean(value.showForecastReasons, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.showForecastReasons),
+        showRecommendations: normalizeBoolean(value.showRecommendations, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.showRecommendations),
+        showLiveProbeNotes: normalizeBoolean(value.showLiveProbeNotes, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.showLiveProbeNotes),
+        actionAutoReturnMs: normalizeAutoReturnMs(value.actionAutoReturnMs, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.actionAutoReturnMs ?? 2_000),
+        actionPauseOnKey: normalizeBoolean(value.actionPauseOnKey, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.actionPauseOnKey ?? true),
+        menuAutoFetchLimits: normalizeBoolean(value.menuAutoFetchLimits, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuAutoFetchLimits ?? true),
+        menuSortEnabled: normalizeBoolean(value.menuSortEnabled, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuSortEnabled ?? false),
+        menuSortMode: normalizeAccountSortMode(value.menuSortMode, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuSortMode ?? "ready-first"),
+        menuSortPinCurrent: normalizeBoolean(value.menuSortPinCurrent, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuSortPinCurrent ?? true),
+        menuSortQuickSwitchVisibleRow: normalizeBoolean(value.menuSortQuickSwitchVisibleRow, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuSortQuickSwitchVisibleRow ?? true),
+        uiThemePreset: normalizeThemePreset(value.uiThemePreset),
+        uiAccentColor: normalizeAccentColor(value.uiAccentColor),
+        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),
+        menuShowQuotaSummary: normalizeBoolean(value.menuShowQuotaSummary, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowQuotaSummary ?? true),
+        menuShowQuotaCooldown: normalizeBoolean(value.menuShowQuotaCooldown, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowQuotaCooldown ?? true),
+        menuShowFetchStatus: normalizeBoolean(value.menuShowFetchStatus, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuShowFetchStatus ?? true),
+        menuShowDetailsForUnselectedRows: derivedLayoutMode === "expanded-rows",
+        menuLayoutMode: derivedLayoutMode,
+        menuQuotaTtlMs: normalizeQuotaTtlMs(value.menuQuotaTtlMs, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuQuotaTtlMs ?? 5 * 60_000),
+        menuFocusStyle: normalizeFocusStyle(value.menuFocusStyle),
+        menuHighlightCurrentRow: normalizeBoolean(value.menuHighlightCurrentRow, DEFAULT_DASHBOARD_DISPLAY_SETTINGS.menuHighlightCurrentRow ?? true),
+        menuStatuslineFields: normalizeStatuslineFields(value.menuStatuslineFields),
+    };
+}
+/**
+ * Load and return the normalized dashboard display settings, migrating legacy settings when present.
+ *
+ * Attempts to read unified settings first; if absent, loads legacy dashboard-settings.json, normalizes
+ * its contents, and tries to migrate the normalized result to the unified settings store. On any read,
+ * parse, or validation error, or if no settings are found, returns the built-in defaults.
+ *
+ * @returns The normalized DashboardDisplaySettings to apply.
+ *
+ * @remarks
+ * - Concurrency: callers may race with other processes performing migration or writes; callers should
+ *   not assume exclusive access and should tolerate eventual consistency.
+ * - Filesystem (Windows): legacy-path checks use case-insensitive filesystem semantics implicitly; ensure
+ *   any external tooling accounts for that when placing or removing legacy files.
+ * - Token handling: persisted settings are stored as-is; remove or redact any sensitive tokens from
+ *   settings before calling this function if they must not be written unmodified to persistent stores.
+ */
+export async function loadDashboardDisplaySettings() {
+    const unifiedSettings = await loadUnifiedDashboardSettings();
+    if (unifiedSettings) {
+        return normalizeDashboardDisplaySettings(unifiedSettings);
+    }
+    if (!existsSync(DASHBOARD_SETTINGS_PATH)) {
+        return { ...DEFAULT_DASHBOARD_DISPLAY_SETTINGS };
+    }
+    try {
+        const raw = await readLegacySettingsFile(DASHBOARD_SETTINGS_PATH);
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed)) {
+            return { ...DEFAULT_DASHBOARD_DISPLAY_SETTINGS };
+        }
+        const normalized = normalizeDashboardDisplaySettings(parsed.settings);
+        try {
+            await saveUnifiedDashboardSettings(toJsonRecord(normalized));
+        }
+        catch {
+            // Keep legacy fallback behavior even if migration write fails.
+        }
+        return normalized;
+    }
+    catch (error) {
+        logWarn(`Failed to load dashboard settings from ${DASHBOARD_SETTINGS_PATH}: ${error instanceof Error ? error.message : String(error)}`);
+        return { ...DEFAULT_DASHBOARD_DISPLAY_SETTINGS };
+    }
+}
+/**
+ * Persist normalized dashboard display settings to the unified settings store.
+ *
+ * Normalizes `settings` and writes the resulting record via the unified settings API.
+ * Concurrent callers may race and overwrite each other; callers should serialize updates
+ * when strong write ordering is required. On Windows, underlying filesystem writes may
+ * not be atomic across processes. Any sensitive tokens or secrets present in settings
+ * are written as provided; callers must remove or redact sensitive values before saving.
+ *
+ * @param settings - The dashboard display settings to normalize and save
+ */
+export async function saveDashboardDisplaySettings(settings) {
+    const normalized = normalizeDashboardDisplaySettings(settings);
+    await saveUnifiedDashboardSettings(toJsonRecord(normalized));
+}
+//# sourceMappingURL=dashboard-settings.js.map

package/dist/lib/dashboard-settings.js.map

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

package/dist/lib/entitlement-cache.d.ts

@@ -0,0 +1,41 @@
+export interface EntitlementBlock {
+    model: string;
+    blockedUntil: number;
+    reason: "unsupported-model" | "plan-entitlement";
+    updatedAt: number;
+}
+export interface EntitlementCacheSnapshot {
+    accounts: Record<string, EntitlementBlock[]>;
+}
+export interface EntitlementAccountRef {
+    accountId?: string;
+    email?: string;
+    index?: number;
+}
+/**
+ * Derives a stable cache key for an entitlement account reference.
+ *
+ * Produces one of three deterministic keys:
+ * - `id:<trimmed accountId>` when `accountId` is present,
+ * - `email:<lowercased trimmed email>` when `email` is present and no `accountId`,
+ * - `idx:<non-negative integer>` otherwise (index defaults to 0).
+ *
+ * This function is pure and concurrency-safe; it performs no I/O and is not affected by Windows filesystem semantics. It does not redact secrets or tokens — values are only trimmed and, for emails, lowercased.
+ *
+ * @param ref - Reference identifying an account (may include `accountId`, `email`, or `index`)
+ * @returns A deterministic string key prefixed with `id:`, `email:`, or `idx:` as described above
+ */
+export declare function resolveEntitlementAccountKey(ref: EntitlementAccountRef): string;
+export declare class EntitlementCache {
+    private readonly blocksByAccount;
+    markBlocked(accountKey: string, model: string, reason: EntitlementBlock["reason"], ttlMs?: number, now?: number): void;
+    clear(accountKey: string, model?: string): void;
+    isBlocked(accountKey: string, model: string, now?: number): {
+        blocked: boolean;
+        waitMs: number;
+        reason?: EntitlementBlock["reason"];
+    };
+    prune(now?: number): number;
+    snapshot(now?: number): EntitlementCacheSnapshot;
+}
+//# sourceMappingURL=entitlement-cache.d.ts.map

package/dist/lib/entitlement-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement-cache.d.ts","sourceRoot":"","sources":["../../lib/entitlement-cache.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAC7C;AAKD,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAO/E;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IAEpF,WAAW,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,KAAK,SAAuB,EAC5B,GAAG,SAAa,GACd,IAAI;IAqBP,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAc/C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;KAAE;IAmBzI,KAAK,CAAC,GAAG,SAAa,GAAG,MAAM;IAmB/B,QAAQ,CAAC,GAAG,SAAa,GAAG,wBAAwB;CAUpD"}

package/dist/lib/entitlement-cache.js

@@ -0,0 +1,137 @@
+import { createLogger } from "./logger.js";
+const log = createLogger("entitlement-cache");
+const DEFAULT_BLOCK_TTL_MS = 30 * 60_000;
+const MAX_ACCOUNT_BUCKETS = 512;
+/**
+ * Produce a normalized model identifier suitable for cache keys and comparisons.
+ *
+ * Trims and lowercases the input, uses the final path segment if a slash is present,
+ * and removes common variant suffixes such as `-none`, `-minimal`, `-low`, `-medium`, `-high`, and `-xhigh`.
+ *
+ * @param model - The raw model string to normalize; may be undefined or empty.
+ * @returns The simplified model identifier, or `null` if `model` is missing or empty after trimming.
+ */
+function normalizeModel(model) {
+    if (!model)
+        return null;
+    const trimmed = model.trim().toLowerCase();
+    if (!trimmed)
+        return null;
+    const stripped = trimmed.includes("/") ? (trimmed.split("/").pop() ?? trimmed) : trimmed;
+    return stripped.replace(/-(none|minimal|low|medium|high|xhigh)$/i, "");
+}
+/**
+ * Derives a stable cache key for an entitlement account reference.
+ *
+ * Produces one of three deterministic keys:
+ * - `id:<trimmed accountId>` when `accountId` is present,
+ * - `email:<lowercased trimmed email>` when `email` is present and no `accountId`,
+ * - `idx:<non-negative integer>` otherwise (index defaults to 0).
+ *
+ * This function is pure and concurrency-safe; it performs no I/O and is not affected by Windows filesystem semantics. It does not redact secrets or tokens — values are only trimmed and, for emails, lowercased.
+ *
+ * @param ref - Reference identifying an account (may include `accountId`, `email`, or `index`)
+ * @returns A deterministic string key prefixed with `id:`, `email:`, or `idx:` as described above
+ */
+export function resolveEntitlementAccountKey(ref) {
+    const accountId = typeof ref.accountId === "string" ? ref.accountId.trim() : "";
+    if (accountId)
+        return `id:${accountId}`;
+    const email = typeof ref.email === "string" ? ref.email.trim().toLowerCase() : "";
+    if (email)
+        return `email:${email}`;
+    const index = Number.isFinite(ref.index) ? Math.max(0, Math.floor(ref.index ?? 0)) : 0;
+    return `idx:${index}`;
+}
+export class EntitlementCache {
+    blocksByAccount = new Map();
+    markBlocked(accountKey, model, reason, ttlMs = DEFAULT_BLOCK_TTL_MS, now = Date.now()) {
+        const normalizedModel = normalizeModel(model);
+        if (!accountKey || !normalizedModel)
+            return;
+        const normalizedTtlMs = typeof ttlMs === "number" && Number.isFinite(ttlMs)
+            ? Math.max(1_000, Math.floor(ttlMs))
+            : DEFAULT_BLOCK_TTL_MS;
+        if (this.blocksByAccount.size >= MAX_ACCOUNT_BUCKETS && !this.blocksByAccount.has(accountKey)) {
+            const first = this.blocksByAccount.keys().next().value;
+            if (typeof first === "string")
+                this.blocksByAccount.delete(first);
+        }
+        const existing = this.blocksByAccount.get(accountKey) ?? new Map();
+        existing.set(normalizedModel, {
+            model: normalizedModel,
+            blockedUntil: now + normalizedTtlMs,
+            reason,
+            updatedAt: now,
+        });
+        this.blocksByAccount.set(accountKey, existing);
+    }
+    clear(accountKey, model) {
+        if (!accountKey)
+            return;
+        if (!model) {
+            this.blocksByAccount.delete(accountKey);
+            return;
+        }
+        const normalizedModel = normalizeModel(model);
+        if (!normalizedModel)
+            return;
+        const accountBlocks = this.blocksByAccount.get(accountKey);
+        if (!accountBlocks)
+            return;
+        accountBlocks.delete(normalizedModel);
+        if (accountBlocks.size === 0)
+            this.blocksByAccount.delete(accountKey);
+    }
+    isBlocked(accountKey, model, now = Date.now()) {
+        const normalizedModel = normalizeModel(model);
+        if (!accountKey || !normalizedModel)
+            return { blocked: false, waitMs: 0 };
+        const accountBlocks = this.blocksByAccount.get(accountKey);
+        if (!accountBlocks)
+            return { blocked: false, waitMs: 0 };
+        const block = accountBlocks.get(normalizedModel);
+        if (!block)
+            return { blocked: false, waitMs: 0 };
+        if (block.blockedUntil <= now) {
+            accountBlocks.delete(normalizedModel);
+            if (accountBlocks.size === 0)
+                this.blocksByAccount.delete(accountKey);
+            return { blocked: false, waitMs: 0 };
+        }
+        return {
+            blocked: true,
+            waitMs: Math.max(0, block.blockedUntil - now),
+            reason: block.reason,
+        };
+    }
+    prune(now = Date.now()) {
+        let removed = 0;
+        for (const [accountKey, blocks] of this.blocksByAccount.entries()) {
+            for (const [model, block] of blocks.entries()) {
+                if (block.blockedUntil <= now) {
+                    blocks.delete(model);
+                    removed += 1;
+                }
+            }
+            if (blocks.size === 0) {
+                this.blocksByAccount.delete(accountKey);
+            }
+        }
+        if (removed > 0) {
+            log.debug("Pruned entitlement cache", { removed });
+        }
+        return removed;
+    }
+    snapshot(now = Date.now()) {
+        this.prune(now);
+        const accounts = {};
+        for (const [accountKey, blocks] of this.blocksByAccount.entries()) {
+            accounts[accountKey] = Array.from(blocks.values())
+                .map((block) => ({ ...block }))
+                .sort((a, b) => a.model.localeCompare(b.model));
+        }
+        return { accounts };
+    }
+}
+//# sourceMappingURL=entitlement-cache.js.map

package/dist/lib/entitlement-cache.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Typed error hierarchy for the Codex plugin.
+ * Provides structured error types with codes, causes, and context.
+ */
+/**
+ * Error codes for categorizing errors.
+ */
+export declare const ErrorCode: {
+    readonly NETWORK_ERROR: "CODEX_NETWORK_ERROR";
+    readonly API_ERROR: "CODEX_API_ERROR";
+    readonly AUTH_ERROR: "CODEX_AUTH_ERROR";
+    readonly VALIDATION_ERROR: "CODEX_VALIDATION_ERROR";
+    readonly RATE_LIMIT: "CODEX_RATE_LIMIT";
+    readonly TIMEOUT: "CODEX_TIMEOUT";
+};
+export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Options for creating a CodexError.
+ */
+export interface CodexErrorOptions {
+    code?: string;
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base error class for all Codex plugin errors.
+ * Supports error chaining via `cause` and arbitrary context data.
+ */
+export declare class CodexError extends Error {
+    readonly name: string;
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: CodexErrorOptions);
+}
+/**
+ * Options for creating a CodexApiError.
+ */
+export interface CodexApiErrorOptions extends CodexErrorOptions {
+    status: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Error for HTTP/API response errors.
+ */
+export declare class CodexApiError extends CodexError {
+    readonly name = "CodexApiError";
+    readonly status: number;
+    readonly headers?: Record<string, string>;
+    constructor(message: string, options: CodexApiErrorOptions);
+}
+/**
+ * Options for creating a CodexAuthError.
+ */
+export interface CodexAuthErrorOptions extends CodexErrorOptions {
+    accountId?: string;
+    retryable?: boolean;
+}
+/**
+ * Error for authentication failures.
+ */
+export declare class CodexAuthError extends CodexError {
+    readonly name = "CodexAuthError";
+    readonly accountId?: string;
+    readonly retryable: boolean;
+    constructor(message: string, options?: CodexAuthErrorOptions);
+}
+/**
+ * Options for creating a CodexNetworkError.
+ */
+export interface CodexNetworkErrorOptions extends CodexErrorOptions {
+    retryable?: boolean;
+}
+/**
+ * Error for network/connection failures.
+ */
+export declare class CodexNetworkError extends CodexError {
+    readonly name = "CodexNetworkError";
+    readonly retryable: boolean;
+    constructor(message: string, options?: CodexNetworkErrorOptions);
+}
+/**
+ * Options for creating a CodexValidationError.
+ */
+export interface CodexValidationErrorOptions extends CodexErrorOptions {
+    field?: string;
+    expected?: string;
+}
+/**
+ * Error for input validation failures.
+ */
+export declare class CodexValidationError extends CodexError {
+    readonly name = "CodexValidationError";
+    readonly field?: string;
+    readonly expected?: string;
+    constructor(message: string, options?: CodexValidationErrorOptions);
+}
+/**
+ * Options for creating a CodexRateLimitError.
+ */
+export interface CodexRateLimitErrorOptions extends CodexErrorOptions {
+    retryAfterMs?: number;
+    accountId?: string;
+}
+/**
+ * Error for rate limit exceeded.
+ */
+export declare class CodexRateLimitError extends CodexError {
+    readonly name = "CodexRateLimitError";
+    readonly retryAfterMs?: number;
+    readonly accountId?: string;
+    constructor(message: string, options?: CodexRateLimitErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

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