@slkiser/opencode-quota 3.11.1 → 4.0.0

package/dist/lib/quota-status.js

@@ -1,4 +1,4 @@
-import { stat } from "fs/promises";
+import { readFile, stat } from "fs/promises";
 import { getAuthPath, getAuthPaths, readAuthFileCached } from "./opencode-auth.js";
 import { getOpencodeRuntimeDirs } from "./opencode-runtime-paths.js";
 import { getGoogleTokenCachePath } from "./google-token-cache.js";
@@ -14,7 +14,7 @@ import { getNanoGptKeyDiagnostics, queryNanoGptQuota } from "./nanogpt.js";
 import { getDeepSeekKeyDiagnostics } from "./deepseek.js";
 import { getSyntheticKeyDiagnostics } from "./synthetic.js";
 import { getCopilotQuotaAuthDiagnostics } from "./copilot.js";
-import { computeAlibabaCodingPlanQuota, computeQwenQuota, getAlibabaCodingPlanQuotaPath, getQwenLocalQuotaPath, readAlibabaCodingPlanQuotaState, readQwenLocalQuotaState, } from "./qwen-local-quota.js";
+import { ALIBABA_CODING_PLAN_STATE_VERSION, QWEN_LOCAL_QUOTA_STATE_VERSION, getAlibabaCodingPlanQuotaPath, getQwenLocalQuotaPath, } from "./qwen-local-quota.js";
 import { DEFAULT_ALIBABA_AUTH_CACHE_MAX_AGE_MS, getAlibabaCodingPlanAuthDiagnostics, resolveAlibabaCodingPlanAuthCached, } from "./alibaba-auth.js";
 import { hasQwenOAuthAuth, resolveQwenLocalPlan } from "./qwen-auth.js";
 import { resolveOpenAIOAuth } from "./openai.js";
@@ -38,6 +38,8 @@ import { sanitizeSingleLineDisplaySnippet, sanitizeSingleLineDisplayText, saniti
 import { QUOTA_TOAST_SETTING_SOURCE_KEYS, } from "./config.js";
 import { getCursorPlanDisplayName, getEffectiveCursorIncludedApiUsd } from "./cursor-pricing.js";
 import { getQuotaProviderDisplayLabel } from "./provider-metadata.js";
+import { isMaintainedQuotaProviderTuning } from "./quota-providers.js";
+import { inspectLocalQuotaProviderState } from "./quota-providers-local.js";
 import { isValueEntry } from "./entries.js";
 import { queryMiniMaxQuota } from "../providers/minimax-coding-plan.js";
 import { queryZaiQuota } from "./zai.js";
@@ -53,6 +55,37 @@ async function pathExists(path) {
         return false;
     }
 }
+async function inspectGeneratedCounterFile(path, expectedVersion) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        const record = parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : null;
+        const version = typeof record?.version === "number" ? record.version : null;
+        const updatedAt = typeof record?.updatedAt === "number" && Number.isFinite(record.updatedAt)
+            ? record.updatedAt
+            : null;
+        return {
+            exists: true,
+            health: !record || version === null || updatedAt === null
+                ? "malformed"
+                : version === expectedVersion
+                    ? "healthy"
+                    : "version_mismatch",
+            version,
+            lastUpdatedAt: updatedAt,
+        };
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            String(error.code) === "ENOENT") {
+            return { exists: false, health: "missing", version: null, lastUpdatedAt: null };
+        }
+        return { exists: true, health: "malformed", version: null, lastUpdatedAt: null };
+    }
+}
 function fmtInt(n) {
     return Math.trunc(n).toLocaleString("en-US");
 }
