agy-cli-usage 0.3.0 → 0.4.0

package/dist/src/main.js

@@ -0,0 +1,169 @@
+#!/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;
+const errMessage = (e) => (e instanceof Error ? e.message : String(e));
+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] ?? 'auto');
+        else if (a === '--channel')
+            o.channel = (argv[++i] ?? 'auto');
+        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 {
+        /* no/expired cache */
+    }
+    return null;
+}
+function writeCache(snap) {
+    try {
+        mkdirSync(CACHE_DIR, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), snap }));
+    }
+    catch {
+        /* cache is best-effort */
+    }
+}
+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: ${errMessage(err)}] 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: ${errMessage(err)}\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: ${errMessage(err)}\n`);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

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

package/dist/src/pty-fallback.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedPanel } from './types.js';
+/** Parse the reconstructed /usage screen text into { account, groups:[...] }. */
+export declare function parsePanel(text: string): ParsedPanel;
+/** Run agy, capture /usage, reconstruct + parse the panel. */
+export declare function captureUsageViaPty(): Promise<ParsedPanel>;

package/dist/src/pty-fallback.js

@@ -0,0 +1,221 @@
+// 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() {
+    // node-pty is an optional dependency; defeat static module resolution so the
+    // build doesn't require it (CI installs with --omit=optional).
+    const moduleName = 'node-pty';
+    let pty;
+    try {
+        pty = await import(moduleName);
+    }
+    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 { /* ignore */ } }, USAGE_AT_MS);
+        const t2 = setTimeout(() => {
+            try {
+                term.write('\x03');
+            }
+            catch { /* ignore */ }
+            try {
+                term.kill();
+            }
+            catch { /* ignore */ }
+            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 { Terminal } = await import('@xterm/headless');
+    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();
+            const kind = /week/i.test(t) ? 'weekly' : '5h';
+            bucket = { kind, 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. */
+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;
+}
+//# sourceMappingURL=pty-fallback.js.map

package/dist/src/pty-fallback.js.map

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

package/dist/src/quota.d.ts

@@ -0,0 +1,7 @@
+import type { FetchResult, ParsedPanel, Snapshot } from './types.js';
+/** Build a normalized snapshot from the raw retrieveUserQuotaSummary response. */
+export declare function fromApi({ raw, host, account, tier }: FetchResult, nowMs?: number): Snapshot;
+/** Build a normalized snapshot from PTY-parsed groups (see pty-fallback.ts). */
+export declare function fromPty(parsed: ParsedPanel, nowMs?: number): Snapshot;
+/** Format a seconds duration like agy: "73h 53m" / "2h 7m" / "12m". */
+export declare function formatDuration(seconds: number | null): string | null;

package/dist/src/quota.js

@@ -0,0 +1,81 @@
+// Normalizes quota data from either source (direct API JSON or PTY-parsed text)
+// into one shape consumed by the renderer / JSON output / HTTP endpoint.
+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.ts). */
+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`;
+}
+//# sourceMappingURL=quota.js.map

package/dist/src/quota.js.map

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

package/dist/src/render.d.ts

@@ -0,0 +1,3 @@
+import type { Snapshot } from './types.js';
+/** Returns the full panel as a string. */
+export declare function renderPanel(snap: Snapshot): string;

package/dist/src/render.js

@@ -0,0 +1,82 @@
+// 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 = () => Boolean(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');
+}
+//# sourceMappingURL=render.js.map

package/dist/src/render.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};