openai 0.110.0 → 0.112.0

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

@@ -12,196 +12,17 @@ module OpenAI
         # @!attribute questions
         #   Native Decision API questions evaluated together, in order.
         #
-        #   @return [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Predicate, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Score>, nil]
-        optional(
-          :questions,
-          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::DecisionsDelegationUpdateConfig::Question] }
-        )
+        #   @return [Array<OpenAI::Models::Live::DecisionQuestion::Choice, OpenAI::Models::Live::DecisionQuestion::Predicate, OpenAI::Models::Live::DecisionQuestion::Score>, nil]
+        optional :questions, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::DecisionQuestion] }
 
         # @!method initialize(model: nil, questions: nil)
         #   @param model [String]
         #
-        #   @param questions [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Predicate, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Score>]
+        #   @param questions [Array<OpenAI::Models::Live::DecisionQuestion::Choice, OpenAI::Models::Live::DecisionQuestion::Predicate, OpenAI::Models::Live::DecisionQuestion::Score>]
         #     Native Decision API questions evaluated together, in order.
 
-        # A question about the request's input, with an optional correlation name.
-        module Question
-          extend OpenAI::Internal::Type::Union
-
-          discriminator :type
-
-          # Estimate how likely it is that a statement about the input is true.
-          variant :predicate, -> { OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Predicate }
-
-          # Choose from the supplied options based on the input.
-          variant :choice, -> { OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Choice }
-
-          # Rate the input against the supplied ordered levels.
-          variant :score, -> { OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Score }
-
-          class Predicate < OpenAI::Internal::Type::BaseModel
-            # @!attribute instructions
-            #
-            #   @return [String]
-            required :instructions, String
-
-            # @!attribute type
-            #   The type of the object. Always `predicate`.
-            #
-            #   @return [Symbol, :predicate]
-            required :type, const: :predicate
-
-            # @!attribute name
-            #
-            #   @return [String, nil]
-            optional :name, String
-
-            # @!method initialize(instructions:, name: nil, type: :predicate)
-            #   Estimate how likely it is that a statement about the input is true.
-            #
-            #   @param instructions [String]
-            #
-            #   @param name [String]
-            #
-            #   @param type [Symbol, :predicate]
-            #     The type of the object. Always `predicate`.
-          end
-
-          class Choice < OpenAI::Internal::Type::BaseModel
-            # @!attribute choices
-            #   Provide between 2 and 255 choices. Each choice must be unique.
-            #
-            #   @return [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice::Choice>]
-            required(
-              :choices,
-              -> {
-                OpenAI::Internal::Type::ArrayOf[OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Choice::Choice]
-              }
-            )
-
-            # @!attribute instructions
-            #
-            #   @return [String]
-            required :instructions, String
-
-            # @!attribute type
-            #   The type of the object. Always `choice`.
-            #
-            #   @return [Symbol, :choice]
-            required :type, const: :choice
-
-            # @!attribute name
-            #
-            #   @return [String, nil]
-            optional :name, String
-
-            # @!method initialize(choices:, instructions:, name: nil, type: :choice)
-            #   Choose from the supplied options based on the input.
-            #
-            #   @param choices [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice::Choice>]
-            #     Provide between 2 and 255 choices. Each choice must be unique.
-            #
-            #   @param instructions [String]
-            #
-            #   @param name [String]
-            #
-            #   @param type [Symbol, :choice]
-            #     The type of the object. Always `choice`.
-            class Choice < OpenAI::Internal::Type::BaseModel
-              # @!attribute value
-              #   Choice values are typed: a string and a boolean with the same text are distinct.
-              #
-              #   @return [String, Boolean]
-              required(
-                :value,
-                union: -> { OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Choice::Choice::Value }
-              )
-
-              # @!attribute description
-              #
-              #   @return [String, nil]
-              optional :description, String
-
-              # @!method initialize(value:, description: nil)
-              #   @param value [String, Boolean]
-              #     Choice values are typed: a string and a boolean with the same text are distinct.
-              #
-              #   @param description [String]
-
-              # Choice values are typed: a string and a boolean with the same text are distinct.
-              #
-              # @see OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice::Choice#value
-              module Value
-                extend OpenAI::Internal::Type::Union
-
-                variant String
-
-                variant OpenAI::Internal::Type::Boolean
-
-                # @!method self.variants
-                #   @return [Array(String, Boolean)]
-              end
-            end
-          end
-
-          class Score < OpenAI::Internal::Type::BaseModel
-            # @!attribute instructions
-            #
-            #   @return [String]
-            required :instructions, String
-
-            # @!attribute levels
-            #
-            #   @return [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Score::Level>]
-            required(
-              :levels,
-              -> {
-                OpenAI::Internal::Type::ArrayOf[OpenAI::Live::DecisionsDelegationUpdateConfig::Question::Score::Level]
-              }
-            )
-
-            # @!attribute type
-            #   The type of the object. Always `score`.
-            #
-            #   @return [Symbol, :score]
-            required :type, const: :score
-
-            # @!attribute name
-            #
-            #   @return [String, nil]
-            optional :name, String
-
-            # @!method initialize(instructions:, levels:, name: nil, type: :score)
-            #   Rate the input against the supplied ordered levels.
-            #
-            #   @param instructions [String]
-            #
-            #   @param levels [Array<OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Score::Level>]
-            #
-            #   @param name [String]
-            #
-            #   @param type [Symbol, :score]
-            #     The type of the object. Always `score`.
-            class Level < OpenAI::Internal::Type::BaseModel
-              # @!attribute label
-              #
-              #   @return [String]
-              required :label, String
-
-              # @!attribute description
-              #
-              #   @return [String, nil]
-              optional :description, String
-
-              # @!method initialize(label:, description: nil)
-              #   @param label [String]
-              #   @param description [String]
-            end
-          end
-
-          # @!method self.variants
-          #   @return [Array(OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Predicate, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Choice, OpenAI::Models::Live::DecisionsDelegationUpdateConfig::Question::Score)]
-        end
+        require_relative "decision_question"
+        Question = ::OpenAI::Models::Live::DecisionQuestion
       end
     end
   end

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

@@ -24,19 +24,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/fork_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/fork_session_config.rb

@@ -82,6 +82,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.
@@ -89,11 +100,19 @@ 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)
           #   Overrides for the stored session’s Responses backend. Only supported when the
           #   stored session already uses Responses delegation; the delegation type cannot
           #   change.
           #
+          #   @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/input_audio_muted_event.rb

@@ -24,8 +24,9 @@ module OpenAI
         optional :client_event_id, String
 
         # @!method initialize(event_id:, client_event_id: nil, type: :"session.input_audio.muted")
-        #   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.
         #
         #   @param event_id [String]
         #     The unique ID of the Live server event.

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

@@ -19,7 +19,8 @@ module OpenAI
 
         # @!method initialize(event_id: nil, type: :"session.input_audio.unmute")
         #   Resume audio input to a Live model after muting it. The server acknowledges with
-        #   `session.input_audio.unmuted`.
+        #   `session.input_audio.unmuted`. An active audio fixture still pauses inference
+        #   until playback finishes.
         #
         #   @param event_id [String, nil]
         #     Optional client identifier for correlating this command with a server event's

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

@@ -24,8 +24,9 @@ module OpenAI
         optional :client_event_id, String
 
         # @!method initialize(event_id:, client_event_id: nil, type: :"session.input_audio.unmuted")
-        #   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.
         #
         #   @param event_id [String]
         #     The unique ID of the Live server event.

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