@ohgodtamit/pi-usage 0.1.0-alpha.0

package/dist/aggregate.d.ts

@@ -0,0 +1,392 @@
+/**
+ * Session aggregation and usage attribution.
+ *
+ * The usage panel mirrors Claude Code's `/usage` view: it shows how spend and
+ * tokens are distributed across models, skills, plugins, tools, and projects,
+ * bucketed by time window (5h / 24h / 7d / all).
+ *
+ * Data source
+ * -----------
+ * Pi stores per-turn usage (tokens + cost) on every assistant message across
+ * all session JSONL files under ~/.pi/agent/sessions/. We open each file once,
+ * walk its entries in append order, and attribute each assistant turn to:
+ *   - a model        (from message.model)
+ *   - a project      (from the session header cwd)
+ *   - skill(s)       (detected via parseSkillBlocks on the preceding user msg)
+ *   - tools/plugins  (from the tool calls inside the assistant message)
+ *
+ * Important: skills, plugins, tools and models are *independent characteristics*
+ * of usage, not a disjoint partition — a single turn can contribute to several
+ * buckets at once (exactly like Claude Code's wording). Percentages therefore
+ * do not sum to 100% across categories.
+ */
+import type { Usage } from "@earendil-works/pi-ai";
+import { type ExtensionAPI, type SessionInfo } from "@earendil-works/pi-coding-agent";
+import type { ScanCache } from "./cache.ts";
+import type { ModelPrice } from "./config.ts";
+/** A lookup of manual model prices ($/Mtok), keyed by model ID. */
+export type PriceMap = Record<string, ModelPrice>;
+/**
+ * Resolve a manual price for a model: exact match first, then by base name
+ * (after the last `/`) so an entry like `claude-opus-4.7` covers proxied
+ * variants such as `kr/claude-opus-4.7` and `cx/claude-opus-4.7`.
+ */
+export declare function resolveModelPrice(model: string, prices: PriceMap | undefined): ModelPrice | undefined;
+/** Compute a USD cost from token usage and a manual price ($/Mtok). */
+export declare function costFromPrice(usage: Usage, price: ModelPrice): number;
+/** Time windows selectable in the panel. */
+export type WindowKey = "5h" | "24h" | "7d" | "all";
+export declare function windowMs(key: WindowKey): number;
+export declare function windowLabel(key: WindowKey): string;
+/** Mutable usage totals for a bucket. */
+export interface Bucket {
+    cost: number;
+    costInput: number;
+    costOutput: number;
+    costCacheRead: number;
+    costCacheWrite: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cacheWrite1h: number;
+    /** Reported reasoning tokens; a labelled subset of output, never additive. */
+    reasoning: number;
+    turns: number;
+    /**
+     * Estimated generation time (ms) summed across turns. Used to derive an
+     * average output-tokens/second. It's an estimate: pi's Usage carries no
+     * duration, so we approximate per-turn time from the gap between an
+     * assistant turn and the preceding session entry (idle/tool gaps clamped).
+     */
+    genMs: number;
+    /** Turns that contributed a usable genMs estimate (for tok/s averaging). */
+    timedTurns: number;
+}
+/** Total tokens consumed by a bucket (input + output + cache reads/writes). */
+export declare function bucketTokens(b: Bucket): number;
+/**
+ * Average output-tokens/second for a bucket, estimated from `genMs`.
+ * Returns 0 when no timed turns are available. Output tokens are used because
+ * that's the generation throughput users mean by "tok/s".
+ */
+export declare function tokensPerSecond(b: Bucket): number;
+/** A single attributed assistant turn on the timeline. */
+export interface TurnEntry {
+    ts: number;
+    model: string;
+    provider: string;
+    project: string;
+    cost: number;
+    usage: Usage;
+    /** Primary skill (first in a multi-skill activation). */
+    skill: string | null;
+    /** All skills from multi-skill or single-skill activation. */
+    skills: string[];
+    /** Bundle names from multi-skill (@bundle) activation. */
+    bundles: string[];
+    tools: string[];
+    /** Estimated generation time for this turn in ms (0 when not estimable). */
+    genMs: number;
+    sessionId: string;
+    sessionPath: string;
+    delegated: boolean;
+    parentSessionId: string | null;
+}
+/**
+ * Backfill fields missing on legacy cached turns (pre multi-skill cache entries).
+ * Safe to call on every cache hit and before aggregating.
+ */
+export declare function normalizeTurnEntry(entry: TurnEntry): TurnEntry;
+/** Skills attributed to a turn (multi-skill aware, legacy-safe). */
+export declare function skillsForTurn(turn: TurnEntry): string[];
+/** Bundles attributed to a turn (multi-skill @bundle activation). */
+export declare function bundlesForTurn(turn: TurnEntry): string[];
+/** Soft metadata for one authoritative delegated transcript. */
+export interface ChildSessionSummary {
+    id: string;
+    path: string;
+    parentSessionId: string | null;
+    parentLabel: string;
+    project: string;
+    task: string;
+    agentType: string;
+    status: string;
+    isBackground?: boolean;
+    startedAt: number;
+    endedAt: number;
+    timingInferred: boolean;
+    model?: string;
+    stack?: string;
+    thinking?: string;
+    compactions: number;
+}
+/** Full raw report built once, then windowed on demand. */
+export interface Report {
+    computedAt: number;
+    sessionCount: number;
+    turnCount: number;
+    entries: TurnEntry[];
+    children: ChildSessionSummary[];
+}
+/** Runtime-derived maps for attributing tools/skills to plugin labels. */
+export interface AttributionMaps {
+    toolToPlugin: Map<string, string>;
+    skillToPlugin: Map<string, string>;
+}
+/** Build tool->plugin and skill->plugin maps from the currently loaded resources. */
+export declare function buildAttributionMaps(pi: ExtensionAPI): AttributionMaps;
+/** Extract bundle names from manually_attached_skills bundles="..." attribute. */
+export declare function parseSkillBundles(text: string): string[];
+/** Extract all skill names from user content (multi-skill aware). */
+export declare function parseSkillBlocks(text: string): string[];
+/**
+ * Scan every session file and build the timeline of attributed turns.
+ *
+ * `onProgress` receives (loaded, total) for UI feedback. Resolves even if some
+ * files fail to parse — bad files are skipped with a console warning.
+ *
+ * When a `cache` is supplied, sessions whose file mtime + size are unchanged
+ * (and whose cost was computed with the same price table) are reused without
+ * re-reading/parsing the file — only new or modified sessions are parsed. The
+ * cache object is updated in place; the caller persists it.
+ */
+export declare function scanSessions(maxSessions: number, excludes: string[], onProgress?: (loaded: number, total: number) => void, prices?: PriceMap, cache?: ScanCache): Promise<Report>;
+/** Loose `subagents:record` metadata payload (authored by delegation frameworks). */
+export type SoftRecord = Record<string, unknown>;
+/** A top-level session excluded from the roots because its header names a parent. */
+export interface ParentedSession {
+    info: SessionInfo;
+    parentSession: string;
+}
+interface DiscoveredSession {
+    info: SessionInfo;
+    project: string;
+    delegated: boolean;
+    parentSessionId: string | null;
+    parentLabel: string;
+}
+interface SessionHeader {
+    id?: string;
+    cwd?: string;
+    parentSession?: string;
+}
+/**
+ * Read just the file's leading lines to find the session header. Roots are
+ * classified before `maxSessions`, so parsing every full transcript here
+ * would defeat the incremental cache on large histories.
+ */
+export declare function headerFor(path: string): SessionHeader;
+export declare function discoverChildSessionFiles(rootFile: string): string[];
+/**
+ * Resolve the selected roots plus their delegated child transcripts into the
+ * flat session list the scanner walks. `parented` carries top-level sessions
+ * excluded from the roots because their header names a parent: those whose
+ * parent chain (session id or path) resolves transitively to a selected root
+ * are attached as direct delegated children. Exported as a narrow seam so
+ * fixture tests can exercise discovery without touching real user sessions.
+ */
+export declare function discoverSelectedSessions(roots: SessionInfo[], parented?: ParentedSession[]): DiscoveredSession[];
+/** Per-plugin contribution detail for the Plugin usage section. */
+export interface PluginContribution {
+    bucket: Bucket;
+    /** Skills of this plugin that were invoked (→ turn buckets). */
+    skills: Map<string, Bucket>;
+    /** Tools owned by this plugin that were called (→ turn buckets). */
+    tools: Map<string, Bucket>;
+}
+/** A windowed view of the report ready for rendering. */
+export interface WindowedReport {
+    window: WindowKey;
+    total: Bucket;
+    fiveHour: Bucket;
+    weekly: Bucket;
+    byModel: Map<string, Bucket>;
+    bySkill: Map<string, Bucket>;
+    byBundle: Map<string, Bucket>;
+    byPlugin: Map<string, Bucket>;
+    /** Per-plugin detail: which skills/tools drove each plugin's usage. */
+    pluginDetail: Map<string, PluginContribution>;
+    /** Turns that used NO plugin tool/skill (builtin-only, no preceding skill). */
+    byCore: Bucket;
+    byTool: Map<string, Bucket>;
+    byProject: Map<string, Bucket>;
+    direct: Bucket;
+    delegated: Bucket;
+    children: ChildSessionSummary[];
+    concurrency: ConcurrencyStats;
+    turnCount: number;
+    sessionCount: number;
+    earliest: number;
+    latest: number;
+}
+/** Filter the timeline to a window and roll up all breakdowns. */
+export declare function windowize(report: Report, key: WindowKey, maps: AttributionMaps): WindowedReport;
+export interface ConcurrencyStats {
+    childCount: number;
+    parentCount: number;
+    peak: number | null;
+    unionMs: number | null;
+    summedMs: number | null;
+    parallelism: number | null;
+    overlapSavedMs: number | null;
+    inferred: boolean;
+}
+/** Compute overlap statistics for valid child intervals, optionally window-clamped. */
+export declare function computeConcurrency(children: ChildSessionSummary[], windowStart?: number, windowEnd?: number): ConcurrencyStats;
+/** Map<K, V> sorted (desc) by a numeric extractor → array of [key, V]. */
+export declare function ranked<V>(map: Map<string, V>, value: (v: V) => number): Array<[string, V]>;
+/** A single calendar day's rolled-up usage. */
+export interface DayStat {
+    /** Local date key `YYYY-MM-DD`. */
+    dateKey: string;
+    /** Epoch ms at local midnight for that day (used for sorting/streaks). */
+    ts: number;
+    bucket: Bucket;
+    /** Per-model usage that day (model → bucket); size = distinct models. */
+    models: Map<string, Bucket>;
+    /** First / last turn timestamp that day. */
+    firstTs: number;
+    lastTs: number;
+    /**
+     * Active working time that day in ms: the sum of gaps between consecutive
+     * turns that are below the idle threshold. Long idle gaps (pi open but not
+     * working) are excluded, so this reflects time pi was actually busy.
+     */
+    activeMs: number;
+}
+/** A day's active working time (idle excluded), in ms. */
+export declare function dayUptimeMs(d: DayStat): number;
+/**
+ * The day's most-used model — ranked by tokens, not cost. Tokens are the
+ * reliable "how much did I use this model" signal: many providers are
+ * token-priced (cost 0), so ranking by cost would just surface whichever
+ * model happened to run first that day.
+ */
+export declare function dayTopModel(d: DayStat): string | null;
+/** Roll up the full timeline into per-day buckets, sorted ascending by date. */
+export declare function dailyStats(report: Report): DayStat[];
+/** Which metric drives the heatmap/stats intensity. */
+export type Metric = "usd" | "tokens";
+/** Pick the metric value out of a bucket. */
+export declare function metricValue(b: Bucket, metric: Metric): number;
+/** Choose the natural metric for a report: USD when there's real pricing. */
+export declare function naturalMetric(days: DayStat[]): Metric;
+/** One cell (one calendar day) in the contribution graph. */
+export interface ContribCell {
+    dateKey: string;
+    ts: number;
+    value: number;
+    /** Intensity bucket 0..4 (0 = no activity). */
+    level: number;
+}
+/** GitHub-style contribution graph: columns = weeks, 7 rows = Sun..Sat. */
+export interface ContribGraph {
+    /** weeks[col][row] — row 0 = Sunday. Empty cells (future/pre-range) are null. */
+    weeks: Array<Array<ContribCell | null>>;
+    maxValue: number;
+    metric: Metric;
+}
+/**
+ * Build a ~53-week contribution graph ending on the current week, aligned so
+ * each column is a Sun..Sat week (mirrors GitHub / Tokscale's Stats view).
+ */
+export declare function contributionGraph(report: Report, weeks?: number, metric?: Metric): ContribGraph;
+/** Selectable time range for the Stats view summary. */
+export type StatsRange = "all" | "30d" | "7d";
+/** Epoch-ms lower bound for a stats range (-1 = all time). */
+export declare function rangeSince(range: StatsRange): number;
+/** Human label for a stats range. */
+export declare function rangeLabel(range: StatsRange): string;
+/** Lifetime usage statistics for the Stats view. */
+export interface UsageStats {
+    totalCost: number;
+    totalTokens: number;
+    totalTurns: number;
+    activeDays: number;
+    currentStreak: number;
+    longestStreak: number;
+    busiestDay: {
+        dateKey: string;
+        value: number;
+    } | null;
+    firstDay: string | null;
+    lastDay: string | null;
+    avgPerActiveDay: number;
+    /** Most-used model in range (by the active metric). */
+    favoriteModel: string | null;
+    /** Hour-of-day (0-23) with the most usage, or null when no activity. */
+    peakHour: number | null;
+    metric: Metric;
+}
+/**
+ * Compute usage stats (totals, active days, streaks, busiest day, favorite
+ * model, peak hour). `sinceMs` filters the timeline (-1 = all time).
+ */
+export declare function computeStats(report: Report, metric?: Metric, sinceMs?: number): UsageStats;
+/** Usage rolled up by local hour-of-day (0–23), across all days. */
+export interface HourStat {
+    hour: number;
+    bucket: Bucket;
+    models: Map<string, Bucket>;
+}
+/** Aggregate the timeline by hour-of-day (local clock). Always returns 24 slots. */
+export declare function hourlyStats(report: Report): HourStat[];
+/** Top model for an hour slot (by tokens). */
+export declare function hourTopModel(h: HourStat): string | null;
+/** Usage rolled up by provider (agent backend). */
+export interface AgentStat {
+    provider: string;
+    bucket: Bucket;
+    models: Map<string, Bucket>;
+    projects: Set<string>;
+    firstTs: number;
+    lastTs: number;
+}
+/** Aggregate the timeline by provider, sorted by tokens descending. */
+export declare function agentStats(report: Report): AgentStat[];
+/** Top model for a provider (by tokens). */
+export declare function agentTopModel(a: AgentStat): string | null;
+/** Calendar years present in the report (newest first). */
+export declare function availableYears(report: Report): number[];
+/** Default Wrapped AI year: current year if active, else the year with most tokens. */
+export declare function defaultWrappedYear(report: Report): number;
+/** Compact year-in-review stats for the Wrapped AI view. */
+export interface WrappedStats {
+    year: number;
+    totalCost: number;
+    totalTokens: number;
+    totalTurns: number;
+    activeDays: number;
+    currentStreak: number;
+    longestStreak: number;
+    favoriteModel: string | null;
+    favoriteProvider: string | null;
+    topProject: string | null;
+    busiestDay: {
+        dateKey: string;
+        value: number;
+    } | null;
+    peakHour: number | null;
+    avgPerActiveDay: number;
+    modelCount: number;
+    providerCount: number;
+    projectCount: number;
+    /** Token totals per calendar month (Jan..Dec) for the selected year. */
+    monthlyTokens: number[];
+    topModels: Array<{
+        name: string;
+        tokens: number;
+        pct: number;
+    }>;
+    topProviders: Array<{
+        name: string;
+        tokens: number;
+        pct: number;
+    }>;
+    metric: Metric;
+}
+/** Build Wrapped AI stats for a calendar year. Returns null when the year has no activity. */
+export declare function wrappedStats(report: Report, year: number): WrappedStats | null;
+export {};
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/aggregate.d.ts.map

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

