openai 0.78.0 → 0.80.0

data/lib/openai/models/beta/beta_response.rb

@@ -274,6 +274,10 @@ module OpenAI
         #     Responses or Chat Completions. The response will show `service_tier=priority`
         #     regardless of if you specify `service_tier=fast` or `priority` in your
         #     request.
+        #   - If set to 'ultrafast', then the request will be processed with the
+        #     access-controlled Ultrafast Processing service tier. This tier is currently
+        #     available for `gpt-5.6-sol`; a response served through it will show
+        #     `service_tier=ultrafast`.
         #   - When not set, the default behavior is 'auto'.
         #
         #   When the `service_tier` parameter is set, the response body will include the
@@ -483,6 +487,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_5 }
 
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_5_2026_04_23 }
+
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_4 }
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_4_MINI }
@@ -659,6 +665,10 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::COMPUTER_USE_PREVIEW_2025_03_11 }
 
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_5_PRO }
+
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_5_PRO_2026_04_23 }
+
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_CODEX }
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_PRO }
@@ -667,6 +677,12 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_1_CODEX_MAX }
 
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_DAYBREAK_BLUE_LATEST }
+
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_DAYBREAK_RED_LATEST }
+
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_5_6_CYBER }
+
           variant String
 
           # @!method self.variants
@@ -682,6 +698,7 @@ module OpenAI
           GPT_5_6_TERRA = :"gpt-5.6-terra"
           GPT_5_6_LUNA = :"gpt-5.6-luna"
           GPT_5_5 = :"gpt-5.5"
+          GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
           GPT_5_4 = :"gpt-5.4"
           GPT_5_4_MINI = :"gpt-5.4-mini"
           GPT_5_4_NANO = :"gpt-5.4-nano"
@@ -770,10 +787,15 @@ module OpenAI
           O4_MINI_DEEP_RESEARCH_2025_06_26 = :"o4-mini-deep-research-2025-06-26"
           COMPUTER_USE_PREVIEW = :"computer-use-preview"
           COMPUTER_USE_PREVIEW_2025_03_11 = :"computer-use-preview-2025-03-11"
+          GPT_5_5_PRO = :"gpt-5.5-pro"
+          GPT_5_5_PRO_2026_04_23 = :"gpt-5.5-pro-2026-04-23"
           GPT_5_CODEX = :"gpt-5-codex"
           GPT_5_PRO = :"gpt-5-pro"
           GPT_5_PRO_2025_10_06 = :"gpt-5-pro-2025-10-06"
           GPT_5_1_CODEX_MAX = :"gpt-5.1-codex-max"
+          GPT_DAYBREAK_BLUE_LATEST = :"gpt-daybreak-blue-latest"
+          GPT_DAYBREAK_RED_LATEST = :"gpt-daybreak-red-latest"
+          GPT_5_6_CYBER = :"gpt-5.6-cyber"
 
           # @!endgroup
         end
@@ -1395,6 +1417,10 @@ module OpenAI
         #   Responses or Chat Completions. The response will show `service_tier=priority`
         #   regardless of if you specify `service_tier=fast` or `priority` in your
         #   request.
+        # - If set to 'ultrafast', then the request will be processed with the
+        #   access-controlled Ultrafast Processing service tier. This tier is currently
+        #   available for `gpt-5.6-sol`; a response served through it will show
+        #   `service_tier=ultrafast`.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the
@@ -1412,6 +1438,7 @@ module OpenAI
           SCALE = :scale
           PRIORITY = :priority
           FAST = :fast
+          ULTRAFAST = :ultrafast
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/openai/models/beta/beta_response_input_item.rb

@@ -2502,8 +2502,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Beta::BetaMcpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -2536,7 +2536,7 @@ module OpenAI
           #
           #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
           #
-          #   @param error [String, nil] The error from the tool call, if any.
+          #   @param error [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

data/lib/openai/models/beta/beta_response_item.rb

