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

gui/src/combo-workspace-data.ts

@@ -84,7 +84,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}$/;
@@ -207,10 +207,15 @@ export function filterCombos(items: ComboItem[], query: string): ComboItem[] {
 
 export function buildComboAttention(
   items: ComboItem[],
-  options: { cataloguedComboIds?: ReadonlySet<string> } = {},
+  options: {
+    cataloguedComboIds?: ReadonlySet<string>;
+    /** Providers whose quota is fully exhausted (0 credits remaining). */
+    exhaustedProviders?: ReadonlySet<string>;
+  } = {},
 ): ComboAttentionItem[] {
   const out: ComboAttentionItem[] = [];
   const catalogued = options.cataloguedComboIds;
+  const exhausted = options.exhaustedProviders;
   for (const item of items) {
     if (item.targets.length === 0) {
       out.push({ id: item.id, model: item.model, reason: "empty-targets" });
@@ -223,6 +228,15 @@ export function buildComboAttention(
     if (catalogued && item.targets.length > 0 && !catalogued.has(item.id)) {
       out.push({ id: item.id, model: item.model, reason: "catalog-omitted" });
     }
+    // Every target points at a provider with an exhausted quota.
+    if (
+      exhausted
+      && exhausted.size > 0
+      && item.targets.length > 0
+      && item.targets.every((target) => exhausted.has(target.provider.trim()))
+    ) {
+      out.push({ id: item.id, model: item.model, reason: "all-targets-exhausted" });
+    }
   }
   return out;
 }
@@ -375,3 +389,32 @@ export function emptyDraft(id = ""): ComboItem {
     targets: [newComboTarget()],
   };
 }
+
+/**
+ * Derives a set of provider names whose quota is fully exhausted
+ * from the /api/provider-quotas response shape.
+ */
+export function exhaustedProvidersFromQuotaReports(
+  reports: ReadonlyArray<{ provider: string; quota?: { creditsUsd?: { remaining?: number; unlimited?: boolean } } }>,
+): Set<string> {
+  const exhausted = new Set<string>();
+  for (const report of reports) {
+    const q = report.quota;
+    if (!q) continue;
+    const credits = q.creditsUsd;
+    if (!credits) continue;
+    if (credits.unlimited) continue;
+    if (typeof credits.remaining === "number" && credits.remaining <= 0) {
+      exhausted.add(report.provider);
+    }
+  }
+  return exhausted;
+}
+
+/** True when the provider has a quota report showing 0 remaining credits. */
+export function isProviderExhausted(
+  provider: string,
+  exhaustedProviders: ReadonlySet<string> | undefined,
+): boolean {
+  return exhaustedProviders !== undefined && exhaustedProviders.has(provider.trim());
+}

gui/src/components/ComboWorkspace.tsx

@@ -21,6 +21,7 @@ export default function ComboWorkspace({
   providers,
   models,
   cataloguedComboIds,
+  exhaustedProviders,
   loading,
   onRefresh,
   onSave,
@@ -190,6 +191,7 @@ export default function ComboWorkspace({
             onRequestRemove={() => setRemoveId(baseline.id)}
             onSave={onSave}
             onDirtyChange={setDetailDirty}
+            exhaustedProviders={exhaustedProviders}
           />
         ) : creatingFirstCombo ? (
           <DetailPanel
@@ -209,11 +211,13 @@ export default function ComboWorkspace({
             }}
             onSave={onSave}
             onDirtyChange={setDetailDirty}
+            exhaustedProviders={exhaustedProviders}
           />
         ) : (
           <OverviewPanel
             combos={combos}
             cataloguedComboIds={cataloguedComboIds}
+            exhaustedProviders={exhaustedProviders}
             onSelect={(id) => trySelect(id)}
             onAdd={onAdd}
           />

gui/src/components/combo-workspace-controls.tsx

@@ -6,6 +6,7 @@ import { useT } from "../i18n/shared";
 import { formatProviderDisplayName } from "../provider-icons";
 import type { ModelOption, ProviderOption } from "./combo-workspace-types";
 import { clampedNumberInput, enabledProviders, modelsForProvider } from "./combo-workspace-utils";
+import { isProviderExhausted } from "../combo-workspace-data";
 
 export function StrategySeg({
   value,
@@ -89,12 +90,14 @@ export function TargetEditor({
   providers,
   models,
   onChange,
+  exhaustedProviders,
 }: {
   targets: ComboTarget[];
   strategy: ComboStrategy;
   providers: ProviderOption[];
   models: ModelOption[];
   onChange: (next: ComboTarget[]) => void;
+  exhaustedProviders?: ReadonlySet<string>;
 }) {
   const t = useT();
   const provs = enabledProviders(providers);
@@ -127,6 +130,7 @@ export function TargetEditor({
         const modelSelectDisabled = !row.provider;
         const dragging = dragIndex === index;
         const dropTarget = overIndex === index && dragIndex !== null && dragIndex !== index;
+        const targetExhausted = row.provider && isProviderExhausted(row.provider, exhaustedProviders);
         return (
           <div
             key={row.clientKey ?? `${row.provider}:${row.model}`}
@@ -237,6 +241,11 @@ export function TargetEditor({
                 }}
               />
             )}
+            {targetExhausted && (
+              <span className="cwi-target-quota-badge cwi-target-quota-badge--exhausted" title={t("cws.target.quotaExhausted")}>
+                {t("cws.target.quotaExhaustedShort")}
+              </span>
+            )}
             <div className="cwi-target-actions">
               <button
                 type="button"

gui/src/components/combo-workspace-detail-panel.tsx

@@ -8,7 +8,10 @@ import {
   updateComboAliasDraft,
   validateComboDraft,
 } from "../combo-workspace-data";
-import { IconChevron, IconTrash } from "../icons";
+import {
+  isProviderExhausted,
+} from "../combo-workspace-data";
+import { IconAlert, IconChevron, IconTrash } from "../icons";
 import { useT } from "../i18n/shared";
 import { Notice } from "../ui";
 import type { ModelOption, ProviderOption } from "./combo-workspace-types";
@@ -40,6 +43,7 @@ export function DetailPanel({
   onRequestRemove,
   onSave,
   onDirtyChange,
+  exhaustedProviders,
 }: {
   baseline: ComboItem;
   isCreate?: boolean;
@@ -55,6 +59,8 @@ export function DetailPanel({
   onRequestRemove?: () => void;
   onSave: (item: ComboItem, isCreate: boolean, renameFrom?: string) => Promise<{ ok: boolean; error?: string }>;
   onDirtyChange: (dirty: boolean) => void;
+  /** Provider names whose quota is fully exhausted (0 credits remaining). */
+  exhaustedProviders?: ReadonlySet<string>;
 }) {
   const t = useT();
   const [tab, setTab] = useState<DetailTab>("config");
@@ -81,6 +87,10 @@ export function DetailPanel({
   const [msg, setMsg] = useState<{ ok: boolean; text: string } | null>(null);
   const [copied, setCopied] = useState(false);
   const dirty = !draftEquals(draft, baseline);
+  const allTargetsExhausted = exhaustedProviders !== undefined
+    && exhaustedProviders.size > 0
+    && draft.targets.length > 0
+    && draft.targets.every((target) => target.provider.trim() && isProviderExhausted(target.provider, exhaustedProviders));
   const baselineSyncKey = `${baseline.id}:${baseline.alias ?? ""}:${baseline.nativeAlias}:${baseline.displayName ?? ""}:${baseline.strategy}:${baseline.stickyLimit}:${baseline.defaultEffort}:${baseline.targets.map((t) => `${t.provider}/${t.model}:${t.weight ?? 1}`).join(",")}`;
   const effortMap = useMemo(() => {
     const map = new Map<string, string[] | undefined>();
@@ -194,6 +204,13 @@ export function DetailPanel({
 
       {msg && <Notice tone={msg.ok ? "ok" : "err"}>{msg.text}</Notice>}
 
+      {allTargetsExhausted && (
+        <div className="cwi-exhausted-banner" role="alert">
+          <IconAlert width={14} height={14} aria-hidden="true" />
+          <span>{t("cws.allTargetsExhausted")}</span>
+        </div>
+      )}
+
       {/*
         Pills, not an underline row. Combos is a tab of the Models page now, so an
         underline strip here would sit directly under the page strip — two rows of the
@@ -350,6 +367,7 @@ export function DetailPanel({
                 providers={providers}
                 models={models}
                 onChange={(targets) => updateDraft((d) => ({ ...d, targets }))}
+                exhaustedProviders={exhaustedProviders}
               />
               <p className="muted" style={{ fontSize: 12, margin: "8px 0 0" }}>
                 {draft.strategy === "failover" ? t("cws.targets.failoverHint") : t("cws.targets.roundRobinHint")}

gui/src/components/combo-workspace-overview-panel.tsx

@@ -4,28 +4,31 @@ import { IconAlert, IconChevron, IconPlus } from "../icons";
 import { useT, type TFn } from "../i18n/shared";
 
 function attentionCopy(
-  reason: "empty-targets" | "few-targets" | "catalog-omitted",
+  reason: "empty-targets" | "few-targets" | "catalog-omitted" | "all-targets-exhausted",
   t: TFn,
 ): string {
   if (reason === "empty-targets") return t("cws.attention.empty");
   if (reason === "catalog-omitted") return t("cws.attention.catalogOmitted");
+  if (reason === "all-targets-exhausted") return t("cws.attention.allExhausted");
   return t("cws.attention.few");
 }
 
 export function OverviewPanel({
   combos,
   cataloguedComboIds,
+  exhaustedProviders,
   onSelect,
   onAdd,
 }: {
   combos: ComboItem[];
   cataloguedComboIds?: ReadonlySet<string>;
+  exhaustedProviders?: ReadonlySet<string>;
   onSelect: (id: string) => void;
   onAdd: () => void;
 }) {
   const t = useT();
   const sections = groupCombos(combos);
-  const attention = buildComboAttention(combos, { cataloguedComboIds });
+  const attentionWithQuota = buildComboAttention(combos, { cataloguedComboIds, exhaustedProviders });
 
   return (
     <div className="combos-workspace-overview">
@@ -47,11 +50,11 @@ export function OverviewPanel({
         <p className="muted" style={{ margin: 0 }}>{t("cws.howBody")}</p>
       </section>
 
-      {attention.length > 0 && (
+      {attentionWithQuota.length > 0 && (
         <section className="pwi-section" aria-label={t("cws.attentionTitle")}>
           <h3 className="pwi-section-title">{t("cws.attentionTitle")}</h3>
           <div className="cwi-attention-list">
-            {attention.map((item) => (
+            {attentionWithQuota.map((item) => (
               <button
                 key={`${item.id}:${item.reason}`}
                 type="button"

gui/src/components/combo-workspace-types.ts

@@ -21,6 +21,8 @@ export interface ComboWorkspaceProps {
   models: ModelOption[];
   /** Combo ids currently present in the live catalog (`provider === "combo"`). */
   cataloguedComboIds?: ReadonlySet<string>;
+  /** Provider names whose quota is fully exhausted (0 credits remaining). */
+  exhaustedProviders?: ReadonlySet<string>;
   loading?: boolean;
   onRefresh: () => void;
   onSave: (item: ComboItem, isCreate: boolean, renameFrom?: string) => Promise<{ ok: boolean; error?: string }>;

gui/src/i18n/de.ts

@@ -1789,6 +1789,10 @@ export const de: Record<TKey, string> = {
   "cws.attention.empty": "Keine Ziele konfiguriert",
   "cws.attention.few": "Nur ein Ziel — Failover hat kein Ersatzziel",
   "cws.attention.catalogOmitted": "Fehlt im Modellkatalog — Mitgliederfähigkeiten sind unvollständig oder inkompatibel (fehlendes Context-Window/Metadaten oder leere Modalitäts-Schnittmenge). Routing per Alias funktioniert weiterhin",
+  "cws.attention.allExhausted": "Alle Ziele haben ihr Kontingent aufgebraucht — Anfragen schlagen fehl",
+  "cws.target.quotaExhausted": "Dieser Anbieter hat sein Kontingent aufgebraucht (0 Guthaben übrig)",
+  "cws.target.quotaExhaustedShort": "0 Guthaben",
+  "cws.allTargetsExhausted": "Alle Ziele in diesem Combo haben ihr Kontingent aufgebraucht. Anfragen schlagen fehl, bis Guthaben aufgefüllt wird.",
   "cws.emptyTitle": "Erste Combo erstellen",
   "cws.empty.createDesc": "Virtuelles Modell benennen und zwei oder mehr Backends verketten.",
   "cws.backToAll": "Zurück zu allen Combos",

gui/src/i18n/en.ts

@@ -1829,6 +1829,10 @@ export const en = {
   "cws.attention.empty": "No targets configured",
   "cws.attention.few": "Only one target — failover has nowhere to hop",
   "cws.attention.catalogOmitted": "Missing from the model catalog — member capabilities are incomplete or incompatible (missing context window / metadata, or empty modality intersection). Routing by alias still works",
+  "cws.attention.allExhausted": "All targets have exhausted their quota — requests will fail closed",
+  "cws.target.quotaExhausted": "This provider has exhausted its quota (0 credits remaining)",
+  "cws.target.quotaExhaustedShort": "0 credits",
+  "cws.allTargetsExhausted": "All targets in this combo have exhausted their quota. Requests will fail closed until credits are replenished.",
   "cws.emptyTitle": "Create your first combo",
   "cws.empty.createDesc": "Name a virtual model and chain two or more backends.",
   "cws.backToAll": "Back to all combos",

gui/src/i18n/ja.ts

@@ -1856,6 +1856,10 @@ export const ja: Record<TKey, string> = {
   "cws.attention.empty": "ターゲットが設定されていません",
   "cws.attention.few": "ターゲットが 1 つだけ — フェイルオーバーのホップ先がありません",
   "cws.attention.catalogOmitted": "モデルカタログにありません — メンバー能力が不完全または非互換です（context window / メタデータ不足、または modality 交差が空）。エイリアス指定のルーティングは動作します",
+  "cws.attention.allExhausted": "全ターゲットのクォータが枯渇しています — リクエストは失敗します",
+  "cws.target.quotaExhausted": "このプロバイダーのクォータが枯渇しています（残高 0）",
+  "cws.target.quotaExhaustedShort": "残高 0",
+  "cws.allTargetsExhausted": "このコンボの全ターゲットのクォータが枯渇しています。クレジットが補充されるまでリクエストは失敗します。",
   "cws.emptyTitle": "最初のコンボを作成",
   "cws.empty.createDesc": "仮想モデルに名前を付け、2 つ以上のバックエンドをつなぎます。",
   "cws.backToAll": "すべてのコンボに戻る",

gui/src/i18n/ko.ts

@@ -1816,6 +1816,10 @@ export const ko: Record<TKey, string> = {
   "cws.attention.empty": "구성된 대상 없음",
   "cws.attention.few": "대상이 하나뿐 — 장애 조치할 곳이 없음",
   "cws.attention.catalogOmitted": "모델 카탈로그에 없음 — 멤버 능력이 불완전하거나 호환되지 않음(context window/메타데이터 부족 또는 modality 교집합이 비어 있음). 별칭 라우팅은 계속 동작",
+  "cws.attention.allExhausted": "모든 대상의 크레딧이 소진됨 — 요청이 실패 처리됩니다",
+  "cws.target.quotaExhausted": "이 제공업체의 크레딧이 소진되었습니다 (잔여 0)",
+  "cws.target.quotaExhaustedShort": "크레딧 0",
+  "cws.allTargetsExhausted": "이 콤보의 모든 대상 크레딧이 소진되었습니다. 크레딧이 보충될 때까지 요청은 실패 처리됩니다.",
   "cws.emptyTitle": "첫 콤보 만들기",
   "cws.empty.createDesc": "가상 모델 이름을 정하고 백엔드를 둘 이상 연결하세요.",
   "cws.backToAll": "모든 콤보로",

gui/src/i18n/ru.ts

@@ -1899,6 +1899,10 @@ export const ru: Record<TKey, string> = {
   "cws.attention.empty": "Цели не настроены",
   "cws.attention.few": "Только одна цель — failover некуда переключаться",
   "cws.attention.catalogOmitted": "Отсутствует в каталоге моделей — возможности участников неполны или несовместимы (нет context window / метаданных, или пустое пересечение modalities). Маршрутизация по alias всё ещё работает",
+  "cws.attention.allExhausted": "Все цели исчерпали свою квоту — запросы будут отклонены",
+  "cws.target.quotaExhausted": "Квота этого провайдера исчерпана (осталось 0 кредитов)",
+  "cws.target.quotaExhaustedShort": "0 кредитов",
+  "cws.allTargetsExhausted": "Все цели в этом комбо исчерпали свою квоту. Запросы будут отклонены до пополнения кредитов.",
   "cws.emptyTitle": "Создайте первое комбо",
   "cws.empty.createDesc": "Задайте имя виртуальной модели и объедините в цепочку два и более бэкенда.",
   "cws.backToAll": "Назад ко всем комбо",

gui/src/i18n/tr.ts

@@ -1819,6 +1819,10 @@ export const tr: Record<TKey, string> = {
   "cws.attention.empty": "Yapılandırılmış hedef yok",
   "cws.attention.few": "Yalnızca bir hedef — geçiş yapılacak yer yok",
   "cws.attention.catalogOmitted": "Model kataloğunda eksik — üye yetenekleri eksik veya uyumsuz (eksik bağlam penceresi / meta veri veya boş modalite kesişimi). Takma ada göre yönlendirme hâlâ çalışır",
+  "cws.attention.allExhausted": "Tüm hedeflerin kotası tükendi — istekler başarısız olacak",
+  "cws.target.quotaExhausted": "Bu sağlayıcının kotası tükendi (0 kredi kaldı)",
+  "cws.target.quotaExhaustedShort": "0 kredi",
+  "cws.allTargetsExhausted": "Bu kombodaki tüm hedeflerin kotası tükendi. Krediler yenilenene kadar istekler başarısız olacak.",
   "cws.emptyTitle": "İlk kombonuzu oluşturun",
   "cws.empty.createDesc": "Sanal bir model adlandırın ve iki veya daha fazla arka ucu bağlayın.",
   "cws.backToAll": "Tüm kombolara dön",

gui/src/i18n/zh-TW.ts

@@ -1360,6 +1360,10 @@ export const zhTW: Record<TKey, string> = {
   "cws.attention.empty": "未配置目標",
   "cws.attention.few": "只有一個目標 — 容錯移轉無處可跳",
   "cws.attention.catalogOmitted": "未出現在模型目錄中 — 成員能力不完整或不相容（缺少上下文視窗／中繼資料，或模態交集為空）。依別名路由仍可用",
+  "cws.attention.allExhausted": "所有目標的配額已耗盡 — 請求將以失敗結束",
+  "cws.target.quotaExhausted": "此供應商的配額已耗盡（剩餘額度為 0）",
+  "cws.target.quotaExhaustedShort": "0 額度",
+  "cws.allTargetsExhausted": "此組合中所有目標的配額已耗盡。在額度補充之前，請求將以失敗結束。",
   "cws.emptyTitle": "建立第一個組合",
   "cws.empty.createDesc": "命名虛擬模型並串聯兩個或多個後端。",
   "cws.backToAll": "返回全部組合",

gui/src/i18n/zh.ts

@@ -1809,6 +1809,10 @@ export const zh: Record<TKey, string> = {
   "cws.attention.empty": "未配置目标",
   "cws.attention.few": "只有一个目标 — 故障转移无处可跳",
   "cws.attention.catalogOmitted": "未出现在模型目录中 — 成员能力不完整或不兼容（缺少上下文窗口/元数据，或模态交集为空）。按别名路由仍可用",
+  "cws.attention.allExhausted": "所有目标的配额已耗尽 — 请求将以失败结束",
+  "cws.target.quotaExhausted": "此供应商的配额已耗尽（剩余额度为 0）",
+  "cws.target.quotaExhaustedShort": "0 额度",
+  "cws.allTargetsExhausted": "此组合中所有目标的配额已耗尽。在额度补充之前，请求将以失败结束。",
   "cws.emptyTitle": "创建第一个组合",
   "cws.empty.createDesc": "命名虚拟模型并串联两个或多个后端。",
   "cws.backToAll": "返回全部组合",