openai 0.20.0 → 0.21.1

data/rbi/openai/models/responses/response_content.rbi

@@ -13,6 +13,7 @@ module OpenAI
               OpenAI::Responses::ResponseInputText,
               OpenAI::Responses::ResponseInputImage,
               OpenAI::Responses::ResponseInputFile,
+              OpenAI::Responses::ResponseInputAudio,
               OpenAI::Responses::ResponseOutputText,
               OpenAI::Responses::ResponseOutputRefusal
             )

data/rbi/openai/models/responses/response_create_params.rbi

@@ -304,7 +304,7 @@ module OpenAI
         # An array of tools the model may call while generating a response. You can
         # specify which tool to use by setting the `tool_choice` parameter.
         #
-        # The two categories of tools you can provide the model are:
+        # We support the following categories of tools:
         #
         # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
         #   capabilities, like
@@ -312,6 +312,9 @@ module OpenAI
         #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
         #   Learn more about
         #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+        # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+        #   predefined connectors such as Google Drive and SharePoint. Learn more about
+        #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
         # - **Function calls (custom tools)**: Functions that are defined by you, enabling
         #   the model to call your own code with strongly typed arguments and outputs.
         #   Learn more about
@@ -330,8 +333,8 @@ module OpenAI
                   OpenAI::Responses::Tool::ImageGeneration,
                   OpenAI::Responses::Tool::LocalShell,
                   OpenAI::Responses::CustomTool,
-                  OpenAI::Responses::Tool::WebSearchTool,
-                  OpenAI::Responses::WebSearchTool
+                  OpenAI::Responses::WebSearchTool,
+                  OpenAI::Responses::WebSearchPreviewTool
                 )
               ]
             )
@@ -352,8 +355,8 @@ module OpenAI
                   OpenAI::Responses::Tool::ImageGeneration::OrHash,
                   OpenAI::Responses::Tool::LocalShell::OrHash,
                   OpenAI::Responses::CustomTool::OrHash,
-                  OpenAI::Responses::Tool::WebSearchTool::OrHash,
-                  OpenAI::Responses::WebSearchTool::OrHash
+                  OpenAI::Responses::WebSearchTool::OrHash,
+                  OpenAI::Responses::WebSearchPreviewTool::OrHash
                 )
               ]
           ).void
@@ -462,8 +465,8 @@ module OpenAI
                   OpenAI::Responses::Tool::ImageGeneration::OrHash,
                   OpenAI::Responses::Tool::LocalShell::OrHash,
                   OpenAI::Responses::CustomTool::OrHash,
-                  OpenAI::Responses::Tool::WebSearchTool::OrHash,
-                  OpenAI::Responses::WebSearchTool::OrHash
+                  OpenAI::Responses::WebSearchTool::OrHash,
+                  OpenAI::Responses::WebSearchPreviewTool::OrHash
                 )
               ],
             top_logprobs: T.nilable(Integer),
@@ -606,7 +609,7 @@ module OpenAI
           # An array of tools the model may call while generating a response. You can
           # specify which tool to use by setting the `tool_choice` parameter.
           #
-          # The two categories of tools you can provide the model are:
+          # We support the following categories of tools:
           #
           # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
           #   capabilities, like
@@ -614,6 +617,9 @@ module OpenAI
           #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
           #   Learn more about
           #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+          # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+          #   predefined connectors such as Google Drive and SharePoint. Learn more about
+          #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
           # - **Function calls (custom tools)**: Functions that are defined by you, enabling
           #   the model to call your own code with strongly typed arguments and outputs.
           #   Learn more about
@@ -707,8 +713,8 @@ module OpenAI
                     OpenAI::Responses::Tool::ImageGeneration,
                     OpenAI::Responses::Tool::LocalShell,
                     OpenAI::Responses::CustomTool,
-                    OpenAI::Responses::Tool::WebSearchTool,
-                    OpenAI::Responses::WebSearchTool
+                    OpenAI::Responses::WebSearchTool,
+                    OpenAI::Responses::WebSearchPreviewTool
                   )
                 ],
               top_logprobs: T.nilable(Integer),

data/rbi/openai/models/responses/response_input_audio.rbi

@@ -12,13 +12,16 @@ module OpenAI
             )
           end
 
-        # Base64-encoded audio data.
-        sig { returns(String) }
-        attr_accessor :data
+        sig { returns(OpenAI::Responses::ResponseInputAudio::InputAudio) }
+        attr_reader :input_audio
 
