@oh-my-pi-zen/omp-stats 16.3.6-zen.1

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

@@ -0,0 +1,301 @@
+/**
+ * Shared type definitions consumed by both the server-side stats code and the
+ * standalone client bundle. Keep this file free of any imports from server-only
+ * packages (e.g. `@oh-my-pi-zen/pi-ai`, `bun:sqlite`) so the client can import it
+ * without dragging server dependencies into its bundle.
+ */
+/**
+ * Aggregated stats for a model or folder.
+ */
+export interface AggregatedStats {
+    /** Total number of requests */
+    totalRequests: number;
+    /** Number of successful requests */
+    successfulRequests: number;
+    /** Number of failed requests */
+    failedRequests: number;
+    /** Error rate (0-1) */
+    errorRate: number;
+    /** Total input tokens */
+    totalInputTokens: number;
+    /** Total output tokens */
+    totalOutputTokens: number;
+    /** Total cache read tokens */
+    totalCacheReadTokens: number;
+    /** Total cache write tokens */
+    totalCacheWriteTokens: number;
+    /** Cache hit rate (0-1) */
+    cacheRate: number;
+    /** Total cost */
+    totalCost: number;
+    /** Total premium requests */
+    totalPremiumRequests: number;
+    /** Average duration in ms */
+    avgDuration: number | null;
+    /** Average TTFT in ms */
+    avgTtft: number | null;
+    /** Average tokens per second (output tokens / duration) */
+    avgTokensPerSecond: number | null;
+    /** Time range */
+    firstTimestamp: number;
+    lastTimestamp: number;
+}
+/**
+ * Stats grouped by model.
+ */
+export interface ModelStats extends AggregatedStats {
+    model: string;
+    provider: string;
+}
+/**
+ * Stats grouped by folder.
+ */
+export interface FolderStats extends AggregatedStats {
+    folder: string;
+}
+/**
+ * Time series data point.
+ */
+export interface TimeSeriesPoint {
+    /** Bucket timestamp (start of hour/day) */
+    timestamp: number;
+    /** Request count */
+    requests: number;
+    /** Error count */
+    errors: number;
+    /** Total tokens */
+    tokens: number;
+    /** Total cost */
+    cost: number;
+}
+/**
+ * Model usage time series data point (daily buckets).
+ */
+export interface ModelTimeSeriesPoint {
+    /** Bucket timestamp (start of day) */
+    timestamp: number;
+    /** Model name */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** Request count */
+    requests: number;
+}
+/**
+ * Model performance time series data point (daily buckets).
+ */
+export interface ModelPerformancePoint {
+    /** Bucket timestamp (start of day) */
+    timestamp: number;
+    /** Model name */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** Request count */
+    requests: number;
+    /** Average TTFT in ms */
+    avgTtft: number | null;
+    /** Average tokens per second */
+    avgTokensPerSecond: number | null;
+}
+/**
+ * Cost time series data point (daily buckets).
+ */
+export interface CostTimeSeriesPoint {
+    /** Bucket timestamp (start of day) */
+    timestamp: number;
+    /** Model name */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** Total cost for this bucket */
+    cost: number;
+    /** Cost breakdown */
+    costInput: number;
+    costOutput: number;
+    costCacheRead: number;
+    costCacheWrite: number;
+    /** Request count */
+    requests: number;
+}
+/**
+ * Overall dashboard stats.
+ */
+export interface DashboardStats {
+    overall: AggregatedStats;
+    byModel: ModelStats[];
+    byFolder: FolderStats[];
+    byAgentType: AgentTypeStats[];
+    timeSeries: TimeSeriesPoint[];
+    modelSeries: ModelTimeSeriesPoint[];
+    modelPerformanceSeries: ModelPerformancePoint[];
+    costSeries: CostTimeSeriesPoint[];
+}
+/**
+ * Which agent produced a message, derived from its transcript file location
+ * inside the session directory: the top-level `<project>/<file>.jsonl` is the
+ * `main` agent, an `__advisor.jsonl` is the passive `advisor`, and any other
+ * nested transcript is a task `subagent`.
+ */
+export type AgentType = "main" | "subagent" | "advisor";
+/**
+ * Token usage aggregated by {@link AgentType} over the active range. Token
+ * columns are explicit so the dashboard's share denominator matches the
+ * counts it renders (input + output + cache read + cache write).
+ */
+export interface AgentTypeStats {
+    agentType: AgentType;
+    /** Total number of requests */
+    totalRequests: number;
+    /** Total input tokens */
+    totalInputTokens: number;
+    /** Total output tokens */
+    totalOutputTokens: number;
+    /** Total cache read tokens */
+    totalCacheReadTokens: number;
+    /** Total cache write tokens */
+    totalCacheWriteTokens: number;
+    /** Total cost */
+    totalCost: number;
+}
+/**
+ * Behavior time-series point (daily bucket, per responding model).
+ */
+export interface BehaviorTimeSeriesPoint {
+    /** Bucket timestamp (start of day) */
+    timestamp: number;
+    /** Responding model ("unknown" if user msg never got a reply) */
+    model: string;
+    /** Responding provider */
+    provider: string;
+    /** Number of user messages in bucket */
+    messages: number;
+    /** Total yelling sentences in bucket */
+    yelling: number;
+    /** Total profanity hits in bucket */
+    profanity: number;
+    /** Total anguish signal in bucket */
+    anguish: number;
+    /** Total corrective-negation hits in bucket */
+    negation: number;
+    /** Total user-repeating-themselves hits in bucket */
+    repetition: number;
+    /** Total second-person blame hits in bucket */
+    blame: number;
+    /** Total characters in bucket */
+    chars: number;
+}
+export interface BehaviorOverallStats {
+    totalMessages: number;
+    totalYelling: number;
+    totalProfanity: number;
+    totalAnguish: number;
+    totalNegation: number;
+    totalRepetition: number;
+    totalBlame: number;
+    totalChars: number;
+    firstTimestamp: number;
+    lastTimestamp: number;
+}
+/**
+ * Per-model behavioral aggregate over the active range.
+ */
+export interface BehaviorModelStats {
+    model: string;
+    provider: string;
+    totalMessages: number;
+    totalYelling: number;
+    totalProfanity: number;
+    totalAnguish: number;
+    totalNegation: number;
+    totalRepetition: number;
+    totalBlame: number;
+    totalChars: number;
+    lastTimestamp: number;
+}
+export interface BehaviorDashboardStats {
+    overall: BehaviorOverallStats;
+    byModel: BehaviorModelStats[];
+    behaviorSeries: BehaviorTimeSeriesPoint[];
+}
+/** Token savings from a single source type. */
+export interface GainSourceTotals {
+    savedTokens: number;
+    savedBytes: number;
+    hits: number;
+    /** originalBytes - savedBytes, when original is known */
+    outputBytes: number;
+    /** Total original bytes before compression, when known */
+    originalBytes: number;
+    /** savedBytes / originalBytes when both are known, else null */
+    reductionPercent: number | null;
+}
+/** Per-source breakdown. */
+export type GainSource = "snapcompact";
+/** Time-series point for gain (daily bucket). */
+export interface GainTimeSeriesPoint {
+    date: string;
+    snapcompact: number;
+    total: number;
+}
+/** Complete gain dashboard payload. */
+export interface GainDashboardStats {
+    /** Aggregate across all sources for the active range. */
+    overall: GainSourceTotals;
+    /** Per-source breakdown. */
+    bySource: Record<GainSource, GainSourceTotals>;
+    /** Daily time series. */
+    timeSeries: GainTimeSeriesPoint[];
+    /** Active project filter (cwd prefix), or null for all projects. */
+    project: string | null;
+    /** 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/sync-worker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Stateless parse worker for `syncAllSessions`. The main thread owns the
+ * SQLite handle; workers receive `{ sessionFile, fromOffset }`, run
+ * `parseSessionFile` (which is pure I/O + CPU, no DB), and post the
+ * structured-clone-safe result back. One in-flight request per worker so
+ * the main thread can fan jobs out 1:1 with the pool size.
+ *
+ * A `{ kind: "ping" }` request is also accepted and replies with
+ * `{ ok: true, kind: "pong" }` — used by `smokeTestSyncWorker` to prove the
+ * worker actually spawns and runs in compiled binaries (regression coverage
+ * for issue #1011 / PR #1027, where the worker silently failed to load).
+ */
+import { type ParseSessionResult } from "./parser";
+export type SyncWorkerRequest = {
+    kind?: "parse";
+    sessionFile: string;
+    fromOffset: number;
+} | {
+    kind: "ping";
+};
+export type SyncWorkerResponse = {
+    ok: true;
+    kind?: "parse";
+    result: ParseSessionResult;
+} | {
+    ok: true;
+    kind: "pong";
+} | {
+    ok: false;
+    error: string;
+};

package/dist/types/types.d.ts

@@ -0,0 +1,164 @@
+import type { AssistantMessage, ServiceTier, ServiceTierByFamily, StopReason, Usage } from "@oh-my-pi-zen/pi-ai";
+import type { AgentType } from "./shared-types";
+export * from "./shared-types";
+/**
+ * Extracted stats from an assistant message.
+ */
+export interface MessageStats {
+    /** Database ID */
+    id?: number;
+    /** Session file path */
+    sessionFile: string;
+    /** Entry ID within the session */
+    entryId: string;
+    /** Folder/project path (extracted from session filename) */
+    folder: string;
+    /** Model ID */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** API type */
+    api: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    /** Request duration in milliseconds */
+    duration: number | null;
+    /** Time to first token in milliseconds */
+    ttft: number | null;
+    /** Stop reason */
+    stopReason: StopReason;
+    /** Error message if stopReason is error */
+    errorMessage: string | null;
+    /** Token usage */
+    usage: Usage;
+    /** Which agent produced this message (main agent, task subagent, advisor) */
+    agentType: AgentType;
+}
+/**
+ * Full details of a request, including content.
+ */
+export interface RequestDetails extends MessageStats {
+    /** The full conversation history or just the last turn. */
+    messages: unknown[];
+    /** The model's response. */
+    output: unknown;
+}
+/**
+ * Session log entry types.
+ */
+export interface SessionHeader {
+    type: "session";
+    version: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+    title?: string;
+}
+export interface SessionMessageEntry {
+    type: "message";
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+    message: AssistantMessage | {
+        role: "user" | "toolResult";
+    };
+}
+export interface SessionServiceTierChangeEntry {
+    type: "service_tier_change";
+    id: string;
+    parentId?: string | null;
+    timestamp: string;
+    serviceTier: ServiceTierByFamily | ServiceTier | null;
+}
+export type SessionEntry = SessionHeader | SessionMessageEntry | SessionServiceTierChangeEntry | {
+    type: string;
+};
+/**
+ * Behavioral stats extracted from a single user message.
+ */
+export interface UserMessageStats {
+    /** Database ID */
+    id?: number;
+    /** Session file path */
+    sessionFile: string;
+    /** Entry ID within the session */
+    entryId: string;
+    /** Folder/project path */
+    folder: string;
+    /** Unix timestamp in ms */
+    timestamp: number;
+    /** Model that responded to this user message, if linked */
+    model: string | null;
+    /** Provider that responded to this user message, if linked */
+    provider: string | null;
+    /** Total characters of message text */
+    chars: number;
+    /** Whitespace-delimited word count */
+    words: number;
+    /** Yelling sentences (> 50% uppercase letters) */
+    yelling: number;
+    /** Profanity hits */
+    profanity: number;
+    /** Catch-all upset signal: drama runs + `noooo`/`ughh`/... + `dude` + `..` */
+    anguish: number;
+    /** Corrective negation ("no", "nope", "thats not what i meant") */
+    negation: number;
+    /** User repeating themselves ("i meant", "still doesnt work", "like i said") */
+    repetition: number;
+    /** Second-person reproach ("you didnt", "you broke", "stop X-ing") */
+    blame: number;
+}
+/**
+ * Pair emitted by the parser when it sees an assistant message whose
+ * `parentId` points to a user message that wasn't parsed in the same pass
+ * (e.g. user prompt landed in an earlier incremental sync). The aggregator
+ * applies the link to the persisted `user_messages` row so it stops showing
+ * up in the "unknown" model bucket.
+ */
+export interface UserMessageLink {
+    sessionFile: string;
+    entryId: string;
+    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/dist/types/user-metrics.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Behavioral metrics extracted from a single user message.
+ *
+ * Pure, side-effect free. Designed for batch use during session ingestion
+ * and standalone testing.
+ */
+export interface UserMessageMetrics {
+    /** Total characters of analyzed text. */
+    chars: number;
+    /** Whitespace-delimited word count. */
+    words: number;
+    /**
+     * Number of "yelling" sentences: sentences where more than half of the
+     * alphabetic characters are uppercase (and there are enough letters to
+     * make the ratio meaningful - short acronyms like "OK" don't count).
+     */
+    yelling: number;
+    /** Profanity hits (word-boundary, case-insensitive). */
+    profanity: number;
+    /**
+     * Catch-all "obviously upset" signal computed on a *prose-only* body
+     * (code fences, XML/HTML tags, URLs, file mentions, and quoted lines
+     * are stripped first; messages whose remaining prose is >=3 lines score
+     * zero because formatted prompts aren't tantrums).
+     *
+     * Sum of:
+     * - drama runs: 3+ `!` / `?` (with `1`-mishit fallout)
+     * - elongated interjections: `noooo`, `ahhhh`, `ughhh`, `argh`, `stooop`,
+     *   `whyyy`, `fuuu(ck)`, `shiiit`, `wtfff`, `omggg`, `yessss`, `helpp`,
+     *   `goddd`, `dammm`, `bruhh`
+     * - standalone `dude`
+     * - dot runs: `..`, `...`, `....+`
+     */
+    anguish: number;
+    /**
+     * Corrective negation: the user is telling us we got it wrong.
+     *
+     * Counted on the same prose-only body as {@link anguish}.
+     *
+     * - line-leading `no` / `nope` / `nah` / `nvm` / `wrong` / `incorrect`
+     *   (word-bounded, so `now`, `nobody`, `north` don't match)
+     * - `that(?:'s)? not (what|right|it)` and `not what i (meant|asked|said|wanted)`
+     */
+    negation: number;
+    /**
+     * The user is repeating themselves - strong signal the previous turn
+     * missed the ask. Counts hits for:
+     *
+     * - `i (meant|said|asked|told you|already (said|told|did|asked|wrote))`
+     * - `(like|as) i (said|told you|asked)`
+     * - `still (doesn't|isn't|not|broken|wrong|fails|failing|the same|same)`
+     *
+     * Bare `still` / `again` are too ambiguous to count alone (they show up
+     * in normal speech like "try again" or "still works").
+     */
+    repetition: number;
+    /**
+     * Direct second-person reproach pinned on the agent:
+     *
+     * - `you (didn't|did not|broke|missed|forgot|keep|always|never|still|ignored)`
+     * - sentence-leading `stop <verb>ing` imperatives
+     */
+    blame: number;
+}
+/**
+ * Compute behavioral metrics for a user message.
+ *
+ * `text` may be empty or whitespace; in that case every metric is 0.
+ */
+export declare function computeUserMessageMetrics(text: string): UserMessageMetrics;
+/** Empty metrics constant for callers that need a default. */
+export declare const EMPTY_USER_METRICS: UserMessageMetrics;

package/package.json

@@ -0,0 +1,95 @@
+{
+	"type": "module",
+	"name": "@oh-my-pi-zen/omp-stats",
+	"version": "16.3.6-zen.1",
+	"description": "Local observability dashboard for pi AI usage statistics",
+	"homepage": "https://omp.sh",
+	"author": "Can Boluk",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/cagedbird043/oh-my-pi-zen.git",
+		"directory": "packages/stats"
+	},
+	"bugs": {
+		"url": "https://github.com/cagedbird043/oh-my-pi-zen/issues"
+	},
+	"keywords": [
+		"ai",
+		"observability",
+		"metrics",
+		"dashboard",
+		"llm",
+		"statistics"
+	],
+	"main": "./src/index.ts",
+	"types": "./dist/types/index.d.ts",
+	"bin": {
+		"omp-stats": "./src/index.ts"
+	},
+	"scripts": {
+		"gen:stats": "bun scripts/generate-client-bundle.ts --generate",
+		"gen:stats:reset": "bun scripts/generate-client-bundle.ts --reset",
+		"build": "bun run build.ts",
+		"dev": "bun run src/index.ts",
+		"check": "biome check . && bun run check:types",
+		"check:types": "tsgo -p tsconfig.json --noEmit && tsgo -p tsconfig.client.json --noEmit",
+		"lint": "biome lint .",
+		"fix": "biome check --write --unsafe .",
+		"fmt": "biome format --write ."
+	},
+	"dependencies": {
+		"@oh-my-pi-zen/pi-ai": "16.3.6-zen.1",
+		"@oh-my-pi-zen/pi-catalog": "16.3.6-zen.1",
+		"@oh-my-pi-zen/pi-utils": "16.3.6-zen.1",
+		"@tailwindcss/node": "^4.3.0",
+		"chart.js": "^4.5.1",
+		"date-fns": "^4.4.0",
+		"lucide-react": "^1.17.0",
+		"react": "19.2.7",
+		"react-chartjs-2": "^5.3.1",
+		"react-dom": "19.2.7",
+		"tailwindcss": "^4.3.0"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3.14",
+		"@types/react": "^19.2.17",
+		"@types/react-dom": "^19.2.3",
+		"postcss": "^8.5.15"
+	},
+	"engines": {
+		"bun": ">=1.3.14"
+	},
+	"files": [
+		"src",
+		"build.ts",
+		"tailwind.config.js",
+		"README.md",
+		"CHANGELOG.md",
+		"dist/types",
+		"dist/client"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./dist/types/*.d.ts",
+			"import": "./src/*.ts"
+		},
+		"./client": {
+			"types": "./dist/types/client/index.d.ts",
+			"import": "./src/client/index.tsx"
+		},
+		"./client/*": {
+			"types": "./dist/types/client/*.d.ts",
+			"import": "./src/client/*.ts"
+		},
+		"./client/components/*": {
+			"types": "./dist/types/client/components/*.d.ts",
+			"import": "./src/client/components/*.ts"
+		},
+		"./*.js": "./src/*.ts"
+	}
+}