openai 0.114.0 → 0.115.1

data/sig/openai/models/beta/beta_response.rbs

@@ -37,6 +37,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -280,6 +281,36 @@ module OpenAI
           OpenAI::Beta::BetaResponseTextConfig
         ) -> OpenAI::Beta::BetaResponseTextConfig
 
+        # 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.
+        attr_reader tool_usage: OpenAI::Beta::BetaResponse::ToolUsage?
+
+        # 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.
+        def tool_usage=: (
+          OpenAI::Beta::BetaResponse::ToolUsage
+        ) -> OpenAI::Beta::BetaResponse::ToolUsage
+
         # 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.
@@ -493,6 +524,19 @@ module OpenAI
         #
         #   - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
         #   - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
+        # @param tool_usage
+        #   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.
         # @param top_logprobs
         #   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
@@ -548,6 +592,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -588,6 +633,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -1572,6 +1618,183 @@ module OpenAI
           def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponse::service_tier]
         end
 
+        type tool_usage =
+          {
+            image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          }
+
+        class ToolUsage < OpenAI::Internal::Type::BaseModel
+          # Aggregated usage statistics for image generation tool calls.
+          attr_accessor image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen
+
+          # Aggregated billable usage statistics for web search tool calls.
+          attr_accessor web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+
+          # @param image_gen
+          #   Aggregated usage statistics for image generation tool calls.
+          # @param web_search
+          #   Aggregated billable usage statistics for web search tool calls.
+          def initialize: (
+            image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          ) -> void
+
+          def to_hash: -> {
+            image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          }
+
+          type image_gen =
+            {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            }
+
+          class ImageGen < OpenAI::Internal::Type::BaseModel
+            # The number of tokens (images and text) in the input prompt.
+            attr_accessor input_tokens: Integer
+
+            # The input tokens detailed information for the image generation.
+            attr_accessor input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails
+
+            # The number of output tokens generated by the model.
+            attr_accessor output_tokens: Integer
+
+            # The total number of tokens (images and text) used for the image generation.
+            attr_accessor total_tokens: Integer
+
+            attr_reader cached_tokens: Integer?
+
+            def cached_tokens=: (Integer) -> Integer
+
+            attr_reader cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails?
+
+            def cached_tokens_details=: (
+              OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails
+            ) -> OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails
+
+            # The output token details for the image generation.
+            attr_reader output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails?
+
+            # The output token details for the image generation.
+            def output_tokens_details=: (
+              OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+
+            # @param input_tokens
+            #   The number of tokens (images and text) in the input prompt.
+            # @param input_tokens_details
+            #   The input tokens detailed information for the image generation.
+            # @param output_tokens
+            #   The number of output tokens generated by the model.
+            # @param total_tokens
+            #   The total number of tokens (images and text) used for the image generation.
+            # @param output_tokens_details
+            #   The output token details for the image generation.
+            def initialize: (
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> void
+
+            def to_hash: -> {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            }
+
+            type input_tokens_details =
+              { image_tokens: Integer, text_tokens: Integer }
+
+            class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # The number of image tokens in the input prompt.
+              attr_accessor image_tokens: Integer
+
+              # The number of text tokens in the input prompt.
+              attr_accessor text_tokens: Integer
+
+              # @param image_tokens
+              #   The number of image tokens in the input prompt.
+              # @param text_tokens
+              #   The number of text tokens in the input prompt.
+              def initialize: (
+                image_tokens: Integer,
+                text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> { image_tokens: Integer, text_tokens: Integer }
+            end
+
+            type cached_tokens_details =
+              { cached_image_tokens: Integer, cached_text_tokens: Integer }
+
+            class CachedTokensDetails < OpenAI::Internal::Type::BaseModel
+              attr_accessor cached_image_tokens: Integer
+
+              attr_accessor cached_text_tokens: Integer
+
+              def initialize: (
+                cached_image_tokens: Integer,
+                cached_text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> {
+                cached_image_tokens: Integer,
+                cached_text_tokens: Integer
+              }
+            end
+
+            type output_tokens_details =
+              { image_tokens: Integer, text_tokens: Integer }
+
+            class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # The number of image output tokens generated by the model.
+              attr_accessor image_tokens: Integer
+
+              # The number of text output tokens generated by the model.
+              attr_accessor text_tokens: Integer
+
+              # @param image_tokens
+              #   The number of image output tokens generated by the model.
+              # @param text_tokens
+              #   The number of text output tokens generated by the model.
+              def initialize: (
+                image_tokens: Integer,
+                text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> { image_tokens: Integer, text_tokens: Integer }
+            end
+          end
+
+          type web_search = { num_requests: Integer }
+
+          class WebSearch < OpenAI::Internal::Type::BaseModel
+            # The number of billable web search requests issued.
+            attr_accessor num_requests: Integer
+
+            # @param num_requests
+            #   The number of billable web search requests issued.
+            def initialize: (num_requests: Integer) -> void
+
+            def to_hash: -> { num_requests: Integer }
+          end
+        end
+
         type truncation = :auto | :disabled
 
         module Truncation

data/sig/openai/models/beta/beta_response_configuration_update_item.rbs

@@ -8,7 +8,8 @@ module OpenAI
           id: String,
           ?type: :configuration_update,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
         }
 
       class BetaResponseConfigurationUpdateItem < OpenAI::Internal::Type::BaseModel
@@ -34,18 +35,29 @@ module OpenAI
           OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
         ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
+        ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param agent
         #   The agent that produced this item.
         # @param reasoning
         #   The reasoning configuration applied by this update.
+        # @param text
+        #   The text output configuration for subsequent responses.
         # @param type
         #   The item type. Always `configuration_update`.
         def initialize: (
           id: String,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
           ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text,
           ?type: :configuration_update
         ) -> void
 
@@ -53,7 +65,8 @@ module OpenAI
           id: String,
           ?type: :configuration_update,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
         }
 
         type agent = { agent_name: String }
@@ -107,6 +120,49 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Reasoning::effort]
           end
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+          }
+
+        class Text < OpenAI::Internal::Type::BaseModel
+          # Use a JSON schema for structured output or text to return to plain text.
+          attr_accessor format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+          }
+
+          type format_ =
+            OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text
+            | OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            type text = { ?type: :text }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # The type of response format being defined. Always `text`.
+              attr_accessor type: :text
+
+              # @param type
+              #   The type of response format being defined. Always `text`.
+              def initialize: (?type: :text) -> void
+
+              def to_hash: -> { ?type: :text }
+            end
+
+            def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/beta/beta_response_configuration_update_item_param.rbs

