llama-stack-client 0.3.4-rc3 → 0.4.0-rc1

package/resources/responses/responses.d.ts

@@ -9,22 +9,22 @@ import { Stream } from "../../streaming.js";
 export declare class Responses extends APIResource {
     inputItems: InputItemsAPI.InputItems;
     /**
-     * Create a new OpenAI response.
+     * Create a model response.
      */
     create(body: ResponseCreateParamsNonStreaming, options?: Core.RequestOptions): APIPromise<ResponseObject>;
     create(body: ResponseCreateParamsStreaming, options?: Core.RequestOptions): APIPromise<Stream<ResponseObjectStream>>;
     create(body: ResponseCreateParamsBase, options?: Core.RequestOptions): APIPromise<Stream<ResponseObjectStream> | ResponseObject>;
     /**
-     * Retrieve an OpenAI response by its ID.
+     * Get a model response.
      */
     retrieve(responseId: string, options?: Core.RequestOptions): Core.APIPromise<ResponseObject>;
     /**
-     * List all OpenAI responses.
+     * List all responses.
      */
     list(query?: ResponseListParams, options?: Core.RequestOptions): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
     list(options?: Core.RequestOptions): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
     /**
-     * Delete an OpenAI response by its ID.
+     * Delete a response.
      */
     delete(responseId: string, options?: Core.RequestOptions): Core.APIPromise<ResponseDeleteResponse>;
 }
@@ -34,62 +34,39 @@ export declare class ResponseListResponsesOpenAICursorPage extends OpenAICursorP
  * Complete OpenAI response object containing generation results and metadata.
  */
 export interface ResponseObject {
-    /**
-     * Unique identifier for this response
-     */
     id: string;
-    /**
-     * Unix timestamp when the response was created
-     */
     created_at: number;
-    /**
-     * Model identifier used for generation
-     */
     model: string;
-    /**
-     * Object type identifier, always "response"
-     */
-    object: 'response';
-    /**
-     * List of generated output items (messages, tool calls, etc.)
-     */
-    output: Array<ResponseObject.OpenAIResponseMessage | ResponseObject.OpenAIResponseOutputMessageWebSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFileSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFunctionToolCall | ResponseObject.OpenAIResponseOutputMessageMcpCall | ResponseObject.OpenAIResponseOutputMessageMcpListTools>;
-    /**
-     * Whether tool calls can be executed in parallel
-     */
-    parallel_tool_calls: boolean;
-    /**
-     * Current status of the response generation
-     */
+    output: Array<ResponseObject.OpenAIResponseMessageOutput | ResponseObject.OpenAIResponseOutputMessageWebSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFileSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFunctionToolCall | ResponseObject.OpenAIResponseOutputMessageMcpCall | ResponseObject.OpenAIResponseOutputMessageMcpListTools | ResponseObject.OpenAIResponseMcpApprovalRequest>;
     status: string;
     /**
-     * Text formatting configuration for the response
-     */
-    text: ResponseObject.Text;
-    /**
-     * (Optional) Error details if the response generation failed
+     * Error details for failed OpenAI response requests.
      */
-    error?: ResponseObject.Error;
+    error?: ResponseObject.Error | null;
+    instructions?: string | null;
+    max_tool_calls?: number | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    object?: 'response';
+    parallel_tool_calls?: boolean | null;
+    previous_response_id?: string | null;
     /**
-     * (Optional) ID of the previous response in a conversation
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
      */
-    previous_response_id?: string;
+    prompt?: ResponseObject.Prompt | null;
+    temperature?: number | null;
     /**
-     * (Optional) Sampling temperature used for generation
-     */
-    temperature?: number;
-    /**
-     * (Optional) Nucleus sampling parameter used for generation
-     */
-    top_p?: number;
-    /**
-     * (Optional) Truncation strategy applied to the response
+     * Text response configuration for OpenAI responses.
      */
-    truncation?: string;
+    text?: ResponseObject.Text;
+    tools?: Array<ResponseObject.OpenAIResponseInputToolWebSearch | ResponseObject.OpenAIResponseInputToolFileSearch | ResponseObject.OpenAIResponseInputToolFunction | ResponseObject.OpenAIResponseToolMcp> | null;
+    top_p?: number | null;
+    truncation?: string | null;
     /**
-     * (Optional) User identifier associated with the request
+     * Usage information for OpenAI response.
      */
-    user?: string;
+    usage?: ResponseObject.Usage | null;
 }
 export declare namespace ResponseObject {
     /**
@@ -97,95 +74,64 @@ export declare namespace ResponseObject {
      * under one type because the Responses API gives them all the same "type" value,
      * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseMessage {
-        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+    interface OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
         role: 'system' | 'developer' | 'user' | 'assistant';
-        type: 'message';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
     }
-    namespace OpenAIResponseMessage {
+    namespace OpenAIResponseMessageOutput {
         /**
          * Text content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentText {
-            /**
-             * The text content of the input message
-             */
             text: string;
-            /**
-             * Content type identifier, always "input_text"
-             */
-            type: 'input_text';
+            type?: 'input_text';
         }
         /**
          * Image content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentImage {
-            /**
-             * Level of detail for image processing, can be "low", "high", or "auto"
-             */
-            detail: 'low' | 'high' | 'auto';
-            /**
-             * Content type identifier, always "input_image"
-             */
-            type: 'input_image';
-            /**
-             * (Optional) URL of the image content
-             */
-            image_url?: string;
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
         }
-        interface UnionMember2 {
-            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+        interface OpenAIResponseOutputMessageContentOutputText {
             text: string;
-            type: 'output_text';
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
         }
-        namespace UnionMember2 {
+        namespace OpenAIResponseOutputMessageContentOutputText {
             /**
              * File citation annotation for referencing specific files in response content.
              */
             interface OpenAIResponseAnnotationFileCitation {
-                /**
-                 * Unique identifier of the referenced file
-                 */
                 file_id: string;
-                /**
-                 * Name of the referenced file
-                 */
                 filename: string;
-                /**
-                 * Position index of the citation within the content
-                 */
                 index: number;
-                /**
-                 * Annotation type identifier, always "file_citation"
-                 */
-                type: 'file_citation';
+                type?: 'file_citation';
             }
             /**
              * URL citation annotation for referencing external web resources.
              */
             interface OpenAIResponseAnnotationCitation {
-                /**
-                 * End position of the citation span in the content
-                 */
                 end_index: number;
-                /**
-                 * Start position of the citation span in the content
-                 */
                 start_index: number;
-                /**
-                 * Title of the referenced web resource
-                 */
                 title: string;
-                /**
-                 * Annotation type identifier, always "url_citation"
-                 */
-                type: 'url_citation';
-                /**
-                 * URL of the referenced web resource
-                 */
                 url: string;
+                type?: 'url_citation';
             }
             interface OpenAIResponseAnnotationContainerFileCitation {
                 container_id: string;
@@ -193,83 +139,51 @@ export declare namespace ResponseObject {
                 file_id: string;
                 filename: string;
                 start_index: number;
-                type: 'container_file_citation';
+                type?: 'container_file_citation';
             }
             interface OpenAIResponseAnnotationFilePath {
                 file_id: string;
                 index: number;
-                type: 'file_path';
+                type?: 'file_path';
             }
         }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
     }
     /**
      * Web search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageWebSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * Current status of the web search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "web_search_call"
-         */
-        type: 'web_search_call';
+        type?: 'web_search_call';
     }
     /**
      * File search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFileSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * List of search queries executed
-         */
         queries: Array<string>;
-        /**
-         * Current status of the file search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "file_search_call"
-         */
-        type: 'file_search_call';
-        /**
-         * (Optional) Search results returned by the file search operation
-         */
-        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
     }
     namespace OpenAIResponseOutputMessageFileSearchToolCall {
         /**
          * Search results returned by the file search operation.
          */
         interface Result {
-            /**
-             * (Optional) Key-value attributes associated with the file
-             */
             attributes: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Unique identifier of the file containing the result
-             */
             file_id: string;
-            /**
-             * Name of the file containing the result
-             */
             filename: string;
-            /**
-             * Relevance score for this search result (between 0 and 1)
-             */
             score: number;
-            /**
-             * Text content of the search result
-             */
             text: string;
         }
     }
@@ -277,202 +191,257 @@ export declare namespace ResponseObject {
      * Function tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFunctionToolCall {
-        /**
-         * JSON string containing the function arguments
-         */
         arguments: string;
-        /**
-         * Unique identifier for the function call
-         */
         call_id: string;
-        /**
-         * Name of the function being called
-         */
         name: string;
-        /**
-         * Tool call type identifier, always "function_call"
-         */
-        type: 'function_call';
-        /**
-         * (Optional) Additional identifier for the tool call
-         */
-        id?: string;
-        /**
-         * (Optional) Current status of the function call execution
-         */
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call';
     }
     /**
      * Model Context Protocol (MCP) call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageMcpCall {
-        /**
-         * Unique identifier for this MCP call
-         */
         id: string;
-        /**
-         * JSON string containing the MCP call arguments
-         */
         arguments: string;
-        /**
-         * Name of the MCP method being called
-         */
         name: string;
-        /**
-         * Label identifying the MCP server handling the call
-         */
         server_label: string;
-        /**
-         * Tool call type identifier, always "mcp_call"
-         */
-        type: 'mcp_call';
-        /**
-         * (Optional) Error message if the MCP call failed
-         */
-        error?: string;
-        /**
-         * (Optional) Output result from the successful MCP call
-         */
-        output?: string;
+        error?: string | null;
+        output?: string | null;
+        type?: 'mcp_call';
     }
     /**
      * MCP list tools output message containing available tools from an MCP server.
      */
     interface OpenAIResponseOutputMessageMcpListTools {
-        /**
-         * Unique identifier for this MCP list tools operation
-         */
         id: string;
-        /**
-         * Label identifying the MCP server providing the tools
-         */
         server_label: string;
-        /**
-         * List of available tools provided by the MCP server
-         */
         tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
-        /**
-         * Tool call type identifier, always "mcp_list_tools"
-         */
-        type: 'mcp_list_tools';
+        type?: 'mcp_list_tools';
     }
     namespace OpenAIResponseOutputMessageMcpListTools {
         /**
          * Tool definition returned by MCP list tools operation.
          */
         interface Tool {
-            /**
-             * JSON schema defining the tool's input parameters
-             */
             input_schema: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Name of the tool
-             */
             name: string;
-            /**
-             * (Optional) Description of what the tool does
-             */
-            description?: string;
+            description?: string | null;
+        }
+    }
+    /**
+     * A request for human approval of a tool invocation.
+     */
+    interface OpenAIResponseMcpApprovalRequest {
+        id: string;
+        arguments: string;
+        name: string;
+        server_label: string;
+        type?: 'mcp_approval_request';
+    }
+    /**
+     * Error details for failed OpenAI response requests.
+     */
+    interface Error {
+        code: string;
+        message: string;
+    }
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    interface Prompt {
+        id: string;
+        variables?: {
+            [key: string]: Prompt.OpenAIResponseInputMessageContentText | Prompt.OpenAIResponseInputMessageContentImage | Prompt.OpenAIResponseInputMessageContentFile;
+        } | null;
+        version?: string | null;
+    }
+    namespace Prompt {
+        /**
+         * Text content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentText {
+            text: string;
+            type?: 'input_text';
+        }
+        /**
+         * Image content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentImage {
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
         }
     }
     /**
-     * Text formatting configuration for the response
+     * Text response configuration for OpenAI responses.
      */
     interface Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
-        format?: Text.Format;
+        format?: Text.Format | null;
     }
     namespace Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
         interface Format {
-            /**
-             * Must be "text", "json_schema", or "json_object" to identify the format type
-             */
-            type: 'text' | 'json_schema' | 'json_object';
-            /**
-             * (Optional) A description of the response format. Only used for json_schema.
-             */
-            description?: string;
-            /**
-             * The name of the response format. Only used for json_schema.
-             */
-            name?: string;
-            /**
-             * The JSON schema the response should conform to. In a Python SDK, this is often a
-             * `pydantic` model. Only used for json_schema.
-             */
+            description?: string | null;
+            name?: string | null;
             schema?: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-            };
