@lyogvce/dsh-codex-subscription 0.2.13 → 0.3.1

package/README.md

@@ -21,8 +21,9 @@
    - 通过 `retryPolicy` 暴露 DSH 原生 `RetryPolicySchema`（支持 `normal` / `always` 模式、`maxRetries`、`retryableCodes` 与 `backoff`，并随 `registration.replace` 热更新生效）。未配置时保持宿主默认策略（`mode: "normal"`、`maxRetries: 5`、默认 5 类错误码 `EMPTY_RESPONSE / RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT` 及 `500ms..10000ms` 退避）。**注意：`retryableCodes` 为完整覆盖集合而非追加列表**，显式配置时需同时列出默认错误码与新增错误码。
 4. **原生多轮思考链回放、工具调用与出站指纹净化**
    - 底层复用 DSH 内置的 `PiAiAdapter` 与 `@earendil-works/pi-ai` 的 `openaiCodexProvider()`，固定使用 `sse` 传输（含 `zstd` 请求体压缩、规范化 36 位 RFC 4122 UUID `session-id` 缓存头与 `prompt_cache_key`、`reasoning.encrypted_content` 签名回放与图片自动缩放卸载），并通过自定义 `fetch` 与 `onPayload` 剥除 `OpenAI-Beta: responses=experimental`、静态 `x-client-request-id`、`msg_pi_*` 等非官方指纹。
-5. **Codex 订阅限额内联展示与 ⚡ Fast 极速模式一键切换（`conversation.input.right`）**
-   - 当会话选中 `openai-codex` 模型时，在输入框右下角紧邻模型选择器左侧展示限额胶囊（根据 `wham/usage` 返回的 `limit_window_seconds` 自适应展示 Plus 的 `5h X% · 7d Y%` 双窗口或 Pro 的 `7d X%` 单窗口，内置 60 秒缓存、单飞合并与每轮回复结束自动刷新），点击可展开查看对应窗口进度条、重置倒计时与手动刷新按钮；切换至其他 Provider 模型时自动隐藏。
+5. **Codex 订阅限额、限额重置卡（Rate Limit Reset Credits）与 ⚡ Fast 极速模式一键切换（`conversation.input.right`）**
+   - 当会话选中 `openai-codex` 模型时，在输入框右下角紧邻模型选择器左侧展示限额胶囊（根据 `wham/usage` 返回的 `limit_window_seconds` 自适应展示 Plus 的 `5h X% · 7d Y%` 双窗口或 Pro 的 `7d X%` 单窗口；由模型请求与流完成结算触发、按 60 秒限流在后台自动更新缓存，并由前端周期静默同步，无请求时零远端轮询，点击胶囊直接展开详情弹窗不触发额外请求），弹窗内可查看窗口进度条、重置倒计时与手动刷新按钮；切换至其他 Provider 模型时自动隐藏。
+   - **🎫 限额重置卡展示与二次确认核销**：自动解析 `wham/usage` 中的 `rate_limit_reset_credits`，并在持有可用重置卡（`available_count > 0`）时按需拉取 `wham/rate-limit-reset-credits` 详情，在弹窗内展示每张重置卡各自的过期时间，支持带内联二次确认的核销操作（`POST /wham/rate-limit-reset-credits/consume`）并在核销后自动刷新最新额度。
    - **⚡ 会话树级 Fast 极速模式（`service_tier: "priority"`，最高 2x 推理速度，主会话与 Subagent / 智能体团队同开同关）**：每个主会话可在限额弹窗底部独立开关 Fast 模式（不同主会话互不影响，新会话默认继承插件设置中的 `fastMode`，未配置时默认 `false` 关闭），该主会话派生的所有 `subagent`、`subagent_fork`、`workflow` 子任务以及智能体团队成员（`spawn_teammate`）均自动绑定至同一主会话开关，实时联动、同开同关；状态自动持久化至 `~/.codex/cache/dsh-codex-subscription/runtime-state.json`。开启后胶囊显示闪电标识 `⚡`，并在请求体中自动注入 `"service_tier": "priority"`。
 
 ---

package/lib/client.js