@@ -1354,8 +1354,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Beta::BetaMcpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -1388,7 +1388,7 @@ module OpenAI
           #
           #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
           #
-          #   @param error [String, nil] The error from the tool call, if any.
+          #   @param error [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

data/lib/openai/models/beta/beta_response_output_item.rb

@@ -1106,8 +1106,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Beta::BetaMcpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -1140,7 +1140,7 @@ module OpenAI
           #
           #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
           #
-          #   @param error [String, nil] The error from the tool call, if any.
+          #   @param error [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

data/lib/openai/models/beta/beta_response_output_item_added_event.rb

@@ -5,7 +5,10 @@ module OpenAI
     module Beta
       class BetaResponseOutputItemAddedEvent < OpenAI::Internal::Type::BaseModel
         # @!attribute item
-        #   The output item that was added.
+        #   The output item that was added. For reasoning items, `encrypted_content` may be
+        #   incomplete while the item is in progress. Use the reasoning item from the
+        #   corresponding `response.output_item.done` event when passing it as input to a
+        #   subsequent request.
         #
         #   @return [OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseOutputItem::Program, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseOutputItem::McpCall, OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem]
         required :item, union: -> { OpenAI::Beta::BetaResponseOutputItem }
@@ -40,7 +43,7 @@ module OpenAI
         #
         #   Emitted when a new output item is added.
         #
-        #   @param item [OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseOutputItem::Program, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseOutputItem::McpCall, OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem] The output item that was added.
+        #   @param item [OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseOutputItem::Program, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseOutputItem::McpCall, OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem] The output item that was added. For reasoning items, `encrypted_content`
         #
         #   @param output_index [Integer] The index of the output item that was added.
         #

data/lib/openai/models/beta/beta_response_output_text_annotation_added_event.rb

@@ -5,10 +5,12 @@ module OpenAI
     module Beta
       class BetaResponseOutputTextAnnotationAddedEvent < OpenAI::Internal::Type::BaseModel
         # @!attribute annotation
-        #   The annotation object being added. (See annotation schema for details.)
+        #   An annotation that applies to a span of output text.
         #
-        #   @return [Object]
-        required :annotation, OpenAI::Internal::Type::Unknown
+        #   @return [OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil]
+        required :annotation,
+                 union: -> { OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation },
+                 nil?: true
 
         # @!attribute annotation_index
         #   The index of the annotation within the content part.
@@ -55,7 +57,7 @@ module OpenAI
         # @!method initialize(annotation:, annotation_index:, content_index:, item_id:, output_index:, sequence_number:, agent: nil, type: :"response.output_text.annotation.added")
         #   Emitted when an annotation is added to output text content.
         #
-        #   @param annotation [Object] The annotation object being added. (See annotation schema for details.)
+        #   @param annotation [OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil] An annotation that applies to a span of output text.
         #
         #   @param annotation_index [Integer] The index of the annotation within the content part.
         #
@@ -71,6 +73,201 @@ module OpenAI
         #
         #   @param type [Symbol, :"response.output_text.annotation.added"] The type of the event. Always 'response.output_text.annotation.added'.
 
