@titan-design/session-analytics 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henry Jewkes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @titan-design/session-analytics
+
+Pricing, session classification and banding for mined Claude Code sessions. Pure functions
+over plain objects: no database, no filesystem, no network.
+
+Tier 2 of the titan-platform DAG. It imports no other titan package; a caller composes it
+with `@titan-design/session-read` and `@titan-design/session-graph`.
+
+```ts
+import { classifySession, contextBand, priceRequest } from "@titan-design/session-analytics";
+
+priceRequest(
+  { inputTokens: 4, cacheReadTokens: 129_291, cacheCreation1hTokens: 1_359, outputTokens: 306 },
+  "claude-fable-5-1",
+  "2026-09-18T14:48:40.512Z",
+).costUsd; // 0.07484275
+```
+
+## What it exports
+
+- `PRICE_TABLE`, `PRICE_TABLE_VERSION`, `findPrice(model, ts, prices?)` — USD per million
+  tokens by longest model prefix, then the latest row effective at `ts`.
+- `priceRequest(tokens, model, ts, prices?)` — the five cost components, `costUsd` and
+  `priced`.
+- `classifySession(facts)` — `agent_spawned`, `human_interactive`, `headless_sdk` or
+  `other_headless`, plus `coordinator` or `adhoc` for human sessions.
+- `CONTEXT_BANDS`, `GAP_BANDS`, `bandOf`, `contextBand`, `gapBand`.
+
+## Two things that will bite you
+
+Fable's cache read is **0.025** of its input rate, not the 0.1 every other model uses.
+Misreading it overstated the 2026-09-20 audit by about $1,700.
+
+An unknown model is **unpriced**: `priced: false` and zero cost. There is no default row,
+because defaulting bills a new model at an old model's rate without saying so.
+
+Full reference: `site/reference/session-analytics.md`.

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+/** USD per million tokens. Fitted against 392 `cost-state` rows in the 2026-09-20 audit. */
+interface PriceRow {
+    /** Matched against the model string by longest prefix. */
+    modelPrefix: string;
+    /** ISO date. The latest row at or before a request's timestamp wins. */
+    effectiveFrom: string;
+    input: number;
+    cacheRead: number;
+    cacheWrite5m: number;
+    cacheWrite1h: number;
+    output: number;
+}
+/** Bump on any edit to PRICE_TABLE. The cost report prints it in its footer. */
+declare const PRICE_TABLE_VERSION = 1;
+declare const PRICE_TABLE: readonly PriceRow[];
+/**
+ * The longest prefix that matches the model, then the latest row effective at `ts`.
+ * Returns null for a model no row covers: an unknown model is unpriced, never defaulted,
+ * because a default silently prices a new model at an old model's rate.
+ */
+declare function findPrice(model: string, ts: string, prices?: readonly PriceRow[]): PriceRow | null;
+
+/** Raw token counts for one API request, as the transcript reports them. */
+interface RequestTokens {
+    inputTokens?: number;
+    cacheReadTokens?: number;
+    /** Total cache creation. Used only when the 5m/1h split is absent. */
+    cacheCreationTokens?: number;
+    cacheCreation5mTokens?: number;
+    cacheCreation1hTokens?: number;
+    outputTokens?: number;
+}
+interface PricedRequest {
+    inputUsd: number;
+    cacheReadUsd: number;
+    cacheWrite5mUsd: number;
+    cacheWrite1hUsd: number;
+    outputUsd: number;
+    costUsd: number;
+    /** False when no price row covers the model. Every component is then zero. */
+    priced: boolean;
+}
+declare function priceRequest(tokens: RequestTokens, model: string, ts: string, prices?: readonly PriceRow[]): PricedRequest;
+
+type SessionClass = "agent_spawned" | "human_interactive" | "headless_sdk" | "other_headless";
+/** Human sessions only. A coordinator drives other agents; an adhoc session does not. */
+type HumanRole = "coordinator" | "adhoc";
+/** The agent-chat spawn record for a session, as the origin resolver returns it. */
+interface SessionOrigin {
+    depth: number;
+    parentName?: string | null;
+    /** "adopted" and "inherited" mark a pane the human took over, not a spawned worker. */
+    originKind?: string | null;
+    profile?: string | null;
+}
+interface SessionFacts {
+    /** The harness entrypoint. Agent-chat workers and `-p` miners both report "sdk-cli". */
+    startType?: string | null;
+    origin?: SessionOrigin | null;
+    firstUserText?: string | null;
+    humanTurnCount?: number;
+    inboundKinds?: readonly string[];
+    signalKinds?: readonly string[];
+}
+interface SessionClassification {
+    sessionClass: SessionClass;
+    reason: string;
+    humanRole: HumanRole | null;
+}
+/**
+ * Rule order matters. The origin row wins over `startType` because agent-chat workers
+ * run `claude -p` and so report "sdk-cli" exactly like a headless miner does.
+ */
+declare function classifySession(facts: SessionFacts): SessionClassification;
+
+/** Half-open [lo, hi) in the band's own unit. */
+interface Band {
+    lo: number;
+    hi: number;
+    name: string;
+}
+/** Context size in tokens. From `cf_analyze.py` BANDS. */
+declare const CONTEXT_BANDS: readonly Band[];
+/** Idle gap in milliseconds. From `cf_analyze.py` IDLE. */
+declare const GAP_BANDS: readonly Band[];
+/** Null for a value no band covers, so a caller reports the gap instead of inventing one. */
+declare function bandOf(value: number, bands: readonly Band[]): string | null;
+declare function contextBand(tokens: number): string | null;
+declare function gapBand(millis: number): string | null;
+
+export { type Band, CONTEXT_BANDS, GAP_BANDS, type HumanRole, PRICE_TABLE, PRICE_TABLE_VERSION, type PriceRow, type PricedRequest, type RequestTokens, type SessionClass, type SessionClassification, type SessionFacts, type SessionOrigin, bandOf, classifySession, contextBand, findPrice, gapBand, priceRequest };

