@linxiraos/pi-stats 1.0.10 → 1.1.1

package/dist/types/aggregator.d.ts

@@ -1,4 +1,4 @@
-import type { BehaviorDashboardStats, DashboardStats, MessageStats, ProviderDashboardStats, RequestDetails, ToolDashboardStats } from "./types.js";
+import type { BehaviorDashboardStats, DashboardStats, FolderStats, 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),
@@ -71,6 +71,7 @@ export declare function getDashboardStats(range?: string | null): Promise<Dashbo
 export declare function getOverviewStats(range?: string | null): Promise<Pick<DashboardStats, "overall" | "byAgentType" | "timeSeries">>;
 export declare function getModelDashboardStats(range?: string | null): Promise<Pick<DashboardStats, "byModel" | "modelSeries" | "modelPerformanceSeries">>;
 export declare function getCostDashboardStats(range?: string | null): Promise<Pick<DashboardStats, "costSeries">>;
+export declare function getFolderStats(range?: string | null): Promise<FolderStats[]>;
 export declare function getRecentRequests(limit?: number): Promise<MessageStats[]>;
 export declare function getRecentErrors(range?: string | null, limit?: number): Promise<MessageStats[]>;
 export declare function getRequestDetails(id: number): Promise<RequestDetails | null>;
@@ -88,6 +89,10 @@ export declare function getToolDashboardStats(range?: string | null): Promise<To
  * 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.
+ *
+ * Window token estimates use broker-held fleet token burn when a broker is
+ * configured — the window fractions cover every install sharing the broker's
+ * credentials, so dividing them into local-only tokens would undercount.
  */
 export declare function getProviderDashboardStats(range?: string | null): Promise<ProviderDashboardStats>;
 /**

package/dist/types/client/data/formatters.d.ts

@@ -1,6 +1,11 @@
+import type { MessageStats } from "../types.js";
 export declare function formatInteger(value: number): string;
 export declare function formatCompact(value: number): string;
 export declare function formatCost(value: number, digits?: number): string;
+/** Format an API-equivalent estimate, using N/A when all usage is unpriced. */
+export declare function formatEstimatedCost(value: number, unpricedRequests: number, digits?: number): string;
+/** Format one request's cost, distinguishing unpriced SuperGrok usage from free usage. */
+export declare function formatMessageCost(message: Pick<MessageStats, "provider" | "usage">, digits?: number): string;
 export declare function formatPercent(value: number, digits?: number): string;
 export declare function formatDurationMs(value: number | null, digits?: number): string;
 export declare function formatTokensPerSecond(value: number | null): string;

package/dist/types/client/data/view-models.d.ts

