@oh-my-pi/omp-stats 15.1.0 → 15.1.2

package/dist/types/db.d.ts

@@ -0,0 +1,93 @@
+import { Database } from "bun:sqlite";
+import type { AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, UserMessageLink, UserMessageStats } from "./types";
+/**
+ * Initialize the database and create tables.
+ */
+export declare function initDb(): Promise<Database>;
+/**
+ * Get the stored offset for a session file.
+ */
+export declare function getFileOffset(sessionFile: string): {
+    offset: number;
+    lastModified: number;
+} | null;
+/**
+ * Update the stored offset for a session file.
+ */
+export declare function setFileOffset(sessionFile: string, offset: number, lastModified: number): void;
+/**
+ * Insert message stats into the database.
+ */
+export declare function insertMessageStats(stats: MessageStats[]): number;
+/**
+ * Get overall aggregated stats.
+ */
+export declare function getOverallStats(cutoff?: number): AggregatedStats;
+/**
+ * Get stats grouped by model.
+ */
+export declare function getStatsByModel(cutoff?: number): ModelStats[];
+/**
+ * Get stats grouped by folder.
+ */
+export declare function getStatsByFolder(cutoff?: number): FolderStats[];
+/**
+ * Get time series data.
+ */
+export declare function getTimeSeries(hours?: number, cutoff?: number | null, bucketMs?: number): TimeSeriesPoint[];
+/**
+ * Get daily performance time series data for the last N days.
+ */
+/**
+ * Get daily model usage time series data for the last N days.
+ */
+export declare function getModelTimeSeries(days?: number, cutoff?: number | null): ModelTimeSeriesPoint[];
+/**
+ * Get daily model performance time series data for the last N days.
+ */
+export declare function getModelPerformanceSeries(days?: number, cutoff?: number | null): ModelPerformancePoint[];
+/**
+ * Get total message count.
+ */
+export declare function getMessageCount(): number;
+/**
+ * Close the database connection.
+ */
+export declare function closeDb(): void;
+export declare function getRecentRequests(limit?: number): MessageStats[];
+export declare function getRecentErrors(limit?: number): MessageStats[];
+export declare function getMessageById(id: number): MessageStats | null;
+/**
+ * Get daily cost time series data for the last N days, broken down by model.
+ */
+export declare function getCostTimeSeries(days?: number, cutoff?: number | null): CostTimeSeriesPoint[];
+export declare function markPriorityPremiumRequestsBackfillComplete(): void;
+export declare function markUserMessagesBackfillComplete(): void;
+export declare function markUserMessageLinksRepairComplete(): void;
+/**
+ * Insert user-message stats. Idempotent via UNIQUE(session_file, entry_id).
+ */
+export declare function insertUserMessageStats(stats: UserMessageStats[]): number;
+/**
+ * Backfill the responding `model`/`provider` on user-message rows that were
+ * persisted before their assistant reply was parsed (a side effect of
+ * incremental `fromOffset` syncing: the `userByEntryId` map in
+ * `parseSessionFile` only spans a single pass). Each row is updated at most
+ * once because the `model IS NULL` guard short-circuits subsequent passes.
+ *
+ * Returns the number of rows actually updated.
+ */
+export declare function updateUserMessageLinks(links: UserMessageLink[]): number;
+/**
+ * Daily behavioral time series, grouped by responding model+provider.
+ */
+export declare function getBehaviorTimeSeries(cutoff?: number | null): BehaviorTimeSeriesPoint[];
+/**
+ * Overall behavioral totals across the cutoff window.
+ */
+export declare function getBehaviorOverall(cutoff?: number | null): BehaviorOverallStats;
+/**
+ * Per-model behavioral totals over the cutoff window. "Unknown" represents
+ * user messages that never received an assistant reply.
+ */
+export declare function getBehaviorByModel(cutoff?: number | null): BehaviorModelStats[];

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+export { getDashboardStats, getTotalMessageCount, type SyncOptions, type SyncProgress, smokeTestSyncWorker, syncAllSessions, } from "./aggregator";
+export { closeDb } from "./db";
+export { startServer } from "./server";
+export type { AggregatedStats, DashboardStats, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, } from "./types";

package/dist/types/parser.d.ts

