openai 0.110.0 → 0.112.0

data/lib/openai/models/live/session_update_config.rb

@@ -57,6 +57,17 @@ module OpenAI
             #   @return [Symbol, :responses]
             required :type, const: :responses
 
+            # @!attribute acknowledgement_delay_ms
+            #   Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+            #   delegation. The model may still speak before this delay. Any commentary or
+            #   thinking appended to the session cancels all pending acknowledgements, including
+            #   those for other delegations. Defaults to 400 for Decisions sessions and 0
+            #   (request immediately) for other sessions. Omission in a session update preserves
+            #   the current value. Updates apply to subsequent delegations.
+            #
+            #   @return [Integer, nil]
+            optional :acknowledgement_delay_ms, Integer
+
             # @!attribute responses
             #   Responses backend settings to update. Omitted settings keep their existing
             #   values.
@@ -64,10 +75,18 @@ module OpenAI
             #   @return [OpenAI::Models::Live::ResponsesDelegationUpdateConfig, nil]
             optional :responses, -> { OpenAI::Live::ResponsesDelegationUpdateConfig }
 
-            # @!method initialize(responses: nil, type: :responses)
+            # @!method initialize(acknowledgement_delay_ms: nil, responses: nil, type: :responses)
             #   Update the Responses backend for an existing Live session without changing
             #   delegation ownership.
             #
+            #   @param acknowledgement_delay_ms [Integer]
+            #     Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+            #     delegation. The model may still speak before this delay. Any commentary or
+            #     thinking appended to the session cancels all pending acknowledgements, including
+            #     those for other delegations. Defaults to 400 for Decisions sessions and 0
+            #     (request immediately) for other sessions. Omission in a session update preserves
+            #     the current value. Updates apply to subsequent delegations.
+            #
             #   @param responses [OpenAI::Models::Live::ResponsesDelegationUpdateConfig]
             #     Responses backend settings to update. Omitted settings keep their existing
             #     values.
@@ -82,13 +101,33 @@ module OpenAI
             #   @return [Symbol, :decisions]
             required :type, const: :decisions
 
+            # @!attribute acknowledgement_delay_ms
+            #   Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+            #   delegation. The model may still speak before this delay. Any commentary or
+            #   thinking appended to the session cancels all pending acknowledgements, including
+            #   those for other delegations. Defaults to 400 for Decisions sessions and 0
+            #   (request immediately) for other sessions. Omission in a session update preserves
+            #   the current value. Updates apply to subsequent delegations.
+            #
+            #   @return [Integer, nil]
+            optional :acknowledgement_delay_ms, Integer
+
             # @!attribute decisions
             #
             #   @return [OpenAI::Models::Live::DecisionsDelegationUpdateConfig, nil]
             optional :decisions, -> { OpenAI::Live::DecisionsDelegationUpdateConfig }
 
-            # @!method initialize(decisions: nil, type: :decisions)
+            # @!method initialize(acknowledgement_delay_ms: nil, decisions: nil, type: :decisions)
+            #   @param acknowledgement_delay_ms [Integer]
+            #     Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+            #     delegation. The model may still speak before this delay. Any commentary or
+            #     thinking appended to the session cancels all pending acknowledgements, including
+            #     those for other delegations. Defaults to 400 for Decisions sessions and 0
+            #     (request immediately) for other sessions. Omission in a session update preserves
+            #     the current value. Updates apply to subsequent delegations.
+            #
             #   @param decisions [OpenAI::Models::Live::DecisionsDelegationUpdateConfig]
+            #
             #   @param type [Symbol, :decisions]
           end
 

data/lib/openai/models/live/sideband_client_event.rb

@@ -16,19 +16,19 @@ module OpenAI
         # Mute audio input to the Live model without closing the session. The server acknowledges with `session.input_audio.muted`.
         variant :"session.input_audio.mute", -> { OpenAI::Live::InputAudioMuteEvent }
 
-        # Resume audio input to a Live model after muting it. The server acknowledges with `session.input_audio.unmuted`.
+        # Resume audio input to a Live model after muting it. The server acknowledges with `session.input_audio.unmuted`. An active audio fixture still pauses inference until playback finishes.
         variant :"session.input_audio.unmute", -> { OpenAI::Live::InputAudioUnmuteEvent }
 
         # Play one complete audio fixture through the session output. Send this event over the primary WebSocket or a server sideband. Audio must be raw mono PCM16 little-endian at 24 kHz, regardless of the session audio format, and at most 30 seconds. The entire payload is validated before model speech is interrupted and input is muted. Only one fixture can be active. fixture.playing acknowledges acceptance and fixture.played reports server mixer drain. These notifications are not exact transport-media boundaries. Input arriving during playback is dropped and not replayed.
         variant :"session.output_audio.fixture.play", -> { OpenAI::Live::OutputAudioFixturePlayEvent }
 