package/dist/cache.d.ts

@@ -0,0 +1,27 @@
+import type { ModelPrice } from "./config.ts";
+import type { ChildSessionSummary, SoftRecord, TurnEntry } from "./aggregate.ts";
+export interface CachedSession {
+    mtimeMs: number;
+    size: number;
+    entries: TurnEntry[];
+    child?: ChildSessionSummary;
+    /** `subagents:record` metadata entries found in this transcript. */
+    records?: SoftRecord[];
+}
+export interface ScanCache {
+    version: number;
+    /** Fingerprint of the price table the cached costs were computed with. */
+    pricesKey: string;
+    /** Fingerprint of excluded project prefixes used during attribution. */
+    excludesKey: string;
+    /** Per-session-file cached attribution, keyed by absolute file path. */
+    sessions: Record<string, CachedSession>;
+}
+/** Stable fingerprint of the price table (key order-independent). */
+export declare function excludesFingerprint(excludes: string[] | undefined): string;
+export declare function pricesFingerprint(prices: Record<string, ModelPrice> | undefined): string;
+/** Load the scan cache; returns an empty cache on any error/missing file. */
+export declare function loadScanCache(): ScanCache;
+/** Persist the scan cache. Never throws. */
+export declare function saveScanCache(cache: ScanCache): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKjF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAK1E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,MAAM,CAQxF;AAMD,6EAA6E;AAC7E,wBAAgB,aAAa,IAAI,SAAS,CAwBzC;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAQpD"}

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Manual price for a model, in USD per **million tokens**. Used to compute a
+ * cost for token-priced / proxied providers that pi records with cost 0
+ * (e.g. zai/GLM, 9Router `kr/…`, `cx/…`). Omitted fields count as 0.
+ */
+export interface ModelPrice {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
+export interface UsageConfig {
+    /** USD budget for the rolling 5-hour window. 0/undefined disables the bar. */
+    fiveHourLimit?: number;
+    /** USD budget for the rolling 7-day (weekly) window. 0/undefined disables the bar. */
+    weeklyLimit?: number;
+    /** Token budget for the rolling 5-hour window (for token-priced providers like zai/GLM). */
+    fiveHourTokenLimit?: number;
+    /** Token budget for the rolling 7-day (weekly) window. */
+    weeklyTokenLimit?: number;
+    /** When true, show a compact one-line usage summary widget above the editor. */
+    showWidget?: boolean;
+    /** Project cwd prefixes to exclude from aggregation (e.g. throwaway dirs). */
+    excludeProjects?: string[];
+    /** Maximum number of session files to scan (safety cap for huge histories). */
+    maxSessions?: number;
+    /**
+     * Manual per-model prices ($/million tokens) used to fill in cost when pi
+     * recorded none. Keyed by model ID; an entry keyed by the base name (without
+     * a proxy prefix like `kr/`) matches all proxied variants.
+     */
+    modelPrices?: Record<string, ModelPrice>;
+}
+/** Load config, merged with defaults. Never throws — returns defaults on error. */
+export declare function loadConfig(): UsageConfig;
+/** Persist config to disk. Creates the agent dir if needed. */
+export declare function saveConfig(config: UsageConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C;AAiBD,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,WAAW,CAkBxC;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAQpD"}

package/dist/format.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Number, currency, and progress-bar formatting helpers for the usage panel.
+ *
+ * Kept dependency-free so it is easy to unit-test and reuse.
+ */
+/** Format a token count with k/M suffixes. */
+export declare function formatTokens(n: number): string;
+/** Format a USD cost. Small amounts get more precision. */
+export declare function formatCost(n: number): string;
+/** Percentage of `part` relative to `total`, as a rounded integer string. */
+export declare function percent(part: number, total: number): string;
+/** Render a horizontal progress bar. Returns the bar string (without ANSI). */
+export declare function bar(ratio: number, width: number): string;
+/** Shorten an absolute path to a friendly project label (~/... style). */
+export declare function shortenPath(p: string, home: string): string;
+/**
+ * Derive a human-friendly plugin label from a resource's SourceInfo.
+ *
+ * Priority:
+ *   1. Package sources (npm:/git:/github:) → package name (ref stripped)
+ *   2. Local/auto skills → the `/skills/<group>/` segment from the path, so
+ *      e.g. `~/.claude/skills/bmad/core/bmad-master/SKILL.md` → "bmad" and
+ *      `~/.pi/agent/skills/frontend-design/SKILL.md` → "frontend-design".
+ *   3. Local extensions → last baseDir segment (skipping generic names)
+ *   4. fallback "other"
+ */
+export declare function sourceLabel(sourceInfo: {
+    source?: string;
+    baseDir?: string;
+    path?: string;
+}): string;
+/** Human day label from a `YYYY-MM-DD` key, e.g. "Mon Jun 17". */
+export declare function formatDayLabel(dateKey: string): string;
+/** Short month name for a 1-based month index (1 = Jan). */
+export declare function monthLabel(month1: number): string;
+/** Render a unicode sparkline for a series of non-negative values. */
+export declare function sparkline(values: number[]): string;
+/** Heatmap glyphs per intensity level (0 = empty). */
+export declare const HEAT_CHARS: readonly ["·", "▪", "▩", "▣", "█"];
+/** Format an hour-of-day (0-23) as a friendly 12-hour label, e.g. "2pm". */
+export declare function formatHour(h: number): string;
+/** Format an integer with thousands separators (e.g. 24086 → "24,086"). */
+export declare function formatInt(n: number): string;
+/** Format a duration in ms as a compact human string (e.g. "2h 14m"). */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,+EAA+E;AAC/E,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CA8BT;AASD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAclD;AAED,sDAAsD;AACtD,eAAO,MAAM,UAAU,oCAAqC,CAAC;AAE7D,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYjD"}

package/dist/freshness.d.ts

@@ -0,0 +1,42 @@
+/**
+ * In-memory report-cache freshness decision.
+ *
+ * The usage panel reuses a scanned `Report` for up to `CACHE_TTL` to avoid
+ * re-reading hundreds of session files on every `/usage` open. That TTL is
+ * purely time-based — which is exactly the bug behind the trend graph looking
+ * frozen ("always the same"): a user who opens the panel, spends more tokens,
+ * and reopens within the TTL window gets the *same* stale snapshot back, even
+ * though the live session file on disk already has the new turns.
+ *
+ * The fix is to also invalidate the cache whenever a new assistant turn has
+ * landed since the cache was built. Because pi flushes each turn to disk in
+ * realtime, a fresh scan will then pick those turns up, so the trend (and every
+ * other panel view) reflects current usage instead of a snapshot from up to
+ * two minutes ago.
+ *
+ * This module is intentionally dependency-free so the decision is unit-testable
+ * in isolation.
+ */
+/** A cache entry carrying the epoch-ms timestamp it was built at. */
+export interface ReportCacheStamp {
+    at: number;
+}
+/**
+ * Is the in-memory report cache still fresh enough to reuse without rescanning?
+ *
+ * Fresh only when ALL of:
+ *   1. a cache exists,
+ *   2. we're still inside the TTL window, and
+ *   3. no assistant turn has arrived after the cache was built.
+ *
+ * Condition (3) is the realtime fix: a new turn means the on-disk session file
+ * changed, so the cached report is stale regardless of the TTL window.
+ *
+ * @param cached     The current in-memory cache stamp (or null when none yet).
+ * @param now        Current epoch-ms.
+ * @param lastTurnAt Epoch-ms of the most recent assistant turn seen this pi run,
+ *                   or 0 when no turn has been observed.
+ * @param ttlMs      Max age of a cache entry before it is considered stale.
+ */
+export declare function isReportCacheFresh(cached: ReportCacheStamp | null, now: number, lastTurnAt: number, ttlMs: number): boolean;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAOT"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function usageExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,iCAAiC,CAAC;AAsC7F,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAE,EAAE,YAAY,QAudtD"}

package/dist/mascot.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pi-chan — lightweight anime mascot for the usage panel TUI.
+ * ASCII poses + per-view icons keep the menu and Wrapped view playful
+ * without breaking narrow terminals.
+ */
+import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { WrappedStats } from "./aggregate.ts";
+/** Selectable top-level views (Tokscale-style menu + Wrapped AI). */
+export type ViewKey = "overview" | "models" | "delegation" | "daily" | "stats" | "hourly" | "providers" | "wrapped";
+/** Ordered list of views for tab/arrow navigation. */
+export declare const VIEW_ORDER: ViewKey[];
+export interface ViewTabMeta {
+    icon: string;
+    short: string;
+    label: string;
+    hint: string;
+    /** Accent when this tab is selected. */
+    color: ThemeColor;
+}
+export declare const VIEW_TABS: Record<ViewKey, ViewTabMeta>;
+/** Cycle palette for rainbow bars (monthly chart, tool rows, etc.). */
+export declare const RAINBOW: ThemeColor[];
+export type MascotPose = "wave" | "celebrate" | "night" | "curious" | "sleepy" | "tools";
+/** Pick a mascot pose for the active view or Wrapped stats mood. */
+export declare function mascotPose(view: ViewKey, stats?: WrappedStats | null): MascotPose;
+/** Theme-colored mascot lines. */
+export declare function renderMascot(pose: MascotPose, theme: Theme): string[];
+/** Wrapped sidebar mascot — compact, report-card styling. */
+export declare function renderWrappedMascot(pose: MascotPose, theme: Theme): string[];
+/** One-line insight caption for the Wrapped footer. */
+export declare function wrappedMascotCaption(stats: WrappedStats | null, year: number): string;
+/** Short speech line for menu hint row. */
+export declare function mascotQuip(view: ViewKey, stats?: WrappedStats | null): string;
+export declare function toolGlyph(name: string): string;
+//# sourceMappingURL=mascot.d.ts.map

package/dist/mascot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mascot.d.ts","sourceRoot":"","sources":["../src/mascot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,qEAAqE;AACrE,MAAM,MAAM,OAAO,GACf,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,OAAO,GACP,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd,sDAAsD;AACtD,eAAO,MAAM,UAAU,EAAE,OAAO,EAS/B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAyDlD,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,OAAO,EAAE,UAAU,EAa/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAuBzF,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,UAAU,CASjF;AAYD,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CASrE;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAO5E;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUrF;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAU7E;AAgBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/prices.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Bundled default model prices ($/million tokens).
+ *
+ * pi records `cost = 0` for token-priced / proxied providers it has no pricing
+ * for (zai/GLM, 9Router `kr/…` `cx/…`, MiniMax, etc.). These defaults let the
+ * panel show an approximate cost out of the box. They are merged under the
+ * user's `~/.pi/agent/usage.json` `modelPrices`, so any user entry overrides
+ * the matching default. Set your own with `/usage-pricing`.
+ *
+ * Figures are taken from each provider's official pricing page (June 2026):
+ *   - Anthropic   platform.claude.com/docs/en/about-claude/pricing
+ *   - OpenAI      developers.openai.com/api/docs/pricing
+ *   - Google      ai.google.dev/gemini-api/docs/pricing
+ *   - Z.ai (GLM)  docs.z.ai/guides/overview/pricing
+ *   - MiniMax     platform.minimax.io/docs/guides/pricing-paygo
+ *
+ * Keys match a model ID exactly, or by base name (after the last `/`) so an
+ * entry like `claude-opus-4.7` also covers `kr/claude-opus-4.7`. Prices change
+ * often and subscription/proxy costs differ from list rates — treat these as
+ * estimates and override as needed.
+ */
+import type { ModelPrice } from "./config.ts";
+export declare const DEFAULT_MODEL_PRICES: Record<string, ModelPrice>;
+//# sourceMappingURL=prices.d.ts.map