ai-sdk-cost-calculator 0.1.21 → 0.1.22

package/dist/core/calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/core/calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,SAAS,CAAC;AAMjB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qDAAqD;IACrD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AA0DD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAkL1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAErE;AAwCD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAaR"}
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/core/calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,SAAS,CAAC;AAMjB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qDAAqD;IACrD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AA0DD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAsL1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAErE;AAwCD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAaR"}

package/dist/core/calculator.js

@@ -134,6 +134,10 @@ export function calculateCost(options) {
         imageGenerationCost,
         additionalCost: 0,
     };
+    // Defensive: clamp every cost component to ≥0. Negative costs are never
+    // valid — they only arise from upstream data anomalies (e.g., AI SDK
+    // providers occasionally emit negative noCacheTokens when cache size
+    // exceeds prompt size). Clamping here guarantees the breakdown contract.
     let totalCost = 0;
     const breakdown = {
         currency: "USD",
@@ -141,9 +145,9 @@ export function calculateCost(options) {
         totalCost: 0,
     };
     for (const field of COST_COMPONENT_FIELDS) {
-        const rounded = roundToMicroDollars(components[field]);
-        breakdown[field] = rounded;
-        totalCost += components[field];
+        const value = components[field] > 0 ? components[field] : 0;
+        breakdown[field] = roundToMicroDollars(value);
+        totalCost += value;
     }
     breakdown.totalCost = roundToMicroDollars(totalCost);
     return breakdown;

package/dist/index.js

@@ -1536,32 +1536,38 @@ function totalsToUsage(totals) {
     }
   };
 }
