ai 7.0.44 → 7.0.45

package/dist/internal/index.js

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

package/docs/03-ai-sdk-core/10-generating-structured-data.mdx

@@ -415,16 +415,22 @@ console.log(result.reasoningText);
 
 ## Error Handling
 
-When `generateText` with structured output cannot generate a valid object, it throws a [`AI_NoObjectGeneratedError`](/docs/reference/ai-sdk-errors/ai-no-object-generated-error).
+`generateText` can report structured output failures in two ways:
 
-This error occurs when the AI provider fails to generate a parsable object that conforms to the schema.
-It can arise due to the following reasons:
+- If the model response cannot be parsed or validated against the schema,
+  `generateText` rejects with an
+  [`AI_NoObjectGeneratedError`](/docs/reference/ai-sdk-errors/ai-no-object-generated-error).
+- If `generateText` returns a result without an output, accessing `result.output`
+  throws an
+  [`AI_NoOutputGeneratedError`](/docs/reference/ai-sdk-errors/ai-no-output-generated-error).
+  This can happen when the final step does not finish with a `stop` reason, for
+  example when it finishes with `tool-calls`.
 
-- The model failed to generate a response.
-- The model generated a response that could not be parsed.
-- The model generated a response that could not be validated against the schema.
+The `output` property is a getter, so destructuring it also triggers this
+access.
 
-The error preserves the following information to help you log the issue:
+`NoObjectGeneratedError` preserves the following information to help you log
+the issue:
 
 - `text`: The text that was generated by the model. This can be the raw text or the tool call text, depending on the object generation mode.
 - `response`: Metadata about the language model response, including response id, timestamp, and model.
@@ -432,14 +438,21 @@ The error preserves the following information to help you log the issue:
 - `cause`: The cause of the error (e.g. a JSON parsing error). You can use this for more detailed error handling.
 
 ```ts
-import { generateText, Output, NoObjectGeneratedError } from 'ai';
+import {
+  generateText,
+  NoObjectGeneratedError,
+  NoOutputGeneratedError,
+  Output,
+} from 'ai';
 
 try {
-  await generateText({
+  const result = await generateText({
     model,
     output: Output.object({ schema }),
     prompt,
   });
+
+  console.log(result.output);
 } catch (error) {
   if (NoObjectGeneratedError.isInstance(error)) {
     console.log('NoObjectGeneratedError');
@@ -447,6 +460,8 @@ try {
     console.log('Text:', error.text);
     console.log('Response:', error.response);
     console.log('Usage:', error.usage);
+  } else if (NoOutputGeneratedError.isInstance(error)) {
+    console.log('NoOutputGeneratedError');
   }
 }
 ```

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

