@linxiraos/pi-stats 1.1.0 → 1.1.2

package/dist/types/usage-windows.d.ts

@@ -0,0 +1,72 @@
+import type { ClientUsageClientSummary } from "@linxiraos/pi-ai/usage";
+import type { ProviderWindowInsight, UsageWindowSeries } from "./shared-types.js";
+/** Subset of a `usage_history` row consumed by the window analytics. */
+export interface UsageSnapshotRow {
+    /** Epoch ms the report was fetched. */
+    recordedAt: number;
+    provider: string;
+    /** Stable credential identity key. */
+    accountKey: string;
+    email: string | null;
+    accountId: string | null;
+    limitId: string;
+    label: string;
+    windowLabel: string | null;
+    /** Used fraction (0..1, >1 = overage) when the provider reported one. */
+    usedFraction: number | null;
+    status: string | null;
+}
+/** Utilization series + derived insights for every provider window in range. */
+export interface UsageWindowStats {
+    usageSeries: UsageWindowSeries[];
+    windowInsights: ProviderWindowInsight[];
+}
+/** Usage snapshots plus, in broker mode, fleet-wide token burn per provider. */
+export interface UsageDataSnapshot {
+    rows: UsageSnapshotRow[];
+    /**
+     * Total tokens (input + output + cache read/write) per provider summed
+     * across every install reporting to the auth broker, or `null` when no
+     * broker is configured or no client reports exist for the range. Matches
+     * the fleet-wide window fractions in `rows`, unlike local message stats
+     * which only see this install's burn.
+     */
+    fleetTokensByProvider: Map<string, number> | null;
+}
+/**
+ * Read usage-limit snapshots recorded at or after `sinceMs`, oldest first.
+ * Opens the agent DB read-only; returns `[]` when the DB or table is absent.
+ */
+export declare function readUsageSnapshots(sinceMs: number, dbPath?: string): UsageSnapshotRow[];
+/**
+ * Fetch usage data from wherever it actually accumulates: the auth broker's
+ * durable history plus per-client observed-usage reports when a broker is
+ * configured (the broker performs every upstream usage fetch in that mode, so
+ * the local `usage_history` stays frozen), else the local agent DB. Broker
+ * errors fall back to the local read so the dashboard degrades to
+ * stale-but-present data instead of failing.
+ */
+export declare function fetchUsageData(sinceMs: number): Promise<UsageDataSnapshot>;
+/**
+ * Fold per-client provider aggregates into total tokens per provider
+ * (input + output + cache read/write, matching message-stat `totalTokens`).
+ * Returns `null` when no client reported anything, signalling "no data"
+ * rather than "zero burn".
+ */
+export declare function sumFleetTokens(clients: ClientUsageClientSummary[]): Map<string, number> | null;
+/**
+ * Derive utilization series and per-window insights from raw snapshots.
+ *
+ * Windows are grouped by `(provider, limitId)` — never by display label.
+ * Distinct limits can share a duration label (Anthropic's overall and
+ * model-scoped 7-day windows, Codex's base and Spark weeklies); merging them
+ * interleaves unrelated fractions per account and wildly inflates consumption.
+ *
+ * `tokensByProvider` supplies each provider's token burn over the same time
+ * range (fleet-wide broker client reports when available, else local message
+ * stats); it converts consumed window fraction into an estimated token
+ * capacity per window. Attribution note: tokens are per provider, not per
+ * account, so the estimate treats the account fleet as one pooled
+ * subscription — which is exactly how round-robin auth uses it.
+ */
+export declare function computeUsageWindowStats(rows: UsageSnapshotRow[], tokensByProvider: ReadonlyMap<string, number>): UsageWindowStats;

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

