@oh-my-pi/omp-stats 14.9.2 → 14.9.5

package/src/client/components/Header.tsx

@@ -1,17 +1,28 @@
 import { Activity, RefreshCw } from "lucide-react";
+import type { TimeRange } from "../types";
 
-type Tab = "overview" | "requests" | "errors" | "models" | "costs";
+type Tab = "overview" | "requests" | "errors" | "models" | "costs" | "behavior";
+
+const tabs: Tab[] = ["overview", "requests", "errors", "models", "costs", "behavior"];
+const timeRanges: { label: string; value: TimeRange }[] = [
+	{ label: "1h", value: "1h" },
+	{ label: "24h", value: "24h" },
+	{ label: "7d", value: "7d" },
+	{ label: "30d", value: "30d" },
+	{ label: "90d", value: "90d" },
+	{ label: "All", value: "all" },
+];
 
 interface HeaderProps {
 	activeTab: Tab;
 	onTabChange: (tab: Tab) => void;
 	onSync: () => void;
 	syncing: boolean;
+	timeRange: TimeRange;
+	onTimeRangeChange: (timeRange: TimeRange) => void;
 }
 
-const tabs: Tab[] = ["overview", "requests", "errors", "models", "costs"];
-
-export function Header({ activeTab, onTabChange, onSync, syncing }: HeaderProps) {
+export function Header({ activeTab, onTabChange, onSync, syncing, timeRange, onTimeRangeChange }: HeaderProps) {
 	return (
 		<header className="flex flex-col sm:flex-row sm:items-center justify-between gap-4 pb-6 mb-8 border-b border-[var(--border-subtle)]">
 			<div className="flex items-center gap-3">
@@ -37,6 +48,19 @@ export function Header({ activeTab, onTabChange, onSync, syncing }: HeaderProps)
 						</button>
 					))}
 				</div>
+				<div className="flex bg-[var(--bg-surface)] rounded-[var(--radius-md)] p-1 border border-[var(--border-subtle)]">
+					{timeRanges.map(range => (
+						<button
+							key={range.value}
+							type="button"
+							onClick={() => onTimeRangeChange(range.value)}
+							className={`tab-btn ${timeRange === range.value ? "active" : ""}`}
+							title={range.value === "all" ? "All time" : `Last ${range.label}`}
+						>
+							{range.label}
+						</button>
+					))}
+				</div>
 
 				<button type="button" onClick={onSync} disabled={syncing} className="btn btn-primary">
 					<RefreshCw size={16} className={syncing ? "spin" : ""} />

package/src/client/components/StatsGrid.tsx

@@ -5,6 +5,15 @@ interface StatsGridProps {
 	stats: AggregatedStats;
 }
 
