@linxiraos/pi-stats 1.1.8 → 1.1.9

package/dist/types/db.d.ts

@@ -1,183 +0,0 @@
-import { Database } from "bun:sqlite";
-import type { AgentTypeStats, AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, DailyActivityPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, ProviderAggregate, ProviderHourlyPoint, ProviderTimeSeriesPoint, TimeSeriesPoint, ToolCallStats, ToolModelStats, ToolResultLink, ToolTimeSeriesPoint, ToolUsageStats, UserMessageLink, UserMessageStats } from "./types.js";
-/**
- * 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.
- *
- * Forked / branched sessions (see `SessionManager.fork()` and
- * `createBranchedSession()` in `@linxiraos/zeta`) deep-copy a parent
- * session's entries into a new JSONL — same `entry_id`, `timestamp`, `model`,
- * `provider`, token counts, and `responseId`. The `UNIQUE(session_file,
- * entry_id)` constraint alone keys each row by file, so without the guard
- * below the same provider request would land twice and inflate every
- * aggregate. The `WHERE NOT EXISTS` clause skips inserts whose
- * `(entry_id, timestamp)` already exists under a different `session_file` —
- * first-write-wins across the lineage. Same-file re-syncs still hit the
- * `ON CONFLICT(session_file, entry_id)` upsert below, which re-derives the
- * stored cost (orchestration-aware) and keeps `premium_requests` monotonic, so
- * a forced re-parse repairs historical `premium_requests` and cost fix-ups.
- */
-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 token usage grouped by agent type (main agent, task subagents, advisor).
- * Token columns are explicit so the dashboard's share denominator matches the
- * counts it renders. Rows missing `agent_type` (defensive) fall back to "main".
- */
-export declare function getStatsByAgentType(cutoff?: number): AgentTypeStats[];
-/**
- * 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, bucketMs?: number): ModelTimeSeriesPoint[];
-/**
- * Get request/token/cost totals grouped by provider.
- */
-export declare function getStatsByProvider(cutoff?: number | null): ProviderAggregate[];
-/**
- * Get token burn grouped by provider and local hour of day (0-23).
- * Hours use the server's timezone — the dashboard is a localhost tool, so
- * server-local and viewer-local time coincide.
- */
-export declare function getProviderHourlyBurn(cutoff?: number | null): ProviderHourlyPoint[];
-/**
- * Get token/cost time series grouped by provider (bucketed like the model series).
- */
-export declare function getProviderTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ProviderTimeSeriesPoint[];
-/**
- * Get daily model performance time series data for the last N days.
- */
-export declare function getModelPerformanceSeries(days?: number, cutoff?: number | null, bucketMs?: number): 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, cutoff?: number | null): MessageStats[];
-export declare function getMessageById(id: number): MessageStats | null;
-/** Per-transcript-file rollup for the Traces session list. */
-export interface SessionRollupRow {
-    sessionFile: string;
-    requests: number;
-    startedAt: number;
-    endedAt: number;
-    totalTokens: number;
-    costTotal: number;
-    /** Comma-joined DISTINCT models. */
-    models: string;
-}
-/** Aggregate every synced transcript file into one row (subagents unfolded). */
-export declare function getSessionRollups(): SessionRollupRow[];
-/** Tool-call counts keyed by transcript file, for the Traces session list. */
-export declare function getToolCallCountsBySession(): Map<string, number>;
-/**
- * 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[];
-/**
- * Per-local-day activity aggregates for the last `days` days, oldest first.
- * Self-initializing (opens the stats DB on first use) so the coding-agent TUI
- * can query without the dashboard server's init flow. Days use the machine's
- * timezone — this is a localhost tool, same rationale as
- * {@link getProviderHourlyBurn}.
- */
-export declare function getDailyActivity(days?: number): Promise<DailyActivityPoint[]>;
-/**
- * Settle every full-session backfill after a successful sync pass.
- */
-export declare function markSessionBackfillsComplete(): void;
-/**
- * Insert user-message stats. Idempotent via UNIQUE(session_file, entry_id).
- * The `WHERE NOT EXISTS` clause matches {@link insertMessageStats}: forks
- * copy user entries verbatim into the child JSONL, so the same
- * `(entry_id, timestamp)` must not land twice across different session files.
- */
-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[];
-/**
- * Insert tool-call rows. Idempotent via UNIQUE(session_file, tool_call_id);
- * the `WHERE NOT EXISTS` guard mirrors {@link insertMessageStats}: forked
- * sessions deep-copy assistant entries (same `entry_id`, `timestamp`, and
- * tool-call ids under a new file), so first-write-wins across the lineage
- * keeps aggregates from double counting. Keyed on the assistant entry
- * identity, not the call id alone — provider call ids are not a global
- * namespace across unrelated sessions.
- */
-export declare function insertToolCalls(calls: ToolCallStats[]): number;
-/**
- * Attach result size / error flag to persisted tool-call rows. Results can
- * land in a later incremental sync pass than the call that produced them, so
- * this is an UPDATE keyed by (session_file, tool_call_id). The `IS NULL`
- * guard makes re-syncs idempotent; rows skipped by the fork guard simply
- * never match.
- */
-export declare function updateToolResults(links: ToolResultLink[]): number;
-/**
- * Get tool usage aggregated by tool name.
- */
-export declare function getToolStats(cutoff?: number): ToolUsageStats[];
-/**
- * Get tool usage aggregated by (tool, model, provider).
- */
-export declare function getToolStatsByModel(cutoff?: number): ToolModelStats[];
-/**
- * Get tool-call time series (one point per bucket per tool).
- */
-export declare function getToolTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ToolTimeSeriesPoint[];

