@ai-sdk/gateway 3.0.40 → 3.0.42

package/docs/00-ai-gateway.mdx

@@ -538,7 +538,7 @@ for await (const part of result.fullStream) {
 Track usage per end-user and categorize requests with tags:
 
 ```ts
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -548,7 +548,7 @@ const { text } = await generateText({
     gateway: {
       user: 'user-abc-123', // Track usage for this specific end-user
       tags: ['document-summary', 'premium-feature'], // Categorize for reporting
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
   },
 });
 ```
@@ -568,7 +568,7 @@ The AI Gateway provider accepts provider options that control routing behavior a
 You can use the `gateway` key in `providerOptions` to control how AI Gateway routes requests:
 
 ```ts
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -578,7 +578,7 @@ const { text } = await generateText({
     gateway: {
       order: ['vertex', 'anthropic'], // Try Vertex AI first, then Anthropic
       only: ['vertex', 'anthropic'], // Only use these providers
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
   },
 });
 ```
@@ -634,7 +634,7 @@ The following gateway provider options are available:
 You can combine these options to have fine-grained control over routing and tracking:
 
 ```ts
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -644,7 +644,7 @@ const { text } = await generateText({
     gateway: {
       order: ['vertex'], // Prefer Vertex AI
       only: ['anthropic', 'vertex'], // Only allow these providers
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
   },
 });
 ```
@@ -654,7 +654,7 @@ const { text } = await generateText({
 The `models` option enables automatic fallback to alternative models when the primary model fails:
 
 ```ts
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -663,7 +663,7 @@ const { text } = await generateText({
   providerOptions: {
     gateway: {
       models: ['openai/gpt-5-nano', 'gemini-2.0-flash'], // Fallback models
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
   },
 });
 
@@ -681,7 +681,7 @@ that have zero data retention policies. When `zeroDataRetention` is `false` or n
 specified, there is no enforcement of restricting routing.
 
 ```ts
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -690,7 +690,7 @@ const { text } = await generateText({
   providerOptions: {
     gateway: {
       zeroDataRetention: true,
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
   },
 });
 ```
@@ -700,8 +700,8 @@ const { text } = await generateText({
 When using provider-specific options through AI Gateway, use the actual provider name (e.g. `anthropic`, `openai`, not `gateway`) as the key:
 
 ```ts
-import type { AnthropicProviderOptions } from '@ai-sdk/anthropic';
-import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+import type { AnthropicLanguageModelOptions } from '@ai-sdk/anthropic';
+import type { GatewayLanguageModelOptions } from '@ai-sdk/gateway';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
@@ -710,10 +710,10 @@ const { text } = await generateText({
   providerOptions: {
     gateway: {
       order: ['vertex', 'anthropic'],
-    } satisfies GatewayProviderOptions,
+    } satisfies GatewayLanguageModelOptions,
     anthropic: {
       thinking: { type: 'enabled', budgetTokens: 12000 },
-    } satisfies AnthropicProviderOptions,
+    } satisfies AnthropicLanguageModelOptions,
   },
 });
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-sdk/gateway",
   "private": false,
-  "version": "3.0.40",
+  "version": "3.0.42",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/gateway-provider-options.ts

@@ -2,7 +2,7 @@ import { InferSchema, lazySchema, zodSchema } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 // https://vercel.com/docs/ai-gateway/provider-options
-const gatewayProviderOptions = lazySchema(() =>
+const gatewayLanguageModelOptions = lazySchema(() =>
   zodSchema(
     z.object({
       /**
@@ -63,4 +63,6 @@ const gatewayProviderOptions = lazySchema(() =>
   ),
 );
 
-export type GatewayProviderOptions = InferSchema<typeof gatewayProviderOptions>;
+export type GatewayLanguageModelOptions = InferSchema<
+  typeof gatewayLanguageModelOptions
+>;

package/src/gateway-video-model.ts

@@ -4,6 +4,7 @@ import type {
   Experimental_VideoModelV3File,
   Experimental_VideoModelV3VideoData,
   SharedV3ProviderMetadata,
+  SharedV3Warning,
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
@@ -50,7 +51,7 @@ export class GatewayVideoModel implements Experimental_VideoModelV3 {
     abortSignal,
   }: Experimental_VideoModelV3CallOptions): Promise<{
     videos: Array<Experimental_VideoModelV3VideoData>;
-    warnings: Array<{ type: 'other'; message: string }>;
+    warnings: Array<SharedV3Warning>;
     providerMetadata?: SharedV3ProviderMetadata;
     response: {
       timestamp: Date;
@@ -151,16 +152,26 @@ const gatewayVideoDataSchema = z.union([
   }),
 ]);
 
+const gatewayVideoWarningSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('unsupported'),
+    feature: z.string(),
+    details: z.string().optional(),
+  }),
+  z.object({
+    type: z.literal('compatibility'),
+    feature: z.string(),
+    details: z.string().optional(),
+  }),
+  z.object({
+    type: z.literal('other'),
+    message: z.string(),
+  }),
+]);
+
 const gatewayVideoResponseSchema = z.object({
   videos: z.array(gatewayVideoDataSchema),
-  warnings: z
-    .array(
-      z.object({
-        type: z.literal('other'),
-        message: z.string(),
-      }),
-    )
-    .optional(),
+  warnings: z.array(gatewayVideoWarningSchema).optional(),
   providerMetadata: z
     .record(z.string(), providerMetadataEntrySchema)
     .optional(),

package/src/index.ts

@@ -15,7 +15,11 @@ export type {
   GatewayProvider,
   GatewayProviderSettings,
 } from './gateway-provider';
-export type { GatewayProviderOptions } from './gateway-provider-options';
+export type {
+  GatewayLanguageModelOptions,
+  /** @deprecated Use `GatewayLanguageModelOptions` instead. */
+  GatewayLanguageModelOptions as GatewayProviderOptions,
+} from './gateway-provider-options';
 export {
   GatewayError,
   GatewayAuthenticationError,