package/dist/index.js

@@ -0,0 +1,134 @@
+// src/prices.ts
+var PRICE_TABLE_VERSION = 1;
+var OPUS = { input: 5, cacheRead: 0.5, cacheWrite5m: 6.25, cacheWrite1h: 10, output: 25 };
+var SONNET = { input: 2, cacheRead: 0.2, cacheWrite5m: 2.5, cacheWrite1h: 4, output: 10 };
+var FABLE = { input: 10, cacheRead: 0.25, cacheWrite5m: 12.5, cacheWrite1h: 20, output: 50 };
+var HAIKU = { input: 1, cacheRead: 0.1, cacheWrite5m: 1.25, cacheWrite1h: 2, output: 5 };
+var FREE = { input: 0, cacheRead: 0, cacheWrite5m: 0, cacheWrite1h: 0, output: 0 };
+var GENESIS = "2026-01-01";
+var PRICE_TABLE = [
+  { modelPrefix: "claude-opus-5", effectiveFrom: GENESIS, ...OPUS },
+  { modelPrefix: "claude-opus-4-8", effectiveFrom: GENESIS, ...OPUS },
+  { modelPrefix: "claude-sonnet-5", effectiveFrom: GENESIS, ...SONNET },
+  { modelPrefix: "claude-fable-5-1", effectiveFrom: GENESIS, ...FABLE },
+  { modelPrefix: "claude-fable-5", effectiveFrom: GENESIS, ...FABLE },
+  { modelPrefix: "claude-haiku-4-5", effectiveFrom: GENESIS, ...HAIKU },
+  { modelPrefix: "<synthetic>", effectiveFrom: GENESIS, ...FREE }
+];
+function findPrice(model, ts, prices = PRICE_TABLE) {
+  let best = null;
+  for (const row of prices) {
+    if (!model.startsWith(row.modelPrefix)) continue;
+    if (row.effectiveFrom > ts) continue;
+    if (best && !isBetterMatch(row, best)) continue;
+    best = row;
+  }
+  return best;
+}
+function isBetterMatch(row, best) {
+  if (row.modelPrefix.length !== best.modelPrefix.length) return row.modelPrefix.length > best.modelPrefix.length;
+  return row.effectiveFrom > best.effectiveFrom;
+}
+
+// src/price-request.ts
+var UNPRICED = {
+  inputUsd: 0,
+  cacheReadUsd: 0,
+  cacheWrite5mUsd: 0,
+  cacheWrite1hUsd: 0,
+  outputUsd: 0,
+  costUsd: 0,
+  priced: false
+};
+function priceRequest(tokens, model, ts, prices = PRICE_TABLE) {
+  const row = findPrice(model, ts, prices);
+  if (!row) return { ...UNPRICED };
+  const { write5m, write1h } = splitCacheCreation(tokens);
+  const inputUsd = perMTok(tokens.inputTokens, row.input);
+  const cacheReadUsd = perMTok(tokens.cacheReadTokens, row.cacheRead);
+  const cacheWrite5mUsd = perMTok(write5m, row.cacheWrite5m);
+  const cacheWrite1hUsd = perMTok(write1h, row.cacheWrite1h);
+  const outputUsd = perMTok(tokens.outputTokens, row.output);
+  const costUsd = inputUsd + cacheReadUsd + cacheWrite5mUsd + cacheWrite1hUsd + outputUsd;
+  return { inputUsd, cacheReadUsd, cacheWrite5mUsd, cacheWrite1hUsd, outputUsd, costUsd, priced: true };
+}
+function splitCacheCreation(tokens) {
+  const write5m = tokens.cacheCreation5mTokens ?? 0;
+  const write1h = tokens.cacheCreation1hTokens ?? 0;
+  if (write5m > 0 || write1h > 0) return { write5m, write1h };
+  return { write5m: tokens.cacheCreationTokens ?? 0, write1h: 0 };
+}
+function perMTok(tokens, ratePerMTok) {
+  return (tokens ?? 0) * ratePerMTok / 1e6;
+}
+
+// src/classify-session.ts
+var COORDINATOR_SIGNALS = /* @__PURE__ */ new Set(["agent_spawn", "chat_send"]);
+function classifySession(facts) {
+  const [sessionClass, reason] = classOf(facts);
+  const humanRole = sessionClass === "human_interactive" ? humanRoleOf(facts) : null;
+  return { sessionClass, reason, humanRole };
+}
+function classOf(facts) {
+  const origin = facts.origin;
+  if (origin) {
+    if (isAdoptedPane(origin)) return ["human_interactive", "origin depth 0, human or adopted parent"];
+    return ["agent_spawned", "origin depth >= 1"];
+  }
+  if (facts.startType === "sdk-cli") return ["headless_sdk", "start_type sdk-cli with no origin row"];
+  if (isProgrammaticPrompt(facts)) return ["other_headless", "content-block prompt with <= 2 human turns"];
+  return ["human_interactive", "no origin row, no headless marker"];
+}
+function isAdoptedPane(origin) {
+  if (origin.depth !== 0) return false;
+  if (origin.parentName === "human") return true;
+  if (origin.originKind === "adopted" || origin.originKind === "inherited") return true;
+  return !origin.profile;
+}
+function isProgrammaticPrompt(facts) {
+  const text = (facts.firstUserText ?? "").trimStart();
+  return text.startsWith("[{") && (facts.humanTurnCount ?? 0) <= 2;
+}
+function humanRoleOf(facts) {
+  if (facts.inboundKinds?.includes("channel_message")) return "coordinator";
+  if (facts.signalKinds?.some((kind) => COORDINATOR_SIGNALS.has(kind))) return "coordinator";
+  return "adhoc";
+}
+
+// src/bands.ts
+var CONTEXT_BANDS = [
+  { lo: 0, hi: 5e4, name: "<50k" },
+  { lo: 5e4, hi: 1e5, name: "50-100k" },
+  { lo: 1e5, hi: 2e5, name: "100-200k" },
+  { lo: 2e5, hi: Number.POSITIVE_INFINITY, name: "200k+" }
+];
+var GAP_BANDS = [
+  { lo: 0, hi: 5 * 6e4, name: "<5m" },
+  { lo: 5 * 6e4, hi: 60 * 6e4, name: "5-60m" },
+  { lo: 60 * 6e4, hi: Number.POSITIVE_INFINITY, name: ">60m" }
+];
+function bandOf(value, bands) {
+  for (const band of bands) {
+    if (value >= band.lo && value < band.hi) return band.name;
+  }
+  return null;
+}
+function contextBand(tokens) {
+  return bandOf(tokens, CONTEXT_BANDS);
+}
+function gapBand(millis) {
+  return bandOf(millis, GAP_BANDS);
+}
+export {
+  CONTEXT_BANDS,
+  GAP_BANDS,
+  PRICE_TABLE,
+  PRICE_TABLE_VERSION,
+  bandOf,
+  classifySession,
+  contextBand,
+  findPrice,
+  gapBand,
+  priceRequest
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prices.ts","../src/price-request.ts","../src/classify-session.ts","../src/bands.ts"],"sourcesContent":["/** USD per million tokens. Fitted against 392 `cost-state` rows in the 2026-09-20 audit. */\nexport interface PriceRow {\n  /** Matched against the model string by longest prefix. */\n  modelPrefix: string;\n  /** ISO date. The latest row at or before a request's timestamp wins. */\n  effectiveFrom: string;\n  input: number;\n  cacheRead: number;\n  cacheWrite5m: number;\n  cacheWrite1h: number;\n  output: number;\n}\n\n/** Bump on any edit to PRICE_TABLE. The cost report prints it in its footer. */\nexport const PRICE_TABLE_VERSION = 1;\n\nconst OPUS = { input: 5.0, cacheRead: 0.5, cacheWrite5m: 6.25, cacheWrite1h: 10.0, output: 25.0 };\nconst SONNET = { input: 2.0, cacheRead: 0.2, cacheWrite5m: 2.5, cacheWrite1h: 4.0, output: 10.0 };\n// Fable's cache read is 0.025 of input, not the 0.1 every other model uses. Reading it as\n// 0.1 overstated the 2026-09-20 audit by about $1,700; `fable-cache-read.test` pins the ratio.\nconst FABLE = { input: 10.0, cacheRead: 0.25, cacheWrite5m: 12.5, cacheWrite1h: 20.0, output: 50.0 };\nconst HAIKU = { input: 1.0, cacheRead: 0.1, cacheWrite5m: 1.25, cacheWrite1h: 2.0, output: 5.0 };\nconst FREE = { input: 0, cacheRead: 0, cacheWrite5m: 0, cacheWrite1h: 0, output: 0 };\n\nconst GENESIS = \"2026-01-01\";\n\nexport const PRICE_TABLE: readonly PriceRow[] = [\n  { modelPrefix: \"claude-opus-5\", effectiveFrom: GENESIS, ...OPUS },\n  { modelPrefix: \"claude-opus-4-8\", effectiveFrom: GENESIS, ...OPUS },\n  { modelPrefix: \"claude-sonnet-5\", effectiveFrom: GENESIS, ...SONNET },\n  { modelPrefix: \"claude-fable-5-1\", effectiveFrom: GENESIS, ...FABLE },\n  { modelPrefix: \"claude-fable-5\", effectiveFrom: GENESIS, ...FABLE },\n  { modelPrefix: \"claude-haiku-4-5\", effectiveFrom: GENESIS, ...HAIKU },\n  { modelPrefix: \"<synthetic>\", effectiveFrom: GENESIS, ...FREE },\n];\n\n/**\n * The longest prefix that matches the model, then the latest row effective at `ts`.\n * Returns null for a model no row covers: an unknown model is unpriced, never defaulted,\n * because a default silently prices a new model at an old model's rate.\n */\nexport function findPrice(model: string, ts: string, prices: readonly PriceRow[] = PRICE_TABLE): PriceRow | null {\n  let best: PriceRow | null = null;\n  for (const row of prices) {\n    if (!model.startsWith(row.modelPrefix)) continue;\n    if (row.effectiveFrom > ts) continue;\n    if (best && !isBetterMatch(row, best)) continue;\n    best = row;\n  }\n  return best;\n}\n\nfunction isBetterMatch(row: PriceRow, best: PriceRow): boolean {\n  if (row.modelPrefix.length !== best.modelPrefix.length) return row.modelPrefix.length > best.modelPrefix.length;\n  return row.effectiveFrom > best.effectiveFrom;\n}\n","import type { PriceRow } from \"./prices.js\";\nimport { PRICE_TABLE, findPrice } from \"./prices.js\";\n\n/** Raw token counts for one API request, as the transcript reports them. */\nexport interface RequestTokens {\n  inputTokens?: number;\n  cacheReadTokens?: number;\n  /** Total cache creation. Used only when the 5m/1h split is absent. */\n  cacheCreationTokens?: number;\n  cacheCreation5mTokens?: number;\n  cacheCreation1hTokens?: number;\n  outputTokens?: number;\n}\n\nexport interface PricedRequest {\n  inputUsd: number;\n  cacheReadUsd: number;\n  cacheWrite5mUsd: number;\n  cacheWrite1hUsd: number;\n  outputUsd: number;\n  costUsd: number;\n  /** False when no price row covers the model. Every component is then zero. */\n  priced: boolean;\n}\n\nconst UNPRICED: PricedRequest = {\n  inputUsd: 0,\n  cacheReadUsd: 0,\n  cacheWrite5mUsd: 0,\n  cacheWrite1hUsd: 0,\n  outputUsd: 0,\n  costUsd: 0,\n  priced: false,\n};\n\nexport function priceRequest(\n  tokens: RequestTokens,\n  model: string,\n  ts: string,\n  prices: readonly PriceRow[] = PRICE_TABLE,\n): PricedRequest {\n  const row = findPrice(model, ts, prices);\n  if (!row) return { ...UNPRICED };\n\n  const { write5m, write1h } = splitCacheCreation(tokens);\n  const inputUsd = perMTok(tokens.inputTokens, row.input);\n  const cacheReadUsd = perMTok(tokens.cacheReadTokens, row.cacheRead);\n  const cacheWrite5mUsd = perMTok(write5m, row.cacheWrite5m);\n  const cacheWrite1hUsd = perMTok(write1h, row.cacheWrite1h);\n  const outputUsd = perMTok(tokens.outputTokens, row.output);\n  const costUsd = inputUsd + cacheReadUsd + cacheWrite5mUsd + cacheWrite1hUsd + outputUsd;\n  return { inputUsd, cacheReadUsd, cacheWrite5mUsd, cacheWrite1hUsd, outputUsd, costUsd, priced: true };\n}\n\n/**\n * Older transcripts carry a cache_creation total with no ttl breakdown. Charging the\n * 5m rate there under-reads rather than over-reads, and 5m is the harness default.\n */\nfunction splitCacheCreation(tokens: RequestTokens): { write5m: number; write1h: number } {\n  const write5m = tokens.cacheCreation5mTokens ?? 0;\n  const write1h = tokens.cacheCreation1hTokens ?? 0;\n  if (write5m > 0 || write1h > 0) return { write5m, write1h };\n  return { write5m: tokens.cacheCreationTokens ?? 0, write1h: 0 };\n}\n\nfunction perMTok(tokens: number | undefined, ratePerMTok: number): number {\n  return ((tokens ?? 0) * ratePerMTok) / 1_000_000;\n}\n","export type SessionClass = \"agent_spawned\" | \"human_interactive\" | \"headless_sdk\" | \"other_headless\";\n\n/** Human sessions only. A coordinator drives other agents; an adhoc session does not. */\nexport type HumanRole = \"coordinator\" | \"adhoc\";\n\n/** The agent-chat spawn record for a session, as the origin resolver returns it. */\nexport interface SessionOrigin {\n  depth: number;\n  parentName?: string | null;\n  /** \"adopted\" and \"inherited\" mark a pane the human took over, not a spawned worker. */\n  originKind?: string | null;\n  profile?: string | null;\n}\n\nexport interface SessionFacts {\n  /** The harness entrypoint. Agent-chat workers and `-p` miners both report \"sdk-cli\". */\n  startType?: string | null;\n  origin?: SessionOrigin | null;\n  firstUserText?: string | null;\n  humanTurnCount?: number;\n  inboundKinds?: readonly string[];\n  signalKinds?: readonly string[];\n}\n\nexport interface SessionClassification {\n  sessionClass: SessionClass;\n  reason: string;\n  humanRole: HumanRole | null;\n}\n\nconst COORDINATOR_SIGNALS = new Set([\"agent_spawn\", \"chat_send\"]);\n\n/**\n * Rule order matters. The origin row wins over `startType` because agent-chat workers\n * run `claude -p` and so report \"sdk-cli\" exactly like a headless miner does.\n */\nexport function classifySession(facts: SessionFacts): SessionClassification {\n  const [sessionClass, reason] = classOf(facts);\n  const humanRole = sessionClass === \"human_interactive\" ? humanRoleOf(facts) : null;\n  return { sessionClass, reason, humanRole };\n}\n\nfunction classOf(facts: SessionFacts): [SessionClass, string] {\n  const origin = facts.origin;\n  if (origin) {\n    if (isAdoptedPane(origin)) return [\"human_interactive\", \"origin depth 0, human or adopted parent\"];\n    return [\"agent_spawned\", \"origin depth >= 1\"];\n  }\n  if (facts.startType === \"sdk-cli\") return [\"headless_sdk\", \"start_type sdk-cli with no origin row\"];\n  if (isProgrammaticPrompt(facts)) return [\"other_headless\", \"content-block prompt with <= 2 human turns\"];\n  return [\"human_interactive\", \"no origin row, no headless marker\"];\n}\n\nfunction isAdoptedPane(origin: SessionOrigin): boolean {\n  if (origin.depth !== 0) return false;\n  if (origin.parentName === \"human\") return true;\n  if (origin.originKind === \"adopted\" || origin.originKind === \"inherited\") return true;\n  return !origin.profile;\n}\n\n/** Cron and RemoteTrigger daemons inject a structured content block, never typed prose. */\nfunction isProgrammaticPrompt(facts: SessionFacts): boolean {\n  const text = (facts.firstUserText ?? \"\").trimStart();\n  return text.startsWith(\"[{\") && (facts.humanTurnCount ?? 0) <= 2;\n}\n\nfunction humanRoleOf(facts: SessionFacts): HumanRole {\n  if (facts.inboundKinds?.includes(\"channel_message\")) return \"coordinator\";\n  if (facts.signalKinds?.some((kind) => COORDINATOR_SIGNALS.has(kind))) return \"coordinator\";\n  return \"adhoc\";\n}\n","/** Half-open [lo, hi) in the band's own unit. */\nexport interface Band {\n  lo: number;\n  hi: number;\n  name: string;\n}\n\n/** Context size in tokens. From `cf_analyze.py` BANDS. */\nexport const CONTEXT_BANDS: readonly Band[] = [\n  { lo: 0, hi: 50_000, name: \"<50k\" },\n  { lo: 50_000, hi: 100_000, name: \"50-100k\" },\n  { lo: 100_000, hi: 200_000, name: \"100-200k\" },\n  { lo: 200_000, hi: Number.POSITIVE_INFINITY, name: \"200k+\" },\n];\n\n/** Idle gap in milliseconds. From `cf_analyze.py` IDLE. */\nexport const GAP_BANDS: readonly Band[] = [\n  { lo: 0, hi: 5 * 60_000, name: \"<5m\" },\n  { lo: 5 * 60_000, hi: 60 * 60_000, name: \"5-60m\" },\n  { lo: 60 * 60_000, hi: Number.POSITIVE_INFINITY, name: \">60m\" },\n];\n\n/** Null for a value no band covers, so a caller reports the gap instead of inventing one. */\nexport function bandOf(value: number, bands: readonly Band[]): string | null {\n  for (const band of bands) {\n    if (value >= band.lo && value < band.hi) return band.name;\n  }\n  return null;\n}\n\nexport function contextBand(tokens: number): string | null {\n  return bandOf(tokens, CONTEXT_BANDS);\n}\n\nexport function gapBand(millis: number): string | null {\n  return bandOf(millis, GAP_BANDS);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@titan-design/session-analytics",
+  "version": "0.0.0",
+  "description": "Pure pricing, session classification and banding over mined session data",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "author": "Henry Jewkes",
+  "license": "MIT",
+  "homepage": "https://github.com/HJewkes/titan-platform#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HJewkes/titan-platform.git",
+    "directory": "packages/session-analytics"
+  },
+  "bugs": "https://github.com/HJewkes/titan-platform/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}