ai 7.0.98 → 7.0.99

package/dist/internal/index.js

@@ -91,7 +91,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.98" : "0.0.0-test";
+var VERSION = true ? "7.0.99" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/02-foundations/02-providers-and-models.mdx

@@ -97,6 +97,7 @@ The open-source community has created the following providers:
 - [Crusoe Provider](/providers/community-providers/crusoe) (`crusoe-ai-provider`)
 - [Neon AI Gateway Provider](/providers/community-providers/neon-ai-gateway) (`@neon/ai-sdk-provider`)
 - [Interfaze Provider](/providers/community-providers/interfaze) (`@interfaze-ai/ai-sdk`)
+- [Telnyx Provider](/providers/community-providers/telnyx) (`@telnyx/ai-sdk-provider`)
 
 ## Self-Hosted Models
 

package/docs/07-reference/01-ai-sdk-core/06-embed-many.mdx

@@ -81,7 +81,7 @@ const { embeddings } = await embedMany({
       type: 'number',
       isOptional: true,
       description:
-        'Maximum number of concurrent requests to the provider. Default: Infinity.',
+        'Maximum number of concurrent requests when a request is split into multiple model calls. Must be greater than 0 when chunking is active and the model supports parallel calls; invalid values throw AI_InvalidArgumentError. Default: Infinity.',
     },
     {
       name: 'runtimeContext',

package/docs/07-reference/05-ai-sdk-errors/ai-invalid-argument-error.mdx

@@ -7,6 +7,11 @@ description: Learn how to fix AI_InvalidArgumentError
 
 This error occurs when an invalid argument was provided.
 
+For example, `getTextFromDataUrl` throws this error when its `dataUrl` argument
+is malformed or cannot be decoded. Utility validation that is used by higher
+level APIs also uses this error, so you can handle invalid arguments with one
+stable error guard.
+
 ## Properties
 
 - `parameter`: The name of the parameter that is invalid
@@ -21,6 +26,6 @@ You can check if an error is an instance of `AI_InvalidArgumentError` using:
 import { InvalidArgumentError } from 'ai';
 
 if (InvalidArgumentError.isInstance(error)) {
-  // Handle the error
+  console.error(`Invalid ${error.parameter}:`, error.message);
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.98",
+  "version": "7.0.99",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,14 +42,14 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.79",
+    "@ai-sdk/gateway": "4.0.80",
     "@ai-sdk/provider": "4.0.14",
     "@ai-sdk/provider-utils": "5.0.40"
   },
   "devDependencies": {
     "@ai-sdk/amazon-bedrock": "5.0.82",
-    "@ai-sdk/deepseek": "3.0.43",
-    "@ai-sdk/google": "4.0.68",
+    "@ai-sdk/deepseek": "3.0.44",
+    "@ai-sdk/google": "4.0.69",
     "@ai-sdk/groq": "4.0.41",
     "@ai-sdk/huggingface": "2.0.48",
     "@ai-sdk/moonshotai": "3.0.49",

package/src/embed/embed-many.ts

@@ -40,7 +40,9 @@ const originalGenerateCallId = createIdGenerator({
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
  *
- * @param maxParallelCalls - Maximum number of concurrent requests. Default: Infinity.
+ * @param maxParallelCalls - Maximum number of concurrent requests when a request is split into
+ * multiple model calls. Must be greater than 0 when the model supports parallel calls.
+ * Default: Infinity.
  *
  * @param telemetry - Optional telemetry configuration.
  * @param runtimeContext - User-defined runtime context passed to callbacks and, when explicitly included, telemetry.
@@ -121,7 +123,8 @@ export async function embedMany<RUNTIME_CONTEXT extends Context = Context>({
   providerOptions?: ProviderOptions;
 
   /**
-   * Maximum number of concurrent requests.
+   * Maximum number of concurrent requests when a request is split into multiple model calls.
+   * Must be greater than 0 when the model supports parallel calls.
    *
    * @default Infinity
    */

package/src/util/data-url.ts

@@ -1,3 +1,5 @@
+import { InvalidArgumentError } from '../error/invalid-argument-error';
+
 // atob needs to be invoked as a function call, not as a method call.
 // Otherwise Cloudflare will throw a
 // "TypeError: Illegal invocation: function called with incorrect this reference"
@@ -5,18 +7,28 @@ const { atob } = globalThis;
 
 /**
  * Converts a data URL of type text/* to a text string.
+ *
+ * @throws {InvalidArgumentError} If the data URL is malformed or cannot be decoded.
  */
 export function getTextFromDataUrl(dataUrl: string): string {
   const [header, base64Content] = dataUrl.split(',');
   const mediaType = header.split(';')[0].split(':')[1];
 
   if (mediaType == null || base64Content == null) {
-    throw new Error('Invalid data URL format');
+    throw new InvalidArgumentError({
+      parameter: 'dataUrl',
+      value: dataUrl,
+      message: 'Invalid data URL format',
+    });
   }
 
   try {
     return atob(base64Content);
   } catch {
-    throw new Error(`Error decoding data URL`);
+    throw new InvalidArgumentError({
+      parameter: 'dataUrl',
+      value: dataUrl,
+      message: 'Error decoding data URL',
+    });
   }
 }

package/src/util/split-array.ts

@@ -1,3 +1,5 @@
+import { InvalidArgumentError } from '../error/invalid-argument-error';
+
 /**
  * Splits an array into chunks of a specified size.
  *
@@ -5,10 +7,15 @@
  * @param {T[]} array - The array to split.
  * @param {number} chunkSize - The size of each chunk.
  * @returns {T[][]} - A new array containing the chunks.
+ * @throws {InvalidArgumentError} If the chunk size is not greater than 0.
  */
 export function splitArray<T>(array: T[], chunkSize: number): T[][] {
   if (chunkSize <= 0) {
-    throw new Error('chunkSize must be greater than 0');
+    throw new InvalidArgumentError({
+      parameter: 'chunkSize',
+      value: chunkSize,
+      message: 'chunkSize must be greater than 0',
+    });
   }
 
   const result = [];