openai 0.16.0 → 0.17.0

data/rbi/openai/models/beta/assistant_update_params.rbi

@@ -65,12 +65,11 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :name
 
-        # **o-series models only**
-        #
         # Constrains effort on reasoning for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-        # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-        # result in faster responses and fewer tokens used on reasoning in a response.
+        # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+        # effort can result in faster responses and fewer tokens used on reasoning in a
+        # response.
         sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
         attr_accessor :reasoning_effort
 
@@ -232,12 +231,11 @@ module OpenAI
           model: nil,
           # The name of the assistant. The maximum length is 256 characters.
           name: nil,
-          # **o-series models only**
-          #
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-          # result in faster responses and fewer tokens used on reasoning in a response.
+          # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+          # effort can result in faster responses and fewer tokens used on reasoning in a
+          # response.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
           # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -354,6 +352,36 @@ module OpenAI
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          GPT_5 =
+            T.let(
+              :"gpt-5",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
+          GPT_5_MINI =
+            T.let(
+              :"gpt-5-mini",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
+          GPT_5_NANO =
+            T.let(
+              :"gpt-5-nano",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
+          GPT_5_2025_08_07 =
+            T.let(
+              :"gpt-5-2025-08-07",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
+          GPT_5_MINI_2025_08_07 =
+            T.let(
+              :"gpt-5-mini-2025-08-07",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
+          GPT_5_NANO_2025_08_07 =
+            T.let(
+              :"gpt-5-nano-2025-08-07",
+              OpenAI::Beta::AssistantUpdateParams::Model::TaggedSymbol
+            )
           GPT_4_1 =
             T.let(
               :"gpt-4.1",

data/rbi/openai/models/beta/threads/run_create_params.rbi

@@ -111,12 +111,11 @@ module OpenAI
           sig { params(parallel_tool_calls: T::Boolean).void }
           attr_writer :parallel_tool_calls
 
-          # **o-series models only**
-          #
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-          # result in faster responses and fewer tokens used on reasoning in a response.
+          # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+          # effort can result in faster responses and fewer tokens used on reasoning in a
+          # response.
           sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
           attr_accessor :reasoning_effort
 
@@ -330,12 +329,11 @@ module OpenAI
             # [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
             # during tool use.
             parallel_tool_calls: nil,
-            # **o-series models only**
-            #
             # Constrains effort on reasoning for
             # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-            # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-            # result in faster responses and fewer tokens used on reasoning in a response.
+            # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+            # effort can result in faster responses and fewer tokens used on reasoning in a
+            # response.
             reasoning_effort: nil,
             # Specifies the format that the model must output. Compatible with
             # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),

data/rbi/openai/models/chat/chat_completion_allowed_tool_choice.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    ChatCompletionAllowedToolChoice = Chat::ChatCompletionAllowedToolChoice
+
+    module Chat
+      class ChatCompletionAllowedToolChoice < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Chat::ChatCompletionAllowedToolChoice,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Constrains the tools available to the model to a pre-defined set.
+        sig { returns(OpenAI::Chat::ChatCompletionAllowedTools) }
+        attr_reader :allowed_tools
+
+        sig do
+          params(
+            allowed_tools: OpenAI::Chat::ChatCompletionAllowedTools::OrHash
+          ).void
+        end
+        attr_writer :allowed_tools
+
+        # Allowed tool configuration type. Always `allowed_tools`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Constrains the tools available to the model to a pre-defined set.
+        sig do
+          params(
+            allowed_tools: OpenAI::Chat::ChatCompletionAllowedTools::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Constrains the tools available to the model to a pre-defined set.
+          allowed_tools:,
+          # Allowed tool configuration type. Always `allowed_tools`.
+          type: :allowed_tools
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              allowed_tools: OpenAI::Chat::ChatCompletionAllowedTools,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/chat/chat_completion_allowed_tools.rbi

@@ -0,0 +1,118 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Chat
+      class ChatCompletionAllowedTools < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Chat::ChatCompletionAllowedTools,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Constrains the tools available to the model to a pre-defined set.
+        #
+        # `auto` allows the model to pick from among the allowed tools and generate a
+        # message.
+        #
+        # `required` requires the model to call one or more of the allowed tools.
+        sig do
+          returns(OpenAI::Chat::ChatCompletionAllowedTools::Mode::OrSymbol)
+        end
+        attr_accessor :mode
+
+        # A list of tool definitions that the model should be allowed to call.
+        #
+        # For the Chat Completions API, the list of tool definitions might look like:
+        #
+        # ```json
+        # [
+        #   { "type": "function", "function": { "name": "get_weather" } },
+        #   { "type": "function", "function": { "name": "get_time" } }
+        # ]
+        # ```
+        sig { returns(T::Array[T::Hash[Symbol, T.anything]]) }
+        attr_accessor :tools
+
+        # Constrains the tools available to the model to a pre-defined set.
+        sig do
+          params(
+            mode: OpenAI::Chat::ChatCompletionAllowedTools::Mode::OrSymbol,
+            tools: T::Array[T::Hash[Symbol, T.anything]]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Constrains the tools available to the model to a pre-defined set.
+          #
+          # `auto` allows the model to pick from among the allowed tools and generate a
+          # message.
+          #
+          # `required` requires the model to call one or more of the allowed tools.
+          mode:,
+          # A list of tool definitions that the model should be allowed to call.
+          #
+          # For the Chat Completions API, the list of tool definitions might look like:
+          #
+          # ```json
+          # [
+          #   { "type": "function", "function": { "name": "get_weather" } },
+          #   { "type": "function", "function": { "name": "get_time" } }
+          # ]
+          # ```
+          tools:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              mode: OpenAI::Chat::ChatCompletionAllowedTools::Mode::OrSymbol,
+              tools: T::Array[T::Hash[Symbol, T.anything]]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Constrains the tools available to the model to a pre-defined set.
+        #
+        # `auto` allows the model to pick from among the allowed tools and generate a
+        # message.
+        #
+        # `required` requires the model to call one or more of the allowed tools.
+        module Mode
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Chat::ChatCompletionAllowedTools::Mode)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          AUTO =
+            T.let(
+              :auto,
+              OpenAI::Chat::ChatCompletionAllowedTools::Mode::TaggedSymbol
+            )
+          REQUIRED =
+            T.let(
+              :required,
+              OpenAI::Chat::ChatCompletionAllowedTools::Mode::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Chat::ChatCompletionAllowedTools::Mode::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/chat/chat_completion_assistant_message_param.rbi

@@ -85,7 +85,14 @@ module OpenAI
         # The tool calls generated by the model, such as function calls.
         sig do
           returns(
-            T.nilable(T::Array[OpenAI::Chat::ChatCompletionMessageToolCall])
+            T.nilable(
+              T::Array[
+                T.any(
+                  OpenAI::Chat::ChatCompletionMessageFunctionToolCall,
+                  OpenAI::Chat::ChatCompletionMessageCustomToolCall
+                )
+              ]
+            )
           )
         end
         attr_reader :tool_calls
@@ -93,7 +100,12 @@ module OpenAI
         sig do
           params(
             tool_calls:
-              T::Array[OpenAI::Chat::ChatCompletionMessageToolCall::OrHash]
+              T::Array[
+                T.any(
+                  OpenAI::Chat::ChatCompletionMessageFunctionToolCall::OrHash,
+                  OpenAI::Chat::ChatCompletionMessageCustomToolCall::OrHash
+                )
+              ]
           ).void
         end
         attr_writer :tool_calls
@@ -116,7 +128,12 @@ module OpenAI
             name: String,
             refusal: T.nilable(String),
             tool_calls:
-              T::Array[OpenAI::Chat::ChatCompletionMessageToolCall::OrHash],
+              T::Array[
+                T.any(
+                  OpenAI::Chat::ChatCompletionMessageFunctionToolCall::OrHash,
+                  OpenAI::Chat::ChatCompletionMessageCustomToolCall::OrHash
+                )
+              ],
             role: Symbol
           ).returns(T.attached_class)
         end
@@ -160,7 +177,13 @@ module OpenAI
                 ),
               name: String,
               refusal: T.nilable(String),
-              tool_calls: T::Array[OpenAI::Chat::ChatCompletionMessageToolCall]
+              tool_calls:
+                T::Array[
+                  T.any(
+                    OpenAI::Chat::ChatCompletionMessageFunctionToolCall,
+                    OpenAI::Chat::ChatCompletionMessageCustomToolCall
+                  )
+                ]
             }
           )
         end

data/rbi/openai/models/chat/chat_completion_custom_tool.rbi

@@ -0,0 +1,335 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    ChatCompletionCustomTool = Chat::ChatCompletionCustomTool
+
+    module Chat
+      class ChatCompletionCustomTool < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Chat::ChatCompletionCustomTool,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Properties of the custom tool.
+        sig { returns(OpenAI::Chat::ChatCompletionCustomTool::Custom) }
+        attr_reader :custom
+
+        sig do
+          params(
+            custom: OpenAI::Chat::ChatCompletionCustomTool::Custom::OrHash
+          ).void
+        end
+        attr_writer :custom
+
+        # The type of the custom tool. Always `custom`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # A custom tool that processes input using a specified format.
+        sig do
+          params(
+            custom: OpenAI::Chat::ChatCompletionCustomTool::Custom::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Properties of the custom tool.
+          custom:,
+          # The type of the custom tool. Always `custom`.
+          type: :custom
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              custom: OpenAI::Chat::ChatCompletionCustomTool::Custom,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Custom < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Chat::ChatCompletionCustomTool::Custom,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The name of the custom tool, used to identify it in tool calls.
+          sig { returns(String) }
+          attr_accessor :name
+
+          # Optional description of the custom tool, used to provide more context.
+          sig { returns(T.nilable(String)) }
+          attr_reader :description
+
+          sig { params(description: String).void }
+          attr_writer :description
+
+          # The input format for the custom tool. Default is unconstrained text.
+          sig do
+            returns(
+              T.nilable(
+                T.any(
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text,
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar
+                )
+              )
+            )
+          end
+          attr_reader :format_
+
+          sig do
+            params(
+              format_:
+                T.any(
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text::OrHash,
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::OrHash
+                )
+            ).void
+          end
+          attr_writer :format_
+
+          # Properties of the custom tool.
+          sig do
+            params(
+              name: String,
+              description: String,
+              format_:
+                T.any(
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text::OrHash,
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::OrHash
+                )
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The name of the custom tool, used to identify it in tool calls.
+            name:,
+            # Optional description of the custom tool, used to provide more context.
+            description: nil,
+            # The input format for the custom tool. Default is unconstrained text.
+            format_: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                name: String,
+                description: String,
+                format_:
+                  T.any(
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text,
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar
+                  )
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The input format for the custom tool. Default is unconstrained text.
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            Variants =
+              T.type_alias do
+                T.any(
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text,
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar
+                )
+              end
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Text,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+              # Unconstrained text format. Always `text`.
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # Unconstrained free-form text.
+              sig { params(type: Symbol).returns(T.attached_class) }
+              def self.new(
+                # Unconstrained text format. Always `text`.
+                type: :text
+              )
+              end
+
+              sig { override.returns({ type: Symbol }) }
+              def to_hash
+              end
+            end
+
+            class Grammar < OpenAI::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+              # Your chosen grammar.
+              sig do
+                returns(
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar
+                )
+              end
+              attr_reader :grammar
+
+              sig do
+                params(
+                  grammar:
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::OrHash
+                ).void
+              end
+              attr_writer :grammar
+
+              # Grammar format. Always `grammar`.
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # A grammar defined by the user.
+              sig do
+                params(
+                  grammar:
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::OrHash,
+                  type: Symbol
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Your chosen grammar.
+                grammar:,
+                # Grammar format. Always `grammar`.
+                type: :grammar
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    grammar:
+                      OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar,
+                    type: Symbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Grammar < OpenAI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar,
+                      OpenAI::Internal::AnyHash
+                    )
+                  end
+
+                # The grammar definition.
+                sig { returns(String) }
+                attr_accessor :definition
+
+                # The syntax of the grammar definition. One of `lark` or `regex`.
+                sig do
+                  returns(
+                    OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::OrSymbol
+                  )
+                end
+                attr_accessor :syntax
+
+                # Your chosen grammar.
+                sig do
+                  params(
+                    definition: String,
+                    syntax:
+                      OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::OrSymbol
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # The grammar definition.
+                  definition:,
+                  # The syntax of the grammar definition. One of `lark` or `regex`.
+                  syntax:
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      definition: String,
+                      syntax:
+                        OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::OrSymbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # The syntax of the grammar definition. One of `lark` or `regex`.
+                module Syntax
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  LARK =
+                    T.let(
+                      :lark,
+                      OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::TaggedSymbol
+                    )
+                  REGEX =
+                    T.let(
+                      :regex,
+                      OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Grammar::Grammar::Syntax::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+            end
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Chat::ChatCompletionCustomTool::Custom::Format::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
+          end
+        end
+      end
+    end
+  end
+end