@ai-sdk/mistral 4.0.0-beta.5 → 4.0.0-beta.55

package/src/{mistral-chat-options.ts → mistral-chat-language-model-options.ts}

@@ -2,29 +2,29 @@ import { z } from 'zod/v4';
 
 // https://docs.mistral.ai/getting-started/models/models_overview/
 export type MistralChatModelId =
-  // premier
   | 'ministral-3b-latest'
   | 'ministral-8b-latest'
+  | 'ministral-14b-latest'
   | 'mistral-large-latest'
   | 'mistral-medium-latest'
+  | 'mistral-medium-3'
+  | 'mistral-large-2512'
   | 'mistral-medium-2508'
   | 'mistral-medium-2505'
-  | 'mistral-small-latest'
+  | 'mistral-small-2506'
   | 'pixtral-large-latest'
+  // reasoning config support models
+  | 'mistral-medium-3.5'
+  | 'mistral-small-latest'
+  | 'mistral-small-2603'
   // reasoning models
-  | 'magistral-small-2507'
-  | 'magistral-medium-2507'
-  | 'magistral-small-2506'
-  | 'magistral-medium-2506'
-  // free
-  | 'pixtral-12b-2409'
-  // legacy
-  | 'open-mistral-7b'
-  | 'open-mixtral-8x7b'
-  | 'open-mixtral-8x22b'
+  | 'magistral-medium-latest'
+  | 'magistral-small-latest'
+  | 'magistral-medium-2509'
+  | 'magistral-small-2509'
   | (string & {});
 