-            /**
-             * (Optional) Whether to strictly enforce the JSON schema. If true, the response
-             * must match the schema exactly. Only used for json_schema.
-             */
-            strict?: boolean;
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
         }
     }
     /**
-     * (Optional) Error details if the response generation failed
+     * Web search tool configuration for OpenAI response inputs.
+     */
+    interface OpenAIResponseInputToolWebSearch {
+        search_context_size?: string | null;
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
+    }
+    /**
+     * File search tool configuration for OpenAI response inputs.
      */
-    interface Error {
+    interface OpenAIResponseInputToolFileSearch {
+        vector_store_ids: Array<string>;
+        filters?: {
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
         /**
-         * Error code identifying the type of failure
+         * Options for ranking and filtering search results.
          */
-        code: string;
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
+    }
+    namespace OpenAIResponseInputToolFileSearch {
         /**
-         * Human-readable error message describing the failure
+         * Options for ranking and filtering search results.
          */
-        message: string;
+        interface RankingOptions {
+            ranker?: string | null;
+            score_threshold?: number | null;
+        }
+    }
+    /**
+     * Function tool configuration for OpenAI response inputs.
+     */
+    interface OpenAIResponseInputToolFunction {
+        name: string;
+        parameters: {
+            [key: string]: unknown;
+        } | null;
+        description?: string | null;
+        strict?: boolean | null;
+        type?: 'function';
+    }
+    /**
+     * Model Context Protocol (MCP) tool configuration for OpenAI response object.
+     */
+    interface OpenAIResponseToolMcp {
+        server_label: string;
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        allowed_tools?: Array<string> | OpenAIResponseToolMcp.AllowedToolsFilter | null;
+        type?: 'mcp';
+    }
+    namespace OpenAIResponseToolMcp {
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        interface AllowedToolsFilter {
+            tool_names?: Array<string> | null;
+        }
+    }
+    /**
+     * Usage information for OpenAI response.
+     */
+    interface Usage {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        input_tokens_details?: Usage.InputTokensDetails | null;
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        output_tokens_details?: Usage.OutputTokensDetails | null;
+    }
+    namespace Usage {
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        interface InputTokensDetails {
+            cached_tokens?: number | null;
+        }
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        interface OutputTokensDetails {
+            reasoning_tokens?: number | null;
+        }
     }
 }
 /**
  * Streaming event indicating a new response has been created.
  */
-export type ResponseObjectStream = ResponseObjectStream.OpenAIResponseObjectStreamResponseCreated | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputItemAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputItemDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputTextDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputTextDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallSearching | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsFailed | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallArgumentsDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallFailed | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseContentPartAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseContentPartDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseCompleted;
+export type ResponseObjectStream = ResponseObjectStream.OpenAIResponseObjectStreamResponseCreated | ResponseObjectStream.OpenAIResponseObjectStreamResponseInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputItemAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputItemDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputTextDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputTextDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallSearching | ResponseObjectStream.OpenAIResponseObjectStreamResponseWebSearchCallCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsFailed | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpListToolsCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallArgumentsDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallFailed | ResponseObjectStream.OpenAIResponseObjectStreamResponseMcpCallCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseContentPartAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseContentPartDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningTextDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningTextDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningSummaryPartDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseReasoningSummaryTextDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseRefusalDelta | ResponseObjectStream.OpenAIResponseObjectStreamResponseRefusalDone | ResponseObjectStream.OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded | ResponseObjectStream.OpenAIResponseObjectStreamResponseFileSearchCallInProgress | ResponseObjectStream.OpenAIResponseObjectStreamResponseFileSearchCallSearching | ResponseObjectStream.OpenAIResponseObjectStreamResponseFileSearchCallCompleted | ResponseObjectStream.OpenAIResponseObjectStreamResponseIncomplete | ResponseObjectStream.OpenAIResponseObjectStreamResponseFailed | ResponseObjectStream.OpenAIResponseObjectStreamResponseCompleted;
 export declare namespace ResponseObjectStream {
     /**
      * Streaming event indicating a new response has been created.
      */
     interface OpenAIResponseObjectStreamResponseCreated {
         /**
-         * The newly created response object
+         * Complete OpenAI response object containing generation results and metadata.
          */
         response: ResponsesAPI.ResponseObject;
+        type?: 'response.created';
+    }
+    /**
+     * Streaming event indicating the response remains in progress.
+     */
+    interface OpenAIResponseObjectStreamResponseInProgress {
         /**
-         * Event type identifier, always "response.created"
+         * Complete OpenAI response object containing generation results and metadata.
          */
-        type: 'response.created';
+        response: ResponsesAPI.ResponseObject;
+        sequence_number: number;
+        type?: 'response.in_progress';
     }
     /**
      * Streaming event for when a new output item is added to the response.
      */
     interface OpenAIResponseObjectStreamResponseOutputItemAdded {
         /**
-         * The output item that was added (message, tool call, etc.)
-         */
-        item: OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseMessage | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageWebSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageMcpCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageMcpListTools;
-        /**
-         * Index position of this item in the output list
+         * Corresponds to the various Message types in the Responses API. They are all
+         * under one type because the Responses API gives them all the same "type" value,
+         * and there is no way to tell them apart in certain scenarios.
          */
+        item: OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseMessage | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageWebSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageMcpCall | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseOutputMessageMcpListTools | OpenAIResponseObjectStreamResponseOutputItemAdded.OpenAIResponseMcpApprovalRequest;
         output_index: number;
-        /**
-         * Unique identifier of the response containing this output
-         */
         response_id: string;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.output_item.added"
-         */
-        type: 'response.output_item.added';
+        type?: 'response.output_item.added';
     }
     namespace OpenAIResponseObjectStreamResponseOutputItemAdded {
         /**
@@ -481,94 +450,63 @@ export declare namespace ResponseObjectStream {
          * and there is no way to tell them apart in certain scenarios.
          */
         interface OpenAIResponseMessage {
-            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage | OpenAIResponseMessage.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessage.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessage.OpenAIResponseContentPartRefusal>;
             role: 'system' | 'developer' | 'user' | 'assistant';
-            type: 'message';
-            id?: string;
-            status?: string;
+            id?: string | null;
+            status?: string | null;
+            type?: 'message';
         }
         namespace OpenAIResponseMessage {
             /**
              * Text content for input messages in OpenAI response format.
              */
             interface OpenAIResponseInputMessageContentText {
-                /**
-                 * The text content of the input message
-                 */
                 text: string;
-                /**
-                 * Content type identifier, always "input_text"
-                 */
-                type: 'input_text';
+                type?: 'input_text';
             }
             /**
              * Image content for input messages in OpenAI response format.
              */
             interface OpenAIResponseInputMessageContentImage {
-                /**
-                 * Level of detail for image processing, can be "low", "high", or "auto"
-                 */
-                detail: 'low' | 'high' | 'auto';
-                /**
-                 * Content type identifier, always "input_image"
-                 */
-                type: 'input_image';
-                /**
-                 * (Optional) URL of the image content
-                 */
-                image_url?: string;
+                detail?: 'low' | 'high' | 'auto';
+                file_id?: string | null;
+                image_url?: string | null;
+                type?: 'input_image';
+            }
+            /**
+             * File content for input messages in OpenAI response format.
+             */
+            interface OpenAIResponseInputMessageContentFile {
+                file_data?: string | null;
+                file_id?: string | null;
+                file_url?: string | null;
+                filename?: string | null;
+                type?: 'input_file';
             }
-            interface UnionMember2 {
-                annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+            interface OpenAIResponseOutputMessageContentOutputText {
                 text: string;
-                type: 'output_text';
+                annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                type?: 'output_text';
             }
-            namespace UnionMember2 {
+            namespace OpenAIResponseOutputMessageContentOutputText {
                 /**
                  * File citation annotation for referencing specific files in response content.
                  */
                 interface OpenAIResponseAnnotationFileCitation {
-                    /**
-                     * Unique identifier of the referenced file
-                     */
                     file_id: string;
-                    /**
-                     * Name of the referenced file
-                     */
                     filename: string;
-                    /**
-                     * Position index of the citation within the content
-                     */
                     index: number;
-                    /**
-                     * Annotation type identifier, always "file_citation"
-                     */
-                    type: 'file_citation';
+                    type?: 'file_citation';
                 }
                 /**
                  * URL citation annotation for referencing external web resources.
                  */
                 interface OpenAIResponseAnnotationCitation {
-                    /**
-                     * End position of the citation span in the content
-                     */
                     end_index: number;
-                    /**
-                     * Start position of the citation span in the content
-                     */
                     start_index: number;
-                    /**
-                     * Title of the referenced web resource
-                     */
                     title: string;
-                    /**
-                     * Annotation type identifier, always "url_citation"
-                     */
-                    type: 'url_citation';
-                    /**
-                     * URL of the referenced web resource
-                     */
                     url: string;
+                    type?: 'url_citation';
                 }
                 interface OpenAIResponseAnnotationContainerFileCitation {
                     container_id: string;
@@ -576,83 +514,51 @@ export declare namespace ResponseObjectStream {
                     file_id: string;
                     filename: string;
                     start_index: number;
-                    type: 'container_file_citation';
+                    type?: 'container_file_citation';
                 }
                 interface OpenAIResponseAnnotationFilePath {
                     file_id: string;
                     index: number;
-                    type: 'file_path';
+                    type?: 'file_path';
                 }
             }
+            /**
+             * Refusal content within a streamed response part.
+             */
+            interface OpenAIResponseContentPartRefusal {
+                refusal: string;
+                type?: 'refusal';
+            }
         }
         /**
          * Web search tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageWebSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
             id: string;
-            /**
-             * Current status of the web search operation
-             */
             status: string;
-            /**
-             * Tool call type identifier, always "web_search_call"
-             */
-            type: 'web_search_call';
+            type?: 'web_search_call';
         }
         /**
          * File search tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageFileSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
             id: string;
-            /**
-             * List of search queries executed
-             */
             queries: Array<string>;
-            /**
-             * Current status of the file search operation
-             */
             status: string;
-            /**
-             * Tool call type identifier, always "file_search_call"
-             */
-            type: 'file_search_call';
-            /**
-             * (Optional) Search results returned by the file search operation
-             */
-            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+            type?: 'file_search_call';
         }
         namespace OpenAIResponseOutputMessageFileSearchToolCall {
             /**
              * Search results returned by the file search operation.
              */
             interface Result {
-                /**
-                 * (Optional) Key-value attributes associated with the file
-                 */
                 attributes: {
-                    [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                    [key: string]: unknown;
                 };
-                /**
-                 * Unique identifier of the file containing the result
-                 */
                 file_id: string;
-                /**
-                 * Name of the file containing the result
-                 */
                 filename: string;
-                /**
-                 * Relevance score for this search result (between 0 and 1)
-                 */
                 score: number;
-                /**
-                 * Text content of the search result
-                 */
                 text: string;
             }
         }
@@ -660,131 +566,71 @@ export declare namespace ResponseObjectStream {
          * Function tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageFunctionToolCall {
-            /**
-             * JSON string containing the function arguments
-             */
             arguments: string;
-            /**
-             * Unique identifier for the function call
-             */
             call_id: string;
-            /**
-             * Name of the function being called
-             */
             name: string;
-            /**
-             * Tool call type identifier, always "function_call"
-             */
-            type: 'function_call';
-            /**
-             * (Optional) Additional identifier for the tool call
-             */
-            id?: string;
-            /**
-             * (Optional) Current status of the function call execution
-             */
-            status?: string;
+            id?: string | null;
+            status?: string | null;
+            type?: 'function_call';
         }
         /**
          * Model Context Protocol (MCP) call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageMcpCall {
-            /**
-             * Unique identifier for this MCP call
-             */
             id: string;
-            /**
-             * JSON string containing the MCP call arguments
-             */
             arguments: string;
-            /**
-             * Name of the MCP method being called
-             */
             name: string;
-            /**
-             * Label identifying the MCP server handling the call
-             */
             server_label: string;
-            /**
-             * Tool call type identifier, always "mcp_call"
-             */
-            type: 'mcp_call';
-            /**
-             * (Optional) Error message if the MCP call failed
-             */
-            error?: string;
-            /**
-             * (Optional) Output result from the successful MCP call
-             */
-            output?: string;
+            error?: string | null;
+            output?: string | null;
+            type?: 'mcp_call';
         }
         /**
          * MCP list tools output message containing available tools from an MCP server.
          */
         interface OpenAIResponseOutputMessageMcpListTools {
-            /**
-             * Unique identifier for this MCP list tools operation
-             */
             id: string;
-            /**
-             * Label identifying the MCP server providing the tools
-             */
             server_label: string;
-            /**
-             * List of available tools provided by the MCP server
-             */
             tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
-            /**
-             * Tool call type identifier, always "mcp_list_tools"
-             */
-            type: 'mcp_list_tools';
+            type?: 'mcp_list_tools';
         }
         namespace OpenAIResponseOutputMessageMcpListTools {
             /**
              * Tool definition returned by MCP list tools operation.
              */
             interface Tool {
-                /**
-                 * JSON schema defining the tool's input parameters
-                 */
                 input_schema: {
-                    [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                    [key: string]: unknown;
                 };
-                /**
-                 * Name of the tool
-                 */
                 name: string;
-                /**
-                 * (Optional) Description of what the tool does
-                 */
-                description?: string;
+                description?: string | null;
             }
         }
+        /**
+         * A request for human approval of a tool invocation.
+         */
+        interface OpenAIResponseMcpApprovalRequest {
+            id: string;
+            arguments: string;
+            name: string;
+            server_label: string;
+            type?: 'mcp_approval_request';
+        }
     }
     /**
      * Streaming event for when an output item is completed.
      */
     interface OpenAIResponseObjectStreamResponseOutputItemDone {
         /**
-         * The completed output item (message, tool call, etc.)
-         */
-        item: OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseMessage | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageWebSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageMcpCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageMcpListTools;
-        /**
-         * Index position of this item in the output list
+         * Corresponds to the various Message types in the Responses API. They are all
+         * under one type because the Responses API gives them all the same "type" value,
+         * and there is no way to tell them apart in certain scenarios.
          */
+        item: OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseMessage | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageWebSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageMcpCall | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseOutputMessageMcpListTools | OpenAIResponseObjectStreamResponseOutputItemDone.OpenAIResponseMcpApprovalRequest;
         output_index: number;
-        /**
-         * Unique identifier of the response containing this output
-         */
         response_id: string;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.output_item.done"
-         */
-        type: 'response.output_item.done';
+        type?: 'response.output_item.done';
     }
     namespace OpenAIResponseObjectStreamResponseOutputItemDone {
         /**
@@ -793,94 +639,63 @@ export declare namespace ResponseObjectStream {
          * and there is no way to tell them apart in certain scenarios.
          */
         interface OpenAIResponseMessage {
-            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage | OpenAIResponseMessage.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessage.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessage.OpenAIResponseContentPartRefusal>;
             role: 'system' | 'developer' | 'user' | 'assistant';
-            type: 'message';
-            id?: string;
-            status?: string;
+            id?: string | null;
+            status?: string | null;
+            type?: 'message';
         }
         namespace OpenAIResponseMessage {
             /**
              * Text content for input messages in OpenAI response format.
              */
             interface OpenAIResponseInputMessageContentText {
-                /**
-                 * The text content of the input message
-                 */
                 text: string;
-                /**
-                 * Content type identifier, always "input_text"
-                 */
-                type: 'input_text';
+                type?: 'input_text';
             }
             /**
              * Image content for input messages in OpenAI response format.
              */
             interface OpenAIResponseInputMessageContentImage {
-                /**
-                 * Level of detail for image processing, can be "low", "high", or "auto"
-                 */
-                detail: 'low' | 'high' | 'auto';
-                /**
-                 * Content type identifier, always "input_image"
-                 */
-                type: 'input_image';
-                /**
-                 * (Optional) URL of the image content
-                 */
-                image_url?: string;
+                detail?: 'low' | 'high' | 'auto';
+                file_id?: string | null;
+                image_url?: string | null;
+                type?: 'input_image';
+            }
+            /**
+             * File content for input messages in OpenAI response format.
+             */
+            interface OpenAIResponseInputMessageContentFile {
+                file_data?: string | null;
+                file_id?: string | null;
+                file_url?: string | null;
+                filename?: string | null;
+                type?: 'input_file';
             }
-            interface UnionMember2 {
-                annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+            interface OpenAIResponseOutputMessageContentOutputText {
                 text: string;
-                type: 'output_text';
+                annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                type?: 'output_text';
             }
-            namespace UnionMember2 {
+            namespace OpenAIResponseOutputMessageContentOutputText {
                 /**
                  * File citation annotation for referencing specific files in response content.
                  */
                 interface OpenAIResponseAnnotationFileCitation {
-                    /**
-                     * Unique identifier of the referenced file
-                     */
                     file_id: string;
-                    /**
-                     * Name of the referenced file
-                     */
                     filename: string;
-                    /**
-                     * Position index of the citation within the content
-                     */
                     index: number;
-                    /**
-                     * Annotation type identifier, always "file_citation"
-                     */
-                    type: 'file_citation';
+                    type?: 'file_citation';
                 }
                 /**
                  * URL citation annotation for referencing external web resources.
                  */
                 interface OpenAIResponseAnnotationCitation {
-                    /**
-                     * End position of the citation span in the content
-                     */
                     end_index: number;
-                    /**
-                     * Start position of the citation span in the content
-                     */
                     start_index: number;
-                    /**
-                     * Title of the referenced web resource
-                     */
                     title: string;
-                    /**
-                     * Annotation type identifier, always "url_citation"
-                     */
-                    type: 'url_citation';
-                    /**
-                     * URL of the referenced web resource
-                     */
                     url: string;
+                    type?: 'url_citation';
                 }
                 interface OpenAIResponseAnnotationContainerFileCitation {
                     container_id: string;
@@ -888,83 +703,51 @@ export declare namespace ResponseObjectStream {
                     file_id: string;
                     filename: string;
                     start_index: number;
-                    type: 'container_file_citation';
+                    type?: 'container_file_citation';
                 }
                 interface OpenAIResponseAnnotationFilePath {
                     file_id: string;
                     index: number;
-                    type: 'file_path';
+                    type?: 'file_path';
                 }
             }
+            /**
+             * Refusal content within a streamed response part.
+             */
+            interface OpenAIResponseContentPartRefusal {
+                refusal: string;
+                type?: 'refusal';
+            }
         }
         /**
          * Web search tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageWebSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
             id: string;
-            /**
-             * Current status of the web search operation
-             */
             status: string;
-            /**
-             * Tool call type identifier, always "web_search_call"
-             */
-            type: 'web_search_call';
+            type?: 'web_search_call';
         }
         /**
          * File search tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageFileSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
             id: string;
-            /**
-             * List of search queries executed
-             */
             queries: Array<string>;
-            /**
-             * Current status of the file search operation
-             */
             status: string;
-            /**
-             * Tool call type identifier, always "file_search_call"
-             */
-            type: 'file_search_call';
-            /**
-             * (Optional) Search results returned by the file search operation
-             */
-            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+            type?: 'file_search_call';
         }
         namespace OpenAIResponseOutputMessageFileSearchToolCall {
             /**
              * Search results returned by the file search operation.
              */
             interface Result {
-                /**
-                 * (Optional) Key-value attributes associated with the file
-                 */
                 attributes: {
-                    [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                    [key: string]: unknown;
                 };
-                /**
-                 * Unique identifier of the file containing the result
-                 */
                 file_id: string;
-                /**
-                 * Name of the file containing the result
-                 */
                 filename: string;
-                /**
-                 * Relevance score for this search result (between 0 and 1)
-                 */
                 score: number;
-                /**
-                 * Text content of the search result
-                 */
                 text: string;
             }
         }
@@ -972,585 +755,756 @@ export declare namespace ResponseObjectStream {
          * Function tool call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageFunctionToolCall {
-            /**
-             * JSON string containing the function arguments
-             */
             arguments: string;
-            /**
-             * Unique identifier for the function call
-             */
             call_id: string;
-            /**
-             * Name of the function being called
-             */
             name: string;
-            /**
-             * Tool call type identifier, always "function_call"
-             */
-            type: 'function_call';
-            /**
-             * (Optional) Additional identifier for the tool call
-             */
-            id?: string;
-            /**
-             * (Optional) Current status of the function call execution
-             */
-            status?: string;
+            id?: string | null;
+            status?: string | null;
+            type?: 'function_call';
         }
         /**
          * Model Context Protocol (MCP) call output message for OpenAI responses.
          */
         interface OpenAIResponseOutputMessageMcpCall {
-            /**
-             * Unique identifier for this MCP call
-             */
             id: string;
-            /**
-             * JSON string containing the MCP call arguments
-             */
             arguments: string;
-            /**
-             * Name of the MCP method being called
-             */
             name: string;
-            /**
-             * Label identifying the MCP server handling the call
-             */
             server_label: string;
-            /**
-             * Tool call type identifier, always "mcp_call"
-             */
-            type: 'mcp_call';
-            /**
-             * (Optional) Error message if the MCP call failed
-             */
-            error?: string;
-            /**
-             * (Optional) Output result from the successful MCP call
-             */
-            output?: string;
+            error?: string | null;
+            output?: string | null;
+            type?: 'mcp_call';
         }
         /**
          * MCP list tools output message containing available tools from an MCP server.
          */
         interface OpenAIResponseOutputMessageMcpListTools {
-            /**
-             * Unique identifier for this MCP list tools operation
-             */
             id: string;
-            /**
-             * Label identifying the MCP server providing the tools
-             */
             server_label: string;
-            /**
-             * List of available tools provided by the MCP server
-             */
             tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
-            /**
-             * Tool call type identifier, always "mcp_list_tools"
-             */
-            type: 'mcp_list_tools';
+            type?: 'mcp_list_tools';
         }
         namespace OpenAIResponseOutputMessageMcpListTools {
             /**
              * Tool definition returned by MCP list tools operation.
              */
             interface Tool {
-                /**
-                 * JSON schema defining the tool's input parameters
-                 */
                 input_schema: {
-                    [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                    [key: string]: unknown;
                 };
-                /**
-                 * Name of the tool
-                 */
                 name: string;
-                /**
-                 * (Optional) Description of what the tool does
-                 */
-                description?: string;
+                description?: string | null;
             }
         }
+        /**
+         * A request for human approval of a tool invocation.
+         */
+        interface OpenAIResponseMcpApprovalRequest {
+            id: string;
+            arguments: string;
+            name: string;
+            server_label: string;
+            type?: 'mcp_approval_request';
+        }
     }
     /**
      * Streaming event for incremental text content updates.
      */
     interface OpenAIResponseObjectStreamResponseOutputTextDelta {
-        /**
-         * Index position within the text content
-         */
         content_index: number;
-        /**
-         * Incremental text content being added
-         */
         delta: string;
-        /**
-         * Unique identifier of the output item being updated
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.output_text.delta"
-         */
-        type: 'response.output_text.delta';
+        type?: 'response.output_text.delta';
     }
     /**
      * Streaming event for when text output is completed.
      */
     interface OpenAIResponseObjectStreamResponseOutputTextDone {
-        /**
-         * Index position within the text content
-         */
         content_index: number;
-        /**
-         * Unique identifier of the completed output item
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Final complete text content of the output item
-         */
         text: string;
-        /**
-         * Event type identifier, always "response.output_text.done"
-         */
-        type: 'response.output_text.done';
+        type?: 'response.output_text.done';
     }
     /**
      * Streaming event for incremental function call argument updates.
      */
     interface OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta {
-        /**
-         * Incremental function call arguments being added
-         */
         delta: string;
-        /**
-         * Unique identifier of the function call being updated
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.function_call_arguments.delta"
-         */
-        type: 'response.function_call_arguments.delta';
+        type?: 'response.function_call_arguments.delta';
     }
     /**
      * Streaming event for when function call arguments are completed.
      */
     interface OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone {
-        /**
-         * Final complete arguments JSON string for the function call
-         */
         arguments: string;
-        /**
-         * Unique identifier of the completed function call
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.function_call_arguments.done"
-         */
-        type: 'response.function_call_arguments.done';
+        type?: 'response.function_call_arguments.done';
     }
     /**
      * Streaming event for web search calls in progress.
      */
     interface OpenAIResponseObjectStreamResponseWebSearchCallInProgress {
-        /**
-         * Unique identifier of the web search call
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.web_search_call.in_progress"
-         */
-        type: 'response.web_search_call.in_progress';
+        type?: 'response.web_search_call.in_progress';
     }
     interface OpenAIResponseObjectStreamResponseWebSearchCallSearching {
         item_id: string;
         output_index: number;
         sequence_number: number;
-        type: 'response.web_search_call.searching';
+        type?: 'response.web_search_call.searching';
     }
     /**
      * Streaming event for completed web search calls.
      */
     interface OpenAIResponseObjectStreamResponseWebSearchCallCompleted {
-        /**
-         * Unique identifier of the completed web search call
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.web_search_call.completed"
-         */
-        type: 'response.web_search_call.completed';
+        type?: 'response.web_search_call.completed';
     }
     interface OpenAIResponseObjectStreamResponseMcpListToolsInProgress {
         sequence_number: number;
-        type: 'response.mcp_list_tools.in_progress';
+        type?: 'response.mcp_list_tools.in_progress';
     }
     interface OpenAIResponseObjectStreamResponseMcpListToolsFailed {
         sequence_number: number;
-        type: 'response.mcp_list_tools.failed';
+        type?: 'response.mcp_list_tools.failed';
     }
     interface OpenAIResponseObjectStreamResponseMcpListToolsCompleted {
         sequence_number: number;
-        type: 'response.mcp_list_tools.completed';
+        type?: 'response.mcp_list_tools.completed';
     }
     interface OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta {
         delta: string;
         item_id: string;
         output_index: number;
         sequence_number: number;
-        type: 'response.mcp_call.arguments.delta';
+        type?: 'response.mcp_call.arguments.delta';
     }
     interface OpenAIResponseObjectStreamResponseMcpCallArgumentsDone {
         arguments: string;
         item_id: string;
         output_index: number;
         sequence_number: number;
-        type: 'response.mcp_call.arguments.done';
+        type?: 'response.mcp_call.arguments.done';
     }
     /**
      * Streaming event for MCP calls in progress.
      */
     interface OpenAIResponseObjectStreamResponseMcpCallInProgress {
-        /**
-         * Unique identifier of the MCP call
-         */
         item_id: string;
-        /**
-         * Index position of the item in the output list
-         */
         output_index: number;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.mcp_call.in_progress"
-         */
-        type: 'response.mcp_call.in_progress';
+        type?: 'response.mcp_call.in_progress';
     }
     /**
      * Streaming event for failed MCP calls.
      */
     interface OpenAIResponseObjectStreamResponseMcpCallFailed {
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.mcp_call.failed"
-         */
-        type: 'response.mcp_call.failed';
+        type?: 'response.mcp_call.failed';
     }
     /**
      * Streaming event for completed MCP calls.
      */
     interface OpenAIResponseObjectStreamResponseMcpCallCompleted {
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.mcp_call.completed"
-         */
-        type: 'response.mcp_call.completed';
+        type?: 'response.mcp_call.completed';
     }
     /**
      * Streaming event for when a new content part is added to a response item.
      */
     interface OpenAIResponseObjectStreamResponseContentPartAdded {
-        /**
-         * Unique identifier of the output item containing this content part
-         */
+        content_index: number;
         item_id: string;
+        output_index: number;
         /**
-         * The content part that was added
-         */
-        part: OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartRefusal;
-        /**
-         * Unique identifier of the response containing this content
+         * Text content within a streamed response part.
          */
+        part: OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartRefusal | OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartReasoningText;
         response_id: string;
-        /**
-         * Sequential number for ordering streaming events
-         */
         sequence_number: number;
-        /**
-         * Event type identifier, always "response.content_part.added"
-         */
-        type: 'response.content_part.added';
+        type?: 'response.content_part.added';
     }
     namespace OpenAIResponseObjectStreamResponseContentPartAdded {
+        /**
+         * Text content within a streamed response part.
+         */
         interface OpenAIResponseContentPartOutputText {
             text: string;
-            type: 'output_text';
-        }
-        interface OpenAIResponseContentPartRefusal {
-            refusal: string;
-            type: 'refusal';
+            annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<{
+                [key: string]: unknown;
+            }> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseContentPartOutputText {
+            /**
+             * File citation annotation for referencing specific files in response content.
+             */
+            interface OpenAIResponseAnnotationFileCitation {
+                file_id: string;
+                filename: string;
+                index: number;
+                type?: 'file_citation';
+            }
+            /**
+             * URL citation annotation for referencing external web resources.
+             */
+            interface OpenAIResponseAnnotationCitation {
+                end_index: number;
+                start_index: number;
+                title: string;
+                url: string;
+                type?: 'url_citation';
+            }
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type?: 'container_file_citation';
+            }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type?: 'file_path';
+            }
+        }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
+        /**
+         * Reasoning text emitted as part of a streamed response.
+         */
+        interface OpenAIResponseContentPartReasoningText {
+            text: string;
+            type?: 'reasoning_text';
         }
     }
     /**
      * Streaming event for when a content part is completed.
      */
     interface OpenAIResponseObjectStreamResponseContentPartDone {
+        content_index: number;
+        item_id: string;
+        output_index: number;
         /**
-         * Unique identifier of the output item containing this content part
+         * Text content within a streamed response part.
          */
-        item_id: string;
+        part: OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartRefusal | OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartReasoningText;
+        response_id: string;
+        sequence_number: number;
+        type?: 'response.content_part.done';
+    }
+    namespace OpenAIResponseObjectStreamResponseContentPartDone {
         /**
-         * The completed content part
+         * Text content within a streamed response part.
          */
-        part: OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartRefusal;
+        interface OpenAIResponseContentPartOutputText {
+            text: string;
+            annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<{
+                [key: string]: unknown;
+            }> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseContentPartOutputText {
+            /**
+             * File citation annotation for referencing specific files in response content.
+             */
+            interface OpenAIResponseAnnotationFileCitation {
+                file_id: string;
+                filename: string;
+                index: number;
+                type?: 'file_citation';
+            }
+            /**
+             * URL citation annotation for referencing external web resources.
+             */
+            interface OpenAIResponseAnnotationCitation {
+                end_index: number;
+                start_index: number;
+                title: string;
+                url: string;
+                type?: 'url_citation';
+            }
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type?: 'container_file_citation';
+            }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type?: 'file_path';
+            }
+        }
         /**
-         * Unique identifier of the response containing this content
+         * Refusal content within a streamed response part.
          */
-        response_id: string;
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
         /**
-         * Sequential number for ordering streaming events
+         * Reasoning text emitted as part of a streamed response.
          */
+        interface OpenAIResponseContentPartReasoningText {
+            text: string;
+            type?: 'reasoning_text';
+        }
+    }
+    /**
+     * Streaming event for incremental reasoning text updates.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningTextDelta {
+        content_index: number;
+        delta: string;
+        item_id: string;
+        output_index: number;
         sequence_number: number;
+        type?: 'response.reasoning_text.delta';
+    }
+    /**
+     * Streaming event for when reasoning text is completed.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningTextDone {
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        text: string;
+        type?: 'response.reasoning_text.done';
+    }
+    /**
+     * Streaming event for when a new reasoning summary part is added.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded {
+        item_id: string;
+        output_index: number;
         /**
-         * Event type identifier, always "response.content_part.done"
+         * Reasoning summary part in a streamed response.
          */
-        type: 'response.content_part.done';
+        part: OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded.Part;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_part.added';
     }
-    namespace OpenAIResponseObjectStreamResponseContentPartDone {
-        interface OpenAIResponseContentPartOutputText {
+    namespace OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded {
+        /**
+         * Reasoning summary part in a streamed response.
+         */
+        interface Part {
             text: string;
-            type: 'output_text';
-        }
-        interface OpenAIResponseContentPartRefusal {
-            refusal: string;
-            type: 'refusal';
+            type?: 'summary_text';
         }
     }
     /**
-     * Streaming event indicating a response has been completed.
+     * Streaming event for when a reasoning summary part is completed.
      */
-    interface OpenAIResponseObjectStreamResponseCompleted {
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryPartDone {
+        item_id: string;
+        output_index: number;
         /**
-         * The completed response object
+         * Reasoning summary part in a streamed response.
          */
-        response: ResponsesAPI.ResponseObject;
+        part: OpenAIResponseObjectStreamResponseReasoningSummaryPartDone.Part;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_part.done';
+    }
+    namespace OpenAIResponseObjectStreamResponseReasoningSummaryPartDone {
         /**
-         * Event type identifier, always "response.completed"
+         * Reasoning summary part in a streamed response.
          */
-        type: 'response.completed';
+        interface Part {
+            text: string;
+            type?: 'summary_text';
+        }
     }
-}
-/**
- * OpenAI response object extended with input context information.
- */
-export interface ResponseListResponse {
     /**
-     * Unique identifier for this response
+     * Streaming event for incremental reasoning summary text updates.
      */
-    id: string;
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta {
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_text.delta';
+    }
     /**
-     * Unix timestamp when the response was created
+     * Streaming event for when reasoning summary text is completed.
      */
-    created_at: number;
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryTextDone {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        summary_index: number;
+        text: string;
+        type?: 'response.reasoning_summary_text.done';
+    }
     /**
-     * List of input items that led to this response
+     * Streaming event for incremental refusal text updates.
      */
-    input: Array<ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall | ResponseListResponse.OpenAIResponseInputFunctionToolCallOutput | ResponseListResponse.OpenAIResponseMessage>;
+    interface OpenAIResponseObjectStreamResponseRefusalDelta {
+        content_index: number;
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.refusal.delta';
+    }
     /**
-     * Model identifier used for generation
+     * Streaming event for when refusal text is completed.
      */
-    model: string;
+    interface OpenAIResponseObjectStreamResponseRefusalDone {
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        refusal: string;
+        sequence_number: number;
+        type?: 'response.refusal.done';
+    }
     /**
-     * Object type identifier, always "response"
+     * Streaming event for when an annotation is added to output text.
      */
-    object: 'response';
+    interface OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded {
+        /**
+         * File citation annotation for referencing specific files in response content.
+         */
+        annotation: OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded.OpenAIResponseAnnotationFileCitation | OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded.OpenAIResponseAnnotationCitation | OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded.OpenAIResponseAnnotationFilePath;
+        annotation_index: number;
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.output_text.annotation.added';
+    }
+    namespace OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded {
+        /**
+         * File citation annotation for referencing specific files in response content.
+         */
+        interface OpenAIResponseAnnotationFileCitation {
+            file_id: string;
+            filename: string;
+            index: number;
+            type?: 'file_citation';
+        }
+        /**
+         * URL citation annotation for referencing external web resources.
+         */
+        interface OpenAIResponseAnnotationCitation {
+            end_index: number;
+            start_index: number;
+            title: string;
+            url: string;
+            type?: 'url_citation';
+        }
+        interface OpenAIResponseAnnotationContainerFileCitation {
+            container_id: string;
+            end_index: number;
+            file_id: string;
+            filename: string;
+            start_index: number;
+            type?: 'container_file_citation';
+        }
+        interface OpenAIResponseAnnotationFilePath {
+            file_id: string;
+            index: number;
+            type?: 'file_path';
+        }
+    }
     /**
-     * List of generated output items (messages, tool calls, etc.)
+     * Streaming event for file search calls in progress.
      */
-    output: Array<ResponseListResponse.OpenAIResponseMessage | ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall | ResponseListResponse.OpenAIResponseOutputMessageMcpCall | ResponseListResponse.OpenAIResponseOutputMessageMcpListTools>;
+    interface OpenAIResponseObjectStreamResponseFileSearchCallInProgress {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.in_progress';
+    }
     /**
-     * Whether tool calls can be executed in parallel
+     * Streaming event for file search currently searching.
      */
-    parallel_tool_calls: boolean;
+    interface OpenAIResponseObjectStreamResponseFileSearchCallSearching {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.searching';
+    }
     /**
-     * Current status of the response generation
+     * Streaming event for completed file search calls.
      */
-    status: string;
+    interface OpenAIResponseObjectStreamResponseFileSearchCallCompleted {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.completed';
+    }
     /**
-     * Text formatting configuration for the response
+     * Streaming event emitted when a response ends in an incomplete state.
      */
-    text: ResponseListResponse.Text;
+    interface OpenAIResponseObjectStreamResponseIncomplete {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        response: ResponsesAPI.ResponseObject;
+        sequence_number: number;
+        type?: 'response.incomplete';
+    }
     /**
-     * (Optional) Error details if the response generation failed
+     * Streaming event emitted when a response fails.
      */
-    error?: ResponseListResponse.Error;
+    interface OpenAIResponseObjectStreamResponseFailed {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        response: ResponsesAPI.ResponseObject;
+        sequence_number: number;
+        type?: 'response.failed';
+    }
     /**
-     * (Optional) ID of the previous response in a conversation
+     * Streaming event indicating a response has been completed.
      */
-    previous_response_id?: string;
+    interface OpenAIResponseObjectStreamResponseCompleted {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        response: ResponsesAPI.ResponseObject;
+        type?: 'response.completed';
+    }
+}
+/**
+ * OpenAI response object extended with input context information.
+ */
+export interface ResponseListResponse {
+    id: string;
+    created_at: number;
+    input: Array<ResponseListResponse.OpenAIResponseMessageOutput | ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall | ResponseListResponse.OpenAIResponseOutputMessageMcpCall | ResponseListResponse.OpenAIResponseOutputMessageMcpListTools | ResponseListResponse.OpenAIResponseMcpApprovalRequest | ResponseListResponse.OpenAIResponseInputFunctionToolCallOutput | ResponseListResponse.OpenAIResponseMcpApprovalResponse | ResponseListResponse.OpenAIResponseMessageOutput>;
+    model: string;
+    output: Array<ResponseListResponse.OpenAIResponseMessageOutput | ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall | ResponseListResponse.OpenAIResponseOutputMessageMcpCall | ResponseListResponse.OpenAIResponseOutputMessageMcpListTools | ResponseListResponse.OpenAIResponseMcpApprovalRequest>;
+    status: string;
     /**
-     * (Optional) Sampling temperature used for generation
+     * Error details for failed OpenAI response requests.
      */
-    temperature?: number;
+    error?: ResponseListResponse.Error | null;
+    instructions?: string | null;
+    max_tool_calls?: number | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    object?: 'response';
+    parallel_tool_calls?: boolean | null;
+    previous_response_id?: string | null;
     /**
-     * (Optional) Nucleus sampling parameter used for generation
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
      */
-    top_p?: number;
+    prompt?: ResponseListResponse.Prompt | null;
+    temperature?: number | null;
     /**
-     * (Optional) Truncation strategy applied to the response
+     * Text response configuration for OpenAI responses.
      */
-    truncation?: string;
+    text?: ResponseListResponse.Text;
+    tools?: Array<ResponseListResponse.OpenAIResponseInputToolWebSearch | ResponseListResponse.OpenAIResponseInputToolFileSearch | ResponseListResponse.OpenAIResponseInputToolFunction | ResponseListResponse.OpenAIResponseToolMcp> | null;
+    top_p?: number | null;
+    truncation?: string | null;
     /**
-     * (Optional) User identifier associated with the request
+     * Usage information for OpenAI response.
      */
-    user?: string;
+    usage?: ResponseListResponse.Usage | null;
 }
 export declare namespace ResponseListResponse {
     /**
-     * Web search tool call output message for OpenAI responses.
+     * Corresponds to the various Message types in the Responses API. They are all
+     * under one type because the Responses API gives them all the same "type" value,
+     * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseOutputMessageWebSearchToolCall {
+    interface OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageOutput {
         /**
-         * Unique identifier for this tool call
+         * Text content for input messages in OpenAI response format.
          */
-        id: string;
+        interface OpenAIResponseInputMessageContentText {
+            text: string;
+            type?: 'input_text';
+        }
         /**
-         * Current status of the web search operation
+         * Image content for input messages in OpenAI response format.
          */
-        status: string;
+        interface OpenAIResponseInputMessageContentImage {
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
         /**
-         * Tool call type identifier, always "web_search_call"
+         * File content for input messages in OpenAI response format.
          */
-        type: 'web_search_call';
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
+        }
+        interface OpenAIResponseOutputMessageContentOutputText {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputText {
+            /**
+             * File citation annotation for referencing specific files in response content.
+             */
+            interface OpenAIResponseAnnotationFileCitation {
+                file_id: string;
+                filename: string;
+                index: number;
+                type?: 'file_citation';
+            }
+            /**
+             * URL citation annotation for referencing external web resources.
+             */
+            interface OpenAIResponseAnnotationCitation {
+                end_index: number;
+                start_index: number;
+                title: string;
+                url: string;
+                type?: 'url_citation';
+            }
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type?: 'container_file_citation';
+            }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type?: 'file_path';
+            }
+        }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
+    }
+    /**
+     * Web search tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageWebSearchToolCall {
+        id: string;
+        status: string;
+        type?: 'web_search_call';
     }
     /**
      * File search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFileSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * List of search queries executed
-         */
         queries: Array<string>;
-        /**
-         * Current status of the file search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "file_search_call"
-         */
-        type: 'file_search_call';
-        /**
-         * (Optional) Search results returned by the file search operation
-         */
-        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
     }
     namespace OpenAIResponseOutputMessageFileSearchToolCall {
         /**
          * Search results returned by the file search operation.
          */
         interface Result {
-            /**
-             * (Optional) Key-value attributes associated with the file
-             */
             attributes: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Unique identifier of the file containing the result
-             */
             file_id: string;
-            /**
-             * Name of the file containing the result
-             */
             filename: string;
-            /**
-             * Relevance score for this search result (between 0 and 1)
-             */
             score: number;
-            /**
-             * Text content of the search result
-             */
             text: string;
         }
     }
     /**
-     * Function tool call output message for OpenAI responses.
+     * Function tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageFunctionToolCall {
+        arguments: string;
+        call_id: string;
+        name: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call';
+    }
+    /**
+     * Model Context Protocol (MCP) call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageMcpCall {
+        id: string;
+        arguments: string;
+        name: string;
+        server_label: string;
+        error?: string | null;
+        output?: string | null;
+        type?: 'mcp_call';
+    }
+    /**
+     * MCP list tools output message containing available tools from an MCP server.
+     */
+    interface OpenAIResponseOutputMessageMcpListTools {
+        id: string;
+        server_label: string;
+        tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
+        type?: 'mcp_list_tools';
+    }
+    namespace OpenAIResponseOutputMessageMcpListTools {
+        /**
+         * Tool definition returned by MCP list tools operation.
+         */
+        interface Tool {
+            input_schema: {
+                [key: string]: unknown;
+            };
+            name: string;
+            description?: string | null;
+        }
+    }
+    /**
+     * A request for human approval of a tool invocation.
      */
-    interface OpenAIResponseOutputMessageFunctionToolCall {
-        /**
-         * JSON string containing the function arguments
-         */
+    interface OpenAIResponseMcpApprovalRequest {
+        id: string;
         arguments: string;
-        /**
-         * Unique identifier for the function call
-         */
-        call_id: string;
-        /**
-         * Name of the function being called
-         */
         name: string;
-        /**
-         * Tool call type identifier, always "function_call"
-         */
-        type: 'function_call';
-        /**
-         * (Optional) Additional identifier for the tool call
-         */
-        id?: string;
-        /**
-         * (Optional) Current status of the function call execution
-         */
-        status?: string;
+        server_label: string;
+        type?: 'mcp_approval_request';
     }
     /**
      * This represents the output of a function call that gets passed back to the
@@ -1559,104 +1513,83 @@ export declare namespace ResponseListResponse {
     interface OpenAIResponseInputFunctionToolCallOutput {
         call_id: string;
         output: string;
-        type: 'function_call_output';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call_output';
+    }
+    /**
+     * A response to an MCP approval request.
+     */
+    interface OpenAIResponseMcpApprovalResponse {
+        approval_request_id: string;
+        approve: boolean;
+        id?: string | null;
+        reason?: string | null;
+        type?: 'mcp_approval_response';
     }
     /**
      * Corresponds to the various Message types in the Responses API. They are all
      * under one type because the Responses API gives them all the same "type" value,
      * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseMessage {
-        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+    interface OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
         role: 'system' | 'developer' | 'user' | 'assistant';
-        type: 'message';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
     }
-    namespace OpenAIResponseMessage {
+    namespace OpenAIResponseMessageOutput {
         /**
          * Text content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentText {
-            /**
-             * The text content of the input message
-             */
             text: string;
-            /**
-             * Content type identifier, always "input_text"
-             */
-            type: 'input_text';
+            type?: 'input_text';
         }
         /**
          * Image content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentImage {
-            /**
-             * Level of detail for image processing, can be "low", "high", or "auto"
-             */
-            detail: 'low' | 'high' | 'auto';
-            /**
-             * Content type identifier, always "input_image"
-             */
-            type: 'input_image';
-            /**
-             * (Optional) URL of the image content
-             */
-            image_url?: string;
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
         }
-        interface UnionMember2 {
-            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
+        }
+        interface OpenAIResponseOutputMessageContentOutputText {
             text: string;
-            type: 'output_text';
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
         }
-        namespace UnionMember2 {
+        namespace OpenAIResponseOutputMessageContentOutputText {
             /**
              * File citation annotation for referencing specific files in response content.
              */
             interface OpenAIResponseAnnotationFileCitation {
-                /**
-                 * Unique identifier of the referenced file
-                 */
                 file_id: string;
-                /**
-                 * Name of the referenced file
-                 */
                 filename: string;
-                /**
-                 * Position index of the citation within the content
-                 */
                 index: number;
-                /**
-                 * Annotation type identifier, always "file_citation"
-                 */
-                type: 'file_citation';
+                type?: 'file_citation';
             }
             /**
              * URL citation annotation for referencing external web resources.
              */
             interface OpenAIResponseAnnotationCitation {
-                /**
-                 * End position of the citation span in the content
-                 */
                 end_index: number;
-                /**
-                 * Start position of the citation span in the content
-                 */
                 start_index: number;
-                /**
-                 * Title of the referenced web resource
-                 */
                 title: string;
-                /**
-                 * Annotation type identifier, always "url_citation"
-                 */
-                type: 'url_citation';
-                /**
-                 * URL of the referenced web resource
-                 */
                 url: string;
+                type?: 'url_citation';
             }
             interface OpenAIResponseAnnotationContainerFileCitation {
                 container_id: string;
@@ -1664,109 +1597,85 @@ export declare namespace ResponseListResponse {
                 file_id: string;
                 filename: string;
                 start_index: number;
-                type: 'container_file_citation';
+                type?: 'container_file_citation';
             }
             interface OpenAIResponseAnnotationFilePath {
                 file_id: string;
                 index: number;
-                type: 'file_path';
+                type?: 'file_path';
             }
         }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
     }
     /**
      * Corresponds to the various Message types in the Responses API. They are all
      * under one type because the Responses API gives them all the same "type" value,
      * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseMessage {
-        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+    interface OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
         role: 'system' | 'developer' | 'user' | 'assistant';
-        type: 'message';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
     }
-    namespace OpenAIResponseMessage {
+    namespace OpenAIResponseMessageOutput {
         /**
          * Text content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentText {
-            /**
-             * The text content of the input message
-             */
             text: string;
-            /**
-             * Content type identifier, always "input_text"
-             */
-            type: 'input_text';
+            type?: 'input_text';
         }
         /**
          * Image content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentImage {
-            /**
-             * Level of detail for image processing, can be "low", "high", or "auto"
-             */
-            detail: 'low' | 'high' | 'auto';
-            /**
-             * Content type identifier, always "input_image"
-             */
-            type: 'input_image';
-            /**
-             * (Optional) URL of the image content
-             */
-            image_url?: string;
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
         }
-        interface UnionMember2 {
-            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
+        }
+        interface OpenAIResponseOutputMessageContentOutputText {
             text: string;
-            type: 'output_text';
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
         }
-        namespace UnionMember2 {
+        namespace OpenAIResponseOutputMessageContentOutputText {
             /**
              * File citation annotation for referencing specific files in response content.
              */
             interface OpenAIResponseAnnotationFileCitation {
-                /**
-                 * Unique identifier of the referenced file
-                 */
                 file_id: string;
-                /**
-                 * Name of the referenced file
-                 */
                 filename: string;
-                /**
-                 * Position index of the citation within the content
-                 */
                 index: number;
-                /**
-                 * Annotation type identifier, always "file_citation"
-                 */
-                type: 'file_citation';
+                type?: 'file_citation';
             }
             /**
              * URL citation annotation for referencing external web resources.
              */
             interface OpenAIResponseAnnotationCitation {
-                /**
-                 * End position of the citation span in the content
-                 */
                 end_index: number;
-                /**
-                 * Start position of the citation span in the content
-                 */
                 start_index: number;
-                /**
-                 * Title of the referenced web resource
-                 */
                 title: string;
-                /**
-                 * Annotation type identifier, always "url_citation"
-                 */
-                type: 'url_citation';
-                /**
-                 * URL of the referenced web resource
-                 */
                 url: string;
+                type?: 'url_citation';
             }
             interface OpenAIResponseAnnotationContainerFileCitation {
                 container_id: string;
@@ -1774,83 +1683,51 @@ export declare namespace ResponseListResponse {
                 file_id: string;
                 filename: string;
                 start_index: number;
-                type: 'container_file_citation';
+                type?: 'container_file_citation';
             }
             interface OpenAIResponseAnnotationFilePath {
                 file_id: string;
                 index: number;
-                type: 'file_path';
+                type?: 'file_path';
             }
         }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
     }
     /**
      * Web search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageWebSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * Current status of the web search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "web_search_call"
-         */
-        type: 'web_search_call';
+        type?: 'web_search_call';
     }
     /**
      * File search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFileSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * List of search queries executed
-         */
         queries: Array<string>;
-        /**
-         * Current status of the file search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "file_search_call"
-         */
-        type: 'file_search_call';
-        /**
-         * (Optional) Search results returned by the file search operation
-         */
-        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
     }
     namespace OpenAIResponseOutputMessageFileSearchToolCall {
         /**
          * Search results returned by the file search operation.
          */
         interface Result {
-            /**
-             * (Optional) Key-value attributes associated with the file
-             */
             attributes: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Unique identifier of the file containing the result
-             */
             file_id: string;
-            /**
-             * Name of the file containing the result
-             */
             filename: string;
-            /**
-             * Relevance score for this search result (between 0 and 1)
-             */
             score: number;
-            /**
-             * Text content of the search result
-             */
             text: string;
         }
     }
@@ -1858,277 +1735,368 @@ export declare namespace ResponseListResponse {
      * Function tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFunctionToolCall {
-        /**
-         * JSON string containing the function arguments
-         */
         arguments: string;
-        /**
-         * Unique identifier for the function call
-         */
         call_id: string;
-        /**
-         * Name of the function being called
-         */
         name: string;
-        /**
-         * Tool call type identifier, always "function_call"
-         */
-        type: 'function_call';
-        /**
-         * (Optional) Additional identifier for the tool call
-         */
-        id?: string;
-        /**
-         * (Optional) Current status of the function call execution
-         */
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call';
     }
     /**
      * Model Context Protocol (MCP) call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageMcpCall {
-        /**
-         * Unique identifier for this MCP call
-         */
         id: string;
-        /**
-         * JSON string containing the MCP call arguments
-         */
         arguments: string;
-        /**
-         * Name of the MCP method being called
-         */
         name: string;
-        /**
-         * Label identifying the MCP server handling the call
-         */
         server_label: string;
-        /**
-         * Tool call type identifier, always "mcp_call"
-         */
-        type: 'mcp_call';
-        /**
-         * (Optional) Error message if the MCP call failed
-         */
-        error?: string;
-        /**
-         * (Optional) Output result from the successful MCP call
-         */
-        output?: string;
+        error?: string | null;
+        output?: string | null;
+        type?: 'mcp_call';
     }
     /**
      * MCP list tools output message containing available tools from an MCP server.
      */
     interface OpenAIResponseOutputMessageMcpListTools {
-        /**
-         * Unique identifier for this MCP list tools operation
-         */
         id: string;
-        /**
-         * Label identifying the MCP server providing the tools
-         */
         server_label: string;
-        /**
-         * List of available tools provided by the MCP server
-         */
         tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
-        /**
-         * Tool call type identifier, always "mcp_list_tools"
-         */
-        type: 'mcp_list_tools';
+        type?: 'mcp_list_tools';
     }
     namespace OpenAIResponseOutputMessageMcpListTools {
         /**
          * Tool definition returned by MCP list tools operation.
          */
         interface Tool {
-            /**
-             * JSON schema defining the tool's input parameters
-             */
             input_schema: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Name of the tool
-             */
             name: string;
-            /**
-             * (Optional) Description of what the tool does
-             */
-            description?: string;
+            description?: string | null;
+        }
+    }
+    /**
+     * A request for human approval of a tool invocation.
+     */
+    interface OpenAIResponseMcpApprovalRequest {
+        id: string;
+        arguments: string;
+        name: string;
+        server_label: string;
+        type?: 'mcp_approval_request';
+    }
+    /**
+     * Error details for failed OpenAI response requests.
+     */
+    interface Error {
+        code: string;
+        message: string;
+    }
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    interface Prompt {
+        id: string;
+        variables?: {
+            [key: string]: Prompt.OpenAIResponseInputMessageContentText | Prompt.OpenAIResponseInputMessageContentImage | Prompt.OpenAIResponseInputMessageContentFile;
+        } | null;
+        version?: string | null;
+    }
+    namespace Prompt {
+        /**
+         * Text content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentText {
+            text: string;
+            type?: 'input_text';
+        }
+        /**
+         * Image content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentImage {
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
         }
     }
     /**
-     * Text formatting configuration for the response
+     * Text response configuration for OpenAI responses.
      */
     interface Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
-        format?: Text.Format;
+        format?: Text.Format | null;
     }
     namespace Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
         interface Format {
-            /**
-             * Must be "text", "json_schema", or "json_object" to identify the format type
-             */
-            type: 'text' | 'json_schema' | 'json_object';
-            /**
-             * (Optional) A description of the response format. Only used for json_schema.
-             */
-            description?: string;
-            /**
-             * The name of the response format. Only used for json_schema.
-             */
-            name?: string;
-            /**
-             * The JSON schema the response should conform to. In a Python SDK, this is often a
-             * `pydantic` model. Only used for json_schema.
-             */
+            description?: string | null;
+            name?: string | null;
             schema?: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-            };
-            /**
-             * (Optional) Whether to strictly enforce the JSON schema. If true, the response
-             * must match the schema exactly. Only used for json_schema.
-             */
-            strict?: boolean;
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
         }
     }
     /**
-     * (Optional) Error details if the response generation failed
+     * Web search tool configuration for OpenAI response inputs.
      */
-    interface Error {
+    interface OpenAIResponseInputToolWebSearch {
+        search_context_size?: string | null;
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
+    }
+    /**
+     * File search tool configuration for OpenAI response inputs.
+     */
+    interface OpenAIResponseInputToolFileSearch {
+        vector_store_ids: Array<string>;
+        filters?: {
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
         /**
-         * Error code identifying the type of failure
+         * Options for ranking and filtering search results.
          */
-        code: string;
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
+    }
+    namespace OpenAIResponseInputToolFileSearch {
         /**
-         * Human-readable error message describing the failure
+         * Options for ranking and filtering search results.
          */
-        message: string;
+        interface RankingOptions {
+            ranker?: string | null;
+            score_threshold?: number | null;
+        }
     }
-}
-/**
- * Response object confirming deletion of an OpenAI response.
- */
-export interface ResponseDeleteResponse {
     /**
-     * Unique identifier of the deleted response
+     * Function tool configuration for OpenAI response inputs.
      */
-    id: string;
+    interface OpenAIResponseInputToolFunction {
+        name: string;
+        parameters: {
+            [key: string]: unknown;
+        } | null;
+        description?: string | null;
+        strict?: boolean | null;
+        type?: 'function';
+    }
     /**
-     * Deletion confirmation flag, always True
+     * Model Context Protocol (MCP) tool configuration for OpenAI response object.
      */
-    deleted: boolean;
+    interface OpenAIResponseToolMcp {
+        server_label: string;
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        allowed_tools?: Array<string> | OpenAIResponseToolMcp.AllowedToolsFilter | null;
+        type?: 'mcp';
+    }
+    namespace OpenAIResponseToolMcp {
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        interface AllowedToolsFilter {
+            tool_names?: Array<string> | null;
+        }
+    }
     /**
-     * Object type identifier, always "response"
+     * Usage information for OpenAI response.
      */
-    object: 'response';
+    interface Usage {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        input_tokens_details?: Usage.InputTokensDetails | null;
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        output_tokens_details?: Usage.OutputTokensDetails | null;
+    }
+    namespace Usage {
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        interface InputTokensDetails {
+            cached_tokens?: number | null;
+        }
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        interface OutputTokensDetails {
+            reasoning_tokens?: number | null;
+        }
+    }
+}
+/**
+ * Response object confirming deletion of an OpenAI response.
+ */
+export interface ResponseDeleteResponse {
+    id: string;
+    deleted?: boolean;
+    object?: 'response';
 }
 export type ResponseCreateParams = ResponseCreateParamsNonStreaming | ResponseCreateParamsStreaming;
 export interface ResponseCreateParamsBase {
-    /**
-     * Input message(s) to create the response.
-     */
-    input: string | Array<ResponseCreateParams.OpenAIResponseOutputMessageWebSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFileSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFunctionToolCall | ResponseCreateParams.OpenAIResponseInputFunctionToolCallOutput | ResponseCreateParams.OpenAIResponseMessage>;
-    /**
-     * The underlying LLM used for completions.
-     */
+    input: string | Array<ResponseCreateParams.OpenAIResponseMessageInput | ResponseCreateParams.OpenAIResponseOutputMessageWebSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFileSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFunctionToolCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpListTools | ResponseCreateParams.OpenAIResponseMcpApprovalRequest | ResponseCreateParams.OpenAIResponseInputFunctionToolCallOutput | ResponseCreateParams.OpenAIResponseMcpApprovalResponse | ResponseCreateParams.OpenAIResponseMessageInput>;
     model: string;
-    /**
-     * (Optional) Additional fields to include in the response.
-     */
-    include?: Array<string>;
-    instructions?: string;
-    max_infer_iters?: number;
-    /**
-     * (Optional) if specified, the new response will be a continuation of the previous
-     * response. This can be used to easily fork-off new responses from existing
-     * responses.
-     */
-    previous_response_id?: string;
-    store?: boolean;
-    stream?: boolean;
-    temperature?: number;
+    conversation?: string | null;
+    include?: Array<string> | null;
+    instructions?: string | null;
+    max_infer_iters?: number | null;
+    max_tool_calls?: number | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    parallel_tool_calls?: boolean | null;
+    previous_response_id?: string | null;
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    prompt?: ResponseCreateParams.Prompt | null;
+    store?: boolean | null;
+    stream?: boolean | null;
+    temperature?: number | null;
     /**
      * Text response configuration for OpenAI responses.
      */
-    text?: ResponseCreateParams.Text;
-    tools?: Array<ResponseCreateParams.OpenAIResponseInputToolWebSearch | ResponseCreateParams.OpenAIResponseInputToolFileSearch | ResponseCreateParams.OpenAIResponseInputToolFunction | ResponseCreateParams.OpenAIResponseInputToolMcp>;
+    text?: ResponseCreateParams.Text | null;
+    tools?: Array<ResponseCreateParams.OpenAIResponseInputToolWebSearch | ResponseCreateParams.OpenAIResponseInputToolFileSearch | ResponseCreateParams.OpenAIResponseInputToolFunction | ResponseCreateParams.OpenAIResponseInputToolMcp> | null;
 }
 export declare namespace ResponseCreateParams {
     /**
-     * Web search tool call output message for OpenAI responses.
+     * Corresponds to the various Message types in the Responses API. They are all
+     * under one type because the Responses API gives them all the same "type" value,
+     * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseOutputMessageWebSearchToolCall {
+    interface OpenAIResponseMessageInput {
+        content: string | Array<OpenAIResponseMessageInput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageInput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageInput {
         /**
-         * Unique identifier for this tool call
+         * Text content for input messages in OpenAI response format.
          */
-        id: string;
+        interface OpenAIResponseInputMessageContentText {
+            text: string;
+            type?: 'input_text';
+        }
+        /**
+         * Image content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentImage {
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
         /**
-         * Current status of the web search operation
+         * File content for input messages in OpenAI response format.
          */
-        status: string;
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
+        }
+        interface OpenAIResponseOutputMessageContentOutputText {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputText {
+            /**
+             * File citation annotation for referencing specific files in response content.
+             */
+            interface OpenAIResponseAnnotationFileCitation {
+                file_id: string;
+                filename: string;
+                index: number;
+                type?: 'file_citation';
+            }
+            /**
+             * URL citation annotation for referencing external web resources.
+             */
+            interface OpenAIResponseAnnotationCitation {
+                end_index: number;
+                start_index: number;
+                title: string;
+                url: string;
+                type?: 'url_citation';
+            }
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type?: 'container_file_citation';
+            }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type?: 'file_path';
+            }
+        }
         /**
-         * Tool call type identifier, always "web_search_call"
+         * Refusal content within a streamed response part.
          */
-        type: 'web_search_call';
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
+    }
+    /**
+     * Web search tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageWebSearchToolCall {
+        id: string;
+        status: string;
+        type?: 'web_search_call';
     }
     /**
      * File search tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFileSearchToolCall {
-        /**
-         * Unique identifier for this tool call
-         */
         id: string;
