feat(provider/openai,provider/gateway): add gpt-5.6 model id (#17021)

## Background

OpenAI released GPT-5.6.

## Summary

Add the `gpt-5.6` model ID:

- `@ai-sdk/openai`: added `gpt-5.6` and the `gpt-5.6-sol`,
`gpt-5.6-terra`, `gpt-5.6-luna` snapshot IDs to the chat and responses
model ID types, the responses reasoning model IDs, and the language
model capabilities (GPT-5.6 supports temperature/topP/logProbs when
`reasoningEffort` is `none`, like GPT-5.1+).
- `@ai-sdk/gateway`: added `openai/gpt-5.6` to the gateway model IDs.
- Docs: added `gpt-5.6` to the model capability tables (foundations,
OpenAI provider page, providers index).
- Examples: updated examples that used a prior flagship GPT model
(`gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.4`, `gpt-5.5`) as a generic
default to use `gpt-5.6`. Examples that are deliberately model-specific
(codex/mini/nano/pro/chat-latest/dated variants, Azure deployment names,
files named after a model) were left unchanged. Added `gpt-5.6` to the
e2e chat model list. Restored `generate-text/openai/basic.ts` to its
pre-debugging state (keeping `gpt-5.6`) and added `reasoning-max.ts`
examples (generate-text + stream-text) demonstrating `reasoningEffort:
'max'`.

## Manual Verification

Ran the new
`examples/ai-functions/src/generate-text/openai/reasoning-max.ts` and
`examples/ai-functions/src/stream-text/openai/reasoning-max.ts` against
the live OpenAI API: `reasoningEffort: 'max'` is accepted and returns
reasoning summaries.

Ran the updated
`examples/ai-functions/src/stream-text/openai/reasoning.ts` against the
live OpenAI API with `gpt-5.6`: streaming works, including reasoning
summary deltas and reasoning provider metadata (the API resolves the ID
to the `gpt-5.6-sol` snapshot).

Note: `openai/gpt-5.6` is not yet served by the AI Gateway
(`model_not_found` as of this PR); the gateway model ID addition is
launch preparation.

## Checklist

- [ ] All commits are signed (PRs with unsigned commits cannot be
merged)
- [x] Tests have been added / updated (for bug fixes / features)
- [x] Documentation has been added / updated (for bug fixes / features)
- [x] A _patch_ changeset for relevant packages has been added (for bug
fixes / features - run `pnpm changeset` in the project root)
- [x] I have reviewed this pull request (self-review)

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: gr2m

.changeset/spicy-pandas-repeat.md

@@ -0,0 +1,6 @@
+---
+'@ai-sdk/openai': patch
+'@ai-sdk/gateway': patch
+---
+
+feat(provider/openai,provider/gateway): add gpt-5.6 model ids

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

@@ -116,6 +116,10 @@ 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 />      |
 | [Vercel](/providers/ai-sdk-providers/vercel)       | `v0-1.0-md`                                 | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.6`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.6-luna`                              | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.6-sol`                               | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.6-terra`                             | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.5`                                   | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.4-pro`                               | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.4`                                   | <Check />   | <Check />         | <Check />  | <Check />      |

content/providers/01-ai-sdk-providers/03-openai.mdx

@@ -2349,6 +2349,10 @@ The following optional provider options are available for OpenAI completion mode
 
 | Model                 | Image Input | Audio Input | Object Generation | Tool Usage |
 | --------------------- | ----------- | ----------- | ----------------- | ---------- |
+| `gpt-5.6`             | <Check />   | <Cross />   | <Check />         | <Check />  |
+| `gpt-5.6-luna`        | <Check />   | <Cross />   | <Check />         | <Check />  |
+| `gpt-5.6-sol`         | <Check />   | <Cross />   | <Check />         | <Check />  |
+| `gpt-5.6-terra`       | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-5.5`             | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-5.4-pro`         | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-5.4`             | <Check />   | <Cross />   | <Check />         | <Check />  |

content/providers/01-ai-sdk-providers/index.mdx

@@ -25,6 +25,10 @@ Not all providers support all AI SDK features. Here's a quick comparison of the
 | [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 />      |
 | [Vercel](/providers/ai-sdk-providers/vercel)               | `v0-1.0-md`                                         | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.6`                                           | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.6-luna`                                      | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.6-sol`                                       | <Check />   | <Check />         | <Check />  | <Check />      |
+| [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.6-terra`                                     | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.5`                                           | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.4-mini`                                      | <Check />   | <Check />         | <Check />  | <Check />      |
 | [OpenAI](/providers/ai-sdk-providers/openai)               | `gpt-5.4-nano`                                      | <Check />   | <Check />         | <Check />  | <Check />      |

examples/ai-e2e-next/agent/openai/apply-patch-agent.ts

@@ -20,7 +20,7 @@ async function ensureWorkspaceExists() {
 ensureWorkspaceExists();
 
 export const openaiApplyPatchAgent = new ToolLoopAgent({
-  model: openai.responses('gpt-5.1'),
+  model: openai.responses('gpt-5.6'),
   tools: {
     apply_patch: openai.tools.applyPatch({
       execute: createApplyPatchExecutor(workspaceRoot),

examples/ai-e2e-next/agent/openai/compaction-agent.ts

@@ -227,7 +227,7 @@ const preloadedMessages: ModelMessage[] = [
 ];
 
 export const openaiCompactionAgent = new ToolLoopAgent({
-  model: openai.responses('gpt-5.2'),
+  model: openai.responses('gpt-5.6'),
   providerOptions: {
     openai: {
       store: false,

examples/ai-e2e-next/agent/openai/mcp-approval-agent.ts

@@ -1,7 +1,7 @@
 import { openai } from '@ai-sdk/openai';
 import { ToolLoopAgent, type InferAgentUIMessage } from 'ai';
 export const openaiMCPApprovalAgent = new ToolLoopAgent({
-  model: openai.responses('gpt-5'),
+  model: openai.responses('gpt-5.6'),
   instructions:
     'You are a helpful assistant that can shorten links. ' +
     'Use the MCP tools available to you to shorten links when needed. ' +

examples/ai-e2e-next/agent/openai/sandbox-agent.ts

@@ -3,7 +3,7 @@ import { openai } from '@ai-sdk/openai';
 import { ToolLoopAgent, type InferAgentUIMessage } from 'ai';
 
 export const sandboxAgent = new ToolLoopAgent({
-  model: openai('gpt-5.5'),
+  model: openai('gpt-5.6'),
 
   tools: {
     shell: sandboxShellTool(),

examples/ai-e2e-next/agent/openai/shell-agent.ts

@@ -61,7 +61,7 @@ async function executeShellCommand(
 }
 
 export const openaiShellAgent = new ToolLoopAgent({
-  model: openai.responses('gpt-5.1'),
+  model: openai.responses('gpt-5.6'),
   instructions:
     'You have access to a shell tool that can execute commands on the local filesystem. ' +
     'Use the shell tool when you need to perform file operations or run commands. ' +

examples/ai-e2e-next/agent/openai/shell-container-agent.ts

@@ -1,7 +1,7 @@
 import { openai } from '@ai-sdk/openai';
 import { ToolLoopAgent, type InferAgentUIMessage } from 'ai';
 export const openaiShellContainerAgent = new ToolLoopAgent({
-  model: openai.responses('gpt-5.4'),
+  model: openai.responses('gpt-5.6'),
   instructions:
     'You have access to a shell tool running in a hosted container. ' +
     'Commands are executed server-side by OpenAI.',