feat(gui): surface per-target quota state in the combo workspace

docs-site/src/content/docs/fr/guides/combos.md

@@ -259,6 +259,11 @@ flux de travail des tâches.
 Ouvrez le tableau de bord local et choisissez **Modèles → Combos**. L'espace de travail crée, modifie, renomme et supprime
 combos, et son sélecteur de cible exclut les modèles désactivés et les combos imbriqués.
 
+Chaque cible affiche aussi un badge de quota en direct : **Disponible**, **Quota épuisé** ou **Quota inconnu**.
+Enregistrer et Créer ne sont désactivés que lorsque chaque cible activée dispose de preuves fraîches et complètes
+que son quota est épuisé. Les données manquantes, obsolètes, mal formées ou agrégées de façon incomplète restent
+inconnues et ne verrouillent jamais un contrôle. La récupération du quota réactive automatiquement l’action.
+
 ### CLI
 
 Les commandes principales sont :

docs-site/src/content/docs/guides/combos.md

@@ -268,6 +268,11 @@ task workflow.
 Open the local dashboard and choose **Models → Combos**. The workspace creates, edits, renames, and removes
 combos, and its target picker excludes disabled models and nested combos.
 
+Each target also shows a live quota badge: **Available**, **Out of quota**, or **Quota unknown**. Save and
+Create are disabled only when every enabled target has fresh, complete evidence that its quota is exhausted.
+Missing, stale, malformed, or incomplete aggregate evidence stays unknown and never locks a control. Polling
+continues while the workspace is visible, so recovery automatically restores the action.
+
 ### CLI
 
 The primary commands are:

docs-site/src/content/docs/ja/guides/combos.md

@@ -167,6 +167,10 @@ v1/base/v2 モードと完全な暗号化タスクのワークフローについ
 
 ローカル ダッシュボードを開き、**Models → コンボ**を選択します。ワークスペースはコンボを作成、編集、名前変更、削除し、そのターゲット ピッカーは無効なモデルとネストされたコンボを除外します。
 
+各ターゲットには **利用可能**、**クォータを使い切りました**、**クォータ不明** のライブバッジも表示されます。
+保存と作成が無効になるのは、有効な全ターゲットについて、クォータ枯渇を示す新鮮で完全な証拠がある場合だけです。
+欠落、古い、不正、または不完全な集約データは不明のままで、操作をロックしません。クォータが回復すると操作は自動で再び有効になります。
+
 ### CLI
 
 主なコマンドは次のとおりです。

docs-site/src/content/docs/ko/guides/combos.md

@@ -167,6 +167,10 @@ v1/base/v2 모드와 암호화된 작업의 전체 흐름은 [Sub-agent Surface]
 
 로컬 대시보드를 열고 **Models → Combos**를 선택합니다. 워크스페이스는 콤보를 만들고, 편집하고, 이름을 바꾸고, 제거할 수 있으며, 대상 선택기에서는 비활성 모델과 중첩 콤보를 제외합니다.
 
+각 대상에는 **사용 가능**, **할당량 소진**, **할당량 알 수 없음** 실시간 배지도 표시됩니다. 저장과 만들기 버튼은
+활성화된 모든 대상에 할당량 소진을 입증하는 최신의 완전한 증거가 있을 때만 비활성화됩니다. 누락되거나 오래되거나
+형식이 잘못되었거나 집계가 불완전한 데이터는 알 수 없음으로 남으며 버튼을 잠그지 않습니다. 할당량이 복구되면 버튼도 자동으로 다시 활성화됩니다.
+
 ### CLI
 
 주요 명령은 다음과 같습니다.

docs-site/src/content/docs/ru/guides/combos.md

@@ -213,6 +213,11 @@ effort вызывающей стороне и цели.
 Откройте локальный дашборд и выберите **Models → Combos**. Рабочая область умеет создавать, редактировать,
 переименовывать и удалять combo, а селектор целей исключает отключённые модели и вложенные combo.
 
+У каждой цели также отображается актуальный значок квоты: **Доступно**, **Квота исчерпана** или **Квота неизвестна**.
+Кнопки сохранения и создания отключаются только тогда, когда для всех включённых целей есть свежие и полные
+данные об исчерпании квоты. Отсутствующие, устаревшие, некорректные или неполные агрегированные данные остаются
+неизвестными и никогда не блокируют управление. Восстановление квоты автоматически снова включает действие.
+
 ### CLI
 
 Основные команды:

docs-site/src/content/docs/tr/guides/combos.md

@@ -286,6 +286,11 @@ Yerel kontrol panelini açın ve **Modeller → Kombolar** seçeneğini belirley
 hedef seçicisi ise devre dışı bırakılmış modelleri ve iç içe geçmiş komboları
 hariç tutar.
 
