ai 7.0.92 → 7.0.93

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # ai
 
+## 7.0.93
+
+### Patch Changes
+
+- df6c009: fix(ai): use new message ID when replacing a message in `sendMessage`
+- 6ee74a3: fix(ai): preserve tool part titles when validating UI messages
+- f13d371: fix(ai): preserve provider metadata when converting failed tool calls
+- d4485fe: feat(ai): support minItems and maxItems in array outputs
+- 4f201cc: chore(ai): formally include already supported `onLanguageModelCallStart` and `onLanguageModelCallEnd` in `ToolLoopAgentSettings` type
+- 8cdb2a7: fix(ai): decode text data URLs in Node.js
+- 0f2281e: fix(ai): reject embedding responses whose count does not match the input values
+- fc8e8ac: fix(ai): preserve image call diagnostics when no image is generated
+- ee8391e: fix(ai): support abort signals when the global AbortSignal is not a constructor
+- Updated dependencies [3cfc1fc]
+  - @ai-sdk/gateway@4.0.75
+
 ## 7.0.92
 
 ### Patch Changes

package/dist/index.d.ts

@@ -3814,13 +3814,23 @@ declare const object: <OBJECT>({ schema: inputSchema, name, description, }: {
  * When the model generates a text response, it will return an array of elements.
  *
  * @param element - The schema of the array elements to generate.
+ * @param minItems - Optional minimum number of elements to generate.
+ * @param maxItems - Optional maximum number of elements to generate.
  * @param name - Optional name of the output that should be generated. Used by some providers for additional LLM guidance, e.g. via tool or schema name.
  * @param description - Optional description of the output that should be generated. Used by some providers for additional LLM guidance, e.g. via tool or schema description.
  *
  * @returns An output specification for generating an array of elements.
  */
-declare const array: <ELEMENT>({ element: inputElementSchema, name, description, }: {
+declare const array: <ELEMENT>({ element: inputElementSchema, minItems, maxItems, name, description, }: {
     element: FlexibleSchema<ELEMENT>;
+    /**
+     * Optional minimum number of elements to generate.
+     */
+    minItems?: number;
+    /**
+     * Optional maximum number of elements to generate.
+     */
+    maxItems?: number;
     /**
      * Optional name of the output that should be generated.
      * Used by some providers for additional LLM guidance, e.g. via tool or schema name.
@@ -5156,6 +5166,15 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
      * @deprecated Use `onStepStart` instead.
      */
     experimental_onStepStart?: GenerateTextOnStepStartCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>, NoInfer<OUTPUT>>;
+    /**
+     * Callback that is called immediately before the provider model call begins.
+     */
+    onLanguageModelCallStart?: OnLanguageModelCallStartCallback;
+    /**
+     * Callback that is called after the model response has been normalized and parsed,
+     * but before any client-side tool execution begins.
+     */
+    onLanguageModelCallEnd?: OnLanguageModelCallEndCallback<NoInfer<TOOLS>>;
     /**
      * Callback that is called before each tool execution begins.
      */
@@ -6839,6 +6858,156 @@ declare class MissingToolResultsError extends AISDKError {
     static isInstance(error: unknown): error is MissingToolResultsError;
 }
 
+type ActiveToolSubset<TOOLS extends ToolSet | undefined, ACTIVE_TOOL_NAMES extends ActiveTools<NonNullable<TOOLS>>> = TOOLS extends undefined ? undefined : [ACTIVE_TOOL_NAMES] extends [NonNullable<ActiveTools<NonNullable<TOOLS>>>] ? Pick<NonNullable<TOOLS>, ACTIVE_TOOL_NAMES[number]> : TOOLS;
+/**
+ * Filters the tools to only include the active tools.
+ * When activeTools is provided, we only include the tools that are in the list.
+ *
+ * @param tools - The tools to filter.
+ * @param activeTools - The active tools to include.
+ * @returns The filtered tools.
+ */
+declare function filterActiveTools<TOOLS extends ToolSet | undefined, ACTIVE_TOOL_NAMES extends ActiveTools<NonNullable<TOOLS>>>({ tools, activeTools, }: {
+    tools: TOOLS;
+    activeTools: ACTIVE_TOOL_NAMES;
+}): ActiveToolSubset<TOOLS, ACTIVE_TOOL_NAMES>;
+
+/**
+ * Prunes model messages from a list of model messages.
+ *
+ * @param messages - The list of model messages to prune.
+ * @param reasoning - How to remove reasoning content from assistant messages. Default is `'none'`.
+ * @param toolCalls - How to prune tool call/results/approval content. Default is `[]`.
+ * @param emptyMessages - Whether to keep or remove messages whose content is empty after pruning. Default is `'remove'`.
+ *
+ * @returns The pruned list of model messages.
+ */
+declare function pruneMessages({ messages, reasoning, toolCalls, emptyMessages, }: {
+    messages: ModelMessage[];
+    reasoning?: 'all' | 'before-last-message' | 'none';
+    toolCalls?: 'all' | 'before-last-message' | `before-last-${number}-messages` | 'none' | Array<{
+        type: 'all' | 'before-last-message' | `before-last-${number}-messages`;
+        tools?: string[];
+    }>;
+    emptyMessages?: 'keep' | 'remove';
+}): ModelMessage[];
+
+/**
+ * Detects the first chunk in a buffer.
+ *
+ * @param buffer - The buffer to detect the first chunk in.
+ *
+ * @returns The first detected chunk, or `undefined` if no chunk was detected.
+ */
+type ChunkDetector = (buffer: string) => string | undefined | null;
+/**
+ * Smooths text and reasoning streaming output.
+ *
+ * @param delayInMs - The delay in milliseconds between each chunk. Defaults to 10ms. Can be set to `null` to skip the delay. The delay is skipped while the document is hidden (e.g. browser background tabs), where timer throttling would otherwise stall the stream.
+ * @param chunking - Controls how the text is chunked for streaming. Use "word" to stream word by word (default), "line" to stream line by line, provide a custom RegExp pattern that does not match the empty string for custom chunking, provide an Intl.Segmenter for locale-aware word segmentation (recommended for CJK languages), or provide a custom ChunkDetector function.
+ *
+ * @returns A transform stream that smooths text streaming output.
+ */
+declare function smoothStream<TOOLS extends ToolSet>({ delayInMs, chunking, _internal: { delay }, }?: {
+    delayInMs?: number | null;
+    chunking?: 'word' | 'line' | RegExp | ChunkDetector | Intl.Segmenter;
+    /**
+     * Internal. For test use only. May change without notice.
+     */
+    _internal?: {
+        delay?: (delayInMs: number | null) => Promise<void>;
+    };
+}): (options: {
+    tools: TOOLS;
+}) => TransformStream<TextStreamPart<TOOLS>, TextStreamPart<TOOLS>>;
+
+/**
+ * Fingerprint the server-controlled, security-relevant fields of each tool in a
+ * `ToolSet`: `description` (string form only), the resolved input JSON schema,
+ * and `title`. Returns a map of tool name to a stable digest.
+ *
+ * Capture a baseline at trust time (first connect, human-reviewed) and compare
+ * later fetches with {@link detectToolDrift} to catch MCP tool-definition drift
+ * ("rug pull"). Baseline storage and the drift response are the app's concern.
+ */
+declare function fingerprintTools(tools: ToolSet): Promise<Record<string, string>>;
+/**
+ * Pure diff of two fingerprint maps produced by {@link fingerprintTools}.
+ * `added`/`removed` are tools present in only one map; `changed` are tools whose
+ * pinned definition differs. Uses own-property lookups so a tool literally named
+ * `constructor` or `toString` diffs correctly.
+ */
+declare function detectToolDrift(current: Record<string, string>, baseline: Record<string, string>): {
+    added: string[];
+    removed: string[];
+    changed: string[];
+};
+
+/**
+ * The result of one underlying image model call.
+ */
+interface GenerateImageCall {
+    /**
+     * The images generated by this call.
+     */
+    readonly images: Array<GeneratedFile>;
+    /**
+     * Provider-specific metadata for this call.
+     */
+    readonly providerMetadata?: ImageModelV4ProviderMetadata;
+    /**
+     * Response metadata from the provider.
+     */
+    readonly response: ImageModelResponseMetadata;
+    /**
+     * Warnings for this call, e.g. unsupported settings.
+     */
+    readonly warnings: Array<Warning>;
+    /**
+     * Token usage for this call, if reported by the provider.
+     */
+    readonly usage?: ImageModelUsage;
+}
+/**
+ * The result of a `generateImage` call.
+ * It contains the images and additional information.
+ */
+interface GenerateImageResult {
+    /**
+     * The first image that was generated.
+     */
+    readonly image: GeneratedFile;
+    /**
+     * The images that were generated.
+     */
+    readonly images: Array<GeneratedFile>;
+    /**
+     * The results of the underlying image model calls.
+     */
+    readonly calls: Array<GenerateImageCall>;
+    /**
+     * Warnings for the call, e.g. unsupported settings.
+     */
+    readonly warnings: Array<Warning>;
+    /**
+     * Response metadata from the provider. There may be multiple responses if we made multiple calls to the model.
+     *
+     * @deprecated Use `calls` to preserve each response with its corresponding images, metadata, warnings, and usage.
+     */
+    readonly responses: Array<ImageModelResponseMetadata>;
+    /**
+     * Provider-specific metadata. They are passed through from the provider to the AI SDK and enable provider-specific
+     * results that can be fully encapsulated in the provider.
+     *
+     * @deprecated Use the provider metadata in `calls` or on individual `images` to preserve its scope.
+     */
+    readonly providerMetadata: ImageModelProviderMetadata;
+    /**
+     * Combined token usage across all underlying provider calls for this image generation.
+     */
+    readonly usage: ImageModelUsage;
+}
+
 declare const symbol$f: unique symbol;
 /**
  * Thrown when no image could be generated. This can have multiple causes:
@@ -6848,13 +7017,18 @@ declare const symbol$f: unique symbol;
  */
 declare class NoImageGeneratedError extends AISDKError {
     private readonly [symbol$f];
+    /**
+     * The results of the underlying image model calls.
+     */
+    readonly calls: Array<GenerateImageCall> | undefined;
     /**
      * The response metadata for each call.
      */
     readonly responses: Array<ImageModelResponseMetadata> | undefined;
-    constructor({ message, cause, responses, }: {
+    constructor({ message, cause, calls, responses, }: {
         message?: string;
         cause?: Error;
+        calls?: Array<GenerateImageCall>;
         responses?: Array<ImageModelResponseMetadata>;
     });
     static isInstance(error: unknown): error is NoImageGeneratedError;
@@ -7212,156 +7386,6 @@ declare class RetryError extends AISDKError {
     static isInstance(error: unknown): error is RetryError;
 }
 
-type ActiveToolSubset<TOOLS extends ToolSet | undefined, ACTIVE_TOOL_NAMES extends ActiveTools<NonNullable<TOOLS>>> = TOOLS extends undefined ? undefined : [ACTIVE_TOOL_NAMES] extends [NonNullable<ActiveTools<NonNullable<TOOLS>>>] ? Pick<NonNullable<TOOLS>, ACTIVE_TOOL_NAMES[number]> : TOOLS;
-/**
- * Filters the tools to only include the active tools.
- * When activeTools is provided, we only include the tools that are in the list.
- *
- * @param tools - The tools to filter.
- * @param activeTools - The active tools to include.
- * @returns The filtered tools.
- */
-declare function filterActiveTools<TOOLS extends ToolSet | undefined, ACTIVE_TOOL_NAMES extends ActiveTools<NonNullable<TOOLS>>>({ tools, activeTools, }: {
-    tools: TOOLS;
-    activeTools: ACTIVE_TOOL_NAMES;
-}): ActiveToolSubset<TOOLS, ACTIVE_TOOL_NAMES>;
-
-/**
- * Prunes model messages from a list of model messages.
- *
- * @param messages - The list of model messages to prune.
- * @param reasoning - How to remove reasoning content from assistant messages. Default is `'none'`.
- * @param toolCalls - How to prune tool call/results/approval content. Default is `[]`.
- * @param emptyMessages - Whether to keep or remove messages whose content is empty after pruning. Default is `'remove'`.
- *
- * @returns The pruned list of model messages.
- */
-declare function pruneMessages({ messages, reasoning, toolCalls, emptyMessages, }: {
-    messages: ModelMessage[];
-    reasoning?: 'all' | 'before-last-message' | 'none';
-    toolCalls?: 'all' | 'before-last-message' | `before-last-${number}-messages` | 'none' | Array<{
-        type: 'all' | 'before-last-message' | `before-last-${number}-messages`;
-        tools?: string[];
-    }>;
-    emptyMessages?: 'keep' | 'remove';
-}): ModelMessage[];
-
-/**
- * Detects the first chunk in a buffer.
- *
- * @param buffer - The buffer to detect the first chunk in.
- *
- * @returns The first detected chunk, or `undefined` if no chunk was detected.
- */
-type ChunkDetector = (buffer: string) => string | undefined | null;
-/**
- * Smooths text and reasoning streaming output.
- *
- * @param delayInMs - The delay in milliseconds between each chunk. Defaults to 10ms. Can be set to `null` to skip the delay. The delay is skipped while the document is hidden (e.g. browser background tabs), where timer throttling would otherwise stall the stream.
- * @param chunking - Controls how the text is chunked for streaming. Use "word" to stream word by word (default), "line" to stream line by line, provide a custom RegExp pattern that does not match the empty string for custom chunking, provide an Intl.Segmenter for locale-aware word segmentation (recommended for CJK languages), or provide a custom ChunkDetector function.
- *
- * @returns A transform stream that smooths text streaming output.
- */
-declare function smoothStream<TOOLS extends ToolSet>({ delayInMs, chunking, _internal: { delay }, }?: {
-    delayInMs?: number | null;
-    chunking?: 'word' | 'line' | RegExp | ChunkDetector | Intl.Segmenter;
-    /**
-     * Internal. For test use only. May change without notice.
-     */
-    _internal?: {
-        delay?: (delayInMs: number | null) => Promise<void>;
-    };
-}): (options: {
-    tools: TOOLS;
-}) => TransformStream<TextStreamPart<TOOLS>, TextStreamPart<TOOLS>>;
-
-/**
- * Fingerprint the server-controlled, security-relevant fields of each tool in a
- * `ToolSet`: `description` (string form only), the resolved input JSON schema,
- * and `title`. Returns a map of tool name to a stable digest.
- *
- * Capture a baseline at trust time (first connect, human-reviewed) and compare
- * later fetches with {@link detectToolDrift} to catch MCP tool-definition drift
- * ("rug pull"). Baseline storage and the drift response are the app's concern.
- */
-declare function fingerprintTools(tools: ToolSet): Promise<Record<string, string>>;
-/**
- * Pure diff of two fingerprint maps produced by {@link fingerprintTools}.
- * `added`/`removed` are tools present in only one map; `changed` are tools whose
- * pinned definition differs. Uses own-property lookups so a tool literally named
- * `constructor` or `toString` diffs correctly.
- */
-declare function detectToolDrift(current: Record<string, string>, baseline: Record<string, string>): {
-    added: string[];
-    removed: string[];
-    changed: string[];
-};
-
-/**
- * The result of one underlying image model call.
- */
-interface GenerateImageCall {
-    /**
-     * The images generated by this call.
-     */
-    readonly images: Array<GeneratedFile>;
-    /**
-     * Provider-specific metadata for this call.
-     */
-    readonly providerMetadata?: ImageModelV4ProviderMetadata;
-    /**
-     * Response metadata from the provider.
-     */
-    readonly response: ImageModelResponseMetadata;
-    /**
-     * Warnings for this call, e.g. unsupported settings.
-     */
-    readonly warnings: Array<Warning>;
-    /**
-     * Token usage for this call, if reported by the provider.
-     */
-    readonly usage?: ImageModelUsage;
-}
-/**
- * The result of a `generateImage` call.
- * It contains the images and additional information.
- */
-interface GenerateImageResult {
-    /**
-     * The first image that was generated.
-     */
-    readonly image: GeneratedFile;
-    /**
-     * The images that were generated.
-     */
-    readonly images: Array<GeneratedFile>;
-    /**
-     * The results of the underlying image model calls.
-     */
-    readonly calls: Array<GenerateImageCall>;
-    /**
-     * Warnings for the call, e.g. unsupported settings.
-     */
-    readonly warnings: Array<Warning>;
-    /**
-     * Response metadata from the provider. There may be multiple responses if we made multiple calls to the model.
-     *
-     * @deprecated Use `calls` to preserve each response with its corresponding images, metadata, warnings, and usage.
-     */
-    readonly responses: Array<ImageModelResponseMetadata>;
-    /**
-     * Provider-specific metadata. They are passed through from the provider to the AI SDK and enable provider-specific
-     * results that can be fully encapsulated in the provider.
-     *
-     * @deprecated Use the provider metadata in `calls` or on individual `images` to preserve its scope.
-     */
-    readonly providerMetadata: ImageModelProviderMetadata;
-    /**
-     * Combined token usage across all underlying provider calls for this image generation.
-     */
-    readonly usage: ImageModelUsage;
-}
-
 type GenerateImagePrompt = string | {
     images: Array<DataContent>;
     text?: string;