@@ -0,0 +1,40 @@
+import type { MessageStats, SessionEntry, UserMessageLink, UserMessageStats } from "./types";
+/**
+ * Parse a session file and extract all assistant message stats.
+ * Uses incremental reading with offset tracking.
+ *
+ * Service-tier carry-over: `currentServiceTier` is a session-scoped piece of
+ * state derived from `service_tier_change` entries that affects whether
+ * subsequent OpenAI assistant replies count as premium requests. Incremental
+ * syncs that resume past the most-recent tier change would otherwise lose
+ * that state and silently record `premiumRequests = 0` for priority traffic
+ * (the coding-agent stopped folding the tier into `usage.premiumRequests`
+ * after 13f59162e — the parser is now the sole source of truth). When
+ * `fromOffset > 0` we therefore scan the bytes preceding `fromOffset`
+ * for the latest service-tier value before parsing the unprocessed tail.
+ * The scan only keeps the current tier and does not materialize prefix
+ * entries, preserving offset-based memory behavior for large sessions.
+ */
+export interface ParseSessionResult {
+    stats: MessageStats[];
+    userStats: UserMessageStats[];
+    userLinks: UserMessageLink[];
+    newOffset: number;
+}
+export declare function parseSessionFile(sessionPath: string, fromOffset?: number): Promise<ParseSessionResult>;
+/**
+ * List all session directories (folders).
+ */
+export declare function listSessionFolders(): Promise<string[]>;
+/**
+ * List all session files in a folder.
+ */
+export declare function listSessionFiles(folderPath: string): Promise<string[]>;
+/**
+ * List all session files across all folders.
+ */
+export declare function listAllSessionFiles(): Promise<string[]>;
+/**
+ * Find a specific entry in a session file.
+ */
+export declare function getSessionEntry(sessionPath: string, entryId: string): Promise<SessionEntry | null>;

package/dist/types/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Start the HTTP server.
+ */
+export declare function startServer(port?: number): Promise<{
+    port: number;
+    stop: () => void;
+}>;

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

@@ -0,0 +1,192 @@
+/**
+ * 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/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[];
+    timeSeries: TimeSeriesPoint[];
+    modelSeries: ModelTimeSeriesPoint[];
+    modelPerformanceSeries: ModelPerformancePoint[];
+    costSeries: CostTimeSeriesPoint[];
+}
+/**
+ * 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[];
+}

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,120 @@
+import type { AssistantMessage, ServiceTier, StopReason, Usage } from "@oh-my-pi/pi-ai";
+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;
+}
+/**
+ * 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: 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;
+}

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

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/omp-stats",
-	"version": "15.1.0",
+	"version": "15.1.2",
 	"description": "Local observability dashboard for pi AI usage statistics",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -23,7 +23,7 @@
 		"statistics"
 	],
 	"main": "./src/index.ts",
-	"types": "./src/index.ts",
+	"types": "./dist/types/index.d.ts",
 	"bin": {
 		"omp-stats": "./src/index.ts"
 	},
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "15.1.0",
-		"@oh-my-pi/pi-utils": "15.1.0",
+		"@oh-my-pi/pi-ai": "15.1.2",
+		"@oh-my-pi/pi-utils": "15.1.2",
 		"@tailwindcss/node": "^4.2.4",
 		"chart.js": "^4.5.1",
 		"date-fns": "^4.1.0",
@@ -61,27 +61,29 @@
 		"src",
 		"build.ts",
 		"tailwind.config.js",
-		"README.md"
+		"README.md",
+		"dist/types",
+		"dist/client"
 	],
 	"exports": {
 		".": {
-			"types": "./src/index.ts",
+			"types": "./dist/types/index.d.ts",
 			"import": "./src/index.ts"
 		},
 		"./*": {
-			"types": "./src/*.ts",
+			"types": "./dist/types/*.d.ts",
 			"import": "./src/*.ts"
 		},
 		"./client": {
-			"types": "./src/client/index.tsx",
+			"types": "./dist/types/client/index.d.ts",
 			"import": "./src/client/index.tsx"
 		},
 		"./client/*": {
-			"types": "./src/client/*.ts",
+			"types": "./dist/types/client/*.d.ts",
 			"import": "./src/client/*.ts"
 		},
 		"./client/components/*": {
-			"types": "./src/client/components/*.ts",
+			"types": "./dist/types/client/components/*.d.ts",
 			"import": "./src/client/components/*.ts"
 		},
 		"./*.js": "./src/*.ts"