-        # The format of the audio data. Currently supported formats are `mp3` and `wav`.
-        sig { returns(OpenAI::Responses::ResponseInputAudio::Format::OrSymbol) }
-        attr_accessor :format_
+        sig do
+          params(
+            input_audio:
+              OpenAI::Responses::ResponseInputAudio::InputAudio::OrHash
+          ).void
+        end
+        attr_writer :input_audio
 
         # The type of the input item. Always `input_audio`.
         sig { returns(Symbol) }
@@ -27,16 +30,13 @@ module OpenAI
         # An audio input to the model.
         sig do
           params(
-            data: String,
-            format_: OpenAI::Responses::ResponseInputAudio::Format::OrSymbol,
+            input_audio:
+              OpenAI::Responses::ResponseInputAudio::InputAudio::OrHash,
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
-          # Base64-encoded audio data.
-          data:,
-          # The format of the audio data. Currently supported formats are `mp3` and `wav`.
-          format_:,
+          input_audio:,
           # The type of the input item. Always `input_audio`.
           type: :input_audio
         )
@@ -45,8 +45,7 @@ module OpenAI
         sig do
           override.returns(
             {
-              data: String,
-              format_: OpenAI::Responses::ResponseInputAudio::Format::OrSymbol,
+              input_audio: OpenAI::Responses::ResponseInputAudio::InputAudio,
               type: Symbol
             }
           )
@@ -54,35 +53,87 @@ module OpenAI
         def to_hash
         end
 
-        # The format of the audio data. Currently supported formats are `mp3` and `wav`.
-        module Format
-          extend OpenAI::Internal::Type::Enum
-
-          TaggedSymbol =
+        class InputAudio < OpenAI::Internal::Type::BaseModel
+          OrHash =
             T.type_alias do
-              T.all(Symbol, OpenAI::Responses::ResponseInputAudio::Format)
+              T.any(
+                OpenAI::Responses::ResponseInputAudio::InputAudio,
+                OpenAI::Internal::AnyHash
+              )
             end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          MP3 =
-            T.let(
-              :mp3,
-              OpenAI::Responses::ResponseInputAudio::Format::TaggedSymbol
-            )
-          WAV =
-            T.let(
-              :wav,
-              OpenAI::Responses::ResponseInputAudio::Format::TaggedSymbol
+          # Base64-encoded audio data.
+          sig { returns(String) }
+          attr_accessor :data
+
+          # The format of the audio data. Currently supported formats are `mp3` and `wav`.
+          sig do
+            returns(
+              OpenAI::Responses::ResponseInputAudio::InputAudio::Format::OrSymbol
             )
+          end
+          attr_accessor :format_
+
+          sig do
+            params(
+              data: String,
+              format_:
+                OpenAI::Responses::ResponseInputAudio::InputAudio::Format::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Base64-encoded audio data.
+            data:,
+            # The format of the audio data. Currently supported formats are `mp3` and `wav`.
+            format_:
+          )
+          end
 
           sig do
             override.returns(
-              T::Array[
-                OpenAI::Responses::ResponseInputAudio::Format::TaggedSymbol
-              ]
+              {
+                data: String,
+                format_:
+                  OpenAI::Responses::ResponseInputAudio::InputAudio::Format::OrSymbol
+              }
             )
           end
-          def self.values
+          def to_hash
+          end
+
+          # The format of the audio data. Currently supported formats are `mp3` and `wav`.
+          module Format
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseInputAudio::InputAudio::Format
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            MP3 =
+              T.let(
+                :mp3,
+                OpenAI::Responses::ResponseInputAudio::InputAudio::Format::TaggedSymbol
+              )
+            WAV =
+              T.let(
+                :wav,
+                OpenAI::Responses::ResponseInputAudio::InputAudio::Format::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseInputAudio::InputAudio::Format::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
           end
         end
       end

data/rbi/openai/models/responses/response_input_content.rbi

@@ -12,7 +12,8 @@ module OpenAI
             T.any(
               OpenAI::Responses::ResponseInputText,
               OpenAI::Responses::ResponseInputImage,
-              OpenAI::Responses::ResponseInputFile
+              OpenAI::Responses::ResponseInputFile,
+              OpenAI::Responses::ResponseInputAudio
             )
           end
 

data/rbi/openai/models/responses/response_input_item.rbi

@@ -55,7 +55,8 @@ module OpenAI
                 T.any(
                   OpenAI::Responses::ResponseInputText,
                   OpenAI::Responses::ResponseInputImage,
-                  OpenAI::Responses::ResponseInputFile
+                  OpenAI::Responses::ResponseInputFile,
+                  OpenAI::Responses::ResponseInputAudio
                 )
               ]
             )
