ai 6.0.304 → 6.0.306

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # ai
 
+## 6.0.306
+
+### Patch Changes
+
+- Updated dependencies [d9244d1]
+  - @ai-sdk/gateway@3.0.214
+
+## 6.0.305
+
+### Patch Changes
+
+- Updated dependencies [604b4d3]
+- Updated dependencies [0a2b345]
+- Updated dependencies [92ef6a5]
+  - @ai-sdk/provider-utils@4.0.58
+  - @ai-sdk/gateway@3.0.213
+
 ## 6.0.304
 
 ### Patch Changes

package/dist/index.js

@@ -1335,7 +1335,7 @@ function detectMediaType({
 var import_provider_utils3 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "6.0.304" : "0.0.0-test";
+var VERSION = true ? "6.0.306" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/index.mjs

@@ -1225,7 +1225,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "6.0.304" : "0.0.0-test";
+var VERSION = true ? "6.0.306" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.js

@@ -164,7 +164,7 @@ function detectMediaType({
 var import_provider_utils2 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "6.0.304" : "0.0.0-test";
+var VERSION = true ? "6.0.306" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.mjs

@@ -144,7 +144,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "6.0.304" : "0.0.0-test";
+var VERSION = true ? "6.0.306" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

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

@@ -180,7 +180,7 @@ for (const part of result.content) {
       type: 'tool-approval-response',
       approvalId: part.approvalId,
       approved: true, // or false to deny
-      reason: 'User confirmed the command', // Optional context for the model
+      reason: 'User confirmed the command', // Optional, see below
     };
     approvals.push(response);
   }
@@ -192,6 +192,19 @@ messages.push({ role: 'tool', content: approvals });
 
 Then call `generateText` again with the updated messages. If approved, the tool executes. If denied, the model receives the denial and can respond accordingly.
 
+The optional `reason` is handled differently depending on the decision:
+
+- **Denied**: the reason is included in the `execution-denied` tool result, so the model can see why the tool call was not executed.
+- **Approved** (tools executed by the AI SDK): the reason remains in the approval response in your messages (e.g. for rendering in the UI or for audit logs). The SDK does not include it in the model prompt, modify the tool's input, or expose it through a dedicated execution option. The model only sees the tool result. In manual `generateText` and `streamText` continuations, the approval response is available to the tool's `execute` function through `options.messages`.
+
+<Note>
+  The approval `reason` is not a channel for passing data to an approved tool.
+  If you need input from the user (for example, an answer to a question or a
+  corrected value), use a tool without an `execute` function and provide its
+  result from the client instead. See [Chatbot Tool
+  Usage](/docs/ai-sdk-ui/chatbot-tool-usage).
+</Note>
+
 <Note>
   When a tool execution is denied, consider adding a system instruction like
   "When a tool execution is not approved, do not retry it" to prevent the model

package/docs/04-ai-sdk-ui/03-chatbot-tool-usage.mdx

@@ -480,6 +480,14 @@ export default function Chat() {
 }
 ```
 
+`addToolApprovalResponse` also accepts an optional `reason`. When a reason is
+supplied with a denial, it is included in the `execution-denied` tool result
+that the model sees. When it is supplied with an approval for a tool executed
+by the AI SDK, it is recorded on the message part, but the SDK does not include
+it in the model prompt, modify the tool's input, or expose it through a
+dedicated execution option. To collect input from the user for a tool, use a
+client-side tool and `addToolOutput` instead.
+
 Approval request chunks can also include an `approvalDescriptor` with opaque
 application-specific metadata. UI message processing exposes it as
 `part.approval.descriptor` in the `approval-requested` state and preserves it in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "6.0.304",
+  "version": "6.0.306",
   "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",
   "sideEffects": false,
@@ -45,9 +45,9 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@ai-sdk/gateway": "3.0.212",
+    "@ai-sdk/gateway": "3.0.214",
     "@ai-sdk/provider": "3.0.18",
-    "@ai-sdk/provider-utils": "4.0.57"
+    "@ai-sdk/provider-utils": "4.0.58"
   },
   "devDependencies": {
     "@edge-runtime/vm": "^5.0.0",
@@ -58,7 +58,7 @@
     "tsx": "^4.19.2",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/google": "3.0.131",
+    "@ai-sdk/google": "3.0.132",
     "@ai-sdk/test-server": "1.0.6",
     "@vercel/ai-tsconfig": "0.0.0"
   },