openai 0.51.0 → 0.53.0

data/rbi/openai/models/responses/tool.rbi

@@ -13,12 +13,15 @@ module OpenAI
               OpenAI::Responses::FunctionTool,
               OpenAI::Responses::FileSearchTool,
               OpenAI::Responses::ComputerTool,
+              OpenAI::Responses::ComputerUsePreviewTool,
               OpenAI::Responses::Tool::Mcp,
               OpenAI::Responses::Tool::CodeInterpreter,
               OpenAI::Responses::Tool::ImageGeneration,
               OpenAI::Responses::Tool::LocalShell,
               OpenAI::Responses::FunctionShellTool,
               OpenAI::Responses::CustomTool,
+              OpenAI::Responses::NamespaceTool,
+              OpenAI::Responses::ToolSearchTool,
               OpenAI::Responses::ApplyPatchTool,
               OpenAI::Responses::WebSearchTool,
               OpenAI::Responses::WebSearchPreviewTool
@@ -90,6 +93,13 @@ module OpenAI
           end
           attr_writer :connector_id
 
+          # Whether this MCP tool is deferred and discovered via tool search.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :defer_loading
+
+          sig { params(defer_loading: T::Boolean).void }
+          attr_writer :defer_loading
+
           # Optional HTTP headers to send to the MCP server. Use for authentication or other
           # purposes.
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
@@ -138,6 +148,7 @@ module OpenAI
                 ),
               authorization: String,
               connector_id: OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol,
