context-mode 1.0.166 → 1.0.167

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/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;

package/build/session/pricing.js

@@ -0,0 +1,151 @@
+/**
+ * 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).
+ */
+import catalog from "./model-prices.json" with { type: "json" };
+/**
+ * Read the curated JSON into one Map. A row with a null *input* price is
+ * unusable for cost (the primary bucket has no rate) and is dropped at load so
+ * lookupPrice returns null for it — matching "null-priced entries → no price".
+ * (The two null-input ids are already pruned from the JSON itself; this guard
+ * keeps the loader robust if one is ever re-added.)
+ */
+function buildCatalog() {
+    const map = new Map();
+    const src = catalog;
+    for (const id of Object.keys(src)) {
+        const row = src[id];
+        if (row == null || typeof row !== "object")
+            continue;
+        // No input rate ⇒ no usable price for this model.
+        if (typeof row.input_per_mtok !== "number")
+            continue;
+        map.set(id, {
+            input_per_mtok: row.input_per_mtok,
+            output_per_mtok: typeof row.output_per_mtok === "number" ? row.output_per_mtok : null,
+            cache_read_per_mtok: typeof row.cache_read_per_mtok === "number" ? row.cache_read_per_mtok : null,
+            cache_write_per_mtok: typeof row.cache_write_per_mtok === "number" ? row.cache_write_per_mtok : null,
+        });
+    }
+    return map;
+}
+const CATALOG = buildCatalog();
+/**
+ * Strip a single leading `provider/` segment, char-algorithmically (NO regex).
+ * Walks to the first '/'; everything after it is the bare model id. Only the
+ * FIRST segment is stripped — `openai/gpt-5` → `gpt-5`, `a/b/c` → `b/c` — so a
+ * model id that legitimately contains a slash keeps its remaining segments.
+ * Returns null when there is no '/' (caller already tried the raw form).
+ */
+function stripProviderPrefix(id) {
+    for (let i = 0; i < id.length; i++) {
+        if (id.charCodeAt(i) === 47 /* '/' */) {
+            // Guard against a leading or trailing slash producing an empty segment.
+            if (i === 0 || i === id.length - 1)
+                return null;
+            return id.slice(i + 1);
+        }
+    }
+    return null;
+}
+/** trim + lowercase, char-safe (String.prototype.trim/toLowerCase, no regex). */
+function normalize(id) {
+    return id.trim().toLowerCase();
+}
+/**
+ * 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 function lookupPrice(modelId) {
+    if (typeof modelId !== "string" || modelId.length === 0)
+        return null;
+    // 1. Exact — fastest path, covers ids already in canonical form.
+    const exact = CATALOG.get(modelId);
+    if (exact)
+        return exact;
+    // 2. Normalized — trimmed + lowercased.
+    const norm = normalize(modelId);
+    const byNorm = CATALOG.get(norm);
+    if (byNorm)
+        return byNorm;
+    // 3. Provider-stripped (pi / openclaw / opencode report `provider/model`).
+    const bare = stripProviderPrefix(norm);
+    if (bare) {
+        const byBare = CATALOG.get(bare);
+        if (byBare)
+            return byBare;
+    }
+    return null;
+}
+/** Price one token bucket. A null bucket rate falls back to the input rate. */
+function bucketCost(tokens, rate, inputRate) {
+    if (tokens <= 0)
+        return 0;
+    const effective = typeof rate === "number" ? rate : inputRate;
+    return tokens * effective;
+}
+/**
+ * Σ 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 function computeCostUsd(modelId, t) {
+    const input = typeof t.input_tokens === "number" ? t.input_tokens : 0;
+    const output = typeof t.output_tokens === "number" ? t.output_tokens : 0;
+    const cacheRead = typeof t.cache_read_tokens === "number" ? t.cache_read_tokens : 0;
+    const cacheCreate = typeof t.cache_creation_tokens === "number" ? t.cache_creation_tokens : 0;
+    // All buckets empty ⇒ nothing to price, regardless of model.
+    if (input <= 0 && output <= 0 && cacheRead <= 0 && cacheCreate <= 0)
+        return null;
+    const price = lookupPrice(modelId);
+    if (!price || typeof price.input_per_mtok !== "number") {
+        // Unknown model — emit one line so the id can be added to the catalog.
+        console.warn(`[pricing] no curated price for model id: ${modelId}`);
+        return null;
+    }
+    const inputRate = price.input_per_mtok;
+    const microDollars = bucketCost(input, inputRate, inputRate) +
+        bucketCost(output, price.output_per_mtok, inputRate) +
+        bucketCost(cacheRead, price.cache_read_per_mtok, inputRate) +
+        bucketCost(cacheCreate, price.cache_write_per_mtok, inputRate);
+    return microDollars / 1_000_000;
+}
+/**
+ * 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 function nativeOrComputed(modelId, t, nativeCostUsd) {
+    if (typeof nativeCostUsd === "number")
+        return nativeCostUsd;
+    return computeCostUsd(modelId, t);
+}