ai 7.0.147 → 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/18-tools.mdx

@@ -107,6 +107,7 @@ Raw runtime instances need their respective adapters; a custom
 | `sandbox`          | `Experimental_SandboxSession` | Required session for command execution and file operations.                                                                   |
 | `workingDirectory` | `string`                      | Optional absolute starting directory for each command, created if needed. When omitted, uses the sandbox's default directory. |
 | `maxOutputLength`  | `number`                      | Positive integer limiting characters retained from each output stream before a truncation notice. Defaults to `30000`.        |
+| `timeout`          | `number`                      | Optional timeout per command execution, in milliseconds (integer from `1` to `2147483647`). No tool-level timeout by default. |
 
 The model calls the tool with `{ command: string }` and receives
 `{ stdout, stderr, exitCode }`. Nonzero exit codes are returned so the model can
@@ -114,6 +115,24 @@ inspect failures and recover. AI SDK cancellation is forwarded to the session.
 Output truncation happens after execution and does not limit execution memory or
 duration.
 
+### Command timeout
+
+Set `timeout` to cancel commands that run longer than the configured duration:
+
+```ts
+const bash = await createBashTool({
+  sandbox,
+  timeout: 10_000,
+});
+```
+
+Each command gets a fresh timeout starting when its execution begins. This does
+not include tool initialization or time waiting for model output or approval.
+The timeout is combined with the caller's abort signal; either can cancel the
+command. The sandbox must honor cancellation. Its result or error is passed
+through; for example, just-bash returns exit code `124` when a running command is
+cancelled. SDK and sandbox timeouts still apply when this option is omitted.
+
 ### Files and lifecycle
 
 Commands use the sandbox's default working directory unless `workingDirectory`

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/02-harness-agent.mdx

@@ -106,6 +106,38 @@ try {
 }
 ```
 
+### Image Inputs
+
+For harness adapters that support images, you can include an image as a file part
+in the latest user message. Set `mediaType` to the image's MIME type:
+
+```ts
+import { readFileSync } from 'node:fs';
+
+const result = await agent.generate({
+  session,
+  messages: [
+    {
+      role: 'user',
+      content: [
+        {
+          type: 'text',
+          text: 'Describe the image in one sentence.',
+        },
+        {
+          type: 'file',
+          mediaType: 'image/png',
+          data: readFileSync('image.png'),
+        },
+      ],
+    },
+  ],
+});
+```
+
+For image input support, see the
+[adapter capability table](/docs/ai-sdk-harnesses/harness-adapters#adapter-capabilities).
+
 ## Lifecycle Callbacks
 
 Configure lifecycle callbacks on `HarnessAgent` to observe agent calls, model

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/06-advanced/11-secure-url-fetching.mdx

@@ -28,8 +28,8 @@ When the SDK fetches a URL taken from a provider response, it:
 
 - **Rejects private, loopback, and link-local targets** — IPv4 (`10/8`,
   `172.16/12`, `192.168/16`, `127/8`, `169.254/16`, CGNAT, multicast, …) and the
-  equivalent IPv6 ranges, plus `localhost` and `.local`. Non-`http(s)` schemes
-  are rejected too.
+  equivalent IPv6 ranges, plus `localhost`, `.local`, `.localhost`, and
+  `.internal` hostnames. Non-`http(s)` schemes are rejected too.
 - **Re-validates every redirect hop** — a URL that passes but then redirects to
   an internal address is blocked; the redirect is never followed blindly.
 - **Validates DNS at connection time on Node.js** — every resolved address is

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.147",
+  "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.120",
-    "@ai-sdk/provider": "4.0.31",
-    "@ai-sdk/provider-utils": "5.0.64"
+    "@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.120",
-    "@ai-sdk/deepseek": "3.0.69",
-    "@ai-sdk/google": "4.0.101",
-    "@ai-sdk/groq": "4.0.66",
-    "@ai-sdk/huggingface": "2.0.74",
-    "@ai-sdk/moonshotai": "3.0.73",
-    "@ai-sdk/openai": "4.0.98",
+    "@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.26",
+    "@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 ===