@songsid/agend 2.1.2-beta.2 → 2.1.2-beta.21

package/dist/usage/providers.d.ts

@@ -0,0 +1,97 @@
+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[];
+}
+/**
+ * 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. An expired file token with no env fallback stays an explicit error.
+ * 4. `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): {
+    token: string;
+    plan: string | null;
+} | {
+    error: string;
+    plan: string | null;
+} | null;
+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 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 {};