@@ -30,6 +30,7 @@ export interface AgentTokenShareView {
 export declare function buildAgentTokenShare(stats: AgentTypeStats[]): AgentTokenShareView;
 export interface CostSummaryView {
     totalCost: number;
+    unpricedRequests: number;
     avgDailyCost: number;
     topModelName: string;
     topModelCost: number;

package/dist/types/db.d.ts

@@ -27,8 +27,9 @@ export declare function setFileOffset(sessionFile: string, offset: number, lastM
  * aggregate. The `WHERE NOT EXISTS` clause skips inserts whose
  * `(entry_id, timestamp)` already exists under a different `session_file` —
  * first-write-wins across the lineage. Same-file re-syncs still hit the
- * `ON CONFLICT(session_file, entry_id)` upsert below so historical
- * `premium_requests` fix-ups continue to work.
+ * `ON CONFLICT(session_file, entry_id)` upsert below, which re-derives the
+ * stored cost (orchestration-aware) and keeps `premium_requests` monotonic, so
+ * a forced re-parse repairs historical `premium_requests` and cost fix-ups.
  */
 export declare function insertMessageStats(stats: MessageStats[]): number;
 /**

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

@@ -33,6 +33,8 @@ export interface AggregatedStats {
     cacheSavings: number;
     /** Total cost */
     totalCost: number;
+    /** Requests with token usage but no public-equivalent subscription price. */
+    unpricedRequests: number;
     /** Total premium requests */
     totalPremiumRequests: number;
     /** Average duration in ms */
@@ -115,6 +117,8 @@ export interface CostTimeSeriesPoint {
     provider: string;
     /** Total cost for this bucket */
     cost: number;
+    /** Requests excluded because no public-equivalent subscription price exists. */
+    unpricedRequests: number;
     /** Cost breakdown */
     costInput: number;
     costOutput: number;
@@ -283,6 +287,8 @@ export interface ToolUsageStats {
     outputTokensShare: number;
     /** Cost (USD) of invoking turns, attributed per call share. */
     costShare: number;
+    /** Share of unpriced subscription requests attributed to this tool. */
+    unpricedRequestsShare: number;
     /** Unix ms of the most recent call in range. */
     lastUsed: number;
 }
@@ -320,6 +326,8 @@ export interface ProviderAggregate {
     /** Uncached input + cache reads + cache writes + output. */
     totalTokens: number;
     totalCost: number;
+    /** Requests excluded because no public-equivalent subscription price exists. */
+    unpricedRequests: number;
     totalPremiumRequests: number;
     avgTokensPerSecond: number | null;
 }
@@ -341,6 +349,8 @@ export interface ProviderTimeSeriesPoint {
     provider: string;
     totalTokens: number;
     cost: number;
+    /** Requests excluded because no public-equivalent subscription price exists. */
+    unpricedRequests: number;
     requests: number;
 }
 /** One recorded usage-limit snapshot for an (account, window) series. */
@@ -359,8 +369,9 @@ export interface UsageWindowSeries {
     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). */
+    /** Groups the same limit window across accounts (the provider limit id). */
     windowKey: string;
+    /** Human label of the limit (distinguishes same-duration windows). */
     windowLabel: string;
     points: UsageWindowPoint[];
 }
@@ -371,7 +382,9 @@ export interface UsageWindowSeries {
  */
 export interface ProviderWindowInsight {
     provider: string;
+    /** Groups the same limit window across accounts (the provider limit id). */
     windowKey: string;
+    /** Human label of the limit (distinguishes same-duration windows). */
     windowLabel: string;
     /** Accounts with at least one snapshot for this window in range. */
     accounts: number;

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

@@ -1,3 +1,4 @@
+import type { ClientUsageClientSummary } from "@linxiraos/pi-ai/usage";
 import type { ProviderWindowInsight, UsageWindowSeries } from "./shared-types.js";
 /** Subset of a `usage_history` row consumed by the window analytics. */
 export interface UsageSnapshotRow {
@@ -20,26 +21,52 @@ export interface UsageWindowStats {
     usageSeries: UsageWindowSeries[];
     windowInsights: ProviderWindowInsight[];
 }
+/** Usage snapshots plus, in broker mode, fleet-wide token burn per provider. */
+export interface UsageDataSnapshot {
+    rows: UsageSnapshotRow[];
+    /**
+     * Total tokens (input + output + cache read/write) per provider summed
+     * across every install reporting to the auth broker, or `null` when no
+     * broker is configured or no client reports exist for the range. Matches
+     * the fleet-wide window fractions in `rows`, unlike local message stats
+     * which only see this install's burn.
+     */
+    fleetTokensByProvider: Map<string, number> | null;
+}
 /**
  * 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.
+ * Fetch usage data from wherever it actually accumulates: the auth broker's
+ * durable history plus per-client observed-usage reports 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 fetchUsageData(sinceMs: number): Promise<UsageDataSnapshot>;
+/**
+ * Fold per-client provider aggregates into total tokens per provider
+ * (input + output + cache read/write, matching message-stat `totalTokens`).
+ * Returns `null` when no client reported anything, signalling "no data"
+ * rather than "zero burn".
  */
-export declare function fetchUsageSnapshots(sinceMs: number): Promise<UsageSnapshotRow[]>;
+export declare function sumFleetTokens(clients: ClientUsageClientSummary[]): Map<string, number> | null;
 /**
  * Derive utilization series and per-window insights from raw snapshots.
  *
+ * Windows are grouped by `(provider, limitId)` — never by display label.
+ * Distinct limits can share a duration label (Anthropic's overall and
+ * model-scoped 7-day windows, Codex's base and Spark weeklies); merging them
+ * interleaves unrelated fractions per account and wildly inflates consumption.
+ *
  * `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.
+ * range (fleet-wide broker client reports when available, else 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,9 +1,9 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-stats",
-	"version": "1.0.10",
+	"version": "1.1.1",
 	"description": "Local observability dashboard for pi AI usage statistics",
-	"homepage": "https://linxira-os.github.io",
+	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Can Boluk",
 	"license": "MIT",
 	"repository": {
@@ -12,7 +12,7 @@
 		"directory": "packages/stats"
 	},
 	"bugs": {
-		"url": "https://github.com/can1357/oh-my-pi/issues"
+		"url": "https://github.com/Linxira-OS/linxira-zeta/issues"
 	},
 	"keywords": [
 		"ai",
@@ -25,7 +25,7 @@
 	"main": "./src/index.ts",
 	"types": "./dist/types/index.d.ts",
 	"bin": {
-		"omp-stats": "./src/index.ts"
+		"zeta-stats": "./src/index.ts"
 	},
 	"scripts": {
 		"gen:stats": "bun scripts/generate-client-bundle.ts --generate",
@@ -39,16 +39,16 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
+		"@linxiraos/pi-ai": "1.1.1",
+		"@linxiraos/pi-catalog": "1.1.1",
+		"@linxiraos/pi-utils": "1.1.1",
 		"@tailwindcss/node": "^4.3.2",
 		"chart.js": "^4.5.1",
 		"lucide-react": "^1.24.0",
 		"react": "19.2.7",
 		"react-chartjs-2": "^5.3.1",
 		"react-dom": "19.2.7",
-		"tailwindcss": "^4.3.2",
-		"@linxiraos/pi-ai": "1.0.10",
-		"@linxiraos/pi-catalog": "1.0.10",
-		"@linxiraos/pi-utils": "1.0.10"
+		"tailwindcss": "^4.3.2"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14",
@@ -65,6 +65,8 @@
 		"tailwind.config.js",
 		"README.md",
 		"CHANGELOG.md",
+		"LICENSE",
+		"THIRD-PARTY-NOTICES.txt",
 		"dist/types",
 		"dist/client"
 	],

package/src/aggregator.ts

@@ -37,17 +37,18 @@ import { getSessionEntry, listAllSessionFiles, type ParseSessionResult, parseSes
 import type { SyncWorkerRequest, SyncWorkerResponse } from "./sync-worker";
 // Coding-agent binary/bundle workers route through the CLI entrypoint with a
 // hidden argv mode, so the compiled binary and npm bundle only need one
-// JavaScript entry. Standalone source `omp-stats` keeps using this package's
+// JavaScript entry. Standalone source `zeta-stats` keeps using this package's
 // own sync-worker source file.
 import type {
 	BehaviorDashboardStats,
 	DashboardStats,
+	FolderStats,
 	MessageStats,
 	ProviderDashboardStats,
 	RequestDetails,
 	ToolDashboardStats,
 } from "./types";
-import { computeUsageWindowStats, fetchUsageSnapshots } from "./usage-windows";
+import { computeUsageWindowStats, fetchUsageData } from "./usage-windows";
 
 /**
  * Apply a freshly parsed result to the database. Runs entirely on the
@@ -455,6 +456,13 @@ export async function getCostDashboardStats(range?: string | null): Promise<Pick
 		costSeries: getCostTimeSeries(costSeriesDays, cutoff),
 	};
 }
+
+export async function getFolderStats(range?: string | null): Promise<FolderStats[]> {
+	await initDb();
+	const { cutoff } = getTimeRangeConfig(range);
+	return getStatsByFolder(cutoff ?? undefined);
+}
+
 export async function getRecentRequests(limit?: number): Promise<MessageStats[]> {
 	await initDb();
 	return dbGetRecentRequests(limit);
@@ -521,14 +529,18 @@ export async function getToolDashboardStats(range?: string | null): Promise<Tool
  * 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.
+ *
+ * Window token estimates use broker-held fleet token burn when a broker is
+ * configured — the window fractions cover every install sharing the broker's
+ * credentials, so dividing them into local-only tokens would undercount.
  */
 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);
+	const usage = await fetchUsageData(cutoff ?? 0);
+	const tokensByProvider = usage.fleetTokensByProvider ?? new Map(providers.map(p => [p.provider, p.totalTokens]));
+	const { usageSeries, windowInsights } = computeUsageWindowStats(usage.rows, tokensByProvider);
 	return {
 		providers,
 		hourly: getProviderHourlyBurn(cutoff ?? undefined),

package/src/client/app/NavRail.tsx

@@ -37,7 +37,7 @@ export function NavRail({ activeSection, onSectionChange, className = "" }: NavR
 			</nav>
 
 			<div className="stats-nav-rail-footer">
-				<span className="stats-version-tag">OMP Stats v1.0.0</span>
+				<span className="stats-version-tag">Zeta Stats</span>
 			</div>
 		</aside>
 	);

package/src/client/data/formatters.ts

@@ -1,4 +1,5 @@
 import { formatDistanceToNow } from "@linxiraos/pi-utils/dates";
+import type { MessageStats } from "../types";
 
 export function formatInteger(value: number): string {
 	return value.toLocaleString();
@@ -17,6 +18,18 @@ export function formatCost(value: number, digits?: number): string {
 	})}`;
 }
 
+/** Format an API-equivalent estimate, using N/A when all usage is unpriced. */
+export function formatEstimatedCost(value: number, unpricedRequests: number, digits?: number): string {
+	return value === 0 && unpricedRequests > 0 ? "N/A" : formatCost(value, digits);
+}
+
+/** Format one request's cost, distinguishing unpriced SuperGrok usage from free usage. */
+export function formatMessageCost(message: Pick<MessageStats, "provider" | "usage">, digits?: number): string {
+	const unpricedRequests =
+		message.provider === "xai-oauth" && message.usage.totalTokens > 0 && message.usage.cost.total === 0 ? 1 : 0;
+	return formatEstimatedCost(message.usage.cost.total, unpricedRequests, digits);
+}
+
 export function formatPercent(value: number, digits = 1): string {
 	return `${(value * 100).toFixed(digits)}%`;
 }

package/src/client/data/view-models.ts

@@ -74,6 +74,7 @@ export function buildAgentTokenShare(stats: AgentTypeStats[]): AgentTokenShareVi
 
 export interface CostSummaryView {
 	totalCost: number;
+	unpricedRequests: number;
 	avgDailyCost: number;
 	topModelName: string;
 	topModelCost: number;
@@ -111,6 +112,7 @@ export interface FolderRowView extends FolderStats {
 
 export function buildCostSummary(costSeries: CostTimeSeriesPoint[]): CostSummaryView {
 	const totalCost = costSeries.reduce((sum, p) => sum + p.cost, 0);
+	const unpricedRequests = costSeries.reduce((sum, point) => sum + point.unpricedRequests, 0);
 	const dayBuckets = new Set(costSeries.map(p => p.timestamp)).size;
 	const avgDailyCost = dayBuckets > 0 ? totalCost / dayBuckets : 0;
 
@@ -130,6 +132,7 @@ export function buildCostSummary(costSeries: CostTimeSeriesPoint[]): CostSummary
 
 	return {
 		totalCost,
+		unpricedRequests,
 		avgDailyCost,
 		topModelName,
 		topModelCost,

package/src/client/routes/CostsRoute.tsx

@@ -13,7 +13,7 @@ import {
 	MODEL_COLORS,
 	styleDatasets,
 } from "../components/chart-shared";
-import { formatCost } from "../data/formatters";
+import { formatCost, formatEstimatedCost } from "../data/formatters";
 import { useResource } from "../data/useResource";
 import { buildCostSummary } from "../data/view-models";
 import type { CostTimeSeriesPoint, TimeRange } from "../types";
@@ -54,12 +54,22 @@ function CostOverviewPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }
 	const summary = useMemo(() => buildCostSummary(costSeries), [costSeries]);
 
 	const cards = [
-		{ label: "Total Cost", value: formatCost(summary.totalCost) },
-		{ label: "Average / Day", value: formatCost(summary.avgDailyCost) },
+		{
+			label: "API-equivalent estimate",
+			value: formatEstimatedCost(summary.totalCost, summary.unpricedRequests),
+			sub:
+				summary.unpricedRequests > 0
+					? `Excludes ${summary.unpricedRequests.toLocaleString()} unpriced subscription request${summary.unpricedRequests === 1 ? "" : "s"}`
+					: undefined,
+		},
+		{
+			label: "Average estimate / Day",
+			value: formatEstimatedCost(summary.avgDailyCost, summary.unpricedRequests),
+		},
 		{
 			label: "Top Model",
 			value: summary.topModelName || "—",
-			sub: summary.topModelName ? formatCost(summary.topModelCost) : undefined,
+			sub: summary.topModelName ? `API-equivalent estimate: ${formatCost(summary.topModelCost)}` : undefined,
 		},
 	];
 
@@ -71,7 +81,7 @@ function CostOverviewPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }
 					<p className="text-2xl font-bold stats-text-primary truncate" title={card.value}>
 						{card.value}
 					</p>
-					{card.sub && <p className="text-xs stats-text-muted mt-1 font-medium">Total spent: {card.sub}</p>}
+					{card.sub && <p className="text-xs stats-text-muted mt-1 font-medium">{card.sub}</p>}
 				</Panel>
 			))}
 		</div>
@@ -118,6 +128,10 @@ function CostTrendPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
 	const [byModel, setByModel] = useState(false);
 	const theme = useSystemTheme();
 	const chartTheme = CHART_THEMES[theme];
+	const unpricedRequests = useMemo(
+		() => costSeries.reduce((sum, point) => sum + point.unpricedRequests, 0),
+		[costSeries],
+	);
 
 	const chartData = useMemo(() => {
 		if (byModel) {
@@ -130,7 +144,7 @@ function CostTrendPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
 				bucketToValue: bucket => bucket.total,
 			});
 		}
-		return buildAggregateTimeSeries<CostTimeSeriesPoint, { total: number }>(costSeries, "Cost", {
+		return buildAggregateTimeSeries<CostTimeSeriesPoint, { total: number }>(costSeries, "API-equivalent estimate", {
 			initBucket: () => ({ total: 0 }),
 			accumulate: (bucket, point) => {
 				bucket.total += point.cost;
@@ -143,7 +157,7 @@ function CostTrendPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
 		return buildSharedPlugins({
 			chartTheme,
 			showLegend: byModel,
-			defaultLabel: "Cost",
+			defaultLabel: "API-equivalent estimate",
 			formatValue: v => `$${v.toFixed(2)}`,
 			footer: items => {
 				if (!byModel || items.length < 2) return undefined;
@@ -214,14 +228,18 @@ function CostTrendPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
 
 	return (
 		<Panel
-			title="Daily Cost"
-			subtitle="API spending over time"
+			title="Daily API-equivalent estimate"
+			subtitle={
+				unpricedRequests > 0
+					? `Public API rate-card value over time; excludes ${unpricedRequests.toLocaleString()} unpriced subscription request${unpricedRequests === 1 ? "" : "s"}`
+					: "Public API rate-card value over time"
+			}
 			actions={<SegmentedControl options={toggleOptions} value={byModel} onChange={setByModel} />}
 		>
 			<div className="h-[300px]">
 				{chartData.labels.length === 0 ? (
 					<div className="h-full flex items-center justify-center text-stats-muted text-sm">
-						No cost data available
+						No API-equivalent estimate data available
 					</div>
 				) : byModel && lineData ? (
 					<Line data={lineData} options={lineOptions} />

package/src/client/routes/ErrorsRoute.tsx

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 import { getRecentErrors } from "../api";
-import { formatCost, formatInteger, formatRelativeTime } from "../data/formatters";
+import { formatInteger, formatMessageCost, formatRelativeTime } from "../data/formatters";
 import { useResource } from "../data/useResource";
 import type { MessageStats, TimeRange } from "../types";
 import { AsyncBoundary, DataTable, Panel, StatusPill } from "../ui";
@@ -59,9 +59,9 @@ export function ErrorsRoute({ active, range, refreshTrigger, onRequestClick }: E
 			},
 			{
 				key: "cost",
-				header: "Cost",
+				header: "API-equivalent estimate",
 				numeric: true,
-				render: (item: MessageStats) => formatCost(item.usage.cost.total, 4),
+				render: (item: MessageStats) => formatMessageCost(item, 4),
 			},
 		],
 		[],
@@ -82,8 +82,8 @@ export function ErrorsRoute({ active, range, refreshTrigger, onRequestClick }: E
 					<div className="stats-mobile-card-value">{formatRelativeTime(item.timestamp)}</div>
 				</div>
 				<div>
-					<div className="stats-mobile-card-label">Cost</div>
-					<div className="stats-mobile-card-value">{formatCost(item.usage.cost.total, 4)}</div>
+					<div className="stats-mobile-card-label">API-equivalent estimate</div>
+					<div className="stats-mobile-card-value">{formatMessageCost(item, 4)}</div>
 				</div>
 				<div>
 					<div className="stats-mobile-card-label">Tokens</div>

package/src/client/routes/ModelsRoute.tsx

@@ -18,6 +18,7 @@ import {
 	TrendEmpty,
 } from "../components/models-table-shared";
 import { formatRangeTick, rangeMeta } from "../components/range-meta";
+import { formatEstimatedCost } from "../data/formatters";
 import { useResource } from "../data/useResource";
 import { buildModelPerformanceLookup } from "../data/view-models";
 import type { ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeRange } from "../types";
@@ -266,7 +267,7 @@ function ModelsTable({
 				columns={[
 					{ label: "Model" },
 					{ label: "Requests", align: "right" },
-					{ label: "Cost", align: "right" },
+					{ label: "API-equivalent estimate", align: "right" },
 					{ label: "Tokens", align: "right" },
 					{ label: "Tokens/s", align: "right" },
 					{ label: "TTFT", align: "right" },
@@ -295,7 +296,7 @@ function ModelsTable({
 									{model.totalRequests.toLocaleString()}
 								</div>,
 								<div key="cost" className="text-right text-[var(--text-secondary)] font-mono text-sm">
-									${model.totalCost.toFixed(2)}
+									{formatEstimatedCost(model.totalCost, model.unpricedRequests)}
 								</div>,
 								<div key="tokens" className="text-right text-[var(--text-secondary)] font-mono text-sm">
 									{(model.totalInputTokens + model.totalOutputTokens).toLocaleString()}

package/src/client/routes/OverviewRoute.tsx

@@ -4,7 +4,7 @@ import { Line } from "react-chartjs-2";
 import { getOverviewStats, getRecentRequests } from "../api";
 import { AgentTokenShare } from "../components/AgentTokenShare";
 import { CHART_THEMES } from "../components/chart-shared";
-import { formatCost, formatDurationMs, formatInteger, formatRelativeTime } from "../data/formatters";
+import { formatDurationMs, formatInteger, formatMessageCost, formatRelativeTime } from "../data/formatters";
 import { useResource } from "../data/useResource";
 import type { MessageStats, TimeRange } from "../types";
 import { AsyncBoundary, DataTable, MetricCluster, Panel, Skeleton, StatusPill } from "../ui";
@@ -157,9 +157,9 @@ export function OverviewRoute({ active, range, refreshTrigger, onRequestClick }:
 			},
 			{
 				key: "cost",
-				header: "Cost",
+				header: "API-equivalent estimate",
 				numeric: true,
-				render: (item: MessageStats) => formatCost(item.usage.cost.total, 4),
+				render: (item: MessageStats) => formatMessageCost(item, 4),
 			},
 			{
 				key: "duration",
@@ -198,8 +198,8 @@ export function OverviewRoute({ active, range, refreshTrigger, onRequestClick }:
 					<div className="stats-mobile-card-value">{formatRelativeTime(item.timestamp)}</div>
 				</div>
 				<div>
-					<div className="stats-mobile-card-label">Cost</div>
-					<div className="stats-mobile-card-value">{formatCost(item.usage.cost.total, 4)}</div>
+					<div className="stats-mobile-card-label">API-equivalent estimate</div>
+					<div className="stats-mobile-card-value">{formatMessageCost(item, 4)}</div>
 				</div>
 				<div>
 					<div className="stats-mobile-card-label">Tokens</div>
@@ -298,7 +298,7 @@ export function OverviewRoute({ active, range, refreshTrigger, onRequestClick }:
 													<div>{req.provider}</div>
 													<div>
 														{req.duration ? formatDurationMs(req.duration) : ""}{" "}
-														{req.usage?.cost?.total ? `· ${formatCost(req.usage.cost.total, 4)}` : ""}
+														{req.usage.totalTokens > 0 ? `· ${formatMessageCost(req, 4)}` : ""}
 													</div>
 												</div>
 												{isError && (

package/src/client/routes/ProjectsRoute.tsx

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 import { getFolderStats } from "../api";
-import { formatCost, formatDurationMs, formatInteger, formatPercent } from "../data/formatters";
+import { formatDurationMs, formatEstimatedCost, formatInteger, formatPercent } from "../data/formatters";
 import { useResource } from "../data/useResource";
 import { buildFolderRows, type FolderRowView } from "../data/view-models";
 import type { TimeRange } from "../types";
@@ -60,11 +60,11 @@ export function ProjectsRoute({ active, range, refreshTrigger }: ProjectsRoutePr
 			},
 			{
 				key: "totalCost",
-				header: "Cost",
+				header: "API-equivalent estimate",
 				numeric: true,
 				render: (item: FolderRowView) => (
 					<div className="stats-text-right">
-						<div className="font-mono">{formatCost(item.totalCost)}</div>
+						<div className="font-mono">{formatEstimatedCost(item.totalCost, item.unpricedRequests)}</div>
 						<div className="stats-progress-bar-track mt-1 ml-auto w-24 h-1">
 							<div
 								className="stats-progress-bar-fill"
@@ -133,8 +133,10 @@ export function ProjectsRoute({ active, range, refreshTrigger }: ProjectsRoutePr
 					<div className="stats-mobile-card-value font-mono">{formatInteger(item.totalRequests)}</div>
 				</div>
 				<div>
-					<div className="stats-mobile-card-label">Cost</div>
-					<div className="stats-mobile-card-value font-mono">{formatCost(item.totalCost)}</div>
+					<div className="stats-mobile-card-label">API-equivalent estimate</div>
+					<div className="stats-mobile-card-value font-mono">
+						{formatEstimatedCost(item.totalCost, item.unpricedRequests)}
+					</div>
 				</div>
 				<div>
 					<div className="stats-mobile-card-label">Cache Rate</div>