feat(grok): читать настоящую квоту из биллинга вместо «Н/Д»

Владелец спросил, где кончились лимиты, и показал экран: еженедельный
лимит SuperGrok израсходован на 14%, запас есть. А вызовы через Hub
падали с 402 «out of credits».

Разгадка — два разных кошелька. Подписка SuperGrok покрывает чат
grok.com, а программный доступ списывается с кредитов API. Проверено на
живом аккаунте: prepaidBalance 0, onDemandCap 0. Именно поэтому 402, и
подписка тут не помогает.

Адрес биллинга взят из плагина hermes-grok-usage, который владелец уже
использует: cli-chat-proxy.grok.com/v1/billing принимает ТОТ ЖЕ
OAuth-токен, что и авторизация. Проверено запросом — 200 и данные.

_collect_grok_quota раньше строила пустые корзины и никуда не ходила,
поэтому Hub показывал «Н/Д» и объяснить ничего не мог. Теперь читает
предоплаченный баланс и лимит по мере использования, а при нулевом
балансе пишет причину прямым текстом, включая различие кошельков.

Процент считается только когда есть от чего считать: при нулевом лимите
доля не определена, и подставлять ноль процентов нельзя — показываются
абсолютные значения.

Тесты: 422 passed, ruff чисто.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/antigravity_provider/router/quota_collector.py

@@ -744,64 +744,105 @@ class AccountQuotaService:
         )
 
     def _collect_grok_quota(self, profile_id: str, auth_data: dict) -> QuotaSnapshot:
-        """Collect Weekly, GrokChat, GrokBuild, and Task limits for Grok (xAI)."""
+        """Прочитать настоящий баланс аккаунта Grok.
+
+        Раньше здесь строились пустые корзины и запрос никуда не уходил —
+        поэтому квота Grok всегда показывалась как «Н/Д».
+
+        Адрес взят из плагина hermes-grok-usage, который владелец уже
+        использует: тот же OAuth-токен, что и для авторизации, принимается
+        биллинговым эндпоинтом grok.com. Именно оттуда берут данные и
+        Grok Build, и /usage.
+
+        Важно: подписка SuperGrok и кредиты API — РАЗНЫЕ кошельки. Вызовы
+        через Hub списываются со второго, и именно его показывает этот ответ.
+        """
         now = _utc_now()
