lidge-jun · lidge-jun · Aug 26, 2026 · Aug 26, 2026 · Aug 26, 2026 · chatgpt-codex-connector
@@ -72,6 +72,10 @@ export default function CodexAccountPool({ apiBase, accountModeState = null, ban
   const [actionFeedbackTone, setActionFeedbackTone] = useState<NoticeTone | null>(null);
   const feedbackTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const [refreshingQuota, setRefreshingQuota] = useState(false);
+  // undefined until /api/settings answers: the switch must not render a guessed position and
+  // then visibly correct itself a moment later.
+  const [sparkVisible, setSparkVisible] = useState<boolean | undefined>(undefined);
+  const [sparkBusy, setSparkBusy] = useState(false);
   const [resetPopup, setResetPopup] = useState<CodexAccountEntry | null>(null);
   const [resetConfirm, setResetConfirm] = useState(false);
   const [redeeming, setRedeeming] = useState(false);
@@ -228,6 +232,49 @@ export default function CodexAccountPool({ apiBase, accountModeState = null, ban
     }
   };
 
+  useEffect(() => {
+    // AbortController rather than a `cancelled` flag: the in-flight request is actually torn
+    // down on unmount, and the state update lands in a .then() the linter can see is guarded.
+    const abort = new AbortController();
+    fetch(`${apiBase}/api/settings`, { signal: abort.signal })
+      .then(response => (response.ok ? response.json() : null))
+      .then((payload: { showCodexSparkQuota?: unknown } | null) => {
+        if (abort.signal.aborted || typeof payload?.showCodexSparkQuota !== "boolean") return;
+        setSparkVisible(payload.showCodexSparkQuota);
+      })
+      // A settings read failure leaves the switch unrendered rather than guessing a position.
+      .catch(() => {});
+    return () => { abort.abort(); };
+  }, [apiBase]);
+
+  const toggleSpark = async () => {
+    if (sparkBusy || sparkVisible === undefined) return;
+    const requested = !sparkVisible;
+    setSparkBusy(true);
+    // Optimistic, then reconciled against what the server confirms — the same shape the account
+    // picker toggle uses, so a rejected write visibly snaps back instead of lying.
+    setSparkVisible(requested);
+    try {
+      const response = await fetch(`${apiBase}/api/settings`, {
+        method: "PUT",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ showCodexSparkQuota: requested }),
+      });
+      if (!response.ok) throw new Error("save");
+      const payload = await response.json() as { showCodexSparkQuota?: unknown };
+      const confirmed = typeof payload.showCodexSparkQuota === "boolean" ? payload.showCodexSparkQuota : requested;
+      setSparkVisible(confirmed);
+      showActionFeedback(t(confirmed ? "codexAuth.sparkQuotaShown" : "codexAuth.sparkQuotaHidden"), "ok");
+      await load(true);
+    } catch {
+      setSparkVisible(!requested);
+      showActionFeedback(t("codexAuth.sparkQuotaFailed"), "err");
+    } finally {
+      setSparkBusy(false);
+    }
+  };
+
+
   const pauseExhausted = async () => {
     const result = await controller.pauseExhaustedAccounts();
     if (!result.ok && result.reason === "busy") return;
@@ -294,6 +341,9 @@ export default function CodexAccountPool({ apiBase, accountModeState = null, ban
         pauseBusy={pauseBusy}
         onRefresh={() => { void refreshQuotas(); }}
         onPauseExhausted={() => { void pauseExhausted(); }}
+        sparkVisible={sparkVisible}
+        sparkBusy={sparkBusy}
+        onToggleSpark={() => { void toggleSpark(); }}
       />
 
       {banner}

@@ -183,6 +183,9 @@ export function CodexAccountPoolPageHead({
   actionFeedbackTone,
   onRefresh,
   onPauseExhausted,
+  sparkVisible,
+  sparkBusy,
+  onToggleSpark,
 }: {
   t: TFn;
   embedded: boolean;
@@ -193,6 +196,10 @@ export function CodexAccountPoolPageHead({
   actionFeedbackTone?: NoticeTone | null;
   onRefresh: () => void;
   onPauseExhausted: () => void;
+  /** undefined until the preference has loaded, so the switch never renders a guessed state. */
+  sparkVisible?: boolean;
+  sparkBusy?: boolean;
+  onToggleSpark?: () => void;
 }) {
   return (
     <div
@@ -208,6 +215,22 @@ export function CodexAccountPoolPageHead({
         >
           {actionFeedback ?? ""}
         </span>
+        {sparkVisible !== undefined && onToggleSpark && (
+          <span className="codex-auth-spark-toggle">
+            <span className="codex-auth-spark-toggle__label">{t("codexAuth.sparkQuota")}</span>
+            <button
+              type="button"
+              className={`toggle ${sparkVisible ? "on" : ""}`}
+              onClick={onToggleSpark}
+              disabled={!!sparkBusy}
+              aria-pressed={sparkVisible}
+              aria-label={t("codexAuth.sparkQuota")}
+              title={t("codexAuth.sparkQuotaHint")}
+            >
+              <span className="toggle-knob" />
+            </button>
+          </span>
+        )}
         <button
           type="button"
           className="btn btn-sm btn-ghost codex-auth-action-btn"

@@ -1003,6 +1003,11 @@ export const de: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "OpenAI-Anbieter-Preset ist nicht verfügbar.",
   "codexAuth.openProviders": "Anbieter öffnen",
   "codexAuth.add": "Hinzufügen",
+  "codexAuth.sparkQuota": "Codex-Spark-Kontingent",
+  "codexAuth.sparkQuotaHint": "Zeigt das GPT-5.3-Codex-Spark-Wochenfenster auf Kontokarten. Standardmäßig ausgeblendet, da es nur für ein Modell gilt.",
+  "codexAuth.sparkQuotaShown": "Codex-Spark-Kontingent wird angezeigt",
+  "codexAuth.sparkQuotaHidden": "Codex-Spark-Kontingent ausgeblendet",
+  "codexAuth.sparkQuotaFailed": "Codex-Spark-Kontingent konnte nicht geändert werden",
   "codexAuth.refreshQuota": "Kontingente aktualisieren",
   "codexAuth.refreshingQuota": "Aktualisiere…",
   "codexAuth.quotaRefreshed": "Kontingente aktualisiert",

@@ -1495,6 +1495,11 @@ export const en = {
   "codexAuth.openaiPresetUnavailable": "OpenAI provider preset is unavailable.",
   "codexAuth.openProviders": "Open Providers",
   "codexAuth.add": "Add",
+  "codexAuth.sparkQuota": "Codex Spark quota",
+  "codexAuth.sparkQuotaHint": "Show the GPT-5.3-Codex-Spark weekly window on account cards. Hidden by default because it applies to one model only.",
+  "codexAuth.sparkQuotaShown": "Codex Spark quota shown",
+  "codexAuth.sparkQuotaHidden": "Codex Spark quota hidden",
+  "codexAuth.sparkQuotaFailed": "Could not change the Codex Spark quota setting",
   "codexAuth.refreshQuota": "Refresh quotas",
   "codexAuth.refreshingQuota": "Refreshing...",
   "codexAuth.quotaRefreshed": "Quotas refreshed",

@@ -1468,6 +1468,11 @@ export const fr: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "Le préréglage du fournisseur OpenAI est indisponible.",
   "codexAuth.openProviders": "Ouvrir Fournisseurs",
   "codexAuth.add": "Ajouter",
+  "codexAuth.sparkQuota": "Quota Codex Spark",
+  "codexAuth.sparkQuotaHint": "Affiche la fenêtre hebdomadaire GPT-5.3-Codex-Spark sur les cartes de compte. Masquée par défaut car elle ne concerne qu'un seul modèle.",
+  "codexAuth.sparkQuotaShown": "Quota Codex Spark affiché",
+  "codexAuth.sparkQuotaHidden": "Quota Codex Spark masqué",
+  "codexAuth.sparkQuotaFailed": "Impossible de modifier le réglage du quota Codex Spark",
   "codexAuth.refreshQuota": "Actualiser les quotas",
   "codexAuth.refreshingQuota": "Actualisation…",
   "codexAuth.quotaRefreshed": "Quotas actualisés",

@@ -1428,6 +1428,11 @@ export const ja: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "OpenAI プロバイダーのプリセットを利用できません。",
   "codexAuth.openProviders": "プロバイダーを開く",
   "codexAuth.add": "追加",
+  "codexAuth.sparkQuota": "Codex Spark 使用量",
+  "codexAuth.sparkQuotaHint": "アカウントカードに GPT-5.3-Codex-Spark の週次枠を表示します。対象が 1 モデルのみのため既定は非表示です。",
+  "codexAuth.sparkQuotaShown": "Codex Spark 使用量を表示しました",
+  "codexAuth.sparkQuotaHidden": "Codex Spark 使用量を非表示にしました",
+  "codexAuth.sparkQuotaFailed": "Codex Spark 使用量の設定を変更できませんでした",
   "codexAuth.refreshQuota": "クォータを更新",
   "codexAuth.refreshingQuota": "更新中...",
   "codexAuth.quotaRefreshed": "クォータを更新しました",

@@ -1027,6 +1027,11 @@ export const ko: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "OpenAI 공급자 프리셋을 사용할 수 없습니다.",
   "codexAuth.openProviders": "프로바이더 열기",
   "codexAuth.add": "추가",
+  "codexAuth.sparkQuota": "Codex Spark 할당량",
+  "codexAuth.sparkQuotaHint": "계정 카드에 GPT-5.3-Codex-Spark 주간 창을 표시합니다. 모델 하나에만 적용되므로 기본값은 숨김입니다.",
+  "codexAuth.sparkQuotaShown": "Codex Spark 할당량을 표시합니다",
+  "codexAuth.sparkQuotaHidden": "Codex Spark 할당량을 숨겼습니다",
+  "codexAuth.sparkQuotaFailed": "Codex Spark 할당량 설정을 바꾸지 못했습니다",
   "codexAuth.refreshQuota": "할당량 새로고침",
   "codexAuth.refreshingQuota": "새로고침 중...",
   "codexAuth.quotaRefreshed": "할당량을 다시 조회했습니다",

@@ -1479,6 +1479,11 @@ export const ru: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "Пресет провайдера OpenAI недоступен.",
   "codexAuth.openProviders": "Открыть провайдеров",
   "codexAuth.add": "Добавить",
+  "codexAuth.sparkQuota": "Квота Codex Spark",
+  "codexAuth.sparkQuotaHint": "Показывать недельное окно GPT-5.3-Codex-Spark на карточках аккаунтов. По умолчанию скрыто: оно относится лишь к одной модели.",
+  "codexAuth.sparkQuotaShown": "Квота Codex Spark показана",
+  "codexAuth.sparkQuotaHidden": "Квота Codex Spark скрыта",
+  "codexAuth.sparkQuotaFailed": "Не удалось изменить настройку квоты Codex Spark",
   "codexAuth.refreshQuota": "Обновить квоты",
   "codexAuth.refreshingQuota": "Обновление...",
   "codexAuth.quotaRefreshed": "Квоты обновлены",

@@ -1497,6 +1497,11 @@ export const tr: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "Ayar kullanılamıyor.",
   "codexAuth.openProviders": "Sağlayıcıları Aç",
   "codexAuth.add": "Ekle",
+  "codexAuth.sparkQuota": "Codex Spark kotası",
+  "codexAuth.sparkQuotaHint": "Hesap kartlarında GPT-5.3-Codex-Spark haftalık penceresini gösterir. Yalnızca tek bir modeli kapsadığı için varsayılan olarak gizlidir.",
+  "codexAuth.sparkQuotaShown": "Codex Spark kotası gösteriliyor",
+  "codexAuth.sparkQuotaHidden": "Codex Spark kotası gizlendi",
+  "codexAuth.sparkQuotaFailed": "Codex Spark kotası ayarı değiştirilemedi",
   "codexAuth.refreshQuota": "Kotaları yenile",
   "codexAuth.refreshingQuota": "Yenileniyor...",
   "codexAuth.quotaRefreshed": "Kotalar yenilendi",

@@ -1127,6 +1127,11 @@ export const zhTW: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "OpenAI 供應商預設不可用。",
   "codexAuth.openProviders": "開啟供應商",
   "codexAuth.add": "新增",
+  "codexAuth.sparkQuota": "Codex Spark 配額",
+  "codexAuth.sparkQuotaHint": "在帳號卡片上顯示 GPT-5.3-Codex-Spark 週視窗。預設隱藏，因為只適用於單一模型。",
+  "codexAuth.sparkQuotaShown": "已顯示 Codex Spark 配額",
+  "codexAuth.sparkQuotaHidden": "已隱藏 Codex Spark 配額",
+  "codexAuth.sparkQuotaFailed": "無法變更 Codex Spark 配額設定",
   "codexAuth.refreshQuota": "重新整理額度",
   "codexAuth.refreshingQuota": "重新整理中...",
   "codexAuth.quotaRefreshed": "額度已重新整理",

@@ -1020,6 +1020,11 @@ export const zh: Record<TKey, string> = {
   "codexAuth.openaiPresetUnavailable": "OpenAI 提供方预设不可用。",
   "codexAuth.openProviders": "打开提供商",
   "codexAuth.add": "添加",
+  "codexAuth.sparkQuota": "Codex Spark 配额",
+  "codexAuth.sparkQuotaHint": "在账户卡片上显示 GPT-5.3-Codex-Spark 周窗口。默认隐藏，因为它只适用于一个模型。",
+  "codexAuth.sparkQuotaShown": "已显示 Codex Spark 配额",
+  "codexAuth.sparkQuotaHidden": "已隐藏 Codex Spark 配额",
+  "codexAuth.sparkQuotaFailed": "无法更改 Codex Spark 配额设置",
   "codexAuth.refreshQuota": "刷新额度",
   "codexAuth.refreshingQuota": "刷新中...",
   "codexAuth.quotaRefreshed": "额度已刷新",

@@ -1680,6 +1680,19 @@ dialog.modal-overlay::backdrop {
   gap: 10px;
   min-width: 0;
 }
+/* Spark visibility switch: a labelled toggle, not a bare knob. An unlabelled switch sitting
+   between two labelled buttons is a guessing game, and this one changes what every card in the
+   page renders. The label carries the meaning; the toggle carries the state. */
+.codex-auth-spark-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  white-space: nowrap;
+}
+.codex-auth-spark-toggle__label {
+  font-size: 12px;
+  color: var(--muted);
+}
 /* Account actions (pause / copy doctor / pause-exhausted): clearer hover than plain
    btn-ghost on card surface — same raised-hover + faint border as icon/list cues. */
 .codex-auth-action-btn:hover:not(:disabled) {

@@ -209,22 +209,59 @@ function codexAccountPersistenceConflict(
     : undefined;
 }
 
+/**
+ * The exact label `parseUsageQuota` emits for the Codex Spark window (quota.ts).
+ * Matching on the label rather than on "is a custom window" is load-bearing: the same array
+ * carries Cursor's First-party models / API usage, Anthropic's Fable / Opus / Sonnet,
+ * Antigravity's Gem / Cla, Kimi's subscription credits and a dozen dynamic provider meters.
+ */
+const CODEX_SPARK_WINDOW_LABEL = "GPT-5.3-Codex-Spark Weekly";
+
+/**
+ * Drop the Spark window unless the operator asked for it (default hidden).
+ *
+ * Applied at the DTO boundary, never at parse or cache time: custom windows participate in
+ * quota-presence checks, snapshot reconciliation and capacity aggregation, so removing Spark
+ * upstream of this point would change routing state rather than display.
+ *
+ * Both GUI surfaces funnel through here — the Codex Auth rows directly, and /api/provider-quotas
+ * via listCodexAuthAccountsSnapshot — so one filter covers both. Filtering only one would leave
+ * the other still rendering the row the operator switched off.
+ */
+export function withSparkVisibility<T extends Omit<StoredAccountQuota, "updatedAt"> | StoredAccountQuota | null>(
+  quota: T,
+): T {
+  if (!quota?.customWindows?.length) return quota;
+  if (loadConfig().showCodexSparkQuota === true) return quota;
+  const kept = quota.customWindows.filter(window => window.label !== CODEX_SPARK_WINDOW_LABEL);
+  if (kept.length === quota.customWindows.length) return quota;
+  // An empty list is dropped rather than serialized: an absent field and an empty array should
+  // not be two different ways of saying "no custom windows" on the wire.
+  const next = { ...quota } as Record<string, unknown>;
+  if (kept.length > 0) next.customWindows = kept;
+  else delete next.customWindows;
+  return next as T;
+}
+
+
 function quotaForPlan<T extends Omit<StoredAccountQuota, "updatedAt"> | StoredAccountQuota | null>(
   quota: T,
   plan: unknown,
 ): T {
-  if (!quota || !isThirtyDayOnlyCodexPlan(plan)) return quota;
+  const visible = withSparkVisibility(quota);
+  if (!visible || !isThirtyDayOnlyCodexPlan(plan)) return visible;
+  const quotaWindows = visible;
   return {
-    ...(quota.monthlyPercent !== undefined ? { monthlyPercent: quota.monthlyPercent } : {}),
-    ...(quota.monthlyResetAt !== undefined ? { monthlyResetAt: quota.monthlyResetAt } : {}),
+    ...(quotaWindows.monthlyPercent !== undefined ? { monthlyPercent: quotaWindows.monthlyPercent } : {}),
+    ...(quotaWindows.monthlyResetAt !== undefined ? { monthlyResetAt: quotaWindows.monthlyResetAt } : {}),
     // A 30-day plan can still carry a burst window, and it blocks the account on its own.
     // Dropping it here would show a healthy card for an account upstream is refusing (#1791).
-    ...(quota.shortPercent !== undefined ? { shortPercent: quota.shortPercent } : {}),
-    ...(quota.shortResetAt !== undefined ? { shortResetAt: quota.shortResetAt } : {}),
-    ...(quota.shortWindowSeconds !== undefined ? { shortWindowSeconds: quota.shortWindowSeconds } : {}),
-    ...(quota.customWindows !== undefined ? { customWindows: quota.customWindows } : {}),
-    ...(quota.resetCredits !== undefined ? { resetCredits: quota.resetCredits } : {}),
-    ...("updatedAt" in quota ? { updatedAt: quota.updatedAt } : {}),
+    ...(quotaWindows.shortPercent !== undefined ? { shortPercent: quotaWindows.shortPercent } : {}),
+    ...(quotaWindows.shortResetAt !== undefined ? { shortResetAt: quotaWindows.shortResetAt } : {}),
+    ...(quotaWindows.shortWindowSeconds !== undefined ? { shortWindowSeconds: quotaWindows.shortWindowSeconds } : {}),
+    ...(quotaWindows.customWindows !== undefined ? { customWindows: quotaWindows.customWindows } : {}),
+    ...(quotaWindows.resetCredits !== undefined ? { resetCredits: quotaWindows.resetCredits } : {}),
+    ...("updatedAt" in quotaWindows ? { updatedAt: quotaWindows.updatedAt } : {}),
   } as T;
 }
 

@@ -921,6 +921,9 @@ const configSchema = z.object({
   // A malformed hand edit must degrade to false without discarding providers, accounts,
   // or the exact selector map. Live writes remain strict.
   codexAccountPickerEnabled: z.boolean().optional().catch(false),
+  // Same degrade-not-reject rule: a malformed hand edit hides Spark rather than discarding the
+  // whole config. Hidden is also the default, so `catch(false)` and the default agree.
+  showCodexSparkQuota: z.boolean().optional().catch(false),
   // Model ids excluded from the Grok Build managed block (dashboard switches).
   grokExcludedModels: z.array(z.string()).optional(),
   // Invalid values degrade to undefined ("auto") instead of failing the whole

@@ -3,6 +3,7 @@ import {
   effectiveCodexAuthAccountId,
   fetchMainAccountInfoSnapshot,
   listCodexAuthAccountsSnapshot,
+  withSparkVisibility,
 } from "../codex/auth-api";
 import type { StoredAccountQuota } from "../codex/quota";
 import { isMainAccountIdentityGenerationLive } from "../codex/main-account-cache";
@@ -171,6 +172,11 @@ function providerQuotaFromCodexQuota(
   quota: StoredAccountQuota | Omit<StoredAccountQuota, "updatedAt"> | null | undefined,
 ): CodexCapacityQuota | null {
   if (!quota) return null;
+  // Every Codex-sourced provider report funnels through here — the pooled path via
+  // listCodexAuthAccountsSnapshot and the `direct` path via fetchMainAccountInfoSnapshot, which
+  // never touches the Codex Auth DTO. Applying the Spark preference at this one point is what
+  // stops the row surviving on /api/provider-quotas after the operator switched it off.
+  quota = withSparkVisibility(quota ?? null) ?? quota;
   return {
     ...(quota.shortPercent !== undefined ? { fiveHourPercent: quota.shortPercent } : {}),
     ...(quota.shortResetAt !== undefined ? { fiveHourResetAt: quota.shortResetAt } : {}),