openai 0.89.0 → 0.91.0

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

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # An action performed by the web search tool.
+      module WebSearchAction
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A search query or group of search queries.
+        variant :search, -> { OpenAI::Beta::WebSearchAction::Search }
+
+        # Opens a web page.
+        variant :open_page, -> { OpenAI::Beta::WebSearchAction::OpenPage }
+
+        # Finds text within a web page.
+        variant :find_in_page, -> { OpenAI::Beta::WebSearchAction::FindInPage }
+
+        # Another web search action.
+        variant :other, -> { OpenAI::Beta::WebSearchAction::Other }
+
+        class Search < OpenAI::Internal::Type::BaseModel
+          # @!attribute queries
+          #   The search queries, when multiple queries were used.
+          #
+          #   @return [Array<String>, nil]
+          required :queries, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute query
+          #   The search query, when a single query was used.
+          #
+          #   @return [String, nil]
+          required :query, String, nil?: true
+
+          # @!attribute type
+          #   The type of the object. Always `search`.
+          #
+          #   @return [Symbol, :search]
+          required :type, const: :search
+
+          # @!method initialize(queries:, query:, type: :search)
+          #   A search query or group of search queries.
+          #
+          #   @param queries [Array<String>, nil]
+          #     The search queries, when multiple queries were used.
+          #
+          #   @param query [String, nil]
+          #     The search query, when a single query was used.
+          #
+          #   @param type [Symbol, :search]
+          #     The type of the object. Always `search`.
+        end
+
+        class OpenPage < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `open_page`.
+          #
+          #   @return [Symbol, :open_page]
+          required :type, const: :open_page
+
+          # @!attribute url
+          #   The URL of the page that was opened.
+          #
+          #   @return [String, nil]
+          required :url, String, nil?: true
+
+          # @!method initialize(url:, type: :open_page)
+          #   Opens a web page.
+          #
+          #   @param url [String, nil]
+          #     The URL of the page that was opened.
+          #
+          #   @param type [Symbol, :open_page]
+          #     The type of the object. Always `open_page`.
+        end
+
+        class FindInPage < OpenAI::Internal::Type::BaseModel
+          # @!attribute pattern
+          #   The text pattern that was searched for.
+          #
+          #   @return [String, nil]
+          required :pattern, String, nil?: true
+
+          # @!attribute type
+          #   The type of the object. Always `find_in_page`.
+          #
+          #   @return [Symbol, :find_in_page]
+          required :type, const: :find_in_page
+
+          # @!attribute url
+          #   The URL of the page that was searched.
+          #
+          #   @return [String, nil]
+          required :url, String, nil?: true
+
+          # @!method initialize(pattern:, url:, type: :find_in_page)
+          #   Finds text within a web page.
+          #
+          #   @param pattern [String, nil]
+          #     The text pattern that was searched for.
+          #
+          #   @param url [String, nil]
+          #     The URL of the page that was searched.
+          #
+          #   @param type [Symbol, :find_in_page]
+          #     The type of the object. Always `find_in_page`.
+        end
+
+        class Other < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `other`.
+          #
+          #   @return [Symbol, :other]
+          required :type, const: :other
+
+          # @!method initialize(type: :other)
+          #   Another web search action.
+          #
+          #   @param type [Symbol, :other]
+          #     The type of the object. Always `other`.
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::WebSearchAction::Search, OpenAI::Models::Beta::WebSearchAction::OpenPage, OpenAI::Models::Beta::WebSearchAction::FindInPage, OpenAI::Models::Beta::WebSearchAction::Other)]
+      end
+    end
+  end
+end

data/lib/openai/models/chat/completion_create_params.rb

@@ -1080,7 +1080,7 @@ module OpenAI
           # An {OpenAI::BaseModel} can be provided and implicitly converted into {OpenAI::Models::ResponseFormatJSONSchema}.
           # See examples for more details.
           #
-          # Learn more about [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+          # Learn more about [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
           variant -> { OpenAI::StructuredOutput::JsonSchemaConverter }
 
           # JSON object response format. An older method of generating JSON responses.

data/lib/openai/models/chat_model.rb

@@ -25,7 +25,6 @@ module OpenAI
       GPT_5_1 = :"gpt-5.1"
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       GPT_5_1_CODEX = :"gpt-5.1-codex"
-      GPT_5_1_MINI = :"gpt-5.1-mini"
       GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
       GPT_5 = :"gpt-5"
       GPT_5_MINI = :"gpt-5-mini"
