ai 7.0.144 → 7.0.146

package/docs/03-ai-sdk-core/16-mcp-tools.mdx

@@ -210,6 +210,33 @@ tokens are invalid.
 
 ### OAuth Authorization Server Validation
 
+Pre-registered confidential clients must be bound to their authorization server
+before starting OAuth. Set `issuer` on the credentials returned by
+`clientInformation()` to the issuer of the server that registered the client:
+
+```typescript
+clientInformation() {
+  return {
+    client_id: process.env.OAUTH_CLIENT_ID!,
+    client_secret: process.env.OAUTH_CLIENT_SECRET!,
+    issuer: 'https://accounts.example.com',
+  };
+}
+```
+
+The issuer must exactly match the discovered issuer. The SDK rejects a mismatch
+before redirecting or sending credentials, even if a stored authorization flow
+pin names the discovered server. Dynamic client registration attaches this
+binding automatically.
+
+Existing complete authorization server bindings on credentials, stored tokens,
+or `authorizationServerInformation()` are also supported. Without a binding,
+a pre-registered client secret or custom `addClientAuthentication` handler is
+rejected, even when `validateAuthorizationServerURL` accepts the selected server.
+Approving a server does not establish that the credentials belong to it.
+Do not derive the credential issuer from the MCP server's metadata; configure it
+from the client's registration.
+
 When using MCP OAuth in server-side applications, the MCP server can advertise
 the OAuth authorization server to use. If you connect to MCP servers outside
 your control, implement `validateAuthorizationServerURL` on your
