openai 0.114.0 → 0.115.1

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

@@ -299,6 +299,24 @@ module OpenAI
         sig { params(text: OpenAI::Responses::ResponseTextConfig::OrHash).void }
         attr_writer :text
 
+        # Usage reported by hosted tools, separate from base model `usage`. The field can
+        # be omitted when tool usage is unavailable. When present, tool families with no
+        # recorded usage have zero counts.
+        #
+        # `image_gen` sums available token counts across image generation calls. Calls
+        # with missing or incomplete usage records may be skipped. Output token details
+        # and cached input counts can be omitted. An omitted cache count means cache usage
+        # is unknown.
+        #
+        # `web_search.num_requests` counts billable searches. Discounted searches and
+        # actions such as opening a page are excluded. Use billing records to reconcile
+        # final charges.
+        sig { returns(T.nilable(OpenAI::Responses::Response::ToolUsage)) }
+        attr_reader :tool_usage
+
+        sig { params(tool_usage: OpenAI::Responses::Response::ToolUsage::OrHash).void }
+        attr_writer :tool_usage
+
         # An integer between 0 and 20 specifying the maximum number of most likely tokens
         # to return at each token position, each with an associated log probability. In
         # some cases, the number of returned tokens may be fewer than requested.
@@ -464,6 +482,8 @@ module OpenAI
 
             text: OpenAI::Responses::ResponseTextConfig::OrHash,
 
+            tool_usage: OpenAI::Responses::Response::ToolUsage::OrHash,
+
             top_logprobs: T.nilable(Integer),
 
             truncation: T.nilable(OpenAI::Responses::Response::Truncation::OrSymbol),
@@ -685,6 +705,20 @@ module OpenAI
           # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
           text: nil,
 
+          # Usage reported by hosted tools, separate from base model `usage`. The field can
+          # be omitted when tool usage is unavailable. When present, tool families with no
+          # recorded usage have zero counts.
+          #
+          # `image_gen` sums available token counts across image generation calls. Calls
+          # with missing or incomplete usage records may be skipped. Output token details
+          # and cached input counts can be omitted. An omitted cache count means cache usage
+          # is unknown.
+          #
+          # `web_search.num_requests` counts billable searches. Discounted searches and
+          # actions such as opening a page are excluded. Use billing records to reconcile
+          # final charges.
+          tool_usage: nil,
+
           # An integer between 0 and 20 specifying the maximum number of most likely tokens
           # to return at each token position, each with an associated log probability. In
           # some cases, the number of returned tokens may be fewer than requested.
@@ -751,6 +785,7 @@ module OpenAI
               service_tier: T.nilable(OpenAI::Responses::Response::ServiceTier::TaggedSymbol),
               status: OpenAI::Responses::ResponseStatus::TaggedSymbol,
               text: OpenAI::Responses::ResponseTextConfig,
+              tool_usage: OpenAI::Responses::Response::ToolUsage,
               top_logprobs: T.nilable(Integer),
               truncation: T.nilable(OpenAI::Responses::Response::Truncation::TaggedSymbol),
               usage: OpenAI::Responses::ResponseUsage,
@@ -1904,6 +1939,365 @@ module OpenAI
           end
         end
 