-export const mistralLanguageModelOptions = z.object({
+export const mistralLanguageModelChatOptions = z.object({
   /**
    * Whether to inject a safety prompt before all conversations.
    *
@@ -56,8 +56,16 @@ export const mistralLanguageModelOptions = z.object({
    * @default true
    */
   parallelToolCalls: z.boolean().optional(),
+
+  /**
+   * Controls the reasoning effort for models that support adjustable reasoning.
+   *
+   * - `'high'`: Enable reasoning
+   * - `'none'`: Disable reasoning
+   */
+  reasoningEffort: z.enum(['high', 'none']).optional(),
 });
 
-export type MistralLanguageModelOptions = z.infer<
-  typeof mistralLanguageModelOptions
+export type MistralLanguageModelChatOptions = z.infer<
+  typeof mistralLanguageModelChatOptions
 >;

package/src/mistral-chat-language-model.ts

@@ -1,4 +1,4 @@
-import {
+import type {
   LanguageModelV4,
   LanguageModelV4CallOptions,
   LanguageModelV4Content,
@@ -12,29 +12,37 @@ import {
   combineHeaders,
   createEventSourceResponseHandler,
   createJsonResponseHandler,
-  FetchFunction,
   generateId,
   injectJsonInstructionIntoMessages,
+  isCustomReasoning,
+  mapReasoningToProviderEffort,
   parseProviderOptions,
-  ParseResult,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
+  type FetchFunction,
+  type ParseResult,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
-import { convertMistralUsage, MistralUsage } from './convert-mistral-usage';
+import {
+  convertMistralUsage,
+  type MistralUsage,
+} from './convert-mistral-usage';
 import { convertToMistralChatMessages } from './convert-to-mistral-chat-messages';
 import { getResponseMetadata } from './get-response-metadata';
 import { mapMistralFinishReason } from './map-mistral-finish-reason';
 import {
-  MistralChatModelId,
-  mistralLanguageModelOptions,
-} from './mistral-chat-options';
+  mistralLanguageModelChatOptions,
+  type MistralChatModelId,
+} from './mistral-chat-language-model-options';
 import { mistralFailedResponseHandler } from './mistral-error';
 import { prepareTools } from './mistral-prepare-tools';
 
 type MistralChatConfig = {
   provider: string;
   baseURL: string;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   fetch?: FetchFunction;
   generateId?: () => string;
 };
@@ -47,6 +55,20 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
   private readonly config: MistralChatConfig;
   private readonly generateId: () => string;
 
+  static [WORKFLOW_SERIALIZE](model: MistralChatLanguageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: MistralChatModelId;
+    config: MistralChatConfig;
+  }) {
+    return new MistralChatLanguageModel(options.modelId, options.config);
+  }
+
   constructor(modelId: MistralChatModelId, config: MistralChatConfig) {
     this.modelId = modelId;
     this.config = config;
@@ -69,6 +91,7 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
     topK,
     frequencyPenalty,
     presencePenalty,
+    reasoning,
     stopSequences,
     responseFormat,
     seed,
@@ -82,7 +105,7 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
       (await parseProviderOptions({
         provider: 'mistral',
         providerOptions,
-        schema: mistralLanguageModelOptions,
+        schema: mistralLanguageModelChatOptions,
       })) ?? {};
 
     if (topK != null) {
@@ -97,8 +120,37 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
       warnings.push({ type: 'unsupported', feature: 'presencePenalty' });
     }
 
-    if (stopSequences != null) {
-      warnings.push({ type: 'unsupported', feature: 'stopSequences' });
+    const supportsReasoningEffort =
+      this.modelId === 'mistral-small-latest' ||
+      this.modelId === 'mistral-small-2603' ||
+      this.modelId === 'mistral-medium-3' ||
+      this.modelId === 'mistral-medium-3.5';
+
+    let resolvedReasoningEffort: string | undefined;
+    if (supportsReasoningEffort) {
+      resolvedReasoningEffort =
+        options.reasoningEffort ??
+        (isCustomReasoning(reasoning)
+          ? reasoning === 'none'
+            ? 'none'
+            : mapReasoningToProviderEffort({
+                reasoning,
+                effortMap: {
+                  minimal: 'high',
+                  low: 'high',
+                  medium: 'high',
+                  high: 'high',
+                  xhigh: 'high',
+                },
+                warnings,
+              })
+          : undefined);
+    } else if (isCustomReasoning(reasoning)) {
+      warnings.push({
+        type: 'unsupported',
+        feature: 'reasoning',
+        details: 'This model does not support reasoning configuration.',
+      });
     }
 
     const structuredOutputs = options.structuredOutputs ?? true;
@@ -124,7 +176,9 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
       max_tokens: maxOutputTokens,
       temperature,
       top_p: topP,
+      stop: stopSequences,
       random_seed: seed,
+      reasoning_effort: resolvedReasoningEffort,
 
       // response format:
       response_format:
@@ -183,7 +237,7 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
       rawValue: rawResponse,
     } = await postJsonToApi({
       url: `${this.config.baseURL}/chat/completions`,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: mistralFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -262,7 +316,7 @@ export class MistralChatLanguageModel implements LanguageModelV4 {
 
     const { responseHeaders, value: response } = await postJsonToApi({
       url: `${this.config.baseURL}/chat/completions`,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: mistralFailedResponseHandler,
       successfulResponseHandler: createEventSourceResponseHandler(
@@ -522,6 +576,13 @@ const mistralUsageSchema = z.object({
   prompt_tokens: z.number(),
   completion_tokens: z.number(),
   total_tokens: z.number(),
+  num_cached_tokens: z.number().nullish(),
+  prompt_tokens_details: z
+    .object({ cached_tokens: z.number().nullish() })
+    .nullish(),
+  prompt_token_details: z
+    .object({ cached_tokens: z.number().nullish() })
+    .nullish(),
 });
 
 // limited version of the schema, focussed on what is needed for the implementation

package/src/mistral-embedding-model.ts

@@ -1,21 +1,24 @@
 import {
-  EmbeddingModelV4,
   TooManyEmbeddingValuesForCallError,
+  type EmbeddingModelV4,
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
   createJsonResponseHandler,
-  FetchFunction,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
-import { MistralEmbeddingModelId } from './mistral-embedding-options';
+import type { MistralEmbeddingModelId } from './mistral-embedding-options';
 import { mistralFailedResponseHandler } from './mistral-error';
 
 type MistralEmbeddingConfig = {
   provider: string;
   baseURL: string;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   fetch?: FetchFunction;
 };
 
@@ -31,6 +34,20 @@ export class MistralEmbeddingModel implements EmbeddingModelV4 {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: MistralEmbeddingModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: MistralEmbeddingModelId;
+    config: MistralEmbeddingConfig;
+  }) {
+    return new MistralEmbeddingModel(options.modelId, options.config);
+  }
+
   constructor(
     modelId: MistralEmbeddingModelId,
     config: MistralEmbeddingConfig,
@@ -61,7 +78,7 @@ export class MistralEmbeddingModel implements EmbeddingModelV4 {
       rawValue,
     } = await postJsonToApi({
       url: `${this.config.baseURL}/embeddings`,
-      headers: combineHeaders(this.config.headers(), headers),
+      headers: combineHeaders(this.config.headers?.(), headers),
       body: {
         model: this.modelId,
         input: values,

package/src/mistral-prepare-tools.ts

@@ -1,9 +1,9 @@
 import {
-  LanguageModelV4CallOptions,
-  SharedV4Warning,
   UnsupportedFunctionalityError,
+  type LanguageModelV4CallOptions,
+  type SharedV4Warning,
 } from '@ai-sdk/provider';
-import { MistralToolChoice } from './mistral-chat-prompt';
+import type { MistralToolChoice } from './mistral-chat-prompt';
 
 export function prepareTools({
   tools,

package/src/mistral-provider.ts

@@ -1,19 +1,19 @@
 import {
-  EmbeddingModelV4,
-  LanguageModelV4,
   NoSuchModelError,
-  ProviderV4,
+  type EmbeddingModelV4,
+  type LanguageModelV4,
+  type ProviderV4,
 } from '@ai-sdk/provider';
 import {
-  FetchFunction,
   loadApiKey,
   withoutTrailingSlash,
   withUserAgentSuffix,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { MistralChatLanguageModel } from './mistral-chat-language-model';
-import { MistralChatModelId } from './mistral-chat-options';
+import type { MistralChatModelId } from './mistral-chat-language-model-options';
 import { MistralEmbeddingModel } from './mistral-embedding-model';
-import { MistralEmbeddingModelId } from './mistral-embedding-options';
+import type { MistralEmbeddingModelId } from './mistral-embedding-options';
 import { VERSION } from './version';
 
 export interface MistralProvider extends ProviderV4 {

package/dist/index.d.mts

@@ -1,78 +0,0 @@
-import { ProviderV4, LanguageModelV4, EmbeddingModelV4 } from '@ai-sdk/provider';
-import { FetchFunction } from '@ai-sdk/provider-utils';
-import { z } from 'zod/v4';
-
-type MistralChatModelId = 'ministral-3b-latest' | 'ministral-8b-latest' | 'mistral-large-latest' | 'mistral-medium-latest' | 'mistral-medium-2508' | 'mistral-medium-2505' | 'mistral-small-latest' | 'pixtral-large-latest' | 'magistral-small-2507' | 'magistral-medium-2507' | 'magistral-small-2506' | 'magistral-medium-2506' | 'pixtral-12b-2409' | 'open-mistral-7b' | 'open-mixtral-8x7b' | 'open-mixtral-8x22b' | (string & {});
-declare const mistralLanguageModelOptions: z.ZodObject<{
-    safePrompt: z.ZodOptional<z.ZodBoolean>;
-    documentImageLimit: z.ZodOptional<z.ZodNumber>;
-    documentPageLimit: z.ZodOptional<z.ZodNumber>;
-    structuredOutputs: z.ZodOptional<z.ZodBoolean>;
-    strictJsonSchema: z.ZodOptional<z.ZodBoolean>;
-    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-type MistralLanguageModelOptions = z.infer<typeof mistralLanguageModelOptions>;
-
-type MistralEmbeddingModelId = 'mistral-embed' | (string & {});
-
-interface MistralProvider extends ProviderV4 {
-    (modelId: MistralChatModelId): LanguageModelV4;
-    /**
-     * Creates a model for text generation.
-     */
-    languageModel(modelId: MistralChatModelId): LanguageModelV4;
-    /**
-     * Creates a model for text generation.
-     */
-    chat(modelId: MistralChatModelId): LanguageModelV4;
-    /**
-     * Creates a model for text embeddings.
-     */
-    embedding(modelId: MistralEmbeddingModelId): EmbeddingModelV4;
-    /**
-     * Creates a model for text embeddings.
-     */
-    embeddingModel: (modelId: MistralEmbeddingModelId) => EmbeddingModelV4;
-    /**
-     * @deprecated Use `embedding` instead.
-     */
-    textEmbedding(modelId: MistralEmbeddingModelId): EmbeddingModelV4;
-    /**
-     * @deprecated Use `embeddingModel` instead.
-     */
-    textEmbeddingModel(modelId: MistralEmbeddingModelId): EmbeddingModelV4;
-}
-interface MistralProviderSettings {
-    /**
-     * Use a different URL prefix for API calls, e.g. to use proxy servers.
-     * The default prefix is `https://api.mistral.ai/v1`.
-     */
-    baseURL?: string;
-    /**
-     * API key that is being send using the `Authorization` header.
-     * It defaults to the `MISTRAL_API_KEY` environment variable.
-     */
-    apiKey?: string;
-    /**
-     * Custom headers to include in the requests.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Custom fetch implementation. You can use it as a middleware to intercept requests,
-     * or to provide a custom fetch implementation for e.g. testing.
-     */
-    fetch?: FetchFunction;
-    generateId?: () => string;
-}
-/**
- * Create a Mistral AI provider instance.
- */
-declare function createMistral(options?: MistralProviderSettings): MistralProvider;
-/**
- * Default Mistral provider instance.
- */
-declare const mistral: MistralProvider;
-
-declare const VERSION: string;
-
-export { type MistralLanguageModelOptions, type MistralProvider, type MistralProviderSettings, VERSION, createMistral, mistral };