@ohgodtamit/pi-usage 0.1.0-alpha.0

package/dist/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../src/prices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAuC3D,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Active-provider detection and live quota fetching.
+ *
+ * The usage panel surfaces TWO independent signals about your active provider:
+ *
+ *   1. Live money quota   — fetched from the provider's billing API when it has
+ *                           one (OpenRouter credits, OpenAI costs). This is the
+ *                           provider's own view of your account.
+ *   2. Rate-limit headers — captured from every provider HTTP response via the
+ *                           `after_provider_response` event. These are universal
+ *                           (Anthropic, OpenAI, OpenRouter, Google, … all return
+ *                           them) and reflect the live per-window limits applied
+ *                           to your current API key.
+ *
+ * API keys are resolved through the session's model registry, the same path pi
+ * uses for request-time credentials and OAuth refresh.
+ */
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { type ModelRegistry } from "@earendil-works/pi-coding-agent";
+/** Resolve a provider's current request credential, including refreshed OAuth. */
+export declare function resolveApiKey(modelRegistry: ModelRegistry, provider: string): Promise<string | undefined>;
+/** Check whether pi can currently resolve authentication for a provider. */
+export declare function hasProviderKey(modelRegistry: ModelRegistry, provider: string): Promise<boolean>;
+export interface ActiveProvider {
+    provider: string;
+    modelId: string;
+    baseUrl: string;
+    api: string;
+    /** True when an API key for this provider is resolvable from the environment. */
+    hasKey: boolean;
+}
+/** Detect the currently active provider/model from the session context. */
+export declare function detectActiveProvider(modelRegistry: ModelRegistry, model: Model<Api> | undefined): Promise<ActiveProvider | null>;
+export interface RateLimitWindow {
+    /** "requests" | "tokens" | "input-tokens" | "output-tokens" */
+    resource: string;
+    /** Approximate window label, e.g. "tokens/min". Heuristic per provider tier. */
+    window: string;
+    limit: number;
+    remaining: number;
+    /** Epoch ms when the window resets, or 0 if unknown. */
+    resetMs: number;
+}
+export interface ProviderQuota {
+    active: ActiveProvider | null;
+    fetchedAt: number;
+    /** Live account credits (OpenRouter). Undefined when not applicable/available. */
+    credits?: {
+        total: number;
+        used: number;
+        remaining: number;
+    };
+    /** Live provider spend in USD (OpenAI organization/costs API). Best-effort. */
+    spend5h?: number;
+    spend7d?: number;
+    monthlyLimit?: number;
+    /**
+     * Provider-native plan quotas (ZAI GLM coding plans, OpenAI Codex subscription):
+     * session (5h) and weekly (7d) windows reported directly by the upstream as a
+     * used percentage with a live reset countdown. These replace the session-derived bars.
+     */
+    planQuota?: {
+        plan: string;
+        session5h?: {
+            usedPct: number;
+            resetMs: number;
+        };
+        weekly?: {
+            usedPct: number;
+            resetMs: number;
+        };
+        webSearches?: {
+            used: number;
+            limit: number;
+            resetMs: number;
+        };
+        /** Purchased credits balance (OpenAI Codex), when reported. */
+        credits?: {
+            balance: number;
+            unlimited: boolean;
+        };
+    };
+    /** Rate-limit windows captured from the most recent provider response. */
+    rateLimits: RateLimitWindow[];
+    /** "live" if a billing API responded, "headers" if only rate-limit headers, "none" otherwise. */
+    source: "live" | "headers" | "none";
+    /** Human hints (e.g. why live quota is unavailable). */
+    notes: string[];
+    error?: string;
+}
+/**
+ * Parse provider rate-limit headers into structured windows.
+ *
+ * Recognizes three conventions and de-dupes by resource:
+ *   - Anthropic: `anthropic-ratelimit-{resource}-{limit|remaining|reset}`
+ *   - OpenAI:    `x-ratelimit-{limit|remaining|reset}-{resource}`
+ *   - Generic:   `x-ratelimit-{limit|remaining|reset}` (older/simpler APIs)
+ *
+ * Pi lowercases all header keys, so matching is case-insensitive by contract.
+ */
+export declare function parseRateLimits(headers: Record<string, string>, now?: number): RateLimitWindow[];
+/**
+ * Parse a reset value into an epoch-ms timestamp.
+ *
+ * Handles ISO-8601 timestamps ("2024-01-01T12:00:00Z"), OpenAI-style durations
+ * ("6m0s", "500ms", "2h"), and bare-seconds integers.
+ */
+export declare function parseReset(value: string | undefined, now: number): number;
+/**
+ * Parse OpenAI Codex subscription quota from response headers captured via
+ * `after_provider_response`. This is the reliable path: the headers come fresh
+ * from pi's own authenticated Codex request, so there is no token/refresh
+ * management (unlike the `/wham/usage` REST endpoint, whose OAuth token in
+ * `~/.codex/auth.json` is frequently stale/rotated).
+ *
+ * Header families (authoritative: openai/codex rate_limits.rs):
+ *   x-codex-primary-used-percent        — 5h rolling window used % (0-100)
+ *   x-codex-primary-reset-at            — unix SECONDS of next reset
+ *   x-codex-secondary-used-percent      — 7-day rolling window used %
+ *   x-codex-secondary-reset-at          — unix SECONDS
+ *   x-codex-credits-has-credits / -unlimited / -balance  — purchased credits
+ *   x-codex-limit-name                  — plan/limit display name
+ *
+ * Returns the planQuota shape (shared with ZAI) when any Codex window is present.
+ */
+export declare function parseCodexQuota(headers: Record<string, string>): NonNullable<ProviderQuota["planQuota"]> | undefined;
+/**
+ * Fetch OpenAI Codex subscription quota from the REST endpoint using pi's
+ * request-time credential resolver, which refreshes OAuth before returning.
+ */
+export declare function fetchCodexQuota(modelRegistry: ModelRegistry, provider?: string, signal?: AbortSignal): Promise<{
+    quota: NonNullable<ProviderQuota["planQuota"]>;
+    error?: string;
+} | {
+    quota: undefined;
+    error: string;
+} | undefined>;
+/**
+ * Build a full provider quota snapshot: merge already-captured rate-limit
+ * headers with a fresh live fetch from the provider's billing API (if any).
+ *
+ * `capturedRateLimits` comes from the `after_provider_response` event in the
+ * orchestrator (index.ts), so it reflects the most recent real request made by
+ * the active provider.
+ */
+export declare function fetchProviderQuota(modelRegistry: ModelRegistry, active: ActiveProvider | null, capturedRateLimits: RateLimitWindow[], capturedHeaders?: Record<string, string>, signal?: AbortSignal): Promise<ProviderQuota>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,iCAAiC,CAAC;AAM3F,kFAAkF;AAClF,wBAAsB,aAAa,CACjC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAClC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAUhC;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,WAAW,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,+DAA+D;QAC/D,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;KACnD,CAAC;IACF,0EAA0E;IAC1E,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,iGAAiG;IACjG,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,GAAG,GAAE,MAAmB,GACvB,eAAe,EAAE,CAiEnB;AAiBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA2BzE;AAgJD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,GAAG,SAAS,CAyCrD;AAyCD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,aAAa,EAC5B,QAAQ,SAAiB,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CACN;IAAE,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC,SAAS,CACZ,CAgFA;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,kBAAkB,EAAE,eAAe,EAAE,EACrC,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAmGxB"}