@@ -56,6 +55,8 @@ module OpenAI
       GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
       GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
       GPT_4O_2024_05_13 = :"gpt-4o-2024-05-13"
+      GPT_AUDIO_MINI = :"gpt-audio-mini"
+      GPT_AUDIO_MINI_2025_12_15 = :"gpt-audio-mini-2025-12-15"
       GPT_4O_AUDIO_PREVIEW = :"gpt-4o-audio-preview"
       GPT_4O_AUDIO_PREVIEW_2024_10_01 = :"gpt-4o-audio-preview-2024-10-01"
       GPT_4O_AUDIO_PREVIEW_2024_12_17 = :"gpt-4o-audio-preview-2024-12-17"
@@ -89,6 +90,7 @@ module OpenAI
       GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
       GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
       GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
+      GPT_5_1_MINI = :"gpt-5.1-mini"
 
       # @!method self.values
       #   @return [Array<Symbol>]

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

@@ -207,8 +207,6 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_CODEX }
 
-          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_MINI }
-
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5 }
@@ -269,6 +267,10 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_4O_2024_05_13 }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_AUDIO_MINI }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_AUDIO_MINI_2025_12_15 }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_4O_AUDIO_PREVIEW }
 
           variant(
@@ -349,6 +351,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_3_5_TURBO_16K_0613 }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_MINI }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::O1_PRO }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::O1_PRO_2025_03_19 }
@@ -422,7 +426,6 @@ module OpenAI
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           GPT_5_1_CODEX = :"gpt-5.1-codex"
-          GPT_5_1_MINI = :"gpt-5.1-mini"
           GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
           GPT_5 = :"gpt-5"
           GPT_5_MINI = :"gpt-5-mini"
@@ -453,6 +456,8 @@ module OpenAI
           GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
           GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
           GPT_4O_2024_05_13 = :"gpt-4o-2024-05-13"
+          GPT_AUDIO_MINI = :"gpt-audio-mini"
+          GPT_AUDIO_MINI_2025_12_15 = :"gpt-audio-mini-2025-12-15"
           GPT_4O_AUDIO_PREVIEW = :"gpt-4o-audio-preview"
           GPT_4O_AUDIO_PREVIEW_2024_10_01 = :"gpt-4o-audio-preview-2024-10-01"
           GPT_4O_AUDIO_PREVIEW_2024_12_17 = :"gpt-4o-audio-preview-2024-12-17"
@@ -486,6 +491,7 @@ module OpenAI
           GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
           GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
           GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
+          GPT_5_1_MINI = :"gpt-5.1-mini"
           O1_PRO = :"o1-pro"
           O1_PRO_2025_03_19 = :"o1-pro-2025-03-19"
           O3_PRO = :"o3-pro"

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseCompactionCompactingEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute item_id
+        #   The ID of the compaction output item.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute output_index
+        #   The index of the compaction output item.
+        #
+        #   @return [Integer]
+        required :output_index, Integer
+
+        # @!attribute sequence_number
+        #   The sequence number of the event that was emitted.
+        #
+        #   @return [Integer]
+        required :sequence_number, Integer
+
+        # @!attribute type
+        #   The type of the event, always `response.compaction.compacting`.
+        #
+        #   @return [Symbol, :"response.compaction.compacting"]
+        required :type, const: :"response.compaction.compacting"
+
+        # @!method initialize(item_id:, output_index:, sequence_number:, type: :"response.compaction.compacting")
+        #   Emitted when new summary content is sampled for a compaction trigger. Contains
+        #   no summary content.
+        #
+        #   @param item_id [String]
+        #     The ID of the compaction output item.
+        #
+        #   @param output_index [Integer]
+        #     The index of the compaction output item.
+        #
+        #   @param sequence_number [Integer]
+        #     The sequence number of the event that was emitted.
+        #
+        #   @param type [Symbol, :"response.compaction.compacting"]
+        #     The type of the event, always `response.compaction.compacting`.
+      end
+    end
+  end
+end

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

@@ -817,6 +817,13 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Mode, nil]
           optional :mode, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Mode }
 
+          # @!attribute prewarm
+          #   Prepares the prompt cache without generating output. Defaults to `false`. When
+          #   set to `true`, overrides the `generate` field to `false`.
+          #
+          #   @return [Boolean, nil]
+          optional :prewarm, OpenAI::Internal::Type::Boolean
+
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
           #   written by the request. Defaults to `30m`, which is currently the only supported