@@ -237,8 +264,8 @@ const myOAuthClientProvider = {
 ```
 
 This hook is called before the SDK fetches authorization server metadata, so a
-rejected URL is not requested. It is optional and does not change existing OAuth
-flows unless you implement it.
+rejected URL is not requested. The hook is an optional additional restriction;
+it does not replace the credential binding required for confidential clients.
 
 ### OAuth Callback Issuer Validation
 

package/docs/03-ai-sdk-core/18-tools.mdx

@@ -0,0 +1,137 @@
+---
+title: Tools
+description: Use first-party AI SDK tools to add capabilities to agents and applications.
+---
+
+# Tools
+
+The AI SDK provides first-party tools for agents and applications. Each tool
+includes its input schema, model-facing description, and
+execution logic, ready to use with `generateText`, `streamText`, or `ToolLoopAgent`.
+These tools work with any model that supports function calling.
+
+Install tools from their individual `@ai-sdk/tool-*` packages.
+
+For defining your own tools and configuring tool execution, see
+[Tools and Tool Calling](/docs/ai-sdk-core/tools-and-tool-calling).
+
+## Bash Tool
+
+`createBashTool` lets agents run Bash commands to search, analyze, and transform files.
+Supply an `Experimental_SandboxSession` to choose where commands run. Use
+`@ai-sdk/sandbox-just-bash` for an in-memory environment,
+`@ai-sdk/sandbox-vercel` for Vercel Sandbox, or your own implementation.
+The tool has no direct dependency on either runtime.
+
+### Installation
+
+Install the tool and the sandbox adapter you want to use. The following examples
+use just-bash:
+
+```sh
+pnpm add ai @ai-sdk/tool-bash @ai-sdk/sandbox-just-bash
+```
+
+Requires Node.js 22.13 or newer.
+
+### Usage
+
+```ts
+import { createJustBashNetworkSandboxSession } from '@ai-sdk/sandbox-just-bash';
+import { createBashTool } from '@ai-sdk/tool-bash';
+import { generateText, isStepCount } from 'ai';
+
+const session = await createJustBashNetworkSandboxSession();
+
+try {
+  const sandbox = session.restricted();
+  await sandbox.writeTextFile({
+    path: 'notes.txt',
+    content: 'Apples: 10\nPears: 20\n',
+  });
+  const bash = await createBashTool({ sandbox });
+
+  const result = await generateText({
+    model, // Your configured model with function calling support.
+    tools: { bash },
+    stopWhen: isStepCount(5),
+    prompt: 'Read notes.txt and write a summary to summary.txt.',
+  });
+
+  console.log(result.text);
+  console.log(await sandbox.readTextFile({ path: 'summary.txt' }));
+} finally {
+  await session.destroy();
+}
+```
+
+### Vercel Sandbox
+
+Install `@ai-sdk/sandbox-vercel` and `@vercel/sandbox` to use an existing native
+Vercel Sandbox. Wrap it with the adapter before passing it to the tool:
+
+```ts
+import { createVercelSandboxSessionFromNativeSandbox } from '@ai-sdk/sandbox-vercel';
+import { createBashTool } from '@ai-sdk/tool-bash';
+import { Sandbox } from '@vercel/sandbox';
+
+const nativeSandbox = await Sandbox.create();
+
+try {
+  const sandbox = createVercelSandboxSessionFromNativeSandbox(nativeSandbox);
+  await sandbox.writeTextFile({
+    path: 'notes.txt',
+    content: 'Hello from Vercel Sandbox',
+  });
+  const bash = await createBashTool({ sandbox });
+
+  // Use bash with generateText, streamText, or ToolLoopAgent here.
+} finally {
+  await nativeSandbox.stop();
+}
+```
+
+You can also create a managed session with
+`createVercelNetworkSandboxSession()` from `@ai-sdk/sandbox-vercel` and pass
+`session.restricted()`. For an existing native just-bash `Sandbox`, use
+`createJustBashSandboxSessionFromNativeSandbox()` from `@ai-sdk/sandbox-just-bash`.
+Raw runtime instances need their respective adapters; a custom
+`Experimental_SandboxSession` can be passed directly.
+
+### Options
+
+`createBashTool()` requires an options object:
+
+| Option             | Type                          | Description                                                                                                                   |
+| ------------------ | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `sandbox`          | `Experimental_SandboxSession` | Required session for command execution and file operations.                                                                   |
+| `workingDirectory` | `string`                      | Optional absolute starting directory for each command, created if needed. When omitted, uses the sandbox's default directory. |
+| `maxOutputLength`  | `number`                      | Positive integer limiting characters retained from each output stream before a truncation notice. Defaults to `30000`.        |
+
+The model calls the tool with `{ command: string }` and receives
+`{ stdout, stderr, exitCode }`. Nonzero exit codes are returned so the model can
+inspect failures and recover. AI SDK cancellation is forwarded to the session.
+Output truncation happens after execution and does not limit execution memory or
+duration.
+
+### Files and lifecycle
+
+Commands use the sandbox's default working directory unless `workingDirectory`
+is provided. Without an override, creating the tool runs no setup commands.
+Seed files through `sandbox.writeTextFile({ path, content })` before running the
+tool. With an explicit working directory, use absolute paths to write files there.
+
+The sandbox controls which files commands can access. Available programs, network
+access, shell state, and persistence depend on the supplied sandbox. Its
+description is included in the tool's instructions.
+
+Tools using the same session share files. Creating a tool does not reset existing
+files or create a new sandbox. Use separate sessions for independent workflows.
+The caller creates, reconnects, and destroys the sandbox.
+
+`createBashTool()` returns the tool directly, ready to use as `tools: { bash }`.
+Use the supplied sandbox's `readTextFile({ path })` to read generated text files;
+it returns `null` if the file is missing. Relative read paths depend on the
+sandbox adapter; just-bash resolves them against its default directory. With an
+explicit working directory, use absolute paths to read files from that directory.
+The same session provides other file operations.

package/docs/03-ai-sdk-core/index.mdx

@@ -28,6 +28,12 @@ description: Learn about AI SDK Core.
       description: 'Learn how to do tool calling with AI SDK Core.',
       href: '/docs/ai-sdk-core/tools-and-tool-calling',
     },
+    {
+      title: 'Tools',
+      description:
+        'Add capabilities to agents and applications with first-party AI SDK tools.',
+      href: '/docs/ai-sdk-core/tools',
+    },
     {
       title: 'Tool Search',
       description:

package/docs/03-ai-sdk-harnesses/05-harness-adapters.mdx

@@ -36,12 +36,12 @@ The AI SDK includes the following harness adapters:
 | Adapter                                                      | Runtime location | Custom tools | Custom skills | Structured output | Built-in tool approval | Built-in tool filtering      | Image input | History access |
 | ------------------------------------------------------------ | ---------------- | ------------ | ------------- | ----------------- | ---------------------- | ---------------------------- | ----------- | -------------- |
 | [Claude Code](/providers/ai-sdk-harnesses/claude-code)       | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Check />   | <Cross />      |
-| [Cline](/providers/ai-sdk-harnesses/cline)                   | Host process     | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Cross />   | <Cross />      |
-| [Codex](/providers/ai-sdk-harnesses/codex)                   | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Cross />              | <Cross />                    | <Cross />   | <Cross />      |
+| [Cline](/providers/ai-sdk-harnesses/cline)                   | Host process     | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Check />   | <Cross />      |
+| [Codex](/providers/ai-sdk-harnesses/codex)                   | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Cross />              | <Cross />                    | <Check />   | <Cross />      |
 | [Cursor](/providers/ai-sdk-harnesses/cursor)                 | Sandbox via ACP  | <Check />    | <Check />     | <Cross />         | <Cross />              | <Cross />                    | <Cross />   | <Cross />      |
 | [Deep Agents](/providers/ai-sdk-harnesses/deepagents)        | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Check />              | <Check /> via auto-rejection | <Cross />   | <Cross />      |
 | [fx](/providers/ai-sdk-harnesses/fx)                         | Host process     | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Cross />   | <Cross />      |
 | [GitHub Copilot](/providers/ai-sdk-harnesses/github-copilot) | Sandbox via ACP  | <Check />    | <Check />     | <Cross />         | <Cross />              | <Cross />                    | <Cross />   | <Cross />      |
 | [Grok Build](/providers/ai-sdk-harnesses/grok-build)         | Sandbox via ACP  | <Check />    | <Check />     | <Check />         | <Cross />              | <Cross />                    | <Cross />   | <Cross />      |
 | [OpenCode](/providers/ai-sdk-harnesses/opencode)             | Sandbox bridge   | <Check />    | <Check />     | <Check />         | <Check />              | <Check />                    | <Cross />   | <Cross />      |
-| [Pi](/providers/ai-sdk-harnesses/pi)                         | Host process     | <Check />    | <Check />     | <Cross />         | <Check />              | <Check />                    | <Cross />   | <Cross />      |
+| [Pi](/providers/ai-sdk-harnesses/pi)                         | Host process     | <Check />    | <Check />     | <Cross />         | <Check />              | <Check />                    | <Check />   | <Cross />      |

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

@@ -14,19 +14,24 @@ state. See [Decisions](/docs/ai-sdk-core/decisions) for examples and semantics.
 
 ## Parameters
 
-| Parameter         | Type                                             | Description                                                                                                                               |
-| ----------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `model`           | `Experimental_DecisionModel`                     | Required experimental v4 model instance or a string ID resolved by Gateway or an explicitly configured decision-capable default provider. |
-| `state`           | `Experimental_DecisionState`                     | Required string, JSON object, or ordered array of text, file, and JSON parts.                                                             |
-| `questions`       | `Record<string, Experimental_DecisionQuestion>`  | Required nonempty question map.                                                                                                           |
-| `maxRetries`      | `number`                                         | Nonnegative integer; defaults to 2.                                                                                                       |
-| `abortSignal`     | `AbortSignal`                                    | Cancels the decisions request.                                                                                                            |
-| `headers`         | `Record<string, string>`                         | Additional HTTP headers.                                                                                                                  |
-| `providerOptions` | `ProviderOptions`                                | Provider-specific options.                                                                                                                |
-| `telemetry`       | `TelemetryOptions`                               | Telemetry configuration, including per-call integrations, input/output recording, and a function ID.                                      |
-| `runtimeContext`  | `Record<string, unknown>`                        | Context available to lifecycle callbacks and selectively included in telemetry with `telemetry.includeRuntimeContext`.                    |
-| `onStart`         | `(event: Experimental_DecideStartEvent) => void` | Called when the decision operation begins.                                                                                                |
-| `onEnd`           | `(event: Experimental_DecideEndEvent) => void`   | Called when the decision operation completes successfully.                                                                                |
+| Parameter         | Type                                                                                           | Description                                                                                                                               |
+| ----------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `model`           | `Experimental_DecisionModel`                                                                   | Required experimental v4 model instance or a string ID resolved by Gateway or an explicitly configured decision-capable default provider. |
+| `state`           | `Experimental_DecisionState`                                                                   | Required string, JSON object, or ordered array of text, file, and JSON parts.                                                             |
+| `questions`       | `Record<string, Experimental_DecisionQuestion>`                                                | Required nonempty question map.                                                                                                           |
+| `maxOutputTokens` | `number`                                                                                       | Optional maximum output tokens, an integer >= 1.                                                                                          |
+| `reasoning`       | `'provider-default' \| 'none' \| 'minimal' \| 'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | Optional reasoning effort. Language-model adapters default to `'none'`. Native decision providers return an unsupported-setting warning.  |
+| `maxRetries`      | `number`                                                                                       | Nonnegative integer; defaults to 2.                                                                                                       |
+| `abortSignal`     | `AbortSignal`                                                                                  | Cancels the decisions request.                                                                                                            |
+| `headers`         | `Record<string, string>`                                                                       | Additional HTTP headers.                                                                                                                  |
+| `providerOptions` | `ProviderOptions`                                                                              | Provider-specific options.                                                                                                                |
+| `telemetry`       | `TelemetryOptions`                                                                             | Telemetry configuration, including per-call integrations, input/output recording, and a function ID.                                      |
+| `runtimeContext`  | `Record<string, unknown>`                                                                      | Context available to lifecycle callbacks and selectively included in telemetry with `telemetry.includeRuntimeContext`.                    |
+| `onStart`         | `(event: Experimental_DecideStartEvent) => void`                                               | Called when the decision operation begins.                                                                                                |
+| `onEnd`           | `(event: Experimental_DecideEndEvent) => void`                                                 | Called when the decision operation completes successfully.                                                                                |
+
+Set `reasoning: 'provider-default'` to use the underlying language model's default
+reasoning effort instead of the adapter's `'none'` default.
 
 See [Lifecycle Callbacks](/docs/ai-sdk-core/lifecycle-callbacks#experimental_decide)
 for the complete `onStart` and `onEnd` event fields.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.144",
+  "version": "7.0.146",
   "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,26 +42,27 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.117",
-    "@ai-sdk/provider": "4.0.30",
-    "@ai-sdk/provider-utils": "5.0.63"
+    "@ai-sdk/gateway": "4.0.119",
+    "@ai-sdk/provider": "4.0.31",
+    "@ai-sdk/provider-utils": "5.0.64"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.119",
-    "@ai-sdk/deepseek": "3.0.68",
-    "@ai-sdk/google": "4.0.100",
-    "@ai-sdk/groq": "4.0.64",
-    "@ai-sdk/huggingface": "2.0.72",
-    "@ai-sdk/moonshotai": "3.0.72",
-    "@ai-sdk/openai": "4.0.97",
+    "@ai-sdk/amazon-bedrock": "5.0.120",
+    "@ai-sdk/deepseek": "3.0.69",
+    "@ai-sdk/google": "4.0.101",
+    "@ai-sdk/groq": "4.0.66",
+    "@ai-sdk/huggingface": "2.0.74",
+    "@ai-sdk/moonshotai": "3.0.73",
+    "@ai-sdk/openai": "4.0.98",
     "@ai-sdk/test-server": "2.0.4",
-    "@ai-sdk/xai": "5.0.25",
+    "@ai-sdk/xai": "5.0.26",
     "@edge-runtime/vm": "^5.0.0",
     "@smithy/eventstream-codec": "^4.3.3",
     "@smithy/util-utf8": "^4.3.3",
     "@types/json-schema": "7.0.15",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",
+    "@vercel/ai-tsdown-config": "0.0.0",
     "esbuild": "^0.28.2",
     "tsdown": "^0.23.0",
     "tsx": "4.23.12",

package/src/decide/decide-events.ts

@@ -34,6 +34,12 @@ export type DecideStartEvent<RUNTIME_CONTEXT extends Context = Context> = {
   /** The questions to decide against the shared state. */
   readonly questions: Readonly<Record<string, DecisionQuestion>>;
 
+  /** Maximum output tokens requested for the decision. */
+  readonly maxOutputTokens?: number;
+
+  /** Reasoning effort requested for the decision. */
+  readonly reasoning?: DecisionModelV4CallOptions['reasoning'];
+
   /** Maximum number of retries for the decision model call. */
   readonly maxRetries: number;
 

package/src/decide/decide.ts

@@ -2,6 +2,7 @@ import {
   Experimental_DecisionRefusalError as DecisionRefusalError,
   Experimental_DecisionUnsupportedQuestionTypeError as DecisionUnsupportedQuestionTypeError,
   type Experimental_DecisionModelV4Question as DecisionQuestion,
+  type Experimental_DecisionModelV4CallOptions as DecisionCallOptions,
 } from '@ai-sdk/provider';
 import {
   createIdGenerator,
@@ -16,6 +17,7 @@ import type { TelemetryOptions } from '../telemetry/telemetry-options';
 import type { Callback } from '../util/callback';
 import { notify } from '../util/notify';
 import { prepareRetries } from '../util/prepare-retries';
+import { prepareLanguageModelCallOptions } from '../prompt/prepare-language-model-call-options';
 import { VERSION } from '../version';
 import type { DecideEndEvent, DecideStartEvent } from './decide-events';
 import type { DecisionModel, DecisionResult } from './decision-result';
@@ -38,6 +40,8 @@ export async function decide<
   model: modelArg,
   state,
   questions,
+  maxOutputTokens,
+  reasoning,
   maxRetries,
   abortSignal,
   headers,
@@ -52,6 +56,10 @@ export async function decide<
   model: DecisionModel;
   state: DecisionState;
   questions: QUESTIONS;
+  /** Maximum output tokens for supported models. Must be an integer >= 1. */
+  maxOutputTokens?: number;
+  /** Reasoning effort for supported models. Language-model adapters default to none. */
+  reasoning?: DecisionCallOptions['reasoning'];
   /** Maximum retries for transient provider failures. Defaults to 2. */
   maxRetries?: number;
   abortSignal?: AbortSignal;
@@ -72,6 +80,7 @@ export async function decide<
 }): Promise<DecisionResult<QUESTIONS>> {
   const model = resolveDecisionModel(modelArg);
 
+  prepareLanguageModelCallOptions({ maxOutputTokens });
   validateDecisionInput({ state, questions });
 
   for (const [questionId, question] of Object.entries(questions)) {
@@ -105,6 +114,8 @@ export async function decide<
     modelId: model.modelId,
     state,
     questions,
+    maxOutputTokens,
+    reasoning,
     maxRetries: resolvedMaxRetries,
     headers,
     providerOptions,
@@ -139,6 +150,8 @@ export async function decide<
           return await model.doDecide({
             state: preparedState,
             questions,
+            maxOutputTokens,
+            reasoning,
             abortSignal,
             headers: withUserAgentSuffix(headers ?? {}, `ai/${VERSION}`),
             providerOptions,

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

@@ -163,42 +163,101 @@ export function pruneMessages({
         return message;
       }
 
-      return {
-        ...message,
-        content: message.content.filter(part => {
-          // keep non-tool parts:
-          if (
-            part.type !== 'tool-call' &&
-            part.type !== 'tool-result' &&
-            part.type !== 'tool-approval-request' &&
-            part.type !== 'tool-approval-response'
-          ) {
-            return true;
+      const keepParts = message.content.map(part => {
+        // keep non-tool parts:
+        if (
+          part.type !== 'tool-call' &&
+          part.type !== 'tool-result' &&
+          part.type !== 'tool-approval-request' &&
+          part.type !== 'tool-approval-response'
+        ) {
+          return true;
+        }
+
+        // keep parts that are associated with a tool call or approval that needs to be kept:
+        if (
+          ((part.type === 'tool-call' || part.type === 'tool-result') &&
+            keptToolCallIds.has(part.toolCallId)) ||
+          ((part.type === 'tool-approval-request' ||
+            part.type === 'tool-approval-response') &&
+            keptApprovalIds.has(part.approvalId))
+        ) {
+          return true;
+        }
+
+        // keep parts that are not associated with a tool that should be removed:
+        const partToolName =
+          part.type === 'tool-call' || part.type === 'tool-result'
+            ? part.toolName
+            : approvalIdToToolName.get(part.approvalId);
+
+        return (
+          toolCall.tools != null &&
+          partToolName != null &&
+          !toolCall.tools.includes(partToolName)
+        );
+      });
+
+      // Consecutive reasoning parts can belong to the same provider item.
+      // Remove the whole group when its following content was pruned.
+      if (message.role === 'assistant') {
+        for (
+          let reasoningIndex = 0;
+          reasoningIndex < message.content.length;
+          reasoningIndex++
+        ) {
+          const part = message.content[reasoningIndex];
+          if (part.type !== 'reasoning' && part.type !== 'reasoning-file') {
+            continue;
+          }
+
+          let reasoningEndIndex = reasoningIndex + 1;
+          while (reasoningEndIndex < message.content.length) {
+            const nextPart = message.content[reasoningEndIndex];
+            if (
+              nextPart.type !== 'reasoning' &&
+              nextPart.type !== 'reasoning-file'
+            ) {
+              break;
+            }
+            reasoningEndIndex++;
           }
 
-          // keep parts that are associated with a tool call or approval that needs to be kept:
-          if (
-            ((part.type === 'tool-call' || part.type === 'tool-result') &&
-              keptToolCallIds.has(part.toolCallId)) ||
-            ((part.type === 'tool-approval-request' ||
-              part.type === 'tool-approval-response') &&
-              keptApprovalIds.has(part.approvalId))
-          ) {
-            return true;
+          let followingPartIndex = reasoningEndIndex;
+          let hasFollowingPart = false;
+          let hasKeptFollowingPart = false;
+
+          while (followingPartIndex < message.content.length) {
+            const followingPart = message.content[followingPartIndex];
+            if (
+              followingPart.type === 'reasoning' ||
+              followingPart.type === 'reasoning-file'
+            ) {
+              break;
+            }
+
+            hasFollowingPart = true;
+            hasKeptFollowingPart ||= keepParts[followingPartIndex];
+            followingPartIndex++;
           }
 
-          // keep parts that are not associated with a tool that should be removed:
-          const partToolName =
-            part.type === 'tool-call' || part.type === 'tool-result'
-              ? part.toolName
-              : approvalIdToToolName.get(part.approvalId);
-
-          return (
-            toolCall.tools != null &&
-            partToolName != null &&
-            !toolCall.tools.includes(partToolName)
-          );
-        }),
+          if (hasFollowingPart && !hasKeptFollowingPart) {
+            for (
+              let index = reasoningIndex;
+              index < reasoningEndIndex;
+              index++
+            ) {
+              keepParts[index] = false;
+            }
+          }
+
+          reasoningIndex = followingPartIndex - 1;
+        }
+      }
+
+      return {
+        ...message,
+        content: message.content.filter((_, index) => keepParts[index]),
       } as AssistantModelMessage | ToolModelMessage;
     });
   }

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

@@ -18,7 +18,7 @@ type BaseToolCall = {
  * with an `input` type inferred from that tool's input schema.
  */
 export type StaticToolCall<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: BaseToolCall & {
+  [NAME in keyof TOOLS]-?: BaseToolCall & {
     toolName: NAME & string;
     input: InferToolInput<TOOLS[NAME]>;
     dynamic?: false | undefined;

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

@@ -4,7 +4,7 @@ import type { ProviderMetadata } from '../types';
 import type { ValueOf } from '../util/value-of';
 
 export type StaticToolError<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: {
+  [NAME in keyof TOOLS]-?: {
     type: 'tool-error';
     toolCallId: string;
     toolName: NAME & string;

package/src/generate-text/tool-execution-events.ts

@@ -36,7 +36,7 @@ type BaseToolExecutionStartFields = {
  * validated `toolContext` type.
  */
 type StaticToolExecutionStartEvent<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: BaseToolExecutionStartFields & {
+  [NAME in keyof TOOLS]-?: BaseToolExecutionStartFields & {
     readonly toolCall: Extract<StaticToolCall<TOOLS>, { toolName: NAME }>;
     readonly toolContext: ToolContextFor<TOOLS[NAME]>;
   };
@@ -93,7 +93,7 @@ type BaseToolExecutionEndFields = {
  * corresponding validated `toolContext`, and the tool execution result.
  */
 type StaticToolExecutionEndEvent<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: BaseToolExecutionEndFields & {
+  [NAME in keyof TOOLS]-?: BaseToolExecutionEndFields & {
     readonly toolCall: Extract<StaticToolCall<TOOLS>, { toolName: NAME }>;
     readonly toolContext: ToolContextFor<TOOLS[NAME]>;
     readonly toolOutput: ToolOutput<TOOLS>;

package/src/generate-text/tool-output-denied.ts

@@ -5,7 +5,7 @@ import type { ToolSet } from '@ai-sdk/provider-utils';
  * Tool output when the tool execution has been denied (for static tools).
  */
 export type StaticToolOutputDenied<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: {
+  [NAME in keyof TOOLS]-?: {
     type: 'tool-output-denied';
     toolCallId: string;
     toolName: NAME & string;

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

@@ -8,7 +8,7 @@ import type { ProviderMetadata } from '../types';
 import type { ValueOf } from '../../src/util/value-of';
 
 export type StaticToolResult<TOOLS extends ToolSet> = ValueOf<{
-  [NAME in keyof TOOLS]: {
+  [NAME in keyof TOOLS]-?: {
     type: 'tool-result';
     toolCallId: string;
     toolName: NAME & string;