@ai-sdk/provider-utils 4.0.0-beta.20 → 4.0.0-beta.22

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/provider-utils
 
+## 4.0.0-beta.22
+
+### Patch Changes
+
+- 58920e0: refactor: consolidate header normalization across packages, remove duplicates, preserve custom headers
+
+## 4.0.0-beta.21
+
+### Patch Changes
+
+- 293a6b7: Added a title to the tools
+
 ## 4.0.0-beta.20
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,9 +1,8 @@
 import { JSONSchema7, JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV3Prompt, SharedV3ProviderOptions } from '@ai-sdk/provider';
-import * as z4 from 'zod/v4';
-import { ZodType } from 'zod/v4';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
 import * as z3 from 'zod/v3';
+import * as z4 from 'zod/v4';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
 
 declare function combineHeaders(...headers: Array<Record<string, string | undefined> | undefined>): Record<string, string | undefined>;
@@ -203,7 +202,6 @@ declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage,
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
 declare const createEventSourceResponseHandler: <T>(chunkSchema: FlexibleSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonResponseHandler: <T>(responseSchema: FlexibleSchema<T>) => ResponseHandler<T>;
 declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
@@ -306,6 +304,15 @@ type MaybePromiseLike<T> = T | PromiseLike<T>;
  */
 declare function mediaTypeToExtension(mediaType: string): string;
 
+/**
+ * Normalizes different header inputs into a plain record with lower-case keys.
+ * Entries with `undefined` or `null` values are removed.
+ *
+ * @param headers - Input headers (`Headers`, tuples array, plain record) to normalize.
+ * @returns A record containing the normalized header entries.
+ */
+declare function normalizeHeaders(headers: HeadersInit | Record<string, string | undefined> | Array<[string, string | undefined]> | undefined): Record<string, string>;
+
 /**
  * Parses a JSON event stream into a stream of parsed JSON objects.
  */
@@ -873,6 +880,10 @@ type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT extends JSONVa
      */
     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.
@@ -963,6 +974,7 @@ declare function tool(tool: Tool<never, never>): Tool<never, never>;
  */
 declare function dynamicTool(tool: {
     description?: string;
+    title?: string;
     providerOptions?: ProviderOptions;
     inputSchema: FlexibleSchema<unknown>;
     execute: ToolExecuteFunction<unknown, unknown>;
@@ -1143,4 +1155,4 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
     dynamic?: boolean;
 }
 
-export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isNonNullable, isParsableJson, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, tool, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };
+export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isNonNullable, isParsableJson, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, normalizeHeaders, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, tool, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };

package/dist/index.d.ts

@@ -1,9 +1,8 @@
 import { JSONSchema7, JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV3Prompt, SharedV3ProviderOptions } from '@ai-sdk/provider';
-import * as z4 from 'zod/v4';
-import { ZodType } from 'zod/v4';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
 import * as z3 from 'zod/v3';
+import * as z4 from 'zod/v4';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
 
 declare function combineHeaders(...headers: Array<Record<string, string | undefined> | undefined>): Record<string, string | undefined>;
@@ -203,7 +202,6 @@ declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage,
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
 declare const createEventSourceResponseHandler: <T>(chunkSchema: FlexibleSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonResponseHandler: <T>(responseSchema: FlexibleSchema<T>) => ResponseHandler<T>;
 declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
@@ -306,6 +304,15 @@ type MaybePromiseLike<T> = T | PromiseLike<T>;
  */
 declare function mediaTypeToExtension(mediaType: string): string;
 
+/**
+ * Normalizes different header inputs into a plain record with lower-case keys.
+ * Entries with `undefined` or `null` values are removed.
+ *
+ * @param headers - Input headers (`Headers`, tuples array, plain record) to normalize.
+ * @returns A record containing the normalized header entries.
+ */
+declare function normalizeHeaders(headers: HeadersInit | Record<string, string | undefined> | Array<[string, string | undefined]> | undefined): Record<string, string>;
+
 /**
  * Parses a JSON event stream into a stream of parsed JSON objects.
  */
@@ -873,6 +880,10 @@ type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT extends JSONVa
      */
     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.
@@ -963,6 +974,7 @@ declare function tool(tool: Tool<never, never>): Tool<never, never>;
  */
 declare function dynamicTool(tool: {
     description?: string;
+    title?: string;
     providerOptions?: ProviderOptions;
     inputSchema: FlexibleSchema<unknown>;
     execute: ToolExecuteFunction<unknown, unknown>;
@@ -1143,4 +1155,4 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
     dynamic?: boolean;
 }
 
-export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isNonNullable, isParsableJson, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, tool, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };
+export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type LazySchema, type MaybePromiseLike, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolApprovalRequest, type ToolApprovalResponse, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolNeedsApprovalFunction, type ToolResult, type ToolResultOutput, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, asSchema, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isNonNullable, isParsableJson, isUrlSupported, jsonSchema, lazySchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, normalizeHeaders, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, tool, validateTypes, withUserAgentSuffix, withoutTrailingSlash, zodSchema };

package/dist/index.js