@@ -825,7 +832,7 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl }
 
-          # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
+          # @!method initialize(comparison_response_id: nil, mode: nil, prewarm: nil, ttl: nil)
           #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
           #   default, OpenAI automatically chooses one implicit cache breakpoint. You can add
           #   explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
@@ -848,6 +855,10 @@ module OpenAI
           #     latest four explicit breakpoints. If there are no explicit breakpoints, the
           #     request does not use prompt caching.
           #
+          #   @param prewarm [Boolean]
+          #     Prepares the prompt cache without generating output. Defaults to `false`. When
+          #     set to `true`, overrides the `generate` field to `false`.
+          #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
           #     written by the request. Defaults to `30m`, which is currently the only supported

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

@@ -51,6 +51,9 @@ module OpenAI
           -> { OpenAI::Responses::ResponseCodeInterpreterCallInterpretingEvent }
         )
 
+        # Emitted when new summary content is sampled for a compaction trigger. Contains no summary content.
+        variant :"response.compaction.compacting", -> { OpenAI::Responses::ResponseCompactionCompactingEvent }
+
         # Emitted when the model response is complete.
         variant :"response.completed", -> { OpenAI::Responses::ResponseCompletedEvent }
 
@@ -269,7 +272,7 @@ module OpenAI
         )
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponseAudioDeltaEvent, OpenAI::Models::Responses::ResponseAudioDoneEvent, OpenAI::Models::Responses::ResponseAudioTranscriptDeltaEvent, OpenAI::Models::Responses::ResponseAudioTranscriptDoneEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDeltaEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDoneEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCompletedEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallInProgressEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallInterpretingEvent, OpenAI::Models::Responses::ResponseCompletedEvent, OpenAI::Models::Responses::ResponseContentPartAddedEvent, OpenAI::Models::Responses::ResponseContentPartDoneEvent, OpenAI::Models::Responses::ResponseCreatedEvent, OpenAI::Models::Responses::ResponseErrorEvent, OpenAI::Models::Responses::ResponseFileSearchCallCompletedEvent, OpenAI::Models::Responses::ResponseFileSearchCallInProgressEvent, OpenAI::Models::Responses::ResponseFileSearchCallSearchingEvent, OpenAI::Models::Responses::ResponseFunctionCallArgumentsDeltaEvent, OpenAI::Models::Responses::ResponseFunctionCallArgumentsDoneEvent, OpenAI::Models::Responses::ResponseShellCallCommandAddedEvent, OpenAI::Models::Responses::ResponseShellCallCommandDeltaEvent, OpenAI::Models::Responses::ResponseShellCallCommandDoneEvent, OpenAI::Models::Responses::ResponseShellCallOutputContentDeltaEvent, OpenAI::Models::Responses::ResponseShellCallOutputContentDoneEvent, OpenAI::Models::Responses::ResponseInProgressEvent, OpenAI::Models::Responses::ResponseFailedEvent, OpenAI::Models::Responses::ResponseIncompleteEvent, OpenAI::Models::Responses::ResponseOutputItemAddedEvent, OpenAI::Models::Responses::ResponseOutputItemDoneEvent, OpenAI::Models::Responses::ResponseReasoningSummaryPartAddedEvent, OpenAI::Models::Responses::ResponseReasoningSummaryPartDoneEvent, OpenAI::Models::Responses::ResponseReasoningSummaryTextDeltaEvent, OpenAI::Models::Responses::ResponseReasoningSummaryTextDoneEvent, OpenAI::Models::Responses::ResponseReasoningTextDeltaEvent, OpenAI::Models::Responses::ResponseReasoningTextDoneEvent, OpenAI::Models::Responses::ResponseRefusalDeltaEvent, OpenAI::Models::Responses::ResponseRefusalDoneEvent, OpenAI::Models::Responses::ResponseTextDeltaEvent, OpenAI::Models::Responses::ResponseTextDoneEvent, OpenAI::Models::Responses::ResponseWebSearchCallCompletedEvent, OpenAI::Models::Responses::ResponseWebSearchCallInProgressEvent, OpenAI::Models::Responses::ResponseWebSearchCallSearchingEvent, OpenAI::Models::Responses::ResponseImageGenCallCompletedEvent, OpenAI::Models::Responses::ResponseImageGenCallGeneratingEvent, OpenAI::Models::Responses::ResponseImageGenCallInProgressEvent, OpenAI::Models::Responses::ResponseImageGenCallPartialImageEvent, OpenAI::Models::Responses::ResponseMcpCallArgumentsDeltaEvent, OpenAI::Models::Responses::ResponseMcpCallArgumentsDoneEvent, OpenAI::Models::Responses::ResponseMcpCallCompletedEvent, OpenAI::Models::Responses::ResponseMcpCallFailedEvent, OpenAI::Models::Responses::ResponseMcpCallInProgressEvent, OpenAI::Models::Responses::ResponseMcpListToolsCompletedEvent, OpenAI::Models::Responses::ResponseMcpListToolsFailedEvent, OpenAI::Models::Responses::ResponseMcpListToolsInProgressEvent, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent, OpenAI::Models::Responses::ResponseQueuedEvent, OpenAI::Models::Responses::ResponseCustomToolCallInputDeltaEvent, OpenAI::Models::Responses::ResponseCustomToolCallInputDoneEvent)]
+        #   @return [Array(OpenAI::Models::Responses::ResponseAudioDeltaEvent, OpenAI::Models::Responses::ResponseAudioDoneEvent, OpenAI::Models::Responses::ResponseAudioTranscriptDeltaEvent, OpenAI::Models::Responses::ResponseAudioTranscriptDoneEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDeltaEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDoneEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallCompletedEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallInProgressEvent, OpenAI::Models::Responses::ResponseCodeInterpreterCallInterpretingEvent, OpenAI::Models::Responses::ResponseCompactionCompactingEvent, OpenAI::Models::Responses::ResponseCompletedEvent, OpenAI::Models::Responses::ResponseContentPartAddedEvent, OpenAI::Models::Responses::ResponseContentPartDoneEvent, OpenAI::Models::Responses::ResponseCreatedEvent, OpenAI::Models::Responses::ResponseErrorEvent, OpenAI::Models::Responses::ResponseFileSearchCallCompletedEvent, OpenAI::Models::Responses::ResponseFileSearchCallInProgressEvent, OpenAI::Models::Responses::ResponseFileSearchCallSearchingEvent, OpenAI::Models::Responses::ResponseFunctionCallArgumentsDeltaEvent, OpenAI::Models::Responses::ResponseFunctionCallArgumentsDoneEvent, OpenAI::Models::Responses::ResponseShellCallCommandAddedEvent, OpenAI::Models::Responses::ResponseShellCallCommandDeltaEvent, OpenAI::Models::Responses::ResponseShellCallCommandDoneEvent, OpenAI::Models::Responses::ResponseShellCallOutputContentDeltaEvent, OpenAI::Models::Responses::ResponseShellCallOutputContentDoneEvent, OpenAI::Models::Responses::ResponseInProgressEvent, OpenAI::Models::Responses::ResponseFailedEvent, OpenAI::Models::Responses::ResponseIncompleteEvent, OpenAI::Models::Responses::ResponseOutputItemAddedEvent, OpenAI::Models::Responses::ResponseOutputItemDoneEvent, OpenAI::Models::Responses::ResponseReasoningSummaryPartAddedEvent, OpenAI::Models::Responses::ResponseReasoningSummaryPartDoneEvent, OpenAI::Models::Responses::ResponseReasoningSummaryTextDeltaEvent, OpenAI::Models::Responses::ResponseReasoningSummaryTextDoneEvent, OpenAI::Models::Responses::ResponseReasoningTextDeltaEvent, OpenAI::Models::Responses::ResponseReasoningTextDoneEvent, OpenAI::Models::Responses::ResponseRefusalDeltaEvent, OpenAI::Models::Responses::ResponseRefusalDoneEvent, OpenAI::Models::Responses::ResponseTextDeltaEvent, OpenAI::Models::Responses::ResponseTextDoneEvent, OpenAI::Models::Responses::ResponseWebSearchCallCompletedEvent, OpenAI::Models::Responses::ResponseWebSearchCallInProgressEvent, OpenAI::Models::Responses::ResponseWebSearchCallSearchingEvent, OpenAI::Models::Responses::ResponseImageGenCallCompletedEvent, OpenAI::Models::Responses::ResponseImageGenCallGeneratingEvent, OpenAI::Models::Responses::ResponseImageGenCallInProgressEvent, OpenAI::Models::Responses::ResponseImageGenCallPartialImageEvent, OpenAI::Models::Responses::ResponseMcpCallArgumentsDeltaEvent, OpenAI::Models::Responses::ResponseMcpCallArgumentsDoneEvent, OpenAI::Models::Responses::ResponseMcpCallCompletedEvent, OpenAI::Models::Responses::ResponseMcpCallFailedEvent, OpenAI::Models::Responses::ResponseMcpCallInProgressEvent, OpenAI::Models::Responses::ResponseMcpListToolsCompletedEvent, OpenAI::Models::Responses::ResponseMcpListToolsFailedEvent, OpenAI::Models::Responses::ResponseMcpListToolsInProgressEvent, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent, OpenAI::Models::Responses::ResponseQueuedEvent, OpenAI::Models::Responses::ResponseCustomToolCallInputDeltaEvent, OpenAI::Models::Responses::ResponseCustomToolCallInputDoneEvent)]
       end
     end
   end

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

