ai 7.0.156 → 7.0.158

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

@@ -115,6 +115,8 @@ Additionally, any self-hosted provider that supports the OpenAI specification ca
 The AI providers support different language models with various capabilities.
 Here are the capabilities of popular models:
 
+{/* OpenAI, Anthropic, and Google rows are generated from provider model catalogs by pnpm generate:model-capabilities-docs. */}
+
 | Provider                                           | Model                                       | Image Input | Object Generation | Tool Usage | Tool Streaming |
 | -------------------------------------------------- | ------------------------------------------- | ----------- | ----------------- | ---------- | -------------- |
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-4.7`                                  | <Check />   | <Check />         | <Check />  | <Check />      |
@@ -124,6 +126,8 @@ Here are the capabilities of popular models:
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3`                                    | <Cross />   | <Check />         | <Check />  | <Check />      |
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3-mini`                               | <Cross />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-6-astra`                               | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-6.1-sol`                               | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-6.1-terra`                             | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-6-luna`                                | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-6-sol`                                 | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.6`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
@@ -139,18 +143,26 @@ Here are the capabilities of popular models:
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.2-pro`                               | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.2-chat-latest`                       | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.2`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
-| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5`                                     | <Check />   | <Check />         | <Check />  | <Check />      |
-| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-mini`                                | <Check />   | <Check />         | <Check />  | <Check />      |
-| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-nano`                                | <Check />   | <Check />         | <Check />  | <Check />      |
-| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.1-chat-latest`                       | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.1-codex-mini`                        | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.1-codex`                             | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.1-chat-latest`                       | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.1`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-pro`                                 | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5`                                     | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-mini`                                | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-nano`                                | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-codex`                               | <Check />   | <Check />         | <Check />  | <Check />      |
-| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-chat-latest`                         | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5-chat-latest`                         | <Check />   | <Cross />         | <Cross />  | <Cross />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-4.1`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-4.1-mini`                              | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-4.1-nano`                              | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-4o`                                    | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-4o-mini`                               | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-5-5`                           | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-5`                             | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-sonnet-5-5`                         | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-sonnet-5`                           | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-haiku-5-5`                          | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-fable-5-1`                          | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-fable-5`                            | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-4-8`                           | <Check />   | <Check />         | <Check />  | <Check />      |
@@ -158,14 +170,29 @@ Here are the capabilities of popular models:
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-4-6`                           | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-sonnet-4-6`                         | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-4-5`                           | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-haiku-4-5`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-sonnet-4-5`                         | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-4-1`                           | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-opus-4-0`                           | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Anthropic](/providers/ai-sdk-providers/anthropic) | `claude-sonnet-4-0`                         | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-nano-banana-2.1`                    | <Check />   | <Cross />         | <Cross />  | <Cross />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-4-argon`                            | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Google](/providers/ai-sdk-providers/google)       | `gemini-3.8-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.7-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.6-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.5-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.5-flash-lite`                     | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Google](/providers/ai-sdk-providers/google)       | `gemini-3.1-pro-preview`                    | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.1-flash-image-preview`            | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3.1-flash-lite-preview`             | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Google](/providers/ai-sdk-providers/google)       | `gemini-3-pro-preview`                      | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3-pro-image-preview`                | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-3-flash-preview`                    | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Google](/providers/ai-sdk-providers/google)       | `gemini-2.5-pro`                            | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Google](/providers/ai-sdk-providers/google)       | `gemini-2.5-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-2.5-flash-lite`                     | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-2.5-flash-lite-preview-06-17`       | <Check />   | <Check />         | <Check />  | <Check />      |
+| [Google](/providers/ai-sdk-providers/google)       | `gemini-2.0-flash`                          | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `pixtral-large-latest`                      | <Check />   | <Check />         | <Check />  | <Check />      |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-large-latest`                      | <Cross />   | <Check />         | <Check />  | <Check />      |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-medium-latest`                     | <Cross />   | <Check />         | <Check />  | <Check />      |

package/docs/03-agents/01-overview.mdx

@@ -133,6 +133,12 @@ Agents are flexible and powerful, but non-deterministic. When you need reliable,
 
 [Explore workflow patterns](/docs/agents/workflows) to learn more about building structured, reliable systems.
 