+              defer_loading: T::Boolean,
               headers: T.nilable(T::Hash[Symbol, String]),
               require_approval:
                 T.nilable(
@@ -176,6 +187,8 @@ module OpenAI
             # - Outlook Email: `connector_outlookemail`
             # - SharePoint: `connector_sharepoint`
             connector_id: nil,
+            # Whether this MCP tool is deferred and discovered via tool search.
+            defer_loading: nil,
             # Optional HTTP headers to send to the MCP server. Use for authentication or other
             # purposes.
             headers: nil,
@@ -206,6 +219,7 @@ module OpenAI
                 authorization: String,
                 connector_id:
                   OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol,
+                defer_loading: T::Boolean,
                 headers: T.nilable(T::Hash[Symbol, String]),
                 require_approval:
                   T.nilable(

data/rbi/openai/models/responses/tool_choice_types.rbi

@@ -16,7 +16,9 @@ module OpenAI
         #
         # - `file_search`
         # - `web_search_preview`
+        # - `computer`
         # - `computer_use_preview`
+        # - `computer_use`
         # - `code_interpreter`
         # - `image_generation`
         sig { returns(OpenAI::Responses::ToolChoiceTypes::Type::OrSymbol) }
@@ -37,7 +39,9 @@ module OpenAI
           #
           # - `file_search`
           # - `web_search_preview`
+          # - `computer`
           # - `computer_use_preview`
+          # - `computer_use`
           # - `code_interpreter`
           # - `image_generation`
           type:
@@ -59,7 +63,9 @@ module OpenAI
         #
         # - `file_search`
         # - `web_search_preview`
+        # - `computer`
         # - `computer_use_preview`
+        # - `computer_use`
         # - `code_interpreter`
         # - `image_generation`
         module Type
@@ -81,11 +87,21 @@ module OpenAI
               :web_search_preview,
               OpenAI::Responses::ToolChoiceTypes::Type::TaggedSymbol
             )
+          COMPUTER =
+            T.let(
+              :computer,
+              OpenAI::Responses::ToolChoiceTypes::Type::TaggedSymbol
+            )
           COMPUTER_USE_PREVIEW =
             T.let(
               :computer_use_preview,
               OpenAI::Responses::ToolChoiceTypes::Type::TaggedSymbol
             )
+          COMPUTER_USE =
+            T.let(
+              :computer_use,
+              OpenAI::Responses::ToolChoiceTypes::Type::TaggedSymbol
+            )
           WEB_SEARCH_PREVIEW_2025_03_11 =
             T.let(
               :web_search_preview_2025_03_11,

data/rbi/openai/models/responses/tool_search_tool.rbi

@@ -0,0 +1,107 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Responses
+      class ToolSearchTool < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(OpenAI::Responses::ToolSearchTool, OpenAI::Internal::AnyHash)
+          end
+
+        # The type of the tool. Always `tool_search`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Description shown to the model for a client-executed tool search tool.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :description
+
+        # Whether tool search is executed by the server or by the client.
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::ToolSearchTool::Execution::OrSymbol)
+          )
+        end
+        attr_reader :execution
+
+        sig do
+          params(
+            execution: OpenAI::Responses::ToolSearchTool::Execution::OrSymbol
+          ).void
+        end
+        attr_writer :execution
+
+        # Parameter schema for a client-executed tool search tool.
+        sig { returns(T.nilable(T.anything)) }
+        attr_accessor :parameters
+
+        # Hosted or BYOT tool search configuration for deferred tools.
+        sig do
+          params(
+            description: T.nilable(String),
+            execution: OpenAI::Responses::ToolSearchTool::Execution::OrSymbol,
+            parameters: T.nilable(T.anything),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Description shown to the model for a client-executed tool search tool.
+          description: nil,
+          # Whether tool search is executed by the server or by the client.
+          execution: nil,
+          # Parameter schema for a client-executed tool search tool.
+          parameters: nil,
+          # The type of the tool. Always `tool_search`.
+          type: :tool_search
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              type: Symbol,
+              description: T.nilable(String),
+              execution: OpenAI::Responses::ToolSearchTool::Execution::OrSymbol,
+              parameters: T.nilable(T.anything)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Whether tool search is executed by the server or by the client.
+        module Execution
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ToolSearchTool::Execution)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SERVER =
+            T.let(
+              :server,
+              OpenAI::Responses::ToolSearchTool::Execution::TaggedSymbol
+            )
+          CLIENT =
+            T.let(
+              :client,
+              OpenAI::Responses::ToolSearchTool::Execution::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ToolSearchTool::Execution::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/responses/web_search_preview_tool.rbi

@@ -17,6 +17,27 @@ module OpenAI
         sig { returns(OpenAI::Responses::WebSearchPreviewTool::Type::OrSymbol) }
         attr_accessor :type
 
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                OpenAI::Responses::WebSearchPreviewTool::SearchContentType::OrSymbol
+              ]
+            )
+          )
+        end
+        attr_reader :search_content_types
+
+        sig do
+          params(
+            search_content_types:
+              T::Array[
+                OpenAI::Responses::WebSearchPreviewTool::SearchContentType::OrSymbol
+              ]
+          ).void
+        end
+        attr_writer :search_content_types
+
         # High level guidance for the amount of context window space to use for the
         # search. One of `low`, `medium`, or `high`. `medium` is the default.
         sig do
