ai 7.0.94 → 7.0.95

package/docs/07-reference/01-ai-sdk-core/22-get-batch-results.mdx

@@ -0,0 +1,109 @@
+---
+title: experimental_getBatchResults
+description: API Reference for experimental_getBatchResults.
+---
+
+# `experimental_getBatchResults()`
+
+<Note type="warning">
+  Batch support is experimental and the API may change in patch releases.
+</Note>
+
+Returns an async iterable of terminal results for the requests in an
+asynchronous batch. For a complete guide to the batch lifecycle, see
+[Batch](/docs/ai-sdk-core/batch).
+
+```ts
+import { anthropic } from '@ai-sdk/anthropic';
+import { experimental_getBatchResults as getBatchResults } from 'ai';
+
+for await (const item of getBatchResults({ provider: anthropic, batch })) {
+  if (item.status === 'succeeded') {
+    console.log(item.id, item.text);
+  } else {
+    console.error(item.id, item.error);
+  }
+}
+```
+
+## Import
+
+<Snippet
+  text={`import { experimental_getBatchResults } from "ai"`}
+  prompt={false}
+/>
+
+## API Signature
+
+### Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: 'provider',
+      type: 'Experimental_BatchProvider',
+      isOptional: true,
+      description:
+        'The provider used to access the batch. Defaults to the global provider, or the AI Gateway when no global provider is configured.',
+    },
+    {
+      name: 'batch',
+      type: 'Experimental_BatchReference',
+      description:
+        'The serializable reference returned by experimental_startBatch.',
+    },
+    {
+      name: 'tools',
+      type: 'ToolSet',
+      isOptional: true,
+      description:
+        'The client-defined tools provided on requests in the batch. Used to validate and normalize returned tool calls; execute functions are never invoked.',
+    },
+    {
+      name: 'providerOptions',
+      type: 'ProviderOptions',
+      isOptional: true,
+      description: 'Additional provider-specific options for result retrieval.',
+    },
+    {
+      name: 'maxRetries',
+      type: 'number',
+      isOptional: true,
+      description:
+        'Maximum number of retries for result retrieval. Set to 0 to disable retries. Default: 2.',
+    },
+    {
+      name: 'abortSignal',
+      type: 'AbortSignal',
+      isOptional: true,
+      description: 'An optional abort signal to cancel result retrieval.',
+    },
+    {
+      name: 'timeout',
+      type: 'number | { totalMs?: number }',
+      isOptional: true,
+      description: 'Maximum time allowed for result retrieval.',
+    },
+    {
+      name: 'headers',
+      type: 'Record<string, string | undefined>',
+      isOptional: true,
+      description: 'Additional HTTP headers for the request.',
+    },
+  ]}
+/>
+
+### Returns
+
+An `AsyncIterableStream<Experimental_BatchItemResult>` of succeeded,
+failed, cancelled, or expired request results. You can consume the stream as
+either an async iterable or a `ReadableStream`.
+
+Successful items contain `id`, `status: 'succeeded'`, `text`, normalized
+`content` (including text, reasoning, sources, files, tool calls, and tool
+results),
+`finishReason`, `usage`, and optional response and provider metadata. `text` is
+the concatenation of text parts and can be an empty string when a result
+contains no text parts.
+Failed, cancelled, and expired items contain the request `id`, their terminal
+status, and optional error details.

package/docs/07-reference/01-ai-sdk-core/index.mdx

@@ -53,6 +53,21 @@ AI SDK Core contains the following main functions:
         'Generate videos based on a given prompt using a video model.',
       href: '/docs/reference/ai-sdk-core/generate-video',
     },
+    {
+      title: 'experimental_startBatch()',
+      description: 'Start an asynchronous text-generation batch.',
+      href: '/docs/reference/ai-sdk-core/start-batch',
+    },
+    {
+      title: 'experimental_getBatchStatus()',
+      description: 'Retrieve the status of an asynchronous batch.',
+      href: '/docs/reference/ai-sdk-core/get-batch-status',
+    },
+    {
+      title: 'experimental_getBatchResults()',
+      description: 'Retrieve terminal results from an asynchronous batch.',
+      href: '/docs/reference/ai-sdk-core/get-batch-results',
+    },
     {
       title: 'transcribe()',
       description: 'Generate a transcript from an audio file.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.94",
+  "version": "7.0.95",
   "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",
@@ -47,13 +47,13 @@
     "@ai-sdk/provider-utils": "5.0.37"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.77",
+    "@ai-sdk/amazon-bedrock": "5.0.79",
     "@ai-sdk/deepseek": "3.0.40",
     "@ai-sdk/google": "4.0.65",
     "@ai-sdk/groq": "4.0.38",
     "@ai-sdk/huggingface": "2.0.45",
     "@ai-sdk/moonshotai": "3.0.46",
-    "@ai-sdk/openai": "4.0.61",
+    "@ai-sdk/openai": "4.0.63",
     "@ai-sdk/test-server": "2.0.1",
     "@ai-sdk/xai": "4.0.55",
     "@edge-runtime/vm": "^5.0.0",

package/src/embed/embed.ts

@@ -3,6 +3,7 @@ import {
   withUserAgentSuffix,
   type ProviderOptions,
 } from '@ai-sdk/provider-utils';
+import { InvalidResponseDataError } from '../error';
 import { logWarnings } from '../logger/log-warnings';
 import { resolveEmbeddingModel } from '../model/resolve-model';
 import { createTelemetryDispatcher } from '../telemetry/create-telemetry-dispatcher';
@@ -221,6 +222,13 @@ export async function embed({
               callbacks: [telemetryDispatcher.onEmbedEnd],
             });
 
+            if (embedding == null) {
+              throw new InvalidResponseDataError({
+                data: modelResponse.embeddings,
+                message: 'No embedding generated.',
+              });
+            }
+
             return {
               embedding,
               usage,