@oh-my-pi/omp-stats 16.3.0 → 16.3.2

package/dist/client/styles.css

@@ -1,4 +1,4 @@
-/*! tailwindcss v4.3.1 | MIT License | https://tailwindcss.com */
+/*! tailwindcss v4.3.2 | MIT License | https://tailwindcss.com */
 @layer properties;
 @layer theme, base, components, utilities;
 @layer theme {
@@ -244,6 +244,9 @@
   .w-full {
     width: 100%;
   }
+  .max-w-\[280px\] {
+    max-width: 280px;
+  }
   .max-w-\[440px\] {
     max-width: 440px;
   }

package/dist/types/aggregator.d.ts

@@ -1,4 +1,4 @@
-import type { BehaviorDashboardStats, DashboardStats, MessageStats, RequestDetails } from "./types";
+import type { BehaviorDashboardStats, DashboardStats, MessageStats, RequestDetails, ToolDashboardStats } from "./types";
 /**
  * Progress event emitted after each session file is fully processed.
  * `current` is the number of files completed (skipped + parsed),
@@ -79,4 +79,9 @@ export declare function getRequestDetails(id: number): Promise<RequestDetails |
  */
 export declare function getTotalMessageCount(): Promise<number>;
 export declare function getBehaviorDashboardStats(range?: string | null): Promise<BehaviorDashboardStats>;
+/**
+ * Get the tools dashboard payload: per-tool totals, per-(tool, model)
+ * breakdown, and the call time series (bucketed like the model series).
+ */
+export declare function getToolDashboardStats(range?: string | null): Promise<ToolDashboardStats>;
 export {};

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

@@ -1,4 +1,4 @@
-import type { BehaviorDashboardStats, CostDashboardStats, FolderStats, GainDashboardStats, MessageStats, ModelDashboardStats, OverviewStats, RequestDetails, TimeRange } from "./types";
+import type { BehaviorDashboardStats, CostDashboardStats, FolderStats, GainDashboardStats, MessageStats, ModelDashboardStats, OverviewStats, RequestDetails, TimeRange, ToolDashboardStats } from "./types";
 export declare class ApiError extends Error {
     status: number;
     endpoint: string;
@@ -18,3 +18,4 @@ export declare function sync(signal?: AbortSignal): Promise<{
 export declare function getBehaviorDashboardStats(range?: TimeRange, signal?: AbortSignal): Promise<BehaviorDashboardStats>;
 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>;

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

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

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

@@ -1,4 +1,4 @@
-import type { AgentType, AgentTypeStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, ModelPerformancePoint, TimeRange } from "../types";
+import type { AgentType, AgentTypeStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, ModelPerformancePoint, TimeRange, ToolUsageStats } from "../types";
 export interface AgentTokenSegment {
     agentType: AgentType;
     /** input + output + cache read + cache write — the displayed denominator. */
@@ -57,3 +57,11 @@ export declare function buildCostSummary(costSeries: CostTimeSeriesPoint[]): Cos
 export declare function buildModelPerformanceLookup(points: ModelPerformancePoint[], range: TimeRange): Map<string, ModelPerformanceSeries>;
 export declare function buildBehaviorSummary(overall: BehaviorOverallStats, series: BehaviorTimeSeriesPoint[]): BehaviorSummaryView;
 export declare function buildFolderRows(folders: FolderStats[]): FolderRowView[];
+/** Table row for the Tools route: usage stats plus derived rates/shares. */
+export interface ToolRowView extends ToolUsageStats {
+    /** errors / calls (0 for zero calls). */
+    errorRate: number;
+    /** Calls relative to the busiest tool, 0-100, for the share bar. */
+    callsPercentage: number;
+}
+export declare function buildToolRows(tools: ToolUsageStats[]): ToolRowView[];

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

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

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

@@ -6,3 +6,4 @@ export * from "./ModelsRoute";
 export * from "./OverviewRoute";
 export * from "./ProjectsRoute";
 export * from "./RequestsRoute";
+export * from "./ToolsRoute";

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, UserMessageLink, UserMessageStats } from "./types";
+import type { AgentTypeStats, AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolCallStats, ToolModelStats, ToolResultLink, ToolTimeSeriesPoint, ToolUsageStats, UserMessageLink, UserMessageStats } from "./types";
 /**
  * Initialize the database and create tables.
  */
@@ -112,3 +112,33 @@ export declare function getBehaviorOverall(cutoff?: number | null): BehaviorOver
  * user messages that never received an assistant reply.
  */
 export declare function getBehaviorByModel(cutoff?: number | null): BehaviorModelStats[];
+/**
+ * Insert tool-call rows. Idempotent via UNIQUE(session_file, tool_call_id);
+ * the `WHERE NOT EXISTS` guard mirrors {@link insertMessageStats}: forked
+ * sessions deep-copy assistant entries (same `entry_id`, `timestamp`, and
+ * tool-call ids under a new file), so first-write-wins across the lineage
+ * keeps aggregates from double counting. Keyed on the assistant entry
+ * identity, not the call id alone — provider call ids are not a global
+ * namespace across unrelated sessions.
+ */
+export declare function insertToolCalls(calls: ToolCallStats[]): number;
+/**
+ * Attach result size / error flag to persisted tool-call rows. Results can
+ * land in a later incremental sync pass than the call that produced them, so
+ * this is an UPDATE keyed by (session_file, tool_call_id). The `IS NULL`
+ * guard makes re-syncs idempotent; rows skipped by the fork guard simply
+ * never match.
+ */
+export declare function updateToolResults(links: ToolResultLink[]): number;
+/**
+ * Get tool usage aggregated by tool name.
+ */
+export declare function getToolStats(cutoff?: number): ToolUsageStats[];
+/**
+ * Get tool usage aggregated by (tool, model, provider).
+ */
+export declare function getToolStatsByModel(cutoff?: number): ToolModelStats[];
+/**
+ * Get tool-call time series (one point per bucket per tool).
+ */
+export declare function getToolTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ToolTimeSeriesPoint[];

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
-export { getDashboardStats, getTotalMessageCount, type SyncOptions, type SyncProgress, smokeTestSyncWorker, syncAllSessions, } from "./aggregator";
+export { getDashboardStats, getToolDashboardStats, getTotalMessageCount, type SyncOptions, type SyncProgress, smokeTestSyncWorker, syncAllSessions, } from "./aggregator";
 export { closeDb } from "./db";
 export { getGainDashboardStats } from "./gain-aggregator";
 export { startServer } from "./server";
 export type { GainDashboardStats, GainSource, GainSourceTotals, GainTimeSeriesPoint, } from "./shared-types";
-export type { AggregatedStats, DashboardStats, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, } from "./types";
+export type { AggregatedStats, DashboardStats, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolDashboardStats, ToolModelStats, ToolTimeSeriesPoint, ToolUsageStats, } from "./types";

package/dist/types/parser.d.ts

@@ -1,4 +1,4 @@
-import type { AgentType, MessageStats, SessionEntry, UserMessageLink, UserMessageStats } from "./types";
+import type { AgentType, MessageStats, SessionEntry, ToolCallStats, ToolResultLink, UserMessageLink, UserMessageStats } from "./types";
 /**
  * Classify which agent produced a transcript from its path within the sessions
  * directory. Layout: `<sessionsDir>/<project>/<file>.jsonl` is the `main`
@@ -30,6 +30,8 @@ export interface ParseSessionResult {
     stats: MessageStats[];
     userStats: UserMessageStats[];
     userLinks: UserMessageLink[];
+    toolCalls: ToolCallStats[];
+    toolResults: ToolResultLink[];
     newOffset: number;
 }
 export declare function parseSessionFile(sessionPath: string, fromOffset?: number): Promise<ParseSessionResult>;

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

@@ -251,3 +251,51 @@ export interface GainDashboardStats {
     /** All distinct projects seen in the data, for the selector. */
     projects: string[];
 }
+/**
+ * Aggregated usage for a single tool over the active range.
+ *
+ * Token/cost fields are the *real* provider usage of the assistant turns that
+ * invoked the tool, split evenly across that turn's tool calls so the numbers
+ * stay additive (a turn with 3 calls contributes a third of its usage to each
+ * tool). Payload fields (`argsChars`/`resultChars`) are raw character counts
+ * of the serialized arguments and the text fed back into context — a size
+ * proxy, not provider-counted tokens.
+ */
+export interface ToolUsageStats {
+    /** Tool name as recorded on the tool call. */
+    tool: string;
+    /** Number of tool calls. */
+    calls: number;
+    /** Calls whose result came back with `isError`. */
+    errors: number;
+    /** Serialized tool-call argument characters. */
+    argsChars: number;
+    /** Text characters of tool results fed back into context. */
+    resultChars: number;
+    /** Total provider tokens of invoking turns, attributed per call share. */
+    totalTokensShare: number;
+    /** Output tokens of invoking turns, attributed per call share. */
+    outputTokensShare: number;
+    /** Cost (USD) of invoking turns, attributed per call share. */
+    costShare: number;
+    /** Unix ms of the most recent call in range. */
+    lastUsed: number;
+}
+/** Per-(tool, model) breakdown with the same attribution as {@link ToolUsageStats}. */
+export interface ToolModelStats extends ToolUsageStats {
+    model: string;
+    provider: string;
+}
+/** Tool-call time-series point (one bucket per tool). */
+export interface ToolTimeSeriesPoint {
+    timestamp: number;
+    tool: string;
+    calls: number;
+    errors: number;
+}
+/** Complete tools dashboard payload. */
+export interface ToolDashboardStats {
+    byTool: ToolUsageStats[];
+    byToolModel: ToolModelStats[];
+    series: ToolTimeSeriesPoint[];
+}

package/dist/types/types.d.ts

@@ -121,3 +121,44 @@ export interface UserMessageLink {
     model: string;
     provider: string;
 }
+/**
+ * One tool call extracted from an assistant message's `toolCall` content
+ * blocks. `callsInTurn` records how many calls that assistant turn contained
+ * so aggregation can split the turn's real provider usage evenly per call.
+ */
+export interface ToolCallStats {
+    /** Session file path */
+    sessionFile: string;
+    /** Assistant-message entry ID that emitted the call */
+    entryId: string;
+    /** Provider-assigned tool call ID (unique within a session) */
+    toolCallId: string;
+    /** Folder/project path (extracted from session filename) */
+    folder: string;
+    /** Tool name */
+    toolName: string;
+    /** Model that emitted the call */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** Assistant-message timestamp (Unix ms) */
+    timestamp: number;
+    /** Which agent produced the call */
+    agentType: AgentType;
+    /** Total tool calls in the same assistant turn (>= 1) */
+    callsInTurn: number;
+    /** Serialized argument characters */
+    argsChars: number;
+}
+/**
+ * Result linkage emitted when the parser sees a `toolResult` message entry.
+ * Applied as an UPDATE on the persisted tool-call row — results can land in a
+ * later incremental sync pass than the call that produced them.
+ */
+export interface ToolResultLink {
+    sessionFile: string;
+    toolCallId: string;
+    /** Text characters fed back into context */
+    resultChars: number;
+    isError: boolean;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/omp-stats",
-	"version": "16.3.0",
+	"version": "16.3.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": "16.3.0",
-		"@oh-my-pi/pi-catalog": "16.3.0",
-		"@oh-my-pi/pi-utils": "16.3.0",
+		"@oh-my-pi/pi-ai": "16.3.2",
+		"@oh-my-pi/pi-catalog": "16.3.2",
+		"@oh-my-pi/pi-utils": "16.3.2",
 		"@tailwindcss/node": "^4.3.0",
 		"chart.js": "^4.5.1",
 		"date-fns": "^4.4.0",

package/src/aggregator.ts

@@ -17,10 +17,15 @@ import {
 	getStatsByFolder,
 	getStatsByModel,
 	getTimeSeries,
+	getToolStats,
+	getToolStatsByModel,
+	getToolTimeSeries,
 	initDb,
 	insertMessageStats,
+	insertToolCalls,
 	insertUserMessageStats,
 	setFileOffset,
+	updateToolResults,
 	updateUserMessageLinks,
 } from "./db";
 import { getSessionEntry, listAllSessionFiles, type ParseSessionResult, parseSessionFile } from "./parser";
@@ -29,7 +34,7 @@ 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 } from "./types";
+import type { BehaviorDashboardStats, DashboardStats, MessageStats, RequestDetails, ToolDashboardStats } from "./types";
 
 /**
  * Apply a freshly parsed result to the database. Runs entirely on the
@@ -39,6 +44,8 @@ function applyParseResult(sessionFile: string, lastModified: number, result: Par
 	if (result.stats.length > 0) insertMessageStats(result.stats);
 	if (result.userStats.length > 0) insertUserMessageStats(result.userStats);
 	if (result.userLinks.length > 0) updateUserMessageLinks(result.userLinks);
+	if (result.toolCalls.length > 0) insertToolCalls(result.toolCalls);
+	if (result.toolResults.length > 0) updateToolResults(result.toolResults);
 	setFileOffset(sessionFile, result.newOffset, lastModified);
 	return result.stats.length + result.userStats.length;
 }
@@ -478,3 +485,17 @@ export async function getBehaviorDashboardStats(range?: string | null): Promise<
 		behaviorSeries: getBehaviorTimeSeries(cutoff),
 	};
 }
+
+/**
+ * Get the tools dashboard payload: per-tool totals, per-(tool, model)
+ * breakdown, and the call time series (bucketed like the model series).
+ */
+export async function getToolDashboardStats(range?: string | null): Promise<ToolDashboardStats> {
+	await initDb();
+	const { modelSeriesDays, modelSeriesBucketMs, cutoff } = getTimeRangeConfig(range);
+	return {
+		byTool: getToolStats(cutoff ?? undefined),
+		byToolModel: getToolStatsByModel(cutoff ?? undefined),
+		series: getToolTimeSeries(modelSeriesDays, cutoff, modelSeriesBucketMs),
+	};
+}

package/src/client/App.tsx

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

package/src/client/api.ts

@@ -8,6 +8,7 @@ import type {
 	OverviewStats,
 	RequestDetails,
 	TimeRange,
+	ToolDashboardStats,
 } from "./types";
 
 const API_BASE = "/api";
@@ -92,3 +93,10 @@ export async function getGainDashboardStats(
 	if (project) params.set("project", project);
 	return fetchJson<GainDashboardStats>(`${API_BASE}/stats/gain?${params}`, { signal });
 }
+
+export async function getToolDashboardStats(
+	range: TimeRange = "24h",
+	signal?: AbortSignal,
+): Promise<ToolDashboardStats> {
+	return fetchJson<ToolDashboardStats>(`${API_BASE}/stats/tools?range=${encodeURIComponent(range)}`, { signal });
+}

package/src/client/app/routes.ts

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

package/src/client/data/useHashRoute.ts

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

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

@@ -8,6 +8,7 @@ import type {
 	FolderStats,
 	ModelPerformancePoint,
 	TimeRange,
+	ToolUsageStats,
 } from "../types";
 
 /** Fixed display order for the agent-token-share breakdown. */
@@ -231,3 +232,20 @@ export function buildFolderRows(folders: FolderStats[]): FolderRowView[] {
 		requestsPercentage: maxRequests > 0 ? (f.totalRequests / maxRequests) * 100 : 0,
 	}));
 }
+
+/** Table row for the Tools route: usage stats plus derived rates/shares. */
+export interface ToolRowView extends ToolUsageStats {
+	/** errors / calls (0 for zero calls). */
+	errorRate: number;
+	/** Calls relative to the busiest tool, 0-100, for the share bar. */
+	callsPercentage: number;
+}
+
+export function buildToolRows(tools: ToolUsageStats[]): ToolRowView[] {
+	const maxCalls = tools.reduce((max, t) => Math.max(max, t.calls), 0);
+	return tools.map(t => ({
+		...t,
+		errorRate: t.calls > 0 ? t.errors / t.calls : 0,
+		callsPercentage: maxCalls > 0 ? (t.calls / maxCalls) * 100 : 0,
+	}));
+}