package/dist/types/embedded-client.d.ts

@@ -1,18 +0,0 @@
-/**
- * Embedded stats dashboard archive handling.
- *
- * `embedded-client.generated.txt` holds the base64 of a gzipped tar of the
- * built dashboard (`dist/client`). It is populated by
- * `gen:stats` for compiled binaries and the
- * prepacked npm bundle, and reset to an empty file afterwards so the dev tree
- * keeps building the dashboard from source.
- */
-/**
- * Decode the generated archive text.
- *
- * Returns `null` when the content is blank or not a raw gzip archive encoded as
- * base64 — notably the legacy placeholder that contained a TypeScript
- * `export const … = "";` stub, which must be treated as "no archive embedded"
- * rather than decoded into garbage bytes.
- */
-export declare function decodeEmbeddedClientArchive(txt: string): Buffer | null;

package/dist/types/gain-aggregator.d.ts

@@ -1,26 +0,0 @@
-/**
- * Aggregates token-savings data for the Gain dashboard.
- *
- * Source:
- *   1. Snapcompact: colocated with stats.db as snapcompact-savings.jsonl
- *
- * Missing files are treated as zero records — never an error.
- */
-import type { GainDashboardStats } from "./shared-types.js";
-/**
- * Collapse conventional worktree sub-paths to their logical project root.
- *
- * Rules are generic: omp internal wt paths are dropped; conventional worktree
- * suffixes (`.wt/`, `-wt/`, `.worktrees/`, `-worktrees/`) are stripped. No
- * author-specific IDE or tool paths are baked in.
- *
- * Returns null to drop temp/internal paths entirely.
- */
-export declare function normalizeProjectPath(p: string): string | null;
-/**
- * Given a raw set of paths, normalize worktree paths and remove sub-paths
- * that are already covered by a shorter parent at depth ≥ 4.
- * Returns a sorted, deduped list of meaningful project roots.
- */
-export declare function dedupeProjects(rawPaths: Set<string>): string[];
-export declare function getGainDashboardStats(range?: string | null, project?: string | null): Promise<GainDashboardStats>;

