@oh-my-pi/omp-stats 17.1.1 → 17.1.2

package/dist/client/styles.css

@@ -221,6 +221,9 @@
   .h-\[200px\] {
     height: 200px;
   }
+  .h-\[260px\] {
+    height: 260px;
+  }
   .h-\[280px\] {
     height: 280px;
   }
@@ -1463,6 +1466,9 @@
 .stats-text-muted {
   color: var(--dim);
 }
+.stats-text-warning {
+  color: var(--warning);
+}
 .stats-text-xs {
   font-size: 12px;
 }

package/dist/types/aggregator.d.ts

@@ -1,4 +1,4 @@
-import type { BehaviorDashboardStats, DashboardStats, MessageStats, RequestDetails, ToolDashboardStats } from "./types.js";
+import type { BehaviorDashboardStats, DashboardStats, MessageStats, ProviderDashboardStats, RequestDetails, ToolDashboardStats } from "./types.js";
 /**
  * Progress event emitted after each session file is fully processed.
  * `current` is the number of files completed (skipped + parsed),
@@ -84,4 +84,10 @@ export declare function getBehaviorDashboardStats(range?: string | null): Promis
  * breakdown, and the call time series (bucketed like the model series).
  */
 export declare function getToolDashboardStats(range?: string | null): Promise<ToolDashboardStats>;
+/**
+ * Get the providers dashboard payload: per-provider totals, peak-burn-hours
+ * histogram, provider token time series, and subscription-window analytics
+ * (utilization series + insights) derived from recorded usage-limit snapshots.
+ */
+export declare function getProviderDashboardStats(range?: string | null): Promise<ProviderDashboardStats>;
 export {};

package/dist/types/client/api.d.ts