+        # An annotation that applies to a span of output text.
+        #
+        # @see OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent#annotation
+        module Annotation
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # A citation to a file.
+          variant :file_citation,
+                  -> { OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation }
+
+          # A citation for a web resource used to generate a model response.
+          variant :url_citation,
+                  -> { OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation }
+
+          # A citation for a container file used to generate a model response.
+          variant :container_file_citation,
+                  -> { OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation }
+
+          # A path to a file.
+          variant :file_path, -> { OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FilePath }
+
+          class FileCitation < OpenAI::Internal::Type::BaseModel
+            # @!attribute file_id
+            #   The ID of the file.
+            #
+            #   @return [String]
+            required :file_id, String
+
+            # @!attribute filename
+            #   The filename of the file cited.
+            #
+            #   @return [String]
+            required :filename, String
+
+            # @!attribute index
+            #   The index of the file in the list of files.
+            #
+            #   @return [Integer]
+            required :index, Integer
+
+            # @!attribute type
+            #   The type of the file citation. Always `file_citation`.
+            #
+            #   @return [Symbol, :file_citation]
+            required :type, const: :file_citation
+
+            # @!method initialize(file_id:, filename:, index:, type: :file_citation)
+            #   A citation to a file.
+            #
+            #   @param file_id [String] The ID of the file.
+            #
+            #   @param filename [String] The filename of the file cited.
+            #
+            #   @param index [Integer] The index of the file in the list of files.
+            #
+            #   @param type [Symbol, :file_citation] The type of the file citation. Always `file_citation`.
+          end
+
+          class URLCitation < OpenAI::Internal::Type::BaseModel
+            # @!attribute end_index
+            #   The index of the last character of the URL citation in the message.
+            #
+            #   @return [Integer]
+            required :end_index, Integer
+
+            # @!attribute start_index
+            #   The index of the first character of the URL citation in the message.
+            #
+            #   @return [Integer]
+            required :start_index, Integer
+
+            # @!attribute title
+            #   The title of the web resource.
+            #
+            #   @return [String]
+            required :title, String
+
+            # @!attribute type
+            #   The type of the URL citation. Always `url_citation`.
+            #
+            #   @return [Symbol, :url_citation]
+            required :type, const: :url_citation
+
+            # @!attribute url
+            #   The URL of the web resource.
+            #
+            #   @return [String]
+            required :url, String
+
+            # @!method initialize(end_index:, start_index:, title:, url:, type: :url_citation)
+            #   A citation for a web resource used to generate a model response.
+            #
+            #   @param end_index [Integer] The index of the last character of the URL citation in the message.
+            #
+            #   @param start_index [Integer] The index of the first character of the URL citation in the message.
+            #
+            #   @param title [String] The title of the web resource.
+            #
+            #   @param url [String] The URL of the web resource.
+            #
+            #   @param type [Symbol, :url_citation] The type of the URL citation. Always `url_citation`.
+          end
+
+          class ContainerFileCitation < OpenAI::Internal::Type::BaseModel
+            # @!attribute container_id
+            #   The ID of the container file.
+            #
+            #   @return [String]
+            required :container_id, String
+
+            # @!attribute end_index
+            #   The index of the last character of the container file citation in the message.
+            #
+            #   @return [Integer]
+            required :end_index, Integer
+
+            # @!attribute file_id
+            #   The ID of the file.
+            #
+            #   @return [String]
+            required :file_id, String
+
+            # @!attribute filename
+            #   The filename of the container file cited.
+            #
+            #   @return [String]
+            required :filename, String
+
+            # @!attribute start_index
+            #   The index of the first character of the container file citation in the message.
+            #
+            #   @return [Integer]
+            required :start_index, Integer
+
+            # @!attribute type
+            #   The type of the container file citation. Always `container_file_citation`.
+            #
+            #   @return [Symbol, :container_file_citation]
+            required :type, const: :container_file_citation
+
+            # @!method initialize(container_id:, end_index:, file_id:, filename:, start_index:, type: :container_file_citation)
+            #   A citation for a container file used to generate a model response.
+            #
+            #   @param container_id [String] The ID of the container file.
+            #
+            #   @param end_index [Integer] The index of the last character of the container file citation in the message.
+            #
+            #   @param file_id [String] The ID of the file.
+            #
+            #   @param filename [String] The filename of the container file cited.
+            #
+            #   @param start_index [Integer] The index of the first character of the container file citation in the message.
+            #
+            #   @param type [Symbol, :container_file_citation] The type of the container file citation. Always `container_file_citation`.
+          end
+
+          class FilePath < OpenAI::Internal::Type::BaseModel
+            # @!attribute file_id
+            #   The ID of the file.
+            #
+            #   @return [String]
+            required :file_id, String
+
+            # @!attribute index
+            #   The index of the file in the list of files.
+            #
+            #   @return [Integer]
+            required :index, Integer
+
+            # @!attribute type
+            #   The type of the file path. Always `file_path`.
+            #
+            #   @return [Symbol, :file_path]
+            required :type, const: :file_path
+
+            # @!method initialize(file_id:, index:, type: :file_path)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FilePath}
+            #   for more details.
+            #
+            #   A path to a file.
+            #
+            #   @param file_id [String] The ID of the file.
+            #
+            #   @param index [Integer] The index of the file in the list of files.
+            #
+            #   @param type [Symbol, :file_path] The type of the file path. Always `file_path`.
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::FilePath)]
+        end
+
         # @see OpenAI::Models::Beta::BetaResponseOutputTextAnnotationAddedEvent#agent
         class Agent < OpenAI::Internal::Type::BaseModel
           # @!attribute agent_name

