openai 0.113.0 → 0.115.0

data/sig/openai/models/evals/run_create_params.rbs

@@ -79,7 +79,14 @@ module OpenAI
 
           class CreateEvalResponsesRunDataSource < OpenAI::Internal::Type::BaseModel
             # Determines what populates the `item` namespace in this run's data source.
-            attr_accessor source: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source
+            attr_reader source: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source
+
+            # Determines what populates the `item` namespace in this run's data source.
+            def source=: (
+              OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source
+              | { id: String, type: :file_id }
+            ) -> (OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source
+            | { id: String, type: :file_id })
 
             # The type of run data source. Always `responses`.
             attr_accessor type: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::type_
@@ -96,7 +103,9 @@ module OpenAI
             # namespace.
             def input_messages=: (
               OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::input_messages
-            ) -> OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::input_messages
+              | { item_reference: String, type: :item_reference }
+            ) -> (OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::input_messages
+            | { item_reference: String, type: :item_reference })
 
             # The name of the model to use for generating completions (e.g. "o3-mini").
             attr_reader model: String?
@@ -122,9 +131,11 @@ module OpenAI
             # @param model
             #   The name of the model to use for generating completions (e.g. "o3-mini").
             def initialize: (
-              source: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source,
+              source: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::source
+              | { id: String, type: :file_id },
               type: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::type_,
-              ?input_messages: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::input_messages,
+              ?input_messages: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::input_messages
+              | { item_reference: String, type: :item_reference },
               ?model: String,
               ?sampling_params: OpenAI::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::SamplingParams
             ) -> void
@@ -361,7 +372,15 @@ module OpenAI
               class Template < OpenAI::Internal::Type::BaseModel
                 # A list of chat messages forming the prompt or context. May include variable
                 # references to the `item` namespace, ie {{item.name}}.
-                attr_accessor template: ::Array[OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template]
+                attr_reader template: ::Array[OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template]
+
+                # A list of chat messages forming the prompt or context. May include variable
+                # references to the `item` namespace, ie {{item.name}}.
+                def template=: (
+                  ::Array[OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template
+                  | { content: String, role: String }]
+                ) -> ::Array[(OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template
+                | { content: String, role: String })]
 
                 # The type of input messages. Always `template`.
                 attr_accessor type: :template
@@ -372,7 +391,8 @@ module OpenAI
                 # @param type
                 #   The type of input messages. Always `template`.
                 def initialize: (
-                  template: ::Array[OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template],
+                  template: ::Array[OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::template
+                  | { content: String, role: String }],
                   ?type: :template
                 ) -> void
 
@@ -416,7 +436,25 @@ module OpenAI
                   class EvalItem < OpenAI::Internal::Type::BaseModel
                     # Inputs to the model - can contain template strings. Supports text, output text,
                     # input images, and input audio, either as a single item or an array of items.
-                    attr_accessor content: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content
+                    attr_reader content: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content
+
+                    # Inputs to the model - can contain template strings. Supports text, output text,
+                    # input images, and input audio, either as a single item or an array of items.
+                    def content=: (
+                      OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content
+                      | { text: String, type: :output_text }
+                      | {
+                        image_url: String,
+                        type: :input_image,
+                        ?detail: String
+                      }
+                    ) -> (OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content
+                    | { text: String, type: :output_text }
+                    | {
+                      image_url: String,
+                      type: :input_image,
+                      ?detail: String
+                    })
 
                     # The role of the message input. One of `user`, `assistant`, `system`, or
                     # `developer`.
@@ -439,7 +477,13 @@ module OpenAI
                     # @param type
                     #   The type of the message input. Always `message`.
                     def initialize: (
-                      content: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content,
+                      content: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::content
+                      | { text: String, type: :output_text }
+                      | {
+                        image_url: String,
+                        type: :input_image,
+                        ?detail: String
+                      },
                       role: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::role,
                       ?type: OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::InputMessages::Template::Template::EvalItem::type_
                     ) -> void

data/sig/openai/models/image_edit_params.rbs

@@ -6,6 +6,7 @@ module OpenAI
         prompt: String,
         ?background: OpenAI::Models::ImageEditParams::background?,
         ?input_fidelity: OpenAI::Models::ImageEditParams::input_fidelity?,