-        # Append instructions to the Live conversation while it is running, optionally associating them with an existing client delegation.
+        # Append developer instructions to the Live conversation while it is running, optionally associating them with an existing client delegation. Rejected while an audio fixture is active. These instructions remain in conversation history through compaction and are included in future backend delegations. For external audio, describe content already delivered so the assistant does not repeat it.
         variant :"session.instructions.append", -> { OpenAI::Live::InstructionsAppendEvent }
 
-        # Provide silent reasoning or progress context to the Live model, optionally for an existing client delegation.
+        # Provide silent reasoning or progress context to the Live model, optionally for an existing client delegation. Rejected while an audio fixture is active.
         variant :"session.thinking.append", -> { OpenAI::Live::ThinkingAppendEvent }
 
-        # Provide context the Live model can communicate to the user, optionally for an existing client delegation.
+        # Provide context the Live model can communicate to the user, optionally for an existing client delegation. Rejected while an audio fixture is active.
         variant :"session.commentary.append", -> { OpenAI::Live::CommentaryAppendEvent }
 
         # Evaluate the configured questions using the current conversation and Decision inputs. Reusing an event_id is rejected for the lifetime of the session.

data/lib/openai/models/live/sideband_server_event.rb

@@ -16,10 +16,10 @@ module OpenAI
         # Returned when a Live session update is accepted. Contains the resolved session configuration after the update.
         variant :"session.updated", -> { OpenAI::Live::SessionUpdatedEvent }
 
-        # Returned when a session.input_audio.mute command is accepted. Input audio is no longer sent to the model; sideband audio reflection continues.
+        # Acknowledges a session.input_audio.mute command. An independent input mute sends silence to the model and preserves sideband audio reflection. Fixture playback does not emit this event.
         variant :"session.input_audio.muted", -> { OpenAI::Live::InputAudioMutedEvent }
 
-        # Returned when a session.input_audio.unmute command is accepted. Input audio is sent to the model again.
+        # Acknowledges a session.input_audio.unmute command, removing the independent input mute. An active audio fixture still pauses inference until playback finishes. Fixture playback does not emit this event.
         variant :"session.input_audio.unmuted", -> { OpenAI::Live::InputAudioUnmutedEvent }
 
         # The existing playback path has accepted the validated audio fixture. This acknowledgment does not identify when the listener receives the first sample. The optional client_event_id echoes the play command.

data/lib/openai/models/live/thinking_append_event.rb

@@ -35,7 +35,7 @@ module OpenAI
 
         # @!method initialize(content:, delegation_id:, event_id: nil, type: :"session.thinking.append")
         #   Provide silent reasoning or progress context to the Live model, optionally for
-        #   an existing client delegation.
+        #   an existing client delegation. Rejected while an audio fixture is active.
         #
         #   @param content [String]
         #     Silent reasoning or progress context, limited to 500 tokens. It does not

data/lib/openai/models/realtime/conversation_item_input_audio_transcription_delta_event.rb

@@ -35,12 +35,11 @@ module OpenAI
         optional :delta, String
 
         # @!attribute logprobs