@@ -2822,10 +2822,9 @@ To see `generateText` in action, check out [these examples](#examples).
     },
     {
       name: 'output',
-      type: 'Output',
-      isOptional: true,
+      type: 'InferCompleteOutput<OUTPUT>',
       description:
-        'The generated structured output. It uses the `output` specification.',
+        'The generated output according to the `output` specification. Accessing this property throws `NoOutputGeneratedError` when no output is available, for example when the final step does not finish with a `stop` reason.',
     },
     {
       name: 'steps',

package/docs/07-reference/01-ai-sdk-core/02-stream-text.mdx

@@ -622,6 +622,13 @@ To see `streamText` in action, check out [these examples](#examples).
       description:
         "Approval configuration for this call. Pass a `GenericToolApprovalFunction` to handle all tool calls in one callback with `toolCall`, `tools`, `toolsContext`, `messages`, and `runtimeContext`, or pass a per-tool object where each key can be a status (`'not-applicable'`, `'approved'`, `'denied'`, or `'user-approval'`), an object form such as `{ type: 'denied', reason: 'blocked by policy' }`, or a `SingleToolApprovalFunction` that receives the tool input and options `toolCallId`, `messages`, `toolContext`, and `runtimeContext` (same shape as tool execution options without `abortSignal`, with `context` renamed to `toolContext`). The `RUNTIME_CONTEXT` type parameter matches the call's `runtimeContext`. A `GenericToolApprovalFunction` or `SingleToolApprovalFunction` may return `undefined` for the same effect as `'not-applicable'`. `'not-applicable'` is the default execution path and runs the tool without approval metadata. Use `'approved'`, `'denied'`, or their object forms when you want explicit automatic approval request/response parts in the output. Automatic approvals and denials can include a `reason`, which is forwarded to the emitted approval response. This setting takes precedence over a tool's `needsApproval` default.",
     },
+    {
+      name: 'experimental_toolCallers',
+      type: 'Experimental_ToolCallers<TOOLS>',
+      isOptional: true,
+      description:
+        "Configures which caller tools may invoke each tool. The callback receives typed references for caller-capable tools in the `tools` set and returns an object keyed by callee tool name. Include `'direct'` to keep a configured tool directly callable by the model. Local-only callees are hidden from direct model calls and bound to their local caller for each generation step. Provider caller references are translated to provider-native allowed-caller options. Tools without an entry keep their existing direct tool-calling behavior.",
+    },
     {
       name: 'experimental_refineToolInput',
       type: 'ToolInputRefinement<TOOLS>',

package/docs/07-reference/01-ai-sdk-core/16-tool-loop-agent.mdx

@@ -111,6 +111,13 @@ To see `ToolLoopAgent` in action, check out [these examples](#examples).
       description:
         "Approval configuration for the agent. Pass a `GenericToolApprovalFunction` to handle all tool calls in one callback with `toolCall`, `tools`, `toolsContext`, `messages`, and `runtimeContext`, or pass a per-tool object where each key can be a status (`'not-applicable'`, `'approved'`, `'denied'`, or `'user-approval'`), an object form such as `{ type: 'denied', reason: 'blocked by policy' }`, or a `SingleToolApprovalFunction` that receives the tool input and options `toolCallId`, `messages`, `toolContext`, and `runtimeContext` (same shape as tool execution options without `abortSignal`, with `context` renamed to `toolContext`). The `RUNTIME_CONTEXT` type parameter matches the agent's `runtimeContext`. A `GenericToolApprovalFunction` or `SingleToolApprovalFunction` may return `undefined` for the same effect as `'not-applicable'`. `'not-applicable'` is the default execution path and runs the tool without approval metadata. Use `'approved'`, `'denied'`, or their object forms when you want explicit automatic approval request/response parts in the output. Automatic approvals and denials can include a `reason`, which is forwarded to the emitted approval response. This setting takes precedence over a tool's `needsApproval` default.",
     },
+    {
+      name: 'experimental_toolCallers',
+      type: 'Experimental_ToolCallers<TOOLS>',
+      isOptional: true,
+      description:
+        "Configures which caller tools may invoke each tool. The callback receives typed references for caller-capable tools in the agent's `tools` set and returns an object keyed by callee tool name. Include `'direct'` to keep a configured tool directly callable by the model. Local-only callees are hidden from direct model calls and bound to their local caller for each agent step. Provider caller references are translated to provider-native allowed-caller options.",
+    },
     {
       name: 'output',
       type: 'Output',

package/docs/07-reference/05-ai-sdk-errors/ai-no-output-generated-error.mdx

@@ -7,6 +7,11 @@ description: Learn how to fix AI_NoOutputGeneratedError
 
 This error is thrown when no LLM output was generated, e.g. because of errors.
 
+For `generateText`, accessing `result.output` throws this error when the result
+does not contain an output. This can happen when the final step does not finish
+with a `stop` reason, for example when it finishes with `tool-calls`. The
+`output` property is a getter, so destructuring it also triggers this access.
+
 ## Properties
 
 - `message`: The error message (optional, defaults to `'No output generated.'`)

package/docs/08-migration-guides/26-migration-guide-5-0.mdx

@@ -2072,11 +2072,48 @@ import { useAssistant } from '@ai-sdk/react';
 ```
 
 ```tsx filename="AI SDK 5.0"
-// useAssistant has been removed
-// Use useChat with appropriate configuration instead
+import { useChat } from '@ai-sdk/react';
+import { DefaultChatTransport } from 'ai';
+
+function Chat() {
+  const { messages, sendMessage } = useChat({
+    transport: new DefaultChatTransport({
+      api: '/api/chat',
+    }),
+  });
+
+  // ...
+}
 ```
 
-For an implementation of the assistant functionality with AI SDK v5, see this [example repository](https://github.com/vercel-labs/ai-sdk-openai-assistants-api).
+The `useAssistant` hook was specific to the OpenAI Assistants API. OpenAI has
+deprecated that API in favor of the Responses API. Configure `useChat` for your
+route as shown above, then return a UI message stream from the route:
+
+```tsx filename="app/api/chat/route.ts"
+import { openai } from '@ai-sdk/openai';
+import { convertToModelMessages, streamText, type UIMessage } from 'ai';
+
+export async function POST(req: Request) {
+  const { messages }: { messages: UIMessage[] } = await req.json();
+
+  const result = streamText({
+    model: openai.responses('gpt-4o-mini'),
+    prompt: convertToModelMessages(messages),
+  });
+
+  return result.toUIMessageStreamResponse();
+}
+```
+
+For persistent conversation state and built-in tools, see the
+[OpenAI Responses API guide](/cookbook/guides/openai-responses).
+
+If you need to connect `useChat` to another backend, see the
+[transport documentation](/docs/ai-sdk-ui/transport) and
+[stream protocol](/docs/ai-sdk-ui/stream-protocol). For migrating existing
+OpenAI Assistants data and API calls, see OpenAI's
+[Assistants migration guide](https://platform.openai.com/docs/assistants/migration).
 
 #### Attachments → File Parts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.44",
+  "version": "7.0.45",
   "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,9 +42,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.33",
+    "@ai-sdk/gateway": "4.0.34",
     "@ai-sdk/provider": "4.0.4",
-    "@ai-sdk/provider-utils": "5.0.16"
+    "@ai-sdk/provider-utils": "5.0.17"
   },
   "devDependencies": {
     "@edge-runtime/vm": "^5.0.0",

package/src/agent/tool-loop-agent-settings.ts

@@ -22,6 +22,7 @@ import type { PrepareStepFunction } from '../generate-text/prepare-step';
 import type { StopCondition } from '../generate-text/stop-condition';
 import type { StreamTextInclude } from '../generate-text/stream-text';
 import type { ToolApprovalConfiguration } from '../generate-text/tool-approval-configuration';
+import type { Experimental_ToolCallers } from '../generate-text/tool-caller-configuration';
 import type { ToolCallRepairFunction } from '../generate-text/tool-call-repair-function';
 import type {
   OnToolExecutionEndCallback,
@@ -134,6 +135,11 @@ export type ToolLoopAgentSettings<
      */
     toolApproval?: ToolApprovalConfiguration<NoInfer<TOOLS>, RUNTIME_CONTEXT>;
 
+    /**
+     * Configures which caller tools may invoke each tool.
+     */
+    experimental_toolCallers?: Experimental_ToolCallers<NoInfer<TOOLS>>;
+
     /**
      * Optional function that you can use to provide different settings for a step.
      */
@@ -329,6 +335,7 @@ export type ToolLoopAgentSettings<
           | 'activeTools'
           | 'toolOrder'
           | 'toolApproval'
+          | 'experimental_toolCallers'
           | 'providerOptions'
           | 'experimental_download'
           | 'experimental_refineToolInput'
@@ -363,6 +370,7 @@ export type ToolLoopAgentSettings<
         | 'activeTools'
         | 'toolOrder'
         | 'toolApproval'
+        | 'experimental_toolCallers'
         | 'providerOptions'
         | 'experimental_download'
         | 'experimental_refineToolInput'

package/src/generate-text/generate-text-result.ts

@@ -172,8 +172,10 @@ export interface GenerateTextResult<
   readonly finalStep: StepResult<TOOLS, RUNTIME_CONTEXT>;
 
   /**
-   * The generated structured output. It uses the `output` specification.
+   * The generated output according to the `output` specification.
    *
+   * @throws {NoOutputGeneratedError} When no output is available, for example
+   * when the final step does not finish with a `stop` reason.
    */
   readonly output: InferCompleteOutput<OUTPUT>;
 }

package/src/generate-text/generate-text.ts

@@ -30,6 +30,8 @@ import { prepareToolChoice } from '../prompt/prepare-tool-choice';
 import { prepareTools } from '../prompt/prepare-tools';
 import type { Prompt } from '../prompt/prompt';
 import {
+  getChunkTimeoutMs,
+  getFirstChunkTimeoutMs,
   getStepTimeoutMs,
   getTotalTimeoutMs,
   type RequestOptions,
@@ -43,6 +45,7 @@ import type {
   LanguageModel,
   LanguageModelRequestMetadata,
   ToolChoice,
+  Warning,
 } from '../types';
 import {
   addLanguageModelUsage,
@@ -588,6 +591,33 @@ export async function generateText<
     onToolExecutionEnd ?? experimental_onToolCallFinish;
   const resolvedOnStepEnd = onStepEnd ?? onStepFinish;
 
+  const unsupportedTimeoutWarnings: Warning[] = [];
+
+  if (getFirstChunkTimeoutMs(timeout) != null) {
+    unsupportedTimeoutWarnings.push({
+      type: 'unsupported',
+      feature: 'timeout.firstChunkMs',
+      details:
+        'The firstChunkMs timeout is only supported by streaming functions.',
+    });
+  }
+
+  if (getChunkTimeoutMs(timeout) != null) {
+    unsupportedTimeoutWarnings.push({
+      type: 'unsupported',
+      feature: 'timeout.chunkMs',
+      details: 'The chunkMs timeout is only supported by streaming functions.',
+    });
+  }
+
+  if (unsupportedTimeoutWarnings.length > 0) {
+    logWarnings({
+      warnings: unsupportedTimeoutWarnings,
+      provider: model.provider,
+      model: model.modelId,
+    });
+  }
+
   const totalTimeoutMs = getTotalTimeoutMs(timeout);
   const stepTimeoutMs = getStepTimeoutMs(timeout);
   const stepAbortController =

package/src/generate-text/stream-text.ts

@@ -136,6 +136,11 @@ import type {
 } from './stream-text-result';
 import { toResponseMessages } from './to-response-messages';
 import type { ToolApprovalConfiguration } from './tool-approval-configuration';
+import {
+  prepareToolsForToolCallers,
+  resolveToolCallerConfiguration,
+  type Experimental_ToolCallers,
+} from './tool-caller-configuration';
 import type { TypedToolCall } from './tool-call';
 import type { ToolCallRepairFunction } from './tool-call-repair-function';
 import type {
@@ -372,6 +377,7 @@ export function streamText<
   experimental_sandbox: sandbox,
   output,
   toolApproval,
+  experimental_toolCallers,
   experimental_toolApprovalSecret,
   experimental_telemetry,
   telemetry = experimental_telemetry,
@@ -495,6 +501,11 @@ export function streamText<
      */
     toolApproval?: ToolApprovalConfiguration<TOOLS, RUNTIME_CONTEXT>;
 
+    /**
+     * Configures which caller tools may invoke each tool.
+     */
+    experimental_toolCallers?: Experimental_ToolCallers<NoInfer<TOOLS>>;
+
     /**
      * Secret for HMAC-signing tool approval requests. When set, the server
      * signs each approval request at issuance and verifies the signature when
@@ -795,6 +806,7 @@ export function streamText<
     stopConditions: asArray(stopWhen),
     output,
     toolApproval,
+    experimental_toolCallers,
     experimental_toolApprovalSecret,
     providerOptions,
     prepareStep,
@@ -1009,6 +1021,7 @@ class DefaultStreamTextResult<
     stopConditions,
     output,
     toolApproval,
+    experimental_toolCallers,
     experimental_toolApprovalSecret,
     providerOptions,
     prepareStep,
@@ -1064,6 +1077,7 @@ class DefaultStreamTextResult<
     >;
     output: OUTPUT | undefined;
     toolApproval: ToolApprovalConfiguration<TOOLS, RUNTIME_CONTEXT> | undefined;
+    experimental_toolCallers: Experimental_ToolCallers<TOOLS> | undefined;
     experimental_toolApprovalSecret: string | Uint8Array | undefined;
     providerOptions: ProviderOptions | undefined;
     prepareStep:
@@ -1114,6 +1128,10 @@ class DefaultStreamTextResult<
   }) {
     this.outputSpecification = output;
     this.tools = tools;
+    const resolvedToolCallers = resolveToolCallerConfiguration({
+      tools,
+      toolCallers: experimental_toolCallers,
+    });
 
     const telemetryDispatcher = createRestrictedTelemetryDispatcher<
       TOOLS,
@@ -1938,10 +1956,20 @@ class DefaultStreamTextResult<
             tools,
             activeTools: prepareStepResult?.activeTools ?? activeTools,
           });
+          const {
+            executionTools: stepExecutionTools,
+            modelTools: stepModelTools,
+          } = prepareToolsForToolCallers({
+            tools: stepActiveTools,
+            toolCallers: resolvedToolCallers,
+          });
           const stepToolOrder = prepareStepResult?.toolOrder ?? toolOrder;
 
           const stepTools = await prepareTools({
-            tools: stepActiveTools,
+            tools: stepModelTools as ActiveToolSubset<
+              TOOLS,
+              ActiveTools<NoInfer<TOOLS>>
+            >,
             toolOrder: stepToolOrder as ToolOrder<
               ActiveToolSubset<TOOLS, ActiveTools<NoInfer<TOOLS>>>
             >,
@@ -1986,7 +2014,7 @@ class DefaultStreamTextResult<
             retry(async () =>
               streamLanguageModelCall({
                 model: prepareStepResult?.model ?? model,
-                tools: stepActiveTools,
+                tools: stepModelTools as TOOLS,
                 toolOrder: stepToolOrder,
                 toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
                 instructions: stepInstructions,
@@ -2056,7 +2084,7 @@ class DefaultStreamTextResult<
           const streamAfterToolCallbackInvocation =
             invokeToolCallbacksFromStream({
               stream: languageModelStream,
-              tools,
+              tools: stepExecutionTools as TOOLS,
               stepInputMessages: stepMessages,
               abortSignal,
               runtimeContext,
@@ -2079,7 +2107,7 @@ class DefaultStreamTextResult<
 
           const streamWithToolResults = executeToolsFromStream({
             stream: streamAfterToolCallbackInvocation,
-            tools,
+            tools: stepExecutionTools as TOOLS,
             callId,
             messages: stepMessages,
             abortSignal,
@@ -2360,7 +2388,7 @@ class DefaultStreamTextResult<
                   // the client tool's result is sent back.
                   for (const toolCall of stepToolCalls) {
                     if (toolCall.providerExecuted !== true) continue;
-                    const tool = getOwn(tools, toolCall.toolName);
+                    const tool = getOwn(stepExecutionTools, toolCall.toolName);
                     if (
                       tool?.type === 'provider' &&
                       tool.supportsDeferredResults