+var nonNegative = (n) => n > 0 ? n : 0;
 function getUsageTokenDetails(usage) {
   const inputDetails = usage.inputTokenDetails;
   const outputDetails = usage.outputTokenDetails;
-  const cacheReadTokens = inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0;
-  const cacheWriteTokens = inputDetails?.cacheWriteTokens ?? 0;
+  const cacheReadTokens = nonNegative(
+    inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0
+  );
+  const cacheWriteTokens = nonNegative(inputDetails?.cacheWriteTokens ?? 0);
   let noCacheTokens;
   if (inputDetails?.noCacheTokens !== void 0) {
-    noCacheTokens = inputDetails.noCacheTokens;
+    noCacheTokens = nonNegative(inputDetails.noCacheTokens);
   } else if (usage.inputTokens !== void 0) {
-    noCacheTokens = Math.max(
-      0,
+    noCacheTokens = nonNegative(
       usage.inputTokens - cacheReadTokens - cacheWriteTokens
     );
   } else {
     noCacheTokens = 0;
   }
-  const reasoningTokens = outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0;
+  const reasoningTokens = nonNegative(
+    outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0
+  );
   let textTokens;
   if (outputDetails?.textTokens !== void 0) {
-    textTokens = outputDetails.textTokens;
+    textTokens = nonNegative(outputDetails.textTokens);
   } else if (usage.outputTokens !== void 0) {
-    textTokens = Math.max(0, usage.outputTokens - reasoningTokens);
+    textTokens = nonNegative(usage.outputTokens - reasoningTokens);
   } else {
     textTokens = 0;
   }
-  const totalInputTokens = usage.inputTokens ?? noCacheTokens + cacheReadTokens + cacheWriteTokens;
+  const componentSum = noCacheTokens + cacheReadTokens + cacheWriteTokens;
+  const reportedInput = usage.inputTokens ?? 0;
+  const totalInputTokens = Math.max(reportedInput, componentSum);
   return {
     noCacheTokens,
     cacheReadTokens,
@@ -1724,9 +1730,9 @@ function calculateCost(options) {
     totalCost: 0
   };
   for (const field of COST_COMPONENT_FIELDS) {
-    const rounded = roundToMicroDollars(components[field]);
-    breakdown[field] = rounded;
-    totalCost += components[field];
+    const value = components[field] > 0 ? components[field] : 0;
+    breakdown[field] = roundToMicroDollars(value);
+    totalCost += value;
   }
   breakdown.totalCost = roundToMicroDollars(totalCost);
   return breakdown;

package/dist/index.mjs

@@ -1484,32 +1484,38 @@ function totalsToUsage(totals) {
     }
   };
 }
+var nonNegative = (n) => n > 0 ? n : 0;
 function getUsageTokenDetails(usage) {
   const inputDetails = usage.inputTokenDetails;
   const outputDetails = usage.outputTokenDetails;
-  const cacheReadTokens = inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0;
-  const cacheWriteTokens = inputDetails?.cacheWriteTokens ?? 0;
+  const cacheReadTokens = nonNegative(
+    inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0
+  );
+  const cacheWriteTokens = nonNegative(inputDetails?.cacheWriteTokens ?? 0);
   let noCacheTokens;
   if (inputDetails?.noCacheTokens !== void 0) {
-    noCacheTokens = inputDetails.noCacheTokens;
+    noCacheTokens = nonNegative(inputDetails.noCacheTokens);
   } else if (usage.inputTokens !== void 0) {
-    noCacheTokens = Math.max(
-      0,
+    noCacheTokens = nonNegative(
       usage.inputTokens - cacheReadTokens - cacheWriteTokens
     );
   } else {
     noCacheTokens = 0;
   }
-  const reasoningTokens = outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0;
+  const reasoningTokens = nonNegative(
+    outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0
+  );
   let textTokens;
   if (outputDetails?.textTokens !== void 0) {
-    textTokens = outputDetails.textTokens;
+    textTokens = nonNegative(outputDetails.textTokens);
   } else if (usage.outputTokens !== void 0) {
-    textTokens = Math.max(0, usage.outputTokens - reasoningTokens);
+    textTokens = nonNegative(usage.outputTokens - reasoningTokens);
   } else {
     textTokens = 0;
   }
-  const totalInputTokens = usage.inputTokens ?? noCacheTokens + cacheReadTokens + cacheWriteTokens;
+  const componentSum = noCacheTokens + cacheReadTokens + cacheWriteTokens;
+  const reportedInput = usage.inputTokens ?? 0;
+  const totalInputTokens = Math.max(reportedInput, componentSum);
   return {
     noCacheTokens,
     cacheReadTokens,
@@ -1672,9 +1678,9 @@ function calculateCost(options) {
     totalCost: 0
   };
   for (const field of COST_COMPONENT_FIELDS) {
-    const rounded = roundToMicroDollars(components[field]);
-    breakdown[field] = rounded;
-    totalCost += components[field];
+    const value = components[field] > 0 ? components[field] : 0;
+    breakdown[field] = roundToMicroDollars(value);
+    totalCost += value;
   }
   breakdown.totalCost = roundToMicroDollars(totalCost);
   return breakdown;

package/dist/shared/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAQzD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAON;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAmB1E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GACxB,iBAAiB,CAkDnB"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAQzD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAON;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAmB1E;AASD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GACxB,iBAAiB,CAwDnB"}

package/dist/shared/usage.js

@@ -33,40 +33,52 @@ export function totalsToUsage(totals) {
         },
     };
 }
+/** Clamp negative token counts to 0. Some AI SDK providers (notably Google
+ * with context caching) can report `noCacheTokens` as negative when
+ * cachedContentTokenCount exceeds promptTokenCount (the cache blob is
+ * larger than what the prompt actually consumed). Negative tokens produce
+ * negative costs, which is never correct. */
+const nonNegative = (n) => (n > 0 ? n : 0);
 export function getUsageTokenDetails(usage) {
     const inputDetails = usage.inputTokenDetails;
     const outputDetails = usage.outputTokenDetails;
     // Cache read: prefer details, fall back to deprecated top-level cachedInputTokens
-    const cacheReadTokens = inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0;
-    const cacheWriteTokens = inputDetails?.cacheWriteTokens ?? 0;
+    const cacheReadTokens = nonNegative(inputDetails?.cacheReadTokens ?? usage.cachedInputTokens ?? 0);
+    const cacheWriteTokens = nonNegative(inputDetails?.cacheWriteTokens ?? 0);
     // noCacheTokens: prefer details. If details exist but noCacheTokens is
     // undefined (some providers populate only cacheRead), derive from
     // inputTokens - cacheRead - cacheWrite. If no details at all, use inputTokens.
+    // Always clamp ≥0: providers can report negatives when cache > prompt.
     let noCacheTokens;
     if (inputDetails?.noCacheTokens !== undefined) {
-        noCacheTokens = inputDetails.noCacheTokens;
+        noCacheTokens = nonNegative(inputDetails.noCacheTokens);
     }
     else if (usage.inputTokens !== undefined) {
-        noCacheTokens = Math.max(0, usage.inputTokens - cacheReadTokens - cacheWriteTokens);
+        noCacheTokens = nonNegative(usage.inputTokens - cacheReadTokens - cacheWriteTokens);
     }
     else {
         noCacheTokens = 0;
     }
     // reasoningTokens: prefer details, fall back to deprecated top-level
-    const reasoningTokens = outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0;
+    const reasoningTokens = nonNegative(outputDetails?.reasoningTokens ?? usage.reasoningTokens ?? 0);
     // textTokens: prefer details. If details exist but textTokens is undefined,
     // derive from outputTokens - reasoningTokens. If no details, use outputTokens.
     let textTokens;
     if (outputDetails?.textTokens !== undefined) {
-        textTokens = outputDetails.textTokens;
+        textTokens = nonNegative(outputDetails.textTokens);
     }
     else if (usage.outputTokens !== undefined) {
-        textTokens = Math.max(0, usage.outputTokens - reasoningTokens);
+        textTokens = nonNegative(usage.outputTokens - reasoningTokens);
     }
     else {
         textTokens = 0;
     }
-    const totalInputTokens = usage.inputTokens ?? noCacheTokens + cacheReadTokens + cacheWriteTokens;
+    // Total input for long-context threshold check. Use the larger of:
+    // - reported inputTokens
+    // - sum of components (in case inputTokens is stale or undercounts)
+    const componentSum = noCacheTokens + cacheReadTokens + cacheWriteTokens;
+    const reportedInput = usage.inputTokens ?? 0;
+    const totalInputTokens = Math.max(reportedInput, componentSum);
     return {
         noCacheTokens,
         cacheReadTokens,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-cost-calculator",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Cost calculator for Vercel AI SDK token usage. Supports OpenAI, Anthropic, Google, xAI (Grok), and DeepSeek with long context pricing, prompt caching, and reasoning tokens.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",