@@ -47,6 +47,20 @@ window.__ModuleLoader__.load({
 		function clampPercent(value) {
 			return Math.max(0, Math.min(100, Math.round(value)));
 		}
+		function normalizeConsumeOutcome(raw) {
+			if (typeof raw !== "string") return null;
+			switch (raw.trim()) {
+				case "reset":
+				case "nothing_to_reset":
+				case "no_credit":
+				case "already_redeemed": return raw.trim();
+				default: return null;
+			}
+		}
+		function generateRedeemRequestId(nowMs) {
+			const rand = Math.random().toString(16).slice(2, 14).padEnd(12, "0");
+			return `redeem-${nowMs.toString(16)}-${rand}`;
+		}
 		//#endregion
 		//#region src/client/quota.ts
 		const RING_CIRCUMFERENCE = 2 * Math.PI * 5.5;
@@ -168,15 +182,46 @@ window.__ModuleLoader__.load({
 			const remHours = totalHours % 24;
 			return fmt.days(days, remHours);
 		}
+		const CREDIT_EXPIRY_FORMATTERS = {
+			zh: {
+				never: () => "永久有效",
+				expired: () => "已过期",
+				minutes: (m, dateStr) => `${m} 分钟后过期 (${dateStr})`,
+				hours: (h, dateStr) => `${h} 小时后过期 (${dateStr})`,
+				days: (d, dateStr) => `${d} 天后过期 (${dateStr})`
+			},
+			en: {
+				never: () => "Never expires",
+				expired: () => "Expired",
+				minutes: (m, dateStr) => `Expires in ${m}m (${dateStr})`,
+				hours: (h, dateStr) => `Expires in ${h}h (${dateStr})`,
+				days: (d, dateStr) => `Expires in ${d}d (${dateStr})`
+			}
+		};
+		function formatResetCreditExpiry(expiresAtSec, nowMs, locale) {
+			const fmt = CREDIT_EXPIRY_FORMATTERS[locale];
+			if (expiresAtSec === null || expiresAtSec === void 0) return fmt.never();
+			if (typeof expiresAtSec !== "number" || !Number.isFinite(expiresAtSec) || expiresAtSec <= 0) return "";
+			const diffSec = Math.round(expiresAtSec - nowMs / 1e3);
+			if (diffSec <= 0) return fmt.expired();
+			const expDate = new Date(expiresAtSec * 1e3);
+			const dateStr = `${padTwo(expDate.getMonth() + 1)}-${padTwo(expDate.getDate())}`;
+			if (diffSec < 3600) return fmt.minutes(Math.max(1, Math.ceil(diffSec / 60)), dateStr);
+			if (diffSec < 86400) return fmt.hours(Math.max(1, Math.ceil(diffSec / 3600)), dateStr);
+			return fmt.days(Math.max(1, Math.ceil(diffSec / 86400)), dateStr);
+		}
 		function createQuotaStore(options = {}) {
-			const fetchFn = options.fetchImpl ?? globalThis.fetch;
+			const getFetch = () => options.fetchImpl ?? globalThis.fetch;
 			const nowFn = options.now ?? Date.now;
-			const ttlMs = options.ttlMs ?? 6e4;
+			const explicitTtlMs = options.ttlMs;
 			let state = {
 				quota: null,
 				defaultFastMode: false,
 				sessionFastModes: {},
 				sessionParents: {},
+				redeeming: false,
+				redeemingCreditId: null,
+				redeemNoticeOutcome: null,
 				loading: false,
 				error: null
 			};
@@ -186,9 +231,11 @@ window.__ModuleLoader__.load({
 			const pendingBySeq = new Map();
 			let inflight = null;
 			let inflightForce = false;
+			let redeemingInflight = null;
 			let requestSeq = 0;
 			let fastModeSeq = 0;
 			let fastMutationEpoch = 0;
+			let redeemSeq = 0;
 			const listeners = new Set();
 			function setState(next) {
 				state = next;
@@ -272,22 +319,27 @@ window.__ModuleLoader__.load({
 					sessionParents: knownSessionParents
 				};
 			}
+			function extractPayloadError(payload, fallback) {
+				return typeof payload?.error === "string" && payload.error !== "" ? payload.error : fallback;
+			}
 			async function refresh(force = false) {
-				if (!force && state.quota !== null && nowFn() - state.quota.fetchedAt < ttlMs) return;
+				if (!force && explicitTtlMs !== void 0 && state.quota !== null && nowFn() - state.quota.fetchedAt < explicitTtlMs) return;
 				if (inflight !== null && (!force || inflightForce)) return inflight;
 				const seq = ++requestSeq;
 				const canReplaceFastAtStart = pendingBySeq.size === 0;
 				const fastEpochAtStart = fastMutationEpoch;
 				inflightForce = force;
-				setState({
+				const showLoading = force || state.quota === null;
+				if (showLoading || state.error !== null || state.redeemNoticeOutcome !== null) setState({
 					...state,
-					loading: true,
+					loading: showLoading ? true : state.loading,
+					redeemNoticeOutcome: null,
 					error: null
 				});
 				const url = force ? `${USAGE_ROUTE_PATH}?force=1` : USAGE_ROUTE_PATH;
 				const task = (async () => {
 					try {
-						const response = await fetchFn(url, {
+						const response = await getFetch()(url, {
 							method: "GET",
 							headers: { Accept: "application/json" }
 						});
@@ -296,6 +348,7 @@ window.__ModuleLoader__.load({
 							setState({
 								...state,
 								loading: false,
+								redeemNoticeOutcome: null,
 								error: `HTTP ${response.status}`
 							});
 							return;
@@ -304,18 +357,22 @@ window.__ModuleLoader__.load({
 						if (seq !== requestSeq) return;
 						const fastState = mergeFastStateFromPayload(payload, canReplaceFastAtStart && pendingBySeq.size === 0 && fastEpochAtStart === fastMutationEpoch);
 						if (payload && payload.ok === true && payload.quota) setState({
+							...state,
 							quota: payload.quota,
 							...fastState,
 							loading: false,
+							redeemNoticeOutcome: null,
 							error: null
 						});
 						else {
 							const fallbackQuota = payload && !payload.ok && payload.quota ? payload.quota : state.quota;
-							const errMsg = payload && !payload.ok && typeof payload.error === "string" ? payload.error : "Invalid response";
+							const errMsg = extractPayloadError(payload && !payload.ok ? payload : null, "Invalid response");
 							setState({
+								...state,
 								quota: fallbackQuota ?? null,
 								...fastState,
 								loading: false,
+								redeemNoticeOutcome: null,
 								error: errMsg
 							});
 						}
@@ -324,6 +381,7 @@ window.__ModuleLoader__.load({
 						setState({
 							...state,
 							loading: false,
+							redeemNoticeOutcome: null,
 							error: safeErrorMessage(error)
 						});
 					} finally {
@@ -361,6 +419,7 @@ window.__ModuleLoader__.load({
 						...state,
 						sessionFastModes: deriveSessionFastModes(),
 						sessionParents: knownSessionParents,
+						redeemNoticeOutcome: null,
 						error: errorMsg
 					});
 				};
@@ -368,10 +427,11 @@ window.__ModuleLoader__.load({
 					...state,
 					sessionFastModes: deriveSessionFastModes(),
 					sessionParents: knownSessionParents,
+					redeemNoticeOutcome: null,
 					error: null
 				});
 				try {
-					const response = await fetchFn(USAGE_ROUTE_PATH, {
+					const response = await getFetch()(USAGE_ROUTE_PATH, {
 						method: "POST",
 						headers: {
 							"Content-Type": "application/json",
@@ -385,7 +445,7 @@ window.__ModuleLoader__.load({
 					if (!response.ok) {
 						const errPayload = await response.json().catch(() => null);
 						mergeServerSessionParents(errPayload?.sessionParents);
-						rollback(typeof errPayload?.error === "string" && errPayload.error !== "" ? errPayload.error : `HTTP ${response.status}`);
+						rollback(extractPayloadError(errPayload, `HTTP ${response.status}`));
 						return;
 					}
 					const payload = await response.json();
@@ -395,7 +455,7 @@ window.__ModuleLoader__.load({
 						return;
 					}
 					if (!payload || payload.ok === false) {
-						rollback(typeof payload?.error === "string" && payload.error !== "" ? payload.error : "Invalid response");
+						rollback(extractPayloadError(payload, "Invalid response"));
 						return;
 					}
 					fastMutationEpoch += 1;
@@ -421,6 +481,7 @@ window.__ModuleLoader__.load({
 						defaultFastMode,
 						sessionFastModes: deriveSessionFastModes(),
 						sessionParents: knownSessionParents,
+						redeemNoticeOutcome: null,
 						error: null
 					});
 				} catch (error) {
@@ -429,6 +490,99 @@ window.__ModuleLoader__.load({
 					pendingBySeq.delete(seq);
 				}
 			}
+			async function consumeResetCredit(creditId) {
+				if (redeemingInflight !== null) return redeemingInflight;
+				const normalizedId = typeof creditId === "string" && creditId.trim() !== "" ? creditId.trim() : null;
+				redeemSeq += 1;
+				const redeemRequestId = generateRedeemRequestId(nowFn() + redeemSeq);
+				setState({
+					...state,
+					redeeming: true,
+					redeemingCreditId: normalizedId,
+					redeemNoticeOutcome: null,
+					error: null
+				});
+				const task = (async () => {
+					try {
+						const response = await getFetch()(USAGE_ROUTE_PATH, {
+							method: "POST",
+							headers: {
+								"Content-Type": "application/json",
+								Accept: "application/json"
+							},
+							body: JSON.stringify({
+								action: "consumeResetCredit",
+								...normalizedId !== null ? { creditId: normalizedId } : {},
+								redeemRequestId
+							})
+						});
+						if (!response.ok) {
+							const errMsg = extractPayloadError(await response.json().catch(() => null), `HTTP ${response.status}`);
+							setState({
+								...state,
+								redeeming: false,
+								redeemingCreditId: null,
+								redeemNoticeOutcome: null,
+								error: errMsg
+							});
+							return {
+								ok: false,
+								error: errMsg
+							};
+						}
+						const payload = await response.json();
+						const fastState = mergeFastStateFromPayload(payload, pendingBySeq.size === 0);
+						if (!payload || payload.ok !== true) {
+							const errMsg = extractPayloadError(payload, "Invalid response");
+							setState({
+								...state,
+								quota: payload?.quota ?? state.quota,
+								...fastState,
+								redeeming: false,
+								redeemingCreditId: null,
+								redeemNoticeOutcome: null,
+								error: errMsg
+							});
+							return {
+								ok: false,
+								error: errMsg
+							};
+						}
+						const outcome = normalizeConsumeOutcome(payload.outcome) ?? "reset";
+						setState({
+							...state,
+							quota: payload.quota ?? state.quota,
+							...fastState,
+							redeeming: false,
+							redeemingCreditId: null,
+							redeemNoticeOutcome: outcome === "reset" ? null : outcome,
+							error: null
+						});
+						return {
+							ok: true,
+							outcome,
+							...payload.quota !== void 0 ? { quota: payload.quota } : {}
+						};
+					} catch (error) {
+						const errMsg = safeErrorMessage(error);
+						setState({
+							...state,
+							redeeming: false,
+							redeemingCreditId: null,
+							redeemNoticeOutcome: null,
+							error: errMsg
+						});
+						return {
+							ok: false,
+							error: errMsg
+						};
+					} finally {
+						redeemingInflight = null;
+					}
+				})();
+				redeemingInflight = task;
+				return task;
+			}
 			return {
 				getSnapshot: () => state,
 				subscribe(listener) {
@@ -438,7 +592,8 @@ window.__ModuleLoader__.load({
 					};
 				},
 				refresh,
-				setFastMode
+				setFastMode,
+				consumeResetCredit
 			};
 		}
 		//#endregion
@@ -480,6 +635,26 @@ window.__ModuleLoader__.load({
 			".dsh-codex-fast-switch[data-checked=\"true\"]{background:var(--dsw-alias-brand-primary,#3b82f6)}",
 			".dsh-codex-fast-switch-thumb{position:absolute;top:2px;left:2px;width:14px;height:14px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,0.2);transition:transform .15s ease}",
 			".dsh-codex-fast-switch[data-checked=\"true\"] .dsh-codex-fast-switch-thumb{transform:translateX(14px)}",
+			".dsh-codex-reset-section{margin-top:8px;padding-top:8px;border-top:1px solid var(--dsw-alias-border-l1)}",
+			".dsh-codex-reset-row{display:flex;align-items:center;justify-content:space-between;gap:10px}",
+			".dsh-codex-reset-icon{color:var(--dsw-alias-brand-primary,#3b82f6);flex:none}",
+			".dsh-codex-reset-pill{display:inline-flex;align-items:center;gap:4px;padding:2px 8px;border-radius:999px;border:none;font-family:inherit;font-size:11px;font-weight:600;background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-brand-primary);white-space:nowrap;font-variant-numeric:tabular-nums;cursor:pointer;flex:none;transition:background-color .12s,color .12s}",
+			".dsh-codex-reset-pill[data-zero=\"true\"]{color:var(--dsw-alias-label-tertiary);font-weight:500;cursor:default}",
+			".dsh-codex-reset-list{margin-top:6px;display:flex;flex-direction:column;gap:5px}",
+			".dsh-codex-reset-card{padding:6px 8px;border-radius:6px;background:var(--dsw-alias-interactive-bg-hover);border:1px dashed var(--dsw-alias-border-l2);display:flex;flex-direction:column;gap:5px}",
+			".dsh-codex-reset-item{display:flex;align-items:center;justify-content:space-between;gap:8px}",
+			".dsh-codex-reset-item-info{display:flex;flex-direction:column;gap:1px;min-width:0}",
+			".dsh-codex-reset-item-title{font-size:11.5px;font-weight:500;color:var(--dsw-alias-label-primary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+			".dsh-codex-reset-item-expiry{font-size:10.5px;line-height:14px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums}",
+			".dsh-codex-reset-use-btn{border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-brand-primary);font-family:inherit;font-size:11px;font-weight:600;padding:2px 8px;border-radius:5px;cursor:pointer;white-space:nowrap;flex:none;transition:background-color .12s,color .12s,border-color .12s}",
+			".dsh-codex-reset-use-btn:hover:not(:disabled){background:var(--dsw-alias-brand-primary,#3b82f6);border-color:var(--dsw-alias-brand-primary,#3b82f6);color:#fff}",
+			".dsh-codex-reset-use-btn:disabled{opacity:0.45;cursor:default;color:var(--dsw-alias-label-tertiary)}",
+			".dsh-codex-reset-confirm{padding-top:5px;border-top:1px dashed var(--dsw-alias-border-l1);display:flex;align-items:center;justify-content:space-between;gap:6px}",
+			".dsh-codex-reset-confirm-text{font-size:11px;line-height:14px;color:var(--dsw-alias-state-warn-primary)}",
+			".dsh-codex-reset-confirm-actions{display:inline-flex;align-items:center;gap:4px;flex:none}",
+			".dsh-codex-reset-confirm-cancel,.dsh-codex-reset-confirm-submit{border:none;font-family:inherit;font-size:11px;font-weight:600;padding:2px 7px;border-radius:4px;cursor:pointer;white-space:nowrap}",
+			".dsh-codex-reset-confirm-cancel{background:transparent;color:var(--dsw-alias-label-secondary)}",
+			".dsh-codex-reset-confirm-submit{background:var(--dsw-alias-state-warn-primary,#f59e0b);color:#111}",
 			".dsh-codex-quota-error{margin-top:6px;padding:4px 6px;border-radius:4px;background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-state-error-primary);font-size:11px;word-break:break-word}"
 		].join("");
 		//#endregion
@@ -489,6 +664,8 @@ window.__ModuleLoader__.load({
 		const NS = "codex-subscription";
 		const SLOT_NAME = "conversation.input.right";
 		const SLOT_ENTRY_ID = "codex-subscription:quota";
+		const ACTIVE_QUOTA_SYNC_INTERVAL_MS = 5e3;
+		const IDLE_QUOTA_SYNC_INTERVAL_MS = 15e3;
 		const zh = {
 			"quota.title": "Codex 订阅限额",
 			"quota.loading": "正在获取 Codex 限额…",
@@ -497,7 +674,22 @@ window.__ModuleLoader__.load({
 			"quota.usedPrefix": "已用 ",
 			"quota.remainPrefix": "剩余 ",
 			"quota.fastTitle": "Fast 极速模式",
-			"quota.fastDesc": "2x 推理速度，消耗更多限额"
+			"quota.fastDesc": "2x 推理速度，消耗更多限额",
+			"quota.resetTitle": "限额重置卡",
+			"quota.resetZero": "0 张可用",
+			"quota.resetZeroDesc": "暂无可用重置卡",
+			"quota.resetAvailableSuffix": " 张可用",
+			"quota.resetNextExpiryPrefix": "下次到期：",
+			"quota.resetReadyDesc": "可重置当前周期已用限额",
+			"quota.resetItemDefaultTitle": "重置卡",
+			"quota.resetUseBtn": "使用",
+			"quota.resetUsingBtn": "核销中…",
+			"quota.resetConfirmPrompt": "确认使用此卡重置当前已用限额？",
+			"quota.resetConfirmYes": "确认使用",
+			"quota.resetConfirmNo": "取消",
+			"quota.resetNothingToReset": "当前无需重置限额",
+			"quota.resetNoCredit": "没有可用的重置卡",
+			"quota.resetAlreadyRedeemed": "该重置卡已被使用"
 		};
 		const en = {
 			"quota.title": "Codex Subscription Quota",
@@ -507,7 +699,22 @@ window.__ModuleLoader__.load({
 			"quota.usedPrefix": "Used ",
 			"quota.remainPrefix": "Remaining ",
 			"quota.fastTitle": "Fast Mode",
-			"quota.fastDesc": "2x speed, increased usage"
+			"quota.fastDesc": "2x speed, increased usage",
+			"quota.resetTitle": "Reset Credits",
+			"quota.resetZero": "0 available",
+			"quota.resetZeroDesc": "No reset credits available",
+			"quota.resetAvailableSuffix": " available",
+			"quota.resetNextExpiryPrefix": "Next expiry: ",
+			"quota.resetReadyDesc": "Reset current window usage",
+			"quota.resetItemDefaultTitle": "Reset Credit",
+			"quota.resetUseBtn": "Use",
+			"quota.resetUsingBtn": "Using…",
+			"quota.resetConfirmPrompt": "Use this credit to reset current usage?",
+			"quota.resetConfirmYes": "Confirm",
+			"quota.resetConfirmNo": "Cancel",
+			"quota.resetNothingToReset": "Your usage does not need a reset right now",
+			"quota.resetNoCredit": "No reset credits available",
+			"quota.resetAlreadyRedeemed": "This reset credit was already redeemed"
 		};
 		const EMPTY_MODEL_STORE = {
 			getSnapshot: () => null,
@@ -525,6 +732,25 @@ window.__ModuleLoader__.load({
 				fill: "currentColor"
 			}));
 		}
+		function renderTicketIcon(size) {
+			return h("svg", {
+				className: "dsh-codex-reset-icon",
+				viewBox: "0 0 16 16",
+				width: size,
+				height: size,
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1.5,
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": true
+			}, h("path", { d: "M2 5a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v1.6a1.4 1.4 0 0 0 0 2.8V11a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V9.4a1.4 1.4 0 0 0 0-2.8V5z" }), h("path", { d: "M6.5 4v8" }));
+		}
+		const REDEEM_OUTCOME_LOCALE_KEYS = {
+			nothing_to_reset: "quota.resetNothingToReset",
+			no_credit: "quota.resetNoCredit",
+			already_redeemed: "quota.resetAlreadyRedeemed"
+		};
 		function CodexQuotaPill(props) {
 			const { sessionId, quotaStore, getModelStore, useProjection, useSession, t, getLocale } = props;
 			const modelStore = getModelStore(sessionId);
@@ -536,6 +762,8 @@ window.__ModuleLoader__.load({
 			const isCodex = isCodexProvider(resolveActiveProvider(directorySnap, projectedSelection));
 			const quotaSnap = React.useSyncExternalStore(quotaStore.subscribe, quotaStore.getSnapshot);
 			const [open, setOpen] = React.useState(false);
+			const [detailsOpen, setDetailsOpen] = React.useState(true);
+			const [confirmingCreditKey, setConfirmingCreditKey] = React.useState(null);
 			const rootRef = React.useRef(null);
 			const prevRunningRef = React.useRef(running);
 			const prevSessionIdRef = React.useRef(sessionId);
@@ -547,8 +775,8 @@ window.__ModuleLoader__.load({
 					prevRunningRef.current = running;
 					return;
 				}
-				quotaStore.refresh(false);
 				if (sameSession && didTurnFinish(prevRunningRef.current, running)) quotaStore.refresh(true);
+				else if (!sameSession || !running || quotaStore.getSnapshot().quota === null) quotaStore.refresh(false);
 				prevRunningRef.current = running;
 			}, [
 				isCodex,
@@ -556,6 +784,20 @@ window.__ModuleLoader__.load({
 				sessionId,
 				quotaStore
 			]);
+			React.useEffect(() => {
+				if (!isCodex || typeof globalThis.setInterval !== "function") return;
+				const intervalMs = running ? ACTIVE_QUOTA_SYNC_INTERVAL_MS : IDLE_QUOTA_SYNC_INTERVAL_MS;
+				const timer = globalThis.setInterval(() => {
+					quotaStore.refresh(false);
+				}, intervalMs);
+				return () => {
+					globalThis.clearInterval(timer);
+				};
+			}, [
+				isCodex,
+				running,
+				quotaStore
+			]);
 			React.useEffect(() => {
 				if (!open || !isCodex || typeof globalThis.document === "undefined") return;
 				const onPointerDown = (event) => {
@@ -595,6 +837,71 @@ window.__ModuleLoader__.load({
 			const isFastMode = resolveSessionFastMode(quotaSnap, sessionId, parentSessionId);
 			const secondaryReached = Boolean(quota?.secondary && quota.secondary.usedPercent >= 100);
 			const primaryReached = Boolean(quota?.limitReached && !secondaryReached);
+			const resetCredits = quota?.resetCredits;
+			const availableResetCount = resetCredits?.availableCount ?? 0;
+			const applicableResetCount = resetCredits?.applicableAvailableCount ?? availableResetCount;
+			const nowSec = Math.floor(nowMs / 1e3);
+			const displayCredits = availableResetCount > 0 ? resetCredits?.credits && resetCredits.credits.length > 0 ? resetCredits.credits.map((item) => ({
+				id: item.id,
+				slotKey: item.id,
+				title: item.title,
+				expiresAt: item.expiresAt
+			})) : Array.from({ length: availableResetCount }, (_unused, idx) => ({
+				id: null,
+				slotKey: `placeholder-${idx}`,
+				title: null,
+				expiresAt: null
+			})) : [];
+			const renderResetCreditsSection = () => {
+				const firstCard = displayCredits[0];
+				const subDesc = availableResetCount === 0 ? t("quota.resetZeroDesc") : firstCard !== void 0 && firstCard.expiresAt !== null ? `${t("quota.resetNextExpiryPrefix")}${formatResetCreditExpiry(firstCard.expiresAt, nowMs, locale)}` : t("quota.resetReadyDesc");
+				return h("div", { className: "dsh-codex-reset-section" }, h("div", { className: "dsh-codex-reset-row" }, h("div", { className: "dsh-codex-fast-info" }, h("div", { className: "dsh-codex-fast-title" }, renderTicketIcon(12), h("span", null, t("quota.resetTitle"))), h("div", { className: "dsh-codex-fast-desc" }, subDesc)), availableResetCount === 0 ? h("span", {
+					className: "dsh-codex-reset-pill",
+					"data-zero": "true"
+				}, t("quota.resetZero")) : h("button", {
+					type: "button",
+					className: "dsh-codex-reset-pill",
+					"data-zero": "false",
+					"aria-expanded": detailsOpen,
+					onClick: () => {
+						setDetailsOpen(!detailsOpen);
+						setConfirmingCreditKey(null);
+					}
+				}, `${availableResetCount}${t("quota.resetAvailableSuffix")} ${detailsOpen ? "▴" : "▾"}`)), availableResetCount > 0 && detailsOpen ? h("div", { className: "dsh-codex-reset-list" }, ...displayCredits.map((item, idx) => {
+					const itemKey = item.slotKey;
+					const itemTitle = item.title ?? `${t("quota.resetItemDefaultTitle")} #${idx + 1}`;
+					const itemExpiry = formatResetCreditExpiry(item.expiresAt, nowMs, locale);
+					const isItemExpired = item.expiresAt !== null && item.expiresAt <= nowSec;
+					const isRedeemingAny = quotaSnap.redeeming === true;
+					const isRedeemingThis = isRedeemingAny && (item.id !== null ? quotaSnap.redeemingCreditId === item.id : quotaSnap.redeemingCreditId === null);
+					const isConfirming = confirmingCreditKey === itemKey;
+					return h("div", {
+						key: itemKey,
+						className: "dsh-codex-reset-card"
+					}, h("div", { className: "dsh-codex-reset-item" }, h("div", { className: "dsh-codex-reset-item-info" }, h("div", { className: "dsh-codex-reset-item-title" }, itemTitle), h("div", { className: "dsh-codex-reset-item-expiry" }, itemExpiry)), h("button", {
+						type: "button",
+						className: "dsh-codex-reset-use-btn",
+						disabled: applicableResetCount <= 0 || isRedeemingAny || isItemExpired,
+						onClick: () => {
+							setConfirmingCreditKey(isConfirming ? null : itemKey);
+						}
+					}, isRedeemingThis ? t("quota.resetUsingBtn") : t("quota.resetUseBtn"))), isConfirming ? h("div", { className: "dsh-codex-reset-confirm" }, h("span", { className: "dsh-codex-reset-confirm-text" }, t("quota.resetConfirmPrompt")), h("div", { className: "dsh-codex-reset-confirm-actions" }, h("button", {
+						type: "button",
+						className: "dsh-codex-reset-confirm-cancel",
+						onClick: () => {
+							setConfirmingCreditKey(null);
+						}
+					}, t("quota.resetConfirmNo")), h("button", {
+						type: "button",
+						className: "dsh-codex-reset-confirm-submit",
+						disabled: isRedeemingAny || isItemExpired,
+						onClick: async () => {
+							setConfirmingCreditKey(null);
+							await quotaStore.consumeResetCredit(item.id ?? void 0);
+						}
+					}, t("quota.resetConfirmYes")))) : null);
+				})) : null);
+			};
 			return h("span", {
 				ref: rootRef,
 				className: "dsh-codex-quota-root",
@@ -609,9 +916,8 @@ window.__ModuleLoader__.load({
 				"aria-expanded": open,
 				title: `${t("quota.title")} (${pillText})`,
 				onClick: () => {
-					const nextOpen = !open;
-					setOpen(nextOpen);
-					if (nextOpen) quotaStore.refresh(false);
+					setConfirmingCreditKey(null);
+					setOpen(!open);
 				}
 			}, h("svg", {
 				viewBox: "0 0 14 14",
@@ -644,7 +950,7 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					quotaStore.refresh(true);
 				}
-			}, quotaSnap.loading ? t("quota.refreshing") : t("quota.refresh"))), quota !== null ? renderWindowSection(formatWindowTitle(quota.primary.windowSeconds, locale, DEFAULT_PRIMARY_WINDOW_SECONDS), quota.primary, primaryReached) : quotaSnap.loading || quotaSnap.error === null ? h("div", { className: "dsh-codex-quota-meta" }, t("quota.loading")) : null, quota?.secondary !== null && quota?.secondary !== void 0 ? renderWindowSection(formatWindowTitle(quota.secondary.windowSeconds, locale, DEFAULT_SECONDARY_WINDOW_SECONDS), quota.secondary, secondaryReached) : null, h("div", { className: "dsh-codex-fast-row" }, h("div", { className: "dsh-codex-fast-info" }, h("div", { className: "dsh-codex-fast-title" }, renderFastBolt(12), h("span", null, t("quota.fastTitle"))), h("div", { className: "dsh-codex-fast-desc" }, t("quota.fastDesc"))), h("button", {
+			}, quotaSnap.loading ? t("quota.refreshing") : t("quota.refresh"))), quota !== null ? renderWindowSection(formatWindowTitle(quota.primary.windowSeconds, locale, DEFAULT_PRIMARY_WINDOW_SECONDS), quota.primary, primaryReached) : quotaSnap.loading || quotaSnap.error === null ? h("div", { className: "dsh-codex-quota-meta" }, t("quota.loading")) : null, quota?.secondary !== null && quota?.secondary !== void 0 ? renderWindowSection(formatWindowTitle(quota.secondary.windowSeconds, locale, DEFAULT_SECONDARY_WINDOW_SECONDS), quota.secondary, secondaryReached) : null, quota !== null ? renderResetCreditsSection() : null, h("div", { className: "dsh-codex-fast-row" }, h("div", { className: "dsh-codex-fast-info" }, h("div", { className: "dsh-codex-fast-title" }, renderFastBolt(12), h("span", null, t("quota.fastTitle"))), h("div", { className: "dsh-codex-fast-desc" }, t("quota.fastDesc"))), h("button", {
 				type: "button",
 				role: "switch",
 				className: "dsh-codex-fast-switch",
@@ -654,7 +960,7 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					quotaStore.setFastMode(sessionId, !isFastMode, parentSessionId);
 				}
-			}, h("span", { className: "dsh-codex-fast-switch-thumb" }))), quotaSnap.error !== null ? h("div", { className: "dsh-codex-quota-error" }, quotaSnap.error) : null) : null);
+			}, h("span", { className: "dsh-codex-fast-switch-thumb" }))), quotaSnap.error !== null || quotaSnap.redeemNoticeOutcome != null ? h("div", { className: "dsh-codex-quota-error" }, quotaSnap.error !== null ? quotaSnap.error : t(REDEEM_OUTCOME_LOCALE_KEYS[quotaSnap.redeemNoticeOutcome])) : null) : null);
 		}
 		const inject = ["slots", "locale"];
 		function apply(ctx) {
@@ -713,6 +1019,7 @@ window.__ModuleLoader__.load({
 			formatWindowTitle,
 			formatQuotaSummary,
 			formatResetCountdown,
+			formatResetCreditExpiry,
 			createQuotaStore,
 			CodexQuotaPill
 		});

package/lib/index.d.ts

@@ -132,27 +132,51 @@ interface CodexQuotaWindow {
   readonly windowSeconds?: number | null | undefined;
   readonly resetAt: number | null;
 }
+interface CodexResetCreditItem {
+  readonly id: string;
+  readonly resetType: string;
+  readonly status: string;
+  readonly grantedAt: number | null;
+  readonly expiresAt: number | null;
+  readonly title: string | null;
+  readonly description: string | null;
+}
+interface CodexResetCreditsSnapshot {
+  readonly availableCount: number;
+  readonly applicableAvailableCount: number;
+  readonly credits: readonly CodexResetCreditItem[] | null;
+}
 interface CodexQuotaSnapshot {
   readonly planType: string;
   readonly limitReached: boolean;
   readonly primary: CodexQuotaWindow;
   readonly secondary: CodexQuotaWindow | null;
+  readonly resetCredits?: CodexResetCreditsSnapshot | undefined;
   readonly fetchedAt: number;
 }
-type CodexQuotaResponse = {
-  readonly ok: true;
-  readonly quota: CodexQuotaSnapshot;
+type ConsumeResetCreditOutcome = 'reset' | 'nothing_to_reset' | 'no_credit' | 'already_redeemed';
+interface CodexRouteStateProjection {
   readonly defaultFastMode?: boolean | undefined;
   readonly sessionFastModes?: Readonly<Record<string, boolean>> | undefined;
   readonly sessionParents?: Readonly<Record<string, string>> | undefined;
-} | {
+}
+type CodexConsumeResetCreditResponse = ({
+  readonly ok: true;
+  readonly outcome: ConsumeResetCreditOutcome;
+  readonly quota?: CodexQuotaSnapshot | undefined;
+} & CodexRouteStateProjection) | ({
   readonly ok: false;
   readonly error: string;
   readonly quota?: CodexQuotaSnapshot | undefined;
-  readonly defaultFastMode?: boolean | undefined;
-  readonly sessionFastModes?: Readonly<Record<string, boolean>> | undefined;
-  readonly sessionParents?: Readonly<Record<string, string>> | undefined;
-};
+} & CodexRouteStateProjection);
+type CodexQuotaResponse = ({
+  readonly ok: true;
+  readonly quota: CodexQuotaSnapshot;
+} & CodexRouteStateProjection) | ({
+  readonly ok: false;
+  readonly error: string;
+  readonly quota?: CodexQuotaSnapshot | undefined;
+} & CodexRouteStateProjection);
 interface UsageFetcherOptions {
   readonly resolveCredentials: () => Promise<CodexResolvedCredentials>;
   readonly buildHeaders: (authHeaders: Record<string, string>) => Record<string, string>;
@@ -160,11 +184,22 @@ interface UsageFetcherOptions {
   readonly now?: (() => number) | undefined;
   readonly ttlMs?: number | undefined;
   readonly minForceIntervalMs?: number | undefined;
+  readonly autoRefresh?: boolean | undefined;
 }
+declare function parseResetCreditsPayload(raw: unknown, nowMs?: number | undefined): {
+  readonly availableCount: number;
+  readonly credits: readonly CodexResetCreditItem[];
+} | null;
 declare function parseUsagePayload(raw: unknown, fetchedAt: number): CodexQuotaSnapshot | null;
 declare function createUsageFetcher(options: UsageFetcherOptions): {
   getUsage: (force?: boolean) => Promise<CodexQuotaResponse>;
+  consumeResetCredit: (params?: {
+    readonly creditId?: string | undefined;
+    readonly redeemRequestId?: string | undefined;
+  }) => Promise<CodexConsumeResetCreditResponse>;
+  onRequestStart: () => void;
   invalidate: () => void;
+  dispose: () => void;
 };
 //#endregion
 //#region src/index.d.ts
@@ -199,7 +234,8 @@ export declare const __test: Readonly<{
   normalizeCodexSessionId: typeof normalizeCodexSessionId;
   toCodexWireSessionId: typeof toCodexWireSessionId;
   parseUsagePayload: typeof parseUsagePayload;
+  parseResetCreditsPayload: typeof parseResetCreditsPayload;
   createUsageFetcher: typeof createUsageFetcher;
 }>;
 //#endregion
-export type { CodexModelMetadata, CodexQuotaResponse, CodexQuotaSnapshot, CodexQuotaWindow, CodexResolvedCredentials, ParsedModelsCatalog, PluginContextLike, PluginLogLevel, RawModelsCache };
+export type { CodexConsumeResetCreditResponse, CodexModelMetadata, CodexQuotaResponse, CodexQuotaSnapshot, CodexQuotaWindow, CodexResetCreditItem, CodexResetCreditsSnapshot, CodexResolvedCredentials, ConsumeResetCreditOutcome, ParsedModelsCatalog, PluginContextLike, PluginLogLevel, RawModelsCache };

package/lib/index.js

@@ -361,6 +361,8 @@ function safeErrorMessage(error) {
 	return (error instanceof Error ? error.message : String(error)).replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[redacted]").replace(/\b(Bearer\s+)[^\s,;'"&]+/giu, "$1[redacted]").replace(/(\b(?:code|token|access_token|refresh_token|id_token)=)[^&\s"']+/giu, "$1[redacted]").replace(/("(?:access_token|refresh_token|id_token)"\s*:\s*")[^"]+"/giu, "$1[redacted]\"").slice(0, 1e3);
 }
 const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
+const CODEX_RESET_CREDITS_URL = "https://chatgpt.com/backend-api/wham/rate-limit-reset-credits";
+const CODEX_RESET_CREDITS_CONSUME_URL = "https://chatgpt.com/backend-api/wham/rate-limit-reset-credits/consume";
 const USAGE_ROUTE_PATH = "/api/codex-subscription/usage";
 const DEFAULT_USAGE_TTL_MS = 6e4;
 const USAGE_FETCH_TIMEOUT_MS = 15e3;
@@ -385,6 +387,77 @@ function parseWindow(raw, fetchedAtMs) {
 		resetAt
 	};
 }
+function parseTimestampSeconds(raw) {
+	if (typeof raw === "number" && Number.isFinite(raw) && raw > 0) return Math.round(raw);
+	if (typeof raw === "string") {
+		const trimmed = raw.trim();
+		if (trimmed === "") return null;
+		const parsedMs = Date.parse(trimmed);
+		if (Number.isFinite(parsedMs) && parsedMs > 0) return Math.floor(parsedMs / 1e3);
+	}
+	return null;
+}
+function nonEmptyString(raw) {
+	if (typeof raw !== "string") return null;
+	const trimmed = raw.trim();
+	return trimmed !== "" ? trimmed : null;
+}
+function parseResetCreditsPayload(raw, nowMs) {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const record = raw;
+	const rawList = Array.isArray(record.credits) ? record.credits : null;
+	if (rawList === null) return null;
+	const nowSec = typeof nowMs === "number" && Number.isFinite(nowMs) && nowMs > 0 ? Math.floor(nowMs / 1e3) : null;
+	const credits = [];
+	for (const entry of rawList) {
+		if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+		const item = entry;
+		const id = nonEmptyString(item.id);
+		if (id === null) continue;
+		const statusRaw = (nonEmptyString(item.status) ?? "available").toLowerCase();
+		if (statusRaw !== "available") continue;
+		const expiresAt = parseTimestampSeconds(item.expires_at);
+		if (nowSec !== null && expiresAt !== null && expiresAt <= nowSec) continue;
+		const resetType = nonEmptyString(item.reset_type) ?? "codex_rate_limits";
+		const grantedAt = parseTimestampSeconds(item.granted_at);
+		const title = nonEmptyString(item.title);
+		const description = nonEmptyString(item.description);
+		credits.push({
+			id,
+			resetType,
+			status: statusRaw,
+			grantedAt,
+			expiresAt,
+			title,
+			description
+		});
+	}
+	credits.sort((a, b) => {
+		if (a.expiresAt !== null && b.expiresAt !== null) {
+			if (a.expiresAt !== b.expiresAt) return a.expiresAt - b.expiresAt;
+		} else if (a.expiresAt !== null) return -1;
+		else if (b.expiresAt !== null) return 1;
+		return (a.grantedAt ?? 0) - (b.grantedAt ?? 0);
+	});
+	const availRaw = record.available_count;
+	return {
+		availableCount: rawList.length > 0 ? credits.length : typeof availRaw === "number" && Number.isFinite(availRaw) && availRaw >= 0 ? Math.round(availRaw) : 0,
+		credits
+	};
+}
+function parseUsageResetCreditsSummary(raw) {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+	const record = raw;
+	const availRaw = record.available_count;
+	if (typeof availRaw !== "number" || !Number.isFinite(availRaw) || availRaw < 0) return;
+	const availableCount = Math.round(availRaw);
+	const appRaw = record.applicable_available_count;
+	return {
+		availableCount,
+		applicableAvailableCount: typeof appRaw === "number" && Number.isFinite(appRaw) && appRaw >= 0 ? Math.min(availableCount, Math.round(appRaw)) : availableCount,
+		credits: availableCount === 0 ? [] : null
+	};
+}
 function parseUsagePayload(raw, fetchedAt) {
 	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
 	const record = raw;
@@ -394,53 +467,145 @@ function parseUsagePayload(raw, fetchedAt) {
 	const primary = parseWindow(rateRecord.primary_window, fetchedAt);
 	if (primary === null) return null;
 	const secondary = parseWindow(rateRecord.secondary_window, fetchedAt);
+	const planType = typeof record.plan_type === "string" && record.plan_type.trim() !== "" ? record.plan_type.trim() : "plus";
+	const limitReached = rateRecord.limit_reached === true || rateRecord.allowed === false || primary.usedPercent >= 100 || secondary !== null && secondary.usedPercent >= 100;
+	const resetCredits = parseUsageResetCreditsSummary(record.rate_limit_reset_credits);
 	return {
-		planType: typeof record.plan_type === "string" && record.plan_type.trim() !== "" ? record.plan_type.trim() : "plus",
-		limitReached: rateRecord.limit_reached === true || rateRecord.allowed === false || primary.usedPercent >= 100 || secondary !== null && secondary.usedPercent >= 100,
+		planType,
+		limitReached,
 		primary,
 		secondary,
+		...resetCredits !== void 0 ? { resetCredits } : {},
 		fetchedAt
 	};
 }
+function isWindowResetDue(snapshot, nowMs) {
+	const nowSec = nowMs / 1e3;
+	const fetchedSec = snapshot.fetchedAt / 1e3;
+	const primaryReset = snapshot.primary.resetAt;
+	if (primaryReset !== null && fetchedSec < primaryReset && nowSec >= primaryReset) return true;
+	const secondaryReset = snapshot.secondary?.resetAt ?? null;
+	if (secondaryReset !== null && fetchedSec < secondaryReset && nowSec >= secondaryReset) return true;
+	return false;
+}
+function normalizeConsumeOutcome(raw) {
+	if (typeof raw !== "string") return null;
+	switch (raw.trim()) {
+		case "reset":
+		case "nothing_to_reset":
+		case "no_credit":
+		case "already_redeemed": return raw.trim();
+		default: return null;
+	}
+}
+function generateRedeemRequestId(nowMs) {
+	const rand = Math.random().toString(16).slice(2, 14).padEnd(12, "0");
+	return `redeem-${nowMs.toString(16)}-${rand}`;
+}
 function createUsageFetcher(options) {
-	const fetchFn = options.fetchImpl ?? globalThis.fetch;
+	const getFetch = () => options.fetchImpl ?? globalThis.fetch;
 	const nowFn = options.now ?? Date.now;
 	const ttlMs = options.ttlMs ?? 6e4;
 	const minForceIntervalMs = options.minForceIntervalMs ?? 5e3;
+	const autoRefresh = options.autoRefresh === true;
 	let cached;
-	let stale = false;
+	let lastAttemptAt;
+	let hasConsumer = false;
+	let dirtyRevision = 0;
+	let fetchedRevision = 0;
 	let inflight;
+	let trailingTimer;
+	let disposed = false;
+	const isStale = () => dirtyRevision > fetchedRevision;
+	async function resolveAuthHeaders(extra) {
+		const creds = await options.resolveCredentials();
+		return options.buildHeaders({
+			Authorization: `Bearer ${creds.accessToken}`,
+			Accept: "application/json",
+			...creds.accountId !== void 0 ? { "ChatGPT-Account-Id": creds.accountId } : {},
+			...extra
+		});
+	}
+	function clearTrailingTimer() {
+		if (trailingTimer !== void 0) {
+			clearTimeout(trailingTimer);
+			trailingTimer = void 0;
+		}
+	}
+	function scheduleBackgroundRefresh(deferIfCached = false) {
+		if (!autoRefresh || !hasConsumer || disposed || !isStale() || inflight !== void 0) return;
+		const baseTime = cached?.fetchedAt ?? lastAttemptAt;
+		if (baseTime === void 0) {
+			runSingleFlight();
+			return;
+		}
+		const ageMs = Math.max(0, nowFn() - baseTime);
+		if (!deferIfCached && ageMs >= ttlMs) {
+			runSingleFlight();
+			return;
+		}
+		if (trailingTimer !== void 0) return;
+		const delayMs = deferIfCached ? Math.max(1, ageMs >= ttlMs ? ttlMs : ttlMs - ageMs) : Math.max(1, ttlMs - ageMs);
+		trailingTimer = setTimeout(() => {
+			trailingTimer = void 0;
+			if (disposed || !isStale()) return;
+			runSingleFlight();
+		}, delayMs);
+		trailingTimer.unref?.();
+	}
 	async function fetchFresh() {
+		const revAtStart = dirtyRevision;
 		try {
-			const creds = await options.resolveCredentials();
-			const headers = options.buildHeaders({
-				Authorization: `Bearer ${creds.accessToken}`,
-				Accept: "application/json",
-				...creds.accountId !== void 0 ? { "ChatGPT-Account-Id": creds.accountId } : {}
-			});
+			const fetchFn = getFetch();
+			const headers = await resolveAuthHeaders();
 			const response = await fetchFn(CODEX_USAGE_URL, {
 				method: "GET",
 				headers,
 				signal: AbortSignal.timeout(USAGE_FETCH_TIMEOUT_MS)
 			});
+			const finishedAt = nowFn();
+			lastAttemptAt = finishedAt;
+			fetchedRevision = Math.max(fetchedRevision, revAtStart);
 			if (!response.ok) return {
 				ok: false,
 				error: `Codex 限额查询失败 (HTTP ${response.status})`,
 				...cached !== void 0 ? { quota: cached } : {}
 			};
-			const parsed = parseUsagePayload(await response.json(), nowFn());
+			let parsed = parseUsagePayload(await response.json(), finishedAt);
 			if (parsed === null) return {
 				ok: false,
 				error: "Codex 限额响应格式无法解析",
 				...cached !== void 0 ? { quota: cached } : {}
 			};
+			if (parsed.resetCredits !== void 0 && parsed.resetCredits.availableCount > 0) try {
+				const detailRes = await fetchFn(CODEX_RESET_CREDITS_URL, {
+					method: "GET",
+					headers,
+					signal: AbortSignal.timeout(USAGE_FETCH_TIMEOUT_MS)
+				});
+				if (detailRes.ok) {
+					const detailParsed = parseResetCreditsPayload(await detailRes.json(), finishedAt);
+					if (detailParsed !== null) {
+						const nextAvailable = detailParsed.availableCount;
+						parsed = {
+							...parsed,
+							resetCredits: {
+								availableCount: nextAvailable,
+								applicableAvailableCount: Math.min(nextAvailable, parsed.resetCredits.applicableAvailableCount),
+								credits: detailParsed.credits
+							}
+						};
+					}
+				}
+			} catch {}
 			cached = parsed;
-			stale = false;
 			return {
 				ok: true,
 				quota: parsed
 			};
 		} catch (error) {
+			lastAttemptAt = nowFn();
+			fetchedRevision = Math.max(fetchedRevision, revAtStart);
 			return {
 				ok: false,
 				error: safeErrorMessage(error),
@@ -448,26 +613,98 @@ function createUsageFetcher(options) {
 			};
 		}
 	}
+	function runSingleFlight() {
+		clearTrailingTimer();
+		if (!inflight) inflight = fetchFresh().finally(() => {
+			inflight = void 0;
+			if (autoRefresh && !disposed && isStale()) scheduleBackgroundRefresh();
+		});
+		return inflight;
+	}
 	return {
+		onRequestStart() {
+			dirtyRevision += 1;
+			scheduleBackgroundRefresh(true);
+		},
 		invalidate() {
-			stale = true;
+			dirtyRevision += 1;
+			scheduleBackgroundRefresh(false);
 		},
-		async getUsage(force = false) {
-			if (!stale && cached !== void 0) {
-				const ageMs = nowFn() - cached.fetchedAt;
-				if (!force && ageMs < ttlMs) return {
+		dispose() {
+			disposed = true;
+			clearTrailingTimer();
+		},
+		async consumeResetCredit(params) {
+			const creditId = nonEmptyString(params?.creditId) ?? void 0;
+			const redeemRequestId = nonEmptyString(params?.redeemRequestId) ?? generateRedeemRequestId(nowFn());
+			try {
+				const fetchFn = getFetch();
+				const headers = await resolveAuthHeaders({ "Content-Type": "application/json" });
+				const response = await fetchFn(CODEX_RESET_CREDITS_CONSUME_URL, {
+					method: "POST",
+					headers,
+					body: JSON.stringify({
+						redeem_request_id: redeemRequestId,
+						...creditId !== void 0 ? { credit_id: creditId } : {}
+					}),
+					signal: AbortSignal.timeout(USAGE_FETCH_TIMEOUT_MS)
+				});
+				if (!response.ok) return {
+					ok: false,
+					error: `Codex 重置卡核销失败 (HTTP ${response.status})`,
+					...cached !== void 0 ? { quota: cached } : {}
+				};
+				const outcome = normalizeConsumeOutcome((await response.json())?.outcome);
+				if (outcome === null) return {
+					ok: false,
+					error: "Codex 重置卡核销响应格式无法解析",
+					...cached !== void 0 ? { quota: cached } : {}
+				};
+				dirtyRevision += 1;
+				if (inflight !== void 0) await inflight;
+				const refreshed = isStale() ? await runSingleFlight() : cached !== void 0 ? {
 					ok: true,
 					quota: cached
+				} : await runSingleFlight();
+				const latestQuota = refreshed.ok ? refreshed.quota : cached;
+				return {
+					ok: true,
+					outcome,
+					...latestQuota !== void 0 ? { quota: latestQuota } : {}
 				};
-				if (force && ageMs >= 0 && ageMs < minForceIntervalMs) return {
+			} catch (error) {
+				return {
+					ok: false,
+					error: safeErrorMessage(error),
+					...cached !== void 0 ? { quota: cached } : {}
+				};
+			}
+		},
+		async getUsage(force = false) {
+			hasConsumer = true;
+			if (cached !== void 0) {
+				const nowMs = nowFn();
+				const ageMs = nowMs - cached.fetchedAt;
+				const stale = isStale();
+				const resetDue = isWindowResetDue(cached, nowMs);
+				if (!force) {
+					if (ageMs >= 0 && ageMs < ttlMs && (!stale || autoRefresh)) {
+						if (stale) scheduleBackgroundRefresh(false);
+						return {
+							ok: true,
+							quota: cached
+						};
+					}
+					if (autoRefresh && !stale && !resetDue) return {
+						ok: true,
+						quota: cached
+					};
+				} else if (!stale && ageMs >= 0 && ageMs < minForceIntervalMs) return {
 					ok: true,
 					quota: cached
 				};
 			}
-			if (!inflight) inflight = fetchFresh().finally(() => {
-				inflight = void 0;
-			});
-			return inflight;
+			return runSingleFlight();
 		}
 	};
 }
@@ -1101,7 +1338,7 @@ function apply(ctx, config = {}) {
 	});
 	function wrapOptions(catalog, model, options = {}) {
 		const modelMeta = catalog.metadataById.get(model?.id);
-		const { temperature: _temperature, sessionId, onPayload, ...rest } = options;
+		const { temperature: _temperature, sessionId, onPayload, onProviderStreamEvent, ...rest } = options;
 		const initiatorId = (ctx.get?.("agents"))?.currentInitiator?.()?.id;
 		const normalizedSessionId = normalizeCodexSessionId(sessionId) ?? normalizeCodexSessionId(initiatorId);
 		const wireSessionId = toCodexWireSessionId(normalizedSessionId);
@@ -1117,12 +1354,18 @@ function apply(ctx, config = {}) {
 			}),
 			async onPayload(payload, requestModel) {
 				return sanitizeCodexPayload(await onPayload?.(payload, requestModel) ?? payload, modelMeta, getEffectiveFastMode(normalizedSessionId));
+			},
+			async onProviderStreamEvent(event, eventModel) {
+				await onProviderStreamEvent?.(event, eventModel);
+				const eventType = event !== null && typeof event === "object" ? event.type : void 0;
+				if (eventType === "response.completed" || eventType === "response.done" || eventType === "response.incomplete") usageFetcher.invalidate();
 			}
 		};
 	}
 	const usageFetcher = createUsageFetcher({
 		resolveCredentials: () => authManager.resolveCredentials(),
-		buildHeaders: (authHeaders) => buildCodexHeaders(authHeaders, ensureSnapshot().catalog.clientVersion)
+		buildHeaders: (authHeaders) => buildCodexHeaders(authHeaders, ensureSnapshot().catalog.clientVersion),
+		autoRefresh: true
 	});
 	function createSnapshotPiProvider(snapshotCatalog) {
 		return Object.freeze({
@@ -1135,11 +1378,11 @@ function apply(ctx, config = {}) {
 			}),
 			getModels: () => snapshotCatalog.models,
 			stream: (model, context, options) => {
-				usageFetcher.invalidate();
+				usageFetcher.onRequestStart();
 				return baseProvider.stream(model, context, wrapOptions(snapshotCatalog, model, options));
 			},
 			streamSimple: (model, context, options) => {
-				usageFetcher.invalidate();
+				usageFetcher.onRequestStart();
 				return baseProvider.streamSimple(model, context, wrapOptions(snapshotCatalog, model, options));
 			}
 		});
@@ -1311,6 +1554,7 @@ function apply(ctx, config = {}) {
 		return () => {
 			watcherDisposed = true;
 			closeModelsCacheWatchers();
+			usageFetcher.dispose();
 		};
 	}, "codex-subscription: models_cache watcher");
 	else {
@@ -1318,6 +1562,7 @@ function apply(ctx, config = {}) {
 		ctx.on?.("dispose", () => {
 			watcherDisposed = true;
 			closeModelsCacheWatchers();
+			usageFetcher.dispose();
 		});
 	}
 	const mountUsageRoute = (connCtx) => {
@@ -1337,6 +1582,33 @@ function apply(ctx, config = {}) {
 						body = null;
 					}
 					const record = body !== null && typeof body === "object" && !Array.isArray(body) ? body : null;
+					if (record !== null && record.action === "consumeResetCredit") {
+						if (record.creditId !== void 0 && typeof record.creditId !== "string" || record.redeemRequestId !== void 0 && typeof record.redeemRequestId !== "string") return new Response(JSON.stringify({
+							ok: false,
+							error: "Invalid request body: creditId and redeemRequestId must be strings when provided"
+						}), {
+							status: 400,
+							headers: { "content-type": "application/json" }
+						});
+						const consumeResult = await usageFetcher.consumeResetCredit({
+							creditId: record.creditId,
+							redeemRequestId: record.redeemRequestId
+						});
+						appendPluginLog(getCodexHome(), ctx, consumeResult.ok ? "INFO" : "WARN", "reset_credit.consume", {
+							creditId: record.creditId ?? null,
+							ok: consumeResult.ok,
+							...consumeResult.ok ? { outcome: consumeResult.outcome } : { error: consumeResult.error }
+						});
+						return new Response(JSON.stringify({
+							...consumeResult,
+							defaultFastMode: getConfigFastMode(),
+							sessionFastModes: buildProjectedSessionFastModes(),
+							sessionParents: Object.fromEntries(sessionParents)
+						}), {
+							status: 200,
+							headers: { "content-type": "application/json" }
+						});
+					}
 					if (record === null || typeof record.fastMode !== "boolean" || record.sessionId !== void 0 && typeof record.sessionId !== "string") return new Response(JSON.stringify({
 						ok: false,
 						error: "Invalid request body: boolean fastMode is required"
@@ -1439,6 +1711,7 @@ const __test = Object.freeze({
 	normalizeCodexSessionId,
 	toCodexWireSessionId,
 	parseUsagePayload,
+	parseResetCreditsPayload,
 	createUsageFetcher
 });
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyogvce/dsh-codex-subscription",
-  "version": "0.2.13",
+  "version": "0.3.1",
   "description": "复用本机 ~/.codex 订阅凭证与 models_cache.json 模型缓存，在 DSH 中通过 SSE 直连调用 Codex 模型。",
   "type": "module",
   "main": "./lib/index.js",