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

package/dist/types/aggregator.d.ts

@@ -0,0 +1,87 @@
+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),
+ * `total` is the size of the work set. `processed` is the running total
+ * of inserted rows.
+ */
+export interface SyncProgress {
+    current: number;
+    total: number;
+    processed: number;
+    sessionFile: string;
+}
+export interface SyncOptions {
+    /** Called after each file completes. Synchronous; keep it cheap. */
+    onProgress?: (event: SyncProgress) => void;
+    /**
+     * Worker pool size. Defaults to a sensible value derived from the host
+     * (capped to avoid drowning a small machine in workers). Set to `1` to
+     * force serial parsing without spawning workers.
+     */
+    workers?: number;
+}
+/**
+ * Smoke test: spawns one sync worker, pings it, asserts the pong response,
+ * then terminates. Used by `omp --smoke-test` so the install-method CI jobs
+ * catch the silent worker-load failure that hit compiled binaries in #1011
+ * and #1027 — neither `--version` nor `stats --summary` exercises the worker
+ * spawn path on a fresh install (no session files = early return), so a
+ * dedicated probe is the only reliable signal.
+ *
+ * No-op on darwin: `syncAllSessions` keeps macOS on the serial parser path
+ * (see {@link defaultWorkerCount}) so the worker spawn surface is unreachable
+ * from the CLI, and probing it under the hardened runtime in
+ * `scripts/ci-macos-sign.sh` would re-enter the Bun-worker abort surface that
+ * motivated the darwin serial default in the first place.
+ *
+ * Rejects on transport error, error response, or timeout.
+ */
+export declare function smokeTestSyncWorker({ timeoutMs }?: {
+    timeoutMs?: number;
+}): Promise<void>;
+/**
+ * Sync all session files to the database.
+ *
+ * `workers: 1` parses inline. Larger pools fan parsing out across workers
+ * (one in-flight job per worker) while DB writes and offset bookkeeping stay on
+ * the calling thread so the single SQLite handle stays uncontended.
+ * `onProgress` fires once per completed file (skipped files included so the
+ * bar walks at a steady rate).
+ */
+export declare function syncAllSessions(opts?: SyncOptions): Promise<{
+    processed: number;
+    files: number;
+}>;
+interface TimeRangeConfig {
+    timeSeriesHours: number;
+    timeSeriesBucketMs: number;
+    modelSeriesDays: number;
+    modelSeriesBucketMs: number;
+    modelPerformanceDays: number;
+    modelPerformanceBucketMs: number;
+    costSeriesDays: number;
+    cutoff: number | null;
+}
+export declare function getTimeRangeConfig(range?: string | null): TimeRangeConfig;
+/**
+ * Get all dashboard stats.
+ */
+export declare function getDashboardStats(range?: string | null): Promise<DashboardStats>;
+export declare function getOverviewStats(range?: string | null): Promise<Pick<DashboardStats, "overall" | "byAgentType" | "timeSeries">>;
+export declare function getModelDashboardStats(range?: string | null): Promise<Pick<DashboardStats, "byModel" | "modelSeries" | "modelPerformanceSeries">>;
+export declare function getCostDashboardStats(range?: string | null): Promise<Pick<DashboardStats, "costSeries">>;
+export declare function getRecentRequests(limit?: number): Promise<MessageStats[]>;
+export declare function getRecentErrors(limit?: number): Promise<MessageStats[]>;
+export declare function getRequestDetails(id: number): Promise<RequestDetails | null>;
+/**
+ * Get the current message count in the database.
+ */
+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/App.d.ts

@@ -0,0 +1 @@
+export default function App(): import("react").JSX.Element;

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

@@ -0,0 +1,21 @@
+import type { BehaviorDashboardStats, CostDashboardStats, FolderStats, GainDashboardStats, MessageStats, ModelDashboardStats, OverviewStats, RequestDetails, TimeRange, ToolDashboardStats } from "./types";
+export declare class ApiError extends Error {
+    status: number;
+    endpoint: string;
+    constructor(status: number, endpoint: string, message: string);
+}
+export declare function getOverviewStats(range?: TimeRange, signal?: AbortSignal): Promise<OverviewStats>;
+export declare function getModelDashboardStats(range?: TimeRange, signal?: AbortSignal): Promise<ModelDashboardStats>;
+export declare function getCostDashboardStats(range?: TimeRange, signal?: AbortSignal): Promise<CostDashboardStats>;
+export declare function getRecentRequests(limit?: number, signal?: AbortSignal): Promise<MessageStats[]>;
+export declare function getRecentErrors(limit?: number, signal?: AbortSignal): Promise<MessageStats[]>;
+export declare function getRequestDetails(id: number, signal?: AbortSignal): Promise<RequestDetails>;
+export declare function sync(signal?: AbortSignal): Promise<{
+    processed: number;
+    files: number;
+    totalMessages: number;
+}>;
+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/AppLayout.d.ts

