docs: update OpenAI model examples from gpt-4o to gpt-5.2 (#222)

Update documentation examples to use gpt-5.2 instead of gpt-4o,
and gpt-5-mini instead of gpt-4o-mini for summarization examples.

Audio/transcription docs were intentionally left unchanged as they
reference specialized audio models (gpt-4o-audio-preview, whisper-1, etc.)
that have different naming conventions.

Author: shkumbinhasani

docs/adapters/openai.md

@@ -19,7 +19,7 @@ import { chat } from "@tanstack/ai";
 import { openaiText } from "@tanstack/ai-openai";
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [{ role: "user", content: "Hello!" }],
 });
 ```
@@ -35,7 +35,7 @@ const adapter = createOpenaiChat(process.env.OPENAI_API_KEY!, {
 });
 
 const stream = chat({
-  adapter: adapter("gpt-4o"),
+  adapter: adapter("gpt-5.2"),
   messages: [{ role: "user", content: "Hello!" }],
 });
 ```
@@ -63,7 +63,7 @@ export async function POST(request: Request) {
   const { messages } = await request.json();
 
   const stream = chat({
-    adapter: openaiText("gpt-4o"),
+    adapter: openaiText("gpt-5.2"),
     messages,
   });
 
@@ -92,7 +92,7 @@ const getWeather = getWeatherDef.server(async ({ location }) => {
 });
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages,
   tools: [getWeather],
 });