@@ -60,6 +81,10 @@ module OpenAI
         sig do
           params(
             type: OpenAI::Responses::WebSearchPreviewTool::Type::OrSymbol,
+            search_content_types:
+              T::Array[
+                OpenAI::Responses::WebSearchPreviewTool::SearchContentType::OrSymbol
+              ],
             search_context_size:
               OpenAI::Responses::WebSearchPreviewTool::SearchContextSize::OrSymbol,
             user_location:
@@ -72,6 +97,7 @@ module OpenAI
           # The type of the web search tool. One of `web_search_preview` or
           # `web_search_preview_2025_03_11`.
           type:,
+          search_content_types: nil,
           # High level guidance for the amount of context window space to use for the
           # search. One of `low`, `medium`, or `high`. `medium` is the default.
           search_context_size: nil,
@@ -84,6 +110,10 @@ module OpenAI
           override.returns(
             {
               type: OpenAI::Responses::WebSearchPreviewTool::Type::OrSymbol,
+              search_content_types:
+                T::Array[
+                  OpenAI::Responses::WebSearchPreviewTool::SearchContentType::OrSymbol
+                ],
               search_context_size:
                 OpenAI::Responses::WebSearchPreviewTool::SearchContextSize::OrSymbol,
               user_location:
@@ -127,6 +157,40 @@ module OpenAI
           end
         end
 
+        module SearchContentType
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                OpenAI::Responses::WebSearchPreviewTool::SearchContentType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TEXT =
+            T.let(
+              :text,
+              OpenAI::Responses::WebSearchPreviewTool::SearchContentType::TaggedSymbol
+            )
+          IMAGE =
+            T.let(
+              :image,
+              OpenAI::Responses::WebSearchPreviewTool::SearchContentType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::WebSearchPreviewTool::SearchContentType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # High level guidance for the amount of context window space to use for the
         # search. One of `low`, `medium`, or `high`. `medium` is the default.
         module SearchContextSize

data/rbi/openai/models/skill_delete_params.rbi

@@ -11,15 +11,23 @@ module OpenAI
           T.any(OpenAI::SkillDeleteParams, OpenAI::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :skill_id
+
       sig do
-        params(request_options: OpenAI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          skill_id: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(skill_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: OpenAI::RequestOptions }) }
+      sig do
+        override.returns(
+          { skill_id: String, request_options: OpenAI::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/openai/models/skill_retrieve_params.rbi

@@ -11,15 +11,23 @@ module OpenAI
           T.any(OpenAI::SkillRetrieveParams, OpenAI::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :skill_id
+
       sig do
-        params(request_options: OpenAI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          skill_id: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(skill_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: OpenAI::RequestOptions }) }
+      sig do
+        override.returns(
+          { skill_id: String, request_options: OpenAI::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/openai/models/skill_update_params.rbi

@@ -11,17 +11,22 @@ module OpenAI
           T.any(OpenAI::SkillUpdateParams, OpenAI::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :skill_id
+
       # The skill version number to set as default.
       sig { returns(String) }
       attr_accessor :default_version
 
       sig do
         params(
+          skill_id: String,
           default_version: String,
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        skill_id:,
         # The skill version number to set as default.
         default_version:,
         request_options: {}
@@ -30,7 +35,11 @@ module OpenAI
 
       sig do
         override.returns(
-          { default_version: String, request_options: OpenAI::RequestOptions }
+          {
+            skill_id: String,
+            default_version: String,
+            request_options: OpenAI::RequestOptions
+          }
         )
       end
       def to_hash

data/rbi/openai/models/skills/content_retrieve_params.rbi

@@ -15,15 +15,23 @@ module OpenAI
             )
           end
 
+        sig { returns(String) }
+        attr_accessor :skill_id
+
         sig do
-          params(request_options: OpenAI::RequestOptions::OrHash).returns(
-            T.attached_class
-          )
+          params(
+            skill_id: String,
+            request_options: OpenAI::RequestOptions::OrHash
+          ).returns(T.attached_class)
         end
-        def self.new(request_options: {})
+        def self.new(skill_id:, request_options: {})
         end
 
-        sig { override.returns({ request_options: OpenAI::RequestOptions }) }
+        sig do
+          override.returns(
+            { skill_id: String, request_options: OpenAI::RequestOptions }
+          )
+        end
         def to_hash
         end
       end

data/rbi/openai/models/skills/version_create_params.rbi

@@ -15,6 +15,9 @@ module OpenAI
             )
           end
 
+        sig { returns(String) }
+        attr_accessor :skill_id
+
         # Whether to set this version as the default.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :default
@@ -39,12 +42,14 @@ module OpenAI
 
         sig do
           params(
+            skill_id: String,
             default: T::Boolean,
             files: OpenAI::Skills::VersionCreateParams::Files::Variants,
             request_options: OpenAI::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
+          skill_id:,
           # Whether to set this version as the default.
           default: nil,
           # Skill files to upload (directory upload) or a single zip file.
@@ -56,6 +61,7 @@ module OpenAI
         sig do
           override.returns(
             {
+              skill_id: String,
               default: T::Boolean,
               files: OpenAI::Skills::VersionCreateParams::Files::Variants,
               request_options: OpenAI::RequestOptions

data/rbi/openai/models/skills/version_delete_params.rbi

@@ -18,18 +18,32 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :skill_id
 
+        # The skill version number.
+        sig { returns(String) }
+        attr_accessor :version
+
         sig do
           params(
             skill_id: String,
+            version: String,
             request_options: OpenAI::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
-        def self.new(skill_id:, request_options: {})
+        def self.new(
+          skill_id:,
+          # The skill version number.
+          version:,
+          request_options: {}
+        )
         end
 
         sig do
           override.returns(
-            { skill_id: String, request_options: OpenAI::RequestOptions }
+            {
+              skill_id: String,
+              version: String,
+              request_options: OpenAI::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/openai/models/skills/version_list_params.rbi

@@ -12,6 +12,9 @@ module OpenAI
             T.any(OpenAI::Skills::VersionListParams, OpenAI::Internal::AnyHash)
           end
 
+        sig { returns(String) }
+        attr_accessor :skill_id
+
         # The skill version ID to start after.
         sig { returns(T.nilable(String)) }
         attr_reader :after
@@ -39,6 +42,7 @@ module OpenAI
 
         sig do
           params(
+            skill_id: String,
             after: String,
             limit: Integer,
             order: OpenAI::Skills::VersionListParams::Order::OrSymbol,
@@ -46,6 +50,7 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          skill_id:,
           # The skill version ID to start after.
           after: nil,
           # Number of versions to retrieve.
@@ -59,6 +64,7 @@ module OpenAI
         sig do
           override.returns(
             {
+              skill_id: String,
               after: String,
               limit: Integer,
               order: OpenAI::Skills::VersionListParams::Order::OrSymbol,

data/rbi/openai/models/skills/version_retrieve_params.rbi

@@ -18,18 +18,32 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :skill_id
 
+        # The version number to retrieve.
+        sig { returns(String) }
+        attr_accessor :version
+
         sig do
           params(
             skill_id: String,
+            version: String,
             request_options: OpenAI::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
-        def self.new(skill_id:, request_options: {})
+        def self.new(
+          skill_id:,
+          # The version number to retrieve.
+          version:,
+          request_options: {}
+        )
         end
 
         sig do
           override.returns(
-            { skill_id: String, request_options: OpenAI::RequestOptions }
+            {
+              skill_id: String,
+              version: String,
+              request_options: OpenAI::RequestOptions
+            }
           )
         end
         def to_hash

data/rbi/openai/models/skills/versions/content_retrieve_params.rbi

@@ -19,18 +19,32 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :skill_id
 
+          # The skill version number.
+          sig { returns(String) }
+          attr_accessor :version
+
           sig do
             params(
               skill_id: String,
+              version: String,
               request_options: OpenAI::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
-          def self.new(skill_id:, request_options: {})
+          def self.new(
+            skill_id:,
+            # The skill version number.
+            version:,
+            request_options: {}
+          )
           end
 
           sig do
             override.returns(
-              { skill_id: String, request_options: OpenAI::RequestOptions }
+              {
+                skill_id: String,
+                version: String,
+                request_options: OpenAI::RequestOptions
+              }
             )
           end
           def to_hash

data/rbi/openai/models/upload_cancel_params.rbi

@@ -11,15 +11,23 @@ module OpenAI
           T.any(OpenAI::UploadCancelParams, OpenAI::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :upload_id
+
       sig do
-        params(request_options: OpenAI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          upload_id: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(upload_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: OpenAI::RequestOptions }) }
+      sig do
+        override.returns(
+          { upload_id: String, request_options: OpenAI::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/openai/models/upload_complete_params.rbi

@@ -11,6 +11,9 @@ module OpenAI
           T.any(OpenAI::UploadCompleteParams, OpenAI::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :upload_id
+
       # The ordered list of Part IDs.
       sig { returns(T::Array[String]) }
       attr_accessor :part_ids
@@ -25,12 +28,14 @@ module OpenAI
 
       sig do
         params(
+          upload_id: String,
           part_ids: T::Array[String],
           md5: String,
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        upload_id:,
         # The ordered list of Part IDs.
         part_ids:,
         # The optional md5 checksum for the file contents to verify if the bytes uploaded
@@ -43,6 +48,7 @@ module OpenAI
       sig do
         override.returns(
           {
+            upload_id: String,
             part_ids: T::Array[String],
             md5: String,
             request_options: OpenAI::RequestOptions