openai 0.79.0 → 0.80.0

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

@@ -238,6 +238,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
@@ -705,6 +709,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
@@ -720,6 +728,7 @@ module OpenAI
           SCALE = :scale
           PRIORITY = :priority
           FAST = :fast
+          ULTRAFAST = :ultrafast
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -1706,8 +1706,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Responses::McpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -1738,7 +1738,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::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

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

@@ -705,8 +705,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Responses::McpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -737,7 +737,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::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

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

@@ -518,8 +518,8 @@ module OpenAI
           # @!attribute error
           #   The error from the tool call, if any.
           #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
+          #   @return [OpenAI::Models::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil]
+          optional :error, union: -> { OpenAI::Responses::McpToolCallError }, nil?: true
 
           # @!attribute output
           #   The output from the tool call.
@@ -550,7 +550,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::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #

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

@@ -5,7 +5,10 @@ module OpenAI
     module Responses
       class ResponseOutputItemAddedEvent < 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::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseOutputItem::Program, OpenAI::Models::Responses::ResponseOutputItem::ProgramOutput, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseOutputItem::AdditionalTools, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem]
         required :item, union: -> { OpenAI::Responses::ResponseOutputItem }
@@ -34,7 +37,7 @@ module OpenAI
         #
         #   Emitted when a new output item is added.
         #
-        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseOutputItem::Program, OpenAI::Models::Responses::ResponseOutputItem::ProgramOutput, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseOutputItem::AdditionalTools, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem] The output item that was added.
+        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseOutputItem::Program, OpenAI::Models::Responses::ResponseOutputItem::ProgramOutput, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseOutputItem::AdditionalTools, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem] 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/responses/response_output_text_annotation_added_event.rb

@@ -5,10 +5,12 @@ module OpenAI
     module Responses
       class ResponseOutputTextAnnotationAddedEvent < 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::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil]
+        required :annotation,
+                 union: -> { OpenAI::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation },
+                 nil?: true
 
         # @!attribute annotation_index
         #   The index of the annotation within the content part.
@@ -49,7 +51,7 @@ module OpenAI
         # @!method initialize(annotation:, annotation_index:, content_index:, item_id:, output_index:, sequence_number:, 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::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::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.
         #
@@ -62,6 +64,201 @@ module OpenAI
         #   @param sequence_number [Integer] The sequence number of this event.
         #
         #   @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::Responses::ResponseOutputTextAnnotationAddedEvent#annotation
+        module Annotation
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # A citation to a file.
+          variant :file_citation,
+                  -> { OpenAI::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation }
+
+          # A citation for a web resource used to generate a model response.
+          variant :url_citation,
+                  -> { OpenAI::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation }
+
+          # A citation for a container file used to generate a model response.
+          variant :container_file_citation,
+                  -> { OpenAI::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation }
+
+          # A path to a file.
+          variant :file_path, -> { OpenAI::Responses::ResponseOutputTextAnnotationAddedEvent::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::Responses::ResponseOutputTextAnnotationAddedEvent::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::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FilePath)]
+        end
       end
     end
   end

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

@@ -35,6 +35,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/responses/responses_client_event.rb

@@ -238,6 +238,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
@@ -732,6 +736,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
@@ -749,6 +757,7 @@ module OpenAI
           SCALE = :scale
           PRIORITY = :priority
           FAST = :fast
+          ULTRAFAST = :ultrafast
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -9,6 +9,9 @@ module OpenAI
 
         discriminator :type
 
+        # Emitted when an error occurs while processing a Responses WebSocket request.
+        variant :error, -> { OpenAI::Responses::ResponsesServerEvent::ResponseWsError }
+
         # Emitted when there is a partial audio response.
         variant :"response.audio.delta", -> { OpenAI::Responses::ResponsesServerEvent::ResponseAudioWsDelta }
 
@@ -57,9 +60,6 @@ module OpenAI
         # An event that is emitted when a response is created.
         variant :"response.created", -> { OpenAI::Responses::ResponsesServerEvent::ResponseWsCreated }
 
-        # Emitted when an error occurs.
-        variant :error, -> { OpenAI::Responses::ResponsesServerEvent::ResponseWsError }
-
         # Emitted when a file search call is completed (results found).
         variant :"response.file_search_call.completed",
                 -> { OpenAI::Responses::ResponsesServerEvent::ResponseFileSearchCallWsCompleted }
@@ -442,24 +442,6 @@ module OpenAI
           #   @param stream_id [String] The WebSocket lane that emitted this event. This field is present
         end
 
-        class ResponseWsError < OpenAI::Models::Responses::ResponseErrorEvent
-          # @!attribute stream_id
-          #   The WebSocket lane that emitted this event. This field is present when the
-          #   originating `response.create` event supplied a `stream_id`.
-          #
-          #   @return [String, nil]
-          optional :stream_id, String
-
-          # @!method initialize(stream_id: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError} for more
-          #   details.
-          #
-          #   Emitted when an error occurs.
-          #
-          #   @param stream_id [String] The WebSocket lane that emitted this event. This field is present
-        end
-
         class ResponseFileSearchCallWsCompleted < OpenAI::Models::Responses::ResponseFileSearchCallCompletedEvent
           # @!attribute stream_id
           #   The WebSocket lane that emitted this event. This field is present when the
@@ -1166,8 +1148,104 @@ module OpenAI
           #   @param stream_id [String] The WebSocket lane that emitted this event. This field is present
         end
 