@@ -44,7 +44,6 @@ __export(src_exports, {
   createIdGenerator: () => createIdGenerator,
   createJsonErrorResponseHandler: () => createJsonErrorResponseHandler,
   createJsonResponseHandler: () => createJsonResponseHandler,
-  createJsonStreamResponseHandler: () => createJsonStreamResponseHandler,
   createProviderDefinedToolFactory: () => createProviderDefinedToolFactory,
   createProviderDefinedToolFactoryWithOutputSchema: () => createProviderDefinedToolFactoryWithOutputSchema,
   createStatusCodeErrorResponseHandler: () => createStatusCodeErrorResponseHandler,
@@ -67,6 +66,7 @@ __export(src_exports, {
   loadOptionalSetting: () => loadOptionalSetting,
   loadSetting: () => loadSetting,
   mediaTypeToExtension: () => mediaTypeToExtension,
+  normalizeHeaders: () => normalizeHeaders,
   parseJSON: () => parseJSON,
   parseJsonEventStream: () => parseJsonEventStream,
   parseProviderOptions: () => parseProviderOptions,
@@ -259,29 +259,42 @@ function getRuntimeEnvironmentUserAgent(globalThisAny = globalThis) {
   return "runtime/unknown";
 }
 
-// src/remove-undefined-entries.ts
-function removeUndefinedEntries(record) {
-  return Object.fromEntries(
-    Object.entries(record).filter(([_key, value]) => value != null)
-  );
+// src/normalize-headers.ts
+function normalizeHeaders(headers) {
+  if (headers == null) {
+    return {};
+  }
+  const normalized = {};
+  if (headers instanceof Headers) {
+    headers.forEach((value, key) => {
+      normalized[key.toLowerCase()] = value;
+    });
+  } else {
+    if (!Array.isArray(headers)) {
+      headers = Object.entries(headers);
+    }
+    for (const [key, value] of headers) {
+      if (value != null) {
+        normalized[key.toLowerCase()] = value;
+      }
+    }
+  }
+  return normalized;
 }
 
 // src/with-user-agent-suffix.ts
 function withUserAgentSuffix(headers, ...userAgentSuffixParts) {
-  const cleanedHeaders = removeUndefinedEntries(
-    headers != null ? headers : {}
-  );
-  const normalizedHeaders = new Headers(cleanedHeaders);
+  const normalizedHeaders = new Headers(normalizeHeaders(headers));
   const currentUserAgentHeader = normalizedHeaders.get("user-agent") || "";
   normalizedHeaders.set(
     "user-agent",
     [currentUserAgentHeader, ...userAgentSuffixParts].filter(Boolean).join(" ")
   );
-  return Object.fromEntries(normalizedHeaders);
+  return Object.fromEntries(normalizedHeaders.entries());
 }
 
 // src/version.ts
-var VERSION = true ? "4.0.0-beta.20" : "0.0.0-test";
+var VERSION = true ? "4.0.0-beta.22" : "0.0.0-test";
 
 // src/get-from-api.ts
 var getOriginalFetch = () => globalThis.fetch;
@@ -2209,6 +2222,13 @@ function createProviderDefinedToolFactoryWithOutputSchema({
   });
 }
 
+// src/remove-undefined-entries.ts
+function removeUndefinedEntries(record) {
+  return Object.fromEntries(
+    Object.entries(record).filter(([_key, value]) => value != null)
+  );
+}
+
 // src/resolve.ts
 async function resolve(value) {
   if (typeof value === "function") {
@@ -2286,33 +2306,6 @@ var createEventSourceResponseHandler = (chunkSchema) => async ({ response }) =>
     })
   };
 };
-var createJsonStreamResponseHandler = (chunkSchema) => async ({ response }) => {
-  const responseHeaders = extractResponseHeaders(response);
-  if (response.body == null) {
-    throw new import_provider11.EmptyResponseBodyError({});
-  }
-  let buffer = "";
-  return {
-    responseHeaders,
-    value: response.body.pipeThrough(new TextDecoderStream()).pipeThrough(
-      new TransformStream({
-        async transform(chunkText, controller) {
-          if (chunkText.endsWith("\n")) {
-            controller.enqueue(
-              await safeParseJSON({
-                text: buffer + chunkText,
-                schema: chunkSchema
-              })
-            );
-            buffer = "";
-          } else {
-            buffer += chunkText;
-          }
-        }
-      })
-    )
-  };
-};
 var createJsonResponseHandler = (responseSchema) => async ({ response, url, requestBodyValues }) => {
   const responseBody = await response.text();
   const parsedResult = await safeParseJSON({
@@ -2448,7 +2441,6 @@ var import_stream2 = require("eventsource-parser/stream");
   createIdGenerator,
   createJsonErrorResponseHandler,
   createJsonResponseHandler,
-  createJsonStreamResponseHandler,
   createProviderDefinedToolFactory,
   createProviderDefinedToolFactoryWithOutputSchema,
   createStatusCodeErrorResponseHandler,
@@ -2471,6 +2463,7 @@ var import_stream2 = require("eventsource-parser/stream");
   loadOptionalSetting,
   loadSetting,
   mediaTypeToExtension,
+  normalizeHeaders,
   parseJSON,
   parseJsonEventStream,
   parseProviderOptions,