@ai-sdk/gateway 4.0.103 → 4.0.104

package/docs/00-ai-gateway.mdx

@@ -1478,7 +1478,7 @@ The following gateway provider options are available:
 
 - **models** _string[] | [GatewayModelFallback, ...string[]]_
 
-  Specifies fallback models in attempt order. String entries keep their existing behavior: the gateway tries them when the primary model fails or is unavailable. Evaluation requests can also start the list with one conditional `{ model, when }` entry to retry a successful but uncertain evaluation with another model. Only the first entry can be conditional, and only one conditional entry is allowed. If the primary model fails, the gateway also advances to the conditional entry under its existing error fallback behavior. Conditional entries are rejected on non-evaluation requests.
+  Specifies fallback models in attempt order. String entries keep their existing behavior: the gateway tries them when the primary model fails or is unavailable. Decision requests can also start the list with one conditional `{ model, when }` entry to retry a successful but uncertain decision with another model. Only the first entry can be conditional, and only one conditional entry is allowed. If the primary model fails, the gateway also advances to the conditional entry under its existing error fallback behavior. Conditional entries are rejected on non-decision requests.
 
   Example: `models: ['openai/gpt-5.4-nano', 'google/gemini-3.8-flash']` will try the fallback models in order if the primary model fails.
 
