@ai-sdk/openai 4.0.80 → 4.0.82

package/docs/03-openai.mdx

@@ -192,9 +192,9 @@ The following provider options are available:
   Reasoning effort for reasoning models. Defaults to `medium`. If you use `providerOptions` to set the `reasoningEffort` option, this model setting will be ignored.
 
 <Note>
-  Supported reasoning efforts vary by model. GPT-5.6 and GPT-6 support `'none'`,
-  `'low'`, `'medium'`, `'high'`, `'xhigh'`, and `'max'`. GPT-6 Astra does not
-  support `'none'`.
+  Supported reasoning efforts vary by model. GPT-5.6, GPT-6 Sol, and GPT-6 Luna
+  support `'none'`, `'low'`, `'medium'`, `'high'`, `'xhigh'`, and `'max'`. GPT-6
+  Astra and GPT-6.1 Sol do not support `'none'`.
 </Note>
 
 <Note type="warning">
@@ -220,8 +220,8 @@ The following provider options are available:
 - **reasoningContext** _'auto' | 'current_turn' | 'all_turns'_
   Controls which available reasoning items GPT-5.6 can reuse. `'auto'` uses the model default, `'current_turn'` excludes reasoning from earlier turns, and `'all_turns'` makes compatible earlier reasoning available. The effective context is returned as `providerMetadata.openai.reasoningContext`.
 
-- **reasoningSummary** _'auto' | 'detailed'_
-  Controls whether the model returns its reasoning process. Set to `'auto'` for a condensed summary, `'detailed'` for more comprehensive reasoning. Defaults to `undefined` (no reasoning summaries). When enabled, reasoning summaries appear in the stream as events with type `'reasoning'` and in non-streaming responses within the `reasoning` field.
+- **reasoningSummary** _'auto' | 'detailed' | null_
+  Controls whether the model returns its reasoning process. Set to `'auto'` for a condensed summary, `'detailed'` for more comprehensive reasoning, or `null` to omit reasoning summaries. Defaults to `'detailed'` when `reasoningEffort` is set to a value other than `'none'`, and to no reasoning summaries otherwise. When enabled, reasoning summaries appear in the stream as events with type `'reasoning'` and in non-streaming responses within the `reasoning` field.
 
 - **strictJsonSchema** _boolean_
   Whether to use strict JSON schema validation. Defaults to `true`.
