ai 7.0.148 → 7.0.149

package/docs/03-ai-sdk-core/15-tools-and-tool-calling.mdx

@@ -819,6 +819,13 @@ It supports the following settings:
 - `none`: the model must not call tools
 - `{ type: 'tool', toolName: string (typed) }`: the model must call the specified tool
 
+When `toolChoice` is `'none'`, the SDK prevents local tool execution even if the
+model returns a tool call. Such responses produce a
+[`ToolChoiceViolationError`](/docs/reference/ai-sdk-errors/ai-tool-choice-violation-error).
+With `streamText`, tool parts are withheld from the stream, so client-side tools
+are not invoked either. Tool call repair and input refinement are skipped for
+rejected tool calls.
+
 ```ts highlight="19"
 import { z } from 'zod';
 import { generateText, tool } from 'ai';

package/docs/03-ai-sdk-core/18-code-mode.mdx

@@ -251,6 +251,7 @@ payloads, console output, and tool calls. Override them with
 const codeMode = codeModeTool({
   executionPolicy: {
     timeoutMs: 30_000,
+    cpuTimeoutMs: 10_000,
     memoryLimitBytes: 64 * 1024 * 1024,
     maxResultBytes: 1024 * 1024,
     maxBridgeRequests: 100,
@@ -261,7 +262,8 @@ const codeMode = codeModeTool({
 
 The available limits are:
 
-- `timeoutMs`: total execution time
+- `timeoutMs`: total execution time, including time spent waiting on tools
+- `cpuTimeoutMs`: CPU time spent running sandboxed code, excluding tool waits
 - `memoryLimitBytes`: QuickJS memory
 - `maxStackSizeBytes`: QuickJS stack
 - `maxSourceBytes`: generated source code

package/docs/03-ai-sdk-core/36-transcription.mdx

@@ -331,44 +331,45 @@ try {
 
 ## Transcription Models
 
-| Provider                                                                            | Model                        |
-| ----------------------------------------------------------------------------------- | ---------------------------- |
-| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `whisper-1`                  |
-| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-transcribe`          |
-| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-mini-transcribe`     |
-| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-transcribe-diarize`  |
-| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v1`                  |
-| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v1_experimental`     |
-| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v2`                  |
-| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#streaming-transcription-models) | `scribe_v2_realtime`         |
-| [Groq](/providers/ai-sdk-providers/groq#transcription-models)                       | `whisper-large-v3-turbo`     |
-| [Groq](/providers/ai-sdk-providers/groq#transcription-models)                       | `whisper-large-v3`           |
-| [Mistral](/providers/ai-sdk-providers/mistral#transcription-models)                 | `voxtral-mini-latest`        |
-| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `whisper-1`                  |
-| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-2`           |
-| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-1.5`         |
-| [Azure MAI](/providers/ai-sdk-providers/azure#mai-transcribe-2-streaming)           | `mai-transcribe-2-streaming` |
-| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-transcribe`          |
-| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-mini-transcribe`     |
-| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `machine`                    |
-| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `low_cost`                   |
-| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `fusion`                     |
-| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `base` (+ variants)          |
-| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `enhanced` (+ variants)      |
-| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova` (+ variants)          |
-| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova-2` (+ variants)        |
-| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova-3` (+ variants)        |
-| [Gladia](/providers/ai-sdk-providers/gladia#transcription-models)                   | `default`                    |
-| [AssemblyAI](/providers/ai-sdk-providers/assemblyai#transcription-models)           | `universal-3-5-pro`          |
-| [AssemblyAI](/providers/ai-sdk-providers/assemblyai#transcription-models)           | `universal-3-pro`            |
-| [Fal](/providers/ai-sdk-providers/fal#transcription-models)                         | `whisper`                    |
-| [Fal](/providers/ai-sdk-providers/fal#transcription-models)                         | `wizper`                     |
-| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `chirp_2`                    |
-| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `chirp_3`                    |
-| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `telephony`                  |
-| [xAI](/providers/ai-sdk-providers/xai#transcription-models)                         | `default`                    |
-| [Cartesia](/providers/ai-sdk-providers/cartesia#transcription-models)               | `ink-whisper`                |
-| [Cartesia](/providers/ai-sdk-providers/cartesia#streaming-transcription-models)     | `ink-2`                      |
-| [Fish Audio](/providers/ai-sdk-providers/fish-audio#transcription-models)           | `transcribe-1`               |
+| Provider                                                                            | Model                          |
+| ----------------------------------------------------------------------------------- | ------------------------------ |
+| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `whisper-1`                    |
+| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-transcribe`            |
+| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-mini-transcribe`       |
+| [OpenAI](/providers/ai-sdk-providers/openai#transcription-models)                   | `gpt-4o-transcribe-diarize`    |
+| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v1`                    |
+| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v1_experimental`       |
+| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#transcription-models)           | `scribe_v2`                    |
+| [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#streaming-transcription-models) | `scribe_v2_realtime`           |
+| [Groq](/providers/ai-sdk-providers/groq#transcription-models)                       | `whisper-large-v3-turbo`       |
+| [Groq](/providers/ai-sdk-providers/groq#transcription-models)                       | `whisper-large-v3`             |
+| [Mistral](/providers/ai-sdk-providers/mistral#transcription-models)                 | `voxtral-mini-transcribe-3-0`  |
+| [Mistral](/providers/ai-sdk-providers/mistral#transcription-models)                 | `voxtral-small-transcribe-3-0` |
+| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `whisper-1`                    |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-2`             |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-1.5`           |
+| [Azure MAI](/providers/ai-sdk-providers/azure#mai-transcribe-2-streaming)           | `mai-transcribe-2-streaming`   |
+| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-transcribe`            |
+| [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-mini-transcribe`       |
+| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `machine`                      |
+| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `low_cost`                     |
+| [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `fusion`                       |
+| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `base` (+ variants)            |
+| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `enhanced` (+ variants)        |
+| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova` (+ variants)            |
+| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova-2` (+ variants)          |
+| [Deepgram](/providers/ai-sdk-providers/deepgram#transcription-models)               | `nova-3` (+ variants)          |
+| [Gladia](/providers/ai-sdk-providers/gladia#transcription-models)                   | `default`                      |
+| [AssemblyAI](/providers/ai-sdk-providers/assemblyai#transcription-models)           | `universal-3-5-pro`            |
+| [AssemblyAI](/providers/ai-sdk-providers/assemblyai#transcription-models)           | `universal-3-pro`              |
+| [Fal](/providers/ai-sdk-providers/fal#transcription-models)                         | `whisper`                      |
+| [Fal](/providers/ai-sdk-providers/fal#transcription-models)                         | `wizper`                       |
+| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `chirp_2`                      |
+| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `chirp_3`                      |
+| [Google Vertex](/providers/ai-sdk-providers/google-vertex#transcription-models)     | `telephony`                    |
+| [xAI](/providers/ai-sdk-providers/xai#transcription-models)                         | `default`                      |
+| [Cartesia](/providers/ai-sdk-providers/cartesia#transcription-models)               | `ink-whisper`                  |
+| [Cartesia](/providers/ai-sdk-providers/cartesia#streaming-transcription-models)     | `ink-2`                        |
+| [Fish Audio](/providers/ai-sdk-providers/fish-audio#transcription-models)           | `transcribe-1`                 |
 
 Above are a small subset of the transcription models supported by the AI SDK providers. For more, see the respective provider documentation.

package/docs/03-ai-sdk-core/37-speech.mdx

@@ -158,6 +158,7 @@ try {
 | [OpenAI](/providers/ai-sdk-providers/openai#speech-models)               | `tts-1-hd`                          |
 | [OpenAI](/providers/ai-sdk-providers/openai#speech-models)               | `gpt-4o-mini-tts`                   |
 | [Mistral](/providers/ai-sdk-providers/mistral#speech-models)             | `voxtral-mini-tts-2603`             |
+| [Mistral](/providers/ai-sdk-providers/mistral#speech-models)             | `voxtral-mini-tts-3-0`              |
 | [Azure Speech](/providers/ai-sdk-providers/azure#mai-voice)              | `mai-voice-2.1-flash`               |
 | [Azure Speech](/providers/ai-sdk-providers/azure#mai-voice)              | `mai-voice-2.1`                     |
 | [Azure Speech](/providers/ai-sdk-providers/azure#mai-voice)              | `mai-voice-2-flash`                 |

package/docs/03-ai-sdk-core/60-telemetry.mdx

@@ -214,6 +214,29 @@ Properties set to `false` or omitted are excluded. If `telemetry.includeToolsCon
   between tool execution context and telemetry event context.
 </Note>
 
+## Agent span names
+
+`agentSpanName` controls root text/object generation span names. The strings
+`'modelId'` (default) and `'functionId'` select a naming strategy, producing
+`invoke_agent {modelId}` or `invoke_agent {telemetry.functionId}`:
+
+```ts
+registerTelemetry(new OpenTelemetry({ agentSpanName: 'functionId' }));
+// With telemetry: { functionId: 'travel-planner' }, the span is:
+// invoke_agent travel-planner
+```
+
+For a literal custom name, use a callback returning the complete span name:
+
+```ts
+registerTelemetry(new OpenTelemetry({ agentSpanName: () => 'my-custom-span' }));
+```
+
+The callback receives `{ modelId, functionId }` for dynamic names. If it returns
+`undefined` or throws, the default name is used. The `'functionId'` strategy also
+falls back to `modelId` when `functionId` is absent. Child span names and
+attributes are unchanged.
+
 ## Custom Tracer
 
 If you want your traces to use a `TracerProvider` other than the one provided by the `@opentelemetry/api` singleton, pass a custom `Tracer` to the `OpenTelemetry` constructor:
@@ -481,7 +504,7 @@ By default, attributes use the `gen_ai.*` prefix. Provider names are mapped to w
 
 For `generateText` and `streamText`, the integration records 3 types of spans:
 
-- **`invoke_agent {modelId}`** (root span, `INTERNAL`): covers the full operation including all steps and tool calls.
+- **`invoke_agent {modelId}`** (default root span name, `INTERNAL`): covers the full operation including all steps and tool calls. Use [`agentSpanName`](#agent-span-names) to customize the name.
 
   Initial attributes:
   - `gen_ai.operation.name`: `"invoke_agent"`
@@ -739,7 +762,7 @@ registerTelemetry(
 );
 ```
 
-This does not create additional AI SDK-specific spans such as `ai.generateText`, `ai.generateText.doGenerate`, or `ai.toolCall`. Instead, it adds only the selected supplemental attributes to the spans emitted by `OpenTelemetry`, such as `invoke_agent {modelId}`, `step {n}`, `chat {modelId}`, and `execute_tool {toolName}`.
+This does not create additional AI SDK-specific spans such as `ai.generateText`, `ai.generateText.doGenerate`, or `ai.toolCall`. Instead, it adds only the selected supplemental attributes to the spans emitted by `OpenTelemetry`, such as the default root span `invoke_agent {modelId}`, `step {n}`, `chat {modelId}`, and `execute_tool {toolName}`.
 
 All supplemental attributes are disabled by default. Enable only the data you want to collect:
 

package/docs/03-ai-sdk-harnesses/05-harness-adapters.mdx

@@ -40,7 +40,7 @@ The AI SDK includes the following harness adapters:
 | [Codex](/providers/ai-sdk-harnesses/codex)                   | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Cross />              | <Cross />                    | <Check />   | <Cross />      |
 | [Cursor](/providers/ai-sdk-harnesses/cursor)                 | Sandbox via ACP  | <Check />    | <Check />     | <Cross />         | <Cross />              | <Cross />                    | <Check />   | <Cross />      |
 | [Deep Agents](/providers/ai-sdk-harnesses/deepagents)        | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Check />              | <Check /> via auto-rejection | <Check />   | <Cross />      |
-| [fx](/providers/ai-sdk-harnesses/fx)                         | Host process     | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Cross />   | <Cross />      |
+| [fx](/providers/ai-sdk-harnesses/fx)                         | Host process     | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Check />   | <Cross />      |
 | [GitHub Copilot](/providers/ai-sdk-harnesses/github-copilot) | Sandbox via ACP  | <Check />    | <Check />     | <Cross />         | <Cross />              | <Cross />                    | <Check />   | <Cross />      |
 | [Grok Build](/providers/ai-sdk-harnesses/grok-build)         | Sandbox via ACP  | <Check />    | <Check />     | <Check />         | <Cross />              | <Cross />                    | <Check />   | <Cross />      |
 | [OpenCode](/providers/ai-sdk-harnesses/opencode)             | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Check />   | <Cross />      |

package/docs/07-reference/01-ai-sdk-core/01-generate-text.mdx

@@ -1735,7 +1735,7 @@ To see `generateText` in action, check out [these examples](#examples).
             },
             {
               name: 'finishReason',
-              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "other"',
+              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "interrupted" | "other"',
               description: 'The unified reason why the generation finished.',
             },
             {
@@ -2029,7 +2029,7 @@ To see `generateText` in action, check out [these examples](#examples).
             },
             {
               name: 'finishReason',
-              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "other"',
+              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "interrupted" | "other"',
               description: 'The unified reason why the generation finished.',
             },
             {
@@ -2634,7 +2634,7 @@ To see `generateText` in action, check out [these examples](#examples).
     },
     {
       name: 'finishReason',
-      type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+      type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
       description: 'The reason the model finished generating the text.',
     },
     {
@@ -3039,7 +3039,7 @@ To see `generateText` in action, check out [these examples](#examples).
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               description: 'The reason why the generation finished.',
             },
             {

package/docs/07-reference/01-ai-sdk-core/02-stream-text.mdx

@@ -1411,7 +1411,7 @@ retain the content their contracts require.
             },
             {
               name: 'finishReason',
-              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "other"',
+              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "interrupted" | "other"',
               description:
                 'The unified finish reason why the generation finished.',
             },
@@ -1746,7 +1746,7 @@ retain the content their contracts require.
           parameters: [
             {
               name: 'finishReason',
-              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "other"',
+              type: '"stop" | "length" | "content-filter" | "tool-calls" | "error" | "interrupted" | "other"',
               description:
                 'The unified finish reason why the generation finished.',
             },
@@ -2674,9 +2674,9 @@ retain the content their contracts require.
     },
     {
       name: 'finishReason',
-      type: "PromiseLike<'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'>",
+      type: "PromiseLike<'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'>",
       description:
-        'The reason why the generation finished. Automatically consumes the stream.',
+        'The reason why the generation finished. A stream that ends cleanly without its provider completion signal can report "interrupted". Partial output is preserved; interruption alone does not emit an error. Streams that produce no output and no finish chunk still reject with NoOutputGeneratedError. OpenAI-compatible retains its existing error behavior. Automatically consumes the stream.',
     },
     {
       name: 'rawFinishReason',
@@ -3165,7 +3165,7 @@ retain the content their contracts require.
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               description: 'The reason the model finished generating the text.',
             },
             {
@@ -3873,7 +3873,7 @@ retain the content their contracts require.
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               description: 'The reason the model finished generating the text.',
             },
             {
@@ -3911,7 +3911,7 @@ retain the content their contracts require.
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               description: 'The reason the model finished generating the text.',
             },
             {

package/docs/07-reference/02-ai-sdk-ui/01-use-chat.mdx

@@ -317,7 +317,7 @@ Allows you to easily create a conversational user interface for your chatbot app
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               isOptional: true,
               description:
                 'The reason why the model finished generating the response. Undefined if the finish reason was not provided by the model.',

package/docs/07-reference/02-ai-sdk-ui/40-create-ui-message-stream.mdx

@@ -179,7 +179,7 @@ outcomes and call `setOutcome` once.
               name: 'finishReason',
               type: 'FinishReason | undefined',
               description:
-                "The reason why the generation finished. One of: 'stop', 'length', 'content-filter', 'tool-calls', 'error', or 'other'.",
+                "The reason why the generation finished. One of: 'stop', 'length', 'content-filter', 'tool-calls', 'error', 'interrupted', or 'other'.",
             },
           ],
         },

package/docs/07-reference/03-ai-sdk-rsc/01-stream-ui.mdx

@@ -649,7 +649,7 @@ To see `streamUI` in action, check out [these examples](#examples).
             },
             {
               name: 'finishReason',
-              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other'",
+              type: "'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other'",
               description: 'The reason the model finished generating the text.',
             },
             {

package/docs/07-reference/05-ai-sdk-errors/ai-tool-choice-violation-error.mdx

@@ -5,14 +5,16 @@ description: Learn how to fix AI SDK ToolChoiceViolationError
 
 # ToolChoiceViolationError
 
-This error occurs when a `generateText` response does not satisfy an enforced
-tool choice. It is thrown when `toolChoice` is set to `'required'` but the
-response contains no structured tool call, or when a specifically selected tool
-was not called.
+This error occurs when a `generateText` or `streamText` response does not satisfy
+an enforced tool choice. It is thrown when `toolChoice` is set to `'none'` but
+the response contains a tool call, when `'required'` produces no structured tool
+call, or when a specifically selected tool was not called. With `streamText`,
+the error is emitted in the stream. Tool calls returned while `'none'` is selected
+are not executed.
 
 The error does not automatically interpret text or reasoning as an executable
-tool call. You can inspect `content` to implement opt-in recovery, including
-schema validation before executing any recovered call.
+tool call. When tool calls are allowed, you can inspect `content` to implement
+opt-in recovery, including schema validation before executing any recovered call.
 
 ## Properties
 
@@ -30,7 +32,10 @@ You can check if an error is an instance of `ToolChoiceViolationError` using:
 ```typescript
 import { ToolChoiceViolationError } from 'ai';
 
-if (ToolChoiceViolationError.isInstance(error)) {
+if (
+  ToolChoiceViolationError.isInstance(error) &&
+  error.toolChoice.type !== 'none'
+) {
   const serializedCall = error.content.find(part => part.type === 'text')?.text;
 
   // Parse and validate serializedCall before treating it as a tool call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.148",
+  "version": "7.0.149",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,20 +42,20 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.121",
-    "@ai-sdk/provider": "4.0.31",
-    "@ai-sdk/provider-utils": "5.0.65"
+    "@ai-sdk/gateway": "4.0.122",
+    "@ai-sdk/provider": "4.0.32",
+    "@ai-sdk/provider-utils": "5.0.66"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.121",
-    "@ai-sdk/deepseek": "3.0.70",
-    "@ai-sdk/google": "4.0.102",
-    "@ai-sdk/groq": "4.0.67",
-    "@ai-sdk/huggingface": "2.0.75",
-    "@ai-sdk/moonshotai": "3.0.74",
-    "@ai-sdk/openai": "4.0.99",
+    "@ai-sdk/amazon-bedrock": "5.0.122",
+    "@ai-sdk/deepseek": "3.0.71",
+    "@ai-sdk/google": "4.0.103",
+    "@ai-sdk/groq": "4.0.68",
+    "@ai-sdk/huggingface": "2.0.76",
+    "@ai-sdk/moonshotai": "3.0.75",
+    "@ai-sdk/openai": "4.0.100",
     "@ai-sdk/test-server": "2.0.4",
-    "@ai-sdk/xai": "5.0.27",
+    "@ai-sdk/xai": "5.0.28",
     "@edge-runtime/vm": "^5.0.0",
     "@smithy/eventstream-codec": "^4.3.3",
     "@smithy/util-utf8": "^4.3.3",

package/src/error/tool-choice-violation-error.ts

@@ -11,7 +11,7 @@ const symbol = Symbol.for(marker);
 
 type EnforcedToolChoice = Extract<
   LanguageModelV4ToolChoice,
-  { type: 'required' } | { type: 'tool' }
+  { type: 'none' } | { type: 'required' } | { type: 'tool' }
 >;
 
 /**
@@ -54,9 +54,11 @@ export class ToolChoiceViolationError extends AISDKError {
     provider,
     modelId,
     content,
-    message = toolChoice.type === 'required'
-      ? 'Model response did not contain a tool call even though tool choice was required.'
-      : `Model response did not contain a call to the required tool '${toolChoice.toolName}'.`,
+    message = toolChoice.type === 'none'
+      ? 'Model response contained a tool call even though tool choice was none.'
+      : toolChoice.type === 'required'
+        ? 'Model response did not contain a tool call even though tool choice was required.'
+        : `Model response did not contain a call to the required tool '${toolChoice.toolName}'.`,
   }: {
     toolChoice: EnforcedToolChoice;
     finishReason: FinishReason;

package/src/generate-text/collect-tool-approvals.ts

@@ -88,6 +88,7 @@ export function collectToolApprovals<TOOLS extends ToolSet>({
 
   const approvedToolApprovals: Array<CollectedToolApprovals<TOOLS>> = [];
   const deniedToolApprovals: Array<CollectedToolApprovals<TOOLS>> = [];
+  const collectedToolCallIds = new Set<string>();
 
   const approvalResponses = lastMessage.content.filter(
     part => part.type === 'tool-approval-response',
@@ -119,6 +120,15 @@ export function collectToolApprovals<TOOLS extends ToolSet>({
       });
     }
 
+    // Only the first response for a tool call is collected. Later responses
+    // (replays, conflicting decisions, or responses to another approval of the
+    // same call) would otherwise execute the tool twice or both execute and
+    // deny it.
+    if (collectedToolCallIds.has(toolCall.toolCallId)) {
+      continue;
+    }
+    collectedToolCallIds.add(toolCall.toolCallId);
+
     const approval: CollectedToolApprovals<TOOLS> = {
       approvalRequest,
       approvalResponse,

package/src/generate-text/generate-text.ts

@@ -939,7 +939,7 @@ export async function generateText<
                 activeTools: prepareStepResult?.activeTools ?? activeTools,
               });
               const {
-                executionTools: stepExecutionTools,
+                executionTools,
                 modelTools: stepModelTools,
                 toolCallerMessages,
               } = prepareToolsForToolCallers({
@@ -969,6 +969,8 @@ export async function generateText<
               const stepToolChoice = prepareToolChoice({
                 toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
               });
+              const stepExecutionTools =
+                stepToolChoice.type === 'none' ? undefined : executionTools;
 
               const stepMessages = appendToolCallerMessages({
                 messages: prepareStepResult?.messages ?? stepInputMessages,
@@ -1097,8 +1099,16 @@ export async function generateText<
                     parseToolCall({
                       toolCall,
                       tools: stepModelTools as TOOLS,
-                      repairToolCall,
-                      refineToolInput,
+                      // tool calls are rejected with tool choice none,
+                      // so user callbacks must not process them:
+                      repairToolCall:
+                        stepToolChoice.type === 'none'
+                          ? undefined
+                          : repairToolCall,
+                      refineToolInput:
+                        stepToolChoice.type === 'none'
+                          ? undefined
+                          : refineToolInput,
                       instructions: stepInstructions,
                       messages: stepMessages,
                       abortSignal: mergedAbortSignal,
@@ -1171,18 +1181,19 @@ export async function generateText<
               });
 
               const enforcedToolChoice =
-                stepToolChoice.type === 'required' ||
-                stepToolChoice.type === 'tool'
-                  ? stepToolChoice
-                  : undefined;
+                stepToolChoice.type === 'auto' ? undefined : stepToolChoice;
 
               if (
                 enforcedToolChoice != null &&
-                !stepToolCalls.some(
-                  toolCall =>
-                    enforcedToolChoice.type === 'required' ||
-                    toolCall.toolName === enforcedToolChoice.toolName,
-                )
+                (enforcedToolChoice.type === 'none'
+                  ? stepToolCalls.length > 0
+                  : currentModelResponse.finishReason.unified !==
+                      'interrupted' &&
+                    !stepToolCalls.some(
+                      toolCall =>
+                        enforcedToolChoice.type === 'required' ||
+                        toolCall.toolName === enforcedToolChoice.toolName,
+                    ))
               ) {
                 throw new ToolChoiceViolationError({
                   toolChoice: enforcedToolChoice,
@@ -1531,6 +1542,7 @@ export async function generateText<
           }
         }
       } while (
+        steps[steps.length - 1].finishReason !== 'interrupted' &&
         // Continue only after all client tool calls have been executed or denied,
         // and if there are client results or pending deferred provider results.
         clientToolOutputs.length + deniedToolApprovalResponses.length ===

package/src/generate-text/stream-language-model-call.ts

@@ -448,6 +448,12 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
   let previousOutputChunkTimestampMs: number | undefined;
   const timeBetweenOutputChunksMs: number[] = [];
 
+  // Tool choice none rejects tool calls when the model call finishes.
+  // Withhold tool parts so that consumers (e.g. client-side tools) cannot
+  // act on them before the rejection, and skip user callbacks that would
+  // repair or refine them.
+  const withholdToolParts = toolChoice.type === 'none';
+
   return new TransformStream<
     LanguageModelV4StreamPart,
     LanguageModelStreamPart<TOOLS>
@@ -467,6 +473,15 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
         previousOutputChunkTimestampMs = outputChunkTimestampMs;
       }
 
+      if (
+        withholdToolParts &&
+        (chunk.type === 'tool-input-start' ||
+          chunk.type === 'tool-input-delta' ||
+          chunk.type === 'tool-input-end')
+      ) {
+        return;
+      }
+
       switch (chunk.type) {
         case 'error':
           controller.enqueue({
@@ -655,17 +670,18 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
           });
 
           const enforcedToolChoice =
-            toolChoice.type === 'required' || toolChoice.type === 'tool'
-              ? toolChoice
-              : undefined;
+            toolChoice.type === 'auto' ? undefined : toolChoice;
 
           const toolChoiceViolationError =
             enforcedToolChoice != null &&
-            ![...toolCallsByToolCallId.values()].some(
-              toolCall =>
-                enforcedToolChoice.type === 'required' ||
-                toolCall.toolName === enforcedToolChoice.toolName,
-            )
+            (enforcedToolChoice.type === 'none'
+              ? toolCallsByToolCallId.size > 0
+              : chunk.finishReason.unified !== 'interrupted' &&
+                ![...toolCallsByToolCallId.values()].some(
+                  toolCall =>
+                    enforcedToolChoice.type === 'required' ||
+                    toolCall.toolName === enforcedToolChoice.toolName,
+                ))
               ? new ToolChoiceViolationError({
                   toolChoice: enforcedToolChoice,
                   finishReason: chunk.finishReason.unified,
@@ -708,17 +724,22 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
             const toolCall = await parseToolCall({
               toolCall: chunk,
               tools,
-              repairToolCall,
-              refineToolInput,
+              repairToolCall: withholdToolParts ? undefined : repairToolCall,
+              refineToolInput: withholdToolParts ? undefined : refineToolInput,
               instructions,
               messages,
               abortSignal,
             });
 
             toolCallsByToolCallId.set(toolCall.toolCallId, toolCall);
-            controller.enqueue(toolCall);
             if (collectContent) modelCallContent.push(toolCall);
 
+            if (withholdToolParts) {
+              break;
+            }
+
+            controller.enqueue(toolCall);
+
             if (toolCall.invalid) {
               if (!toolCall.providerExecuted) {
                 controller.enqueue({
@@ -746,6 +767,10 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
         case 'tool-approval-request': {
           if (collectContent) rawModelCallContent.push(chunk);
 
+          if (withholdToolParts) {
+            break;
+          }
+
           const toolCall = toolCallsByToolCallId.get(chunk.toolCallId);
 
           if (toolCall == null) {
@@ -808,7 +833,7 @@ function createLanguageModelV4StreamPartToLanguageModelStreamPartTransform<
                   : {}),
               } as TypedToolResult<TOOLS>);
 
-          controller.enqueue(toolResultPart);
+          if (!withholdToolParts) controller.enqueue(toolResultPart);
           if (collectContent) modelCallContent.push(toolResultPart);
 
           break;