openai 7.3.0 → 7.5.0

package/src/resources/responses/responses.ts

@@ -1,4 +1,4 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 
 import {
   type ExtractParsedContentFromParams,
@@ -863,6 +863,8 @@ export interface FunctionTool {
   output_schema?: { [key: string]: unknown } | null;
 }
 
+export type ImageDetail = 'low' | 'high' | 'auto' | 'original';
+
 export interface InlineSkill {
   /**
    * The description of the skill.
@@ -934,6 +936,35 @@ export interface LocalSkill {
   path: string;
 }
 
+export type McpToolCallError =
+  | McpToolCallError.McpProtocolError
+  | McpToolCallError.McpToolExecutionError
+  | McpToolCallError.HTTPError;
+
+export namespace McpToolCallError {
+  export interface McpProtocolError {
+    code: number;
+
+    message: string;
+
+    type: 'mcp_protocol_error';
+  }
+
+  export interface McpToolExecutionError {
+    content: unknown;
+
+    type: 'mcp_tool_execution_error';
+  }
+
+  export interface HTTPError {
+    code: number;
+
+    message: string;
+
+    type: 'http_error';
+  }
+}
+
 /**
  * Groups function/custom tools under a shared namespace.
  */
@@ -1235,12 +1266,16 @@ export interface Response {
    *   Responses or Chat Completions. The response will show `service_tier=priority`
    *   regardless of if you specify `service_tier=fast` or `priority` in your
    *   request.
+   * - If set to 'ultrafast', then the request will be processed with the
+   *   access-controlled Ultrafast Processing service tier. This tier is currently
+   *   available for `gpt-5.6-sol`; a response served through it will show
+   *   `service_tier=ultrafast`.
    * - When not set, the default behavior is 'auto'.
    *
    * When this parameter is set, the response body will include the `service_tier`
    * utilized.
    */
-  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority' | 'fast' | null;
+  service_tier?: ServiceTier | null;
 
   /**
    * The status of the response generation. One of `completed`, `failed`,
@@ -3471,6 +3506,16 @@ export interface ResponseFunctionToolCallOutputItem {
    * The identifier of the actor that created the item.
    */
   created_by?: string;
+
+  /**
+   * The name of the tool that produced the output.
+   */
+  name?: string;
+
+  /**
+   * The namespace of the tool that produced the output.
+   */
+  namespace?: string;
 }
 
 export namespace ResponseFunctionToolCallOutputItem {
@@ -3715,6 +3760,26 @@ export interface ResponseImageGenCallPartialImageEvent {
    * The type of the event. Always 'response.image_generation_call.partial_image'.
    */
   type: 'response.image_generation_call.partial_image';
+
+  /**
+   * The background setting that was used.
+   */
+  background?: string;
+
+  /**
+   * The output format that was used.
+   */
+  output_format?: string;
+
+  /**
+   * The image quality that was used.
+   */
+  quality?: string;
+
+  /**
+   * The image size that was used.
+   */
+  size?: string;
 }
 
 /**
@@ -3958,7 +4023,7 @@ export interface ResponseInputImage {
    * 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' | 'original';
+  detail: ImageDetail;
 
   /**
    * The type of the input item. Always `input_image`.
@@ -4012,7 +4077,7 @@ export interface ResponseInputImageContent {
    * 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' | 'original' | null;
+  detail?: ImageDetail | null;
 
   /**
    * The ID of the file to be sent to the model.
@@ -4207,6 +4272,16 @@ export namespace ResponseInputItem {
      */
     caller?: FunctionCallOutput.Direct | FunctionCallOutput.Program | null;
 
+    /**
+     * The name of the tool that produced the output.
+     */
+    name?: string | null;
+
+    /**
+     * The namespace of the tool that produced the output.
+     */
+    namespace?: string | null;
+
     /**
      * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
      * Populated when items are returned via API.
@@ -4882,7 +4957,7 @@ export namespace ResponseInputItem {
     /**
      * The error from the tool call, if any.
      */
-    error?: string | null;
+    error?: ResponsesAPI.McpToolCallError | null;
 
     /**
      * The output from the tool call.
@@ -5467,7 +5542,7 @@ export namespace ResponseItem {
     /**
      * The error from the tool call, if any.
      */
-    error?: string | null;
+    error?: ResponsesAPI.McpToolCallError | null;
 
     /**
      * The output from the tool call.
@@ -5991,7 +6066,7 @@ export namespace ResponseOutputItem {
     /**
      * The error from the tool call, if any.
      */
-    error?: string | null;
+    error?: ResponsesAPI.McpToolCallError | null;
 
     /**
      * The output from the tool call.
@@ -6128,7 +6203,10 @@ export namespace ResponseOutputItem {
  */
 export interface ResponseOutputItemAddedEvent {
   /**
-   * The output item that was added.
+   * The output item that was added. For reasoning items, `encrypted_content` may be
+   * incomplete while the item is in progress. Use the reasoning item from the
+   * corresponding `response.output_item.done` event when passing it as input to a
+   * subsequent request.
    */
   item: ResponseOutputItem;
 
@@ -6397,9 +6475,14 @@ export namespace ResponseOutputText {
  */
 export interface ResponseOutputTextAnnotationAddedEvent {
   /**
-   * The annotation object being added. (See annotation schema for details.)
+   * An annotation that applies to a span of output text.
    */
-  annotation: unknown;
+  annotation:
+    | ResponseOutputTextAnnotationAddedEvent.FileCitation
+    | ResponseOutputTextAnnotationAddedEvent.URLCitation
+    | ResponseOutputTextAnnotationAddedEvent.ContainerFileCitation
+    | ResponseOutputTextAnnotationAddedEvent.FilePath
+    | null;
 
   /**
    * The index of the annotation within the content part.
@@ -6432,6 +6515,118 @@ export interface ResponseOutputTextAnnotationAddedEvent {
   type: 'response.output_text.annotation.added';
 }
 
+export namespace ResponseOutputTextAnnotationAddedEvent {
+  /**
+   * A citation to a file.
+   */
+  export interface FileCitation {
+    /**
+     * The ID of the file.
+     */
+    file_id: string;
+
+    /**
+     * The filename of the file cited.
+     */
+    filename: string;
+
+    /**
+     * The index of the file in the list of files.
+     */
+    index: number;
+
+    /**
+     * The type of the file citation. Always `file_citation`.
+     */
+    type: 'file_citation';
+  }
+
+  /**
+   * A citation for a web resource used to generate a model response.
+   */
+  export interface URLCitation {
+    /**
+     * The index of the last character of the URL citation in the message.
+     */
+    end_index: number;
+
+    /**
+     * The index of the first character of the URL citation in the message.
+     */
+    start_index: number;
+
+    /**
+     * The title of the web resource.
+     */
+    title: string;
+
+    /**
+     * The type of the URL citation. Always `url_citation`.
+     */
+    type: 'url_citation';
+
+    /**
+     * The URL of the web resource.
+     */
+    url: string;
+  }
+
+  /**
+   * A citation for a container file used to generate a model response.
+   */
+  export interface ContainerFileCitation {
+    /**
+     * The ID of the container file.
+     */
+    container_id: string;
+
+    /**
+     * The index of the last character of the container file citation in the message.
+     */
+    end_index: number;
+
+    /**
+     * The ID of the file.
+     */
+    file_id: string;
+
+    /**
+     * The filename of the container file cited.
+     */
+    filename: string;
+
+    /**
+     * The index of the first character of the container file citation in the message.
+     */
+    start_index: number;
+
+    /**
+     * The type of the container file citation. Always `container_file_citation`.
+     */
+    type: 'container_file_citation';
+  }
+
+  /**
+   * A path to a file.
+   */
+  export interface FilePath {
+    /**
+     * The ID of the file.
+     */
+    file_id: string;
+
+    /**
+     * The index of the file in the list of files.
+     */
+    index: number;
+
+    /**
+     * The type of the file path. Always `file_path`.
+     */
+    type: 'file_path';
+  }
+}
+
 /**
  * Reference to a prompt template and its variables.
  * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
@@ -6506,6 +6701,11 @@ export interface ResponseReasoningItem {
    * The encrypted content of the reasoning item. This is populated by default for
    * reasoning items returned by `POST /v1/responses` and WebSocket `response.create`
    * requests.
+   *
+   * When streaming, use the completed reasoning item and its `encrypted_content`
+   * from the `response.output_item.done` event in subsequent requests. The
+   * `encrypted_content` in `response.output_item.added` may be incomplete. This is
+   * especially important when `store` is `false` or when using Zero Data Retention.
    */
   encrypted_content?: string | null;
 
@@ -6869,202 +7069,371 @@ export interface ResponseRefusalDoneEvent {
 }
 
 /**
- * The status of the response generation. One of `completed`, `failed`,
- * `in_progress`, `cancelled`, `queued`, or `incomplete`.
+ * A streaming event that indicated a shell command was added to a tool call.
  */
-export type ResponseStatus = 'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete';
+export interface ResponseShellCallCommandAddedEvent {
+  /**
+   * The shell command that was added.
+   */
+  command: string;
 
-/**
- * Emitted when there is a partial audio response.
- */
-export type ResponseStreamEvent =
-  | 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;
+  /**
+   * The index of the shell command that was added.
+   */
+  command_index: number;
 
-/**
- * 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)
- */
-export interface ResponseTextConfig {
   /**
-   * An object specifying the format that the model must output.
-   *
-   * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which
-   * ensures the model will match your supplied JSON schema. Learn more in the
-   * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
-   *
-   * The default format is `{ "type": "text" }` with no additional options.
-   *
-   * **Not recommended for gpt-4o and newer models:**
-   *
-   * Setting to `{ "type": "json_object" }` enables the older JSON mode, which
-   * ensures the message the model generates is valid JSON. Using `json_schema` is
-   * preferred for models that support it.
+   * The index of the output item that was updated.
    */
-  format?: ResponseFormatTextConfig;
+  output_index: number;
 
   /**
-   * Constrains the verbosity of the model's response. Lower values will result in
-   * more concise responses, while higher values will result in more verbose
-   * responses. Currently supported values are `low`, `medium`, and `high`. The
-   * default is `medium`.
+   * The sequence number of the event that was emitted.
    */
-  verbosity?: 'low' | 'medium' | 'high' | null;
+  sequence_number: number;
+
+  /**
+   * The type of the event, always `response.shell_call_command.added`.
+   */
+  type: 'response.shell_call_command.added';
 }
 
 /**
- * Emitted when there is an additional text delta.
+ * A streaming event that indicated a shell command was incrementally updated.
  */
-export interface ResponseTextDeltaEvent {
+export interface ResponseShellCallCommandDeltaEvent {
   /**
-   * The index of the content part that the text delta was added to.
+   * The index of the shell command that was updated.
    */
-  content_index: number;
+  command_index: number;
 
   /**
-   * The text delta that was added.
+   * The shell command delta that was appended.
    */
   delta: string;
 
   /**
-   * The ID of the output item that the text delta was added to.
+   * The index of the output item that was updated.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the event that was emitted.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event, always `response.shell_call_command.delta`.
+   */
+  type: 'response.shell_call_command.delta';
+
+  /**
+   * An obfuscation string that was added to pad the event payload.
+   */
+  obfuscation?: string;
+}
+
+/**
+ * A streaming event that indicated a shell command was completed.
+ */
+export interface ResponseShellCallCommandDoneEvent {
+  /**
+   * The final shell command that was emitted.
+   */
+  command: string;
+
+  /**
+   * The index of the shell command that was completed.
+   */
+  command_index: number;
+
+  /**
+   * The index of the output item that was updated.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number of the event that was emitted.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event, always `response.shell_call_command.done`.
+   */
+  type: 'response.shell_call_command.done';
+}
+
+/**
+ * A streaming event that indicated shell call output was incrementally added.
+ */
+export interface ResponseShellCallOutputContentDeltaEvent {
+  /**
+   * The index of the shell command that produced output.
+   */
+  command_index: number;
+
+  /**
+   * The stdout/stderr delta that was emitted.
+   */
+  delta: ResponseShellCallOutputContentDeltaEvent.Delta;
+
+  /**
+   * The ID of the output item that was updated.
    */
   item_id: string;
 
   /**
-   * The log probabilities of the tokens in the delta.
+   * The index of the output item that was updated.
    */
-  logprobs: Array<ResponseTextDeltaEvent.Logprob>;
+  output_index: number;
 
   /**
-   * The index of the output item that the text delta was added to.
+   * The sequence number of the event that was emitted.
+   */
+  sequence_number: number;
+
+  /**
+   * The type of the event, always `response.shell_call_output_content.delta`.
+   */
+  type: 'response.shell_call_output_content.delta';
+}
+
+export namespace ResponseShellCallOutputContentDeltaEvent {
+  /**
+   * The stdout/stderr delta that was emitted.
+   */
+  export interface Delta {
+    /**
+     * The stderr delta that was emitted.
+     */
+    stderr?: string;
+
+    /**
+     * The stdout delta that was emitted.
+     */
+    stdout?: string;
+  }
+}
+
+/**
+ * A streaming event that indicated shell call output was completed.
+ */
+export interface ResponseShellCallOutputContentDoneEvent {
+  /**
+   * The index of the shell command that produced output.
+   */
+  command_index: number;
+
+  /**
+   * The ID of the output item that was updated.
+   */
+  item_id: string;
+
+  /**
+   * The output contents emitted for the shell command.
+   */
+  output: Array<ResponseShellCallOutputContentDoneEvent.Output>;
+
+  /**
+   * The index of the output item that was updated.
    */
   output_index: number;
 
   /**
-   * The sequence number for this event.
+   * The sequence number of the event that was emitted.
    */
   sequence_number: number;
 
   /**
-   * The type of the event. Always `response.output_text.delta`.
+   * The type of the event, always `response.shell_call_output_content.done`.
    */
-  type: 'response.output_text.delta';
+  type: 'response.shell_call_output_content.done';
 }
 
-export namespace ResponseTextDeltaEvent {
+export namespace ResponseShellCallOutputContentDoneEvent {
   /**
-   * A logprob is the logarithmic probability that the model assigns to producing a
-   * particular token at a given position in the sequence. Less-negative (higher)
-   * logprob values indicate greater model confidence in that token choice.
+   * The content of a shell tool call output that was emitted.
    */
-  export interface Logprob {
+  export interface Output {
     /**
-     * A possible text token.
+     * Represents either an exit outcome (with an exit code) or a timeout outcome for a
+     * shell call output chunk.
      */
-    token: string;
+    outcome: Output.Timeout | Output.Exit;
 
     /**
-     * The log probability of this token.
+     * The standard error output that was captured.
      */
-    logprob: number;
+    stderr: string;
 
     /**
-     * The log probabilities of up to 20 of the most likely tokens.
+     * The standard output that was captured.
      */
-    top_logprobs?: Array<Logprob.TopLogprob>;
+    stdout: string;
+
+    /**
+     * The identifier of the actor that created the item.
+     */
+    created_by?: string;
   }
 
-  export namespace Logprob {
-    export interface TopLogprob {
+  export namespace Output {
+    /**
+     * Indicates that the shell call exceeded its configured time limit.
+     */
+    export interface Timeout {
       /**
-       * A possible text token.
+       * The outcome type. Always `timeout`.
        */
-      token?: string;
+      type: 'timeout';
+    }
 
+    /**
+     * Indicates that the shell commands finished and returned an exit code.
+     */
+    export interface Exit {
       /**
-       * The log probability of this token.
+       * Exit code from the shell process.
        */
-      logprob?: number;
+      exit_code: number;
+
+      /**
+       * The outcome type. Always `exit`.
+       */
+      type: 'exit';
     }
   }
 }
 
 /**
- * Emitted when text content is finalized.
+ * The status of the response generation. One of `completed`, `failed`,
+ * `in_progress`, `cancelled`, `queued`, or `incomplete`.
  */
-export interface ResponseTextDoneEvent {
+export type ResponseStatus = 'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete';
+
+/**
+ * Event emitted while a response is streamed.
+ */
+export type ResponseStreamEvent =
+  | ResponseAudioDeltaEvent
+  | ResponseAudioDoneEvent
+  | ResponseAudioTranscriptDeltaEvent
+  | ResponseAudioTranscriptDoneEvent
+  | ResponseCodeInterpreterCallCodeDeltaEvent
+  | ResponseCodeInterpreterCallCodeDoneEvent
+  | ResponseCodeInterpreterCallCompletedEvent
+  | ResponseCodeInterpreterCallInProgressEvent
+  | ResponseCodeInterpreterCallInterpretingEvent
+  | ResponseCompletedEvent
+  | ResponseContentPartAddedEvent
+  | ResponseContentPartDoneEvent
+  | ResponseCreatedEvent
+  | ResponseErrorEvent
+  | ResponseFileSearchCallCompletedEvent
+  | ResponseFileSearchCallInProgressEvent
+  | ResponseFileSearchCallSearchingEvent
+  | ResponseFunctionCallArgumentsDeltaEvent
+  | ResponseFunctionCallArgumentsDoneEvent
+  | ResponseShellCallCommandAddedEvent
+  | ResponseShellCallCommandDeltaEvent
+  | ResponseShellCallCommandDoneEvent
+  | ResponseShellCallOutputContentDeltaEvent
+  | ResponseShellCallOutputContentDoneEvent
+  | 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;
+
+/**
+ * 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)
+ */
+export interface ResponseTextConfig {
   /**
-   * The index of the content part that the text content is finalized.
+   * An object specifying the format that the model must output.
+   *
+   * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which
+   * ensures the model will match your supplied JSON schema. Learn more in the
+   * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+   *
+   * The default format is `{ "type": "text" }` with no additional options.
+   *
+   * **Not recommended for gpt-4o and newer models:**
+   *
+   * Setting to `{ "type": "json_object" }` enables the older JSON mode, which
+   * ensures the message the model generates is valid JSON. Using `json_schema` is
+   * preferred for models that support it.
+   */
+  format?: ResponseFormatTextConfig;
+
+  /**
+   * Constrains the verbosity of the model's response. Lower values will result in
+   * more concise responses, while higher values will result in more verbose
+   * responses. Currently supported values are `low`, `medium`, and `high`. The
+   * default is `medium`.
+   */
+  verbosity?: 'low' | 'medium' | 'high' | null;
+}
+
+/**
+ * Emitted when there is an additional text delta.
+ */
+export interface ResponseTextDeltaEvent {
+  /**
+   * The index of the content part that the text delta was added to.
    */
   content_index: number;
 
   /**
-   * The ID of the output item that the text content is finalized.
+   * The text delta that was added.
+   */
+  delta: string;
+
+  /**
+   * The ID of the output item that the text delta was added to.
    */
   item_id: string;
 
   /**
    * The log probabilities of the tokens in the delta.
    */
-  logprobs: Array<ResponseTextDoneEvent.Logprob>;
+  logprobs: Array<ResponseTextDeltaEvent.Logprob>;
 
   /**
-   * The index of the output item that the text content is finalized.
+   * The index of the output item that the text delta was added to.
    */
   output_index: number;
 
@@ -7074,17 +7443,90 @@ export interface ResponseTextDoneEvent {
   sequence_number: number;
 
   /**
-   * The text content that is finalized.
-   */
-  text: string;
-
-  /**
-   * The type of the event. Always `response.output_text.done`.
+   * The type of the event. Always `response.output_text.delta`.
    */
-  type: 'response.output_text.done';
+  type: 'response.output_text.delta';
 }
 
-export namespace ResponseTextDoneEvent {
+export namespace ResponseTextDeltaEvent {
+  /**
+   * A logprob is the logarithmic probability that the model assigns to producing a
+   * particular token at a given position in the sequence. Less-negative (higher)
+   * logprob values indicate greater model confidence in that token choice.
+   */
+  export interface Logprob {
+    /**
+     * A possible text token.
+     */
+    token: string;
+
+    /**
+     * The log probability of this token.
+     */
+    logprob: number;
+
+    /**
+     * The log probabilities of up to 20 of the most likely tokens.
+     */
+    top_logprobs?: Array<Logprob.TopLogprob>;
+  }
+
+  export namespace Logprob {
+    export interface TopLogprob {
+      /**
+       * A possible text token.
+       */
+      token?: string;
+
+      /**
+       * The log probability of this token.
+       */
+      logprob?: number;
+    }
+  }
+}
+
+/**
+ * Emitted when text content is finalized.
+ */
+export interface ResponseTextDoneEvent {
+  /**
+   * The index of the content part that the text content is finalized.
+   */
+  content_index: number;
+
+  /**
+   * The ID of the output item that the text content is finalized.
+   */
+  item_id: string;
+
+  /**
+   * The log probabilities of the tokens in the delta.
+   */
+  logprobs: Array<ResponseTextDoneEvent.Logprob>;
+
+  /**
+   * The index of the output item that the text content is finalized.
+   */
+  output_index: number;
+
+  /**
+   * The sequence number for this event.
+   */
+  sequence_number: number;
+
+  /**
+   * The text content that is finalized.
+   */
+  text: string;
+
+  /**
+   * The type of the event. Always `response.output_text.done`.
+   */
+  type: 'response.output_text.done';
+}
+
+export namespace ResponseTextDoneEvent {
   /**
    * A logprob is the logarithmic probability that the model assigns to producing a
    * particular token at a given position in the sequence. Less-negative (higher)
@@ -7563,6 +8005,10 @@ export interface ResponsesClientEvent {
    *   Responses or Chat Completions. The response will show `service_tier=priority`
    *   regardless of if you specify `service_tier=fast` or `priority` in your
    *   request.
+   * - If set to 'ultrafast', then the request will be processed with the
+   *   access-controlled Ultrafast Processing service tier. This tier is currently
+   *   available for `gpt-5.6-sol`; a response served through it will show
+   *   `service_tier=ultrafast`.
    * - When not set, the default behavior is 'auto'.
    *
    * When the `service_tier` parameter is set, the response body will include the
@@ -7570,7 +8016,7 @@ export interface ResponsesClientEvent {
    * request. This response value may be different from the value set in the
    * parameter.
    */
-  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority' | 'fast' | null;
+  service_tier?: ServiceTier | null;
 
   /**
    * Whether to store the generated model response for later retrieval via API.
@@ -7588,276 +8034,1026 @@ export interface ResponsesClientEvent {
   stream?: boolean | null;
 
   /**
-   * Options for streaming responses. Only set this when you set `stream: true`.
+   * The WebSocket lane for this response. Requests with the same `stream_id` are
+   * processed FIFO, and events for the response echo the same `stream_id`.
+   *
+   * `stream_id` controls routing; `previous_response_id` controls conversation
+   * lineage, so a new lane can fork from a response created on another lane.
+   */
+  stream_id?: string;
+
+  /**
+   * Options for streaming responses. Only set this when you set `stream: true`.
+   */
+  stream_options?: ResponsesClientEvent.StreamOptions | null;
+
+  /**
+   * 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.
+   */
+  temperature?: number | null;
+
+  /**
+   * 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)
+   */
+  text?: ResponseTextConfig;
+
+  /**
+   * 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.
+   */
+  tool_choice?:
+    | ToolChoiceOptions
+    | ToolChoiceAllowed
+    | ToolChoiceTypes
+    | ToolChoiceFunction
+    | ToolChoiceMcp
+    | ToolChoiceCustom
+    | ResponsesClientEvent.SpecificProgrammaticToolCallingParam
+    | ToolChoiceApplyPatch
+    | ToolChoiceShell;
+
+  /**
+   * 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.
+   */
+  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
+   * means only the tokens comprising the top 10% probability mass are considered.
+   *
+   * We generally recommend altering this or `temperature` but not both.
+   */
+  top_p?: number | null;
+
+  /**
+   * @deprecated 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.
+   */
+  truncation?: 'auto' | 'disabled' | null;
+
+  /**
+   * @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).
+   */
+  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;
+  }
+
+  /**
+   * Configuration for running moderation on the input and output of this response.
+   */
+  export interface Moderation {
+    /**
+     * The moderation model to use for moderated completions, e.g.
+     * 'omni-moderation-latest'.
+     */
+    model: string;
+
+    /**
+     * The policy to apply to moderated response input and output.
+     */
+    policy?: Moderation.Policy | null;
+  }
+
+  export namespace Moderation {
+    /**
+     * The policy to apply to moderated response input and output.
+     */
+    export interface Policy {
+      /**
+       * The moderation policy for the response input.
+       */
+      input?: Policy.Input | null;
+
+      /**
+       * The moderation policy for the response output.
+       */
+      output?: Policy.Output | null;
+    }
+
+    export namespace Policy {
+      /**
+       * The moderation policy for the response input.
+       */
+      export interface Input {
+        mode: 'score' | 'block';
+      }
+
+      /**
+       * The moderation policy for the response output.
+       */
+      export interface Output {
+        mode: 'score' | 'block';
+      }
+    }
+  }
+
+  /**
+   * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+   * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+   * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+   * request can write up to four breakpoints. For cache matching, OpenAI considers
+   * up to the latest 80 breakpoints in the conversation, without a content-block
+   * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+   * `ttl` defaults to `30m`, which is currently the only supported value. See the
+   * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+   * for current details.
+   */
+  export interface PromptCacheOptions {
+    /**
+     * Controls whether OpenAI automatically creates an implicit cache breakpoint.
+     * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+     * and writes up to the latest three explicit breakpoints in the request. With
+     * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+     * latest four explicit breakpoints. If there are no explicit breakpoints, the
+     * request does not use prompt caching.
+     */
+    mode?: 'implicit' | 'explicit';
+
+    /**
+     * The minimum lifetime applied to every implicit and explicit cache breakpoint
+     * written by the request. Defaults to `30m`, which is currently the only supported
+     * value. The backend may retain cache entries for longer.
+     */
+    ttl?: '30m';
+  }
+
+  /**
+   * Options for streaming responses. Only set this when you set `stream: true`.
+   */
+  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;
+  }
+
+  export interface SpecificProgrammaticToolCallingParam {
+    /**
+     * The tool to call. Always `programmatic_tool_calling`.
+     */
+    type: 'programmatic_tool_calling';
+  }
+}
+
+/**
+ * Server events emitted by the Responses WebSocket server.
+ */
+export type ResponsesServerEvent =
+  | ResponsesServerEvent.ResponseAudioWsDelta
+  | ResponsesServerEvent.ResponseAudioWsDone
+  | ResponsesServerEvent.ResponseAudioTranscriptWsDelta
+  | ResponsesServerEvent.ResponseAudioTranscriptWsDone
+  | ResponsesServerEvent.ResponseCodeInterpreterCallCodeWsDelta
+  | ResponsesServerEvent.ResponseCodeInterpreterCallCodeWsDone
+  | ResponsesServerEvent.ResponseCodeInterpreterCallWsCompleted
+  | ResponsesServerEvent.ResponseCodeInterpreterCallInWsProgress
+  | ResponsesServerEvent.ResponseCodeInterpreterCallWsInterpreting
+  | ResponsesServerEvent.ResponseWsCompleted
+  | ResponsesServerEvent.ResponseContentPartWsAdded
+  | ResponsesServerEvent.ResponseContentPartWsDone
+  | ResponsesServerEvent.ResponseWsCreated
+  | ResponsesServerEvent.ResponseFileSearchCallWsCompleted
+  | ResponsesServerEvent.ResponseFileSearchCallInWsProgress
+  | ResponsesServerEvent.ResponseFileSearchCallWsSearching
+  | ResponsesServerEvent.ResponseFunctionCallArgumentsWsDelta
+  | ResponsesServerEvent.ResponseFunctionCallArgumentsWsDone
+  | ResponsesServerEvent.ResponseShellCallCommandWsAdded
+  | ResponsesServerEvent.ResponseShellCallCommandWsDelta
+  | ResponsesServerEvent.ResponseShellCallCommandWsDone
+  | ResponsesServerEvent.ResponseShellCallOutputContentWsDelta
+  | ResponsesServerEvent.ResponseShellCallOutputContentWsDone
+  | ResponsesServerEvent.ResponseInWsProgress
+  | ResponsesServerEvent.ResponseWsFailed
+  | ResponsesServerEvent.ResponseWsIncomplete
+  | ResponsesServerEvent.ResponseOutputItemWsAdded
+  | ResponsesServerEvent.ResponseOutputItemWsDone
+  | ResponsesServerEvent.ResponseReasoningSummaryPartWsAdded
+  | ResponsesServerEvent.ResponseReasoningSummaryPartWsDone
+  | ResponsesServerEvent.ResponseReasoningSummaryTextWsDelta
+  | ResponsesServerEvent.ResponseReasoningSummaryTextWsDone
+  | ResponsesServerEvent.ResponseReasoningTextWsDelta
+  | ResponsesServerEvent.ResponseReasoningTextWsDone
+  | ResponsesServerEvent.ResponseRefusalWsDelta
+  | ResponsesServerEvent.ResponseRefusalWsDone
+  | ResponsesServerEvent.ResponseTextWsDelta
+  | ResponsesServerEvent.ResponseTextWsDone
+  | ResponsesServerEvent.ResponseWebSearchCallWsCompleted
+  | ResponsesServerEvent.ResponseWebSearchCallInWsProgress
+  | ResponsesServerEvent.ResponseWebSearchCallWsSearching
+  | ResponsesServerEvent.ResponseImageGenCallWsCompleted
+  | ResponsesServerEvent.ResponseImageGenCallWsGenerating
+  | ResponsesServerEvent.ResponseImageGenCallInWsProgress
+  | ResponsesServerEvent.ResponseImageGenCallPartialWsImage
+  | ResponsesServerEvent.ResponseMcpCallArgumentsWsDelta
+  | ResponsesServerEvent.ResponseMcpCallArgumentsWsDone
+  | ResponsesServerEvent.ResponseMcpCallWsCompleted
+  | ResponsesServerEvent.ResponseMcpCallWsFailed
+  | ResponsesServerEvent.ResponseMcpCallInWsProgress
+  | ResponsesServerEvent.ResponseMcpListToolsWsCompleted
+  | ResponsesServerEvent.ResponseMcpListToolsWsFailed
+  | ResponsesServerEvent.ResponseMcpListToolsInWsProgress
+  | ResponsesServerEvent.ResponseOutputTextAnnotationWsAdded
+  | ResponsesServerEvent.ResponseWsQueued
+  | ResponsesServerEvent.ResponseCustomToolCallInputWsDelta
+  | ResponsesServerEvent.ResponseCustomToolCallInputWsDone
+  | ResponsesServerEvent.ResponseWsStreamingError
+  | ResponsesServerEvent.ResponseWsError;
+
+export namespace ResponsesServerEvent {
+  /**
+   * Emitted when there is a partial audio response.
+   */
+  export interface ResponseAudioWsDelta extends ResponseAudioDeltaEvent {
+    /**
+     * 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 audio response is complete.
+   */
+  export interface ResponseAudioWsDone extends ResponseAudioDoneEvent {
+    /**
+     * 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 there is a partial transcript of audio.
+   */
+  export interface ResponseAudioTranscriptWsDelta extends ResponseAudioTranscriptDeltaEvent {
+    /**
+     * 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 full audio transcript is completed.
+   */
+  export interface ResponseAudioTranscriptWsDone extends ResponseAudioTranscriptDoneEvent {
+    /**
+     * 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 a partial code snippet is streamed by the code interpreter.
+   */
+  export interface ResponseCodeInterpreterCallCodeWsDelta extends ResponseCodeInterpreterCallCodeDeltaEvent {
+    /**
+     * 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 code snippet is finalized by the code interpreter.
+   */
+  export interface ResponseCodeInterpreterCallCodeWsDone extends ResponseCodeInterpreterCallCodeDoneEvent {
+    /**
+     * 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 code interpreter call is completed.
+   */
+  export interface ResponseCodeInterpreterCallWsCompleted extends ResponseCodeInterpreterCallCompletedEvent {
+    /**
+     * 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 a code interpreter call is in progress.
+   */
+  export interface ResponseCodeInterpreterCallInWsProgress extends ResponseCodeInterpreterCallInProgressEvent {
+    /**
+     * 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 code interpreter is actively interpreting the code snippet.
+   */
+  export interface ResponseCodeInterpreterCallWsInterpreting extends ResponseCodeInterpreterCallInterpretingEvent {
+    /**
+     * 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.
+   */
+  export interface ResponseWsCompleted extends ResponseCompletedEvent {
+    /**
+     * 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 a new content part is added.
+   */
+  export interface ResponseContentPartWsAdded extends ResponseContentPartAddedEvent {
+    /**
+     * 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 a content part is done.
+   */
+  export interface ResponseContentPartWsDone extends ResponseContentPartDoneEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * An event that is emitted when a response is created.
+   */
+  export interface ResponseWsCreated extends ResponseCreatedEvent {
+    /**
+     * 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 a file search call is completed (results found).
+   */
+  export interface ResponseFileSearchCallWsCompleted extends ResponseFileSearchCallCompletedEvent {
+    /**
+     * 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 a file search call is initiated.
+   */
+  export interface ResponseFileSearchCallInWsProgress extends ResponseFileSearchCallInProgressEvent {
+    /**
+     * 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 a file search is currently searching.
+   */
+  export interface ResponseFileSearchCallWsSearching extends ResponseFileSearchCallSearchingEvent {
+    /**
+     * 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 there is a partial function-call arguments delta.
+   */
+  export interface ResponseFunctionCallArgumentsWsDelta extends ResponseFunctionCallArgumentsDeltaEvent {
+    /**
+     * 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 function-call arguments are finalized.
+   */
+  export interface ResponseFunctionCallArgumentsWsDone extends ResponseFunctionCallArgumentsDoneEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * A streaming event that indicated a shell command was added to a tool call.
+   */
+  export interface ResponseShellCallCommandWsAdded extends ResponseShellCallCommandAddedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * A streaming event that indicated a shell command was incrementally updated.
+   */
+  export interface ResponseShellCallCommandWsDelta extends ResponseShellCallCommandDeltaEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * A streaming event that indicated a shell command was completed.
+   */
+  export interface ResponseShellCallCommandWsDone extends ResponseShellCallCommandDoneEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * A streaming event that indicated shell call output was incrementally added.
+   */
+  export interface ResponseShellCallOutputContentWsDelta extends ResponseShellCallOutputContentDeltaEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * A streaming event that indicated shell call output was completed.
+   */
+  export interface ResponseShellCallOutputContentWsDone extends ResponseShellCallOutputContentDoneEvent {
+    /**
+     * 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 response is in progress.
+   */
+  export interface ResponseInWsProgress extends ResponseInProgressEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * An event that is emitted when a response fails.
+   */
+  export interface ResponseWsFailed extends ResponseFailedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
+
+  /**
+   * An event that is emitted when a response finishes as incomplete.
+   */
+  export interface ResponseWsIncomplete extends ResponseIncompleteEvent {
+    /**
+     * 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 a new output item is added.
+   */
+  export interface ResponseOutputItemWsAdded extends ResponseOutputItemAddedEvent {
+    /**
+     * 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 an output item is marked done.
+   */
+  export interface ResponseOutputItemWsDone extends ResponseOutputItemDoneEvent {
+    /**
+     * 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 a new reasoning summary part is added.
+   */
+  export interface ResponseReasoningSummaryPartWsAdded extends ResponseReasoningSummaryPartAddedEvent {
+    /**
+     * 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 a reasoning summary part is completed.
+   */
+  export interface ResponseReasoningSummaryPartWsDone extends ResponseReasoningSummaryPartDoneEvent {
+    /**
+     * 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 a delta is added to a reasoning summary text.
+   */
+  export interface ResponseReasoningSummaryTextWsDelta extends ResponseReasoningSummaryTextDeltaEvent {
+    /**
+     * 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 a reasoning summary text is completed.
+   */
+  export interface ResponseReasoningSummaryTextWsDone extends ResponseReasoningSummaryTextDoneEvent {
+    /**
+     * 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 a delta is added to a reasoning text.
+   */
+  export interface ResponseReasoningTextWsDelta extends ResponseReasoningTextDeltaEvent {
+    /**
+     * 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 a reasoning text is completed.
+   */
+  export interface ResponseReasoningTextWsDone extends ResponseReasoningTextDoneEvent {
+    /**
+     * 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 there is a partial refusal text.
+   */
+  export interface ResponseRefusalWsDelta extends ResponseRefusalDeltaEvent {
+    /**
+     * 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 refusal text is finalized.
+   */
+  export interface ResponseRefusalWsDone extends ResponseRefusalDoneEvent {
+    /**
+     * 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 there is an additional text delta.
+   */
+  export interface ResponseTextWsDelta extends ResponseTextDeltaEvent {
+    /**
+     * 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 text content is finalized.
+   */
+  export interface ResponseTextWsDone extends ResponseTextDoneEvent {
+    /**
+     * 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 a web search call is completed.
+   */
+  export interface ResponseWebSearchCallWsCompleted extends ResponseWebSearchCallCompletedEvent {
+    /**
+     * 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 a web search call is initiated.
+   */
+  export interface ResponseWebSearchCallInWsProgress extends ResponseWebSearchCallInProgressEvent {
+    /**
+     * 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 a web search call is executing.
+   */
+  export interface ResponseWebSearchCallWsSearching extends ResponseWebSearchCallSearchingEvent {
+    /**
+     * 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 an image generation tool call has completed and the final image is
+   * available.
+   */
+  export interface ResponseImageGenCallWsCompleted extends ResponseImageGenCallCompletedEvent {
+    /**
+     * 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 an image generation tool call is actively generating an image
+   * (intermediate state).
+   */
+  export interface ResponseImageGenCallWsGenerating extends ResponseImageGenCallGeneratingEvent {
+    /**
+     * 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 an image generation tool call is in progress.
+   */
+  export interface ResponseImageGenCallInWsProgress extends ResponseImageGenCallInProgressEvent {
+    /**
+     * 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 a partial image is available during image generation streaming.
+   */
+  export interface ResponseImageGenCallPartialWsImage extends ResponseImageGenCallPartialImageEvent {
+    /**
+     * 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 there is a delta (partial update) to the arguments of an MCP tool
+   * call.
+   */
+  export interface ResponseMcpCallArgumentsWsDelta extends ResponseMcpCallArgumentsDeltaEvent {
+    /**
+     * 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 arguments for an MCP tool call are finalized.
+   */
+  export interface ResponseMcpCallArgumentsWsDone extends ResponseMcpCallArgumentsDoneEvent {
+    /**
+     * 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 an MCP tool call has completed successfully.
+   */
+  export interface ResponseMcpCallWsCompleted extends ResponseMcpCallCompletedEvent {
+    /**
+     * 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 an MCP tool call has failed.
    */
-  stream_options?: ResponsesClientEvent.StreamOptions | null;
+  export interface ResponseMcpCallWsFailed extends ResponseMcpCallFailedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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.
+   * Emitted when an MCP tool call is in progress.
    */
-  temperature?: number | null;
+  export interface ResponseMcpCallInWsProgress extends ResponseMcpCallInProgressEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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)
+   * Emitted when the list of available MCP tools has been successfully retrieved.
    */
-  text?: ResponseTextConfig;
+  export interface ResponseMcpListToolsWsCompleted extends ResponseMcpListToolsCompletedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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.
+   * Emitted when the attempt to list available MCP tools has failed.
    */
-  tool_choice?:
-    | ToolChoiceOptions
-    | ToolChoiceAllowed
-    | ToolChoiceTypes
-    | ToolChoiceFunction
-    | ToolChoiceMcp
-    | ToolChoiceCustom
-    | ResponsesClientEvent.SpecificProgrammaticToolCallingParam
-    | ToolChoiceApplyPatch
-    | ToolChoiceShell;
+  export interface ResponseMcpListToolsWsFailed extends ResponseMcpListToolsFailedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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.
+   * Emitted when the system is in the process of retrieving the list of available
+   * MCP tools.
    */
-  tools?: Array<Tool>;
+  export interface ResponseMcpListToolsInWsProgress extends ResponseMcpListToolsInProgressEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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.
+   * Emitted when an annotation is added to output text content.
    */
-  top_logprobs?: number | null;
+  export interface ResponseOutputTextAnnotationWsAdded extends ResponseOutputTextAnnotationAddedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * 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.
+   * Emitted when a response is queued and waiting to be processed.
    */
-  top_p?: number | null;
+  export interface ResponseWsQueued extends ResponseQueuedEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * @deprecated 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.
+   * Event representing a delta (partial update) to the input of a custom tool call.
    */
-  truncation?: 'auto' | 'disabled' | null;
+  export interface ResponseCustomToolCallInputWsDelta extends ResponseCustomToolCallInputDeltaEvent {
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
+  }
 
   /**
-   * @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).
+   * Event indicating that input for a custom tool call is complete.
    */
-  user?: string;
-}
-
-export namespace ResponsesClientEvent {
-  export interface ContextManagement {
+  export interface ResponseCustomToolCallInputWsDone extends ResponseCustomToolCallInputDoneEvent {
     /**
-     * The context management entry type. Currently only 'compaction' is supported.
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
      */
-    type: string;
+    stream_id?: string;
+  }
 
+  /**
+   * Emitted when an error occurs while streaming a response over the WebSocket.
+   */
+  export interface ResponseWsStreamingError extends ResponseErrorEvent {
     /**
-     * Token threshold at which compaction should be triggered for this entry.
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
      */
-    compact_threshold?: number | null;
+    stream_id?: string;
   }
 
   /**
-   * Configuration for running moderation on the input and output of this response.
+   * Emitted when an error occurs while processing a Responses WebSocket request.
    */
-  export interface Moderation {
+  export interface ResponseWsError {
     /**
-     * The moderation model to use for moderated completions, e.g.
-     * 'omni-moderation-latest'.
+     * Details about the error.
      */
-    model: string;
+    error: ResponseWsError.Error;
 
     /**
-     * The policy to apply to moderated response input and output.
+     * The type of the event. Always `error`.
      */
-    policy?: Moderation.Policy | null;
+    type: 'error';
+
+    /**
+     * The sequence number of an error emitted by the response stream.
+     */
+    sequence_number?: number;
+
+    /**
+     * The HTTP status code associated with a WebSocket protocol error.
+     */
+    status?: number;
+
+    /**
+     * The WebSocket lane that emitted this event. This field is present when the
+     * originating `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
   }
 
-  export namespace Moderation {
+  export namespace ResponseWsError {
     /**
-     * The policy to apply to moderated response input and output.
+     * Details about the error.
      */
-    export interface Policy {
+    export interface Error {
       /**
-       * The moderation policy for the response input.
+       * The error code that was emitted, if any.
        */
-      input?: Policy.Input | null;
+      code: string | null;
 
       /**
-       * The moderation policy for the response output.
+       * The human-readable error message that was emitted.
        */
-      output?: Policy.Output | null;
-    }
+      message: string;
 
-    export namespace Policy {
       /**
-       * The moderation policy for the response input.
+       * The parameter name that was associated with the error, if any.
        */
-      export interface Input {
-        mode: 'score' | 'block';
-      }
+      param: string | null;
 
       /**
-       * The moderation policy for the response output.
+       * The error type that was emitted.
        */
-      export interface Output {
-        mode: 'score' | 'block';
-      }
-    }
-  }
-
-  /**
-   * Options for prompt caching. Supported for `gpt-5.6` and later models. By
-   * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
-   * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
-   * request can write up to four breakpoints. For cache matching, OpenAI considers
-   * up to the latest 80 breakpoints in the conversation, without a content-block
-   * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-   * `ttl` defaults to `30m`, which is currently the only supported value. See the
-   * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
-   * for current details.
-   */
-  export interface PromptCacheOptions {
-    /**
-     * Controls whether OpenAI automatically creates an implicit cache breakpoint.
-     * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
-     * and writes up to the latest three explicit breakpoints in the request. With
-     * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
-     * latest four explicit breakpoints. If there are no explicit breakpoints, the
-     * request does not use prompt caching.
-     */
-    mode?: 'implicit' | 'explicit';
-
-    /**
-     * The minimum lifetime applied to every implicit and explicit cache breakpoint
-     * written by the request. Defaults to `30m`, which is currently the only supported
-     * value. The backend may retain cache entries for longer.
-     */
-    ttl?: '30m';
-  }
-
-  /**
-   * Options for streaming responses. Only set this when you set `stream: true`.
-   */
-  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;
-  }
+      type: string;
 
-  export interface SpecificProgrammaticToolCallingParam {
-    /**
-     * The tool to call. Always `programmatic_tool_calling`.
-     */
-    type: 'programmatic_tool_calling';
+      /**
+       * The response headers that were emitted with the error, if any.
+       */
+      headers?: { [key: string]: string };
+    }
   }
 }
 
 /**
- * Server events emitted by the Responses WebSocket server.
+ * 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)',
+ *   then the request will be processed with the Flex Processing service tier.
+ * - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
+ *   include the `service_tier=fast` or `service_tier=priority` parameter for
+ *   Responses or Chat Completions. The response will show `service_tier=priority`
+ *   regardless of if you specify `service_tier=fast` or `priority` in your
+ *   request.
+ * - If set to 'ultrafast', then the request will be processed with the
+ *   access-controlled Ultrafast Processing service tier. This tier is currently
+ *   available for `gpt-5.6-sol`; a response served through it will show
+ *   `service_tier=ultrafast`.
+ * - 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 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 type ServiceTier = 'auto' | 'default' | 'flex' | 'scale' | 'priority' | 'fast' | 'ultrafast' | null;
 
 export interface SkillReference {
   /**
@@ -8499,6 +9695,13 @@ export interface WebSearchTool {
    */
   type: 'web_search' | 'web_search_2025_08_26';
 
+  /**
+   * Allow live internet access for web search. Defaults to true when omitted. When
+   * false, the web search tool runs in offline/cache-only mode and will not fetch
+   * new external content.
+   */
+  external_web_access?: boolean;
+
   /**
    * Filters for the search.
    */
@@ -8757,12 +9960,16 @@ export interface ResponseCreateParamsBase {
    *   Responses or Chat Completions. The response will show `service_tier=priority`
    *   regardless of if you specify `service_tier=fast` or `priority` in your
    *   request.
+   * - If set to 'ultrafast', then the request will be processed with the
+   *   access-controlled Ultrafast Processing service tier. This tier is currently
+   *   available for `gpt-5.6-sol`; a response served through it will show
+   *   `service_tier=ultrafast`.
    * - When not set, the default behavior is 'auto'.
    *
    * When this parameter is set, the response body will include the `service_tier`
    * utilized.
    */
-  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority' | 'fast' | null;
+  service_tier?: ServiceTier | null;
 
   /**
    * Whether to store the generated model response for later retrieval via API.
@@ -9096,6 +10303,8 @@ export interface ResponseCompactParams {
     | 'gpt-5.6-sol'
     | 'gpt-5.6-terra'
     | 'gpt-5.6-luna'
+    | 'gpt-5.5'
+    | 'gpt-5.5-2026-04-23'
     | 'gpt-5.4'
     | 'gpt-5.4-mini'
     | 'gpt-5.4-nano'
@@ -9184,10 +10393,15 @@ export interface ResponseCompactParams {
     | 'o4-mini-deep-research-2025-06-26'
     | 'computer-use-preview'
     | 'computer-use-preview-2025-03-11'
+    | 'gpt-5.5-pro'
+    | 'gpt-5.5-pro-2026-04-23'
     | 'gpt-5-codex'
     | 'gpt-5-pro'
     | 'gpt-5-pro-2025-10-06'
     | 'gpt-5.1-codex-max'
+    | 'gpt-daybreak-blue-latest'
+    | 'gpt-daybreak-red-latest'
+    | 'gpt-5.6-cyber'
     | (string & {})
     | null;
 
@@ -9308,10 +10522,12 @@ export declare namespace Responses {
     type FileSearchTool as FileSearchTool,
     type FunctionShellTool as FunctionShellTool,
     type FunctionTool as FunctionTool,
+    type ImageDetail as ImageDetail,
     type InlineSkill as InlineSkill,
     type InlineSkillSource as InlineSkillSource,
     type LocalEnvironment as LocalEnvironment,
     type LocalSkill as LocalSkill,
+    type McpToolCallError as McpToolCallError,
     type NamespaceTool as NamespaceTool,
     type Response as Response,
     type ResponseApplyPatchToolCall as ResponseApplyPatchToolCall,
@@ -9412,6 +10628,11 @@ export declare namespace Responses {
     type ResponseReasoningTextDoneEvent as ResponseReasoningTextDoneEvent,
     type ResponseRefusalDeltaEvent as ResponseRefusalDeltaEvent,
     type ResponseRefusalDoneEvent as ResponseRefusalDoneEvent,
+    type ResponseShellCallCommandAddedEvent as ResponseShellCallCommandAddedEvent,
+    type ResponseShellCallCommandDeltaEvent as ResponseShellCallCommandDeltaEvent,
+    type ResponseShellCallCommandDoneEvent as ResponseShellCallCommandDoneEvent,
+    type ResponseShellCallOutputContentDeltaEvent as ResponseShellCallOutputContentDeltaEvent,
+    type ResponseShellCallOutputContentDoneEvent as ResponseShellCallOutputContentDoneEvent,
     type ResponseStatus as ResponseStatus,
     type ResponseStreamEvent as ResponseStreamEvent,
     type ResponseTextConfig as ResponseTextConfig,
@@ -9426,6 +10647,7 @@ export declare namespace Responses {
     type ResponseWebSearchCallSearchingEvent as ResponseWebSearchCallSearchingEvent,
     type ResponsesClientEvent as ResponsesClientEvent,
     type ResponsesServerEvent as ResponsesServerEvent,
+    type ServiceTier as ServiceTier,
     type SkillReference as SkillReference,
     type Tool as Tool,
     type ToolChoiceAllowed as ToolChoiceAllowed,