package/dist/types/index.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env bun
-export { getDashboardStats, getToolDashboardStats, getTotalMessageCount, type SyncOptions, type SyncProgress, smokeTestSyncWorker, syncAllSessions, } from "./aggregator.js";
-export { closeDb } from "./db.js";
-export { getGainDashboardStats } from "./gain-aggregator.js";
-export { formatStatsDashboardUrl, startServer } from "./server.js";
-export type { GainDashboardStats, GainSource, GainSourceTotals, GainTimeSeriesPoint } from "./shared-types.js";
-export type { AggregatedStats, DashboardStats, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolDashboardStats, ToolModelStats, ToolTimeSeriesPoint, ToolUsageStats, } from "./types.js";
-/** Parsed arguments for the standalone `omp-stats` entry point. */
-export interface StandaloneStatsArgs {
-    port: number;
-    host: string;
-    json: boolean;
-    sync: boolean;
-    help: boolean;
-}
-/** Parse the standalone `omp-stats` arguments used by the production entry point. */
-export declare function parseStandaloneStatsArgs(args: string[]): StandaloneStatsArgs;

package/dist/types/parser.d.ts

@@ -1,61 +0,0 @@
-import type { AgentType, MessageStats, SessionEntry, ToolCallStats, ToolResultLink, UserMessageLink, UserMessageStats } from "./types.js";
-/**
- * Classify which agent produced a transcript from its path within the sessions
- * directory. Layout: `<sessionsDir>/<project>/<file>.jsonl` is the `main`
- * agent; subagent and advisor transcripts live nested one level deeper inside
- * the session's artifacts dir (`<project>/<session>/<id>.jsonl`,
- * `<project>/<session>/__advisor.jsonl`). Any advisor transcript
- * (`__advisor.jsonl` or `__advisor.<slug>.jsonl`) — at any depth, including a
- * subagent's own advisor — counts as `advisor`; every other nested transcript
- * is a task `subagent`.
- */
-export declare function classifyAgentType(sessionPath: string): AgentType;
-/**
- * Extract folder name from session filename.
- * Session files are named like: --work--pi--/timestamp_uuid.jsonl
- * The folder part uses -- as path separator.
- */
-export declare function extractFolderFromPath(sessionPath: string): string;
-/** Parse every well-formed entry in a transcript buffer (malformed lines skipped). */
-export declare function parseAllSessionEntries(bytes: Uint8Array): SessionEntry[];
-/**
- * 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[];
-    toolCalls: ToolCallStats[];
-    toolResults: ToolResultLink[];
-    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/port-conflict.d.ts

@@ -1,16 +0,0 @@
-/** Header stamped on every dashboard response so reuse probes can identify us. */
-export declare const STATS_DASHBOARD_HEADER = "x-omp-stats-dashboard";
-/** Header recording the server's requested bind host so reuse cannot change its exposure scope. */
-export declare const STATS_DASHBOARD_HOSTNAME_HEADER = "x-omp-stats-hostname";
-/** Identity-header value for dashboards enforcing an explicit bind host and same-origin access. */
-export declare const STATS_DASHBOARD_SECURITY_VERSION = "3";
-/** IPv4 loopback address shared by the dashboard server and reuse probe. */
-export declare const STATS_DASHBOARD_HOSTNAME = "127.0.0.1";
-/**
- * Reuse a secure dashboard or reclaim an insecure HTTP dashboard before binding.
- * The preflight is needed on platforms that permit wildcard and loopback-specific
- * listeners to coexist on one port.
- */
-export declare function prepareStatsPort(port: number, hostname?: string): Promise<"retry" | "reuse">;
-/** Reuse or reclaim a listener found after the server bind reports EADDRINUSE. */
-export declare function recoverStatsPort(port: number, hostname?: string): Promise<"retry" | "reuse">;

package/dist/types/server.d.ts

@@ -1,15 +0,0 @@
-/**
- * Handle API requests.
- */
-export declare function handleApi(req: Request): Promise<Response>;
-/** Format a dashboard origin, including brackets required by IPv6 literals. */
-export declare function formatStatsDashboardUrl(hostname: string, port: number): string;
-/**
- * Start the HTTP server, reusing a live dashboard or reclaiming a stale omp listener.
- */
-export interface StatsServerHandle {
-    hostname: string;
-    port: number;
-    stop: () => void;
-}
-export declare function startServer(port?: number, hostname?: string): Promise<StatsServerHandle>;