@@ -8,7 +8,8 @@ module OpenAI
           ?type: :configuration_update,
           ?id: String?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
         }
 
       class BetaResponseConfigurationUpdateItemParam < OpenAI::Internal::Type::BaseModel
@@ -29,18 +30,29 @@ module OpenAI
           OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
         ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
+        ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param agent
         #   The agent that produced this item.
         # @param reasoning
         #   Updates to reasoning configuration. Only effort is supported.
+        # @param text
+        #   The text output configuration for subsequent responses.
         # @param type
         #   The item type. Always `configuration_update`.
         def initialize: (
           ?id: String?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
           ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text,
           ?type: :configuration_update
         ) -> void
 
@@ -48,7 +60,8 @@ module OpenAI
           ?type: :configuration_update,
           ?id: String?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
         }
 
         type agent = { agent_name: String }
@@ -102,6 +115,49 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning::effort]
           end
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+          }
+
+        class Text < OpenAI::Internal::Type::BaseModel
+          # Use a JSON schema for structured output or text to return to plain text.
+          attr_accessor format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+          }
+
+          type format_ =
+            OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text
+            | OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            type text = { ?type: :text }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # The type of response format being defined. Always `text`.
+              attr_accessor type: :text
+
+              # @param type
+              #   The type of response format being defined. Always `text`.
+              def initialize: (?type: :text) -> void
+
+              def to_hash: -> { ?type: :text }
+            end
+
+            def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/beta/beta_response_tool_search_output_item_param.rbs

@@ -720,8 +720,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.
             attr_accessor input_fidelity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::input_fidelity?
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -843,8 +843,8 @@ module OpenAI
             # @param input_fidelity
             #   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.
             # @param input_image_mask
             #   Optional mask for inpainting. Contains `image_url` (string, optional) and
             #   `file_id` (string, optional).

data/sig/openai/models/beta/beta_responses_client_event.rbs

@@ -18,6 +18,7 @@ module OpenAI
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
+            ?generate: bool,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,
@@ -75,6 +76,16 @@ module OpenAI
           # response completes.
           attr_accessor conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?
 
+          # Whether to generate output for this response. Defaults to true when omitted. Set
+          # to false to prepare request state without model output; the response ID can be
+          # used as previous_response_id on a later turn.
+          attr_reader generate: bool?
+
+          # Whether to generate output for this response. Defaults to true when omitted. Set
+          # to false to prepare request state without model output; the response ID can be
+          # used as previous_response_id on a later turn.
+          def generate=: (bool) -> bool
+
           # Specify additional output data to include in the model response. Currently
           # supported values are:
           #
@@ -426,6 +437,10 @@ module OpenAI
           #   prepended to `input_items` for this response request. Input items and output
           #   items from this response are automatically added to this conversation after this
           #   response completes.
+          # @param generate
+          #   Whether to generate output for this response. Defaults to true when omitted. Set
+          #   to false to prepare request state without model output; the response ID can be
+          #   used as previous_response_id on a later turn.
           # @param include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -653,6 +668,7 @@ module OpenAI
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
+            ?generate: bool,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,
@@ -692,6 +708,7 @@ module OpenAI
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
+            ?generate: bool,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,