+Her hedef ayrıca canlı bir kota rozeti gösterir: **Kullanılabilir**, **Kota tükendi** veya **Kota bilinmiyor**.
+Kaydet ve Oluştur yalnızca etkin hedeflerin tamamı için kotanın tükendiğini gösteren güncel ve eksiksiz kanıt varsa
+devre dışı bırakılır. Eksik, eski, bozuk veya tamamlanmamış toplu kanıt bilinmiyor olarak kalır ve denetimleri asla
+kilitlemez. Kota yenilendiğinde işlem otomatik olarak yeniden etkinleşir.
+
 ### CLI
 
 Birincil komutlar şunlardır:
@@ -381,4 +386,3 @@ Hata hedefe özgü olmaktan ziyade uç (terminal) bir hataydı. Geçersiz girdiy
 düzeltin, aşırı büyük bir bağlamı azaltın, bir politika reddini işleyin veya
 reddedilen istek kaynağını düzeltin. Kombolar bu durumlar için atlama yapmaz.
 
-

docs-site/src/content/docs/zh-cn/guides/combos.md

@@ -197,6 +197,10 @@ combo 失败分为 **跳转** 失败和 **终止** 失败。
 
 打开本地 dashboard 并选择 **Models → Combos**。该工作区可以创建、编辑、重命名和删除 combo，其目标选择器会排除已禁用的模型和嵌套 combo。
 
+每个目标还会显示实时额度徽章：**可用**、**额度已用尽**或**额度未知**。只有当所有已启用目标都有最新、
+完整的额度耗尽证据时，保存和创建操作才会被禁用。缺失、过期、格式错误或聚合不完整的证据会保持为未知，
+绝不会锁定控件。额度恢复后，操作会自动重新启用。
+
 ### CLI
 
 主要命令如下：

docs-site/src/content/docs/zh-tw/guides/combos.md