@@ -104,7 +104,7 @@ OpenAI supports various provider-specific options:
 
 ```typescript
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages,
   modelOptions: {
     temperature: 0.7,
@@ -141,7 +141,7 @@ import { summarize } from "@tanstack/ai";
 import { openaiSummarize } from "@tanstack/ai-openai";
 
 const result = await summarize({
-  adapter: openaiSummarize("gpt-4o-mini"),
+  adapter: openaiSummarize("gpt-5-mini"),
   text: "Your long text to summarize...",
   maxLength: 100,
   style: "concise", // "concise" | "bullet-points" | "paragraph"

docs/api/ai.md

@@ -21,7 +21,7 @@ import { chat } from "@tanstack/ai";
 import { openaiText } from "@tanstack/ai-openai";
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [{ role: "user", content: "Hello!" }],
   tools: [myTool],
   systemPrompts: ["You are a helpful assistant"],
@@ -31,7 +31,7 @@ const stream = chat({
 
 ### Parameters
 
-- `adapter` - An AI adapter instance with model (e.g., `openaiText('gpt-4o')`, `anthropicText('claude-sonnet-4-5')`)
+- `adapter` - An AI adapter instance with model (e.g., `openaiText('gpt-5.2')`, `anthropicText('claude-sonnet-4-5')`)
 - `messages` - Array of chat messages
 - `tools?` - Array of tools for function calling
 - `systemPrompts?` - System prompts to prepend to messages
@@ -52,7 +52,7 @@ import { summarize } from "@tanstack/ai";
 import { openaiSummarize } from "@tanstack/ai-openai";
 
 const result = await summarize({
-  adapter: openaiSummarize("gpt-4o"),
+  adapter: openaiSummarize("gpt-5.2"),
   text: "Long text to summarize...",
   maxLength: 100,
   style: "concise",
@@ -99,7 +99,7 @@ const myClientTool = myToolDef.client(async ({ param }) => {
 
 // Use directly in chat() (server-side, no execute)
 chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   tools: [myToolDef],
   messages: [{ role: "user", content: "..." }],
 });
@@ -112,7 +112,7 @@ const myServerTool = myToolDef.server(async ({ param }) => {
 
 // Use directly in chat() (server-side, no execute)
 chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   tools: [myServerTool],
   messages: [{ role: "user", content: "..." }],
 });
@@ -140,7 +140,7 @@ import { chat, toServerSentEventsStream } from "@tanstack/ai";
 import { openaiText } from "@tanstack/ai-openai";
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [...],
 });
 const readableStream = toServerSentEventsStream(stream);
@@ -167,7 +167,7 @@ import { chat, toServerSentEventsResponse } from "@tanstack/ai";
 import { openaiText } from "@tanstack/ai-openai";
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [...],
 });
 return toServerSentEventsResponse(stream);
@@ -191,7 +191,7 @@ import { chat, maxIterations } from "@tanstack/ai";
 import { openaiText } from "@tanstack/ai-openai";
 
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [...],
   agentLoopStrategy: maxIterations(20),
 });
@@ -274,21 +274,21 @@ import {
 
 // --- Streaming chat
 const stream = chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [{ role: "user", content: "Hello!" }],
 });
 
 // --- One-shot chat response (stream: false)
 const response = await chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [{ role: "user", content: "What's the capital of France?" }],
   stream: false, // Returns a Promise<string> instead of AsyncIterable
 });
 
 // --- Structured response with outputSchema
 import { z } from "zod";
 const parsed = await chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [{ role: "user", content: "Summarize this text in JSON with keys 'summary' and 'keywords': ... " }],
   outputSchema: z.object({
     summary: z.string(),
@@ -310,7 +310,7 @@ const weatherTool = toolDefinition({
 });
 
 const toolResult = await chat({
-  adapter: openaiText("gpt-4o"),
+  adapter: openaiText("gpt-5.2"),
   messages: [
     { role: "user", content: "What's the weather in Paris?" }
   ],
@@ -326,7 +326,7 @@ const toolResult = await chat({
 
 // --- Summarization
 const summary = await summarize({
-  adapter: openaiSummarize("gpt-4o"),
+  adapter: openaiSummarize("gpt-5.2"),
   text: "Long text to summarize...",
   maxLength: 100,
 });

docs/getting-started/overview.md

@@ -46,7 +46,7 @@ const getProducts = getProductsDef.server(async ({ query }) => {
 
 // Use in AI chat
 chat({
-  adapter: openaiText('gpt-4o'),
+  adapter: openaiText('gpt-5.2'),
   messages: [{ role: 'user', content: 'Find products' }],
   tools: [getProducts]
 })

docs/getting-started/quick-start.md

@@ -51,7 +51,7 @@ export const Route = createFileRoute("/api/chat")({
           const stream = chat({
             adapter: openai(),
             messages,
-            model: "gpt-4o",
+            model: "gpt-5.2",
             conversationId,
           });
 
@@ -100,7 +100,7 @@ export async function POST(request: Request) {
   try {
     // Create a streaming chat response
     const stream = chat({
-      adapter: openaiText("gpt-4o"),
+      adapter: openaiText("gpt-5.2"),
       messages,
       conversationId
     });
@@ -248,7 +248,7 @@ const getProducts = getProductsDef.server(async ({ query }) => {
 })
 
 chat({
-  adapter: openaiText('gpt-4o'),
+  adapter: openaiText('gpt-5.2'),
   messages: [{ role: 'user', content: 'Find products' }],
   tools: [getProducts]
 })

docs/guides/agentic-cycle.md

@@ -123,7 +123,7 @@ export async function POST(request: Request) {
   const { messages } = await request.json();
 
   const stream = chat({
-    adapter: openaiText("gpt-4o"),
+    adapter: openaiText("gpt-5.2"),
     messages,
     tools: [getWeather, getClothingAdvice],
   });

docs/guides/client-tools.md

@@ -102,7 +102,7 @@ export async function POST(request: Request) {
   const { messages } = await request.json();
 
   const stream = chat({
-    adapter: openaiText("gpt-4o"),
+    adapter: openaiText("gpt-5.2"),
     messages,
     tools: [updateUIDef, saveToLocalStorageDef], // Pass definitions
   });
@@ -297,10 +297,10 @@ const addToCartClient = addToCartDef.client((input) => {
 });
 
 // Server: Pass definition for client execution
-chat({ adapter: openaiText('gpt-4o'), messages: [], tools: [addToCartDef] }); // Client will execute
+chat({ adapter: openaiText('gpt-5.2'), messages: [], tools: [addToCartDef] }); // Client will execute
 
 // Or pass server implementation for server execution
-chat({ adapter: openaiText('gpt-4o'), messages: [], tools: [addToCartServer] }); // Server will execute
+chat({ adapter: openaiText('gpt-5.2'), messages: [], tools: [addToCartServer] }); // Server will execute
 ```
 
 ## Best Practices

docs/guides/migration.md

@@ -30,7 +30,7 @@ import { openai } from '@tanstack/ai-openai'
 
 const stream = chat({
   adapter: openai(),
-  model: 'gpt-4o',
+  model: 'gpt-5.2',
   messages: [{ role: 'user', content: 'Hello!' }],
 })
 ```
@@ -42,14 +42,14 @@ import { chat } from '@tanstack/ai'
 import { openaiText } from '@tanstack/ai-openai'
 
 const stream = chat({
-  adapter: openaiText('gpt-4o'),
+  adapter: openaiText('gpt-5.2'),
   messages: [{ role: 'user', content: 'Hello!' }],
 })
 ```
 
 ### Key Changes
 