-        #   The log probabilities of the transcription. These can be enabled by
-        #   configurating the session with
-        #   `"include": ["item.input_audio_transcription.logprobs"]`. Each entry in the
-        #   array corresponds a log probability of which token would be selected for this
-        #   chunk of transcription. This can help to identify if it was possible there were
-        #   multiple valid options for a given chunk of transcription.
+        #   The log probabilities of the transcription. These can be enabled by configuring
+        #   the session with `"include": ["item.input_audio_transcription.logprobs"]`. Each
+        #   entry in the array corresponds a log probability of which token would be
+        #   selected for this chunk of transcription. This can help to identify if it was
+        #   possible there were multiple valid options for a given chunk of transcription.
         #
         #   @return [Array<OpenAI::Models::Realtime::LogProbProperties>, nil]
         optional(
@@ -66,12 +65,11 @@ module OpenAI
         #     The text delta.
         #
         #   @param logprobs [Array<OpenAI::Models::Realtime::LogProbProperties>, nil]
-        #     The log probabilities of the transcription. These can be enabled by
-        #     configurating the session with
-        #     `"include": ["item.input_audio_transcription.logprobs"]`. Each entry in the
-        #     array corresponds a log probability of which token would be selected for this
-        #     chunk of transcription. This can help to identify if it was possible there were
-        #     multiple valid options for a given chunk of transcription.
+        #     The log probabilities of the transcription. These can be enabled by configuring
+        #     the session with `"include": ["item.input_audio_transcription.logprobs"]`. Each
+        #     entry in the array corresponds a log probability of which token would be
+        #     selected for this chunk of transcription. This can help to identify if it was
+        #     possible there were multiple valid options for a given chunk of transcription.
         #
         #   @param type [Symbol, :"conversation.item.input_audio_transcription.delta"]
         #     The event type, must be `conversation.item.input_audio_transcription.delta`.

data/lib/openai/models/realtime/realtime_error_event.rb

@@ -25,7 +25,7 @@ module OpenAI
         # @!method initialize(error:, event_id:, type: :error)
         #   Returned when an error occurs, which could be a client problem or a server
         #   problem. Most errors are recoverable and the session will stay open, we
-        #   recommend to implementors to monitor and log error messages by default.
+        #   recommend to implementers to monitor and log error messages by default.
         #
         #   @param error [OpenAI::Models::Realtime::RealtimeError]
         #     Details of the error.

data/lib/openai/models/realtime/realtime_server_event.rb

@@ -73,7 +73,7 @@ module OpenAI
 
         # Returned when an error occurs, which could be a client problem or a server
         # problem. Most errors are recoverable and the session will stay open, we
-        # recommend to implementors to monitor and log error messages by default.
+        # recommend to implementers to monitor and log error messages by default.
         variant :error, -> { OpenAI::Realtime::RealtimeErrorEvent }
 
         # Returned when the input audio buffer is cleared by the client with a

data/lib/openai/models/realtime/realtime_translation_server_event.rb

@@ -11,7 +11,7 @@ module OpenAI
 
         # Returned when an error occurs, which could be a client problem or a server
         # problem. Most errors are recoverable and the session will stay open, we
-        # recommend to implementors to monitor and log error messages by default.
+        # recommend to implementers to monitor and log error messages by default.
         variant :error, -> { OpenAI::Realtime::RealtimeErrorEvent }
 
         # Returned when a translation session is created. Emitted automatically when a

data/lib/openai/models/responses/response_input_file.rb

@@ -108,13 +108,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputFile::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputFile::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputFile::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_input_file_content.rb

@@ -112,13 +112,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_input_image.rb

@@ -85,13 +85,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_input_image_content.rb

@@ -89,13 +89,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_input_text.rb

@@ -46,13 +46,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_input_text_content.rb

@@ -50,13 +50,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/responses/response_tool_search_output_item_param.rb

@@ -778,11 +778,14 @@ module OpenAI
             )
 
             # @!attribute model