data/lib/openai/models/beta/beta_response_reasoning_item.rb

@@ -41,6 +41,11 @@ module OpenAI
         #   reasoning items returned by `POST /v1/responses` and WebSocket `response.create`
         #   requests.
         #
+        #   When streaming, use the completed reasoning item and its `encrypted_content`
+        #   from the `response.output_item.done` event in subsequent requests. The
+        #   `encrypted_content` in `response.output_item.added` may be incomplete. This is
+        #   especially important when `store` is `false` or when using Zero Data Retention.
+        #
         #   @return [String, nil]
         optional :encrypted_content, String, nil?: true
 

data/lib/openai/models/beta/beta_response_stream_event.rb

@@ -3,7 +3,7 @@
 module OpenAI
   module Models
     module Beta
-      # Emitted when there is a partial audio response.
+      # Event emitted while a response is streamed.
       module BetaResponseStreamEvent
         extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/beta/beta_responses_client_event.rb

@@ -10,11 +10,13 @@ module OpenAI
         discriminator :type
 
         # Client event for creating a response over a persistent WebSocket connection.
-        # This payload uses the same top-level fields as `POST /v1/responses`.
+        # This payload uses the same top-level fields as `POST /v1/responses`, plus
+        # WebSocket-only envelope metadata.
         #
         # Notes:
         # - `stream` is implicit over WebSocket and should not be sent.
         # - `background` is not supported over WebSocket.
+        # - `stream_id` is WebSocket-only and is not part of `POST /v1/responses`.
         variant :"response.create", -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate }
 
         # Injects input items into an active response over a WebSocket connection.
@@ -270,6 +272,10 @@ module OpenAI
           #     Responses or Chat Completions. The response will show `service_tier=priority`
           #     regardless of if you specify `service_tier=fast` or `priority` in your
           #     request.
+          #   - If set to 'ultrafast', then the request will be processed with the
+          #     access-controlled Ultrafast Processing service tier. This tier is currently
+          #     available for `gpt-5.6-sol`; a response served through it will show
+          #     `service_tier=ultrafast`.
           #   - When not set, the default behavior is 'auto'.
           #
           #   When the `service_tier` parameter is set, the response body will include the
@@ -299,6 +305,16 @@ module OpenAI
           #   @return [Boolean, nil]
           optional :stream, OpenAI::Internal::Type::Boolean, nil?: true
 
+          # @!attribute stream_id
+          #   The WebSocket lane for this response. Requests with the same `stream_id` are
+          #   processed FIFO, and events for the response echo the same `stream_id`.
+          #
+          #   `stream_id` controls routing; `previous_response_id` controls conversation
+          #   lineage, so a new lane can fork from a response created on another lane.
+          #
+          #   @return [String, nil]
+          optional :stream_id, String
+
           # @!attribute stream_options
           #   Options for streaming responses. Only set this when you set `stream: true`.
           #
@@ -404,18 +420,20 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate} for more
           #   details.
           #
           #   Client event for creating a response over a persistent WebSocket connection.
