@oh-my-pi/omp-stats 18.3.5 → 18.4.0

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

@@ -182,65 +182,91 @@ export interface AgentTypeStats {
     totalCost: number;
 }
 /**
- * Behavior time-series point (daily bucket, per responding model).
+ * Frustration tallies over a set of user messages. Each message counts once,
+ * classified by its cached judge verdict when one exists, else by the regex
+ * behavior signals stored at ingest (see `frustration.ts` for both rules).
  */
-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 */
+export interface FrustrationCounts {
+    /** User messages with non-empty prose. */
     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;
+    /** Messages whose prose has a cached judge verdict; the rest use regex fallback. */
+    judged: number;
+    /** Annoyed at anything (the assistant, tooling, other people, ...). */
+    annoyed: number;
+    /** Annoyed and aimed at the assistant. Subset of `annoyed`. */
+    atAssistant: number;
+    /** Aimed at the assistant and hostile/angry. Subset of `atAssistant`. */
+    angry: number;
 }
 /**
- * Per-model behavioral aggregate over the active range.
+ * Frustration tallies for one model version. Provider/spelling variants of the
+ * same model (`claude-opus-4.6`, `anthropic/claude-opus-4-6`) merge under one
+ * catalog identity.
  */
-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[];
-}
+export interface FrustrationModelStats extends FrustrationCounts {
+    /** Stable key: `class/family/revision` when classified, else the raw model id. */
+    key: string;
+    /** Display label, e.g. `opus 4.5`; the raw model id when unclassified. */
+    label: string;
+    /** Catalog identity class, e.g. `anthropic`; `unknown` when unclassified. */
+    modelClass: string;
+    /** Catalog family within the class, e.g. `opus`. */
+    family: string | null;
+    /** Canonical `major.minor.patch`, e.g. `4.5.0`. */
+    revision: string | null;
+    /** Raw model ids merged into this row. */
+    models: string[];
+    /** Earliest message timestamp (ms) in range. */
+    firstSeen: number;
+}
+/** Lifecycle of the dashboard-host judge run that classifies unjudged messages. */
+export type FrustrationJobState = "idle" | "running" | "done" | "cancelled" | "failed";
+/** Progress of the (single, process-wide) frustration judge run. */
+export interface FrustrationJobStatus {
+    state: FrustrationJobState;
+    /** Unique prose texts queued for judgment. */
+    total: number;
+    /** Texts judged successfully. */
+    done: number;
+    /** Texts that exhausted their retries. */
+    failed: number;
+    /** Accumulated USD cost of every judge attempt, retries included. */
+    cost: number;
+    /** Judge label (`provider/model`) of the run, when known. */
+    judge: string | null;
+    /** Why the run failed; null otherwise. */
+    error: string | null;
+    startedAt: number | null;
+    finishedAt: number | null;
+    /** Judge requests the run currently keeps in flight (adapts to the judge's rate limits). */
+    concurrency: number;
+}
+/** Payload of `GET /api/stats/frustration`. */
+export interface FrustrationDashboardStats {
+    overall: FrustrationCounts;
+    /** Every model with messages in range, ordered by class, then revision, then family. */
+    byModel: FrustrationModelStats[];
+    /** Whether this dashboard host can run the judge (standalone `omp-stats` cannot). */
+    judgeAvailable: boolean;
+    job: FrustrationJobStatus;
+}
+/** Payload of `GET /api/frustration/estimate`: the pre-run cost quote shown before judging. */
+export type FrustrationEstimate = {
+    available: true;
+    /** Unique unjudged prose texts in range (identical messages share one verdict). */
+    messages: number;
+    /** Total prose characters sent. */
+    chars: number;
+    /** Estimated billed input tokens. */
+    inputTokens: number;
+    /** Estimated USD cost. */
+    cost: number;
+    /** Judge label (`provider/model`) the run will route to first. */
+    judge: string;
+} | {
+    available: false;
+    reason: string;
+};
 /** Token savings from a single source type. */
 export interface GainSourceTotals {
     savedTokens: number;
@@ -425,13 +451,47 @@ export interface ProviderWindowInsight {
     /** Transitions into an exhausted state observed in range. */
     exhaustedEvents: number;
 }
-/** Complete providers dashboard payload. */
+/** Ingest state of the dashboard host's background session sync. */
+export interface LiveSyncStatus {
+    phase: "idle" | "syncing" | "error";
+    /** Files completed in the running sync (0 when not yet known). */
+    current: number;
+    /** Files in the running sync's work set (0 while listing → indeterminate). */
+    total: number;
+    /** Rows inserted by the running (or last) sync. */
+    processed: number;
+    /** Wall-clock time the last sync finished, if any. */
+    lastSyncedAt: number | null;
+    /** Failure message of the last sync when `phase` is `"error"`. */
+    error: string | null;
+}
+/**
+ * Payload of every `GET /api/events` server-sent event (and `GET /api/status`).
+ * `version` increases whenever stored stats may have changed, so clients
+ * revalidate their queries when it moves.
+ */
+export interface LiveStatus {
+    version: number;
+    sync: LiveSyncStatus;
+    /** Hours whose rollups are still being (re)built; ranges covering them may be incomplete. */
+    indexingHours: number;
+}
+/** Providers dashboard payload: local request stats only (fast, DB-backed). */
 export interface ProviderDashboardStats {
     providers: ProviderAggregate[];
     hourly: ProviderHourlyPoint[];
     series: ProviderTimeSeriesPoint[];
-    usageSeries: UsageWindowSeries[];
+}
+/**
+ * Subscription-window payload (`GET /api/stats/provider-windows`). Snapshots
+ * may come from the auth broker over the network, so it is fetched separately
+ * from {@link ProviderDashboardStats}. `usageSeries` only carries the
+ * requested provider's series (empty without a provider) — all of them can be
+ * thousands of series.
+ */
+export interface ProviderWindowStats {
     windowInsights: ProviderWindowInsight[];
+    usageSeries: UsageWindowSeries[];
 }
 /**
  * One row of the Traces session list: a root session with every child

package/dist/types/types.d.ts

@@ -162,6 +162,10 @@ export interface UserMessageStats {
     repetition: number;
     /** Second-person reproach ("you didnt", "why did you", "stop X-ing") */
     blame: number;
+    /** Judge-facing prose (see `judgeProse`); empty when the message was all markup. */
+    prose: string;
+    /** Hex `Bun.hash` of `prose`, keying the shared verdict cache; empty when `prose` is. */
+    proseHash: string;
 }
 /**
  * Pair emitted by the parser when it sees an assistant message whose

package/dist/types/user-metrics.d.ts

@@ -71,6 +71,14 @@ export interface UserMessageMetrics {
      */
     blame: number;
 }