+        class ToolUsage < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Responses::Response::ToolUsage,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Aggregated usage statistics for image generation tool calls.
+          sig { returns(OpenAI::Responses::Response::ToolUsage::ImageGen) }
+          attr_reader :image_gen
+
+          sig { params(image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen::OrHash).void }
+          attr_writer :image_gen
+
+          # Aggregated billable usage statistics for web search tool calls.
+          sig { returns(OpenAI::Responses::Response::ToolUsage::WebSearch) }
+          attr_reader :web_search
+
+          sig { params(web_search: OpenAI::Responses::Response::ToolUsage::WebSearch::OrHash).void }
+          attr_writer :web_search
+
+          # Usage reported by hosted tools, separate from base model `usage`. The field can
+          # be omitted when tool usage is unavailable. When present, tool families with no
+          # recorded usage have zero counts.
+          #
+          # `image_gen` sums available token counts across image generation calls. Calls
+          # with missing or incomplete usage records may be skipped. Output token details
+          # and cached input counts can be omitted. An omitted cache count means cache usage
+          # is unknown.
+          #
+          # `web_search.num_requests` counts billable searches. Discounted searches and
+          # actions such as opening a page are excluded. Use billing records to reconcile
+          # final charges.
+          sig do
+            params(
+
+              image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen::OrHash,
+
+              web_search: OpenAI::Responses::Response::ToolUsage::WebSearch::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Aggregated usage statistics for image generation tool calls.
+            image_gen:,
+
+            # Aggregated billable usage statistics for web search tool calls.
+
+            web_search:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen,
+                web_search: OpenAI::Responses::Response::ToolUsage::WebSearch
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class ImageGen < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Responses::Response::ToolUsage::ImageGen,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The number of tokens (images and text) in the input prompt.
+            sig { returns(Integer) }
+            attr_accessor :input_tokens
+
+            # The input tokens detailed information for the image generation.
+            sig { returns(OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails) }
+            attr_reader :input_tokens_details
+
+            sig {
+              params(input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails::OrHash)
+                .void
+            }
+            attr_writer :input_tokens_details
+
+            # The number of output tokens generated by the model.
+            sig { returns(Integer) }
+            attr_accessor :output_tokens
+
+            # The total number of tokens (images and text) used for the image generation.
+            sig { returns(Integer) }
+            attr_accessor :total_tokens
+
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :cached_tokens
+
+            sig { params(cached_tokens: Integer).void }
+            attr_writer :cached_tokens
+
+            sig { returns(T.nilable(OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails)) }
+            attr_reader :cached_tokens_details
+
+            sig {
+              params(
+                cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails::OrHash
+              )
+                .void
+            }
+            attr_writer :cached_tokens_details
+
+            # The output token details for the image generation.
+            sig { returns(T.nilable(OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails)) }
+            attr_reader :output_tokens_details
+
+            sig {
+              params(
+                output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails::OrHash
+              )
+                .void
+            }
+            attr_writer :output_tokens_details
+
+            # Aggregated usage statistics for image generation tool calls.
+            sig do
+              params(
+
+                input_tokens: Integer,
+
+                input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails::OrHash,
+
+                output_tokens: Integer,
+
+                total_tokens: Integer,
+
+                cached_tokens: Integer,
+
+                cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails::OrHash,
+
+                output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails::OrHash
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The number of tokens (images and text) in the input prompt.
+              input_tokens:,
+
+              # The input tokens detailed information for the image generation.
+              input_tokens_details:,
+
+              # The number of output tokens generated by the model.
+              output_tokens:,
+
+              # The total number of tokens (images and text) used for the image generation.
+              total_tokens:,
+
+              cached_tokens: nil,
+
+              cached_tokens_details: nil,
+
+              # The output token details for the image generation.
+
+              output_tokens_details: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  input_tokens: Integer,
+                  input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails,
+                  output_tokens: Integer,
+                  total_tokens: Integer,
+                  cached_tokens: Integer,
+                  cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails,
+                  output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The number of image tokens in the input prompt.
+              sig { returns(Integer) }
+              attr_accessor :image_tokens
+
+              # The number of text tokens in the input prompt.
+              sig { returns(Integer) }
+              attr_accessor :text_tokens
+
+              # The input tokens detailed information for the image generation.
+              sig do
+                params(
+
+                  image_tokens: Integer,
+
+                  text_tokens: Integer
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The number of image tokens in the input prompt.
+                image_tokens:,
+
+                # The number of text tokens in the input prompt.
+
+                text_tokens:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {image_tokens: Integer, text_tokens: Integer}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            class CachedTokensDetails < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              sig { returns(Integer) }
+              attr_accessor :cached_image_tokens
+
+              sig { returns(Integer) }
+              attr_accessor :cached_text_tokens
+
+              sig do
+                params(
+
+                  cached_image_tokens: Integer,
+
+                  cached_text_tokens: Integer
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                cached_image_tokens:,
+
+                cached_text_tokens:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {cached_image_tokens: Integer, cached_text_tokens: Integer}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The number of image output tokens generated by the model.
+              sig { returns(Integer) }
+              attr_accessor :image_tokens
+
+              # The number of text output tokens generated by the model.
+              sig { returns(Integer) }
+              attr_accessor :text_tokens
+
+              # The output token details for the image generation.
+              sig do
+                params(
+
+                  image_tokens: Integer,
+
+                  text_tokens: Integer
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The number of image output tokens generated by the model.
+                image_tokens:,
+
+                # The number of text output tokens generated by the model.
+
+                text_tokens:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {image_tokens: Integer, text_tokens: Integer}
+                )
+              end
+              def to_hash
+              end
+
+            end
+          end
+
+          class WebSearch < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Responses::Response::ToolUsage::WebSearch,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The number of billable web search requests issued.
+            sig { returns(Integer) }
+            attr_accessor :num_requests
+
+            # Aggregated billable usage statistics for web search tool calls.
+            sig do
+              params(
+
+                num_requests: Integer
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The number of billable web search requests issued.
+
+              num_requests:
+            )
+            end
+
+            sig do
+              override.returns(
+                {num_requests: Integer}
+              )
+            end
+            def to_hash
+            end
+
+          end
+        end
+
         # The truncation strategy to use for the model response.
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,

data/rbi/openai/models/responses/response_configuration_update_item.rbi

@@ -29,8 +29,15 @@ module OpenAI
         sig { params(reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning::OrHash).void }
         attr_writer :reasoning
 
-        # A configuration update that applies to subsequent responses until it is replaced
-        # by another configuration update.
+        # The text output configuration for subsequent responses.
+        sig { returns(T.nilable(OpenAI::Responses::ResponseConfigurationUpdateItem::Text)) }
+        attr_reader :text
+
+        sig { params(text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text::OrHash).void }
+        attr_writer :text
+
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         sig do
           params(
 
@@ -38,6 +45,8 @@ module OpenAI
 
             reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning::OrHash,
 
+            text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text::OrHash,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -50,6 +59,9 @@ module OpenAI
           # The reasoning configuration applied by this update.
           reasoning: nil,
 
+          # The text output configuration for subsequent responses.
+          text: nil,
+
           # The item type. Always `configuration_update`.
 
           type: :configuration_update
@@ -58,7 +70,12 @@ module OpenAI
 
         sig do
           override.returns(
-            {id: String, type: Symbol, reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning}
+            {
+              id: String,
+              type: Symbol,
+              reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning,
+              text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text
+            }
           )
         end
         def to_hash
@@ -104,6 +121,62 @@ module OpenAI
 
         end
 
+        class Text < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Responses::ResponseConfigurationUpdateItem::Text,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          sig { returns(OpenAI::Responses::ResponseConfigurationUpdateItem::Text::Format::Variants) }
+          attr_accessor :format_
+
+          # The text output configuration for subsequent responses.
+          sig do
+            params(
+
+              format_: T.any(
+                OpenAI::ResponseFormatText::OrHash,
+                OpenAI::Responses::ResponseFormatTextJSONSchemaConfig::OrHash
+              )
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Use a JSON schema for structured output or text to return to plain text.
+
+            format_:
+          )
+          end
+
+          sig do
+            override.returns(
+              {format_: OpenAI::Responses::ResponseConfigurationUpdateItem::Text::Format::Variants}
+            )
+          end
+          def to_hash
+          end
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            Variants = T.type_alias {
+              T.any(OpenAI::ResponseFormatText, OpenAI::Responses::ResponseFormatTextJSONSchemaConfig)
+            }
+
+            sig {
+              override.returns(T::Array[OpenAI::Responses::ResponseConfigurationUpdateItem::Text::Format::Variants])
+            }
+            def self.variants
+            end
+
+          end
+        end
+
       end
 
     end

data/rbi/openai/models/responses/response_configuration_update_item_param.rbi

@@ -29,9 +29,15 @@ module OpenAI
         sig { params(reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning::OrHash).void }
         attr_writer :reasoning
 
-        # An update to the conversation's response configuration. The configuration
-        # remains in effect for subsequent responses until it is replaced by another
-        # configuration update.
+        # The text output configuration for subsequent responses.
+        sig { returns(T.nilable(OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text)) }
+        attr_reader :text
+
+        sig { params(text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text::OrHash).void }
+        attr_writer :text
+
+        # An update to the conversation's response configuration. Supply reasoning, text,
+        # or both. Each setting stays in effect until a later update replaces it.
         sig do
           params(
 
@@ -39,6 +45,8 @@ module OpenAI
 
             reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning::OrHash,
 
+            text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text::OrHash,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -51,6 +59,9 @@ module OpenAI
           # Updates to reasoning configuration. Only effort is supported.
           reasoning: nil,
 
+          # The text output configuration for subsequent responses.
+          text: nil,
+
           # The item type. Always `configuration_update`.
 
           type: :configuration_update
@@ -62,7 +73,8 @@ module OpenAI
             {
               type: Symbol,
               id: T.nilable(String),
-              reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning
+              reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning,
+              text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text
             }
           )
         end
@@ -109,6 +121,64 @@ module OpenAI
 
         end
 
+        class Text < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          sig { returns(T.any(OpenAI::ResponseFormatText, OpenAI::Responses::ResponseFormatTextJSONSchemaConfig)) }
+          attr_accessor :format_
+
+          # The text output configuration for subsequent responses.
+          sig do
+            params(
+
+              format_: T.any(
+                OpenAI::ResponseFormatText::OrHash,
+                OpenAI::Responses::ResponseFormatTextJSONSchemaConfig::OrHash
+              )
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Use a JSON schema for structured output or text to return to plain text.
+
+            format_:
+          )
+          end
+
+          sig do
+            override.returns(
+              {format_: T.any(OpenAI::ResponseFormatText, OpenAI::Responses::ResponseFormatTextJSONSchemaConfig)}
+            )
+          end
+          def to_hash
+          end
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            Variants = T.type_alias {
+              T.any(OpenAI::ResponseFormatText, OpenAI::Responses::ResponseFormatTextJSONSchemaConfig)
+            }
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text::Format::Variants]
+              )
+            }
+            def self.variants
+            end
+
+          end
+        end
+
       end
 
     end

data/rbi/openai/models/responses/response_tool_search_output_item_param.rbi

@@ -1296,8 +1296,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             sig {
               returns(
                 T.nilable(
@@ -1517,8 +1517,8 @@ module OpenAI
 
               # Control how much effort the model will exert to match the style and features,
               # especially facial features, of input images. Supports `high` and `low` on
-              # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-              # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+              # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+              # this parameter. Defaults to `low` on supported models.
               input_fidelity: nil,
 
               # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1678,8 +1678,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             module InputFidelity
               extend OpenAI::Internal::Type::Enum