@@ -941,6 +941,13 @@ module OpenAI
               enum: -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode }
             )
 
+            # @!attribute prewarm
+            #   Prepares the prompt cache without generating output. Defaults to `false`. When
+            #   set to `true`, overrides the `generate` field to `false`.
+            #
+            #   @return [Boolean, nil]
+            optional :prewarm, OpenAI::Internal::Type::Boolean
+
             # @!attribute ttl
             #   The minimum lifetime applied to every implicit and explicit cache breakpoint
             #   written by the request. Defaults to `30m`, which is currently the only supported
@@ -952,7 +959,7 @@ module OpenAI
               enum: -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl }
             )
 
-            # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
+            # @!method initialize(comparison_response_id: nil, mode: nil, prewarm: nil, ttl: nil)
             #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
             #   default, OpenAI automatically chooses one implicit cache breakpoint. You can add
             #   explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
@@ -975,6 +982,10 @@ module OpenAI
             #     latest four explicit breakpoints. If there are no explicit breakpoints, the
             #     request does not use prompt caching.
             #
+            #   @param prewarm [Boolean]
+            #     Prepares the prompt cache without generating output. Defaults to `false`. When
+            #     set to `true`, overrides the `generate` field to `false`.
+            #
             #   @param ttl [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl]
             #     The minimum lifetime applied to every implicit and explicit cache breakpoint
             #     written by the request. Defaults to `30m`, which is currently the only supported

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

