@ai-sdk/provider 3.0.0-beta.25 → 3.0.0-beta.26

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/provider
 
+## 3.0.0-beta.26
+
+### Patch Changes
+
+- 3bd2689: feat: extended token usage
+
 ## 3.0.0-beta.25
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1603,34 +1603,54 @@ interface LanguageModelV3ResponseMetadata {
 }
 
 /**
-Usage information for a language model call.
-
-If your API return additional usage information, you can add it to the
-provider metadata under your provider's key.
+ * Usage information for a language model call.
  */
 type LanguageModelV3Usage = {
     /**
-  The number of input (prompt) tokens used.
-     */
-    inputTokens: number | undefined;
-    /**
-  The number of output (completion) tokens used.
+     * Information about the input tokens.
      */
-    outputTokens: number | undefined;
-    /**
-  The total number of tokens as reported by the provider.
-  This number might be different from the sum of `inputTokens` and `outputTokens`
-  and e.g. include reasoning tokens or other overhead.
-     */
-    totalTokens: number | undefined;
+    inputTokens: {
+        /**
+         *The total number of input (prompt) tokens used.
+         */
+        total: number | undefined;
+        /**
+         * The number of non-cached input (prompt) tokens used.
+         */
+        noCache: number | undefined;
+        /**
+         * The number of cached input (prompt) tokens read.
+         */
+        cacheRead: number | undefined;
+        /**
+         * The number of cached input (prompt) tokens written.
+         */
+        cacheWrite: number | undefined;
+    };
     /**
-  The number of reasoning tokens used.
+     * Information about the output tokens.
      */
-    reasoningTokens?: number | undefined;
+    outputTokens: {
+        /**
+         * The total number of output (completion) tokens used.
+         */
+        total: number | undefined;
+        /**
+         * The number of text tokens used.
+         */
+        text: number | undefined;
+        /**
+         * The number of reasoning tokens used.
+         */
+        reasoning: number | undefined;
+    };
     /**
-  The number of cached input tokens.
+     * Raw usage information from the provider.
+     *
+     * This is the usage information in the shape that the provider returns.
+     * It can include additional information that is not part of the standard usage information.
      */
-    cachedInputTokens?: number | undefined;
+    raw?: JSONObject;
 };
 
 type LanguageModelV3StreamPart = {

package/dist/index.d.ts

@@ -1603,34 +1603,54 @@ interface LanguageModelV3ResponseMetadata {
 }
 
 /**
-Usage information for a language model call.
-
-If your API return additional usage information, you can add it to the
-provider metadata under your provider's key.
+ * Usage information for a language model call.
  */
 type LanguageModelV3Usage = {
     /**
-  The number of input (prompt) tokens used.
-     */
-    inputTokens: number | undefined;
-    /**
-  The number of output (completion) tokens used.
+     * Information about the input tokens.
      */
-    outputTokens: number | undefined;
-    /**
-  The total number of tokens as reported by the provider.
-  This number might be different from the sum of `inputTokens` and `outputTokens`
-  and e.g. include reasoning tokens or other overhead.
-     */
-    totalTokens: number | undefined;
+    inputTokens: {
+        /**
+         *The total number of input (prompt) tokens used.
+         */
+        total: number | undefined;
+        /**
+         * The number of non-cached input (prompt) tokens used.
+         */
+        noCache: number | undefined;
+        /**
+         * The number of cached input (prompt) tokens read.
+         */
+        cacheRead: number | undefined;
+        /**
+         * The number of cached input (prompt) tokens written.
+         */
+        cacheWrite: number | undefined;
+    };
     /**
-  The number of reasoning tokens used.
+     * Information about the output tokens.
      */
-    reasoningTokens?: number | undefined;
+    outputTokens: {
+        /**
+         * The total number of output (completion) tokens used.
+         */
+        total: number | undefined;
+        /**
+         * The number of text tokens used.
+         */
+        text: number | undefined;
+        /**
+         * The number of reasoning tokens used.
+         */
+        reasoning: number | undefined;
+    };
     /**
-  The number of cached input tokens.
+     * Raw usage information from the provider.
+     *
+     * This is the usage information in the shape that the provider returns.
+     * It can include additional information that is not part of the standard usage information.
      */
-    cachedInputTokens?: number | undefined;
+    raw?: JSONObject;
 };
 
 type LanguageModelV3StreamPart = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider",
-  "version": "3.0.0-beta.25",
+  "version": "3.0.0-beta.26",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",