package/dist/view.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Interactive usage panel TUI component.
+ *
+ * Rendered via ctx.ui.custom(). Mirrors Claude Code's `/usage` screen:
+ * always-visible 5-hour and weekly quota bars, a selectable time window, and
+ * independent-characteristic breakdowns by model / skill / plugin / tool /
+ * project. Supports vertical scrolling for small terminals.
+ */
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { TUI } from "@earendil-works/pi-tui";
+import { type AttributionMaps, type Report, type StatsRange, type WindowKey } from "./aggregate.ts";
+import { type ViewKey } from "./mascot.ts";
+import type { ProviderQuota } from "./provider.ts";
+export type { ViewKey } from "./mascot.ts";
+/** Sort field for the Models table. */
+type SortKey = "value" | "name";
+/** Sort field + direction for the Daily table. */
+type DailySortField = "tokens" | "cost" | "date";
+/** Semantic controls shared by terminal key handling and portable UI clients. */
+export type UsageAction = {
+    type: "view";
+    view: ViewKey;
+} | {
+    type: "window";
+    window: WindowKey;
+} | {
+    type: "modelSort";
+    sort: SortKey;
+} | {
+    type: "dailySort";
+    sort: DailySortField;
+} | {
+    type: "statsRange";
+    range: StatsRange;
+} | {
+    type: "providerSort";
+    sort: SortKey;
+} | {
+    type: "wrappedYear";
+    year: number;
+} | {
+    type: "wrappedYearDelta";
+    delta: number;
+} | {
+    type: "refresh";
+} | {
+    type: "configure";
+} | {
+    type: "close";
+};
+export interface UsageViewDeps {
+    theme: Theme;
+    tui: TUI | undefined;
+    maps: AttributionMaps;
+    home: string;
+    getConfig: () => {
+        fiveHourLimit?: number;
+        weeklyLimit?: number;
+        fiveHourTokenLimit?: number;
+        weeklyTokenLimit?: number;
+    };
+    onClose: () => void;
+    onRefresh: () => void;
+    onConfigure: () => void;
+}
+export declare class UsageView {
+    private readonly deps;
+    private portableRendering;
+    private state;
+    constructor(deps: UsageViewDeps);
+    /** Set the initial view (used by /usage-models, /usage-daily, … shortcuts). */
+    setInitialView(view: ViewKey): void;
+    get activeView(): ViewKey;
+    get wrappedYears(): number[];
+    /** Apply a UI-independent dashboard action. */
+    applyAction(action: UsageAction): void;
+    /** Re-bind the TUI/theme/close callback once pi's custom() factory runs. */
+    bind(tui: TUI, theme: Theme, onClose: () => void): void;
+    setReport(report: Report): void;
+    setScanning(loaded: number, total: number): void;
+    setError(message: string): void;
+    setProviderQuota(quota: ProviderQuota): void;
+    handleInput(data: string): void;
+    render(width: number): string[];
+    /** Render all lines without terminal viewport assumptions or key-based instructions. */
+    renderPortable(width: number): string[];
+    /** Final width clamp so one long line can never break the TUI layout. */
+    private clampLine;
+    invalidate(): void;
+    private availableHeight;
+    private setWindow;
+    private setView;
+    private cycleView;
+    private setStatsRange;
+    /** Set the Daily sort field; pressing the same field again flips direction. */
+    private setDailySort;
+    private cycleWrappedYear;
+    private scrollBy;
+    private scrollTo;
+    private clampScroll;
+    private buildLines;
+    /**
+     * Subscription-aware breakdown unit: token-priced providers (Codex, ZAI
+     * plans) always show tokens; otherwise USD when the window has real cost.
+     */
+    private unitForWindow;
+    private renderOverview;
+    /** Render the always-on quota bars (plan quota or session-derived budget). */
+    private renderQuotaBlock;
+    private renderModels;
+    /**
+     * Models table styled like the Skills section (name · % · bar · value), with
+     * an extra column for the average generation speed (estimated tok/s).
+     */
+    private appendModelTable;
+    private renderDelegation;
+    private windowDuration;
+    private zeroBucket;
+    private addUsageToBucket;
+    private renderDaily;
+    private renderHourly;
+    private renderProviders;
+    private renderWrapped;
+    /** Hairline section label — matches Stats/Daily report rhythm. */
+    private wrappedSectionHeader;
+    /** Pi-chan footer card — character accent, professional tone. */
+    private wrappedInsightBox;
+    /** Side-by-side mascot + content when the terminal is wide enough. */
+    private appendMascotBlock;
+    private wrappedBannerLine;
+    private appendWrappedHero;
+    private appendWrappedMonthly;
+    /**
+     * Claude Code / Stats-style vertical month columns: graded blocks, month
+     * labels, Less→More legend, and a peak-month callout.
+     */
+    private appendWrappedMonthlyHeatmap;
+    /** Narrow-terminal fallback: horizontal share bars (same geometry as Rankings). */
+    private appendWrappedMonthlyRows;
+    private appendWrappedHighlights;
+    private appendWrappedTops;
+    private renderStats;
+    /** Interactive range selector for the Stats view (All / 7d / 30d). */
+    private statsRangeLine;
+    /** Render stat pairs in two aligned columns. */
+    private appendStatGrid;
+    /** A playful one-liner comparing total usage to a familiar reference. */
+    private statsFunFact;
+    /**
+     * GitHub-style contribution heatmap: a month-label header row, then 7 day
+     * rows (Sun..Sat) of graded square cells, then a Less→More legend.
+     */
+    private heatmapColor;
+    /** Map a 0–1 usage ratio to heatmap intensity (matches Stats view). */
+    private heatmapLevel;
+    private appendContribGraph;
+    /** Sparkline of the last 30 active-window days (Overview trend strip). */
+    private appendTrendSparkline;
+    private portableMenuLines;
+    private menuLines;
+    private titleLineRaw;
+    private windowTabs;
+    private subheaderLine;
+    private quotaLine;
+    /**
+     * Render an upstream-reported percentage quota bar (e.g. ZAI 5h/weekly).
+     * The provider only exposes `usedPct` (0-100) + a reset countdown, so the bar
+     * shows used%, remaining%, and when the window resets.
+     */
+    private percentLine;
+    /**
+     * Build a context-aware hint explaining why the subscription quota isn't
+     * shown yet. Subscriptions (OpenAI Codex, ZAI coding plans) get their quota
+     * from the upstream — the panel must never suggest `/usage-config` for
+     * these, because that would be wrong (it would just aggregate session
+     * history, not the real plan quota).
+     */
+    private buildSubscriptionHint;
+    private appendTokenComposition;
+    private statsLine;
+    private topConsumer;
+    /** Render the active-provider banner + live quota + rate-limit windows. */
+    private appendProviderSection;
+    /** Compact single-line bar: `[label] ██████░░░░ right` */
+    private miniBar;
+    /**
+     * One aligned table-header row: the section title fills the label column and
+     * the column labels (`%`, value unit, optional extra) sit directly above
+     * their data columns. Keeps every breakdown section visually consistent.
+     */
+    private tableHeader;
+    private appendToolsSection;
+    private appendSection;
+    /**
+     * Plugin usage section: ranks plugins by their attributed usage and shows the
+     * specific skills/tools that drove each one, plus the "core" remainder
+     * (turns with only builtin tools and no skill — i.e. plain pi usage).
+     *
+     * Plugins are independent characteristics: a single turn can credit several
+     * plugins, so the percentages need not sum to 100. The core line is the
+     * complement (turns attributed to NO plugin).
+     */
+    private appendPluginUsageSection;
+    private portableFooterLine;
+    private footerLine;
+}
+//# sourceMappingURL=view.d.ts.map