@@ -0,0 +1,81 @@
+/**
+ * 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).
+     * A sentence also needs either two uppercase runs ("WHAT THE HELL") or
+     * one elongated run ("CMOOON") so a lone acronym/env var ("use JSON",
+     * "HOME=/tmp") doesn't register.
+     */
+    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)
+     * - interjections, elongated where the short form is ambiguous:
+     *   `noooo`, `ahhh`, `ugh(h)`, `argh`, `grr`, `stooop`, `whyyy`,
+     *   `fuuu(ck)`, `wtfff`, `omggg`, `yesss`, `goddd`, `bruhh`
+     * - standalone `dude`
+     * - sad emoticons: `:(`, `;(`, `:-(((`
+     */
+    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 `nope` / `nah` / `nvm` / `wrong` / `incorrect`
+     *   (word-bounded, so `now`, `nobody`, `north` don't match)
+     * - line-leading `no` when used as an interjection - followed by
+     *   punctuation, end-of-text, or a discourse word (`no i meant`,
+     *   `no, wait`). Determiner `no` (`no extensions to the page`,
+     *   `no auto start`) doesn't count.
+     * - `that(?:'s)? not (what|right|it)` and `not what i (meant|asked|said|wanted)`
+     * - `makes (no|zero) sense`
+     */
+    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)`
+     * - `why (would|did) (you|u)`
+     * - 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,92 +1,96 @@
 {
-  "type": "module",
-  "name": "@linxiraos/pi-stats",
-  "version": "1.1.0",
-  "description": "Local observability dashboard for pi AI usage statistics",
-  "homepage": "https://linxira-os.github.io/zeta/",
-  "author": "Can Boluk",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Linxira-OS/linxira-zeta.git",
-    "directory": "packages/stats"
-  },
-  "bugs": {
-    "url": "https://github.com/Linxira-OS/linxira-zeta/issues"
-  },
-  "keywords": [
-    "ai",
-    "observability",
-    "metrics",
-    "dashboard",
-    "llm",
-    "statistics"
-  ],
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "bin": {
-    "omp-stats": "./src/index.ts"
-  },
-  "scripts": {
-    "gen:stats": "bun scripts/generate-client-bundle.ts --generate",
-    "gen:stats:reset": "bun scripts/generate-client-bundle.ts --reset",
-    "build": "bun run build.ts",
-    "dev": "bun run src/index.ts",
-    "check": "biome check . && bun run check:types",
-    "check:types": "tsgo -p tsconfig.json --noEmit && tsgo -p tsconfig.client.json --noEmit",
-    "lint": "biome lint .",
-    "fix": "biome check --write --unsafe .",
-    "fmt": "biome format --write ."
-  },
-  "dependencies": {
-    "@linxiraos/pi-ai": "catalog:",
-    "@linxiraos/pi-catalog": "catalog:",
-    "@linxiraos/pi-utils": "catalog:",
-    "@tailwindcss/node": "catalog:",
-    "chart.js": "catalog:",
-    "lucide-react": "catalog:",
-    "react": "catalog:",
-    "react-chartjs-2": "catalog:",
-    "react-dom": "catalog:",
-    "tailwindcss": "catalog:"
-  },
-  "devDependencies": {
-    "@types/bun": "catalog:",
-    "@types/react": "catalog:",
-    "@types/react-dom": "catalog:",
-    "postcss": "catalog:"
-  },
-  "engines": {
-    "bun": ">=1.3.14"
-  },
-  "files": [
-    "src",
-    "build.ts",
-    "tailwind.config.js",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "exports": {
-    ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
-    },
-    "./*": {
-      "types": "./src/*.ts",
-      "import": "./src/*.ts"
-    },
-    "./client": {
-      "types": "./src/client/index.tsx",
-      "import": "./src/client/index.tsx"
-    },
-    "./client/*": {
-      "types": "./src/client/*.ts",
-      "import": "./src/client/*.ts"
-    },
-    "./client/components/*": {
-      "types": "./src/client/components/*.ts",
-      "import": "./src/client/components/*.ts"
-    },
-    "./*.js": "./src/*.ts"
-  }
-}
+	"type": "module",
+	"name": "@linxiraos/pi-stats",
+	"version": "1.1.2",
+	"description": "Local observability dashboard for pi AI usage statistics",
+	"homepage": "https://linxira-os.github.io/zeta/",
+	"author": "Can Boluk",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Linxira-OS/linxira-zeta.git",
+		"directory": "packages/stats"
+	},
+	"bugs": {
+		"url": "https://github.com/Linxira-OS/linxira-zeta/issues"
+	},
+	"keywords": [
+		"ai",
+		"observability",
+		"metrics",
+		"dashboard",
+		"llm",
+		"statistics"
+	],
+	"main": "./src/index.ts",
+	"types": "./dist/types/index.d.ts",
+	"bin": {
+		"zeta-stats": "./src/index.ts"
+	},
+	"scripts": {
+		"gen:stats": "bun scripts/generate-client-bundle.ts --generate",
+		"gen:stats:reset": "bun scripts/generate-client-bundle.ts --reset",
+		"build": "bun run build.ts",
+		"dev": "bun run src/index.ts",
+		"check": "biome check . && bun run check:types",
+		"check:types": "tsgo -p tsconfig.json --noEmit && tsgo -p tsconfig.client.json --noEmit",
+		"lint": "biome lint .",
+		"fix": "biome check --write --unsafe .",
+		"fmt": "biome format --write ."
+	},
+	"dependencies": {
+		"@linxiraos/pi-ai": "1.1.2",
+		"@linxiraos/pi-catalog": "1.1.2",
+		"@linxiraos/pi-utils": "1.1.2",
+		"@tailwindcss/node": "^4.3.2",
+		"chart.js": "^4.5.1",
+		"lucide-react": "^1.24.0",
+		"react": "19.2.7",
+		"react-chartjs-2": "^5.3.1",
+		"react-dom": "19.2.7",
+		"tailwindcss": "^4.3.2"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3.14",
+		"@types/react": "^19.2.17",
+		"@types/react-dom": "^19.2.3",
+		"postcss": "^8.5.16"
+	},
+	"engines": {
+		"bun": ">=1.3.14"
+	},
+	"files": [
+		"src",
+		"build.ts",
+		"tailwind.config.js",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		"THIRD-PARTY-NOTICES.txt",
+		"dist/types",
+		"dist/client"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./dist/types/*.d.ts",
+			"import": "./src/*.ts"
+		},
+		"./client": {
+			"types": "./dist/types/client/index.d.ts",
+			"import": "./src/client/index.tsx"
+		},
+		"./client/*": {
+			"types": "./dist/types/client/*.d.ts",
+			"import": "./src/client/*.ts"
+		},
+		"./client/components/*": {
+			"types": "./dist/types/client/components/*.d.ts",
+			"import": "./src/client/components/*.ts"
+		},
+		"./*.js": "./src/*.ts"
+	}
+}

package/src/aggregator.ts

@@ -37,7 +37,7 @@ import { getSessionEntry, listAllSessionFiles, type ParseSessionResult, parseSes
 import type { SyncWorkerRequest, SyncWorkerResponse } from "./sync-worker";
 // Coding-agent binary/bundle workers route through the CLI entrypoint with a
 // hidden argv mode, so the compiled binary and npm bundle only need one
-// JavaScript entry. Standalone source `omp-stats` keeps using this package's
+// JavaScript entry. Standalone source `zeta-stats` keeps using this package's
 // own sync-worker source file.
 import type {
 	BehaviorDashboardStats,