openai 0.51.0 → 0.53.0

data/rbi/openai/models/responses/computer_use_preview_tool.rbi

@@ -0,0 +1,124 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Responses
+      class ComputerUsePreviewTool < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Responses::ComputerUsePreviewTool,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The height of the computer display.
+        sig { returns(Integer) }
+        attr_accessor :display_height
+
+        # The width of the computer display.
+        sig { returns(Integer) }
+        attr_accessor :display_width
+
+        # The type of computer environment to control.
+        sig do
+          returns(
+            OpenAI::Responses::ComputerUsePreviewTool::Environment::OrSymbol
+          )
+        end
+        attr_accessor :environment
+
+        # The type of the computer use tool. Always `computer_use_preview`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # A tool that controls a virtual computer. Learn more about the
+        # [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+        sig do
+          params(
+            display_height: Integer,
+            display_width: Integer,
+            environment:
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::OrSymbol,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The height of the computer display.
+          display_height:,
+          # The width of the computer display.
+          display_width:,
+          # The type of computer environment to control.
+          environment:,
+          # The type of the computer use tool. Always `computer_use_preview`.
+          type: :computer_use_preview
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              display_height: Integer,
+              display_width: Integer,
+              environment:
+                OpenAI::Responses::ComputerUsePreviewTool::Environment::OrSymbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The type of computer environment to control.
+        module Environment
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                OpenAI::Responses::ComputerUsePreviewTool::Environment
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          WINDOWS =
+            T.let(
+              :windows,
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+            )
+          MAC =
+            T.let(
+              :mac,
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+            )
+          LINUX =
+            T.let(
+              :linux,
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+            )
+          UBUNTU =
+            T.let(
+              :ubuntu,
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+            )
+          BROWSER =
+            T.let(
+              :browser,
+              OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ComputerUsePreviewTool::Environment::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/responses/custom_tool.rbi

@@ -17,6 +17,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Whether this tool should be 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 description of the custom tool, used to provide more context.
         sig { returns(T.nilable(String)) }
         attr_reader :description
@@ -53,6 +60,7 @@ module OpenAI
         sig do
           params(
             name: String,
+            defer_loading: T::Boolean,
             description: String,
             format_:
               T.any(
@@ -65,6 +73,8 @@ module OpenAI
         def self.new(
           # The name of the custom tool, used to identify it in tool calls.
           name:,
+          # Whether this tool should be deferred and discovered via tool search.
+          defer_loading: nil,
           # Optional description of the custom tool, used to provide more context.
           description: nil,
           # The input format for the custom tool. Default is unconstrained text.
@@ -79,6 +89,7 @@ module OpenAI
             {
               name: String,
               type: Symbol,
+              defer_loading: T::Boolean,
               description: String,
               format_:
                 T.any(

data/rbi/openai/models/responses/easy_input_message.rbi

@@ -22,12 +22,10 @@ module OpenAI
         sig { returns(OpenAI::Responses::EasyInputMessage::Role::OrSymbol) }
         attr_accessor :role
 
-        # The phase of an assistant message.
-        #
-        # Use `commentary` for an intermediate assistant message and `final_answer` for
-        # the final assistant message. For follow-up requests with models like
-        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-        # Omitting it can degrade performance. Not used for user messages.
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
         sig do
           returns(
             T.nilable(OpenAI::Responses::EasyInputMessage::Phase::OrSymbol)
@@ -69,12 +67,10 @@ module OpenAI
           # The role of the message input. One of `user`, `assistant`, `system`, or
           # `developer`.
           role:,
-          # The phase of an assistant message.
-          #
-          # Use `commentary` for an intermediate assistant message and `final_answer` for
-          # the final assistant message. For follow-up requests with models like
-          # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-          # Omitting it can degrade performance. Not used for user messages.
+          # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+          # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+          # sending follow-up requests, preserve and resend phase on all assistant messages
+          # — dropping it can degrade performance. Not used for user messages.
           phase: nil,
           # The type of the message input. Always `message`.
           type: nil
@@ -158,12 +154,10 @@ module OpenAI
           end
         end
 
-        # The phase of an assistant message.
-        #
-        # Use `commentary` for an intermediate assistant message and `final_answer` for
-        # the final assistant message. For follow-up requests with models like
-        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-        # Omitting it can degrade performance. Not used for user messages.
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
         module Phase
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/responses/function_tool.rbi

@@ -25,6 +25,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Whether this function is deferred and loaded via tool search.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :defer_loading
+
+        sig { params(defer_loading: T::Boolean).void }
+        attr_writer :defer_loading
+
         # A description of the function. Used by the model to determine whether or not to
         # call the function.
         sig { returns(T.nilable(String)) }
@@ -38,6 +45,7 @@ module OpenAI
             name: String,
             parameters: T.nilable(T::Hash[Symbol, T.anything]),
             strict: T.nilable(T::Boolean),
+            defer_loading: T::Boolean,
             description: T.nilable(String),
             type: Symbol
           ).returns(T.attached_class)
@@ -49,6 +57,8 @@ module OpenAI
           parameters:,
           # Whether to enforce strict parameter validation. Default `true`.
           strict:,
+          # Whether this function is deferred and loaded via tool search.
+          defer_loading: nil,
           # A description of the function. Used by the model to determine whether or not to
           # call the function.
           description: nil,
@@ -64,6 +74,7 @@ module OpenAI
               parameters: T.nilable(T::Hash[Symbol, T.anything]),
               strict: T.nilable(T::Boolean),
               type: Symbol,
+              defer_loading: T::Boolean,
               description: T.nilable(String)
             }
           )

data/rbi/openai/models/responses/input_item_list_params.rbi

@@ -15,6 +15,9 @@ module OpenAI
             )
           end
 
+        sig { returns(String) }
+        attr_accessor :response_id
+
         # An item ID to list items after, used in pagination.
         sig { returns(T.nilable(String)) }
         attr_reader :after
@@ -66,6 +69,7 @@ module OpenAI
 
         sig do
           params(
+            response_id: String,
             after: String,
             include: T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
             limit: Integer,
@@ -74,6 +78,7 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          response_id:,
           # An item ID to list items after, used in pagination.
           after: nil,
           # Additional fields to include in the response. See the `include` parameter for
@@ -94,6 +99,7 @@ module OpenAI
         sig do
           override.returns(
             {
+              response_id: String,
               after: String,
               include:
                 T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],

data/rbi/openai/models/responses/input_token_count_params.rbi

@@ -117,12 +117,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
@@ -195,12 +198,15 @@ module OpenAI
                     OpenAI::Responses::FunctionTool::OrHash,
                     OpenAI::Responses::FileSearchTool::OrHash,
                     OpenAI::Responses::ComputerTool::OrHash,
+                    OpenAI::Responses::ComputerUsePreviewTool::OrHash,
                     OpenAI::Responses::Tool::Mcp::OrHash,
                     OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                     OpenAI::Responses::Tool::ImageGeneration::OrHash,
                     OpenAI::Responses::Tool::LocalShell::OrHash,
                     OpenAI::Responses::FunctionShellTool::OrHash,
                     OpenAI::Responses::CustomTool::OrHash,
+                    OpenAI::Responses::NamespaceTool::OrHash,
+                    OpenAI::Responses::ToolSearchTool::OrHash,
                     OpenAI::Responses::ApplyPatchTool::OrHash,
                     OpenAI::Responses::WebSearchTool::OrHash,
                     OpenAI::Responses::WebSearchPreviewTool::OrHash
@@ -299,12 +305,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

data/rbi/openai/models/responses/namespace_tool.rbi

@@ -0,0 +1,163 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Responses
+      class NamespaceTool < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(OpenAI::Responses::NamespaceTool, OpenAI::Internal::AnyHash)
+          end
+
+        # A description of the namespace shown to the model.
+        sig { returns(String) }
+        attr_accessor :description
+
+        # The namespace name used in tool calls (for example, `crm`).
+        sig { returns(String) }
+        attr_accessor :name
+
+        # The function/custom tools available inside this namespace.
+        sig do
+          returns(
+            T::Array[
+              T.any(
+                OpenAI::Responses::NamespaceTool::Tool::Function,
+                OpenAI::Responses::CustomTool
+              )
+            ]
+          )
+        end
+        attr_accessor :tools
+
+        # The type of the tool. Always `namespace`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Groups function/custom tools under a shared namespace.
+        sig do
+          params(
+            description: String,
+            name: String,
+            tools:
+              T::Array[
+                T.any(
+                  OpenAI::Responses::NamespaceTool::Tool::Function::OrHash,
+                  OpenAI::Responses::CustomTool::OrHash
+                )
+              ],
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A description of the namespace shown to the model.
+          description:,
+          # The namespace name used in tool calls (for example, `crm`).
+          name:,
+          # The function/custom tools available inside this namespace.
+          tools:,
+          # The type of the tool. Always `namespace`.
+          type: :namespace
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              description: String,
+              name: String,
+              tools:
+                T::Array[
+                  T.any(
+                    OpenAI::Responses::NamespaceTool::Tool::Function,
+                    OpenAI::Responses::CustomTool
+                  )
+                ],
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # A function or custom tool that belongs to a namespace.
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::NamespaceTool::Tool::Function,
+                OpenAI::Responses::CustomTool
+              )
+            end
+
+          class Function < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Responses::NamespaceTool::Tool::Function,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :name
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :description
+
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :parameters
+
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :strict
+
+            sig do
+              params(
+                name: String,
+                description: T.nilable(String),
+                parameters: T.nilable(T.anything),
+                strict: T.nilable(T::Boolean),
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              name:,
+              description: nil,
+              parameters: nil,
+              strict: nil,
+              type: :function
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  name: String,
+                  type: Symbol,
+                  description: T.nilable(String),
+                  parameters: T.nilable(T.anything),
+                  strict: T.nilable(T::Boolean)
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Responses::NamespaceTool::Tool::Variants]
+            )
+          end
+          def self.variants
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/responses/response.rbi

@@ -340,6 +340,8 @@ module OpenAI
                   OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                   OpenAI::Responses::ResponseComputerToolCall::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Responses::ResponseToolSearchCall::OrHash,
+                  OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                   OpenAI::Responses::ResponseCompactionItem::OrHash,
                   OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
@@ -373,12 +375,15 @@ module OpenAI
                   OpenAI::Responses::FunctionTool::OrHash,
                   OpenAI::Responses::FileSearchTool::OrHash,
                   OpenAI::Responses::ComputerTool::OrHash,
+                  OpenAI::Responses::ComputerUsePreviewTool::OrHash,
                   OpenAI::Responses::Tool::Mcp::OrHash,
                   OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                   OpenAI::Responses::Tool::ImageGeneration::OrHash,
                   OpenAI::Responses::Tool::LocalShell::OrHash,
                   OpenAI::Responses::FunctionShellTool::OrHash,
                   OpenAI::Responses::CustomTool::OrHash,
+                  OpenAI::Responses::NamespaceTool::OrHash,
+                  OpenAI::Responses::ToolSearchTool::OrHash,
                   OpenAI::Responses::ApplyPatchTool::OrHash,
                   OpenAI::Responses::WebSearchTool::OrHash,
                   OpenAI::Responses::WebSearchPreviewTool::OrHash

data/rbi/openai/models/responses/response_cancel_params.rbi

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

data/rbi/openai/models/responses/response_compact_params.rbi

@@ -158,6 +158,16 @@ module OpenAI
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          GPT_5_4 =
+            T.let(
+              :"gpt-5.4",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
+          GPT_5_3_CHAT_LATEST =
+            T.let(
+              :"gpt-5.3-chat-latest",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
           GPT_5_2 =
             T.let(
               :"gpt-5.2",