+const compactNumberFormatter = new Intl.NumberFormat(undefined, {
+	notation: "compact",
+	maximumFractionDigits: 1,
+});
+
+function formatCompactNumber(value: number): string {
+	return compactNumberFormatter.format(value);
+}
+
 const statConfig = [
 	{
 		key: "requests",
@@ -39,7 +48,7 @@ const statConfig = [
 		icon: Database,
 		color: "var(--accent-cyan)",
 		getValue: (s: AggregatedStats) => `${(s.cacheRate * 100).toFixed(1)}%`,
-		getDetail: (s: AggregatedStats) => `${(s.totalCacheReadTokens / 1000).toFixed(1)}k cached tokens`,
+		getDetail: (s: AggregatedStats) => `${formatCompactNumber(s.totalCacheReadTokens)} cached tokens`,
 	},
 	{
 		key: "errors",

package/src/client/types.ts

@@ -59,6 +59,7 @@ export interface AggregatedStats {
 	lastTimestamp: number;
 }
 
+export type TimeRange = "1h" | "24h" | "7d" | "30d" | "90d" | "all";
 export interface ModelStats extends AggregatedStats {
 	model: string;
 	provider: string;
@@ -113,3 +114,56 @@ export interface DashboardStats {
 	modelPerformanceSeries: ModelPerformancePoint[];
 	costSeries: CostTimeSeriesPoint[];
 }
+
+export interface OverviewStats {
+	overall: AggregatedStats;
+	timeSeries: TimeSeriesPoint[];
+}
+
+export interface ModelDashboardStats {
+	byModel: ModelStats[];
+	modelSeries: ModelTimeSeriesPoint[];
+	modelPerformanceSeries: ModelPerformancePoint[];
+}
+
+export interface CostDashboardStats {
+	costSeries: CostTimeSeriesPoint[];
+}
+
+export interface BehaviorTimeSeriesPoint {
+	timestamp: number;
+	model: string;
+	provider: string;
+	messages: number;
+	yellingSentences: number;
+	profanity: number;
+	dramaRuns: number;
+	chars: number;
+}
+
+export interface BehaviorOverallStats {
+	totalMessages: number;
+	totalYellingSentences: number;
+	totalProfanity: number;
+	totalDramaRuns: number;
+	totalChars: number;
+	firstTimestamp: number;
+	lastTimestamp: number;
+}
+
+export interface BehaviorModelStats {
+	model: string;
+	provider: string;
+	totalMessages: number;
+	totalYellingSentences: number;
+	totalProfanity: number;
+	totalDramaRuns: number;
+	totalChars: number;
+	lastTimestamp: number;
+}
+
+export interface BehaviorDashboardStats {
+	overall: BehaviorOverallStats;
+	byModel: BehaviorModelStats[];
+	behaviorSeries: BehaviorTimeSeriesPoint[];
+}

package/src/db.ts

@@ -4,6 +4,9 @@ import { type GeneratedProvider, getBundledModel, type Usage } from "@oh-my-pi/p
 import { getConfigRootDir, getStatsDbPath } from "@oh-my-pi/pi-utils";
 import type {
 	AggregatedStats,
+	BehaviorModelStats,
+	BehaviorOverallStats,
+	BehaviorTimeSeriesPoint,
 	CostTimeSeriesPoint,
 	FolderStats,
 	MessageStats,
@@ -11,6 +14,7 @@ import type {
 	ModelStats,
 	ModelTimeSeriesPoint,
 	TimeSeriesPoint,
+	UserMessageStats,
 } from "./types";
 
 type ModelCost = { input: number; output: number; cacheRead: number; cacheWrite: number };
@@ -74,12 +78,39 @@ export async function initDb(): Promise<Database> {
 		CREATE INDEX IF NOT EXISTS idx_messages_model ON messages(model);
 		CREATE INDEX IF NOT EXISTS idx_messages_folder ON messages(folder);
 		CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_file);
+		CREATE INDEX IF NOT EXISTS idx_messages_timestamp_model_provider ON messages(timestamp, model, provider);
+		CREATE INDEX IF NOT EXISTS idx_messages_timestamp_folder ON messages(timestamp, folder);
+		CREATE INDEX IF NOT EXISTS idx_messages_stop_reason_timestamp ON messages(stop_reason, timestamp);
 
 		CREATE TABLE IF NOT EXISTS file_offsets (
 			session_file TEXT PRIMARY KEY,
 			offset INTEGER NOT NULL,
 			last_modified INTEGER NOT NULL
 		);
+
+		CREATE TABLE IF NOT EXISTS user_messages (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			session_file TEXT NOT NULL,
+			entry_id TEXT NOT NULL,
+			folder TEXT NOT NULL,
+			timestamp INTEGER NOT NULL,
+			model TEXT,
+			provider TEXT,
+			chars INTEGER NOT NULL,
+			words INTEGER NOT NULL,
+			yelling_sentences INTEGER NOT NULL,
+			profanity INTEGER NOT NULL,
+			drama_runs INTEGER NOT NULL,
+			UNIQUE(session_file, entry_id)
+		);
+
+		CREATE INDEX IF NOT EXISTS idx_user_messages_timestamp ON user_messages(timestamp);
+		CREATE INDEX IF NOT EXISTS idx_user_messages_timestamp_model ON user_messages(timestamp, model, provider);
+
+		CREATE TABLE IF NOT EXISTS meta (
+			key TEXT PRIMARY KEY,
+			value TEXT NOT NULL
+		);
 	`);
 
 	const messageColumns = db.prepare("PRAGMA table_info(messages)").all() as { name: string }[];
@@ -87,6 +118,38 @@ export async function initDb(): Promise<Database> {
 		db.exec("ALTER TABLE messages ADD COLUMN premium_requests REAL NOT NULL DEFAULT 0");
 	}
 	db.exec("UPDATE messages SET premium_requests = 0 WHERE premium_requests IS NULL");
+	// Bumping the metric definition (yelling sentences vs caps words) invalidates
+	// previously-ingested rows. If the legacy column is present we drop the table
+	// outright; the `IF NOT EXISTS` create above already gave us the new schema
+	// in parallel, but we want a clean wipe + re-ingest. The accompanying
+	// `backfillUserMessages` bump (v2) clears `file_offsets` so the next sync
+	// re-parses every session.
+	const userMessageColumns = db.prepare("PRAGMA table_info(user_messages)").all() as {
+		name: string;
+	}[];
+	if (userMessageColumns.some(column => column.name === "caps_words")) {
+		db.exec("DROP TABLE user_messages");
+		db.exec(`
+			CREATE TABLE user_messages (
+				id INTEGER PRIMARY KEY AUTOINCREMENT,
+				session_file TEXT NOT NULL,
+				entry_id TEXT NOT NULL,
+				folder TEXT NOT NULL,
+				timestamp INTEGER NOT NULL,
+				model TEXT,
+				provider TEXT,
+				chars INTEGER NOT NULL,
+				words INTEGER NOT NULL,
+				yelling_sentences INTEGER NOT NULL,
+				profanity INTEGER NOT NULL,
+				drama_runs INTEGER NOT NULL,
+				UNIQUE(session_file, entry_id)
+			);
+			CREATE INDEX IF NOT EXISTS idx_user_messages_timestamp ON user_messages(timestamp);
+			CREATE INDEX IF NOT EXISTS idx_user_messages_timestamp_model ON user_messages(timestamp, model, provider);
+		`);
+	}
+	backfillUserMessages(db);
 	backfillMissingCatalogCosts(db);
 	return db;
 }
@@ -312,9 +375,10 @@ function buildAggregatedStats(rows: any[]): AggregatedStats {
 /**
  * Get overall aggregated stats.
  */
-export function getOverallStats(): AggregatedStats {
+export function getOverallStats(cutoff?: number): AggregatedStats {
 	if (!db) return buildAggregatedStats([]);
 
+	const hasCutoff = cutoff !== undefined && cutoff > 0;
 	const stmt = db.prepare(`
 		SELECT
 			COUNT(*) as total_requests,
@@ -331,18 +395,19 @@ export function getOverallStats(): AggregatedStats {
 			MIN(timestamp) as first_timestamp,
 			MAX(timestamp) as last_timestamp
 		FROM messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 	`);
 
-	const rows = stmt.all();
-	return buildAggregatedStats(rows);
+	const rows = hasCutoff ? stmt.all(cutoff) : stmt.all();
+	return buildAggregatedStats(rows as any[]);
 }
-
 /**
  * Get stats grouped by model.
  */
-export function getStatsByModel(): ModelStats[] {
+export function getStatsByModel(cutoff?: number): ModelStats[] {
 	if (!db) return [];
 
+	const hasCutoff = cutoff !== undefined && cutoff > 0;
 	const stmt = db.prepare(`
 		SELECT
 			model,
@@ -361,11 +426,12 @@ export function getStatsByModel(): ModelStats[] {
 			MIN(timestamp) as first_timestamp,
 			MAX(timestamp) as last_timestamp
 		FROM messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY model, provider
 		ORDER BY total_requests DESC
 	`);
 
-	const rows = stmt.all() as any[];
+	const rows = (hasCutoff ? stmt.all(cutoff) : stmt.all()) as any[];
 	return rows.map(row => ({
 		model: row.model,
 		provider: row.provider,
@@ -376,9 +442,10 @@ export function getStatsByModel(): ModelStats[] {
 /**
  * Get stats grouped by folder.
  */
-export function getStatsByFolder(): FolderStats[] {
+export function getStatsByFolder(cutoff?: number): FolderStats[] {
 	if (!db) return [];
 
+	const hasCutoff = cutoff !== undefined && cutoff > 0;
 	const stmt = db.prepare(`
 		SELECT
 			folder,
@@ -396,11 +463,12 @@ export function getStatsByFolder(): FolderStats[] {
 			MIN(timestamp) as first_timestamp,
 			MAX(timestamp) as last_timestamp
 		FROM messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY folder
 		ORDER BY total_requests DESC
 	`);
 
-	const rows = stmt.all() as any[];
+	const rows = (hasCutoff ? stmt.all(cutoff) : stmt.all()) as any[];
 	return rows.map(row => ({
 		folder: row.folder,
 		...buildAggregatedStats([row]),
@@ -408,27 +476,30 @@ export function getStatsByFolder(): FolderStats[] {
 }
 
 /**
- * Get hourly time series data.
+ * Get time series data.
  */
-export function getTimeSeries(hours = 24): TimeSeriesPoint[] {
+export function getTimeSeries(hours = 24, cutoff?: number | null, bucketMs = 60 * 60 * 1000): TimeSeriesPoint[] {
 	if (!db) return [];
 
-	const cutoff = Date.now() - hours * 60 * 60 * 1000;
+	const hasCutoff = cutoff !== null;
+	const seriesCutoff = hasCutoff ? (cutoff ?? Date.now() - hours * 60 * 60 * 1000) : 0;
 
 	const stmt = db.prepare(`
 		SELECT
-			(timestamp / 3600000) * 3600000 as bucket,
+			(timestamp / ?) * ? as bucket,
 			COUNT(*) as requests,
 			SUM(CASE WHEN stop_reason = 'error' THEN 1 ELSE 0 END) as errors,
 			SUM(total_tokens) as tokens,
 			SUM(cost_total) as cost
 		FROM messages
-		WHERE timestamp >= ?
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY bucket
 		ORDER BY bucket ASC
 	`);
 
-	const rows = stmt.all(cutoff) as any[];
+	const rows = hasCutoff
+		? (stmt.all(bucketMs, bucketMs, seriesCutoff) as any[])
+		: (stmt.all(bucketMs, bucketMs) as any[]);
 	return rows.map(row => ({
 		timestamp: row.bucket,
 		requests: row.requests,
@@ -444,10 +515,11 @@ export function getTimeSeries(hours = 24): TimeSeriesPoint[] {
 /**
  * Get daily model usage time series data for the last N days.
  */
-export function getModelTimeSeries(days = 14): ModelTimeSeriesPoint[] {
+export function getModelTimeSeries(days = 14, cutoff?: number | null): ModelTimeSeriesPoint[] {
 	if (!db) return [];
 
-	const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+	const hasCutoff = cutoff !== null;
+	const seriesCutoff = hasCutoff ? (cutoff ?? Date.now() - days * 24 * 60 * 60 * 1000) : 0;
 
 	const stmt = db.prepare(`
 		SELECT
@@ -456,12 +528,12 @@ export function getModelTimeSeries(days = 14): ModelTimeSeriesPoint[] {
 			provider,
 			COUNT(*) as requests
 		FROM messages
-		WHERE timestamp >= ?
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY bucket, model, provider
 		ORDER BY bucket ASC
 	`);
 
-	const rows = stmt.all(cutoff) as any[];
+	const rows = hasCutoff ? (stmt.all(seriesCutoff) as any[]) : (stmt.all() as any[]);
 	return rows.map(row => ({
 		timestamp: row.bucket,
 		model: row.model,
@@ -473,10 +545,11 @@ export function getModelTimeSeries(days = 14): ModelTimeSeriesPoint[] {
 /**
  * Get daily model performance time series data for the last N days.
  */
-export function getModelPerformanceSeries(days = 14): ModelPerformancePoint[] {
+export function getModelPerformanceSeries(days = 14, cutoff?: number | null): ModelPerformancePoint[] {
 	if (!db) return [];
 
-	const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+	const hasCutoff = cutoff !== null;
+	const seriesCutoff = hasCutoff ? (cutoff ?? Date.now() - days * 24 * 60 * 60 * 1000) : 0;
 
 	const stmt = db.prepare(`
 		SELECT
@@ -487,12 +560,12 @@ export function getModelPerformanceSeries(days = 14): ModelPerformancePoint[] {
 			AVG(ttft) as avg_ttft,
 			AVG(CASE WHEN duration > 0 THEN output_tokens * 1000.0 / duration ELSE NULL END) as avg_tokens_per_second
 		FROM messages
-		WHERE timestamp >= ?
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY bucket, model, provider
 		ORDER BY bucket ASC
 	`);
 
-	const rows = stmt.all(cutoff) as any[];
+	const rows = hasCutoff ? (stmt.all(seriesCutoff) as any[]) : (stmt.all() as any[]);
 	return rows.map(row => ({
 		timestamp: row.bucket,
 		model: row.model,
@@ -586,10 +659,11 @@ export function getMessageById(id: number): MessageStats | null {
 /**
  * Get daily cost time series data for the last N days, broken down by model.
  */
-export function getCostTimeSeries(days = 90): CostTimeSeriesPoint[] {
+export function getCostTimeSeries(days = 90, cutoff?: number | null): CostTimeSeriesPoint[] {
 	if (!db) return [];
 
-	const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+	const hasCutoff = cutoff !== null;
+	const seriesCutoff = hasCutoff ? (cutoff ?? Date.now() - days * 24 * 60 * 60 * 1000) : 0;
 
 	const stmt = db.prepare(`
 		SELECT
@@ -603,12 +677,12 @@ export function getCostTimeSeries(days = 90): CostTimeSeriesPoint[] {
 			SUM(cost_cache_write) as cost_cache_write,
 			COUNT(*) as requests
 		FROM messages
-		WHERE timestamp >= ?
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
 		GROUP BY bucket, model, provider
 		ORDER BY bucket ASC
 	`);
 
-	const rows = stmt.all(cutoff) as any[];
+	const rows = hasCutoff ? (stmt.all(seriesCutoff) as any[]) : (stmt.all() as any[]);
 	return rows.map(row => ({
 		timestamp: row.bucket,
 		model: row.model,
@@ -621,3 +695,210 @@ export function getCostTimeSeries(days = 90): CostTimeSeriesPoint[] {
 		requests: row.requests,
 	}));
 }
+
+/**
+ * Reset `file_offsets` (and any existing `user_messages` rows) so the next
+ * sync re-parses every session and re-derives behavioral metrics. Run once
+ * per metric-definition bump; the meta sentinel records the version.
+ *
+ * - v1: initial introduction of `user_messages`.
+ * - v2: yelling-sentence metric replaces caps-word counts; existing rows are
+ *   computed under the old definition and must be discarded.
+ *
+ * Existing `messages` rows are unaffected — `INSERT OR IGNORE` keeps them.
+ */
+function backfillUserMessages(database: Database): void {
+	const row = database.prepare("SELECT value FROM meta WHERE key = 'user_messages_v2'").get() as
+		| { value: string }
+		| undefined;
+	if (row) return;
+
+	database.exec("DELETE FROM user_messages");
+	database.exec("DELETE FROM file_offsets");
+	database
+		.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)")
+		.run("user_messages_v2", String(Date.now()));
+}
+
+/**
+ * Insert user-message stats. Idempotent via UNIQUE(session_file, entry_id).
+ */
+export function insertUserMessageStats(stats: UserMessageStats[]): number {
+	if (!db || stats.length === 0) return 0;
+
+	const stmt = db.prepare(`
+		INSERT OR IGNORE INTO user_messages (
+			session_file, entry_id, folder, timestamp, model, provider,
+			chars, words, yelling_sentences, profanity, drama_runs
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	let inserted = 0;
+	const insert = db.transaction(() => {
+		for (const s of stats) {
+			const result = stmt.run(
+				s.sessionFile,
+				s.entryId,
+				s.folder,
+				s.timestamp,
+				s.model,
+				s.provider,
+				s.chars,
+				s.words,
+				s.yellingSentences,
+				s.profanity,
+				s.dramaRuns,
+			);
+			if (result.changes > 0) inserted++;
+		}
+	});
+	insert();
+	return inserted;
+}
+
+const UNKNOWN_MODEL = "unknown";
+
+interface BehaviorSeriesRow {
+	bucket: number;
+	model: string;
+	provider: string;
+	messages: number;
+	yelling_sentences: number | null;
+	profanity: number | null;
+	drama_runs: number | null;
+	chars: number | null;
+}
+
+/**
+ * Daily behavioral time series, grouped by responding model+provider.
+ */
+export function getBehaviorTimeSeries(cutoff?: number | null): BehaviorTimeSeriesPoint[] {
+	if (!db) return [];
+	const hasCutoff = cutoff !== null && cutoff !== undefined && cutoff > 0;
+	const stmt = db.prepare(`
+		SELECT
+			(timestamp / 86400000) * 86400000 as bucket,
+			COALESCE(model, ?) as model,
+			COALESCE(provider, ?) as provider,
+			COUNT(*) as messages,
+			SUM(yelling_sentences) as yelling_sentences,
+			SUM(profanity) as profanity,
+			SUM(drama_runs) as drama_runs,
+			SUM(chars) as chars
+		FROM user_messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
+		GROUP BY bucket, model, provider
+		ORDER BY bucket ASC
+	`);
+	const rows = (
+		hasCutoff ? stmt.all(UNKNOWN_MODEL, UNKNOWN_MODEL, cutoff) : stmt.all(UNKNOWN_MODEL, UNKNOWN_MODEL)
+	) as BehaviorSeriesRow[];
+	return rows.map(row => ({
+		timestamp: row.bucket,
+		model: row.model,
+		provider: row.provider,
+		messages: row.messages,
+		yellingSentences: row.yelling_sentences ?? 0,
+		profanity: row.profanity ?? 0,
+		dramaRuns: row.drama_runs ?? 0,
+		chars: row.chars ?? 0,
+	}));
+}
+
+interface BehaviorOverallRow {
+	total_messages: number;
+	total_yelling_sentences: number | null;
+	total_profanity: number | null;
+	total_drama_runs: number | null;
+	total_chars: number | null;
+	first_timestamp: number | null;
+	last_timestamp: number | null;
+}
+
+/**
+ * Overall behavioral totals across the cutoff window.
+ */
+export function getBehaviorOverall(cutoff?: number | null): BehaviorOverallStats {
+	const empty: BehaviorOverallStats = {
+		totalMessages: 0,
+		totalYellingSentences: 0,
+		totalProfanity: 0,
+		totalDramaRuns: 0,
+		totalChars: 0,
+		firstTimestamp: 0,
+		lastTimestamp: 0,
+	};
+	if (!db) return empty;
+	const hasCutoff = cutoff !== null && cutoff !== undefined && cutoff > 0;
+	const stmt = db.prepare(`
+		SELECT
+			COUNT(*) as total_messages,
+			SUM(yelling_sentences) as total_yelling_sentences,
+			SUM(profanity) as total_profanity,
+			SUM(drama_runs) as total_drama_runs,
+			SUM(chars) as total_chars,
+			MIN(timestamp) as first_timestamp,
+			MAX(timestamp) as last_timestamp
+		FROM user_messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
+	`);
+	const row = (hasCutoff ? stmt.get(cutoff) : stmt.get()) as BehaviorOverallRow | undefined;
+	if (!row?.total_messages) return empty;
+	return {
+		totalMessages: row.total_messages,
+		totalYellingSentences: row.total_yelling_sentences ?? 0,
+		totalProfanity: row.total_profanity ?? 0,
+		totalDramaRuns: row.total_drama_runs ?? 0,
+		totalChars: row.total_chars ?? 0,
+		firstTimestamp: row.first_timestamp ?? 0,
+		lastTimestamp: row.last_timestamp ?? 0,
+	};
+}
+
+interface BehaviorByModelRow {
+	model: string;
+	provider: string;
+	total_messages: number;
+	total_yelling_sentences: number | null;
+	total_profanity: number | null;
+	total_drama_runs: number | null;
+	total_chars: number | null;
+	last_timestamp: number | null;
+}
+
+/**
+ * Per-model behavioral totals over the cutoff window. "Unknown" represents
+ * user messages that never received an assistant reply.
+ */
+export function getBehaviorByModel(cutoff?: number | null): BehaviorModelStats[] {
+	if (!db) return [];
+	const hasCutoff = cutoff !== null && cutoff !== undefined && cutoff > 0;
+	const stmt = db.prepare(`
+		SELECT
+			COALESCE(model, ?) as model,
+			COALESCE(provider, ?) as provider,
+			COUNT(*) as total_messages,
+			SUM(yelling_sentences) as total_yelling_sentences,
+			SUM(profanity) as total_profanity,
+			SUM(drama_runs) as total_drama_runs,
+			SUM(chars) as total_chars,
+			MAX(timestamp) as last_timestamp
+		FROM user_messages
+		${hasCutoff ? "WHERE timestamp >= ?" : ""}
+		GROUP BY model, provider
+		ORDER BY total_messages DESC
+	`);
+	const rows = (
+		hasCutoff ? stmt.all(UNKNOWN_MODEL, UNKNOWN_MODEL, cutoff) : stmt.all(UNKNOWN_MODEL, UNKNOWN_MODEL)
+	) as BehaviorByModelRow[];
+	return rows.map(row => ({
+		model: row.model,
+		provider: row.provider,
+		totalMessages: row.total_messages,
+		totalYellingSentences: row.total_yelling_sentences ?? 0,
+		totalProfanity: row.total_profanity ?? 0,
+		totalDramaRuns: row.total_drama_runs ?? 0,
+		totalChars: row.total_chars ?? 0,
+		lastTimestamp: row.last_timestamp ?? 0,
+	}));
+}