data/sig/openai/models/beta/beta_tool.rbs

@@ -645,8 +645,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.
           attr_accessor input_fidelity: OpenAI::Models::Beta::BetaTool::ImageGeneration::input_fidelity?
 
           # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -768,8 +768,8 @@ module OpenAI
           # @param input_fidelity
           #   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.
           # @param input_image_mask
           #   Optional mask for inpainting. Contains `image_url` (string, optional) and
           #   `file_id` (string, optional).

data/sig/openai/models/beta/response_create_params.rbs

@@ -298,7 +298,9 @@ module OpenAI
         # can call.
         def tool_choice=: (
           OpenAI::Models::Beta::ResponseCreateParams::tool_choice
-        ) -> OpenAI::Models::Beta::ResponseCreateParams::tool_choice
+          | { type: :programmatic_tool_calling }
+        ) -> (OpenAI::Models::Beta::ResponseCreateParams::tool_choice
+        | { type: :programmatic_tool_calling })
 
         # 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.
@@ -633,7 +635,8 @@ module OpenAI
           ?stream_options: OpenAI::Beta::ResponseCreateParams::StreamOptions?,
           ?temperature: Float?,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
-          ?tool_choice: OpenAI::Models::Beta::ResponseCreateParams::tool_choice,
+          ?tool_choice: OpenAI::Models::Beta::ResponseCreateParams::tool_choice
+          | { type: :programmatic_tool_calling },
           ?tools: ::Array[OpenAI::Models::Beta::beta_tool],
           ?top_logprobs: Integer?,
           ?top_p: Float?,

data/sig/openai/models/beta/responses/input_token_count_params.rbs

@@ -79,7 +79,14 @@ module OpenAI
           attr_accessor text: OpenAI::Beta::Responses::InputTokenCountParams::Text?
 
           # Controls which tool the model should use, if any.
-          attr_accessor tool_choice: OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice?
+          attr_reader tool_choice: OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice?
+
+          # Controls which tool the model should use, if any.
+          def tool_choice=: (
+            (OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice
+            | { type: :programmatic_tool_calling })?
+          ) -> (OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice
+          | { type: :programmatic_tool_calling })?
 
           # 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.
@@ -166,7 +173,8 @@ module OpenAI
             ?previous_response_id: String?,
             ?reasoning: OpenAI::Beta::Responses::InputTokenCountParams::Reasoning?,
             ?text: OpenAI::Beta::Responses::InputTokenCountParams::Text?,
-            ?tool_choice: OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice?,
+            ?tool_choice: (OpenAI::Models::Beta::Responses::InputTokenCountParams::tool_choice
+            | { type: :programmatic_tool_calling })?,
             ?tools: ::Array[OpenAI::Models::Beta::beta_tool]?,
             ?truncation: OpenAI::Models::Beta::Responses::InputTokenCountParams::truncation,
             ?betas: ::Array[OpenAI::Models::Beta::Responses::InputTokenCountParams::beta],

data/sig/openai/models/beta/thread_create_and_run_params.rbs

@@ -441,8 +441,10 @@ module OpenAI
 
               # The tools to add this file to.
               def tools=: (
-                ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
-              ) -> ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
+                ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool
+                | { type: :file_search }]
+              ) -> ::Array[(OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool
+              | { type: :file_search })]
 
               # @param file_id
               #   The ID of the file to attach to the message.
@@ -450,7 +452,8 @@ module OpenAI
               #   The tools to add this file to.
               def initialize: (
                 ?file_id: String,
-                ?tools: ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool]
+                ?tools: ::Array[OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::Message::Attachment::tool
+                | { type: :file_search }]
               ) -> void
 
               def to_hash: -> {
@@ -603,7 +606,9 @@ module OpenAI
                 # strategy.
                 def chunking_strategy=: (
                   OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
-                ) -> OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
+                  | { type: :auto }
+                ) -> (OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
+                | { type: :auto })
 
                 # A list of [file](https://developers.openai.com/api/reference/resources/files)
                 # IDs to add to the vector store. For vector stores created before Nov 2025, there
@@ -641,7 +646,8 @@ module OpenAI
                 #   Keys are strings with a maximum length of 64 characters. Values are strings with
                 #   a maximum length of 512 characters.
                 def initialize: (
-                  ?chunking_strategy: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy,
+                  ?chunking_strategy: OpenAI::Models::Beta::ThreadCreateAndRunParams::Thread::ToolResources::FileSearch::VectorStore::chunking_strategy
+                  | { type: :auto },
                   ?file_ids: ::Array[String],
                   ?metadata: OpenAI::Models::metadata?
                 ) -> void