openai 0.111.0 → 0.113.0

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

@@ -33,8 +33,11 @@ module OpenAI
         optional :event_id, String, nil?: true
 
         # @!method initialize(content:, delegation_id:, event_id: nil, type: :"session.instructions.append")
-        #   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.
         #
         #   @param content [String]
         #     Instruction text to append, limited to 500 tokens. This is a plain string, not

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

@@ -227,13 +227,32 @@ module OpenAI
             #   @return [Symbol, :responses]
             required :type, const: :responses
 
-            # @!method initialize(responses:, type: :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
+
+            # @!method initialize(responses:, acknowledgement_delay_ms: nil, type: :responses)
             #   Delegate tasks to a Responses model managed by the Live session.
             #
             #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
             #     Backend model, prompt, and tools used when the Live session delegates a task to
             #     Responses.
             #
+            #   @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 type [Symbol, :responses]
             #     The delegation owner. Always `responses` for tasks handled by the Responses API.
           end
@@ -249,8 +268,26 @@ module OpenAI
             #   @return [Symbol, :decisions]
             required :type, const: :decisions
 
-            # @!method initialize(decisions:, type: :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. Updates apply to subsequent
+            #   delegations.
+            #
+            #   @return [Integer, nil]
+            optional :acknowledgement_delay_ms, Integer
+
+            # @!method initialize(decisions:, acknowledgement_delay_ms: nil, type: :decisions)
             #   @param decisions [OpenAI::Models::Live::DecisionsDelegationConfig]
+            #
+            #   @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. Updates apply to subsequent
+            #     delegations.
+            #
             #   @param type [Symbol, :decisions]
           end
 

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

@@ -51,6 +51,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.
@@ -58,10 +69,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.

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

@@ -19,10 +19,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/session_accept_params.rb

@@ -256,13 +256,32 @@ module OpenAI
               #   @return [Symbol, :responses]
               required :type, const: :responses
 
-              # @!method initialize(responses:, type: :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
+
+              # @!method initialize(responses:, acknowledgement_delay_ms: nil, type: :responses)
               #   Delegate tasks to a Responses model managed by the Live session.
               #
               #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
               #     Backend model, prompt, and tools used when the Live session delegates a task to
               #     Responses.
               #
+              #   @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 type [Symbol, :responses]
               #     The delegation owner. Always `responses` for tasks handled by the Responses API.
             end
@@ -278,8 +297,26 @@ module OpenAI
               #   @return [Symbol, :decisions]
               required :type, const: :decisions
 
-              # @!method initialize(decisions:, type: :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. Updates apply to subsequent
+              #   delegations.
+              #
+              #   @return [Integer, nil]
+              optional :acknowledgement_delay_ms, Integer
+
+              # @!method initialize(decisions:, acknowledgement_delay_ms: nil, type: :decisions)
               #   @param decisions [OpenAI::Models::Live::DecisionsDelegationConfig]
+              #
+              #   @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. Updates apply to subsequent
+              #     delegations.
+              #
               #   @param type [Symbol, :decisions]
             end
 

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

@@ -236,13 +236,32 @@ module OpenAI
             #   @return [Symbol, :responses]
             required :type, const: :responses
 
-            # @!method initialize(responses:, type: :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
+
+            # @!method initialize(responses:, acknowledgement_delay_ms: nil, type: :responses)
             #   Delegate tasks to a Responses model managed by the Live session.
             #
             #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
             #     Backend model, prompt, and tools used when the Live session delegates a task to
             #     Responses.
             #
+            #   @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 type [Symbol, :responses]
             #     The delegation owner. Always `responses` for tasks handled by the Responses API.
           end
@@ -258,8 +277,26 @@ module OpenAI
             #   @return [Symbol, :decisions]
             required :type, const: :decisions
 
-            # @!method initialize(decisions:, type: :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. Updates apply to subsequent
+            #   delegations.
+            #
+            #   @return [Integer, nil]
+            optional :acknowledgement_delay_ms, Integer
+
+            # @!method initialize(decisions:, acknowledgement_delay_ms: nil, type: :decisions)
             #   @param decisions [OpenAI::Models::Live::DecisionsDelegationConfig]
+            #
+            #   @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. Updates apply to subsequent
+            #     delegations.
+            #
             #   @param type [Symbol, :decisions]
           end
 

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

@@ -268,13 +268,32 @@ module OpenAI
             #   @return [Symbol, :responses]
             required :type, const: :responses
 
-            # @!method initialize(responses:, type: :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
+
+            # @!method initialize(responses:, acknowledgement_delay_ms: nil, type: :responses)
             #   Delegate tasks to a Responses model managed by the Live session.
             #
             #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
             #     Backend model, prompt, and tools used when the Live session delegates a task to
             #     Responses.
             #
+            #   @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 type [Symbol, :responses]
             #     The delegation owner. Always `responses` for tasks handled by the Responses API.
           end
@@ -290,8 +309,26 @@ module OpenAI
             #   @return [Symbol, :decisions]
             required :type, const: :decisions
 
-            # @!method initialize(decisions:, type: :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. Updates apply to subsequent
+            #   delegations.
+            #
+            #   @return [Integer, nil]
+            optional :acknowledgement_delay_ms, Integer
+
+            # @!method initialize(decisions:, acknowledgement_delay_ms: nil, type: :decisions)
             #   @param decisions [OpenAI::Models::Live::DecisionsDelegationConfig]
+            #
+            #   @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. Updates apply to subsequent
+            #     delegations.
+            #
             #   @param type [Symbol, :decisions]
           end
 

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_compact_params.rb

@@ -171,6 +171,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_LUNA }
@@ -416,6 +418,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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