@mxalbert/context-mode 2.0.0

package/build/session/model-prices.json

@@ -0,0 +1,429 @@
+{
+    "claude-opus-4-8": {
+        "input_per_mtok": 5,
+        "output_per_mtok": 25,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": 6.25,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-opus-4-7": {
+        "input_per_mtok": 5,
+        "output_per_mtok": 25,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": 6.25,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-opus-4-6": {
+        "input_per_mtok": 5,
+        "output_per_mtok": 25,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": 6.25,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-opus-4-5": {
+        "input_per_mtok": 5,
+        "output_per_mtok": 25,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": 6.25,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-sonnet-4-6": {
+        "input_per_mtok": 3,
+        "output_per_mtok": 15,
+        "cache_read_per_mtok": 0.3,
+        "cache_write_per_mtok": 3.75,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-sonnet-4-5": {
+        "input_per_mtok": 3,
+        "output_per_mtok": 15,
+        "cache_read_per_mtok": 0.3,
+        "cache_write_per_mtok": 3.75,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-haiku-4-5": {
+        "input_per_mtok": 1,
+        "output_per_mtok": 5,
+        "cache_read_per_mtok": 0.1,
+        "cache_write_per_mtok": 1.25,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-3-7-sonnet": {
+        "input_per_mtok": 3,
+        "output_per_mtok": 15,
+        "cache_read_per_mtok": 0.3,
+        "cache_write_per_mtok": 3.75,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "claude-3-5-haiku": {
+        "input_per_mtok": 0.8,
+        "output_per_mtok": 4,
+        "cache_read_per_mtok": 0.08,
+        "cache_write_per_mtok": 1,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "claude-fable-5": {
+        "input_per_mtok": 10,
+        "output_per_mtok": 50,
+        "cache_read_per_mtok": 1,
+        "cache_write_per_mtok": 12.5,
+        "source": "https://platform.claude.com/docs/en/about-claude/pricing"
+    },
+    "gpt-5": {
+        "input_per_mtok": 1.25,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": 0.125,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-5-mini": {
+        "input_per_mtok": 0.25,
+        "output_per_mtok": 2,
+        "cache_read_per_mtok": 0.025,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-5-nano": {
+        "input_per_mtok": 0.05,
+        "output_per_mtok": 0.4,
+        "cache_read_per_mtok": 0.005,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-5-codex": {
+        "input_per_mtok": 1.25,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": 0.125,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-4.1": {
+        "input_per_mtok": 2,
+        "output_per_mtok": 8,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-4.1-mini": {
+        "input_per_mtok": 0.4,
+        "output_per_mtok": 1.6,
+        "cache_read_per_mtok": 0.1,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-4.1-nano": {
+        "input_per_mtok": 0.1,
+        "output_per_mtok": 0.4,
+        "cache_read_per_mtok": 0.025,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-4o": {
+        "input_per_mtok": 2.5,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": 1.25,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gpt-4o-mini": {
+        "input_per_mtok": 0.15,
+        "output_per_mtok": 0.6,
+        "cache_read_per_mtok": 0.075,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "o3": {
+        "input_per_mtok": 2,
+        "output_per_mtok": 8,
+        "cache_read_per_mtok": 0.5,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "o4-mini": {
+        "input_per_mtok": 1.1,
+        "output_per_mtok": 4.4,
+        "cache_read_per_mtok": 0.275,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "o3-mini": {
+        "input_per_mtok": 1.1,
+        "output_per_mtok": 4.4,
+        "cache_read_per_mtok": 0.55,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "codex-mini-latest": {
+        "input_per_mtok": 1.5,
+        "output_per_mtok": 6,
+        "cache_read_per_mtok": 0.375,
+        "cache_write_per_mtok": null,
+        "source": "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json"
+    },
+    "gemini-2.5-pro": {
+        "input_per_mtok": 1.25,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": 0.125,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-2.5-flash": {
+        "input_per_mtok": 0.3,
+        "output_per_mtok": 2.5,
+        "cache_read_per_mtok": 0.03,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-2.5-flash-lite": {
+        "input_per_mtok": 0.1,
+        "output_per_mtok": 0.4,
+        "cache_read_per_mtok": 0.01,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-2.0-flash": {
+        "input_per_mtok": 0.1,
+        "output_per_mtok": 0.4,
+        "cache_read_per_mtok": 0.025,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-2.0-flash-lite": {
+        "input_per_mtok": 0.075,
+        "output_per_mtok": 0.3,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-3-pro-preview": {
+        "input_per_mtok": 2,
+        "output_per_mtok": 12,
+        "cache_read_per_mtok": 0.2,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "gemini-3-flash-preview": {
+        "input_per_mtok": 0.5,
+        "output_per_mtok": 3,
+        "cache_read_per_mtok": 0.05,
+        "cache_write_per_mtok": null,
+        "source": "https://ai.google.dev/gemini-api/docs/pricing"
+    },
+    "qwen3-coder": {
+        "input_per_mtok": 1,
+        "output_per_mtok": 5,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.alibabacloud.com/help/en/model-studio/models"
+    },
+    "qwen-max": {
+        "input_per_mtok": 1.6,
+        "output_per_mtok": 6.4,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.alibabacloud.com/help/en/model-studio/models"
+    },
+    "qwen-plus": {
+        "input_per_mtok": 0.4,
+        "output_per_mtok": 1.2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.alibabacloud.com/help/en/model-studio/models"
+    },
+    "qwen-turbo": {
+        "input_per_mtok": 0.05,
+        "output_per_mtok": 0.2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.alibabacloud.com/help/en/model-studio/models"
+    },
+    "qwen3-max": {
+        "input_per_mtok": 1.2,
+        "output_per_mtok": 6,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.alibabacloud.com/help/en/model-studio/models"
+    },
+    "kimi-k2": {
+        "input_per_mtok": 0.6,
+        "output_per_mtok": 2.5,
+        "cache_read_per_mtok": 0.15,
+        "cache_write_per_mtok": null,
+        "source": "https://platform.moonshot.ai/docs/pricing/chat"
+    },
+    "kimi-k2-turbo": {
+        "input_per_mtok": 1.15,
+        "output_per_mtok": 8,
+        "cache_read_per_mtok": 0.15,
+        "cache_write_per_mtok": null,
+        "source": "https://platform.moonshot.ai/docs/pricing/chat"
+    },
+    "moonshot-v1-8k": {
+        "input_per_mtok": 0.2,
+        "output_per_mtok": 2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://platform.moonshot.ai/docs/pricing"
+    },
+    "moonshot-v1-32k": {
+        "input_per_mtok": 1,
+        "output_per_mtok": 3,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://platform.moonshot.ai/docs/pricing"
+    },
+    "moonshot-v1-128k": {
+        "input_per_mtok": 2,
+        "output_per_mtok": 5,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://platform.moonshot.ai/docs/pricing"
+    },
+    "deepseek-v3": {
+        "input_per_mtok": 0.27,
+        "output_per_mtok": 1.1,
+        "cache_read_per_mtok": 0.07,
+        "cache_write_per_mtok": 0,
+        "source": "https://api-docs.deepseek.com/quick_start/pricing"
+    },
+    "deepseek-r1": {
+        "input_per_mtok": 0.55,
+        "output_per_mtok": 2.19,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://api-docs.deepseek.com/quick_start/pricing"
+    },
+    "deepseek-chat": {
+        "input_per_mtok": 0.14,
+        "output_per_mtok": 0.28,
+        "cache_read_per_mtok": 0.0028,
+        "cache_write_per_mtok": null,
+        "source": "https://api-docs.deepseek.com/quick_start/pricing"
+    },
+    "deepseek-reasoner": {
+        "input_per_mtok": 0.14,
+        "output_per_mtok": 0.28,
+        "cache_read_per_mtok": 0.0028,
+        "cache_write_per_mtok": null,
+        "source": "https://api-docs.deepseek.com/quick_start/pricing"
+    },
+    "glm-4.6": {
+        "input_per_mtok": 0.6,
+        "output_per_mtok": 2.2,
+        "cache_read_per_mtok": 0.11,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.z.ai/guides/overview/pricing"
+    },
+    "glm-4-air": {
+        "input_per_mtok": 0.2,
+        "output_per_mtok": 1.1,
+        "cache_read_per_mtok": 0.03,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.z.ai/guides/overview/pricing"
+    },
+    "grok-4": {
+        "input_per_mtok": 3,
+        "output_per_mtok": 15,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.x.ai/docs/pricing"
+    },
+    "grok-3": {
+        "input_per_mtok": 3,
+        "output_per_mtok": 15,
+        "cache_read_per_mtok": 0.75,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.x.ai/docs/pricing"
+    },
+    "grok-code-fast-1": {
+        "input_per_mtok": 0.2,
+        "output_per_mtok": 1.5,
+        "cache_read_per_mtok": 0.02,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.x.ai/docs/pricing"
+    },
+    "grok-2": {
+        "input_per_mtok": 2,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://docs.x.ai/docs/pricing"
+    },
+    "mistral-large-latest": {
+        "input_per_mtok": 0.5,
+        "output_per_mtok": 1.5,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://mistral.ai/pricing"
+    },
+    "codestral-latest": {
+        "input_per_mtok": 0.3,
+        "output_per_mtok": 0.9,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://mistral.ai/pricing"
+    },
+    "devstral": {
+        "input_per_mtok": 0.4,
+        "output_per_mtok": 2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://mistral.ai/pricing"
+    },
+    "mistral-medium": {
+        "input_per_mtok": 0.4,
+        "output_per_mtok": 2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://mistral.ai/pricing"
+    },
+    "llama-4-maverick": {
+        "input_per_mtok": 0.27,
+        "output_per_mtok": 0.85,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.together.ai/pricing"
+    },
+    "llama-4-scout": {
+        "input_per_mtok": 0.08,
+        "output_per_mtok": 0.3,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.together.ai/pricing"
+    },
+    "llama-3.3-70b": {
+        "input_per_mtok": 0.88,
+        "output_per_mtok": 0.88,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://www.together.ai/pricing"
+    },
+    "command-a": {
+        "input_per_mtok": 2.5,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://cohere.com/pricing"
+    },
+    "command-r-plus": {
+        "input_per_mtok": 2.5,
+        "output_per_mtok": 10,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://cohere.com/pricing"
+    },
+    "amazon-nova-pro": {
+        "input_per_mtok": 0.8,
+        "output_per_mtok": 3.2,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://aws.amazon.com/bedrock/pricing/"
+    },
+    "amazon-nova-lite": {
+        "input_per_mtok": 0.06,
+        "output_per_mtok": 0.24,
+        "cache_read_per_mtok": null,
+        "cache_write_per_mtok": null,
+        "source": "https://aws.amazon.com/bedrock/pricing/"
+    }
+}

package/build/session/persist-tool-calls.d.ts

@@ -0,0 +1,54 @@
+/**
+ * persist-tool-calls — runtime glue between MCP server's in-memory
+ * `sessionStats` and the on-disk `tool_calls` SessionDB table.
+ *
+ * Why this module exists
+ * ──────────────────────
+ * Commit 4742160 (May 2 16:58) added the SessionDB write path so the
+ * statusline counters survived `npm update -g @mxalbert/context-mode` and
+ * `claude --continue`. Commit b392c2f (May 2 21:43) — the concurrency
+ * refactor — silently dropped that wiring as collateral. Same-session
+ * `/ctx-upgrade` flips the statusline back to `0 calls / $0.00`
+ * because the new PID starts with an empty `sessionStats` and never
+ * looks at the table the old PID was writing to.
+ *
+ * This module re-introduces the write path AND adds the read-side
+ * restore that 4742160 never shipped — both pure helpers so the
+ * server.ts wiring is a one-liner and the unit tests don't need to
+ * boot the MCP server.
+ */
+/**
+ * Shape returned by {@link restoreSessionStats}. Subset of the in-memory
+ * `sessionStats` object the MCP server keeps — only the fields that can
+ * be recovered from SessionDB.
+ */
+export interface RestoredSessionStats {
+    /** Per-tool call counts. */
+    calls: Record<string, number>;
+    /** Per-tool returned bytes. */
+    bytesReturned: Record<string, number>;
+    /**
+     * Epoch-ms for `session_meta.started_at` of the latest session, so the
+     * statusline `uptime_ms` reflects the original session start instead of
+     * resetting to `Date.now()` on every PID change.
+     */
+    sessionStart: number;
+}
+/**
+ * Increment the persistent tool-call counter for `toolName` under whatever
+ * session_id `session_meta` currently treats as the most recent. This is
+ * called from {@link trackResponse} on every tool response and must be
+ * cheap, non-throwing, and best-effort — a stats failure must never break
+ * the MCP tool call.
+ */
+export declare function persistToolCallCounter(sessionDbPath: string, toolName: string, bytes: number): void;
+/**
+ * Read the latest session's tool-call totals back out of SessionDB so the
+ * MCP server can hydrate its in-memory `sessionStats` on startup. Returns
+ * `null` when the DB is missing or empty so the caller can keep the
+ * default zero-state without branching twice.
+ *
+ * Used during MCP server boot (BEFORE the heartbeat fires) so the
+ * statusline doesn't briefly flash `0 calls / $0.00` after upgrade.
+ */
+export declare function restoreSessionStats(sessionDbPath: string): RestoredSessionStats | null;

package/build/session/persist-tool-calls.js

@@ -0,0 +1,105 @@
+/**
+ * persist-tool-calls — runtime glue between MCP server's in-memory
+ * `sessionStats` and the on-disk `tool_calls` SessionDB table.
+ *
+ * Why this module exists
+ * ──────────────────────
+ * Commit 4742160 (May 2 16:58) added the SessionDB write path so the
+ * statusline counters survived `npm update -g @mxalbert/context-mode` and
+ * `claude --continue`. Commit b392c2f (May 2 21:43) — the concurrency
+ * refactor — silently dropped that wiring as collateral. Same-session
+ * `/ctx-upgrade` flips the statusline back to `0 calls / $0.00`
+ * because the new PID starts with an empty `sessionStats` and never
+ * looks at the table the old PID was writing to.
+ *
+ * This module re-introduces the write path AND adds the read-side
+ * restore that 4742160 never shipped — both pure helpers so the
+ * server.ts wiring is a one-liner and the unit tests don't need to
+ * boot the MCP server.
+ */
+import { existsSync } from "node:fs";
+import { SessionDB } from "./db.js";
+/**
+ * Increment the persistent tool-call counter for `toolName` under whatever
+ * session_id `session_meta` currently treats as the most recent. This is
+ * called from {@link trackResponse} on every tool response and must be
+ * cheap, non-throwing, and best-effort — a stats failure must never break
+ * the MCP tool call.
+ */
+export function persistToolCallCounter(sessionDbPath, toolName, bytes) {
+    try {
+        if (!existsSync(sessionDbPath))
+            return;
+        const sdb = new SessionDB({ dbPath: sessionDbPath });
+        try {
+            const sid = sdb.getLatestSessionId();
+            if (!sid)
+                return;
+            sdb.incrementToolCall(sid, toolName, bytes);
+        }
+        finally {
+            sdb.close();
+        }
+    }
+    catch {
+        // Best-effort: counter must never throw and break the parent tool call.
+    }
+}
+/**
+ * Read the latest session's tool-call totals back out of SessionDB so the
+ * MCP server can hydrate its in-memory `sessionStats` on startup. Returns
+ * `null` when the DB is missing or empty so the caller can keep the
+ * default zero-state without branching twice.
+ *
+ * Used during MCP server boot (BEFORE the heartbeat fires) so the
+ * statusline doesn't briefly flash `0 calls / $0.00` after upgrade.
+ */
+export function restoreSessionStats(sessionDbPath) {
+    try {
+        if (!existsSync(sessionDbPath))
+            return null;
+        const sdb = new SessionDB({ dbPath: sessionDbPath });
+        try {
+            const sid = sdb.getLatestSessionId();
+            if (!sid)
+                return null;
+            const stats = sdb.getToolCallStats(sid);
+            const calls = {};
+            const bytesReturned = {};
+            for (const [tool, row] of Object.entries(stats.byTool)) {
+                calls[tool] = row.calls;
+                bytesReturned[tool] = row.bytesReturned;
+            }
+            // started_at is "YYYY-MM-DD HH:MM:SS" in UTC (SQLite datetime() default);
+            // append "Z" so Date.parse interprets it as UTC, matching how the
+            // session was actually persisted.
+            let sessionStart = Date.now();
+            try {
+                const meta = sdb.getSessionStats(sid);
+                if (meta?.started_at) {
+                    const parsed = Date.parse(`${meta.started_at}Z`);
+                    if (Number.isFinite(parsed) && parsed > 0)
+                        sessionStart = parsed;
+                }
+            }
+            catch {
+                // best-effort — keep `Date.now()` fallback
+            }
+            // Skip empty restores so callers can `if (restored)` and not stomp
+            // their already-zero default with another zero.
+            if (Object.keys(calls).length === 0 &&
+                Object.keys(bytesReturned).length === 0) {
+                // Still useful to return sessionStart so uptime_ms doesn't reset
+                // even when no tool calls were made — but only if we found a session.
+                return { calls, bytesReturned, sessionStart };
+            }
+            return { calls, bytesReturned, sessionStart };
+        }
+        finally {
+            sdb.close();
+        }
+    }
+    catch {
+        return null;
+    }
+}

package/build/session/pricing.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pricing catalog — single source of truth for per-model USD cost.
+ *
+ * Deep module, tiny interface. At load it reads one curated multi-vendor JSON
+ * (src/session/model-prices.json) into a Map<modelId, Price> in per-Mtok units,
+ * then exposes three pure-ish functions:
+ *
+ *   lookupPrice(modelId)            → Price | null
+ *   computeCostUsd(modelId, tokens) → number  | null
+ *   nativeOrComputed(id, t, native) → number  | null
+ *
+ * WHY THIS EXISTS — the bug it kills:
+ * The old table in src/session/extract.ts hardcoded ~5 Claude rows plus a
+ * `default` row, and any unmatched id (every OpenAI / Gemini / Qwen / DeepSeek
+ * / Grok model) silently inherited Claude-Sonnet pricing. Non-Claude turns were
+ * therefore mispriced. Here each model is priced from ITS OWN curated row, and
+ * an unknown id resolves to `null` (no price) instead of a wrong Claude rate.
+ *
+ * The large litellm catalog (~1.5MB, ~2900 models) is NOT bundled — it lives at
+ * tools/pricing/litellm-catalog.json as the dev-only refresh base for this
+ * curated JSON.
+ *
+ * The curated JSON is small (~13KB, 61 models) and esbuild inlines it into the
+ * hook/server bundles at build time (no runtime fs read, no external file).
+ */
+/** Per-Mtok price for one model. Any of the four rates may be null ("unknown"). */
+export interface Price {
+    input_per_mtok: number | null;
+    output_per_mtok: number | null;
+    cache_read_per_mtok: number | null;
+    cache_write_per_mtok: number | null;
+}
+/** Token counts for one turn. All fields optional; absent ⇒ treated as 0. */
+export interface TokenCounts {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_read_tokens?: number;
+    cache_creation_tokens?: number;
+}
+/**
+ * Resolve a model id to its curated Price, or null on miss.
+ * Strategy: exact, then normalized (trim+lowercase), then provider-stripped
+ * normalized. Misses return null so the caller can decide (warn / fall back).
+ */
+export declare function lookupPrice(modelId: string): Price | null;
+/**
+ * Σ tokens × per-Mtok price / 1e6 over the four buckets. Returns null when no
+ * price is found OR every token count is zero/absent (so dashboards never show
+ * a misleading "$0.00 for nothing" row). On a price miss, warns exactly once
+ * with the unmatched id so the curated catalog can be extended.
+ *
+ * Bucket → price mapping:
+ *   input_tokens          → input_per_mtok
+ *   output_tokens         → output_per_mtok  (null ⇒ input rate)
+ *   cache_read_tokens     → cache_read_per_mtok  (null ⇒ input rate)
+ *   cache_creation_tokens → cache_write_per_mtok (null ⇒ input rate)
+ */
+export declare function computeCostUsd(modelId: string, t: TokenCounts): number | null;
+/**
+ * Prefer a provider-supplied native cost when present, else compute from the
+ * catalog. A native cost of exactly 0 is a real value (free tier) and passes
+ * through — only null/undefined defers to computeCostUsd.
+ */
+export declare function nativeOrComputed(modelId: string, t: TokenCounts, nativeCostUsd?: number | null): number | null;