@narumitw/pi-usage 0.54.0 → 0.57.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@narumitw/pi-usage",
-	"version": "0.54.0",
-	"description": "Pi extension that shows current-account usage for Codex, Kimi For Coding, GitHub Copilot, OpenRouter, OpenCode Zen, Z.AI, and xAI OAuth subscriptions.",
+	"version": "0.57.0",
+	"description": "Pi extension that shows current-account usage and DeepSeek API balance for supported providers.",
 	"type": "module",
 	"license": "MIT",
 	"private": false,
@@ -11,6 +11,8 @@
 		"pi",
 		"usage",
 		"quota",
+		"balance",
+		"deepseek",
 		"codex",
 		"kimi",
 		"kimi-coding",
@@ -34,9 +36,6 @@
 			"./dist/index.ts"
 		]
 	},
-	"piExtension": {
-		"lifecycle": "stable"
-	},
 	"scripts": {
 		"build": "node scripts/build-runtime.mjs",
 		"check": "npm run build && biome check --vcs-use-ignore-file=false src test scripts package.json tsconfig.json README.md && npm run typecheck",
@@ -50,11 +49,11 @@
 		"@earendil-works/pi-tui": "*"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.10",
-		"@earendil-works/pi-ai": "0.84.3",
-		"@earendil-works/pi-coding-agent": "0.84.3",
-		"@earendil-works/pi-tui": "0.84.3",
-		"@types/node": "26.2.0",
+		"@biomejs/biome": "2.5.11",
+		"@earendil-works/pi-ai": "0.84.4",
+		"@earendil-works/pi-coding-agent": "0.84.4",
+		"@earendil-works/pi-tui": "0.84.4",
+		"@types/node": "26.4.0",
 		"esbuild": "0.28.2",
 		"typescript": "7.0.2"
 	},

package/src/format.ts

