openai 7.16.0 → 7.18.0

package/src/resources/live/forks/internal-base.ts

@@ -22,13 +22,21 @@ export type ForksStreamMessage =
 export class WebSocketError extends OpenAIError {
   /**
    * The error data that the API sent back in an error event.
+   *
+   * This property is non-enumerable to avoid exposing the event through
+   * JSON serialization, object spread, or Object.assign.
    */
   error?: LiveAPI.ErrorEvent | undefined;
 
   constructor(message: string, event: LiveAPI.ErrorEvent | null) {
     super(message);
 
-    this.error = event ?? undefined;
+    Object.defineProperty(this, 'error', {
+      value: event ?? undefined,
+      writable: true,
+      configurable: true,
+      enumerable: false,
+    });
   }
 }
 
@@ -68,7 +76,8 @@ export abstract class ForksEmitter extends EventEmitter<WebSocketEvents> {
   protected _onError(event: null, message: string, cause: any): void;
   protected _onError(event: LiveAPI.ErrorEvent, message?: string | undefined): void;
   protected _onError(event: LiveAPI.ErrorEvent | null, message?: string | undefined, cause?: any): void {
-    message = message ?? safeJSONStringify(event) ?? 'unknown error';
+    const safeMessage = safeWebSocketErrorMessage(event, message);
+    message = safeMessage ?? 'unknown error';
 
     if (!this._hasListener('error')) {
       const error = new WebSocketError(
@@ -98,10 +107,20 @@ export function buildURL(client: OpenAI, parameters: Record<string, unknown>): U
   return url;
 }
 
-function safeJSONStringify(value: unknown): string | null {
+function safeWebSocketErrorMessage(event: unknown, message: unknown): string | undefined {
+  if (typeof message === 'string') return message;
+  if (typeof event !== 'object' || event === null) return undefined;
+
   try {
-    return JSON.stringify(value);
+    const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+    const nestedMessage =
+      typeof error === 'object' && error !== null
+        ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+        : undefined;
+    const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+    const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+    return typeof candidate === 'string' ? candidate : undefined;
   } catch {
-    return null;
+    return undefined;
   }
 }

package/src/resources/live/forks/ws.ts

@@ -4,7 +4,6 @@ import * as WS from 'ws';
 import { NodeWebSocket } from '../../../internal/ws-adapter-node';
 import { ForksWSBase, type ForksWSBaseOptions, type ForksWSParameters } from './ws-base';
 import { OpenAI } from '../../../client';
-import { VERSION } from '../../../version';
 
 export type { WebSocketStreamOptions } from '../../../internal/ws';
 
@@ -36,10 +35,10 @@ export class ForksWS extends ForksWSBase<NodeWebSocket> {
     const ws = new WS.WebSocket(url, {
       ...this._wsOptions,
       headers: {
-        'User-Agent': `${this._client.constructor.name}/JS ${VERSION}`,
-
-        ...authHeaders,
-        ...this._wsOptions?.headers,
+        ...this._client._buildWebSocketHeaders(authHeaders),
+        ...Object.fromEntries(
+          Object.entries(this._wsOptions?.headers ?? {}).map(([name, value]) => [name.toLowerCase(), value]),
+        ),
       },
       followRedirects: false,
     });

package/src/resources/live/internal-base.ts

@@ -19,13 +19,21 @@ export type LiveStreamMessage =
 export class WebSocketError extends OpenAIError {
   /**
    * The error data that the API sent back in an error event.
+   *
+   * This property is non-enumerable to avoid exposing the event through
+   * JSON serialization, object spread, or Object.assign.
    */
   error?: LiveAPI.ErrorEvent | undefined;
 
   constructor(message: string, event: LiveAPI.ErrorEvent | null) {
     super(message);
 
-    this.error = event ?? undefined;
+    Object.defineProperty(this, 'error', {
+      value: event ?? undefined,
+      writable: true,
+      configurable: true,
+      enumerable: false,
+    });
   }
 }
 
@@ -65,7 +73,8 @@ export abstract class LiveEmitter extends EventEmitter<WebSocketEvents> {
   protected _onError(event: null, message: string, cause: any): void;
   protected _onError(event: LiveAPI.ErrorEvent, message?: string | undefined): void;
   protected _onError(event: LiveAPI.ErrorEvent | null, message?: string | undefined, cause?: any): void {
-    message = message ?? safeJSONStringify(event) ?? 'unknown error';
+    const safeMessage = safeWebSocketErrorMessage(event, message);
+    message = safeMessage ?? 'unknown error';
 
     if (!this._hasListener('error')) {
       const error = new WebSocketError(
@@ -95,10 +104,20 @@ export function buildURL(client: OpenAI, parameters: Record<string, unknown>): U
   return url;
 }
 
-function safeJSONStringify(value: unknown): string | null {
+function safeWebSocketErrorMessage(event: unknown, message: unknown): string | undefined {
+  if (typeof message === 'string') return message;
+  if (typeof event !== 'object' || event === null) return undefined;
+
   try {
-    return JSON.stringify(value);
+    const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+    const nestedMessage =
+      typeof error === 'object' && error !== null
+        ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+        : undefined;
+    const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+    const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+    return typeof candidate === 'string' ? candidate : undefined;
   } catch {
-    return null;
+    return undefined;
   }
 }

package/src/resources/live/sideband/internal-base.ts

@@ -22,13 +22,21 @@ export type SidebandStreamMessage =
 export class WebSocketError extends OpenAIError {
   /**
    * The error data that the API sent back in an error event.
+   *
+   * This property is non-enumerable to avoid exposing the event through
+   * JSON serialization, object spread, or Object.assign.
    */
   error?: LiveAPI.ErrorEvent | undefined;
 
   constructor(message: string, event: LiveAPI.ErrorEvent | null) {
     super(message);
 
-    this.error = event ?? undefined;
+    Object.defineProperty(this, 'error', {
+      value: event ?? undefined,
+      writable: true,
+      configurable: true,
+      enumerable: false,
+    });
   }
 }
 
@@ -68,7 +76,8 @@ export abstract class SidebandEmitter extends EventEmitter<WebSocketEvents> {
   protected _onError(event: null, message: string, cause: any): void;
   protected _onError(event: LiveAPI.ErrorEvent, message?: string | undefined): void;
   protected _onError(event: LiveAPI.ErrorEvent | null, message?: string | undefined, cause?: any): void {
-    message = message ?? safeJSONStringify(event) ?? 'unknown error';
+    const safeMessage = safeWebSocketErrorMessage(event, message);
+    message = safeMessage ?? 'unknown error';
 
     if (!this._hasListener('error')) {
       const error = new WebSocketError(
@@ -98,10 +107,20 @@ export function buildURL(client: OpenAI, parameters: Record<string, unknown>): U
   return url;
 }
 
-function safeJSONStringify(value: unknown): string | null {
+function safeWebSocketErrorMessage(event: unknown, message: unknown): string | undefined {
+  if (typeof message === 'string') return message;
+  if (typeof event !== 'object' || event === null) return undefined;
+
   try {
-    return JSON.stringify(value);
+    const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+    const nestedMessage =
+      typeof error === 'object' && error !== null
+        ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+        : undefined;
+    const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+    const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+    return typeof candidate === 'string' ? candidate : undefined;
   } catch {
-    return null;
+    return undefined;
   }
 }

package/src/resources/live/sideband/ws.ts

@@ -4,7 +4,6 @@ import * as WS from 'ws';
 import { NodeWebSocket } from '../../../internal/ws-adapter-node';
 import { SidebandWSBase, type SidebandWSBaseOptions, type SidebandWSParameters } from './ws-base';
 import { OpenAI } from '../../../client';
-import { VERSION } from '../../../version';
 
 export type { WebSocketStreamOptions } from '../../../internal/ws';
 
@@ -36,10 +35,10 @@ export class SidebandWS extends SidebandWSBase<NodeWebSocket> {
     const ws = new WS.WebSocket(url, {
       ...this._wsOptions,
       headers: {
-        'User-Agent': `${this._client.constructor.name}/JS ${VERSION}`,
-
-        ...authHeaders,
-        ...this._wsOptions?.headers,
+        ...this._client._buildWebSocketHeaders(authHeaders),
+        ...Object.fromEntries(
+          Object.entries(this._wsOptions?.headers ?? {}).map(([name, value]) => [name.toLowerCase(), value]),
+        ),
       },
       followRedirects: false,
     });

package/src/resources/live/ws.ts

@@ -4,7 +4,6 @@ import * as WS from 'ws';
 import { NodeWebSocket } from '../../internal/ws-adapter-node';
 import { LiveWSBase, type LiveWSBaseOptions } from './ws-base';
 import { OpenAI } from '../../client';
-import { VERSION } from '../../version';
 
 export type { WebSocketStreamOptions } from '../../internal/ws';
 
@@ -32,10 +31,10 @@ export class LiveWS extends LiveWSBase<NodeWebSocket> {
     const ws = new WS.WebSocket(url, {
       ...this._wsOptions,
       headers: {
-        'User-Agent': `${this._client.constructor.name}/JS ${VERSION}`,
-
-        ...authHeaders,
-        ...this._wsOptions?.headers,
+        ...this._client._buildWebSocketHeaders(authHeaders),
+        ...Object.fromEntries(
+          Object.entries(this._wsOptions?.headers ?? {}).map(([name, value]) => [name.toLowerCase(), value]),
+        ),
       },
       followRedirects: false,
     });

package/src/resources/responses/api.md

@@ -38,6 +38,7 @@ Types:
 - <code><a href="./src/resources/responses/responses.ts">ResponseCodeInterpreterCallInProgressEvent</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCodeInterpreterCallInterpretingEvent</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCodeInterpreterToolCall</a></code>
+- <code><a href="./src/resources/responses/responses.ts">ResponseCompactionCompactingEvent</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCompactionItem</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCompactionItemParam</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCompletedEvent</a></code>

package/src/resources/responses/internal-base.ts

@@ -27,13 +27,21 @@ type WebSocketErrorEvent = Extract<ResponsesAPI.ResponsesServerEvent, { type: 'e
 export class WebSocketError extends OpenAIError {
   /**
    * The error data that the API sent back in an error event.
+   *
+   * This property is non-enumerable to avoid exposing the event through
+   * JSON serialization, object spread, or Object.assign.
    */
   error?: WebSocketErrorEvent | undefined;
 
   constructor(message: string, event: WebSocketErrorEvent | null) {
     super(message);
 
-    this.error = event ?? undefined;
+    Object.defineProperty(this, 'error', {
+      value: event ?? undefined,
+      writable: true,
+      configurable: true,
+      enumerable: false,
+    });
   }
 }
 
@@ -73,13 +81,8 @@ export abstract class ResponsesEmitter extends EventEmitter<WebSocketEvents> {
   protected _onError(event: null, message: string, cause: any): void;
   protected _onError(event: WebSocketErrorEvent, message?: string | undefined): void;
   protected _onError(event: WebSocketErrorEvent | null, message?: string | undefined, cause?: any): void {
-    const eventMessage = event && ('error' in event ? event.error?.message : event.message);
-    message = message ?? eventMessage ?? safeJSONStringify(event) ?? 'unknown error';
-    try {
-      message = String(message);
-    } catch {
-      message = '[unserializable error value]';
-    }
+    const safeMessage = safeWebSocketErrorMessage(event, message);
+    message = safeMessage ?? 'unknown error';
 
     if (!this._hasListener('error')) {
       const error = new WebSocketError(
@@ -110,10 +113,20 @@ export function buildURL(client: OpenAI, parameters: Record<string, unknown>): U
   return url;
 }
 
-function safeJSONStringify(value: unknown): string | null {
+function safeWebSocketErrorMessage(event: unknown, message: unknown): string | undefined {
+  if (typeof message === 'string') return message;
+  if (typeof event !== 'object' || event === null) return undefined;
+
   try {
-    return JSON.stringify(value);
+    const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+    const nestedMessage =
+      typeof error === 'object' && error !== null
+        ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+        : undefined;
+    const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+    const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+    return typeof candidate === 'string' ? candidate : undefined;
   } catch {
-    return null;
+    return undefined;
   }
 }

package/src/resources/responses/responses.ts

@@ -2026,6 +2026,32 @@ export namespace ResponseCodeInterpreterToolCall {
   }
 }
 
+/**
+ * Emitted when new summary content is sampled for a compaction trigger. Contains
+ * no summary content.
+ */
+export interface ResponseCompactionCompactingEvent {
+  /**
+   * The ID of the compaction output item.
+   */
+  item_id: string;
+
+  /**
+   * The index of the compaction output item.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the event that was emitted.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event, always `response.compaction.compacting`.
+   */
+  type: 'response.compaction.compacting';
+}
+
 /**
  * A compaction item generated by the
  * [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
@@ -8136,6 +8162,7 @@ export type ResponseStreamEvent =
   | ResponseCodeInterpreterCallCompletedEvent
   | ResponseCodeInterpreterCallInProgressEvent
   | ResponseCodeInterpreterCallInterpretingEvent
+  | ResponseCompactionCompactingEvent
   | ResponseCompletedEvent
   | ResponseContentPartAddedEvent
   | ResponseContentPartDoneEvent
@@ -9083,6 +9110,12 @@ export namespace ResponsesClientEvent {
        */
       mode?: 'implicit' | 'explicit';
 
+      /**
+       * Prepares the prompt cache without generating output. Defaults to `false`. When
+       * set to `true`, overrides the `generate` field to `false`.
+       */
+      prewarm?: boolean;
+
       /**
        * The minimum lifetime applied to every implicit and explicit cache breakpoint
        * written by the request. Defaults to `30m`, which is currently the only supported
@@ -9128,6 +9161,7 @@ export type ResponsesServerEvent =
   | ResponsesServerEvent.ResponseCodeInterpreterCallWsCompleted
   | ResponsesServerEvent.ResponseCodeInterpreterCallInWsProgress
   | ResponsesServerEvent.ResponseCodeInterpreterCallWsInterpreting
+  | ResponsesServerEvent.ResponseCompactionWsCompacting
   | ResponsesServerEvent.ResponseWsCompleted
   | ResponsesServerEvent.ResponseContentPartWsAdded
   | ResponsesServerEvent.ResponseContentPartWsDone
@@ -9282,6 +9316,18 @@ export namespace ResponsesServerEvent {
     stream_id?: string;
   }
 
+  /**
+   * Emitted when new summary content is sampled for a compaction trigger. Contains
+   * no summary content.
+   */
+  export interface ResponseCompactionWsCompacting extends ResponseCompactionCompactingEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
   /**
    * Emitted when the model response is complete.
    */
@@ -11093,6 +11139,12 @@ export namespace ResponseCreateParams {
      */
     mode?: 'implicit' | 'explicit';
 
+    /**
+     * Prepares the prompt cache without generating output. Defaults to `false`. When
+     * set to `true`, overrides the `generate` field to `false`.
+     */
+    prewarm?: boolean;
+
     /**
      * The minimum lifetime applied to every implicit and explicit cache breakpoint
      * written by the request. Defaults to `30m`, which is currently the only supported
@@ -11244,7 +11296,6 @@ export interface ResponseCompactParams {
     | 'gpt-5.1'
     | 'gpt-5.1-2025-11-13'
     | 'gpt-5.1-codex'
-    | 'gpt-5.1-mini'
     | 'gpt-5.1-chat-latest'
     | 'gpt-5'
     | 'gpt-5-mini'
@@ -11275,6 +11326,8 @@ export interface ResponseCompactParams {
     | 'gpt-4o-2024-11-20'
     | 'gpt-4o-2024-08-06'
     | 'gpt-4o-2024-05-13'
+    | 'gpt-audio-mini'
+    | 'gpt-audio-mini-2025-12-15'
     | 'gpt-4o-audio-preview'
     | 'gpt-4o-audio-preview-2024-10-01'
     | 'gpt-4o-audio-preview-2024-12-17'
@@ -11308,6 +11361,7 @@ export interface ResponseCompactParams {
     | 'gpt-3.5-turbo-1106'
     | 'gpt-3.5-turbo-0125'
     | 'gpt-3.5-turbo-16k-0613'
+    | 'gpt-5.1-mini'
     | 'o1-pro'
     | 'o1-pro-2025-03-19'
     | 'o3-pro'
@@ -11468,6 +11522,7 @@ export declare namespace Responses {
     type ResponseCodeInterpreterCallInProgressEvent as ResponseCodeInterpreterCallInProgressEvent,
     type ResponseCodeInterpreterCallInterpretingEvent as ResponseCodeInterpreterCallInterpretingEvent,
     type ResponseCodeInterpreterToolCall as ResponseCodeInterpreterToolCall,
+    type ResponseCompactionCompactingEvent as ResponseCompactionCompactingEvent,
     type ResponseCompactionItem as ResponseCompactionItem,
     type ResponseCompactionItemParam as ResponseCompactionItemParam,
     type ResponseCompletedEvent as ResponseCompletedEvent,

package/src/resources/responses/ws-base.ts

@@ -7,6 +7,8 @@ import { type WebSocketLike, ReadyState } from '../../internal/ws-adapter';
 import {
   SendQueue,
   getMaxBufferedEvents,
+  recordWebSocketError,
+  rawByteLength,
   type WebSocketStreamOptions,
   flattenRawData,
   isRecoverableClose,
@@ -19,6 +21,21 @@ import * as ResponsesAPI from './responses';
 import { OpenAI } from '../../client';
 import { OpenAIError } from '../../core/error';
 
+const webSocketEventPayloads = new WeakMap<ResponsesAPI.ResponsesServerEvent, string>();
+const webSocketEventBytes = new WeakMap<ResponsesAPI.ResponsesServerEvent, number>();
+
+/** Uses immutable wire size, or JSON accounting for a custom emitter. @internal */
+export function getWebSocketEventBytes(event: ResponsesAPI.ResponsesServerEvent): number {
+  return webSocketEventBytes.get(event) ?? rawByteLength(JSON.stringify(event));
+}
+
+/** Original JSON, available only during synchronous event notification.
+ * @internal
+ */
+export function getWebSocketEventPayload(event: ResponsesAPI.ResponsesServerEvent): string | undefined {
+  return webSocketEventPayloads.get(event);
+}
+
 export interface ResponsesWSReconnectOptions {
   /**
    * Called before each reconnect attempt. Return an object with
@@ -99,7 +116,11 @@ export abstract class ResponsesWSBase<TSocket extends WebSocketLike> extends Res
     this.socket = this._connect();
   }
 
-  /** Creates a platform-specific WebSocket for the given URL and auth headers. */
+  /**
+   * Creates a platform-specific WebSocket for the given URL and captured client auth headers.
+   * The transport must supply or validate its final credentials before connecting;
+   * these headers may be empty when authentication is managed by the transport.
+   */
   protected abstract _createSocket(url: URL, authHeaders: Record<string, string>): TSocket;
 
   send(event: ResponsesAPI.ResponsesClientEvent) {
@@ -436,6 +457,7 @@ export abstract class ResponsesWSBase<TSocket extends WebSocketLike> extends Res
       }
 
       const eventType: string = event.type;
+      const errorEvent = event.type === 'error' ? event : undefined;
       const reservedEventType =
         eventType === 'raw' ||
         eventType === 'close' ||
@@ -449,17 +471,24 @@ export abstract class ResponsesWSBase<TSocket extends WebSocketLike> extends Res
         return;
       }
 
-      this._emit('event', event);
+      webSocketEventBytes.set(event, rawByteLength(data));
+      webSocketEventPayloads.set(event, text);
+      try {
+        this._emit('event', event);
+      } finally {
+        webSocketEventPayloads.delete(event);
+      }
 
-      if (event.type === 'error') {
-        this._onError(event);
+      if (errorEvent) {
+        this._onError(errorEvent);
       } else {
         // @ts-ignore TS isn't smart enough to get the relationship right here
-        this._emit(event.type, event);
+        this._emit(eventType, event);
       }
     });
 
     socket.on('error', (err: Error) => {
+      recordWebSocketError(socket, err);
       // Suppress transient errors during reconnection — the retry loop
       // already handles them and will surface a close if retries exhaust.
       if (this._isReconnecting) return;
@@ -692,9 +721,7 @@ export abstract class ResponsesWSBase<TSocket extends WebSocketLike> extends Res
   }
 
   protected _authHeaders(): Record<string, string> {
-    if (this._client.apiKey) {
-      return { Authorization: `Bearer ${this._client.apiKey}` };
-    }
-    return {};
+    const apiKey = this._client.apiKey;
+    return typeof apiKey === 'string' && apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
   }
 }

package/src/resources/responses/ws.ts

@@ -4,13 +4,17 @@ import * as WS from 'ws';
 import { NodeWebSocket } from '../../internal/ws-adapter-node';
 import { ResponsesWSBase, type ResponsesWSBaseOptions } from './ws-base';
 import { OpenAI } from '../../client';
-import { VERSION } from '../../version';
+import { OpenAIError } from '../../core/error';
+import { snapshotWebSocketCredentials } from '../../internal/ws';
 
 export type { WebSocketStreamOptions } from '../../internal/ws';
 
 export type { ResponsesWSReconnectOptions } from './ws-base';
 
-export interface ResponsesWSClientOptions extends WS.ClientOptions, ResponsesWSBaseOptions {}
+export interface ResponsesWSClientOptions extends WS.ClientOptions, ResponsesWSBaseOptions {
+  /** Basic authentication forwarded by the Node `ws` transport. */
+  auth?: string;
+}
 
 export class ResponsesWS extends ResponsesWSBase<NodeWebSocket> {
   private _wsOptions: WS.ClientOptions | null | undefined;
@@ -21,7 +25,6 @@ export class ResponsesWS extends ResponsesWSBase<NodeWebSocket> {
         'ResponsesWS from "openai/resources/responses/ws" requires the "ws" package but it could not be loaded.',
       );
     }
-
     const { reconnect, maxQueueSize, ...wsOptions } = options ?? {};
     super(client, { reconnect, maxQueueSize });
     this._wsOptions = wsOptions;
@@ -29,16 +32,31 @@ export class ResponsesWS extends ResponsesWSBase<NodeWebSocket> {
   }
 
   protected _createSocket(url: URL, authHeaders: Record<string, string>): NodeWebSocket {
-    const ws = new WS.WebSocket(url, {
+    const capturedAuthHeaders = { ...authHeaders };
+    const headers = new Map(Object.entries(this._client._buildWebSocketHeaders(capturedAuthHeaders)));
+    for (const [name, value] of Object.entries(this._wsOptions?.headers ?? {})) {
+      if (value === null) {
+        headers.delete(name.toLowerCase());
+      } else if (value !== undefined) {
+        headers.set(name.toLowerCase(), value);
+      }
+    }
+    const socketOptions: ResponsesWSClientOptions = {
       ...this._wsOptions,
-      headers: {
-        'User-Agent': `${this._client.constructor.name}/JS ${VERSION}`,
-
-        ...authHeaders,
-        ...this._wsOptions?.headers,
-      },
+      headers: Object.fromEntries(headers),
       followRedirects: false,
-    });
+    };
+    if (
+      this._client._hasApiKeyProvider() &&
+      !capturedAuthHeaders['Authorization'] &&
+      !snapshotWebSocketCredentials(socketOptions)
+    ) {
+      throw new OpenAIError(
+        'Cannot open a Responses WebSocket with an unresolved function-based apiKey. Resolve it before constructing the WebSocket or provide explicit WebSocket credentials.',
+      );
+    }
+
+    const ws = new WS.WebSocket(url, socketOptions);
     return new NodeWebSocket(ws);
   }
 }

package/src/resources/shared.ts

@@ -44,7 +44,6 @@ export type ChatModel =
   | 'gpt-5.1'
   | 'gpt-5.1-2025-11-13'
   | 'gpt-5.1-codex'
-  | 'gpt-5.1-mini'
   | 'gpt-5.1-chat-latest'
   | 'gpt-5'
   | 'gpt-5-mini'
@@ -75,6 +74,8 @@ export type ChatModel =
   | 'gpt-4o-2024-11-20'
   | 'gpt-4o-2024-08-06'
   | 'gpt-4o-2024-05-13'
+  | 'gpt-audio-mini'
+  | 'gpt-audio-mini-2025-12-15'
   | 'gpt-4o-audio-preview'
   | 'gpt-4o-audio-preview-2024-10-01'
   | 'gpt-4o-audio-preview-2024-12-17'
@@ -107,7 +108,8 @@ export type ChatModel =
   | 'gpt-3.5-turbo-0613'
   | 'gpt-3.5-turbo-1106'
   | 'gpt-3.5-turbo-0125'
-  | 'gpt-3.5-turbo-16k-0613';
+  | 'gpt-3.5-turbo-16k-0613'
+  | 'gpt-5.1-mini';
 
 /**
  * A filter used to compare a specified attribute key to a given value using a

package/src/resources/webhooks/webhooks.ts

@@ -684,10 +684,9 @@ export namespace RealtimeCallIncomingWebhookEvent {
    */
   export interface Data {
     /**
-     * The Transceiver `rtc_...` ID of the pending SIP session. The paired
-     * `live.transport.incoming` event derives its `session_id` by replacing the `rtc_`
-     * prefix with `live_`. Use the ID returned by the event with the corresponding
-     * Realtime or Live API.
+     * The ID of the pending SIP call. Pass this value unchanged when accepting or
+     * rejecting the call through the Realtime API. For the Live API, use the
+     * `session_id` from `live.transport.incoming` instead.
      */
     call_id: string;
 

package/src/version.ts

@@ -1,2 +1,2 @@
 /** Version of the installed OpenAI SDK package. */
-export const VERSION = '7.16.0'; // x-release-please-version
+export const VERSION = '7.18.0'; // x-release-please-version

package/version.d.mts

@@ -1,3 +1,3 @@
 /** Version of the installed OpenAI SDK package. */
-export declare const VERSION = "7.16.0";
+export declare const VERSION = "7.18.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,3 +1,3 @@
 /** Version of the installed OpenAI SDK package. */
-export declare const VERSION = "7.16.0";
+export declare const VERSION = "7.18.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /** Version of the installed OpenAI SDK package. */
-exports.VERSION = '7.16.0'; // x-release-please-version
+exports.VERSION = '7.18.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map