llama-stack-client 0.4.4 → 0.4.5

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

@@ -39,11 +39,14 @@ export interface ResponseObject {
     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;
@@ -55,11 +58,22 @@ export interface ResponseObject {
      * 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;
@@ -75,7 +89,7 @@ export declare namespace ResponseObject {
      * 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.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        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;
@@ -108,12 +122,13 @@ export declare namespace ResponseObject {
             filename?: string | null;
             type?: 'input_file';
         }
-        interface OpenAIResponseOutputMessageContentOutputText {
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
             text: string;
-            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
             type?: 'output_text';
         }
-        namespace OpenAIResponseOutputMessageContentOutputText {
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
             /**
              * File citation annotation for referencing specific files in response content.
              */
@@ -146,6 +161,48 @@ export declare namespace ResponseObject {
                 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.
@@ -286,6 +343,14 @@ export declare namespace ResponseObject {
             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.
      */
@@ -309,6 +374,50 @@ export declare namespace ResponseObject {
             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.
      */
@@ -327,6 +436,22 @@ export declare namespace ResponseObject {
         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';
@@ -334,10 +459,45 @@ export declare namespace ResponseObject {
     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;
         }
     }
     /**
@@ -376,29 +536,29 @@ export declare namespace ResponseObject {
      */
     interface Usage {
         input_tokens: number;
-        output_tokens: number;
-        total_tokens: number;
         /**
          * Token details for input tokens in OpenAI response usage.
          */
-        input_tokens_details?: Usage.InputTokensDetails | null;
+        input_tokens_details: Usage.InputTokensDetails;
+        output_tokens: number;
         /**
          * Token details for output tokens in OpenAI response usage.
          */
-        output_tokens_details?: Usage.OutputTokensDetails | null;
+        output_tokens_details: Usage.OutputTokensDetails;
+        total_tokens: number;
     }
     namespace Usage {
         /**
          * Token details for input tokens in OpenAI response usage.
          */
         interface InputTokensDetails {
-            cached_tokens?: number | null;
+            cached_tokens: number;
         }
         /**
          * Token details for output tokens in OpenAI response usage.
          */
         interface OutputTokensDetails {
-            reasoning_tokens?: number | null;
+            reasoning_tokens: number;
         }
     }
 }
@@ -486,6 +646,7 @@ export declare namespace ResponseObjectStream {
             interface OpenAIResponseOutputMessageContentOutputText {
                 text: string;
                 annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                logprobs?: Array<OpenAIResponseOutputMessageContentOutputText.Logprob> | null;
                 type?: 'output_text';
             }
             namespace OpenAIResponseOutputMessageContentOutputText {
@@ -521,6 +682,48 @@ export declare namespace ResponseObjectStream {
                     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.
@@ -675,6 +878,7 @@ export declare namespace ResponseObjectStream {
             interface OpenAIResponseOutputMessageContentOutputText {
                 text: string;
                 annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+                logprobs?: Array<OpenAIResponseOutputMessageContentOutputText.Logprob> | null;
                 type?: 'output_text';
             }
             namespace OpenAIResponseOutputMessageContentOutputText {
@@ -710,6 +914,48 @@ export declare namespace ResponseObjectStream {
                     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.
@@ -815,8 +1061,53 @@ export declare namespace ResponseObjectStream {
         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.
      */
@@ -943,9 +1234,7 @@ export declare namespace ResponseObjectStream {
         interface OpenAIResponseContentPartOutputText {
             text: string;
             annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
-            logprobs?: Array<{
-                [key: string]: unknown;
-            }> | null;
+            logprobs?: Array<OpenAIResponseContentPartOutputText.Logprob> | null;
             type?: 'output_text';
         }
         namespace OpenAIResponseContentPartOutputText {
@@ -981,6 +1270,48 @@ export declare namespace ResponseObjectStream {
                 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.
@@ -1019,9 +1350,7 @@ export declare namespace ResponseObjectStream {
         interface OpenAIResponseContentPartOutputText {
             text: string;
             annotations?: Array<OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseContentPartOutputText.OpenAIResponseAnnotationFilePath>;
-            logprobs?: Array<{
-                [key: string]: unknown;
-            }> | null;
+            logprobs?: Array<OpenAIResponseContentPartOutputText.Logprob> | null;
             type?: 'output_text';
         }
         namespace OpenAIResponseContentPartOutputText {
@@ -1057,6 +1386,48 @@ export declare namespace ResponseObjectStream {
                 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.
@@ -1304,11 +1675,14 @@ export interface ResponseListResponse {
     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;
@@ -1320,11 +1694,22 @@ export interface ResponseListResponse {
      * 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;
@@ -1340,7 +1725,7 @@ export declare namespace ResponseListResponse {
      * 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.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        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;
@@ -1373,12 +1758,13 @@ export declare namespace ResponseListResponse {
             filename?: string | null;
             type?: 'input_file';
         }
-        interface OpenAIResponseOutputMessageContentOutputText {
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
             text: string;
-            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
             type?: 'output_text';
         }
-        namespace OpenAIResponseOutputMessageContentOutputText {
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
             /**
              * File citation annotation for referencing specific files in response content.
              */
@@ -1411,6 +1797,48 @@ export declare namespace ResponseListResponse {
                 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.
@@ -1533,7 +1961,7 @@ export declare namespace ResponseListResponse {
      * 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.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        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;
@@ -1566,12 +1994,13 @@ export declare namespace ResponseListResponse {
             filename?: string | null;
             type?: 'input_file';
         }
-        interface OpenAIResponseOutputMessageContentOutputText {
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
             text: string;
-            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
             type?: 'output_text';
         }
-        namespace OpenAIResponseOutputMessageContentOutputText {
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
             /**
              * File citation annotation for referencing specific files in response content.
              */
@@ -1604,6 +2033,48 @@ export declare namespace ResponseListResponse {
                 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.
@@ -1619,7 +2090,7 @@ export declare namespace ResponseListResponse {
      * 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.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal>;
+        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;
@@ -1652,12 +2123,13 @@ export declare namespace ResponseListResponse {
             filename?: string | null;
             type?: 'input_file';
         }
-        interface OpenAIResponseOutputMessageContentOutputText {
+        interface OpenAIResponseOutputMessageContentOutputTextOutput {
             text: string;
-            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextOutput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextOutput.Logprob> | null;
             type?: 'output_text';
         }
-        namespace OpenAIResponseOutputMessageContentOutputText {
+        namespace OpenAIResponseOutputMessageContentOutputTextOutput {
             /**
              * File citation annotation for referencing specific files in response content.
              */
@@ -1690,6 +2162,48 @@ export declare namespace ResponseListResponse {
                 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.
@@ -1830,6 +2344,14 @@ export declare namespace ResponseListResponse {
             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.
      */
@@ -1853,6 +2375,50 @@ export declare namespace ResponseListResponse {
             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.
      */
@@ -1871,6 +2437,22 @@ export declare namespace ResponseListResponse {
         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';
@@ -1878,10 +2460,45 @@ export declare namespace ResponseListResponse {
     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;
         }
     }
     /**
@@ -1920,29 +2537,29 @@ export declare namespace ResponseListResponse {
      */
     interface Usage {
         input_tokens: number;
-        output_tokens: number;
-        total_tokens: number;
         /**
          * Token details for input tokens in OpenAI response usage.
          */
-        input_tokens_details?: Usage.InputTokensDetails | null;
+        input_tokens_details: Usage.InputTokensDetails;
+        output_tokens: number;
         /**
          * Token details for output tokens in OpenAI response usage.
          */
-        output_tokens_details?: Usage.OutputTokensDetails | null;
+        output_tokens_details: Usage.OutputTokensDetails;
+        total_tokens: number;
     }
     namespace Usage {
         /**
          * Token details for input tokens in OpenAI response usage.
          */
         interface InputTokensDetails {
-            cached_tokens?: number | null;
+            cached_tokens: number;
         }
         /**
          * Token details for output tokens in OpenAI response usage.
          */
         interface OutputTokensDetails {
-            reasoning_tokens?: number | null;
+            reasoning_tokens: number;
         }
     }
 }
@@ -1956,29 +2573,93 @@ export interface ResponseDeleteResponse {
 }
 export type ResponseCreateParams = ResponseCreateParamsNonStreaming | ResponseCreateParamsStreaming;
 export interface ResponseCreateParamsBase {
-    input: string | Array<ResponseCreateParams.OpenAIResponseMessageInput | ResponseCreateParams.OpenAIResponseOutputMessageWebSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFileSearchToolCall | ResponseCreateParams.OpenAIResponseOutputMessageFunctionToolCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpCall | ResponseCreateParams.OpenAIResponseOutputMessageMcpListTools | ResponseCreateParams.OpenAIResponseMcpApprovalRequest | ResponseCreateParams.OpenAIResponseInputFunctionToolCallOutput | ResponseCreateParams.OpenAIResponseMcpApprovalResponse | ResponseCreateParams.OpenAIResponseMessageInput>;
+    /**
+     * 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;
-    include?: Array<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 {
@@ -1988,7 +2669,7 @@ export declare namespace ResponseCreateParams {
      * 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.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal>;
+        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;
@@ -2021,12 +2702,13 @@ export declare namespace ResponseCreateParams {
             filename?: string | null;
             type?: 'input_file';
         }
-        interface OpenAIResponseOutputMessageContentOutputText {
+        interface OpenAIResponseOutputMessageContentOutputTextInput {
             text: string;
-            annotations?: Array<OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath>;
+            annotations?: Array<OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFileCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationContainerFileCitation | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFilePath>;
+            logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextInput.Logprob> | null;
             type?: 'output_text';
         }
-        namespace OpenAIResponseOutputMessageContentOutputText {
+        namespace OpenAIResponseOutputMessageContentOutputTextInput {
             /**
              * File citation annotation for referencing specific files in response content.
              */
@@ -2059,6 +2741,48 @@ export declare namespace ResponseCreateParams {
                 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.
@@ -2176,90 +2900,10 @@ export declare namespace ResponseCreateParams {
         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.
+     * Specification for a guardrail to apply during response generation.
      */
-    interface OpenAIResponseMessageInput {
-        content: string | Array<OpenAIResponseMessageInput.OpenAIResponseInputMessageContentText | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentImage | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentFile> | Array<OpenAIResponseMessageInput.OpenAIResponseOutputMessageContentOutputText | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal>;
-        role: 'system' | 'developer' | 'user' | 'assistant';
-        id?: string | null;
-        status?: string | null;
-        type?: 'message';
-    }
-    namespace OpenAIResponseMessageInput {
-        /**
-         * 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>;
-            type?: 'output_text';
-        }
-        namespace OpenAIResponseOutputMessageContentOutputText {
-            /**
-             * File citation annotation for referencing specific files in response content.
-             */
-            interface OpenAIResponseAnnotationFileCitation {
-                file_id: string;
-                filename: string;
-                index: number;
-                type?: 'file_citation';
-            }
-            /**
-             * URL citation annotation for referencing external web resources.
-             */
-            interface OpenAIResponseAnnotationCitation {
-                end_index: number;
-                start_index: number;
-                title: string;
-                url: string;
-                type?: 'url_citation';
-            }
-            interface OpenAIResponseAnnotationContainerFileCitation {
-                container_id: string;
-                end_index: number;
-                file_id: string;
-                filename: string;
-                start_index: number;
-                type?: 'container_file_citation';
-            }
-            interface OpenAIResponseAnnotationFilePath {
-                file_id: string;
-                index: number;
-                type?: 'file_path';
-            }
-        }
-        /**
-         * Refusal content within a streamed response part.
-         */
-        interface OpenAIResponseContentPartRefusal {
-            refusal: string;
-            type?: 'refusal';
-        }
+    interface ResponseGuardrailSpec {
+        type: string;
     }
     /**
      * OpenAI compatible Prompt object that is used in OpenAI responses.
@@ -2299,6 +2943,14 @@ export declare namespace ResponseCreateParams {
             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.
      */
@@ -2322,6 +2974,50 @@ export declare namespace ResponseCreateParams {
             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.
      */
@@ -2340,6 +3036,22 @@ export declare namespace ResponseCreateParams {
         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';
@@ -2347,10 +3059,45 @@ export declare namespace ResponseCreateParams {
     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;
         }
     }
     /**
@@ -2370,12 +3117,12 @@ export declare namespace ResponseCreateParams {
      */
     interface OpenAIResponseInputToolMcp {
         server_label: string;
-        server_url: 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;
@@ -2383,6 +3130,7 @@ export declare namespace ResponseCreateParams {
          * Filter configuration for MCP tool approval requirements.
          */
         require_approval?: 'always' | 'never' | OpenAIResponseInputToolMcp.ApprovalFilter;
+        server_url?: string | null;
         type?: 'mcp';
     }
     namespace OpenAIResponseInputToolMcp {
@@ -2404,12 +3152,21 @@ export declare namespace ResponseCreateParams {
     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.