-- **Model is passed to adapter factory** - The model name is now passed directly to the adapter function (e.g., `openaiText('gpt-4o')`)
+- **Model is passed to adapter factory** - The model name is now passed directly to the adapter function (e.g., `openaiText('gpt-5.2')`)
 - **No separate `model` parameter** - The model is stored on the adapter, so you don't need to pass it separately to `chat()`
 - **Activity-specific imports** - Import only what you need (e.g., `openaiText`, `openaiSummarize`, `openaiImage`)
 
@@ -123,7 +123,7 @@ function getAdapter(provider: Provider) {
 
 const stream = chat({
   adapter: getAdapter(provider),
-  model: provider === 'openai' ? 'gpt-4o' : 'claude-sonnet-4-5',
+  model: provider === 'openai' ? 'gpt-5.2' : 'claude-sonnet-4-5',
   messages,
 })
 ```
@@ -138,7 +138,7 @@ import { anthropicText } from '@tanstack/ai-anthropic'
 type Provider = 'openai' | 'anthropic'
 
 const adapters = {
-  openai: () => openaiText('gpt-4o'),
+  openai: () => openaiText('gpt-5.2'),
   anthropic: () => anthropicText('claude-sonnet-4-5'),
 }
 
@@ -157,7 +157,7 @@ Common options that were previously nested in an `options` object are now flatte
 ```typescript
 const stream = chat({
   adapter: openai(),
-  model: 'gpt-4o',
+  model: 'gpt-5.2',
   messages,
   options: {
     temperature: 0.7,
@@ -171,7 +171,7 @@ const stream = chat({
 
 ```typescript
 const stream = chat({
-  adapter: openaiText('gpt-4o'),
+  adapter: openaiText('gpt-5.2'),
   messages,
   temperature: 0.7,
   maxTokens: 1000,
@@ -197,7 +197,7 @@ The `providerOptions` parameter has been renamed to `modelOptions` for clarity.
 ```typescript
 const stream = chat({
   adapter: openai(),
-  model: 'gpt-4o',
+  model: 'gpt-5.2',
   messages,
   providerOptions: {
     // OpenAI-specific options
@@ -211,7 +211,7 @@ const stream = chat({
 
 ```typescript
 const stream = chat({
-  adapter: openaiText('gpt-4o'),
+  adapter: openaiText('gpt-5.2'),
   messages,
   modelOptions: {
     // OpenAI-specific options
@@ -228,14 +228,14 @@ const stream = chat({
 ```typescript
 import { openaiText } from '@tanstack/ai-openai'
 
-const adapter = openaiText('gpt-4o')
+const adapter = openaiText('gpt-5.2')
 
-// TypeScript knows the exact modelOptions type for gpt-4o
+// TypeScript knows the exact modelOptions type for gpt-5.2
 const stream = chat({
   adapter,
   messages,
   modelOptions: {
-    // Autocomplete and type checking for gpt-4o options
+    // Autocomplete and type checking for gpt-5.2 options
     responseFormat: { type: 'json_object' },
   },
 })
@@ -257,7 +257,7 @@ export async function POST(request: Request) {
 
   const stream = chat({
     adapter: openai(),
-    model: 'gpt-4o',
+    model: 'gpt-5.2',
     messages,
     abortController,
   })
@@ -277,7 +277,7 @@ export async function POST(request: Request) {
   const abortController = new AbortController()
 
   const stream = chat({
-    adapter: openaiText('gpt-4o'),
+    adapter: openaiText('gpt-5.2'),
     messages,
     abortController,
   })
@@ -371,7 +371,7 @@ export async function POST(request: Request) {
 
   const stream = chat({
     adapter: openai(),
-    model: 'gpt-4o',
+    model: 'gpt-5.2',
     messages,
     options: {
       temperature: 0.7,
@@ -398,7 +398,7 @@ export async function POST(request: Request) {
   const abortController = new AbortController()
 
   const stream = chat({
-    adapter: openaiText('gpt-4o'),
+    adapter: openaiText('gpt-5.2'),
     messages,
     temperature: 0.7,
     maxTokens: 1000,