+## Agent Frameworks
+
+The agent classes in this section are primitives you assemble inside your own application. When you want a production framework for durable, long-running agents — with channels, schedules, approvals, and testing included — [eve](https://eve.dev) is an open-source framework built on the AI SDK. It uses the same `tool()` shape and model settings, and runs agents durably on Vercel or self-hosted.
+
+Learn more in [eve](/docs/agents/eve).
+
 ## Next Steps
 
 - **[Building Agents](/docs/agents/building-agents)** - Guide to creating agents with the ToolLoopAgent
@@ -140,3 +146,4 @@ Agents are flexible and powerful, but non-deterministic. When you need reliable,
 - **[Workflow Patterns](/docs/agents/workflows)** - Structured patterns using core functions for complex workflows
 - **[Loop Control](/docs/agents/loop-control)** - Execution control with stopWhen and prepareStep
 - **[Chat Platforms](/docs/agents/chat-platforms)** - Run agents in Slack, Microsoft Teams, Discord, and more with Chat SDK
+- **[eve](/docs/agents/eve)** - Build production agents for durable, long-running work

package/docs/03-agents/10-eve.mdx

@@ -0,0 +1,96 @@
+---
+title: eve
+description: Build production AI agents with eve, an open-source agent framework for durable, long-running work that is built on the AI SDK.
+---
+
+# eve
+
+[eve](https://eve.dev) is an open-source agent framework for durable, long-running work. Build, govern, and evolve enterprise-grade agents that scale — with channels, durable runs, approvals, and testing built in.
+
+eve is built on the AI SDK:
+
+- `defineTool` uses the same shape as [`tool()`](/docs/ai-sdk-core/tools-and-tool-calling): a `description`, an `inputSchema` (Zod, any Standard Schema, or a JSON Schema object), and an `execute` function.
+- `defineAgent` accepts an [AI Gateway](https://vercel.com/ai-gateway) model ID such as `openai/gpt-6-luna-fast`, or any AI SDK `LanguageModel` from a [provider package](/providers).
+- Options like `reasoning` map to the AI SDK's model settings.
+- A [Chat SDK](/docs/agents/chat-platforms) channel connects any Chat SDK adapter to your agent.
+
+## Built for Production
+
+- **Channels** — Multiplayer and single-player chat across Slack, Teams, iMessage, WhatsApp, and the web. Channels are a framework primitive.
+- **Durable runs** — Checkpoints every step. Survives crashes, restarts, and days-long waits. Runs on crons, too.
+- **Agentic or deterministic** — Fully agentic loops, deterministic workflows, or both in one run. You choose per task.
+- **Human in the loop** — Pause for approval. Resume durably when it arrives.
+- **Any provider** — Swap models with a one-line edit. Provider fallback included. Route different models to different tasks.
+- **Per-user capabilities** — Skills, schedules, memory, and tools resolved per user at runtime.
+- **MCP, OpenAPI, and subagents** — Connect to services over MCP and OpenAPI, or delegate to focused subagents. Credentials stay in the runtime.
+- **Testing** — Test agent behavior before and after every change.
+
+## Quick Start
+
+Create a new agent project:
+
+```bash
+npx eve@latest init my-agent
+```
+
+This creates a `my-agent` directory, installs its dependencies, initializes Git, and starts the interactive terminal UI. To add an agent to an existing project, pass a path:
+
+```bash
+cd myapp
+npx eve@latest init .
+```
+
+<Note>
+  Like the `ai` package, `eve` bundles its full documentation, so coding agents
+  can read it locally from `node_modules/eve/docs`. See [Coding
+  Agents](/docs/getting-started/coding-agents) for the same workflow with the AI
+  SDK.
+</Note>
+
+## A Minimal Example
+
+An eve agent lives in an `agent/` directory. Replace the system prompt in `agent/instructions.md`:
+
+```md filename="agent/instructions.md"
+You are a concise weather demo assistant. Tell users that the weather data is mocked.
+```
+
+Add a tool at `agent/tools/get_weather.ts`. The filename is the tool name the model sees:
+
+```ts filename="agent/tools/get_weather.ts"
+import { defineTool } from 'eve/tools';
+import { z } from 'zod';
+
+export default defineTool({
+  description: 'Return mock weather data for a city.',
+  inputSchema: z.object({ city: z.string().min(1) }),
+  async execute({ city }) {
+    return { city, condition: 'Sunny', temperatureF: 72 };
+  },
+});
+```
+
+Choose the model in `agent/agent.ts`:
+
+```ts filename="agent/agent.ts"
+import { defineAgent } from 'eve';
+
+export default defineAgent({
+  model: 'openai/gpt-6-luna-fast',
+  reasoning: 'high',
+});
+```
+
+## When to Choose eve
+
+The AI SDK gives you the primitives; eve is the production framework around them.
+
+- Use eve when you want a complete production agent — durable, long-running work across channels, schedules, and approvals — without assembling those pieces yourself.
+- Use [`ToolLoopAgent`](/docs/agents/building-agents) when you are assembling your own model-and-tools loop inside an application.
+- Use [`WorkflowAgent`](/docs/agents/workflow-agent) from `@ai-sdk/workflow` when you need durable, resumable execution with explicit workflow steps.
+- Use [Chat SDK](/docs/agents/chat-platforms) when you are adding an agent to chat platforms.
+
+## Next Steps
+
+- [eve documentation](https://eve.dev/docs) — the full project layout and guides
+- [eve on GitHub](https://github.com/vercel/eve) — source code and discussions

package/docs/03-agents/index.mdx

@@ -74,5 +74,11 @@ The following section shows you how to build agents with the AI SDK - systems wh
         'Run agents in Slack, Microsoft Teams, Discord, and more with Chat SDK.',
       href: '/docs/agents/chat-platforms',
     },
+    {
+      title: 'eve',
+      description:
+        'Build production AI agents with eve, an open-source framework for durable, long-running work.',
+      href: '/docs/agents/eve',
+    },
   ]}
 />

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

@@ -160,7 +160,7 @@ The Stdio transport can be imported from either the MCP SDK or the AI SDK:
 import { createMCPClient } from '@ai-sdk/mcp';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 // Or use the AI SDK's stdio transport:
-// import { Experimental_StdioMCPTransport as StdioClientTransport } from '@ai-sdk/mcp/mcp-stdio';
+// import { StdioMCPTransport as StdioClientTransport } from '@ai-sdk/mcp/mcp-stdio';
 
 const mcpClient = await createMCPClient({
   transport: new StdioClientTransport({
@@ -666,16 +666,12 @@ client throws an `MCPClientError`.
 
 ## Using MCP Prompts
 
-<Note type="warning">
-  MCP Prompts is an experimental feature and may change in the future.
-</Note>
-
 According to the MCP specification, prompts are user-controlled templates that servers expose for clients to list and retrieve with optional arguments.
 
 ### Listing Prompts
 
 ```typescript
-const prompts = await mcpClient.experimental_listPrompts();
+const prompts = await mcpClient.listPrompts();
 ```
 
 ### Getting a Prompt
@@ -683,7 +679,7 @@ const prompts = await mcpClient.experimental_listPrompts();
 Retrieve prompt messages, optionally passing arguments defined by the server:
 
 ```typescript
-const prompt = await mcpClient.experimental_getPrompt({
+const prompt = await mcpClient.getPrompt({
   name: 'code_review',
   arguments: { code: 'function add(a, b) { return a + b; }' },
 });
@@ -742,6 +738,16 @@ mcpClient.onElicitationRequest(ElicitationRequestSchema, async request => {
 
 ### Elicitation Response Actions
 
+On MCP `2026-07-28` connections, the same handler processes form elicitation
+requests embedded in `input_required` results from tools, prompts, and resource
+reads. The client retries the original request with the handler's answers and
+the server's unchanged `requestState` until it receives a final result, with a
+limit of 10 retries. State-only retries are delayed by 250 ms. Each round respects
+`timeout`, including time spent awaiting the handler, while `maxTotalTimeout`
+bounds the entire exchange. Missing handlers and unsupported input requests
+reject the operation. Older connections continue to use `elicitation/create`
+server requests.
+
 Your handler must return an object with an `action` field that can be one of:
 
 - `'accept'`: User provided the requested information. Must include `content` with the data.

package/docs/03-ai-sdk-core/17-mcp-apps.mdx

@@ -153,18 +153,13 @@ In production, add any policy and user approval checks your app needs before for
 
 ## Render With React
 
-In your React chat UI, render normal message parts as usual and pass tool parts to `experimental_MCPAppRenderer`.
-
-<Note type="warning">
-  `experimental_MCPAppRenderer` is experimental and may change in a future
-  release.
-</Note>
+In your React chat UI, render normal message parts as usual and pass tool parts to `MCPAppRenderer`.
 
 ```tsx filename="app/page.tsx"
 'use client';
 
 import {
-  experimental_MCPAppRenderer as MCPAppRenderer,
+  MCPAppRenderer,
   useChat,
   type MCPAppBridgeHandlers,
   type MCPAppMetadata,
@@ -242,7 +237,7 @@ export default function Chat() {
 }
 ```
 
-For ordinary tools, `experimental_MCPAppRenderer` renders the provided `fallback` (or nothing when no fallback is provided). For app-backed tools, it loads the resource, creates the sandbox bridge, sends tool input and result notifications to the iframe, and forwards supported app requests through your handlers.
+For ordinary tools, `MCPAppRenderer` renders the provided `fallback` (or nothing when no fallback is provided). For app-backed tools, it loads the resource, creates the sandbox bridge, sends tool input and result notifications to the iframe, and forwards supported app requests through your handlers.
 
 ## Best Practices
 

package/docs/03-ai-sdk-core/26-reasoning.mdx

@@ -24,7 +24,7 @@ The `reasoning` parameter accepts the following values:
 | Value                | Behavior                                                             |
 | -------------------- | -------------------------------------------------------------------- |
 | `'provider-default'` | Use the provider's default reasoning behavior (default when omitted) |
-| `'none'`             | Disable reasoning                                                    |
+| `'none'`             | Disable reasoning (lowest reasoning level if it cannot be disabled)  |
 | `'minimal'`          | Bare-minimum reasoning                                               |
 | `'low'`              | Fast, concise reasoning                                              |
 | `'medium'`           | Balanced reasoning                                                   |
@@ -80,9 +80,15 @@ This design lets you use the portable `reasoning` parameter by default and fall
 
 The `reasoning` parameter is supported by providers including OpenAI, Anthropic, Google, xAI, Groq, DeepSeek, Moonshot AI, Fireworks, Amazon Bedrock, Mistral, Cohere, Alibaba, Open Responses, OpenAI Compatible, and Perplexity. Each provider translates the value to its native reasoning API.
 
-Providers with a distinct native maximum tier, such as supported OpenAI, Anthropic, DeepSeek, and Moonshot AI models, receive `'max'` directly. Amazon Bedrock preserves `'max'` for its Anthropic and OpenAI effort mappings, while Amazon Nova 2 maps `'xhigh'` and `'max'` to `'high'` with a compatibility warning. Providers whose highest native tier is lower coerce `'max'` to their closest supported tier and emit a compatibility warning when their adapter supports warning propagation. OpenAI-compatible and Open Responses endpoints receive `'max'` directly so compatible servers can interpret it.
+### How values are mapped
 
-Some providers use a numeric token budget instead of an enum for reasoning control. In those cases, `'max'` maps to 95% of the model's maximum output tokens by default, subject to the provider's minimum and maximum reasoning budget limits.
+When a model does not support the requested value, the provider uses the closest supported value, rounding down. The values are ordered `none` < `minimal` < `low` < `medium` < `high` < `xhigh` < `max`, so `'xhigh'` becomes `'high'` on a model without an `xhigh` level. If there is no lower value, the next higher one is used.
+
+Rounding never turns reasoning off: other values never map to `'none'`, and `'none'` on a model that cannot disable reasoning maps to the model's lowest level. Providers emit a `compatibility` warning whenever the value they send differs from the requested value. Values set in `providerOptions` are sent unchanged (see [Precedence Rules](#precedence-rules)).
+
+Providers only round values for models and model families they recognize by model ID, so newer versions of a known family use that family's levels. Unrecognized model IDs, such as fine-tuned or custom models, and OpenAI-compatible and Open Responses endpoints receive the value directly and the API decides whether it is supported.
+
+For providers that use a token budget, the value maps to a percentage of the model's maximum output tokens (`'max'` maps to 95% by default), within the provider's budget limits.
 
 Maximum reasoning can substantially increase token usage, latency, cost, and the chance of reaching request or output limits. Use it when the model's additional reasoning depth is worth those tradeoffs.
 

package/docs/03-ai-sdk-harnesses/03-tools.mdx

@@ -272,12 +272,42 @@ const agent = new HarnessAgent({
 `toolApproval` accepts the same status values as AI SDK tool approval status
 objects: `not-applicable`, `approved`, `user-approval`, and `denied`.
 
+When a host tool call is denied, the model and response messages receive an
+`execution-denied` tool result with the denial reason, if provided. The tool's
+`execute` and `toModelOutput` functions are not called for the denial.
+
 When approval is required, the stream pauses after a `tool-approval-request`.
 Continue the same session by sending a tool approval response message. In UI
 flows, `useChat` sends those messages for you when you add the approval result.
 In direct agent code, pass the approval response as `messages` on the next
 `stream()` or `generate()` call.
 
+### Native Tool Names
+
+Built-in tool calls use the harness tool name, such as `bash`, `write`, or
+`edit`, while their input follows the underlying runtime's schema. When an
+adapter supplies a different native name, `HarnessAgent` exposes it as
+`providerMetadata[harnessId].nativeToolName` on the streamed `tool-call` and
+on the `toolCall` inside a `tool-approval-request`.
+
+For example, a Claude Code approval request for `bash` includes
+`toolCall.providerMetadata['claude-code'].nativeToolName: 'Bash'`. An approval
+gate that works with Claude Code's native tool names can read it without
+changing the harness-facing `toolName` or interpreting the input shape:
+
+```ts
+for await (const part of result.fullStream) {
+  if (part.type === 'tool-approval-request') {
+    const nativeToolName =
+      part.toolCall.providerMetadata?.['claude-code']?.nativeToolName;
+    console.log(nativeToolName ?? part.toolCall.toolName, part.toolCall.input);
+  }
+}
+```
+
+The metadata field is omitted when the adapter does not supply a native name
+or when it matches `toolName`. Existing provider metadata is preserved.
+
 ## Built-in Approval Support
 
 Most adapters can pause built-in tool calls for approval. Adapters that do not

package/docs/06-advanced/10-vercel-deployment-guide.mdx

@@ -11,6 +11,13 @@ Vercel is a platform for developers that provides the tools, workflows, and infr
 
 Vercel allows for automatic deployments on every branch push and merges onto the production branch of your GitHub, GitLab, and Bitbucket projects. It is a great option for deploying your AI application.
 
+<Note>
+  Deploying a durable backend agent instead of an application with a UI?
+  [eve](https://eve.dev) is an open-source agent framework built on the AI SDK
+  for durable, long-running work — channels, schedules, and approvals included.
+  Learn more in the [eve guide](/docs/agents/eve).
+</Note>
+
 ## Before You Begin
 
 To follow along with this guide, you will need:

package/docs/07-reference/01-ai-sdk-core/23-create-mcp-client.mdx

@@ -562,13 +562,12 @@ Returns a Promise that resolves to an `MCPClient` with the following properties
       ],
     },
     {
-      name: 'experimental_listPrompts',
+      name: 'listPrompts',
       type: `async (options?: {
         params?: PaginatedRequest['params'];
         options?: RequestOptions;
       }) => Promise<ListPromptsResult>`,
-      description:
-        'Lists available prompts from the MCP server. This method is experimental and may change in the future.',
+      description: 'Lists available prompts from the MCP server.',
       properties: [
         {
           type: 'options',
@@ -591,14 +590,13 @@ Returns a Promise that resolves to an `MCPClient` with the following properties
       ],
     },
     {
-      name: 'experimental_getPrompt',
+      name: 'getPrompt',
       type: `async (args: {
         name: string;
         arguments?: Record<string, unknown>;
         options?: RequestOptions;
       }) => Promise<GetPromptResult>`,
-      description:
-        'Retrieves a prompt by name, optionally passing arguments. This method is experimental and may change in the future.',
+      description: 'Retrieves a prompt by name, optionally passing arguments.',
       properties: [
         {
           type: 'args',
@@ -667,13 +665,13 @@ Returns a Promise that resolves to an `MCPClient` with the following properties
 ```typescript
 import { createMCPClient } from '@ai-sdk/mcp';
 import { generateText } from 'ai';
-import { Experimental_StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';
+import { StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';
 
 let client;
 
 try {
   client = await createMCPClient({
-    transport: new Experimental_StdioMCPTransport({
+    transport: new StdioMCPTransport({
       command: 'node server.js',
     }),
   });

package/docs/07-reference/01-ai-sdk-core/24-mcp-stdio-transport.mdx

@@ -1,18 +1,18 @@
 ---
-title: Experimental_StdioMCPTransport
+title: StdioMCPTransport
 description: Create a transport for Model Context Protocol (MCP) clients to communicate with MCP servers using standard input and output streams
 ---
 
-# `Experimental_StdioMCPTransport`
+# `StdioMCPTransport`
 
 Creates a transport for Model Context Protocol (MCP) clients to communicate with MCP servers using standard input and output streams. This transport is only supported in Node.js environments.
 
-This feature is experimental and may change or be removed in the future.
+`Experimental_StdioMCPTransport` is a deprecated alias of `StdioMCPTransport`.
 
 ## Import
 
 <Snippet
-  text={`import { Experimental_StdioMCPTransport } from "@ai-sdk/mcp/mcp-stdio"`}
+  text={`import { StdioMCPTransport } from "@ai-sdk/mcp/mcp-stdio"`}
   prompt={false}
 />
 

package/docs/07-reference/01-ai-sdk-core/29-filter-active-tools.mdx

@@ -5,8 +5,6 @@ description: Filter a tool set to the currently active tools (API Reference)
 
 # `filterActiveTools()`
 
-<Note type="warning">`filterActiveTools` is an experimental feature.</Note>
-
 `filterActiveTools` filters a tool set to only the string tool names listed in `activeTools`.
 If `activeTools` is `undefined`, it returns the original tool set.
 If `tools` is `undefined`, it returns `undefined`.
@@ -14,7 +12,7 @@ If `tools` is `undefined`, it returns `undefined`.
 `filterActiveTools` is useful for limiting which tools are sent to a model in a particular step.
 
 ```ts
-import { experimental_filterActiveTools as filterActiveTools, tool } from 'ai';
+import { filterActiveTools, tool } from 'ai';
 import { z } from 'zod';
 
 const tools = {
@@ -38,10 +36,7 @@ const filteredTools = filterActiveTools({
 
 ## Import
 
-<Snippet
-  text={`import { experimental_filterActiveTools as filterActiveTools } from "ai"`}
-  prompt={false}
-/>
+<Snippet text={`import { filterActiveTools } from "ai"`} prompt={false} />
 
 ## API Signature
 

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

@@ -6,7 +6,7 @@ description: API Reference for the Experimental_SandboxSession interface.
 # `Experimental_SandboxSession`
 
 The `Experimental_SandboxSession` interface describes an execution environment that
-tools can use to run commands. Pass an experimental sandbox using the
+tools can use to run commands and access files. Pass an experimental sandbox using the
 `experimental_sandbox` option to `generateText`, `streamText`,
 `ToolLoopAgent.generate`, `ToolLoopAgent.stream`, or agent UI stream helpers to
 make it available to tool description functions and tool execution.
@@ -30,19 +30,91 @@ make it available to tool description functions and tool execution.
 ```ts
 type Experimental_SandboxSession = {
   readonly description: string;
+
   readonly run: (options: {
     command: string;
     workingDirectory?: string;
     env?: Record<string, string>;
     abortSignal?: AbortSignal;
-  }) => PromiseLike<{
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-  }>;
+  }) => PromiseLike<{ exitCode: number; stdout: string; stderr: string }>;
+  readonly spawn: (options: {
+    command: string;
+    workingDirectory?: string;
+    env?: Record<string, string>;
+    abortSignal?: AbortSignal;
+    stdin?: boolean;
+  }) => PromiseLike<Experimental_SandboxProcess>;
+
+  readonly readFile: (options: {
+    path: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<ReadableStream<Uint8Array> | null>;
+  readonly readBinaryFile: (options: {
+    path: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<Uint8Array | null>;
+  readonly readTextFile: (options: {
+    path: string;
+    encoding?: string;
+    startLine?: number;
+    endLine?: number;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<string | null>;
+
+  readonly writeFile: (options: {
+    path: string;
+    content: ReadableStream<Uint8Array>;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<void>;
+  readonly writeBinaryFile: (options: {
+    path: string;
+    content: Uint8Array;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<void>;
+  readonly writeTextFile: (options: {
+    path: string;
+    content: string;
+    encoding?: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<void>;
+
+  readonly stat: (options: {
+    path: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<Experimental_SandboxFileStat | null>;
+  readonly listDirectory: (options: {
+    path: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<Array<Experimental_SandboxDirectoryEntry> | null>;
+  readonly deleteFile: (options: {
+    path: string;
+    abortSignal?: AbortSignal;
+  }) => PromiseLike<boolean>;
+};
+
+type Experimental_SandboxFileStat = {
+  type: 'file' | 'directory' | 'other';
+  size: number;
+};
+
+type Experimental_SandboxDirectoryEntry = {
+  name: string;
+  type: 'file' | 'directory' | 'symlink' | 'other';
 };
 ```
 
+## Paths
+
+Relative paths in every method, including the `workingDirectory` option of `run`
+and `spawn`, resolve against the same base directory: the directory that `run`
+and `spawn` start in when no `workingDirectory` is given. The base directory does
+not change for the lifetime of the session. Changing the directory inside a
+command, for example with `cd`, only affects that command. Absolute paths are
+used as is.
+
+This lets tools combine methods. For example, a path that a `grep` command run
+with `run` prints can be passed to `readTextFile`.
+
 ## Properties
 
 <PropertiesTable
@@ -90,6 +162,42 @@ type Experimental_SandboxSession = {
         },
       ],
     },
+    {
+      name: 'spawn',
+      type: '(options: { command: string; workingDirectory?: string; env?: Record<string, string>; abortSignal?: AbortSignal; stdin?: boolean }) => PromiseLike<Experimental_SandboxProcess>',
+      description:
+        'Starts a long-running process and returns immediately with a handle that streams standard output and standard error, can be waited on, and can be killed. With `stdin: true`, standard input stays open and the handle also has a writable `stdin` stream; implementations that do not support this reject before starting the command.',
+    },
+    {
+      name: 'readFile / readBinaryFile / readTextFile',
+      type: '(options: { path: string; abortSignal?: AbortSignal }) => PromiseLike<ReadableStream<Uint8Array> | Uint8Array | string | null>',
+      description:
+        'Reads one file as a stream of bytes, raw bytes, or decoded text. Resolves to `null` when the file does not exist. `readTextFile` accepts an `encoding` (default `utf-8`) and 1-based inclusive `startLine` and `endLine`.',
+    },
+    {
+      name: 'writeFile / writeBinaryFile / writeTextFile',
+      type: '(options: { path: string; content: ReadableStream<Uint8Array> | Uint8Array | string; abortSignal?: AbortSignal }) => PromiseLike<void>',
+      description:
+        'Writes one file from a stream of bytes, raw bytes, or a string. Creates parent directories and overwrites an existing file. Rejects when the path is a directory.',
+    },
+    {
+      name: 'stat',
+      type: '(options: { path: string; abortSignal?: AbortSignal }) => PromiseLike<Experimental_SandboxFileStat | null>',
+      description:
+        'Returns the type (`file`, `directory`, or `other`) and size in bytes of a path. The size of a directory is implementation-defined. Symbolic links are followed. Resolves to `null` when the path does not exist.',
+    },
+    {
+      name: 'listDirectory',
+      type: '(options: { path: string; abortSignal?: AbortSignal }) => PromiseLike<Array<Experimental_SandboxDirectoryEntry> | null>',
+      description:
+        'Lists the entries of one directory, without descending into subdirectories. Each entry has a `name` and a `type` (`file`, `directory`, `symlink`, or `other`); symbolic links are not followed. The order is unspecified. Resolves to `null` when the directory does not exist and rejects when the path is not a directory.',
+    },
+    {
+      name: 'deleteFile',
+      type: '(options: { path: string; abortSignal?: AbortSignal }) => PromiseLike<boolean>',
+      description:
+        'Deletes one file. A symbolic link is deleted itself, not its target. Resolves to `true` when the file was deleted and `false` when it does not exist. Rejects when the path is a directory.',
+    },
   ]}
 />