@@ -78,7 +111,9 @@ function isDefaultOpenCodeGoStatusWindowSelection(windows) {
         OPENCODE_GO_STATUS_WINDOW_ORDER.every((window) => selected.has(window)));
 }
 function formatOpenCodeGoMissingWindows(windows) {
-    return windows.map((window) => `${window} (${OPENCODE_GO_STATUS_WINDOW_FIELDS[window]})`).join(", ");
+    return windows
+        .map((window) => `${window} (${OPENCODE_GO_STATUS_WINDOW_FIELDS[window]})`)
+        .join(", ");
 }
 function formatOpenCodeGoUsage(window) {
     return `percent_used=${window.usagePercent} percent_remaining=${window.percentRemaining} reset_in_sec=${window.resetInSec} reset_at=${window.resetTimeIso}`;
@@ -148,6 +183,17 @@ function isRedundantLiveProbeDescriptor(providerId, value) {
 function findProviderLiveProbe(providerId, probes) {
     return probes?.find((probe) => probe.providerId === providerId);
 }
+function getLiveProbeState(probe) {
+    if (!probe)
+        return "unavailable";
+    if (probe.result.entries.length > 0 && probe.result.errors.length > 0)
+        return "partial";
+    if (probe.result.entries.length > 0)
+        return "success";
+    if (probe.result.errors.length > 0)
+        return "error";
+    return "no_data";
+}
 function appendProviderCompactLiveProbeRows(rows, providerId, probes) {
     appendCompactLiveProbeRows(rows, providerId, findProviderLiveProbe(providerId, probes));
 }
@@ -203,13 +249,113 @@ function formatCompactLiveProbeError(providerId, error) {
     const message = sanitizeSingleLineDisplayText(error.message);
     return sanitizeSingleLineDisplaySnippet(label ? `${label}: ${message}` : message, STATUS_LIVE_ROW_MAX_LENGTH);
 }
+function getQuotaProviderCredentialCategory(source) {
+    switch (source) {
+        case "explicit_env":
+            return "environment";
+        case "global_opencode_json":
+        case "global_opencode_jsonc":
+            return "trusted_global_config";
+        case "auth_json":
+            return "auth_json";
+        default:
+            return "none";
+    }
+}
+async function createQuotaProvidersSection(params) {
+    if (params.definitions.length === 0)
+        return null;
+    const diagnostics = findProviderLiveProbe("quota-providers", params.probes)?.result.diagnostics ?? [];
+    const diagnosticsBySource = new Map(diagnostics.map((diagnostic) => [diagnostic.sourceId, diagnostic]));
+    const rows = [];
+    for (const definition of params.definitions) {
+        const diagnostic = diagnosticsBySource.get(definition.id);
+        const coverage = definition.modelIds ? definition.modelIds.join(",") : "all_models";
+        if (definition.mode === "local-estimate" && isMaintainedQuotaProviderTuning(definition)) {
+            const maintained = definition.id === "qwen-code"
+                ? {
+                    path: getQwenLocalQuotaPath(),
+                    version: QWEN_LOCAL_QUOTA_STATE_VERSION,
+                }
+                : {
+                    path: getAlibabaCodingPlanQuotaPath(),
+                    version: ALIBABA_CODING_PLAN_STATE_VERSION,
+                };
+            const state = await inspectGeneratedCounterFile(maintained.path, maintained.version);
+            const probe = findProviderLiveProbe(definition.id, params.probes);
+            rows.push({
+                key: `provider_${definition.id}`,
+                value: [
+                    `provider_id=${definition.providerId}`,
+                    "mode=local-estimate",
+                    `coverage=${coverage}`,
+                    `outcome=${getLiveProbeState(probe)}`,
+                    `limits=${definition.windows.map((window) => `${window.id}:${window.requestLimit}`).join(",")}`,
+                    `state_path=${maintained.path}`,
+                    `state_exists=${state.exists ? "true" : "false"}`,
+                    `state_health=${state.health}`,
+                    `state_version=${state.version ?? "(none)"}`,
+                    `state_last_update=${state.lastUpdatedAt === null ? "(none)" : new Date(state.lastUpdatedAt).toISOString()}`,
+                ]
+                    .map((part) => sanitizeSingleLineDisplayText(part))
+                    .join(" "),
+            });
+            continue;
+        }
+        if (definition.mode === "local-estimate") {
+            const state = await inspectLocalQuotaProviderState(definition);
+            rows.push({
+                key: `provider_${definition.id}`,
+                value: [
+                    `provider_id=${definition.providerId}`,
+                    "mode=local-estimate",
+                    `coverage=${coverage}`,
+                    `outcome=${diagnostic?.outcome ?? "unavailable"}`,
+                    `state_path=${state.path}`,
+                    `state_exists=${state.exists ? "true" : "false"}`,
+                    `state_health=${state.health}`,
+                    `state_version=${state.version ?? "(none)"}`,
+                    `state_last_update=${state.lastUpdatedAt === null ? "(none)" : new Date(state.lastUpdatedAt).toISOString()}`,
+                ]
+                    .map((part) => sanitizeSingleLineDisplayText(part))
+                    .join(" "),
+            });
+            continue;
+        }
+        const checkedPaths = diagnostic
+            ? [...new Set([...diagnostic.checkedPaths, ...diagnostic.authPaths])]
+            : [];
+        rows.push({
+            key: `provider_${definition.id}`,
+            value: [
+                `provider_id=${definition.providerId}`,
+                "mode=remote-api",
+                `format=${definition.format}`,
+                `coverage=${coverage}`,
+                `outcome=${diagnostic?.outcome ?? "unavailable"}`,
+                `credential_category=${getQuotaProviderCredentialCategory(diagnostic?.credentialSource ?? null)}`,
+                `env_name=${definition.apiKeyEnv ?? "(none)"}`,
+                `checked_paths=${checkedPaths.length > 0 ? checkedPaths.join(" | ") : "(none)"}`,
+            ]
+                .map((part) => sanitizeSingleLineDisplayText(part))
+                .join(" "),
+        });
+    }
+    return createKvSection("quota_providers", "quota_providers:", rows);
+}
 function appendCompactLiveProbeRows(rows, providerId, probe) {
     if (!probe)
         return;
     const result = sanitizeQuotaProviderResult(probe.result);
     const entryCount = Math.min(result.entries.length, STATUS_LIVE_ENTRY_LIMIT);
     const errorCount = Math.min(result.errors.length, STATUS_LIVE_ERROR_LIMIT);
-    const state = result.entries.length > 0 ? "success" : result.errors.length > 0 ? "error" : "no_data";
+    const state = result.entries.length > 0 && result.errors.length > 0
+        ? "partial"
+        : result.entries.length > 0
+            ? "success"
+            : result.errors.length > 0
+                ? "error"
+                : "no_data";
     rows.push({ key: "live_probe", value: state });
     for (let index = 0; index < entryCount; index += 1) {
         rows.push({
@@ -223,7 +369,8 @@ function appendCompactLiveProbeRows(rows, providerId, probe) {
             value: formatCompactLiveProbeError(providerId, result.errors[index]),
         });
     }
-    const suppressedCount = Math.max(0, result.entries.length - entryCount) + Math.max(0, result.errors.length - errorCount);
+    const suppressedCount = Math.max(0, result.entries.length - entryCount) +
+        Math.max(0, result.errors.length - errorCount);
     if (suppressedCount > 0) {
         rows.push({
             key: "live_more",
@@ -452,6 +599,13 @@ export async function buildQuotaStatusReport(params) {
         toastLines.push(`  - ${p.id}: ${bits.join(" ")}`);
     }
     sections.push(createLinesSection("toast", "toast:", toastLines));
+    const quotaProvidersSection = await createQuotaProvidersSection({
+        definitions: params.quotaProviders ?? [],
+        probes: params.providerLiveProbes,
+    });
+    if (quotaProvidersSection) {
+        sections.push(quotaProvidersSection);
+    }
     if (params.maintainerAnnouncements) {
         const announcements = params.maintainerAnnouncements;
         const summary = announcements.summary;
@@ -493,13 +647,16 @@ export async function buildQuotaStatusReport(params) {
     const openaiAuth = resolveOpenAIOAuth(authData);
     const alibabaAuthDiagnostics = await getAlibabaCodingPlanAuthDiagnostics({
         maxAgeMs: DEFAULT_ALIBABA_AUTH_CACHE_MAX_AGE_MS,
-        fallbackTier: params.alibabaCodingPlanTier,
+        fallbackTier: "lite",
     });
     const alibabaCodingPlanAuth = await resolveAlibabaCodingPlanAuthCached({
         maxAgeMs: DEFAULT_ALIBABA_AUTH_CACHE_MAX_AGE_MS,
-        fallbackTier: params.alibabaCodingPlanTier,
+        fallbackTier: "lite",
+    });
+    pathsRows.push({
+        key: "qwen oauth auth configured",
+        value: qwenAuthConfigured ? "true" : "false",
     });
-    pathsRows.push({ key: "qwen oauth auth configured", value: qwenAuthConfigured ? "true" : "false" });
     pathsRows.push({
         key: "qwen_oauth_source",
         value: qwenLocalPlan.state === "qwen_free" ? qwenLocalPlan.sourceKey : "(none)",
@@ -512,7 +669,10 @@ export async function buildQuotaStatusReport(params) {
         key: "alibaba auth configured",
         value: alibabaAuthDiagnostics.state === "none" ? "false" : "true",
     });
-    pathsRows.push({ key: "alibaba_api_key_source", value: alibabaAuthDiagnostics.source ?? "(none)" });
+    pathsRows.push({
+        key: "alibaba_api_key_source",
+        value: alibabaAuthDiagnostics.source ?? "(none)",
+    });
     pathsRows.push({
         key: "alibaba_api_key_checked_paths",
         value: joinOrNone(alibabaAuthDiagnostics.checkedPaths),
@@ -521,10 +681,6 @@ export async function buildQuotaStatusReport(params) {
         key: "alibaba_api_key_auth_paths",
         value: joinOrNone(alibabaAuthDiagnostics.authPaths),
     });
-    pathsRows.push({
-        key: "alibaba coding plan fallback tier",
-        value: params.alibabaCodingPlanTier,
-    });
     pathsRows.push({
         key: "alibaba_coding_plan",
         value: alibabaAuthDiagnostics.state === "configured"
@@ -651,14 +807,20 @@ export async function buildQuotaStatusReport(params) {
     if (cursorAuth.error) {
         cursorRows.push({ key: "auth_error", value: cursorAuth.error });
     }
-    cursorRows.push({ key: "plugin_enabled", value: cursorIntegration.pluginEnabled ? "true" : "false" });
+    cursorRows.push({
+        key: "plugin_enabled",
+        value: cursorIntegration.pluginEnabled ? "true" : "false",
+    });
     cursorRows.push({ key: "canonical_plugin_package", value: CURSOR_CANONICAL_PLUGIN_PACKAGE });
     cursorRows.push({
         key: "provider_configured",
         value: cursorIntegration.providerConfigured ? "true" : "false",
     });
     cursorRows.push({ key: "config_matches", value: joinOrNone(cursorIntegration.matchedPaths) });
-    cursorRows.push({ key: "config_checked_paths", value: joinOrNone(cursorIntegration.checkedPaths) });
+    cursorRows.push({
+        key: "config_checked_paths",
+        value: joinOrNone(cursorIntegration.checkedPaths),
+    });
     try {
         const cursorUsage = await getCurrentCursorUsageSummary({
             billingCycleStartDay: params.cursorBillingCycleStartDay,
@@ -677,56 +839,40 @@ export async function buildQuotaStatusReport(params) {
             key: "total_cursor_usage",
             value: `${fmtUsdAmount(cursorUsage.total.costUsd)} across ${fmtInt(cursorUsage.total.messageCount)} messages`,
         });
-        cursorRows.push({ key: "unknown_cursor_models", value: fmtInt(cursorUsage.unknownModels.length) });
+        cursorRows.push({
+            key: "unknown_cursor_models",
+            value: fmtInt(cursorUsage.unknownModels.length),
+        });
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         cursorRows.push({ key: "usage_error", value: msg });
     }
     const qwenLocalQuotaPath = getQwenLocalQuotaPath();
-    const qwenLocalQuotaExists = await pathExists(qwenLocalQuotaPath);
+    const qwenCounter = await inspectGeneratedCounterFile(qwenLocalQuotaPath, QWEN_LOCAL_QUOTA_STATE_VERSION);
     cursorRows.push({
         key: "qwen free local quota",
-        value: `path=${qwenLocalQuotaPath} exists=${qwenLocalQuotaExists ? "true" : "false"}`,
+        value: [
+            `path=${qwenLocalQuotaPath}`,
+            `exists=${qwenCounter.exists ? "true" : "false"}`,
+            `health=${qwenCounter.health}`,
+            `version=${qwenCounter.version ?? "(none)"}`,
+            `last_update=${qwenCounter.lastUpdatedAt === null ? "(none)" : new Date(qwenCounter.lastUpdatedAt).toISOString()}`,
+        ].join(" "),
     });
-    try {
-        const qwenState = await readQwenLocalQuotaState();
-        const qwenQuota = computeQwenQuota({ state: qwenState });
-        const qwenUsageSuffix = qwenLocalQuotaExists ? "" : " (default state)";
-        cursorRows.push({
-            key: "qwen free local usage",
-            value: `daily=${qwenQuota.day.used}/${qwenQuota.day.limit} rpm=${qwenQuota.rpm.used}/${qwenQuota.rpm.limit}${qwenUsageSuffix}`,
-        });
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        cursorRows.push({ key: "qwen free local usage", value: `error (${msg})` });
-    }
     const alibabaLocalQuotaPath = getAlibabaCodingPlanQuotaPath();
-    const alibabaLocalQuotaExists = await pathExists(alibabaLocalQuotaPath);
+    const alibabaCounter = await inspectGeneratedCounterFile(alibabaLocalQuotaPath, ALIBABA_CODING_PLAN_STATE_VERSION);
     cursorRows.push({
         key: "alibaba coding plan local quota",
-        value: `path=${alibabaLocalQuotaPath} exists=${alibabaLocalQuotaExists ? "true" : "false"}`,
+        value: [
+            `path=${alibabaLocalQuotaPath}`,
+            `exists=${alibabaCounter.exists ? "true" : "false"}`,
+            `health=${alibabaCounter.health}`,
+            `version=${alibabaCounter.version ?? "(none)"}`,
+            `last_update=${alibabaCounter.lastUpdatedAt === null ? "(none)" : new Date(alibabaCounter.lastUpdatedAt).toISOString()}`,
+        ].join(" "),
     });
-    if (alibabaCodingPlanAuth.state === "configured") {
-        try {
-            const alibabaState = await readAlibabaCodingPlanQuotaState();
-            const alibabaQuota = computeAlibabaCodingPlanQuota({
-                state: alibabaState,
-                tier: alibabaCodingPlanAuth.tier,
-            });
-            const alibabaUsageSuffix = alibabaLocalQuotaExists ? "" : " (default state)";
-            cursorRows.push({
-                key: "alibaba coding plan usage",
-                value: `tier=${alibabaCodingPlanAuth.tier} 5h=${alibabaQuota.fiveHour.used}/${alibabaQuota.fiveHour.limit} weekly=${alibabaQuota.weekly.used}/${alibabaQuota.weekly.limit} monthly=${alibabaQuota.monthly.used}/${alibabaQuota.monthly.limit}${alibabaUsageSuffix}`,
-            });
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            cursorRows.push({ key: "alibaba coding plan usage", value: `error (${msg})` });
-        }
-    }
-    else if (alibabaCodingPlanAuth.state === "invalid") {
+    if (alibabaCodingPlanAuth.state === "invalid") {
         cursorRows.push({ key: "alibaba coding plan error", value: alibabaCodingPlanAuth.error });
     }
     appendProviderCompactLiveProbeRows(cursorRows, "cursor", params.providerLiveProbes);
@@ -881,7 +1027,10 @@ export async function buildQuotaStatusReport(params) {
     if (openCodeGoDiag.error) {
         openCodeGoRows.push({ key: "config_error", value: sanitizeDisplayText(openCodeGoDiag.error) });
     }
-    openCodeGoRows.push({ key: "config_checked_paths", value: joinOrNone(openCodeGoDiag.checkedPaths) });
+    openCodeGoRows.push({
+        key: "config_checked_paths",
+        value: joinOrNone(openCodeGoDiag.checkedPaths),
+    });
     const openCodeGoSelectedWindows = params.opencodeGoWindows ?? OPENCODE_GO_STATUS_WINDOW_ORDER;
     openCodeGoRows.push({
         key: "selected_windows",
@@ -947,7 +1096,10 @@ export async function buildQuotaStatusReport(params) {
     if (zaiAuth.state === "configured") {
         const zaiQuota = await queryZaiQuota();
         if (!zaiQuota) {
-            zaiRows.push({ key: "live_fetch_error", value: "Z.ai API key became unavailable before fetch" });
+            zaiRows.push({
+                key: "live_fetch_error",
+                value: "Z.ai API key became unavailable before fetch",
+            });
         }
         else if (!zaiQuota.success) {
             zaiRows.push({ key: "live_fetch_error", value: zaiQuota.error });
@@ -997,7 +1149,10 @@ export async function buildQuotaStatusReport(params) {
     if (zhipuAuth.state === "configured") {
         const zhipuQuota = await queryZhipuQuota();
         if (!zhipuQuota) {
-            zhipuRows.push({ key: "live_fetch_error", value: "Zhipu API key became unavailable before fetch" });
+            zhipuRows.push({
+                key: "live_fetch_error",
+                value: "Zhipu API key became unavailable before fetch",
+            });
         }
         else if (!zhipuQuota.success) {
             zhipuRows.push({ key: "live_fetch_error", value: zhipuQuota.error });
@@ -1106,7 +1261,10 @@ export async function buildQuotaStatusReport(params) {
                         value: nanoGptQuota.subscription.currentPeriodEndIso ?? "(none)",
                     });
                     if (nanoGptQuota.subscription.graceUntilIso) {
-                        nanoGptRows.push({ key: "grace_until", value: nanoGptQuota.subscription.graceUntilIso });
+                        nanoGptRows.push({
+                            key: "grace_until",
+                            value: nanoGptQuota.subscription.graceUntilIso,
+                        });
                     }
                 }
                 nanoGptRows.push({
@@ -1115,7 +1273,10 @@ export async function buildQuotaStatusReport(params) {
                         ? fmtUsdAmount(nanoGptQuota.balance.usdBalance)
                         : "(none)",
                 });
-                nanoGptRows.push({ key: "balance_nano", value: nanoGptQuota.balance?.nanoBalanceRaw ?? "(none)" });
+                nanoGptRows.push({
+                    key: "balance_nano",
+                    value: nanoGptQuota.balance?.nanoBalanceRaw ?? "(none)",
+                });
                 for (const entry of nanoGptQuota.endpointErrors ?? []) {
                     nanoGptRows.push({ key: `live_error_${entry.endpoint}`, value: entry.message });
                 }
@@ -1140,6 +1301,9 @@ export async function buildQuotaStatusReport(params) {
     if (copilotDiag.pat.config?.tier) {
         copilotRows.push({ key: "pat_tier", value: copilotDiag.pat.config.tier });
     }
+    if (copilotDiag.billingModel) {
+        copilotRows.push({ key: "billing_model", value: copilotDiag.billingModel });
+    }
     if (copilotDiag.pat.config?.organization) {
         copilotRows.push({ key: "pat_organization", value: copilotDiag.pat.config.organization });
     }
@@ -1149,6 +1313,7 @@ export async function buildQuotaStatusReport(params) {
     copilotRows.push({ key: "billing_mode", value: copilotDiag.billingMode });
     copilotRows.push({ key: "billing_scope", value: copilotDiag.billingScope });
     copilotRows.push({ key: "quota_api", value: copilotDiag.quotaApi });
+    copilotRows.push({ key: "budget_api", value: copilotDiag.budgetApi });
     copilotRows.push({
         key: "billing_api_access_likely",
         value: copilotDiag.billingApiAccessLikely ? "true" : "false",
@@ -1166,41 +1331,47 @@ export async function buildQuotaStatusReport(params) {
     if (copilotDiag.billingMode === "organization_usage") {
         copilotRows.push({
             key: "billing_usage_note",
-            value: "organization premium usage for the current billing period",
+            value: "organization AI Credit usage for the current UTC calendar month",
         });
         copilotRows.push({
             key: "remaining_quota_note",
-            value: "valid PAT access can query billing usage, but pooled org usage does not provide a true per-user remaining quota",
+            value: "the usage report exposes included-pool consumption and billed usage, but no included-pool denominator; percentages require a real budget",
         });
     }
     if (copilotDiag.billingMode === "enterprise_usage") {
         copilotRows.push({
             key: "billing_usage_note",
-            value: "enterprise premium usage for the current billing period",
+            value: "enterprise AI Credit usage for the current UTC calendar month",
         });
         copilotRows.push({
             key: "remaining_quota_note",
-            value: "valid enterprise billing access can query pooled enterprise usage, but it does not provide a true per-user remaining quota",
+            value: "the usage report exposes included-pool consumption and billed usage, but no included-pool denominator; percentages require a real budget",
         });
     }
     if (copilotDiag.billingTargetError) {
         copilotRows.push({ key: "billing_target_error", value: copilotDiag.billingTargetError });
     }
     if (copilotDiag.tokenCompatibilityError) {
-        copilotRows.push({ key: "token_compatibility_error", value: copilotDiag.tokenCompatibilityError });
+        copilotRows.push({
+            key: "token_compatibility_error",
+            value: copilotDiag.tokenCompatibilityError,
+        });
     }
     if (copilotDiag.pat.error) {
         copilotRows.push({ key: "pat_error", value: copilotDiag.pat.error });
     }
     copilotRows.push({
         key: "pat_checked_paths",
-        value: copilotDiag.pat.checkedPaths.length ? copilotDiag.pat.checkedPaths.join(" | ") : "(none)",
+        value: copilotDiag.pat.checkedPaths.length
+            ? copilotDiag.pat.checkedPaths.join(" | ")
+            : "(none)",
     });
     copilotRows.push({
         key: "oauth_configured",
         value: `${copilotDiag.oauth.configured ? "true" : "false"} key=${copilotDiag.oauth.keyName ?? "(none)"} refresh=${copilotDiag.oauth.hasRefreshToken ? "true" : "false"} access=${copilotDiag.oauth.hasAccessToken ? "true" : "false"}`,
     });
     copilotRows.push({ key: "effective_source", value: copilotDiag.effectiveSource });
+    copilotRows.push({ key: "oauth_accounting_state", value: copilotDiag.oauthAccountingState });
     copilotRows.push({ key: "override", value: copilotDiag.override });
     appendProviderCompactLiveProbeRows(copilotRows, "copilot", params.providerLiveProbes);
     sections.push(createKvSection("copilot_quota_auth", "copilot_quota_auth:", copilotRows));
@@ -1226,7 +1397,7 @@ export async function buildQuotaStatusReport(params) {
         {
             key: "companion_package_path",
             value: googleCompanionPresence.state === "present" || googleCompanionPresence.state === "invalid"
-                ? googleCompanionPresence.resolvedPath ?? "(none)"
+                ? (googleCompanionPresence.resolvedPath ?? "(none)")
                 : "(none)",
         },
     ];
@@ -1260,13 +1431,17 @@ export async function buildQuotaStatusReport(params) {
         { key: "companion_package_state", value: geminiCliCompanionPresence.state },
         {
             key: "companion_package_path",
-            value: geminiCliCompanionPresence.state === "present" || geminiCliCompanionPresence.state === "invalid"
-                ? geminiCliCompanionPresence.resolvedPath ?? "(none)"
+            value: geminiCliCompanionPresence.state === "present" ||
+                geminiCliCompanionPresence.state === "invalid"
+                ? (geminiCliCompanionPresence.resolvedPath ?? "(none)")
                 : "(none)",
         },
     ];
     if (geminiCliAuthPresence.state === "invalid") {
-        geminiCliRows.push({ key: "auth_error", value: sanitizeDisplayText(geminiCliAuthPresence.error) });
+        geminiCliRows.push({
+            key: "auth_error",
+            value: sanitizeDisplayText(geminiCliAuthPresence.error),
+        });
     }
     if (geminiCliCompanionPresence.state !== "present") {
         geminiCliRows.push({
@@ -1288,7 +1463,7 @@ export async function buildQuotaStatusReport(params) {
         {
             key: "companion_package_path",
             value: agyCompanionPresence.state === "present" || agyCompanionPresence.state === "invalid"
-                ? agyCompanionPresence.resolvedPath ?? "(none)"
+                ? (agyCompanionPresence.resolvedPath ?? "(none)")
                 : "(none)",
         },
     ];
@@ -1327,7 +1502,10 @@ export async function buildQuotaStatusReport(params) {
             { key: "error", value: params.sessionTokenError.error },
         ];
         if (params.sessionTokenError.checkedPath) {
-            sessionTokenErrorRows.push({ key: "checked_path", value: params.sessionTokenError.checkedPath });
+            sessionTokenErrorRows.push({
+                key: "checked_path",
+                value: params.sessionTokenError.checkedPath,
+            });
         }
         sections.push(createKvSection("session_tokens_error", "session_tokens_error:", sessionTokenErrorRows));
     }