-        b_weekly = QuotaBucket(
+        token = None
-            id="grok.weekly",
+        tokens = auth_data.get("token") or auth_data.get("tokens") or {}
-            display_name="Недельное",
+        if isinstance(tokens, dict):
+            token = tokens.get("access_token")
+        token = token or auth_data.get("access_token") or auth_data.get("api_key")
+        if not token:
+            raise RuntimeError("В профиле Grok отсутствует access token")
+
+        request = urllib.request.Request(
+            "https://cli-chat-proxy.grok.com/v1/billing?format=credits",
+            headers={"Authorization": f"Bearer {token}"},
+        )
+        with urllib.request.urlopen(request, timeout=20) as response:
+            payload = json.loads(response.read().decode("utf-8") or "{}")
+
+        config = payload.get("config") if isinstance(payload, dict) else None
+        if not isinstance(config, dict):
+            raise RuntimeError("Grok вернул биллинг в неожиданном формате")
+
+        def _val(node: Any) -> Optional[float]:
+            if isinstance(node, dict):
+                raw = node.get("val")
+                return float(raw) if isinstance(raw, (int, float)) else None
+            return float(node) if isinstance(node, (int, float)) else None
+
+        prepaid = _val(config.get("prepaidBalance"))
+        cap = _val(config.get("onDemandCap"))
+        used = _val(config.get("onDemandUsed"))
+
+        period_end = _parse_datetime((config.get("currentPeriod") or {}).get("end"))
+
+        buckets: List[QuotaBucket] = []
+
+        # Процент считаем ТОЛЬКО когда есть от чего считать. При нулевом
+        # лимите доля не определена — показываем абсолютные значения, а не
+        # выдуманный ноль процентов.
+        remaining_pct: Optional[float] = None
+        used_pct: Optional[float] = None
+        if cap and cap > 0 and used is not None:
+            used_pct = max(0.0, min(100.0, used / cap * 100.0))
+            remaining_pct = 100.0 - used_pct
+
+        buckets.append(
+            QuotaBucket(
+                id="grok.on_demand",
+                display_name="Кредиты по мере использования",
                 model_family="grok",
-            used_percent=None,
+                used_percent=used_pct,
-            remaining_percent=None,
+                remaining_percent=remaining_pct,
+                used_absolute=int(used) if used is not None else None,
+                limit_absolute=int(cap) if cap is not None else None,
+                reset_at=period_end,
                 period="7d",
-            reset_at=None,
+                unit="currency",
-            status="unknown",
+                scope="account",
+                status="exhausted" if (cap == 0 or (remaining_pct is not None and remaining_pct <= 0)) else "healthy",
             )
-        b_chat = QuotaBucket(
-            id="grok.chat",
-            display_name="GrokChat",
-            model_family="grok",
-            used_percent=None,
-            remaining_percent=None,
-            reset_at=None,
-            status="unknown",
         )
-        b_build = QuotaBucket(
+        buckets.append(
-            id="grok.build",
+            QuotaBucket(
-            display_name="GrokBuild",
+                id="grok.prepaid",
+                display_name="Предоплаченный баланс",
                 model_family="grok",
-            used_percent=None,
+                remaining_absolute=int(prepaid) if prepaid is not None else None,
-            remaining_percent=None,
+                unit="currency",
-            reset_at=None,
+                scope="account",
-            status="unknown",
+                status="exhausted" if prepaid == 0 else "healthy",
             )
-        b_frequent = QuotaBucket(
-            id="grok.frequent_tasks",
-            display_name="Частые задачи",
-            model_family="grok",
-            used_absolute=None,
-            remaining_absolute=None,
-            limit_absolute=10,
-            reset_at=None,
-            status="unknown",
         )
-        b_normal = QuotaBucket(
+
-            id="grok.normal_tasks",
+        reason = None
-            display_name="Обычные задачи",
+        if not prepaid and not cap:
-            model_family="grok",
+            reason = (
-            used_absolute=None,
+                "Кредиты API исчерпаны: предоплаченный баланс и лимит по мере "
-            remaining_absolute=None,
+                "использования равны нулю. Подписка SuperGrok их не пополняет — "
-            limit_absolute=30,
+                "это отдельный кошелёк."
-            reset_at=None,
-            status="unknown",
             )
 
         return QuotaSnapshot(
             account_id=profile_id,
             provider="grok",
-            buckets=[b_weekly, b_chat, b_build, b_frequent, b_normal],
+            buckets=buckets,
             fetched_at=now,
-            source="baseline",
+            source="provider_api",
-            unavailable_reason="Grok не предоставляет остаток через публичный API",
+            unavailable_reason=reason,
         )
 
     def _collect_local_quota(self, profile_id: str, auth_data: dict) -> QuotaSnapshot:

tests/test_grok_quota.py

@@ -0,0 +1,73 @@
+"""Квота Grok читается у провайдера, а не показывается как «Н/Д».
+
+Владелец спросил: «где закончились лимиты?» — и показал экран, где
+еженедельный лимит SuperGrok израсходован на 14%. Но вызовы через Hub
+падали с 402.
+
+Разгадка: это ДВА РАЗНЫХ кошелька. Подписка SuperGrok покрывает чат
+grok.com, а программный доступ списывается с кредитов API. Их у аккаунта
+ноль — подтверждено биллинговым эндпоинтом.
+
+Раньше _collect_grok_quota строила пустые корзины и никуда не ходила,
+поэтому Hub показывал «Н/Д» и объяснить ничего не мог.
+"""
+
+from __future__ import annotations
+
+import json
+from unittest.mock import MagicMock, patch
+
+from antigravity_provider.router.quota_collector import AccountQuotaService
+
+
+def _billing(prepaid: float, cap: float, used: float) -> MagicMock:
+    payload = {
+        "config": {
+            "currentPeriod": {"start": "2026-08-19T00:00:00+00:00", "end": "2026-08-26T00:00:00+00:00"},
+            "prepaidBalance": {"val": prepaid},
+            "onDemandCap": {"val": cap},
+            "onDemandUsed": {"val": used},
+        }
+    }
+    resp = MagicMock()
+    resp.__enter__.return_value.read.return_value = json.dumps(payload).encode("utf-8")
+    return resp
+
+
+def _auth() -> dict:
+    return {"token": {"access_token": "tok"}}
+
+
+def test_exhausted_account_explains_two_wallets():
+    """Нулевой баланс объясняется, а не показывается прочерком."""
+    with patch("antigravity_provider.router.quota_collector.urllib.request.urlopen",
+               return_value=_billing(0, 0, 0)):
+        snap = AccountQuotaService()._collect_grok_quota("grok-orch", _auth())
+
+    assert snap.source == "provider_api"
+    assert "SuperGrok" in (snap.unavailable_reason or ""), "не объяснено, что это разные кошельки"
+    assert all(b.status == "exhausted" for b in snap.buckets)
+
+
+def test_zero_cap_does_not_fabricate_percent():
+    """При нулевом лимите доля не определена — процент выдумывать нельзя."""
+    with patch("antigravity_provider.router.quota_collector.urllib.request.urlopen",
+               return_value=_billing(0, 0, 0)):
+        snap = AccountQuotaService()._collect_grok_quota("grok-orch", _auth())
+
+    on_demand = next(b for b in snap.buckets if b.id == "grok.on_demand")
+    assert on_demand.remaining_percent is None
+    assert on_demand.used_percent is None
+    assert on_demand.limit_absolute == 0
+
+
+def test_account_with_credits_reports_real_percent():
+    """Когда лимит есть, доля считается по измеренным значениям."""
+    with patch("antigravity_provider.router.quota_collector.urllib.request.urlopen",
+               return_value=_billing(50, 200, 50)):
+        snap = AccountQuotaService()._collect_grok_quota("grok-orch", _auth())
+
+    on_demand = next(b for b in snap.buckets if b.id == "grok.on_demand")
+    assert on_demand.used_percent == 25.0
+    assert on_demand.remaining_percent == 75.0
+    assert snap.unavailable_reason is None