ai 3.3.34 → 3.3.36

package/dist/index.js

@@ -20,9 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // streams/index.ts
 var streams_exports = {};
 __export(streams_exports, {
-  AISDKError: () => import_provider16.AISDKError,
+  AISDKError: () => import_provider13.AISDKError,
   AIStream: () => AIStream,
-  APICallError: () => import_provider16.APICallError,
+  APICallError: () => import_provider13.APICallError,
   AWSBedrockAnthropicMessagesStream: () => AWSBedrockAnthropicMessagesStream,
   AWSBedrockAnthropicStream: () => AWSBedrockAnthropicStream,
   AWSBedrockCohereStream: () => AWSBedrockCohereStream,
@@ -32,25 +32,25 @@ __export(streams_exports, {
   AssistantResponse: () => AssistantResponse,
   CohereStream: () => CohereStream,
   DownloadError: () => DownloadError,
-  EmptyResponseBodyError: () => import_provider16.EmptyResponseBodyError,
+  EmptyResponseBodyError: () => import_provider13.EmptyResponseBodyError,
   GoogleGenerativeAIStream: () => GoogleGenerativeAIStream,
   HuggingFaceStream: () => HuggingFaceStream,
   InkeepStream: () => InkeepStream,
   InvalidArgumentError: () => InvalidArgumentError,
   InvalidDataContentError: () => InvalidDataContentError,
   InvalidMessageRoleError: () => InvalidMessageRoleError,
-  InvalidPromptError: () => import_provider16.InvalidPromptError,
-  InvalidResponseDataError: () => import_provider16.InvalidResponseDataError,
+  InvalidPromptError: () => import_provider13.InvalidPromptError,
+  InvalidResponseDataError: () => import_provider13.InvalidResponseDataError,
   InvalidToolArgumentsError: () => InvalidToolArgumentsError,
-  JSONParseError: () => import_provider16.JSONParseError,
+  JSONParseError: () => import_provider13.JSONParseError,
   LangChainAdapter: () => langchain_adapter_exports,
   LangChainStream: () => LangChainStream,
-  LoadAPIKeyError: () => import_provider16.LoadAPIKeyError,
+  LoadAPIKeyError: () => import_provider13.LoadAPIKeyError,
   MessageConversionError: () => MessageConversionError,
   MistralStream: () => MistralStream,
-  NoContentGeneratedError: () => import_provider16.NoContentGeneratedError,
+  NoContentGeneratedError: () => import_provider13.NoContentGeneratedError,
   NoObjectGeneratedError: () => NoObjectGeneratedError,
-  NoSuchModelError: () => import_provider16.NoSuchModelError,
+  NoSuchModelError: () => import_provider13.NoSuchModelError,
   NoSuchProviderError: () => NoSuchProviderError,
   NoSuchToolError: () => NoSuchToolError,
   OpenAIStream: () => OpenAIStream,
@@ -58,8 +58,8 @@ __export(streams_exports, {
   RetryError: () => RetryError,
   StreamData: () => StreamData2,
   StreamingTextResponse: () => StreamingTextResponse,
-  TypeValidationError: () => import_provider16.TypeValidationError,
-  UnsupportedFunctionalityError: () => import_provider16.UnsupportedFunctionalityError,
+  TypeValidationError: () => import_provider13.TypeValidationError,
+  UnsupportedFunctionalityError: () => import_provider13.UnsupportedFunctionalityError,
   convertToCoreMessages: () => convertToCoreMessages,
   cosineSimilarity: () => cosineSimilarity,
   createCallbacksTransformer: () => createCallbacksTransformer,
@@ -1148,6 +1148,7 @@ function prepareCallSettings({
   maxTokens,
   temperature,
   topP,
+  topK,
   presencePenalty,
   frequencyPenalty,
   stopSequences,
@@ -1188,6 +1189,15 @@ function prepareCallSettings({
       });
     }
   }
+  if (topK != null) {
+    if (typeof topK !== "number") {
+      throw new InvalidArgumentError({
+        parameter: "topK",
+        value: topP,
+        message: "topP must be a number"
+      });
+    }
+  }
   if (presencePenalty != null) {
     if (typeof presencePenalty !== "number") {
       throw new InvalidArgumentError({
@@ -1235,6 +1245,7 @@ function prepareCallSettings({
     maxTokens,
     temperature: temperature != null ? temperature : 0,
     topP,
+    topK,
     presencePenalty,
     frequencyPenalty,
     stopSequences: stopSequences != null && stopSequences.length > 0 ? stopSequences : void 0,
@@ -2825,64 +2836,8 @@ var experimental_streamObject = streamObject;
 // core/generate-text/generate-text.ts
 var import_provider_utils9 = require("@ai-sdk/provider-utils");
 
-// core/prompt/prepare-tools-and-tool-choice.ts
-var import_ui_utils3 = require("@ai-sdk/ui-utils");
-
-// core/util/is-non-empty-object.ts
-function isNonEmptyObject(object) {
-  return object != null && Object.keys(object).length > 0;
-}
-
-// core/prompt/prepare-tools-and-tool-choice.ts
-function prepareToolsAndToolChoice({
-  tools,
-  toolChoice
-}) {
-  if (!isNonEmptyObject(tools)) {
-    return {
-      tools: void 0,
-      toolChoice: void 0
-    };
-  }
-  return {
-    tools: Object.entries(tools).map(([name11, tool2]) => ({
-      type: "function",
-      name: name11,
-      description: tool2.description,
-      parameters: (0, import_ui_utils3.asSchema)(tool2.parameters).jsonSchema
-    })),
-    toolChoice: toolChoice == null ? { type: "auto" } : typeof toolChoice === "string" ? { type: toolChoice } : { type: "tool", toolName: toolChoice.toolName }
-  };
-}
-
-// core/generate-text/to-response-messages.ts
-function toResponseMessages({
-  text = "",
-  toolCalls,
-  toolResults
-}) {
-  const responseMessages = [];
-  responseMessages.push({
-    role: "assistant",
-    content: [{ type: "text", text }, ...toolCalls]
-  });
-  if (toolResults.length > 0) {
-    responseMessages.push({
-      role: "tool",
-      content: toolResults.map((result) => ({
-        type: "tool-result",
-        toolCallId: result.toolCallId,
-        toolName: result.toolName,
-        result: result.result
-      }))
-    });
-  }
-  return responseMessages;
-}
-
-// core/generate-text/tool-call.ts
-var import_provider_utils8 = require("@ai-sdk/provider-utils");
-var import_ui_utils4 = require("@ai-sdk/ui-utils");
+// errors/index.ts
+var import_provider13 = require("@ai-sdk/provider");
 
 // errors/invalid-tool-arguments-error.ts
 var import_provider10 = require("@ai-sdk/provider");
@@ -2970,7 +2925,85 @@ var NoSuchToolError = class extends import_provider11.AISDKError {
 };
 _a8 = symbol8;
 
+// core/prompt/message-conversion-error.ts
+var import_provider12 = require("@ai-sdk/provider");
+var name9 = "AI_MessageConversionError";
+var marker9 = `vercel.ai.error.${name9}`;
+var symbol9 = Symbol.for(marker9);
+var _a9;
+var MessageConversionError = class extends import_provider12.AISDKError {
+  constructor({
+    originalMessage,
+    message
+  }) {
+    super({ name: name9, message });
+    this[_a9] = true;
+    this.originalMessage = originalMessage;
+  }
+  static isInstance(error) {
+    return import_provider12.AISDKError.hasMarker(error, marker9);
+  }
+};
+_a9 = symbol9;
+
+// core/prompt/prepare-tools-and-tool-choice.ts
+var import_ui_utils3 = require("@ai-sdk/ui-utils");
+
+// core/util/is-non-empty-object.ts
+function isNonEmptyObject(object) {
+  return object != null && Object.keys(object).length > 0;
+}
+
+// core/prompt/prepare-tools-and-tool-choice.ts
+function prepareToolsAndToolChoice({
+  tools,
+  toolChoice
+}) {
+  if (!isNonEmptyObject(tools)) {
+    return {
+      tools: void 0,
+      toolChoice: void 0
+    };
+  }
+  return {
+    tools: Object.entries(tools).map(([name11, tool2]) => ({
+      type: "function",
+      name: name11,
+      description: tool2.description,
+      parameters: (0, import_ui_utils3.asSchema)(tool2.parameters).jsonSchema
+    })),
+    toolChoice: toolChoice == null ? { type: "auto" } : typeof toolChoice === "string" ? { type: toolChoice } : { type: "tool", toolName: toolChoice.toolName }
+  };
+}
+
+// core/generate-text/to-response-messages.ts
+function toResponseMessages({
+  text = "",
+  toolCalls,
+  toolResults
+}) {
+  const responseMessages = [];
+  responseMessages.push({
+    role: "assistant",
+    content: [{ type: "text", text }, ...toolCalls]
+  });
+  if (toolResults.length > 0) {
+    responseMessages.push({
+      role: "tool",
+      content: toolResults.map((result) => ({
+        type: "tool-result",
+        toolCallId: result.toolCallId,
+        toolName: result.toolName,
+        result: result.result
+      }))
+    });
+  }
+  return responseMessages;
+}
+
 // core/generate-text/tool-call.ts
+var import_provider_utils8 = require("@ai-sdk/provider-utils");
+var import_ui_utils4 = require("@ai-sdk/ui-utils");
 function parseToolCall({
   toolCall,
   tools
@@ -3019,6 +3052,7 @@ async function generateText({
   headers,
   maxAutomaticRoundtrips = 0,
   maxToolRoundtrips = maxAutomaticRoundtrips,
+  maxSteps = maxToolRoundtrips != null ? maxToolRoundtrips + 1 : 1,
   experimental_telemetry: telemetry,
   experimental_providerMetadata: providerMetadata,
   _internal: {
@@ -3028,6 +3062,13 @@ async function generateText({
   ...settings
 }) {
   var _a11;
+  if (maxSteps < 1) {
+    throw new InvalidArgumentError({
+      parameter: "maxSteps",
+      value: maxSteps,
+      message: "maxSteps must be at least 1"
+    });
+  }
   const baseTelemetryAttributes = getBaseTelemetryAttributes({
     model,
     telemetry,
@@ -3049,7 +3090,7 @@ async function generateText({
         "ai.prompt": {
           input: () => JSON.stringify({ system, prompt, messages })
         },
-        "ai.settings.maxToolRoundtrips": maxToolRoundtrips
+        "ai.settings.maxSteps": maxSteps
       }
     }),
     tracer,
@@ -3073,16 +3114,16 @@ async function generateText({
       let currentModelResponse;
       let currentToolCalls = [];
       let currentToolResults = [];
-      let roundtripCount = 0;
+      let stepCount = 0;
       const responseMessages = [];
-      const roundtrips = [];
+      const steps = [];
       const usage = {
         completionTokens: 0,
         promptTokens: 0,
         totalTokens: 0
       };
       do {
-        const currentInputFormat = roundtripCount === 0 ? validatedPrompt.type : "messages";
+        const currentInputFormat = stepCount === 0 ? validatedPrompt.type : "messages";
         currentModelResponse = await retry(
           () => recordSpan({
             name: "ai.generateText.doGenerate",
@@ -3179,7 +3220,7 @@ async function generateText({
         usage.completionTokens += currentUsage.completionTokens;
         usage.promptTokens += currentUsage.promptTokens;
         usage.totalTokens += currentUsage.totalTokens;
-        roundtrips.push({
+        steps.push({
           text: (_b = currentModelResponse.text) != null ? _b : "",
           toolCalls: currentToolCalls,
           toolResults: currentToolResults,
@@ -3206,8 +3247,8 @@ async function generateText({
       } while (
         // there are tool calls:
         currentToolCalls.length > 0 && // all current tool calls have results:
-        currentToolResults.length === currentToolCalls.length && // the number of roundtrips is less than the maximum:
-        roundtripCount++ < maxToolRoundtrips
+        currentToolResults.length === currentToolCalls.length && // the number of steps is less than the maximum:
+        ++stepCount < maxSteps
       );
       span.setAttributes(
         selectTelemetryAttributes({
@@ -3249,7 +3290,7 @@ async function generateText({
         },
         logprobs: currentModelResponse.logprobs,
         responseMessages,
-        roundtrips,
+        steps,
         providerMetadata: currentModelResponse.providerMetadata
       });
     }
@@ -3324,7 +3365,8 @@ var DefaultGenerateTextResult = class {
     this.warnings = options.warnings;
     this.response = options.response;
     this.responseMessages = options.responseMessages;
-    this.roundtrips = options.roundtrips;
+    this.roundtrips = options.steps;
+    this.steps = options.steps;
     this.experimental_providerMetadata = options.providerMetadata;
     this.rawResponse = {
       headers: options.response.headers
@@ -3689,6 +3731,7 @@ async function streamText({
   abortSignal,
   headers,
   maxToolRoundtrips = 0,
+  maxSteps = maxToolRoundtrips != null ? maxToolRoundtrips + 1 : 1,
   experimental_telemetry: telemetry,
   experimental_providerMetadata: providerMetadata,
   experimental_toolCallStreaming: toolCallStreaming = false,
@@ -3702,6 +3745,13 @@ async function streamText({
   ...settings
 }) {
   var _a11;
+  if (maxSteps < 1) {
+    throw new InvalidArgumentError({
+      parameter: "maxSteps",
+      value: maxSteps,
+      message: "maxSteps must be at least 1"
+    });
+  }
   const baseTelemetryAttributes = getBaseTelemetryAttributes({
     model,
     telemetry,
@@ -3719,14 +3769,15 @@ async function streamText({
         // specific settings that only make sense on the outer level:
         "ai.prompt": {
           input: () => JSON.stringify({ system, prompt, messages })
-        }
+        },
+        "ai.settings.maxSteps": maxSteps
       }
     }),
     tracer,
     endWhenDone: false,
     fn: async (rootSpan) => {
       const retry = retryWithExponentialBackoff({ maxRetries });
-      const startRoundtrip = async ({
+      const startStep = async ({
         promptMessages: promptMessages2,
         promptType
       }) => {
@@ -3808,7 +3859,7 @@ async function streamText({
         result: { stream, warnings, rawResponse },
         doStreamSpan,
         startTimestampMs
-      } = await startRoundtrip({
+      } = await startStep({
         promptType: validatePrompt({ system, prompt, messages }).type,
         promptMessages
       });
@@ -3822,8 +3873,8 @@ async function streamText({
         doStreamSpan,
         telemetry,
         startTimestampMs,
-        maxToolRoundtrips,
-        startRoundtrip,
+        maxSteps,
+        startStep,
         promptMessages,
         modelId: model.modelId,
         now: now2,
@@ -3844,8 +3895,8 @@ var DefaultStreamTextResult = class {
     doStreamSpan,
     telemetry,
     startTimestampMs,
-    maxToolRoundtrips,
-    startRoundtrip,
+    maxSteps,
+    startStep,
     promptMessages,
     modelId,
     now: now2,
@@ -3864,6 +3915,8 @@ var DefaultStreamTextResult = class {
     this.toolCalls = toolCallsPromise;
     const { resolve: resolveToolResults, promise: toolResultsPromise } = createResolvablePromise();
     this.toolResults = toolResultsPromise;
+    const { resolve: resolveSteps, promise: stepsPromise } = createResolvablePromise();
+    this.steps = stepsPromise;
     const {
       resolve: resolveProviderMetadata,
       promise: providerMetadataPromise
@@ -3877,12 +3930,13 @@ var DefaultStreamTextResult = class {
       close: closeStitchableStream
     } = createStitchableStream();
     this.originalStream = stitchableStream;
+    const stepResults = [];
     const self = this;
-    function addRoundtripStream({
+    function addStepStream({
       stream: stream2,
       startTimestamp,
       doStreamSpan: doStreamSpan2,
-      currentToolRoundtrip,
+      currentStep,
       promptMessages: promptMessages2,
       usage = {
         promptTokens: 0,
@@ -3890,19 +3944,19 @@ var DefaultStreamTextResult = class {
         totalTokens: 0
       }
     }) {
-      const roundtripToolCalls = [];
-      const roundtripToolResults = [];
-      let roundtripFinishReason = "unknown";
-      let roundtripUsage = {
+      const stepToolCalls = [];
+      const stepToolResults = [];
+      let stepFinishReason = "unknown";
+      let stepUsage = {
         promptTokens: 0,
         completionTokens: 0,
         totalTokens: 0
       };
-      let roundtripProviderMetadata;
-      let roundtripFirstChunk = true;
-      let roundtripText = "";
-      let roundtripLogProbs;
-      let roundtripResponse = {
+      let stepProviderMetadata;
+      let stepFirstChunk = true;
+      let stepText = "";
+      let stepLogProbs;
+      let stepResponse = {
         id: generateId3(),
         timestamp: currentDate(),
         modelId
@@ -3912,9 +3966,9 @@ var DefaultStreamTextResult = class {
           new TransformStream({
             async transform(chunk, controller) {
               var _a11, _b, _c;
-              if (roundtripFirstChunk) {
+              if (stepFirstChunk) {
                 const msToFirstChunk = now2() - startTimestamp;
-                roundtripFirstChunk = false;
+                stepFirstChunk = false;
                 doStreamSpan2.addEvent("ai.stream.firstChunk", {
                   "ai.response.msToFirstChunk": msToFirstChunk,
                   // deprecated:
@@ -3933,40 +3987,40 @@ var DefaultStreamTextResult = class {
               switch (chunkType) {
                 case "text-delta": {
                   controller.enqueue(chunk);
-                  roundtripText += chunk.textDelta;
+                  stepText += chunk.textDelta;
                   await (onChunk == null ? void 0 : onChunk({ chunk }));
                   break;
                 }
                 case "tool-call": {
                   controller.enqueue(chunk);
-                  roundtripToolCalls.push(chunk);
+                  stepToolCalls.push(chunk);
                   await (onChunk == null ? void 0 : onChunk({ chunk }));
                   break;
                 }
                 case "tool-result": {
                   controller.enqueue(chunk);
-                  roundtripToolResults.push(chunk);
+                  stepToolResults.push(chunk);
                   await (onChunk == null ? void 0 : onChunk({ chunk }));
                   break;
                 }
                 case "response-metadata": {
-                  roundtripResponse = {
-                    id: (_a11 = chunk.id) != null ? _a11 : roundtripResponse.id,
-                    timestamp: (_b = chunk.timestamp) != null ? _b : roundtripResponse.timestamp,
-                    modelId: (_c = chunk.modelId) != null ? _c : roundtripResponse.modelId
+                  stepResponse = {
+                    id: (_a11 = chunk.id) != null ? _a11 : stepResponse.id,
+                    timestamp: (_b = chunk.timestamp) != null ? _b : stepResponse.timestamp,
+                    modelId: (_c = chunk.modelId) != null ? _c : stepResponse.modelId
                   };
                   break;
                 }
                 case "finish": {
-                  roundtripUsage = chunk.usage;
-                  roundtripFinishReason = chunk.finishReason;
-                  roundtripProviderMetadata = chunk.experimental_providerMetadata;
-                  roundtripLogProbs = chunk.logprobs;
+                  stepUsage = chunk.usage;
+                  stepFinishReason = chunk.finishReason;
+                  stepProviderMetadata = chunk.experimental_providerMetadata;
+                  stepLogProbs = chunk.logprobs;
                   const msToFinish = now2() - startTimestamp;
                   doStreamSpan2.addEvent("ai.stream.finish");
                   doStreamSpan2.setAttributes({
                     "ai.response.msToFinish": msToFinish,
-                    "ai.response.avgCompletionTokensPerSecond": 1e3 * roundtripUsage.completionTokens / msToFinish
+                    "ai.response.avgCompletionTokensPerSecond": 1e3 * stepUsage.completionTokens / msToFinish
                   });
                   break;
                 }
@@ -3978,7 +4032,7 @@ var DefaultStreamTextResult = class {
                 }
                 case "error": {
                   controller.enqueue(chunk);
-                  roundtripFinishReason = "error";
+                  stepFinishReason = "error";
                   break;
                 }
                 default: {
@@ -3990,41 +4044,52 @@ var DefaultStreamTextResult = class {
             // invoke onFinish callback and resolve toolResults promise when the stream is about to close:
             async flush(controller) {
               controller.enqueue({
-                type: "roundtrip-finish",
-                finishReason: roundtripFinishReason,
-                usage: roundtripUsage,
-                experimental_providerMetadata: roundtripProviderMetadata,
-                logprobs: roundtripLogProbs,
-                response: roundtripResponse
+                type: "step-finish",
+                finishReason: stepFinishReason,
+                usage: stepUsage,
+                experimental_providerMetadata: stepProviderMetadata,
+                logprobs: stepLogProbs,
+                response: stepResponse
               });
-              const telemetryToolCalls = roundtripToolCalls.length > 0 ? JSON.stringify(roundtripToolCalls) : void 0;
+              stepResults.push({
+                text: stepText,
+                toolCalls: stepToolCalls,
+                toolResults: stepToolResults,
+                finishReason: stepFinishReason,
+                usage: stepUsage,
+                warnings: self.warnings,
+                logprobs: stepLogProbs,
+                response: stepResponse,
+                rawResponse: self.rawResponse
+              });
+              const telemetryToolCalls = stepToolCalls.length > 0 ? JSON.stringify(stepToolCalls) : void 0;
               try {
                 doStreamSpan2.setAttributes(
                   selectTelemetryAttributes({
                     telemetry,
                     attributes: {
-                      "ai.response.finishReason": roundtripFinishReason,
-                      "ai.response.text": { output: () => roundtripText },
+                      "ai.response.finishReason": stepFinishReason,
+                      "ai.response.text": { output: () => stepText },
                       "ai.response.toolCalls": {
                         output: () => telemetryToolCalls
                       },
-                      "ai.response.id": roundtripResponse.id,
-                      "ai.response.model": roundtripResponse.modelId,
-                      "ai.response.timestamp": roundtripResponse.timestamp.toISOString(),
-                      "ai.usage.promptTokens": roundtripUsage.promptTokens,
-                      "ai.usage.completionTokens": roundtripUsage.completionTokens,
+                      "ai.response.id": stepResponse.id,
+                      "ai.response.model": stepResponse.modelId,
+                      "ai.response.timestamp": stepResponse.timestamp.toISOString(),
+                      "ai.usage.promptTokens": stepUsage.promptTokens,
+                      "ai.usage.completionTokens": stepUsage.completionTokens,
                       // deprecated
-                      "ai.finishReason": roundtripFinishReason,
-                      "ai.result.text": { output: () => roundtripText },
+                      "ai.finishReason": stepFinishReason,
+                      "ai.result.text": { output: () => stepText },
                       "ai.result.toolCalls": {
                         output: () => telemetryToolCalls
                       },
                       // standardized gen-ai llm span attributes:
-                      "gen_ai.response.finish_reasons": [roundtripFinishReason],
-                      "gen_ai.response.id": roundtripResponse.id,
-                      "gen_ai.response.model": roundtripResponse.modelId,
-                      "gen_ai.usage.input_tokens": roundtripUsage.promptTokens,
-                      "gen_ai.usage.output_tokens": roundtripUsage.completionTokens
+                      "gen_ai.response.finish_reasons": [stepFinishReason],
+                      "gen_ai.response.id": stepResponse.id,
+                      "gen_ai.response.model": stepResponse.modelId,
+                      "gen_ai.usage.input_tokens": stepUsage.promptTokens,
+                      "gen_ai.usage.output_tokens": stepUsage.completionTokens
                     }
                   })
                 );
@@ -4033,21 +4098,21 @@ var DefaultStreamTextResult = class {
                 doStreamSpan2.end();
               }
               const combinedUsage = {
-                promptTokens: usage.promptTokens + roundtripUsage.promptTokens,
-                completionTokens: usage.completionTokens + roundtripUsage.completionTokens,
-                totalTokens: usage.totalTokens + roundtripUsage.totalTokens
+                promptTokens: usage.promptTokens + stepUsage.promptTokens,
+                completionTokens: usage.completionTokens + stepUsage.completionTokens,
+                totalTokens: usage.totalTokens + stepUsage.totalTokens
               };
               if (
                 // there are tool calls:
-                roundtripToolCalls.length > 0 && // all current tool calls have results:
-                roundtripToolResults.length === roundtripToolCalls.length && // the number of roundtrips is less than the maximum:
-                currentToolRoundtrip < maxToolRoundtrips
+                stepToolCalls.length > 0 && // all current tool calls have results:
+                stepToolResults.length === stepToolCalls.length && // the number of steps is less than the maximum:
+                currentStep + 1 < maxSteps
               ) {
                 promptMessages2.push(
                   ...toResponseMessages({
-                    text: roundtripText,
-                    toolCalls: roundtripToolCalls,
-                    toolResults: roundtripToolResults
+                    text: stepText,
+                    toolCalls: stepToolCalls,
+                    toolResults: stepToolResults
                   }).map(
                     (message) => convertToLanguageModelMessage(message, null)
                   )
@@ -4056,17 +4121,17 @@ var DefaultStreamTextResult = class {
                   result,
                   doStreamSpan: doStreamSpan3,
                   startTimestampMs: startTimestamp2
-                } = await startRoundtrip({
+                } = await startStep({
                   promptType: "messages",
                   promptMessages: promptMessages2
                 });
                 self.warnings = result.warnings;
                 self.rawResponse = result.rawResponse;
-                addRoundtripStream({
+                addStepStream({
                   stream: result.stream,
                   startTimestamp: startTimestamp2,
                   doStreamSpan: doStreamSpan3,
-                  currentToolRoundtrip: currentToolRoundtrip + 1,
+                  currentStep: currentStep + 1,
                   promptMessages: promptMessages2,
                   usage: combinedUsage
                 });
@@ -4075,27 +4140,27 @@ var DefaultStreamTextResult = class {
               try {
                 controller.enqueue({
                   type: "finish",
-                  finishReason: roundtripFinishReason,
+                  finishReason: stepFinishReason,
                   usage: combinedUsage,
-                  experimental_providerMetadata: roundtripProviderMetadata,
-                  logprobs: roundtripLogProbs,
-                  response: roundtripResponse
+                  experimental_providerMetadata: stepProviderMetadata,
+                  logprobs: stepLogProbs,
+                  response: stepResponse
                 });
                 closeStitchableStream();
                 rootSpan.setAttributes(
                   selectTelemetryAttributes({
                     telemetry,
                     attributes: {
-                      "ai.response.finishReason": roundtripFinishReason,
-                      "ai.response.text": { output: () => roundtripText },
+                      "ai.response.finishReason": stepFinishReason,
+                      "ai.response.text": { output: () => stepText },
                       "ai.response.toolCalls": {
                         output: () => telemetryToolCalls
                       },
                       "ai.usage.promptTokens": combinedUsage.promptTokens,
                       "ai.usage.completionTokens": combinedUsage.completionTokens,
                       // deprecated
-                      "ai.finishReason": roundtripFinishReason,
-                      "ai.result.text": { output: () => roundtripText },
+                      "ai.finishReason": stepFinishReason,
+                      "ai.result.text": { output: () => stepText },
                       "ai.result.toolCalls": {
                         output: () => telemetryToolCalls
                       }
@@ -4103,32 +4168,35 @@ var DefaultStreamTextResult = class {
                   })
                 );
                 resolveUsage(combinedUsage);
-                resolveFinishReason(roundtripFinishReason);
-                resolveText(roundtripText);
-                resolveToolCalls(roundtripToolCalls);
-                resolveProviderMetadata(roundtripProviderMetadata);
-                resolveToolResults(roundtripToolResults);
+                resolveFinishReason(stepFinishReason);
+                resolveText(stepText);
+                resolveToolCalls(stepToolCalls);
+                resolveProviderMetadata(stepProviderMetadata);
+                resolveToolResults(stepToolResults);
                 resolveResponse({
-                  ...roundtripResponse,
+                  ...stepResponse,
                   headers: rawResponse == null ? void 0 : rawResponse.headers
                 });
+                resolveSteps(stepResults);
                 await (onFinish == null ? void 0 : onFinish({
-                  finishReason: roundtripFinishReason,
+                  finishReason: stepFinishReason,
                   usage: combinedUsage,
-                  text: roundtripText,
-                  toolCalls: roundtripToolCalls,
+                  text: stepText,
+                  toolCalls: stepToolCalls,
                   // The tool results are inferred as a never[] type, because they are
                   // optional and the execute method with an inferred result type is
                   // optional as well. Therefore we need to cast the toolResults to any.
                   // The type exposed to the users will be correctly inferred.
-                  toolResults: roundtripToolResults,
+                  toolResults: stepToolResults,
                   rawResponse,
                   response: {
-                    ...roundtripResponse,
+                    ...stepResponse,
                     headers: rawResponse == null ? void 0 : rawResponse.headers
                   },
                   warnings,
-                  experimental_providerMetadata: roundtripProviderMetadata
+                  experimental_providerMetadata: stepProviderMetadata,
+                  steps: stepResults
+                  // see tool results comment above
                 }));
               } catch (error) {
                 controller.error(error);
@@ -4140,11 +4208,11 @@ var DefaultStreamTextResult = class {
         )
       );
     }
-    addRoundtripStream({
+    addStepStream({
       stream,
       startTimestamp: startTimestampMs,
       doStreamSpan,
-      currentToolRoundtrip: 0,
+      currentStep: 0,
       promptMessages,
       usage: void 0
     });
@@ -4185,8 +4253,9 @@ var DefaultStreamTextResult = class {
   }
   toDataStreamInternal({
     callbacks = {},
-    getErrorMessage: getErrorMessage4 = () => ""
+    getErrorMessage: getErrorMessage4 = () => "",
     // mask error messages for safety by default
+    sendUsage = true
   } = {}) {
     let aggregatedResponse = "";
     const callbackTransformer = new TransformStream({
@@ -4216,10 +4285,11 @@ var DefaultStreamTextResult = class {
       transform: async (chunk, controller) => {
         const chunkType = chunk.type;
         switch (chunkType) {
-          case "text-delta":
+          case "text-delta": {
             controller.enqueue((0, import_ui_utils10.formatStreamPart)("text", chunk.textDelta));
             break;
-          case "tool-call-streaming-start":
+          }
+          case "tool-call-streaming-start": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("tool_call_streaming_start", {
                 toolCallId: chunk.toolCallId,
@@ -4227,7 +4297,8 @@ var DefaultStreamTextResult = class {
               })
             );
             break;
-          case "tool-call-delta":
+          }
+          case "tool-call-delta": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("tool_call_delta", {
                 toolCallId: chunk.toolCallId,
@@ -4235,7 +4306,8 @@ var DefaultStreamTextResult = class {
               })
             );
             break;
-          case "tool-call":
+          }
+          case "tool-call": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("tool_call", {
                 toolCallId: chunk.toolCallId,
@@ -4244,7 +4316,8 @@ var DefaultStreamTextResult = class {
               })
             );
             break;
-          case "tool-result":
+          }
+          case "tool-result": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("tool_result", {
                 toolCallId: chunk.toolCallId,
@@ -4252,33 +4325,37 @@ var DefaultStreamTextResult = class {
               })
             );
             break;
-          case "error":
+          }
+          case "error": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("error", getErrorMessage4(chunk.error))
             );
             break;
-          case "roundtrip-finish":
+          }
+          case "step-finish": {
             controller.enqueue(
-              (0, import_ui_utils10.formatStreamPart)("finish_roundtrip", {
+              (0, import_ui_utils10.formatStreamPart)("finish_step", {
                 finishReason: chunk.finishReason,
-                usage: {
+                usage: sendUsage ? {
                   promptTokens: chunk.usage.promptTokens,
                   completionTokens: chunk.usage.completionTokens
-                }
+                } : void 0
               })
             );
             break;
-          case "finish":
+          }
+          case "finish": {
             controller.enqueue(
               (0, import_ui_utils10.formatStreamPart)("finish_message", {
                 finishReason: chunk.finishReason,
-                usage: {
+                usage: sendUsage ? {
                   promptTokens: chunk.usage.promptTokens,
                   completionTokens: chunk.usage.completionTokens
-                }
+                } : void 0
               })
             );
             break;
+          }
           default: {
             const exhaustiveCheck = chunkType;
             throw new Error(`Unknown chunk type: ${exhaustiveCheck}`);
@@ -4299,6 +4376,7 @@ var DefaultStreamTextResult = class {
     };
     const data = options == null ? void 0 : "data" in options ? options.data : void 0;
     const getErrorMessage4 = options == null ? void 0 : "getErrorMessage" in options ? options.getErrorMessage : void 0;
+    const sendUsage = options == null ? void 0 : "sendUsage" in options ? options.sendUsage : void 0;
     writeToServerResponse({
       response,
       status: init == null ? void 0 : init.status,
@@ -4307,7 +4385,7 @@ var DefaultStreamTextResult = class {
         contentType: "text/plain; charset=utf-8",
         dataStreamVersion: "v1"
       }),
-      stream: this.toDataStream({ data, getErrorMessage: getErrorMessage4 })
+      stream: this.toDataStream({ data, getErrorMessage: getErrorMessage4, sendUsage })
     });
   }
   pipeTextStreamToResponse(response, init) {
@@ -4326,7 +4404,8 @@ var DefaultStreamTextResult = class {
   }
   toDataStream(options) {
     const stream = this.toDataStreamInternal({
-      getErrorMessage: options == null ? void 0 : options.getErrorMessage
+      getErrorMessage: options == null ? void 0 : options.getErrorMessage,
+      sendUsage: options == null ? void 0 : options.sendUsage
     });
     return (options == null ? void 0 : options.data) ? mergeStreams(options == null ? void 0 : options.data.stream, stream) : stream;
   }
@@ -4339,14 +4418,18 @@ var DefaultStreamTextResult = class {
     };
     const data = options == null ? void 0 : "data" in options ? options.data : void 0;
     const getErrorMessage4 = options == null ? void 0 : "getErrorMessage" in options ? options.getErrorMessage : void 0;
-    return new Response(this.toDataStream({ data, getErrorMessage: getErrorMessage4 }), {
-      status: (_a11 = init == null ? void 0 : init.status) != null ? _a11 : 200,
-      statusText: init == null ? void 0 : init.statusText,
-      headers: prepareResponseHeaders(init, {
-        contentType: "text/plain; charset=utf-8",
-        dataStreamVersion: "v1"
-      })
-    });
+    const sendUsage = options == null ? void 0 : "sendUsage" in options ? options.sendUsage : void 0;
+    return new Response(
+      this.toDataStream({ data, getErrorMessage: getErrorMessage4, sendUsage }),
+      {
+        status: (_a11 = init == null ? void 0 : init.status) != null ? _a11 : 200,
+        statusText: init == null ? void 0 : init.statusText,
+        headers: prepareResponseHeaders(init, {
+          contentType: "text/plain; charset=utf-8",
+          dataStreamVersion: "v1"
+        })
+      }
+    );
   }
   toTextStreamResponse(init) {
     var _a11;
@@ -4448,27 +4531,6 @@ function attachmentsToParts(attachments) {
   return parts;
 }
 
-// core/prompt/message-conversion-error.ts
-var import_provider12 = require("@ai-sdk/provider");
-var name9 = "AI_MessageConversionError";
-var marker9 = `vercel.ai.error.${name9}`;
-var symbol9 = Symbol.for(marker9);
-var _a9;
-var MessageConversionError = class extends import_provider12.AISDKError {
-  constructor({
-    originalMessage,
-    message
-  }) {
-    super({ name: name9, message });
-    this[_a9] = true;
-    this.originalMessage = originalMessage;
-  }
-  static isInstance(error) {
-    return import_provider12.AISDKError.hasMarker(error, marker9);
-  }
-};
-_a9 = symbol9;
-
 // core/prompt/convert-to-core-messages.ts
 function convertToCoreMessages(messages) {
   const coreMessages = [];
@@ -4548,7 +4610,7 @@ function convertToCoreMessages(messages) {
 }
 
 // core/registry/custom-provider.ts
-var import_provider13 = require("@ai-sdk/provider");
+var import_provider14 = require("@ai-sdk/provider");
 function experimental_customProvider({
   languageModels,
   textEmbeddingModels,
@@ -4562,7 +4624,7 @@ function experimental_customProvider({
       if (fallbackProvider) {
         return fallbackProvider.languageModel(modelId);
       }
-      throw new import_provider13.NoSuchModelError({ modelId, modelType: "languageModel" });
+      throw new import_provider14.NoSuchModelError({ modelId, modelType: "languageModel" });
     },
     textEmbeddingModel(modelId) {
       if (textEmbeddingModels != null && modelId in textEmbeddingModels) {
@@ -4571,18 +4633,18 @@ function experimental_customProvider({
       if (fallbackProvider) {
         return fallbackProvider.textEmbeddingModel(modelId);
       }
-      throw new import_provider13.NoSuchModelError({ modelId, modelType: "textEmbeddingModel" });
+      throw new import_provider14.NoSuchModelError({ modelId, modelType: "textEmbeddingModel" });
     }
   };
 }
 
 // core/registry/no-such-provider-error.ts
-var import_provider14 = require("@ai-sdk/provider");
+var import_provider15 = require("@ai-sdk/provider");
 var name10 = "AI_NoSuchProviderError";
 var marker10 = `vercel.ai.error.${name10}`;
 var symbol10 = Symbol.for(marker10);
 var _a10;
-var NoSuchProviderError = class extends import_provider14.NoSuchModelError {
+var NoSuchProviderError = class extends import_provider15.NoSuchModelError {
   constructor({
     modelId,
     modelType,
@@ -4596,7 +4658,7 @@ var NoSuchProviderError = class extends import_provider14.NoSuchModelError {
     this.availableProviders = availableProviders;
   }
   static isInstance(error) {
-    return import_provider14.AISDKError.hasMarker(error, marker10);
+    return import_provider15.AISDKError.hasMarker(error, marker10);
   }
   /**
    * @deprecated use `isInstance` instead
@@ -4622,7 +4684,7 @@ var NoSuchProviderError = class extends import_provider14.NoSuchModelError {
 _a10 = symbol10;
 
 // core/registry/provider-registry.ts
-var import_provider15 = require("@ai-sdk/provider");
+var import_provider16 = require("@ai-sdk/provider");
 function experimental_createProviderRegistry(providers) {
   const registry = new DefaultProviderRegistry();
   for (const [id, provider] of Object.entries(providers)) {
@@ -4656,7 +4718,7 @@ var DefaultProviderRegistry = class {
   splitId(id, modelType) {
     const index = id.indexOf(":");
     if (index === -1) {
-      throw new import_provider15.NoSuchModelError({
+      throw new import_provider16.NoSuchModelError({
         modelId: id,
         modelType,
         message: `Invalid ${modelType} id for registry: ${id} (must be in the format "providerId:modelId")`
@@ -4669,7 +4731,7 @@ var DefaultProviderRegistry = class {
     const [providerId, modelId] = this.splitId(id, "languageModel");
     const model = (_b = (_a11 = this.getProvider(providerId)).languageModel) == null ? void 0 : _b.call(_a11, modelId);
     if (model == null) {
-      throw new import_provider15.NoSuchModelError({ modelId: id, modelType: "languageModel" });
+      throw new import_provider16.NoSuchModelError({ modelId: id, modelType: "languageModel" });
     }
     return model;
   }
@@ -4679,7 +4741,7 @@ var DefaultProviderRegistry = class {
     const provider = this.getProvider(providerId);
     const model = (_c = (_a11 = provider.textEmbeddingModel) == null ? void 0 : _a11.call(provider, modelId)) != null ? _c : "textEmbedding" in provider ? (_b = provider.textEmbedding) == null ? void 0 : _b.call(provider, modelId) : void 0;
     if (model == null) {
-      throw new import_provider15.NoSuchModelError({
+      throw new import_provider16.NoSuchModelError({
         modelId: id,
         modelType: "textEmbeddingModel"
       });
@@ -4718,9 +4780,6 @@ function magnitude(vector) {
   return Math.sqrt(dotProduct(vector, vector));
 }
 
-// errors/index.ts
-var import_provider16 = require("@ai-sdk/provider");
-
 // streams/ai-stream.ts
 var import_eventsource_parser = require("eventsource-parser");
 function createEventStreamTransformer(customParser) {