@songsid/agend 2.1.4-beta.37 → 2.1.4-beta.39

package/dist/usage/providers.js

@@ -25,6 +25,7 @@ import { homedir } from "node:os";
 import { getProviderRateLimit } from "./provider-alerts.js";
 import { readStatuslineRateLimits, } from "./statusline-usage.js";
 import Database from "better-sqlite3";
+const i18n = (key, ...args) => args.length ? { key, args } : { key };
 const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
 const SESSION_MS = 5 * 60 * 60 * 1000;
 function jwtExpiryMs(token) {
@@ -173,19 +174,20 @@ function readShellRcToken() {
  */
 export function statuslineUsage(reading, plan, now = Date.now()) {
     const metrics = [];
-    const add = (w, label, windowMs) => {
+    const add = (w, label, labelKey, windowMs) => {
         if (!w)
             return;
         metrics.push({
             label,
+            labelI18n: i18n(labelKey),
             type: "percent",
             used: w.usedPercent,
             resetsAt: w.resetsAtMs !== null ? new Date(w.resetsAtMs).toISOString() : null,
             windowMs,
         });
     };
-    add(reading.fiveHour, "Session", SESSION_MS);
-    add(reading.sevenDay, "Weekly", WEEK_MS);
+    add(reading.fiveHour, "Session", "usage.metric.session", SESSION_MS);
+    add(reading.sevenDay, "Weekly", "usage.metric.weekly", WEEK_MS);
     const ageMin = Math.round((now - reading.observedAtMs) / 60_000);
     const age = ageMin <= 0 ? "just now" : `${ageMin}m ago`;
     return {
@@ -194,6 +196,7 @@ export function statuslineUsage(reading, plan, now = Date.now()) {
         // Say what is missing as well as where it came from: someone comparing this
         // against claude.ai should not have to guess why per-model rows vanished.
         hint: `from ${reading.instance}'s statusline, ${age} — no API call; plan and per-model limits need a CLI login`,
+        hintI18n: i18n(ageMin <= 0 ? "usage.hint.statusline_now" : "usage.hint.statusline_minutes", reading.instance, ageMin),
         metrics,
     };
 }
@@ -237,12 +240,19 @@ export async function fetchClaudeUsage() {
         const hint = process.env.ANTHROPIC_API_KEY
             ? "API-key login has no subscription usage. Use `claude /login` or set CLAUDE_CODE_OAUTH_TOKEN (from `claude setup-token`)."
             : "Log in with the Claude Code CLI (`claude`).";
-        return { status: "no-credentials", hint, metrics: [] };
+        return {
+            status: "no-credentials",
+            hint,
+            hintI18n: process.env.ANTHROPIC_API_KEY
+                ? i18n("usage.hint.claude_api_key")
+                : i18n("usage.hint.login_claude"),
+            metrics: [],
+        };
     }
     if ("error" in auth) {
         if (statusline)
             return statuslineUsage(statusline, auth.plan);
-        return { status: "error", plan: auth.plan, error: auth.error, metrics: [] };
+        return { status: "error", plan: auth.plan, error: auth.error, errorI18n: i18n("usage.error.claude_token_expired"), metrics: [] };
     }
     const plan = auth.plan;
     /** Every API failure degrades to the statusline rather than to an error row. */
@@ -261,33 +271,39 @@ export async function fetchClaudeUsage() {
         });
     }
     catch {
-        return orStatusline({ status: "error", plan, error: "Could not reach api.anthropic.com.", metrics: [] });
+        return orStatusline({ status: "error", plan, error: "Could not reach api.anthropic.com.", errorI18n: i18n("usage.error.unreachable", "api.anthropic.com"), metrics: [] });
     }
     if (res.status === 401 || res.status === 403) {
-        return orStatusline({ status: "error", plan, error: "Token rejected. Run `claude` once to refresh the login.", metrics: [] });
+        return orStatusline({ status: "error", plan, error: "Token rejected. Run `claude` once to refresh the login.", errorI18n: i18n("usage.error.token_rejected", "claude"), metrics: [] });
     }
     if (res.status === 429) {
-        return orStatusline({ status: "error", plan, error: "Rate limited by Anthropic — try again later.", metrics: [] });
+        return orStatusline({ status: "error", plan, error: "Rate limited by Anthropic — try again later.", errorI18n: i18n("usage.error.rate_limited", "Anthropic"), metrics: [] });
     }
     if (!res.ok)
-        return orStatusline({ status: "error", plan, error: `Usage request failed (HTTP ${res.status}).`, metrics: [] });
+        return orStatusline({ status: "error", plan, error: `Usage request failed (HTTP ${res.status}).`, errorI18n: i18n("usage.error.http", res.status), metrics: [] });
     let body;
     try {
         body = await res.json();
     }
     catch {
-        return orStatusline({ status: "error", plan, error: "Invalid response from usage endpoint.", metrics: [] });
+        return orStatusline({ status: "error", plan, error: "Invalid response from usage endpoint.", errorI18n: i18n("usage.error.invalid_response"), metrics: [] });
     }
     const metrics = [];
-    const window = (obj, label, windowMs) => {
+    const window = (obj, label, labelKey, windowMs) => {
         const o = obj;
         if (typeof o?.utilization !== "number")
             return;
-        metrics.push({ label, type: "percent", used: o.utilization, resetsAt: claudeResetIso(o.resets_at), windowMs });
+        metrics.push({ label, labelI18n: i18n(labelKey), type: "percent", used: o.utilization, resetsAt: claudeResetIso(o.resets_at), windowMs });
     };
-    window(body.five_hour, "Session", SESSION_MS);
-    window(body.seven_day, "Weekly", WEEK_MS);
-    window(body.seven_day_sonnet, "Sonnet (weekly)", WEEK_MS);
+    window(body.five_hour, "Session", "usage.metric.session", SESSION_MS);
+    window(body.seven_day, "Weekly", "usage.metric.weekly", WEEK_MS);
+    const sonnet = body.seven_day_sonnet;
+    if (typeof sonnet?.utilization === "number") {
+        metrics.push({
+            label: "Sonnet (weekly)", labelI18n: i18n("usage.metric.named_weekly", "Sonnet"),
+            type: "percent", used: sonnet.utilization, resetsAt: claudeResetIso(sonnet.resets_at), windowMs: WEEK_MS,
+        });
+    }
     // Per-model weekly windows live in the `limits` array (kind: weekly_scoped).
     // `limits` also carries which window is currently BINDING (`is_active`) and a
     // severity the top-level windows do not expose. Probed live on a Team account:
@@ -305,31 +321,38 @@ export async function fetchClaudeUsage() {
             continue;
         metrics.push({
             label: `${model} (weekly)`,
+            labelI18n: i18n("usage.metric.named_weekly", model),
             type: "percent",
             used: e.percent,
             resetsAt: claudeResetIso(e.resets_at),
             windowMs: WEEK_MS,
-            ...(e.is_active === true ? { note: "binding" } : {}),
-            ...(typeof e.severity === "string" && e.severity !== "normal" ? { note: `binding · ${e.severity}` } : {}),
+            ...(e.is_active === true ? { note: "binding", noteI18n: i18n("usage.note.binding") } : {}),
+            ...(typeof e.severity === "string" && e.severity !== "normal"
+                ? { note: `binding · ${e.severity}`, noteI18n: i18n("usage.note.binding_severity", e.severity) }
+                : {}),
         });
     }
     // Mark the two plain windows too, using the same source.
     for (const m of metrics) {
         if (m.note)
             continue;
-        if (m.label === "Session" && activeKinds.has("session"))
+        if (m.label === "Session" && activeKinds.has("session")) {
             m.note = "binding";
-        if (m.label === "Weekly" && activeKinds.has("weekly_all"))
+            m.noteI18n = i18n("usage.note.binding");
+        }
+        if (m.label === "Weekly" && activeKinds.has("weekly_all")) {
             m.note = "binding";
+            m.noteI18n = i18n("usage.note.binding");
+        }
     }
     const extra = body.extra_usage;
     if (extra?.is_enabled === true && typeof extra.used_credits === "number") {
         const used = extra.used_credits / 100;
         const limit = typeof extra.monthly_limit === "number" && extra.monthly_limit > 0 ? extra.monthly_limit / 100 : null;
         if (limit)
-            metrics.push({ label: "Extra usage", type: "dollars", used, limit });
+            metrics.push({ label: "Extra usage", labelI18n: i18n("usage.metric.extra_usage"), type: "dollars", used, limit });
         else if (used > 0)
-            metrics.push({ label: "Extra usage", type: "dollars", used });
+            metrics.push({ label: "Extra usage", labelI18n: i18n("usage.metric.extra_usage"), type: "dollars", used });
     }
     // A 200 with nothing in it is not better than the file on disk.
     if (metrics.length === 0 && statusline)
@@ -398,8 +421,10 @@ let agyTokenCache = null;
  */
 export function agyPoolMetrics(buckets) {
     const POOLED = {
-        "gemini-5h": "Gemini (session)", "gemini-weekly": "Gemini (weekly)",
-        "3p-5h": "Claude & others (session)", "3p-weekly": "Claude & others (weekly)",
+        "gemini-5h": { text: "Gemini (session)", i18n: i18n("usage.metric.named_session", "Gemini") },
+        "gemini-weekly": { text: "Gemini (weekly)", i18n: i18n("usage.metric.named_weekly", "Gemini") },
+        "3p-5h": { text: "Claude & others (session)", i18n: i18n("usage.metric.agy_claude_others_session") },
+        "3p-weekly": { text: "Claude & others (weekly)", i18n: i18n("usage.metric.agy_claude_others_weekly") },
     };
     const direct = [];
     const pools = new Map();
@@ -409,7 +434,7 @@ export function agyPoolMetrics(buckets) {
         const reset = b.resetTime ?? null;
         const pooledLabel = POOLED[b.bucketId];
         if (pooledLabel) {
-            direct.push({ label: pooledLabel, type: "percent", used: (1 - b.remainingFraction) * 100, resetsAt: reset });
+            direct.push({ label: pooledLabel.text, labelI18n: pooledLabel.i18n, type: "percent", used: (1 - b.remainingFraction) * 100, resetsAt: reset });
             continue;
         }
         const pool = b.bucketId.startsWith("gemini") ? "Gemini" : "Claude & others";
@@ -430,6 +455,9 @@ export function agyPoolMetrics(buckets) {
         return direct;
     return [...pools.entries()].map(([label, p]) => ({
         label,
+        labelI18n: label === "Claude & others"
+            ? i18n("usage.metric.agy_claude_others")
+            : i18n("usage.metric.named", label),
         type: "percent",
         used: (1 - p.fraction) * 100,
         resetsAt: p.resetsAt,
@@ -437,6 +465,7 @@ export function agyPoolMetrics(buckets) {
         // it a flat 0% right after a weekly rollover is indistinguishable from a
         // broken reading — which is exactly how it was reported.
         note: `busiest of ${p.models} model${p.models === 1 ? "" : "s"}`,
+        noteI18n: i18n(p.models === 1 ? "usage.note.busiest_model" : "usage.note.busiest_models", p.models),
     }));
 }
 /**
@@ -482,6 +511,9 @@ async function agyAccessToken() {
             error: client
                 ? "Access token expired and no refresh token is stored. Run `agy` once."
                 : "Access token expired. Run `agy` once to refresh it (or set AGY_OAUTH_CLIENT_ID/SECRET to refresh automatically).",
+            errorI18n: client
+                ? i18n("usage.error.agy_no_refresh")
+                : i18n("usage.error.agy_token_expired"),
         };
     }
     try {
@@ -497,15 +529,15 @@ async function agyAccessToken() {
             signal: AbortSignal.timeout(15_000),
         });
         if (!res.ok)
-            return { error: "Google sign-in expired. Run `agy` once to log in again." };
+            return { error: "Google sign-in expired. Run `agy` once to log in again.", errorI18n: i18n("usage.error.agy_login_expired") };
         const body = await res.json();
         if (!body.access_token)
-            return { error: "Google token refresh returned no token." };
+            return { error: "Google token refresh returned no token.", errorI18n: i18n("usage.error.agy_refresh_empty") };
         agyTokenCache = { token: body.access_token, until: Date.now() + Math.max(60, (body.expires_in ?? 3600) - 120) * 1000 };
         return { token: body.access_token };
     }
     catch {
-        return { error: "Could not reach oauth2.googleapis.com." };
+        return { error: "Could not reach oauth2.googleapis.com.", errorI18n: i18n("usage.error.unreachable", "oauth2.googleapis.com") };
     }
 }
 async function fetchAntigravityUsage() {
@@ -523,15 +555,16 @@ async function fetchAntigravityUsage() {
             status: "error",
             error: `Individual cap reached — CLI is rate limited (resets in ~${resetText}). `
                 + "The per-model pool quotas are a separate counter and may still read 0% used.",
+            errorI18n: i18n("usage.error.agy_cap", resetText),
             metrics: [],
         };
     }
     const auth = await agyAccessToken();
     if (auth === null) {
-        return { status: "no-credentials", hint: "Log in with the Antigravity CLI (`agy`).", metrics: [] };
+        return { status: "no-credentials", hint: "Log in with the Antigravity CLI (`agy`).", hintI18n: i18n("usage.hint.login_agy"), metrics: [] };
     }
     if ("error" in auth)
-        return { status: "error", error: auth.error, metrics: [] };
+        return { status: "error", error: auth.error, errorI18n: auth.errorI18n, metrics: [] };
     for (const base of AGY_CLOUDCODE_URLS) {
         let res;
         try {
@@ -550,7 +583,7 @@ async function fetchAntigravityUsage() {
             continue;
         }
         if (res.status === 401 || res.status === 403) {
-            return { status: "error", error: "Token rejected. Run `agy` once to refresh the login.", metrics: [] };
+            return { status: "error", error: "Token rejected. Run `agy` once to refresh the login.", errorI18n: i18n("usage.error.token_rejected", "agy"), metrics: [] };
         }
         if (!res.ok)
             continue; // try the other base
@@ -565,9 +598,9 @@ async function fetchAntigravityUsage() {
         const metrics = agyPoolMetrics(buckets);
         return metrics.length
             ? { status: "ok", plan: null, metrics }
-            : { status: "ok", plan: null, hint: "No quota information reported for this account.", metrics: [] };
+            : { status: "ok", plan: null, hint: "No quota information reported for this account.", hintI18n: i18n("usage.hint.no_quota"), metrics: [] };
     }
-    return { status: "error", error: "Could not reach the Cloud Code quota endpoints.", metrics: [] };
+    return { status: "error", error: "Could not reach the Cloud Code quota endpoints.", errorI18n: i18n("usage.error.unreachable", "Cloud Code quota endpoints"), metrics: [] };
 }
 // ── Codex ────────────────────────────────────────────────────────────────────
 const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
@@ -606,7 +639,7 @@ function codexWindows(rateLimit, labels, nowMs) {
             label = labels.other(Math.round(windowMs / 864e5));
         else
             label = fallback === "session" ? labels.session : labels.weekly;
-        metrics.push({ label, type: "percent", used: win.used_percent, resetsAt: codexResetIso(win, nowMs), windowMs });
+        metrics.push({ label: label.text, labelI18n: label.i18n, type: "percent", used: win.used_percent, resetsAt: codexResetIso(win, nowMs), windowMs });
     }
     return metrics;
 }
@@ -626,15 +659,15 @@ export async function fetchCodexUsage() {
         auth = JSON.parse(await readFile(join(home, "auth.json"), "utf8"));
     }
     catch {
-        return { status: "no-credentials", hint: "Log in with the Codex CLI (`codex`).", metrics: [] };
+        return { status: "no-credentials", hint: "Log in with the Codex CLI (`codex`).", hintI18n: i18n("usage.hint.login_codex"), metrics: [] };
     }
     const accessToken = auth?.tokens?.access_token;
     if (!accessToken) {
-        return { status: "no-credentials", hint: "auth.json has no OAuth login (API-key-only auth cannot read usage).", metrics: [] };
+        return { status: "no-credentials", hint: "auth.json has no OAuth login (API-key-only auth cannot read usage).", hintI18n: i18n("usage.hint.codex_no_oauth"), metrics: [] };
     }
     const exp = jwtExpiryMs(accessToken);
     if (exp && exp < Date.now()) {
-        return { status: "error", error: "Access token expired. Run `codex` once to refresh it.", metrics: [] };
+        return { status: "error", error: "Access token expired. Run `codex` once to refresh it.", errorI18n: i18n("usage.error.codex_token_expired"), metrics: [] };
     }
     const headers = {
         Authorization: `Bearer ${accessToken}`,
@@ -648,23 +681,26 @@ export async function fetchCodexUsage() {
         res = await fetch(CODEX_USAGE_URL, { headers, signal: AbortSignal.timeout(10_000) });
     }
     catch {
-        return { status: "error", error: "Could not reach chatgpt.com.", metrics: [] };
+        return { status: "error", error: "Could not reach chatgpt.com.", errorI18n: i18n("usage.error.unreachable", "chatgpt.com"), metrics: [] };
     }
     if (res.status === 401 || res.status === 403) {
-        return { status: "error", error: "Token rejected. Run `codex` once to refresh the login.", metrics: [] };
+        return { status: "error", error: "Token rejected. Run `codex` once to refresh the login.", errorI18n: i18n("usage.error.token_rejected", "codex"), metrics: [] };
     }
     if (!res.ok)
-        return { status: "error", error: `Usage request failed (HTTP ${res.status}).`, metrics: [] };
+        return { status: "error", error: `Usage request failed (HTTP ${res.status}).`, errorI18n: i18n("usage.error.http", res.status), metrics: [] };
     let body;
     try {
         body = await res.json();
     }
     catch {
-        return { status: "error", error: "Invalid response from usage endpoint.", metrics: [] };
+        return { status: "error", error: "Invalid response from usage endpoint.", errorI18n: i18n("usage.error.invalid_response"), metrics: [] };
     }
     const nowMs = Date.now();
     const metrics = codexWindows(body.rate_limit, {
-        session: "Session", weekly: "Weekly", monthly: "Monthly", other: d => `${d}-day window`,
+        session: { text: "Session", i18n: i18n("usage.metric.session") },
+        weekly: { text: "Weekly", i18n: i18n("usage.metric.weekly") },
+        monthly: { text: "Monthly", i18n: i18n("usage.metric.monthly") },
+        other: d => ({ text: `${d}-day window`, i18n: i18n("usage.metric.days_window", d) }),
     }, nowMs);
     // Model-specific limits (e.g. Spark) ride in additional_rate_limits, same window shape.
     for (const entry of Array.isArray(body.additional_rate_limits) ? body.additional_rate_limits : []) {
@@ -673,12 +709,19 @@ export async function fetchCodexUsage() {
             continue;
         const rawName = e.limit_name || e.metered_feature || "Model limit";
         metrics.push(...codexWindows(e.rate_limit, {
-            session: rawName, weekly: `${rawName} (weekly)`, monthly: `${rawName} (monthly)`, other: d => `${rawName} (${d}d)`,
+            session: { text: rawName, i18n: i18n("usage.metric.named", rawName) },
+            weekly: { text: `${rawName} (weekly)`, i18n: i18n("usage.metric.named_weekly", rawName) },
+            monthly: { text: `${rawName} (monthly)`, i18n: i18n("usage.metric.named_monthly", rawName) },
+            other: d => ({ text: `${rawName} (${d}d)`, i18n: i18n("usage.metric.named_days", rawName, d) }),
         }, nowMs));
     }
     const resets = body.rate_limit_reset_credits;
     if (typeof resets?.available_count === "number" && resets.available_count >= 0) {
-        metrics.push({ label: "Rate limit resets", type: "count", value: Math.floor(resets.available_count), unit: "available" });
+        metrics.push({
+            label: "Rate limit resets", labelI18n: i18n("usage.metric.rate_limit_resets"),
+            type: "count", value: Math.floor(resets.available_count),
+            unit: "available", unitI18n: i18n("usage.unit.available"),
+        });
     }
     const credits = body.credits;
     let remaining = null;
@@ -688,7 +731,10 @@ export async function fetchCodexUsage() {
         remaining = 0;
     if (remaining !== null) {
         const count = Math.max(0, Math.floor(remaining));
-        metrics.push({ label: "Credits", type: "count", value: count, unit: "credits", note: `≈ $${(count * CREDIT_USD_RATE).toFixed(2)}` });
+        metrics.push({
+            label: "Credits", labelI18n: i18n("usage.metric.credits"), type: "count", value: count,
+            unit: "credits", unitI18n: i18n("usage.unit.credits"), note: `≈ $${(count * CREDIT_USD_RATE).toFixed(2)}`,
+        });
     }
     return { status: "ok", plan: codexPlan(body.plan_type), metrics };
 }
@@ -718,11 +764,11 @@ async function grokRefreshAndPersist(file, auth, entryKey, entry) {
         await access(file, constants.W_OK);
     }
     catch {
-        return { error: "Token expired and auth.json is read-only. Run `grok` once to refresh it." };
+        return { error: "Token expired and auth.json is read-only. Run `grok` once to refresh it.", errorI18n: i18n("usage.error.grok_auth_readonly") };
     }
     const refreshToken = (entry.refresh_token || entry.refresh || "").trim();
     if (!refreshToken)
-        return { error: "Token expired and no refresh token found. Run `grok login`." };
+        return { error: "Token expired and no refresh token found. Run `grok login`.", errorI18n: i18n("usage.error.grok_no_refresh") };
     const clientId = entry.oidc_client_id?.trim()
         || entryKey.split("::").pop()?.trim()
         || GROK_DEFAULT_CLIENT_ID;
@@ -736,19 +782,19 @@ async function grokRefreshAndPersist(file, auth, entryKey, entry) {
         });
     }
     catch {
-        return { error: "Could not reach auth.x.ai to refresh the token." };
+        return { error: "Could not reach auth.x.ai to refresh the token.", errorI18n: i18n("usage.error.grok_refresh_unreachable") };
     }
     if (!res.ok)
-        return { error: "Grok session expired. Run `grok login` again." };
+        return { error: "Grok session expired. Run `grok login` again.", errorI18n: i18n("usage.error.grok_expired") };
     let body;
     try {
         body = await res.json();
     }
     catch {
-        return { error: "Invalid refresh response from auth.x.ai." };
+        return { error: "Invalid refresh response from auth.x.ai.", errorI18n: i18n("usage.error.grok_invalid_refresh") };
     }
     if (!body.access_token)
-        return { error: "Grok session expired. Run `grok login` again." };
+        return { error: "Grok session expired. Run `grok login` again.", errorI18n: i18n("usage.error.grok_expired") };
     // Update only this entry's fields, preserving everything else in the file
     // (other accounts' entries included).
     const updated = { ...(auth[entryKey] ?? {}) };
@@ -763,7 +809,7 @@ async function grokRefreshAndPersist(file, auth, entryKey, entry) {
         await writeFile(file, JSON.stringify({ ...auth, [entryKey]: updated }, null, 2));
     }
     catch {
-        return { error: "Refreshed but could not write auth.json — refusing to continue without persisting. Run `grok` once instead." };
+        return { error: "Refreshed but could not write auth.json — refusing to continue without persisting. Run `grok` once instead.", errorI18n: i18n("usage.error.grok_persist") };
     }
     return { token: body.access_token };
 }
@@ -783,18 +829,18 @@ async function fetchGrokUsage() {
         auth = JSON.parse(await readFile(file, "utf8"));
     }
     catch {
-        return { status: "no-credentials", hint: "Log in with the Grok CLI (`grok login`).", metrics: [] };
+        return { status: "no-credentials", hint: "Log in with the Grok CLI (`grok login`).", hintI18n: i18n("usage.hint.login_grok"), metrics: [] };
     }
     const entries = Object.entries(auth).filter(([, e]) => typeof e?.key === "string" && e.key.trim());
     if (!entries.length)
-        return { status: "no-credentials", hint: "auth.json has no usable login. Run `grok login`.", metrics: [] };
+        return { status: "no-credentials", hint: "auth.json has no usable login. Run `grok login`.", hintI18n: i18n("usage.hint.grok_no_login"), metrics: [] };
     const [entryKey, entry] = entries[0];
     let token = entry.key.trim();
     const expiry = grokEntryExpiryMs(entry, token);
     if (expiry && expiry - Date.now() <= GROK_REFRESH_BUFFER_MS) {
         const refreshed = await grokRefreshAndPersist(file, auth, entryKey, entry);
         if (refreshed.error)
-            return { status: "error", error: refreshed.error, metrics: [] };
+            return { status: "error", error: refreshed.error, errorI18n: refreshed.errorI18n, metrics: [] };
         token = refreshed.token;
     }
     const fetchBoth = async (tok) => {
@@ -810,30 +856,30 @@ async function fetchGrokUsage() {
         if (credits.status === 401 || credits.status === 403) {
             const refreshed = await grokRefreshAndPersist(file, auth, entryKey, entry);
             if (refreshed.error)
-                return { status: "error", error: refreshed.error, metrics: [] };
+                return { status: "error", error: refreshed.error, errorI18n: refreshed.errorI18n, metrics: [] };
             token = refreshed.token;
             ({ credits, settings } = await fetchBoth(token));
         }
     }
     catch {
-        return { status: "error", error: "Could not reach cli-chat-proxy.grok.com.", metrics: [] };
+        return { status: "error", error: "Could not reach cli-chat-proxy.grok.com.", errorI18n: i18n("usage.error.unreachable", "cli-chat-proxy.grok.com"), metrics: [] };
     }
     if (credits.status === 401 || credits.status === 403) {
-        return { status: "error", error: "Grok session expired. Run `grok login` again.", metrics: [] };
+        return { status: "error", error: "Grok session expired. Run `grok login` again.", errorI18n: i18n("usage.error.grok_expired"), metrics: [] };
     }
     if (!credits.ok)
-        return { status: "error", error: `Billing request failed (HTTP ${credits.status}).`, metrics: [] };
+        return { status: "error", error: `Billing request failed (HTTP ${credits.status}).`, errorI18n: i18n("usage.error.billing_http", credits.status), metrics: [] };
     let body;
     try {
         body = await credits.json();
     }
     catch {
-        return { status: "error", error: "Invalid response from billing endpoint.", metrics: [] };
+        return { status: "error", error: "Invalid response from billing endpoint.", errorI18n: i18n("usage.error.invalid_billing_response"), metrics: [] };
     }
     const config = body?.config;
     const period = config?.currentPeriod;
     if (!config || !period?.type)
-        return { status: "error", error: "Grok billing response changed.", metrics: [] };
+        return { status: "error", error: "Grok billing response changed.", errorI18n: i18n("usage.error.grok_response_changed"), metrics: [] };
     const metrics = [];
     if (period.type === GROK_WEEKLY_PERIOD) {
         // proto-JSON drops zero-valued fields: an absent creditUsagePercent means 0%.
@@ -842,6 +888,7 @@ async function fetchGrokUsage() {
         const end = new Date(period.end ?? "").getTime();
         metrics.push({
             label: "Weekly limit",
+            labelI18n: i18n("usage.metric.weekly_limit"),
             type: "percent",
             used: Math.min(100, Math.max(0, pct)),
             resetsAt: Number.isNaN(end) ? null : new Date(end).toISOString(),
@@ -849,7 +896,11 @@ async function fetchGrokUsage() {
         });
     }
     const cap = typeof config.onDemandCap?.val === "number" ? config.onDemandCap.val : 0;
-    metrics.push({ label: "Pay as you go", type: "text", value: cap > 0 ? `${cap} cap` : "Disabled" });
+    metrics.push({
+        label: "Pay as you go", labelI18n: i18n("usage.metric.pay_as_you_go"), type: "text",
+        value: cap > 0 ? `${cap} cap` : "Disabled",
+        valueI18n: cap > 0 ? i18n("usage.value.cap", cap) : i18n("usage.value.disabled"),
+    });
     let plan = null;
     if (settings?.ok) {
         try {
@@ -942,12 +993,12 @@ export async function fetchKiroUsage() {
     const { token, kind, missing, notInstalled } = readKiroToken();
     if (notInstalled) {
         // The one case that should disappear from the panel: kiro-cli isn't here.
-        return { status: "no-credentials", hint: "Log in with the Kiro CLI (`kiro-cli`).", metrics: [] };
+        return { status: "no-credentials", hint: "Log in with the Kiro CLI (`kiro-cli`).", hintI18n: i18n("usage.hint.login_kiro"), metrics: [] };
     }
     if (missing || !token) {
         // Installed but no readable login. Previously indistinguishable from
         // not-installed, so the whole Kiro row vanished instead of saying this.
-        return { status: "ok", plan: "Kiro", hint: "Signed out — run `kiro-cli` to log in.", metrics: [] };
+        return { status: "ok", plan: "Kiro", hint: "Signed out — run `kiro-cli` to log in.", hintI18n: i18n("usage.hint.kiro_signed_out"), metrics: [] };
     }
     const expiresAt = token.expires_at ? new Date(token.expires_at).getTime() : null;
     if (expiresAt && expiresAt < Date.now()) {
@@ -955,7 +1006,7 @@ export async function fetchKiroUsage() {
         // panel showing a red failure for a routine token rollover is just noise.
         // Still `ok` rather than no-credentials, so the row stays on screen with its
         // explanation instead of the provider silently disappearing.
-        return { status: "ok", plan: "Kiro", hint: "Token refreshing — try again in a moment.", metrics: [] };
+        return { status: "ok", plan: "Kiro", hint: "Token refreshing — try again in a moment.", hintI18n: i18n("usage.hint.token_refreshing"), metrics: [] };
     }
     if (kind === "q-developer-pro") {
         // Seat-licensed subscription: GetUsageLimits describes Builder-ID credit
@@ -964,6 +1015,7 @@ export async function fetchKiroUsage() {
             status: "ok",
             plan: "Q Developer Pro",
             hint: "Subscription — no credit usage to report.",
+            hintI18n: i18n("usage.hint.subscription_no_credit"),
             metrics: [],
         };
     }
@@ -984,35 +1036,40 @@ export async function fetchKiroUsage() {
         });
     }
     catch {
-        return { status: "error", error: `Could not reach codewhisperer.${region}.amazonaws.com.`, metrics: [] };
+        return { status: "error", error: `Could not reach codewhisperer.${region}.amazonaws.com.`, errorI18n: i18n("usage.error.unreachable", `codewhisperer.${region}.amazonaws.com`), metrics: [] };
     }
     if (res.status === 401 || res.status === 403) {
-        return { status: "error", error: "Token rejected. Use `kiro-cli` once to refresh the login.", metrics: [] };
+        return { status: "error", error: "Token rejected. Use `kiro-cli` once to refresh the login.", errorI18n: i18n("usage.error.token_rejected", "kiro-cli"), metrics: [] };
     }
     if (!res.ok)
-        return { status: "error", error: `Usage request failed (HTTP ${res.status}).`, metrics: [] };
+        return { status: "error", error: `Usage request failed (HTTP ${res.status}).`, errorI18n: i18n("usage.error.http", res.status), metrics: [] };
     let body;
     try {
         body = await res.json();
     }
     catch {
-        return { status: "error", error: "Invalid response from GetUsageLimits.", metrics: [] };
+        return { status: "error", error: "Invalid response from GetUsageLimits.", errorI18n: i18n("usage.error.invalid_kiro_response"), metrics: [] };
     }
     const plan = typeof body.subscriptionInfo?.subscriptionTitle === "string"
         ? kiroTitleCase(body.subscriptionInfo.subscriptionTitle)
         : null;
     const metrics = [];
     for (const ub of Array.isArray(body.usageBreakdownList) ? body.usageBreakdownList : []) {
-        const unit = (ub.displayNamePlural || ub.displayName || "credits").toLowerCase();
+        const displayName = ub.displayNamePlural || ub.displayName;
+        const unit = (displayName || "credits").toLowerCase();
         const used = ub.currentUsageWithPrecision ?? ub.currentUsage ?? null;
         const limit = ub.usageLimitWithPrecision ?? ub.usageLimit ?? null;
         if (used !== null && limit !== null && limit > 0) {
             metrics.push({
-                label: `${ub.displayNamePlural || ub.displayName || "Usage"} (monthly)`,
+                label: `${displayName || "Usage"} (monthly)`,
+                labelI18n: displayName
+                    ? i18n("usage.metric.named_monthly", displayName)
+                    : i18n("usage.metric.usage_monthly"),
                 type: "percent",
                 used: Math.min(100, (used / limit) * 100),
                 resetsAt: kiroEpochIso(ub.nextDateReset ?? body.nextDateReset),
                 note: `${+used.toFixed(1)} / ${+limit.toFixed(0)} ${unit}`,
+                noteI18n: i18n("usage.note.used_limit_unit", +used.toFixed(1), +limit.toFixed(0), unit),
             });
         }
         // Bonus / gift credits (redeemed promo codes), aggregated across active codes.
@@ -1024,27 +1081,29 @@ export async function fetchKiroUsage() {
             if (bLimit > 0) {
                 metrics.push({
                     label: "Bonus credits",
+                    labelI18n: i18n("usage.metric.bonus_credits"),
                     type: "percent",
                     used: Math.min(100, (bUsed / bLimit) * 100),
                     resetsAt: expiries.length ? kiroEpochIso(Math.min(...expiries)) : null,
                     note: `${+bUsed.toFixed(1)} / ${+bLimit.toFixed(0)} ${unit} · ${bonuses.length} codes`,
+                    noteI18n: i18n("usage.note.bonus_codes", +bUsed.toFixed(1), +bLimit.toFixed(0), unit, bonuses.length),
                 });
             }
         }
         const overages = ub.currentOveragesWithPrecision ?? ub.currentOverages ?? 0;
         if (overages > 0 && typeof ub.overageCharges === "number") {
-            metrics.push({ label: "Overage charges", type: "dollars", used: ub.overageCharges });
+            metrics.push({ label: "Overage charges", labelI18n: i18n("usage.metric.overage_charges"), type: "dollars", used: ub.overageCharges });
         }
     }
     const overageStatus = body.overageConfiguration?.overageStatus;
     if (typeof overageStatus === "string") {
-        metrics.push({ label: "Pay-per-use", type: "text", value: kiroTitleCase(overageStatus.replace(/_/g, " ")) });
+        metrics.push({ label: "Pay-per-use", labelI18n: i18n("usage.metric.pay_per_use"), type: "text", value: kiroTitleCase(overageStatus.replace(/_/g, " ")) });
     }
     if (metrics.length === 0) {
         // Amazon Q logins whose account type reports no credit buckets (#398's
         // sibling case): an OK answer with nothing in it must say so, not render an
         // empty row that reads like a failure.
-        return { status: "ok", plan: plan ?? "Amazon Q", hint: "No quota information available for this account type.", metrics: [] };
+        return { status: "ok", plan: plan ?? "Amazon Q", hint: "No quota information available for this account type.", hintI18n: i18n("usage.hint.no_quota_account"), metrics: [] };
     }
     return { status: "ok", plan, metrics };
 }