-            #   The image generation model to use. One of `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`, or
-            #   `chatgpt-image-latest`. Default: `gpt-image-1`.
+            #   The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+            #   `gpt-image-2`.
+            #
+            #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            #   `gpt-image-2.5-flare` instead.
             #
             #   @return [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model, nil]
             optional(
@@ -880,11 +883,14 @@ module OpenAI
             #     `file_id` (string, optional).
             #
             #   @param model [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model]
-            #     The image generation model to use. One of `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`, or
-            #     `chatgpt-image-latest`. Default: `gpt-image-1`.
+            #     The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+            #     `gpt-image-2`.
+            #
+            #     `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            #     `gpt-image-2.5-flare` instead.
             #
             #   @param moderation [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Moderation]
             #     Moderation level for the generated image. Default: `auto`.
@@ -998,11 +1004,14 @@ module OpenAI
               #     Base64-encoded mask image.
             end
 
-            # The image generation model to use. One of `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`, or
-            # `chatgpt-image-latest`. Default: `gpt-image-1`.
+            # The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2`.
+            #
+            # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            # `gpt-image-2.5-flare` instead.
             #
             # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#model
             module Model
@@ -1084,6 +1093,8 @@ module OpenAI
 
               # @!group
 
+              # @deprecated GPT Image 1 was shut down on October 23, 2026. Use gpt-image-2.5-sunburst or
+              # gpt-image-2.5-flare instead.
               GPT_IMAGE_1 = :"gpt-image-1"
               GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
               GPT_IMAGE_2 = :"gpt-image-2"

data/lib/openai/models/responses/tool.rb

@@ -656,11 +656,14 @@ module OpenAI
           optional :input_image_mask, -> { OpenAI::Responses::Tool::ImageGeneration::InputImageMask }
 
           # @!attribute model
-          #   The image generation model to use. One of `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`, or
-          #   `chatgpt-image-latest`. Default: `gpt-image-1`.
+          #   The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+          #   `gpt-image-2`.
+          #
+          #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          #   `gpt-image-2.5-flare` instead.
           #
           #   @return [String, Symbol, OpenAI::Models::Responses::Tool::ImageGeneration::Model, nil]
           optional :model, union: -> { OpenAI::Responses::Tool::ImageGeneration::Model }
@@ -743,11 +746,14 @@ module OpenAI
           #     `file_id` (string, optional).
           #
           #   @param model [String, Symbol, OpenAI::Models::Responses::Tool::ImageGeneration::Model]
-          #     The image generation model to use. One of `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`, or
-          #     `chatgpt-image-latest`. Default: `gpt-image-1`.
+          #     The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+          #     `gpt-image-2`.
+          #
+          #     `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          #     `gpt-image-2.5-flare` instead.
           #
           #   @param moderation [Symbol, OpenAI::Models::Responses::Tool::ImageGeneration::Moderation]
           #     Moderation level for the generated image. Default: `auto`.
@@ -861,11 +867,14 @@ module OpenAI
             #     Base64-encoded mask image.
           end
 
-          # The image generation model to use. One of `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`, or
-          # `chatgpt-image-latest`. Default: `gpt-image-1`.
+          # The image generation model to use. One of `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`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2`.
+          #
+          # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          # `gpt-image-2.5-flare` instead.
           #
           # @see OpenAI::Models::Responses::Tool::ImageGeneration#model
           module Model
@@ -906,6 +915,8 @@ module OpenAI
 
             # @!group
 
+            # @deprecated GPT Image 1 was shut down on October 23, 2026. Use gpt-image-2.5-sunburst or
+            # gpt-image-2.5-flare instead.
             GPT_IMAGE_1 = :"gpt-image-1"
             GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
             GPT_IMAGE_2 = :"gpt-image-2"

data/lib/openai/models.rb

@@ -119,6 +119,8 @@ module OpenAI
 
   DecisionInputImage = OpenAI::Models::DecisionInputImage
 
+  DecisionInputJSON = OpenAI::Models::DecisionInputJSON
+
   DecisionInputMessage = OpenAI::Models::DecisionInputMessage
 
   DecisionInputPart = OpenAI::Models::DecisionInputPart
@@ -127,6 +129,12 @@ module OpenAI
 
   DecisionPromptCacheBreakpoint = OpenAI::Models::DecisionPromptCacheBreakpoint
 
+  DecisionQuestionInputImage = OpenAI::Models::DecisionQuestionInputImage
+
+  DecisionQuestionInputPart = OpenAI::Models::DecisionQuestionInputPart
+
+  DecisionQuestionInputText = OpenAI::Models::DecisionQuestionInputText
+
   DeletedSkill = OpenAI::Models::DeletedSkill
 
   Embedding = OpenAI::Models::Embedding

data/lib/openai/resources/beta/agents.rb

@@ -46,7 +46,7 @@ module OpenAI
         #   Configuration for generated text. Defaults to the `text` format and medium
         #   verbosity.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse, OpenAI::Models::Beta::PersistedAgentToolParam::Automations>, nil]
         #   Tools available to the agent. Defaults to an empty list. The tool list must fit
         #   within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #
@@ -128,7 +128,7 @@ module OpenAI
         # @param text [OpenAI::Models::Beta::AgentTextParam, nil]
         #   Configuration for text generated by the agent.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse, OpenAI::Models::Beta::PersistedAgentToolParam::Automations>, nil]
         #   Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
         #   The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #

data/lib/openai/resources/beta/responses.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/websocket/resource"
+require_relative "../../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Beta
       # Create and manage model responses.
       class Responses
-        include OpenAI::WebSocket::Resource
+        include OpenAI::WebSocket::TypedResource
 
         # @api private
         def __websocket_request(query: {})