ai 7.0.128 → 7.0.130

package/docs/02-foundations/06-provider-options.mdx

@@ -69,18 +69,19 @@ console.log(
 );
 ```
 
-| Value       | Behavior                                   |
-| ----------- | ------------------------------------------ |
-| `'none'`    | No reasoning (GPT-5.1 models only)         |
-| `'minimal'` | Bare-minimum reasoning                     |
-| `'low'`     | Fast, concise reasoning                    |
-| `'medium'`  | Balanced (default)                         |
-| `'high'`    | Thorough reasoning                         |
-| `'xhigh'`   | Maximum reasoning (GPT-5.1-Codex-Max only) |
+| Value       | Behavior                                 |
+| ----------- | ---------------------------------------- |
+| `'none'`    | No reasoning (GPT-5.1 models only)       |
+| `'minimal'` | Bare-minimum reasoning                   |
+| `'low'`     | Fast, concise reasoning                  |
+| `'medium'`  | Balanced (default)                       |
+| `'high'`    | Thorough reasoning                       |
+| `'xhigh'`   | Extra-high reasoning on supported models |
+| `'max'`     | Maximum reasoning on supported models    |
 
 <Note>
-  `'none'` and `'xhigh'` are only supported on specific models. Using them with
-  unsupported models will result in an error.
+  Supported effort levels vary by model. Using an effort with an unsupported
+  model will result in an error.
 </Note>
 
 ### Reasoning Summary

package/docs/03-agents/02-building-agents.mdx

@@ -85,7 +85,9 @@ results. If a tool needs server-side values such as credentials, scoped
 permissions, or default settings, pass them through `toolsContext` and declare
 them with the tool's `contextSchema`.
 
-```ts highlight="12-15,20-27,31-40"
+Set `runtimeContext` and `toolsContext` in the `ToolLoopAgent` constructor.
+
+```ts
 import { ToolLoopAgent, tool } from 'ai';
 import { z } from 'zod';
 
@@ -105,6 +107,16 @@ const agent = new ToolLoopAgent({
         searchTickets(query, context.accountId, context.apiKey),
     }),
   },
+  runtimeContext: {
+    requestId: 'req_abc',
+    escalated: false,
+  },
+  toolsContext: {
+    searchTickets: {
+      apiKey: process.env.SUPPORT_API_KEY!,
+      accountId: 'acct_123',
+    },
+  },
   prepareStep: async ({ runtimeContext }) => {
     if (runtimeContext.escalated) {
       return { temperature: 0.1 };
@@ -116,19 +128,12 @@ const agent = new ToolLoopAgent({
 
 const result = await agent.generate({
   prompt: 'Find open billing tickets for this account.',
-  runtimeContext: {
-    requestId: 'req_abc',
-    escalated: false,
-  },
-  toolsContext: {
-    searchTickets: {
-      apiKey: process.env.SUPPORT_API_KEY!,
-      accountId: 'acct_123',
-    },
-  },
 });
 ```
 
+For context that changes with each invocation, use `callOptionsSchema` and
+`prepareCall`. See [Configuring Call Options](/docs/agents/configuring-call-options).
+
 Model call settings returned from `prepareStep`, such as `temperature`, apply
 only to the current step. Later steps use the agent's top-level setting unless
 they return another override.

package/docs/03-agents/07-workflow-agent.mdx

@@ -36,10 +36,10 @@ For simpler use cases that don't need durability, use [`ToolLoopAgent`](/docs/ag
 ## Installation
 
 ```bash
-npm install @ai-sdk/workflow workflow@beta
+npm install @ai-sdk/workflow workflow@5
 ```
 
-`@ai-sdk/workflow` requires Workflow 5, which is currently available under the `beta` tag, as well as the `ai` package and `zod` peer dependencies. The `workflow` package provides the Workflow DevKit runtime (`getWritable`, `'use workflow'`, `'use step'`).
+`@ai-sdk/workflow` requires Workflow 5, as well as the `ai` package and `zod` peer dependencies. The `workflow` package provides the Workflow DevKit runtime (`getWritable`, `'use workflow'`, `'use step'`).
 
 ## Creating a WorkflowAgent
 
