@ai-sdk/provider-utils 5.0.0-beta.26 → 5.0.0-beta.27

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-sdk/provider-utils
 
+## 5.0.0-beta.27
+
+### Patch Changes
+
+- 785fe16: feat: distinguish provider-defined and provider-executed tools
+- 67df0a0: feat: add sensitiveContext property to Tool
+- befb78c: refactoring: remove real-time delays in unit tests
+- 0458559: fix: deprecate needsApproval on Tool
+- 5852c0a: refactoring(provider-utils): add controller as property to StreamingToolCallTracker
+- fc92055: feat(ai): automatic tool approval
+
 ## 5.0.0-beta.26
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ImageModelV4File, LanguageModelV4FunctionTool, LanguageModelV4ProviderTool, AISDKError, JSONSchema7, JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV4Prompt, LanguageModelV4FilePart, SharedV4ProviderReference, LanguageModelV4CallOptions, SharedV4Warning, SharedV4ProviderOptions, JSONObject, SharedV4ProviderMetadata, LanguageModelV4StreamPart, TypeValidationContext } from '@ai-sdk/provider';
+import { ImageModelV4File, LanguageModelV4FunctionTool, LanguageModelV4ProviderTool, AISDKError, JSONSchema7, JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV4Prompt, LanguageModelV4FilePart, SharedV4ProviderReference, LanguageModelV4CallOptions, SharedV4Warning, SharedV4ProviderOptions, JSONObject, LanguageModelV4StreamPart, SharedV4ProviderMetadata, TypeValidationContext } from '@ai-sdk/provider';
 export { getErrorMessage } from '@ai-sdk/provider';
 import { StandardSchemaV1, StandardJSONSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
@@ -489,6 +489,9 @@ declare function mapReasoningToProviderBudget({ reasoning, maxOutputTokens, maxR
     warnings: SharedV4Warning[];
 }): number | undefined;
 
+/**
+ * A value that can be provided either synchronously or as a promise-like.
+ */
 type MaybePromiseLike<T> = T | PromiseLike<T>;
 
 /**
@@ -970,6 +973,11 @@ type ToolResultOutput = {
     }>;
 };
 
+/**
+ * A context object that is passed into tool execution.
+ */
+type Context = Record<string, unknown>;
+
 /**
  * Tool approval request prompt part.
  */
@@ -983,6 +991,12 @@ type ToolApprovalRequest = {
      * ID of the tool call that the approval request is for.
      */
     toolCallId: string;
+    /**
+     * Flag indicating whether the tool was automatically approved or denied.
+     *
+     * @default false
+     */
+    isAutomatic?: boolean;
 };
 
 /**
@@ -1089,9 +1103,12 @@ type UserContent = string | Array<TextPart | ImagePart | FilePart>;
 type ModelMessage = SystemModelMessage | UserModelMessage | AssistantModelMessage | ToolModelMessage;
 
 /**
- * A context object that is passed into tool execution.
+ * Top-level context properties that contain sensitive data and should be
+ * excluded from telemetry.
  */
-type Context = Record<string, unknown>;
+type SensitiveContext<CONTEXT extends Context | unknown | never> = {
+    [KEY in keyof CONTEXT]?: boolean;
+} | undefined;
 
 /**
  * Additional options that are sent into each tool execution.
@@ -1111,7 +1128,8 @@ interface ToolExecutionOptions<CONTEXT extends Context | unknown | never> {
      */
     abortSignal?: AbortSignal;
     /**
-     * User-defined runtime context.
+     * Tool context as defined by the tool's context schema.
+     * The tool context is specific to the tool and is passed to the tool execution.
      *
      * Treat the context object as immutable inside tools.
      * Mutating the context object can lead to race conditions and unexpected results
@@ -1124,6 +1142,8 @@ interface ToolExecutionOptions<CONTEXT extends Context | unknown | never> {
 }
 /**
  * Function that is called to determine if the tool needs approval before it can be executed.
+ *
+ * @deprecated Tool approval is handled on a `generateText` / `streamText` level now.
  */
 type ToolNeedsApprovalFunction<INPUT, CONTEXT extends Context | unknown | never> = (input: INPUT, options: {
     /**
@@ -1136,7 +1156,8 @@ type ToolNeedsApprovalFunction<INPUT, CONTEXT extends Context | unknown | never>
      */
     messages: ModelMessage[];
     /**
-     * User-defined runtime context.
+     * Tool context as defined by the tool's context schema.
+     * The tool context is specific to the tool and is passed to the tool execution.
      *
      * Treat the context object as immutable inside tools.
      * Mutating the context object can lead to race conditions and unexpected results
@@ -1164,8 +1185,14 @@ type ToolOutputProperties<INPUT, OUTPUT, CONTEXT extends Context | unknown | nev
      * @options.abortSignal is a signal that can be used to abort the tool call.
      */
     execute: ToolExecuteFunction<INPUT, OUTPUT, CONTEXT>;
+    /**
+     * The schema of the output that the tool produces.
+     */
     outputSchema?: FlexibleSchema<OUTPUT>;
 } | {
+    /**
+     * The schema of the output that the tool produces.
+     */
     outputSchema: FlexibleSchema<OUTPUT>;
     execute?: never;
 }>;
@@ -1213,8 +1240,15 @@ type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT extends JSONVa
      * The context is passed to execute function as part of the execution options.
      */
     contextSchema?: FlexibleSchema<CONTEXT>;
+    /**
+     * Marks top-level context properties that contain sensitive data and should be excluded from telemetry.
+     * Properties marked as `true` are omitted from telemetry integrations.
+     */
+    sensitiveContext?: SensitiveContext<CONTEXT>;
     /**
      * Whether the tool needs approval before it can be executed.
+     *
+     * @deprecated Tool approval is handled on a `generateText` / `streamText` level now.
      */
     needsApproval?: boolean | ToolNeedsApprovalFunction<[
         INPUT
@@ -1288,6 +1322,10 @@ type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT extends JSONVa
      * The ID of the tool. Must follow the format `<provider-name>.<unique-tool-name>`.
      */
     id: `${string}.${string}`;
+    /**
+     * Flag that indicates whether the tool is executed by the provider.
+     */
+    isProviderExecuted: boolean;
     /**
      * The arguments for configuring the tool. Must match the expected arguments defined by the provider for this tool.
      */
@@ -1318,10 +1356,37 @@ declare function tool<CONTEXT extends Context>(tool: Tool<never, never, CONTEXT>
  * Defines a dynamic tool.
  */
 declare function dynamicTool(tool: {
+    /**
+     * An optional description of what the tool does.
+     * Will be used by the language model to decide whether to use the tool.
+     * Not used for provider-defined tools.
+     */
     description?: string;
+    /**
+     * An optional title of the tool.
+     */
     title?: string;
+    /**
+     * Additional provider-specific metadata. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
     providerOptions?: ProviderOptions;
+    /**
+     * The schema of the input that the tool expects.
+     * The language model will use this to generate the input.
+     * It is also used to validate the output of the language model.
+     *
+     * You can use descriptions on the schema properties to make the input understandable for the language model.
+     */
     inputSchema: FlexibleSchema<unknown>;
+    /**
+     * An async function that is called with the arguments from the tool call and produces a result.
+     * If not provided, the tool will not be executed automatically.
+     *
+     * @args is the input of the tool call.
+     * @options.abortSignal is a signal that can be used to abort the tool call.
+     */
     execute: ToolExecuteFunction<unknown, unknown, Context>;
     /**
      * Optional conversion function that maps the tool result to an output that can be used by the language model.
@@ -1350,7 +1415,11 @@ declare function dynamicTool(tool: {
     type: 'dynamic';
 };
 
-type ProviderToolFactory<INPUT, ARGS extends object, CONTEXT extends Context = {}> = <OUTPUT>(options: ARGS & {
+/**
+ * A provider-defined tool is a tool for which the provider defines the input
+ * and output schemas, but does not execute the tool.
+ */
+type ProviderDefinedToolFactory<INPUT, ARGS extends object, CONTEXT extends Context = {}> = <OUTPUT>(options: ARGS & {
     execute?: ToolExecuteFunction<INPUT, OUTPUT, CONTEXT>;
     needsApproval?: Tool<INPUT, OUTPUT, CONTEXT>['needsApproval'];
     toModelOutput?: Tool<INPUT, OUTPUT, CONTEXT>['toModelOutput'];
@@ -1358,11 +1427,11 @@ type ProviderToolFactory<INPUT, ARGS extends object, CONTEXT extends Context = {
     onInputDelta?: Tool<INPUT, OUTPUT, CONTEXT>['onInputDelta'];
     onInputAvailable?: Tool<INPUT, OUTPUT, CONTEXT>['onInputAvailable'];
 }) => Tool<INPUT, OUTPUT, CONTEXT>;
-declare function createProviderToolFactory<INPUT, ARGS extends object, CONTEXT extends Context = {}>({ id, inputSchema, }: {
+declare function createProviderDefinedToolFactory<INPUT, ARGS extends object, CONTEXT extends Context = {}>({ id, inputSchema, }: {
     id: `${string}.${string}`;
     inputSchema: FlexibleSchema<INPUT>;
-}): ProviderToolFactory<INPUT, ARGS, CONTEXT>;
-type ProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}> = (options: ARGS & {
+}): ProviderDefinedToolFactory<INPUT, ARGS, CONTEXT>;
+type ProviderDefinedToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}> = (options: ARGS & {
     execute?: ToolExecuteFunction<INPUT, OUTPUT, CONTEXT>;
     needsApproval?: Tool<INPUT, OUTPUT, CONTEXT>['needsApproval'];
     toModelOutput?: Tool<INPUT, OUTPUT, CONTEXT>['toModelOutput'];
@@ -1370,7 +1439,21 @@ type ProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS extends object, CON
     onInputDelta?: Tool<INPUT, OUTPUT, CONTEXT>['onInputDelta'];
     onInputAvailable?: Tool<INPUT, OUTPUT, CONTEXT>['onInputAvailable'];
 }) => Tool<INPUT, OUTPUT, CONTEXT>;
-declare function createProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}>({ id, inputSchema, outputSchema, supportsDeferredResults, }: {
+declare function createProviderDefinedToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}>({ id, inputSchema, outputSchema, }: {
+    id: `${string}.${string}`;
+    inputSchema: FlexibleSchema<INPUT>;
+    outputSchema: FlexibleSchema<OUTPUT>;
+}): ProviderDefinedToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS, CONTEXT>;
+
+/**
+ * A provider-executed tool is a tool for which the provider executes the tool.
+ */
+type ProviderExecutedToolFactory<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}> = (options: ARGS & {
+    onInputStart?: Tool<INPUT, OUTPUT, CONTEXT>['onInputStart'];
+    onInputDelta?: Tool<INPUT, OUTPUT, CONTEXT>['onInputDelta'];
+    onInputAvailable?: Tool<INPUT, OUTPUT, CONTEXT>['onInputAvailable'];
+}) => Tool<INPUT, OUTPUT, CONTEXT>;
+declare function createProviderExecutedToolFactory<INPUT, OUTPUT, ARGS extends object, CONTEXT extends Context = {}>({ id, inputSchema, outputSchema, supportsDeferredResults, }: {
     id: `${string}.${string}`;
     inputSchema: FlexibleSchema<INPUT>;
     outputSchema: FlexibleSchema<OUTPUT>;
@@ -1385,7 +1468,7 @@ declare function createProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS e
      * @default false
      */
     supportsDeferredResults?: boolean;
-}): ProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS, CONTEXT>;
+}): ProviderExecutedToolFactory<INPUT, OUTPUT, ARGS, CONTEXT>;
 
 /**
  * Default maximum download size: 2 GiB.
@@ -1499,7 +1582,7 @@ interface StreamingToolCallDelta {
         arguments?: string | null;
     } | null;
 }
-interface StreamingToolCallTrackerOptions {
+interface StreamingToolCallTrackerOptions<DELTA extends StreamingToolCallDelta = StreamingToolCallDelta> {
     /**
      * ID generator function for tool call IDs.
      * Defaults to the standard generateId.
@@ -1518,7 +1601,7 @@ interface StreamingToolCallTrackerOptions {
      * The returned metadata is stored on the tool call and passed to
      * `buildToolCallProviderMetadata` when the tool call is finalized.
      */
-    extractMetadata?: (delta: StreamingToolCallDelta) => SharedV4ProviderMetadata | undefined;
+    extractMetadata?: (delta: DELTA) => SharedV4ProviderMetadata | undefined;
     /**
      * Build the `providerMetadata` object for a `tool-call` event.
      * Receives the metadata previously extracted via `extractMetadata`.
@@ -1526,6 +1609,7 @@ interface StreamingToolCallTrackerOptions {
      */
     buildToolCallProviderMetadata?: (metadata: SharedV4ProviderMetadata | undefined) => SharedV4ProviderMetadata | undefined;
 }
+type StreamingToolCallTrackerController = Pick<TransformStreamDefaultController<LanguageModelV4StreamPart>, 'enqueue'>;
 /**
  * Tracks streaming tool call state across multiple deltas from an
  * OpenAI-compatible chat completion stream. Handles argument accumulation,
@@ -1534,24 +1618,25 @@ interface StreamingToolCallTrackerOptions {
  *
  * Used by openai, openai-compatible, groq, deepseek, and alibaba providers.
  */
-declare class StreamingToolCallTracker {
+declare class StreamingToolCallTracker<DELTA extends StreamingToolCallDelta = StreamingToolCallDelta> {
     private toolCalls;
+    private readonly controller;
     private readonly _generateId;
     private readonly typeValidation;
     private readonly extractMetadata?;
     private readonly buildToolCallProviderMetadata?;
-    constructor(options?: StreamingToolCallTrackerOptions);
+    constructor(controller: StreamingToolCallTrackerController, options?: StreamingToolCallTrackerOptions<DELTA>);
     /**
      * Process a tool call delta from a streaming response chunk.
      * Emits tool-input-start, tool-input-delta, tool-input-end, and tool-call
      * events as appropriate.
      */
-    processDelta(toolCallDelta: StreamingToolCallDelta, enqueue: (part: LanguageModelV4StreamPart) => void): void;
+    processDelta(toolCallDelta: DELTA): void;
     /**
      * Finalize any unfinished tool calls. Should be called during the stream's
      * flush handler to ensure all tool calls are properly completed.
      */
-    flush(enqueue: (part: LanguageModelV4StreamPart) => void): void;
+    flush(): void;
     private processNewToolCall;
     private processExistingToolCall;
     private finishToolCall;
@@ -1762,4 +1847,4 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
     dynamic?: boolean;
 }
 
-export { type Arrayable, type AssistantContent, type AssistantModelMessage, type Context, type CustomPart, DEFAULT_MAX_DOWNLOAD_SIZE, type DataContent, DelayedPromise, DownloadError, type ExecutableTool, type FetchFunction, type FilePart, type FlexibleSchema, type HasRequiredKey, type IdGenerator, type ImagePart, type InferSchema, type InferToolContext, type InferToolInput, type InferToolOutput, type InferToolSetContext, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderOptions, type ProviderReference, type ProviderToolFactory, type ProviderToolFactoryWithOutputSchema, type ReasoningFilePart, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type StreamingToolCallDelta, StreamingToolCallTracker, type StreamingToolCallTrackerOptions, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolExecutionOptions, type ToolModelMessage, type ToolNameMapping, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type ToolSet, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asArray, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertImageModelFileToDataUri, convertToBase64, convertToFormData, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createProviderToolFactory, createProviderToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, createToolNameMapping, delay, downloadBlob, dynamicTool, executeTool, extractResponseHeaders, filterNullable, generateId, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isCustomReasoning, isExecutableTool, isNonNullable, isParsableJson, isProviderReference, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mapReasoningToProviderBudget, mapReasoningToProviderEffort, mediaTypeToExtension, normalizeHeaders, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, readResponseWithSizeLimit, removeUndefinedEntries, resolve, resolveProviderReference, safeParseJSON, safeValidateTypes, serializeModelOptions, stripFileExtension, tool, validateDownloadUrl, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };
+export { type Arrayable, type AssistantContent, type AssistantModelMessage, type Context, type CustomPart, DEFAULT_MAX_DOWNLOAD_SIZE, type DataContent, DelayedPromise, DownloadError, type ExecutableTool, type FetchFunction, type FilePart, type FlexibleSchema, type HasRequiredKey, type IdGenerator, type ImagePart, type InferSchema, type InferToolContext, type InferToolInput, type InferToolOutput, type InferToolSetContext, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderExecutedToolFactory, type ProviderOptions, type ProviderReference, type ReasoningFilePart, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SensitiveContext, type StreamingToolCallDelta, StreamingToolCallTracker, type StreamingToolCallTrackerOptions, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolExecutionOptions, type ToolModelMessage, type ToolNameMapping, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type ToolSet, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asArray, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertImageModelFileToDataUri, convertToBase64, convertToFormData, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createProviderExecutedToolFactory, createStatusCodeErrorResponseHandler, createToolNameMapping, delay, downloadBlob, dynamicTool, executeTool, extractResponseHeaders, filterNullable, generateId, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isCustomReasoning, isExecutableTool, isNonNullable, isParsableJson, isProviderReference, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mapReasoningToProviderBudget, mapReasoningToProviderEffort, mediaTypeToExtension, normalizeHeaders, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, readResponseWithSizeLimit, removeUndefinedEntries, resolve, resolveProviderReference, safeParseJSON, safeValidateTypes, serializeModelOptions, stripFileExtension, tool, validateDownloadUrl, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };

package/dist/index.js

@@ -576,7 +576,7 @@ function withUserAgentSuffix(headers, ...userAgentSuffixParts) {
 }
 
 // src/version.ts
-var VERSION = true ? "5.0.0-beta.26" : "0.0.0-test";
+var VERSION = true ? "5.0.0-beta.27" : "0.0.0-test";
 
 // src/get-from-api.ts
 var getOriginalFetch = () => globalThis.fetch;
@@ -2501,8 +2501,8 @@ function dynamicTool(tool2) {
   return { ...tool2, type: "dynamic" };
 }
 
-// src/provider-tool-factory.ts
-function createProviderToolFactory({
+// src/provider-defined-tool-factory.ts
+function createProviderDefinedToolFactory({
   id,
   inputSchema
 }) {
@@ -2517,6 +2517,7 @@ function createProviderToolFactory({
     ...args
   }) => tool({
     type: "provider",
+    isProviderExecuted: false,
     id,
     args,
     inputSchema,
@@ -2529,11 +2530,10 @@ function createProviderToolFactory({
     onInputAvailable
   });
 }
-function createProviderToolFactoryWithOutputSchema({
+function createProviderDefinedToolFactoryWithOutputSchema({
   id,
   inputSchema,
-  outputSchema,
-  supportsDeferredResults
+  outputSchema
 }) {
   return ({
     execute,
@@ -2545,6 +2545,7 @@ function createProviderToolFactoryWithOutputSchema({
     ...args
   }) => tool({
     type: "provider",
+    isProviderExecuted: false,
     id,
     args,
     inputSchema,
@@ -2554,6 +2555,31 @@ function createProviderToolFactoryWithOutputSchema({
     toModelOutput,
     onInputStart,
     onInputDelta,
+    onInputAvailable
+  });
+}
+
+// src/provider-executed-tool-factory.ts
+function createProviderExecutedToolFactory({
+  id,
+  inputSchema,
+  outputSchema,
+  supportsDeferredResults
+}) {
+  return ({
+    onInputStart,
+    onInputDelta,
+    onInputAvailable,
+    ...args
+  }) => tool({
+    type: "provider",
+    isProviderExecuted: true,
+    id,
+    args,
+    inputSchema,
+    outputSchema,
+    onInputStart,
+    onInputDelta,
     onInputAvailable,
     supportsDeferredResults
   });
@@ -2780,9 +2806,10 @@ import {
   InvalidResponseDataError
 } from "@ai-sdk/provider";
 var StreamingToolCallTracker = class {
-  constructor(options = {}) {
+  constructor(controller, options = {}) {
     this.toolCalls = [];
     var _a2, _b2;
+    this.controller = controller;
     this._generateId = (_a2 = options.generateId) != null ? _a2 : generateId;
     this.typeValidation = (_b2 = options.typeValidation) != null ? _b2 : "none";
     this.extractMetadata = options.extractMetadata;
@@ -2793,27 +2820,27 @@ var StreamingToolCallTracker = class {
    * Emits tool-input-start, tool-input-delta, tool-input-end, and tool-call
    * events as appropriate.
    */
-  processDelta(toolCallDelta, enqueue) {
+  processDelta(toolCallDelta) {
     var _a2;
     const index = (_a2 = toolCallDelta.index) != null ? _a2 : this.toolCalls.length;
     if (this.toolCalls[index] == null) {
-      this.processNewToolCall(index, toolCallDelta, enqueue);
+      this.processNewToolCall(index, toolCallDelta);
     } else {
-      this.processExistingToolCall(index, toolCallDelta, enqueue);
+      this.processExistingToolCall(index, toolCallDelta);
     }
   }
   /**
    * Finalize any unfinished tool calls. Should be called during the stream's
    * flush handler to ensure all tool calls are properly completed.
    */
-  flush(enqueue) {
+  flush() {
     for (const toolCall of this.toolCalls) {
       if (!toolCall.hasFinished) {
-        this.finishToolCall(toolCall, enqueue);
+        this.finishToolCall(toolCall);
       }
     }
   }
-  processNewToolCall(index, toolCallDelta, enqueue) {
+  processNewToolCall(index, toolCallDelta) {
     var _a2, _b2, _c;
     if (this.typeValidation === "required") {
       if (toolCallDelta.type !== "function") {
@@ -2842,7 +2869,7 @@ var StreamingToolCallTracker = class {
         message: `Expected 'function.name' to be a string.`
       });
     }
-    enqueue({
+    this.controller.enqueue({
       type: "tool-input-start",
       id: toolCallDelta.id,
       toolName: toolCallDelta.function.name
@@ -2860,17 +2887,17 @@ var StreamingToolCallTracker = class {
     };
     const toolCall = this.toolCalls[index];
     if (toolCall.function.arguments.length > 0) {
-      enqueue({
+      this.controller.enqueue({
         type: "tool-input-delta",
         id: toolCall.id,
         delta: toolCall.function.arguments
       });
     }
     if (isParsableJson(toolCall.function.arguments)) {
-      this.finishToolCall(toolCall, enqueue);
+      this.finishToolCall(toolCall);
     }
   }
-  processExistingToolCall(index, toolCallDelta, enqueue) {
+  processExistingToolCall(index, toolCallDelta) {
     var _a2;
     const toolCall = this.toolCalls[index];
     if (toolCall.hasFinished) {
@@ -2878,19 +2905,19 @@ var StreamingToolCallTracker = class {
     }
     if (((_a2 = toolCallDelta.function) == null ? void 0 : _a2.arguments) != null) {
       toolCall.function.arguments += toolCallDelta.function.arguments;
-      enqueue({
+      this.controller.enqueue({
         type: "tool-input-delta",
         id: toolCall.id,
         delta: toolCallDelta.function.arguments
       });
     }
     if (isParsableJson(toolCall.function.arguments)) {
-      this.finishToolCall(toolCall, enqueue);
+      this.finishToolCall(toolCall);
     }
   }
-  finishToolCall(toolCall, enqueue) {
+  finishToolCall(toolCall) {
     var _a2, _b2;
-    enqueue({
+    this.controller.enqueue({
       type: "tool-input-end",
       id: toolCall.id
     });
@@ -2898,7 +2925,7 @@ var StreamingToolCallTracker = class {
       this,
       toolCall.metadata
     );
-    enqueue({
+    this.controller.enqueue({
       type: "tool-call",
       toolCallId: (_b2 = toolCall.id) != null ? _b2 : this._generateId(),
       toolName: toolCall.function.name,
@@ -2977,8 +3004,9 @@ export {
   createIdGenerator,
   createJsonErrorResponseHandler,
   createJsonResponseHandler,
-  createProviderToolFactory,
-  createProviderToolFactoryWithOutputSchema,
+  createProviderDefinedToolFactory,
+  createProviderDefinedToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   createStatusCodeErrorResponseHandler,
   createToolNameMapping,
   delay,