package/dist/view.d.ts.map

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

package/dist/zai.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure ZAI (Zhipu / GLM coding plans) quota-limit classification.
+ *
+ * Extracted from provider.ts into its own module so it has ZERO pi / pi-ai
+ * runtime dependencies and is unit-testable without network or auth. The
+ * network layer (provider.ts) imports `classifyZaiLimits` from here.
+ *
+ * The return shape is structurally compatible with the `planQuota` field on
+ * provider.ts's `ProviderQuota` (a subset: ZAI never reports purchased
+ * credits, only the 5h/weekly windows + web searches), so it can be returned
+ * directly from `fetchZaiPlanQuota`.
+ */
+/** A single quota window in ZAI's /quota/limit response. */
+export interface ZaiQuotaLimit {
+    type?: string;
+    unit?: number;
+    number?: number;
+    usage?: number;
+    currentValue?: number;
+    remaining?: number;
+    percentage?: number;
+    nextResetTime?: number;
+}
+/** Provider-native plan quota fragment produced from a ZAI limits array. */
+export interface ZaiPlanQuota {
+    plan: string;
+    session5h?: {
+        usedPct: number;
+        resetMs: number;
+    };
+    weekly?: {
+        usedPct: number;
+        resetMs: number;
+    };
+    webSearches?: {
+        used: number;
+        limit: number;
+        resetMs: number;
+    };
+}
+/**
+ * Classify a ZAI /quota/limit `limits[]` into the planQuota shape.
+ *
+ * PURE function (no network). Detection strategy (robust across ZAI plan
+ * tiers and regions):
+ *   1. Prefer the documented exact identifiers verified on the "max" plan:
+ *      session 5h = (unit 3, number 5), weekly 7d = (unit 6, number 1).
+ *   2. Fall back to positional pairing: ZAI only ever reports these two
+ *      token windows, so the window that is NOT the session is the weekly.
+ *      This keeps weekly resolving when other plans/regions encode the window
+ *      with different unit/number values — the production bug where only the
+ *      5h bar appeared for non-"max" accounts.
+ *   3. When neither exact code matches, assign by reset-window length: the
+ *      shorter countdown maps to the 5h session, the longer to weekly.
+ */
+export declare function classifyZaiLimits(limits: ZaiQuotaLimit[], level: string): ZaiPlanQuota | undefined;
+//# sourceMappingURL=zai.d.ts.map