@@ -0,0 +1,16 @@
+import type React from "react";
+import type { TimeRange } from "../types";
+import type { DashboardSection } from "./routes";
+export interface AppLayoutProps {
+    activeSection: DashboardSection;
+    onSectionChange: (section: DashboardSection) => void;
+    range: TimeRange;
+    onRangeChange: (range: TimeRange) => void;
+    updatedAt: number | null;
+    onSyncStart?: () => void;
+    onSyncComplete?: (result: {
+        success: boolean;
+    }) => void;
+    children: React.ReactNode;
+}
+export declare function AppLayout({ activeSection, onSectionChange, range, onRangeChange, updatedAt, onSyncStart, onSyncComplete, children, }: AppLayoutProps): React.JSX.Element;

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

@@ -0,0 +1,7 @@
+import { type DashboardSection } from "./routes";
+export interface NavRailProps {
+    activeSection: DashboardSection;
+    onSectionChange: (section: DashboardSection) => void;
+    className?: string;
+}
+export declare function NavRail({ activeSection, onSectionChange, className }: NavRailProps): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface RangeControlProps {
+    value: TimeRange;
+    onChange: (value: TimeRange) => void;
+    className?: string;
+}
+export declare function RangeControl({ value, onChange, className }: RangeControlProps): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+export interface SyncButtonProps {
+    onSyncStart?: () => void;
+    onSyncComplete?: (result: {
+        success: boolean;
+        data?: {
+            processed: number;
+            files: number;
+            totalMessages: number;
+        };
+        error?: string;
+    }) => void;
+    className?: string;
+}
+export declare function SyncButton({ onSyncStart, onSyncComplete, className }: SyncButtonProps): import("react").JSX.Element;

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

@@ -0,0 +1 @@
+export declare function ThemeToggle(): import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+import type { TimeRange } from "../types";
+import type { DashboardSection } from "./routes";
+export interface TopBarProps {
+    activeSection: DashboardSection;
+    range: TimeRange;
+    onRangeChange: (range: TimeRange) => void;
+    updatedAt: number | null;
+    onSyncStart?: () => void;
+    onSyncComplete?: (result: {
+        success: boolean;
+    }) => void;
+    onMenuToggle?: () => void;
+    className?: string;
+}
+export declare function TopBar({ activeSection, range, onRangeChange, updatedAt, onSyncStart, onSyncComplete, onMenuToggle, className, }: TopBarProps): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type React from "react";
+export type DashboardSection = "overview" | "requests" | "errors" | "models" | "tools" | "costs" | "behavior" | "projects" | "gain";
+export interface DashboardRoute {
+    id: DashboardSection;
+    label: string;
+    shortLabel?: string;
+    icon: React.ComponentType<{
+        size?: number;
+        className?: string;
+    }>;
+}
+export declare const routes: DashboardRoute[];

package/dist/types/client/components/AgentTokenShare.d.ts

@@ -0,0 +1,5 @@
+import type { AgentTypeStats } from "../types";
+export interface AgentTokenShareProps {
+    stats: AgentTypeStats[];
+}
+export declare function AgentTokenShare({ stats }: AgentTokenShareProps): import("react").JSX.Element;

