@narumitw/pi-usage 0.54.0 → 0.57.0

package/dist/index.ts

@@ -449,10 +449,81 @@ function clampPercent(value) {
   return Math.min(100, Math.max(0, value));
 }
 
+// src/providers/deepseek.ts
+var CURRENCIES = ["CNY", "USD"];
+var BALANCE_FIELDS = [
+  ["total", "Total balance", "total_balance"],
+  ["granted", "Granted balance", "granted_balance"],
+  ["topped-up", "Topped-up balance", "topped_up_balance"]
+];
+function normalizeDeepSeekBalancePayload(payload, capturedAt) {
+  if (typeof payload.is_available !== "boolean") {
+    throw new Error("DeepSeek API balance response availability was not a boolean.");
+  }
+  if (!Array.isArray(payload.balance_infos) || payload.balance_infos.length === 0) {
+    throw new Error("DeepSeek API balance response returned no balance information.");
+  }
+  const balances = /* @__PURE__ */ new Map();
+  for (const raw of payload.balance_infos) {
+    const balance = asObject2(raw);
+    if (!balance) throw new Error("DeepSeek API balance row was not an object.");
+    const currency = deepSeekCurrency(balance.currency);
+    if (!currency) throw new Error("DeepSeek API balance row returned an unsupported currency.");
+    if (balances.has(currency)) {
+      throw new Error(`DeepSeek API balance response repeated ${currency}.`);
+    }
+    for (const [, label, field] of BALANCE_FIELDS) {
+      if (!decimalAmount(balance[field])) {
+        throw new Error(`DeepSeek API balance ${label.toLowerCase()} was not a valid amount.`);
+      }
+    }
+    balances.set(currency, balance);
+  }
+  const metrics = [
+    {
+      id: "api-availability",
+      label: "API calls",
+      value: payload.is_available ? "available" : "unavailable"
+    }
+  ];
+  for (const currency of CURRENCIES) {
+    const balance = balances.get(currency);
+    if (!balance) continue;
+    for (const [id, label, field] of BALANCE_FIELDS) {
+      metrics.push({
+        id: `${currency.toLowerCase()}-${id}`,
+        label,
+        value: balance[field],
+        unit: "currency",
+        currency
+      });
+    }
+  }
+  return {
+    providerId: "deepseek",
+    providerName: "DeepSeek",
+    capturedAt,
+    source: "deepseek-balance",
+    semantics: { kind: "api-key", label: "DeepSeek API balance" },
+    buckets: [],
+    metrics
+  };
+}
+function asObject2(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  return value;
+}
+function deepSeekCurrency(value) {
+  return CURRENCIES.find((currency) => currency === value);
+}
+function decimalAmount(value) {
+  return typeof value === "string" && value.length <= 64 && /^(?:0|[1-9]\d*)(?:\.\d+)?$/u.test(value);
+}
+
 // src/providers/github-copilot.ts
 function normalizeGitHubCopilotUsagePayload(payload, capturedAt) {
-  const snapshots = asObject2(payload.quota_snapshots);
-  const premium = asObject2(snapshots?.premium_interactions);
+  const snapshots = asObject3(payload.quota_snapshots);
+  const premium = asObject3(snapshots?.premium_interactions);
   const metrics = [];
   let semanticsLabel;
   let bucket;
@@ -493,8 +564,8 @@ function normalizeGitHubCopilotUsagePayload(payload, capturedAt) {
       };
     }
   } else {
-    const limited = asObject2(payload.limited_user_quotas);
-    const monthly = asObject2(payload.monthly_quotas);
+    const limited = asObject3(payload.limited_user_quotas);
+    const monthly = asObject3(payload.monthly_quotas);
     const remaining = asNonnegativeNumber(limited?.chat);
     const entitlement = asNonnegativeNumber(monthly?.chat);
     if (remaining === void 0 || entitlement === void 0) {
@@ -533,7 +604,7 @@ function resetTimestamp(payload) {
   const milliseconds = Date.parse(raw);
   return Number.isNaN(milliseconds) ? {} : { resetsAt: Math.floor(milliseconds / 1e3) };
 }
-function asObject2(value) {
+function asObject3(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -556,7 +627,7 @@ var DAILY_WINDOW_MINUTES = 1440;
 var WEEKLY_WINDOW_MINUTES = 10080;
 var FIXED_POINT_UNITS_PER_CENT = 1e6;
 function normalizeKimiCodingUsagePayload(payload, capturedAt) {
-  const root = asObject3(payload);
+  const root = asObject4(payload);
   if (!root) throw new Error("Kimi Coding usage response was not an object.");
   const candidates = [];
   let omittedWindow = false;
@@ -565,7 +636,7 @@ function normalizeKimiCodingUsagePayload(payload, capturedAt) {
   else if (root.usage !== void 0) omittedWindow = true;
   if (Array.isArray(root.limits)) {
     for (const raw of root.limits) {
-      const item = asObject3(raw);
+      const item = asObject4(raw);
       const windowMinutes = parseWindowMinutes(item?.window);
       const label = sanitizedLabel(item?.name);
       const bucket = windowMinutes === void 0 ? void 0 : parseUsageRow(item?.detail, windowMinutes, label ?? defaultWindowLabel(windowMinutes));
@@ -602,7 +673,7 @@ function normalizeKimiCodingUsagePayload(payload, capturedAt) {
   };
 }
 function parseUsageRow(value, windowMinutes, label) {
-  const row = asObject3(value);
+  const row = asObject4(value);
   if (!row) return void 0;
   const used = asNonnegativeInteger2(row.used);
   const limit = asNonnegativeInteger2(row.limit);
@@ -620,7 +691,7 @@ function parseUsageRow(value, windowMinutes, label) {
   };
 }
 function parseWindowMinutes(value) {
-  const window = asObject3(value);
+  const window = asObject4(value);
   if (!window) return void 0;
   const duration = asPositiveInteger(window.duration);
   if (duration === void 0) return void 0;
@@ -630,8 +701,8 @@ function parseWindowMinutes(value) {
   return Number.isSafeInteger(minutes) ? minutes : void 0;
 }
 function parseBoosterWallet(value) {
-  const wallet = asObject3(value);
-  const balance = asObject3(wallet?.balance);
+  const wallet = asObject4(value);
+  const balance = asObject4(wallet?.balance);
   if (!wallet || !balance || balance.type !== "BOOSTER") return [];
   const totalRaw = asPositiveInteger(balance.amount);
   if (totalRaw === void 0) return [];
@@ -682,7 +753,7 @@ function parseBoosterWallet(value) {
   return metrics;
 }
 function parseMoney(value) {
-  const money = asObject3(value);
+  const money = asObject4(value);
   if (!money) return void 0;
   const cents = asNonnegativeInteger2(money.priceInCents);
   if (cents === void 0) return void 0;
@@ -696,7 +767,7 @@ function fixedPointToMajor(value) {
   const major = roundedCents / 100;
   return Number.isSafeInteger(roundedCents) && Number.isFinite(major) ? major : void 0;
 }
-function asObject3(value) {
+function asObject4(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -770,12 +841,12 @@ var ZEN_WINDOWS = [
   { key: "monthly", label: "Monthly" }
 ];
 function normalizeOpenCodeZenPayload(payload, capturedAt) {
-  const usage = asObject4(payload.usage);
+  const usage = asObject5(payload.usage);
   if (!usage) throw new Error("OpenCode Zen usage response was not an object.");
   const buckets = [];
   const notes = [];
   for (const window of ZEN_WINDOWS) {
-    const raw = asObject4(usage[window.key]);
+    const raw = asObject5(usage[window.key]);
     if (!raw) continue;
     const status = asString3(raw.status);
     if (status !== "ok" && status !== "rate-limited") {
@@ -812,7 +883,7 @@ function normalizeOpenCodeZenPayload(payload, capturedAt) {
     ...notes.length > 0 ? { notes } : {}
   };
 }
-function asObject4(value) {
+function asObject5(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -836,7 +907,7 @@ function clampPercent2(value) {
 
 // src/providers/openrouter.ts
 function normalizeOpenRouterKeyPayload(payload, capturedAt) {
-  const data = asObject5(payload.data);
+  const data = asObject6(payload.data);
   if (!data) throw new Error("OpenRouter key response data was not an object.");
   const limit = asNonnegativeNumber3(data.limit);
   const remaining = asNonnegativeNumber3(data.limit_remaining);
@@ -882,7 +953,7 @@ function addUsageMetric(metrics, id, label, value) {
   if (amount === void 0) return;
   metrics.push({ id, label, value: amount, unit: "usd" });
 }
-function asObject5(value) {
+function asObject6(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -1060,13 +1131,13 @@ function isRecord2(value) {
 var FIVE_HOUR_WINDOW_MINUTES2 = 300;
 var WEEKLY_WINDOW_MINUTES2 = 10080;
 function normalizeZaiQuotaPayload(providerId, providerName, payload, capturedAt) {
-  const data = asObject6(payload.data);
+  const data = asObject7(payload.data);
   if (!data) throw new Error("Z.AI quota response data was not an object.");
   const limits = Array.isArray(data.limits) ? data.limits : [];
   const buckets = [];
   const metrics = [];
   for (const raw of limits) {
-    const limit = asObject6(raw);
+    const limit = asObject7(raw);
     if (!limit) continue;
     const type = asString5(limit.type);
     const unit = asNonnegativeNumber4(limit.unit);
@@ -1138,7 +1209,7 @@ function addCountBucket(buckets, limit, id, label, windowMinutes) {
 function addUsageDetailMetrics(metrics, value) {
   if (!Array.isArray(value)) return;
   for (const raw of value) {
-    const detail = asObject6(raw);
+    const detail = asObject7(raw);
     if (!detail) continue;
     const label = asString5(detail.modelCode);
     const usage = asNonnegativeNumber4(detail.usage);
@@ -1146,7 +1217,7 @@ function addUsageDetailMetrics(metrics, value) {
     metrics.push({ id: `mcp-${kebabCase(label)}`, label, value: usage, unit: "count" });
   }
 }
-function asObject6(value) {
+function asObject7(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -1172,6 +1243,7 @@ function clampPercent3(value) {
 
 // src/query.ts
 var CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
+var DEEPSEEK_BALANCE_URL = "https://api.deepseek.com/user/balance";
 var GITHUB_COPILOT_USAGE_URL = "https://api.github.com/copilot_internal/user";
 var OPENROUTER_KEY_URL = "https://openrouter.ai/api/v1/key";
 var OPENCODE_GO_USAGE_URL = "https://opencode.ai/zen/go/v1/usage";
@@ -1205,6 +1277,27 @@ var SUPPORTED_ADAPTERS = [
       return normalizeCodexBackendPayload(payload, Date.now());
     }
   },
+  {
+    id: "deepseek",
+    displayName: "DeepSeek",
+    semantics: { kind: "api-key", label: "DeepSeek API balance" },
+    async query(auth, signal, timeoutMs, guard) {
+      if (!guard) throw new Error("DeepSeek API balance requires request-boundary revalidation.");
+      const startedAt = Date.now();
+      await guard();
+      const remainingMs = timeoutMs - (Date.now() - startedAt);
+      if (remainingMs <= 0) throw new Error("Timed out while revalidating DeepSeek runtime auth.");
+      const payload = await fetchProviderJson(
+        DEEPSEEK_BALANCE_URL,
+        auth,
+        signal,
+        remainingMs,
+        "DeepSeek API balance endpoint",
+        { redirect: "error" }
+      );
+      return normalizeDeepSeekBalancePayload(payload, Date.now());
+    }
+  },
   {
     id: "github-copilot",
     displayName: "GitHub Copilot",
@@ -1273,7 +1366,6 @@ var SUPPORTED_ADAPTERS = [
     id: "zai",
     displayName: "Z.AI",
     semantics: { kind: "consumer-subscription", label: "GLM Coding Plan usage" },
-    publishesStatusline: false,
     async query(auth, signal, timeoutMs) {
       const payload = await fetchProviderJson(
         zaiMonitorUrl(auth.model.baseUrl),
@@ -1289,7 +1381,6 @@ var SUPPORTED_ADAPTERS = [
     id: "zai-coding-cn",
     displayName: "Z.AI Coding CN",
     semantics: { kind: "consumer-subscription", label: "GLM Coding Plan usage" },
-    publishesStatusline: false,
     async query(auth, signal, timeoutMs) {
       const payload = await fetchProviderJson(
         zaiMonitorUrl(auth.model.baseUrl),
@@ -1351,11 +1442,11 @@ var XAI_ADAPTER = {
     return normalizeXaiBillingPayload(billingPayload, userPayload.subscriptionTier, Date.now());
   }
 };
-function usageAdapters(xaiUsage = true) {
-  return xaiUsage ? [...SUPPORTED_ADAPTERS, XAI_ADAPTER] : SUPPORTED_ADAPTERS;
+function usageAdapters() {
+  return [...SUPPORTED_ADAPTERS, XAI_ADAPTER];
 }
-function adapterForProvider(providerId, xaiUsage = true) {
-  return usageAdapters(xaiUsage).find((adapter) => adapter.id === providerId);
+function adapterForProvider(providerId) {
+  return usageAdapters().find((adapter) => adapter.id === providerId);
 }
 function isStaleExtensionContextError(error) {
   return error instanceof Error && error.message.includes("This extension ctx is stale after session replacement or reload");
@@ -1372,11 +1463,14 @@ async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, cred
   if (!model) return void 0;
   const registry = ctx.modelRegistry;
   let modelAuth;
-  if (ctx.model?.provider === adapter.id && typeof registry.getApiKeyAndHeaders === "function") {
-    const result = await registry.getApiKeyAndHeaders(ctx.model);
+  const currentModel = ctx.model?.provider === adapter.id ? ctx.model : void 0;
+  const resolveCurrentModelAuth = async () => {
+    if (!currentModel || typeof registry.getApiKeyAndHeaders !== "function") return void 0;
+    const result = await registry.getApiKeyAndHeaders(currentModel);
     if (!result.ok) throw new Error(redactUsageError(result.error));
-    if (authorizationFrom(result)) modelAuth = result;
-  }
+    return authorizationFrom(result) ? result : void 0;
+  };
+  if (adapter.id !== "deepseek") modelAuth = await resolveCurrentModelAuth();
   if (typeof registry.getProviderAuth !== "function") {
     throw new Error("pi-usage requires Pi 0.81.0 or newer to validate resolved provider auth.");
   }
@@ -1386,6 +1480,7 @@ async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, cred
       `${adapter.displayName} usage cannot send a proxy-resolved credential to the official usage endpoint.`
     );
   }
+  if (adapter.id === "deepseek") modelAuth = await resolveCurrentModelAuth();
   const auth = modelAuth ?? providerResult?.auth;
   if (!auth) return void 0;
   if (adapter.id === "github-copilot") {
@@ -1406,6 +1501,26 @@ async function resolveUsageAuth(ctx, adapter, salt = AUTH_FINGERPRINT_SALT, cred
     if (!offered.ok) throw new Error("xAI OAuth credential discovery failed closed.");
     return resolveXaiUsageAuth(auth, model, salt, offered.candidates);
   }
+  if (adapter.id === "deepseek") {
+    const resolvedAuthorization = authorizationFrom(auth);
+    const access = bearerToken(resolvedAuthorization);
+    if (!access) throw new Error("DeepSeek API balance requires Bearer authentication.");
+    const authorization2 = `Bearer ${access}`;
+    const headers2 = { Authorization: authorization2 };
+    return {
+      apiKey: access,
+      headers: headers2,
+      fingerprint: fingerprintResolvedAuth({ headers: headers2 }, salt),
+      secrets: [
+        access,
+        auth.apiKey,
+        headerValue(auth.headers, "Authorization"),
+        resolvedAuthorization,
+        authorization2
+      ].filter((value) => Boolean(value)),
+      model
+    };
+  }
   const authorization = authorizationFrom(auth);
   if (!authorization) return void 0;
   const headers = { Authorization: authorization };
@@ -1563,7 +1678,7 @@ function resolveXaiUsageAuth(auth, model, salt, candidates) {
   const matches = [];
   for (const candidate of candidates) {
     try {
-      const credential = asObject7(candidate);
+      const credential = asObject8(candidate);
       if (credential?.type !== "oauth") continue;
       sawOAuth = true;
       if (credential.access !== resolvedAccess) continue;
@@ -1617,7 +1732,7 @@ function resolveGitHubCopilotUsageAuth(auth, model, salt, candidates, standalone
   const matches = /* @__PURE__ */ new Map();
   for (const candidate of candidates) {
     try {
-      const credential = asObject7(candidate);
+      const credential = asObject8(candidate);
       if (credential?.type !== "oauth") continue;
       sawOAuth = true;
       const storedAccess2 = typeof credential.access === "string" && credential.access ? credential.access : void 0;
@@ -1679,7 +1794,7 @@ function bearerToken(authorization) {
   const match = /^Bearer\s+(.+)$/iu.exec(authorization ?? "");
   return match?.[1];
 }
-function asObject7(value) {
+function asObject8(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -1698,6 +1813,7 @@ function hasOfficialUrlOrigin(value, providerId) {
   try {
     const url = new URL(value);
     if (providerId === "openai-codex") return url.origin === "https://chatgpt.com";
+    if (providerId === "deepseek") return url.origin === "https://api.deepseek.com";
     if (providerId === "openrouter") return url.origin === "https://openrouter.ai";
     if (providerId === "opencode-go") return url.origin === "https://opencode.ai";
     if (providerId === "kimi-coding") return url.origin === "https://api.kimi.com";
@@ -1885,7 +2001,7 @@ function normalizeCodexResetCreditsPayload(payload) {
   if (rawCredits !== void 0 && !Array.isArray(rawCredits)) {
     throw new Error("Codex reset credits response returned invalid credits.");
   }
-  const options = (rawCredits ?? []).map(asObject8).filter((credit) => Boolean(credit)).filter((credit) => credit.status === "available" && credit.reset_type === "codex_rate_limits").map(normalizeResetOption).sort(
+  const options = (rawCredits ?? []).map(asObject9).filter((credit) => Boolean(credit)).filter((credit) => credit.status === "available" && credit.reset_type === "codex_rate_limits").map(normalizeResetOption).sort(
     (left, right) => (left.expiresAt ?? Number.MAX_SAFE_INTEGER) - (right.expiresAt ?? Number.MAX_SAFE_INTEGER)
   ).slice(0, Math.min(availableCount, MAX_RESET_OPTIONS));
   if (availableCount > 0 && options.length === 0) {
@@ -1900,7 +2016,7 @@ function selectCodexResetCredential(candidates, resolvedAccess, resolvedAccountI
   const matches = /* @__PURE__ */ new Map();
   for (const candidate of candidates) {
     try {
-      const credential = asObject8(candidate);
+      const credential = asObject9(candidate);
       if (credential?.type !== "oauth") continue;
       sawOAuth = true;
       const storedAccess = asNonemptyString(credential.access);
@@ -1939,7 +2055,7 @@ function codexAccountIdFromAccessToken(access) {
     const parts = access.split(".");
     if (parts.length !== 3 || !parts[1]) return void 0;
     const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
-    const claims = asObject8(asObject8(payload)?.["https://api.openai.com/auth"]);
+    const claims = asObject9(asObject9(payload)?.["https://api.openai.com/auth"]);
     return validHeaderValue(claims?.chatgpt_account_id);
   } catch {
     return void 0;
@@ -1971,7 +2087,7 @@ function normalizeResetOption(credit) {
 function isCodexResetOutcomeCode(value) {
   return value === "reset" || value === "nothing_to_reset" || value === "no_credit" || value === "already_redeemed";
 }
-function asObject8(value) {
+function asObject9(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
@@ -2012,10 +2128,12 @@ var BAR_SEGMENTS = 20;
 var VALUE_COLUMN = 29;
 function formatUsageReport(report, displayState) {
   const stateLabel = displayState === "current" ? "Current" : "Configured";
-  const lines = [`${report.providerName} Usage \xB7 ${stateLabel}`];
+  const title = report.providerId === "deepseek" ? "DeepSeek API Balance" : `${report.providerName} Usage`;
+  const lines = [`${title} \xB7 ${stateLabel}`];
   if (report.accountLabel) lines.push(`Account: ${report.accountLabel}`);
   lines.push(`Semantics: ${report.semantics.label}`, "");
   if (report.providerId === "openai-codex") formatCodexReport(lines, report);
+  else if (report.providerId === "deepseek") formatDeepSeekReport(lines, report);
   else if (report.providerId === "github-copilot") formatGitHubCopilotReport(lines, report);
   else if (report.providerId === "openrouter") formatOpenRouterReport(lines, report);
   else if (report.providerId === "opencode-go") formatOpenCodeZenReport(lines, report);
@@ -2029,8 +2147,11 @@ function formatUsageReport(report, displayState) {
   }
   return lines.join("\n").trimEnd();
 }
-function formatUsageStatusline(report, model) {
-  if (report.providerId === "openai-codex") return formatCodexStatusline(report, model);
+function formatUsageStatusline(report, model, now = Date.now(), showCodexResetCountdown = true) {
+  if (report.providerId === "openai-codex") {
+    return formatCodexStatusline(report, model, now, showCodexResetCountdown);
+  }
+  if (report.providerId === "deepseek") return formatDeepSeekStatusline(report);
   if (report.providerId === "github-copilot") return formatGitHubCopilotStatusline(report);
   if (report.providerId === "openrouter") {
     const limit = report.buckets.find((bucket) => bucket.id === "key-limit");
@@ -2040,6 +2161,9 @@ function formatUsageStatusline(report, model) {
   }
   if (report.providerId === "opencode-go") return formatOpenCodeZenStatusline(report);
   if (report.providerId === "kimi-coding") return formatKimiCodingStatusline(report);
+  if (report.providerId === "zai" || report.providerId === "zai-coding-cn") {
+    return formatZaiStatusline(report);
+  }
   return void 0;
 }
 function formatProviderStates(states) {
@@ -2073,6 +2197,31 @@ function formatCodexReport(lines, report) {
     }
   }
 }
+function formatDeepSeekReport(lines, report) {
+  const availability = report.metrics.find((metric) => metric.id === "api-availability");
+  lines.push(
+    `${"API calls:".padEnd(VALUE_COLUMN)}${availability?.value === "available" ? "Available" : "Unavailable"}`
+  );
+  for (const currency of ["CNY", "USD"]) {
+    const metrics = report.metrics.filter((metric) => metric.currency === currency);
+    if (metrics.length === 0) continue;
+    lines.push("", `${currency} balance:`);
+    for (const metric of metrics) {
+      lines.push(`${`${metric.label}:`.padEnd(VALUE_COLUMN)}${currency} ${metric.value}`);
+    }
+  }
+}
+function formatDeepSeekStatusline(report) {
+  const availability = report.metrics.find((metric) => metric.id === "api-availability");
+  if (availability?.value !== "available") return "deepseek API unavailable";
+  const totals = ["CNY", "USD"].flatMap((currency) => {
+    const metric = report.metrics.find(
+      (candidate) => candidate.id === `${currency.toLowerCase()}-total`
+    );
+    return metric ? [`${currency} ${metric.value}`] : [];
+  });
+  return totals.length > 0 ? `deepseek ${totals.join(" \xB7 ")}` : "deepseek balance unavailable";
+}
 function formatGitHubCopilotReport(lines, report) {
   const quota = findGitHubCopilotQuota(report);
   if (!quota || quota.limit === void 0 || quota.remaining === void 0) {
@@ -2187,6 +2336,21 @@ function formatKimiCodingStatusline(report) {
   }
   return parts.length > 1 ? parts.join(" ") : void 0;
 }
+function formatZaiStatusline(report) {
+  const selected = [
+    report.buckets.find((bucket) => bucket.id === "five-hour"),
+    report.buckets.find((bucket) => bucket.id === "weekly")
+  ];
+  const parts = ["zai"];
+  for (const bucket of selected) {
+    if (!bucket?.limit || bucket.remaining === void 0) continue;
+    const fallback = bucket.id === "weekly" ? "weekly" : "5h";
+    parts.push(
+      `${percentRemaining(bucket)}% ${formatWindowLabel(bucket.windowMinutes, fallback, true)}`
+    );
+  }
+  return parts.length > 1 ? parts.join(" ") : void 0;
+}
 function formatCurrencyMetric(metric) {
   if (typeof metric.value !== "number") return String(metric.value);
   if (!metric.currency) return "unavailable";
@@ -2258,7 +2422,7 @@ function formatGenericReport(lines, report) {
     );
   }
 }
-function formatCodexStatusline(report, model) {
+function formatCodexStatusline(report, model, now = Date.now(), showResetCountdown = true) {
   const group = selectCodexGroup(report, model);
   if (!group) return formatCodexCreditsStatus(report);
   const buckets = report.buckets.filter((bucket) => (bucket.groupId ?? bucket.id) === group);
@@ -2268,10 +2432,15 @@ function formatCodexStatusline(report, model) {
   ];
   for (const bucket of buckets) {
     if (bucket.remaining === void 0) continue;
+    const percent = `${clampPercent4(bucket.remaining).toFixed(0)}%`;
     const fallback = bucket.id.endsWith(":secondary") ? "weekly" : "5h";
-    parts.push(
-      `${clampPercent4(bucket.remaining).toFixed(0)}% ${formatWindowLabel(bucket.windowMinutes, fallback, true)}`
-    );
+    const window = formatWindowLabel(bucket.windowMinutes, fallback, true);
+    if (!showResetCountdown) {
+      parts.push(`${percent} ${window}`);
+      continue;
+    }
+    const reset = formatResetCountdown(bucket.resetsAt, now);
+    parts.push(`${percent} ${reset ? `\u21BB ${reset}` : window}`);
   }
   return parts.length > 1 ? parts.join(" ") : formatCodexCreditsStatus(report);
 }
@@ -2352,6 +2521,23 @@ function formatWindowLabel(minutes, fallback, compact) {
   if (minutes % 60 === 0) return `${minutes / 60}h`;
   return `${minutes}m`;
 }
+function formatResetCountdown(resetsAt, now) {
+  if (resetsAt === void 0 || !Number.isFinite(resetsAt) || !Number.isFinite(now))
+    return void 0;
+  const totalMinutes = Math.max(0, Math.ceil((resetsAt * 1e3 - now) / 6e4));
+  const days = Math.floor(totalMinutes / 1440);
+  const hours = Math.floor(totalMinutes % 1440 / 60);
+  const minutes = totalMinutes % 60;
+  if (days > 0) {
+    return [
+      `${String(days)}d`,
+      hours > 0 ? `${String(hours)}h` : minutes > 0 ? `${String(minutes)}m` : ""
+    ].filter(Boolean).join("");
+  }
+  if (hours > 0)
+    return [`${String(hours)}h`, minutes > 0 ? `${String(minutes)}m` : ""].filter(Boolean).join("");
+  return `${String(minutes)}m`;
+}
 function formatMetricValue(value, unit) {
   if (unit === "usd" && typeof value === "number") return formatUsd(value);
   return String(value);
@@ -2384,7 +2570,7 @@ var USAGE_SETTINGS_FILE = "pi-usage.json";
 var MAX_USAGE_SETTINGS_BYTES = 64 * 1024;
 var DEFAULT_USAGE_SETTINGS = Object.freeze({
   codexFastMode: false,
-  xaiUsage: true
+  codexStatusResetCountdown: true
 });
 function usageSettingsPath() {
   return join(getAgentDir(), USAGE_SETTINGS_FILE);
@@ -2394,12 +2580,12 @@ function normalizeUsageSettings(value) {
   if (Object.hasOwn(value, "codexFastMode") && typeof value.codexFastMode !== "boolean") {
     return void 0;
   }
-  if (Object.hasOwn(value, "xaiUsage") && typeof value.xaiUsage !== "boolean") {
+  if (Object.hasOwn(value, "codexStatusResetCountdown") && typeof value.codexStatusResetCountdown !== "boolean") {
     return void 0;
   }
   return {
     codexFastMode: typeof value.codexFastMode === "boolean" ? value.codexFastMode : DEFAULT_USAGE_SETTINGS.codexFastMode,
-    xaiUsage: typeof value.xaiUsage === "boolean" ? value.xaiUsage : DEFAULT_USAGE_SETTINGS.xaiUsage
+    codexStatusResetCountdown: typeof value.codexStatusResetCountdown === "boolean" ? value.codexStatusResetCountdown : DEFAULT_USAGE_SETTINGS.codexStatusResetCountdown
   };
 }
 async function loadUsageSettings(path = usageSettingsPath(), signal) {
@@ -2684,8 +2870,8 @@ function isAbortError2(error) {
 }
 
 // src/usage-helpers.ts
-function configuredAdapters(ctx, xaiUsage = true) {
-  return usageAdapters(xaiUsage).filter(
+function configuredAdapters(ctx) {
+  return usageAdapters().filter(
     (adapter) => adapter.id === ctx.model?.provider || providerIsConfigured(ctx, adapter.id)
   );
 }
@@ -2750,10 +2936,10 @@ async function showUsageSettings(ctx, settingsRuntime, parentSignal, isCurrent,
         values: [OFF, ON]
       },
       {
-        id: "xaiUsage",
-        label: "xAI usage",
-        description: "Report OAuth subscription allowance and credits.",
-        currentValue: state.kind !== "invalid" && state.settings.xaiUsage ? ON : OFF,
+        id: "codexStatusResetCountdown",
+        label: "Codex reset countdown",
+        description: "Show time remaining until each Codex usage limit resets.",
+        currentValue: state.settings.codexStatusResetCountdown ? ON : OFF,
         values: [OFF, ON]
       }
     ];
@@ -2777,8 +2963,7 @@ async function showUsageSettings(ctx, settingsRuntime, parentSignal, isCurrent,
         saveQueue = saveQueue.then(async () => {
           const previous = settingsRuntime.get().settings[settingId];
           if (settingsRuntime.get().kind === "invalid") {
-            const effectivePrevious = settingId === "xaiUsage" ? false : previous;
-            settingsList.updateValue(id, displayValue(settingId, effectivePrevious));
+            settingsList.updateValue(id, displayValue(previous));
             if (!signal.aborted && isCurrent()) {
               ctx.ui.notify("Repair pi-usage.json and reload before changing settings.", "error");
               tui.requestRender();
@@ -2789,17 +2974,17 @@ async function showUsageSettings(ctx, settingsRuntime, parentSignal, isCurrent,
             await settingsRuntime.update({ [settingId]: requested }, signal);
           } catch (error) {
             if (signal.aborted || !isCurrent()) return;
-            settingsList.updateValue(id, displayValue(settingId, previous));
+            settingsList.updateValue(id, displayValue(previous));
             ctx.ui.notify(`Could not save pi-usage.json: ${errorMessage(error)}`, "error");
             tui.requestRender();
             return;
           }
           if (previous !== requested) {
             changed = true;
-            onApplied(settingId, previous, requested);
+            onApplied(settingId);
           }
           if (signal.aborted || !isCurrent()) return;
-          settingsList.updateValue(id, displayValue(settingId, requested));
+          settingsList.updateValue(id, displayValue(requested));
           tui.requestRender();
         });
       },
@@ -2823,12 +3008,13 @@ async function showUsageSettings(ctx, settingsRuntime, parentSignal, isCurrent,
     };
   });
 }
-function displayValue(_id, enabled) {
+function displayValue(enabled) {
   return enabled ? ON : OFF;
 }
 
 // src/usage.ts
 var CACHE_TTL_MS = 5 * 60 * 1e3;
+var STATUS_COUNTDOWN_REFRESH_MS = 60 * 1e3;
 var DEFAULT_TIMEOUT_MS = 15e3;
 var ALL_PROVIDER_CONCURRENCY = 2;
 var FAILURE_BACKOFF_MS = 3e4;
@@ -2854,19 +3040,22 @@ function usageExtension(pi, dependencies = {}) {
   let sessionActive = false;
   let statusGeneration = 0;
   let sessionGeneration = 0;
-  let xaiSettingsGeneration = 0;
   let statusRefreshTimer;
+  let statusCountdownTimer;
   let statusController;
   let fastRuntime;
-  const xaiUsageEnabled = () => {
-    const state = settingsRuntime.get();
-    return state.kind !== "invalid" && state.settings.xaiUsage;
-  };
-  const activeAdapterForProvider = (providerId) => adapterForProvider(providerId, xaiUsageEnabled());
-  const clearStatusTimer = () => {
+  const clearStatusRefreshTimer = () => {
     if (statusRefreshTimer) clearTimeout(statusRefreshTimer);
     statusRefreshTimer = void 0;
   };
+  const clearStatusCountdownTimer = () => {
+    if (statusCountdownTimer) clearTimeout(statusCountdownTimer);
+    statusCountdownTimer = void 0;
+  };
+  const clearStatusTimers = () => {
+    clearStatusRefreshTimer();
+    clearStatusCountdownTimer();
+  };
   const safeSetStatus = (ctx, value) => {
     try {
       ctx.ui.setStatus(STATUS_KEY, value);
@@ -2880,11 +3069,11 @@ function usageExtension(pi, dependencies = {}) {
     statusGeneration += 1;
     statusController?.abort();
     statusController = void 0;
-    clearStatusTimer();
+    clearStatusTimers();
     safeSetStatus(ctx, void 0);
   };
   const scheduleStatusRefresh = (ctx, model) => {
-    clearStatusTimer();
+    clearStatusRefreshTimer();
     const generation = statusGeneration;
     statusRefreshTimer = setTimeout(() => {
       statusRefreshTimer = void 0;
@@ -2894,13 +3083,14 @@ function usageExtension(pi, dependencies = {}) {
     statusRefreshTimer.unref?.();
   };
   const publishStatus = (ctx, outcome, model, shouldSchedule) => {
-    if (activeAdapterForProvider(model.provider)?.publishesStatusline === false) {
-      clearStatusTimer();
+    clearStatusCountdownTimer();
+    if (adapterForProvider(model.provider)?.publishesStatusline === false) {
+      clearStatusRefreshTimer();
       safeSetStatus(ctx, void 0);
       return;
     }
     if (outcome.state.status === "unsupported") {
-      clearStatusTimer();
+      clearStatusRefreshTimer();
       safeSetStatus(ctx, void 0);
       return;
     }
@@ -2913,10 +3103,30 @@ function usageExtension(pi, dependencies = {}) {
       }
       return;
     }
-    const rawValue = formatUsageStatusline(outcome.state.report, model);
+    const showCodexResetCountdown = outcome.state.report.providerId === "openai-codex" && settingsRuntime.get().settings.codexStatusResetCountdown;
+    const now = Date.now();
+    const rawValue = formatUsageStatusline(
+      outcome.state.report,
+      model,
+      now,
+      showCodexResetCountdown
+    );
     const value = rawValue ? fastRuntime.decorateStatus(model, rawValue) : void 0;
     if (!safeSetStatus(ctx, value)) return;
     if (shouldSchedule && sessionActive) scheduleStatusRefresh(ctx, model);
+    if (sessionActive && showCodexResetCountdown && outcome.state.report.buckets.some(
+      (bucket) => bucket.resetsAt !== void 0 && Number.isFinite(bucket.resetsAt) && bucket.resetsAt * 1e3 > now
+    )) {
+      const generation = statusGeneration;
+      statusCountdownTimer = setTimeout(() => {
+        statusCountdownTimer = void 0;
+        if (!sessionActive || generation !== statusGeneration || modelIdentity(ctx.model) !== modelIdentity(model)) {
+          return;
+        }
+        publishStatus(ctx, outcome, model, false);
+      }, STATUS_COUNTDOWN_REFRESH_MS);
+      statusCountdownTimer.unref?.();
+    }
   };
   const invalidateProviderState = (providerId) => {
     cache.clearProvider(providerId);
@@ -2938,10 +3148,8 @@ function usageExtension(pi, dependencies = {}) {
     }
     activeCurrentIdentity = nextIdentity;
   };
-  const queryAdapterState = async (ctx, adapter, displayState, force, signal) => {
-    const startedAt = Date.now();
+  const queryAdapterState = async (ctx, adapter, displayState, force, signal, authRetry = 0, deadlineAt = Date.now() + DEFAULT_TIMEOUT_MS) => {
     const expectedSessionGeneration = sessionGeneration;
-    const expectedXaiSettingsGeneration = xaiSettingsGeneration;
     const expectedSessionId = ctx.sessionManager.getSessionId();
     const expectedModelIdentity = modelIdentity(ctx.model);
     let auth;
@@ -2949,7 +3157,7 @@ function usageExtension(pi, dependencies = {}) {
       auth = await awaitWithDeadline(
         resolveUsageAuth(ctx, adapter, void 0, credentialReader, credentialCandidates),
         signal,
-        DEFAULT_TIMEOUT_MS,
+        Math.max(1, deadlineAt - Date.now()),
         `resolving ${adapter.displayName} runtime auth`
       );
     } catch (error) {
@@ -2967,9 +3175,9 @@ function usageExtension(pi, dependencies = {}) {
         }
       };
     }
-    if (adapter.id === "xai" && (expectedSessionGeneration !== sessionGeneration || expectedXaiSettingsGeneration !== xaiSettingsGeneration || !xaiUsageEnabled() || ctx.sessionManager.getSessionId() !== expectedSessionId || modelIdentity(ctx.model) !== expectedModelIdentity)) {
-      throw abortError();
-    }
+    const requiresRequestBoundaryGuard = adapter.id === "deepseek" || adapter.id === "xai";
+    const requestContextChanged = () => expectedSessionGeneration !== sessionGeneration || ctx.sessionManager.getSessionId() !== expectedSessionId || modelIdentity(ctx.model) !== expectedModelIdentity;
+    if (requiresRequestBoundaryGuard && requestContextChanged()) throw abortError();
     if (!auth) {
       if (displayState === "current") {
         transitionCurrentIdentity(`${adapter.id}:unavailable`, adapter.id);
@@ -3019,19 +3227,23 @@ function usageExtension(pi, dependencies = {}) {
     querySequence += 1;
     const queryId = querySequence;
     setBoundedMap(latestQueries, failureKey, queryId, MAX_ACCOUNT_STATES);
+    let deepSeekAuthChanged = false;
     try {
-      const remainingMs = Math.max(1, DEFAULT_TIMEOUT_MS - (Date.now() - startedAt));
-      const guard = adapter.id === "xai" ? async () => {
-        if (signal.aborted || expectedSessionGeneration !== sessionGeneration || expectedXaiSettingsGeneration !== xaiSettingsGeneration || !xaiUsageEnabled() || ctx.sessionManager.getSessionId() !== expectedSessionId || modelIdentity(ctx.model) !== expectedModelIdentity) {
-          throw abortError();
-        }
+      const remainingMs = Math.max(1, deadlineAt - Date.now());
+      const guard = requiresRequestBoundaryGuard ? async () => {
+        if (signal.aborted || requestContextChanged()) throw abortError();
         const revalidated = await awaitWithDeadline(
           resolveUsageAuth(ctx, adapter, void 0, credentialReader, credentialCandidates),
           signal,
-          Math.max(1, DEFAULT_TIMEOUT_MS - (Date.now() - startedAt)),
-          "revalidating xAI runtime auth"
+          Math.max(1, deadlineAt - Date.now()),
+          `revalidating ${adapter.displayName} runtime auth`
         );
-        if (signal.aborted || expectedSessionGeneration !== sessionGeneration || expectedXaiSettingsGeneration !== xaiSettingsGeneration || !xaiUsageEnabled() || ctx.sessionManager.getSessionId() !== expectedSessionId || modelIdentity(ctx.model) !== expectedModelIdentity || revalidated?.fingerprint !== auth.fingerprint) {
+        if (signal.aborted || requestContextChanged()) throw abortError();
+        if (revalidated?.fingerprint !== auth.fingerprint) {
+          if (adapter.id === "deepseek") {
+            deepSeekAuthChanged = true;
+            throw new Error("DeepSeek runtime credential changed during the balance query.");
+          }
           throw abortError();
         }
       } : void 0;
@@ -3053,6 +3265,18 @@ function usageExtension(pi, dependencies = {}) {
       };
     } catch (error) {
       if (isStaleExtensionContextError(error) || isAbortError3(error)) throw error;
+      if (deepSeekAuthChanged && authRetry === 0 && !signal.aborted && !requestContextChanged() && Date.now() < deadlineAt) {
+        if (latestQueries.get(failureKey) === queryId) latestQueries.delete(failureKey);
+        return queryAdapterState(
+          ctx,
+          adapter,
+          displayState,
+          true,
+          signal,
+          authRetry + 1,
+          deadlineAt
+        );
+      }
       const message = errorMessage(error);
       const now = Date.now();
       for (const [key, failure] of failureBackoff) {
@@ -3079,7 +3303,7 @@ function usageExtension(pi, dependencies = {}) {
     }
   };
   const queryCurrentState = async (ctx, model, force, signal) => {
-    const adapter = activeAdapterForProvider(model?.provider);
+    const adapter = adapterForProvider(model?.provider);
     if (!adapter) {
       const providerId = model?.provider ?? "none";
       transitionCurrentIdentity(`unsupported:${providerId}`, providerId);
@@ -3089,14 +3313,14 @@ function usageExtension(pi, dependencies = {}) {
           providerName: providerDisplayName(ctx, providerId),
           displayState: "current",
           status: "unsupported",
-          message: providerId === "xai" && !xaiUsageEnabled() ? "xAI usage is disabled. Open Settings to enable it." : model ? `Usage reporting is not supported for ${providerDisplayName(ctx, providerId)}.` : "No model is selected."
+          message: model ? `Usage reporting is not supported for ${providerDisplayName(ctx, providerId)}.` : "No model is selected."
         }
       };
     }
     return queryAdapterState(ctx, adapter, "current", force, signal);
   };
   const refreshCurrentStatus = async (ctx, model, force) => {
-    const adapter = activeAdapterForProvider(model?.provider);
+    const adapter = adapterForProvider(model?.provider);
     if (!adapter || !model) {
       const providerId = model?.provider ?? "none";
       transitionCurrentIdentity(`unsupported:${providerId}`, providerId);
@@ -3109,6 +3333,7 @@ function usageExtension(pi, dependencies = {}) {
     }
     statusGeneration += 1;
     const generation = statusGeneration;
+    clearStatusCountdownTimer();
     statusController?.abort();
     const controller = new AbortController();
     statusController = controller;
@@ -3159,7 +3384,7 @@ function usageExtension(pi, dependencies = {}) {
     if (generation !== statusGeneration || modelIdentity(ctx.model) !== modelIdentity(model)) {
       return false;
     }
-    const adapter = activeAdapterForProvider(model?.provider);
+    const adapter = adapterForProvider(model?.provider);
     if (outcome.authState === "unavailable") {
       if (!adapter) return false;
       try {
@@ -3218,7 +3443,7 @@ function usageExtension(pi, dependencies = {}) {
     const menuGeneration = statusGeneration;
     statusController?.abort();
     statusController = void 0;
-    clearStatusTimer();
+    clearStatusTimers();
     const controller = new AbortController();
     activeControllers.add(controller);
     try {
@@ -3283,7 +3508,7 @@ function usageExtension(pi, dependencies = {}) {
           providers: () => ({
             kind: "actions",
             title: "Select a configured provider",
-            items: configuredAdapters(ctx, xaiUsageEnabled()).filter((adapter) => adapter.id !== ctx.model?.provider).map((adapter) => ({
+            items: configuredAdapters(ctx).filter((adapter) => adapter.id !== ctx.model?.provider).map((adapter) => ({
               id: adapter.id,
               label: adapter.displayName,
               action: "provider"
@@ -3353,14 +3578,9 @@ function usageExtension(pi, dependencies = {}) {
               settingsRuntime,
               controller.signal,
               () => statusGeneration === menuGeneration && !controller.signal.aborted,
-              (id, _previous, next) => {
-                if (id !== "xaiUsage") return;
-                xaiSettingsGeneration += 1;
-                invalidateProviderState("xai");
-                if (!next) {
-                  for (const active of activeControllers) {
-                    if (active !== controller) active.abort();
-                  }
+              (id) => {
+                if (id === "codexStatusResetCountdown" && stableCurrent && statusGeneration === menuGeneration && !controller.signal.aborted) {
+                  publishStableCurrent(ctx, stableCurrent);
                 }
               }
             );
@@ -3546,7 +3766,7 @@ function usageExtension(pi, dependencies = {}) {
             return { kind: "stay" };
           },
           another: async () => {
-            const others = configuredAdapters(ctx, xaiUsageEnabled()).filter(
+            const others = configuredAdapters(ctx).filter(
               (adapter) => adapter.id !== ctx.model?.provider
             );
             if (others.length === 0) {
@@ -3556,7 +3776,7 @@ function usageExtension(pi, dependencies = {}) {
             return { kind: "to", screen: "providers" };
           },
           provider: async ({ itemId }) => {
-            const adapter = configuredAdapters(ctx, xaiUsageEnabled()).find(
+            const adapter = configuredAdapters(ctx).find(
               (candidate) => candidate.id === itemId && candidate.id !== ctx.model?.provider
             );
             if (!adapter) return { kind: "back" };
@@ -3582,7 +3802,7 @@ function usageExtension(pi, dependencies = {}) {
             return { kind: "back" };
           },
           all: async () => {
-            const adapters = configuredAdapters(ctx, xaiUsageEnabled());
+            const adapters = configuredAdapters(ctx);
             const currentProviderId = ctx.model?.provider;
             const settled = await runMenuOperation(
               ctx,
@@ -3662,9 +3882,8 @@ function usageExtension(pi, dependencies = {}) {
   });
   pi.on("session_start", (_event, ctx) => {
     sessionGeneration += 1;
-    xaiSettingsGeneration += 1;
     statusGeneration += 1;
-    clearStatusTimer();
+    clearStatusTimers();
     for (const controller of activeControllers) controller.abort();
     activeControllers.clear();
     statusController = void 0;
@@ -3683,9 +3902,8 @@ function usageExtension(pi, dependencies = {}) {
   pi.on("session_shutdown", (_event, ctx) => {
     sessionActive = false;
     sessionGeneration += 1;
-    xaiSettingsGeneration += 1;
     statusGeneration += 1;
-    clearStatusTimer();
+    clearStatusTimers();
     for (const controller of activeControllers) controller.abort();
     activeControllers.clear();
     statusController = void 0;
@@ -3730,6 +3948,7 @@ export {
   loadUsageSettings,
   normalizeCodexBackendPayload,
   normalizeCodexResetCreditsPayload,
+  normalizeDeepSeekBalancePayload,
   normalizeGitHubCopilotUsagePayload,
   normalizeKimiCodingUsagePayload,
   normalizeOpenCodeZenPayload,