@ai-sdk/openai 3.0.132 → 3.0.134

package/docs/03-openai.mdx

@@ -206,9 +206,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, 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'`.
+  Supported reasoning efforts vary by model. GPT-5.6, GPT-6 Sol, GPT-6 Luna, and
+  GPT-6.1 Terra support `'none'`, `'low'`, `'medium'`, `'high'`, `'xhigh'`, and
+  `'max'`. GPT-6 Astra and GPT-6.1 Sol do not support `'none'`.
 </Note>
 
 <Note>
@@ -2562,6 +2562,7 @@ The following optional provider options are available for OpenAI completion mode
 | --------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
 | `gpt-6-astra`         | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6.1-sol`         | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| `gpt-6.1-terra`        | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6-luna`          | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6-sol`           | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-5.6`             | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "3.0.132",
+  "version": "3.0.134",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -36,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider-utils": "4.0.62",
-    "@ai-sdk/provider": "3.0.19"
+    "@ai-sdk/provider": "3.0.19",
+    "@ai-sdk/provider-utils": "4.0.62"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

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

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

package/src/openai-language-model-capabilities.ts

@@ -24,7 +24,10 @@ export function getOpenAILanguageModelCapabilities(
   const isGptNanoModel = gptVersion?.variant?.startsWith('nano') ?? false;
   const isGpt6OrLaterModel = gptVersion != null && gptVersion.major >= 6;
 
-  const isGpt6SolOrLuna = modelId === 'gpt-6-sol' || modelId === 'gpt-6-luna';
+  const isGpt6OrLaterModelWithNoneEffort =
+    modelId === 'gpt-6-sol' ||
+    modelId === 'gpt-6-luna' ||
+    modelId === 'gpt-6.1-terra';
 
   const supportsFlexProcessing =
     (oSeriesVersion != null && oSeriesVersion >= 3) ||
@@ -59,7 +62,7 @@ export function getOpenAILanguageModelCapabilities(
     supportsPriorityProcessing,
     supportsConfigurationUpdate: isGpt6OrLaterModel,
     supportsAsyncToolCalling: isGpt6OrLaterModel,
-    supportedReasoningEfforts: isGpt6SolOrLuna
+    supportedReasoningEfforts: isGpt6OrLaterModelWithNoneEffort
       ? ['none', 'low', 'medium', 'high', 'xhigh', 'max']
       : isGpt6OrLaterModel
         ? ['low', 'medium', 'high', 'xhigh', 'max']

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

@@ -1009,7 +1009,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV3 {
             toolName: toolNameMapping.toCustomToolName(
               webSearchToolName ?? 'web_search',
             ),
-            result: mapWebSearchOutput(part.action),
+            ...mapWebSearchResult(part),
           });
 
           break;
@@ -1772,7 +1772,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV3 {
                   toolName: toolNameMapping.toCustomToolName(
                     webSearchToolName ?? 'web_search',
                   ),
-                  result: mapWebSearchOutput(value.item.action),
+                  ...mapWebSearchResult(value.item),
                 });
               } else if (value.item.type === 'computer_call') {
                 ongoingToolCalls[value.output_index] = undefined;
@@ -2678,6 +2678,20 @@ function isResponseOutputChunk(chunk: OpenAIResponsesChunk): boolean {
   );
 }
 
+export function mapWebSearchResult({
+  action,
+  status,
+}: {
+  action?: OpenAIResponsesWebSearchAction | null;
+  status: string;
+}):
+  | { isError: true; result: { status: string } }
+  | { result: InferSchema<typeof webSearchOutputSchema> } {
+  return status === 'completed'
+    ? { result: mapWebSearchOutput(action) }
+    : { isError: true, result: { status } };
+}
+
 function mapWebSearchOutput(
   action: OpenAIResponsesWebSearchAction | null | undefined,
 ): InferSchema<typeof webSearchOutputSchema> {

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

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

package/src/transcription/openai-transcription-api.ts

@@ -32,6 +32,14 @@ export const openaiTranscriptionResponseSchema = lazySchema(() =>
           }),
         )
         .nullish(),
+      // Lenient: an unexpected usage shape must not fail the transcription.
+      usage: z
+        .object({
+          type: z.string().nullish(),
+          seconds: z.number().nullish(),
+        })
+        .nullish()
+        .catch(undefined),
     }),
   ),
 );

package/src/transcription/openai-transcription-model.ts

@@ -145,12 +145,16 @@ export class OpenAITranscriptionModel implements TranscriptionModelV3 {
         prompt: openAIOptions.prompt,
         // https://platform.openai.com/docs/api-reference/audio/createTranscription#audio_createtranscription-response_format
         // prefer verbose_json to get segments for models that support it
-        response_format: [
-          'gpt-4o-transcribe',
-          'gpt-4o-mini-transcribe',
-        ].includes(this.modelId)
-          ? 'json'
-          : 'verbose_json',
+        // gpt-4o(-mini)-transcribe (incl. snapshots) and gpt-transcribe reject verbose_json:
+        response_format:
+          ['gpt-4o-transcribe', 'gpt-4o-mini-transcribe'].includes(
+            this.modelId,
+          ) ||
+          this.modelId.startsWith('gpt-4o-mini-transcribe-') ||
+          this.modelId === 'gpt-transcribe' ||
+          this.modelId.startsWith('gpt-transcribe-')
+            ? 'json'
+            : 'verbose_json',
         temperature: openAIOptions.temperature,
         timestamp_granularities: openAIOptions.timestampGranularities,
       };
@@ -219,7 +223,12 @@ export class OpenAITranscriptionModel implements TranscriptionModelV3 {
         })) ??
         [],
       language,
-      durationInSeconds: response.duration ?? undefined,
+      // Duration-billed json responses report the duration only in `usage`:
+      durationInSeconds:
+        response.duration ??
+        (response.usage?.type === 'duration'
+          ? (response.usage.seconds ?? undefined)
+          : undefined),
       warnings,
       response: {
         timestamp: currentDate,