-          #   This payload uses the same top-level fields as `POST /v1/responses`.
+          #   This payload uses the same top-level fields as `POST /v1/responses`, plus
+          #   WebSocket-only envelope metadata.
           #
           #   Notes:
           #
           #   - `stream` is implicit over WebSocket and should not be sent.
           #   - `background` is not supported over WebSocket.
+          #   - `stream_id` is WebSocket-only and is not part of `POST /v1/responses`.
           #
           #   @param background [Boolean, nil] Whether to run the model response in the background.
           #
@@ -463,6 +481,8 @@ module OpenAI
           #
           #   @param stream [Boolean, nil] If set to true, the model response data will be streamed to the client
           #
+          #   @param stream_id [String] The WebSocket lane for this response. Requests with the same
+          #
           #   @param stream_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::StreamOptions, nil] Options for streaming responses. Only set this when you set `stream: true`.
           #
           #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
@@ -565,6 +585,8 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_5 }
 
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_5_2026_04_23 }
+
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_4 }
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_4_MINI }
@@ -741,6 +763,10 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::COMPUTER_USE_PREVIEW_2025_03_11 }
 
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_5_PRO }
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_5_PRO_2026_04_23 }
+
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_CODEX }
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_PRO }
@@ -749,6 +775,12 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_1_CODEX_MAX }
 
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_DAYBREAK_BLUE_LATEST }
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_DAYBREAK_RED_LATEST }
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_5_6_CYBER }
+
             variant String
 
             # @!method self.variants
@@ -764,6 +796,7 @@ module OpenAI
             GPT_5_6_TERRA = :"gpt-5.6-terra"
             GPT_5_6_LUNA = :"gpt-5.6-luna"
             GPT_5_5 = :"gpt-5.5"
+            GPT_5_5_2026_04_23 = :"gpt-5.5-2026-04-23"
             GPT_5_4 = :"gpt-5.4"
             GPT_5_4_MINI = :"gpt-5.4-mini"
             GPT_5_4_NANO = :"gpt-5.4-nano"
@@ -852,10 +885,15 @@ module OpenAI
             O4_MINI_DEEP_RESEARCH_2025_06_26 = :"o4-mini-deep-research-2025-06-26"
             COMPUTER_USE_PREVIEW = :"computer-use-preview"
             COMPUTER_USE_PREVIEW_2025_03_11 = :"computer-use-preview-2025-03-11"
+            GPT_5_5_PRO = :"gpt-5.5-pro"
+            GPT_5_5_PRO_2026_04_23 = :"gpt-5.5-pro-2026-04-23"
             GPT_5_CODEX = :"gpt-5-codex"
             GPT_5_PRO = :"gpt-5-pro"
             GPT_5_PRO_2025_10_06 = :"gpt-5-pro-2025-10-06"
             GPT_5_1_CODEX_MAX = :"gpt-5.1-codex-max"
+            GPT_DAYBREAK_BLUE_LATEST = :"gpt-daybreak-blue-latest"
+            GPT_DAYBREAK_RED_LATEST = :"gpt-daybreak-red-latest"
+            GPT_5_6_CYBER = :"gpt-5.6-cyber"
 
             # @!endgroup
           end
@@ -1316,6 +1354,10 @@ module OpenAI
           #   Responses or Chat Completions. The response will show `service_tier=priority`
           #   regardless of if you specify `service_tier=fast` or `priority` in your
           #   request.
+          # - If set to 'ultrafast', then the request will be processed with the
+          #   access-controlled Ultrafast Processing service tier. This tier is currently
+          #   available for `gpt-5.6-sol`; a response served through it will show
+          #   `service_tier=ultrafast`.
           # - When not set, the default behavior is 'auto'.
           #
           # When the `service_tier` parameter is set, the response body will include the
@@ -1333,6 +1375,7 @@ module OpenAI
             SCALE = :scale
             PRIORITY = :priority
             FAST = :fast
+            ULTRAFAST = :ultrafast
 
             # @!method self.values
             #   @return [Array<Symbol>]