@diogonzafe/tokenwatch 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-CJKk1hHw.cjs';
-export { B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IStorage, M as ModelPrice, d as ModelStats, P as PriceMap, e as PricesFile, R as Report, f as ReportOptions, S as SessionStats, U as UsageEntry, g as UserStats } from './index-CJKk1hHw.cjs';
+import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-D9xq0RNg.cjs';
+export { A as AnomalyDetectionConfig, B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IExporter, d as IStorage, M as ModelPrice, e as ModelStats, P as PriceMap, f as PricesFile, R as Report, g as ReportOptions, S as SessionStats, U as UsageEntry, h as UserStats } from './index-D9xq0RNg.cjs';
 
 declare function createTracker(config?: TrackerConfig): Tracker;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-CJKk1hHw.js';
-export { B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IStorage, M as ModelPrice, d as ModelStats, P as PriceMap, e as PricesFile, R as Report, f as ReportOptions, S as SessionStats, U as UsageEntry, g as UserStats } from './index-CJKk1hHw.js';
+import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-D9xq0RNg.js';
+export { A as AnomalyDetectionConfig, B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IExporter, d as IStorage, M as ModelPrice, e as ModelStats, P as PriceMap, f as PricesFile, R as Report, g as ReportOptions, S as SessionStats, U as UsageEntry, h as UserStats } from './index-D9xq0RNg.js';
 
 declare function createTracker(config?: TrackerConfig): Tracker;
 

package/dist/index.js

@@ -237,7 +237,7 @@ async function getRemotePrices() {
 
 // prices.json
 var prices_default = {
-  updated_at: "2026-04-22",
+  updated_at: "2026-04-23",
   source: "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json",
   models: {
     "gpt-4o": {
@@ -1586,7 +1586,14 @@ var TrackerConfigSchema = z.object({
     perUser: BudgetConfigSchema.optional(),
     perSession: BudgetConfigSchema.optional()
   }).optional(),
-  suggestions: z.boolean().optional().default(false)
+  suggestions: z.boolean().optional().default(false),
+  anomalyDetection: z.object({
+    multiplierThreshold: z.number().positive(),
+    webhookUrl: z.string().url(),
+    windowHours: z.number().positive().optional().default(24),
+    mode: z.enum(["once", "always"]).optional().default("once")
+  }).optional(),
+  exporter: z.custom((v) => v !== null && typeof v === "object" && typeof v.export === "function").optional()
 });
 function createTracker(config = {}) {
   const parsed = TrackerConfigSchema.safeParse(config);
@@ -1603,7 +1610,9 @@ ${issues}`);
     customPrices,
     warnIfStaleAfterHours,
     budgets,
-    suggestions
+    suggestions,
+    anomalyDetection,
+    exporter
   } = parsed.data;
   const storage = typeof storageOption === "object" ? storageOption : createStorage(storageOption);
   let remotePrices;
@@ -1636,6 +1645,7 @@ ${issues}`);
   let alertFired = false;
   const firedUserAlerts = /* @__PURE__ */ new Set();
   const firedSessionAlerts = /* @__PURE__ */ new Set();
+  const firedAnomalyKeys = /* @__PURE__ */ new Set();
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   function resolveModelPrice(model) {
     maybeWarnStaleness();
@@ -1660,7 +1670,12 @@ ${issues}`);
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
     storage.record(full);
+    if (exporter) {
+      Promise.resolve(exporter.export(full)).catch(() => {
+      });
+    }
     maybeFireAlerts(full);
+    if (anomalyDetection) maybeDetectAnomaly(full);
     if (suggestions) {
       maybeSuggestCheaperModel(entry.model, costUSD, entry.inputTokens, entry.outputTokens, {
         bundledPrices,
@@ -1830,11 +1845,56 @@ ${issues}`);
       basedOnPeriod: { from: first, to: last }
     };
   }
+  function maybeDetectAnomaly(entry) {
+    if (entry.costUSD <= 0) return;
+    const { multiplierThreshold, webhookUrl: aUrl, windowHours: wh, mode: modeRaw } = anomalyDetection;
+    const wHours = wh ?? 24;
+    const mode = modeRaw ?? "once";
+    const windowStart = Date.now() - wHours * 60 * 60 * 1e3;
+    const entryTs = new Date(entry.timestamp).getTime();
+    function checkEntity(key, label, predicate) {
+      if (mode !== "always" && firedAnomalyKeys.has(key)) return;
+      if (mode !== "always") firedAnomalyKeys.add(key);
+      Promise.resolve(storage.getAll()).then((all) => {
+        const history = all.filter(
+          (e) => predicate(e) && new Date(e.timestamp).getTime() >= windowStart && new Date(e.timestamp).getTime() !== entryTs
+        );
+        if (history.length === 0) {
+          if (mode !== "always") firedAnomalyKeys.delete(key);
+          return;
+        }
+        const avg = history.reduce((s, e) => s + e.costUSD, 0) / history.length;
+        if (avg <= 0 || entry.costUSD <= avg * multiplierThreshold) {
+          if (mode !== "always") firedAnomalyKeys.delete(key);
+          return;
+        }
+        const multiple = (entry.costUSD / avg).toFixed(1);
+        fireWebhook(aUrl, {
+          text: `[tokenwatch] Anomaly: ${label} call cost $${entry.costUSD.toFixed(4)} is ${multiple}x above ${wHours}h average ($${avg.toFixed(4)})`
+        });
+      }).catch(() => {
+        if (mode !== "always") firedAnomalyKeys.delete(key);
+      });
+    }
+    if (entry.userId) {
+      checkEntity(
+        `user:${entry.userId}`,
+        `user "${entry.userId}"`,
+        (e) => e.userId === entry.userId
+      );
+    }
+    checkEntity(
+      `model:${entry.model}`,
+      `model "${entry.model}"`,
+      (e) => e.model === entry.model
+    );
+  }
   async function reset() {
     await Promise.resolve(storage.clearAll());
     alertFired = false;
     firedUserAlerts.clear();
     firedSessionAlerts.clear();
+    firedAnomalyKeys.clear();
   }
   async function resetSession(sessionId) {
     await Promise.resolve(storage.clearSession(sessionId));