openai 7.9.0 → 7.12.1

package/resources/responses/responses.d.ts

@@ -104,7 +104,7 @@ export declare class Responses extends APIResource {
      * @example
      * ```ts
      * const compactedResponse = await client.responses.compact({
-     *   model: 'gpt-5.6-sol',
+     *   model: 'gpt-6-astra',
      * });
      * ```
      */
@@ -464,6 +464,11 @@ export interface CustomTool {
      * The tool invocation context(s).
      */
     allowed_callers?: Array<'direct' | 'programmatic'> | null;
+    /**
+     * Whether the tool response can be returned asynchronously versus immediately
+     * returned on next response creation.
+     */
+    async?: boolean;
     /**
      * Whether this tool should be deferred and discovered via tool search.
      */
@@ -615,6 +620,7 @@ export interface FunctionTool {
      * The tool invocation context(s).
      */
     allowed_callers?: Array<'direct' | 'programmatic'> | null;
+    async?: boolean;
     /**
      * Whether this function is deferred and loaded via tool search.
      */
@@ -738,6 +744,11 @@ export declare namespace NamespaceTool {
          * The tool invocation context(s).
          */
         allowed_callers?: Array<'direct' | 'programmatic'> | null;
+        /**
+         * Whether the tool response can be returned asynchronously versus immediately
+         * returned on next response creation.
+         */
+        async?: boolean;
         /**
          * Whether this function should be deferred and discovered via tool search.
          */
@@ -795,7 +806,7 @@ export interface Response {
      */
     metadata: Shared.Metadata | null;
     /**
-     * Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI offers a wide
+     * Model ID used to generate the response, like `gpt-6-astra`. 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
@@ -901,6 +912,10 @@ export interface Response {
      * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
      */
     prompt?: ResponsePrompt | null;
+    /**
+     * Prompt cache diagnostics requested for this response.
+     */
+    prompt_cache_diagnostics?: Response.CacheMiss | Response.CacheHit | Response.ComparisonResponseNotFound | Response.Unavailable;
     /**
      * Used by OpenAI to cache responses for similar requests to optimize your cache
      * hit rates. Replaces the `user` field.
@@ -1022,9 +1037,11 @@ export declare namespace Response {
      */
     interface IncompleteDetails {
         /**
-         * The reason why the response is incomplete.
+         * The reason why the response is incomplete. `steered` means the response stopped
+         * at a safe output boundary after a WebSocket `response.steer` event. The server
+         * can then create a successor response automatically with the queued input.
          */
-        reason?: 'max_output_tokens' | 'max_messages' | 'content_filter';
+        reason?: 'max_output_tokens' | 'max_messages' | 'content_filter' | 'steered';
     }
     interface SpecificProgrammaticToolCallingParam {
         /**
@@ -1166,6 +1183,31 @@ export declare namespace Response {
             type: 'error';
         }
     }
+    interface CacheMiss {
+        /**
+         * The estimated number of input tokens affected after the first detected
+         * divergence.
+         */
+        cache_missed_tokens: number;
+        /**
+         * The reason prompt cache reuse did not occur.
+         */
+        reason: 'model_changed' | 'prompt_cache_key_changed' | 'tools_changed' | 'text_format_changed' | 'reasoning_effort_changed' | 'verbosity_changed' | 'context_compacted' | 'input_changed' | 'service_tier_changed';
+        type: 'cache_miss';
+        /**
+         * The raw token count of the reusable prefix in the compared response.
+         */
+        comparison_reusable_tokens?: number;
+    }
+    interface CacheHit {
+        type: 'cache_hit';
+    }
+    interface ComparisonResponseNotFound {
+        type: 'comparison_response_not_found';
+    }
+    interface Unavailable {
+        type: 'unavailable';
+    }
     /**
      * The prompt-caching options that were applied to the response. Supported for
      * `gpt-5.6` and later models.
@@ -1179,6 +1221,10 @@ export declare namespace Response {
          * The minimum lifetime applied to each cache breakpoint.
          */
         ttl: '30m';
+        /**
+         * The response ID supplied as the prompt cache diagnostics comparison.
+         */
+        comparison_response_id?: string | null;
     }
 }
 /**
@@ -1929,6 +1975,67 @@ export interface ResponseComputerToolCallOutputScreenshot {
      */
     image_url?: string;
 }
+/**
+ * A configuration update that applies to subsequent responses until it is replaced
+ * by another configuration update.
+ */
+export interface ResponseConfigurationUpdateItem {
+    /**
+     * The unique ID of the configuration update item.
+     */
+    id: string;
+    /**
+     * The item type. Always `configuration_update`.
+     */
+    type: 'configuration_update';
+    /**
+     * The reasoning configuration applied by this update.
+     */
+    reasoning?: ResponseConfigurationUpdateItem.Reasoning;
+}
+export declare namespace ResponseConfigurationUpdateItem {
+    /**
+     * The reasoning configuration applied by this update.
+     */
+    interface Reasoning {
+        /**
+         * The reasoning effort used for subsequent responses until another configuration
+         * update replaces it.
+         */
+        effort?: Shared.ReasoningEffort | null;
+    }
+}
+/**
+ * An update to the conversation's response configuration. The configuration
+ * remains in effect for subsequent responses until it is replaced by another
+ * configuration update.
+ */
+export interface ResponseConfigurationUpdateItemParam {
+    /**
+     * The item type. Always `configuration_update`.
+     */
+    type: 'configuration_update';
+    /**
+     * The unique ID of the configuration update item.
+     */
+    id?: string | null;
+    /**
+     * Updates to reasoning configuration. Only effort is supported.
+     */
+    reasoning?: ResponseConfigurationUpdateItemParam.Reasoning;
+}
+export declare namespace ResponseConfigurationUpdateItemParam {
+    /**
+     * Updates to reasoning configuration. Only effort is supported.
+     */
+    interface Reasoning {
+        /**
+         * The reasoning effort to use for subsequent responses until another configuration
+         * update replaces it.
+         */
+        effort?: Shared.ReasoningEffort | null;
+    }
+}
 /**
  * Represents a container created with /v1/containers.
  */
@@ -2096,6 +2203,10 @@ export interface ResponseCustomToolCall {
      * The unique ID of the custom tool call in the OpenAI platform.
      */
     id?: string;
+    /**
+     * Whether the custom tool call runs asynchronously.
+     */
+    async?: boolean;
     /**
      * The execution context that produced this tool call.
      */
@@ -2254,11 +2365,39 @@ export interface ResponseError {
     /**
      * The error code for the response.
      */
-    code: 'server_error' | 'rate_limit_exceeded' | 'invalid_prompt' | 'data_residency_mismatch' | 'bio_policy' | 'vector_store_timeout' | 'invalid_image' | 'invalid_image_format' | 'invalid_base64_image' | 'invalid_image_url' | 'image_too_large' | 'image_too_small' | 'image_parse_error' | 'image_content_policy_violation' | 'invalid_image_mode' | 'image_file_too_large' | 'unsupported_image_media_type' | 'empty_image_file' | 'failed_to_download_image' | 'image_file_not_found';
+    code: 'server_error' | 'rate_limit_exceeded' | 'invalid_prompt' | 'data_residency_mismatch' | 'bio_policy' | 'misalignment_policy_violation' | 'vector_store_timeout' | 'invalid_image' | 'invalid_image_format' | 'invalid_base64_image' | 'invalid_image_url' | 'image_too_large' | 'image_too_small' | 'image_parse_error' | 'image_content_policy_violation' | 'invalid_image_mode' | 'image_file_too_large' | 'unsupported_image_media_type' | 'empty_image_file' | 'failed_to_download_image' | 'image_file_not_found';
     /**
      * A human-readable description of the error.
      */
     message: string;
+    misalignment?: ResponseError.Misalignment;
+}
+export declare namespace ResponseError {
+    interface Misalignment {
+        /**
+         * The public explanation for this block.
+         */
+        detailed_explanation?: string;
+        /**
+         * An optional classification; clients must accept additional values.
+         */
+        error_type?: (string & {}) | 'potentially_unintended_data_transfer' | 'potentially_unintended_data_access' | 'potentially_unintended_destructive_activity' | 'other';
+        /**
+         * An optional public continuation instruction.
+         */
+        steer?: Misalignment.Steer;
+    }
+    namespace Misalignment {
+        /**
+         * An optional public continuation instruction.
+         */
+        interface Steer {
+            /**
+             * The public continuation instruction.
+             */
+            message: string;
+        }
+    }
 }
 /**
  * Emitted when an error occurs.
@@ -2512,10 +2651,6 @@ export interface ResponseFunctionCallArgumentsDoneEvent {
      * The ID of the item.
      */
     item_id: string;
-    /**
-     * The name of the function that was called.
-     */
-    name: string;
     /**
      * The index of the output item.
      */
@@ -2764,6 +2899,10 @@ export interface ResponseFunctionToolCall {
      * The unique ID of the function tool call.
      */
     id?: string;
+    /**
+     * Whether the function tool call runs asynchronously.
+     */
+    async?: boolean;
     /**
      * The execution context that produced this tool call.
      */
@@ -2886,7 +3025,7 @@ export interface ResponseFunctionWebSearch {
     /**
      * The status of the web search tool call.
      */
-    status: 'in_progress' | 'searching' | 'completed' | 'failed';
+    status: 'in_progress' | 'searching' | 'completed' | 'failed' | 'incomplete';
     /**
      * The type of the web search tool call. Always `web_search_call`.
      */
@@ -3116,6 +3255,10 @@ export interface ResponseInProgressEvent {
 export type ResponseIncludable = 'file_search_call.results' | 'web_search_call.results' | 'web_search_call.action.sources' | 'message.input_image.image_url' | 'computer_call_output.output.image_url' | 'code_interpreter_call.outputs' | 'reasoning.encrypted_content' | 'message.output_text.logprobs';
 /**
  * An event that is emitted when a response finishes as incomplete.
+ *
+ * Over WebSocket, steering can finish a response with
+ * `response.incomplete_details.reason` set to `steered`, followed automatically by
+ * a successor `response.created` that commits the queued steering input.
  */
 export interface ResponseIncompleteEvent {
     /**
@@ -3359,7 +3502,7 @@ export declare namespace ResponseInputImageContent {
  * `assistant` role are presumed to have been generated by the model in previous
  * interactions.
  */
-export type ResponseInputItem = EasyInputMessage | ResponseInputItem.Message | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseFunctionToolCall | ResponseInputItem.FunctionCallOutput | ResponseInputItem.ToolSearchCall | ResponseToolSearchOutputItemParam | ResponseInputItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItemParam | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.ShellCall | ResponseInputItem.ShellCallOutput | ResponseInputItem.ApplyPatchCall | ResponseInputItem.ApplyPatchCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseCustomToolCallOutput | ResponseCustomToolCall | ResponseInputItem.CompactionTrigger | ResponseInputItem.ItemReference | ResponseInputItem.Program | ResponseInputItem.ProgramOutput;
+export type ResponseInputItem = EasyInputMessage | ResponseInputItem.Message | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseFunctionToolCall | ResponseInputItem.FunctionCallOutput | ResponseInputItem.ToolSearchCall | ResponseToolSearchOutputItemParam | ResponseInputItem.AdditionalTools | ResponseConfigurationUpdateItemParam | ResponseReasoningItem | ResponseCompactionItemParam | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.ShellCall | ResponseInputItem.ShellCallOutput | ResponseInputItem.ApplyPatchCall | ResponseInputItem.ApplyPatchCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseCustomToolCallOutput | ResponseCustomToolCall | ResponseInputItem.CompactionTrigger | ResponseInputItem.ItemReference | ResponseInputItem.Program | ResponseInputItem.ProgramOutput;
 export declare namespace ResponseInputItem {
     /**
      * A message input to the model with a role indicating instruction following
@@ -3557,6 +3700,15 @@ export declare namespace ResponseInputItem {
          * The type of the image generation call. Always `image_generation_call`.
          */
         type: 'image_generation_call';
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     /**
      * A tool call to run a command on the local shell.
@@ -4213,7 +4365,7 @@ export declare namespace ResponseInputTextContent {
 /**
  * Content item used to generate a response.
  */
-export type ResponseItem = ResponseInputMessageItem | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseFunctionWebSearch | ResponseFunctionToolCallItem | ResponseFunctionToolCallOutputItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseItem.AdditionalTools | ResponseReasoningItem | ResponseItem.Program | ResponseItem.ProgramOutput | ResponseCompactionItem | ResponseItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseItem.LocalShellCall | ResponseItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseItem.McpListTools | ResponseItem.McpApprovalRequest | ResponseItem.McpApprovalResponse | ResponseItem.McpCall | ResponseCustomToolCallItem | ResponseCustomToolCallOutputItem;
+export type ResponseItem = ResponseInputMessageItem | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseFunctionWebSearch | ResponseFunctionToolCallItem | ResponseFunctionToolCallOutputItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseItem.AdditionalTools | ResponseConfigurationUpdateItem | ResponseReasoningItem | ResponseItem.Program | ResponseItem.ProgramOutput | ResponseCompactionItem | ResponseItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseItem.LocalShellCall | ResponseItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseItem.McpListTools | ResponseItem.McpApprovalRequest | ResponseItem.McpApprovalResponse | ResponseItem.McpCall | ResponseCustomToolCallItem | ResponseCustomToolCallOutputItem;
 export declare namespace ResponseItem {
     interface AdditionalTools {
         /**
@@ -4297,6 +4449,15 @@ export declare namespace ResponseItem {
          * The type of the image generation call. Always `image_generation_call`.
          */
         type: 'image_generation_call';
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     /**
      * A tool call to run a command on the local shell.
@@ -4812,6 +4973,15 @@ export declare namespace ResponseOutputItem {
          * The type of the image generation call. Always `image_generation_call`.
          */
         type: 'image_generation_call';
+        /**
+         * The quality of the image generated by the image generation tool call. One of
+         * `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto' | null;
+        /**
+         * The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+         */
+        size?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | null;
     }
     /**
      * A tool call to run a command on the local shell.
@@ -5964,773 +6134,1253 @@ export declare namespace ResponseShellCallOutputContentDoneEvent {
  */
 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:
+ * Emitted when steering input has been validated and queued. Acceptance means the
+ * server owns the input, not that it has been applied. The successor's
+ * `response.created` event is the commit point. If accepted input cannot be
+ * committed, `response.steer.failed` returns it with the same steering ID.
  *
- * - [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.
-     */
-    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.
+ * When the response stops for client-owned tool output or approval, the input
+ * remains queued and `response.steer.pending` is emitted after
+ * `response.completed`. Fill the pending event's `required_input` stubs with saved
+ * results and send one matching explicit `response.create` per parent. Do not
+ * resend accepted input while it is still queued.
  */
-export interface ResponseTextDeltaEvent {
-    /**
-     * The index of the content part that the text delta was added to.
-     */
-    content_index: number;
-    /**
-     * The text delta that was added.
-     */
-    delta: string;
-    /**
-     * The ID of the output item that the text delta was added to.
-     */
-    item_id: string;
+export interface ResponseSteerAcceptedEvent {
     /**
-     * The log probabilities of the tokens in the delta.
+     * The sequence number for this event.
      */
-    logprobs: Array<ResponseTextDeltaEvent.Logprob>;
+    sequence_number: number;
     /**
-     * The index of the output item that the text delta was added to.
+     * The accepted steering submission.
      */
-    output_index: number;
+    steer: ResponseSteerAcceptedEvent.Steer;
     /**
-     * The sequence number for this event.
+     * The event discriminator. Always `response.steer.accepted`.
      */
-    sequence_number: number;
+    type: 'response.steer.accepted';
     /**
-     * The type of the event. Always `response.output_text.delta`.
+     * The WebSocket lane that emitted this event. This field is present when the
+     * target response's `response.create` event supplied a `stream_id`.
      */
-    type: 'response.output_text.delta';
+    stream_id?: string;
 }
-export declare namespace ResponseTextDeltaEvent {
+export declare namespace ResponseSteerAcceptedEvent {
     /**
-     * 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 accepted steering submission.
      */
-    interface Logprob {
-        /**
-         * A possible text token.
-         */
-        token: string;
+    interface Steer {
         /**
-         * The log probability of this token.
+         * The ID assigned to the steering submission.
          */
-        logprob: number;
+        id: string;
         /**
-         * The log probabilities of up to 20 of the most likely tokens.
+         * The ID of the response being steered.
          */
-        top_logprobs?: Array<Logprob.TopLogprob>;
-    }
-    namespace Logprob {
-        interface TopLogprob {
-            /**
-             * A possible text token.
-             */
-            token?: string;
-            /**
-             * The log probability of this token.
-             */
-            logprob?: number;
-        }
+        previous_response_id: string;
     }
 }
 /**
- * Emitted when text content is finalized.
+ * A machine-readable steering error code. Clients should handle unknown values
+ * because additional codes may be introduced. Known values include:
+ *
+ * - `response_not_found`: The target response is not available on this connection.
+ * - `invalid_input`: The event or input failed validation.
+ * - `steering_not_supported`: The model or response execution mode does not
+ *   support steering.
+ * - `too_many_pending_steers`: Too much steering input is pending for the
+ *   response.
+ * - `response_already_completed`: The response completed and is no longer
+ *   accepting steering input.
+ * - `response_not_active`: The response is no longer accepting steering input.
+ * - `successor_creation_failed`: The successor response could not be created.
+ */
+export type ResponseSteerErrorCode = 'response_not_found' | 'invalid_input' | 'steering_not_supported' | 'too_many_pending_steers' | 'response_already_completed' | 'response_not_active' | 'successor_creation_failed' | (string & {});
+/**
+ * Queues user input to steer a response on this WebSocket connection. Input can
+ * contain text, images, and files. Steering is supported only for single-agent
+ * responses on models and execution modes that support steering. Responses bound
+ * to a conversation or using automatic compaction do not support steering.
+ *
+ * A `response.steer.accepted` event acknowledges that the server owns the queued
+ * input, not that it has been applied. The successor's `response.created` event is
+ * the commit point. Input that cannot be committed is returned in
+ * `response.steer.failed`.
+ *
+ * Steering may cause the active response to finish at a safe output boundary with
+ * `response.incomplete` and `incomplete_details.reason` set to `steered`, followed
+ * automatically by a successor `response.created`. Normal completion can also be
+ * followed by an automatic successor. Automatic successors inherit the previous
+ * response's settings and continue from it with the queued input.
+ *
+ * If the response stops for client-owned tool output or approval, accepted
+ * steering input remains queued and `response.steer.pending` is emitted after
+ * `response.completed`. Fill the `required_input` stubs from that event with saved
+ * tool results or approval decisions, and send one explicit `response.create` per
+ * parent with the same `previous_response_id` and WebSocket lane. Do not rerun
+ * tools or resend accepted steering input. The queued input is prepended in
+ * submission order to that request's input, and the explicit request retains its
+ * own settings.
+ *
+ * This event accepts only `type`, `previous_response_id`, and `input`. Do not send
+ * `stream_id`; the target response determines the WebSocket lane.
  */
-export interface ResponseTextDoneEvent {
+export interface ResponseSteerEvent {
     /**
-     * The index of the content part that the text content is finalized.
+     * Input to queue for a continuation of the response. Uses the same string or
+     * input-item shape as `response.create.input`, with a non-empty array when
+     * supplying input items.
+     *
+     * Steering accepts only messages with the `user` role. Each message may contain
+     * only `type`, `role`, and `content`, with `content` as a string or an array of
+     * `input_text`, `input_image`, and `input_file` parts. The optional `type` must be
+     * `message`. Other roles, tool outputs, and item types are not supported for
+     * steering.
      */
-    content_index: number;
+    input: ResponseSteerInput;
     /**
-     * The ID of the output item that the text content is finalized.
+     * The ID of the response to steer on this WebSocket connection.
      */
-    item_id: string;
+    previous_response_id: string;
     /**
-     * The log probabilities of the tokens in the delta.
+     * The event discriminator. Always `response.steer`.
      */
-    logprobs: Array<ResponseTextDoneEvent.Logprob>;
+    type: 'response.steer';
+}
+/**
+ * Emitted when steering input is rejected or cannot be committed to a successor
+ * response. Returns the original, uncommitted input so the client can carry it
+ * into `response.create` when appropriate. Invalid input must be corrected before
+ * retrying.
+ *
+ * Failures after acceptance include the same steering ID. Failures before an ID is
+ * allocated omit `steer.id`. A lost connection or missing acknowledgement leaves
+ * the outcome unknown; it is not proof that the input was rejected.
+ */
+export interface ResponseSteerFailedEvent {
     /**
-     * The index of the output item that the text content is finalized.
+     * Information about why the input could not be committed.
      */
-    output_index: number;
+    error: ResponseSteerFailedEvent.Error;
     /**
      * The sequence number for this event.
      */
     sequence_number: number;
     /**
-     * The text content that is finalized.
+     * The steering submission that could not be committed.
      */
-    text: string;
+    steer: ResponseSteerFailedEvent.Steer;
     /**
-     * The type of the event. Always `response.output_text.done`.
+     * The event discriminator. Always `response.steer.failed`.
      */
-    type: 'response.output_text.done';
+    type: 'response.steer.failed';
+    /**
+     * The WebSocket lane that emitted this event, when the target response is
+     * available and its `response.create` event supplied a `stream_id`.
+     */
+    stream_id?: string;
 }
-export declare namespace ResponseTextDoneEvent {
+export declare namespace ResponseSteerFailedEvent {
     /**
-     * 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.
+     * Information about why the input could not be committed.
      */
-    interface Logprob {
+    interface Error {
         /**
-         * A possible text token.
+         * A machine-readable steering error code. Clients should handle unknown values
+         * because additional codes may be introduced. Known values include:
+         *
+         * - `response_not_found`: The target response is not available on this connection.
+         * - `invalid_input`: The event or input failed validation.
+         * - `steering_not_supported`: The model or response execution mode does not
+         *   support steering.
+         * - `too_many_pending_steers`: Too much steering input is pending for the
+         *   response.
+         * - `response_already_completed`: The response completed and is no longer
+         *   accepting steering input.
+         * - `response_not_active`: The response is no longer accepting steering input.
+         * - `successor_creation_failed`: The successor response could not be created.
          */
-        token: string;
+        code: ResponsesAPI.ResponseSteerErrorCode;
         /**
-         * The log probability of this token.
+         * A human-readable description of the error.
          */
-        logprob: number;
+        message: string;
         /**
-         * The log probabilities of up to 20 of the most likely tokens.
+         * The error type. Always `invalid_request_error`.
          */
-        top_logprobs?: Array<Logprob.TopLogprob>;
-    }
-    namespace Logprob {
-        interface TopLogprob {
-            /**
-             * A possible text token.
-             */
-            token?: string;
-            /**
-             * The log probability of this token.
-             */
-            logprob?: number;
-        }
+        type: 'invalid_request_error';
     }
-}
-export interface ResponseToolSearchCall {
     /**
-     * The unique ID of the tool search call item.
+     * The steering submission that could not be committed.
      */
-    id: string;
+    interface Steer {
+        /**
+         * Input to queue for a continuation of the response. Uses the same string or
+         * input-item shape as `response.create.input`, with a non-empty array when
+         * supplying input items.
+         *
+         * Steering accepts only messages with the `user` role. Each message may contain
+         * only `type`, `role`, and `content`, with `content` as a string or an array of
+         * `input_text`, `input_image`, and `input_file` parts. The optional `type` must be
+         * `message`. Other roles, tool outputs, and item types are not supported for
+         * steering.
+         */
+        input: ResponsesAPI.ResponseSteerInput;
+        /**
+         * The ID of the response that was targeted for steering.
+         */
+        previous_response_id: string;
+        /**
+         * The ID assigned to the steering submission, if one was allocated.
+         */
+        id?: string;
+    }
+}
+/**
+ * Input to queue for a continuation of the response. Uses the same string or
+ * input-item shape as `response.create.input`, with a non-empty array when
+ * supplying input items.
+ *
+ * Steering accepts only messages with the `user` role. Each message may contain
+ * only `type`, `role`, and `content`, with `content` as a string or an array of
+ * `input_text`, `input_image`, and `input_file` parts. The optional `type` must be
+ * `message`. Other roles, tool outputs, and item types are not supported for
+ * steering.
+ */
+export type ResponseSteerInput = string | Array<ResponseSteerInputItemList.Message | ResponseSteerInputItemList.FunctionCallOutput>;
+export declare namespace ResponseSteerInputItemList {
+    interface Message {
+        /**
+         * The message content, as an array of content parts.
+         */
+        content: Array<ResponsesAPI.ResponseSteerInputContent> | string;
+        /**
+         * The message role. Always `user`.
+         */
+        role: 'user';
+        /**
+         * The item type. Always `message`.
+         */
+        type: 'message';
+        /**
+         * The unique ID of this message item.
+         */
+        id?: string | null;
+        /**
+         * The status of the message item.
+         */
+        status?: string | null;
+    }
     /**
-     * Arguments used for the tool search call.
+     * The output of a function tool 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';
+    interface FunctionCallOutput {
+        /**
+         * Text, image, or file output of the function tool call.
+         */
+        output: string | ResponsesAPI.ResponseFunctionCallOutputItemList;
+        /**
+         * The type of the function tool call output. Always `function_call_output`.
+         */
+        type: 'function_call_output';
+        /**
+         * The unique ID of the function tool call output. Populated when this item is
+         * returned via API.
+         */
+        id?: string | null;
+        /**
+         * The unique ID of the function tool call generated by the model.
+         */
+        call_id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        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.
+         */
+        status?: 'in_progress' | 'completed' | 'incomplete' | null;
+    }
+    namespace FunctionCallOutput {
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
+    }
+}
+/**
+ * A piece of message content, such as text, an image, or a file.
+ */
+export type ResponseSteerInputContent = ResponseInputTextContent | ResponseInputImageContent | ResponseInputFileContent;
+/**
+ * Emitted when accepted steering input remains queued after the target response
+ * completes. The server still owns the input. Do not resend it. The successor's
+ * `response.created` event is the commit point.
+ *
+ * When `reason` is `waiting_for_required_input`, this event follows
+ * `response.completed` while the response waits for the tool results or approval
+ * decisions identified by `required_input`. Copy those stubs, fill their result
+ * fields using the ordinary `response.create` input schemas, and submit one
+ * continuation per parent with the same `previous_response_id` and WebSocket lane.
+ * Use saved results without rerunning tools. The queued steering input is
+ * prepended in submission order to the continuation's input. That explicit request
+ * retains its own settings.
+ *
+ * This notification is emitted at most once per steering submission. Multiple
+ * submissions for the same parent can report the same required inputs; they do not
+ * each require a separate continuation.
+ */
+export interface ResponseSteerPendingEvent {
     /**
-     * The status of the tool search call item that was recorded.
+     * An extensible enum describing why accepted steering input is still queued.
+     * Clients should handle unknown values because additional reasons may be
+     * introduced. Known values include:
+     *
+     * - `waiting_for_required_input`: The response is waiting for the tool results or
+     *   approval decisions identified by `required_input`.
      */
-    status: 'in_progress' | 'completed' | 'incomplete';
+    reason: ResponseSteerPendingReason;
     /**
-     * The type of the item. Always `tool_search_call`.
+     * Input stubs identifying outstanding client-owned tool results or approval
+     * decisions. Each stub contains identifying fields only; the client supplies the
+     * result before including it in `response.create`.
      */
-    type: 'tool_search_call';
+    required_input: Array<ResponseSteerRequiredInput>;
     /**
-     * The identifier of the actor that created the item.
+     * The sequence number for this event.
      */
-    created_by?: string;
-}
-export interface ResponseToolSearchOutputItem {
+    sequence_number: number;
     /**
-     * The unique ID of the tool search output item.
+     * The steering submission that remains queued.
      */
-    id: string;
+    steer: ResponseSteerPendingEvent.Steer;
     /**
-     * The unique ID of the tool search call generated by the model.
+     * The event discriminator. Always `response.steer.pending`.
      */
-    call_id: string | null;
+    type: 'response.steer.pending';
     /**
-     * Whether tool search was executed by the server or by the client.
+     * The WebSocket lane that emitted this event. This field is present when the
+     * target response's `response.create` event supplied a `stream_id`.
      */
-    execution: 'server' | 'client';
+    stream_id?: string;
+}
+export declare namespace ResponseSteerPendingEvent {
     /**
-     * The status of the tool search output item that was recorded.
+     * The steering submission that remains queued.
      */
-    status: 'in_progress' | 'completed' | 'incomplete';
+    interface Steer {
+        /**
+         * The ID assigned to the steering submission.
+         */
+        id: string;
+        /**
+         * The ID of the response being steered.
+         */
+        previous_response_id: string;
+    }
+}
+/**
+ * An extensible enum describing why accepted steering input is still queued.
+ * Clients should handle unknown values because additional reasons may be
+ * introduced. Known values include:
+ *
+ * - `waiting_for_required_input`: The response is waiting for the tool results or
+ *   approval decisions identified by `required_input`.
+ */
+export type ResponseSteerPendingReason = 'waiting_for_required_input' | (string & {});
+/**
+ * An input stub identifying an outstanding client-owned tool result or approval
+ * decision. Copy the stub and fill the result fields using the corresponding
+ * `response.create` input schema. Use saved results without rerunning the tool.
+ * The server does not supply results, approval decisions, or safety
+ * acknowledgements in these stubs.
+ */
+export type ResponseSteerRequiredInput = ResponseSteerRequiredInput.FunctionCallOutput | ResponseSteerRequiredInput.CustomToolCallOutput | ResponseSteerRequiredInput.ComputerCallOutput | ResponseSteerRequiredInput.ShellCallOutput | ResponseSteerRequiredInput.ApplyPatchCallOutput | ResponseSteerRequiredInput.ToolSearchOutput | ResponseSteerRequiredInput.McpApprovalResponse;
+export declare namespace ResponseSteerRequiredInput {
     /**
-     * The loaded tool definitions returned by tool search.
+     * Supply `output` using the function tool call output input schema.
      */
-    tools: Array<Tool>;
+    interface FunctionCallOutput {
+        call_id: string;
+        name: string;
+        type: 'function_call_output';
+    }
     /**
-     * The type of the item. Always `tool_search_output`.
+     * Supply `output` using the custom tool call output input schema. The original
+     * custom tool call supplies the tool's name.
      */
-    type: 'tool_search_output';
+    interface CustomToolCallOutput {
+        call_id: string;
+        type: 'custom_tool_call_output';
+    }
     /**
-     * The identifier of the actor that created the item.
+     * Supply `output` using the computer tool call output input schema, including any
+     * required `acknowledged_safety_checks`.
      */
-    created_by?: string;
-}
-export interface ResponseToolSearchOutputItemParam {
+    interface ComputerCallOutput {
+        call_id: string;
+        type: 'computer_call_output';
+    }
     /**
-     * The loaded tool definitions returned by the tool search output.
+     * Supply `output` using the shell tool call output input schema. Each output entry
+     * includes `stdout`, `stderr`, and `outcome`.
      */
-    tools: Array<Tool>;
+    interface ShellCallOutput {
+        call_id: string;
+        type: 'shell_call_output';
+    }
     /**
-     * The item type. Always `tool_search_output`.
+     * Supply `status` and optional `output` using the apply patch tool call output
+     * input schema.
      */
-    type: 'tool_search_output';
+    interface ApplyPatchCallOutput {
+        call_id: string;
+        type: 'apply_patch_call_output';
+    }
     /**
-     * The unique ID of this tool search output.
+     * Supply `tools` using the tool search output input schema, retaining
+     * `execution: "client"`.
      */
-    id?: string | null;
+    interface ToolSearchOutput {
+        call_id: string;
+        execution: 'client';
+        type: 'tool_search_output';
+    }
     /**
-     * The unique ID of the tool search call generated by the model.
+     * Supply `approve` using the MCP approval response input schema. An optional
+     * `reason` can be supplied when denying the request. The original approval request
+     * identifies the tool and server.
      */
-    call_id?: string | null;
+    interface McpApprovalResponse {
+        approval_request_id: string;
+        type: 'mcp_approval_response';
+    }
+}
+/**
+ * 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 {
     /**
-     * Whether tool search was executed by the server or by the client.
+     * 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.
      */
-    execution?: 'server' | 'client';
+    format?: ResponseFormatTextConfig;
     /**
-     * The status of the tool search output.
+     * 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`.
      */
-    status?: 'in_progress' | 'completed' | 'incomplete' | null;
+    verbosity?: 'low' | 'medium' | 'high' | null;
 }
 /**
- * Represents token usage details including input tokens, output tokens, a
- * breakdown of output tokens, and the total tokens used.
+ * Emitted when there is an additional text delta.
  */
-export interface ResponseUsage {
+export interface ResponseTextDeltaEvent {
     /**
-     * The number of input tokens.
+     * The index of the content part that the text delta was added to.
      */
-    input_tokens: number;
+    content_index: number;
     /**
-     * A detailed breakdown of the input tokens.
+     * The text delta that was added.
      */
-    input_tokens_details: ResponseUsage.InputTokensDetails;
+    delta: string;
     /**
-     * The number of output tokens.
+     * The ID of the output item that the text delta was added to.
      */
-    output_tokens: number;
+    item_id: string;
     /**
-     * A detailed breakdown of the output tokens.
+     * The log probabilities of the tokens in the delta.
      */
-    output_tokens_details: ResponseUsage.OutputTokensDetails;
+    logprobs: Array<ResponseTextDeltaEvent.Logprob>;
     /**
-     * The total number of tokens used.
+     * The index of the output item that the text delta was added to.
      */
-    total_tokens: number;
+    output_index: number;
+    /**
+     * The sequence number for this event.
+     */
+    sequence_number: number;
+    /**
+     * The type of the event. Always `response.output_text.delta`.
+     */
+    type: 'response.output_text.delta';
 }
-export declare namespace ResponseUsage {
+export declare namespace ResponseTextDeltaEvent {
     /**
-     * A detailed breakdown of the input tokens.
+     * 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.
      */
-    interface InputTokensDetails {
+    interface Logprob {
         /**
-         * The number of input tokens that were written to the cache.
+         * A possible text token.
          */
-        cache_write_tokens: number;
+        token: string;
         /**
-         * The number of tokens that were retrieved from the cache.
-         * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+         * The log probability of this token.
          */
-        cached_tokens: number;
-    }
-    /**
-     * A detailed breakdown of the output tokens.
-     */
-    interface OutputTokensDetails {
+        logprob: number;
         /**
-         * The number of reasoning tokens.
+         * The log probabilities of up to 20 of the most likely tokens.
          */
-        reasoning_tokens: number;
+        top_logprobs?: Array<Logprob.TopLogprob>;
+    }
+    namespace Logprob {
+        interface TopLogprob {
+            /**
+             * A possible text token.
+             */
+            token?: string;
+            /**
+             * The log probability of this token.
+             */
+            logprob?: number;
+        }
     }
 }
 /**
- * Emitted when a web search call is completed.
+ * Emitted when text content is finalized.
  */
-export interface ResponseWebSearchCallCompletedEvent {
+export interface ResponseTextDoneEvent {
     /**
-     * Unique ID for the output item associated with the web search call.
+     * The index of the content part that the text content is finalized.
      */
-    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;
+    content_index: number;
     /**
-     * The type of the event. Always `response.web_search_call.completed`.
+     * The ID of the output item that the text content is finalized.
      */
-    type: 'response.web_search_call.completed';
-}
-/**
- * Emitted when a web search call is initiated.
- */
-export interface ResponseWebSearchCallInProgressEvent {
+    item_id: string;
     /**
-     * Unique ID for the output item associated with the web search call.
+     * The log probabilities of the tokens in the delta.
      */
-    item_id: string;
+    logprobs: Array<ResponseTextDoneEvent.Logprob>;
     /**
-     * The index of the output item that the web search call is associated with.
+     * The index of the output item that the text content is finalized.
      */
     output_index: number;
     /**
-     * The sequence number of the web search call being processed.
+     * The sequence number for this event.
      */
     sequence_number: number;
     /**
-     * The type of the event. Always `response.web_search_call.in_progress`.
+     * The text content that is finalized.
      */
-    type: 'response.web_search_call.in_progress';
+    text: string;
+    /**
+     * The type of the event. Always `response.output_text.done`.
+     */
+    type: 'response.output_text.done';
 }
-/**
- * Emitted when a web search call is executing.
- */
-export interface ResponseWebSearchCallSearchingEvent {
+export declare namespace ResponseTextDoneEvent {
     /**
-     * Unique ID for the output item associated with the web search call.
+     * 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.
      */
-    item_id: string;
+    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>;
+    }
+    namespace Logprob {
+        interface TopLogprob {
+            /**
+             * A possible text token.
+             */
+            token?: string;
+            /**
+             * The log probability of this token.
+             */
+            logprob?: number;
+        }
+    }
+}
+export interface ResponseToolSearchCall {
     /**
-     * The index of the output item that the web search call is associated with.
+     * The unique ID of the tool search call item.
      */
-    output_index: number;
+    id: string;
     /**
-     * The sequence number of the web search call being processed.
+     * Arguments used for the tool search call.
      */
-    sequence_number: number;
+    arguments: unknown;
     /**
-     * The type of the event. Always `response.web_search_call.searching`.
+     * The unique ID of the tool search call generated by the model.
      */
-    type: 'response.web_search_call.searching';
-}
-export interface ResponsesClientEvent {
+    call_id: string | null;
     /**
-     * The type of the client event. Always `response.create`.
+     * Whether tool search was executed by the server or by the client.
      */
-    type: 'response.create';
+    execution: 'server' | 'client';
     /**
-     * Whether to run the model response in the background.
-     * [Learn more](https://platform.openai.com/docs/guides/background).
+     * The status of the tool search call item that was recorded.
      */
-    background?: boolean | null;
+    status: 'in_progress' | 'completed' | 'incomplete';
     /**
-     * Context management configuration for this request.
+     * The type of the item. Always `tool_search_call`.
      */
-    context_management?: Array<ResponsesClientEvent.ContextManagement> | null;
+    type: 'tool_search_call';
     /**
-     * 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.
+     * The identifier of the actor that created the item.
      */
-    conversation?: string | ResponseConversationParam | null;
+    created_by?: string;
+}
+export interface ResponseToolSearchOutputItem {
     /**
-     * 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).
+     * The unique ID of the tool search output item.
      */
-    include?: Array<ResponseIncludable> | null;
+    id: string;
     /**
-     * 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)
+     * The unique ID of the tool search call generated by the model.
      */
-    input?: string | ResponseInput;
+    call_id: string | null;
     /**
-     * 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.
+     * Whether tool search was executed by the server or by the client.
      */
-    instructions?: string | null;
+    execution: 'server' | 'client';
     /**
-     * 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).
+     * The status of the tool search output item that was recorded.
      */
-    max_output_tokens?: number | null;
+    status: 'in_progress' | 'completed' | 'incomplete';
     /**
-     * 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.
+     * The loaded tool definitions returned by tool search.
      */
-    max_tool_calls?: number | null;
+    tools: Array<Tool>;
     /**
-     * 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.
+     * The type of the item. Always `tool_search_output`.
      */
-    metadata?: Shared.Metadata | null;
+    type: 'tool_search_output';
     /**
-     * Model ID used to generate the response, like `gpt-5.6-sol`. 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.
+     * The identifier of the actor that created the item.
      */
-    model?: Shared.ResponsesModel;
+    created_by?: string;
+}
+export interface ResponseToolSearchOutputItemParam {
     /**
-     * Configuration for running moderation on the input and output of this response.
+     * The loaded tool definitions returned by the tool search output.
      */
-    moderation?: ResponsesClientEvent.Moderation | null;
+    tools: Array<Tool>;
     /**
-     * Whether to allow the model to run tool calls in parallel.
+     * The item type. Always `tool_search_output`.
      */
-    parallel_tool_calls?: boolean | null;
+    type: 'tool_search_output';
     /**
-     * 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`.
+     * The unique ID of this tool search output.
      */
-    previous_response_id?: string | null;
+    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).
+     * The unique ID of the tool search call generated by the model.
      */
-    prompt?: ResponsePrompt | null;
+    call_id?: string | 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).
+     * Whether tool search was executed by the server or by the client.
      */
-    prompt_cache_key?: string | null;
+    execution?: 'server' | 'client';
     /**
-     * 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.
+     * The status of the tool search output.
      */
-    prompt_cache_options?: ResponsesClientEvent.PromptCacheOptions;
+    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.
+ */
+export interface ResponseUsage {
     /**
-     * @deprecated Deprecated. Use `prompt_cache_options.ttl` instead.
-     *
-     * 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).
-     * This field expresses a maximum retention policy, while
-     * `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
-     * are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
-     * models, only `24h` is supported.
-     *
-     * For older models that support both `in_memory` and `24h`, the default depends on
-     * your organization's data retention policy:
-     *
-     * - Organizations without ZDR enabled default to `24h`.
-     * - Organizations with ZDR enabled default to `in_memory` when
-     *   `prompt_cache_retention` is not specified.
+     * The number of input tokens.
      */
-    prompt_cache_retention?: 'in_memory' | '24h' | null;
+    input_tokens: number;
     /**
-     * Configuration options for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     * A detailed breakdown of the input tokens.
      */
-    reasoning?: Shared.Reasoning | null;
+    input_tokens_details: ResponseUsage.InputTokensDetails;
     /**
-     * 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).
+     * The number of output tokens.
      */
-    safety_identifier?: string | null;
+    output_tokens: number;
     /**
-     * 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.
+     * A detailed breakdown of the output tokens.
      */
-    service_tier?: ServiceTier | null;
+    output_tokens_details: ResponseUsage.OutputTokensDetails;
     /**
-     * Whether to store the generated model response for later retrieval via API.
+     * The total number of tokens used.
      */
-    store?: boolean | null;
+    total_tokens: number;
+}
+export declare namespace ResponseUsage {
     /**
-     * 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.
+     * A detailed breakdown of the input tokens.
      */
-    stream?: boolean | null;
+    interface InputTokensDetails {
+        /**
+         * The number of input tokens that were written to the cache.
+         */
+        cache_write_tokens: number;
+        /**
+         * 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;
+    }
     /**
-     * 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.
+     * A detailed breakdown of the output tokens.
      */
-    stream_id?: string;
+    interface OutputTokensDetails {
+        /**
+         * The number of reasoning tokens.
+         */
+        reasoning_tokens: number;
+    }
+}
+/**
+ * Emitted when a web search call is completed.
+ */
+export interface ResponseWebSearchCallCompletedEvent {
     /**
-     * Options for streaming responses. Only set this when you set `stream: true`.
+     * Unique ID for the output item associated with the web search call.
      */
-    stream_options?: ResponsesClientEvent.StreamOptions | null;
+    item_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.
+     * The index of the output item that the web search call is associated with.
      */
-    temperature?: number | null;
+    output_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)
+     * The sequence number of the web search call being processed.
      */
-    text?: ResponseTextConfig;
+    sequence_number: number;
     /**
-     * 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.
+     * The type of the event. Always `response.web_search_call.completed`.
      */
-    tool_choice?: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ResponsesClientEvent.SpecificProgrammaticToolCallingParam | ToolChoiceApplyPatch | ToolChoiceShell;
+    type: 'response.web_search_call.completed';
+}
+/**
+ * Emitted when a web search call is initiated.
+ */
+export interface ResponseWebSearchCallInProgressEvent {
     /**
-     * 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.
+     * Unique ID for the output item associated with the web search call.
      */
-    tools?: Array<Tool>;
+    item_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.
+     * The index of the output item that the web search call is associated with.
      */
-    top_logprobs?: number | null;
+    output_index: number;
     /**
-     * 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.
+     * The sequence number of the web search call being processed.
      */
-    top_p?: number | null;
+    sequence_number: number;
     /**
-     * @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.
+     * The type of the event. Always `response.web_search_call.in_progress`.
      */
-    truncation?: 'auto' | 'disabled' | null;
+    type: 'response.web_search_call.in_progress';
+}
+/**
+ * Emitted when a web search call is executing.
+ */
+export interface ResponseWebSearchCallSearchingEvent {
     /**
-     * @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).
+     * Unique ID for the output item associated with the web search call.
      */
-    user?: string;
+    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';
 }
+/**
+ * Client events accepted by the Responses WebSocket server.
+ */
+export type ResponsesClientEvent = ResponsesClientEvent.ResponseCreate | ResponseSteerEvent;
 export declare namespace ResponsesClientEvent {
-    interface ContextManagement {
+    type ContextManagement = ResponseCreate.ContextManagement;
+    type Moderation = ResponseCreate.Moderation;
+    namespace Moderation {
+        type Policy = ResponseCreate.Moderation.Policy;
+        namespace Policy {
+            type Input = ResponseCreate.Moderation.Policy.Input;
+            type Output = ResponseCreate.Moderation.Policy.Output;
+        }
+    }
+    type PromptCacheOptions = ResponseCreate.PromptCacheOptions;
+    type StreamOptions = ResponseCreate.StreamOptions;
+    type SpecificProgrammaticToolCallingParam = ResponseCreate.SpecificProgrammaticToolCallingParam;
+    /**
+     * Client event for creating a response over a persistent WebSocket connection.
+     * This payload uses the same top-level fields as `POST /v1/responses`, plus
+     * WebSocket-only envelope metadata.
+     *
+     * Notes:
+     *
+     * - `stream` is implicit over WebSocket and should not be sent.
+     * - `background` is not supported over WebSocket.
+     * - `stream_id` is WebSocket-only and is not part of `POST /v1/responses`.
+     */
+    interface ResponseCreate {
         /**
-         * The context management entry type. Currently only 'compaction' is supported.
+         * The type of the client event. Always `response.create`.
          */
-        type: string;
+        type: 'response.create';
         /**
-         * Token threshold at which compaction should be triggered for this entry.
+         * Whether to run the model response in the background.
+         * [Learn more](https://platform.openai.com/docs/guides/background).
          */
-        compact_threshold?: number | null;
-    }
-    /**
-     * Configuration for running moderation on the input and output of this response.
-     */
-    interface Moderation {
+        background?: boolean | null;
         /**
-         * The moderation model to use for moderated completions, e.g.
-         * 'omni-moderation-latest'.
+         * Context management configuration for this request.
          */
-        model: string;
+        context_management?: Array<ResponseCreate.ContextManagement> | null;
         /**
-         * The policy to apply to moderated response input and output.
+         * 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.
          */
-        policy?: Moderation.Policy | null;
-    }
-    namespace Moderation {
+        conversation?: string | ResponsesAPI.ResponseConversationParam | null;
         /**
-         * The policy to apply to moderated response input and output.
+         * 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<ResponsesAPI.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)
          */
-        interface Policy {
+        input?: string | ResponsesAPI.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-6-astra`. 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;
+        /**
+         * Configuration for running moderation on the input and output of this response.
+         */
+        moderation?: ResponseCreate.Moderation | null;
+        /**
+         * 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?: ResponsesAPI.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 | null;
+        /**
+         * 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.
+         */
+        prompt_cache_options?: ResponseCreate.PromptCacheOptions;
+        /**
+         * @deprecated Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * 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).
+         * This field expresses a maximum retention policy, while
+         * `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
+         * are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
+         * models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on
+         * your organization's data retention policy:
+         *
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when
+         *   `prompt_cache_retention` is not specified.
+         */
+        prompt_cache_retention?: 'in_memory' | '24h' | null;
+        /**
+         * 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 | null;
+        /**
+         * 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.
+         */
+        service_tier?: ResponsesAPI.ServiceTier | null;
+        /**
+         * Whether to store the generated model response for later retrieval via API.
+         * Defaults to true when omitted. If set to true, response data will be stored for
+         * at least 30 days, subject to the
+         * [data retention exceptions](/api/docs/guides/your-data#v1responses).
+         */
+        store?: boolean | null;
+        /**
+         * 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.
+         */
+        stream?: boolean | null;
+        /**
+         * 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?: ResponseCreate.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?: ResponsesAPI.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?: ResponsesAPI.ToolChoiceOptions | ResponsesAPI.ToolChoiceAllowed | ResponsesAPI.ToolChoiceTypes | ResponsesAPI.ToolChoiceFunction | ResponsesAPI.ToolChoiceMcp | ResponsesAPI.ToolChoiceCustom | ResponseCreate.SpecificProgrammaticToolCallingParam | ResponsesAPI.ToolChoiceApplyPatch | ResponsesAPI.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<ResponsesAPI.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;
+    }
+    namespace ResponseCreate {
+        interface ContextManagement {
             /**
-             * The moderation policy for the response input.
+             * The context management entry type. Currently only 'compaction' is supported.
              */
-            input?: Policy.Input | null;
+            type: string;
             /**
-             * The moderation policy for the response output.
+             * Token threshold at which compaction should be triggered for this entry.
              */
-            output?: Policy.Output | null;
+            compact_threshold?: number | null;
         }
-        namespace Policy {
+        /**
+         * Configuration for running moderation on the input and output of this response.
+         */
+        interface Moderation {
             /**
-             * The moderation policy for the response input.
+             * The moderation model to use for moderated completions, e.g.
+             * 'omni-moderation-latest'.
              */
-            interface Input {
-                mode: 'score' | 'block';
-            }
+            model: string;
             /**
-             * The moderation policy for the response output.
+             * The policy to apply to moderated response input and output.
              */
-            interface Output {
-                mode: 'score' | 'block';
+            policy?: Moderation.Policy | null;
+        }
+        namespace Moderation {
+            /**
+             * The policy to apply to moderated response input and output.
+             */
+            interface Policy {
+                /**
+                 * The moderation policy for the response input.
+                 */
+                input?: Policy.Input | null;
+                /**
+                 * The moderation policy for the response output.
+                 */
+                output?: Policy.Output | null;
+            }
+            namespace Policy {
+                /**
+                 * The moderation policy for the response input.
+                 */
+                interface Input {
+                    mode: 'score' | 'block';
+                }
+                /**
+                 * The moderation policy for the response output.
+                 */
+                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.
-     */
-    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`.
-     */
-    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;
-    }
-    interface SpecificProgrammaticToolCallingParam {
+         * 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.
+         */
+        interface PromptCacheOptions {
+            /**
+             * The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+             * this field requests prompt cache diagnostics when the feature is enabled.
+             */
+            comparison_response_id?: string | null;
+            /**
+             * 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';
+        }
         /**
-         * The tool to call. Always `programmatic_tool_calling`.
+         * Options for streaming responses. Only set this when you set `stream: true`.
          */
-        type: 'programmatic_tool_calling';
+        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;
+        }
+        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 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 | ResponseSteerAcceptedEvent | ResponseSteerPendingEvent | ResponseSteerFailedEvent;
 export declare namespace ResponsesServerEvent {
     /**
      * Emitted when there is a partial audio response.
@@ -6984,6 +7634,10 @@ export declare namespace ResponsesServerEvent {
     }
     /**
      * An event that is emitted when a response finishes as incomplete.
+     *
+     * Over WebSocket, steering can finish a response with
+     * `response.incomplete_details.reason` set to `steered`, followed automatically by
+     * a successor `response.created` that commits the queued steering input.
      */
     interface ResponseWsIncomplete extends ResponseIncompleteEvent {
         /**
@@ -7369,6 +8023,34 @@ export declare namespace ResponsesServerEvent {
             headers?: {
                 [key: string]: string;
             };
+            misalignment?: Error.Misalignment;
+        }
+        namespace Error {
+            interface Misalignment {
+                /**
+                 * The public explanation for this block.
+                 */
+                detailed_explanation?: string;
+                /**
+                 * An optional classification; clients must accept additional values.
+                 */
+                error_type?: (string & {}) | 'potentially_unintended_data_transfer' | 'potentially_unintended_data_access' | 'potentially_unintended_destructive_activity' | 'other';
+                /**
+                 * An optional public continuation instruction.
+                 */
+                steer?: Misalignment.Steer;
+            }
+            namespace Misalignment {
+                /**
+                 * An optional public continuation instruction.
+                 */
+                interface Steer {
+                    /**
+                     * The public continuation instruction.
+                     */
+                    message: string;
+                }
+            }
         }
     }
 }
@@ -7626,9 +8308,11 @@ export declare namespace Tool {
          * one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
          * the model will automatically determine the best background for the image.
          *
-         * Transparent backgrounds are available for supported GPT Image models. For
-         * `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-         * using `transparent`, set the output format to `png` or `webp`.
+         * `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+         * snapshots, support `opaque` and `transparent` backgrounds. Transparent
+         * backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+         * `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+         * set the output format to `png` or `webp`.
          */
         background?: 'transparent' | 'opaque' | 'auto';
         /**
@@ -7645,10 +8329,12 @@ export declare namespace Tool {
         input_image_mask?: ImageGeneration.InputImageMask;
         /**
          * The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-         * `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+         * `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+         * `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+         * `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
          * `chatgpt-image-latest`. Default: `gpt-image-1`.
          */
-        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';
+        model?: (string & {}) | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-2' | 'gpt-image-2-2026-04-21' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-1.5' | 'chatgpt-image-latest';
         /**
          * Moderation level for the generated image. Default: `auto`.
          */
@@ -7668,22 +8354,25 @@ export declare namespace Tool {
          */
         partial_images?: number;
         /**
-         * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-         * Default: `auto`.
-         */
-        quality?: 'low' | 'medium' | 'high' | '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`.
+         * The quality of the generated image. The GPT image models support `low`,
+         * `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+         * including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+         * `auto`.
+         */
+        quality?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
+        /**
+         * The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+         * `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+         * `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, 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?: (string & {}) | '1024x1024' | '1024x1536' | '1536x1024' | 'auto';
     }
@@ -8062,7 +8751,7 @@ export interface ResponseCreateParamsBase {
      */
     metadata?: Shared.Metadata | null;
     /**
-     * Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI offers a wide
+     * Model ID used to generate the response, like `gpt-6-astra`. 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
@@ -8169,6 +8858,9 @@ export interface ResponseCreateParamsBase {
     service_tier?: ServiceTier | null;
     /**
      * Whether to store the generated model response for later retrieval via API.
+     * Defaults to true when omitted. If set to true, response data will be stored for
+     * at least 30 days, subject to the
+     * [data retention exceptions](/api/docs/guides/your-data#v1responses).
      */
     store?: boolean | null;
     /**
@@ -8327,6 +9019,11 @@ export declare namespace ResponseCreateParams {
      * for current details.
      */
     interface PromptCacheOptions {
+        /**
+         * The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+         * this field requests prompt cache diagnostics when the feature is enabled.
+         */
+        comparison_response_id?: string | null;
         /**
          * Controls whether OpenAI automatically creates an implicit cache breakpoint.
          * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -8446,13 +9143,13 @@ export interface ResponseRetrieveParamsStreaming extends ResponseRetrieveParamsB
 }
 export interface ResponseCompactParams {
     /**
-     * Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI offers a wide
+     * Model ID used to generate the response, like `gpt-6-astra`. 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: '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' | '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' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | '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;
+    model: 'gpt-6-astra' | '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' | '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' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | '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;
     /**
      * Text, image, or file inputs to the model, used to generate a response
      */
@@ -8501,12 +9198,13 @@ export interface ResponseCompactParams {
      * 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. - 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.
+     * Completions. For models with a dedicated Fast tier, either value resolves to
+     * `service_tier=fast`; for other models, either value resolves to
+     * `service_tier=priority`. - 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.
      */
     service_tier?: 'auto' | 'default' | 'fast' | 'flex' | 'priority' | null;
 }
@@ -8541,7 +9239,7 @@ export declare namespace ResponseCompactParams {
     }
 }
 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, type ContainerNetworkPolicyDomainSecret as ContainerNetworkPolicyDomainSecret, type ContainerReference as ContainerReference, type CustomTool as CustomTool, type EasyInputMessage as EasyInputMessage, 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, type ResponseApplyPatchToolCallOutput as ResponseApplyPatchToolCallOutput, type ResponseAudioDeltaEvent as ResponseAudioDeltaEvent, type ResponseAudioDoneEvent as ResponseAudioDoneEvent, type ResponseAudioTranscriptDeltaEvent as ResponseAudioTranscriptDeltaEvent, type ResponseAudioTranscriptDoneEvent as ResponseAudioTranscriptDoneEvent, type ResponseCodeInterpreterCallCodeDeltaEvent as ResponseCodeInterpreterCallCodeDeltaEvent, type ResponseCodeInterpreterCallCodeDoneEvent as ResponseCodeInterpreterCallCodeDoneEvent, type ResponseCodeInterpreterCallCompletedEvent as ResponseCodeInterpreterCallCompletedEvent, type ResponseCodeInterpreterCallInProgressEvent as ResponseCodeInterpreterCallInProgressEvent, type ResponseCodeInterpreterCallInterpretingEvent as ResponseCodeInterpreterCallInterpretingEvent, type ResponseCodeInterpreterToolCall as ResponseCodeInterpreterToolCall, type ResponseCompactionItem as ResponseCompactionItem, type ResponseCompactionItemParam as ResponseCompactionItemParam, type ResponseCompletedEvent as ResponseCompletedEvent, type ResponseComputerToolCall as ResponseComputerToolCall, type ResponseComputerToolCallOutputItem as ResponseComputerToolCallOutputItem, type ResponseComputerToolCallOutputScreenshot as ResponseComputerToolCallOutputScreenshot, type ResponseContainerReference as ResponseContainerReference, type ResponseContent as ResponseContent, type ResponseContentPartAddedEvent as ResponseContentPartAddedEvent, type ResponseContentPartDoneEvent as ResponseContentPartDoneEvent, type ResponseConversationParam as ResponseConversationParam, type ResponseCreatedEvent as ResponseCreatedEvent, 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, type ResponseFileSearchCallCompletedEvent as ResponseFileSearchCallCompletedEvent, type ResponseFileSearchCallInProgressEvent as ResponseFileSearchCallInProgressEvent, type ResponseFileSearchCallSearchingEvent as ResponseFileSearchCallSearchingEvent, type ResponseFileSearchToolCall as ResponseFileSearchToolCall, type ResponseFormatTextConfig as ResponseFormatTextConfig, type ResponseFormatTextJSONSchemaConfig as ResponseFormatTextJSONSchemaConfig, type ResponseFunctionCallArgumentsDeltaEvent as ResponseFunctionCallArgumentsDeltaEvent, type ResponseFunctionCallArgumentsDoneEvent as ResponseFunctionCallArgumentsDoneEvent, type ResponseFunctionCallOutputItem as ResponseFunctionCallOutputItem, type ResponseFunctionCallOutputItemList as ResponseFunctionCallOutputItemList, type ResponseFunctionShellCallOutputContent as ResponseFunctionShellCallOutputContent, type ResponseFunctionShellToolCall as ResponseFunctionShellToolCall, type ResponseFunctionShellToolCallOutput as ResponseFunctionShellToolCallOutput, type ResponseFunctionToolCall as ResponseFunctionToolCall, type ResponseFunctionToolCallItem as ResponseFunctionToolCallItem, type ResponseFunctionToolCallOutputItem as ResponseFunctionToolCallOutputItem, type ResponseFunctionWebSearch as ResponseFunctionWebSearch, type ResponseImageGenCallCompletedEvent as ResponseImageGenCallCompletedEvent, type ResponseImageGenCallGeneratingEvent as ResponseImageGenCallGeneratingEvent, type ResponseImageGenCallInProgressEvent as ResponseImageGenCallInProgressEvent, type ResponseImageGenCallPartialImageEvent as ResponseImageGenCallPartialImageEvent, type ResponseInProgressEvent as ResponseInProgressEvent, type ResponseIncludable as ResponseIncludable, type ResponseIncompleteEvent as ResponseIncompleteEvent, type ResponseInput as ResponseInput, type ResponseInputAudio as ResponseInputAudio, type ResponseInputContent as ResponseInputContent, type ResponseInputFile as ResponseInputFile, type ResponseInputFileContent as ResponseInputFileContent, type ResponseInputImage as ResponseInputImage, type ResponseInputImageContent as ResponseInputImageContent, type ResponseInputItem as ResponseInputItem, type ResponseInputMessageContentList as ResponseInputMessageContentList, type ResponseInputMessageItem as ResponseInputMessageItem, type ResponseInputText as ResponseInputText, type ResponseInputTextContent as ResponseInputTextContent, type ResponseItem as ResponseItem, type ResponseLocalEnvironment as ResponseLocalEnvironment, type ResponseMcpCallArgumentsDeltaEvent as ResponseMcpCallArgumentsDeltaEvent, type ResponseMcpCallArgumentsDoneEvent as ResponseMcpCallArgumentsDoneEvent, type ResponseMcpCallCompletedEvent as ResponseMcpCallCompletedEvent, type ResponseMcpCallFailedEvent as ResponseMcpCallFailedEvent, type ResponseMcpCallInProgressEvent as ResponseMcpCallInProgressEvent, type ResponseMcpListToolsCompletedEvent as ResponseMcpListToolsCompletedEvent, type ResponseMcpListToolsFailedEvent as ResponseMcpListToolsFailedEvent, type ResponseMcpListToolsInProgressEvent as ResponseMcpListToolsInProgressEvent, type ResponseOutputAudio as ResponseOutputAudio, type ResponseOutputItem as ResponseOutputItem, type ResponseOutputItemAddedEvent as ResponseOutputItemAddedEvent, type ResponseOutputItemDoneEvent as ResponseOutputItemDoneEvent, type ResponseOutputMessage as ResponseOutputMessage, type ResponseOutputRefusal as ResponseOutputRefusal, type ResponseOutputText as ResponseOutputText, type ResponseOutputTextAnnotationAddedEvent as ResponseOutputTextAnnotationAddedEvent, type ResponsePrompt as ResponsePrompt, type ResponseQueuedEvent as ResponseQueuedEvent, type ResponseReasoningItem as ResponseReasoningItem, type ResponseReasoningSummaryPartAddedEvent as ResponseReasoningSummaryPartAddedEvent, type ResponseReasoningSummaryPartDoneEvent as ResponseReasoningSummaryPartDoneEvent, type ResponseReasoningSummaryTextDeltaEvent as ResponseReasoningSummaryTextDeltaEvent, type ResponseReasoningSummaryTextDoneEvent as ResponseReasoningSummaryTextDoneEvent, type ResponseReasoningTextDeltaEvent as ResponseReasoningTextDeltaEvent, 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, 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 ServiceTier as ServiceTier, type SkillReference as SkillReference, type Tool as Tool, type ToolChoiceAllowed as ToolChoiceAllowed, type ToolChoiceApplyPatch as ToolChoiceApplyPatch, type ToolChoiceCustom as ToolChoiceCustom, type ToolChoiceFunction as ToolChoiceFunction, type ToolChoiceMcp as ToolChoiceMcp, 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, type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming, type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming, type ResponseRetrieveParams as ResponseRetrieveParams, type ResponseRetrieveParamsNonStreaming as ResponseRetrieveParamsNonStreaming, type ResponseRetrieveParamsStreaming as ResponseRetrieveParamsStreaming, type ResponseCompactParams as ResponseCompactParams, };
+    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, type ContainerNetworkPolicyDomainSecret as ContainerNetworkPolicyDomainSecret, type ContainerReference as ContainerReference, type CustomTool as CustomTool, type EasyInputMessage as EasyInputMessage, 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, type ResponseApplyPatchToolCallOutput as ResponseApplyPatchToolCallOutput, type ResponseAudioDeltaEvent as ResponseAudioDeltaEvent, type ResponseAudioDoneEvent as ResponseAudioDoneEvent, type ResponseAudioTranscriptDeltaEvent as ResponseAudioTranscriptDeltaEvent, type ResponseAudioTranscriptDoneEvent as ResponseAudioTranscriptDoneEvent, type ResponseCodeInterpreterCallCodeDeltaEvent as ResponseCodeInterpreterCallCodeDeltaEvent, type ResponseCodeInterpreterCallCodeDoneEvent as ResponseCodeInterpreterCallCodeDoneEvent, type ResponseCodeInterpreterCallCompletedEvent as ResponseCodeInterpreterCallCompletedEvent, type ResponseCodeInterpreterCallInProgressEvent as ResponseCodeInterpreterCallInProgressEvent, type ResponseCodeInterpreterCallInterpretingEvent as ResponseCodeInterpreterCallInterpretingEvent, type ResponseCodeInterpreterToolCall as ResponseCodeInterpreterToolCall, type ResponseCompactionItem as ResponseCompactionItem, type ResponseCompactionItemParam as ResponseCompactionItemParam, type ResponseCompletedEvent as ResponseCompletedEvent, type ResponseComputerToolCall as ResponseComputerToolCall, type ResponseComputerToolCallOutputItem as ResponseComputerToolCallOutputItem, type ResponseComputerToolCallOutputScreenshot as ResponseComputerToolCallOutputScreenshot, type ResponseConfigurationUpdateItem as ResponseConfigurationUpdateItem, type ResponseConfigurationUpdateItemParam as ResponseConfigurationUpdateItemParam, type ResponseContainerReference as ResponseContainerReference, type ResponseContent as ResponseContent, type ResponseContentPartAddedEvent as ResponseContentPartAddedEvent, type ResponseContentPartDoneEvent as ResponseContentPartDoneEvent, type ResponseConversationParam as ResponseConversationParam, type ResponseCreatedEvent as ResponseCreatedEvent, 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, type ResponseFileSearchCallCompletedEvent as ResponseFileSearchCallCompletedEvent, type ResponseFileSearchCallInProgressEvent as ResponseFileSearchCallInProgressEvent, type ResponseFileSearchCallSearchingEvent as ResponseFileSearchCallSearchingEvent, type ResponseFileSearchToolCall as ResponseFileSearchToolCall, type ResponseFormatTextConfig as ResponseFormatTextConfig, type ResponseFormatTextJSONSchemaConfig as ResponseFormatTextJSONSchemaConfig, type ResponseFunctionCallArgumentsDeltaEvent as ResponseFunctionCallArgumentsDeltaEvent, type ResponseFunctionCallArgumentsDoneEvent as ResponseFunctionCallArgumentsDoneEvent, type ResponseFunctionCallOutputItem as ResponseFunctionCallOutputItem, type ResponseFunctionCallOutputItemList as ResponseFunctionCallOutputItemList, type ResponseFunctionShellCallOutputContent as ResponseFunctionShellCallOutputContent, type ResponseFunctionShellToolCall as ResponseFunctionShellToolCall, type ResponseFunctionShellToolCallOutput as ResponseFunctionShellToolCallOutput, type ResponseFunctionToolCall as ResponseFunctionToolCall, type ResponseFunctionToolCallItem as ResponseFunctionToolCallItem, type ResponseFunctionToolCallOutputItem as ResponseFunctionToolCallOutputItem, type ResponseFunctionWebSearch as ResponseFunctionWebSearch, type ResponseImageGenCallCompletedEvent as ResponseImageGenCallCompletedEvent, type ResponseImageGenCallGeneratingEvent as ResponseImageGenCallGeneratingEvent, type ResponseImageGenCallInProgressEvent as ResponseImageGenCallInProgressEvent, type ResponseImageGenCallPartialImageEvent as ResponseImageGenCallPartialImageEvent, type ResponseInProgressEvent as ResponseInProgressEvent, type ResponseIncludable as ResponseIncludable, type ResponseIncompleteEvent as ResponseIncompleteEvent, type ResponseInput as ResponseInput, type ResponseInputAudio as ResponseInputAudio, type ResponseInputContent as ResponseInputContent, type ResponseInputFile as ResponseInputFile, type ResponseInputFileContent as ResponseInputFileContent, type ResponseInputImage as ResponseInputImage, type ResponseInputImageContent as ResponseInputImageContent, type ResponseInputItem as ResponseInputItem, type ResponseInputMessageContentList as ResponseInputMessageContentList, type ResponseInputMessageItem as ResponseInputMessageItem, type ResponseInputText as ResponseInputText, type ResponseInputTextContent as ResponseInputTextContent, type ResponseItem as ResponseItem, type ResponseLocalEnvironment as ResponseLocalEnvironment, type ResponseMcpCallArgumentsDeltaEvent as ResponseMcpCallArgumentsDeltaEvent, type ResponseMcpCallArgumentsDoneEvent as ResponseMcpCallArgumentsDoneEvent, type ResponseMcpCallCompletedEvent as ResponseMcpCallCompletedEvent, type ResponseMcpCallFailedEvent as ResponseMcpCallFailedEvent, type ResponseMcpCallInProgressEvent as ResponseMcpCallInProgressEvent, type ResponseMcpListToolsCompletedEvent as ResponseMcpListToolsCompletedEvent, type ResponseMcpListToolsFailedEvent as ResponseMcpListToolsFailedEvent, type ResponseMcpListToolsInProgressEvent as ResponseMcpListToolsInProgressEvent, type ResponseOutputAudio as ResponseOutputAudio, type ResponseOutputItem as ResponseOutputItem, type ResponseOutputItemAddedEvent as ResponseOutputItemAddedEvent, type ResponseOutputItemDoneEvent as ResponseOutputItemDoneEvent, type ResponseOutputMessage as ResponseOutputMessage, type ResponseOutputRefusal as ResponseOutputRefusal, type ResponseOutputText as ResponseOutputText, type ResponseOutputTextAnnotationAddedEvent as ResponseOutputTextAnnotationAddedEvent, type ResponsePrompt as ResponsePrompt, type ResponseQueuedEvent as ResponseQueuedEvent, type ResponseReasoningItem as ResponseReasoningItem, type ResponseReasoningSummaryPartAddedEvent as ResponseReasoningSummaryPartAddedEvent, type ResponseReasoningSummaryPartDoneEvent as ResponseReasoningSummaryPartDoneEvent, type ResponseReasoningSummaryTextDeltaEvent as ResponseReasoningSummaryTextDeltaEvent, type ResponseReasoningSummaryTextDoneEvent as ResponseReasoningSummaryTextDoneEvent, type ResponseReasoningTextDeltaEvent as ResponseReasoningTextDeltaEvent, 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 ResponseSteerAcceptedEvent as ResponseSteerAcceptedEvent, type ResponseSteerErrorCode as ResponseSteerErrorCode, type ResponseSteerEvent as ResponseSteerEvent, type ResponseSteerFailedEvent as ResponseSteerFailedEvent, type ResponseSteerInput as ResponseSteerInput, type ResponseSteerInputContent as ResponseSteerInputContent, type ResponseSteerPendingEvent as ResponseSteerPendingEvent, type ResponseSteerPendingReason as ResponseSteerPendingReason, type ResponseSteerRequiredInput as ResponseSteerRequiredInput, type ResponseStreamEvent as ResponseStreamEvent, 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 ServiceTier as ServiceTier, type SkillReference as SkillReference, type Tool as Tool, type ToolChoiceAllowed as ToolChoiceAllowed, type ToolChoiceApplyPatch as ToolChoiceApplyPatch, type ToolChoiceCustom as ToolChoiceCustom, type ToolChoiceFunction as ToolChoiceFunction, type ToolChoiceMcp as ToolChoiceMcp, 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, type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming, type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming, type ResponseRetrieveParams as ResponseRetrieveParams, type ResponseRetrieveParamsNonStreaming as ResponseRetrieveParamsNonStreaming, type ResponseRetrieveParamsStreaming as ResponseRetrieveParamsStreaming, type ResponseCompactParams as ResponseCompactParams, };
     export { InputItems as InputItems, type ResponseItemList as ResponseItemList, type InputItemListParams as InputItemListParams, };
     export { InputTokens as InputTokens, type InputTokenCountResponse as InputTokenCountResponse, type InputTokenCountParams as InputTokenCountParams, };
 }