@99percentpeople/pi-codex-api 0.1.4 → 0.2.1

package/dist/index.ts

@@ -11,7 +11,8 @@ var DEFAULT_CODEX_API_CONFIG = {
   searchMode: "auto",
   searchContextSize: "medium",
   imageQuality: "auto",
-  usageStatus: true
+  usageStatus: true,
+  usagePollInterval: 5
 };
 function oneOf(value, values, fallback) {
   return typeof value === "string" && values.includes(value) ? value : fallback;
@@ -26,7 +27,8 @@ function normalizeCodexApiConfig(value) {
     searchMode: oneOf(input.searchMode, ["auto", "cached", "indexed", "live"], DEFAULT_CODEX_API_CONFIG.searchMode),
     searchContextSize: oneOf(input.searchContextSize, ["low", "medium", "high"], DEFAULT_CODEX_API_CONFIG.searchContextSize),
     imageQuality: oneOf(input.imageQuality, ["auto", "low", "medium", "high"], DEFAULT_CODEX_API_CONFIG.imageQuality),
-    usageStatus: typeof input.usageStatus === "boolean" ? input.usageStatus : DEFAULT_CODEX_API_CONFIG.usageStatus
+    usageStatus: typeof input.usageStatus === "boolean" ? input.usageStatus : DEFAULT_CODEX_API_CONFIG.usageStatus,
+    usagePollInterval: typeof input.usagePollInterval === "number" && Number.isFinite(input.usagePollInterval) && input.usagePollInterval > 0 ? Math.min(60, Math.round(input.usagePollInterval)) : DEFAULT_CODEX_API_CONFIG.usagePollInterval
   };
 }
 function getCodexApiConfigPath() {
@@ -381,7 +383,7 @@ function imagePhaseLabel(phase) {
     return "Saving generated PNG…";
   return "Image completed";
 }
-function registerCodexImageTool(pi, getConfig = () => DEFAULT_CODEX_API_CONFIG, refreshUsageInBackground) {
+function registerCodexImageTool(pi, getConfig = () => DEFAULT_CODEX_API_CONFIG) {
   pi.registerTool({
     name: "codex_image",
     label: "Codex Image",
@@ -466,7 +468,6 @@ function registerCodexImageTool(pi, getConfig = () => DEFAULT_CODEX_API_CONFIG,
       update("saving");
       await mkdir(dirname(savedPath), { recursive: true });
       await writeFile(savedPath, Buffer.from(data, "base64"));
-      refreshUsageInBackground?.(ctx);
       return {
         content: [
           { type: "text", text: `${operation === "edit" ? "Edited" : "Generated"} image saved to ${savedPath}` },
@@ -1113,6 +1114,15 @@ var IMAGE_QUALITY_LABELS = {
   medium: "Medium",
   high: "High"
 };
+function usagePollLabel(minutes) {
+  if (minutes <= 0)
+    return "Off";
+  return `${minutes}m`;
+}
+function usagePollMinutes(label) {
+  const match = /^(\d+)m$/.exec(label);
+  return match ? Number(match[1]) : 0;
+}
 function keyForLabel(labels, value) {
   return Object.entries(labels).find(([, label]) => label === value)?.[0];
 }
@@ -1164,6 +1174,13 @@ function registerCodexApiSettings(pi, controller) {
           description: "Show remaining Codex subscription usage in the status area",
           currentValue: config.usageStatus ? "Show" : "Hide",
           values: ["Show", "Hide"]
+        },
+        {
+          id: "usagePollInterval",
+          label: "Usage poll",
+          description: "Periodically refresh the usage status while a session is active (Off disables polling)",
+          currentValue: usagePollLabel(config.usagePollInterval),
+          values: ["Off", "1m", "5m", "15m"]
         }
       ];
     },
@@ -1190,6 +1207,8 @@ function registerCodexApiSettings(pi, controller) {
         }, ctx);
       } else if (id === "usageStatus") {
         controller.updateConfig({ ...config, usageStatus: value === "Show" }, ctx);
+      } else if (id === "usagePollInterval") {
+        controller.updateConfig({ ...config, usagePollInterval: usagePollMinutes(value) }, ctx);
       }
     }
   });
@@ -1202,6 +1221,11 @@ import {
   getAgentDir
 } from "@earendil-works/pi-coding-agent";
 var USAGE_PATH = "../wham/usage";
+var REDEEM_CREDITS_PATH = "../wham/rate-limit-reset-credits";
+var REDEEM_PATH = "../wham/rate-limit-reset-credits/consume";
+var REDEEM_CONFIRM_WINDOW_MS = 1e4;
+var REDEEM_DIALOG_TIMEOUT_MS = 30000;
+var REDEEM_RETRY_WINDOW_MS = 5 * 60000;
 var USAGE_REFRESH_INTERVAL_MS = 60000;
 var AUTH_WATCH_DEBOUNCE_MS = 100;
 var STATUS_KEY = "codex-api-usage";
@@ -1215,6 +1239,18 @@ function payloadNumber(value) {
   const number = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
   return Number.isFinite(number) ? number : undefined;
 }
+function payloadDate(value) {
+  if (typeof value === "number")
+    return Number.isFinite(value) ? value : undefined;
+  if (typeof value === "string") {
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : undefined;
+  }
+  return;
+}
+function payloadString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
 function payloadBool(value) {
   if (typeof value === "boolean")
     return value;
@@ -1253,14 +1289,65 @@ function payloadCredits(value) {
     balance: typeof balance === "string" && balance ? balance : undefined
   };
 }
-function payloadSnapshot(limitId, limitName, rateLimitValue, creditsValue) {
+function payloadSnapshot(limitId, limitName, rateLimitValue, creditsValue, limitReached) {
   const rateLimit = object(rateLimitValue);
   return {
     limitId,
     limitName,
     primary: payloadWindow(rateLimit && property(rateLimit, "primary_window", "primaryWindow")),
     secondary: payloadWindow(rateLimit && property(rateLimit, "secondary_window", "secondaryWindow")),
-    credits: payloadCredits(creditsValue)
+    credits: payloadCredits(creditsValue),
+    limitReached
+  };
+}
+function parseCodexAccountInfo(value) {
+  const input = object(value);
+  if (!input)
+    return;
+  const planType = payloadString(property(input, "plan_type", "planType"));
+  const email = payloadString(property(input, "email", "email"));
+  if (planType === undefined && email === undefined)
+    return;
+  return { planType, email };
+}
+function maskCodexEmail(email) {
+  const [local, domain] = email.split("@");
+  if (!domain)
+    return "***";
+  const head = local.length > 3 ? local.slice(0, 3) : local.slice(0, 1);
+  return `${head}***@${domain}`;
+}
+function parseCodexRedeemCredits(value) {
+  const input = object(value);
+  if (!input)
+    return;
+  const availableCount = payloadNumber(property(input, "available_count", "availableCount"));
+  if (availableCount === undefined)
+    return;
+  const credits = [];
+  const list = property(input, "credits", "credits");
+  if (Array.isArray(list)) {
+    for (const item of list) {
+      const credit = object(item);
+      if (!credit)
+        continue;
+      const id = payloadString(property(credit, "id", "id"));
+      if (!id)
+        continue;
+      credits.push({
+        id,
+        title: payloadString(property(credit, "title", "title")),
+        description: payloadString(property(credit, "description", "description")),
+        status: payloadString(property(credit, "status", "status")),
+        grantedAt: payloadDate(property(credit, "granted_at", "grantedAt")),
+        expiresAt: payloadDate(property(credit, "expires_at", "expiresAt"))
+      });
+    }
+  }
+  return {
+    availableCount,
+    totalEarnedCount: payloadNumber(property(input, "total_earned_count", "totalEarnedCount")),
+    credits
   };
 }
 function parseCodexUsagePayload(value) {
@@ -1268,7 +1355,9 @@ function parseCodexUsagePayload(value) {
   if (!input)
     return [];
   const rateLimit = property(input, "rate_limit", "rateLimit");
-  const snapshots = rateLimit !== undefined || input.credits !== undefined ? [payloadSnapshot("codex", undefined, rateLimit, input.credits)] : [];
+  const rateLimitObject = object(rateLimit);
+  const limitReached = payloadBool(rateLimitObject && property(rateLimitObject, "limit_reached", "limitReached"));
+  const snapshots = rateLimit !== undefined || input.credits !== undefined ? [payloadSnapshot("codex", undefined, rateLimit, input.credits, limitReached)] : [];
   const additional = property(input, "additional_rate_limits", "additionalRateLimits");
   if (Array.isArray(additional)) {
     for (const value2 of additional) {
@@ -1330,14 +1419,16 @@ function parseCodexRateLimits(input) {
       unlimited,
       balance: headers["x-codex-credits-balance"]
     } : undefined;
-    if (!primary && !secondary && !credits)
+    const limitReached = prefix === "x-codex" ? headers["x-codex-rate-limit-reached-type"] !== undefined : undefined;
+    if (!primary && !secondary && !credits && !limitReached)
       return [];
     return [{
       limitId: prefix.slice(2).replace(/-/g, "_"),
       limitName: headers[`${prefix}-limit-name`],
       primary,
       secondary,
-      credits
+      credits,
+      limitReached
     }];
   });
 }
@@ -1350,13 +1441,17 @@ function resetText(epochSeconds, now = Date.now()) {
   const remainingMs = epochSeconds * 1000 - now;
   if (remainingMs <= 0)
     return;
-  const minutes = Math.ceil(remainingMs / 60000);
-  if (minutes < 60)
-    return `${minutes}m`;
-  const hours = Math.ceil(minutes / 60);
-  if (hours < 48)
-    return `${hours}h`;
-  return `${Math.ceil(hours / 24)}d`;
+  const totalMinutes = Math.ceil(remainingMs / 60000);
+  if (totalMinutes < 60)
+    return `${totalMinutes}m`;
+  if (totalMinutes < 24 * 60) {
+    const hours2 = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    return minutes > 0 ? `${hours2}h ${minutes}m` : `${hours2}h`;
+  }
+  const days = Math.floor(totalMinutes / (24 * 60));
+  const hours = Math.floor(totalMinutes % (24 * 60) / 60);
+  return hours > 0 ? `${days}d ${hours}h` : `${days}d`;
 }
 var KNOWN_WINDOWS = [
   { minutes: 5 * 60, label: "5h" },
@@ -1393,10 +1488,11 @@ function usageBar(remaining) {
   const filled = Math.round(remaining / 100 * USAGE_BAR_WIDTH);
   return `[${"█".repeat(filled)}${"░".repeat(USAGE_BAR_WIDTH - filled)}]`;
 }
-function windowText(item, labelWidth, now) {
+function windowText(item, labelWidth, now, limitReached) {
   const reset = resetText(item.window.resetsAt, now);
   const remaining = remainingPercent(item.window);
-  return `${item.label.padEnd(labelWidth)} ${usageBar(remaining)} ${percent(remaining)}% left${reset ? ` resets in ${reset}` : ""}`;
+  const state = limitReached ? "limit reached" : `${percent(remaining)}% left`;
+  return `${item.label.padEnd(labelWidth)} ${usageBar(limitReached ? 0 : remaining)} ${state}${reset ? ` resets in ${reset}` : ""}`;
 }
 function creditsText(credits) {
   if (credits.unlimited)
@@ -1406,11 +1502,41 @@ function creditsText(credits) {
   }
   return "no additional credits";
 }
-function formatCodexUsage(snapshots, now = Date.now()) {
+function planLabel(planType) {
+  return planType.charAt(0).toUpperCase() + planType.slice(1);
+}
+function formatDateTime(epochMs) {
+  const date = new Date(epochMs);
+  const pad = (value) => String(value).padStart(2, "0");
+  const offsetMinutes = -new Date(epochMs).getTimezoneOffset();
+  const sign = offsetMinutes >= 0 ? "+" : "-";
+  const abs = Math.abs(offsetMinutes);
+  const offset = abs % 60 === 0 ? `UTC${sign}${abs / 60}` : `UTC${sign}${Math.floor(abs / 60)}:${pad(abs % 60)}`;
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())} ${offset}`;
+}
+function formatCodexRedeemCredits(redeemCredits, now = Date.now()) {
+  if (!redeemCredits || redeemCredits.availableCount <= 0)
+    return [];
+  const lines = [`rate limit redeem${redeemCredits.availableCount === 1 ? "" : ` ×${redeemCredits.availableCount}`}`];
+  const available = redeemCredits.credits.filter((credit) => credit.status === undefined || credit.status === "available").sort((left, right) => (left.expiresAt ?? Number.POSITIVE_INFINITY) - (right.expiresAt ?? Number.POSITIVE_INFINITY));
+  for (const credit of available) {
+    const details = ["available"];
+    if (credit.expiresAt !== undefined) {
+      details.push(credit.expiresAt > now ? `expires ${formatDateTime(credit.expiresAt)}` : "expired");
+    }
+    lines.push(`  ${credit.title ?? "reset credit"} (${details.join(", ")})`);
+  }
+  return lines.length > 1 ? lines : [];
+}
+function formatCodexUsage(snapshots, now = Date.now(), extras = {}) {
   if (snapshots.length === 0) {
     return "No Codex usage data is available. Run /codex-usage with an active Codex subscription model to refresh it.";
   }
   const lines = ["Codex usage"];
+  if (extras.account) {
+    const plan = extras.account.planType ? planLabel(extras.account.planType) : "unknown plan";
+    lines.push("", `account · ${plan}${extras.account.email ? ` (${maskCodexEmail(extras.account.email)})` : ""}`);
+  }
   for (const snapshot of snapshots) {
     const name = snapshot.limitName ?? snapshot.limitId;
     const windows = activeWindows(snapshot, now);
@@ -1419,10 +1545,13 @@ function formatCodexUsage(snapshots, now = Date.now()) {
     if (windows.length === 0)
       lines.push("  no active usage windows");
     else
-      lines.push(...windows.map((window) => `  ${windowText(window, labelWidth, now)}`));
+      lines.push(...windows.map((window) => `  ${windowText(window, labelWidth, now, snapshot.limitReached === true)}`));
     if (snapshot.credits)
       lines.push(`  ${creditsText(snapshot.credits)}`);
   }
+  const redeemLines = formatCodexRedeemCredits(extras.redeemCredits, now);
+  if (redeemLines.length > 0)
+    lines.push("", ...redeemLines);
   return lines.join(`
 `);
 }
@@ -1441,15 +1570,20 @@ function formatCodexStatus(snapshots, fastMode, now = Date.now()) {
     return;
   const remaining = remainingPercent(shortest.window);
   const reset = resetText(shortest.window.resetsAt, now);
-  return `Codex ${shortest.label} ${percent(remaining)}%${reset ? ` ${reset}` : ""}${fastMode ? " Fast" : ""}`;
+  const usage = snapshot.limitReached === true ? "limit reached" : `${percent(remaining)}%`;
+  return `Codex ${shortest.label} ${usage}${reset ? ` ${reset}` : ""}${fastMode ? " Fast" : ""}`;
 }
 function applyFastModePayload(payload, enabled) {
   if (!enabled || !payload || typeof payload !== "object" || Array.isArray(payload))
     return payload;
   return { ...payload, service_tier: "priority" };
 }
+function usageRefreshNeeded(prev, next) {
+  return next.usageStatus && (prev.usageStatus !== next.usageStatus || prev.allowOtherProviders !== next.allowOtherProviders);
+}
 function registerCodexUsageAndFast(pi, controller, options = {}) {
   const usageByAccount = new Map;
+  const pendingRedeemByAccount = new Map;
   let activeAccountId;
   let credentialRevision = 0;
   let latestContext;
@@ -1457,6 +1591,7 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
   let accountObserverActive = false;
   let authWatcher;
   let authWatchDebounce;
+  let pollDelay;
   const usageEnabled = (ctx) => {
     const config = controller.getConfig();
     return config.usageStatus && (ctx.model?.provider === "openai-codex" || config.allowOtherProviders);
@@ -1481,6 +1616,7 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
     credentialRevision += 1;
     activeAccountId = undefined;
     usageByAccount.clear();
+    pendingRedeemByAccount.clear();
     if (action === "set")
       showSyncingStatus(ctx);
     else
@@ -1492,6 +1628,7 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
     credentialRevision += 1;
     activeAccountId = accountId;
     usageByAccount.clear();
+    pendingRedeemByAccount.clear();
     showSyncingStatus(ctx);
     return true;
   };
@@ -1542,6 +1679,7 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
         if (parsed.length === 0)
           throw new Error("Codex usage API returned no usage data");
         state.snapshots = parsed;
+        state.account = parseCodexAccountInfo(payload);
         state.lastFetchAt = Date.now();
       })();
       let nextFetch;
@@ -1562,6 +1700,36 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
     latestContext = ctx;
     refreshUsage(ctx, force).catch(() => refreshStatus(ctx));
   };
+  const stopPolling = () => {
+    if (pollDelay) {
+      clearTimeout(pollDelay);
+      pollDelay = undefined;
+    }
+  };
+  const scheduleNextPoll = () => {
+    if (pollDelay)
+      return;
+    const intervalMinutes = Math.round(controller.getConfig().usagePollInterval);
+    if (intervalMinutes <= 0)
+      return;
+    pollDelay = setTimeout(() => {
+      pollDelay = undefined;
+      const active = latestContext;
+      const state = currentState();
+      if (active && usageEnabled(active)) {
+        const intervalMs = intervalMinutes * 60000;
+        if (!state || state.snapshots.length === 0 || Date.now() - state.lastFetchAt >= intervalMs) {
+          refreshUsage(active).catch(() => refreshStatus(active));
+        }
+      }
+      scheduleNextPoll();
+    }, intervalMinutes * 60000);
+    pollDelay.unref?.();
+  };
+  const startPolling = (ctx) => {
+    latestContext = ctx;
+    scheduleNextPoll();
+  };
   const codexOAuthAvailable = (ctx, config) => {
     const model = ctx.model?.provider === "openai-codex" ? ctx.model : config.allowOtherProviders ? ctx.modelRegistry.getAll().find((candidate) => candidate.provider === "openai-codex" && ctx.modelRegistry.isUsingOAuth(candidate)) : undefined;
     return !!model && ctx.modelRegistry.isUsingOAuth(model);
@@ -1646,20 +1814,120 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
     }
   };
   pi.registerCommand("codex-usage", {
-    description: "Refresh and show Codex subscription usage limits and credits",
+    description: "Refresh and show Codex subscription usage, plan, and rate limit redeems",
     handler: async (_args, ctx) => {
       try {
         await refreshUsage(ctx, true);
       } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
+        const message2 = error instanceof Error ? error.message : String(error);
         const snapshots = currentState()?.snapshots ?? [];
         if (snapshots.length === 0) {
-          ctx.ui.notify(`Failed to refresh Codex usage: ${message}`, "error");
+          ctx.ui.notify(`Failed to refresh Codex usage: ${message2}`, "error");
+          return;
+        }
+        ctx.ui.notify(`Failed to refresh Codex usage; showing the latest snapshot: ${message2}`, "warning");
+      }
+      try {
+        const resolved = await resolveActiveClient(ctx, controller.getConfig());
+        const state2 = accountState(resolved.accountId);
+        const payload = await resolved.client.get(REDEEM_CREDITS_PATH);
+        state2.redeemCredits = parseCodexRedeemCredits(payload);
+      } catch {}
+      const state = currentState();
+      const message = formatCodexUsage(state?.snapshots ?? [], Date.now(), {
+        account: state?.account,
+        redeemCredits: state?.redeemCredits
+      });
+      ctx.ui.notify(ctx.ui.theme ? ctx.ui.theme.fg("muted", message) : message, "info");
+    }
+  });
+  pi.registerCommand("codex-redeem", {
+    description: "Preview and redeem an earned Codex rate limit reset credit (confirmation required)",
+    handler: async (_args, ctx) => {
+      const config = controller.getConfig();
+      if (ctx.model?.provider !== "openai-codex" && !config.allowOtherProviders) {
+        ctx.ui.notify("An active openai-codex model is required to redeem a rate limit reset. " + "Enable Other providers in /99settings to use the logged-in Codex subscription from another model.", "error");
+        return;
+      }
+      let resolved;
+      try {
+        resolved = await resolveActiveClient(ctx, config);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ctx.ui.notify(`Failed to resolve the Codex subscription: ${message}`, "error");
+        return;
+      }
+      const state = accountState(resolved.accountId);
+      try {
+        const payload = await resolved.client.get(REDEEM_CREDITS_PATH);
+        const redeemCredits = parseCodexRedeemCredits(payload);
+        state.redeemCredits = redeemCredits;
+        const now = Date.now();
+        if (!redeemCredits || redeemCredits.availableCount <= 0) {
+          pendingRedeemByAccount.delete(resolved.accountId);
+          ctx.ui.notify("No Codex rate limit reset credits are available to redeem.", "info");
           return;
         }
-        ctx.ui.notify(`Failed to refresh Codex usage; showing the latest snapshot: ${message}`, "warning");
+        const availableCredits = [...redeemCredits.credits].filter((item) => item.status === undefined || item.status === "available").sort((left, right) => (left.expiresAt ?? Number.POSITIVE_INFINITY) - (right.expiresAt ?? Number.POSITIVE_INFINITY));
+        const credit = availableCredits[0] ?? redeemCredits.credits[0];
+        const expiryOf = (item) => item?.expiresAt !== undefined && item.expiresAt > now ? ` (expires ${formatDateTime(item.expiresAt)})` : "";
+        let selected = credit;
+        if (ctx.hasUI) {
+          if (availableCredits.length > 1) {
+            const options2 = availableCredits.map((item) => `${item.title ?? "reset credit"}${expiryOf(item)}`);
+            const choice2 = await ctx.ui.select("Select a reset credit to redeem", options2, {
+              timeout: REDEEM_DIALOG_TIMEOUT_MS
+            });
+            if (choice2 === undefined) {
+              pendingRedeemByAccount.delete(resolved.accountId);
+              ctx.ui.notify("Redeem cancelled — no reset credit was consumed.", "info");
+              return;
+            }
+            const index = options2.indexOf(choice2);
+            selected = availableCredits[index] ?? credit;
+          }
+          const confirmOptions = ["No", "Yes"];
+          const choice = await ctx.ui.select(`Redeem ${selected?.title ?? "Full reset"}${expiryOf(selected)}?`, confirmOptions, { timeout: REDEEM_DIALOG_TIMEOUT_MS });
+          if (choice !== confirmOptions[1]) {
+            pendingRedeemByAccount.delete(resolved.accountId);
+            ctx.ui.notify("Redeem cancelled — no reset credit was consumed.", "info");
+            return;
+          }
+        }
+        const targetId = selected?.id;
+        const existing = pendingRedeemByAccount.get(resolved.accountId);
+        const pending = existing && existing.expiresAt > now && existing.creditId === targetId ? existing : {
+          redeemRequestId: crypto.randomUUID(),
+          creditId: targetId,
+          expiresAt: now + REDEEM_CONFIRM_WINDOW_MS
+        };
+        pendingRedeemByAccount.set(resolved.accountId, pending);
+        if (!ctx.hasUI && (!existing || existing.expiresAt <= now || existing.creditId !== targetId)) {
+          ctx.ui.notify(`${redeemCredits.availableCount} rate limit reset redeem available: ${credit?.title ?? "Full reset"}${expiryOf(credit)}. ` + `Run /codex-redeem again within ${REDEEM_CONFIRM_WINDOW_MS / 1000}s to confirm.`, "warning");
+          return;
+        }
+        try {
+          await resolved.client.post(REDEEM_PATH, {
+            redeem_request_id: pending.redeemRequestId,
+            credit_id: pending.creditId
+          });
+          pendingRedeemByAccount.delete(resolved.accountId);
+          try {
+            await refreshUsage(ctx, true);
+          } catch {}
+          const status = formatCodexStatus(currentState()?.snapshots ?? [], config.fastMode);
+          ctx.ui.notify(`✓ Rate limit reset redeemed — usage reset.${status ? `
+${status}` : ""}`, "info");
+        } catch (error) {
+          pending.expiresAt = Date.now() + REDEEM_RETRY_WINDOW_MS;
+          pendingRedeemByAccount.set(resolved.accountId, pending);
+          const message = error instanceof Error ? error.message : String(error);
+          ctx.ui.notify(`Failed to redeem a rate limit reset: ${message}. ` + "Run /codex-redeem again to retry with the same request ID.", "error");
+        }
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ctx.ui.notify(`Failed to redeem a rate limit reset: ${message}`, "error");
       }
-      ctx.ui.notify(formatCodexUsage(currentState()?.snapshots ?? []), "info");
     }
   });
   pi.on("before_provider_request", (event, ctx) => {
@@ -1682,15 +1950,19 @@ function registerCodexUsageAndFast(pi, controller, options = {}) {
     startAccountObserver(ctx);
     checkCurrentAccount(ctx).catch(() => {});
     refreshInBackground(ctx, true);
+    startPolling(ctx);
   });
   pi.on("session_start", (_event, ctx) => {
     startAccountObserver(ctx);
     refreshInBackground(ctx, true);
+    startPolling(ctx);
   });
   pi.on("session_shutdown", (_event, ctx) => {
+    stopPolling();
     credentialRevision += 1;
     activeAccountId = undefined;
     usageByAccount.clear();
+    pendingRedeemByAccount.clear();
     latestContext = undefined;
     accountObserverActive = false;
     if (authWatchDebounce)
@@ -1715,6 +1987,7 @@ function codex_api_default(pi) {
   const controller = {
     getConfig: () => config,
     updateConfig: (next, ctx) => {
+      const prev = config;
       config = next;
       try {
         saveCodexApiConfig(config);
@@ -1722,17 +1995,21 @@ function codex_api_default(pi) {
         ctx.ui.notify(`Failed to save Codex API settings: ${error instanceof Error ? error.message : String(error)}`, "error");
       }
       usageHandle?.refreshStatus(ctx);
+      if (usageRefreshNeeded(prev, next)) {
+        usageHandle?.refreshUsage(ctx, true).catch(() => {});
+      }
     }
   };
   usageHandle = registerCodexUsageAndFast(pi, controller);
   const refreshUsageInBackground = (ctx) => {
     usageHandle?.refreshUsage(ctx).catch(() => {});
   };
-  registerCodexImageTool(pi, () => config, refreshUsageInBackground);
+  registerCodexImageTool(pi, () => config);
   registerCodexSearchTool(pi, () => config, refreshUsageInBackground);
   registerCodexApiSettings(pi, controller);
 }
 export {
+  usageRefreshNeeded,
   saveCodexApiConfig,
   resolveSearchMode,
   resolveCodexApiRoot,
@@ -1741,14 +2018,18 @@ export {
   registerCodexImageTool,
   registerCodexApiSettings,
   parseCodexUsagePayload,
+  parseCodexRedeemCredits,
   parseCodexRateLimits,
+  parseCodexAccountInfo,
   normalizeCodexImageSize,
   normalizeCodexApiConfig,
+  maskCodexEmail,
   loadCodexApiConfig,
   getCodexApiConfigPath,
   formatCodexUsage,
   formatCodexStatus,
   formatCodexSearchDisplay,
+  formatCodexRedeemCredits,
   extractCodexAccountId,
   codex_api_default as default,
   createCodexSearchDisplay,
@@ -1765,5 +2046,5 @@ export {
   CODEX_API_SETTINGS_NAMESPACE
 };
 
-//# debugId=84C84A4D70A68DF064756E2164756E21
+//# debugId=F65EB4B48F9B1F0B64756E2164756E21
 //# sourceMappingURL=index.ts.map