+        ?markup: OpenAI::Internal::file_input,
         ?mask: OpenAI::Internal::file_input,
         ?model: OpenAI::Models::ImageEditParams::model?,
         ?n: Integer?,
@@ -26,12 +27,12 @@ module OpenAI
 
       # The image(s) to edit. Must be a supported image file or an array of images.
       #
-      # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-      # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
-      # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-      # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`), each image should
-      # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-      # images.
+      # For the GPT image models (`gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
+      # `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+      # `jpg` file less than 50MB. You can provide up to 16 images.
+      # `chatgpt-image-latest` follows the same input constraints as GPT image models.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -55,10 +56,30 @@ 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::ImageEditParams::input_fidelity?
 
+      # A transparent PNG overlaid on the first image to guide the edit. Must match that
+      # image's dimensions after orientation and contain transparent pixels. Supports
+      # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #
+      # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      # metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      # content type.
+      attr_reader markup: OpenAI::Internal::file_input?
+
+      # A transparent PNG overlaid on the first image to guide the edit. Must match that
+      # image's dimensions after orientation and contain transparent pixels. Supports
+      # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #
+      # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      # metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      # content type.
+      def markup=: (
+        OpenAI::Internal::file_input
+      ) -> OpenAI::Internal::file_input
+
       # An additional image whose fully transparent areas (e.g. where alpha is zero)
       # indicate where `image` should be edited. If there are multiple images provided,
       # the mask will be applied on the first image. Must be a valid PNG file, less than
@@ -156,12 +177,12 @@ module OpenAI
       # @param image
       #   The image(s) to edit. Must be a supported image file or an array of images.
       #
-      #   For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-      #   `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
-      #   `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-      #   `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`), each image should
-      #   be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-      #   images.
+      #   For the GPT image models (`gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      #   `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #   `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
+      #   `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+      #   `jpg` file less than 50MB. You can provide up to 16 images.
+      #   `chatgpt-image-latest` follows the same input constraints as GPT image models.
       #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -182,8 +203,16 @@ 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 markup
+      #   A transparent PNG overlaid on the first image to guide the edit. Must match that
+      #   image's dimensions after orientation and contain transparent pixels. Supports
+      #   GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       # @param mask
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
       #   indicate where `image` should be edited. If there are multiple images provided,
@@ -256,6 +285,7 @@ module OpenAI
         prompt: String,
         ?background: OpenAI::Models::ImageEditParams::background?,
         ?input_fidelity: OpenAI::Models::ImageEditParams::input_fidelity?,
+        ?markup: OpenAI::Internal::file_input,
         ?mask: OpenAI::Internal::file_input,
         ?model: OpenAI::Models::ImageEditParams::model?,
         ?n: Integer?,
@@ -275,6 +305,7 @@ module OpenAI
         prompt: String,
         ?background: OpenAI::Models::ImageEditParams::background?,
         ?input_fidelity: OpenAI::Models::ImageEditParams::input_fidelity?,
+        ?markup: OpenAI::Internal::file_input,
         ?mask: OpenAI::Internal::file_input,
         ?model: OpenAI::Models::ImageEditParams::model?,
         ?n: Integer?,

data/sig/openai/models/live/fork_server_event.rbs

@@ -26,6 +26,7 @@ module OpenAI
         | OpenAI::Live::InfoEvent
         | OpenAI::Live::ForkServerEvent::TransportDtmfReceived
         | OpenAI::Live::ForkServerEvent::TransportDtmfSend
+        | OpenAI::Live::ForkServerEvent::TransportDtmfSent
         | OpenAI::Live::ForkServerEvent::TransportRinging
         | OpenAI::Live::ForkServerEvent::TransportAnswered
         | OpenAI::Live::ForkServerEvent::TransportFailed
@@ -123,6 +124,44 @@ module OpenAI
           }
         end
 