@@ -100,6 +100,12 @@ module OpenAI
           -> { OpenAI::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsInterpreting }
         )
 
+        # Emitted when new summary content is sampled for a compaction trigger. Contains no summary content.
+        variant(
+          :"response.compaction.compacting",
+          -> { OpenAI::Responses::ResponsesServerEvent::ResponseCompactionWsCompacting }
+        )
+
         # Emitted when the model response is complete.
         variant :"response.completed", -> { OpenAI::Responses::ResponsesServerEvent::ResponseWsCompleted }
 
@@ -606,6 +612,35 @@ module OpenAI
           #     The type of the event. Always `response.code_interpreter_call.interpreting`.
         end
 
+        class ResponseCompactionWsCompacting < OpenAI::Models::Responses::ResponseCompactionCompactingEvent
+          # @!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(item_id:, output_index:, sequence_number:, stream_id: nil, type: :"response.compaction.compacting")
+          #   Emitted when new summary content is sampled for a compaction trigger. Contains
+          #   no summary content.
+          #
+          #   @param item_id [String]
+          #     The ID of the compaction output item.
+          #
+          #   @param output_index [Integer]
+          #     The index of the compaction output item.
+          #
+          #   @param sequence_number [Integer]
+          #     The sequence number of the event that was emitted.
+          #
+          #   @param stream_id [String]
+          #     The WebSocket lane that emitted this event. This field is present when the
+          #     originating `response.create` event supplied a `stream_id`.
+          #
+          #   @param type [Symbol, :"response.compaction.compacting"]
+          #     The type of the event, always `response.compaction.compacting`.
+        end
+
         class ResponseWsCompleted < OpenAI::Models::Responses::ResponseCompletedEvent
           # @!attribute stream_id
           #   The WebSocket lane that emitted this event. This field is present when the