@@ -117,7 +118,8 @@ module OpenAI
                   T.any(
                     OpenAI::Responses::ResponseInputText::OrHash,
                     OpenAI::Responses::ResponseInputImage::OrHash,
-                    OpenAI::Responses::ResponseInputFile::OrHash
+                    OpenAI::Responses::ResponseInputFile::OrHash,
+                    OpenAI::Responses::ResponseInputAudio::OrHash
                   )
                 ],
               role:
@@ -150,7 +152,8 @@ module OpenAI
                     T.any(
                       OpenAI::Responses::ResponseInputText,
                       OpenAI::Responses::ResponseInputImage,
-                      OpenAI::Responses::ResponseInputFile
+                      OpenAI::Responses::ResponseInputFile,
+                      OpenAI::Responses::ResponseInputAudio
                     )
                   ],
                 role:

data/rbi/openai/models/responses/response_input_message_item.rbi

@@ -75,7 +75,8 @@ module OpenAI
                 T.any(
                   OpenAI::Responses::ResponseInputText::OrHash,
                   OpenAI::Responses::ResponseInputImage::OrHash,
-                  OpenAI::Responses::ResponseInputFile::OrHash
+                  OpenAI::Responses::ResponseInputFile::OrHash,
+                  OpenAI::Responses::ResponseInputAudio::OrHash
                 )
               ],
             role: OpenAI::Responses::ResponseInputMessageItem::Role::OrSymbol,

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

@@ -18,357 +18,11 @@ module OpenAI
               OpenAI::Responses::Tool::ImageGeneration,
               OpenAI::Responses::Tool::LocalShell,
               OpenAI::Responses::CustomTool,
-              OpenAI::Responses::Tool::WebSearchTool,
-              OpenAI::Responses::WebSearchTool
+              OpenAI::Responses::WebSearchTool,
+              OpenAI::Responses::WebSearchPreviewTool
             )
           end
 