@@ -1323,6 +1323,7 @@ const result = await generateText({
     apply_patch: openai.tools.applyPatch({
       execute: async ({ callId, operation }) => {
         // ... your implementation for applying the diffs.
+        return { status: 'completed' };
       },
     }),
   },
@@ -1657,7 +1658,7 @@ name those tools as you declared them instead.
 #### Image Inputs
 
 The OpenAI Responses API supports Image inputs for appropriate models.
-You can pass Image files as part of the message content using the 'image' type:
+You can pass Image files as part of the message content using the `file` type with an `image` media type:
 
 ```ts
 const result = await generateText({
@@ -1682,7 +1683,7 @@ const result = await generateText({
 ```
 
 The model will have access to the image and will respond to questions about it.
-The image should be passed using the `image` field.
+The image should be passed using the `data` field.
 
 You can also pass a file-id from the OpenAI Files API.
 
@@ -2457,7 +2458,7 @@ const logprobs = openaiMetadata?.logprobs;
 #### Image Support
 
 The OpenAI Chat API supports Image inputs for appropriate models.
-You can pass Image files as part of the message content using the 'image' type:
+You can pass Image files as part of the message content using the `file` type with an `image` media type:
 
 ```ts
 const result = await generateText({
@@ -2482,7 +2483,7 @@ const result = await generateText({
 ```
 
 The model will have access to the image and will respond to questions about it.
-The image should be passed using the `image` field.
+The image should be passed using the `data` field.
 
 You can also pass the URL of an image.
 
@@ -2878,6 +2879,7 @@ The following optional provider options are available for OpenAI completion mode
 | Model                 | Image Input | Audio Input | Object Generation | Tool Usage |
 | --------------------- | ----------- | ----------- | ----------------- | ---------- |
 | `gpt-6-astra`         | <Check />   | <Cross />   | <Check />         | <Check />  |
+| `gpt-6.1-sol`         | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-6-luna`          | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-6-sol`           | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-5.6`             | <Check />   | <Cross />   | <Check />         | <Check />  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.80",
+  "version": "4.0.82",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,14 +35,14 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.19",
-    "@ai-sdk/provider-utils": "5.0.51"
+    "@ai-sdk/provider": "4.0.20",
+    "@ai-sdk/provider-utils": "5.0.52"
   },
   "devDependencies": {
-    "@ai-sdk/test-server": "2.0.2",
+    "@ai-sdk/test-server": "2.0.3",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.23.0",
     "typescript": "5.8.3",
     "zod": "3.25.76"
   },
@@ -69,9 +69,9 @@
     "ai"
   ],
   "scripts": {
-    "build": "pnpm clean && tsup --tsconfig tsconfig.build.json",
-    "build:watch": "pnpm clean && tsup --watch",
-    "clean": "del-cli dist docs *.tsbuildinfo",
+    "build": "pnpm clean && tsdown",
+    "build:watch": "pnpm clean && tsdown --watch",
+    "clean": "del-cli docs *.tsbuildinfo",
     "type-check": "tsc --build",
     "test": "pnpm test:node && pnpm test:edge",
     "test:update": "pnpm test:node -u",

package/src/chat/openai-chat-language-model-options.ts

@@ -71,6 +71,7 @@ export type OpenAIChatModelId =
   | 'gpt-5.6-sol'
   | 'gpt-5.6-terra'
   | 'gpt-6-astra'
+  | 'gpt-6.1-sol'
   | 'gpt-6-luna'
   | 'gpt-6-sol'
   | (string & {});

package/src/normalize-openai-json-schema.ts

@@ -15,6 +15,10 @@ import {
  *
  * OpenAI also does not support regex lookaround in JSON Schema `pattern`
  * values. Those patterns are removed and left to client-side validation.
+ *
+ * Zod 4 represents recursive references as singleton `allOf` schemas. OpenAI
+ * does not support `allOf`, but a singleton local reference can be rewritten
+ * to a direct reference without changing its validation behavior.
  */
 export function normalizeOpenAIJsonSchema(schema: JSONSchema7): {
   schema: JSONSchema7;
@@ -23,7 +27,7 @@ export function normalizeOpenAIJsonSchema(schema: JSONSchema7): {
   let removedPropertyNames = false;
   let removedLookaroundPattern = false;
 
-  const normalizedSchema = normalizeSchema(schema);
+  const normalizedSchema = normalizeSchema(schema, true);
 
   const warnings: SharedV4Warning[] = [];
 
@@ -50,7 +54,7 @@ export function normalizeOpenAIJsonSchema(schema: JSONSchema7): {
     warnings,
   };
 
-  function normalizeSchema(schema: JSONSchema7): JSONSchema7 {
+  function normalizeSchema(schema: JSONSchema7, isRoot = false): JSONSchema7 {
     const propertyNames = schema.propertyNames;
 
     if (propertyNames != null) {
@@ -160,7 +164,76 @@ export function normalizeOpenAIJsonSchema(schema: JSONSchema7): {
       }
     }
 
-    return normalizedSchema;
+    const reference = getSingletonReference(normalizedSchema);
+
+    if (reference == null) {
+      return normalizedSchema;
+    }
+
+    const { allOf: _allOf, ...schemaWithoutAllOf } = normalizedSchema;
+
+    if (!isRoot) {
+      // A one-item allOf has the same validation behavior as its reference.
+      return {
+        ...schemaWithoutAllOf,
+        $ref: reference,
+      };
+    }
+
+    const referencedSchema = getLocalReferenceSchema(
+      reference,
+      normalizedSchema,
+    );
+
+    // OpenAI requires an object at the schema root, so a local root reference
+    // must be expanded instead of being sent as a direct $ref.
+    if (referencedSchema == null) {
+      return normalizedSchema;
+    }
+
+    return {
+      ...referencedSchema,
+      ...schemaWithoutAllOf,
+    };
+  }
+
+  function getSingletonReference(schema: JSONSchema7): string | undefined {
+    // Do not rewrite intersections: only a single reference is equivalent to
+    // a direct $ref.
+    if (schema.allOf?.length !== 1) {
+      return undefined;
+    }
+
+    const [allOfSchema] = schema.allOf;
+
+    return typeof allOfSchema === 'object' &&
+      allOfSchema != null &&
+      Object.keys(allOfSchema).length === 1 &&
+      typeof allOfSchema.$ref === 'string'
+      ? allOfSchema.$ref
+      : undefined;
+  }
+
+  function getLocalReferenceSchema(
+    reference: string,
+    schema: JSONSchema7,
+  ): JSONSchema7 | undefined {
+    const match = /^#\/(definitions|\$defs)\/(.+)$/.exec(reference);
+
+    if (match == null) {
+      return undefined;
+    }
+
+    const [, keyword, encodedName] = match;
+    const name = encodedName.replace(/~1/g, '/').replace(/~0/g, '~');
+    const definition =
+      keyword === 'definitions'
+        ? schema.definitions?.[name]
+        : schema.$defs?.[name];
+
+    return typeof definition === 'object' && definition != null
+      ? definition
+      : undefined;
   }
 
   function normalizeSchemaRecord(

package/src/responses/openai-responses-language-model-options.ts

@@ -58,6 +58,7 @@ export const openaiResponsesReasoningModelIds = [
   'gpt-5.6-sol',
   'gpt-5.6-terra',
   'gpt-6-astra',
+  'gpt-6.1-sol',
   'gpt-6-luna',
   'gpt-6-sol',
 ] as const;
@@ -133,6 +134,7 @@ export type OpenAIResponsesModelId =
   | 'gpt-5.6-sol'
   | 'gpt-5.6-terra'
   | 'gpt-6-astra'
+  | 'gpt-6.1-sol'
   | 'gpt-6-luna'
   | 'gpt-6-sol'
   | 'gpt-5-2025-08-07'