+        class ResponseWsError < OpenAI::Internal::Type::BaseModel
+          # @!attribute error
+          #   Details about the error.
+          #
+          #   @return [OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error]
+          required :error, -> { OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error }
+
+          # @!attribute type
+          #   The type of the event. Always `error`.
+          #
+          #   @return [Symbol, :error]
+          required :type, const: :error
+
+          # @!attribute sequence_number
+          #   The sequence number of an error emitted by the response stream.
+          #
+          #   @return [Integer, nil]
+          optional :sequence_number, Integer
+
+          # @!attribute status
+          #   The HTTP status code associated with a WebSocket protocol error.
+          #
+          #   @return [Integer, nil]
+          optional :status, Integer
+
+          # @!attribute stream_id
+          #   The WebSocket lane that emitted this event. This field is present when the
+          #   originating `response.create` event supplied a `stream_id`.
+          #
+          #   @return [String, nil]
+          optional :stream_id, String
+
+          # @!method initialize(error:, sequence_number: nil, status: nil, stream_id: nil, type: :error)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError} for more
+          #   details.
+          #
+          #   Emitted when an error occurs while processing a Responses WebSocket request.
+          #
+          #   @param error [OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error] Details about the error.
+          #
+          #   @param sequence_number [Integer] The sequence number of an error emitted by the response stream.
+          #
+          #   @param status [Integer] The HTTP status code associated with a WebSocket protocol error.
+          #
+          #   @param stream_id [String] The WebSocket lane that emitted this event. This field is present when the
+          #
+          #   @param type [Symbol, :error] The type of the event. Always `error`.
+
+          # @see OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError#error
+          class Error < OpenAI::Internal::Type::BaseModel
+            # @!attribute code
+            #   The error code that was emitted, if any.
+            #
+            #   @return [String, nil]
+            required :code, String, nil?: true
+
+            # @!attribute message
+            #   The human-readable error message that was emitted.
+            #
+            #   @return [String]
+            required :message, String
+
+            # @!attribute param
+            #   The parameter name that was associated with the error, if any.
+            #
+            #   @return [String, nil]
+            required :param, String, nil?: true
+
+            # @!attribute type
+            #   The error type that was emitted.
+            #
+            #   @return [String]
+            required :type, String
+
+            # @!attribute headers
+            #   The response headers that were emitted with the error, if any.
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, OpenAI::Internal::Type::HashOf[String]
+
+            # @!method initialize(code:, message:, param:, type:, headers: nil)
+            #   Details about the error.
+            #
+            #   @param code [String, nil] The error code that was emitted, if any.
+            #
+            #   @param message [String] The human-readable error message that was emitted.
+            #
+            #   @param param [String, nil] The parameter name that was associated with the error, if any.
+            #
+            #   @param type [String] The error type that was emitted.
+            #
+            #   @param headers [Hash{Symbol=>String}] The response headers that were emitted with the error, if any.
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioTranscriptWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioTranscriptWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallCodeWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallCodeWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsInterpreting, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseContentPartWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseContentPartWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsCreated, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallWsSearching, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFunctionCallArgumentsWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFunctionCallArgumentsWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsIncomplete, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputItemWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputItemWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryPartWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryPartWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseRefusalWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseRefusalWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallWsSearching, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallWsGenerating, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallPartialWsImage, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallArgumentsWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallArgumentsWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputTextAnnotationWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsQueued, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCustomToolCallInputWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCustomToolCallInputWsDone)]
+        #   @return [Array(OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioTranscriptWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseAudioTranscriptWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallCodeWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallCodeWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsInterpreting, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseContentPartWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseContentPartWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsCreated, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFileSearchCallWsSearching, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFunctionCallArgumentsWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseFunctionCallArgumentsWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsIncomplete, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputItemWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputItemWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryPartWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryPartWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningSummaryTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseReasoningTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseRefusalWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseRefusalWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseTextWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseTextWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWebSearchCallWsSearching, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallWsGenerating, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseImageGenCallPartialWsImage, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallArgumentsWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallArgumentsWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpCallInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsWsCompleted, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsWsFailed, OpenAI::Models::Responses::ResponsesServerEvent::ResponseMcpListToolsInWsProgress, OpenAI::Models::Responses::ResponsesServerEvent::ResponseOutputTextAnnotationWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsQueued, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCustomToolCallInputWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseCustomToolCallInputWsDone)]
       end
     end
   end

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

@@ -10,6 +10,14 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Responses::WebSearchTool::Type]
         required :type, enum: -> { OpenAI::Responses::WebSearchTool::Type }
 
+        # @!attribute external_web_access
+        #   Allow live internet access for web search. Defaults to true when omitted. When
+        #   false, the web search tool runs in offline/cache-only mode and will not fetch
+        #   new external content.
+        #
+        #   @return [Boolean, nil]
+        optional :external_web_access, OpenAI::Internal::Type::Boolean
+
         # @!attribute filters
         #   Filters for the search.
         #
@@ -29,7 +37,7 @@ module OpenAI
         #   @return [OpenAI::Models::Responses::WebSearchTool::UserLocation, nil]
         optional :user_location, -> { OpenAI::Responses::WebSearchTool::UserLocation }, nil?: true
 
-        # @!method initialize(type:, filters: nil, search_context_size: nil, user_location: nil)
+        # @!method initialize(type:, external_web_access: nil, filters: nil, search_context_size: nil, user_location: nil)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::WebSearchTool} for more details.
         #
@@ -38,6 +46,8 @@ module OpenAI
         #
         #   @param type [Symbol, OpenAI::Models::Responses::WebSearchTool::Type] The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
+        #   @param external_web_access [Boolean] Allow live internet access for web search. Defaults to true when omitted. When f
+        #
         #   @param filters [OpenAI::Models::Responses::WebSearchTool::Filters, nil] Filters for the search.
         #
         #   @param search_context_size [Symbol, OpenAI::Models::Responses::WebSearchTool::SearchContextSize] High level guidance for the amount of context window space to use for the search

data/lib/openai/models/responses_model.rb

@@ -24,6 +24,8 @@ 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"