@@ -2315,7 +2350,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError, OpenAI::Models::Responses::ResponseSteerAcceptedEvent, OpenAI::Models::Responses::ResponseSteerPendingEvent, OpenAI::Models::Responses::ResponseSteerFailedEvent, 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::ResponseShellCallCommandWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallCommandWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallCommandWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallOutputContentWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallOutputContentWsDone, 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::ResponseSteerAcceptedEvent, OpenAI::Models::Responses::ResponseSteerPendingEvent, OpenAI::Models::Responses::ResponseSteerFailedEvent, 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::ResponseCompactionWsCompacting, 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::ResponseShellCallCommandWsAdded, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallCommandWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallCommandWsDone, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallOutputContentWsDelta, OpenAI::Models::Responses::ResponsesServerEvent::ResponseShellCallOutputContentWsDone, 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/webhooks/realtime_call_incoming_webhook_event.rb

@@ -57,10 +57,9 @@ module OpenAI
         # @see OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent#data
         class Data < OpenAI::Internal::Type::BaseModel
           # @!attribute call_id
-          #   The Transceiver `rtc_...` ID of the pending SIP session. The paired
-          #   `live.transport.incoming` event derives its `session_id` by replacing the `rtc_`
-          #   prefix with `live_`. Use the ID returned by the event with the corresponding
-          #   Realtime or Live API.
+          #   The ID of the pending SIP call. Pass this value unchanged when accepting or
+          #   rejecting the call through the Realtime API. For the Live API, use the
+          #   `session_id` from `live.transport.incoming` instead.
           #
           #   @return [String]
           required :call_id, String
@@ -80,10 +79,9 @@ module OpenAI
           #   Event data payload.
           #
           #   @param call_id [String]
-          #     The Transceiver `rtc_...` ID of the pending SIP session. The paired
-          #     `live.transport.incoming` event derives its `session_id` by replacing the `rtc_`
-          #     prefix with `live_`. Use the ID returned by the event with the corresponding
-          #     Realtime or Live API.
+          #     The ID of the pending SIP call. Pass this value unchanged when accepting or
+          #     rejecting the call through the Realtime API. For the Live API, use the
+          #     `session_id` from `live.transport.incoming` instead.
           #
           #   @param sip_headers [Array<OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader>]
           #     Headers from the SIP INVITE, excluding SIP authorization headers. Retained

data/lib/openai/resources/beta/agents/environments/files.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Environments
+          class Files
+            # Copies inline bytes or a Files API file into a connected execution environment.
+            # See
+            # [environment files](https://developers.openai.com/api/docs/guides/agents-api/environments/files).
+            #
+            # @overload create(environment_id, hosted_environment_file_param:, request_options: {})
+            #
+            # @param environment_id [String]
+            #   The ID of the environment.
+            #
+            # @param hosted_environment_file_param [OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID, OpenAI::Models::Beta::HostedEnvironmentFileParam::Inline]
+            #   A file materialized in an OpenAI-hosted execution environment.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Beta::Agents::Environments::EnvironmentFile]
+            #
+            # @see OpenAI::Models::Beta::Agents::Environments::FileCreateParams
+            def create(environment_id, params)
+              parsed, options = OpenAI::Beta::Agents::Environments::FileCreateParams.dump_request(params)
+              @client.request(
+                method: :post,
+                path: ["agents/environments/%1$s/files", environment_id],
+                body: parsed[:hosted_environment_file_param],
+                model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Lists live files on a connected execution environment with optional directory
+            # filtering and opaque cursor pagination. See
+            # [environment files](https://developers.openai.com/api/docs/guides/agents-api/environments/files).
+            #
+            # @overload list(environment_id, limit: nil, order: nil, page: nil, path: nil, request_options: {})
+            #
+            # @param environment_id [String]
+            #   The ID of the environment.
+            #
+            # @param limit [Integer, nil]
+            #   The maximum number of files to return, between 1 and 100.
+            #
+            # @param order [Symbol, OpenAI::Models::Beta::Agents::Environments::FileListParams::Order]
+            #   Sort by case-sensitive path components. Defaults to descending.
+            #
+            # @param page [String]
+            #   The opaque token from the previous page. Keep the same path, order, and limit.
+            #
+            # @param path [String, nil]
+            #   Restrict the listing to this absolute workspace directory.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Internal::TokenPage<OpenAI::Models::Beta::Agents::Environments::EnvironmentFile>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Environments::FileListParams
+            def list(environment_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Environments::FileListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/environments/%1$s/files", environment_id],
+                query: query,
+                page: OpenAI::Internal::TokenPage,
+                model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [OpenAI::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end