openai 0.19.0 → 0.21.0

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

@@ -0,0 +1,300 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      # @see OpenAI::Resources::Realtime::ClientSecrets#create
+      class ClientSecretCreateResponse < OpenAI::Internal::Type::BaseModel
+        # @!attribute expires_at
+        #   Expiration timestamp for the client secret, in seconds since epoch.
+        #
+        #   @return [Integer]
+        required :expires_at, Integer
+
+        # @!attribute session
+        #   The session configuration for either a realtime or transcription session.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeSessionCreateResponse, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse]
+        required :session, union: -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session }
+
+        # @!attribute value
+        #   The generated client secret value.
+        #
+        #   @return [String]
+        required :value, String
+
+        # @!method initialize(expires_at:, session:, value:)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Realtime::ClientSecretCreateResponse} for more details.
+        #
+        #   Response from creating a session and client secret for the Realtime API.
+        #
+        #   @param expires_at [Integer] Expiration timestamp for the client secret, in seconds since epoch.
+        #
+        #   @param session [OpenAI::Models::Realtime::RealtimeSessionCreateResponse, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse] The session configuration for either a realtime or transcription session.
+        #
+        #   @param value [String] The generated client secret value.
+
+        # The session configuration for either a realtime or transcription session.
+        #
+        # @see OpenAI::Models::Realtime::ClientSecretCreateResponse#session
+        module Session
+          extend OpenAI::Internal::Type::Union
+
+          # A Realtime session configuration object.
+          variant -> { OpenAI::Realtime::RealtimeSessionCreateResponse }
+
+          # A Realtime transcription session configuration object.
+          variant -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse }
+
+          class RealtimeTranscriptionSessionCreateResponse < OpenAI::Internal::Type::BaseModel
+            # @!attribute id
+            #   Unique identifier for the session that looks like `sess_1234567890abcdef`.
+            #
+            #   @return [String, nil]
+            optional :id, String
+
+            # @!attribute audio
+            #   Configuration for input audio for the session.
+            #
+            #   @return [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio, nil]
+            optional :audio,
+                     -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio }
+
+            # @!attribute expires_at
+            #   Expiration timestamp for the session, in seconds since epoch.
+            #
+            #   @return [Integer, nil]
+            optional :expires_at, Integer
+
+            # @!attribute include
+            #   Additional fields to include in server outputs.
+            #
+            #   - `item.input_audio_transcription.logprobs`: Include logprobs for input audio
+            #     transcription.
+            #
+            #   @return [Array<Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include>, nil]
+            optional :include,
+                     -> do
+                       OpenAI::Internal::Type::ArrayOf[
+                         enum: OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include
+                       ]
+                     end
+
+            # @!attribute object
+            #   The object type. Always `realtime.transcription_session`.
+            #
+            #   @return [String, nil]
+            optional :object, String
+
+            # @!method initialize(id: nil, audio: nil, expires_at: nil, include: nil, object: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse}
+            #   for more details.
+            #
+            #   A Realtime transcription session configuration object.
+            #
+            #   @param id [String] Unique identifier for the session that looks like `sess_1234567890abcdef`.
+            #
+            #   @param audio [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio] Configuration for input audio for the session.
+            #
+            #   @param expires_at [Integer] Expiration timestamp for the session, in seconds since epoch.
+            #
+            #   @param include [Array<Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include>] Additional fields to include in server outputs.
+            #
+            #   @param object [String] The object type. Always `realtime.transcription_session`.
+
+            # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse#audio
+            class Audio < OpenAI::Internal::Type::BaseModel
+              # @!attribute input
+              #
+              #   @return [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input, nil]
+              optional :input,
+                       -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input }
+
+              # @!method initialize(input: nil)
+              #   Configuration for input audio for the session.
+              #
+              #   @param input [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input]
+
+              # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio#input
+              class Input < OpenAI::Internal::Type::BaseModel
+                # @!attribute format_
+                #   The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
+                #
+                #   @return [String, nil]
+                optional :format_, String, api_name: :format
+
+                # @!attribute noise_reduction
+                #   Configuration for input audio noise reduction.
+                #
+                #   @return [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction, nil]
+                optional :noise_reduction,
+                         -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction }
+
+                # @!attribute transcription
+                #   Configuration of the transcription model.
+                #
+                #   @return [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription, nil]
+                optional :transcription,
+                         -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription }
+
+                # @!attribute turn_detection
+                #   Configuration for turn detection.
+                #
+                #   @return [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection, nil]
+                optional :turn_detection,
+                         -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection }
+
+                # @!method initialize(format_: nil, noise_reduction: nil, transcription: nil, turn_detection: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input}
+                #   for more details.
+                #
+                #   @param format_ [String] The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
+                #
+                #   @param noise_reduction [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction] Configuration for input audio noise reduction.
+                #
+                #   @param transcription [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription] Configuration of the transcription model.
+                #
+                #   @param turn_detection [OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection] Configuration for turn detection.
+
+                # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input#noise_reduction
+                class NoiseReduction < OpenAI::Internal::Type::BaseModel
+                  # @!attribute type
+                  #
+                  #   @return [Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type, nil]
+                  optional :type,
+                           enum: -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type }
+
+                  # @!method initialize(type: nil)
+                  #   Configuration for input audio noise reduction.
+                  #
+                  #   @param type [Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type]
+
+                  # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction#type
+                  module Type
+                    extend OpenAI::Internal::Type::Enum
+
+                    NEAR_FIELD = :near_field
+                    FAR_FIELD = :far_field
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+
+                # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input#transcription
+                class Transcription < OpenAI::Internal::Type::BaseModel
+                  # @!attribute language
+                  #   The language of the input audio. Supplying the input language in
+                  #   [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
+                  #   format will improve accuracy and latency.
+                  #
+                  #   @return [String, nil]
+                  optional :language, String
+
+                  # @!attribute model
+                  #   The model to use for transcription. Can be `gpt-4o-transcribe`,
+                  #   `gpt-4o-mini-transcribe`, or `whisper-1`.
+                  #
+                  #   @return [Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model, nil]
+                  optional :model,
+                           enum: -> { OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model }
+
+                  # @!attribute prompt
+                  #   An optional text to guide the model's style or continue a previous audio
+                  #   segment. The
+                  #   [prompt](https://platform.openai.com/docs/guides/speech-to-text#prompting)
+                  #   should match the audio language.
+                  #
+                  #   @return [String, nil]
+                  optional :prompt, String
+
+                  # @!method initialize(language: nil, model: nil, prompt: nil)
+                  #   Some parameter documentations has been truncated, see
+                  #   {OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription}
+                  #   for more details.
+                  #
+                  #   Configuration of the transcription model.
+                  #
+                  #   @param language [String] The language of the input audio. Supplying the input language in
+                  #
+                  #   @param model [Symbol, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model] The model to use for transcription. Can be `gpt-4o-transcribe`, `gpt-4o-mini-tra
+                  #
+                  #   @param prompt [String] An optional text to guide the model's style or continue a previous audio segment
+
+                  # The model to use for transcription. Can be `gpt-4o-transcribe`,
+                  # `gpt-4o-mini-transcribe`, or `whisper-1`.
+                  #
+                  # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription#model
+                  module Model
+                    extend OpenAI::Internal::Type::Enum
+
+                    GPT_4O_TRANSCRIBE = :"gpt-4o-transcribe"
+                    GPT_4O_MINI_TRANSCRIBE = :"gpt-4o-mini-transcribe"
+                    WHISPER_1 = :"whisper-1"
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+
+                # @see OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input#turn_detection
+                class TurnDetection < OpenAI::Internal::Type::BaseModel
+                  # @!attribute prefix_padding_ms
+                  #
+                  #   @return [Integer, nil]
+                  optional :prefix_padding_ms, Integer
+
+                  # @!attribute silence_duration_ms
+                  #
+                  #   @return [Integer, nil]
+                  optional :silence_duration_ms, Integer
+
+                  # @!attribute threshold
+                  #
+                  #   @return [Float, nil]
+                  optional :threshold, Float
+
+                  # @!attribute type
+                  #   Type of turn detection, only `server_vad` is currently supported.
+                  #
+                  #   @return [String, nil]
+                  optional :type, String
+
+                  # @!method initialize(prefix_padding_ms: nil, silence_duration_ms: nil, threshold: nil, type: nil)
+                  #   Some parameter documentations has been truncated, see
+                  #   {OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection}
+                  #   for more details.
+                  #
+                  #   Configuration for turn detection.
+                  #
+                  #   @param prefix_padding_ms [Integer]
+                  #
+                  #   @param silence_duration_ms [Integer]
+                  #
+                  #   @param threshold [Float]
+                  #
+                  #   @param type [String] Type of turn detection, only `server_vad` is currently supported.
+                end
+              end
+            end
+
+            module Include
+              extend OpenAI::Internal::Type::Enum
+
+              ITEM_INPUT_AUDIO_TRANSCRIPTION_LOGPROBS = :"item.input_audio_transcription.logprobs"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Realtime::RealtimeSessionCreateResponse, OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationCreatedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute conversation
+        #   The conversation resource.
+        #
+        #   @return [OpenAI::Models::Realtime::ConversationCreatedEvent::Conversation]
+        required :conversation, -> { OpenAI::Realtime::ConversationCreatedEvent::Conversation }
+
+        # @!attribute event_id
+        #   The unique ID of the server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute type
+        #   The event type, must be `conversation.created`.
+        #
+        #   @return [Symbol, :"conversation.created"]
+        required :type, const: :"conversation.created"
+
+        # @!method initialize(conversation:, event_id:, type: :"conversation.created")
+        #   Returned when a conversation is created. Emitted right after session creation.
+        #
+        #   @param conversation [OpenAI::Models::Realtime::ConversationCreatedEvent::Conversation] The conversation resource.
+        #
+        #   @param event_id [String] The unique ID of the server event.
+        #
+        #   @param type [Symbol, :"conversation.created"] The event type, must be `conversation.created`.
+
+        # @see OpenAI::Models::Realtime::ConversationCreatedEvent#conversation
+        class Conversation < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the conversation.
+          #
+          #   @return [String, nil]
+          optional :id, String
+
+          # @!attribute object
+          #   The object type, must be `realtime.conversation`.
+          #
+          #   @return [Symbol, OpenAI::Models::Realtime::ConversationCreatedEvent::Conversation::Object, nil]
+          optional :object, enum: -> { OpenAI::Realtime::ConversationCreatedEvent::Conversation::Object }
+
+          # @!method initialize(id: nil, object: nil)
+          #   The conversation resource.
+          #
+          #   @param id [String] The unique ID of the conversation.
+          #
+          #   @param object [Symbol, OpenAI::Models::Realtime::ConversationCreatedEvent::Conversation::Object] The object type, must be `realtime.conversation`.
+
+          # The object type, must be `realtime.conversation`.
+          #
+          # @see OpenAI::Models::Realtime::ConversationCreatedEvent::Conversation#object
+          module Object
+            extend OpenAI::Internal::Type::Enum
+
+            REALTIME_CONVERSATION = :"realtime.conversation"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      # A single item within a Realtime conversation.
+      module ConversationItem
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A system message item in a Realtime conversation.
+        variant :message, -> { OpenAI::Realtime::RealtimeConversationItemSystemMessage }
+
+        # A user message item in a Realtime conversation.
+        variant :message, -> { OpenAI::Realtime::RealtimeConversationItemUserMessage }
+
+        # An assistant message item in a Realtime conversation.
+        variant :message, -> { OpenAI::Realtime::RealtimeConversationItemAssistantMessage }
+
+        # A function call item in a Realtime conversation.
+        variant :function_call, -> { OpenAI::Realtime::RealtimeConversationItemFunctionCall }
+
+        # A function call output item in a Realtime conversation.
+        variant :function_call_output, -> { OpenAI::Realtime::RealtimeConversationItemFunctionCallOutput }
+
+        # A Realtime item responding to an MCP approval request.
+        variant :mcp_approval_response, -> { OpenAI::Realtime::RealtimeMcpApprovalResponse }
+
+        # A Realtime item listing tools available on an MCP server.
+        variant :mcp_list_tools, -> { OpenAI::Realtime::RealtimeMcpListTools }
+
+        # A Realtime item representing an invocation of a tool on an MCP server.
+        variant :mcp_tool_call, -> { OpenAI::Realtime::RealtimeMcpToolCall }
+
+        # A Realtime item requesting human approval of a tool invocation.
+        variant :mcp_approval_request, -> { OpenAI::Realtime::RealtimeMcpApprovalRequest }
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest)]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationItemAdded < OpenAI::Internal::Type::BaseModel
+        # @!attribute event_id
+        #   The unique ID of the server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute item
+        #   A single item within a Realtime conversation.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest]
+        required :item, union: -> { OpenAI::Realtime::ConversationItem }
+
+        # @!attribute type
+        #   The event type, must be `conversation.item.added`.
+        #
+        #   @return [Symbol, :"conversation.item.added"]
+        required :type, const: :"conversation.item.added"
+
+        # @!attribute previous_item_id
+        #   The ID of the item that precedes this one, if any. This is used to maintain
+        #   ordering when items are inserted.
+        #
+        #   @return [String, nil]
+        optional :previous_item_id, String, nil?: true
+
+        # @!method initialize(event_id:, item:, previous_item_id: nil, type: :"conversation.item.added")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Realtime::ConversationItemAdded} for more details.
+        #
+        #   Returned when a conversation item is added.
+        #
+        #   @param event_id [String] The unique ID of the server event.
+        #
+        #   @param item [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest] A single item within a Realtime conversation.
+        #
+        #   @param previous_item_id [String, nil] The ID of the item that precedes this one, if any. This is used to
+        #
+        #   @param type [Symbol, :"conversation.item.added"] The event type, must be `conversation.item.added`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationItemCreateEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute item
+        #   A single item within a Realtime conversation.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest]
+        required :item, union: -> { OpenAI::Realtime::ConversationItem }
+
+        # @!attribute type
+        #   The event type, must be `conversation.item.create`.
+        #
+        #   @return [Symbol, :"conversation.item.create"]
+        required :type, const: :"conversation.item.create"
+
+        # @!attribute event_id
+        #   Optional client-generated ID used to identify this event.
+        #
+        #   @return [String, nil]
+        optional :event_id, String
+
+        # @!attribute previous_item_id
+        #   The ID of the preceding item after which the new item will be inserted. If not
+        #   set, the new item will be appended to the end of the conversation. If set to
+        #   `root`, the new item will be added to the beginning of the conversation. If set
+        #   to an existing ID, it allows an item to be inserted mid-conversation. If the ID
+        #   cannot be found, an error will be returned and the item will not be added.
+        #
+        #   @return [String, nil]
+        optional :previous_item_id, String
+
+        # @!method initialize(item:, event_id: nil, previous_item_id: nil, type: :"conversation.item.create")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Realtime::ConversationItemCreateEvent} for more details.
+        #
+        #   Add a new Item to the Conversation's context, including messages, function
+        #   calls, and function call responses. This event can be used both to populate a
+        #   "history" of the conversation and to add new items mid-stream, but has the
+        #   current limitation that it cannot populate assistant audio messages.
+        #
+        #   If successful, the server will respond with a `conversation.item.created` event,
+        #   otherwise an `error` event will be sent.
+        #
+        #   @param item [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest] A single item within a Realtime conversation.
+        #
+        #   @param event_id [String] Optional client-generated ID used to identify this event.
+        #
+        #   @param previous_item_id [String] The ID of the preceding item after which the new item will be inserted.
+        #
+        #   @param type [Symbol, :"conversation.item.create"] The event type, must be `conversation.item.create`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationItemCreatedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute event_id
+        #   The unique ID of the server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute item
+        #   A single item within a Realtime conversation.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest]
+        required :item, union: -> { OpenAI::Realtime::ConversationItem }
+
+        # @!attribute type
+        #   The event type, must be `conversation.item.created`.
+        #
+        #   @return [Symbol, :"conversation.item.created"]
+        required :type, const: :"conversation.item.created"
+
+        # @!attribute previous_item_id
+        #   The ID of the preceding item in the Conversation context, allows the client to
+        #   understand the order of the conversation. Can be `null` if the item has no
+        #   predecessor.
+        #
+        #   @return [String, nil]
+        optional :previous_item_id, String, nil?: true
+
+        # @!method initialize(event_id:, item:, previous_item_id: nil, type: :"conversation.item.created")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Realtime::ConversationItemCreatedEvent} for more details.
+        #
+        #   Returned when a conversation item is created. There are several scenarios that
+        #   produce this event:
+        #
+        #   - The server is generating a Response, which if successful will produce either
+        #     one or two Items, which will be of type `message` (role `assistant`) or type
+        #     `function_call`.
+        #   - The input audio buffer has been committed, either by the client or the server
+        #     (in `server_vad` mode). The server will take the content of the input audio
+        #     buffer and add it to a new user message Item.
+        #   - The client has sent a `conversation.item.create` event to add a new Item to
+        #     the Conversation.
+        #
+        #   @param event_id [String] The unique ID of the server event.
+        #
+        #   @param item [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest] A single item within a Realtime conversation.
+        #
+        #   @param previous_item_id [String, nil] The ID of the preceding item in the Conversation context, allows the
+        #
+        #   @param type [Symbol, :"conversation.item.created"] The event type, must be `conversation.item.created`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationItemDeleteEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute item_id
+        #   The ID of the item to delete.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute type
+        #   The event type, must be `conversation.item.delete`.
+        #
+        #   @return [Symbol, :"conversation.item.delete"]
+        required :type, const: :"conversation.item.delete"
+
+        # @!attribute event_id
+        #   Optional client-generated ID used to identify this event.
+        #
+        #   @return [String, nil]
+        optional :event_id, String
+
+        # @!method initialize(item_id:, event_id: nil, type: :"conversation.item.delete")
+        #   Send this event when you want to remove any item from the conversation history.
+        #   The server will respond with a `conversation.item.deleted` event, unless the
+        #   item does not exist in the conversation history, in which case the server will
+        #   respond with an error.
+        #
+        #   @param item_id [String] The ID of the item to delete.
+        #
+        #   @param event_id [String] Optional client-generated ID used to identify this event.
+        #
+        #   @param type [Symbol, :"conversation.item.delete"] The event type, must be `conversation.item.delete`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      class ConversationItemDeletedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute event_id
+        #   The unique ID of the server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute item_id
+        #   The ID of the item that was deleted.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute type
+        #   The event type, must be `conversation.item.deleted`.
+        #
+        #   @return [Symbol, :"conversation.item.deleted"]
+        required :type, const: :"conversation.item.deleted"
+
+        # @!method initialize(event_id:, item_id:, type: :"conversation.item.deleted")
+        #   Returned when an item in the conversation is deleted by the client with a
+        #   `conversation.item.delete` event. This event is used to synchronize the server's
+        #   understanding of the conversation history with the client's view.
+        #
+        #   @param event_id [String] The unique ID of the server event.
+        #
+        #   @param item_id [String] The ID of the item that was deleted.
+        #
+        #   @param type [Symbol, :"conversation.item.deleted"] The event type, must be `conversation.item.deleted`.
+      end
+    end
+  end
+end