agy-cli-usage 0.3.1 → 0.4.1

package/server.js

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-// Optional lightweight HTTP endpoint for dashboard integration (e.g. ontology).
-// Serves the normalized quota snapshot as JSON, going through the same 5-minute
-// cache as the CLI so polling clients never hammer the upstream API.
-//
-//   PORT=3007 node server.js
-//   GET /quota   -> normalized snapshot JSON
-//   GET /healthz -> { ok: true }
-
-import { createServer } from 'node:http';
-import { getSnapshot } from './src/main.js';
-
-const PORT = Number(process.env.PORT) || 3007;
-const HOST = process.env.HOST || '127.0.0.1';
-
-const server = createServer(async (req, res) => {
-  const url = new URL(req.url, `http://${req.headers.host}`);
-
-  if (url.pathname === '/healthz') {
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ ok: true }));
-    return;
-  }
-
-  if (url.pathname === '/quota') {
-    try {
-      const noCache = url.searchParams.get('refresh') === '1';
-      const snap = await getSnapshot({ source: 'auto', channel: 'auto', cache: !noCache });
-      res.writeHead(200, {
-        'Content-Type': 'application/json',
-        'Access-Control-Allow-Origin': '*',
-        'Cache-Control': 'public, max-age=300',
-      });
-      res.end(JSON.stringify(snap));
-    } catch (err) {
-      res.writeHead(502, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ error: err.message }));
-    }
-    return;
-  }
-
-  res.writeHead(404, { 'Content-Type': 'application/json' });
-  res.end(JSON.stringify({ error: 'not found' }));
-});
-
-server.listen(PORT, HOST, () => {
-  process.stdout.write(`agy-usage server on http://${HOST}:${PORT}  (GET /quota)\n`);
-});

package/src/api.js

