@ai-sdk/openai 4.0.103 → 4.0.105

package/docs/03-openai.mdx

@@ -245,9 +245,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 type="warning">
@@ -3069,6 +3069,7 @@ The following optional provider options are available for OpenAI completion mode
 | --------------------- | ----------- | ----------- | ----------------- | ---------- |
 | `gpt-6-astra`         | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-6.1-sol`         | <Check />   | <Cross />   | <Check />         | <Check />  |
+| `gpt-6.1-terra`       | <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 />  |
@@ -3508,12 +3509,13 @@ The following provider options are available:
 
 - **timestampGranularities** _string[]_
   The granularity of the timestamps in the transcription.
-  Defaults to `['segment']`.
+  Defaults to `['segment']` when `responseFormat` is `verbose_json`.
   Possible values are `['word']`, `['segment']`, and `['word', 'segment']`.
   Note: There is no additional latency for segment timestamps, but generating word timestamps incurs additional latency.
 
 - **language** _string_
   The language of the input audio. Supplying the input language in ISO-639-1 format (e.g. 'en') will improve accuracy and latency.
+  For streaming with `gpt-transcribe` and `gpt-live-transcribe`, it is sent as a single-entry `languages` list.
   Optional.
 
 - **prompt** _string_
@@ -3529,13 +3531,13 @@ The following provider options are available:
   Additional information to include in the transcription response.
 
 - **responseFormat** _'json' | 'verbose_json' | 'diarized_json'_
-  The format of the transcription response. `gpt-4o-transcribe-diarize` defaults to `diarized_json`.
+  The format of the transcription response. `whisper-1` defaults to `verbose_json` and `gpt-4o-transcribe-diarize` defaults to `diarized_json`. Other models use the service default unless this option is set.
 
 - **chunkingStrategy** _'auto' | object_
   Controls how the audio is split into chunks. `gpt-4o-transcribe-diarize` defaults to `'auto'`; provide this option to override the default. The object form configures OpenAI server-side VAD with `type: 'server_vad'` and optional `threshold`, `prefixPaddingMs`, and `silenceDurationMs` fields.
 
 - **streaming** _object_
-  Options for streaming transcription models such as `gpt-realtime-whisper`.
+  Options for streaming transcription models such as `gpt-live-transcribe`.
   Use with `experimental_streamTranscribe`.
   - **delay** _'minimal' | 'low' | 'medium' | 'high' | 'xhigh'_
     Latency/accuracy tradeoff for realtime transcription.
@@ -3551,6 +3553,8 @@ The following provider options are available:
 | `gpt-4o-mini-transcribe`    | <Check />     | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
 | `gpt-4o-transcribe`         | <Check />     | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
 | `gpt-4o-transcribe-diarize` | <Check />     | <Cross /> | <Check /> | <Check /> | <Cross /> |
+| `gpt-transcribe`            | <Check />     | <Check /> | <Cross /> | <Cross /> | <Check /> |
+| `gpt-live-transcribe`       | <Cross />     | <Check /> | <Cross /> | <Cross /> | <Cross /> |
 | `gpt-realtime-whisper`      | <Cross />     | <Check /> | <Cross /> | <Cross /> | <Cross /> |
 
 ## Translation Models
@@ -3691,8 +3695,10 @@ include probability distributions. Boolean questions use the API's predicate
 primitive and return P(true). Apply thresholds in application code, for example
 `answers.requestsRefund.probability >= 0.5`.
 
-Structured state, instructions, and criterion descriptions are serialized as JSON
-text. Score levels receive zero-based index labels. Non-null Boolean criteria are
+JSON state parts that hold an object or an array of objects are sent as native
+`input_json` parts when they fit its limits (32 container levels, 10,000 values, and
+256 KiB of compact UTF-8 JSON). Larger JSON state, other JSON state values, structured
+instructions, and criterion descriptions are serialized as JSON text. Score levels receive zero-based index labels. Non-null Boolean criteria are
 appended to predicate instructions under `Criteria for true:` and `Criteria for false:`.
 String criteria are passed through; structured criteria are serialized as JSON text.
 
@@ -3714,11 +3720,15 @@ state: [
 
 The factory respects `createOpenAI` settings, including custom fetch and base URL.
 Set `providerOptions.openai.safetyIdentifier` to an opaque end-user identifier for
-safety monitoring (up to 128 characters). For example:
+safety monitoring (up to 128 characters). Set `providerOptions.openai.promptCacheKey`
+to partition prompt cache reuse across requests that share `state`. For example:
 
 ```ts
 providerOptions: {
-  openai: { safetyIdentifier: 'user-123' } satisfies OpenAIDecisionModelOptions,
+  openai: {
+    safetyIdentifier: 'user-123',
+    promptCacheKey: 'tenant-42',
+  } satisfies OpenAIDecisionModelOptions,
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.103",
+  "version": "4.0.105",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.34",
-    "@ai-sdk/provider-utils": "5.0.69"
+    "@ai-sdk/provider-utils": "5.0.71"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/chat/openai-chat-language-model-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/chat/openai-chat-language-model.ts

@@ -26,7 +26,10 @@ import {
   type ParseResult,
 } from '@ai-sdk/provider-utils';
 import { openaiFailedResponseHandler } from '../openai-error';
-import { getOpenAILanguageModelCapabilities } from '../openai-language-model-capabilities';
+import {
+  getOpenAILanguageModelCapabilities,
+  resolveOpenAIReasoningEffort,
+} from '../openai-language-model-capabilities';
 import {
   createOpenAIProviderStreamError,
   throwIfOpenAIStreamErrorBeforeOutput,
@@ -121,26 +124,38 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
 
     const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
 
-    // AI SDK reasoning values map directly to the OpenAI reasoning values.
-    let resolvedReasoningEffort =
-      openaiOptions.reasoningEffort ??
-      (isCustomReasoning(reasoning) ? reasoning : undefined);
+    // Some models reject function tools unless reasoning is disabled, even
+    // when no reasoning effort is sent, so reasoning is set to 'none'.
+    const requiresNoReasoningEffort =
+      !modelCapabilities.supportsChatFunctionToolsWithReasoning &&
+      openaiOptions.reasoningEffort == null &&
+      (tools?.some(tool => tool.type === 'function') ?? false);
 
     if (
-      resolvedReasoningEffort != null &&
-      modelCapabilities.supportedReasoningEfforts != null &&
-      !modelCapabilities.supportedReasoningEfforts.includes(
-        resolvedReasoningEffort,
-      )
+      requiresNoReasoningEffort &&
+      isCustomReasoning(reasoning) &&
+      reasoning !== 'none'
     ) {
       warnings.push({
-        type: 'unsupported',
-        feature: 'reasoningEffort',
-        details: `${this.modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(', ')}`,
+        type: 'compatibility',
+        feature: 'reasoning',
+        details: `${this.modelId} does not support function tools with reasoning in the Chat Completions API. reasoning effort set to "none". Use the Responses API to combine reasoning with function tools.`,
       });
-      resolvedReasoningEffort = undefined;
     }
 
+    const resolvedReasoningEffort = requiresNoReasoningEffort
+      ? 'none'
+      : resolveOpenAIReasoningEffort({
+          providerReasoningEffort: openaiOptions.reasoningEffort,
+          reasoning,
+          // Only the Responses API supports `max`.
+          supportedReasoningEfforts:
+            modelCapabilities.supportedReasoningEfforts?.filter(
+              effort => effort !== 'max',
+            ),
+          warnings,
+        });
+
     const isReasoningModel =
       openaiOptions.forceReasoning ?? modelCapabilities.isReasoningModel;
 
@@ -246,7 +261,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     };
 
     if (
-      modelCapabilities.supportedReasoningEfforts != null &&
+      modelCapabilities.supportsConfigurationUpdate &&
       baseArgs.prompt_cache_retention != null
     ) {
       baseArgs.prompt_cache_retention = undefined;

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

@@ -58,9 +58,10 @@ export function normalizeOpenAIJsonSchema(schema: JSONSchema7): {
     const propertyNames = schema.propertyNames;
 
     if (propertyNames != null) {
+      // Property names are always strings in JSON, so omitted type is a string schema.
       if (
         typeof propertyNames === 'boolean' ||
-        propertyNames.type !== 'string'
+        (propertyNames.type != null && propertyNames.type !== 'string')
       ) {
         throw new UnsupportedFunctionalityError({
           functionality:

package/src/openai-batch.ts

@@ -47,7 +47,7 @@ import {
   type OpenAIResponsesLogprobs,
 } from './responses/openai-responses-api';
 import {
-  mapWebSearchOutput,
+  mapWebSearchResult,
   OpenAIResponsesLanguageModel,
   openaiResponsesSupportedUrls,
 } from './responses/openai-responses-language-model';
@@ -812,9 +812,7 @@ async function convertOpenAIBatchResult(
           type: 'tool-result',
           toolCallId: part.id,
           toolName: 'web_search',
-          ...(part.status === 'failed' || part.status === 'incomplete'
-            ? { isError: true, result: { status: part.status } }
-            : { result: mapWebSearchOutput(part.action) }),
+          ...mapWebSearchResult(part),
           dynamic: true,
         });
         break;

package/src/openai-decision-model-options.ts

@@ -10,6 +10,7 @@ export const openaiDecisionModelOptions = lazySchema(() =>
     z.object({
       /** An opaque end-user identifier for safety monitoring, up to 128 characters. */
       safetyIdentifier: z.string().max(128).optional(),
+      promptCacheKey: z.string().optional(),
     }),
   ),
 );

package/src/openai-decision-model.ts

@@ -4,6 +4,8 @@ import {
   type Experimental_DecisionModelV4 as DecisionModelV4,
   type Experimental_DecisionModelV4Answer as DecisionModelV4Answer,
   type Experimental_DecisionModelV4Input as DecisionModelV4Input,
+  type JSONObject,
+  type JSONValue,
 } from '@ai-sdk/provider';
 import {
   lazySchema,
@@ -148,6 +150,7 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
       body: {
         model: this.modelId,
         safety_identifier: openaiOptions?.safetyIdentifier,
+        prompt_cache_key: openaiOptions?.promptCacheKey,
         input: [
           {
             role: 'user',
@@ -155,10 +158,9 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
               if (part.type === 'text')
                 return { type: 'input_text', text: part.text };
               if (part.type === 'json')
-                return {
-                  type: 'input_text',
-                  text: JSON.stringify(part.value),
-                };
+                return isInputJsonData(part.value)
+                  ? { type: 'input_json', data: part.value }
+                  : { type: 'input_text', text: JSON.stringify(part.value) };
               if (part.data.type !== 'data') {
                 throw new UnsupportedFunctionalityError({
                   functionality: `OpenAI decision file input: ${part.mediaType} (${part.data.type})`,
@@ -323,7 +325,7 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
           ? [{ type: 'unsupported' as const, feature: 'reasoning' }]
           : []),
         ...Object.keys(providerOptions?.openai ?? {})
-          .filter(option => option !== 'safetyIdentifier')
+          .filter(option => !SUPPORTED_PROVIDER_OPTIONS.has(option))
           .map(option => ({
             type: 'unsupported' as const,
             feature: `providerOptions.openai.${option}`,
@@ -351,6 +353,45 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
   }
 }
 
+const SUPPORTED_PROVIDER_OPTIONS = new Set([
+  'safetyIdentifier',
+  'promptCacheKey',
+]);
+
 function toText(input: DecisionModelV4Input): string {
   return typeof input === 'string' ? input : JSON.stringify(input);
 }
+
+const INPUT_JSON_MAX_DEPTH = 32;
+const INPUT_JSON_MAX_VALUES = 10_000;
+const INPUT_JSON_MAX_BYTES = 256 * 1024;
+
+function isInputJsonData(value: JSONValue): value is JSONObject | JSONObject[] {
+  const hasInputJsonShape = Array.isArray(value)
+    ? value.length > 0 && value.every(isJSONObject)
+    : isJSONObject(value);
+  return hasInputJsonShape && fitsInputJsonLimits(value);
+}
+
+function fitsInputJsonLimits(value: JSONValue): boolean {
+  let count = 0;
+  const visit = (node: JSONValue | undefined, depth: number): boolean => {
+    count += 1;
+    if (count > INPUT_JSON_MAX_VALUES) return false;
+    if (node === null || typeof node !== 'object') return true;
+    if (depth > INPUT_JSON_MAX_DEPTH) return false;
+    const children: readonly (JSONValue | undefined)[] = Array.isArray(node)
+      ? node
+      : Object.values(node);
+    return children.every(child => visit(child, depth + 1));
+  };
+  return (
+    visit(value, 1) &&
+    new TextEncoder().encode(JSON.stringify(value)).length <=
+      INPUT_JSON_MAX_BYTES
+  );
+}
+
+function isJSONObject(value: JSONValue): value is JSONObject {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

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

@@ -1,3 +1,25 @@
+import type {
+  LanguageModelV4CallOptions,
+  SharedV4Warning,
+} from '@ai-sdk/provider';
+import { mapReasoningToProviderEffort } from '@ai-sdk/provider-utils';
+
+type OpenAIReasoningEffort = Exclude<
+  LanguageModelV4CallOptions['reasoning'],
+  'provider-default' | undefined
+>;
+
+// Unknown model families send the reasoning value directly.
+const ALL_OPENAI_REASONING_EFFORTS: readonly OpenAIReasoningEffort[] = [
+  'none',
+  'minimal',
+  'low',
+  'medium',
+  'high',
+  'xhigh',
+  'max',
+];
+
 export type OpenAILanguageModelCapabilities = {
   isReasoningModel: boolean;
   systemMessageMode: 'remove' | 'system' | 'developer';
@@ -5,7 +27,17 @@ export type OpenAILanguageModelCapabilities = {
   supportsPriorityProcessing: boolean;
   supportsConfigurationUpdate: boolean;
   supportsAsyncToolCalling: boolean;
-  supportedReasoningEfforts: readonly string[] | undefined;
+  /**
+   * Reasoning efforts supported by the model family, or `undefined` when they
+   * are not known.
+   */
+  supportedReasoningEfforts: readonly OpenAIReasoningEffort[] | undefined;
+
+  /**
+   * Whether function tools can be combined with a reasoning effort other than
+   * `none` in the Chat Completions API.
+   */
+  supportsChatFunctionToolsWithReasoning: boolean;
 
   /**
    * Allow temperature, topP, logProbs when reasoningEffort is none.
@@ -24,7 +56,19 @@ 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';
+  // Pro, codex, and chat variants are excluded because their supported
+  // efforts are not known.
+  const isStandardGpt5Model =
+    gptVersion?.major === 5 &&
+    (gptVersion.variant == null ||
+      /^(?:(?:mini|nano|sol|luna|terra)(?:-\d{4}-\d{2}-\d{2})?|\d{4}-\d{2}-\d{2})$/.test(
+        gptVersion.variant,
+      ));
+
+  const isGpt6OrLaterModelWithNoneEffort =
+    modelId === 'gpt-6-sol' ||
+    modelId === 'gpt-6-luna' ||
+    modelId === 'gpt-6.1-terra';
 
   const supportsFlexProcessing =
     (oSeriesVersion != null && oSeriesVersion >= 3) ||
@@ -45,10 +89,10 @@ export function getOpenAILanguageModelCapabilities(
     (gptVersion != null && gptVersion.major >= 5 && !isGptChatModel);
 
   // https://platform.openai.com/docs/guides/latest-model#gpt-5-1-parameter-compatibility
-  // GPT-5.1 through GPT-5.x and GPT-6 Sol/Luna support temperature,
-  // topP, and logProbs when reasoningEffort is none.
+  // GPT-5.1 through GPT-5.x, GPT-6 Sol/Luna, and GPT-6.1 Terra support
+  // temperature, topP, and logProbs when reasoningEffort is none.
   const supportsNonReasoningParameters =
-    isGpt6SolOrLuna ||
+    isGpt6OrLaterModelWithNoneEffort ||
     (!isGpt6OrLaterModel &&
       gptVersion != null &&
       (gptVersion.major > 5 ||
@@ -61,17 +105,41 @@ export function getOpenAILanguageModelCapabilities(
     supportsPriorityProcessing,
     supportsConfigurationUpdate: isGpt6OrLaterModel,
     supportsAsyncToolCalling: isGpt6OrLaterModel,
-    supportedReasoningEfforts: isGpt6SolOrLuna
+    supportedReasoningEfforts: isGpt6OrLaterModelWithNoneEffort
       ? ['none', 'low', 'medium', 'high', 'xhigh', 'max']
       : isGpt6OrLaterModel
         ? ['low', 'medium', 'high', 'xhigh', 'max']
-        : undefined,
+        : isStandardGpt5Model
+          ? getGpt5ReasoningEfforts(gptVersion.minor ?? 0)
+          : undefined,
+    // GPT-5.6 rejects function tools with reasoning in the Chat Completions API.
+    supportsChatFunctionToolsWithReasoning: !(
+      gptVersion?.major === 5 && (gptVersion.minor ?? 0) >= 6
+    ),
     isReasoningModel,
     systemMessageMode,
     supportsNonReasoningParameters,
   };
 }
 
+function getGpt5ReasoningEfforts(
+  minor: number,
+): readonly OpenAIReasoningEffort[] {
+  if (minor === 0) {
+    return ['minimal', 'low', 'medium', 'high'];
+  }
+
+  if (minor === 1) {
+    return ['none', 'low', 'medium', 'high'];
+  }
+
+  if (minor < 6) {
+    return ['none', 'low', 'medium', 'high', 'xhigh'];
+  }
+
+  return ['none', 'low', 'medium', 'high', 'xhigh', 'max'];
+}
+
 function getOSeriesVersion(modelId: string): number | undefined {
   const match = /^o(\d+)(?:-|$)/.exec(modelId);
   return match == null ? undefined : Number(match[1]);
@@ -96,3 +164,33 @@ function getGptVersion(modelId: string):
     variant: match[3],
   };
 }
+
+/**
+ * Resolves the reasoning effort to send to OpenAI.
+ *
+ * A reasoning effort from provider options is sent unchanged. Otherwise the
+ * top-level reasoning value is mapped to the closest effort that the model
+ * family supports, or sent directly when the supported efforts are not known.
+ */
+export function resolveOpenAIReasoningEffort({
+  providerReasoningEffort,
+  reasoning,
+  supportedReasoningEfforts,
+  warnings,
+}: {
+  providerReasoningEffort: string | null | undefined;
+  reasoning: LanguageModelV4CallOptions['reasoning'];
+  supportedReasoningEfforts: readonly OpenAIReasoningEffort[] | undefined;
+  warnings: SharedV4Warning[];
+}): string | undefined {
+  return mapReasoningToProviderEffort({
+    reasoning,
+    providerOptionsEffort: providerReasoningEffort,
+    effortMap: Object.fromEntries(
+      (supportedReasoningEfforts ?? ALL_OPENAI_REASONING_EFFORTS).map(
+        effort => [effort, effort],
+      ),
+    ),
+    warnings,
+  });
+}

package/src/responses/openai-responses-language-model-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/responses/openai-responses-language-model.ts

@@ -22,7 +22,6 @@ import {
   createJsonResponseHandler,
   createToolNameMapping,
   generateId,
-  isCustomReasoning,
   parseProviderOptions,
   postJsonToApi,
   serializeModelOptions,
@@ -37,7 +36,10 @@ import {
   type OpenAIConfig,
 } from '../openai-config';
 import { openaiFailedResponseHandler } from '../openai-error';
-import { getOpenAILanguageModelCapabilities } from '../openai-language-model-capabilities';
+import {
+  getOpenAILanguageModelCapabilities,
+  resolveOpenAIReasoningEffort,
+} from '../openai-language-model-capabilities';
 import {
   createOpenAIProviderStreamError,
   throwIfOpenAIStreamErrorBeforeOutput,
@@ -341,24 +343,12 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
       });
     }
 
-    let resolvedReasoningEffort =
-      openaiOptions?.reasoningEffort ??
-      (isCustomReasoning(reasoning) ? reasoning : undefined);
-
-    if (
-      resolvedReasoningEffort != null &&
-      modelCapabilities.supportedReasoningEfforts != null &&
-      !modelCapabilities.supportedReasoningEfforts.includes(
-        resolvedReasoningEffort,
-      )
-    ) {
-      warnings.push({
-        type: 'unsupported',
-        feature: 'reasoningEffort',
-        details: `${modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(', ')}`,
-      });
-      resolvedReasoningEffort = undefined;
-    }
+    const resolvedReasoningEffort = resolveOpenAIReasoningEffort({
+      providerReasoningEffort: openaiOptions?.reasoningEffort,
+      reasoning,
+      supportedReasoningEfforts: modelCapabilities.supportedReasoningEfforts,
+      warnings,
+    });
 
     const resolvedReasoningSummary =
       openaiOptions?.reasoningSummary !== undefined
@@ -458,10 +448,13 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
 
     // The schema accepts update efforts supported by any supported model. Check
     // whether this specific model supports the requested effort.
+    const supportedReasoningEfforts =
+      modelCapabilities.supportedReasoningEfforts as
+        | readonly string[]
+        | undefined;
     const getUpdateEffortUnsupportedReason = (effort: string | undefined) =>
-      effort != null &&
-      modelCapabilities.supportedReasoningEfforts?.includes(effort) === false
-        ? `${modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(', ')}`
+      effort != null && supportedReasoningEfforts?.includes(effort) === false
+        ? `${modelId} only supports the following reasoning efforts: ${supportedReasoningEfforts.join(', ')}`
         : undefined;
 
     // Reject configuration updates whose effort value is unsupported by the selected model.
@@ -725,7 +718,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
         }
 
         if (
-          modelCapabilities.supportedReasoningEfforts != null &&
+          modelCapabilities.supportsConfigurationUpdate &&
           (baseArgs.top_logprobs != null ||
             baseArgs.include?.includes('message.output_text.logprobs'))
         ) {
@@ -1275,9 +1268,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
             toolName: toolNameMapping.toCustomToolName(
               webSearchToolName ?? 'web_search',
             ),
-            ...(part.status === 'failed' || part.status === 'incomplete'
-              ? { isError: true, result: { status: part.status } }
-              : { result: mapWebSearchOutput(part.action) }),
+            ...mapWebSearchResult(part),
           });
 
           if (part.action?.type === 'search') {
@@ -2190,10 +2181,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
                   toolName: toolNameMapping.toCustomToolName(
                     webSearchToolName ?? 'web_search',
                   ),
-                  ...(value.item.status === 'failed' ||
-                  value.item.status === 'incomplete'
-                    ? { isError: true, result: { status: value.item.status } }
-                    : { result: mapWebSearchOutput(value.item.action) }),
+                  ...mapWebSearchResult(value.item),
                 });
 
                 if (value.item.action?.type === 'search') {
@@ -3180,7 +3168,21 @@ function isResponseOutputChunk(chunk: OpenAIResponsesChunk): boolean {
   );
 }
 
-export function mapWebSearchOutput(
+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> {
   if (action == null) {

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

@@ -12,7 +12,9 @@ export type OpenAITranscriptionModelId =
   | 'gpt-4o-mini-transcribe-2025-12-15'
   | 'gpt-4o-transcribe'
   | 'gpt-4o-transcribe-diarize'
+  | 'gpt-live-transcribe'
   | 'gpt-realtime-whisper'
+  | 'gpt-transcribe'
   | (string & {});
 
 // https://platform.openai.com/docs/api-reference/audio/createTranscription
@@ -43,12 +45,9 @@ export const openAITranscriptionModelOptions = lazySchema(() =>
 
       /**
        * The timestamp granularities to populate for this transcription.
-       * @default ['segment']
+       * Defaults to ['segment'] when the response format is verbose_json.
        */
-      timestampGranularities: z
-        .array(z.enum(['word', 'segment']))
-        .default(['segment'])
-        .optional(),
+      timestampGranularities: z.array(z.enum(['word', 'segment'])).optional(),
 
       /**
        * The format of the transcription response.
@@ -73,7 +72,7 @@ export const openAITranscriptionModelOptions = lazySchema(() =>
         .optional(),
 
       /**
-       * Options for streaming transcription models such as `gpt-realtime-whisper`.
+       * Options for streaming transcription models such as `gpt-live-transcribe`.
        */
       streaming: z
         .object({