@openrouter/ai-sdk-provider 2.10.0 → 3.0.0

package/README.md

@@ -2,7 +2,9 @@
 
 The [OpenRouter](https://openrouter.ai/) provider for the [Vercel AI SDK](https://sdk.vercel.ai/docs) gives access to over 300 large language models on the OpenRouter chat and completion APIs.
 
-## Setup for AI SDK v6
+## Setup for AI SDK v7
+
+This release line supports `ai@^7.0.0`, requires Node.js 22 or newer, and is ESM-only.
 
 ```bash
 # For pnpm
@@ -15,6 +17,19 @@ npm install @openrouter/ai-sdk-provider
 yarn add @openrouter/ai-sdk-provider
 ```
 
+## (LEGACY) Setup for AI SDK v6
+
+```bash
+# For pnpm
+pnpm add @openrouter/ai-sdk-provider@2.9.1
+
+# For npm
+npm install @openrouter/ai-sdk-provider@2.9.1
+
+# For yarn
+yarn add @openrouter/ai-sdk-provider@2.9.1
+```
+
 ## (LEGACY) Setup for AI SDK v5
 
 ```bash
@@ -383,6 +398,11 @@ const result = await generateText({
   prompt: 'Hello, how are you today?',
 });
 
+// AI SDK v7 standard usage details
+console.log('Input tokens:', result.usage.inputTokens);
+console.log('Cached input tokens:', result.usage.inputTokenDetails.cacheReadTokens);
+console.log('Reasoning tokens:', result.usage.outputTokenDetails.reasoningTokens);
+
 // Provider-specific usage details (available in providerMetadata)
 if (result.providerMetadata?.openrouter?.usage) {
   console.log('Cost:', result.providerMetadata.openrouter.usage.cost);
@@ -411,6 +431,10 @@ const result = await generateText({
   prompt: 'Hello, how are you today?',
 });
 
+console.log('Input tokens:', result.usage.inputTokens);
+console.log('Cached input tokens:', result.usage.inputTokenDetails.cacheReadTokens);
+console.log('Reasoning tokens:', result.usage.outputTokenDetails.reasoningTokens);
+
 // Provider-specific BYOK usage details (available in providerMetadata)
 if (result.providerMetadata?.openrouter?.usage) {
   const costDetails = result.providerMetadata.openrouter.usage.costDetails;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3Content, LanguageModelV3FinishReason, LanguageModelV3Usage, SharedV3Warning, LanguageModelV3ResponseMetadata, SharedV3Headers, LanguageModelV3StreamPart, EmbeddingModelV3, SharedV3ProviderMetadata, ImageModelV3, ImageModelV3CallOptions, ImageModelV3ProviderMetadata, ImageModelV3Usage, Experimental_VideoModelV3, Experimental_VideoModelV3CallOptions, Experimental_VideoModelV3VideoData, ProviderV3 } from '@ai-sdk/provider';
-export { LanguageModelV3, LanguageModelV3Prompt } from '@ai-sdk/provider';
-import { ProviderToolFactory } from '@ai-sdk/provider-utils';
+import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4Content, LanguageModelV4FinishReason, LanguageModelV4Usage, SharedV4Warning, LanguageModelV4ResponseMetadata, SharedV4Headers, LanguageModelV4StreamPart, EmbeddingModelV4, SharedV4ProviderMetadata, ImageModelV4, ImageModelV4CallOptions, ImageModelV4ProviderMetadata, ImageModelV4Usage, Experimental_VideoModelV4, Experimental_VideoModelV4CallOptions, Experimental_VideoModelV4VideoData, ProviderV4 } from '@ai-sdk/provider';
+export { LanguageModelV4, LanguageModelV4Prompt } from '@ai-sdk/provider';
+import { ProviderDefinedToolFactory } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 /**
@@ -552,8 +552,8 @@ type OpenRouterChatConfig = {
     fetch?: typeof fetch;
     extraBody?: Record<string, unknown>;
 };
-declare class OpenRouterChatLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
+declare class OpenRouterChatLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider = "openrouter";
     readonly defaultObjectGenerationMode: "tool";
     readonly modelId: OpenRouterChatModelId;
@@ -563,11 +563,11 @@ declare class OpenRouterChatLanguageModel implements LanguageModelV3 {
     private readonly config;
     constructor(modelId: OpenRouterChatModelId, settings: OpenRouterChatSettings, config: OpenRouterChatConfig);
     private getArgs;
-    doGenerate(options: LanguageModelV3CallOptions): Promise<{
-        content: Array<LanguageModelV3Content>;
-        finishReason: LanguageModelV3FinishReason;
-        usage: LanguageModelV3Usage;
-        warnings: Array<SharedV3Warning>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<{
+        content: Array<LanguageModelV4Content>;
+        finishReason: LanguageModelV4FinishReason;
+        usage: LanguageModelV4Usage;
+        warnings: Array<SharedV4Warning>;
         providerMetadata?: {
             openrouter: {
                 provider: string;
@@ -578,19 +578,19 @@ declare class OpenRouterChatLanguageModel implements LanguageModelV3 {
         request?: {
             body?: unknown;
         };
-        response?: LanguageModelV3ResponseMetadata & {
-            headers?: SharedV3Headers;
+        response?: LanguageModelV4ResponseMetadata & {
+            headers?: SharedV4Headers;
             body?: unknown;
         };
     }>;
-    doStream(options: LanguageModelV3CallOptions): Promise<{
-        stream: ReadableStream<LanguageModelV3StreamPart>;
-        warnings: Array<SharedV3Warning>;
+    doStream(options: LanguageModelV4CallOptions): Promise<{
+        stream: ReadableStream<LanguageModelV4StreamPart>;
+        warnings: Array<SharedV4Warning>;
         request?: {
             body?: unknown;
         };
-        response?: LanguageModelV3ResponseMetadata & {
-            headers?: SharedV3Headers;
+        response?: LanguageModelV4ResponseMetadata & {
+            headers?: SharedV4Headers;
             body?: unknown;
         };
     }>;
@@ -607,8 +607,8 @@ type OpenRouterCompletionConfig = {
     fetch?: typeof fetch;
     extraBody?: Record<string, unknown>;
 };
-declare class OpenRouterCompletionLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
+declare class OpenRouterCompletionLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider = "openrouter";
     readonly modelId: OpenRouterCompletionModelId;
     readonly supportsImageUrls = true;
@@ -618,8 +618,8 @@ declare class OpenRouterCompletionLanguageModel implements LanguageModelV3 {
     private readonly config;
     constructor(modelId: OpenRouterCompletionModelId, settings: OpenRouterCompletionSettings, config: OpenRouterCompletionConfig);
     private getArgs;
-    doGenerate(options: LanguageModelV3CallOptions): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>;
-    doStream(options: LanguageModelV3CallOptions): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<Awaited<ReturnType<LanguageModelV4['doGenerate']>>>;
+    doStream(options: LanguageModelV4CallOptions): Promise<Awaited<ReturnType<LanguageModelV4['doStream']>>>;
 }
 
 type OpenRouterEmbeddingConfig = {
@@ -632,8 +632,8 @@ type OpenRouterEmbeddingConfig = {
     fetch?: typeof fetch;
     extraBody?: Record<string, unknown>;
 };
-declare class OpenRouterEmbeddingModel implements EmbeddingModelV3 {
-    readonly specificationVersion: "v3";
+declare class OpenRouterEmbeddingModel implements EmbeddingModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider = "openrouter";
     readonly modelId: OpenRouterEmbeddingModelId;
     readonly settings: OpenRouterEmbeddingSettings;
@@ -650,12 +650,12 @@ declare class OpenRouterEmbeddingModel implements EmbeddingModelV3 {
         usage?: {
             tokens: number;
         };
-        providerMetadata?: SharedV3ProviderMetadata;
+        providerMetadata?: SharedV4ProviderMetadata;
         response?: {
-            headers?: SharedV3Headers;
+            headers?: SharedV4Headers;
             body?: unknown;
         };
-        warnings: Array<_ai_sdk_provider.SharedV3Warning>;
+        warnings: Array<_ai_sdk_provider.SharedV4Warning>;
     }>;
 }
 
@@ -669,24 +669,24 @@ type OpenRouterImageConfig = {
     fetch?: typeof fetch;
     extraBody?: Record<string, unknown>;
 };
-declare class OpenRouterImageModel implements ImageModelV3 {
-    readonly specificationVersion: "v3";
+declare class OpenRouterImageModel implements ImageModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider = "openrouter";
     readonly modelId: OpenRouterImageModelId;
     readonly settings: OpenRouterImageSettings;
     readonly maxImagesPerCall = 10;
     private readonly config;
     constructor(modelId: OpenRouterImageModelId, settings: OpenRouterImageSettings, config: OpenRouterImageConfig);
-    doGenerate(options: ImageModelV3CallOptions): Promise<{
+    doGenerate(options: ImageModelV4CallOptions): Promise<{
         images: Array<string>;
-        warnings: Array<SharedV3Warning>;
-        providerMetadata?: ImageModelV3ProviderMetadata;
+        warnings: Array<SharedV4Warning>;
+        providerMetadata?: ImageModelV4ProviderMetadata;
         response: {
             timestamp: Date;
             modelId: string;
             headers: Record<string, string> | undefined;
         };
-        usage?: ImageModelV3Usage;
+        usage?: ImageModelV4Usage;
     }>;
 }
 
@@ -700,18 +700,18 @@ type OpenRouterVideoConfig = {
     fetch?: typeof fetch;
     extraBody?: Record<string, unknown>;
 };
-declare class OpenRouterVideoModel implements Experimental_VideoModelV3 {
-    readonly specificationVersion = "v3";
+declare class OpenRouterVideoModel implements Experimental_VideoModelV4 {
+    readonly specificationVersion = "v4";
     readonly provider = "openrouter";
     readonly modelId: OpenRouterVideoModelId;
     readonly settings: OpenRouterVideoSettings;
     readonly maxVideosPerCall = 1;
     private readonly config;
     constructor(modelId: OpenRouterVideoModelId, settings: OpenRouterVideoSettings, config: OpenRouterVideoConfig);
-    doGenerate(options: Experimental_VideoModelV3CallOptions): Promise<{
-        videos: Array<Experimental_VideoModelV3VideoData>;
-        warnings: Array<SharedV3Warning>;
-        providerMetadata?: SharedV3ProviderMetadata;
+    doGenerate(options: Experimental_VideoModelV4CallOptions): Promise<{
+        videos: Array<Experimental_VideoModelV4VideoData>;
+        warnings: Array<SharedV4Warning>;
+        providerMetadata?: SharedV4ProviderMetadata;
         response: {
             timestamp: Date;
             modelId: string;
@@ -734,7 +734,7 @@ type WebSearchToolArgs = {
     engine?: 'auto' | Engine;
 };
 
-interface OpenRouterProvider extends ProviderV3 {
+interface OpenRouterProvider extends ProviderV4 {
     (modelId: OpenRouterChatModelId, settings?: OpenRouterCompletionSettings): OpenRouterCompletionLanguageModel;
     (modelId: OpenRouterChatModelId, settings?: OpenRouterChatSettings): OpenRouterChatLanguageModel;
     languageModel(modelId: OpenRouterChatModelId, settings?: OpenRouterCompletionSettings): OpenRouterCompletionLanguageModel;
@@ -773,7 +773,7 @@ interface OpenRouterProvider extends ProviderV3 {
          *
          * @see https://openrouter.ai/docs/guides/features/server-tools/web-search
          */
-        webSearch: ProviderToolFactory<unknown, WebSearchToolArgs>;
+        webSearch: ProviderDefinedToolFactory<unknown, WebSearchToolArgs>;
     };
 }
 interface OpenRouterProviderSettings {