llama-stack-client 0.4.3 → 0.4.5

package/dist/resources/responses/responses.d.ts

@@ -0,0 +1,3180 @@
+import { APIResource } from "../../resource.js";
+import { APIPromise } from "../../core.js";
+import * as Core from "../../core.js";
+import * as ResponsesAPI from "./responses.js";
+import * as InputItemsAPI from "./input-items.js";
+import { InputItemListParams, InputItemListResponse, InputItems } from "./input-items.js";
+import { OpenAICursorPage, type OpenAICursorPageParams } from "../../pagination.js";
+import { Stream } from "../../streaming.js";
+export declare class Responses extends APIResource {
+    inputItems: InputItemsAPI.InputItems;
+    /**
+     * 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>;
+    /**
+     * Get a model response.
+     */
+    retrieve(responseId: string, options?: Core.RequestOptions): Core.APIPromise<ResponseObject>;
+    /**
+     * List all responses.
+     */
+    list(query?: ResponseListParams, options?: Core.RequestOptions): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
+    list(options?: Core.RequestOptions): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
+    /**
+     * Delete a response.
+     */
+    delete(responseId: string, options?: Core.RequestOptions): Core.APIPromise<ResponseDeleteResponse>;
+}
+export declare class ResponseListResponsesOpenAICursorPage extends OpenAICursorPage<ResponseListResponse> {
+}
+/**
+ * Complete OpenAI response object containing generation results and metadata.
+ */
+export interface ResponseObject {
+    id: string;
+    created_at: number;
+    model: string;
+    output: Array<ResponseObject.OpenAIResponseMessageOutput | ResponseObject.OpenAIResponseOutputMessageWebSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFileSearchToolCall | ResponseObject.OpenAIResponseOutputMessageFunctionToolCall | ResponseObject.OpenAIResponseOutputMessageMcpCall | ResponseObject.OpenAIResponseOutputMessageMcpListTools | ResponseObject.OpenAIResponseMcpApprovalRequest>;
+    status: string;
+    store: boolean;
+    completed_at?: number | null;
+    /**
+     * Error details for failed OpenAI response requests.
+     */
+    error?: ResponseObject.Error | null;
+    instructions?: string | null;
+    max_output_tokens?: number | null;
+    max_tool_calls?: number | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    object?: 'response';
+    parallel_tool_calls?: boolean | null;
+    previous_response_id?: string | null;
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    prompt?: ResponseObject.Prompt | null;
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    reasoning?: ResponseObject.Reasoning | null;
+    safety_identifier?: string | null;
+    temperature?: number | null;
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    text?: ResponseObject.Text;
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     */
+    tool_choice?: 'auto' | 'required' | 'none' | ResponseObject.OpenAIResponseInputToolChoiceAllowedTools | ResponseObject.OpenAIResponseInputToolChoiceFileSearch | ResponseObject.OpenAIResponseInputToolChoiceWebSearch | ResponseObject.OpenAIResponseInputToolChoiceFunctionTool | ResponseObject.OpenAIResponseInputToolChoiceMcpTool | ResponseObject.OpenAIResponseInputToolChoiceCustomTool | null;
+    tools?: Array<ResponseObject.OpenAIResponseInputToolWebSearch | ResponseObject.OpenAIResponseInputToolFileSearch | ResponseObject.OpenAIResponseInputToolFunction | ResponseObject.OpenAIResponseToolMcp> | null;
+    top_p?: number | null;
+    truncation?: string | null;
+    /**
+     * Usage information for OpenAI response.
+     */
+    usage?: ResponseObject.Usage | null;
+}
+export declare namespace ResponseObject {
+    /**
+     * 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 OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputTextOutput | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageOutput {
+        /**
+         * 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';
+        }
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
+            /**
+             * 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 {
+        id: string;
+        queries: Array<string>;
+        status: string;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        interface Result {
+            attributes: {
+                [key: string]: unknown;
+            };
+            file_id: string;
+            filename: string;
+            score: number;
+            text: string;
+        }
+    }
+    /**
+     * 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 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';
+        }
+    }
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    interface Reasoning {
+        effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+    }
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    interface Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        format?: Text.Format | null;
+    }
+    namespace Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        interface Format {
+            description?: string | null;
+            name?: string | null;
+            schema?: {
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
+        }
+    }
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     */
+    interface OpenAIResponseInputToolChoiceAllowedTools {
+        tools: Array<{
+            [key: string]: string;
+        }>;
+        mode?: 'auto' | 'required';
+        type?: 'allowed_tools';
+    }
+    /**
+     * Indicates that the model should use file search to generate a response.
+     */
+    interface OpenAIResponseInputToolChoiceFileSearch {
+        type?: 'file_search';
+    }
+    /**
+     * Indicates that the model should use web search to generate a response
+     */
+    interface OpenAIResponseInputToolChoiceWebSearch {
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
+    }
+    /**
+     * Forces the model to call a specific function.
+     */
+    interface OpenAIResponseInputToolChoiceFunctionTool {
+        name: string;
+        type?: 'function';
+    }
+    /**
+     * Forces the model to call a specific tool on a remote MCP server
+     */
+    interface OpenAIResponseInputToolChoiceMcpTool {
+        server_label: string;
+        name?: string | null;
+        type?: 'mcp';
+    }
+    /**
+     * Forces the model to call a custom tool.
+     */
+    interface OpenAIResponseInputToolChoiceCustomTool {
+        name: string;
+        type?: 'custom';
+    }
+    /**
+     * 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 OpenAIResponseInputToolFileSearch {
+        vector_store_ids: Array<string>;
+        filters?: {
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
+    }
+    namespace OpenAIResponseInputToolFileSearch {
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        interface RankingOptions {
+            /**
+             * Weight factor for weighted ranker
+             */
+            alpha?: number | null;
+            /**
+             * Impact factor for RRF algorithm
+             */
+            impact_factor?: number | null;
+            /**
+             * Model identifier for neural reranker
+             */
+            model?: string | null;
+            ranker?: string | null;
+            score_threshold?: number | null;
+            /**
+             * Weights for combining vector, keyword, and neural scores. Keys: 'vector',
+             * 'keyword', 'neural'
+             */
+            weights?: {
+                [key: string]: 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;
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        input_tokens_details: Usage.InputTokensDetails;
+        output_tokens: number;
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        output_tokens_details: Usage.OutputTokensDetails;
+        total_tokens: number;
+    }
+    namespace Usage {
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        interface InputTokensDetails {
+            cached_tokens: number;
+        }
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        interface OutputTokensDetails {
+            reasoning_tokens: number;
+        }
+    }
+}
+/**
+ * Streaming event indicating a new response has been created.
+ */
+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 {
+        /**
+         * 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 {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        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 {
+        /**
+         * 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;
+        response_id: string;
+        sequence_number: number;
+        type?: 'response.output_item.added';
+    }
+    namespace OpenAIResponseObjectStreamResponseOutputItemAdded {
+        /**
+         * 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 | OpenAIResponseMessage.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessage.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessage.OpenAIResponseContentPartRefusal>;
+            role: 'system' | 'developer' | 'user' | 'assistant';
+            id?: string | null;
+            status?: string | null;
+            type?: 'message';
+        }
+        namespace OpenAIResponseMessage {
+            /**
+             * 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';
+            }
+            interface OpenAIResponseOutputMessageContentOutputText {
+                text: string;
+                annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                logprobs?: Array<OpenAIResponseOutputMessageContentOutputText.Logprob> | null;
+                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';
+                }
+                /**
+                 * The log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface Logprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                    /**
+                     * The top log probabilities for the token.
+                     */
+                    top_logprobs?: Array<Logprob.TopLogprob> | null;
+                }
+                namespace Logprob {
+                    /**
+                     * The top log probability for a token from an OpenAI-compatible chat completion
+                     * response.
+                     */
+                    interface TopLogprob {
+                        /**
+                         * The token.
+                         */
+                        token: string;
+                        /**
+                         * The log probability of the token.
+                         */
+                        logprob: number;
+                        /**
+                         * The bytes for the token.
+                         */
+                        bytes?: Array<number> | null;
+                    }
+                }
+            }
+            /**
+             * 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 {
+            id: string;
+            queries: Array<string>;
+            status: string;
+            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+            type?: 'file_search_call';
+        }
+        namespace OpenAIResponseOutputMessageFileSearchToolCall {
+            /**
+             * Search results returned by the file search operation.
+             */
+            interface Result {
+                attributes: {
+                    [key: string]: unknown;
+                };
+                file_id: string;
+                filename: string;
+                score: number;
+                text: string;
+            }
+        }
+        /**
+         * 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 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 {
+        /**
+         * 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;
+        response_id: string;
+        sequence_number: number;
+        type?: 'response.output_item.done';
+    }
+    namespace OpenAIResponseObjectStreamResponseOutputItemDone {
+        /**
+         * 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 | OpenAIResponseMessage.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessage.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessage.OpenAIResponseContentPartRefusal>;
+            role: 'system' | 'developer' | 'user' | 'assistant';
+            id?: string | null;
+            status?: string | null;
+            type?: 'message';
+        }
+        namespace OpenAIResponseMessage {
+            /**
+             * 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';
+            }
+            interface OpenAIResponseOutputMessageContentOutputText {
+                text: string;
+                annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                logprobs?: Array<OpenAIResponseOutputMessageContentOutputText.Logprob> | null;
+                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';
+                }
+                /**
+                 * The log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface Logprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                    /**
+                     * The top log probabilities for the token.
+                     */
+                    top_logprobs?: Array<Logprob.TopLogprob> | null;
+                }
+                namespace Logprob {
+                    /**
+                     * The top log probability for a token from an OpenAI-compatible chat completion
+                     * response.
+                     */
+                    interface TopLogprob {
+                        /**
+                         * The token.
+                         */
+                        token: string;
+                        /**
+                         * The log probability of the token.
+                         */
+                        logprob: number;
+                        /**
+                         * The bytes for the token.
+                         */
+                        bytes?: Array<number> | null;
+                    }
+                }
+            }
+            /**
+             * 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 {
+            id: string;
+            queries: Array<string>;
+            status: string;
+            results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+            type?: 'file_search_call';
+        }
+        namespace OpenAIResponseOutputMessageFileSearchToolCall {
+            /**
+             * Search results returned by the file search operation.
+             */
+            interface Result {
+                attributes: {
+                    [key: string]: unknown;
+                };
+                file_id: string;
+                filename: string;
+                score: number;
+                text: string;
+            }
+        }
+        /**
+         * 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 OpenAIResponseMcpApprovalRequest {
+            id: string;
+            arguments: string;
+            name: string;
+            server_label: string;
+            type?: 'mcp_approval_request';
+        }
+    }
+    /**
+     * Streaming event for incremental text content updates.
+     */
+    interface OpenAIResponseObjectStreamResponseOutputTextDelta {
+        content_index: number;
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        logprobs?: Array<OpenAIResponseObjectStreamResponseOutputTextDelta.Logprob> | null;
+        type?: 'response.output_text.delta';
+    }
+    namespace OpenAIResponseObjectStreamResponseOutputTextDelta {
+        /**
+         * The log probability for a token from an OpenAI-compatible chat completion
+         * response.
+         */
+        interface Logprob {
+            /**
+             * The token.
+             */
+            token: string;
+            /**
+             * The log probability of the token.
+             */
+            logprob: number;
+            /**
+             * The bytes for the token.
+             */
+            bytes?: Array<number> | null;
+            /**
+             * The top log probabilities for the token.
+             */
+            top_logprobs?: Array<Logprob.TopLogprob> | null;
+        }
+        namespace Logprob {
+            /**
+             * The top log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface TopLogprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+            }
+        }
+    }
+    /**
+     * Streaming event for when text output is completed.
+     */
+    interface OpenAIResponseObjectStreamResponseOutputTextDone {
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        text: string;
+        type?: 'response.output_text.done';
+    }
+    /**
+     * Streaming event for incremental function call argument updates.
+     */
+    interface OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta {
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.function_call_arguments.delta';
+    }
+    /**
+     * Streaming event for when function call arguments are completed.
+     */
+    interface OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone {
+        arguments: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.function_call_arguments.done';
+    }
+    /**
+     * Streaming event for web search calls in progress.
+     */
+    interface OpenAIResponseObjectStreamResponseWebSearchCallInProgress {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.web_search_call.in_progress';
+    }
+    interface OpenAIResponseObjectStreamResponseWebSearchCallSearching {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.web_search_call.searching';
+    }
+    /**
+     * Streaming event for completed web search calls.
+     */
+    interface OpenAIResponseObjectStreamResponseWebSearchCallCompleted {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.web_search_call.completed';
+    }
+    interface OpenAIResponseObjectStreamResponseMcpListToolsInProgress {
+        sequence_number: number;
+        type?: 'response.mcp_list_tools.in_progress';
+    }
+    interface OpenAIResponseObjectStreamResponseMcpListToolsFailed {
+        sequence_number: number;
+        type?: 'response.mcp_list_tools.failed';
+    }
+    interface OpenAIResponseObjectStreamResponseMcpListToolsCompleted {
+        sequence_number: number;
+        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';
+    }
+    interface OpenAIResponseObjectStreamResponseMcpCallArgumentsDone {
+        arguments: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.mcp_call.arguments.done';
+    }
+    /**
+     * Streaming event for MCP calls in progress.
+     */
+    interface OpenAIResponseObjectStreamResponseMcpCallInProgress {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.mcp_call.in_progress';
+    }
+    /**
+     * Streaming event for failed MCP calls.
+     */
+    interface OpenAIResponseObjectStreamResponseMcpCallFailed {
+        sequence_number: number;
+        type?: 'response.mcp_call.failed';
+    }
+    /**
+     * Streaming event for completed MCP calls.
+     */
+    interface OpenAIResponseObjectStreamResponseMcpCallCompleted {
+        sequence_number: number;
+        type?: 'response.mcp_call.completed';
+    }
+    /**
+     * Streaming event for when a new content part is added to a response item.
+     */
+    interface OpenAIResponseObjectStreamResponseContentPartAdded {
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        /**
+         * Text content within a streamed response part.
+         */
+        part: OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartRefusal | OpenAIResponseObjectStreamResponseContentPartAdded.OpenAIResponseContentPartReasoningText;
+        response_id: string;
+        sequence_number: number;
+        type?: 'response.content_part.added';
+    }
+    namespace OpenAIResponseObjectStreamResponseContentPartAdded {
+        /**
+         * Text content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartOutputText {
+            text: string;
+            annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseContentPartOutputText.Logprob> | 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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;
+        /**
+         * Text content within a streamed response part.
+         */
+        part: OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartOutputText | OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartRefusal | OpenAIResponseObjectStreamResponseContentPartDone.OpenAIResponseContentPartReasoningText;
+        response_id: string;
+        sequence_number: number;
+        type?: 'response.content_part.done';
+    }
+    namespace OpenAIResponseObjectStreamResponseContentPartDone {
+        /**
+         * Text content within a streamed response part.
+         */
+        interface OpenAIResponseContentPartOutputText {
+            text: string;
+            annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseContentPartOutputText.Logprob> | 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 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;
+        /**
+         * Reasoning summary part in a streamed response.
+         */
+        part: OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded.Part;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_part.added';
+    }
+    namespace OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded {
+        /**
+         * Reasoning summary part in a streamed response.
+         */
+        interface Part {
+            text: string;
+            type?: 'summary_text';
+        }
+    }
+    /**
+     * Streaming event for when a reasoning summary part is completed.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryPartDone {
+        item_id: string;
+        output_index: number;
+        /**
+         * Reasoning summary part in a streamed response.
+         */
+        part: OpenAIResponseObjectStreamResponseReasoningSummaryPartDone.Part;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_part.done';
+    }
+    namespace OpenAIResponseObjectStreamResponseReasoningSummaryPartDone {
+        /**
+         * Reasoning summary part in a streamed response.
+         */
+        interface Part {
+            text: string;
+            type?: 'summary_text';
+        }
+    }
+    /**
+     * Streaming event for incremental reasoning summary text updates.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta {
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        summary_index: number;
+        type?: 'response.reasoning_summary_text.delta';
+    }
+    /**
+     * Streaming event for when reasoning summary text is completed.
+     */
+    interface OpenAIResponseObjectStreamResponseReasoningSummaryTextDone {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        summary_index: number;
+        text: string;
+        type?: 'response.reasoning_summary_text.done';
+    }
+    /**
+     * Streaming event for incremental refusal text updates.
+     */
+    interface OpenAIResponseObjectStreamResponseRefusalDelta {
+        content_index: number;
+        delta: string;
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.refusal.delta';
+    }
+    /**
+     * Streaming event for when refusal text is completed.
+     */
+    interface OpenAIResponseObjectStreamResponseRefusalDone {
+        content_index: number;
+        item_id: string;
+        output_index: number;
+        refusal: string;
+        sequence_number: number;
+        type?: 'response.refusal.done';
+    }
+    /**
+     * Streaming event for when an annotation is added to output text.
+     */
+    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';
+        }
+    }
+    /**
+     * Streaming event for file search calls in progress.
+     */
+    interface OpenAIResponseObjectStreamResponseFileSearchCallInProgress {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.in_progress';
+    }
+    /**
+     * Streaming event for file search currently searching.
+     */
+    interface OpenAIResponseObjectStreamResponseFileSearchCallSearching {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.searching';
+    }
+    /**
+     * Streaming event for completed file search calls.
+     */
+    interface OpenAIResponseObjectStreamResponseFileSearchCallCompleted {
+        item_id: string;
+        output_index: number;
+        sequence_number: number;
+        type?: 'response.file_search_call.completed';
+    }
+    /**
+     * Streaming event emitted when a response ends in an incomplete state.
+     */
+    interface OpenAIResponseObjectStreamResponseIncomplete {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        response: ResponsesAPI.ResponseObject;
+        sequence_number: number;
+        type?: 'response.incomplete';
+    }
+    /**
+     * Streaming event emitted when a response fails.
+     */
+    interface OpenAIResponseObjectStreamResponseFailed {
+        /**
+         * Complete OpenAI response object containing generation results and metadata.
+         */
+        response: ResponsesAPI.ResponseObject;
+        sequence_number: number;
+        type?: 'response.failed';
+    }
+    /**
+     * Streaming event indicating a response has been completed.
+     */
+    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;
+    store: boolean;
+    completed_at?: number | null;
+    /**
+     * Error details for failed OpenAI response requests.
+     */
+    error?: ResponseListResponse.Error | null;
+    instructions?: string | null;
+    max_output_tokens?: number | null;
+    max_tool_calls?: number | null;
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    object?: 'response';
+    parallel_tool_calls?: boolean | null;
+    previous_response_id?: string | null;
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    prompt?: ResponseListResponse.Prompt | null;
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    reasoning?: ResponseListResponse.Reasoning | null;
+    safety_identifier?: string | null;
+    temperature?: number | null;
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    text?: ResponseListResponse.Text;
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     */
+    tool_choice?: 'auto' | 'required' | 'none' | ResponseListResponse.OpenAIResponseInputToolChoiceAllowedTools | ResponseListResponse.OpenAIResponseInputToolChoiceFileSearch | ResponseListResponse.OpenAIResponseInputToolChoiceWebSearch | ResponseListResponse.OpenAIResponseInputToolChoiceFunctionTool | ResponseListResponse.OpenAIResponseInputToolChoiceMcpTool | ResponseListResponse.OpenAIResponseInputToolChoiceCustomTool | null;
+    tools?: Array<ResponseListResponse.OpenAIResponseInputToolWebSearch | ResponseListResponse.OpenAIResponseInputToolFileSearch | ResponseListResponse.OpenAIResponseInputToolFunction | ResponseListResponse.OpenAIResponseToolMcp> | null;
+    top_p?: number | null;
+    truncation?: string | null;
+    /**
+     * Usage information for OpenAI response.
+     */
+    usage?: ResponseListResponse.Usage | null;
+}
+export declare namespace ResponseListResponse {
+    /**
+     * 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 OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputTextOutput | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageOutput {
+        /**
+         * 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';
+        }
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
+            /**
+             * 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 {
+        id: string;
+        queries: Array<string>;
+        status: string;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        interface Result {
+            attributes: {
+                [key: string]: unknown;
+            };
+            file_id: string;
+            filename: string;
+            score: number;
+            text: string;
+        }
+    }
+    /**
+     * 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 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
+     * model.
+     */
+    interface OpenAIResponseInputFunctionToolCallOutput {
+        call_id: string;
+        output: 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 OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputTextOutput | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageOutput {
+        /**
+         * 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';
+        }
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
+            /**
+             * 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 OpenAIResponseMessageOutput {
+        content: string | Array<OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputTextOutput | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageOutput {
+        /**
+         * 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';
+        }
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
+            /**
+             * 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 {
+        id: string;
+        queries: Array<string>;
+        status: string;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        interface Result {
+            attributes: {
+                [key: string]: unknown;
+            };
+            file_id: string;
+            filename: string;
+            score: number;
+            text: string;
+        }
+    }
+    /**
+     * 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 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';
+        }
+    }
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    interface Reasoning {
+        effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+    }
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    interface Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        format?: Text.Format | null;
+    }
+    namespace Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        interface Format {
+            description?: string | null;
+            name?: string | null;
+            schema?: {
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
+        }
+    }
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     */
+    interface OpenAIResponseInputToolChoiceAllowedTools {
+        tools: Array<{
+            [key: string]: string;
+        }>;
+        mode?: 'auto' | 'required';
+        type?: 'allowed_tools';
+    }
+    /**
+     * Indicates that the model should use file search to generate a response.
+     */
+    interface OpenAIResponseInputToolChoiceFileSearch {
+        type?: 'file_search';
+    }
+    /**
+     * Indicates that the model should use web search to generate a response
+     */
+    interface OpenAIResponseInputToolChoiceWebSearch {
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
+    }
+    /**
+     * Forces the model to call a specific function.
+     */
+    interface OpenAIResponseInputToolChoiceFunctionTool {
+        name: string;
+        type?: 'function';
+    }
+    /**
+     * Forces the model to call a specific tool on a remote MCP server
+     */
+    interface OpenAIResponseInputToolChoiceMcpTool {
+        server_label: string;
+        name?: string | null;
+        type?: 'mcp';
+    }
+    /**
+     * Forces the model to call a custom tool.
+     */
+    interface OpenAIResponseInputToolChoiceCustomTool {
+        name: string;
+        type?: 'custom';
+    }
+    /**
+     * 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 OpenAIResponseInputToolFileSearch {
+        vector_store_ids: Array<string>;
+        filters?: {
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
+    }
+    namespace OpenAIResponseInputToolFileSearch {
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        interface RankingOptions {
+            /**
+             * Weight factor for weighted ranker
+             */
+            alpha?: number | null;
+            /**
+             * Impact factor for RRF algorithm
+             */
+            impact_factor?: number | null;
+            /**
+             * Model identifier for neural reranker
+             */
+            model?: string | null;
+            ranker?: string | null;
+            score_threshold?: number | null;
+            /**
+             * Weights for combining vector, keyword, and neural scores. Keys: 'vector',
+             * 'keyword', 'neural'
+             */
+            weights?: {
+                [key: string]: 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;
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        input_tokens_details: Usage.InputTokensDetails;
+        output_tokens: number;
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        output_tokens_details: Usage.OutputTokensDetails;
+        total_tokens: number;
+    }
+    namespace Usage {
+        /**
+         * Token details for input tokens in OpenAI response usage.
+         */
+        interface InputTokensDetails {
+            cached_tokens: number;
+        }
+        /**
+         * Token details for output tokens in OpenAI response usage.
+         */
+        interface OutputTokensDetails {
+            reasoning_tokens: number;
+        }
+    }
+}
+/**
+ * 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.OpenAIResponseMessageInput | ResponseCreateParams.OpenAIResponseOutputMessageWebSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFileSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFunctionToolCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpListTools | ResponseCreateParams.OpenAIResponseMcpApprovalRequest | ResponseCreateParams.OpenAIResponseInputFunctionToolCallOutput | ResponseCreateParams.OpenAIResponseMcpApprovalResponse>;
+    /**
+     * The underlying LLM used for completions.
+     */
+    model: string;
+    /**
+     * Optional ID of a conversation to add the response to.
+     */
+    conversation?: string | null;
+    /**
+     * List of guardrails to apply during response generation.
+     */
+    guardrails?: Array<string | ResponseCreateParams.ResponseGuardrailSpec> | null;
+    /**
+     * Additional fields to include in the response.
+     */
+    include?: Array<'web_search_call.action.sources' | 'code_interpreter_call.outputs' | 'computer_call_output.output.image_url' | 'file_search_call.results' | 'message.input_image.image_url' | 'message.output_text.logprobs' | 'reasoning.encrypted_content'> | null;
+    /**
+     * Instructions to guide the model's behavior.
+     */
+    instructions?: string | null;
+    /**
+     * Maximum number of inference iterations.
+     */
+    max_infer_iters?: number | null;
+    /**
+     * Upper bound for the number of tokens that can be generated for a response.
+     */
+    max_output_tokens?: number | null;
+    /**
+     * Max number of total calls to built-in tools that can be processed in a response.
+     */
+    max_tool_calls?: number | null;
+    /**
+     * Dictionary of metadata key-value pairs to attach to the response.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Whether to enable parallel tool calls.
+     */
+    parallel_tool_calls?: boolean | null;
+    /**
+     * Optional ID of a previous response to continue from.
+     */
+    previous_response_id?: string | null;
+    /**
+     * OpenAI compatible Prompt object that is used in OpenAI responses.
+     */
+    prompt?: ResponseCreateParams.Prompt | null;
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    reasoning?: ResponseCreateParams.Reasoning | null;
+    /**
+     * A stable identifier used for safety monitoring and abuse detection.
+     */
+    safety_identifier?: string | null;
+    /**
+     * Whether to store the response in the database.
+     */
+    store?: boolean | null;
+    /**
+     * Whether to stream the response.
+     */
+    stream?: boolean | null;
+    /**
+     * Sampling temperature.
+     */
+    temperature?: number | null;
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    text?: ResponseCreateParams.Text | null;
+    /**
+     * How the model should select which tool to call (if any).
+     */
+    tool_choice?: 'auto' | 'required' | 'none' | ResponseCreateParams.OpenAIResponseInputToolChoiceAllowedTools | ResponseCreateParams.OpenAIResponseInputToolChoiceFileSearch | ResponseCreateParams.OpenAIResponseInputToolChoiceWebSearch | ResponseCreateParams.OpenAIResponseInputToolChoiceFunctionTool | ResponseCreateParams.OpenAIResponseInputToolChoiceMcpTool | ResponseCreateParams.OpenAIResponseInputToolChoiceCustomTool | null;
+    /**
+     * List of tools available to the model.
+     */
+    tools?: Array<ResponseCreateParams.OpenAIResponseInputToolWebSearch | ResponseCreateParams.OpenAIResponseInputToolFileSearch | ResponseCreateParams.OpenAIResponseInputToolFunction | ResponseCreateParams.OpenAIResponseInputToolMcp> | null;
+}
+export declare namespace ResponseCreateParams {
+    /**
+     * 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 OpenAIResponseMessageInput {
+        content: string | Array<OpenAIResponseMessageInput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageInput.OpenAIResponseOutputMessageContentOutputTextInput | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        id?: string | null;
+        status?: string | null;
+        type?: 'message';
+    }
+    namespace OpenAIResponseMessageInput {
+        /**
+         * 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';
+        }
+        interface OpenAIResponseOutputMessageContentOutputTextInput {
+            text: string;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextInput.Logprob> | null;
+            type?: 'output_text';
+        }
+        namespace OpenAIResponseOutputMessageContentOutputTextInput {
+            /**
+             * 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';
+            }
+            /**
+             * The log probability for a token from an OpenAI-compatible chat completion
+             * response.
+             */
+            interface Logprob {
+                /**
+                 * The token.
+                 */
+                token: string;
+                /**
+                 * The log probability of the token.
+                 */
+                logprob: number;
+                /**
+                 * The bytes for the token.
+                 */
+                bytes?: Array<number> | null;
+                /**
+                 * The top log probabilities for the token.
+                 */
+                top_logprobs?: Array<Logprob.TopLogprob> | null;
+            }
+            namespace Logprob {
+                /**
+                 * The top log probability for a token from an OpenAI-compatible chat completion
+                 * response.
+                 */
+                interface TopLogprob {
+                    /**
+                     * The token.
+                     */
+                    token: string;
+                    /**
+                     * The log probability of the token.
+                     */
+                    logprob: number;
+                    /**
+                     * The bytes for the token.
+                     */
+                    bytes?: Array<number> | null;
+                }
+            }
+        }
+        /**
+         * 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 {
+        id: string;
+        queries: Array<string>;
+        status: string;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+        type?: 'file_search_call';
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        interface Result {
+            attributes: {
+                [key: string]: unknown;
+            };
+            file_id: string;
+            filename: string;
+            score: number;
+            text: string;
+        }
+    }
+    /**
+     * 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 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
+     * model.
+     */
+    interface OpenAIResponseInputFunctionToolCallOutput {
+        call_id: string;
+        output: 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';
+    }
+    /**
+     * Specification for a guardrail to apply during response generation.
+     */
+    interface ResponseGuardrailSpec {
+        type: 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';
+        }
+    }
+    /**
+     * Configuration for reasoning effort in OpenAI responses.
+     *
+     * Controls how much reasoning the model performs before generating a response.
+     */
+    interface Reasoning {
+        effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+    }
+    /**
+     * Text response configuration for OpenAI responses.
+     */
+    interface Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        format?: Text.Format | null;
+    }
+    namespace Text {
+        /**
+         * Configuration for Responses API text format.
+         */
+        interface Format {
+            description?: string | null;
+            name?: string | null;
+            schema?: {
+                [key: string]: unknown;
+            } | null;
+            strict?: boolean | null;
+            type?: 'text' | 'json_schema' | 'json_object';
+        }
+    }
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     */
+    interface OpenAIResponseInputToolChoiceAllowedTools {
+        tools: Array<{
+            [key: string]: string;
+        }>;
+        mode?: 'auto' | 'required';
+        type?: 'allowed_tools';
+    }
+    /**
+     * Indicates that the model should use file search to generate a response.
+     */
+    interface OpenAIResponseInputToolChoiceFileSearch {
+        type?: 'file_search';
+    }
+    /**
+     * Indicates that the model should use web search to generate a response
+     */
+    interface OpenAIResponseInputToolChoiceWebSearch {
+        type?: 'web_search' | 'web_search_preview' | 'web_search_preview_2025_03_11' | 'web_search_2025_08_26';
+    }
+    /**
+     * Forces the model to call a specific function.
+     */
+    interface OpenAIResponseInputToolChoiceFunctionTool {
+        name: string;
+        type?: 'function';
+    }
+    /**
+     * Forces the model to call a specific tool on a remote MCP server
+     */
+    interface OpenAIResponseInputToolChoiceMcpTool {
+        server_label: string;
+        name?: string | null;
+        type?: 'mcp';
+    }
+    /**
+     * Forces the model to call a custom tool.
+     */
+    interface OpenAIResponseInputToolChoiceCustomTool {
+        name: string;
+        type?: 'custom';
+    }
+    /**
+     * 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 OpenAIResponseInputToolFileSearch {
+        vector_store_ids: Array<string>;
+        filters?: {
+            [key: string]: unknown;
+        } | null;
+        max_num_results?: number | null;
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        ranking_options?: OpenAIResponseInputToolFileSearch.RankingOptions | null;
+        type?: 'file_search';
+    }
+    namespace OpenAIResponseInputToolFileSearch {
+        /**
+         * Options for ranking and filtering search results.
+         *
+         * This class configures how search results are ranked and filtered. You can use
+         * algorithm-based rerankers (weighted, RRF) or neural rerankers. Defaults from
+         * VectorStoresConfig are used when parameters are not provided.
+         *
+         * Examples: # Weighted ranker with custom alpha
+         * SearchRankingOptions(ranker="weighted", alpha=0.7)
+         *
+         *     # RRF ranker with custom impact factor
+         *     SearchRankingOptions(ranker="rrf", impact_factor=50.0)
+         *
+         *     # Use config defaults (just specify ranker type)
+         *     SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig
+         *
+         *     # Score threshold filtering
+         *     SearchRankingOptions(ranker="weighted", score_threshold=0.5)
+         */
+        interface RankingOptions {
+            /**
+             * Weight factor for weighted ranker
+             */
+            alpha?: number | null;
+            /**
+             * Impact factor for RRF algorithm
+             */
+            impact_factor?: number | null;
+            /**
+             * Model identifier for neural reranker
+             */
+            model?: string | null;
+            ranker?: string | null;
+            score_threshold?: number | null;
+            /**
+             * Weights for combining vector, keyword, and neural scores. Keys: 'vector',
+             * 'keyword', 'neural'
+             */
+            weights?: {
+                [key: string]: 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 inputs.
+     */
+    interface OpenAIResponseInputToolMcp {
+        server_label: string;
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        allowed_tools?: Array<string> | OpenAIResponseInputToolMcp.AllowedToolsFilter | null;
+        authorization?: string | null;
+        connector_id?: string | null;
+        headers?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * Filter configuration for MCP tool approval requirements.
+         */
+        require_approval?: 'always' | 'never' | OpenAIResponseInputToolMcp.ApprovalFilter;
+        server_url?: string | null;
+        type?: 'mcp';
+    }
+    namespace OpenAIResponseInputToolMcp {
+        /**
+         * Filter configuration for restricting which MCP tools can be used.
+         */
+        interface AllowedToolsFilter {
+            tool_names?: Array<string> | null;
+        }
+        /**
+         * Filter configuration for MCP tool approval requirements.
+         */
+        interface ApprovalFilter {
+            always?: Array<string> | null;
+            never?: Array<string> | null;
+        }
+    }
+    type ResponseCreateParamsNonStreaming = ResponsesAPI.ResponseCreateParamsNonStreaming;
+    type ResponseCreateParamsStreaming = ResponsesAPI.ResponseCreateParamsStreaming;
+}
+export interface ResponseCreateParamsNonStreaming extends ResponseCreateParamsBase {
+    /**
+     * Whether to stream the response.
+     */
+    stream?: false | null;
+}
+export interface ResponseCreateParamsStreaming extends ResponseCreateParamsBase {
+    /**
+     * Whether to stream the response.
+     */
+    stream: true;
+}
+export interface ResponseListParams extends OpenAICursorPageParams {
+    /**
+     * The model to filter responses by.
+     */
+    model?: string | null;
+    /**
+     * Sort order for paginated responses.
+     */
+    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, };
+    export { InputItems as InputItems, type InputItemListResponse as InputItemListResponse, type InputItemListParams as InputItemListParams, };
+}
+//# sourceMappingURL=responses.d.ts.map