@@ -691,7 +691,7 @@ export type MyAgentUIMessage = InferWorkflowAgentUIMessage<typeof myAgent>;
 Install the new package alongside `workflow`:
 
 ```bash
-npm install @ai-sdk/workflow workflow@beta
+npm install @ai-sdk/workflow workflow@5
 ```
 
 ### Write `ModelCallStreamPart`, not `UIMessageChunk`

package/docs/03-ai-sdk-core/17-runtime-and-tool-context.mdx

@@ -16,14 +16,14 @@ should affect execution.
 
 ## Context Types
 
-| Concept                           | Where you define it                                                | Where you read it                                                                               | Use it for                                                    |
-| --------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
-| `runtimeContext`                  | `generateText`, `streamText`, or `ToolLoopAgent` calls             | `prepareStep`, lifecycle callbacks, step results, and telemetry                                 | Shared generation or agent state                              |
-| `toolsContext`                    | `generateText`, `streamText`, or `ToolLoopAgent` calls             | `prepareStep`, approval callbacks, tool context resolution, and tool description functions      | A map of per-tool context values keyed by tool name           |
-| tool `context`                    | Each tool's `toolsContext` entry, validated by its `contextSchema` | Tool description functions, tool `execute`, `needsApproval`, and tool input lifecycle callbacks | Values needed by one tool                                     |
-| `toolContext`                     | Derived from one tool's context                                    | Tool approval callbacks and tool execution events                                               | The event/callback name for one tool's context                |
-| `telemetry.includeRuntimeContext` | The generation or agent call                                       | Telemetry filtering                                                                             | Top-level `runtimeContext` properties to include in telemetry |
-| `telemetry.includeToolsContext`   | The generation or agent call                                       | Telemetry filtering                                                                             | Top-level tool context properties to include in telemetry     |
+| Concept                           | Where you define it                                                             | Where you read it                                                                               | Use it for                                                    |
+| --------------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `runtimeContext`                  | `generateText` or `streamText` calls; `ToolLoopAgent` settings or `prepareCall` | `prepareStep`, lifecycle callbacks, step results, and telemetry                                 | Shared generation or agent state                              |
+| `toolsContext`                    | `generateText` or `streamText` calls; `ToolLoopAgent` settings or `prepareCall` | `prepareStep`, approval callbacks, tool context resolution, and tool description functions      | A map of per-tool context values keyed by tool name           |
+| tool `context`                    | Each tool's `toolsContext` entry, validated by its `contextSchema`              | Tool description functions, tool `execute`, `needsApproval`, and tool input lifecycle callbacks | Values needed by one tool                                     |
+| `toolContext`                     | Derived from one tool's context                                                 | Tool approval callbacks and tool execution events                                               | The event/callback name for one tool's context                |
+| `telemetry.includeRuntimeContext` | The generation call or `ToolLoopAgent` settings                                 | Telemetry filtering                                                                             | Top-level `runtimeContext` properties to include in telemetry |
+| `telemetry.includeToolsContext`   | The generation call or `ToolLoopAgent` settings                                 | Telemetry filtering                                                                             | Top-level tool context properties to include in telemetry     |
 
 In agents, `runtimeContext` is the agent's shared runtime state. It flows
 through the loop and can be read or updated in `prepareStep` between model