+/** Cap on the judge-facing prose stored per user message; longer prose is truncated. */
+export declare const PROSE_MAX_CHARS = 4000;
+/**
+ * The prose a user message contributes to frustration judging: the same
+ * structured-content strip the regex signals score on, trimmed and capped at
+ * {@link PROSE_MAX_CHARS}. Empty when the message was nothing but markup.
+ */
+export declare function judgeProse(text: string): string;
 /**
  * Compute behavioral metrics for a user message.
  *

package/package.json

@@ -1,8 +1,8 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/omp-stats",
-	"version": "18.3.5",
-	"description": "Local observability dashboard for pi AI usage statistics",
+	"version": "18.4.0",
+	"description": "Local observability dashboard for omp AI usage statistics",
 	"homepage": "https://omp.sh",
 	"author": {
 		"name": "Stencil Labs, Inc.",
@@ -42,22 +42,17 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "18.3.5",
-		"@oh-my-pi/pi-catalog": "18.3.5",
-		"@oh-my-pi/pi-utils": "18.3.5",
-		"@tailwindcss/node": "^4.3.2",
-		"chart.js": "^4.5.1",
+		"@oh-my-pi/pi-ai": "18.4.0",
+		"@oh-my-pi/pi-catalog": "18.4.0",
+		"@oh-my-pi/pi-utils": "18.4.0",
 		"lucide-react": "^1.24.0",
 		"react": "19.2.7",
-		"react-chartjs-2": "^5.3.1",
-		"react-dom": "19.2.7",
-		"tailwindcss": "^4.3.2"
+		"react-dom": "19.2.7"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14",
 		"@types/react": "^19.2.17",
-		"@types/react-dom": "^19.2.3",
-		"postcss": "^8.5.16"
+		"@types/react-dom": "^19.2.3"
 	},
 	"engines": {
 		"bun": ">=1.3.14"
@@ -65,7 +60,6 @@
 	"files": [
 		"src",
 		"build.ts",
-		"tailwind.config.js",
 		"README.md",
 		"CHANGELOG.md",
 		"LICENSE",