@nocobase/plugin-ai 2.1.7 → 2.1.8

package/dist/node_modules/openai/src/resources/responses/responses.ts

@@ -39,13 +39,18 @@ export type ParsedResponseOutputItem<ParsedT> =
   | ParsedResponseOutputMessage<ParsedT>
   | ParsedResponseFunctionToolCall
   | ResponseFileSearchToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
+  | ResponseToolSearchCall
+  | ResponseToolSearchOutputItem
   | ResponseReasoningItem
   | ResponseCompactionItem
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
@@ -53,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>>;
@@ -99,9 +106,12 @@ export class Responses extends APIResource {
     options?: RequestOptions,
   ): APIPromise<Response> | APIPromise<Stream<ResponseStreamEvent>> {
     return (
-      this._client.post('/responses', { body, ...options, stream: body.stream ?? false }) as
-        | APIPromise<Response>
-        | APIPromise<Stream<ResponseStreamEvent>>
+      this._client.post('/responses', {
+        body,
+        ...options,
+        stream: body.stream ?? false,
+        __security: { bearerAuth: true },
+      }) as APIPromise<Response> | APIPromise<Stream<ResponseStreamEvent>>
     )._thenUnwrap((rsp) => {
       if ('object' in rsp && rsp.object === 'response') {
         addOutputText(rsp as Response);
@@ -146,6 +156,7 @@ export class Responses extends APIResource {
         query,
         ...options,
         stream: query?.stream ?? false,
+        __security: { bearerAuth: true },
       }) as APIPromise<Response> | APIPromise<Stream<ResponseStreamEvent>>
     )._thenUnwrap((rsp) => {
       if ('object' in rsp && rsp.object === 'response') {
@@ -170,6 +181,7 @@ export class Responses extends APIResource {
     return this._client.delete(path`/responses/${responseID}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      __security: { bearerAuth: true },
     });
   }
 
@@ -205,21 +217,29 @@ export class Responses extends APIResource {
    * ```
    */
   cancel(responseID: string, options?: RequestOptions): APIPromise<Response> {
-    return this._client.post(path`/responses/${responseID}/cancel`, options);
+    return this._client.post(path`/responses/${responseID}/cancel`, {
+      ...options,
+      __security: { bearerAuth: true },
+    });
   }
 
   /**
-   * Compact conversation
+   * Compact a conversation. Returns a compacted response object.
+   *
+   * Learn when and how to compact long-running conversations in the
+   * [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+   * For ZDR-compatible compaction details, see
+   * [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
    *
    * @example
    * ```ts
    * const compactedResponse = await client.responses.compact({
-   *   model: 'gpt-5.2',
+   *   model: 'gpt-5.4',
    * });
    * ```
    */
   compact(body: ResponseCompactParams, options?: RequestOptions): APIPromise<CompactedResponse> {
-    return this._client.post('/responses/compact', { body, ...options });
+    return this._client.post('/responses/compact', { body, ...options, __security: { bearerAuth: true } });
   }
 }
 
@@ -264,11 +284,264 @@ export interface CompactedResponse {
   usage: ResponseUsage;
 }
 
+/**
+ * A click action.
+ */
+export type ComputerAction =
+  | ComputerAction.Click
+  | ComputerAction.DoubleClick
+  | ComputerAction.Drag
+  | ComputerAction.Keypress
+  | ComputerAction.Move
+  | ComputerAction.Screenshot
+  | ComputerAction.Scroll
+  | ComputerAction.Type
+  | ComputerAction.Wait;
+
+export namespace ComputerAction {
+  /**
+   * A click action.
+   */
+  export interface Click {
+    /**
+     * Indicates which mouse button was pressed during the click. One of `left`,
+     * `right`, `wheel`, `back`, or `forward`.
+     */
+    button: 'left' | 'right' | 'wheel' | 'back' | 'forward';
+
+    /**
+     * Specifies the event type. For a click action, this property is always `click`.
+     */
+    type: 'click';
+
+    /**
+     * The x-coordinate where the click occurred.
+     */
+    x: number;
+
+    /**
+     * 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`.
+     */
+    type: 'double_click';
+
+    /**
+     * The x-coordinate where the double click occurred.
+     */
+    x: number;
+
+    /**
+     * The y-coordinate where the double click occurred.
+     */
+    y: number;
+  }
+
+  /**
+   * A drag action.
+   */
+  export interface Drag {
+    /**
+     * An array of coordinates representing the path of the drag action. Coordinates
+     * will appear as an array of objects, eg
+     *
+     * ```
+     * [
+     *   { x: 100, y: 200 },
+     *   { x: 200, y: 300 }
+     * ]
+     * ```
+     */
+    path: Array<Drag.Path>;
+
+    /**
+     * Specifies the event type. For a drag action, this property is always set to
+     * `drag`.
+     */
+    type: 'drag';
+
+    /**
+     * The keys being held while dragging the mouse.
+     */
+    keys?: Array<string> | null;
+  }
+
+  export namespace Drag {
+    /**
+     * An x/y coordinate pair, e.g. `{ x: 100, y: 200 }`.
+     */
+    export interface Path {
+      /**
+       * The x-coordinate.
+       */
+      x: number;
+
+      /**
+       * The y-coordinate.
+       */
+      y: number;
+    }
+  }
+
+  /**
+   * A collection of keypresses the model would like to perform.
+   */
+  export interface Keypress {
+    /**
+     * The combination of keys the model is requesting to be pressed. This is an array
+     * of strings, each representing a key.
+     */
+    keys: Array<string>;
+
+    /**
+     * Specifies the event type. For a keypress action, this property is always set to
+     * `keypress`.
+     */
+    type: 'keypress';
+  }
+
+  /**
+   * A mouse move action.
+   */
+  export interface Move {
+    /**
+     * Specifies the event type. For a move action, this property is always set to
+     * `move`.
+     */
+    type: 'move';
+
+    /**
+     * The x-coordinate to move to.
+     */
+    x: number;
+
+    /**
+     * The y-coordinate to move to.
+     */
+    y: number;
+
+    /**
+     * The keys being held while moving the mouse.
+     */
+    keys?: Array<string> | null;
+  }
+
+  /**
+   * A screenshot action.
+   */
+  export interface Screenshot {
+    /**
+     * Specifies the event type. For a screenshot action, this property is always set
+     * to `screenshot`.
+     */
+    type: 'screenshot';
+  }
+
+  /**
+   * A scroll action.
+   */
+  export interface Scroll {
+    /**
+     * The horizontal scroll distance.
+     */
+    scroll_x: number;
+
+    /**
+     * The vertical scroll distance.
+     */
+    scroll_y: number;
+
+    /**
+     * Specifies the event type. For a scroll action, this property is always set to
+     * `scroll`.
+     */
+    type: 'scroll';
+
+    /**
+     * The x-coordinate where the scroll occurred.
+     */
+    x: number;
+
+    /**
+     * The y-coordinate where the scroll occurred.
+     */
+    y: number;
+
+    /**
+     * The keys being held while scrolling.
+     */
+    keys?: Array<string> | null;
+  }
+
+  /**
+   * An action to type in text.
+   */
+  export interface Type {
+    /**
+     * The text to type.
+     */
+    text: string;
+
+    /**
+     * Specifies the event type. For a type action, this property is always set to
+     * `type`.
+     */
+    type: 'type';
+  }
+
+  /**
+   * A wait action.
+   */
+  export interface Wait {
+    /**
+     * Specifies the event type. For a wait action, this property is always set to
+     * `wait`.
+     */
+    type: 'wait';
+  }
+}
+
+/**
+ * Flattened batched actions for `computer_use`. Each action includes an `type`
+ * discriminator and action-specific fields.
+ */
+export type ComputerActionList = Array<ComputerAction>;
+
 /**
  * A tool that controls a virtual computer. Learn more about the
  * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
  */
 export interface ComputerTool {
+  /**
+   * The type of the computer tool. Always `computer`.
+   */
+  type: 'computer';
+}
+
+/**
+ * A tool that controls a virtual computer. Learn more about the
+ * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+ */
+export interface ComputerUsePreviewTool {
   /**
    * The height of the computer display.
    */
@@ -385,6 +658,11 @@ export interface CustomTool {
    */
   type: 'custom';
 
+  /**
+   * Whether this tool should be deferred and discovered via tool search.
+   */
+  defer_loading?: boolean;
+
   /**
    * Optional description of the custom tool, used to provide more context.
    */
@@ -416,6 +694,14 @@ export interface EasyInputMessage {
    */
   role: 'user' | 'assistant' | 'system' | 'developer';
 
+  /**
+   * Labels an `assistant` message as intermediate commentary (`commentary`) or the
+   * final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+   * sending follow-up requests, preserve and resend phase on all assistant messages
+   * — dropping it can degrade performance. Not used for user messages.
+   */
+  phase?: 'commentary' | 'final_answer' | null;
+
   /**
    * The type of the message input. Always `message`.
    */
@@ -536,6 +822,11 @@ export interface FunctionTool {
    */
   type: 'function';
 
+  /**
+   * Whether this function is deferred and loaded via tool search.
+   */
+  defer_loading?: boolean;
+
   /**
    * A description of the function. Used by the model to determine whether or not to
    * call the function.
@@ -614,28 +905,72 @@ export interface LocalSkill {
   path: string;
 }
 
-export interface Response {
+/**
+ * Groups function/custom tools under a shared namespace.
+ */
+export interface NamespaceTool {
   /**
-   * Unique identifier for this Response.
+   * A description of the namespace shown to the model.
    */
-  id: string;
+  description: string;
 
   /**
-   * Unix timestamp (in seconds) of when this Response was created.
+   * The namespace name used in tool calls (for example, `crm`).
    */
-  created_at: number;
-
-  output_text: string;
+  name: string;
 
   /**
-   * An error object returned when the model fails to generate a Response.
+   * The function/custom tools available inside this namespace.
    */
-  error: ResponseError | null;
+  tools: Array<NamespaceTool.Function | CustomTool>;
 
   /**
-   * Details about why the response is incomplete.
+   * The type of the tool. Always `namespace`.
    */
-  incomplete_details: Response.IncompleteDetails | null;
+  type: 'namespace';
+}
+
+export namespace NamespaceTool {
+  export interface Function {
+    name: string;
+
+    type: 'function';
+
+    /**
+     * Whether this function should be deferred and discovered via tool search.
+     */
+    defer_loading?: boolean;
+
+    description?: string | null;
+
+    parameters?: unknown | null;
+
+    strict?: boolean | null;
+  }
+}
+
+export interface Response {
+  /**
+   * Unique identifier for this Response.
+   */
+  id: string;
+
+  /**
+   * Unix timestamp (in seconds) of when this Response was created.
+   */
+  created_at: number;
+
+  output_text: string;
+
+  /**
+   * An error object returned when the model fails to generate a Response.
+   */
+  error: ResponseError | null;
+
+  /**
+   * Details about why the response is incomplete.
+   */
+  incomplete_details: Response.IncompleteDetails | null;
 
   /**
    * A system (or developer) message inserted into the model's context.
@@ -793,7 +1128,7 @@ export interface Response {
    * of 24 hours.
    * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
    */
-  prompt_cache_retention?: 'in-memory' | '24h' | null;
+  prompt_cache_retention?: 'in_memory' | '24h' | null;
 
   /**
    * **gpt-5 and o-series models only**
@@ -806,8 +1141,9 @@ export interface Response {
   /**
    * A stable identifier used to help detect users of your application that may be
    * violating OpenAI's usage policies. The IDs should be a string that uniquely
-   * identifies each user. We recommend hashing their username or email address, in
-   * order to avoid sending us any identifying information.
+   * identifies each user, with a maximum length of 64 characters. We recommend
+   * hashing their username or email address, in order to avoid sending us any
+   * identifying information.
    * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
    */
   safety_identifier?: string;
@@ -846,6 +1182,13 @@ export interface Response {
    */
   text?: ResponseTextConfig;
 
+  /**
+   * An integer between 0 and 20 specifying the maximum number of most likely tokens
+   * to return at each token position, each with an associated log probability. In
+   * some cases, the number of returned tokens may be fewer than requested.
+   */
+  top_logprobs?: number | null;
+
   /**
    * The truncation strategy to use for the model response.
    *
@@ -1386,20 +1729,6 @@ export interface ResponseComputerToolCall {
    */
   id: string;
 
-  /**
-   * A click action.
-   */
-  action:
-    | ResponseComputerToolCall.Click
-    | ResponseComputerToolCall.DoubleClick
-    | ResponseComputerToolCall.Drag
-    | ResponseComputerToolCall.Keypress
-    | ResponseComputerToolCall.Move
-    | ResponseComputerToolCall.Screenshot
-    | ResponseComputerToolCall.Scroll
-    | ResponseComputerToolCall.Type
-    | ResponseComputerToolCall.Wait;
-
   /**
    * An identifier used when responding to the tool call with output.
    */
@@ -1420,9 +1749,49 @@ export interface ResponseComputerToolCall {
    * The type of the computer call. Always `computer_call`.
    */
   type: 'computer_call';
+
+  /**
+   * A click action.
+   */
+  action?:
+    | ResponseComputerToolCall.Click
+    | ResponseComputerToolCall.DoubleClick
+    | ResponseComputerToolCall.Drag
+    | ResponseComputerToolCall.Keypress
+    | ResponseComputerToolCall.Move
+    | ResponseComputerToolCall.Screenshot
+    | ResponseComputerToolCall.Scroll
+    | ResponseComputerToolCall.Type
+    | ResponseComputerToolCall.Wait;
+
+  /**
+   * Flattened batched actions for `computer_use`. Each action includes an `type`
+   * discriminator and action-specific fields.
+   */
+  actions?: ComputerActionList;
 }
 
 export namespace ResponseComputerToolCall {
+  /**
+   * A pending safety check for the computer call.
+   */
+  export interface PendingSafetyCheck {
+    /**
+     * The ID of the pending safety check.
+     */
+    id: string;
+
+    /**
+     * The type of the pending safety check.
+     */
+    code?: string | null;
+
+    /**
+     * Details about the pending safety check.
+     */
+    message?: string | null;
+  }
+
   /**
    * A click action.
    */
@@ -1447,12 +1816,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`.
@@ -1492,6 +1871,11 @@ export namespace ResponseComputerToolCall {
      * `drag`.
      */
     type: 'drag';
+
+    /**
+     * The keys being held while dragging the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   export namespace Drag {
@@ -1547,6 +1931,11 @@ export namespace ResponseComputerToolCall {
      * The y-coordinate to move to.
      */
     y: number;
+
+    /**
+     * The keys being held while moving the mouse.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -1589,6 +1978,11 @@ export namespace ResponseComputerToolCall {
      * The y-coordinate where the scroll occurred.
      */
     y: number;
+
+    /**
+     * The keys being held while scrolling.
+     */
+    keys?: Array<string> | null;
   }
 
   /**
@@ -1617,26 +2011,6 @@ export namespace ResponseComputerToolCall {
      */
     type: 'wait';
   }
-
-  /**
-   * A pending safety check for the computer call.
-   */
-  export interface PendingSafetyCheck {
-    /**
-     * The ID of the pending safety check.
-     */
-    id: string;
-
-    /**
-     * The type of the pending safety check.
-     */
-    code?: string | null;
-
-    /**
-     * Details about the pending safety check.
-     */
-    message?: string | null;
-  }
 }
 
 export interface ResponseComputerToolCallOutputItem {
@@ -1655,6 +2029,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`.
    */
@@ -1667,10 +2047,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 {
@@ -1918,6 +2297,11 @@ export interface ResponseCustomToolCall {
    * The unique ID of the custom tool call in the OpenAI platform.
    */
   id?: string;
+
+  /**
+   * The namespace of the custom tool being called.
+   */
+  namespace?: string;
 }
 
 /**
@@ -1980,6 +2364,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.
  */
@@ -2006,6 +2411,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.
  */
@@ -2601,6 +3027,11 @@ export interface ResponseFunctionToolCall {
    */
   id?: string;
 
+  /**
+   * The namespace of the function to run.
+   */
+  namespace?: string;
+
   /**
    * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
    * Populated when items are returned via API.
@@ -2618,6 +3049,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 {
@@ -2637,16 +3079,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;
 }
 
 /**
@@ -2896,6 +3343,8 @@ export interface ResponseInProgressEvent {
  * Specify additional output data to include in the model response. Currently
  * supported values are:
  *
+ * - `web_search_call.results`: Include the search results of the web search tool
+ *   call.
  * - `web_search_call.action.sources`: Include the sources of the web search tool
  *   call.
  * - `code_interpreter_call.outputs`: Includes the outputs of python code execution
@@ -2991,6 +3440,13 @@ export interface ResponseInputFile {
    */
   type: 'input_file';
 
+  /**
+   * The detail level of the file to be sent to the model. Use `low` for the default
+   * rendering behavior, or `high` to render the file at higher quality. Defaults to
+   * `low`.
+   */
+  detail?: 'low' | 'high';
+
   /**
    * The content of the file to be sent to the model.
    */
@@ -3021,6 +3477,13 @@ export interface ResponseInputFileContent {
    */
   type: 'input_file';
 
+  /**
+   * The detail level of the file to be sent to the model. Use `low` for the default
+   * rendering behavior, or `high` to render the file at higher quality. Defaults to
+   * `low`.
+   */
+  detail?: 'low' | 'high';
+
   /**
    * The base64-encoded data of the file to be sent to the model.
    */
@@ -3048,10 +3511,10 @@ export interface ResponseInputFileContent {
  */
 export interface ResponseInputImage {
   /**
-   * The detail level of the image to be sent to the model. One of `high`, `low`, or
-   * `auto`. Defaults to `auto`.
+   * The detail level of the image to be sent to the model. One of `high`, `low`,
+   * `auto`, or `original`. Defaults to `auto`.
    */
-  detail: 'low' | 'high' | 'auto';
+  detail: 'low' | 'high' | 'auto' | 'original';
 
   /**
    * The type of the input item. Always `input_image`.
@@ -3081,10 +3544,10 @@ export interface ResponseInputImageContent {
   type: 'input_image';
 
   /**
-   * The detail level of the image to be sent to the model. One of `high`, `low`, or
-   * `auto`. Defaults to `auto`.
+   * The detail level of the image to be sent to the model. One of `high`, `low`,
+   * `auto`, or `original`. Defaults to `auto`.
    */
-  detail?: 'low' | 'high' | 'auto' | null;
+  detail?: 'low' | 'high' | 'auto' | 'original' | null;
 
   /**
    * The ID of the file to be sent to the model.
@@ -3115,6 +3578,8 @@ export type ResponseInputItem =
   | ResponseFunctionWebSearch
   | ResponseFunctionToolCall
   | ResponseInputItem.FunctionCallOutput
+  | ResponseInputItem.ToolSearchCall
+  | ResponseToolSearchOutputItemParam
   | ResponseReasoningItem
   | ResponseCompactionItemParam
   | ResponseInputItem.ImageGenerationCall
@@ -3131,6 +3596,7 @@ export type ResponseInputItem =
   | ResponseInputItem.McpCall
   | ResponseCustomToolCallOutput
   | ResponseCustomToolCall
+  | ResponseInputItem.CompactionTrigger
   | ResponseInputItem.ItemReference;
 
 export namespace ResponseInputItem {
@@ -3254,6 +3720,38 @@ export namespace ResponseInputItem {
     status?: 'in_progress' | 'completed' | 'incomplete' | null;
   }
 
+  export interface ToolSearchCall {
+    /**
+     * The arguments supplied to the tool search call.
+     */
+    arguments: unknown;
+
+    /**
+     * The item type. Always `tool_search_call`.
+     */
+    type: 'tool_search_call';
+
+    /**
+     * The unique ID of this tool search call.
+     */
+    id?: string | null;
+
+    /**
+     * The unique ID of the tool search call generated by the model.
+     */
+    call_id?: string | null;
+
+    /**
+     * Whether tool search was executed by the server or by the client.
+     */
+    execution?: 'server' | 'client';
+
+    /**
+     * The status of the tool search call.
+     */
+    status?: 'in_progress' | 'completed' | 'incomplete' | null;
+  }
+
   /**
    * An image generation request made by the model.
    */
@@ -3761,6 +4259,16 @@ export namespace ResponseInputItem {
     status?: 'in_progress' | 'completed' | 'incomplete' | 'calling' | 'failed';
   }
 
+  /**
+   * Compacts the current context. Must be the final input item.
+   */
+  export interface CompactionTrigger {
+    /**
+     * The type of the item. Always `compaction_trigger`.
+     */
+    type: 'compaction_trigger';
+  }
+
   /**
    * An internal identifier for an item to reference.
    */
@@ -3801,15 +4309,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';
 }
 
 /**
@@ -3854,6 +4362,10 @@ export type ResponseItem =
   | ResponseFunctionWebSearch
   | ResponseFunctionToolCallItem
   | ResponseFunctionToolCallOutputItem
+  | ResponseToolSearchCall
+  | ResponseToolSearchOutputItem
+  | ResponseReasoningItem
+  | ResponseCompactionItem
   | ResponseItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseItem.LocalShellCall
@@ -3865,7 +4377,9 @@ export type ResponseItem =
   | ResponseItem.McpListTools
   | ResponseItem.McpApprovalRequest
   | ResponseItem.McpApprovalResponse
-  | ResponseItem.McpCall;
+  | ResponseItem.McpCall
+  | ResponseCustomToolCallItem
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseItem {
   /**
@@ -4406,13 +4920,18 @@ export type ResponseOutputItem =
   | ResponseOutputMessage
   | ResponseFileSearchToolCall
   | ResponseFunctionToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
   | ResponseReasoningItem
+  | ResponseToolSearchCall
+  | ResponseToolSearchOutputItem
   | ResponseCompactionItem
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
@@ -4420,7 +4939,9 @@ export type ResponseOutputItem =
   | ResponseOutputItem.McpCall
   | ResponseOutputItem.McpListTools
   | ResponseOutputItem.McpApprovalRequest
-  | ResponseCustomToolCall;
+  | ResponseOutputItem.McpApprovalResponse
+  | ResponseCustomToolCall
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseOutputItem {
   /**
@@ -4516,16 +5037,41 @@ export namespace ResponseOutputItem {
   }
 
   /**
-   * An invocation of a tool on an MCP server.
+   * The output of a local shell tool call.
    */
-  export interface McpCall {
+  export interface LocalShellCallOutput {
     /**
-     * The unique ID of the tool call.
+     * The unique ID of the local shell tool call generated by the model.
      */
     id: string;
 
     /**
-     * A JSON string of the arguments passed to the tool.
+     * 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.
+   */
+  export interface McpCall {
+    /**
+     * The unique ID of the tool call.
+     */
+    id: string;
+
+    /**
+     * A JSON string of the arguments passed to the tool.
      */
     arguments: string;
 
@@ -4654,6 +5200,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;
+  }
 }
 
 /**
@@ -4735,6 +5311,14 @@ export interface ResponseOutputMessage {
    * The type of the output message. Always `message`.
    */
   type: 'message';
+
+  /**
+   * Labels an `assistant` message as intermediate commentary (`commentary`) or the
+   * final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+   * sending follow-up requests, preserve and resend phase on all assistant messages
+   * — dropping it can degrade performance. Not used for user messages.
+   */
+  phase?: 'commentary' | 'final_answer' | null;
 }
 
 /**
@@ -5541,7 +6125,7 @@ export namespace ResponseTextDeltaEvent {
     logprob: number;
 
     /**
-     * The log probability of the top 20 most likely tokens.
+     * The log probabilities of up to 20 of the most likely tokens.
      */
     top_logprobs?: Array<Logprob.TopLogprob>;
   }
@@ -5619,7 +6203,7 @@ export namespace ResponseTextDoneEvent {
     logprob: number;
 
     /**
-     * The log probability of the top 20 most likely tokens.
+     * The log probabilities of up to 20 of the most likely tokens.
      */
     top_logprobs?: Array<Logprob.TopLogprob>;
   }
@@ -5639,6 +6223,112 @@ export namespace ResponseTextDoneEvent {
   }
 }
 
+export interface ResponseToolSearchCall {
+  /**
+   * The unique ID of the tool search call item.
+   */
+  id: string;
+
+  /**
+   * Arguments used for the tool search call.
+   */
+  arguments: unknown;
+
+  /**
+   * The unique ID of the tool search call generated by the model.
+   */
+  call_id: string | null;
+
+  /**
+   * Whether tool search was executed by the server or by the client.
+   */
+  execution: 'server' | 'client';
+
+  /**
+   * The status of the tool search call item that was recorded.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The type of the item. Always `tool_search_call`.
+   */
+  type: 'tool_search_call';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
+export interface ResponseToolSearchOutputItem {
+  /**
+   * The unique ID of the tool search output item.
+   */
+  id: string;
+
+  /**
+   * The unique ID of the tool search call generated by the model.
+   */
+  call_id: string | null;
+
+  /**
+   * Whether tool search was executed by the server or by the client.
+   */
+  execution: 'server' | 'client';
+
+  /**
+   * The status of the tool search output item that was recorded.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The loaded tool definitions returned by tool search.
+   */
+  tools: Array<Tool>;
+
+  /**
+   * The type of the item. Always `tool_search_output`.
+   */
+  type: 'tool_search_output';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
+export interface ResponseToolSearchOutputItemParam {
+  /**
+   * The loaded tool definitions returned by the tool search output.
+   */
+  tools: Array<Tool>;
+
+  /**
+   * The item type. Always `tool_search_output`.
+   */
+  type: 'tool_search_output';
+
+  /**
+   * The unique ID of this tool search output.
+   */
+  id?: string | null;
+
+  /**
+   * The unique ID of the tool search call generated by the model.
+   */
+  call_id?: string | null;
+
+  /**
+   * Whether tool search was executed by the server or by the client.
+   */
+  execution?: 'server' | 'client';
+
+  /**
+   * The status of the tool search output.
+   */
+  status?: 'in_progress' | 'completed' | 'incomplete' | null;
+}
+
 /**
  * Represents token usage details including input tokens, output tokens, a
  * breakdown of output tokens, and the total tokens used.
@@ -5674,100 +6364,475 @@ export namespace ResponseUsage {
   /**
    * A detailed breakdown of the input tokens.
    */
-  export interface InputTokensDetails {
-    /**
-     * The number of tokens that were retrieved from the cache.
-     * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
-     */
-    cached_tokens: number;
-  }
+  export interface InputTokensDetails {
+    /**
+     * The number of tokens that were retrieved from the cache.
+     * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+     */
+    cached_tokens: number;
+  }
+
+  /**
+   * A detailed breakdown of the output tokens.
+   */
+  export interface OutputTokensDetails {
+    /**
+     * The number of reasoning tokens.
+     */
+    reasoning_tokens: number;
+  }
+}
+
+/**
+ * Emitted when a web search call is completed.
+ */
+export interface ResponseWebSearchCallCompletedEvent {
+  /**
+   * Unique ID for the output item associated with the web search call.
+   */
+  item_id: string;
+
+  /**
+   * The index of the output item that the web search call is associated with.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the web search call being processed.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event. Always `response.web_search_call.completed`.
+   */
+  type: 'response.web_search_call.completed';
+}
+
+/**
+ * Emitted when a web search call is initiated.
+ */
+export interface ResponseWebSearchCallInProgressEvent {
+  /**
+   * Unique ID for the output item associated with the web search call.
+   */
+  item_id: string;
+
+  /**
+   * The index of the output item that the web search call is associated with.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the web search call being processed.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event. Always `response.web_search_call.in_progress`.
+   */
+  type: 'response.web_search_call.in_progress';
+}
+
+/**
+ * Emitted when a web search call is executing.
+ */
+export interface ResponseWebSearchCallSearchingEvent {
+  /**
+   * Unique ID for the output item associated with the web search call.
+   */
+  item_id: string;
+
+  /**
+   * The index of the output item that the web search call is associated with.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the web search call being processed.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event. Always `response.web_search_call.searching`.
+   */
+  type: 'response.web_search_call.searching';
+}
+
+export interface ResponsesClientEvent {
+  /**
+   * The type of the client event. Always `response.create`.
+   */
+  type: 'response.create';
+
+  /**
+   * Whether to run the model response in the background.
+   * [Learn more](https://platform.openai.com/docs/guides/background).
+   */
+  background?: boolean | null;
+
+  /**
+   * Context management configuration for this request.
+   */
+  context_management?: Array<ResponsesClientEvent.ContextManagement> | null;
+
+  /**
+   * The conversation that this response belongs to. Items from this conversation are
+   * prepended to `input_items` for this response request. Input items and output
+   * items from this response are automatically added to this conversation after this
+   * response completes.
+   */
+  conversation?: string | ResponseConversationParam | null;
+
+  /**
+   * Specify additional output data to include in the model response. Currently
+   * supported values are:
+   *
+   * - `web_search_call.action.sources`: Include the sources of the web search tool
+   *   call.
+   * - `code_interpreter_call.outputs`: Includes the outputs of python code execution
+   *   in code interpreter tool call items.
+   * - `computer_call_output.output.image_url`: Include image urls from the computer
+   *   call output.
+   * - `file_search_call.results`: Include the search results of the file search tool
+   *   call.
+   * - `message.input_image.image_url`: Include image urls from the input message.
+   * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+   * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning
+   *   tokens in reasoning item outputs. This enables reasoning items to be used in
+   *   multi-turn conversations when using the Responses API statelessly (like when
+   *   the `store` parameter is set to `false`, or when an organization is enrolled
+   *   in the zero data retention program).
+   */
+  include?: Array<ResponseIncludable> | null;
+
+  /**
+   * Text, image, or file inputs to the model, used to generate a response.
+   *
+   * Learn more:
+   *
+   * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+   * - [Image inputs](https://platform.openai.com/docs/guides/images)
+   * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+   * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+   * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+   */
+  input?: string | ResponseInput;
+
+  /**
+   * A system (or developer) message inserted into the model's context.
+   *
+   * When using along with `previous_response_id`, the instructions from a previous
+   * response will not be carried over to the next response. This makes it simple to
+   * swap out system (or developer) messages in new responses.
+   */
+  instructions?: string | null;
+
+  /**
+   * An upper bound for the number of tokens that can be generated for a response,
+   * including visible output tokens and
+   * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+   */
+  max_output_tokens?: number | null;
+
+  /**
+   * The maximum number of total calls to built-in tools that can be processed in a
+   * response. This maximum number applies across all built-in tool calls, not per
+   * individual tool. Any further attempts to call a tool by the model will be
+   * ignored.
+   */
+  max_tool_calls?: number | null;
+
+  /**
+   * Set of 16 key-value pairs that can be attached to an object. This can be useful
+   * for storing additional information about the object in a structured format, and
+   * querying for objects via API or the dashboard.
+   *
+   * Keys are strings with a maximum length of 64 characters. Values are strings with
+   * a maximum length of 512 characters.
+   */
+  metadata?: Shared.Metadata | null;
+
+  /**
+   * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
+   * wide range of models with different capabilities, performance characteristics,
+   * and price points. Refer to the
+   * [model guide](https://platform.openai.com/docs/models) to browse and compare
+   * available models.
+   */
+  model?: Shared.ResponsesModel;
+
+  /**
+   * Whether to allow the model to run tool calls in parallel.
+   */
+  parallel_tool_calls?: boolean | null;
+
+  /**
+   * The unique ID of the previous response to the model. Use this to create
+   * multi-turn conversations. Learn more about
+   * [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+   * Cannot be used in conjunction with `conversation`.
+   */
+  previous_response_id?: string | null;
+
+  /**
+   * Reference to a prompt template and its variables.
+   * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+   */
+  prompt?: ResponsePrompt | null;
+
+  /**
+   * Used by OpenAI to cache responses for similar requests to optimize your cache
+   * hit rates. Replaces the `user` field.
+   * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+   */
+  prompt_cache_key?: string;
+
+  /**
+   * The retention policy for the prompt cache. Set to `24h` to enable extended
+   * prompt caching, which keeps cached prefixes active for longer, up to a maximum
+   * of 24 hours.
+   * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+   */
+  prompt_cache_retention?: 'in_memory' | '24h' | null;
+
+  /**
+   * **gpt-5 and o-series models only**
+   *
+   * Configuration options for
+   * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+   */
+  reasoning?: Shared.Reasoning | null;
+
+  /**
+   * A stable identifier used to help detect users of your application that may be
+   * violating OpenAI's usage policies. The IDs should be a string that uniquely
+   * identifies each user, with a maximum length of 64 characters. We recommend
+   * hashing their username or email address, in order to avoid sending us any
+   * identifying information.
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+   */
+  safety_identifier?: string;
 
   /**
-   * A detailed breakdown of the output tokens.
+   * Specifies the processing type used for serving the request.
+   *
+   * - If set to 'auto', then the request will be processed with the service tier
+   *   configured in the Project settings. Unless otherwise configured, the Project
+   *   will use 'default'.
+   * - If set to 'default', then the request will be processed with the standard
+   *   pricing and performance for the selected model.
+   * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+   *   '[priority](https://openai.com/api-priority-processing/)', then the request
+   *   will be processed with the corresponding service tier.
+   * - When not set, the default behavior is 'auto'.
+   *
+   * When the `service_tier` parameter is set, the response body will include the
+   * `service_tier` value based on the processing mode actually used to serve the
+   * request. This response value may be different from the value set in the
+   * parameter.
    */
-  export interface OutputTokensDetails {
-    /**
-     * The number of reasoning tokens.
-     */
-    reasoning_tokens: number;
-  }
-}
+  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority' | null;
 
-/**
- * Emitted when a web search call is completed.
- */
-export interface ResponseWebSearchCallCompletedEvent {
   /**
-   * Unique ID for the output item associated with the web search call.
+   * Whether to store the generated model response for later retrieval via API.
    */
-  item_id: string;
+  store?: boolean | null;
 
   /**
-   * The index of the output item that the web search call is associated with.
+   * If set to true, the model response data will be streamed to the client as it is
+   * generated using
+   * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
+   * See the
+   * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+   * for more information.
    */
-  output_index: number;
+  stream?: boolean | null;
 
   /**
-   * The sequence number of the web search call being processed.
+   * Options for streaming responses. Only set this when you set `stream: true`.
    */
-  sequence_number: number;
+  stream_options?: ResponsesClientEvent.StreamOptions | null;
 
   /**
-   * The type of the event. Always `response.web_search_call.completed`.
+   * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+   * make the output more random, while lower values like 0.2 will make it more
+   * focused and deterministic. We generally recommend altering this or `top_p` but
+   * not both.
    */
-  type: 'response.web_search_call.completed';
-}
+  temperature?: number | null;
 
-/**
- * Emitted when a web search call is initiated.
- */
-export interface ResponseWebSearchCallInProgressEvent {
   /**
-   * Unique ID for the output item associated with the web search call.
+   * Configuration options for a text response from the model. Can be plain text or
+   * structured JSON data. Learn more:
+   *
+   * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+   * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
    */
-  item_id: string;
+  text?: ResponseTextConfig;
 
   /**
-   * The index of the output item that the web search call is associated with.
+   * How the model should select which tool (or tools) to use when generating a
+   * response. See the `tools` parameter to see how to specify which tools the model
+   * can call.
    */
-  output_index: number;
+  tool_choice?:
+    | ToolChoiceOptions
+    | ToolChoiceAllowed
+    | ToolChoiceTypes
+    | ToolChoiceFunction
+    | ToolChoiceMcp
+    | ToolChoiceCustom
+    | ToolChoiceApplyPatch
+    | ToolChoiceShell;
 
   /**
-   * The sequence number of the web search call being processed.
+   * An array of tools the model may call while generating a response. You can
+   * specify which tool to use by setting the `tool_choice` parameter.
+   *
+   * We support the following categories of tools:
+   *
+   * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+   *   capabilities, like
+   *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+   *   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+   *   Learn more about
+   *   [built-in tools](https://platform.openai.com/docs/guides/tools).
+   * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+   *   predefined connectors such as Google Drive and SharePoint. Learn more about
+   *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+   * - **Function calls (custom tools)**: Functions that are defined by you, enabling
+   *   the model to call your own code with strongly typed arguments and outputs.
+   *   Learn more about
+   *   [function calling](https://platform.openai.com/docs/guides/function-calling).
+   *   You can also use custom tools to call your own code.
    */
-  sequence_number: number;
+  tools?: Array<Tool>;
 
   /**
-   * The type of the event. Always `response.web_search_call.in_progress`.
+   * An integer between 0 and 20 specifying the maximum number of most likely tokens
+   * to return at each token position, each with an associated log probability. In
+   * some cases, the number of returned tokens may be fewer than requested.
    */
-  type: 'response.web_search_call.in_progress';
-}
+  top_logprobs?: number | null;
 
-/**
- * Emitted when a web search call is executing.
- */
-export interface ResponseWebSearchCallSearchingEvent {
   /**
-   * Unique ID for the output item associated with the web search call.
+   * An alternative to sampling with temperature, called nucleus sampling, where the
+   * model considers the results of the tokens with top_p probability mass. So 0.1
+   * means only the tokens comprising the top 10% probability mass are considered.
+   *
+   * We generally recommend altering this or `temperature` but not both.
    */
-  item_id: string;
+  top_p?: number | null;
 
   /**
-   * The index of the output item that the web search call is associated with.
+   * The truncation strategy to use for the model response.
+   *
+   * - `auto`: If the input to this Response exceeds the model's context window size,
+   *   the model will truncate the response to fit the context window by dropping
+   *   items from the beginning of the conversation.
+   * - `disabled` (default): If the input size will exceed the context window size
+   *   for a model, the request will fail with a 400 error.
    */
-  output_index: number;
+  truncation?: 'auto' | 'disabled' | null;
 
   /**
-   * The sequence number of the web search call being processed.
+   * @deprecated This field is being replaced by `safety_identifier` and
+   * `prompt_cache_key`. Use `prompt_cache_key` instead to maintain caching
+   * optimizations. A stable identifier for your end-users. Used to boost cache hit
+   * rates by better bucketing similar requests and to help OpenAI detect and prevent
+   * abuse.
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
    */
-  sequence_number: number;
+  user?: string;
+}
+
+export namespace ResponsesClientEvent {
+  export interface ContextManagement {
+    /**
+     * The context management entry type. Currently only 'compaction' is supported.
+     */
+    type: string;
+
+    /**
+     * Token threshold at which compaction should be triggered for this entry.
+     */
+    compact_threshold?: number | null;
+  }
 
   /**
-   * The type of the event. Always `response.web_search_call.searching`.
+   * Options for streaming responses. Only set this when you set `stream: true`.
    */
-  type: 'response.web_search_call.searching';
+  export interface StreamOptions {
+    /**
+     * When true, stream obfuscation will be enabled. Stream obfuscation adds random
+     * characters to an `obfuscation` field on streaming delta events to normalize
+     * payload sizes as a mitigation to certain side-channel attacks. These obfuscation
+     * fields are included by default, but add a small amount of overhead to the data
+     * stream. You can set `include_obfuscation` to false to optimize for bandwidth if
+     * you trust the network links between your application and the OpenAI API.
+     */
+    include_obfuscation?: boolean;
+  }
 }
 
+/**
+ * Server events emitted by the Responses WebSocket server.
+ */
+export type ResponsesServerEvent =
+  | ResponseAudioDeltaEvent
+  | ResponseAudioDoneEvent
+  | ResponseAudioTranscriptDeltaEvent
+  | ResponseAudioTranscriptDoneEvent
+  | ResponseCodeInterpreterCallCodeDeltaEvent
+  | ResponseCodeInterpreterCallCodeDoneEvent
+  | ResponseCodeInterpreterCallCompletedEvent
+  | ResponseCodeInterpreterCallInProgressEvent
+  | ResponseCodeInterpreterCallInterpretingEvent
+  | ResponseCompletedEvent
+  | ResponseContentPartAddedEvent
+  | ResponseContentPartDoneEvent
+  | ResponseCreatedEvent
+  | ResponseErrorEvent
+  | ResponseFileSearchCallCompletedEvent
+  | ResponseFileSearchCallInProgressEvent
+  | ResponseFileSearchCallSearchingEvent
+  | ResponseFunctionCallArgumentsDeltaEvent
+  | ResponseFunctionCallArgumentsDoneEvent
+  | ResponseInProgressEvent
+  | ResponseFailedEvent
+  | ResponseIncompleteEvent
+  | ResponseOutputItemAddedEvent
+  | ResponseOutputItemDoneEvent
+  | ResponseReasoningSummaryPartAddedEvent
+  | ResponseReasoningSummaryPartDoneEvent
+  | ResponseReasoningSummaryTextDeltaEvent
+  | ResponseReasoningSummaryTextDoneEvent
+  | ResponseReasoningTextDeltaEvent
+  | ResponseReasoningTextDoneEvent
+  | ResponseRefusalDeltaEvent
+  | ResponseRefusalDoneEvent
+  | ResponseTextDeltaEvent
+  | ResponseTextDoneEvent
+  | ResponseWebSearchCallCompletedEvent
+  | ResponseWebSearchCallInProgressEvent
+  | ResponseWebSearchCallSearchingEvent
+  | ResponseImageGenCallCompletedEvent
+  | ResponseImageGenCallGeneratingEvent
+  | ResponseImageGenCallInProgressEvent
+  | ResponseImageGenCallPartialImageEvent
+  | ResponseMcpCallArgumentsDeltaEvent
+  | ResponseMcpCallArgumentsDoneEvent
+  | ResponseMcpCallCompletedEvent
+  | ResponseMcpCallFailedEvent
+  | ResponseMcpCallInProgressEvent
+  | ResponseMcpListToolsCompletedEvent
+  | ResponseMcpListToolsFailedEvent
+  | ResponseMcpListToolsInProgressEvent
+  | ResponseOutputTextAnnotationAddedEvent
+  | ResponseQueuedEvent
+  | ResponseCustomToolCallInputDeltaEvent
+  | ResponseCustomToolCallInputDoneEvent;
+
 export interface SkillReference {
   /**
    * The ID of the referenced skill.
@@ -5792,6 +6857,7 @@ export type Tool =
   | FunctionTool
   | FileSearchTool
   | ComputerTool
+  | ComputerUsePreviewTool
   | WebSearchTool
   | Tool.Mcp
   | Tool.CodeInterpreter
@@ -5799,6 +6865,8 @@ export type Tool =
   | Tool.LocalShell
   | FunctionShellTool
   | CustomTool
+  | NamespaceTool
+  | ToolSearchTool
   | WebSearchPreviewTool
   | ApplyPatchTool;
 
@@ -5858,6 +6926,11 @@ export namespace Tool {
       | 'connector_outlookemail'
       | 'connector_sharepoint';
 
+    /**
+     * Whether this MCP tool is deferred and discovered via tool search.
+     */
+    defer_loading?: boolean;
+
     /**
      * Optional HTTP headers to send to the MCP server. Use for authentication or other
      * purposes.
@@ -6017,8 +7090,18 @@ export namespace Tool {
     action?: 'generate' | 'edit' | 'auto';
 
     /**
-     * Background type for the generated image. One of `transparent`, `opaque`, or
-     * `auto`. Default: `auto`.
+     * Allows to set transparency for the background of the generated image(s). This
+     * parameter is only supported for GPT image models that support transparent
+     * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+     * When `auto` is used, the model will automatically determine the best background
+     * for the image.
+     *
+     * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+     * backgrounds. Requests with `background` set to `transparent` will return an
+     * error for these models; use `opaque` or `auto` instead.
+     *
+     * If `transparent`, the output format needs to support transparency, so it should
+     * be set to either `png` (default value) or `webp`.
      */
     background?: 'transparent' | 'opaque' | 'auto';
 
@@ -6039,7 +7122,14 @@ export namespace Tool {
     /**
      * The image generation model to use. Default: `gpt-image-1`.
      */
-    model?: (string & {}) | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5';
+    model?:
+      | (string & {})
+      | 'gpt-image-1'
+      | 'gpt-image-1-mini'
+      | 'gpt-image-2'
+      | 'gpt-image-2-2026-04-21'
+      | 'gpt-image-1.5'
+      | 'chatgpt-image-latest';
 
     /**
      * Moderation level for the generated image. Default: `auto`.
@@ -6070,10 +7160,19 @@ export namespace Tool {
     quality?: 'low' | 'medium' | 'high' | 'auto';
 
     /**
-     * The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-     * or `auto`. Default: `auto`.
+     * The size of the generated images. For `gpt-image-2` and
+     * `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
+     * strings, for example `1536x864`. Width and height must both be divisible by 16
+     * and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
+     * `2560x1440` are experimental, and the maximum supported resolution is
+     * `3840x2160`. The requested size must also satisfy the model's current pixel and
+     * edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
+     * supported by the GPT image models; `auto` is supported for models that allow
+     * automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
+     * `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
+     * `1024x1792`.
      */
-    size?: '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
+    size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
   }
 
   export namespace ImageGeneration {
@@ -6236,7 +7335,9 @@ export interface ToolChoiceTypes {
    *
    * - `file_search`
    * - `web_search_preview`
+   * - `computer`
    * - `computer_use_preview`
+   * - `computer_use`
    * - `code_interpreter`
    * - `mcp`
    * - `image_generation`
@@ -6244,13 +7345,40 @@ export interface ToolChoiceTypes {
   type:
     | 'file_search'
     | 'web_search_preview'
+    | 'computer'
     | 'computer_use_preview'
+    | 'computer_use'
     | 'web_search_preview_2025_03_11'
     | 'image_generation'
     | 'code_interpreter'
     | 'mcp';
 }
 
+/**
+ * Hosted or BYOT tool search configuration for deferred tools.
+ */
+export interface ToolSearchTool {
+  /**
+   * The type of the tool. Always `tool_search`.
+   */
+  type: 'tool_search';
+
+  /**
+   * Description shown to the model for a client-executed tool search tool.
+   */
+  description?: string | null;
+
+  /**
+   * Whether tool search is executed by the server or by the client.
+   */
+  execution?: 'server' | 'client';
+
+  /**
+   * Parameter schema for a client-executed tool search tool.
+   */
+  parameters?: unknown | null;
+}
+
 /**
  * This tool searches the web for relevant results to use in a response. Learn more
  * about the
@@ -6263,6 +7391,8 @@ export interface WebSearchPreviewTool {
    */
   type: 'web_search_preview' | 'web_search_preview_2025_03_11';
 
+  search_content_types?: Array<'text' | 'image'>;
+
   /**
    * High level guidance for the amount of context window space to use for the
    * search. One of `low`, `medium`, or `high`. `medium` is the default.
@@ -6510,7 +7640,7 @@ export interface ResponseCreateParamsBase {
    * of 24 hours.
    * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
    */
-  prompt_cache_retention?: 'in-memory' | '24h' | null;
+  prompt_cache_retention?: 'in_memory' | '24h' | null;
 
   /**
    * **gpt-5 and o-series models only**
@@ -6523,8 +7653,9 @@ export interface ResponseCreateParamsBase {
   /**
    * A stable identifier used to help detect users of your application that may be
    * violating OpenAI's usage policies. The IDs should be a string that uniquely
-   * identifies each user. We recommend hashing their username or email address, in
-   * order to avoid sending us any identifying information.
+   * identifies each user, with a maximum length of 64 characters. We recommend
+   * hashing their username or email address, in order to avoid sending us any
+   * identifying information.
    * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
    */
   safety_identifier?: string;
@@ -6623,6 +7754,13 @@ export interface ResponseCreateParamsBase {
    */
   tools?: Array<Tool>;
 
+  /**
+   * An integer between 0 and 20 specifying the maximum number of most likely tokens
+   * to return at each token position, each with an associated log probability. In
+   * some cases, the number of returned tokens may be fewer than requested.
+   */
+  top_logprobs?: number | null;
+
   /**
    * An alternative to sampling with temperature, called nucleus sampling, where the
    * model considers the results of the tokens with top_p probability mass. So 0.1
@@ -6783,6 +7921,12 @@ export interface ResponseCompactParams {
    * available models.
    */
   model:
+    | 'gpt-5.4'
+    | 'gpt-5.4-mini'
+    | 'gpt-5.4-nano'
+    | 'gpt-5.4-mini-2026-03-17'
+    | 'gpt-5.4-nano-2026-03-17'
+    | 'gpt-5.3-chat-latest'
     | 'gpt-5.2'
     | 'gpt-5.2-2025-12-11'
     | 'gpt-5.2-chat-latest'
@@ -6892,6 +8036,21 @@ export interface ResponseCompactParams {
    * Cannot be used in conjunction with `conversation`.
    */
   previous_response_id?: string | null;
+
+  /**
+   * A key to use when reading from or writing to the prompt cache.
+   */
+  prompt_cache_key?: string | null;
+
+  /**
+   * How long to retain a prompt cache entry created by this request.
+   */
+  prompt_cache_retention?: 'in_memory' | '24h' | null;
+
+  /**
+   * The service tier to use for this request.
+   */
+  service_tier?: 'auto' | 'default' | 'flex' | 'priority' | null;
 }
 
 Responses.InputItems = InputItems;
@@ -6901,7 +8060,10 @@ export declare namespace Responses {
   export {
     type ApplyPatchTool as ApplyPatchTool,
     type CompactedResponse as CompactedResponse,
+    type ComputerAction as ComputerAction,
+    type ComputerActionList as ComputerActionList,
     type ComputerTool as ComputerTool,
+    type ComputerUsePreviewTool as ComputerUsePreviewTool,
     type ContainerAuto as ContainerAuto,
     type ContainerNetworkPolicyAllowlist as ContainerNetworkPolicyAllowlist,
     type ContainerNetworkPolicyDisabled as ContainerNetworkPolicyDisabled,
@@ -6916,6 +8078,7 @@ export declare namespace Responses {
     type InlineSkillSource as InlineSkillSource,
     type LocalEnvironment as LocalEnvironment,
     type LocalSkill as LocalSkill,
+    type NamespaceTool as NamespaceTool,
     type Response as Response,
     type ResponseApplyPatchToolCall as ResponseApplyPatchToolCall,
     type ResponseApplyPatchToolCallOutput as ResponseApplyPatchToolCallOutput,
@@ -6944,7 +8107,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,
@@ -7018,10 +8183,15 @@ export declare namespace Responses {
     type ResponseTextConfig as ResponseTextConfig,
     type ResponseTextDeltaEvent as ResponseTextDeltaEvent,
     type ResponseTextDoneEvent as ResponseTextDoneEvent,
+    type ResponseToolSearchCall as ResponseToolSearchCall,
+    type ResponseToolSearchOutputItem as ResponseToolSearchOutputItem,
+    type ResponseToolSearchOutputItemParam as ResponseToolSearchOutputItemParam,
     type ResponseUsage as ResponseUsage,
     type ResponseWebSearchCallCompletedEvent as ResponseWebSearchCallCompletedEvent,
     type ResponseWebSearchCallInProgressEvent as ResponseWebSearchCallInProgressEvent,
     type ResponseWebSearchCallSearchingEvent as ResponseWebSearchCallSearchingEvent,
+    type ResponsesClientEvent as ResponsesClientEvent,
+    type ResponsesServerEvent as ResponsesServerEvent,
     type SkillReference as SkillReference,
     type Tool as Tool,
     type ToolChoiceAllowed as ToolChoiceAllowed,
@@ -7032,6 +8202,7 @@ export declare namespace Responses {
     type ToolChoiceOptions as ToolChoiceOptions,
     type ToolChoiceShell as ToolChoiceShell,
     type ToolChoiceTypes as ToolChoiceTypes,
+    type ToolSearchTool as ToolSearchTool,
     type WebSearchPreviewTool as WebSearchPreviewTool,
     type WebSearchTool as WebSearchTool,
     type ResponseCreateParams as ResponseCreateParams,