@@ -31,7 +31,7 @@ calls. Tool-specific data stays in `toolsContext`, where each tool receives only
 its own validated `context`.
 
 ```txt
-generateText / streamText / ToolLoopAgent
+generateText / streamText / ToolLoopAgent settings
   -> runtimeContext
        -> prepareStep, lifecycle callbacks, step results
        -> telemetry, filtered by telemetry.includeRuntimeContext
@@ -123,6 +123,10 @@ Treat tool context as immutable inside tools. If you need to change tool context
 between steps, inspect the previous step in `prepareStep` and return an updated
 `toolsContext`.
 
+For `ToolLoopAgent`, set context in the constructor. For context that changes
+with each invocation, use `callOptionsSchema` and `prepareCall`. See
+[Configuring Call Options](/docs/agents/configuring-call-options).
+
 ## Telemetry Context Filtering
 
 Context often contains values that are useful inside your application but should
@@ -131,7 +135,7 @@ include selected top-level runtime context properties in telemetry, and
 `telemetry.includeToolsContext` to include selected top-level tool context
 properties per tool.
 
-```ts highlight="34-43"
+```ts
 import { ToolLoopAgent, tool } from 'ai';
 import { z } from 'zod';
 
@@ -156,10 +160,6 @@ const customerLookup = tool({
 const agent = new ToolLoopAgent({
   model: __MODEL__,
   tools: { customerLookup },
-});
-
-const result = await agent.generate({
-  prompt: 'Check whether customer cust_123 is eligible for priority support.',
   runtimeContext: {
     requestId: 'req_abc',
     tenantId: 'tenant_123',
@@ -182,6 +182,10 @@ const result = await agent.generate({
     },
   },
 });
+
+const result = await agent.generate({
+  prompt: 'Check whether customer cust_123 is eligible for priority support.',
+});
 ```
 
 In this example, telemetry receives `runtimeContext` with only `requestId` and the

package/docs/03-ai-sdk-core/25-settings.mdx

@@ -101,9 +101,10 @@ Controls how much reasoning the model performs before generating a response.
 | `'low'`              | Fast, concise reasoning                                              |
 | `'medium'`           | Balanced reasoning                                                   |
 | `'high'`             | Thorough reasoning                                                   |
-| `'xhigh'`            | Maximum reasoning                                                    |
+| `'xhigh'`            | Extra-high reasoning                                                 |
+| `'max'`              | Maximum reasoning                                                    |
 
-If you also set reasoning-related options in `providerOptions` (e.g. `openai.reasoningEffort` or `anthropic.thinking`), the provider-specific options take precedence and the top-level `reasoning` parameter is ignored.
+Provider-specific settings take precedence over the corresponding fields derived from `reasoning`. Partial configurations can still use portable reasoning to fill missing fields; summary and display options can be used alongside it. For example, Bedrock preserves an explicit thinking budget while deriving a missing enabled type from portable reasoning.
 
 See the [reasoning guide](/docs/ai-sdk-core/reasoning) for details on per-provider mapping and migration from `providerOptions`.
 

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

@@ -29,7 +29,8 @@ The `reasoning` parameter accepts the following values:
 | `'low'`              | Fast, concise reasoning                                              |
 | `'medium'`           | Balanced reasoning                                                   |
 | `'high'`             | Thorough reasoning                                                   |
-| `'xhigh'`            | Maximum reasoning                                                    |
+| `'xhigh'`            | Extra-high reasoning                                                 |
+| `'max'`              | Maximum reasoning                                                    |
 
 ## Streaming
 
