agy-cli-usage 0.3.1 → 0.4.0

package/dist/src/update.js

@@ -0,0 +1,87 @@
+// Self-update + version helpers for the CLI.
+//
+// `agy-cli-usage update`        check the registry and `npm install -g` if newer
+// `agy-cli-usage update --check` report only, don't install
+// `agy-cli-usage --version`     print the installed version
+import { execFileSync, spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+const PKG_NAME = 'agy-cli-usage';
+/**
+ * Installed version, read from this package's package.json.
+ * NOTE: this module compiles to dist/src/update.js, so package.json (at the
+ * package root) is two levels up.
+ */
+export function currentVersion() {
+    const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+    return pkg.version;
+}
+/**
+ * Compare two dotted versions numerically (prerelease tags ignored).
+ * Returns negative if a<b, 0 if equal, positive if a>b.
+ */
+export function semverCompare(a, b) {
+    const norm = (v) => String(v)
+        .replace(/^v/, '')
+        .split('-')[0]
+        .split('.')
+        .map((n) => parseInt(n, 10) || 0);
+    const pa = norm(a);
+    const pb = norm(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] || 0) - (pb[i] || 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+/** Latest published version: prefer the user's configured registry (npm view), fall back to public. */
+export async function latestVersion() {
+    try {
+        const out = execFileSync('npm', ['view', PKG_NAME, 'version'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (out)
+            return out;
+    }
+    catch {
+        // npm missing or offline — try the public registry directly
+    }
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`);
+        if (res.ok)
+            return (await res.json()).version;
+    }
+    catch {
+        // offline
+    }
+    return null;
+}
+/** Run the update flow. Returns the intended process exit code. */
+export async function runUpdate({ checkOnly = false } = {}) {
+    const current = currentVersion();
+    const latest = await latestVersion();
+    if (!latest) {
+        process.stderr.write('Could not determine the latest version (offline or npm unavailable).\n');
+        return 1;
+    }
+    if (semverCompare(latest, current) <= 0) {
+        process.stdout.write(`agy-cli-usage is up to date (${current}).\n`);
+        return 0;
+    }
+    process.stdout.write(`Update available: ${current} -> ${latest}\n`);
+    if (checkOnly) {
+        process.stdout.write('Run `agy-cli-usage update` to install it.\n');
+        return 0;
+    }
+    process.stdout.write(`Installing ${PKG_NAME}@${latest} globally…\n`);
+    const r = spawnSync('npm', ['install', '-g', `${PKG_NAME}@${latest}`], { stdio: 'inherit' });
+    if (r.error) {
+        process.stderr.write(`Failed to run npm: ${r.error.message}\nInstall manually: npm install -g ${PKG_NAME}@latest\n`);
+        return 1;
+    }
+    if (r.status === 0)
+        process.stdout.write(`Updated to ${latest}.\n`);
+    return r.status ?? 0;
+}
+//# sourceMappingURL=update.js.map

package/dist/src/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,24 +1,27 @@
 {
   "name": "agy-cli-usage",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Headless usage/quota monitor for the Antigravity CLI (agy) — reads Cloud Code quota directly, with a PTY fallback. No IDE required.",
   "type": "module",
+  "types": "dist/src/main.d.ts",
   "bin": {
-    "agy-cli-usage": "src/main.js",
-    "agy-usage": "src/main.js"
+    "agy-cli-usage": "dist/src/main.js",
+    "agy-usage": "dist/src/main.js"
   },
   "scripts": {
-    "start": "node src/main.js",
-    "serve": "node server.js",
-    "test": "node --test",
-    "check": "node --check src/main.js && node --check server.js"
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "pretest": "tsc",
+    "test": "node --test dist/test/unit.test.js",
+    "start": "tsc && node dist/src/main.js",
+    "serve": "tsc && node dist/src/server.js",
+    "prepack": "tsc"
   },
   "engines": {
     "node": ">=18"
   },
   "files": [
-    "src/",
-    "server.js",
+    "dist/src/",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -49,5 +52,9 @@
   "optionalDependencies": {
     "node-pty": "^1.0.0"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3"
+  }
 }

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;
-}