package/dist/zai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zai.d.ts","sourceRoot":"","sources":["../src/zai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAiD1B"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@ohgodtamit/pi-usage",
+  "version": "0.1.0-alpha.0",
+  "description": "Usage dashboards, attribution, and live provider quotas for Pi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GodTamIt/pi-mono.git",
+    "directory": "packages/pi-usage"
+  },
+  "homepage": "https://github.com/GodTamIt/pi-mono/tree/master/packages/pi-usage#readme",
+  "bugs": {
+    "url": "https://github.com/GodTamIt/pi-mono/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "pi-package"
+  ],
+  "engines": {
+    "node": ">=22.22.2"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit --declaration false --declarationMap false",
+    "unit": "vitest run",
+    "test": "npm run unit",
+    "declarations": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.declarations.json",
+    "prepack": "npm run declarations",
+    "pack:inspect": "node ./scripts/inspect-package.mjs",
+    "smoke:installed": "node ./test/installed/smoke.mjs"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.84.3 <0.85.0",
+    "@earendil-works/pi-ai": ">=0.84.3 <0.85.0",
+    "@earendil-works/pi-tui": ">=0.84.3 <0.85.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.3",
+    "@earendil-works/pi-ai": "0.84.3",
+    "@earendil-works/pi-tui": "0.84.3"
+  }
+}