@@ -55,7 +56,7 @@ for await (const part of result.stream) {
 
 ## Precedence Rules
 
-The top-level `reasoning` parameter and provider-specific `providerOptions` are **never merged**. If you set reasoning-related options in `providerOptions`, they take full precedence and the top-level `reasoning` parameter is ignored.
+Provider-specific settings take precedence over the corresponding fields derived from `reasoning`. Partial configurations may still use portable reasoning to fill missing fields; summary and display settings can be used alongside it.
 
 ```ts
 import { generateText } from 'ai';
@@ -77,9 +78,15 @@ This design lets you use the portable `reasoning` parameter by default and fall
 
 ## Provider Support
 
-The `reasoning` parameter is supported by the following providers: OpenAI, Anthropic, Google, xAI, Groq, DeepSeek, Fireworks, Amazon Bedrock, and Perplexity. Each provider translates the value to its native reasoning API. Some providers support all six levels natively, while others coerce to fewer levels (a warning is emitted when coercion occurs). Some providers use a numeric token budget instead of an enum for reasoning control; in those cases the top-level `reasoning` value is mapped to a budget calculated as a percentage of the model's maximum output tokens.
+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 that do not support reasoning (e.g. Mistral and Cohere) emit an `unsupported` warning and ignore the parameter.
+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.
+
+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.
+
+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.
+
+Providers and models that do not support reasoning configuration emit an `unsupported` warning and ignore the parameter.
 
 ## Migrating from `providerOptions`
 
@@ -188,4 +195,4 @@ const { text } = await generateText({
 });
 ```
 
-Note that `providerOptions` can still be used alongside `reasoning` for provider-specific features unrelated to reasoning effort. However, if `providerOptions` includes reasoning effort/budget settings (e.g. `reasoningEffort`, `thinking`, `thinkingConfig.thinkingBudget`), those take full precedence and the top-level `reasoning` parameter is ignored.
+You can combine `providerOptions` with `reasoning` for provider-specific features such as reasoning summaries or display settings. Explicit effort or budget values override the corresponding mapped fields; partial configurations may still use portable reasoning to fill missing fields. See [Precedence Rules](#precedence-rules) for details.

package/docs/03-ai-sdk-core/32-decisions.mdx

@@ -51,29 +51,26 @@ Use a provider's `decisionModel` factory:
 | Provider    | Example model                                          |
 | ----------- | ------------------------------------------------------ |
 | TypeSafe AI | `typeSafeAi.decisionModel('jev-latest')`               |
-| OpenAI      | `openai.decisionModel('gpt-5.6-luna')`                 |
+| OpenAI      | `openai.decisionModel('gpt-6-luna')`                   |
 | Anthropic   | `anthropic.decisionModel('claude-haiku-4-5-20251001')` |
 | Google      | `google.decisionModel('gemini-3.5-flash-lite')`        |
 
-TypeSafe AI's [Jev](https://vercel.com/i/what-is-jev) supplies native Choice, Score, and Boolean decisions. OpenAI,
-Anthropic, and Google adapt structured language-model output for all three types.
-Boolean answers contain prompted estimates of P(true), validated to be finite
-and in `[0, 1]`. These estimates are not guaranteed to be calibrated. Choice and
-Score answers do not include probability distributions. Select a model that
-supports the provider's structured-output API; judge quality against your own
-labeled examples before choosing a model for a task.
-
-The language-model adapters decide all answers in one prompt. They do not
-provide TypeSafe's native independent-question execution semantics. The example
-model IDs demonstrate API compatibility; they are not benchmark-selected defaults.
-
-Language-model adapters request `reasoning: 'none'` by default. Each provider
-maps this setting to its model's reasoning controls; it does not guarantee that
-every model runs without thinking. To enable reasoning for more demanding
-decisions, pass the model's supported reasoning settings through
-`providerOptions`, which take precedence over this default. For example, use
-`providerOptions: { openai: { reasoningEffort: 'high' } }` with an OpenAI model
-that supports that effort.
+TypeSafe AI's [Jev](https://vercel.com/i/what-is-jev) and OpenAI's
+[Decisions API](https://developers.openai.com/api/docs/guides/decisions)
+supply native Choice, Score, and Boolean decisions. Each question is evaluated
+independently. Choice and Score answers include native probability distributions.
+
+Anthropic and Google adapt structured language-model output for all three types,
+evaluating all questions in one prompt. Their Boolean answers contain prompted
+estimates of P(true), and Choice and Score answers omit probability distributions.
+Select a model that supports the provider's structured-output API and judge quality
+against your own labeled examples before choosing a model for a task.
+
+The Anthropic and Google language-model adapters request `reasoning: 'none'` by
+default. Each provider maps this setting to its model's reasoning controls. Pass
+supported reasoning settings through `providerOptions` to override this default.
+OpenAI decision models use the Decisions endpoint and do not accept Responses
+API reasoning options.
 
 ## Model aliases and registries
 
@@ -251,6 +248,9 @@ substitute models automatically.
 
 Invalid inputs throw `InvalidArgumentError`. Missing answers, mismatched answer
 types, invalid options, scores, or probabilities throw `InvalidResponseDataError`.
+If the model refuses any question, the call throws
+`Experimental_DecisionRefusalError` with the refused question IDs, and is not
+retried.
 Transient provider failures use the normal retry policy (`maxRetries: 2` by
 default). Use `abortSignal` to cancel the decisions request, `headers` for request headers,
 and `providerOptions` for provider-specific settings.

package/docs/03-ai-sdk-core/35-image-generation.mdx

@@ -378,9 +378,11 @@ for (const file of result.files) {
 | [Google](/providers/ai-sdk-providers/google#image-models)                       | `gemini-2.5-flash-image`                                     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
 | [Google](/providers/ai-sdk-providers/google#image-models)                       | `gemini-3-pro-image-preview`                                 | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
 | [Google](/providers/ai-sdk-providers/google#image-models)                       | `gemini-3.1-flash-image-preview`                             | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
+| [Google](/providers/ai-sdk-providers/google#image-models)                       | `gemini-nano-banana-2.1`                                     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:8, 8:1, 1:4, 4:1                                                                                             |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex#image-models)         | `gemini-2.5-flash-image`                                     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex#image-models)         | `gemini-3-pro-image-preview`                                 | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex#image-models)         | `gemini-3.1-flash-image-preview`                             | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                                                                                                                 |
+| [Google Vertex](/providers/ai-sdk-providers/google-vertex#image-models)         | `gemini-nano-banana-2.1`                                     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:8, 8:1, 1:4, 4:1                                                                                             |
 | [Fireworks](/providers/ai-sdk-providers/fireworks#image-models)                 | `accounts/fireworks/models/flux-1-dev-fp8`                   | 1:1, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 9:21, 21:9                                                                                                                     |
 | [Fireworks](/providers/ai-sdk-providers/fireworks#image-models)                 | `accounts/fireworks/models/flux-1-schnell-fp8`               | 1:1, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 9:21, 21:9                                                                                                                     |
 | [Fireworks](/providers/ai-sdk-providers/fireworks#image-models)                 | `accounts/fireworks/models/playground-v2-5-1024px-aesthetic` | 640x1536, 768x1344, 832x1216, 896x1152, 1024x1024, 1152x896, 1216x832, 1344x768, 1536x640                                                                           |

package/docs/04-ai-sdk-ui/21-error-handling.mdx

@@ -12,15 +12,17 @@ These warnings help you fix problems before they cause errors.
 
 ### When Warnings Appear
 
-Warnings are shown in the browser console when:
+Warnings use Node.js `process.emitWarning` when available and `console.warn` in
+browser/edge runtimes. They appear when:
 
 - **Unsupported features**: You use a feature or setting that is not supported by the AI model (e.g., certain options or parameters).
 - **Compatibility warnings**: A feature is used in a compatibility mode, which might work differently or less optimally than intended.
+- **Deprecations**: You use a deprecated API, option, or message format.
 - **Other warnings**: The AI model reports another type of issue, such as general problems or advisory messages.
 
 ### Warning Messages
 
-All warnings start with "AI SDK Warning:" so you can easily find them. For example:
+All warnings include "AI SDK Warning" so you can easily find them. For example:
 
 ```
 AI SDK Warning: The feature "temperature" is not supported by this model
@@ -41,7 +43,8 @@ globalThis.AI_SDK_LOG_WARNINGS = false;
 #### Custom Warning Handler
 
 You can also provide your own function to handle warnings.
-It receives provider id, model id, and a list of warnings.
+It receives a list of warnings and optional provider and model ids. Custom
+handlers receive every warning, including repeated deprecations.
 
 ```ts
 globalThis.AI_SDK_LOG_WARNINGS = ({ warnings, provider, model }) => {
@@ -49,6 +52,28 @@ globalThis.AI_SDK_LOG_WARNINGS = ({ warnings, provider, model }) => {
 };
 ```
 
+### Deprecation Warnings
+
+The default logger emits each deprecation code once per loaded SDK instance.
+In Node.js, these warnings have the type `DeprecationWarning` and a stable
+`AISDK_DEP_*` code, available as `warning.code` on `process.on('warning', handler)`.
+Browser/edge console messages include the code in brackets.
+
+| Code                                     | Deprecated usage / replacement                                             |
+| ---------------------------------------- | -------------------------------------------------------------------------- |
+| `AISDK_DEP_GENERATE_OBJECT`              | Use `generateText` with `output` instead of `generateObject`.              |
+| `AISDK_DEP_STREAM_OBJECT`                | Use `streamText` with `output` instead of `streamObject`.                  |
+| `AISDK_DEP_EXPERIMENTAL_GENERATE_SPEECH` | Use `generateSpeech` instead of `experimental_generateSpeech`.             |
+| `AISDK_DEP_EXPERIMENTAL_TRANSCRIBE`      | Use `transcribe` instead of `experimental_transcribe`.                     |
+| `AISDK_DEP_TOOL_RESULT_*`                | Use `file` with tagged `data` instead of legacy tool-result content types. |
+| `AISDK_DEP_UI_MESSAGE_RAW_INPUT`         | Use `input` instead of `rawInput` in UI tool parts.                        |
+| `AISDK_DEP_IMAGE_CONTENT_PART`           | Use `file` with an image `mediaType` instead of `image` message parts.     |
+
+Run Node.js with `--throw-deprecation` to fail on deprecated usage,
+`--no-deprecation` to suppress deprecations, or `--trace-deprecation` for stack
+traces. These flags affect all `DeprecationWarning`s, rather than individual
+codes, and apply only to the default Node.js logger.
+
 ## Error Handling
 
 ### Error Helper Object

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

@@ -455,10 +455,10 @@ To see `generateText` in action, check out [these examples](#examples).
     },
     {
       name: 'reasoning',
-      type: "'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'",
+      type: "'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'",
       isOptional: true,
       description:
-        "Controls how much reasoning the model performs before generating a response. When omitted, the provider's default behavior is used. `'provider-default'` explicitly requests the provider's default. Providers that do not support reasoning will emit a warning. If reasoning-related `providerOptions` are also set, they take precedence and this parameter is ignored. See the [reasoning guide](/docs/ai-sdk-core/reasoning) for provider-specific mapping details.",
+        "Controls how much reasoning the model performs before generating a response. When omitted, the provider's default behavior is used. `'provider-default'` explicitly requests the provider's default. Providers that do not support reasoning will emit a warning. Provider-specific settings take precedence over corresponding mapped fields. Partial configurations may still use portable reasoning to fill missing fields; summary and display settings can be combined with it. See the [reasoning guide](/docs/ai-sdk-core/reasoning) for provider-specific mapping details.",
     },
     {
       name: 'maxRetries',

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

@@ -456,10 +456,10 @@ To see `streamText` in action, check out [these examples](#examples).
     },
     {
       name: 'reasoning',
-      type: "'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'",
+      type: "'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'",
       isOptional: true,
       description:
-        "Controls how much reasoning the model performs before generating a response. When omitted, the provider's default behavior is used. `'provider-default'` explicitly requests the provider's default. Providers that do not support reasoning will emit a warning. If reasoning-related `providerOptions` are also set, they take precedence and this parameter is ignored. See the [reasoning guide](/docs/ai-sdk-core/reasoning) for provider-specific mapping details.",
+        "Controls how much reasoning the model performs before generating a response. When omitted, the provider's default behavior is used. `'provider-default'` explicitly requests the provider's default. Providers that do not support reasoning will emit a warning. Provider-specific settings take precedence over corresponding mapped fields. Partial configurations may still use portable reasoning to fill missing fields; summary and display settings can be combined with it. See the [reasoning guide](/docs/ai-sdk-core/reasoning) for provider-specific mapping details.",
     },
     {
       name: 'maxRetries',
@@ -480,7 +480,7 @@ To see `streamText` in action, check out [these examples](#examples).
       type: 'AbortSignal',
       isOptional: true,
       description:
-        'An optional abort signal that can be used to cancel the call.',
+        'An optional abort signal that can be used to cancel the call. When it fires during streaming, pending result promises such as text and steps reject with the abort reason without waiting for onAbort or provider cancellation. Completed steps are available through onAbort.',
     },
     {
       name: 'timeout',

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

@@ -57,7 +57,8 @@ The public core types are `Experimental_DecisionModel`,
 
 Unsupported types throw `Experimental_DecisionUnsupportedQuestionTypeError`
 before provider I/O. Invalid inputs throw `InvalidArgumentError`; malformed
-answers throw `InvalidResponseDataError`. Invalid answers are not retried.
+answers throw `InvalidResponseDataError`. Questions the model refuses throw
+`Experimental_DecisionRefusalError`. Invalid answers and refusals are not retried.
 Neither partial results nor missing probability synthesis are supported.
 
 ## Model resolution

package/docs/07-reference/05-ai-sdk-errors/ai-decision-refusal-error.mdx

@@ -0,0 +1,33 @@
+---
+title: AI_DecisionRefusalError
+description: Identify decision questions that a model declined to answer.
+---
+
+# AI_DecisionRefusalError
+
+This experimental error identifies questions that a decision model declined to
+answer, such as a question the provider's safety policy refuses. It is exported
+from `ai` and `@ai-sdk/provider` as `Experimental_DecisionRefusalError`.
+
+Decision models report a refusal as an answer with `type: 'refusal'`.
+`experimental_decide` throws this error when any answer is a refusal, after the
+provider call and without retrying it.
+
+## Properties
+
+- `questionIds`: The IDs of the refused questions.
+- `provider`: The provider of the decision model.
+- `modelId`: The decision model ID.
+- `message`: A description of the refused questions and model.
+
+## Checking for this Error
+
+Use the marker-based `isInstance` check, which works across package copies:
+
+```typescript
+import { Experimental_DecisionRefusalError as DecisionRefusalError } from 'ai';
+
+if (DecisionRefusalError.isInstance(error)) {
+  console.log(error.questionIds, error.modelId);
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.128",
+  "version": "7.0.130",
   "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,30 +42,30 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.104",
-    "@ai-sdk/provider": "4.0.22",
-    "@ai-sdk/provider-utils": "5.0.54"
+    "@ai-sdk/gateway": "4.0.106",
+    "@ai-sdk/provider": "4.0.24",
+    "@ai-sdk/provider-utils": "5.0.56"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.106",
-    "@ai-sdk/deepseek": "3.0.59",
-    "@ai-sdk/google": "4.0.88",
-    "@ai-sdk/groq": "4.0.55",
-    "@ai-sdk/huggingface": "2.0.63",
-    "@ai-sdk/moonshotai": "3.0.63",
-    "@ai-sdk/openai": "4.0.84",
-    "@ai-sdk/test-server": "2.0.3",
-    "@ai-sdk/xai": "5.0.15",
+    "@ai-sdk/amazon-bedrock": "5.0.108",
+    "@ai-sdk/deepseek": "3.0.61",
+    "@ai-sdk/google": "4.0.90",
+    "@ai-sdk/groq": "4.0.57",
+    "@ai-sdk/huggingface": "2.0.65",
+    "@ai-sdk/moonshotai": "3.0.65",
+    "@ai-sdk/openai": "4.0.86",
+    "@ai-sdk/test-server": "2.0.4",
+    "@ai-sdk/xai": "5.0.17",
     "@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",
-    "esbuild": "^0.28.1",
+    "esbuild": "^0.28.2",
     "tsdown": "^0.23.0",
     "tsx": "4.23.12",
-    "typescript": "5.8.3",
+    "typescript": "6.0.3",
     "zod": "3.25.76"
   },
   "peerDependencies": {

package/src/decide/decide.ts

@@ -1,4 +1,5 @@
 import {
+  Experimental_DecisionRefusalError as DecisionRefusalError,
   Experimental_DecisionUnsupportedQuestionTypeError as DecisionUnsupportedQuestionTypeError,
   type Experimental_DecisionModelV4CallOptions as DecisionModelV4CallOptions,
 } from '@ai-sdk/provider';
@@ -152,6 +153,16 @@ export async function decide<
           answers: result.answers,
           rounding: result.rounding,
         });
+        const refusedQuestionIds = Object.keys(questions).filter(
+          id => result.answers[id]?.type === 'refusal',
+        );
+        if (refusedQuestionIds.length > 0) {
+          throw new DecisionRefusalError({
+            questionIds: refusedQuestionIds,
+            provider: model.provider,
+            modelId: model.modelId,
+          });
+        }
         await notify({
           event: { ...modelCallEvent, ...result },
           callbacks: [telemetryDispatcher.experimental_onDecisionModelCallEnd],

package/src/decide/validate-decision.ts

@@ -203,6 +203,7 @@ export function validateDecisionAnswers({
 
   for (const [id, question] of Object.entries(questions)) {
     const answer = answers[id];
+    if (isRecord(answer) && answer.type === 'refusal') continue;
     if (!isRecord(answer) || answer.type !== question.type) {
       invalidAnswer(
         answers,

package/src/error/index.ts

@@ -4,6 +4,7 @@ export {
   AISDKError,
   APICallError,
   EmptyResponseBodyError,
+  Experimental_DecisionRefusalError,
   Experimental_DecisionUnsupportedQuestionTypeError,
   InvalidPromptError,
   InvalidResponseDataError,

package/src/generate-object/generate-object.ts

@@ -263,6 +263,16 @@ export async function generateObject<
       };
     },
 ): Promise<GenerateObjectResult<RESULT>> {
+  logWarnings({
+    warnings: [
+      {
+        type: 'deprecated',
+        setting: 'generateObject',
+        message: 'Use generateText with an output setting instead.',
+      },
+    ],
+  });
+
   const {
     model: modelArg,
     output = 'object',

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

@@ -353,6 +353,16 @@ export function streamObject<
       : never
     : never
 > {
+  logWarnings({
+    warnings: [
+      {
+        type: 'deprecated',
+        setting: 'streamObject',
+        message: 'Use streamText with an output setting instead.',
+      },
+    ],
+  });
+
   const {
     model,
     output = 'object',

package/src/generate-speech/index.ts

@@ -1,5 +1,6 @@
 import type { SpeechResult } from './generate-speech-result';
 import { generateSpeech } from './generate-speech';
+import { logWarnings } from '../logger/log-warnings';
 
 export { generateSpeech } from './generate-speech';
 export type { SpeechResult } from './generate-speech-result';
@@ -14,7 +15,18 @@ export type {
 /**
  * @deprecated Use `generateSpeech` instead.
  */
-const experimental_generateSpeech = generateSpeech;
+const experimental_generateSpeech: typeof generateSpeech = options => {
+  logWarnings({
+    warnings: [
+      {
+        type: 'deprecated',
+        setting: 'experimental_generateSpeech',
+        message: 'Use generateSpeech instead.',
+      },
+    ],
+  });
+  return generateSpeech(options);
+};
 export { experimental_generateSpeech };
 
 /**