ai 5.1.0-beta.8 → 6.0.0-beta.29

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";
@@ -98,7 +97,7 @@ import { gateway } from "@ai-sdk/gateway";
 
 // src/error/index.ts
 import {
-  AISDKError as AISDKError17,
+  AISDKError as AISDKError18,
   APICallError,
   EmptyResponseBodyError,
   InvalidPromptError,
@@ -275,13 +274,25 @@ var NoOutputGeneratedError = class extends AISDKError8 {
 };
 _a8 = symbol8;
 
-// src/error/no-such-tool-error.ts
+// src/error/no-speech-generated-error.ts
 import { AISDKError as AISDKError9 } from "@ai-sdk/provider";
+var NoSpeechGeneratedError = class extends AISDKError9 {
+  constructor(options) {
+    super({
+      name: "AI_NoSpeechGeneratedError",
+      message: "No speech audio generated."
+    });
+    this.responses = options.responses;
+  }
+};
+
+// src/error/no-such-tool-error.ts
+import { AISDKError as AISDKError10 } from "@ai-sdk/provider";
 var name9 = "AI_NoSuchToolError";
 var marker9 = `vercel.ai.error.${name9}`;
 var symbol9 = Symbol.for(marker9);
 var _a9;
-var NoSuchToolError = class extends AISDKError9 {
+var NoSuchToolError = class extends AISDKError10 {
   constructor({
     toolName,
     availableTools = void 0,
@@ -293,18 +304,18 @@ var NoSuchToolError = class extends AISDKError9 {
     this.availableTools = availableTools;
   }
   static isInstance(error) {
-    return AISDKError9.hasMarker(error, marker9);
+    return AISDKError10.hasMarker(error, marker9);
   }
 };
 _a9 = symbol9;
 
 // src/error/tool-call-repair-error.ts
-import { AISDKError as AISDKError10, getErrorMessage as getErrorMessage2 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError11, getErrorMessage as getErrorMessage2 } from "@ai-sdk/provider";
 var name10 = "AI_ToolCallRepairError";
 var marker10 = `vercel.ai.error.${name10}`;
 var symbol10 = Symbol.for(marker10);
 var _a10;
-var ToolCallRepairError = class extends AISDKError10 {
+var ToolCallRepairError = class extends AISDKError11 {
   constructor({
     cause,
     originalError,
@@ -315,14 +326,14 @@ var ToolCallRepairError = class extends AISDKError10 {
     this.originalError = originalError;
   }
   static isInstance(error) {
-    return AISDKError10.hasMarker(error, marker10);
+    return AISDKError11.hasMarker(error, marker10);
   }
 };
 _a10 = symbol10;
 
 // src/error/unsupported-model-version-error.ts
-import { AISDKError as AISDKError11 } from "@ai-sdk/provider";
-var UnsupportedModelVersionError = class extends AISDKError11 {
+import { AISDKError as AISDKError12 } from "@ai-sdk/provider";
+var UnsupportedModelVersionError = class extends AISDKError12 {
   constructor(options) {
     super({
       name: "AI_UnsupportedModelVersionError",
@@ -335,12 +346,12 @@ var UnsupportedModelVersionError = class extends AISDKError11 {
 };
 
 // src/prompt/invalid-data-content-error.ts
-import { AISDKError as AISDKError12 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError13 } from "@ai-sdk/provider";
 var name11 = "AI_InvalidDataContentError";
 var marker11 = `vercel.ai.error.${name11}`;
 var symbol11 = Symbol.for(marker11);
 var _a11;
-var InvalidDataContentError = class extends AISDKError12 {
+var InvalidDataContentError = class extends AISDKError13 {
   constructor({
     content,
     cause,
@@ -351,18 +362,18 @@ var InvalidDataContentError = class extends AISDKError12 {
     this.content = content;
   }
   static isInstance(error) {
-    return AISDKError12.hasMarker(error, marker11);
+    return AISDKError13.hasMarker(error, marker11);
   }
 };
 _a11 = symbol11;
 
 // src/prompt/invalid-message-role-error.ts
-import { AISDKError as AISDKError13 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError14 } from "@ai-sdk/provider";
 var name12 = "AI_InvalidMessageRoleError";
 var marker12 = `vercel.ai.error.${name12}`;
 var symbol12 = Symbol.for(marker12);
 var _a12;
-var InvalidMessageRoleError = class extends AISDKError13 {
+var InvalidMessageRoleError = class extends AISDKError14 {
   constructor({
     role,
     message = `Invalid message role: '${role}'. Must be one of: "system", "user", "assistant", "tool".`
@@ -372,18 +383,18 @@ var InvalidMessageRoleError = class extends AISDKError13 {
     this.role = role;
   }
   static isInstance(error) {
-    return AISDKError13.hasMarker(error, marker12);
+    return AISDKError14.hasMarker(error, marker12);
   }
 };
 _a12 = symbol12;
 
 // src/prompt/message-conversion-error.ts
-import { AISDKError as AISDKError14 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError15 } from "@ai-sdk/provider";
 var name13 = "AI_MessageConversionError";
 var marker13 = `vercel.ai.error.${name13}`;
 var symbol13 = Symbol.for(marker13);
 var _a13;
-var MessageConversionError = class extends AISDKError14 {
+var MessageConversionError = class extends AISDKError15 {
   constructor({
     originalMessage,
     message
@@ -393,18 +404,18 @@ var MessageConversionError = class extends AISDKError14 {
     this.originalMessage = originalMessage;
   }
   static isInstance(error) {
-    return AISDKError14.hasMarker(error, marker13);
+    return AISDKError15.hasMarker(error, marker13);
   }
 };
 _a13 = symbol13;
 
 // src/util/download/download-error.ts
-import { AISDKError as AISDKError15 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError16 } from "@ai-sdk/provider";
 var name14 = "AI_DownloadError";
 var marker14 = `vercel.ai.error.${name14}`;
 var symbol14 = Symbol.for(marker14);
 var _a14;
-var DownloadError = class extends AISDKError15 {
+var DownloadError = class extends AISDKError16 {
   constructor({
     url,
     statusCode,
@@ -419,18 +430,18 @@ var DownloadError = class extends AISDKError15 {
     this.statusText = statusText;
   }
   static isInstance(error) {
-    return AISDKError15.hasMarker(error, marker14);
+    return AISDKError16.hasMarker(error, marker14);
   }
 };
 _a14 = symbol14;
 
 // src/util/retry-error.ts
-import { AISDKError as AISDKError16 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError17 } from "@ai-sdk/provider";
 var name15 = "AI_RetryError";
 var marker15 = `vercel.ai.error.${name15}`;
 var symbol15 = Symbol.for(marker15);
 var _a15;
-var RetryError = class extends AISDKError16 {
+var RetryError = class extends AISDKError17 {
   constructor({
     message,
     reason,
@@ -443,34 +454,60 @@ var RetryError = class extends AISDKError16 {
     this.lastError = errors[errors.length - 1];
   }
   static isInstance(error) {
-    return AISDKError16.hasMarker(error, marker15);
+    return AISDKError17.hasMarker(error, marker15);
   }
 };
 _a15 = symbol15;
 
 // src/model/resolve-model.ts
+function transformToV3LanguageModel(model) {
+  return new Proxy(model, {
+    get(target, prop) {
+      if (prop === "specificationVersion")
+        return "v3";
+      return target[prop];
+    }
+  });
+}
+function transformToV3EmbeddingModel(model) {
+  return new Proxy(model, {
+    get(target, prop) {
+      if (prop === "specificationVersion")
+        return "v3";
+      return target[prop];
+    }
+  });
+}
 function resolveLanguageModel(model) {
   if (typeof model !== "string") {
-    if (model.specificationVersion !== "v2") {
+    if (model.specificationVersion !== "v3" && model.specificationVersion !== "v2") {
+      const unsupportedModel = model;
       throw new UnsupportedModelVersionError({
-        version: model.specificationVersion,
-        provider: model.provider,
-        modelId: model.modelId
+        version: unsupportedModel.specificationVersion,
+        provider: unsupportedModel.provider,
+        modelId: unsupportedModel.modelId
       });
     }
+    if (model.specificationVersion === "v2") {
+      return transformToV3LanguageModel(model);
+    }
     return model;
   }
   return getGlobalProvider().languageModel(model);
 }
 function resolveEmbeddingModel(model) {
   if (typeof model !== "string") {
-    if (model.specificationVersion !== "v3") {
+    if (model.specificationVersion !== "v3" && model.specificationVersion !== "v2") {
+      const unsupportedModel = model;
       throw new UnsupportedModelVersionError({
-        version: model.specificationVersion,
-        provider: model.provider,
-        modelId: model.modelId
+        version: unsupportedModel.specificationVersion,
+        provider: unsupportedModel.provider,
+        modelId: unsupportedModel.modelId
       });
     }
+    if (model.specificationVersion === "v2") {
+      return transformToV3EmbeddingModel(model);
+    }
     return model;
   }
   return getGlobalProvider().textEmbeddingModel(
@@ -679,7 +716,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "5.1.0-beta.8" : "0.0.0-test";
+var VERSION = true ? "6.0.0-beta.29" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({ url }) => {
@@ -720,7 +757,7 @@ var createDefaultDownloadFunction = (download2 = download) => (requestedDownload
 );
 
 // src/prompt/data-content.ts
-import { AISDKError as AISDKError18 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError19 } from "@ai-sdk/provider";
 import {
   convertBase64ToUint8Array as convertBase64ToUint8Array2,
   convertUint8ArrayToBase64
@@ -757,7 +794,7 @@ var dataContentSchema = z.union([
     { message: "Must be a Buffer" }
   )
 ]);
-function convertToLanguageModelV2DataContent(content) {
+function convertToLanguageModelV3DataContent(content) {
   if (content instanceof Uint8Array) {
     return { data: content, mediaType: void 0 };
   }
@@ -775,7 +812,7 @@ function convertToLanguageModelV2DataContent(content) {
       content.toString()
     );
     if (dataUrlMediaType == null || base64Content == null) {
-      throw new AISDKError18({
+      throw new AISDKError19({
         name: "InvalidDataContentError",
         message: `Invalid data URL format in content ${content.toString()}`
       });
@@ -825,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,
@@ -872,11 +923,13 @@ 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) {
             case "file": {
-              const { data, mediaType } = convertToLanguageModelV2DataContent(
+              const { data, mediaType } = convertToLanguageModelV3DataContent(
                 part.data
               );
               return {
@@ -928,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,
@@ -972,12 +1025,12 @@ async function downloadAssets(messages, download2, supportedUrls) {
   }));
   const downloadedFiles = await download2(plannedDownloads);
   return Object.fromEntries(
-    downloadedFiles.filter(
-      (downloadedFile) => (downloadedFile == null ? void 0 : downloadedFile.data) != null
-    ).map(({ data, mediaType }, index) => [
-      plannedDownloads[index].url.toString(),
-      { data, mediaType }
-    ])
+    downloadedFiles.map(
+      (file, index) => file == null ? null : [
+        plannedDownloads[index].url.toString(),
+        { data: file.data, mediaType: file.mediaType }
+      ]
+    ).filter((file) => file != null)
   );
 }
 function convertPartToLanguageModelPart(part, downloadedAssets) {
@@ -1001,7 +1054,7 @@ function convertPartToLanguageModelPart(part, downloadedAssets) {
     default:
       throw new Error(`Unsupported part type: ${type}`);
   }
-  const { data: convertedData, mediaType: convertedMediaType } = convertToLanguageModelV2DataContent(originalData);
+  const { data: convertedData, mediaType: convertedMediaType } = convertToLanguageModelV3DataContent(originalData);
   let mediaType = convertedMediaType != null ? convertedMediaType : part.mediaType;
   let data = convertedData;
   if (data instanceof URL) {
@@ -1040,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,
@@ -1291,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(
@@ -1320,7 +1407,8 @@ var assistantModelMessageSchema = z5.object({
         filePartSchema,
         reasoningPartSchema,
         toolCallPartSchema,
-        toolResultPartSchema
+        toolResultPartSchema,
+        toolApprovalRequestSchema
       ])
     )
   ]),
@@ -1329,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;
@@ -1402,10 +1490,10 @@ import {
   GatewayAuthenticationError,
   GatewayModelNotFoundError
 } from "@ai-sdk/gateway";
-import { AISDKError as AISDKError19 } from "@ai-sdk/provider";
+import { AISDKError as AISDKError20 } from "@ai-sdk/provider";
 function wrapGatewayError(error) {
   if (GatewayAuthenticationError.isInstance(error) || GatewayModelNotFoundError.isInstance(error)) {
-    return new AISDKError19({
+    return new AISDKError20({
       name: "GatewayError",
       message: "Vercel AI Gateway access failed. If you want to use AI SDK providers directly, use the providers, e.g. @ai-sdk/openai, or register a different global default provider.",
       cause: error
@@ -1652,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
@@ -1708,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) {
@@ -1779,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(
@@ -1827,6 +2073,26 @@ var DefaultGeneratedFileWithType = class extends DefaultGeneratedFile {
   }
 };
 
+// src/generate-text/is-approval-needed.ts
+async function isApprovalNeeded({
+  tool: tool3,
+  toolCall,
+  messages,
+  experimental_context
+}) {
+  if (tool3.needsApproval == null) {
+    return false;
+  }
+  if (typeof tool3.needsApproval === "boolean") {
+    return tool3.needsApproval;
+  }
+  return await tool3.needsApproval(toolCall.input, {
+    toolCallId: toolCall.toolCallId,
+    messages,
+    experimental_context
+  });
+}
+
 // src/generate-text/parse-tool-call.ts
 import {
   asSchema as asSchema2,
@@ -2008,29 +2274,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,
@@ -2094,6 +2337,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) {
@@ -2148,10 +2397,11 @@ async function generateText({
   experimental_download: download2,
   experimental_context,
   _internal: {
-    generateId: generateId3 = originalGenerateId,
+    generateId: generateId2 = originalGenerateId,
     currentDate = () => /* @__PURE__ */ new Date()
   } = {},
   onStepFinish,
+  onFinish,
   ...settings
 }) {
   const model = resolveLanguageModel(modelArg);
@@ -2200,17 +2450,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,
@@ -2286,7 +2574,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,
@@ -2342,6 +2630,7 @@ async function generateText({
               })
             )
           );
+          const toolApprovalRequests = {};
           for (const toolCall of stepToolCalls) {
             if (toolCall.invalid) {
               continue;
@@ -2356,6 +2645,18 @@ async function generateText({
                 experimental_context
               });
             }
+            if (await isApprovalNeeded({
+              tool: tool3,
+              toolCall,
+              messages: stepInputMessages,
+              experimental_context
+            })) {
+              toolApprovalRequests[toolCall.toolCallId] = {
+                type: "tool-approval-request",
+                approvalId: generateId2(),
+                toolCall
+              };
+            }
           }
           const invalidToolCalls = stepToolCalls.filter(
             (toolCall) => toolCall.invalid && toolCall.dynamic
@@ -2378,7 +2679,7 @@ async function generateText({
             clientToolOutputs.push(
               ...await executeTools({
                 toolCalls: clientToolCalls.filter(
-                  (toolCall) => !toolCall.invalid
+                  (toolCall) => !toolCall.invalid && toolApprovalRequests[toolCall.toolCallId] == null
                 ),
                 tools,
                 tracer,
@@ -2392,7 +2693,8 @@ async function generateText({
           const stepContent = asContent({
             content: currentModelResponse.content,
             toolCalls: stepToolCalls,
-            toolOutputs: clientToolOutputs
+            toolOutputs: clientToolOutputs,
+            toolApprovalRequests: Object.values(toolApprovalRequests)
           });
           responseMessages.push(
             ...toResponseMessages({
@@ -2446,8 +2748,43 @@ async function generateText({
           })
         );
         const lastStep = steps[steps.length - 1];
+        const totalUsage = steps.reduce(
+          (totalUsage2, step) => {
+            return addLanguageModelUsage(totalUsage2, step.usage);
+          },
+          {
+            inputTokens: void 0,
+            outputTokens: void 0,
+            totalTokens: void 0,
+            reasoningTokens: void 0,
+            cachedInputTokens: void 0
+          }
+        );
+        await (onFinish == null ? void 0 : onFinish({
+          finishReason: lastStep.finishReason,
+          usage: lastStep.usage,
+          content: lastStep.content,
+          text: lastStep.text,
+          reasoningText: lastStep.reasoningText,
+          reasoning: lastStep.reasoning,
+          files: lastStep.files,
+          sources: lastStep.sources,
+          toolCalls: lastStep.toolCalls,
+          staticToolCalls: lastStep.staticToolCalls,
+          dynamicToolCalls: lastStep.dynamicToolCalls,
+          toolResults: lastStep.toolResults,
+          staticToolResults: lastStep.staticToolResults,
+          dynamicToolResults: lastStep.dynamicToolResults,
+          request: lastStep.request,
+          response: lastStep.response,
+          warnings: lastStep.warnings,
+          providerMetadata: lastStep.providerMetadata,
+          steps,
+          totalUsage
+        }));
         return new DefaultGenerateTextResult({
           steps,
+          totalUsage,
           resolvedOutput: await (output == null ? void 0 : output.parseOutput(
             { text: lastStep.text },
             {
@@ -2473,81 +2810,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
@@ -2557,6 +2830,7 @@ var DefaultGenerateTextResult = class {
   constructor(options) {
     this.steps = options.steps;
     this.resolvedOutput = options.resolvedOutput;
+    this.totalUsage = options.totalUsage;
   }
   get finalStep() {
     return this.steps[this.steps.length - 1];
@@ -2615,20 +2889,6 @@ var DefaultGenerateTextResult = class {
   get usage() {
     return this.finalStep.usage;
   }
-  get totalUsage() {
-    return this.steps.reduce(
-      (totalUsage, step) => {
-        return addLanguageModelUsage(totalUsage, step.usage);
-      },
-      {
-        inputTokens: void 0,
-        outputTokens: void 0,
-        totalTokens: void 0,
-        reasoningTokens: void 0,
-        cachedInputTokens: void 0
-      }
-    );
-  }
   get experimental_output() {
     if (this.resolvedOutput == null) {
       throw new NoOutputSpecifiedError();
@@ -2652,7 +2912,8 @@ function asToolCalls(content) {
 function asContent({
   content,
   toolCalls,
-  toolOutputs
+  toolOutputs,
+  toolApprovalRequests
 }) {
   return [
     ...content.map((part) => {
@@ -2702,7 +2963,8 @@ function asContent({
         }
       }
     }),
-    ...toolOutputs
+    ...toolOutputs,
+    ...toolApprovalRequests
   ];
 }
 
@@ -2908,6 +3170,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(),
@@ -2923,6 +3190,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(),
@@ -3707,6 +3978,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(
@@ -4058,10 +4344,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);
@@ -4158,8 +4444,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({
@@ -4171,7 +4455,8 @@ function runToolsTransformation({
   messages,
   abortSignal,
   repairToolCall,
-  experimental_context
+  experimental_context,
+  generateId: generateId2
 }) {
   let toolResultsStreamController = null;
   const toolResultsStream = new ReadableStream({
@@ -4253,7 +4538,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,
@@ -4263,79 +4547,38 @@ function runToolsTransformation({
                 experimental_context
               });
             }
+            if (await isApprovalNeeded({
+              tool: tool3,
+              toolCall,
+              messages,
+              experimental_context
+            })) {
+              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) {
@@ -4440,7 +4683,7 @@ function streamText({
   experimental_context,
   _internal: {
     now: now2 = now,
-    generateId: generateId3 = originalGenerateId2,
+    generateId: generateId2 = originalGenerateId2,
     currentDate = () => /* @__PURE__ */ new Date()
   } = {},
   ...settings
@@ -4472,7 +4715,7 @@ function streamText({
     onStepFinish,
     now: now2,
     currentDate,
-    generateId: generateId3,
+    generateId: generateId2,
     experimental_context,
     download: download2
   });
@@ -4565,7 +4808,7 @@ var DefaultStreamTextResult = class {
     includeRawChunks,
     now: now2,
     currentDate,
-    generateId: generateId3,
+    generateId: generateId2,
     onChunk,
     onError,
     onFinish,
@@ -4593,7 +4836,7 @@ var DefaultStreamTextResult = class {
     let activeReasoningContent = {};
     const eventProcessor = new TransformStream({
       async transform(chunk, controller) {
-        var _a17, _b, _c;
+        var _a17, _b, _c, _d;
         controller.enqueue(chunk);
         const { part } = chunk;
         if (part.type === "text-delta" || part.type === "reasoning-delta" || part.type === "source" || part.type === "tool-call" || part.type === "tool-result" || part.type === "tool-input-start" || part.type === "tool-input-delta" || part.type === "raw") {
@@ -4626,6 +4869,18 @@ var DefaultStreamTextResult = class {
           activeText.providerMetadata = (_a17 = part.providerMetadata) != null ? _a17 : activeText.providerMetadata;
         }
         if (part.type === "text-end") {
+          const activeText = activeTextContent[part.id];
+          if (activeText == null) {
+            controller.enqueue({
+              part: {
+                type: "error",
+                error: `text part ${part.id} not found`
+              },
+              partialOutput: void 0
+            });
+            return;
+          }
+          activeText.providerMetadata = (_b = part.providerMetadata) != null ? _b : activeText.providerMetadata;
           delete activeTextContent[part.id];
         }
         if (part.type === "reasoning-start") {
@@ -4649,7 +4904,7 @@ var DefaultStreamTextResult = class {
             return;
           }
           activeReasoning.text += part.text;
-          activeReasoning.providerMetadata = (_b = part.providerMetadata) != null ? _b : activeReasoning.providerMetadata;
+          activeReasoning.providerMetadata = (_c = part.providerMetadata) != null ? _c : activeReasoning.providerMetadata;
         }
         if (part.type === "reasoning-end") {
           const activeReasoning = activeReasoningContent[part.id];
@@ -4663,7 +4918,7 @@ var DefaultStreamTextResult = class {
             });
             return;
           }
-          activeReasoning.providerMetadata = (_c = part.providerMetadata) != null ? _c : activeReasoning.providerMetadata;
+          activeReasoning.providerMetadata = (_d = part.providerMetadata) != null ? _d : activeReasoning.providerMetadata;
           delete activeReasoningContent[part.id];
         }
         if (part.type === "file") {
@@ -4678,10 +4933,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;
         }
@@ -4705,9 +4966,6 @@ var DefaultStreamTextResult = class {
           await (onStepFinish == null ? void 0 : onStepFinish(currentStepResult));
           logWarnings(recordedWarnings);
           recordedSteps.push(currentStepResult);
-          recordedContent = [];
-          activeReasoningContent = {};
-          activeTextContent = {};
           recordedResponseMessages.push(...stepMessages);
           stepFinish.resolve();
         }
@@ -4867,6 +5125,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,
@@ -4875,15 +5209,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,
@@ -4949,24 +5275,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({
@@ -4978,7 +5302,8 @@ var DefaultStreamTextResult = class {
             messages: stepInputMessages,
             repairToolCall,
             abortSignal,
-            experimental_context
+            experimental_context,
+            generateId: generateId2
           });
           const stepRequest = request != null ? request : {};
           const stepToolCalls = [];
@@ -4994,7 +5319,7 @@ var DefaultStreamTextResult = class {
           let stepProviderMetadata;
           let stepFirstChunk = true;
           let stepResponse = {
-            id: generateId3(),
+            id: generateId2(),
             timestamp: currentDate(),
             modelId: model.modelId
           };
@@ -5025,6 +5350,7 @@ var DefaultStreamTextResult = class {
                   }
                   const chunkType = chunk.type;
                   switch (chunkType) {
+                    case "tool-approval-request":
                     case "text-start":
                     case "text-end": {
                       controller.enqueue(chunk);
@@ -5253,7 +5579,7 @@ var DefaultStreamTextResult = class {
         }
         await streamStep({
           currentStep: 0,
-          responseMessages: [],
+          responseMessages: initialResponseMessages,
           usage: {
             inputTokens: void 0,
             outputTokens: void 0,
@@ -5560,6 +5886,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({
@@ -5583,6 +5917,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",
@@ -5827,6 +6168,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",
@@ -5855,29 +6203,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
                 )
               });
             }
@@ -5915,14 +6283,39 @@ var Agent = class {
   constructor(settings) {
     this.settings = settings;
   }
+  /**
+   * The name of the agent.
+   */
+  get name() {
+    return this.settings.name;
+  }
+  /**
+   * The tools that the agent can use.
+   */
   get tools() {
     return this.settings.tools;
   }
+  /**
+   * Generates an output from the agent (non-streaming).
+   */
   async generate(options) {
-    return generateText({ ...this.settings, ...options });
+    var _a17;
+    return generateText({
+      ...this.settings,
+      stopWhen: (_a17 = this.settings.stopWhen) != null ? _a17 : stepCountIs(20),
+      ...options
+    });
   }
+  /**
+   * Streams an output from the agent (streaming).
+   */
   stream(options) {
-    return streamText({ ...this.settings, ...options });
+    var _a17;
+    return streamText({
+      ...this.settings,
+      stopWhen: (_a17 = this.settings.stopWhen) != null ? _a17 : stepCountIs(20),
+      ...options
+    });
   }
   /**
    * Creates a response object that streams UI messages to the client.
@@ -6318,7 +6711,7 @@ async function generateImage({
   headers
 }) {
   var _a17, _b;
-  if (model.specificationVersion !== "v2") {
+  if (model.specificationVersion !== "v3") {
     throw new UnsupportedModelVersionError({
       version: model.specificationVersion,
       provider: model.provider,
@@ -6892,7 +7285,7 @@ async function generateObject(options) {
     experimental_download: download2,
     providerOptions,
     _internal: {
-      generateId: generateId3 = originalGenerateId3,
+      generateId: generateId2 = originalGenerateId3,
       currentDate = () => /* @__PURE__ */ new Date()
     } = {},
     ...settings
@@ -7016,7 +7409,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,
@@ -7295,7 +7688,7 @@ function streamObject(options) {
     },
     onFinish,
     _internal: {
-      generateId: generateId3 = originalGenerateId4,
+      generateId: generateId2 = originalGenerateId4,
       currentDate = () => /* @__PURE__ */ new Date(),
       now: now2 = now
     } = {},
@@ -7337,7 +7730,7 @@ function streamObject(options) {
     onError,
     onFinish,
     download: download2,
-    generateId: generateId3,
+    generateId: generateId2,
     currentDate,
     now: now2
   });
@@ -7361,7 +7754,7 @@ var DefaultStreamObjectResult = class {
     onError,
     onFinish,
     download: download2,
-    generateId: generateId3,
+    generateId: generateId2,
     currentDate,
     now: now2
   }) {
@@ -7509,7 +7902,7 @@ var DefaultStreamObjectResult = class {
         let accumulatedText = "";
         let textDelta = "";
         let fullResponse = {
-          id: generateId3(),
+          id: generateId2(),
           timestamp: currentDate(),
           modelId: model.modelId
         };
@@ -7798,18 +8191,6 @@ var DefaultStreamObjectResult = class {
 // src/generate-speech/generate-speech.ts
 import { withUserAgentSuffix as withUserAgentSuffix7 } from "@ai-sdk/provider-utils";
 
-// src/error/no-speech-generated-error.ts
-import { AISDKError as AISDKError20 } from "@ai-sdk/provider";
-var NoSpeechGeneratedError = class extends AISDKError20 {
-  constructor(options) {
-    super({
-      name: "AI_NoSpeechGeneratedError",
-      message: "No speech audio generated."
-    });
-    this.responses = options.responses;
-  }
-};
-
 // src/generate-speech/generated-audio-file.ts
 var DefaultGeneratedAudioFile = class extends DefaultGeneratedFile {
   constructor({
@@ -7850,7 +8231,7 @@ async function generateSpeech({
   headers
 }) {
   var _a17;
-  if (model.specificationVersion !== "v2") {
+  if (model.specificationVersion !== "v3") {
     throw new UnsupportedModelVersionError({
       version: model.specificationVersion,
       provider: model.provider,
@@ -8065,7 +8446,7 @@ function defaultSettingsMiddleware({
   settings
 }) {
   return {
-    middlewareVersion: "v2",
+    middlewareVersion: "v3",
     transformParams: async ({ params }) => {
       return mergeObjects(settings, params);
     }
@@ -8099,7 +8480,7 @@ function extractReasoningMiddleware({
   const openingTag = `<${tagName}>`;
   const closingTag = `</${tagName}>`;
   return {
-    middlewareVersion: "v2",
+    middlewareVersion: "v3",
     wrapGenerate: async ({ doGenerate }) => {
       const { content, ...rest } = await doGenerate();
       const transformedContent = [];
@@ -8245,7 +8626,7 @@ function extractReasoningMiddleware({
 // src/middleware/simulate-streaming-middleware.ts
 function simulateStreamingMiddleware() {
   return {
-    middlewareVersion: "v2",
+    middlewareVersion: "v3",
     wrapStream: async ({ doGenerate }) => {
       const result = await doGenerate();
       let id = 0;
@@ -8342,7 +8723,7 @@ var doWrap = ({
     return transformParams ? await transformParams({ params, type, model }) : params;
   }
   return {
-    specificationVersion: "v2",
+    specificationVersion: "v3",
     provider: (_a17 = providerId != null ? providerId : overrideProvider == null ? void 0 : overrideProvider({ model })) != null ? _a17 : model.provider,
     modelId: (_b = modelId != null ? modelId : overrideModelId == null ? void 0 : overrideModelId({ model })) != null ? _b : model.modelId,
     supportedUrls: (_c = overrideSupportedUrls == null ? void 0 : overrideSupportedUrls({ model })) != null ? _c : model.supportedUrls,
@@ -9204,7 +9585,7 @@ async function transcribe({
   abortSignal,
   headers
 }) {
-  if (model.specificationVersion !== "v2") {
+  if (model.specificationVersion !== "v3") {
     throw new UnsupportedModelVersionError({
       version: model.specificationVersion,
       provider: model.provider,
@@ -9583,8 +9964,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,
@@ -9696,29 +10077,50 @@ 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,
       toolCallId,
-      output
+      output,
+      errorText
     }) => this.jobExecutor.run(async () => {
       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-available", output } : 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-available",
-            output,
-            errorText: void 0
-          } : 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({
@@ -9740,7 +10142,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;
@@ -9910,6 +10312,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
@@ -9925,7 +10351,9 @@ function lastAssistantMessageIsCompleteWithToolCalls({
     return part.type === "step-start" ? index : lastIndex;
   }, -1);
   const lastStepToolInvocations = message.parts.slice(lastStepStartIndex + 1).filter(isToolOrDynamicToolUIPart);
-  return lastStepToolInvocations.length > 0 && lastStepToolInvocations.every((part) => part.state === "output-available");
+  return lastStepToolInvocations.length > 0 && lastStepToolInvocations.every(
+    (part) => part.state === "output-available" || part.state === "output-error"
+  );
 }
 
 // src/ui/transform-text-to-ui-message-stream.ts
@@ -10061,7 +10489,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-"),
@@ -10071,7 +10500,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-"),
@@ -10082,7 +10542,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-"),
@@ -10092,7 +10557,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({
@@ -10237,7 +10722,7 @@ function createUIMessageStream({
   onError = getErrorMessage8,
   originalMessages,
   onFinish,
-  generateId: generateId3 = generateIdFunc2
+  generateId: generateId2 = generateIdFunc2
 }) {
   let controller;
   const ongoingStreamPromises = [];
@@ -10309,7 +10794,7 @@ function createUIMessageStream({
   });
   return handleUIMessageStreamFinish({
     stream,
-    messageId: generateId3(),
+    messageId: generateId2(),
     originalMessages,
     onFinish,
     onError
@@ -10364,9 +10849,10 @@ function readUIMessageStream({
   return createAsyncIterableStream(outputStream);
 }
 export {
-  AISDKError17 as AISDKError,
+  AISDKError18 as AISDKError,
   APICallError,
   AbstractChat,
+  Agent,
   DefaultChatTransport,
   DownloadError,
   EmptyResponseBodyError,
@@ -10389,6 +10875,7 @@ export {
   NoObjectGeneratedError,
   NoOutputGeneratedError,
   NoOutputSpecifiedError,
+  NoSpeechGeneratedError,
   NoSuchModelError,
   NoSuchProviderError,
   NoSuchToolError,
@@ -10434,7 +10921,7 @@ export {
   transcribe as experimental_transcribe,
   extractReasoningMiddleware,
   gateway2 as gateway,
-  generateId2 as generateId,
+  generateId,
   generateObject,
   generateText,
   getTextFromDataUrl,
@@ -10445,6 +10932,7 @@ export {
   isToolOrDynamicToolUIPart,
   isToolUIPart,
   jsonSchema2 as jsonSchema,
+  lastAssistantMessageIsCompleteWithApprovalResponses,
   lastAssistantMessageIsCompleteWithToolCalls,
   modelMessageSchema,
   parseJsonEventStream3 as parseJsonEventStream,