@@ -1616,15 +1616,15 @@ const { text } = await generateText({
 // 4. Return the result from the first model that succeeds
 ```
 
-#### Conditional Evaluation Fallbacks Example
+#### Conditional Decision Fallbacks Example
 
-Conditional model entries are available only for evaluation requests. Keep the
-configuration under `providerOptions.gateway.models`. `experimental_evaluate`
+Conditional model entries are available only for decision requests. Keep the
+configuration under `providerOptions.gateway.models`. `experimental_decide`
 does not have a top-level fallback option.
 
 ```ts
 import type { GatewayProviderOptions } from '@ai-sdk/gateway';
-import { experimental_evaluate } from 'ai';
+import { experimental_decide } from 'ai';
 
 const questions = {
   department: {
@@ -1638,7 +1638,7 @@ const questions = {
   },
 } as const;
 
-const result = await experimental_evaluate({
+const result = await experimental_decide({
   model: 'typesafe-ai/jev',
   state: 'I was charged twice. Please refund the duplicate.',
   questions,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-sdk/gateway",
   "private": false,
-  "version": "4.0.103",
+  "version": "4.0.104",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -30,8 +30,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.21",
-    "@ai-sdk/provider-utils": "5.0.53",
+    "@ai-sdk/provider": "4.0.22",
+    "@ai-sdk/provider-utils": "5.0.54",
     "@vercel/oidc": "3.2.0"
   },
   "devDependencies": {

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

@@ -0,0 +1,6 @@
+export type GatewayDecisionModelId =
+  | 'convaiinnovations/laya'
+  | 'convaiinnovations/laya-free'
+  | 'liquid/d1'
+  | 'typesafe-ai/jev'
+  | (string & {});

package/src/{gateway-evaluation-model.ts → gateway-decision-model.ts}

@@ -1,5 +1,5 @@
 import type {
-  Experimental_EvaluationModelV4 as EvaluationModelV4,
+  Experimental_DecisionModelV4 as DecisionModelV4,
   SharedV4ProviderMetadata,
 } from '@ai-sdk/provider';
 import {
@@ -18,9 +18,9 @@ import { z } from './zod';
 import { asGatewayError } from './errors';
 import { parseAuthMethod } from './errors/parse-auth-method';
 import type { GatewayConfig } from './gateway-config';
-import { gatewayEvaluationProviderOptionsSchema } from './gateway-provider-options';
+import { gatewayDecisionProviderOptionsSchema } from './gateway-provider-options';
 
-export class GatewayEvaluationModel implements EvaluationModelV4 {
+export class GatewayDecisionModel implements DecisionModelV4 {
   readonly specificationVersion = 'v4';
 
   readonly supportedQuestionTypes = ['choice', 'score', 'boolean'] as const;
@@ -37,19 +37,24 @@ export class GatewayEvaluationModel implements EvaluationModelV4 {
     return this.config.provider;
   }
 
-  async doEvaluate({
+  /** @deprecated Use `doDecide` instead. */
+  doEvaluate(options: Parameters<DecisionModelV4['doDecide']>[0]) {
+    return this.doDecide(options);
+  }
+
+  async doDecide({
     state,
     questions,
     headers,
     abortSignal,
     providerOptions,
-  }: Parameters<EvaluationModelV4['doEvaluate']>[0]): Promise<
-    Awaited<ReturnType<EvaluationModelV4['doEvaluate']>>
+  }: Parameters<DecisionModelV4['doDecide']>[0]): Promise<
+    Awaited<ReturnType<DecisionModelV4['doDecide']>>
   > {
     const gatewayOptions = await parseProviderOptions({
       provider: 'gateway',
       providerOptions,
-      schema: gatewayEvaluationProviderOptionsSchema,
+      schema: gatewayDecisionProviderOptionsSchema,
     });
     const validatedProviderOptions =
       gatewayOptions == null
@@ -79,7 +84,7 @@ export class GatewayEvaluationModel implements EvaluationModelV4 {
             : {}),
         },
         successfulResponseHandler: createJsonResponseHandler(
-          gatewayEvaluationResponseSchema,
+          gatewayDecisionResponseSchema,
         ),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: z.any(),
@@ -111,18 +116,18 @@ export class GatewayEvaluationModel implements EvaluationModelV4 {
   }
 
   private getUrl() {
-    return `${this.config.baseURL}/evaluation-model`;
+    return `${this.config.baseURL}/decision-model`;
   }
 
   private getModelConfigHeaders() {
     return {
-      'ai-evaluation-model-specification-version': '4',
+      'ai-decision-model-specification-version': '4',
       'ai-model-id': this.modelId,
     };
   }
 }
 
-const gatewayEvaluationAnswerSchema = z.discriminatedUnion('type', [
+const gatewayDecisionAnswerSchema = z.discriminatedUnion('type', [
   z.object({
     type: z.literal('choice'),
     choice: z.string(),
@@ -139,7 +144,7 @@ const gatewayEvaluationAnswerSchema = z.discriminatedUnion('type', [
   }),
 ]);
 
-const gatewayEvaluationWarningSchema = z.discriminatedUnion('type', [
+const gatewayDecisionWarningSchema = z.discriminatedUnion('type', [
   z.object({
     type: z.literal('unsupported'),
     feature: z.string(),
@@ -161,10 +166,10 @@ const gatewayEvaluationWarningSchema = z.discriminatedUnion('type', [
   }),
 ]);
 
-const gatewayEvaluationResponseSchema = lazySchema(() =>
+const gatewayDecisionResponseSchema = lazySchema(() =>
   zodSchema(
     z.object({
-      answers: z.record(z.string(), gatewayEvaluationAnswerSchema),
+      answers: z.record(z.string(), gatewayDecisionAnswerSchema),
       model: z.string().optional(),
       rounding: z
         .object({
@@ -178,7 +183,7 @@ const gatewayEvaluationResponseSchema = lazySchema(() =>
           outputTokens: z.number().optional(),
         })
         .optional(),
-      warnings: z.array(gatewayEvaluationWarningSchema).optional(),
+      warnings: z.array(gatewayDecisionWarningSchema).optional(),
       providerMetadata: z
         .record(z.string(), z.record(z.string(), z.unknown()))
         .optional(),

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

@@ -70,6 +70,7 @@ export type GatewayModelId =
   | 'deepseek/deepseek-v4-pro'
   | 'deepseek/deepseek-v4-pro-0813'
   | 'deepseek/deepseek-v4.1-flash'
+  | 'deepseek/deepseek-v4.1-flash-fast'
   | 'fireworks/ember-1'
   | 'google/gemini-2.5-flash'
   | 'google/gemini-2.5-flash-image'
@@ -96,7 +97,6 @@ export type GatewayModelId =
   | 'inclusionai/ling-3.0-flash'
   | 'inclusionai/ling-3.0-flash-fin'
   | 'inclusionai/ling-3.0-flash-sante'
-  | 'inclusionai/ling-3.0-flash-sante-free'
   | 'inclusionai/ling-3.0-flash-vl'
   | 'inclusionai/ling-3.1-flash'
   | 'inclusionai/ling-3.1-flash-free'

package/src/gateway-model-entry.ts

@@ -2,6 +2,8 @@ import type { LanguageModelV4 } from '@ai-sdk/provider';
 
 export const KNOWN_MODEL_TYPES = [
   'embedding',
+  'decision',
+  // Keep `evaluation` until Gateway migrates its model catalog to `decision`.
   'evaluation',
   'image',
   'language',

package/src/gateway-provider-options.ts

@@ -3,11 +3,11 @@ import type { ZodType } from 'zod/v4';
 import { z } from './zod';
 
 // https://vercel.com/docs/ai-gateway/provider-options
-export const EVALUATION_FALLBACK_MAX_CONDITION_DEPTH = 5;
-export const EVALUATION_FALLBACK_MAX_CONDITIONS_PER_LIST = 20;
-export const EVALUATION_FALLBACK_MAX_QUESTION_LENGTH = 256;
+export const DECISION_FALLBACK_MAX_CONDITION_DEPTH = 5;
+export const DECISION_FALLBACK_MAX_CONDITIONS_PER_LIST = 20;
+export const DECISION_FALLBACK_MAX_QUESTION_LENGTH = 256;
 
-export const gatewayEvaluationProviderOptionsSchema = lazySchema(() =>
+export const gatewayDecisionProviderOptionsSchema = lazySchema(() =>
   zodSchema(
     z
       .object({
@@ -24,18 +24,18 @@ export const gatewayEvaluationProviderOptionsSchema = lazySchema(() =>
  * Boolean question. Groups nest at most five levels deep, which the SDK
  * checks at runtime.
  */
-export type EvaluationFallbackCondition<QUESTION_ID extends string = string> =
+export type DecisionFallbackCondition<QUESTION_ID extends string = string> =
   | ExclusiveCondition<{ question?: QUESTION_ID; confidenceBelow: number }>
   | ExclusiveCondition<{
       question?: QUESTION_ID;
       probabilityBetween: [number, number];
     }>
-  | ExclusiveCondition<{ any: EvaluationFallbackConditionList<QUESTION_ID> }>
-  | ExclusiveCondition<{ all: EvaluationFallbackConditionList<QUESTION_ID> }>
+  | ExclusiveCondition<{ any: DecisionFallbackConditionList<QUESTION_ID> }>
+  | ExclusiveCondition<{ all: DecisionFallbackConditionList<QUESTION_ID> }>
   | ExclusiveCondition<{
       atLeast: {
         count: number;
-        conditions: EvaluationFallbackConditionList<QUESTION_ID>;
+        conditions: DecisionFallbackConditionList<QUESTION_ID>;
       };
     }>;
 
@@ -43,7 +43,7 @@ export type GatewayModelFallback<QUESTION_ID extends string = string> =
   | string
   | {
       model: string;
-      when: EvaluationFallbackCondition<QUESTION_ID>;
+      when: DecisionFallbackCondition<QUESTION_ID>;
     };
 
 export type GatewayProviderOptions<QUESTION_ID extends string = string> = {
@@ -91,8 +91,8 @@ export type GatewayProviderOptions<QUESTION_ID extends string = string> = {
   idempotencyKey?: string;
 
   /**
-   * Fallback models to try in order. On evaluation requests, the first entry
-   * can be a conditional `{ model, when }` fallback that reruns the evaluation
+   * Fallback models to try in order. On decision requests, the first entry
+   * can be a conditional `{ model, when }` fallback that reruns the decision
    * when `when` matches the primary answers. Other request types reject a
    * conditional entry. Pass your question IDs as `QUESTION_ID` to check the
    * `question` names in `when`.
@@ -129,9 +129,9 @@ export type GatewayProviderOptions<QUESTION_ID extends string = string> = {
   zeroDataRetention?: boolean;
 };
 
-type EvaluationFallbackConditionList<QUESTION_ID extends string> = [
-  EvaluationFallbackCondition<QUESTION_ID>,
-  ...EvaluationFallbackCondition<QUESTION_ID>[],
+type DecisionFallbackConditionList<QUESTION_ID extends string> = [
+  DecisionFallbackCondition<QUESTION_ID>,
+  ...DecisionFallbackCondition<QUESTION_ID>[],
 ];
 
 type ConditionKey =
@@ -160,7 +160,7 @@ const probabilitySchema = z.number().finite().min(0).max(1);
 const questionSchema = z
   .string()
   .min(1)
-  .max(EVALUATION_FALLBACK_MAX_QUESTION_LENGTH);
+  .max(DECISION_FALLBACK_MAX_QUESTION_LENGTH);
 const directConditionSchema = z.union([
   z
     .object({
@@ -180,7 +180,7 @@ const directConditionSchema = z.union([
         }),
     })
     .strict(),
-]) as ZodType<EvaluationFallbackCondition>;
+]) as ZodType<DecisionFallbackCondition>;
 
 const groupBeyondMaxDepthSchema = z
   .union([
@@ -191,7 +191,7 @@ const groupBeyondMaxDepthSchema = z
   .superRefine((_, context) => {
     context.addIssue({
       code: 'custom',
-      message: `conditions can be nested at most ${EVALUATION_FALLBACK_MAX_CONDITION_DEPTH} levels deep`,
+      message: `conditions can be nested at most ${DECISION_FALLBACK_MAX_CONDITION_DEPTH} levels deep`,
     });
   });
 
@@ -211,32 +211,32 @@ const gatewayModelFallbacksSchema = z
     if (conditionalIndexes.length > 1) {
       context.addIssue({
         code: 'custom',
-        message: 'models supports at most one conditional evaluation fallback',
+        message: 'models supports at most one conditional decision fallback',
       });
     }
     if (conditionalIndexes[0] !== undefined && conditionalIndexes[0] !== 0) {
       context.addIssue({
         code: 'custom',
         message:
-          'a conditional evaluation fallback must be the first models entry',
+          'a conditional decision fallback must be the first models entry',
         path: [conditionalIndexes[0]],
       });
     }
   });
 
-function conditionSchema(depth: number): ZodType<EvaluationFallbackCondition> {
-  if (depth === EVALUATION_FALLBACK_MAX_CONDITION_DEPTH) {
+function conditionSchema(depth: number): ZodType<DecisionFallbackCondition> {
+  if (depth === DECISION_FALLBACK_MAX_CONDITION_DEPTH) {
     return z.union([
       directConditionSchema,
       groupBeyondMaxDepthSchema,
-    ]) as ZodType<EvaluationFallbackCondition>;
+    ]) as ZodType<DecisionFallbackCondition>;
   }
 
   const childConditionSchema = conditionSchema(depth + 1);
   const conditionListSchema = z
     .array(childConditionSchema)
     .min(1)
-    .max(EVALUATION_FALLBACK_MAX_CONDITIONS_PER_LIST);
+    .max(DECISION_FALLBACK_MAX_CONDITIONS_PER_LIST);
 
   return z.union([
     directConditionSchema,
@@ -256,5 +256,5 @@ function conditionSchema(depth: number): ZodType<EvaluationFallbackCondition> {
           }),
       })
       .strict(),
-  ]) as ZodType<EvaluationFallbackCondition>;
+  ]) as ZodType<DecisionFallbackCondition>;
 }

package/src/gateway-provider.ts

@@ -36,7 +36,7 @@ import { GatewayLanguageModel } from './gateway-language-model';
 import { GatewayEmbeddingModel } from './gateway-embedding-model';
 import { GatewayImageModel } from './gateway-image-model';
 import { GatewayVideoModel } from './gateway-video-model';
-import { GatewayEvaluationModel } from './gateway-evaluation-model';
+import { GatewayDecisionModel } from './gateway-decision-model';
 import { GatewayRerankingModel } from './gateway-reranking-model';
 import { GatewaySpeechModel } from './gateway-speech-model';
 import {
@@ -45,7 +45,7 @@ import {
 } from './gateway-transcription-model';
 import { GatewayRealtimeModel } from './gateway-realtime-model';
 import type { GatewayEmbeddingModelId } from './gateway-embedding-model-settings';
-import type { GatewayEvaluationModelId } from './gateway-evaluation-model-settings';
+import type { GatewayDecisionModelId } from './gateway-decision-model-settings';
 import type { GatewayImageModelId } from './gateway-image-model-settings';
 import type { GatewayRerankingModelId } from './gateway-reranking-model-settings';
 import type { GatewaySpeechModelId } from './gateway-speech-model-settings';
@@ -63,7 +63,7 @@ import type {
   SpeechModelV4,
   TranscriptionModelV4,
   Experimental_VideoModelV4,
-  Experimental_EvaluationModelV4,
+  Experimental_DecisionModelV4,
   Experimental_RealtimeFactoryV4 as RealtimeFactoryV4,
   Experimental_RealtimeFactoryV4GetTokenOptions as RealtimeFactoryV4GetTokenOptions,
   ProviderV4,
@@ -159,16 +159,24 @@ export interface GatewayProvider extends ProviderV4 {
   rerankingModel(modelId: GatewayRerankingModelId): RerankingModelV4;
 
   /**
-   * Creates a model for evaluating state against questions.
+   * Creates a model for deciding answers to questions against shared state.
    */
-  evaluation(modelId: GatewayEvaluationModelId): Experimental_EvaluationModelV4;
+  decision(modelId: GatewayDecisionModelId): Experimental_DecisionModelV4;
 
   /**
-   * Creates a model for evaluating state against questions.
+   * Creates a model for deciding answers to questions against shared state.
    */
+  decisionModel(modelId: GatewayDecisionModelId): Experimental_DecisionModelV4;
+  /** @deprecated Use `decisionModel` instead. */
   evaluationModel(
-    modelId: GatewayEvaluationModelId,
-  ): Experimental_EvaluationModelV4;
+    modelId: GatewayDecisionModelId,
+  ): Experimental_DecisionModelV4 & {
+    doEvaluate: Experimental_DecisionModelV4['doDecide'];
+  };
+  /** @deprecated Use `decision` instead. */
+  evaluation(
+    modelId: GatewayDecisionModelId,
+  ): ReturnType<GatewayProvider['evaluationModel']>;
 
   /**
    * Creates a model for text-to-speech generation.
@@ -583,8 +591,8 @@ export function createGateway(
   };
   provider.rerankingModel = createRerankingModel;
   provider.reranking = createRerankingModel;
-  const createEvaluationModel = (modelId: GatewayEvaluationModelId) => {
-    return new GatewayEvaluationModel(modelId, {
+  const createDecisionModel = (modelId: GatewayDecisionModelId) => {
+    return new GatewayDecisionModel(modelId, {
       provider: 'gateway',
       baseURL,
       headers: getHeaders,
@@ -592,8 +600,10 @@ export function createGateway(
       o11yHeaders: createO11yHeaders(),
     });
   };
-  provider.evaluationModel = createEvaluationModel;
-  provider.evaluation = createEvaluationModel;
+  provider.decisionModel = createDecisionModel;
+  provider.decision = createDecisionModel;
+  provider.evaluationModel = createDecisionModel;
+  provider.evaluation = createDecisionModel;
   const createSpeechModel = (modelId: GatewaySpeechModelId) => {
     return new GatewaySpeechModel(modelId, {
       provider: 'gateway',

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

@@ -34,4 +34,5 @@ export type GatewayVideoModelId =
   | 'minimax/minimax-h3-max'
   | 'spacexai/grok-imagine-video'
   | 'spacexai/grok-imagine-video-1.5'
+  | 'spacexai/grok-imagine-video-1.5-lite'
   | (string & {});

package/src/index.ts

@@ -1,5 +1,8 @@
+import type { GatewayDecisionModelId } from './gateway-decision-model-settings';
+import type { DecisionFallbackCondition } from './gateway-provider-options';
+
 export type { GatewayEmbeddingModelId } from './gateway-embedding-model-settings';
-export type { GatewayEvaluationModelId } from './gateway-evaluation-model-settings';
+export type { GatewayDecisionModelId } from './gateway-decision-model-settings';
 export type { GatewayImageModelId } from './gateway-image-model-settings';
 export type { GatewayModelId } from './gateway-language-model-settings';
 export {
@@ -47,7 +50,7 @@ export type {
   GatewayProviderMetadata,
 } from './gateway-provider-metadata';
 export type {
-  EvaluationFallbackCondition,
+  DecisionFallbackCondition,
   GatewayModelFallback,
   GatewayProviderOptions,
   /** @deprecated Use `GatewayProviderOptions` instead. */
@@ -67,3 +70,9 @@ export {
 } from './errors';
 export type { GatewayErrorResponse } from './errors';
 export { VERSION } from './version';
+
+/** @deprecated Use `GatewayDecisionModelId` instead. */
+export type GatewayEvaluationModelId = GatewayDecisionModelId;
+/** @deprecated Use `DecisionFallbackCondition` instead. */
+export type EvaluationFallbackCondition<QUESTION_ID extends string = string> =
+  DecisionFallbackCondition<QUESTION_ID>;

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

@@ -1,4 +0,0 @@
-export type GatewayEvaluationModelId =
-  | 'liquid/d1'
-  | 'typesafe-ai/jev'
-  | (string & {});