ai 5.1.0-beta.20 → 5.1.0-beta.22

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
   asSchema as asSchema5,
   createIdGenerator as createIdGenerator5,
   dynamicTool as dynamicTool2,
-  generateId as generateId2,
+  generateId,
   jsonSchema as jsonSchema2,
   parseJsonEventStream as parseJsonEventStream3,
   tool as tool2,
@@ -20,7 +20,6 @@ import {
 // src/generate-text/generate-text.ts
 import {
   createIdGenerator,
-  executeTool,
   getErrorMessage as getErrorMessage5,
   withUserAgentSuffix as withUserAgentSuffix2
 } from "@ai-sdk/provider-utils";
@@ -717,7 +716,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "5.1.0-beta.20" : "0.0.0-test";
+var VERSION = true ? "5.1.0-beta.22" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({ url }) => {
@@ -863,12 +862,26 @@ async function convertToLanguageModelPrompt({
     download2,
     supportedUrls
   );
-  return [
+  const messages = [
     ...prompt.system != null ? [{ role: "system", content: prompt.system }] : [],
     ...prompt.messages.map(
       (message) => convertToLanguageModelMessage({ message, downloadedAssets })
     )
   ];
+  const combinedMessages = [];
+  for (const message of messages) {
+    if (message.role !== "tool") {
+      combinedMessages.push(message);
+      continue;
+    }
+    const lastCombinedMessage = combinedMessages.at(-1);
+    if ((lastCombinedMessage == null ? void 0 : lastCombinedMessage.role) === "tool") {
+      lastCombinedMessage.content.push(...message.content);
+    } else {
+      combinedMessages.push(message);
+    }
+  }
+  return combinedMessages;
 }
 function convertToLanguageModelMessage({
   message,
@@ -910,6 +923,8 @@ function convertToLanguageModelMessage({
         content: message.content.filter(
           // remove empty text parts (no text, and no provider options):
           (part) => part.type !== "text" || part.text !== "" || part.providerOptions != null
+        ).filter(
+          (part) => part.type !== "tool-approval-request"
         ).map((part) => {
           const providerOptions = part.providerOptions;
           switch (part.type) {
@@ -966,7 +981,7 @@ function convertToLanguageModelMessage({
     case "tool": {
       return {
         role: "tool",
-        content: message.content.map((part) => ({
+        content: message.content.filter((part) => part.type !== "tool-approval-response").map((part) => ({
           type: "tool-result",
           toolCallId: part.toolCallId,
           toolName: part.toolName,
@@ -1078,6 +1093,29 @@ function convertPartToLanguageModelPart(part, downloadedAssets) {
   }
 }
 
+// src/prompt/create-tool-model-output.ts
+import {
+  getErrorMessage as getErrorMessage3
+} from "@ai-sdk/provider";
+function createToolModelOutput({
+  output,
+  tool: tool3,
+  errorMode
+}) {
+  if (errorMode === "text") {
+    return { type: "error-text", value: getErrorMessage3(output) };
+  } else if (errorMode === "json") {
+    return { type: "error-json", value: toJSONValue(output) };
+  }
+  if (tool3 == null ? void 0 : tool3.toModelOutput) {
+    return tool3.toModelOutput(output);
+  }
+  return typeof output === "string" ? { type: "text", value: output } : { type: "json", value: toJSONValue(output) };
+}
+function toJSONValue(value) {
+  return value === void 0 ? null : value;
+}
+
 // src/prompt/prepare-call-settings.ts
 function prepareCallSettings({
   maxOutputTokens,
@@ -1329,6 +1367,17 @@ var toolResultPartSchema = z4.object({
   output: outputSchema,
   providerOptions: providerMetadataSchema.optional()
 });
+var toolApprovalRequestSchema = z4.object({
+  type: z4.literal("tool-approval-request"),
+  approvalId: z4.string(),
+  toolCallId: z4.string()
+});
+var toolApprovalResponseSchema = z4.object({
+  type: z4.literal("tool-approval-response"),
+  approvalId: z4.string(),
+  approved: z4.boolean(),
+  reason: z4.string().optional()
+});
 
 // src/prompt/message.ts
 var systemModelMessageSchema = z5.object(
@@ -1358,7 +1407,8 @@ var assistantModelMessageSchema = z5.object({
         filePartSchema,
         reasoningPartSchema,
         toolCallPartSchema,
-        toolResultPartSchema
+        toolResultPartSchema,
+        toolApprovalRequestSchema
       ])
     )
   ]),
@@ -1367,7 +1417,7 @@ var assistantModelMessageSchema = z5.object({
 var coreAssistantMessageSchema = assistantModelMessageSchema;
 var toolModelMessageSchema = z5.object({
   role: z5.literal("tool"),
-  content: z5.array(toolResultPartSchema),
+  content: z5.array(z5.union([toolResultPartSchema, toolApprovalResponseSchema])),
   providerOptions: providerMetadataSchema.optional()
 });
 var coreToolMessageSchema = toolModelMessageSchema;
@@ -1690,7 +1740,7 @@ function asArray(value) {
 
 // src/util/retry-with-exponential-backoff.ts
 import { APICallError as APICallError2 } from "@ai-sdk/provider";
-import { delay, getErrorMessage as getErrorMessage3, isAbortError } from "@ai-sdk/provider-utils";
+import { delay, getErrorMessage as getErrorMessage4, isAbortError } from "@ai-sdk/provider-utils";
 function getRetryDelayInMs({
   error,
   exponentialBackoffDelay
@@ -1746,7 +1796,7 @@ async function _retryWithExponentialBackoff(f, {
     if (maxRetries === 0) {
       throw error;
     }
-    const errorMessage = getErrorMessage3(error);
+    const errorMessage = getErrorMessage4(error);
     const newErrors = [...errors, error];
     const tryNumber = newErrors.length;
     if (tryNumber > maxRetries) {
@@ -1817,6 +1867,164 @@ function prepareRetries({
   };
 }
 
+// src/generate-text/collect-tool-approvals.ts
+function collectToolApprovals({
+  messages
+}) {
+  const lastMessage = messages.at(-1);
+  if ((lastMessage == null ? void 0 : lastMessage.role) != "tool") {
+    return {
+      approvedToolApprovals: [],
+      deniedToolApprovals: []
+    };
+  }
+  const toolCallsByToolCallId = {};
+  for (const message of messages) {
+    if (message.role === "assistant" && typeof message.content !== "string") {
+      const content = message.content;
+      for (const part of content) {
+        if (part.type === "tool-call") {
+          toolCallsByToolCallId[part.toolCallId] = part;
+        }
+      }
+    }
+  }
+  const toolApprovalRequestsByApprovalId = {};
+  for (const message of messages) {
+    if (message.role === "assistant" && typeof message.content !== "string") {
+      const content = message.content;
+      for (const part of content) {
+        if (part.type === "tool-approval-request") {
+          toolApprovalRequestsByApprovalId[part.approvalId] = part;
+        }
+      }
+    }
+  }
+  const toolResults = {};
+  for (const part of lastMessage.content) {
+    if (part.type === "tool-result") {
+      toolResults[part.toolCallId] = part;
+    }
+  }
+  const approvedToolApprovals = [];
+  const deniedToolApprovals = [];
+  const approvalResponses = lastMessage.content.filter(
+    (part) => part.type === "tool-approval-response"
+  );
+  for (const approvalResponse of approvalResponses) {
+    const approvalRequest = toolApprovalRequestsByApprovalId[approvalResponse.approvalId];
+    if (toolResults[approvalRequest.toolCallId] != null) {
+      continue;
+    }
+    const approval = {
+      approvalRequest,
+      approvalResponse,
+      toolCall: toolCallsByToolCallId[approvalRequest.toolCallId]
+    };
+    if (approvalResponse.approved) {
+      approvedToolApprovals.push(approval);
+    } else {
+      deniedToolApprovals.push(approval);
+    }
+  }
+  return { approvedToolApprovals, deniedToolApprovals };
+}
+
+// src/generate-text/execute-tool-call.ts
+import { executeTool } from "@ai-sdk/provider-utils";
+async function executeToolCall({
+  toolCall,
+  tools,
+  tracer,
+  telemetry,
+  messages,
+  abortSignal,
+  experimental_context,
+  onPreliminaryToolResult
+}) {
+  const { toolName, toolCallId, input } = toolCall;
+  const tool3 = tools == null ? void 0 : tools[toolName];
+  if ((tool3 == null ? void 0 : tool3.execute) == null) {
+    return void 0;
+  }
+  return recordSpan({
+    name: "ai.toolCall",
+    attributes: selectTelemetryAttributes({
+      telemetry,
+      attributes: {
+        ...assembleOperationName({
+          operationId: "ai.toolCall",
+          telemetry
+        }),
+        "ai.toolCall.name": toolName,
+        "ai.toolCall.id": toolCallId,
+        "ai.toolCall.args": {
+          output: () => JSON.stringify(input)
+        }
+      }
+    }),
+    tracer,
+    fn: async (span) => {
+      let output;
+      try {
+        const stream = executeTool({
+          execute: tool3.execute.bind(tool3),
+          input,
+          options: {
+            toolCallId,
+            messages,
+            abortSignal,
+            experimental_context
+          }
+        });
+        for await (const part of stream) {
+          if (part.type === "preliminary") {
+            onPreliminaryToolResult == null ? void 0 : onPreliminaryToolResult({
+              ...toolCall,
+              type: "tool-result",
+              output: part.output,
+              preliminary: true
+            });
+          } else {
+            output = part.output;
+          }
+        }
+      } catch (error) {
+        recordErrorOnSpan(span, error);
+        return {
+          type: "tool-error",
+          toolCallId,
+          toolName,
+          input,
+          error,
+          dynamic: tool3.type === "dynamic"
+        };
+      }
+      try {
+        span.setAttributes(
+          selectTelemetryAttributes({
+            telemetry,
+            attributes: {
+              "ai.toolCall.result": {
+                output: () => JSON.stringify(output)
+              }
+            }
+          })
+        );
+      } catch (ignored) {
+      }
+      return {
+        type: "tool-result",
+        toolCallId,
+        toolName,
+        input,
+        output,
+        dynamic: tool3.type === "dynamic"
+      };
+    }
+  });
+}
+
 // src/generate-text/extract-text-content.ts
 function extractTextContent(content) {
   const parts = content.filter(
@@ -2046,29 +2254,6 @@ async function isStopConditionMet({
   return (await Promise.all(stopConditions.map((condition) => condition({ steps })))).some((result) => result);
 }
 
-// src/prompt/create-tool-model-output.ts
-import {
-  getErrorMessage as getErrorMessage4
-} from "@ai-sdk/provider";
-function createToolModelOutput({
-  output,
-  tool: tool3,
-  errorMode
-}) {
-  if (errorMode === "text") {
-    return { type: "error-text", value: getErrorMessage4(output) };
-  } else if (errorMode === "json") {
-    return { type: "error-json", value: toJSONValue(output) };
-  }
-  if (tool3 == null ? void 0 : tool3.toModelOutput) {
-    return tool3.toModelOutput(output);
-  }
-  return typeof output === "string" ? { type: "text", value: output } : { type: "json", value: toJSONValue(output) };
-}
-function toJSONValue(value) {
-  return value === void 0 ? null : value;
-}
-
 // src/generate-text/to-response-messages.ts
 function toResponseMessages({
   content: inputContent,
@@ -2132,6 +2317,12 @@ function toResponseMessages({
           }),
           providerOptions: part.providerMetadata
         };
+      case "tool-approval-request":
+        return {
+          type: "tool-approval-request",
+          approvalId: part.approvalId,
+          toolCallId: part.toolCall.toolCallId
+        };
     }
   });
   if (content.length > 0) {
@@ -2186,7 +2377,7 @@ async function generateText({
   experimental_download: download2,
   experimental_context,
   _internal: {
-    generateId: generateId3 = originalGenerateId,
+    generateId: generateId2 = originalGenerateId,
     currentDate = () => /* @__PURE__ */ new Date()
   } = {},
   onStepFinish,
@@ -2238,17 +2429,55 @@ async function generateText({
       tracer,
       fn: async (span) => {
         var _a17, _b, _c, _d, _e, _f, _g;
+        const initialMessages = initialPrompt.messages;
+        const responseMessages = [];
+        const { approvedToolApprovals, deniedToolApprovals } = collectToolApprovals({ messages: initialMessages });
+        if (deniedToolApprovals.length > 0 || approvedToolApprovals.length > 0) {
+          const toolOutputs = await executeTools({
+            toolCalls: approvedToolApprovals.map(
+              (toolApproval) => toolApproval.toolCall
+            ),
+            tools,
+            tracer,
+            telemetry,
+            messages: initialMessages,
+            abortSignal,
+            experimental_context
+          });
+          responseMessages.push({
+            role: "tool",
+            content: [
+              // add regular tool results for approved tool calls:
+              ...toolOutputs.map((output2) => ({
+                type: "tool-result",
+                toolCallId: output2.toolCallId,
+                toolName: output2.toolName,
+                output: createToolModelOutput({
+                  tool: tools == null ? void 0 : tools[output2.toolName],
+                  output: output2.type === "tool-result" ? output2.output : output2.error,
+                  errorMode: output2.type === "tool-error" ? "json" : "none"
+                })
+              })),
+              // add execution denied tool results for denied tool approvals:
+              ...deniedToolApprovals.map((toolApproval) => ({
+                type: "tool-result",
+                toolCallId: toolApproval.toolCall.toolCallId,
+                toolName: toolApproval.toolCall.toolName,
+                output: {
+                  type: "execution-denied",
+                  reason: toolApproval.approvalResponse.reason
+                }
+              }))
+            ]
+          });
+        }
         const callSettings2 = prepareCallSettings(settings);
         let currentModelResponse;
         let clientToolCalls = [];
         let clientToolOutputs = [];
-        const responseMessages = [];
         const steps = [];
         do {
-          const stepInputMessages = [
-            ...initialPrompt.messages,
-            ...responseMessages
-          ];
+          const stepInputMessages = [...initialMessages, ...responseMessages];
           const prepareStepResult = await (prepareStep == null ? void 0 : prepareStep({
             model,
             steps,
@@ -2324,7 +2553,7 @@ async function generateText({
                     headers: headersWithUserAgent
                   });
                   const responseData = {
-                    id: (_b2 = (_a19 = result.response) == null ? void 0 : _a19.id) != null ? _b2 : generateId3(),
+                    id: (_b2 = (_a19 = result.response) == null ? void 0 : _a19.id) != null ? _b2 : generateId2(),
                     timestamp: (_d2 = (_c2 = result.response) == null ? void 0 : _c2.timestamp) != null ? _d2 : currentDate(),
                     modelId: (_f2 = (_e2 = result.response) == null ? void 0 : _e2.modelId) != null ? _f2 : stepModel.modelId,
                     headers: (_g2 = result.response) == null ? void 0 : _g2.headers,
@@ -2380,6 +2609,7 @@ async function generateText({
               })
             )
           );
+          const toolApprovalRequests = {};
           for (const toolCall of stepToolCalls) {
             if (toolCall.invalid) {
               continue;
@@ -2394,6 +2624,13 @@ async function generateText({
                 experimental_context
               });
             }
+            if (tool3 == null ? void 0 : tool3.needsApproval) {
+              toolApprovalRequests[toolCall.toolCallId] = {
+                type: "tool-approval-request",
+                approvalId: generateId2(),
+                toolCall
+              };
+            }
           }
           const invalidToolCalls = stepToolCalls.filter(
             (toolCall) => toolCall.invalid && toolCall.dynamic
@@ -2416,7 +2653,7 @@ async function generateText({
             clientToolOutputs.push(
               ...await executeTools({
                 toolCalls: clientToolCalls.filter(
-                  (toolCall) => !toolCall.invalid
+                  (toolCall) => !toolCall.invalid && toolApprovalRequests[toolCall.toolCallId] == null
                 ),
                 tools,
                 tracer,
@@ -2430,7 +2667,8 @@ async function generateText({
           const stepContent = asContent({
             content: currentModelResponse.content,
             toolCalls: stepToolCalls,
-            toolOutputs: clientToolOutputs
+            toolOutputs: clientToolOutputs,
+            toolApprovalRequests: Object.values(toolApprovalRequests)
           });
           responseMessages.push(
             ...toResponseMessages({
@@ -2511,81 +2749,17 @@ async function executeTools({
   experimental_context
 }) {
   const toolOutputs = await Promise.all(
-    toolCalls.map(async ({ toolCallId, toolName, input }) => {
-      const tool3 = tools[toolName];
-      if ((tool3 == null ? void 0 : tool3.execute) == null) {
-        return void 0;
-      }
-      return recordSpan({
-        name: "ai.toolCall",
-        attributes: selectTelemetryAttributes({
-          telemetry,
-          attributes: {
-            ...assembleOperationName({
-              operationId: "ai.toolCall",
-              telemetry
-            }),
-            "ai.toolCall.name": toolName,
-            "ai.toolCall.id": toolCallId,
-            "ai.toolCall.args": {
-              output: () => JSON.stringify(input)
-            }
-          }
-        }),
+    toolCalls.map(
+      async (toolCall) => executeToolCall({
+        toolCall,
+        tools,
         tracer,
-        fn: async (span) => {
-          try {
-            const stream = executeTool({
-              execute: tool3.execute.bind(tool3),
-              input,
-              options: {
-                toolCallId,
-                messages,
-                abortSignal,
-                experimental_context
-              }
-            });
-            let output;
-            for await (const part of stream) {
-              if (part.type === "final") {
-                output = part.output;
-              }
-            }
-            try {
-              span.setAttributes(
-                selectTelemetryAttributes({
-                  telemetry,
-                  attributes: {
-                    "ai.toolCall.result": {
-                      output: () => JSON.stringify(output)
-                    }
-                  }
-                })
-              );
-            } catch (ignored) {
-            }
-            return {
-              type: "tool-result",
-              toolCallId,
-              toolName,
-              input,
-              output,
-              dynamic: tool3.type === "dynamic"
-            };
-          } catch (error) {
-            recordErrorOnSpan(span, error);
-            return {
-              type: "tool-error",
-              toolCallId,
-              toolName,
-              input,
-              error,
-              dynamic: tool3.type === "dynamic"
-            };
-          }
-        }
-      });
-    })
+        telemetry,
+        messages,
+        abortSignal,
+        experimental_context
+      })
+    )
   );
   return toolOutputs.filter(
     (output) => output != null
@@ -2690,7 +2864,8 @@ function asToolCalls(content) {
 function asContent({
   content,
   toolCalls,
-  toolOutputs
+  toolOutputs,
+  toolApprovalRequests
 }) {
   return [
     ...content.map((part) => {
@@ -2740,7 +2915,8 @@ function asContent({
         }
       }
     }),
-    ...toolOutputs
+    ...toolOutputs,
+    ...toolApprovalRequests
   ];
 }
 
@@ -2946,6 +3122,11 @@ var uiMessageChunkSchema = z7.union([
     dynamic: z7.boolean().optional(),
     errorText: z7.string()
   }),
+  z7.strictObject({
+    type: z7.literal("tool-approval-request"),
+    approvalId: z7.string(),
+    toolCallId: z7.string()
+  }),
   z7.strictObject({
     type: z7.literal("tool-output-available"),
     toolCallId: z7.string(),
@@ -2961,6 +3142,10 @@ var uiMessageChunkSchema = z7.union([
     providerExecuted: z7.boolean().optional(),
     dynamic: z7.boolean().optional()
   }),
+  z7.strictObject({
+    type: z7.literal("tool-output-denied"),
+    toolCallId: z7.string()
+  }),
   z7.strictObject({
     type: z7.literal("reasoning-start"),
     id: z7.string(),
@@ -3745,6 +3930,21 @@ function processUIMessageStream({
               write();
               break;
             }
+            case "tool-approval-request": {
+              const toolInvocation = getToolInvocation(chunk.toolCallId);
+              toolInvocation.state = "approval-requested";
+              toolInvocation.approval = {
+                id: chunk.approvalId
+              };
+              write();
+              break;
+            }
+            case "tool-output-denied": {
+              const toolInvocation = getToolInvocation(chunk.toolCallId);
+              toolInvocation.state = "output-denied";
+              write();
+              break;
+            }
             case "tool-output-available": {
               if (chunk.dynamic) {
                 const toolInvocation = getDynamicToolInvocation(
@@ -4096,10 +4296,10 @@ function createStitchableStream() {
       const { value, done } = await innerStreamReaders[0].read();
       if (done) {
         innerStreamReaders.shift();
-        if (innerStreamReaders.length > 0) {
-          await processPull();
-        } else if (isClosed) {
+        if (innerStreamReaders.length === 0 && isClosed) {
           controller == null ? void 0 : controller.close();
+        } else {
+          await processPull();
         }
       } else {
         controller == null ? void 0 : controller.enqueue(value);
@@ -4196,8 +4396,6 @@ function now() {
 
 // src/generate-text/run-tools-transformation.ts
 import {
-  executeTool as executeTool2,
-  generateId,
   getErrorMessage as getErrorMessage6
 } from "@ai-sdk/provider-utils";
 function runToolsTransformation({
@@ -4209,7 +4407,8 @@ function runToolsTransformation({
   messages,
   abortSignal,
   repairToolCall,
-  experimental_context
+  experimental_context,
+  generateId: generateId2
 }) {
   let toolResultsStreamController = null;
   const toolResultsStream = new ReadableStream({
@@ -4291,7 +4490,6 @@ function runToolsTransformation({
               break;
             }
             const tool3 = tools[toolCall.toolName];
-            toolInputs.set(toolCall.toolCallId, toolCall.input);
             if (tool3.onInputAvailable != null) {
               await tool3.onInputAvailable({
                 input: toolCall.input,
@@ -4301,79 +4499,33 @@ function runToolsTransformation({
                 experimental_context
               });
             }
+            if (tool3.needsApproval) {
+              toolResultsStreamController.enqueue({
+                type: "tool-approval-request",
+                approvalId: generateId2(),
+                toolCall
+              });
+              break;
+            }
+            toolInputs.set(toolCall.toolCallId, toolCall.input);
             if (tool3.execute != null && toolCall.providerExecuted !== true) {
-              const toolExecutionId = generateId();
+              const toolExecutionId = generateId2();
               outstandingToolResults.add(toolExecutionId);
-              recordSpan({
-                name: "ai.toolCall",
-                attributes: selectTelemetryAttributes({
-                  telemetry,
-                  attributes: {
-                    ...assembleOperationName({
-                      operationId: "ai.toolCall",
-                      telemetry
-                    }),
-                    "ai.toolCall.name": toolCall.toolName,
-                    "ai.toolCall.id": toolCall.toolCallId,
-                    "ai.toolCall.args": {
-                      output: () => JSON.stringify(toolCall.input)
-                    }
-                  }
-                }),
+              executeToolCall({
+                toolCall,
+                tools,
                 tracer,
-                fn: async (span) => {
-                  let output;
-                  try {
-                    const stream = executeTool2({
-                      execute: tool3.execute.bind(tool3),
-                      input: toolCall.input,
-                      options: {
-                        toolCallId: toolCall.toolCallId,
-                        messages,
-                        abortSignal,
-                        experimental_context
-                      }
-                    });
-                    for await (const part of stream) {
-                      toolResultsStreamController.enqueue({
-                        ...toolCall,
-                        type: "tool-result",
-                        output: part.output,
-                        ...part.type === "preliminary" && {
-                          preliminary: true
-                        }
-                      });
-                      if (part.type === "final") {
-                        output = part.output;
-                      }
-                    }
-                  } catch (error) {
-                    recordErrorOnSpan(span, error);
-                    toolResultsStreamController.enqueue({
-                      ...toolCall,
-                      type: "tool-error",
-                      error
-                    });
-                    outstandingToolResults.delete(toolExecutionId);
-                    attemptClose();
-                    return;
-                  }
-                  outstandingToolResults.delete(toolExecutionId);
-                  attemptClose();
-                  try {
-                    span.setAttributes(
-                      selectTelemetryAttributes({
-                        telemetry,
-                        attributes: {
-                          "ai.toolCall.result": {
-                            output: () => JSON.stringify(output)
-                          }
-                        }
-                      })
-                    );
-                  } catch (ignored) {
-                  }
+                telemetry,
+                messages,
+                abortSignal,
+                experimental_context,
+                onPreliminaryToolResult: (result) => {
+                  toolResultsStreamController.enqueue(result);
                 }
+              }).then((result) => {
+                toolResultsStreamController.enqueue(result);
+                outstandingToolResults.delete(toolExecutionId);
+                attemptClose();
               });
             }
           } catch (error) {
@@ -4478,7 +4630,7 @@ function streamText({
   experimental_context,
   _internal: {
     now: now2 = now,
-    generateId: generateId3 = originalGenerateId2,
+    generateId: generateId2 = originalGenerateId2,
     currentDate = () => /* @__PURE__ */ new Date()
   } = {},
   ...settings
@@ -4510,7 +4662,7 @@ function streamText({
     onStepFinish,
     now: now2,
     currentDate,
-    generateId: generateId3,
+    generateId: generateId2,
     experimental_context,
     download: download2
   });
@@ -4603,7 +4755,7 @@ var DefaultStreamTextResult = class {
     includeRawChunks,
     now: now2,
     currentDate,
-    generateId: generateId3,
+    generateId: generateId2,
     onChunk,
     onError,
     onFinish,
@@ -4728,10 +4880,16 @@ var DefaultStreamTextResult = class {
         if (part.type === "tool-result" && !part.preliminary) {
           recordedContent.push(part);
         }
+        if (part.type === "tool-approval-request") {
+          recordedContent.push(part);
+        }
         if (part.type === "tool-error") {
           recordedContent.push(part);
         }
         if (part.type === "start-step") {
+          recordedContent = [];
+          activeReasoningContent = {};
+          activeTextContent = {};
           recordedRequest = part.request;
           recordedWarnings = part.warnings;
         }
@@ -4755,9 +4913,6 @@ var DefaultStreamTextResult = class {
           await (onStepFinish == null ? void 0 : onStepFinish(currentStepResult));
           logWarnings(recordedWarnings);
           recordedSteps.push(currentStepResult);
-          recordedContent = [];
-          activeReasoningContent = {};
-          activeTextContent = {};
           recordedResponseMessages.push(...stepMessages);
           stepFinish.resolve();
         }
@@ -4917,6 +5072,82 @@ var DefaultStreamTextResult = class {
       endWhenDone: false,
       fn: async (rootSpanArg) => {
         rootSpan = rootSpanArg;
+        const initialPrompt = await standardizePrompt({
+          system,
+          prompt,
+          messages
+        });
+        const initialMessages = initialPrompt.messages;
+        const initialResponseMessages = [];
+        const { approvedToolApprovals, deniedToolApprovals } = collectToolApprovals({ messages: initialMessages });
+        if (deniedToolApprovals.length > 0 || approvedToolApprovals.length > 0) {
+          let toolExecutionStepStreamController;
+          const toolExecutionStepStream = new ReadableStream({
+            start(controller) {
+              toolExecutionStepStreamController = controller;
+            }
+          });
+          self.addStream(toolExecutionStepStream);
+          try {
+            for (const toolApproval of deniedToolApprovals) {
+              toolExecutionStepStreamController == null ? void 0 : toolExecutionStepStreamController.enqueue({
+                type: "tool-output-denied",
+                toolCallId: toolApproval.toolCall.toolCallId,
+                toolName: toolApproval.toolCall.toolName
+              });
+            }
+            const toolOutputs = [];
+            await Promise.all(
+              approvedToolApprovals.map(async (toolApproval) => {
+                const result = await executeToolCall({
+                  toolCall: toolApproval.toolCall,
+                  tools,
+                  tracer,
+                  telemetry,
+                  messages: initialMessages,
+                  abortSignal,
+                  experimental_context,
+                  onPreliminaryToolResult: (result2) => {
+                    toolExecutionStepStreamController == null ? void 0 : toolExecutionStepStreamController.enqueue(result2);
+                  }
+                });
+                if (result != null) {
+                  toolExecutionStepStreamController == null ? void 0 : toolExecutionStepStreamController.enqueue(result);
+                  toolOutputs.push(result);
+                }
+              })
+            );
+            initialResponseMessages.push({
+              role: "tool",
+              content: [
+                // add regular tool results for approved tool calls:
+                ...toolOutputs.map((output2) => ({
+                  type: "tool-result",
+                  toolCallId: output2.toolCallId,
+                  toolName: output2.toolName,
+                  output: createToolModelOutput({
+                    tool: tools == null ? void 0 : tools[output2.toolName],
+                    output: output2.type === "tool-result" ? output2.output : output2.error,
+                    errorMode: output2.type === "tool-error" ? "json" : "none"
+                  })
+                })),
+                // add execution denied tool results for denied tool approvals:
+                ...deniedToolApprovals.map((toolApproval) => ({
+                  type: "tool-result",
+                  toolCallId: toolApproval.toolCall.toolCallId,
+                  toolName: toolApproval.toolCall.toolName,
+                  output: {
+                    type: "execution-denied",
+                    reason: toolApproval.approvalResponse.reason
+                  }
+                }))
+              ]
+            });
+          } finally {
+            toolExecutionStepStreamController == null ? void 0 : toolExecutionStepStreamController.close();
+          }
+        }
+        recordedResponseMessages.push(...initialResponseMessages);
         async function streamStep({
           currentStep,
           responseMessages,
@@ -4925,15 +5156,7 @@ var DefaultStreamTextResult = class {
           var _a17, _b, _c, _d, _e;
           const includeRawChunks2 = self.includeRawChunks;
           stepFinish = new DelayedPromise();
-          const initialPrompt = await standardizePrompt({
-            system,
-            prompt,
-            messages
-          });
-          const stepInputMessages = [
-            ...initialPrompt.messages,
-            ...responseMessages
-          ];
+          const stepInputMessages = [...initialMessages, ...responseMessages];
           const prepareStepResult = await (prepareStep == null ? void 0 : prepareStep({
             model,
             steps: recordedSteps,
@@ -4999,24 +5222,22 @@ var DefaultStreamTextResult = class {
               }),
               tracer,
               endWhenDone: false,
-              fn: async (doStreamSpan2) => {
-                return {
-                  startTimestampMs: now2(),
-                  // get before the call
-                  doStreamSpan: doStreamSpan2,
-                  result: await stepModel.doStream({
-                    ...callSettings,
-                    tools: stepTools,
-                    toolChoice: stepToolChoice,
-                    responseFormat: output == null ? void 0 : output.responseFormat,
-                    prompt: promptMessages,
-                    providerOptions,
-                    abortSignal,
-                    headers,
-                    includeRawChunks: includeRawChunks2
-                  })
-                };
-              }
+              fn: async (doStreamSpan2) => ({
+                startTimestampMs: now2(),
+                // get before the call
+                doStreamSpan: doStreamSpan2,
+                result: await stepModel.doStream({
+                  ...callSettings,
+                  tools: stepTools,
+                  toolChoice: stepToolChoice,
+                  responseFormat: output == null ? void 0 : output.responseFormat,
+                  prompt: promptMessages,
+                  providerOptions,
+                  abortSignal,
+                  headers,
+                  includeRawChunks: includeRawChunks2
+                })
+              })
             })
           );
           const streamWithToolResults = runToolsTransformation({
@@ -5028,7 +5249,8 @@ var DefaultStreamTextResult = class {
             messages: stepInputMessages,
             repairToolCall,
             abortSignal,
-            experimental_context
+            experimental_context,
+            generateId: generateId2
           });
           const stepRequest = request != null ? request : {};
           const stepToolCalls = [];
@@ -5044,7 +5266,7 @@ var DefaultStreamTextResult = class {
           let stepProviderMetadata;
           let stepFirstChunk = true;
           let stepResponse = {
-            id: generateId3(),
+            id: generateId2(),
             timestamp: currentDate(),
             modelId: model.modelId
           };
@@ -5075,6 +5297,7 @@ var DefaultStreamTextResult = class {
                   }
                   const chunkType = chunk.type;
                   switch (chunkType) {
+                    case "tool-approval-request":
                     case "text-start":
                     case "text-end": {
                       controller.enqueue(chunk);
@@ -5303,7 +5526,7 @@ var DefaultStreamTextResult = class {
         }
         await streamStep({
           currentStep: 0,
-          responseMessages: [],
+          responseMessages: initialResponseMessages,
           usage: {
             inputTokens: void 0,
             outputTokens: void 0,
@@ -5610,6 +5833,14 @@ var DefaultStreamTextResult = class {
               }
               break;
             }
+            case "tool-approval-request": {
+              controller.enqueue({
+                type: "tool-approval-request",
+                approvalId: part.approvalId,
+                toolCallId: part.toolCall.toolCallId
+              });
+              break;
+            }
             case "tool-result": {
               const dynamic = isDynamic(part.toolCallId);
               controller.enqueue({
@@ -5633,6 +5864,13 @@ var DefaultStreamTextResult = class {
               });
               break;
             }
+            case "tool-output-denied": {
+              controller.enqueue({
+                type: "tool-output-denied",
+                toolCallId: part.toolCallId
+              });
+              break;
+            }
             case "error": {
               controller.enqueue({
                 type: "error",
@@ -5877,6 +6115,13 @@ function convertToModelMessages(messages, options) {
                     providerExecuted: part.providerExecuted,
                     ...part.callProviderMetadata != null ? { providerOptions: part.callProviderMetadata } : {}
                   });
+                  if (part.approval != null) {
+                    content.push({
+                      type: "tool-approval-request",
+                      approvalId: part.approval.id,
+                      toolCallId: part.toolCallId
+                    });
+                  }
                   if (part.providerExecuted === true && (part.state === "output-available" || part.state === "output-error")) {
                     content.push({
                       type: "tool-result",
@@ -5905,29 +6150,49 @@ function convertToModelMessages(messages, options) {
             if (toolParts.length > 0) {
               modelMessages.push({
                 role: "tool",
-                content: toolParts.map((toolPart) => {
-                  var _a18;
-                  switch (toolPart.state) {
-                    case "output-error":
-                    case "output-available": {
-                      const toolName = toolPart.type === "dynamic-tool" ? toolPart.toolName : getToolName(toolPart);
-                      return {
-                        type: "tool-result",
-                        toolCallId: toolPart.toolCallId,
-                        toolName,
-                        output: createToolModelOutput({
-                          output: toolPart.state === "output-error" ? toolPart.errorText : toolPart.output,
-                          tool: (_a18 = options == null ? void 0 : options.tools) == null ? void 0 : _a18[toolName],
-                          errorMode: toolPart.state === "output-error" ? "text" : "none"
-                        })
-                      };
+                content: toolParts.flatMap(
+                  (toolPart) => {
+                    var _a18, _b2, _c;
+                    const outputs = [];
+                    if (toolPart.type !== "dynamic-tool" && ((_a18 = toolPart.approval) == null ? void 0 : _a18.approved) != null) {
+                      outputs.push({
+                        type: "tool-approval-response",
+                        approvalId: toolPart.approval.id,
+                        approved: toolPart.approval.approved,
+                        reason: toolPart.approval.reason
+                      });
                     }
-                    default: {
-                      return null;
+                    switch (toolPart.state) {
+                      case "output-denied": {
+                        outputs.push({
+                          type: "tool-result",
+                          toolCallId: toolPart.toolCallId,
+                          toolName: getToolName(toolPart),
+                          output: {
+                            type: "error-text",
+                            value: (_b2 = toolPart.approval.reason) != null ? _b2 : "Tool execution denied."
+                          }
+                        });
+                        break;
+                      }
+                      case "output-error":
+                      case "output-available": {
+                        const toolName = toolPart.type === "dynamic-tool" ? toolPart.toolName : getToolName(toolPart);
+                        outputs.push({
+                          type: "tool-result",
+                          toolCallId: toolPart.toolCallId,
+                          toolName,
+                          output: createToolModelOutput({
+                            output: toolPart.state === "output-error" ? toolPart.errorText : toolPart.output,
+                            tool: (_c = options == null ? void 0 : options.tools) == null ? void 0 : _c[toolName],
+                            errorMode: toolPart.state === "output-error" ? "text" : "none"
+                          })
+                        });
+                        break;
+                      }
                     }
+                    return outputs;
                   }
-                }).filter(
-                  (output) => output != null
                 )
               });
             }
@@ -6961,7 +7226,7 @@ async function generateObject(options) {
     experimental_download: download2,
     providerOptions,
     _internal: {
-      generateId: generateId3 = originalGenerateId3,
+      generateId: generateId2 = originalGenerateId3,
       currentDate = () => /* @__PURE__ */ new Date()
     } = {},
     ...settings
@@ -7085,7 +7350,7 @@ async function generateObject(options) {
                 headers: headersWithUserAgent
               });
               const responseData = {
-                id: (_b = (_a18 = result2.response) == null ? void 0 : _a18.id) != null ? _b : generateId3(),
+                id: (_b = (_a18 = result2.response) == null ? void 0 : _a18.id) != null ? _b : generateId2(),
                 timestamp: (_d = (_c = result2.response) == null ? void 0 : _c.timestamp) != null ? _d : currentDate(),
                 modelId: (_f = (_e = result2.response) == null ? void 0 : _e.modelId) != null ? _f : model.modelId,
                 headers: (_g = result2.response) == null ? void 0 : _g.headers,
@@ -7364,7 +7629,7 @@ function streamObject(options) {
     },
     onFinish,
     _internal: {
-      generateId: generateId3 = originalGenerateId4,
+      generateId: generateId2 = originalGenerateId4,
       currentDate = () => /* @__PURE__ */ new Date(),
       now: now2 = now
     } = {},
@@ -7406,7 +7671,7 @@ function streamObject(options) {
     onError,
     onFinish,
     download: download2,
-    generateId: generateId3,
+    generateId: generateId2,
     currentDate,
     now: now2
   });
@@ -7430,7 +7695,7 @@ var DefaultStreamObjectResult = class {
     onError,
     onFinish,
     download: download2,
-    generateId: generateId3,
+    generateId: generateId2,
     currentDate,
     now: now2
   }) {
@@ -7578,7 +7843,7 @@ var DefaultStreamObjectResult = class {
         let accumulatedText = "";
         let textDelta = "";
         let fullResponse = {
-          id: generateId3(),
+          id: generateId2(),
           timestamp: currentDate(),
           modelId: model.modelId
         };
@@ -7907,7 +8172,7 @@ async function generateSpeech({
   headers
 }) {
   var _a17;
-  if (model.specificationVersion !== "v2") {
+  if (model.specificationVersion !== "v3") {
     throw new UnsupportedModelVersionError({
       version: model.specificationVersion,
       provider: model.provider,
@@ -9261,7 +9526,7 @@ async function transcribe({
   abortSignal,
   headers
 }) {
-  if (model.specificationVersion !== "v2") {
+  if (model.specificationVersion !== "v3") {
     throw new UnsupportedModelVersionError({
       version: model.specificationVersion,
       provider: model.provider,
@@ -9640,8 +9905,8 @@ var DefaultChatTransport = class extends HttpChatTransport {
 // src/ui/chat.ts
 var AbstractChat = class {
   constructor({
-    generateId: generateId3 = generateIdFunc,
-    id = generateId3(),
+    generateId: generateId2 = generateIdFunc,
+    id = generateId2(),
     transport = new DefaultChatTransport(),
     messageMetadataSchema,
     dataPartSchemas,
@@ -9753,6 +10018,33 @@ var AbstractChat = class {
         this.setStatus({ status: "ready" });
       }
     };
+    this.addToolApprovalResponse = async ({
+      id,
+      approved,
+      reason
+    }) => this.jobExecutor.run(async () => {
+      var _a17, _b;
+      const messages = this.state.messages;
+      const lastMessage = messages[messages.length - 1];
+      const updatePart = (part) => isToolUIPart(part) && part.state === "approval-requested" && part.approval.id === id ? {
+        ...part,
+        state: "approval-responded",
+        approval: { id, approved, reason }
+      } : part;
+      this.state.replaceMessage(messages.length - 1, {
+        ...lastMessage,
+        parts: lastMessage.parts.map(updatePart)
+      });
+      if (this.activeResponse) {
+        this.activeResponse.state.message.parts = this.activeResponse.state.message.parts.map(updatePart);
+      }
+      if (this.status !== "streaming" && this.status !== "submitted" && ((_a17 = this.sendAutomaticallyWhen) == null ? void 0 : _a17.call(this, { messages: this.state.messages }))) {
+        this.makeRequest({
+          trigger: "submit-message",
+          messageId: (_b = this.lastMessage) == null ? void 0 : _b.id
+        });
+      }
+    });
     this.addToolResult = async ({
       state = "output-available",
       tool: tool3,
@@ -9763,21 +10055,13 @@ var AbstractChat = class {
       var _a17, _b;
       const messages = this.state.messages;
       const lastMessage = messages[messages.length - 1];
+      const updatePart = (part) => isToolOrDynamicToolUIPart(part) && part.toolCallId === toolCallId ? { ...part, state, output, errorText } : part;
       this.state.replaceMessage(messages.length - 1, {
         ...lastMessage,
-        parts: lastMessage.parts.map(
-          (part) => isToolOrDynamicToolUIPart(part) && part.toolCallId === toolCallId ? { ...part, state, output, errorText } : part
-        )
+        parts: lastMessage.parts.map(updatePart)
       });
       if (this.activeResponse) {
-        this.activeResponse.state.message.parts = this.activeResponse.state.message.parts.map(
-          (part) => isToolOrDynamicToolUIPart(part) && part.toolCallId === toolCallId ? {
-            ...part,
-            state,
-            output,
-            errorText
-          } : part
-        );
+        this.activeResponse.state.message.parts = this.activeResponse.state.message.parts.map(updatePart);
       }
       if (this.status !== "streaming" && this.status !== "submitted" && ((_a17 = this.sendAutomaticallyWhen) == null ? void 0 : _a17.call(this, { messages: this.state.messages }))) {
         this.makeRequest({
@@ -9799,7 +10083,7 @@ var AbstractChat = class {
     };
     this.id = id;
     this.transport = transport;
-    this.generateId = generateId3;
+    this.generateId = generateId2;
     this.messageMetadataSchema = messageMetadataSchema;
     this.dataPartSchemas = dataPartSchemas;
     this.state = state;
@@ -9969,6 +10253,30 @@ var AbstractChat = class {
   }
 };
 
+// src/ui/last-assistant-message-is-complete-with-approval-responses.ts
+function lastAssistantMessageIsCompleteWithApprovalResponses({
+  messages
+}) {
+  const message = messages[messages.length - 1];
+  if (!message) {
+    return false;
+  }
+  if (message.role !== "assistant") {
+    return false;
+  }
+  const lastStepStartIndex = message.parts.reduce((lastIndex, part, index) => {
+    return part.type === "step-start" ? index : lastIndex;
+  }, -1);
+  const lastStepToolInvocations = message.parts.slice(lastStepStartIndex + 1).filter(isToolOrDynamicToolUIPart);
+  return (
+    // has at least one tool approval response
+    lastStepToolInvocations.filter((part) => part.state === "approval-responded").length > 0 && // all tool approvals must have a response
+    lastStepToolInvocations.every(
+      (part) => part.state === "output-available" || part.state === "output-error" || part.state === "approval-responded"
+    )
+  );
+}
+
 // src/ui/last-assistant-message-is-complete-with-tool-calls.ts
 function lastAssistantMessageIsCompleteWithToolCalls({
   messages
@@ -10122,7 +10430,8 @@ var toolUIPartSchemas = [
     providerExecuted: z10.boolean().optional(),
     input: z10.unknown().optional(),
     output: z10.never().optional(),
-    errorText: z10.never().optional()
+    errorText: z10.never().optional(),
+    approval: z10.never().optional()
   }),
   z10.object({
     type: z10.string().startsWith("tool-"),
@@ -10132,7 +10441,38 @@ var toolUIPartSchemas = [
     input: z10.unknown(),
     output: z10.never().optional(),
     errorText: z10.never().optional(),
-    callProviderMetadata: providerMetadataSchema.optional()
+    callProviderMetadata: providerMetadataSchema.optional(),
+    approval: z10.never().optional()
+  }),
+  z10.object({
+    type: z10.string().startsWith("tool-"),
+    toolCallId: z10.string(),
+    state: z10.literal("approval-requested"),
+    input: z10.unknown(),
+    providerExecuted: z10.boolean().optional(),
+    output: z10.never().optional(),
+    errorText: z10.never().optional(),
+    callProviderMetadata: providerMetadataSchema.optional(),
+    approval: z10.object({
+      id: z10.string(),
+      approved: z10.never().optional(),
+      reason: z10.never().optional()
+    })
+  }),
+  z10.object({
+    type: z10.string().startsWith("tool-"),
+    toolCallId: z10.string(),
+    state: z10.literal("approval-responded"),
+    input: z10.unknown(),
+    providerExecuted: z10.boolean().optional(),
+    output: z10.never().optional(),
+    errorText: z10.never().optional(),
+    callProviderMetadata: providerMetadataSchema.optional(),
+    approval: z10.object({
+      id: z10.string(),
+      approved: z10.boolean(),
+      reason: z10.string().optional()
+    })
   }),
   z10.object({
     type: z10.string().startsWith("tool-"),
@@ -10143,7 +10483,12 @@ var toolUIPartSchemas = [
     output: z10.unknown(),
     errorText: z10.never().optional(),
     callProviderMetadata: providerMetadataSchema.optional(),
-    preliminary: z10.boolean().optional()
+    preliminary: z10.boolean().optional(),
+    approval: z10.object({
+      id: z10.string(),
+      approved: z10.literal(true),
+      reason: z10.string().optional()
+    }).optional()
   }),
   z10.object({
     type: z10.string().startsWith("tool-"),
@@ -10153,7 +10498,27 @@ var toolUIPartSchemas = [
     input: z10.unknown(),
     output: z10.never().optional(),
     errorText: z10.string(),
-    callProviderMetadata: providerMetadataSchema.optional()
+    callProviderMetadata: providerMetadataSchema.optional(),
+    approval: z10.object({
+      id: z10.string(),
+      approved: z10.literal(true),
+      reason: z10.string().optional()
+    }).optional()
+  }),
+  z10.object({
+    type: z10.string().startsWith("tool-"),
+    toolCallId: z10.string(),
+    state: z10.literal("output-denied"),
+    providerExecuted: z10.boolean().optional(),
+    input: z10.unknown(),
+    output: z10.never().optional(),
+    errorText: z10.never().optional(),
+    callProviderMetadata: providerMetadataSchema.optional(),
+    approval: z10.object({
+      id: z10.string(),
+      approved: z10.literal(false),
+      reason: z10.string().optional()
+    })
   })
 ];
 var uiMessageSchema = z10.object({
@@ -10298,7 +10663,7 @@ function createUIMessageStream({
   onError = getErrorMessage8,
   originalMessages,
   onFinish,
-  generateId: generateId3 = generateIdFunc2
+  generateId: generateId2 = generateIdFunc2
 }) {
   let controller;
   const ongoingStreamPromises = [];
@@ -10370,7 +10735,7 @@ function createUIMessageStream({
   });
   return handleUIMessageStreamFinish({
     stream,
-    messageId: generateId3(),
+    messageId: generateId2(),
     originalMessages,
     onFinish,
     onError
@@ -10497,7 +10862,7 @@ export {
   transcribe as experimental_transcribe,
   extractReasoningMiddleware,
   gateway2 as gateway,
-  generateId2 as generateId,
+  generateId,
   generateObject,
   generateText,
   getTextFromDataUrl,
@@ -10508,6 +10873,7 @@ export {
   isToolOrDynamicToolUIPart,
   isToolUIPart,
   jsonSchema2 as jsonSchema,
+  lastAssistantMessageIsCompleteWithApprovalResponses,
   lastAssistantMessageIsCompleteWithToolCalls,
   modelMessageSchema,
   parseJsonEventStream3 as parseJsonEventStream,