-        class WebSearchTool < OpenAI::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                OpenAI::Responses::Tool::WebSearchTool,
-                OpenAI::Internal::AnyHash
-              )
-            end
-
-          # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
-          sig do
-            returns(OpenAI::Responses::Tool::WebSearchTool::Type::OrSymbol)
-          end
-          attr_accessor :type
-
-          # Filters for the search.
-          sig do
-            returns(T.nilable(OpenAI::Responses::Tool::WebSearchTool::Filters))
-          end
-          attr_reader :filters
-
-          sig do
-            params(
-              filters:
-                T.nilable(
-                  OpenAI::Responses::Tool::WebSearchTool::Filters::OrHash
-                )
-            ).void
-          end
-          attr_writer :filters
-
-          # 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
-            returns(
-              T.nilable(
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::OrSymbol
-              )
-            )
-          end
-          attr_reader :search_context_size
-
-          sig do
-            params(
-              search_context_size:
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::OrSymbol
-            ).void
-          end
-          attr_writer :search_context_size
-
-          # The approximate location of the user.
-          sig do
-            returns(
-              T.nilable(OpenAI::Responses::Tool::WebSearchTool::UserLocation)
-            )
-          end
-          attr_reader :user_location
-
-          sig do
-            params(
-              user_location:
-                T.nilable(
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::OrHash
-                )
-            ).void
-          end
-          attr_writer :user_location
-
-          # Search the Internet for sources related to the prompt. Learn more about the
-          # [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
-          sig do
-            params(
-              type: OpenAI::Responses::Tool::WebSearchTool::Type::OrSymbol,
-              filters:
-                T.nilable(
-                  OpenAI::Responses::Tool::WebSearchTool::Filters::OrHash
-                ),
-              search_context_size:
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::OrSymbol,
-              user_location:
-                T.nilable(
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::OrHash
-                )
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
-            type:,
-            # Filters for the search.
-            filters: 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,
-            # The approximate location of the user.
-            user_location: nil
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                type: OpenAI::Responses::Tool::WebSearchTool::Type::OrSymbol,
-                filters:
-                  T.nilable(OpenAI::Responses::Tool::WebSearchTool::Filters),
-                search_context_size:
-                  OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::OrSymbol,
-                user_location:
-                  T.nilable(
-                    OpenAI::Responses::Tool::WebSearchTool::UserLocation
-                  )
-              }
-            )
-          end
-          def to_hash
-          end
-
-          # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
-          module Type
-            extend OpenAI::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(Symbol, OpenAI::Responses::Tool::WebSearchTool::Type)
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            WEB_SEARCH =
-              T.let(
-                :web_search,
-                OpenAI::Responses::Tool::WebSearchTool::Type::TaggedSymbol
-              )
-            WEB_SEARCH_2025_08_26 =
-              T.let(
-                :web_search_2025_08_26,
-                OpenAI::Responses::Tool::WebSearchTool::Type::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  OpenAI::Responses::Tool::WebSearchTool::Type::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
-          end
-
-          class Filters < OpenAI::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  OpenAI::Responses::Tool::WebSearchTool::Filters,
-                  OpenAI::Internal::AnyHash
-                )
-              end
-
-            # Allowed domains for the search. If not provided, all domains are allowed.
-            # Subdomains of the provided domains are allowed as well.
-            #
-            # Example: `["pubmed.ncbi.nlm.nih.gov"]`
-            sig { returns(T.nilable(T::Array[String])) }
-            attr_accessor :allowed_domains
-
-            # Filters for the search.
-            sig do
-              params(allowed_domains: T.nilable(T::Array[String])).returns(
-                T.attached_class
-              )
-            end
-            def self.new(
-              # Allowed domains for the search. If not provided, all domains are allowed.
-              # Subdomains of the provided domains are allowed as well.
-              #
-              # Example: `["pubmed.ncbi.nlm.nih.gov"]`
-              allowed_domains: nil
-            )
-            end
-
-            sig do
-              override.returns({ allowed_domains: T.nilable(T::Array[String]) })
-            end
-            def to_hash
-            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
-            extend OpenAI::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  OpenAI::Responses::Tool::WebSearchTool::SearchContextSize
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            LOW =
-              T.let(
-                :low,
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::TaggedSymbol
-              )
-            MEDIUM =
-              T.let(
-                :medium,
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::TaggedSymbol
-              )
-            HIGH =
-              T.let(
-                :high,
-                OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  OpenAI::Responses::Tool::WebSearchTool::SearchContextSize::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
-          end
-
-          class UserLocation < OpenAI::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation,
-                  OpenAI::Internal::AnyHash
-                )
-              end
-
-            # Free text input for the city of the user, e.g. `San Francisco`.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :city
-
-            # The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
-            # the user, e.g. `US`.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :country
-
-            # Free text input for the region of the user, e.g. `California`.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :region
-
-            # The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
-            # user, e.g. `America/Los_Angeles`.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :timezone
-
-            # The type of location approximation. Always `approximate`.
-            sig do
-              returns(
-                T.nilable(
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::OrSymbol
-                )
-              )
-            end
-            attr_reader :type
-
-            sig do
-              params(
-                type:
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::OrSymbol
-              ).void
-            end
-            attr_writer :type
-
-            # The approximate location of the user.
-            sig do
-              params(
-                city: T.nilable(String),
-                country: T.nilable(String),
-                region: T.nilable(String),
-                timezone: T.nilable(String),
-                type:
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::OrSymbol
-              ).returns(T.attached_class)
-            end
-            def self.new(
-              # Free text input for the city of the user, e.g. `San Francisco`.
-              city: nil,
-              # The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
-              # the user, e.g. `US`.
-              country: nil,
-              # Free text input for the region of the user, e.g. `California`.
-              region: nil,
-              # The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
-              # user, e.g. `America/Los_Angeles`.
-              timezone: nil,
-              # The type of location approximation. Always `approximate`.
-              type: nil
-            )
-            end
-
-            sig do
-              override.returns(
-                {
-                  city: T.nilable(String),
-                  country: T.nilable(String),
-                  region: T.nilable(String),
-                  timezone: T.nilable(String),
-                  type:
-                    OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::OrSymbol
-                }
-              )
-            end
-            def to_hash
-            end
-
-            # The type of location approximation. Always `approximate`.
-            module Type
-              extend OpenAI::Internal::Type::Enum
-
-              TaggedSymbol =
-                T.type_alias do
-                  T.all(
-                    Symbol,
-                    OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type
-                  )
-                end
-              OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-              APPROXIMATE =
-                T.let(
-                  :approximate,
-                  OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::TaggedSymbol
-                )
-
-              sig do
-                override.returns(
-                  T::Array[
-                    OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type::TaggedSymbol
-                  ]
-                )
-              end
-              def self.values
-              end
-            end
-          end
-        end
-
         class Mcp < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do