openai 6.32.0 → 6.34.0

package/src/resources/responses/responses.ts

@@ -39,8 +39,10 @@ export type ParsedResponseOutputItem<ParsedT> =
   | ParsedResponseOutputMessage<ParsedT>
   | ParsedResponseFunctionToolCall
   | ResponseFileSearchToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
   | ResponseReasoningItem
@@ -48,6 +50,7 @@ export type ParsedResponseOutputItem<ParsedT> =
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
@@ -55,7 +58,9 @@ export type ParsedResponseOutputItem<ParsedT> =
   | ResponseOutputItem.McpCall
   | ResponseOutputItem.McpListTools
   | ResponseOutputItem.McpApprovalRequest
-  | ResponseCustomToolCall;
+  | ResponseOutputItem.McpApprovalResponse
+  | ResponseCustomToolCall
+  | ResponseCustomToolCallOutputItem;
 
 export interface ParsedResponse<ParsedT> extends Response {
   output: Array<ParsedResponseOutputItem<ParsedT>>;
@@ -310,12 +315,22 @@ export namespace ComputerAction {
      * The y-coordinate where the click occurred.
      */
     y: number;
+
+    /**
+     * The keys being held while clicking.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
    * A double click action.
    */
   export interface DoubleClick {
+    /**
+     * The keys being held while double-clicking.
+     */
+    keys: Array<string> | null;
+
     /**
      * Specifies the event type. For a double click action, this property is always set
      * to `double_click`.
@@ -355,6 +370,11 @@ export namespace ComputerAction {
      * `drag`.
      */
     type: 'drag';
+
+    /**
+     * The keys being held while dragging the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   export namespace Drag {
@@ -410,6 +430,11 @@ export namespace ComputerAction {
      * The y-coordinate to move to.
      */
     y: number;
+
+    /**
+     * The keys being held while moving the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -452,6 +477,11 @@ export namespace ComputerAction {
      * The y-coordinate where the scroll occurred.
      */
     y: number;
+
+    /**
+     * The keys being held while scrolling.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -1771,12 +1801,22 @@ export namespace ResponseComputerToolCall {
      * The y-coordinate where the click occurred.
      */
     y: number;
+
+    /**
+     * The keys being held while clicking.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
    * A double click action.
    */
   export interface DoubleClick {
+    /**
+     * The keys being held while double-clicking.
+     */
+    keys: Array<string> | null;
+
     /**
      * Specifies the event type. For a double click action, this property is always set
      * to `double_click`.
@@ -1816,6 +1856,11 @@ export namespace ResponseComputerToolCall {
      * `drag`.
      */
     type: 'drag';
+
+    /**
+     * The keys being held while dragging the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   export namespace Drag {
@@ -1871,6 +1916,11 @@ export namespace ResponseComputerToolCall {
      * The y-coordinate to move to.
      */
     y: number;
+
+    /**
+     * The keys being held while moving the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -1913,6 +1963,11 @@ export namespace ResponseComputerToolCall {
      * The y-coordinate where the scroll occurred.
      */
     y: number;
+
+    /**
+     * The keys being held while scrolling.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -1959,6 +2014,12 @@ export interface ResponseComputerToolCallOutputItem {
    */
   output: ResponseComputerToolCallOutputScreenshot;
 
+  /**
+   * The status of the message input. One of `in_progress`, `completed`, or
+   * `incomplete`. Populated when input items are returned via API.
+   */
+  status: 'completed' | 'incomplete' | 'failed' | 'in_progress';
+
   /**
    * The type of the computer tool call output. Always `computer_call_output`.
    */
@@ -1971,10 +2032,9 @@ export interface ResponseComputerToolCallOutputItem {
   acknowledged_safety_checks?: Array<ResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck>;
 
   /**
-   * The status of the message input. One of `in_progress`, `completed`, or
-   * `incomplete`. Populated when input items are returned via API.
+   * The identifier of the actor that created the item.
    */
-  status?: 'in_progress' | 'completed' | 'incomplete';
+  created_by?: string;
 }
 
 export namespace ResponseComputerToolCallOutputItem {
@@ -2289,6 +2349,27 @@ export interface ResponseCustomToolCallInputDoneEvent {
   type: 'response.custom_tool_call_input.done';
 }
 
+/**
+ * A call to a custom tool created by the model.
+ */
+export interface ResponseCustomToolCallItem extends ResponseCustomToolCall {
+  /**
+   * The unique ID of the custom tool call item.
+   */
+  id: string;
+
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
 /**
  * The output of a custom tool call from your code, being sent back to the model.
  */
@@ -2315,6 +2396,27 @@ export interface ResponseCustomToolCallOutput {
   id?: string;
 }
 
+/**
+ * The output of a custom tool call from your code, being sent back to the model.
+ */
+export interface ResponseCustomToolCallOutputItem extends ResponseCustomToolCallOutput {
+  /**
+   * The unique ID of the custom tool call output item.
+   */
+  id: string;
+
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
 /**
  * An error object returned when the model fails to generate a Response.
  */
@@ -2932,6 +3034,17 @@ export interface ResponseFunctionToolCallItem extends ResponseFunctionToolCall {
    * The unique ID of the function tool call.
    */
   id: string;
+
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
 }
 
 export interface ResponseFunctionToolCallOutputItem {
@@ -2951,16 +3064,21 @@ export interface ResponseFunctionToolCallOutputItem {
    */
   output: string | Array<ResponseInputText | ResponseInputImage | ResponseInputFile>;
 
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
   /**
    * The type of the function tool call output. Always `function_call_output`.
    */
   type: 'function_call_output';
 
   /**
-   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-   * Populated when items are returned via API.
+   * The identifier of the actor that created the item.
    */
-  status?: 'in_progress' | 'completed' | 'incomplete';
+  created_by?: string;
 }
 
 /**
@@ -4149,15 +4267,15 @@ export interface ResponseInputMessageItem {
   role: 'user' | 'system' | 'developer';
 
   /**
-   * The status of item. One of `in_progress`, `completed`, or `incomplete`.
-   * Populated when items are returned via API.
+   * The type of the message input. Always set to `message`.
    */
-  status?: 'in_progress' | 'completed' | 'incomplete';
+  type: 'message';
 
   /**
-   * The type of the message input. Always set to `message`.
+   * The status of item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
    */
-  type?: 'message';
+  status?: 'in_progress' | 'completed' | 'incomplete';
 }
 
 /**
@@ -4204,6 +4322,8 @@ export type ResponseItem =
   | ResponseFunctionToolCallOutputItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
+  | ResponseReasoningItem
+  | ResponseCompactionItem
   | ResponseItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseItem.LocalShellCall
@@ -4215,7 +4335,9 @@ export type ResponseItem =
   | ResponseItem.McpListTools
   | ResponseItem.McpApprovalRequest
   | ResponseItem.McpApprovalResponse
-  | ResponseItem.McpCall;
+  | ResponseItem.McpCall
+  | ResponseCustomToolCallItem
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseItem {
   /**
@@ -4756,8 +4878,10 @@ export type ResponseOutputItem =
   | ResponseOutputMessage
   | ResponseFileSearchToolCall
   | ResponseFunctionToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
   | ResponseReasoningItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
@@ -4765,6 +4889,7 @@ export type ResponseOutputItem =
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
@@ -4772,7 +4897,9 @@ export type ResponseOutputItem =
   | ResponseOutputItem.McpCall
   | ResponseOutputItem.McpListTools
   | ResponseOutputItem.McpApprovalRequest
-  | ResponseCustomToolCall;
+  | ResponseOutputItem.McpApprovalResponse
+  | ResponseCustomToolCall
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseOutputItem {
   /**
@@ -4867,6 +4994,31 @@ export namespace ResponseOutputItem {
     }
   }
 
+  /**
+   * The output of a local shell tool call.
+   */
+  export interface LocalShellCallOutput {
+    /**
+     * The unique ID of the local shell tool call generated by the model.
+     */
+    id: string;
+
+    /**
+     * A JSON string of the output of the local shell tool call.
+     */
+    output: string;
+
+    /**
+     * The type of the local shell tool call output. Always `local_shell_call_output`.
+     */
+    type: 'local_shell_call_output';
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+     */
+    status?: 'in_progress' | 'completed' | 'incomplete' | null;
+  }
+
   /**
    * An invocation of a tool on an MCP server.
    */
@@ -5006,6 +5158,36 @@ export namespace ResponseOutputItem {
      */
     type: 'mcp_approval_request';
   }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface McpApprovalResponse {
+    /**
+     * The unique ID of the approval response
+     */
+    id: string;
+
+    /**
+     * The ID of the approval request being answered.
+     */
+    approval_request_id: string;
+
+    /**
+     * Whether the request was approved.
+     */
+    approve: boolean;
+
+    /**
+     * The type of the item. Always `mcp_approval_response`.
+     */
+    type: 'mcp_approval_response';
+
+    /**
+     * Optional reason for the decision.
+     */
+    reason?: string | null;
+  }
 }
 
 /**
@@ -7839,7 +8021,9 @@ export declare namespace Responses {
     type ResponseCustomToolCall as ResponseCustomToolCall,
     type ResponseCustomToolCallInputDeltaEvent as ResponseCustomToolCallInputDeltaEvent,
     type ResponseCustomToolCallInputDoneEvent as ResponseCustomToolCallInputDoneEvent,
+    type ResponseCustomToolCallItem as ResponseCustomToolCallItem,
     type ResponseCustomToolCallOutput as ResponseCustomToolCallOutput,
+    type ResponseCustomToolCallOutputItem as ResponseCustomToolCallOutputItem,
     type ResponseError as ResponseError,
     type ResponseErrorEvent as ResponseErrorEvent,
     type ResponseFailedEvent as ResponseFailedEvent,

package/src/resources/responses/ws.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import * as WS from 'ws';
-import { ResponsesEmitter, buildURL } from './internal-base';
+import { ResponsesEmitter, ResponsesStreamMessage, WebSocketError, buildURL } from './internal-base';
 import * as ResponsesAPI from './responses';
 import { OpenAI } from '../../client';
 
@@ -65,6 +65,135 @@ export class ResponsesWS extends ResponsesEmitter {
     }
   }
 
+  /**
+   * Returns an async iterator over WebSocket lifecycle and message events,
+   * providing an alternative to the event-based `.on()` API.
+   * The iterator will exit if the socket closes but breaking out of the iterator
+   * does not close the socket.
+   *
+   * @example
+   * ```ts
+   * for await (const event of connection.stream()) {
+   *   switch (event.type) {
+   *     case 'message':
+   *       console.log('received:', event.message);
+   *       break;
+   *     case 'error':
+   *       console.error(event.error);
+   *       break;
+   *     case 'close':
+   *       console.log('connection closed');
+   *       break;
+   *   }
+   * }
+   * ```
+   */
+  stream(): AsyncIterableIterator<ResponsesStreamMessage> {
+    return this[Symbol.asyncIterator]();
+  }
+
+  [Symbol.asyncIterator](): AsyncIterableIterator<ResponsesStreamMessage> {
+    // Two-queue async iterator: `queue` buffers incoming messages,
+    // `resolvers` buffers waiting next() calls. A push wakes the
+    // oldest next(); a next() drains the oldest message.
+    const queue: ResponsesStreamMessage[] = [];
+    const resolvers: (() => void)[] = [];
+    let done = false;
+
+    const push = (msg: ResponsesStreamMessage) => {
+      queue.push(msg);
+      resolvers.shift()?.();
+    };
+
+    const onEvent = (event: ResponsesAPI.ResponsesServerEvent) => {
+      if (event.type === 'error') return; // handled by onEmitterError
+      push({ type: 'message', message: event });
+    };
+
+    // Catches both API-level and socket-level errors via _onError → _emit('error')
+    const onEmitterError = (err: WebSocketError) => {
+      push({ type: 'error', error: err });
+    };
+
+    const onOpen = () => {
+      push({ type: 'open' });
+    };
+
+    const flushResolvers = () => {
+      for (let resolver = resolvers.shift(); resolver; resolver = resolvers.shift()) {
+        resolver();
+      }
+    };
+
+    const onClose = () => {
+      push({ type: 'close' });
+      done = true;
+      flushResolvers();
+      cleanup();
+    };
+
+    const cleanup = () => {
+      this.off('event', onEvent);
+      this.off('error', onEmitterError);
+      this.socket.off('open', onOpen);
+      this.socket.off('close', onClose);
+    };
+
+    this.on('event', onEvent);
+    this.on('error', onEmitterError);
+    this.socket.on('open', onOpen);
+    this.socket.on('close', onClose);
+
+    switch (this.socket.readyState) {
+      case WS.WebSocket.CONNECTING:
+        push({ type: 'connecting' });
+        break;
+      case WS.WebSocket.OPEN:
+        push({ type: 'open' });
+        break;
+      case WS.WebSocket.CLOSING:
+        push({ type: 'closing' });
+        break;
+      case WS.WebSocket.CLOSED:
+        push({ type: 'close' });
+        done = true;
+        cleanup();
+        break;
+    }
+
+    const resolve = (res: (value: IteratorResult<ResponsesStreamMessage>) => void) => {
+      if (queue.length > 0) {
+        res({ value: queue.shift()!, done: false });
+      } else if (done) {
+        res({ value: undefined, done: true });
+      } else {
+        return false;
+      }
+      return true;
+    };
+
+    const next = (): Promise<IteratorResult<ResponsesStreamMessage>> =>
+      new Promise((res) => {
+        if (resolve(res)) return;
+        resolvers.push(() => {
+          resolve(res);
+        });
+      });
+
+    return {
+      next,
+      return: (): Promise<IteratorReturnResult<undefined>> => {
+        done = true;
+        cleanup();
+        flushResolvers();
+        return Promise.resolve({ value: undefined, done: true });
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+    };
+  }
+
   private authHeaders(): Record<string, string> {
     return { Authorization: `Bearer ${this.client.apiKey}` };
     return {};

package/src/resources/shared.ts

@@ -248,6 +248,8 @@ export type FunctionParameters = { [key: string]: unknown };
  */
 export type Metadata = { [key: string]: string };
 
+export type OAuthErrorCode = 'invalid_grant' | 'invalid_subject_token' | (string & {});
+
 /**
  * **gpt-5 and o-series models only**
  *

package/src/resources/vector-stores/file-batches.ts

@@ -274,8 +274,9 @@ export interface FileBatchCreateParams {
    * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
    * the vector store should use. Useful for tools like `file_search` that can access
    * files. If `attributes` or `chunking_strategy` are provided, they will be applied
-   * to all files in the batch. The maximum batch size is 2000 files. Mutually
-   * exclusive with `files`.
+   * to all files in the batch. The maximum batch size is 2000 files. This endpoint
+   * is recommended for multi-file ingestion and helps reduce per-vector-store write
+   * request pressure. Mutually exclusive with `files`.
    */
   file_ids?: Array<string>;
 
@@ -283,8 +284,9 @@ export interface FileBatchCreateParams {
    * A list of objects that each include a `file_id` plus optional `attributes` or
    * `chunking_strategy`. Use this when you need to override metadata for specific
    * files. The global `attributes` or `chunking_strategy` will be ignored and must
-   * be specified for each file. The maximum batch size is 2000 files. Mutually
-   * exclusive with `file_ids`.
+   * be specified for each file. The maximum batch size is 2000 files. This endpoint
+   * is recommended for multi-file ingestion and helps reduce per-vector-store write
+   * request pressure. Mutually exclusive with `file_ids`.
    */
   files?: Array<FileBatchCreateParams.File>;
 }
@@ -294,7 +296,9 @@ export namespace FileBatchCreateParams {
     /**
      * A [File](https://platform.openai.com/docs/api-reference/files) ID that the
      * vector store should use. Useful for tools like `file_search` that can access
-     * files.
+     * files. For multi-file ingestion, we recommend
+     * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+     * to minimize per-vector-store write requests.
      */
     file_id: string;
 

package/src/resources/vector-stores/files.ts

@@ -299,7 +299,9 @@ export interface FileCreateParams {
   /**
    * A [File](https://platform.openai.com/docs/api-reference/files) ID that the
    * vector store should use. Useful for tools like `file_search` that can access
-   * files.
+   * files. For multi-file ingestion, we recommend
+   * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+   * to minimize per-vector-store write requests.
    */
   file_id: string;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.32.0'; // x-release-please-version
+export const VERSION = '6.34.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.32.0";
+export declare const VERSION = "6.34.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.32.0";
+export declare const VERSION = "6.34.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.32.0'; // x-release-please-version
+exports.VERSION = '6.34.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.32.0'; // x-release-please-version
+export const VERSION = '6.34.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map