@@ -205,6 +205,10 @@ Codex v2 子代理有一個重要限制（[issue #92](https://github.com/lidge-j
 
 開啟本機儀表板並選擇 **Combos**。該工作區可建立、編輯、重新命名與移除 combo，且其目標 picker 會排除已停用的模型與巢狀 combo。
 
+每個目標也會顯示即時額度徽章：**可用**、**額度已用盡**或**額度未知**。只有當所有已啟用目標都有最新、
+完整的額度耗盡證據時，儲存與建立操作才會停用。缺失、過期、格式錯誤或聚合不完整的證據會維持未知，
+絕不會鎖住控制項。額度恢復後，操作會自動重新啟用。
+
 ### CLI
 
 主要指令為：

gui/src/combo-workspace-data.ts

@@ -49,6 +49,12 @@ export interface ComboTarget {
   clientKey?: string;
 }
 
+export type ComboQuotaState = "available" | "exhausted" | "unknown";
+export type ProviderQuotaStates = Readonly<Record<string, ComboQuotaState>>;
+
+/** Matches the management endpoint's bounded last-good quota lifetime. */
+export const COMBO_QUOTA_MAX_AGE_MS = 30 * 60_000;
+
 let comboTargetKeySeq = 0;
 
 export function newComboTarget(partial: Partial<ComboTarget> = {}): ComboTarget {
@@ -90,7 +96,7 @@ export interface ComboSections {
 export interface ComboAttentionItem {
   id: string;
   model: string;
-  reason: "few-targets" | "empty-targets" | "catalog-omitted";
+  reason: "few-targets" | "empty-targets" | "catalog-omitted" | "all-targets-exhausted";
 }
 
 export const COMBO_ID_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/;
@@ -212,9 +218,197 @@ export function filterCombos(items: ComboItem[], query: string): ComboItem[] {
   });
 }
 
+function recordFromUnknown(value: unknown): Record<string, unknown> | null {
+  return value && typeof value === "object" && !Array.isArray(value)
+    ? value as Record<string, unknown>
+    : null;
+}
+
+function finiteNumber(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function quotaTimestampIsFresh(value: unknown, now: number): boolean {
+  const timestamp = finiteNumber(value);
+  return timestamp !== null && now - timestamp < COMBO_QUOTA_MAX_AGE_MS;
+}
+
+function nonNegativeInteger(value: unknown): number | null {
+  const number = finiteNumber(value);
+  return number !== null && Number.isInteger(number) && number >= 0 ? number : null;
+}
+
+function aggregateWindowIsComplete(value: unknown, now: number): boolean {
+  const window = recordFromUnknown(value);
+  const usedPercent = finiteNumber(window?.usedPercent);
+  return !!window
+    && usedPercent !== null
+    && usedPercent >= 0
+    && nonNegativeInteger(window.includedAccounts) !== null
+    && (nonNegativeInteger(window.includedAccounts) ?? 0) > 0
+    && nonNegativeInteger(window.excludedAccounts) === 0
+    && window.incomplete === false
+    && quotaTimestampIsFresh(window.updatedAt, now);
+}
+
+function aggregateEvidenceIsComplete(value: unknown, now: number): boolean {
+  const aggregation = recordFromUnknown(value);
+  if (
+    !aggregation
+    || aggregation.kind !== "capacity-weighted-v1"
+    || aggregation.scope !== "routable-known"
+    || aggregation.presentation !== "aggregate"
+    || aggregation.incomplete !== false
+  ) return false;
+
+  for (const key of [
+    "includedAccounts",
+    "excludedAccounts",
+    "unknownPlanAccounts",
+    "missingQuotaAccounts",
+    "pausedAccounts",
+    "reauthAccounts",
+    "staleQuotaAccounts",
+    "partialWindowAccounts",
+  ] as const) {
+    if (nonNegativeInteger(aggregation[key]) === null) return false;
+  }
+  if ((nonNegativeInteger(aggregation.includedAccounts) ?? 0) === 0) return false;
+  for (const key of [
+    "excludedAccounts",
+    "unknownPlanAccounts",
+    "missingQuotaAccounts",
+    "pausedAccounts",
+    "reauthAccounts",
+    "staleQuotaAccounts",
+    "partialWindowAccounts",
+  ] as const) {
+    if (aggregation[key] !== 0) return false;
+  }
+
+  let hasWindow = false;
+  for (const key of ["fiveHour", "weekly", "monthly"] as const) {
+    if (!Object.hasOwn(aggregation, key)) continue;
+    if (!aggregateWindowIsComplete(aggregation[key], now)) return false;
+    hasWindow = true;
+  }
+  if (Object.hasOwn(aggregation, "customWindows")) {
+    if (!Array.isArray(aggregation.customWindows)) return false;
+    for (const value of aggregation.customWindows) {
+      const custom = recordFromUnknown(value);
+      if (!custom || typeof custom.label !== "string" || !custom.label.trim()) return false;
+      if (!aggregateWindowIsComplete(custom, now)) return false;
+      hasWindow = true;
+    }
+  }
+  return hasWindow;
+}
+
+function quotaStateFromReport(raw: Record<string, unknown>, now: number): ComboQuotaState {
+  if (!quotaTimestampIsFresh(raw.updatedAt, now)) return "unknown";
+  const quota = recordFromUnknown(raw.quota);
+  if (!quota || !quotaTimestampIsFresh(quota.updatedAt, now)) return "unknown";
+  if (raw.aggregation !== undefined && !aggregateEvidenceIsComplete(raw.aggregation, now)) return "unknown";
+
+  let hasEvidence = false;
+  let exhausted = false;
+  for (const key of ["fiveHourPercent", "weeklyPercent", "monthlyPercent"] as const) {
+    if (!Object.hasOwn(quota, key)) continue;
+    const percent = finiteNumber(quota[key]);
+    if (percent === null || percent < 0) return "unknown";
+    hasEvidence = true;
+    if (percent >= 100) exhausted = true;
+  }
+  for (const key of ["fiveHourResetAt", "weeklyResetAt", "monthlyResetAt"] as const) {
+    if (Object.hasOwn(quota, key) && finiteNumber(quota[key]) === null) return "unknown";
+  }
+
+  if (Object.hasOwn(quota, "customWindows")) {
+    if (!Array.isArray(quota.customWindows)) return "unknown";
+    for (const value of quota.customWindows) {
+      const window = recordFromUnknown(value);
+      const percent = finiteNumber(window?.percent);
+      if (!window || typeof window.label !== "string" || !window.label.trim() || percent === null || percent < 0) {
+        return "unknown";
+      }
+      if (Object.hasOwn(window, "resetAt") && finiteNumber(window.resetAt) === null) return "unknown";
+      hasEvidence = true;
+      if (percent >= 100) exhausted = true;
+    }
+  }
+
+  if (Object.hasOwn(quota, "creditsUsd")) {
+    const credits = recordFromUnknown(quota.creditsUsd);
+    if (!credits) return "unknown";
+    const used = finiteNumber(credits.used);
+    const limit = finiteNumber(credits.limit);
+    const remaining = finiteNumber(credits.remaining);
+    const percent = finiteNumber(credits.percent);
+    if (used === null || used < 0 || limit === null || limit < 0 || remaining === null || percent === null || percent < 0) {
+      return "unknown";
+    }
+    if (credits.unlimited !== undefined && typeof credits.unlimited !== "boolean") return "unknown";
+    if (Object.hasOwn(credits, "expiresAt") && finiteNumber(credits.expiresAt) === null) return "unknown";
+    hasEvidence = true;
+    if (credits.unlimited !== true && remaining <= 0) exhausted = true;
+  }
+
+  if (!hasEvidence) return "unknown";
+  return exhausted ? "exhausted" : "available";
+}
+
+/** Fail-unknown parser for the live `/api/provider-quotas` report array. */
+export function providerQuotaStatesFromReports(
+  reports: unknown,
+  now = Date.now(),
+): Record<string, ComboQuotaState> {
+  if (!Array.isArray(reports)) return {};
+  const states: Record<string, ComboQuotaState> = {};
+  for (const value of reports) {
+    const report = recordFromUnknown(value);
+    const provider = typeof report?.provider === "string" ? report.provider.trim() : "";
+    if (!report || !provider) continue;
+    const next = quotaStateFromReport(report, now);
+    states[provider] = Object.hasOwn(states, provider) && states[provider] !== next
+      ? "unknown"
+      : next;
+  }
+  return states;
+}
+
+/**
+ * A combo is exhausted only when it has at least one configured, enabled,
+ * complete target and every such target has known exhausted quota evidence.
+ */
+export function comboQuotaState(
+  targets: readonly ComboTarget[],
+  providerQuotaStates: ProviderQuotaStates,
+  providers: Readonly<Record<string, { disabled?: boolean }>>,
+): ComboQuotaState {
+  const usableProviders = targets.flatMap((target) => {
+    const provider = target.provider.trim();
+    if (!provider || !target.model.trim()) return [];
+    if (!Object.hasOwn(providers, provider) || providers[provider]?.disabled === true) return [];
+    return [provider];
+  });
+  if (usableProviders.length === 0) return "unknown";
+
+  let sawUnknown = false;
+  for (const provider of usableProviders) {
+    const state = providerQuotaStates[provider] ?? "unknown";
+    if (state === "available") return "available";
+    if (state === "unknown") sawUnknown = true;
+  }
+  return sawUnknown ? "unknown" : "exhausted";
+}
+
 export function buildComboAttention(
   items: ComboItem[],
-  options: { cataloguedComboIds?: ReadonlySet<string> } = {},
+  options: {
+    cataloguedComboIds?: ReadonlySet<string>;
+    providerQuotaStates?: ProviderQuotaStates;
+    providers?: Readonly<Record<string, { disabled?: boolean }>>;
+  } = {},
 ): ComboAttentionItem[] {
   const out: ComboAttentionItem[] = [];
   const catalogued = options.cataloguedComboIds;
@@ -230,6 +424,13 @@ export function buildComboAttention(
     if (catalogued && item.targets.length > 0 && !catalogued.has(item.id)) {
       out.push({ id: item.id, model: item.model, reason: "catalog-omitted" });
     }
+    if (
+      options.providerQuotaStates
+      && options.providers
+      && comboQuotaState(item.targets, options.providerQuotaStates, options.providers) === "exhausted"
+    ) {
+      out.push({ id: item.id, model: item.model, reason: "all-targets-exhausted" });
+    }
   }
   return out;
 }

gui/src/components/ComboWorkspace.tsx

@@ -18,6 +18,7 @@ export type { ModelOption, ProviderOption, ComboWorkspaceProps } from "./combo-w
 
 export default function ComboWorkspace({
   combos,
+  providerQuotaStates,
   providers,
   models,
   cataloguedComboIds,
@@ -172,6 +173,7 @@ export default function ComboWorkspace({
             otherIds={otherComboIds}
             otherAliases={otherComboAliases}
             providerMap={providerMap}
+            providerQuotaStates={providerQuotaStates}
             providers={providers}
             models={models}
             onBack={() => trySelect(null)}
@@ -199,6 +201,7 @@ export default function ComboWorkspace({
             otherIds={[]}
             otherAliases={[]}
             providerMap={providerMap}
+            providerQuotaStates={providerQuotaStates}
             providers={providers}
             models={models}
             onSaved={(item) => {
@@ -214,6 +217,8 @@ export default function ComboWorkspace({
           <OverviewPanel
             combos={combos}
             cataloguedComboIds={cataloguedComboIds}
+            providerMap={providerMap}
+            providerQuotaStates={providerQuotaStates}
             onSelect={(id) => trySelect(id)}
             onAdd={onAdd}
           />
@@ -225,6 +230,7 @@ export default function ComboWorkspace({
           existingIds={combos.map((c) => c.id)}
           existingAliases={existingComboAliases}
           providerMap={providerMap}
+          providerQuotaStates={providerQuotaStates}
           providers={providers}
           models={models}
           onClose={onCloseAdd}