llama-stack-client 0.4.3 → 0.4.5

package/src/resources/responses/responses.ts

@@ -102,6 +102,10 @@ export interface ResponseObject {
 
   status: string;
 
+  store: boolean;
+
+  completed_at?: number | null;
+
   /**
    * Error details for failed OpenAI response requests.
    */
@@ -109,6 +113,8 @@ export interface ResponseObject {
 
   instructions?: string | null;
 
+  max_output_tokens?: number | null;
+
   max_tool_calls?: number | null;
 
   metadata?: { [key: string]: string } | null;
@@ -124,6 +130,15 @@ export interface ResponseObject {
    */
   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;
 
   /**
@@ -298,17 +313,26 @@ export namespace ResponseObject {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -316,15 +340,21 @@ export namespace ResponseObject {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -524,6 +554,15 @@ export namespace ResponseObject {
     }
   }
 
+  /**
+   * Configuration for reasoning effort in OpenAI responses.
+   *
+   * Controls how much reasoning the model performs before generating a response.
+   */
+  export interface Reasoning {
+    effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+  }
+
   /**
    * Text response configuration for OpenAI responses.
    */
@@ -626,6 +665,22 @@ export namespace ResponseObject {
 
     /**
      * 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;
 
@@ -635,11 +690,48 @@ export namespace ResponseObject {
   export 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)
      */
     export 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;
     }
   }
 
@@ -687,19 +779,19 @@ export namespace ResponseObject {
   export 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;
   }
 
   export namespace Usage {
@@ -707,14 +799,14 @@ export namespace ResponseObject {
      * Token details for input tokens in OpenAI response usage.
      */
     export interface InputTokensDetails {
-      cached_tokens?: number | null;
+      cached_tokens: number;
     }
 
     /**
      * Token details for output tokens in OpenAI response usage.
      */
     export interface OutputTokensDetails {
-      reasoning_tokens?: number | null;
+      reasoning_tokens: number;
     }
   }
 }
@@ -949,17 +1041,26 @@ export namespace ResponseObjectStream {
         /**
          * The log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token :top_logprobs: The top log probabilities for the token
          */
         export 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;
         }
 
@@ -967,15 +1068,21 @@ export namespace ResponseObjectStream {
           /**
            * The top log probability for a token from an OpenAI-compatible chat completion
            * response.
-           *
-           * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-           * probability of the token
            */
           export interface TopLogprob {
+            /**
+             * The token.
+             */
             token: string;
 
+            /**
+             * The log probability of the token.
+             */
             logprob: number;
 
+            /**
+             * The bytes for the token.
+             */
             bytes?: Array<number> | null;
           }
         }
@@ -1274,17 +1381,26 @@ export namespace ResponseObjectStream {
         /**
          * The log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token :top_logprobs: The top log probabilities for the token
          */
         export 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;
         }
 
@@ -1292,15 +1408,21 @@ export namespace ResponseObjectStream {
           /**
            * The top log probability for a token from an OpenAI-compatible chat completion
            * response.
-           *
-           * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-           * probability of the token
            */
           export interface TopLogprob {
+            /**
+             * The token.
+             */
             token: string;
 
+            /**
+             * The log probability of the token.
+             */
             logprob: number;
 
+            /**
+             * The bytes for the token.
+             */
             bytes?: Array<number> | null;
           }
         }
@@ -1460,17 +1582,26 @@ export namespace ResponseObjectStream {
     /**
      * The log probability for a token from an OpenAI-compatible chat completion
      * response.
-     *
-     * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-     * probability of the token :top_logprobs: The top log probabilities for the token
      */
     export 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;
     }
 
@@ -1478,15 +1609,21 @@ export namespace ResponseObjectStream {
       /**
        * The top log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token
        */
       export interface TopLogprob {
+        /**
+         * The token.
+         */
         token: string;
 
+        /**
+         * The log probability of the token.
+         */
         logprob: number;
 
+        /**
+         * The bytes for the token.
+         */
         bytes?: Array<number> | null;
       }
     }
@@ -1746,17 +1883,26 @@ export namespace ResponseObjectStream {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -1764,15 +1910,21 @@ export namespace ResponseObjectStream {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -1895,17 +2047,26 @@ export namespace ResponseObjectStream {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -1913,15 +2074,21 @@ export namespace ResponseObjectStream {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -2303,6 +2470,10 @@ export interface ResponseListResponse {
 
   status: string;
 
+  store: boolean;
+
+  completed_at?: number | null;
+
   /**
    * Error details for failed OpenAI response requests.
    */
@@ -2310,6 +2481,8 @@ export interface ResponseListResponse {
 
   instructions?: string | null;
 
+  max_output_tokens?: number | null;
+
   max_tool_calls?: number | null;
 
   metadata?: { [key: string]: string } | null;
@@ -2325,6 +2498,15 @@ export interface ResponseListResponse {
    */
   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;
 
   /**
@@ -2499,17 +2681,26 @@ export namespace ResponseListResponse {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -2517,15 +2708,21 @@ export namespace ResponseListResponse {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -2826,17 +3023,26 @@ export namespace ResponseListResponse {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -2844,15 +3050,21 @@ export namespace ResponseListResponse {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -3002,17 +3214,26 @@ export namespace ResponseListResponse {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -3020,15 +3241,21 @@ export namespace ResponseListResponse {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -3228,6 +3455,15 @@ export namespace ResponseListResponse {
     }
   }
 
+  /**
+   * Configuration for reasoning effort in OpenAI responses.
+   *
+   * Controls how much reasoning the model performs before generating a response.
+   */
+  export interface Reasoning {
+    effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+  }
+
   /**
    * Text response configuration for OpenAI responses.
    */
@@ -3330,6 +3566,22 @@ export namespace ResponseListResponse {
 
     /**
      * 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;
 
@@ -3339,11 +3591,48 @@ export namespace ResponseListResponse {
   export 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)
      */
     export 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;
     }
   }
 
@@ -3391,19 +3680,19 @@ export namespace ResponseListResponse {
   export 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;
   }
 
   export namespace Usage {
@@ -3411,14 +3700,14 @@ export namespace ResponseListResponse {
      * Token details for input tokens in OpenAI response usage.
      */
     export interface InputTokensDetails {
-      cached_tokens?: number | null;
+      cached_tokens: number;
     }
 
     /**
      * Token details for output tokens in OpenAI response usage.
      */
     export interface OutputTokensDetails {
-      reasoning_tokens?: number | null;
+      reasoning_tokens: number;
     }
   }
 }
@@ -3437,6 +3726,9 @@ export interface ResponseDeleteResponse {
 export type ResponseCreateParams = ResponseCreateParamsNonStreaming | ResponseCreateParamsStreaming;
 
 export interface ResponseCreateParamsBase {
+  /**
+   * Input message(s) to create the response.
+   */
   input:
     | string
     | Array<
@@ -3449,13 +3741,26 @@ export interface ResponseCreateParamsBase {
         | ResponseCreateParams.OpenAIResponseMcpApprovalRequest
         | ResponseCreateParams.OpenAIResponseInputFunctionToolCallOutput
         | ResponseCreateParams.OpenAIResponseMcpApprovalResponse
-        | ResponseCreateParams.OpenAIResponseMessageInput
       >;
 
+  /**
+   * 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'
@@ -3466,16 +3771,39 @@ export interface ResponseCreateParamsBase {
     | '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;
 
   /**
@@ -3483,10 +3811,31 @@ export interface ResponseCreateParamsBase {
    */
   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;
 
   /**
@@ -3495,7 +3844,7 @@ export interface ResponseCreateParamsBase {
   text?: ResponseCreateParams.Text | null;
 
   /**
-   * Constrains the tools available to the model to a pre-defined set.
+   * How the model should select which tool to call (if any).
    */
   tool_choice?:
     | 'auto'
@@ -3509,6 +3858,9 @@ export interface ResponseCreateParamsBase {
     | ResponseCreateParams.OpenAIResponseInputToolChoiceCustomTool
     | null;
 
+  /**
+   * List of tools available to the model.
+   */
   tools?: Array<
     | ResponseCreateParams.OpenAIResponseInputToolWebSearch
     | ResponseCreateParams.OpenAIResponseInputToolFileSearch
@@ -3652,17 +4004,26 @@ export namespace ResponseCreateParams {
       /**
        * The log probability for a token from an OpenAI-compatible chat completion
        * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
        */
       export 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;
       }
 
@@ -3670,15 +4031,21 @@ export namespace ResponseCreateParams {
         /**
          * The top log probability for a token from an OpenAI-compatible chat completion
          * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
          */
         export interface TopLogprob {
+          /**
+           * The token.
+           */
           token: string;
 
+          /**
+           * The log probability of the token.
+           */
           logprob: number;
 
+          /**
+           * The bytes for the token.
+           */
           bytes?: Array<number> | null;
         }
       }
@@ -3846,179 +4213,10 @@ export 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.
+   * Specification for a guardrail to apply during response generation.
    */
-  export 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';
-  }
-
-  export namespace OpenAIResponseMessageInput {
-    /**
-     * Text content for input messages in OpenAI response format.
-     */
-    export interface OpenAIResponseInputMessageContentText {
-      text: string;
-
-      type?: 'input_text';
-    }
-
-    /**
-     * Image content for input messages in OpenAI response format.
-     */
-    export 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.
-     */
-    export interface OpenAIResponseInputMessageContentFile {
-      file_data?: string | null;
-
-      file_id?: string | null;
-
-      file_url?: string | null;
-
-      filename?: string | null;
-
-      type?: 'input_file';
-    }
-
-    export interface OpenAIResponseOutputMessageContentOutputTextInput {
-      text: string;
-
-      annotations?: Array<
-        | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFileCitation
-        | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationCitation
-        | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationContainerFileCitation
-        | OpenAIResponseOutputMessageContentOutputTextInput.OpenAIResponseAnnotationFilePath
-      >;
-
-      logprobs?: Array<OpenAIResponseOutputMessageContentOutputTextInput.Logprob> | null;
-
-      type?: 'output_text';
-    }
-
-    export namespace OpenAIResponseOutputMessageContentOutputTextInput {
-      /**
-       * File citation annotation for referencing specific files in response content.
-       */
-      export interface OpenAIResponseAnnotationFileCitation {
-        file_id: string;
-
-        filename: string;
-
-        index: number;
-
-        type?: 'file_citation';
-      }
-
-      /**
-       * URL citation annotation for referencing external web resources.
-       */
-      export interface OpenAIResponseAnnotationCitation {
-        end_index: number;
-
-        start_index: number;
-
-        title: string;
-
-        url: string;
-
-        type?: 'url_citation';
-      }
-
-      export interface OpenAIResponseAnnotationContainerFileCitation {
-        container_id: string;
-
-        end_index: number;
-
-        file_id: string;
-
-        filename: string;
-
-        start_index: number;
-
-        type?: 'container_file_citation';
-      }
-
-      export interface OpenAIResponseAnnotationFilePath {
-        file_id: string;
-
-        index: number;
-
-        type?: 'file_path';
-      }
-
-      /**
-       * The log probability for a token from an OpenAI-compatible chat completion
-       * response.
-       *
-       * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-       * probability of the token :top_logprobs: The top log probabilities for the token
-       */
-      export interface Logprob {
-        token: string;
-
-        logprob: number;
-
-        bytes?: Array<number> | null;
-
-        top_logprobs?: Array<Logprob.TopLogprob> | null;
-      }
-
-      export namespace Logprob {
-        /**
-         * The top log probability for a token from an OpenAI-compatible chat completion
-         * response.
-         *
-         * :token: The token :bytes: (Optional) The bytes for the token :logprob: The log
-         * probability of the token
-         */
-        export interface TopLogprob {
-          token: string;
-
-          logprob: number;
-
-          bytes?: Array<number> | null;
-        }
-      }
-    }
-
-    /**
-     * Refusal content within a streamed response part.
-     */
-    export interface OpenAIResponseContentPartRefusal {
-      refusal: string;
-
-      type?: 'refusal';
-    }
+  export interface ResponseGuardrailSpec {
+    type: string;
   }
 
   /**
@@ -4076,6 +4274,15 @@ export namespace ResponseCreateParams {
     }
   }
 
+  /**
+   * Configuration for reasoning effort in OpenAI responses.
+   *
+   * Controls how much reasoning the model performs before generating a response.
+   */
+  export interface Reasoning {
+    effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
+  }
+
   /**
    * Text response configuration for OpenAI responses.
    */
@@ -4178,6 +4385,22 @@ export namespace ResponseCreateParams {
 
     /**
      * 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;
 
@@ -4187,11 +4410,48 @@ export namespace ResponseCreateParams {
   export 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)
      */
     export 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;
     }
   }
 
@@ -4216,8 +4476,6 @@ export namespace ResponseCreateParams {
   export interface OpenAIResponseInputToolMcp {
     server_label: string;
 
-    server_url: string;
-
     /**
      * Filter configuration for restricting which MCP tools can be used.
      */
@@ -4225,6 +4483,8 @@ export namespace ResponseCreateParams {
 
     authorization?: string | null;
 
+    connector_id?: string | null;
+
     headers?: { [key: string]: unknown } | null;
 
     /**
@@ -4232,6 +4492,8 @@ export namespace ResponseCreateParams {
      */
     require_approval?: 'always' | 'never' | OpenAIResponseInputToolMcp.ApprovalFilter;
 
+    server_url?: string | null;
+
     type?: 'mcp';
   }
 
@@ -4258,14 +4520,23 @@ export namespace ResponseCreateParams {
 }
 
 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;
 
   /**