@@ -11,11 +11,14 @@ const VALUE_COLUMN = 29;
 
 export function formatUsageReport(report: UsageReport, displayState: UsageDisplayState): string {
 	const stateLabel = displayState === "current" ? "Current" : "Configured";
-	const lines = [`${report.providerName} Usage · ${stateLabel}`];
+	const title =
+		report.providerId === "deepseek" ? "DeepSeek API Balance" : `${report.providerName} Usage`;
+	const lines = [`${title} · ${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);
@@ -31,8 +34,16 @@ export function formatUsageReport(report: UsageReport, displayState: UsageDispla
 	return lines.join("\n").trimEnd();
 }
 
-export function formatUsageStatusline(report: UsageReport, model?: UsageModel): string | undefined {
-	if (report.providerId === "openai-codex") return formatCodexStatusline(report, model);
+export function formatUsageStatusline(
+	report: UsageReport,
+	model?: UsageModel,
+	now = Date.now(),
+	showCodexResetCountdown = true,
+): string | undefined {
+	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");
@@ -42,6 +53,9 @@ export function formatUsageStatusline(report: UsageReport, model?: UsageModel):
 	}
 	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 undefined;
 }
 
@@ -84,6 +98,33 @@ function formatCodexReport(lines: string[], report: UsageReport): void {
 	}
 }
 
+function formatDeepSeekReport(lines: string[], report: UsageReport): void {
+	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: UsageReport): string {
+	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(" · ")}` : "deepseek balance unavailable";
+}
+
 function formatGitHubCopilotReport(lines: string[], report: UsageReport): void {
 	const quota = findGitHubCopilotQuota(report);
 	if (!quota || quota.limit === undefined || quota.remaining === undefined) {
@@ -213,6 +254,22 @@ function formatKimiCodingStatusline(report: UsageReport): string | undefined {
 	return parts.length > 1 ? parts.join(" ") : undefined;
 }
 
+function formatZaiStatusline(report: UsageReport): string | undefined {
+	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 === undefined) continue;
+		const fallback = bucket.id === "weekly" ? "weekly" : "5h";
+		parts.push(
+			`${percentRemaining(bucket)}% ${formatWindowLabel(bucket.windowMinutes, fallback, true)}`,
+		);
+	}
+	return parts.length > 1 ? parts.join(" ") : undefined;
+}
+
 function formatCurrencyMetric(metric: UsageReport["metrics"][number]): string {
 	if (typeof metric.value !== "number") return String(metric.value);
 	if (!metric.currency) return "unavailable";
@@ -289,7 +346,12 @@ function formatGenericReport(lines: string[], report: UsageReport): void {
 	}
 }
 
-function formatCodexStatusline(report: UsageReport, model?: UsageModel): string | undefined {
+function formatCodexStatusline(
+	report: UsageReport,
+	model?: UsageModel,
+	now = Date.now(),
+	showResetCountdown = true,
+): string | undefined {
 	const group = selectCodexGroup(report, model);
 	if (!group) return formatCodexCreditsStatus(report);
 	const buckets = report.buckets.filter((bucket) => (bucket.groupId ?? bucket.id) === group);
@@ -299,10 +361,15 @@ function formatCodexStatusline(report: UsageReport, model?: UsageModel): string
 	];
 	for (const bucket of buckets) {
 		if (bucket.remaining === undefined) continue;
+		const percent = `${clampPercent(bucket.remaining).toFixed(0)}%`;
 		const fallback = bucket.id.endsWith(":secondary") ? "weekly" : "5h";
-		parts.push(
-			`${clampPercent(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 ? `↻ ${reset}` : window}`);
 	}
 	return parts.length > 1 ? parts.join(" ") : formatCodexCreditsStatus(report);
 }
@@ -405,6 +472,26 @@ function formatWindowLabel(
 	return `${minutes}m`;
 }
 
+function formatResetCountdown(resetsAt: number | undefined, now: number): string | undefined {
+	if (resetsAt === undefined || !Number.isFinite(resetsAt) || !Number.isFinite(now))
+		return undefined;
+	const totalMinutes = Math.max(0, Math.ceil((resetsAt * 1_000 - now) / 60_000));
+	const days = Math.floor(totalMinutes / 1_440);
+	const hours = Math.floor((totalMinutes % 1_440) / 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: number | string, unit: UsageBucket["unit"] | undefined): string {
 	if (unit === "usd" && typeof value === "number") return formatUsd(value);
 	return String(value);

package/src/index.ts

@@ -33,6 +33,7 @@ export {
 } from "./core.js";
 export { formatProviderStates, formatUsageReport, formatUsageStatusline } from "./format.js";
 export { normalizeCodexBackendPayload } from "./providers/codex.js";
+export { normalizeDeepSeekBalancePayload } from "./providers/deepseek.js";
 export { normalizeGitHubCopilotUsagePayload } from "./providers/github-copilot.js";
 export { normalizeKimiCodingUsagePayload } from "./providers/kimi-coding.js";
 export { normalizeOpenCodeZenPayload } from "./providers/opencode-zen.js";
@@ -62,6 +63,7 @@ export {
 	usageSettingsPath,
 } from "./settings.js";
 export type {
+	DeepSeekBalancePayload,
 	KimiCodingUsagePayload,
 	ProviderUsageState,
 	ResolvedUsageAuth,

package/src/providers/deepseek.ts

@@ -0,0 +1,85 @@
+import type { DeepSeekBalancePayload, UsageMetric, UsageReport } from "../types.js";
+
+const CURRENCIES = ["CNY", "USD"] as const;
+type DeepSeekCurrency = (typeof CURRENCIES)[number];
+
+const BALANCE_FIELDS = [
+	["total", "Total balance", "total_balance"],
+	["granted", "Granted balance", "granted_balance"],
+	["topped-up", "Topped-up balance", "topped_up_balance"],
+] as const;
+
+export function normalizeDeepSeekBalancePayload(
+	payload: DeepSeekBalancePayload,
+	capturedAt: number,
+): UsageReport {
+	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 = new Map<DeepSeekCurrency, Record<string, unknown>>();
+	for (const raw of payload.balance_infos) {
+		const balance = asObject(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: UsageMetric[] = [
+		{
+			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] as string,
+				unit: "currency",
+				currency,
+			});
+		}
+	}
+
+	return {
+		providerId: "deepseek",
+		providerName: "DeepSeek",
+		capturedAt,
+		source: "deepseek-balance",
+		semantics: { kind: "api-key", label: "DeepSeek API balance" },
+		buckets: [],
+		metrics,
+	};
+}
+
+function asObject(value: unknown): Record<string, unknown> | undefined {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
+	return value as Record<string, unknown>;
+}
+
+function deepSeekCurrency(value: unknown): DeepSeekCurrency | undefined {
+	return CURRENCIES.find((currency) => currency === value);
+}
+
+function decimalAmount(value: unknown): value is string {
+	return (
+		typeof value === "string" && value.length <= 64 && /^(?:0|[1-9]\d*)(?:\.\d+)?$/u.test(value)
+	);
+}

package/src/query.ts

@@ -6,6 +6,7 @@ import {
 	type OAuthCredentialCandidateReader,
 } from "./oauth-credential-source.js";
 import { normalizeCodexBackendPayload } from "./providers/codex.js";
+import { normalizeDeepSeekBalancePayload } from "./providers/deepseek.js";
 import { normalizeGitHubCopilotUsagePayload } from "./providers/github-copilot.js";
 import { normalizeKimiCodingUsagePayload } from "./providers/kimi-coding.js";
 import { normalizeOpenCodeZenPayload } from "./providers/opencode-zen.js";
@@ -14,6 +15,7 @@ import { normalizeXaiBillingPayload } from "./providers/xai.js";
 import { normalizeZaiQuotaPayload } from "./providers/zai.js";
 import type {
 	CodexBackendPayload,
+	DeepSeekBalancePayload,
 	GitHubCopilotUsagePayload,
 	KimiCodingUsagePayload,
 	OpenCodeZenPayload,
@@ -28,6 +30,7 @@ import type {
 } from "./types.js";
 
 const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
+const DEEPSEEK_BALANCE_URL = "https://api.deepseek.com/user/balance";
 const GITHUB_COPILOT_USAGE_URL = "https://api.github.com/copilot_internal/user";
 const OPENROUTER_KEY_URL = "https://openrouter.ai/api/v1/key";
 const OPENCODE_GO_USAGE_URL = "https://opencode.ai/zen/go/v1/usage";
@@ -65,6 +68,27 @@ export const SUPPORTED_ADAPTERS: readonly UsageProviderAdapter[] = [
 			return normalizeCodexBackendPayload(payload as CodexBackendPayload, 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 as DeepSeekBalancePayload, Date.now());
+		},
+	},
 	{
 		id: "github-copilot",
 		displayName: "GitHub Copilot",
@@ -133,7 +157,6 @@ export const SUPPORTED_ADAPTERS: readonly UsageProviderAdapter[] = [
 		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),
@@ -149,7 +172,6 @@ export const SUPPORTED_ADAPTERS: readonly UsageProviderAdapter[] = [
 		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),
@@ -223,15 +245,14 @@ export const XAI_ADAPTER: UsageProviderAdapter = {
 	},
 };
 
-export function usageAdapters(xaiUsage = true): readonly UsageProviderAdapter[] {
-	return xaiUsage ? [...SUPPORTED_ADAPTERS, XAI_ADAPTER] : SUPPORTED_ADAPTERS;
+export function usageAdapters(): readonly UsageProviderAdapter[] {
+	return [...SUPPORTED_ADAPTERS, XAI_ADAPTER];
 }
 
 export function adapterForProvider(
 	providerId: string | undefined,
-	xaiUsage = true,
 ): UsageProviderAdapter | undefined {
-	return usageAdapters(xaiUsage).find((adapter) => adapter.id === providerId);
+	return usageAdapters().find((adapter) => adapter.id === providerId);
 }
 
 export function isStaleExtensionContextError(error: unknown): boolean {
@@ -261,11 +282,14 @@ export async function resolveUsageAuth(
 	// SAFETY: Pi exposes the required auth methods at runtime, and checks below narrow them before use.
 	const registry = ctx.modelRegistry as unknown as UsageAuthRegistry;
 	let modelAuth: RequestAuth | undefined;
-	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 : undefined;
+	const resolveCurrentModelAuth = async (): Promise<RequestAuth | undefined> => {
+		if (!currentModel || typeof registry.getApiKeyAndHeaders !== "function") return undefined;
+		const result = await registry.getApiKeyAndHeaders(currentModel);
 		if (!result.ok) throw new Error(redactUsageError(result.error));
-		if (authorizationFrom(result)) modelAuth = result;
-	}
+		return authorizationFrom(result) ? result : undefined;
+	};
+	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.");
 	}
@@ -278,6 +302,9 @@ export async function resolveUsageAuth(
 			`${adapter.displayName} usage cannot send a proxy-resolved credential to the official usage endpoint.`,
 		);
 	}
+	// DeepSeek reads selected-model auth last so a rotation during provider-origin validation
+	// cannot leave the earlier credential queued for the balance request.
+	if (adapter.id === "deepseek") modelAuth = await resolveCurrentModelAuth();
 	const auth = modelAuth ?? providerResult?.auth;
 	if (!auth) return undefined;
 	if (adapter.id === "github-copilot") {
@@ -302,6 +329,26 @@ export async function resolveUsageAuth(
 		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 authorization = `Bearer ${access}`;
+		const headers = { Authorization: authorization };
+		return {
+			apiKey: access,
+			headers,
+			fingerprint: fingerprintResolvedAuth({ headers }, salt),
+			secrets: [
+				access,
+				auth.apiKey,
+				headerValue(auth.headers, "Authorization"),
+				resolvedAuthorization,
+				authorization,
+			].filter((value): value is string => Boolean(value)),
+			model,
+		};
+	}
 	const authorization = authorizationFrom(auth);
 	if (!authorization) return undefined;
 	const headers = { Authorization: authorization };
@@ -685,6 +732,7 @@ function hasOfficialUrlOrigin(value: string, providerId: string): boolean {
 	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";

package/src/settings.ts

@@ -9,12 +9,12 @@ export const MAX_USAGE_SETTINGS_BYTES = 64 * 1024;
 
 export interface UsageSettings {
 	codexFastMode: boolean;
-	xaiUsage: boolean;
+	codexStatusResetCountdown: boolean;
 }
 
 export const DEFAULT_USAGE_SETTINGS: Readonly<UsageSettings> = Object.freeze({
 	codexFastMode: false,
-	xaiUsage: true,
+	codexStatusResetCountdown: true,
 });
 
 export interface UsageSettingsState {
@@ -54,7 +54,10 @@ export function normalizeUsageSettings(value: unknown): UsageSettings | undefine
 	if (Object.hasOwn(value, "codexFastMode") && typeof value.codexFastMode !== "boolean") {
 		return undefined;
 	}
-	if (Object.hasOwn(value, "xaiUsage") && typeof value.xaiUsage !== "boolean") {
+	if (
+		Object.hasOwn(value, "codexStatusResetCountdown") &&
+		typeof value.codexStatusResetCountdown !== "boolean"
+	) {
 		return undefined;
 	}
 	return {
@@ -62,8 +65,10 @@ export function normalizeUsageSettings(value: unknown): UsageSettings | undefine
 			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,
 	};
 }
 

package/src/types.ts

@@ -84,6 +84,11 @@ export type ProviderUsageState =
 			message: string;
 	  };
 
+export type DeepSeekBalancePayload = {
+	is_available?: unknown;
+	balance_infos?: unknown;
+};
+
 export type GitHubCopilotUsagePayload = {
 	login?: unknown;
 	copilot_plan?: unknown;

package/src/usage-helpers.ts

@@ -3,8 +3,8 @@ import { sanitizeDisplayText } from "./core.js";
 import { providerIsConfigured, usageAdapters } from "./query.js";
 import type { PiModel, UsageProviderAdapter } from "./types.js";
 
-export function configuredAdapters(ctx: ExtensionContext, xaiUsage = true): UsageProviderAdapter[] {
-	return usageAdapters(xaiUsage).filter(
+export function configuredAdapters(ctx: ExtensionContext): UsageProviderAdapter[] {
+	return usageAdapters().filter(
 		(adapter) => adapter.id === ctx.model?.provider || providerIsConfigured(ctx, adapter.id),
 	);
 }

package/src/usage-settings-ui.ts

@@ -23,7 +23,7 @@ export async function showUsageSettings(
 	settingsRuntime: UsageSettingsRuntime,
 	parentSignal: AbortSignal,
 	isCurrent: () => boolean,
-	onApplied: (id: UsageSettingId, previous: boolean, next: boolean) => void,
+	onApplied: (id: UsageSettingId) => void,
 ): Promise<boolean> {
 	if (ctx.mode !== "tui") {
 		if (ctx.hasUI) ctx.ui.notify(`Edit settings manually: ${settingsRuntime.get().path}`, "info");
@@ -47,10 +47,10 @@ export async function showUsageSettings(
 				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],
 			},
 		];
@@ -75,8 +75,7 @@ export async function showUsageSettings(
 				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();
@@ -87,17 +86,17 @@ export async function showUsageSettings(
 						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();
 				});
 			},
@@ -123,6 +122,6 @@ export async function showUsageSettings(
 	});
 }
 
-function displayValue(_id: UsageSettingId, enabled: boolean): string {
+function displayValue(enabled: boolean): string {
 	return enabled ? ON : OFF;
 }