-        /**
-         * List of search queries executed
-         */
         queries: Array<string>;
-        /**
-         * Current status of the file search operation
-         */
         status: string;
-        /**
-         * Tool call type identifier, always "file_search_call"
-         */
-        type: 'file_search_call';
-        /**
-         * (Optional) Search results returned by the file search operation
-         */
-        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
     }
     namespace OpenAIResponseOutputMessageFileSearchToolCall {
         /**
          * Search results returned by the file search operation.
          */
         interface Result {
-            /**
-             * (Optional) Key-value attributes associated with the file
-             */
             attributes: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+                [key: string]: unknown;
             };
-            /**
-             * Unique identifier of the file containing the result
-             */
             file_id: string;
-            /**
-             * Name of the file containing the result
-             */
             filename: string;
-            /**
-             * Relevance score for this search result (between 0 and 1)
-             */
             score: number;
-            /**
-             * Text content of the search result
-             */
             text: string;
         }
     }
@@ -2136,30 +2104,55 @@ export declare namespace ResponseCreateParams {
      * Function tool call output message for OpenAI responses.
      */
     interface OpenAIResponseOutputMessageFunctionToolCall {
-        /**
-         * JSON string containing the function arguments
-         */
         arguments: string;
-        /**
-         * Unique identifier for the function call
-         */
         call_id: string;
-        /**
-         * Name of the function being called
-         */
         name: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call';
+    }
+    /**
+     * Model Context Protocol (MCP) call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageMcpCall {
+        id: string;
+        arguments: string;
+        name: string;
+        server_label: string;
+        error?: string | null;
+        output?: string | null;
+        type?: 'mcp_call';
+    }
+    /**
+     * MCP list tools output message containing available tools from an MCP server.
+     */
+    interface OpenAIResponseOutputMessageMcpListTools {
+        id: string;
+        server_label: string;
+        tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
+        type?: 'mcp_list_tools';
+    }
+    namespace OpenAIResponseOutputMessageMcpListTools {
         /**
-         * Tool call type identifier, always "function_call"
-         */
-        type: 'function_call';
-        /**
-         * (Optional) Additional identifier for the tool call
-         */
-        id?: string;
-        /**
-         * (Optional) Current status of the function call execution
+         * Tool definition returned by MCP list tools operation.
          */
-        status?: string;
+        interface Tool {
+            input_schema: {
+                [key: string]: unknown;
+            };
+            name: string;
+            description?: string | null;
+        }
+    }
+    /**
+     * A request for human approval of a tool invocation.
+     */
+    interface OpenAIResponseMcpApprovalRequest {
+        id: string;
+        arguments: string;
+        name: string;
+        server_label: string;
+        type?: 'mcp_approval_request';
     }
     /**
      * This represents the output of a function call that gets passed back to the
@@ -2168,104 +2161,83 @@ export declare namespace ResponseCreateParams {
     interface OpenAIResponseInputFunctionToolCallOutput {
         call_id: string;
         output: string;
-        type: 'function_call_output';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'function_call_output';
+    }
+    /**
+     * A response to an MCP approval request.
+     */
+    interface OpenAIResponseMcpApprovalResponse {
+        approval_request_id: string;
+        approve: boolean;
+        id?: string | null;
+        reason?: string | null;
+        type?: 'mcp_approval_response';
     }
     /**
      * Corresponds to the various Message types in the Responses API. They are all
      * under one type because the Responses API gives them all the same "type" value,
      * and there is no way to tell them apart in certain scenarios.
      */
-    interface OpenAIResponseMessage {
-        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+    interface OpenAIResponseMessageInput {
+        content: string | Array<OpenAIResponseMessageInput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageInput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal>;
         role: 'system' | 'developer' | 'user' | 'assistant';
-        type: 'message';
-        id?: string;
-        status?: string;
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
     }
-    namespace OpenAIResponseMessage {
+    namespace OpenAIResponseMessageInput {
         /**
          * Text content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentText {
-            /**
-             * The text content of the input message
-             */
             text: string;
-            /**
-             * Content type identifier, always "input_text"
-             */
-            type: 'input_text';
+            type?: 'input_text';
         }
         /**
          * Image content for input messages in OpenAI response format.
          */
         interface OpenAIResponseInputMessageContentImage {
-            /**
-             * Level of detail for image processing, can be "low", "high", or "auto"
-             */
-            detail: 'low' | 'high' | 'auto';
-            /**
-             * Content type identifier, always "input_image"
-             */
-            type: 'input_image';
-            /**
-             * (Optional) URL of the image content
-             */
-            image_url?: string;
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
         }
-        interface UnionMember2 {
-            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+        interface OpenAIResponseOutputMessageContentOutputText {
             text: string;
-            type: 'output_text';
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            type?: 'output_text';
         }
-        namespace UnionMember2 {
+        namespace OpenAIResponseOutputMessageContentOutputText {
             /**
              * File citation annotation for referencing specific files in response content.
              */
             interface OpenAIResponseAnnotationFileCitation {
-                /**
-                 * Unique identifier of the referenced file
-                 */
                 file_id: string;
-                /**
-                 * Name of the referenced file
-                 */
                 filename: string;
-                /**
-                 * Position index of the citation within the content
-                 */
                 index: number;
-                /**
-                 * Annotation type identifier, always "file_citation"
-                 */
-                type: 'file_citation';
+                type?: 'file_citation';
             }
             /**
              * URL citation annotation for referencing external web resources.
              */
             interface OpenAIResponseAnnotationCitation {
-                /**
-                 * End position of the citation span in the content
-                 */
                 end_index: number;
-                /**
-                 * Start position of the citation span in the content
-                 */
                 start_index: number;
-                /**
-                 * Title of the referenced web resource
-                 */
                 title: string;
-                /**
-                 * Annotation type identifier, always "url_citation"
-                 */
-                type: 'url_citation';
-                /**
-                 * URL of the referenced web resource
-                 */
                 url: string;
+                type?: 'url_citation';
             }
             interface OpenAIResponseAnnotationContainerFileCitation {
                 container_id: string;
@@ -2273,210 +2245,176 @@ export declare namespace ResponseCreateParams {
                 file_id: string;
                 filename: string;
                 start_index: number;
-                type: 'container_file_citation';
+                type?: 'container_file_citation';
             }
             interface OpenAIResponseAnnotationFilePath {
                 file_id: string;
                 index: number;
-                type: 'file_path';
+                type?: 'file_path';
             }
         }
+        /**
+         * Refusal content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartRefusal {
+            refusal: string;
+            type?: 'refusal';
+        }
+    }
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    interface Prompt {
+        id: string;
+        variables?: {
+            [key: string]: Prompt.OpenAIResponseInputMessageContentText | Prompt.OpenAIResponseInputMessageContentImage | Prompt.OpenAIResponseInputMessageContentFile;
+        } | null;
+        version?: string | null;
+    }
+    namespace Prompt {
+        /**
+         * Text content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentText {
+            text: string;
+            type?: 'input_text';
+        }
+        /**
+         * Image content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentImage {
+            detail?: 'low' | 'high' | 'auto';
+            file_id?: string | null;
+            image_url?: string | null;
+            type?: 'input_image';
+        }
+        /**
+         * File content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentFile {
+            file_data?: string | null;
+            file_id?: string | null;
+            file_url?: string | null;
+            filename?: string | null;
+            type?: 'input_file';
+        }
     }
     /**
      * Text response configuration for OpenAI responses.
      */
     interface Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
-        format?: Text.Format;
+        format?: Text.Format | null;
     }
     namespace Text {
         /**
-         * (Optional) Text format configuration specifying output format requirements
+         * Configuration for Responses API text format.
          */
         interface Format {
-            /**
-             * Must be "text", "json_schema", or "json_object" to identify the format type
-             */
-            type: 'text' | 'json_schema' | 'json_object';
-            /**
-             * (Optional) A description of the response format. Only used for json_schema.
-             */
-            description?: string;
-            /**
-             * The name of the response format. Only used for json_schema.
-             */
-            name?: string;
-            /**
-             * The JSON schema the response should conform to. In a Python SDK, this is often a
-             * `pydantic` model. Only used for json_schema.
-             */
+            description?: string | null;
+            name?: string | null;
             schema?: {
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-            };
-            /**
-             * (Optional) Whether to strictly enforce the JSON schema. If true, the response
-             * must match the schema exactly. Only used for json_schema.
-             */
-            strict?: boolean;
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
         }
     }
     /**
      * Web search tool configuration for OpenAI response inputs.
      */
     interface OpenAIResponseInputToolWebSearch {
-        /**
-         * Web search tool type variant to use
-         */
-        type: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11';
-        /**
-         * (Optional) Size of search context, must be "low", "medium", or "high"
-         */
-        search_context_size?: string;
+        search_context_size?: string | null;
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
     }
     /**
      * File search tool configuration for OpenAI response inputs.
      */
     interface OpenAIResponseInputToolFileSearch {
-        /**
-         * Tool type identifier, always "file_search"
-         */
-        type: 'file_search';
-        /**
-         * List of vector store identifiers to search within
-         */
         vector_store_ids: Array<string>;
-        /**
-         * (Optional) Additional filters to apply to the search
-         */
         filters?: {
-            [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-        };
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
         /**
-         * (Optional) Maximum number of search results to return (1-50)
+         * Options for ranking and filtering search results.
          */
-        max_num_results?: number;
-        /**
-         * (Optional) Options for ranking and scoring search results
-         */
-        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions;
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
     }
     namespace OpenAIResponseInputToolFileSearch {
         /**
-         * (Optional) Options for ranking and scoring search results
+         * Options for ranking and filtering search results.
          */
         interface RankingOptions {
-            /**
-             * (Optional) Name of the ranking algorithm to use
-             */
-            ranker?: string;
-            /**
-             * (Optional) Minimum relevance score threshold for results
-             */
-            score_threshold?: number;
+            ranker?: string | null;
+            score_threshold?: number | null;
         }
     }
     /**
      * Function tool configuration for OpenAI response inputs.
      */
     interface OpenAIResponseInputToolFunction {
-        /**
-         * Name of the function that can be called
-         */
         name: string;
-        /**
-         * Tool type identifier, always "function"
-         */
-        type: 'function';
-        /**
-         * (Optional) Description of what the function does
-         */
-        description?: string;
-        /**
-         * (Optional) JSON schema defining the function's parameters
-         */
-        parameters?: {
-            [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-        };
-        /**
-         * (Optional) Whether to enforce strict parameter validation
-         */
-        strict?: boolean;
+        parameters: {
+            [key: string]: unknown;
+        } | null;
+        description?: string | null;
+        strict?: boolean | null;
+        type?: 'function';
     }
     /**
      * Model Context Protocol (MCP) tool configuration for OpenAI response inputs.
      */
     interface OpenAIResponseInputToolMcp {
-        /**
-         * Approval requirement for tool calls ("always", "never", or filter)
-         */
-        require_approval: 'always' | 'never' | OpenAIResponseInputToolMcp.ApprovalFilter;
-        /**
-         * Label to identify this MCP server
-         */
         server_label: string;
-        /**
-         * URL endpoint of the MCP server
-         */
         server_url: string;
         /**
-         * Tool type identifier, always "mcp"
-         */
-        type: 'mcp';
-        /**
-         * (Optional) Restriction on which tools can be used from this server
+         * Filter configuration for restricting which MCP tools can be used.
          */
-        allowed_tools?: Array<string> | OpenAIResponseInputToolMcp.AllowedToolsFilter;
+        allowed_tools?: Array<string> | OpenAIResponseInputToolMcp.AllowedToolsFilter | null;
+        authorization?: string | null;
+        headers?: {
+            [key: string]: unknown;
+        } | null;
         /**
-         * (Optional) HTTP headers to include when connecting to the server
+         * Filter configuration for MCP tool approval requirements.
          */
-        headers?: {
-            [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-        };
+        require_approval?: 'always' | 'never' | OpenAIResponseInputToolMcp.ApprovalFilter;
+        type?: 'mcp';
     }
     namespace OpenAIResponseInputToolMcp {
         /**
-         * Filter configuration for MCP tool approval requirements.
+         * Filter configuration for restricting which MCP tools can be used.
          */
-        interface ApprovalFilter {
-            /**
-             * (Optional) List of tool names that always require approval
-             */
-            always?: Array<string>;
-            /**
-             * (Optional) List of tool names that never require approval
-             */
-            never?: Array<string>;
+        interface AllowedToolsFilter {
+            tool_names?: Array<string> | null;
         }
         /**
-         * Filter configuration for restricting which MCP tools can be used.
+         * Filter configuration for MCP tool approval requirements.
          */
-        interface AllowedToolsFilter {
-            /**
-             * (Optional) List of specific tool names that are allowed
-             */
-            tool_names?: Array<string>;
+        interface ApprovalFilter {
+            always?: Array<string> | null;
+            never?: Array<string> | null;
         }
     }
     type ResponseCreateParamsNonStreaming = ResponsesAPI.ResponseCreateParamsNonStreaming;
     type ResponseCreateParamsStreaming = ResponsesAPI.ResponseCreateParamsStreaming;
 }
 export interface ResponseCreateParamsNonStreaming extends ResponseCreateParamsBase {
-    stream?: false;
+    stream?: false | null;
 }
 export interface ResponseCreateParamsStreaming extends ResponseCreateParamsBase {
     stream: true;
 }
 export interface ResponseListParams extends OpenAICursorPageParams {
+    model?: string | null;
     /**
-     * The model to filter responses by.
-     */
-    model?: string;
-    /**
-     * The order to sort responses by when sorted by created_at ('asc' or 'desc').
+     * Sort order for paginated responses.
      */
-    order?: 'asc' | 'desc';
+    order?: 'asc' | 'desc' | null;
 }
 export declare namespace Responses {
     export { type ResponseObject as ResponseObject, type ResponseObjectStream as ResponseObjectStream, type ResponseListResponse as ResponseListResponse, type ResponseDeleteResponse as ResponseDeleteResponse, ResponseListResponsesOpenAICursorPage as ResponseListResponsesOpenAICursorPage, type ResponseCreateParams as ResponseCreateParams, type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming, type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming, type ResponseListParams as ResponseListParams, };