@diogonzafe/tokenwatch 0.2.1 → 0.4.0

package/dist/cli.js

@@ -22,7 +22,7 @@ async function fetchRemotePrices(url = REMOTE_URL) {
     const data = await res.json();
     if (!data?.models) return null;
     await persistCache(data);
-    return data.models;
+    return { models: data.models, updated_at: data.updated_at ?? "" };
   } catch {
     return null;
   }
@@ -34,7 +34,8 @@ async function loadCachedPrices() {
     const data = JSON.parse(raw);
     const age = Date.now() - (data._cachedAt ?? 0);
     if (age > CACHE_TTL_MS) return null;
-    return data.models ?? null;
+    if (!data.models) return null;
+    return { models: data.models, updated_at: data.updated_at ?? "" };
   } catch {
     return null;
   }
@@ -98,16 +99,18 @@ var SqliteStorage = class {
   migrate() {
     this.db.exec(`
       CREATE TABLE IF NOT EXISTS usage (
-        id               INTEGER PRIMARY KEY AUTOINCREMENT,
-        model            TEXT    NOT NULL,
-        input_tokens     INTEGER NOT NULL,
-        output_tokens    INTEGER NOT NULL,
-        reasoning_tokens INTEGER NOT NULL DEFAULT 0,
-        cost_usd         REAL    NOT NULL,
-        session_id       TEXT,
-        user_id          TEXT,
-        feature          TEXT,
-        timestamp        TEXT    NOT NULL
+        id                    INTEGER PRIMARY KEY AUTOINCREMENT,
+        model                 TEXT    NOT NULL,
+        input_tokens          INTEGER NOT NULL,
+        output_tokens         INTEGER NOT NULL,
+        reasoning_tokens      INTEGER NOT NULL DEFAULT 0,
+        cached_tokens         INTEGER NOT NULL DEFAULT 0,
+        cache_creation_tokens INTEGER NOT NULL DEFAULT 0,
+        cost_usd              REAL    NOT NULL,
+        session_id            TEXT,
+        user_id               TEXT,
+        feature               TEXT,
+        timestamp             TEXT    NOT NULL
       )
     `);
     const cols = this.db.prepare(`PRAGMA table_info(usage)`).all().map((c) => c.name);
@@ -117,17 +120,26 @@ var SqliteStorage = class {
     if (!cols.includes("feature")) {
       this.db.exec(`ALTER TABLE usage ADD COLUMN feature TEXT`);
     }
+    if (!cols.includes("cached_tokens")) {
+      this.db.exec(`ALTER TABLE usage ADD COLUMN cached_tokens INTEGER NOT NULL DEFAULT 0`);
+    }
+    if (!cols.includes("cache_creation_tokens")) {
+      this.db.exec(`ALTER TABLE usage ADD COLUMN cache_creation_tokens INTEGER NOT NULL DEFAULT 0`);
+    }
   }
   record(entry) {
     this.db.prepare(
       `INSERT INTO usage
-         (model, input_tokens, output_tokens, reasoning_tokens, cost_usd, session_id, user_id, feature, timestamp)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
+         (model, input_tokens, output_tokens, reasoning_tokens, cached_tokens, cache_creation_tokens,
+          cost_usd, session_id, user_id, feature, timestamp)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
     ).run(
       entry.model,
       entry.inputTokens,
       entry.outputTokens,
       entry.reasoningTokens ?? 0,
+      entry.cachedTokens ?? 0,
+      entry.cacheCreationTokens ?? 0,
       entry.costUSD,
       entry.sessionId ?? null,
       entry.userId ?? null,
@@ -142,6 +154,8 @@ var SqliteStorage = class {
       inputTokens: r.input_tokens,
       outputTokens: r.output_tokens,
       ...r.reasoning_tokens > 0 && { reasoningTokens: r.reasoning_tokens },
+      ...r.cached_tokens > 0 && { cachedTokens: r.cached_tokens },
+      ...r.cache_creation_tokens > 0 && { cacheCreationTokens: r.cache_creation_tokens },
       costUSD: r.cost_usd,
       ...r.session_id != null && { sessionId: r.session_id },
       ...r.user_id != null && { userId: r.user_id },
@@ -188,93 +202,153 @@ function lookupInMap(model, map) {
   }
   return void 0;
 }
-function calculateCost(inputTokens, outputTokens, price) {
-  return inputTokens / 1e6 * price.input + outputTokens / 1e6 * price.output;
+function calculateCost(inputTokens, outputTokens, price, cachedTokens = 0, cacheCreationTokens = 0) {
+  const regularInputCost = inputTokens / 1e6 * price.input;
+  const cachedReadCost = cachedTokens / 1e6 * (price.cachedInput ?? price.input);
+  const cacheCreationCost = cacheCreationTokens / 1e6 * (price.cacheCreationInput ?? price.input * 1.25);
+  const outputCost = outputTokens / 1e6 * price.output;
+  return regularInputCost + cachedReadCost + cacheCreationCost + outputCost;
+}
+
+// src/core/suggestions.ts
+var PROVIDER_PREFIXES = ["gpt-", "claude-", "gemini-", "deepseek-"];
+function getProviderPrefix(model) {
+  return PROVIDER_PREFIXES.find((p) => model.startsWith(p));
+}
+function maybeSuggestCheaperModel(model, costUSD, inputTokens, outputTokens, layers) {
+  if (costUSD <= 0) return;
+  const prefix = getProviderPrefix(model);
+  if (!prefix) return;
+  const mergedMap = {
+    ...layers.bundledPrices,
+    ...layers.remotePrices ?? {},
+    ...layers.customPrices ?? {}
+  };
+  let cheapestModel;
+  let cheapestCost = Infinity;
+  for (const key of Object.keys(mergedMap)) {
+    if (key === model || !key.startsWith(prefix)) continue;
+    const price = mergedMap[key];
+    if (!price) continue;
+    const candidateCost = calculateCost(inputTokens, outputTokens, price);
+    if (candidateCost < cheapestCost) {
+      cheapestCost = candidateCost;
+      cheapestModel = key;
+    }
+  }
+  if (cheapestModel === void 0 || cheapestCost >= costUSD * 0.5) return;
+  const savingsPct = Math.round((1 - cheapestCost / costUSD) * 100);
+  console.log(
+    `[tokenwatch] Suggestion: ${cheapestModel} could handle this for ~$${cheapestCost.toFixed(4)} (${savingsPct}% cheaper than ${model})`
+  );
 }
 
 // prices.json
 var prices_default = {
-  updated_at: "2026-04-21",
+  updated_at: "2026-04-22",
   source: "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json",
   models: {
     "gpt-4o": {
       input: 2.5,
       output: 10,
+      cachedInput: 1.25,
       maxInputTokens: 128e3
     },
     "gpt-4o-mini": {
       input: 0.15,
       output: 0.6,
+      cachedInput: 0.075,
       maxInputTokens: 128e3
     },
     "gpt-5": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5-mini": {
       input: 0.25,
       output: 2,
+      cachedInput: 0.025,
       maxInputTokens: 272e3
     },
     "gpt-5-nano": {
       input: 0.05,
       output: 0.4,
+      cachedInput: 5e-3,
       maxInputTokens: 272e3
     },
     "claude-opus-4-6": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-sonnet-4-6": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     },
     "claude-haiku-4-5": {
       input: 1,
       output: 5,
+      cachedInput: 0.1,
+      cacheCreationInput: 1.25,
       maxInputTokens: 2e5
     },
     "gemini-2.5-pro": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash": {
       input: 0.3,
       output: 2.5,
+      cachedInput: 0.03,
       maxInputTokens: 1048576
     },
     "deepseek-chat": {
       input: 0.28,
       output: 0.42,
+      cachedInput: 0.028,
       maxInputTokens: 131072
     },
     "deepseek-reasoner": {
       input: 0.28,
       output: 0.42,
+      cachedInput: 0.028,
       maxInputTokens: 131072
     },
     "claude-opus-4-5": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 2e5
     },
     "claude-opus-4-7": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-opus-4-1": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-sonnet-4-5": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "gpt-oss-120b": {
@@ -365,36 +439,43 @@ var prices_default = {
     "gpt-4.1": {
       input: 2,
       output: 8,
+      cachedInput: 0.5,
       maxInputTokens: 1047576
     },
     "gpt-4.1-2025-04-14": {
       input: 2,
       output: 8,
+      cachedInput: 0.5,
       maxInputTokens: 1047576
     },
     "gpt-4.1-mini": {
       input: 0.4,
       output: 1.6,
+      cachedInput: 0.1,
       maxInputTokens: 1047576
     },
     "gpt-4.1-mini-2025-04-14": {
       input: 0.4,
       output: 1.6,
+      cachedInput: 0.1,
       maxInputTokens: 1047576
     },
     "gpt-4.1-nano": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.025,
       maxInputTokens: 1047576
     },
     "gpt-4.1-nano-2025-04-14": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.025,
       maxInputTokens: 1047576
     },
     "gpt-4.5-preview": {
       input: 75,
       output: 150,
+      cachedInput: 37.5,
       maxInputTokens: 128e3
     },
     "gpt-4o-2024-05-13": {
@@ -405,11 +486,13 @@ var prices_default = {
     "gpt-4o-2024-08-06": {
       input: 2.5,
       output: 10,
+      cachedInput: 1.25,
       maxInputTokens: 128e3
     },
     "gpt-4o-2024-11-20": {
       input: 2.5,
       output: 10,
+      cachedInput: 1.25,
       maxInputTokens: 128e3
     },
     "gpt-audio-2025-08-28": {
@@ -435,6 +518,7 @@ var prices_default = {
     "gpt-4o-mini-2024-07-18": {
       input: 0.15,
       output: 0.6,
+      cachedInput: 0.075,
       maxInputTokens: 128e3
     },
     "gpt-4o-mini-audio-preview-2024-12-17": {
@@ -445,21 +529,25 @@ var prices_default = {
     "gpt-4o-mini-realtime-preview-2024-12-17": {
       input: 0.6,
       output: 2.4,
+      cachedInput: 0.3,
       maxInputTokens: 128e3
     },
     "gpt-realtime-2025-08-28": {
       input: 4,
       output: 16,
+      cachedInput: 0.4,
       maxInputTokens: 32e3
     },
     "gpt-realtime-1.5-2026-02-23": {
       input: 4,
       output: 16,
+      cachedInput: 4,
       maxInputTokens: 32e3
     },
     "gpt-realtime-mini-2025-10-06": {
       input: 0.6,
       output: 2.4,
+      cachedInput: 0.06,
       maxInputTokens: 128e3
     },
     "gpt-4o-mini-transcribe": {
@@ -470,11 +558,13 @@ var prices_default = {
     "gpt-4o-realtime-preview-2024-10-01": {
       input: 5,
       output: 20,
+      cachedInput: 2.5,
       maxInputTokens: 128e3
     },
     "gpt-4o-realtime-preview-2024-12-17": {
       input: 5,
       output: 20,
+      cachedInput: 2.5,
       maxInputTokens: 128e3
     },
     "gpt-4o-transcribe": {
@@ -490,51 +580,61 @@ var prices_default = {
     "gpt-5.1-2025-11-13": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5.1-chat-2025-11-13": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 128e3
     },
     "gpt-5.1-codex-2025-11-13": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5.1-codex-mini-2025-11-13": {
       input: 0.25,
       output: 2,
+      cachedInput: 0.025,
       maxInputTokens: 272e3
     },
     "gpt-5-2025-08-07": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5-chat": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 128e3
     },
     "gpt-5-chat-latest": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 128e3
     },
     "gpt-5-codex": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5-mini-2025-08-07": {
       input: 0.25,
       output: 2,
+      cachedInput: 0.025,
       maxInputTokens: 272e3
     },
     "gpt-5-nano-2025-08-07": {
       input: 0.05,
       output: 0.4,
+      cachedInput: 5e-3,
       maxInputTokens: 272e3
     },
     "gpt-5-pro": {
@@ -545,61 +645,73 @@ var prices_default = {
     "gpt-5.1": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5.1-chat": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 128e3
     },
     "gpt-5.1-codex": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5.1-codex-max": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 272e3
     },
     "gpt-5.1-codex-mini": {
       input: 0.25,
       output: 2,
+      cachedInput: 0.025,
       maxInputTokens: 272e3
     },
     "gpt-5.2": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 272e3
     },
     "gpt-5.2-2025-12-11": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 272e3
     },
     "gpt-5.2-chat": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 128e3
     },
     "gpt-5.2-chat-2025-12-11": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 128e3
     },
     "gpt-5.2-codex": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 272e3
     },
     "gpt-5.3-chat": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 128e3
     },
     "gpt-5.3-codex": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 272e3
     },
     "gpt-5.2-pro": {
@@ -615,71 +727,85 @@ var prices_default = {
     "gpt-5.4": {
       input: 2.5,
       output: 15,
+      cachedInput: 0.25,
       maxInputTokens: 105e4
     },
     "gpt-5.4-2026-03-05": {
       input: 2.5,
       output: 15,
+      cachedInput: 0.25,
       maxInputTokens: 105e4
     },
     "gpt-5.4-pro": {
       input: 30,
       output: 180,
+      cachedInput: 3,
       maxInputTokens: 105e4
     },
     "gpt-5.4-pro-2026-03-05": {
       input: 30,
       output: 180,
+      cachedInput: 3,
       maxInputTokens: 105e4
     },
     "gpt-5.4-mini": {
       input: 0.75,
       output: 4.5,
+      cachedInput: 0.075,
       maxInputTokens: 272e3
     },
     "gpt-5.4-nano": {
       input: 0.2,
       output: 1.25,
+      cachedInput: 0.02,
       maxInputTokens: 272e3
     },
     "o1-2024-12-17": {
       input: 15,
       output: 60,
+      cachedInput: 7.5,
       maxInputTokens: 2e5
     },
     "o1-mini": {
       input: 1.21,
       output: 4.84,
+      cachedInput: 0.605,
       maxInputTokens: 128e3
     },
     "o1-mini-2024-09-12": {
       input: 1.1,
       output: 4.4,
+      cachedInput: 0.55,
       maxInputTokens: 128e3
     },
     "o1-preview": {
       input: 15,
       output: 60,
+      cachedInput: 7.5,
       maxInputTokens: 128e3
     },
     "o1-preview-2024-09-12": {
       input: 15,
       output: 60,
+      cachedInput: 7.5,
       maxInputTokens: 128e3
     },
     "o3-2025-04-16": {
       input: 2,
       output: 8,
+      cachedInput: 0.5,
       maxInputTokens: 2e5
     },
     "o3-mini": {
       input: 1.1,
       output: 4.4,
+      cachedInput: 0.55,
       maxInputTokens: 2e5
     },
     "o3-mini-2025-01-31": {
       input: 1.1,
       output: 4.4,
+      cachedInput: 0.55,
       maxInputTokens: 2e5
     },
     "o3-pro": {
@@ -695,11 +821,13 @@ var prices_default = {
     "o4-mini": {
       input: 1.1,
       output: 4.4,
+      cachedInput: 0.275,
       maxInputTokens: 2e5
     },
     "o4-mini-2025-04-16": {
       input: 1.1,
       output: 4.4,
+      cachedInput: 0.275,
       maxInputTokens: 2e5
     },
     "deepseek-v3.2": {
@@ -720,6 +848,7 @@ var prices_default = {
     "deepseek-v3": {
       input: 0.27,
       output: 1.1,
+      cachedInput: 0.07,
       maxInputTokens: 65536
     },
     "deepseek-v3-0324": {
@@ -735,76 +864,105 @@ var prices_default = {
     "claude-haiku-4-5-20251001": {
       input: 1,
       output: 5,
+      cachedInput: 0.1,
+      cacheCreationInput: 1.25,
       maxInputTokens: 2e5
     },
     "claude-3-7-sonnet-20250219": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "claude-3-haiku-20240307": {
       input: 0.25,
       output: 1.25,
+      cachedInput: 0.03,
+      cacheCreationInput: 0.3,
       maxInputTokens: 2e5
     },
     "claude-3-opus-20240229": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-4-opus-20250514": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-4-sonnet-20250514": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     },
     "claude-sonnet-4-5-20250929": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "claude-sonnet-4-5-20250929-v1:0": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4-1-20250805": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4-20250514": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4-5-20251101": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 2e5
     },
     "claude-opus-4-6-20260205": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-opus-4-7-20260416": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-sonnet-4-20250514": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     },
     "codex-mini-latest": {
       input: 1.5,
       output: 6,
+      cachedInput: 0.375,
       maxInputTokens: 2e5
     },
     "deepseek-ai/deepseek-r1": {
@@ -854,6 +1012,7 @@ var prices_default = {
     "deepseek-ai/deepseek-v3.1-terminus": {
       input: 0.27,
       output: 1,
+      cachedInput: 0.216,
       maxInputTokens: 163840
     },
     "deepseek-coder": {
@@ -864,26 +1023,31 @@ var prices_default = {
     "gemini-2.0-flash": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.025,
       maxInputTokens: 1048576
     },
     "gemini-2.0-flash-001": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.025,
       maxInputTokens: 1048576
     },
     "gemini-2.0-flash-lite": {
       input: 0.075,
       output: 0.3,
+      cachedInput: 0.01875,
       maxInputTokens: 1048576
     },
     "gemini-2.0-flash-lite-001": {
       input: 0.075,
       output: 0.3,
+      cachedInput: 0.01875,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash-image": {
       input: 0.3,
       output: 2.5,
+      cachedInput: 0.03,
       maxInputTokens: 32768
     },
     "gemini-3-pro-image-preview": {
@@ -899,51 +1063,61 @@ var prices_default = {
     "gemini-3.1-flash-lite-preview": {
       input: 0.25,
       output: 1.5,
+      cachedInput: 0.025,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash-lite": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.01,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash-lite-preview-09-2025": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.01,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash-preview-09-2025": {
       input: 0.3,
       output: 2.5,
+      cachedInput: 0.075,
       maxInputTokens: 1048576
     },
     "gemini-live-2.5-flash-preview-native-audio-09-2025": {
       input: 0.3,
       output: 2,
+      cachedInput: 0.075,
       maxInputTokens: 1048576
     },
     "gemini-2.5-flash-lite-preview-06-17": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.025,
       maxInputTokens: 1048576
     },
     "gemini-3-pro-preview": {
       input: 2,
       output: 12,
+      cachedInput: 0.2,
       maxInputTokens: 1048576
     },
     "gemini-3.1-pro-preview": {
       input: 2,
       output: 12,
+      cachedInput: 0.2,
       maxInputTokens: 1048576
     },
     "gemini-3.1-pro-preview-customtools": {
       input: 2,
       output: 12,
+      cachedInput: 0.2,
       maxInputTokens: 1048576
     },
     "gemini-3-flash-preview": {
       input: 0.5,
       output: 3,
+      cachedInput: 0.05,
       maxInputTokens: 1048576
     },
     "gemini-robotics-er-1.5-preview": {
@@ -959,11 +1133,13 @@ var prices_default = {
     "gemini-flash-latest": {
       input: 0.3,
       output: 2.5,
+      cachedInput: 0.03,
       maxInputTokens: 1048576
     },
     "gemini-flash-lite-latest": {
       input: 0.1,
       output: 0.4,
+      cachedInput: 0.01,
       maxInputTokens: 1048576
     },
     "gemini-gemma-2-27b-it": {
@@ -1039,39 +1215,47 @@ var prices_default = {
     "gpt-4o-mini-realtime-preview": {
       input: 0.6,
       output: 2.4,
+      cachedInput: 0.3,
       maxInputTokens: 128e3
     },
     "gpt-4o-realtime-preview": {
       input: 5,
       output: 20,
+      cachedInput: 2.5,
       maxInputTokens: 128e3
     },
     "gpt-4o-realtime-preview-2025-06-03": {
       input: 5,
       output: 20,
+      cachedInput: 2.5,
       maxInputTokens: 128e3
     },
     "gpt-image-1.5": {
       input: 5,
-      output: 10
+      output: 10,
+      cachedInput: 1.25
     },
     "gpt-image-1.5-2025-12-16": {
       input: 5,
-      output: 10
+      output: 10,
+      cachedInput: 1.25
     },
     "gpt-5.1-chat-latest": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 128e3
     },
     "gpt-5.2-chat-latest": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 128e3
     },
     "gpt-5.3-chat-latest": {
       input: 1.75,
       output: 14,
+      cachedInput: 0.175,
       maxInputTokens: 128e3
     },
     "gpt-5-pro-2025-10-06": {
@@ -1082,11 +1266,13 @@ var prices_default = {
     "gpt-realtime": {
       input: 4,
       output: 16,
+      cachedInput: 0.4,
       maxInputTokens: 32e3
     },
     "gpt-realtime-1.5": {
       input: 4,
       output: 16,
+      cachedInput: 0.4,
       maxInputTokens: 32e3
     },
     "gpt-realtime-mini": {
@@ -1133,6 +1319,7 @@ var prices_default = {
     o1: {
       input: 15,
       output: 60,
+      cachedInput: 7.5,
       maxInputTokens: 2e5
     },
     "o1-pro": {
@@ -1148,6 +1335,7 @@ var prices_default = {
     o3: {
       input: 2,
       output: 8,
+      cachedInput: 0.5,
       maxInputTokens: 2e5
     },
     "gpt-oss-20b": {
@@ -1172,6 +1360,8 @@ var prices_default = {
     "claude-haiku-4-5@20251001": {
       input: 1,
       output: 5,
+      cachedInput: 0.1,
+      cacheCreationInput: 1.25,
       maxInputTokens: 2e5
     },
     "claude-3-5-sonnet": {
@@ -1187,6 +1377,8 @@ var prices_default = {
     "claude-3-7-sonnet@20250219": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "claude-3-haiku": {
@@ -1222,46 +1414,64 @@ var prices_default = {
     "claude-opus-4": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4-1@20250805": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4-5@20251101": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 2e5
     },
     "claude-opus-4-6@default": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-opus-4-7@default": {
       input: 5,
       output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
       maxInputTokens: 1e6
     },
     "claude-sonnet-4-5@20250929": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "claude-opus-4@20250514": {
       input: 15,
       output: 75,
+      cachedInput: 1.5,
+      cacheCreationInput: 18.75,
       maxInputTokens: 2e5
     },
     "claude-sonnet-4": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     },
     "claude-sonnet-4@20250514": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     },
     "deepseek-ai/deepseek-v3.1-maas": {
@@ -1311,6 +1521,7 @@ var prices_default = {
     "gpt-realtime-mini-2025-12-15": {
       input: 0.6,
       output: 2.4,
+      cachedInput: 0.06,
       maxInputTokens: 128e3
     },
     "gemini-2.5-flash-native-audio-latest": {
@@ -1336,16 +1547,20 @@ var prices_default = {
     "gemini-pro-latest": {
       input: 1.25,
       output: 10,
+      cachedInput: 0.125,
       maxInputTokens: 1048576
     },
     "gemini-exp-1206": {
       input: 0.3,
       output: 2.5,
+      cachedInput: 0.03,
       maxInputTokens: 1048576
     },
     "claude-sonnet-4-6@default": {
       input: 3,
       output: 15,
+      cachedInput: 0.3,
+      cacheCreationInput: 3.75,
       maxInputTokens: 1e6
     }
   }
@@ -1353,11 +1568,19 @@ var prices_default = {
 
 // src/core/tracker.ts
 var bundledPrices = prices_default.models;
+var bundledUpdatedAt = prices_default.updated_at ?? "";
 var ModelPriceSchema = z.object({
   input: z.number().nonnegative(),
   output: z.number().nonnegative(),
+  cachedInput: z.number().nonnegative().optional(),
+  cacheCreationInput: z.number().nonnegative().optional(),
   maxInputTokens: z.number().positive().optional()
 });
+var BudgetConfigSchema = z.object({
+  threshold: z.number().positive(),
+  webhookUrl: z.string().url(),
+  mode: z.enum(["once", "always"]).optional().default("once")
+});
 var TrackerConfigSchema = z.object({
   storage: z.union([z.enum(["memory", "sqlite"]), z.custom((v) => {
     return v !== null && typeof v === "object" && typeof v.record === "function" && typeof v.getAll === "function" && typeof v.clearAll === "function" && typeof v.clearSession === "function";
@@ -1365,7 +1588,13 @@ var TrackerConfigSchema = z.object({
   alertThreshold: z.number().positive().optional(),
   webhookUrl: z.string().url().optional(),
   syncPrices: z.boolean().optional().default(true),
-  customPrices: z.record(z.string(), ModelPriceSchema).optional()
+  customPrices: z.record(z.string(), ModelPriceSchema).optional(),
+  warnIfStaleAfterHours: z.number().nonnegative().optional().default(72),
+  budgets: z.object({
+    perUser: BudgetConfigSchema.optional(),
+    perSession: BudgetConfigSchema.optional()
+  }).optional(),
+  suggestions: z.boolean().optional().default(false)
 });
 function createTracker(config = {}) {
   const parsed = TrackerConfigSchema.safeParse(config);
@@ -1379,19 +1608,45 @@ ${issues}`);
     alertThreshold,
     webhookUrl,
     syncPrices,
-    customPrices
+    customPrices,
+    warnIfStaleAfterHours,
+    budgets,
+    suggestions
   } = parsed.data;
   const storage = typeof storageOption === "object" ? storageOption : createStorage(storageOption);
   let remotePrices;
+  let pricesUpdatedAt = bundledUpdatedAt;
   if (syncPrices) {
     getRemotePrices().then((result) => {
-      if (result) remotePrices = result;
+      if (result) {
+        remotePrices = result.models;
+        pricesUpdatedAt = result.updated_at;
+      }
     }).catch(() => {
     });
   }
+  let stalenessChecked = false;
+  function maybeWarnStaleness() {
+    if (stalenessChecked || !warnIfStaleAfterHours) return;
+    stalenessChecked = true;
+    if (!pricesUpdatedAt) return;
+    try {
+      const updatedMs = new Date(pricesUpdatedAt).getTime();
+      const ageHours = (Date.now() - updatedMs) / (1e3 * 60 * 60);
+      if (ageHours > warnIfStaleAfterHours) {
+        console.warn(
+          `[tokenwatch] Price data is ${Math.round(ageHours)}h old (updated_at: ${pricesUpdatedAt}). Run "tokenwatch sync" to refresh, or set warnIfStaleAfterHours: 0 to suppress.`
+        );
+      }
+    } catch {
+    }
+  }
   let alertFired = false;
+  const firedUserAlerts = /* @__PURE__ */ new Set();
+  const firedSessionAlerts = /* @__PURE__ */ new Set();
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   function resolveModelPrice(model) {
+    maybeWarnStaleness();
     return resolvePrice(model, {
       bundledPrices,
       ...customPrices !== void 0 && { customPrices },
@@ -1400,39 +1655,94 @@ ${issues}`);
   }
   function track(entry) {
     const price = resolveModelPrice(entry.model);
-    const costUSD = calculateCost(entry.inputTokens, entry.outputTokens, price);
+    const costUSD = calculateCost(
+      entry.inputTokens,
+      entry.outputTokens,
+      price,
+      entry.cachedTokens,
+      entry.cacheCreationTokens
+    );
     const full = {
       ...entry,
       costUSD,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
     storage.record(full);
-    maybeFireAlert();
+    maybeFireAlerts(full);
+    if (suggestions) {
+      maybeSuggestCheaperModel(entry.model, costUSD, entry.inputTokens, entry.outputTokens, {
+        bundledPrices,
+        ...customPrices !== void 0 && { customPrices },
+        ...remotePrices !== void 0 && { remotePrices }
+      });
+    }
   }
-  function maybeFireAlert() {
-    if (!alertThreshold || !webhookUrl || alertFired) return;
-    alertFired = true;
-    Promise.resolve(storage.getAll()).then((entries) => {
-      const total = computeTotal(entries);
-      if (total < alertThreshold) {
-        alertFired = false;
-        return;
-      }
-      const payload = {
-        text: `[tokenwatch] Alert: total cost reached $${total.toFixed(4)} USD (threshold: $${alertThreshold})`
-      };
-      fetch(webhookUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload)
+  function maybeFireAlerts(entry) {
+    if (alertThreshold && webhookUrl && !alertFired) {
+      alertFired = true;
+      Promise.resolve(storage.getAll()).then((entries) => {
+        const total = computeTotal(entries);
+        if (total < alertThreshold) {
+          alertFired = false;
+          return;
+        }
+        fireWebhook(webhookUrl, {
+          text: `[tokenwatch] Alert: total cost reached $${total.toFixed(4)} USD (threshold: $${alertThreshold})`
+        });
       }).catch(() => {
+        alertFired = false;
       });
+    }
+    if (budgets?.perUser && entry.userId) {
+      const cfg = budgets.perUser;
+      const uid = entry.userId;
+      if (cfg.mode === "always" || !firedUserAlerts.has(uid)) {
+        if (cfg.mode !== "always") firedUserAlerts.add(uid);
+        Promise.resolve(storage.getAll()).then((entries) => {
+          const userCost = entries.filter((e) => e.userId === uid).reduce((s, e) => s + e.costUSD, 0);
+          if (userCost >= cfg.threshold) {
+            fireWebhook(cfg.webhookUrl, {
+              text: `[tokenwatch] Budget alert: user "${uid}" reached $${userCost.toFixed(4)} USD (threshold: $${cfg.threshold})`
+            });
+          } else {
+            if (cfg.mode !== "always") firedUserAlerts.delete(uid);
+          }
+        }).catch(() => {
+          if (cfg.mode !== "always") firedUserAlerts.delete(uid);
+        });
+      }
+    }
+    if (budgets?.perSession && entry.sessionId) {
+      const cfg = budgets.perSession;
+      const sid = entry.sessionId;
+      if (cfg.mode === "always" || !firedSessionAlerts.has(sid)) {
+        if (cfg.mode !== "always") firedSessionAlerts.add(sid);
+        Promise.resolve(storage.getAll()).then((entries) => {
+          const sessionCost = entries.filter((e) => e.sessionId === sid).reduce((s, e) => s + e.costUSD, 0);
+          if (sessionCost >= cfg.threshold) {
+            fireWebhook(cfg.webhookUrl, {
+              text: `[tokenwatch] Budget alert: session "${sid}" reached $${sessionCost.toFixed(4)} USD (threshold: $${cfg.threshold})`
+            });
+          } else {
+            if (cfg.mode !== "always") firedSessionAlerts.delete(sid);
+          }
+        }).catch(() => {
+          if (cfg.mode !== "always") firedSessionAlerts.delete(sid);
+        });
+      }
+    }
+  }
+  function fireWebhook(url, payload) {
+    fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
     }).catch(() => {
-      alertFired = false;
     });
   }
-  async function getReport() {
-    const entries = await Promise.resolve(storage.getAll());
+  async function getReport(options) {
+    const allEntries = await Promise.resolve(storage.getAll());
+    const entries = filterEntries(allEntries, options);
     const byModel = {};
     const bySession = {};
     const byUser = {};
@@ -1440,18 +1750,24 @@ ${issues}`);
     let totalInput = 0;
     let totalOutput = 0;
     let totalCost = 0;
-    let lastTimestamp = startedAt;
+    let periodFrom = options ? entries[0]?.timestamp ?? startedAt : startedAt;
+    let lastTimestamp = periodFrom;
     for (const e of entries) {
-      totalInput += e.inputTokens;
+      totalInput += e.inputTokens + (e.cachedTokens ?? 0) + (e.cacheCreationTokens ?? 0);
       totalOutput += e.outputTokens;
       totalCost += e.costUSD;
       if (e.timestamp > lastTimestamp) lastTimestamp = e.timestamp;
-      const m = byModel[e.model] ??= { costUSD: 0, calls: 0, tokens: { input: 0, output: 0, reasoning: 0 } };
+      const m = byModel[e.model] ??= {
+        costUSD: 0,
+        calls: 0,
+        tokens: { input: 0, output: 0, reasoning: 0, cached: 0 }
+      };
       m.costUSD += e.costUSD;
       m.calls += 1;
-      m.tokens.input += e.inputTokens;
+      m.tokens.input += e.inputTokens + (e.cachedTokens ?? 0) + (e.cacheCreationTokens ?? 0);
       m.tokens.output += e.outputTokens;
       m.tokens.reasoning += e.reasoningTokens ?? 0;
+      m.tokens.cached += e.cachedTokens ?? 0;
       if (e.sessionId) {
         const s = bySession[e.sessionId] ??= { costUSD: 0, calls: 0 };
         s.costUSD += e.costUSD;
@@ -1468,6 +1784,9 @@ ${issues}`);
         f.calls += 1;
       }
     }
+    if (options && entries.length > 0) {
+      periodFrom = entries[0]?.timestamp ?? periodFrom;
+    }
     return {
       totalCostUSD: totalCost,
       totalTokens: { input: totalInput, output: totalOutput },
@@ -1475,22 +1794,66 @@ ${issues}`);
       bySession,
       byUser,
       byFeature,
-      period: { from: startedAt, to: lastTimestamp }
+      period: { from: periodFrom, to: lastTimestamp },
+      ...pricesUpdatedAt ? { pricesUpdatedAt } : {}
+    };
+  }
+  async function getCostForecast(options = {}) {
+    const windowHours = options.windowHours ?? 24;
+    const allEntries = await Promise.resolve(storage.getAll());
+    const now = Date.now();
+    const windowStart = now - windowHours * 60 * 60 * 1e3;
+    const windowEntries = allEntries.filter(
+      (e) => new Date(e.timestamp).getTime() >= windowStart
+    );
+    if (windowEntries.length < 2) {
+      return {
+        burnRatePerHour: 0,
+        projectedDailyCostUSD: 0,
+        projectedMonthlyCostUSD: 0,
+        basedOnHours: 0,
+        basedOnPeriod: null
+      };
+    }
+    const first = windowEntries[0]?.timestamp ?? "";
+    const last = windowEntries[windowEntries.length - 1]?.timestamp ?? "";
+    const actualMs = new Date(last).getTime() - new Date(first).getTime();
+    const actualHours = actualMs / (1e3 * 60 * 60);
+    if (actualHours < 1e-3) {
+      return {
+        burnRatePerHour: 0,
+        projectedDailyCostUSD: 0,
+        projectedMonthlyCostUSD: 0,
+        basedOnHours: 0,
+        basedOnPeriod: { from: first, to: last }
+      };
+    }
+    const totalCost = windowEntries.reduce((s, e) => s + e.costUSD, 0);
+    const burnRatePerHour = totalCost / actualHours;
+    return {
+      burnRatePerHour,
+      projectedDailyCostUSD: burnRatePerHour * 24,
+      projectedMonthlyCostUSD: burnRatePerHour * 24 * 30,
+      basedOnHours: Math.round(actualHours * 100) / 100,
+      basedOnPeriod: { from: first, to: last }
     };
   }
   async function reset() {
     await Promise.resolve(storage.clearAll());
     alertFired = false;
+    firedUserAlerts.clear();
+    firedSessionAlerts.clear();
   }
   async function resetSession(sessionId) {
     await Promise.resolve(storage.clearSession(sessionId));
+    firedSessionAlerts.delete(sessionId);
   }
   async function exportJSON() {
     return JSON.stringify(await getReport(), null, 2);
   }
   async function exportCSV() {
     const entries = await Promise.resolve(storage.getAll());
-    const header = "timestamp,model,inputTokens,outputTokens,reasoningTokens,costUSD,sessionId,userId,feature";
+    const header = "timestamp,model,inputTokens,outputTokens,reasoningTokens,cachedTokens,cacheCreationTokens,costUSD,sessionId,userId,feature";
     const rows = entries.map(
       (e) => [
         csvEscape(e.timestamp),
@@ -1498,6 +1861,8 @@ ${issues}`);
         e.inputTokens,
         e.outputTokens,
         e.reasoningTokens ?? 0,
+        e.cachedTokens ?? 0,
+        e.cacheCreationTokens ?? 0,
         e.costUSD.toFixed(8),
         csvEscape(e.sessionId ?? ""),
         csvEscape(e.userId ?? ""),
@@ -1513,11 +1878,47 @@ ${issues}`);
       ...remotePrices !== void 0 && { remotePrices }
     }) ?? null;
   }
-  return { track, getReport, reset, resetSession, exportJSON, exportCSV, getModelInfo };
+  return {
+    track,
+    getReport,
+    getCostForecast,
+    reset,
+    resetSession,
+    exportJSON,
+    exportCSV,
+    getModelInfo
+  };
 }
 function computeTotal(entries) {
   return entries.reduce((sum, e) => sum + e.costUSD, 0);
 }
+function parseLastMs(last) {
+  const match = /^(\d+(?:\.\d+)?)(h|d)$/.exec(last.trim());
+  if (!match) throw new Error(`[tokenwatch] Invalid "last" value: "${last}". Use e.g. "24h", "7d".`);
+  const value = parseFloat(match[1] ?? "0");
+  const unit = match[2] ?? "h";
+  return unit === "h" ? value * 60 * 60 * 1e3 : value * 24 * 60 * 60 * 1e3;
+}
+function filterEntries(entries, options) {
+  if (!options) return entries;
+  let sinceMs;
+  let untilMs;
+  if (options.last) {
+    sinceMs = Date.now() - parseLastMs(options.last);
+  } else if (options.since) {
+    sinceMs = new Date(options.since).getTime();
+  }
+  if (options.until) {
+    untilMs = new Date(options.until).getTime();
+  }
+  if (sinceMs === void 0 && untilMs === void 0) return entries;
+  return entries.filter((e) => {
+    const ts = new Date(e.timestamp).getTime();
+    if (sinceMs !== void 0 && ts < sinceMs) return false;
+    if (untilMs !== void 0 && ts > untilMs) return false;
+    return true;
+  });
+}
 function csvEscape(value) {
   if (value.includes(",") || value.includes('"') || value.includes("\n")) {
     return `"${value.replace(/"/g, '""')}"`;
@@ -1538,7 +1939,7 @@ async function cmdSync() {
   console.log("Fetching latest prices from remote...");
   const result = await fetchRemotePrices();
   if (result) {
-    console.log(`\u2713 Prices updated. ${Object.keys(result).length} models cached.`);
+    console.log(`\u2713 Prices updated. ${Object.keys(result.models).length} models cached (updated_at: ${result.updated_at}).`);
   } else {
     console.error("\u2717 Failed to fetch remote prices. Check your internet connection.");
     process.exit(1);
@@ -1584,6 +1985,9 @@ async function cmdReport() {
   console.log(`  Total cost:   $${report.totalCostUSD.toFixed(6)} USD`);
   console.log(`  Total tokens: ${report.totalTokens.input.toLocaleString()} in / ${report.totalTokens.output.toLocaleString()} out`);
   console.log(`  Period:       ${report.period.from}  \u2192  ${report.period.to}`);
+  if (report.pricesUpdatedAt) {
+    console.log(`  Prices as of: ${report.pricesUpdatedAt}`);
+  }
   if (Object.keys(report.byModel).length > 0) {
     console.log("\n  By model:");
     for (const [model, stats] of Object.entries(report.byModel)) {