@songsid/agend 2.1.2-beta.8 → 2.1.2

package/dist/usage/format-rich.js

@@ -0,0 +1,121 @@
+const BAR_WIDTH = 10;
+/** `████░░░░░░` for 40%. Clamped — a vendor "105% used" must not overflow. */
+export function usageBar(percent) {
+    const filled = Math.round(Math.min(100, Math.max(0, percent)) / 100 * BAR_WIDTH);
+    return "█".repeat(filled) + "░".repeat(BAR_WIDTH - filled);
+}
+function statusDot(p) {
+    if (p.status === "error")
+        return "🔴";
+    if (p.status === "no-credentials")
+        return "⚪";
+    // Highest metric drives the colour: the reader scans for "which one is hot".
+    const hottest = Math.max(0, ...p.metrics.map(metricPercent).filter((v) => v !== null));
+    return hottest >= 90 ? "🔴" : hottest >= 70 ? "🟡" : "🟢";
+}
+/** A metric's fill percentage, when one can honestly be computed. */
+function metricPercent(m) {
+    if (m.type === "percent" && typeof m.used === "number")
+        return m.used;
+    if (m.type === "dollars" && typeof m.used === "number" && m.limit)
+        return (m.used / m.limit) * 100;
+    return null;
+}
+function resetSuffix(resetsAt) {
+    if (!resetsAt)
+        return "";
+    const at = new Date(resetsAt);
+    if (Number.isNaN(at.getTime()))
+        return "";
+    const hours = Math.round((at.getTime() - Date.now()) / 3_600_000);
+    if (hours <= 0)
+        return "";
+    return hours >= 48 ? ` · resets in ${Math.round(hours / 24)}d` : ` · resets in ${hours}h`;
+}
+function metricLine(m) {
+    const pct = metricPercent(m);
+    switch (m.type) {
+        case "percent":
+            return {
+                bar: usageBar(pct ?? 0),
+                // note explains WHICH number this is (e.g. "busiest of 8 models"); it is
+                // what stops a legitimate 0% from reading as a broken meter.
+                text: `${Math.round(m.used ?? 0)}% ${m.label}${m.note ? ` (${m.note})` : ""}${resetSuffix(m.resetsAt)}`,
+            };
+        case "dollars": {
+            const used = `$${(m.used ?? 0).toFixed(2)}`;
+            return m.limit
+                ? { bar: usageBar(pct ?? 0), text: `${used}/$${m.limit.toFixed(2)} ${m.label}` }
+                : { bar: null, text: `${used} ${m.label}` };
+        }
+        case "count":
+            return { bar: null, text: `${m.label}: ${m.value ?? "?"}${m.unit ? ` ${m.unit}` : ""}` };
+        case "text":
+            return m.value != null ? { bar: null, text: `${m.label}: ${m.value}` } : null;
+    }
+}
+function toBlocks(payload) {
+    return payload.providers.map(p => ({
+        dot: statusDot(p),
+        name: p.name,
+        plan: p.plan ?? null,
+        // An ok row can carry a hint too — e.g. "cached 3m ago — live query is rate
+        // limited" from the stale fallback. Shown under the metrics, not instead of
+        // them, so old numbers still read as numbers.
+        note: p.status === "no-credentials" ? "not logged in"
+            : p.status === "error" ? `⚠️ ${p.error ?? "error"}`
+                : null,
+        okHint: p.status === "ok" && p.hint ? p.hint : null,
+        lines: p.status === "ok" ? p.metrics.map(metricLine).filter((l) => l !== null) : [],
+    }));
+}
+/** Discord: native Markdown in plain message content. */
+export function renderUsageMarkdown(payload) {
+    const out = ["📊 **AI Subscription Usage**"];
+    for (const b of toBlocks(payload)) {
+        out.push("", `${b.dot} **${b.name}**${b.plan ? ` (${b.plan})` : ""}`);
+        if (b.note) {
+            out.push(`> ${b.note}`);
+            continue;
+        }
+        if (b.lines.length === 0) {
+            out.push(b.okHint ? `> ${b.okHint}` : "> no data");
+            continue;
+        }
+        for (const l of b.lines) {
+            out.push(l.bar ? `\`${l.bar}\` ${l.text}` : l.text);
+        }
+        if (b.okHint)
+            out.push(`> ${b.okHint}`);
+    }
+    return out.join("\n");
+}
+function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/**
+ * Telegram: HTML parse mode. Every payload-derived string is entity-escaped —
+ * provider errors and metric labels come from vendor responses, and one stray
+ * `<` would make Telegram reject the whole message.
+ */
+export function renderUsageHtml(payload) {
+    const out = ["📊 <b>AI Subscription Usage</b>"];
+    for (const b of toBlocks(payload)) {
+        out.push("", `${b.dot} <b>${escapeHtml(b.name)}</b>${b.plan ? ` (${escapeHtml(b.plan)})` : ""}`);
+        if (b.note) {
+            out.push(escapeHtml(b.note));
+            continue;
+        }
+        if (b.lines.length === 0) {
+            out.push(b.okHint ? escapeHtml(b.okHint) : "no data");
+            continue;
+        }
+        for (const l of b.lines) {
+            out.push(l.bar ? `<code>${l.bar}</code> ${escapeHtml(l.text)}` : escapeHtml(l.text));
+        }
+        if (b.okHint)
+            out.push(escapeHtml(b.okHint));
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=format-rich.js.map

package/dist/usage/format-rich.js.map

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

package/dist/usage/provider-alerts.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Rate-limit state that only the CLI can see, remembered for the usage panel.
+ *
+ * Antigravity's quota summary API reports per-model bucket pools — and those
+ * can read "0% used" while the account-level individual cap is exhausted.
+ * Verified live (2026-08-02, same minute): `agy -p` returned "Individual quota
+ * reached … Resets in 139h12m12s" while `retrieveUserQuotaSummary` reported
+ * every bucket at remainingFraction 1.0. No Google API exposes the individual
+ * cap; the generation error relayed through a running instance's pane is the
+ * only place it surfaces. So the daemon's error monitor reports it here, and
+ * the usage provider overlays it on the row that would otherwise say 🟢 0%.
+ *
+ * In-memory on purpose: the fleet process hosts both the error monitor and the
+ * usage provider, and a restart just means the alert reappears the next time an
+ * instance hits the cap.
+ */
+/**
+ * `Resets in 139h12m12s` → milliseconds. Null when the text carries no such
+ * phrase — the caller falls back to a default TTL rather than guessing.
+ */
+export declare function parseResetsIn(text: string): number | null;
+/**
+ * Record a CLI-observed rate limit for a usage provider. The alert expires by
+ * itself at the reset time the message names (or after an hour when it names
+ * none), which is what makes "reset 後警示消失" true without a cleanup job.
+ */
+export declare function reportProviderRateLimit(providerId: string, message: string, now?: number): void;
+/** The live alert for a provider, or null once its reset time has passed. */
+export declare function getProviderRateLimit(providerId: string, now?: number): {
+    message: string;
+    resetsAtMs: number;
+} | null;
+export declare function clearProviderRateLimitsForTests(): void;

package/dist/usage/provider-alerts.js

@@ -0,0 +1,57 @@
+/**
+ * Rate-limit state that only the CLI can see, remembered for the usage panel.
+ *
+ * Antigravity's quota summary API reports per-model bucket pools — and those
+ * can read "0% used" while the account-level individual cap is exhausted.
+ * Verified live (2026-08-02, same minute): `agy -p` returned "Individual quota
+ * reached … Resets in 139h12m12s" while `retrieveUserQuotaSummary` reported
+ * every bucket at remainingFraction 1.0. No Google API exposes the individual
+ * cap; the generation error relayed through a running instance's pane is the
+ * only place it surfaces. So the daemon's error monitor reports it here, and
+ * the usage provider overlays it on the row that would otherwise say 🟢 0%.
+ *
+ * In-memory on purpose: the fleet process hosts both the error monitor and the
+ * usage provider, and a restart just means the alert reappears the next time an
+ * instance hits the cap.
+ */
+const alerts = new Map();
+/**
+ * `Resets in 139h12m12s` → milliseconds. Null when the text carries no such
+ * phrase — the caller falls back to a default TTL rather than guessing.
+ */
+export function parseResetsIn(text) {
+    const m = text.match(/Resets? in (?:(\d+)h)?(?:(\d+)m)?(?:(\d+(?:\.\d+)?)s)?/i);
+    if (!m || (!m[1] && !m[2] && !m[3]))
+        return null;
+    return (Number(m[1] ?? 0) * 3600 + Number(m[2] ?? 0) * 60 + Number(m[3] ?? 0)) * 1000;
+}
+/** A cap with no parseable reset still should not alarm forever. */
+const DEFAULT_ALERT_TTL_MS = 60 * 60_000;
+/**
+ * Record a CLI-observed rate limit for a usage provider. The alert expires by
+ * itself at the reset time the message names (or after an hour when it names
+ * none), which is what makes "reset 後警示消失" true without a cleanup job.
+ */
+export function reportProviderRateLimit(providerId, message, now = Date.now()) {
+    const resetInMs = parseResetsIn(message);
+    alerts.set(providerId, {
+        message,
+        resetsAtMs: now + (resetInMs ?? DEFAULT_ALERT_TTL_MS),
+        reportedAtMs: now,
+    });
+}
+/** The live alert for a provider, or null once its reset time has passed. */
+export function getProviderRateLimit(providerId, now = Date.now()) {
+    const alert = alerts.get(providerId);
+    if (!alert)
+        return null;
+    if (now >= alert.resetsAtMs) {
+        alerts.delete(providerId);
+        return null;
+    }
+    return { message: alert.message, resetsAtMs: alert.resetsAtMs };
+}
+export function clearProviderRateLimitsForTests() {
+    alerts.clear();
+}
+//# sourceMappingURL=provider-alerts.js.map

package/dist/usage/provider-alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-alerts.js","sourceRoot":"","sources":["../../src/usage/provider-alerts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAChF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AACxF,CAAC;AAED,oEAAoE;AACpE,MAAM,oBAAoB,GAAG,EAAE,GAAG,MAAM,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,OAAe,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC3F,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE;QACrB,OAAO;QACP,UAAU,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,oBAAoB,CAAC;QACrD,YAAY,EAAE,GAAG;KAClB,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEvE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}

package/dist/usage/providers.d.ts

@@ -0,0 +1,130 @@
+import { type StatuslineRateLimits } from "./statusline-usage.js";
+export interface UsageMetric {
+    label: string;
+    type: "percent" | "dollars" | "count" | "text";
+    used?: number;
+    limit?: number;
+    value?: number | string;
+    unit?: string;
+    note?: string;
+    resetsAt?: string | null;
+    windowMs?: number | null;
+}
+export interface ProviderUsage {
+    id: string;
+    name: string;
+    status: "ok" | "error" | "no-credentials";
+    plan?: string | null;
+    error?: string;
+    hint?: string;
+    metrics: UsageMetric[];
+}
+/** `CLAUDE_CODE_OAUTH_TOKEN` as exported in a shell rc file, or null. */
+export declare function tokenFromShellRc(read: (path: string) => string, home?: string, files?: readonly string[]): string | null;
+/**
+ * Where the Claude OAuth bearer comes from, in preference order:
+ *
+ * 1. `~/.claude/.credentials.json` (`claudeAiOauth.accessToken`) when present and
+ *    unexpired — the interactive `/login` flow. Carries plan metadata.
+ * 2. `CLAUDE_CODE_OAUTH_TOKEN` — the long-lived (annual) token minted by
+ *    `claude setup-token`. Users on this flow often have NO credentials file at
+ *    all (or a stale one from an old login), which is why /usage showed them
+ *    "not logged in" / "token expired" while their CLI worked fine. Same token
+ *    family (`sk-ant-oat…`), same usage endpoint; it just carries no plan
+ *    metadata, so plan shows unknown.
+ * 3. The same variable as exported in a shell rc file. A systemd-launched daemon
+ *    inherits none of the user's interactive shell, so a `setup-token` login was
+ *    invisible to /usage unless the user duplicated it into ~/.agend/.env.
+ * 4. An expired file token with no other source stays an explicit error.
+ * 5. `ANTHROPIC_API_KEY` alone is named in the hint but NOT used: console API
+ *    keys are pay-per-token and have no subscription usage to query — the OAuth
+ *    endpoint rejects them, and pretending otherwise would render a misleading
+ *    error instead of an accurate "log in" hint.
+ */
+export declare function resolveClaudeAuth(file: {
+    accessToken?: string;
+    expiresAt?: number;
+    subscriptionType?: string;
+    rateLimitTier?: string;
+} | null, env?: NodeJS.ProcessEnv, rcLookup?: () => string | null): {
+    token: string;
+    plan: string | null;
+} | {
+    error: string;
+    plan: string | null;
+} | null;
+/**
+ * Render a statusline reading as provider metrics.
+ *
+ * Kept deliberately close to the API path's shape so the panel looks the same
+ * wherever the numbers came from — the hint is what tells the difference, and
+ * it names the source because a number with no provenance invites "is this
+ * even live?".
+ */
+export declare function statuslineUsage(reading: StatuslineRateLimits, plan: string | null, now?: number): Omit<ProviderUsage, "id" | "name">;
+/** Exported for tests — the statusline/API preference order is the subject. */
+export declare function fetchClaudeUsage(): Promise<Omit<ProviderUsage, "id" | "name">>;
+interface AgyBucket {
+    bucketId?: string;
+    displayName?: string;
+    remainingFraction?: number;
+    resetTime?: string;
+}
+/**
+ * Pool the summary's buckets into at most four metrics.
+ *
+ * Two payload shapes exist. Older accounts report pooled ids (`gemini-5h`,
+ * `gemini-weekly`, `3p-5h`, `3p-weekly`), which map 1:1. This machine's live
+ * response instead lists PER-MODEL buckets (`gemini-3.6-flash-high`,
+ * `claude-sonnet-4-6`, `gpt-oss-120b-medium`, …) — those aggregate into a
+ * Gemini pool and an everything-else pool, keeping each pool's WORST remaining
+ * fraction, because eleven per-model meters is noise and the binding constraint
+ * is the one that runs out first.
+ */
+export declare function agyPoolMetrics(buckets: AgyBucket[]): UsageMetric[];
+interface AgyStoredToken {
+    access_token?: string;
+    refresh_token?: string;
+    expiry?: string;
+    expiry_date?: number;
+}
+/**
+ * agy's token file, in either shape.
+ *
+ * This machine writes it nested (`{ token: {...}, id_token, auth_method }`),
+ * which is what the provider was built against. Flat (`{ access_token, ... }`)
+ * is accepted too — it costs one `??` and other installs or future agy versions
+ * may differ. `expiry_date` (epoch ms, the shape ~/.gemini/oauth_creds.json
+ * uses) is read alongside `expiry` (RFC3339) for the same reason.
+ */
+export declare function readAgyToken(file: unknown): AgyStoredToken;
+interface KiroToken {
+    access_token?: string;
+    expires_at?: string;
+    region?: string;
+    profile_arn?: string;
+    /** IAM Identity Center portal URL — present only for Q Developer Pro logins. */
+    start_url?: string;
+    /** Social login provider (google/github/…) — present only for free-tier logins. */
+    provider?: string;
+}
+/**
+ * Which Kiro login is in use. Verified against a real kiro-cli auth store:
+ * - IAM Identity Center (Amazon Q Developer Pro) tokens carry `start_url`
+ *   (e.g. `https://d-xxxx.awsapps.com/start/`) and no social `provider`.
+ * - Free-tier social logins (Builder ID / Google / GitHub) carry `provider`
+ *   and a `profile_arn`.
+ * Q Developer Pro is a seat-licensed subscription, so the credit/usage endpoint
+ * that Builder ID reports against does not describe it.
+ */
+export type KiroAuthKind = "q-developer-pro" | "builder-id";
+export declare function kiroAuthKind(token: KiroToken): KiroAuthKind;
+/** Exported for tests: the Q-Pro and expired paths return without any network call. */
+export declare function fetchKiroUsage(): Promise<Omit<ProviderUsage, "id" | "name">>;
+/** Fetch every provider in parallel. Providers without local credentials are
+ * skipped (per the panel's contract: absent CLIs simply don't show). */
+export declare function fetchAllUsage(): Promise<{
+    fetchedAt: string;
+    providers: ProviderUsage[];
+}>;
+export {};