package/dist/types/client/components/chart-shared.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Shared chart primitives for the dashboard timeline charts: the OMP color
+ * palette, light/dark chart chrome, legend/tooltip + scale plumbing, dataset
+ * styling, and the top-N-by-model / aggregate bucketing used by the cost and
+ * behavior series.
+ */
+export declare const MODEL_COLORS: string[];
+export declare const CHART_THEMES: {
+    readonly dark: {
+        readonly legendLabel: "#a89fb3";
+        readonly tooltipBackground: "#241a2e";
+        readonly tooltipTitle: "#eae5ef";
+        readonly tooltipBody: "#a89fb3";
+        readonly tooltipBorder: "rgba(255, 255, 255, 0.12)";
+        readonly grid: "rgba(255, 255, 255, 0.06)";
+        readonly tick: "#867a93";
+    };
+    readonly light: {
+        readonly legendLabel: "#5a5462";
+        readonly tooltipBackground: "#ffffff";
+        readonly tooltipTitle: "#241a2e";
+        readonly tooltipBody: "#5a5462";
+        readonly tooltipBorder: "rgba(20, 12, 28, 0.15)";
+        readonly grid: "rgba(20, 12, 28, 0.08)";
+        readonly tick: "#6a6275";
+    };
+};
+export type ChartTheme = (typeof CHART_THEMES)[keyof typeof CHART_THEMES];
+export interface ChartSeries {
+    labels: string[];
+    datasets: Array<{
+        label: string;
+        data: number[];
+    }>;
+}
+interface TooltipItem {
+    parsed: {
+        y: number | null;
+    };
+}
+/** Tooltip + legend config common to bar and line variants of the time charts. */
+export declare function buildSharedPlugins(opts: {
+    chartTheme: ChartTheme;
+    showLegend: boolean;
+    defaultLabel: string;
+    formatValue: (n: number) => string;
+    footer?: (items: TooltipItem[]) => string | undefined;
+}): {
+    legend: {
+        display: boolean;
+        position: "top";
+        align: "start";
+        labels: {
+            color: "#5a5462" | "#a89fb3";
+            usePointStyle: boolean;
+            padding: number;
+            font: {
+                size: number;
+            };
+            boxWidth: number;
+        };
+    };
+    tooltip: {
+        backgroundColor: "#241a2e" | "#ffffff";
+        titleColor: "#241a2e" | "#eae5ef";
+        bodyColor: "#5a5462" | "#a89fb3";
+        borderColor: "rgba(20, 12, 28, 0.15)" | "rgba(255, 255, 255, 0.12)";
+        borderWidth: number;
+        padding: number;
+        cornerRadius: number;
+        callbacks: {
+            label: (ctx: {
+                dataset: {
+                    label?: string;
+                };
+                parsed: {
+                    y: number | null;
+                };
+            }) => string;
+            footer?: ((items: TooltipItem[]) => string | undefined) | undefined;
+        };
+    };
+};
+/** Y-axis tick formatter + grid/tick styling shared by both charts. */
+export declare function buildSharedScales(opts: {
+    chartTheme: ChartTheme;
+    formatY: (n: number) => string;
+}): {
+    sharedScaleBase: {
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+            drawBorder: boolean;
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+    };
+    yScale: {
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+            drawBorder: boolean;
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+            callback: (value: number | string) => string;
+        };
+        min: number;
+    };
+};
+/** Stylistic defaults for a single line dataset in a stacked/by-model chart. */
+export declare function lineDatasetStyle(color: string): {
+    borderColor: string;
+    backgroundColor: string;
+    fill: boolean;
+    tension: number;
+    pointRadius: number;
+    pointHoverRadius: number;
+    borderWidth: number;
+};
+/** Stylistic defaults for a single bar dataset in a stacked chart. */
+export declare function barDatasetStyle(color: string): {
+    backgroundColor: string;
+    borderColor: string;
+    borderWidth: number;
+    borderRadius: number;
+    maxBarThickness: number;
+};
+/**
+ * Map a generic ChartSeries' datasets through a per-index style function so
+ * callers can supply line or bar styling without repeating the label/data
+ * spread at every chart site.
+ */
+export declare function styleDatasets(series: ChartSeries, styleFor: (index: number) => Record<string, unknown>): {
+    label: string;
+    data: number[];
+}[];
+/**
+ * Bucket points by day into a single aggregate series. Caller supplies the
+ * per-bucket accumulator + final value extractor; mirrors the shape of
+ * `buildTopNByModelSeries` for the non-by-model variant of each time chart.
+ */
+export declare function buildAggregateTimeSeries<T extends {
+    timestamp: number;
+}, B>(points: T[], label: string, opts: {
+    initBucket: () => B;
+    accumulate: (bucket: B, point: T) => void;
+    bucketToValue: (bucket: B) => number;
+}): ChartSeries;
+interface ModelKeyedPoint {
+    timestamp: number;
+    model: string;
+    provider: string;
+}
+/**
+ * Bucket points by day and by top-N model (with an "Other" rollup), producing
+ * a ChartSeries. Caller controls how points contribute to ranking and to each
+ * day-bucket value via the `rankWeight`/`accumulate`/`bucketToValue` callbacks
+ * — keeps the behavior chart's rate math separate from the cost chart's sum.
+ */
+export declare function buildTopNByModelSeries<T extends ModelKeyedPoint, B>(points: T[], opts: {
+    topN?: number;
+    rankWeight: (point: T) => number;
+    initBucket: () => B;
+    accumulate: (bucket: B, point: T) => void;
+    bucketToValue: (bucket: B) => number;
+}): ChartSeries;
+export {};