+        type transport_dtmf_sent =
+          {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+
+        class TransportDtmfSent < OpenAI::Internal::Type::BaseModel
+          attr_accessor event: String
+
+          attr_accessor event_id: String
+
+          attr_accessor type: :"transport.dtmf.sent"
+
+          # The event_id of the client command, when supplied.
+          attr_reader client_event_id: String?
+
+          # The event_id of the client command, when supplied.
+          def client_event_id=: (String) -> String
+
+          # @param client_event_id
+          #   The event_id of the client command, when supplied.
+          def initialize: (
+            event: String,
+            event_id: String,
+            ?client_event_id: String,
+            ?type: :"transport.dtmf.sent"
+          ) -> void
+
+          def to_hash: -> {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+        end
+
         type transport_ringing =
           { event_id: String, session_id: String, ?type: :"transport.ringing" }
 

data/sig/openai/models/live/server_event.rbs

@@ -26,6 +26,7 @@ module OpenAI
         | OpenAI::Live::InfoEvent
         | OpenAI::Live::ServerEvent::TransportDtmfReceived
         | OpenAI::Live::ServerEvent::TransportDtmfSend
+        | OpenAI::Live::ServerEvent::TransportDtmfSent
         | OpenAI::Live::ServerEvent::TransportRinging
         | OpenAI::Live::ServerEvent::TransportAnswered
         | OpenAI::Live::ServerEvent::TransportFailed
@@ -123,6 +124,44 @@ module OpenAI
           }
         end
 
+        type transport_dtmf_sent =
+          {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+
+        class TransportDtmfSent < OpenAI::Internal::Type::BaseModel
+          attr_accessor event: String
+
+          attr_accessor event_id: String
+
+          attr_accessor type: :"transport.dtmf.sent"
+
+          # The event_id of the client command, when supplied.
+          attr_reader client_event_id: String?
+
+          # The event_id of the client command, when supplied.
+          def client_event_id=: (String) -> String
+
+          # @param client_event_id
+          #   The event_id of the client command, when supplied.
+          def initialize: (
+            event: String,
+            event_id: String,
+            ?client_event_id: String,
+            ?type: :"transport.dtmf.sent"
+          ) -> void
+
+          def to_hash: -> {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+        end
+
         type transport_ringing =
           { event_id: String, session_id: String, ?type: :"transport.ringing" }
 

data/sig/openai/models/live/session_accept_params.rbs

@@ -67,7 +67,34 @@ module OpenAI
           # Who handles tasks delegated by the Live model. Omitted or null selects your
           # application; use `responses` or `decisions` to delegate to the corresponding
           # API.
-          attr_accessor delegation: OpenAI::Models::Live::SessionAcceptParams::Session::delegation?
+          attr_reader delegation: OpenAI::Models::Live::SessionAcceptParams::Session::delegation?
+
+          # Who handles tasks delegated by the Live model. Omitted or null selects your
+          # application; use `responses` or `decisions` to delegate to the corresponding
+          # API.
+          def delegation=: (
+            (OpenAI::Models::Live::SessionAcceptParams::Session::delegation
+            | {
+              responses: OpenAI::Live::ResponsesDelegationConfig,
+              type: :responses,
+              ?acknowledgement_delay_ms: Integer
+            }
+            | {
+              decisions: OpenAI::Live::DecisionsDelegationConfig,
+              type: :decisions,
+              ?acknowledgement_delay_ms: Integer
+            })?
+          ) -> (OpenAI::Models::Live::SessionAcceptParams::Session::delegation
+          | {
+            responses: OpenAI::Live::ResponsesDelegationConfig,
+            type: :responses,
+            ?acknowledgement_delay_ms: Integer
+          }
+          | {
+            decisions: OpenAI::Live::DecisionsDelegationConfig,
+            type: :decisions,
+            ?acknowledgement_delay_ms: Integer
+          })?
 
           # Ordered text-only history supplied before startup. Supports developer, user, and
           # assistant messages with one text part each; at most 128 messages and a
@@ -147,7 +174,17 @@ module OpenAI
           def initialize: (
             model: OpenAI::Models::Live::SessionAcceptParams::Session::model,
             ?audio: OpenAI::Live::SessionAcceptParams::Session::Audio,
-            ?delegation: OpenAI::Models::Live::SessionAcceptParams::Session::delegation?,
+            ?delegation: (OpenAI::Models::Live::SessionAcceptParams::Session::delegation
+            | {
+              responses: OpenAI::Live::ResponsesDelegationConfig,
+              type: :responses,
+              ?acknowledgement_delay_ms: Integer
+            }
+            | {
+              decisions: OpenAI::Live::DecisionsDelegationConfig,
+              type: :decisions,
+              ?acknowledgement_delay_ms: Integer
+            })?,
             ?input: ::Array[OpenAI::Models::Live::initial_item],
             ?instructions: String?,
             ?store: bool,

data/sig/openai/models/live/sideband_client_event.rbs

@@ -6,6 +6,7 @@ module OpenAI
         | OpenAI::Live::InputAudioMuteEvent
         | OpenAI::Live::InputAudioUnmuteEvent
         | OpenAI::Live::OutputAudioFixturePlayEvent
+        | OpenAI::Live::SidebandClientEvent::TransportDtmfSend
         | OpenAI::Live::InstructionsAppendEvent
         | OpenAI::Live::ThinkingAppendEvent
         | OpenAI::Live::CommentaryAppendEvent
@@ -19,6 +20,37 @@ module OpenAI
       module SidebandClientEvent
         extend OpenAI::Internal::Type::Union
 
+        type transport_dtmf_send =
+          { event: String, ?type: :"transport.dtmf.send", ?event_id: String? }
+
+        class TransportDtmfSend < OpenAI::Internal::Type::BaseModel
+          # The DTMF key to send: one of `0`–`9`, `A`–`D`, `*`, or `#`.
+          attr_accessor event: String
+
+          attr_accessor type: :"transport.dtmf.send"
+
+          # Optional client identifier for correlating this command with a server event's
+          # client_event_id or error.client_event_id.
+          attr_accessor event_id: String?
+
+          # @param event
+          #   The DTMF key to send: one of `0`–`9`, `A`–`D`, `*`, or `#`.
+          # @param event_id
+          #   Optional client identifier for correlating this command with a server event's
+          #   client_event_id or error.client_event_id.
+          def initialize: (
+            event: String,
+            ?event_id: String?,
+            ?type: :"transport.dtmf.send"
+          ) -> void
+
+          def to_hash: -> {
+            event: String,
+            ?type: :"transport.dtmf.send",
+            ?event_id: String?
+          }
+        end
+
         def self?.variants: -> ::Array[OpenAI::Models::Live::sideband_client_event]
       end
     end

data/sig/openai/models/live/sideband_server_event.rbs

@@ -26,6 +26,7 @@ module OpenAI
         | OpenAI::Live::OutputAudioDeltaEvent
         | OpenAI::Live::SidebandServerEvent::TransportDtmfReceived
         | OpenAI::Live::SidebandServerEvent::TransportDtmfSend
+        | OpenAI::Live::SidebandServerEvent::TransportDtmfSent
         | OpenAI::Live::SidebandServerEvent::TransportRinging
         | OpenAI::Live::SidebandServerEvent::TransportAnswered
         | OpenAI::Live::SidebandServerEvent::TransportFailed
@@ -123,6 +124,44 @@ module OpenAI
           }
         end
 
+        type transport_dtmf_sent =
+          {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+
+        class TransportDtmfSent < OpenAI::Internal::Type::BaseModel
+          attr_accessor event: String
+
+          attr_accessor event_id: String
+
+          attr_accessor type: :"transport.dtmf.sent"
+
+          # The event_id of the client command, when supplied.
+          attr_reader client_event_id: String?
+
+          # The event_id of the client command, when supplied.
+          def client_event_id=: (String) -> String
+
+          # @param client_event_id
+          #   The event_id of the client command, when supplied.
+          def initialize: (
+            event: String,
+            event_id: String,
+            ?client_event_id: String,
+            ?type: :"transport.dtmf.sent"
+          ) -> void
+
+          def to_hash: -> {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.sent",
+            ?client_event_id: String
+          }
+        end
+
         type transport_ringing =
           { event_id: String, session_id: String, ?type: :"transport.ringing" }
 

data/sig/openai/models/realtime/conversation_item.rbs

@@ -11,6 +11,7 @@ module OpenAI
         | OpenAI::Realtime::RealtimeMcpListTools
         | OpenAI::Realtime::RealtimeMcpToolCall
         | OpenAI::Realtime::RealtimeMcpApprovalRequest
+        | OpenAI::Realtime::ConversationItemWithReference
 
       module ConversationItem
         extend OpenAI::Internal::Type::Union

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

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