@@ -1,4 +1,4 @@
-import type { BehaviorDashboardStats, CostDashboardStats, FolderStats, GainDashboardStats, MessageStats, ModelDashboardStats, OverviewStats, RequestDetails, TimeRange, ToolDashboardStats } from "./types.js";
+import type { BehaviorDashboardStats, CostDashboardStats, FolderStats, GainDashboardStats, MessageStats, ModelDashboardStats, OverviewStats, ProviderDashboardStats, RequestDetails, TimeRange, ToolDashboardStats } from "./types.js";
 export declare class ApiError extends Error {
     status: number;
     endpoint: string;
@@ -19,3 +19,4 @@ export declare function getBehaviorDashboardStats(range?: TimeRange, signal?: Ab
 export declare function getFolderStats(range?: TimeRange, signal?: AbortSignal): Promise<FolderStats[]>;
 export declare function getGainDashboardStats(range?: TimeRange, project?: string | null, signal?: AbortSignal): Promise<GainDashboardStats>;
 export declare function getToolDashboardStats(range?: TimeRange, signal?: AbortSignal): Promise<ToolDashboardStats>;
+export declare function getProviderDashboardStats(range?: TimeRange, signal?: AbortSignal): Promise<ProviderDashboardStats>;

package/dist/types/client/app/routes.d.ts

@@ -1,5 +1,5 @@
 import type React from "react";
-export type DashboardSection = "overview" | "requests" | "errors" | "models" | "tools" | "costs" | "behavior" | "projects" | "gain";
+export type DashboardSection = "overview" | "requests" | "errors" | "models" | "providers" | "tools" | "costs" | "behavior" | "projects" | "gain";
 export interface DashboardRoute {
     id: DashboardSection;
     label: string;

package/dist/types/client/routes/ProvidersRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types.js";
+export interface ProvidersRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function ProvidersRoute({ active, range, refreshTrigger }: ProvidersRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/index.d.ts

@@ -5,5 +5,6 @@ export * from "./GainRoute.js";
 export * from "./ModelsRoute.js";
 export * from "./OverviewRoute.js";
 export * from "./ProjectsRoute.js";
+export * from "./ProvidersRoute.js";
 export * from "./RequestsRoute.js";
 export * from "./ToolsRoute.js";

package/dist/types/db.d.ts

@@ -1,5 +1,5 @@
 import { Database } from "bun:sqlite";
-import type { AgentTypeStats, AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolCallStats, ToolModelStats, ToolResultLink, ToolTimeSeriesPoint, ToolUsageStats, UserMessageLink, UserMessageStats } from "./types.js";
+import type { AgentTypeStats, AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, ProviderAggregate, ProviderHourlyPoint, ProviderTimeSeriesPoint, TimeSeriesPoint, ToolCallStats, ToolModelStats, ToolResultLink, ToolTimeSeriesPoint, ToolUsageStats, UserMessageLink, UserMessageStats } from "./types.js";
 /**
  * Initialize the database and create tables.
  */
@@ -60,6 +60,20 @@ export declare function getTimeSeries(hours?: number, cutoff?: number | null, bu
  * Get daily model usage time series data for the last N days.
  */
 export declare function getModelTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ModelTimeSeriesPoint[];
+/**
+ * Get request/token/cost totals grouped by provider.
+ */
+export declare function getStatsByProvider(cutoff?: number | null): ProviderAggregate[];
+/**
+ * Get token burn grouped by provider and local hour of day (0-23).
+ * Hours use the server's timezone — the dashboard is a localhost tool, so
+ * server-local and viewer-local time coincide.
+ */
+export declare function getProviderHourlyBurn(cutoff?: number | null): ProviderHourlyPoint[];
+/**
+ * Get token/cost time series grouped by provider (bucketed like the model series).
+ */
+export declare function getProviderTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ProviderTimeSeriesPoint[];
 /**
  * Get daily model performance time series data for the last N days.
  */

package/dist/types/shared-types.d.ts

@@ -299,3 +299,105 @@ export interface ToolDashboardStats {
     byToolModel: ToolModelStats[];
     series: ToolTimeSeriesPoint[];
 }
+/**
+ * Aggregated request/token/cost totals for one provider over the active range.
+ */
+export interface ProviderAggregate {
+    provider: string;
+    totalRequests: number;
+    failedRequests: number;
+    /** Distinct models used through this provider in the range. */
+    models: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheWriteTokens: number;
+    /** Uncached input + cache reads + cache writes + output. */
+    totalTokens: number;
+    totalCost: number;
+    totalPremiumRequests: number;
+    avgTokensPerSecond: number | null;
+}
+/**
+ * Token burn attributed to one local hour-of-day (0-23) for one provider.
+ * Powers the "peak burn hours" histogram.
+ */
+export interface ProviderHourlyPoint {
+    provider: string;
+    /** Local hour of day, 0-23. */
+    hour: number;
+    totalTokens: number;
+    outputTokens: number;
+    requests: number;
+}
+/** Provider token/cost time-series point (bucketed like the model series). */
+export interface ProviderTimeSeriesPoint {
+    timestamp: number;
+    provider: string;
+    totalTokens: number;
+    cost: number;
+    requests: number;
+}
+/** One recorded usage-limit snapshot for an (account, window) series. */
+export interface UsageWindowPoint {
+    timestamp: number;
+    /** Used fraction 0..1 (>1 = overage) when the provider reported one. */
+    usedFraction: number | null;
+    exhausted: boolean;
+}
+/**
+ * Utilization history for one (account, limit window) pair of a provider,
+ * sourced from the auth store's recorded usage-limit snapshots.
+ */
+export interface UsageWindowSeries {
+    provider: string;
+    accountKey: string;
+    /** Email/account id when known, else the stable account key. */
+    accountLabel: string;
+    /** Groups the same limit window across accounts (window label or limit id). */
+    windowKey: string;
+    windowLabel: string;
+    points: UsageWindowPoint[];
+}
+/**
+ * Derived subscription insight for one provider limit window across all
+ * accounts: how much of the window was consumed, what one window is worth in
+ * tokens, and how many accounts peak demand would have needed.
+ */
+export interface ProviderWindowInsight {
+    provider: string;
+    windowKey: string;
+    windowLabel: string;
+    /** Accounts with at least one snapshot for this window in range. */
+    accounts: number;
+    /** Window resets observed (drops in used fraction). */
+    cycles: number;
+    /**
+     * Subscription-window equivalents consumed in range: sum of positive
+     * used-fraction deltas across accounts (1.0 = one full window burned).
+     */
+    fractionConsumed: number;
+    /**
+     * Estimated tokens one full window buys: provider tokens burned in range
+     * divided by {@link fractionConsumed}. Null when too little of the window
+     * was consumed to extrapolate.
+     */
+    estTokensPerWindow: number | null;
+    /** Peak of sum-across-accounts used fraction at any sampled instant. */
+    peakConcurrentFraction: number;
+    /**
+     * Accounts needed to keep peak demand under 90% of fleet capacity:
+     * max(1, ceil(peakConcurrentFraction / 0.9)).
+     */
+    idealAccounts: number;
+    /** Transitions into an exhausted state observed in range. */
+    exhaustedEvents: number;
+}
+/** Complete providers dashboard payload. */
+export interface ProviderDashboardStats {
+    providers: ProviderAggregate[];
+    hourly: ProviderHourlyPoint[];
+    series: ProviderTimeSeriesPoint[];
+    usageSeries: UsageWindowSeries[];
+    windowInsights: ProviderWindowInsight[];
+}

package/dist/types/usage-windows.d.ts

@@ -0,0 +1,45 @@
+import type { ProviderWindowInsight, UsageWindowSeries } from "./shared-types.js";
+/** Subset of a `usage_history` row consumed by the window analytics. */
+export interface UsageSnapshotRow {
+    /** Epoch ms the report was fetched. */
+    recordedAt: number;
+    provider: string;
+    /** Stable credential identity key. */
+    accountKey: string;
+    email: string | null;
+    accountId: string | null;
+    limitId: string;
+    label: string;
+    windowLabel: string | null;
+    /** Used fraction (0..1, >1 = overage) when the provider reported one. */
+    usedFraction: number | null;
+    status: string | null;
+}
+/** Utilization series + derived insights for every provider window in range. */
+export interface UsageWindowStats {
+    usageSeries: UsageWindowSeries[];
+    windowInsights: ProviderWindowInsight[];
+}
+/**
+ * Read usage-limit snapshots recorded at or after `sinceMs`, oldest first.
+ * Opens the agent DB read-only; returns `[]` when the DB or table is absent.
+ */
+export declare function readUsageSnapshots(sinceMs: number, dbPath?: string): UsageSnapshotRow[];
+/**
+ * Fetch usage snapshots from wherever they actually accumulate: the auth
+ * broker's durable history when a broker is configured (the broker performs
+ * every upstream usage fetch in that mode, so the local `usage_history` stays
+ * frozen), else the local agent DB. Broker errors fall back to the local read
+ * so the dashboard degrades to stale-but-present data instead of failing.
+ */
+export declare function fetchUsageSnapshots(sinceMs: number): Promise<UsageSnapshotRow[]>;
+/**
+ * Derive utilization series and per-window insights from raw snapshots.
+ *
+ * `tokensByProvider` supplies each provider's token burn over the same time
+ * range (from the local message stats); it converts consumed window fraction
+ * into an estimated token capacity per window. Attribution note: tokens are
+ * per provider, not per account, so the estimate treats the account fleet as
+ * one pooled subscription — which is exactly how round-robin auth uses it.
+ */
+export declare function computeUsageWindowStats(rows: UsageSnapshotRow[], tokensByProvider: ReadonlyMap<string, number>): UsageWindowStats;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/omp-stats",
-	"version": "17.1.1",
+	"version": "17.1.2",
 	"description": "Local observability dashboard for pi AI usage statistics",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -39,9 +39,9 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "17.1.1",
-		"@oh-my-pi/pi-catalog": "17.1.1",
-		"@oh-my-pi/pi-utils": "17.1.1",
+		"@oh-my-pi/pi-ai": "17.1.2",
+		"@oh-my-pi/pi-catalog": "17.1.2",
+		"@oh-my-pi/pi-utils": "17.1.2",
 		"@tailwindcss/node": "^4.3.2",
 		"chart.js": "^4.5.1",
 		"date-fns": "^4.4.0",

package/src/aggregator.ts

@@ -13,9 +13,12 @@ import {
 	getModelPerformanceSeries,
 	getModelTimeSeries,
 	getOverallStats,
+	getProviderHourlyBurn,
+	getProviderTimeSeries,
 	getStatsByAgentType,
 	getStatsByFolder,
 	getStatsByModel,
+	getStatsByProvider,
 	getTimeSeries,
 	getToolStats,
 	getToolStatsByModel,
@@ -35,7 +38,15 @@ import type { SyncWorkerRequest, SyncWorkerResponse } from "./sync-worker";
 // hidden argv mode, so the compiled binary and npm bundle only need one
 // JavaScript entry. Standalone source `omp-stats` keeps using this package's
 // own sync-worker source file.
-import type { BehaviorDashboardStats, DashboardStats, MessageStats, RequestDetails, ToolDashboardStats } from "./types";
+import type {
+	BehaviorDashboardStats,
+	DashboardStats,
+	MessageStats,
+	ProviderDashboardStats,
+	RequestDetails,
+	ToolDashboardStats,
+} from "./types";
+import { computeUsageWindowStats, fetchUsageSnapshots } from "./usage-windows";
 
 /**
  * Apply a freshly parsed result to the database. Runs entirely on the
@@ -504,3 +515,24 @@ export async function getToolDashboardStats(range?: string | null): Promise<Tool
 		series: getToolTimeSeries(modelSeriesDays, cutoff, modelSeriesBucketMs),
 	};
 }
+
+/**
+ * Get the providers dashboard payload: per-provider totals, peak-burn-hours
+ * histogram, provider token time series, and subscription-window analytics
+ * (utilization series + insights) derived from recorded usage-limit snapshots.
+ */
+export async function getProviderDashboardStats(range?: string | null): Promise<ProviderDashboardStats> {
+	await initDb();
+	const { modelSeriesDays, modelSeriesBucketMs, cutoff } = getTimeRangeConfig(range);
+	const providers = getStatsByProvider(cutoff ?? undefined);
+	const tokensByProvider = new Map(providers.map(p => [p.provider, p.totalTokens]));
+	const snapshots = await fetchUsageSnapshots(cutoff ?? 0);
+	const { usageSeries, windowInsights } = computeUsageWindowStats(snapshots, tokensByProvider);
+	return {
+		providers,
+		hourly: getProviderHourlyBurn(cutoff ?? undefined),
+		series: getProviderTimeSeries(modelSeriesDays, cutoff, modelSeriesBucketMs),
+		usageSeries,
+		windowInsights,
+	};
+}

package/src/client/App.tsx

@@ -10,6 +10,7 @@ import {
 	ModelsRoute,
 	OverviewRoute,
 	ProjectsRoute,
+	ProvidersRoute,
 	RequestsRoute,
 	ToolsRoute,
 } from "./routes";
@@ -73,6 +74,8 @@ export default function App() {
 				);
 			case "models":
 				return <ModelsRoute active={isActive} range={range} refreshTrigger={refreshTrigger} />;
+			case "providers":
+				return <ProvidersRoute active={isActive} range={range} refreshTrigger={refreshTrigger} />;
 			case "tools":
 				return <ToolsRoute active={isActive} range={range} refreshTrigger={refreshTrigger} />;
 			case "costs":

package/src/client/api.ts

@@ -6,6 +6,7 @@ import type {
 	MessageStats,
 	ModelDashboardStats,
 	OverviewStats,
+	ProviderDashboardStats,
 	RequestDetails,
 	TimeRange,
 	ToolDashboardStats,
@@ -106,3 +107,12 @@ export async function getToolDashboardStats(
 ): Promise<ToolDashboardStats> {
 	return fetchJson<ToolDashboardStats>(`${API_BASE}/stats/tools?range=${encodeURIComponent(range)}`, { signal });
 }
+
+export async function getProviderDashboardStats(
+	range: TimeRange = "24h",
+	signal?: AbortSignal,
+): Promise<ProviderDashboardStats> {
+	return fetchJson<ProviderDashboardStats>(`${API_BASE}/stats/providers?range=${encodeURIComponent(range)}`, {
+		signal,
+	});
+}

package/src/client/app/routes.ts

@@ -1,4 +1,15 @@
-import { Activity, AlertCircle, Coins, Cpu, Folder, LayoutDashboard, Smile, TrendingUp, Wrench } from "lucide-react";
+import {
+	Activity,
+	AlertCircle,
+	Coins,
+	Cpu,
+	Folder,
+	LayoutDashboard,
+	Plug,
+	Smile,
+	TrendingUp,
+	Wrench,
+} from "lucide-react";
 import type React from "react";
 
 export type DashboardSection =
@@ -6,6 +17,7 @@ export type DashboardSection =
 	| "requests"
 	| "errors"
 	| "models"
+	| "providers"
 	| "tools"
 	| "costs"
 	| "behavior"
@@ -40,6 +52,11 @@ export const routes: DashboardRoute[] = [
 		label: "Models",
 		icon: Cpu,
 	},
+	{
+		id: "providers",
+		label: "Providers",
+		icon: Plug,
+	},
 	{
 		id: "tools",
 		label: "Tools",

package/src/client/data/useHashRoute.ts

@@ -7,6 +7,7 @@ const VALID_SECTIONS: DashboardSection[] = [
 	"requests",
 	"errors",
 	"models",
+	"providers",
 	"tools",
 	"costs",
 	"behavior",