package/dist/types/client/components/models-table-shared.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Shared primitives for the per-model breakdown tables. Each table owns its
+ * column definitions, sort order, and chart type — this module owns the
+ * surface chrome, expand-row plumbing, theme palette, the mini-sparkline, and
+ * the shared plugin/scale config consumed by multi-line detail charts.
+ */
+import type { ChartTheme } from "./chart-shared";
+export { CHART_THEMES as TABLE_CHART_THEMES, MODEL_COLORS } from "./chart-shared";
+export type TableChartTheme = ChartTheme;
+/** Style defaults for one line in a non-stacked detail chart. */
+export declare function lineSeriesStyle(color: string): {
+    borderColor: string;
+    backgroundColor: string;
+    tension: number;
+    pointRadius: number;
+    borderWidth: number;
+};
+/**
+ * No-axis, no-legend single-series sparkline used in the trend cell of every
+ * model row. Caller supplies the already-extracted numeric series so this
+ * stays agnostic of the row's underlying data shape.
+ */
+export declare function MiniSparkline({ timestamps, values, color, }: {
+    timestamps: number[];
+    values: number[];
+    color: string;
+}): import("react").JSX.Element;
+/**
+ * Plugin block (legend + tooltip) shared by every multi-series detail chart
+ * in the table expanded views.
+ */
+export declare function detailChartPlugins(chartTheme: TableChartTheme): {
+    legend: {
+        display: boolean;
+        position: "top";
+        labels: {
+            color: "#5a5462" | "#a89fb3";
+            usePointStyle: boolean;
+            padding: number;
+            font: {
+                size: number;
+            };
+        };
+    };
+    tooltip: {
+        backgroundColor: "#241a2e" | "#ffffff";
+        titleColor: "#241a2e" | "#eae5ef";
+        bodyColor: "#5a5462" | "#a89fb3";
+        borderColor: "rgba(20, 12, 28, 0.15)" | "rgba(255, 255, 255, 0.12)";
+        borderWidth: number;
+        cornerRadius: number;
+    };
+};
+/**
+ * Single-Y-axis scales for a detail chart (used when every series shares a
+ * unit, e.g. behavior counts). Min anchored at 0.
+ */
+export declare function detailChartScalesSingleAxis(chartTheme: TableChartTheme): {
+    x: {
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+    };
+    y: {
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+        min: number;
+    };
+};
+/**
+ * Dual-Y-axis scales for a detail chart with mixed units (e.g. TTFT seconds
+ * on left, tokens/s on right). Right-axis grid is suppressed so it doesn't
+ * collide with the left.
+ */
+export declare function detailChartScalesDualAxis(chartTheme: TableChartTheme): {
+    x: {
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+    };
+    y: {
+        type: "linear";
+        display: boolean;
+        position: "left";
+        grid: {
+            color: "rgba(20, 12, 28, 0.08)" | "rgba(255, 255, 255, 0.06)";
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+    };
+    y1: {
+        type: "linear";
+        display: boolean;
+        position: "right";
+        grid: {
+            drawOnChartArea: boolean;
+        };
+        ticks: {
+            color: "#6a6275" | "#867a93";
+            font: {
+                size: number;
+            };
+        };
+    };
+};
+export interface TableColumn {
+    label: string;
+    align?: "left" | "right" | "center";
+}
+/** Outer card + section title used by every model table. */
+export declare function ModelTableShell({ title, subtitle, children, }: {
+    title: string;
+    subtitle?: string;
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/** Sticky column-header row for a model table. */
+export declare function ModelTableHeader({ columns, gridTemplate }: {
+    columns: TableColumn[];
+    gridTemplate: string;
+}): import("react").JSX.Element;
+/** Scroll wrapper for the row stack — capped to fit the dashboard viewport. */
+export declare function ModelTableBody({ children }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Two-line model identity cell (model name + provider) shared by every
+ * per-model table. Kept as a stable named contract so callers don't restate
+ * the same two divs and font-utility classes.
+ */
+export declare function ModelNameCell({ model, provider }: {
+    model: string;
+    provider: string;
+}): import("react").JSX.Element;
+/**
+ * One expandable model row. `cells` matches the column order from
+ * `ModelTableHeader` plus the trend cell at the end (caller controls the
+ * sparkline / placeholder). `expandedContent` is the panel revealed on toggle.
+ */
+export declare function ExpandableModelRow({ gridTemplate, cells, trendCell, isExpanded, onToggle, expandedContent, }: {
+    gridTemplate: string;
+    cells: React.ReactNode[];
+    trendCell: React.ReactNode;
+    isExpanded: boolean;
+    onToggle: () => void;
+    expandedContent: React.ReactNode;
+}): import("react").JSX.Element;
+/** Placeholder shown in the trend cell when a model has no time-series data. */
+export declare function TrendEmpty(): import("react").JSX.Element;
+/** Placeholder shown in the expanded detail-chart slot when data is missing. */
+export declare function DetailChartEmpty({ message }: {
+    message?: string;
+}): import("react").JSX.Element;

package/dist/types/client/components/range-meta.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Display metadata for a `TimeRange` — keeps chart labels, sparkline bucket
+ * counts, and x-axis date formatting in sync with the server-side bucketing
+ * defined in `aggregator.ts`.
+ */
+import type { TimeRange } from "../types";
+export interface RangeMeta {
+    /** Human label used in chart subtitles ("the last 24 hours"). */
+    windowLabel: string;
+    /** Short prefix used in compact column headers ("24h Trend"). */
+    trendLabel: string;
+    /** Bucket size matching the server query for this range. */
+    bucketMs: number;
+    /** Number of buckets the server is expected to return for this range. */
+    bucketCount: number;
+    /** date-fns format string for x-axis labels and tooltip headings. */
+    tickFormat: string;
+}
+export declare function rangeMeta(range: TimeRange): RangeMeta;
+/** Format a bucket timestamp using the active range's tick format. */
+export declare function formatRangeTick(timestamp: number, range: TimeRange): string;

package/dist/types/client/data/charts.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/client/data/formatters.d.ts

@@ -0,0 +1,8 @@
+export declare function formatInteger(value: number): string;
+export declare function formatCompact(value: number): string;
+export declare function formatCost(value: number, digits?: number): string;
+export declare function formatPercent(value: number, digits?: number): string;
+export declare function formatDurationMs(value: number | null, digits?: number): string;
+export declare function formatTokensPerSecond(value: number | null): string;
+export declare function formatRelativeTime(timestamp: number): string;
+export declare function formatBytes(value: number): string;

package/dist/types/client/data/useHashRoute.d.ts

@@ -0,0 +1,8 @@
+import type { DashboardSection } from "../app/routes";
+import type { TimeRange } from "../types";
+export declare function useHashRoute(): {
+    section: DashboardSection;
+    setSection: (newSection: DashboardSection) => void;
+    range: TimeRange;
+    setRange: (newRange: string) => void;
+};

package/dist/types/client/data/useResource.d.ts

@@ -0,0 +1,13 @@
+export interface ResourceResult<T> {
+    data: T | null;
+    error: Error | null;
+    loading: boolean;
+    refreshing: boolean;
+    refetch: () => Promise<void>;
+    updatedAt: number | null;
+}
+export interface ResourceOptions {
+    pollMs?: number;
+    enabled?: boolean;
+}
+export declare function useResource<T>(key: readonly unknown[], fetcher: (signal: AbortSignal) => Promise<T>, options?: ResourceOptions): ResourceResult<T>;

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

@@ -0,0 +1,67 @@
+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. */
+    tokens: number;
+    requests: number;
+    cost: number;
+    /** Fraction (0-1) of total tokens across all present agent types. */
+    share: number;
+}
+export interface AgentTokenShareView {
+    totalTokens: number;
+    totalCost: number;
+    segments: AgentTokenSegment[];
+}
+/**
+ * Build the "token usage by agent" breakdown: one segment per agent type that
+ * appears in the data, ordered main -> subagents -> advisor, each carrying its
+ * token total and share of the grand total. Token counts sum the same four
+ * columns the overview renders (input + output + cache read + cache write) so a
+ * segment's share never disagrees with the count beside it.
+ */
+export declare function buildAgentTokenShare(stats: AgentTypeStats[]): AgentTokenShareView;
+export interface CostSummaryView {
+    totalCost: number;
+    avgDailyCost: number;
+    topModelName: string;
+    topModelCost: number;
+}
+export interface ModelPerformanceDataPoint {
+    timestamp: number;
+    avgTtftSeconds: number | null;
+    avgTokensPerSecond: number | null;
+    requests: number;
+}
+export interface ModelPerformanceSeries {
+    label: string;
+    data: ModelPerformanceDataPoint[];
+}
+export interface BehaviorSummaryView {
+    totalMessages: number;
+    totalYelling: number;
+    totalProfanity: number;
+    totalAnguish: number;
+    totalFrustration: number;
+    highestFrictionModel: {
+        model: string;
+        provider: string;
+        score: number;
+    } | null;
+}
+export interface FolderRowView extends FolderStats {
+    costPercentage: number;
+    requestsPercentage: number;
+}
+export declare function buildCostSummary(costSeries: CostTimeSeriesPoint[]): CostSummaryView;
+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[];