@@ -1,92 +0,0 @@
-// Direct client for the Antigravity / Gemini Code Assist "Cloud Code" internal API.
-//
-// Reproduces exactly what `agy` does on startup to populate its /usage panel:
-//   1. POST /v1internal:loadCodeAssist  {metadata:{ideType:"ANTIGRAVITY"}}
-//        -> { cloudaicompanionProject, currentTier, ... }
-//   2. POST /v1internal:retrieveUserQuotaSummary  {project:<cloudaicompanionProject>}
-//        -> { groups:[ { displayName, description, buckets:[ {bucketId, displayName,
-//             window, resetTime, description?, remainingFraction} ] } ], description }
-//
-// Captured from live agy traffic (mitmproxy). The internal endpoint is undocumented;
-// the PTY fallback exists for when it changes.
-
-const UA = `antigravity-usage-monitor/0.1 ${process.platform}/${process.arch}`;
-
-// Antigravity ships against the "daily" Cloud Code host; stable builds use the
-// plain host. Try daily first (matches current CLI), fall back to prod.
-const HOSTS = ['daily-cloudcode-pa.googleapis.com', 'cloudcode-pa.googleapis.com'];
-
-class ApiError extends Error {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-  }
-}
-
-function extractEmail(uri) {
-  const m = uri?.match(/[?&]Email=([^&]+)/);
-  if (!m) return null;
-  try {
-    return decodeURIComponent(m[1]);
-  } catch {
-    return m[1];
-  }
-}
-
-async function postInternal(host, accessToken, method, body) {
-  const res = await fetch(`https://${host}/v1internal:${method}`, {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${accessToken}`,
-      'Content-Type': 'application/json',
-      'User-Agent': UA,
-    },
-    body: JSON.stringify(body),
-  });
-  if (!res.ok) {
-    throw new ApiError(`${method} -> HTTP ${res.status}: ${(await res.text()).slice(0, 300)}`, res.status);
-  }
-  return res.json();
-}
-
-/**
- * Fetch the raw quota summary from the Cloud Code API.
- * @param {string} accessToken
- * @param {{ host?: string, channel?: 'daily'|'prod' }} [opts]
- * @returns {Promise<{ raw: object, host: string, account: string|null, tier: string|null }>}
- */
-export async function fetchQuotaSummary(accessToken, opts = {}) {
-  const candidates = opts.host
-    ? [opts.host]
-    : opts.channel === 'prod'
-      ? ['cloudcode-pa.googleapis.com']
-      : opts.channel === 'daily'
-        ? ['daily-cloudcode-pa.googleapis.com']
-        : HOSTS;
-
-  let lastErr;
-  for (const host of candidates) {
-    try {
-      const lca = await postInternal(host, accessToken, 'loadCodeAssist', {
-        metadata: { ideType: 'ANTIGRAVITY' },
-      });
-      const project = lca.cloudaicompanionProject;
-      if (!project) throw new ApiError('loadCodeAssist returned no cloudaicompanionProject', 0);
-
-      const raw = await postInternal(host, accessToken, 'retrieveUserQuotaSummary', { project });
-      return {
-        raw,
-        host,
-        tier: lca.currentTier?.id ?? null,
-        account: extractEmail(lca.currentTier?.upgradeSubscriptionUri),
-      };
-    } catch (err) {
-      lastErr = err;
-      // 404 / wrong-host -> try next candidate; auth errors -> stop early.
-      if (err instanceof ApiError && (err.status === 401 || err.status === 403)) throw err;
-    }
-  }
-  throw lastErr ?? new ApiError('No Cloud Code host responded', 0);
-}
-
-export { ApiError };

package/src/main.js

@@ -1,142 +0,0 @@
-#!/usr/bin/env node
-// agy-usage — Antigravity CLI (agy) usage/quota monitor.
-//
-// Usage:
-//   agy-usage                 one-shot panel (like agy's /usage)
-//   agy-usage --json          machine-readable JSON
-//   agy-usage --watch [secs]  refresh every N seconds (default 60)
-//   agy-usage --source api|pty|auto   data source (default auto: api, fall back to pty)
-//   agy-usage --channel daily|prod    Cloud Code host (default: auto-detect)
-//   agy-usage --no-cache      bypass the 5-minute cache
-//   agy-usage --refresh       force a fresh fetch (alias for --no-cache)
-//   agy-usage update [--check]  self-update via npm
-//   agy-usage --version | -v  print the installed version
-
-import { getAccessToken, CredentialError } from './credentials.js';
-import { fetchQuotaSummary } from './api.js';
-import { captureUsageViaPty } from './pty-fallback.js';
-import { fromApi, fromPty } from './quota.js';
-import { renderPanel } from './render.js';
-import { currentVersion, runUpdate } from './update.js';
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-const CACHE_DIR = join(process.env.XDG_CACHE_HOME || join(homedir(), '.cache'), 'agy-usage');
-const CACHE_FILE = join(CACHE_DIR, 'quota.json');
-const CACHE_TTL_MS = 5 * 60 * 1000;
-
-function parseArgs(argv) {
-  const o = { json: false, watch: null, source: 'auto', channel: 'auto', cache: true, command: null, check: false };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === 'update' && o.command == null) o.command = 'update';
-    else if (a === '--json') o.json = true;
-    else if (a === '--watch') {
-      const n = Number(argv[i + 1]);
-      if (Number.isFinite(n)) { o.watch = n; i++; } else o.watch = 60;
-    } else if (a === '--source') o.source = argv[++i];
-    else if (a === '--channel') o.channel = argv[++i];
-    else if (a === '--no-cache' || a === '--refresh') o.cache = false;
-    else if (a === '--check') o.check = true;
-    else if (a === '-v' || a === '--version') o.version = true;
-    else if (a === '-h' || a === '--help') o.help = true;
-  }
-  return o;
-}
-
-const HELP = `agy-usage — Antigravity CLI (agy) usage/quota monitor
-
-  agy-usage                 one-shot panel
-  agy-usage --json          machine-readable JSON
-  agy-usage --watch [secs]  auto-refresh (default 60s)
-  agy-usage --source <auto|api|pty>
-  agy-usage --channel <auto|daily|prod>
-  agy-usage --no-cache | --refresh
-  agy-usage update [--check]  self-update via npm (--check: report only)
-  agy-usage --version | -v
-`;
-
-// --- cache -------------------------------------------------------------------
-
-function readCache() {
-  try {
-    const { ts, snap } = JSON.parse(readFileSync(CACHE_FILE, 'utf8'));
-    if (Date.now() - ts < CACHE_TTL_MS) return snap;
-  } catch {}
-  return null;
-}
-
-function writeCache(snap) {
-  try {
-    mkdirSync(CACHE_DIR, { recursive: true });
-    writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), snap }));
-  } catch {}
-}
-
-// --- fetch -------------------------------------------------------------------
-
-export async function getSnapshot(opts) {
-  if (opts.cache && opts.source !== 'pty') {
-    const cached = readCache();
-    if (cached) return cached;
-  }
-
-  let snap;
-  if (opts.source === 'pty') {
-    snap = fromPty(await captureUsageViaPty());
-  } else {
-    try {
-      const { accessToken } = await getAccessToken();
-      const raw = await fetchQuotaSummary(accessToken, { channel: opts.channel === 'auto' ? undefined : opts.channel });
-      snap = fromApi(raw);
-    } catch (err) {
-      if (opts.source === 'api') throw err;
-      // auto: fall back to PTY
-      process.stderr.write(`[api failed: ${err.message}] falling back to PTY (agy)…\n`);
-      snap = fromPty(await captureUsageViaPty());
-    }
-  }
-  writeCache(snap);
-  return snap;
-}
-
-// --- main --------------------------------------------------------------------
-
-async function once(opts) {
-  const snap = await getSnapshot(opts);
-  if (opts.json) process.stdout.write(JSON.stringify(snap, null, 2) + '\n');
-  else process.stdout.write(renderPanel(snap) + '\n');
-}
-
-async function main() {
-  const opts = parseArgs(process.argv.slice(2));
-  if (opts.help) { process.stdout.write(HELP); return; }
-  if (opts.version) { process.stdout.write(currentVersion() + '\n'); return; }
-  if (opts.command === 'update') { process.exit(await runUpdate({ checkOnly: opts.check })); }
-
-  if (opts.watch != null) {
-    const intervalMs = Math.max(5, opts.watch) * 1000;
-    const tick = async () => {
-      try {
-        if (!opts.json) process.stdout.write('\x1b[2J\x1b[H'); // clear screen
-        await once(opts);
-      } catch (err) {
-        process.stderr.write(`error: ${err.message}\n`);
-      }
-    };
-    await tick();
-    setInterval(tick, intervalMs);
-  } else {
-    await once(opts);
-  }
-}
-
-main().catch((err) => {
-  if (err instanceof CredentialError) {
-    process.stderr.write(`credential error: ${err.message}\n`);
-  } else {
-    process.stderr.write(`error: ${err.message}\n`);
-  }
-  process.exit(1);
-});

package/src/pty-fallback.js

@@ -1,211 +0,0 @@
-// Fallback path: drive the real `agy` TUI in a pseudo-terminal, send `/usage`,
-// reconstruct the rendered screen with a headless VT emulator, and parse the
-// panel. Used only when the direct API path is unavailable (no readable
-// keyring, or the internal API changed). Slower and more brittle than the API
-// path, but uses agy's own auth so it works wherever agy itself works.
-//
-// Why a VT emulator: agy renders /usage in the alternate screen buffer using
-// cursor addressing, so naive ANSI-stripping yields nothing. We feed the raw
-// PTY bytes through @xterm/headless to get the final visible screen, then parse.
-//
-// Capture backend: python3 `pty` on POSIX (no native build), node-pty on
-// Windows (ConPTY). agy shows a welcome screen first, so `/usage` is sent after
-// a delay and the session is held open long enough to render.
-
-import { spawn } from 'node:child_process';
-import { writeFileSync, readFileSync, mkdtempSync, existsSync } from 'node:fs';
-import { tmpdir, homedir } from 'node:os';
-import { join, delimiter } from 'node:path';
-
-// Resolve the agy binary: explicit AGY_BIN, then PATH, then common install dir.
-function resolveAgy() {
-  const explicit = process.env.AGY_BIN;
-  if (explicit) return explicit;
-  const exe = process.platform === 'win32' ? 'agy.exe' : 'agy';
-  for (const dir of (process.env.PATH || '').split(delimiter)) {
-    if (dir && existsSync(join(dir, exe))) return join(dir, exe);
-  }
-  const local = join(homedir(), '.local', 'bin', exe);
-  if (existsSync(local)) return local;
-  return 'agy'; // last resort: let the OS resolve it
-}
-
-const AGY_BIN = resolveAgy();
-const COLS = 120;
-const ROWS = 60;
-const USAGE_AT_MS = 10_000; // send /usage after the welcome screen settles
-const TEARDOWN_MS = 23_000; // keep session open long enough to render
-
-// --- capture: returns raw PTY bytes (Buffer) or null --------------------------
-
-async function captureViaNodePty() {
-  let pty;
-  try {
-    pty = await import('node-pty');
-  } catch {
-    return null;
-  }
-  return new Promise((resolve) => {
-    let term;
-    try {
-      term = pty.spawn(AGY_BIN, [], { name: 'xterm-256color', cols: COLS, rows: ROWS, cwd: process.cwd(), env: process.env });
-    } catch {
-      resolve(null);
-      return;
-    }
-    const chunks = [];
-    term.onData((d) => chunks.push(Buffer.from(d, 'utf8')));
-    const t1 = setTimeout(() => { try { term.write('/usage\r'); } catch {} }, USAGE_AT_MS);
-    const t2 = setTimeout(() => {
-      try { term.write('\x03'); } catch {}
-      try { term.kill(); } catch {}
-      resolve(Buffer.concat(chunks));
-    }, TEARDOWN_MS);
-    term.onExit(() => { clearTimeout(t1); clearTimeout(t2); resolve(Buffer.concat(chunks)); });
-  });
-}
-
-async function captureViaPython() {
-  if (process.platform === 'win32') return null;
-  const dir = mkdtempSync(join(tmpdir(), 'agy-usage-'));
-  const helper = join(dir, 'drive.py');
-  const outFile = join(dir, 'out.bin');
-  writeFileSync(
-    helper,
-    `import os, pty, time, select, signal, struct, fcntl, termios
-AGY = ${JSON.stringify(AGY_BIN)}
-out = open(${JSON.stringify(outFile)}, "wb")
-pid, fd = pty.fork()
-if pid == 0:
-    os.execvpe(AGY, [AGY], os.environ)
-    os._exit(127)
-fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack("HHHH", ${ROWS}, ${COLS}, 0, 0))
-start = time.time(); sent = False
-while time.time() - start < ${TEARDOWN_MS / 1000}:
-    e = time.time() - start
-    r, _, _ = select.select([fd], [], [], 0.5)
-    if r:
-        try: d = os.read(fd, 8192)
-        except OSError: break
-        if not d: break
-        out.write(d); out.flush()
-    if not sent and e > ${USAGE_AT_MS / 1000}:
-        os.write(fd, b"/usage\\r"); sent = True
-try: os.write(fd, b"\\x03")
-except OSError: pass
-try: os.kill(pid, signal.SIGTERM)
-except Exception: pass
-out.close()
-`,
-  );
-  return new Promise((resolve) => {
-    const proc = spawn('python3', [helper], { stdio: 'ignore' });
-    proc.on('error', () => resolve(null));
-    proc.on('exit', () => {
-      try { resolve(readFileSync(outFile)); } catch { resolve(null); }
-    });
-  });
-}
-
-// --- VT reconstruction --------------------------------------------------------
-
-async function reconstructScreen(raw) {
-  const mod = await import('@xterm/headless');
-  const Terminal = mod.Terminal ?? mod.default?.Terminal ?? mod.default;
-  const term = new Terminal({ cols: COLS, rows: ROWS, allowProposedApi: true, scrollback: 200 });
-  await new Promise((res) => term.write(raw, res));
-  const buf = term.buffer.active;
-  const lines = [];
-  // include scrollback so a panel taller than the viewport is still captured
-  for (let i = 0; i < buf.length; i++) {
-    const line = buf.getLine(i);
-    if (line) lines.push(line.translateToString(true).replace(/\s+$/, ''));
-  }
-  term.dispose?.();
-  return lines.join('\n');
-}
-
-// --- parse --------------------------------------------------------------------
-
-function parseDuration(text) {
-  let seconds = 0;
-  const d = text.match(/(\d+)\s*day/i);
-  const h = text.match(/(\d+)\s*h(?:our)?/i);
-  const m = text.match(/(\d+)\s*m(?:in)?/i);
-  if (d) seconds += +d[1] * 86400;
-  if (h) seconds += +h[1] * 3600;
-  if (m) seconds += +m[1] * 60;
-  return seconds || null;
-}
-
-/** Parse the reconstructed /usage screen text into { account, groups:[...] }. */
-export function parsePanel(text) {
-  const lines = text.split(/\r?\n/);
-  const account = text.match(/Account:\s*(\S+)/)?.[1] ?? null;
-
-  const groups = [];
-  let group = null;
-  let bucket = null;
-  const pushBucket = () => { if (group && bucket) group.buckets.push(bucket); bucket = null; };
-  const pushGroup = () => { pushBucket(); if (group) groups.push(group); group = null; };
-
-  for (const line of lines) {
-    const t = line.trim();
-    if (!t) continue;
-
-    if (/^[A-Z][A-Z0-9 &/]*MODELS$/.test(t)) {
-      pushGroup();
-      group = { name: t.replace(/\s+/g, ' '), models: '', buckets: [] };
-      continue;
-    }
-    const models = t.match(/^Models within this group:\s*(.+)$/i);
-    if (models && group) { group.models = models[1].trim(); continue; }
-
-    if (/^(Weekly Limit|Five Hour Limit|5[- ]?Hour Limit)$/i.test(t)) {
-      pushBucket();
-      bucket = {
-        kind: /week/i.test(t) ? 'weekly' : '5h',
-        label: t,
-        remainingFraction: null,
-        resetsInSeconds: null,
-        available: false,
-        description: null,
-      };
-      continue;
-    }
-    if (bucket) {
-      const pct = t.match(/(\d+(?:\.\d+)?)\s*%/);
-      if (pct && bucket.remainingFraction == null) bucket.remainingFraction = +pct[1] / 100;
-      if (/Quota available/i.test(t)) { bucket.available = true; bucket.remainingFraction = 1; }
-      const refresh = t.match(/Refreshes in (.+)$/i);
-      if (refresh) bucket.resetsInSeconds = parseDuration(refresh[1]);
-    }
-  }
-  pushGroup();
-  return { account, groups };
-}
-
-/**
- * Run agy, capture /usage, reconstruct + parse the panel.
- * @returns {Promise<{ account, groups }>}
- */
-export async function captureUsageViaPty() {
-  const order = process.platform === 'win32'
-    ? [captureViaNodePty, captureViaPython]
-    : [captureViaPython, captureViaNodePty];
-
-  let raw = null;
-  for (const fn of order) {
-    raw = await fn();
-    if (raw && raw.length) break;
-  }
-  if (!raw || !raw.length) {
-    throw new Error('No PTY backend captured agy output (need python3 on POSIX, or node-pty on Windows)');
-  }
-  const screen = await reconstructScreen(raw);
-  const parsed = parsePanel(screen);
-  if (!parsed.groups.length) {
-    throw new Error('Could not parse /usage panel from agy output');
-  }
-  return parsed;
-}

package/src/quota.js

@@ -1,100 +0,0 @@
-// Normalizes quota data from either source (direct API JSON or PTY-parsed text)
-// into one shape consumed by the renderer / JSON output / HTTP endpoint.
-//
-// Normalized model:
-//   {
-//     account, fetchedAt, source: 'api'|'pty', host?,
-//     note,                       // the API's overall description blurb
-//     groups: [
-//       { name, models,           // e.g. "Gemini Models", "Gemini Flash, Gemini Pro"
-//         buckets: [
-//           { kind: 'weekly'|'5h', label,
-//             remainingFraction,  // 0..1  (null if unknown)
-//             usedFraction,       // 1 - remaining
-//             resetAt,            // ISO string or null
-//             resetsInSeconds,    // derived from resetAt - now (null if unknown)
-//             available,          // true when nothing consumed (remainingFraction === 1)
-//             description } ] } ]
-//   }
-
-function bucketKind(window, label) {
-  if (window === 'weekly' || /week/i.test(label)) return 'weekly';
-  if (window === '5h' || /5.?hour|five.?hour/i.test(label)) return '5h';
-  return window || label;
-}
-
-function secondsUntil(resetAt, now) {
-  if (!resetAt) return null;
-  const ms = new Date(resetAt).getTime() - now;
-  return Number.isFinite(ms) ? Math.max(0, Math.round(ms / 1000)) : null;
-}
-
-/** Build a normalized snapshot from the raw retrieveUserQuotaSummary response. */
-export function fromApi({ raw, host, account, tier }, nowMs = Date.now()) {
-  const groups = (raw.groups ?? []).map((g) => ({
-    name: g.displayName ?? 'Models',
-    models: (g.description ?? '').replace(/^Models within this group:\s*/i, '').trim(),
-    buckets: (g.buckets ?? []).map((b) => {
-      const remaining = typeof b.remainingFraction === 'number' ? b.remainingFraction : null;
-      return {
-        kind: bucketKind(b.window, b.displayName ?? ''),
-        label: b.displayName ?? b.window ?? '',
-        remainingFraction: remaining,
-        usedFraction: remaining == null ? null : 1 - remaining,
-        resetAt: b.resetTime ?? null,
-        resetsInSeconds: secondsUntil(b.resetTime, nowMs),
-        available: remaining === 1,
-        description: b.description ?? null,
-      };
-    }),
-  }));
-  return {
-    account: account ?? null,
-    tier: tier ?? null,
-    fetchedAt: new Date(nowMs).toISOString(),
-    source: 'api',
-    host: host ?? null,
-    note: raw.description ?? null,
-    groups,
-  };
-}
-
-/**
- * Build a normalized snapshot from PTY-parsed groups (see pty-fallback.js).
- * Input groups: [{ name, models, buckets:[{ kind, label, remainingFraction,
- *   resetsInSeconds, available, description }] }]
- */
-export function fromPty(parsed, nowMs = Date.now()) {
-  const groups = (parsed.groups ?? []).map((g) => ({
-    name: g.name,
-    models: g.models ?? '',
-    buckets: (g.buckets ?? []).map((b) => ({
-      kind: b.kind,
-      label: b.label,
-      remainingFraction: b.remainingFraction ?? null,
-      usedFraction: b.remainingFraction == null ? null : 1 - b.remainingFraction,
-      resetAt: b.resetsInSeconds != null ? new Date(nowMs + b.resetsInSeconds * 1000).toISOString() : null,
-      resetsInSeconds: b.resetsInSeconds ?? null,
-      available: b.available ?? b.remainingFraction === 1,
-      description: b.description ?? null,
-    })),
-  }));
-  return {
-    account: parsed.account ?? null,
-    tier: null,
-    fetchedAt: new Date(nowMs).toISOString(),
-    source: 'pty',
-    host: null,
-    note: parsed.note ?? null,
-    groups,
-  };
-}
-
-/** Format a seconds duration like agy: "73h 53m" / "2h 7m" / "12m". */
-export function formatDuration(seconds) {
-  if (seconds == null) return null;
-  const h = Math.floor(seconds / 3600);
-  const m = Math.floor((seconds % 3600) / 60);
-  if (h > 0) return `${h}h ${m}m`;
-  return `${m}m`;
-}

package/src/render.js

@@ -1,82 +0,0 @@
-// Renders a normalized quota snapshot as a terminal panel, mirroring agy's
-// `/usage` layout (progress bar + percent + reset time per bucket).
-
-import { formatDuration } from './quota.js';
-
-const BAR_WIDTH = 50;
-
-const useColor = () => process.stdout.isTTY && !process.env.NO_COLOR;
-const c = (code, s) => (useColor() ? `\x1b[${code}m${s}\x1b[0m` : s);
-const dim = (s) => c('2', s);
-const bold = (s) => c('1', s);
-
-// remaining-based color: lots left = green, getting low = yellow/red.
-function barColor(remaining) {
-  if (remaining == null) return '37';
-  if (remaining > 0.5) return '32'; // green
-  if (remaining > 0.2) return '33'; // yellow
-  return '31'; // red
-}
-
-function bar(remainingFraction) {
-  const frac = remainingFraction == null ? 0 : Math.max(0, Math.min(1, remainingFraction));
-  const filled = Math.round(frac * BAR_WIDTH);
-  const body = '█'.repeat(filled) + '░'.repeat(BAR_WIDTH - filled);
-  return useColor() ? `\x1b[${barColor(remainingFraction)}m${body}\x1b[0m` : body;
-}
-
-function bucketLine(b) {
-  const lines = [];
-  lines.push(`    ${bold(b.label)}`);
-  if (b.available) {
-    lines.push(`    [${bar(1)}] ${c('32', 'Quota available')}`);
-  } else {
-    const pct = b.remainingFraction == null ? '—' : `${(b.remainingFraction * 100).toFixed(2)}%`;
-    const remainPct = b.remainingFraction == null ? '' : `${Math.round(b.remainingFraction * 100)}% remaining`;
-    const dur = formatDuration(b.resetsInSeconds);
-    const reset = dur ? ` · ${dim(`Refreshes in ${dur}`)}` : '';
-    lines.push(`    [${bar(b.remainingFraction)}] ${pct}`);
-    lines.push(`    ${dim(remainPct)}${reset}`);
-  }
-  return lines.join('\n');
-}
-
-/** Returns the full panel as a string. */
-export function renderPanel(snap) {
-  const out = [];
-  out.push('');
-  out.push(bold('  Models & Quota'));
-  if (snap.account) out.push(`  ${dim('Account:')} ${snap.account}`);
-  out.push(`  ${dim(`source: ${snap.source}${snap.host ? ` · ${snap.host}` : ''} · ${snap.fetchedAt}`)}`);
-  out.push('');
-
-  for (const g of snap.groups) {
-    out.push(bold(`  ${g.name.toUpperCase()}`));
-    if (g.models) out.push(`  ${dim(`Models within this group: ${g.models}`)}`);
-    out.push('');
-    for (const b of g.buckets) {
-      out.push(bucketLine(b));
-      out.push('');
-    }
-  }
-  if (snap.note) {
-    out.push(dim(wrap(snap.note, 76, '  │')));
-  }
-  return out.join('\n');
-}
-
-function wrap(text, width, prefix) {
-  const words = text.split(/\s+/);
-  const lines = [];
-  let cur = '';
-  for (const w of words) {
-    if ((cur + ' ' + w).trim().length > width) {
-      lines.push(prefix + cur);
-      cur = w;
-    } else {
-      cur = (cur + ' ' + w).trim();
-    }
-  }
-  if (cur) lines.push(prefix + cur);
-  return lines.join('\n');
-}