@ai-sdk/gateway 3.0.144 → 3.0.146

package/docs/00-ai-gateway.mdx

@@ -419,7 +419,7 @@ import { generateText, tool } from "ai";
 import { z } from "zod";
 
 const { text } = await generateText({
-  model: "xai/grok-4",
+  model: "xai/grok-4.5",
   prompt: "What is the weather like in San Francisco?",
   tools: {
     getWeather: tool({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-sdk/gateway",
   "private": false,
-  "version": "3.0.144",
+  "version": "3.0.146",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "@vercel/oidc": "3.2.0",
-    "@ai-sdk/provider": "3.0.13",
-    "@ai-sdk/provider-utils": "4.0.36"
+    "@ai-sdk/provider": "3.0.14",
+    "@ai-sdk/provider-utils": "4.0.38"
   },
   "devDependencies": {
     "@types/node": "18.15.11",
@@ -40,8 +40,8 @@
     "tsx": "4.19.2",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@vercel/ai-tsconfig": "0.0.0",
-    "@ai-sdk/test-server": "1.0.6"
+    "@ai-sdk/test-server": "1.0.6",
+    "@vercel/ai-tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

package/src/errors/create-gateway-error.ts

@@ -9,7 +9,10 @@ import {
 } from './gateway-model-not-found-error';
 import { GatewayInternalServerError } from './gateway-internal-server-error';
 import { GatewayFailedDependencyError } from './gateway-failed-dependency-error';
-import { GatewayForbiddenError } from './gateway-forbidden-error';
+import {
+  GatewayForbiddenError,
+  forbiddenParamSchema,
+} from './gateway-forbidden-error';
 import { GatewayResponseError } from './gateway-response-error';
 import {
   lazySchema,
@@ -112,13 +115,20 @@ export async function createGatewayErrorFromResponse({
         cause,
         generationId,
       });
-    case 'forbidden':
+    case 'forbidden': {
+      const ruleResult = await safeValidateTypes({
+        value: validatedResponse.error.param,
+        schema: forbiddenParamSchema,
+      });
+
       return new GatewayForbiddenError({
         message,
         statusCode,
         cause,
         generationId,
+        ruleId: ruleResult.success ? ruleResult.value.ruleId : undefined,
       });
+    }
     default:
       return new GatewayInternalServerError({
         message,

package/src/errors/gateway-forbidden-error.ts

@@ -1,9 +1,19 @@
+import { z } from 'zod/v4';
 import { GatewayError } from './gateway-error';
+import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
 
 const name = 'GatewayForbiddenError';
 const marker = `vercel.ai.gateway.error.${name}`;
 const symbol = Symbol.for(marker);
 
+export const forbiddenParamSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      ruleId: z.string(),
+    }),
+  ),
+);
+
 /**
  * Forbidden - the request was rejected by policy (e.g. a routing rule),
  * not an authentication failure.
@@ -13,19 +23,23 @@ export class GatewayForbiddenError extends GatewayError {
 
   readonly name = name;
   readonly type = 'forbidden';
+  readonly ruleId?: string;
 
   constructor({
     message = 'Forbidden',
     statusCode = 403,
     cause,
     generationId,
+    ruleId,
   }: {
     message?: string;
     statusCode?: number;
     cause?: unknown;
     generationId?: string;
+    ruleId?: string;
   } = {}) {
     super({ message, statusCode, cause, generationId });
+    this.ruleId = ruleId;
   }
 
   static isInstance(error: unknown): error is GatewayForbiddenError {

package/src/gateway-image-model.ts

@@ -13,6 +13,7 @@ import {
   type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
+import { mapGatewayWarnings } from './map-gateway-warnings';
 import type { GatewayConfig } from './gateway-config';
 import { asGatewayError } from './errors';
 import { parseAuthMethod } from './errors/parse-auth-method';
@@ -87,7 +88,7 @@ export class GatewayImageModel implements ImageModelV3 {
 
       return {
         images: responseBody.images, // Always base64 strings from server
-        warnings: responseBody.warnings ?? [],
+        warnings: mapGatewayWarnings(responseBody.warnings),
         providerMetadata:
           responseBody.providerMetadata as ImageModelV3ProviderMetadata,
         response: {
@@ -147,6 +148,11 @@ const gatewayImageWarningSchema = z.discriminatedUnion('type', [
     feature: z.string(),
     details: z.string().optional(),
   }),
+  z.object({
+    type: z.literal('deprecated'),
+    setting: z.string(),
+    message: z.string(),
+  }),
   z.object({
     type: z.literal('other'),
     message: z.string(),

package/src/gateway-language-model-settings.ts

@@ -156,6 +156,10 @@ export type GatewayModelId =
   | 'openai/gpt-5.4-pro'
   | 'openai/gpt-5.5'
   | 'openai/gpt-5.5-pro'
+  | 'openai/gpt-5.6'
+  | 'openai/gpt-5.6-luna'
+  | 'openai/gpt-5.6-sol'
+  | 'openai/gpt-5.6-terra'
   | 'openai/gpt-oss-120b'
   | 'openai/gpt-oss-20b'
   | 'openai/gpt-oss-safeguard-20b'
@@ -180,6 +184,7 @@ export type GatewayModelId =
   | 'xai/grok-4.20-reasoning'
   | 'xai/grok-4.20-reasoning-beta'
   | 'xai/grok-4.3'
+  | 'xai/grok-4.5'
   | 'xai/grok-build-0.1'
   | 'xiaomi/mimo-v2-flash'
   | 'xiaomi/mimo-v2-pro'

package/src/gateway-speech-model.ts

@@ -1,8 +1,4 @@
-import type {
-  SharedV3ProviderMetadata,
-  SharedV3Warning,
-  SpeechModelV3,
-} from '@ai-sdk/provider';
+import type { SharedV3ProviderMetadata, SpeechModelV3 } from '@ai-sdk/provider';
 import {
   combineHeaders,
   createJsonErrorResponseHandler,
@@ -12,6 +8,7 @@ import {
   type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
+import { mapGatewayWarnings } from './map-gateway-warnings';
 import { asGatewayError } from './errors';
 import { parseAuthMethod } from './errors/parse-auth-method';
 import type { GatewayConfig } from './gateway-config';
@@ -80,7 +77,7 @@ export class GatewaySpeechModel implements SpeechModelV3 {
 
       return {
         audio: responseBody.audio,
-        warnings: (responseBody.warnings ?? []) as Array<SharedV3Warning>,
+        warnings: mapGatewayWarnings(responseBody.warnings),
         providerMetadata:
           responseBody.providerMetadata as SharedV3ProviderMetadata,
         response: {
@@ -123,6 +120,11 @@ const gatewaySpeechWarningSchema = z.discriminatedUnion('type', [
     feature: z.string(),
     details: z.string().optional(),
   }),
+  z.object({
+    type: z.literal('deprecated'),
+    setting: z.string(),
+    message: z.string(),
+  }),
   z.object({
     type: z.literal('other'),
     message: z.string(),

package/src/gateway-transcription-model.ts

@@ -1,6 +1,5 @@
 import type {
   SharedV3ProviderMetadata,
-  SharedV3Warning,
   TranscriptionModelV3,
 } from '@ai-sdk/provider';
 import {
@@ -13,6 +12,7 @@ import {
   type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
+import { mapGatewayWarnings } from './map-gateway-warnings';
 import { asGatewayError } from './errors';
 import { parseAuthMethod } from './errors/parse-auth-method';
 import type { GatewayConfig } from './gateway-config';
@@ -79,7 +79,7 @@ export class GatewayTranscriptionModel implements TranscriptionModelV3 {
         segments: responseBody.segments ?? [],
         language: responseBody.language ?? undefined,
         durationInSeconds: responseBody.durationInSeconds ?? undefined,
-        warnings: (responseBody.warnings ?? []) as Array<SharedV3Warning>,
+        warnings: mapGatewayWarnings(responseBody.warnings),
         providerMetadata:
           responseBody.providerMetadata as SharedV3ProviderMetadata,
         response: {
@@ -122,6 +122,11 @@ const gatewayTranscriptionWarningSchema = z.discriminatedUnion('type', [
     feature: z.string(),
     details: z.string().optional(),
   }),
+  z.object({
+    type: z.literal('deprecated'),
+    setting: z.string(),
+    message: z.string(),
+  }),
   z.object({
     type: z.literal('other'),
     message: z.string(),

package/src/gateway-video-model-settings.ts

@@ -5,6 +5,8 @@ export type GatewayVideoModelId =
   | 'alibaba/wan-v2.6-r2v'
   | 'alibaba/wan-v2.6-r2v-flash'
   | 'alibaba/wan-v2.6-t2v'
+  | 'alibaba/wan-v2.7-r2v'
+  | 'alibaba/wan-v2.7-t2v'
   | 'bytedance/seedance-2.0'
   | 'bytedance/seedance-2.0-fast'
   | 'bytedance/seedance-v1.0-pro'

package/src/gateway-video-model.ts

@@ -17,6 +17,7 @@ import {
   type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
+import { mapGatewayWarnings } from './map-gateway-warnings';
 import type { GatewayConfig } from './gateway-config';
 import { asGatewayError } from './errors';
 import { parseAuthMethod } from './errors/parse-auth-method';
@@ -183,7 +184,7 @@ export class GatewayVideoModel implements Experimental_VideoModelV3 {
 
       return {
         videos: responseBody.videos,
-        warnings: responseBody.warnings ?? [],
+        warnings: mapGatewayWarnings(responseBody.warnings),
         providerMetadata:
           responseBody.providerMetadata as SharedV3ProviderMetadata,
         response: {
@@ -249,6 +250,11 @@ const gatewayVideoWarningSchema = z.discriminatedUnion('type', [
     feature: z.string(),
     details: z.string().optional(),
   }),
+  z.object({
+    type: z.literal('deprecated'),
+    setting: z.string(),
+    message: z.string(),
+  }),
   z.object({
     type: z.literal('other'),
     message: z.string(),

package/src/map-gateway-warnings.ts

@@ -0,0 +1,21 @@
+import type { SharedV3Warning } from '@ai-sdk/provider';
+
+type GatewayResponseWarning =
+  | SharedV3Warning
+  | { type: 'deprecated'; setting: string; message: string };
+
+/**
+ * Maps warnings from gateway responses to `SharedV3Warning`.
+ *
+ * The gateway backend can emit `deprecated` warnings, which the v3
+ * specification cannot represent — they are mapped to `other` warnings.
+ */
+export function mapGatewayWarnings(
+  warnings: Array<GatewayResponseWarning> | undefined,
+): Array<SharedV3Warning> {
+  return (warnings ?? []).map(warning =>
+    warning.type === 'deprecated'
+      ? { type: 'other', message: warning.message }
+      : warning,
+  );
+}