openai 0.89.0 → 0.91.0

data/rbi/openai/models/responses/response_compact_params.rbi

@@ -258,7 +258,6 @@ module OpenAI
             OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
           )
           GPT_5_1_CODEX = T.let(:"gpt-5.1-codex", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
-          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5_1_CHAT_LATEST = T.let(
             :"gpt-5.1-chat-latest",
             OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
@@ -319,6 +318,11 @@ module OpenAI
           GPT_4O_2024_11_20 = T.let(:"gpt-4o-2024-11-20", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           GPT_4O_2024_08_06 = T.let(:"gpt-4o-2024-08-06", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           GPT_4O_2024_05_13 = T.let(:"gpt-4o-2024-05-13", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
+          GPT_AUDIO_MINI = T.let(:"gpt-audio-mini", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
+          GPT_AUDIO_MINI_2025_12_15 = T.let(
+            :"gpt-audio-mini-2025-12-15",
+            OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+          )
           GPT_4O_AUDIO_PREVIEW = T.let(
             :"gpt-4o-audio-preview",
             OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
@@ -415,6 +419,7 @@ module OpenAI
             :"gpt-3.5-turbo-16k-0613",
             OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
           )
+          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           O1_PRO = T.let(:"o1-pro", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           O1_PRO_2025_03_19 = T.let(:"o1-pro-2025-03-19", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)
           O3_PRO = T.let(:"o3-pro", OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol)

data/rbi/openai/models/responses/response_compaction_compacting_event.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Responses
+
+      class ResponseCompactionCompactingEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Responses::ResponseCompactionCompactingEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The ID of the compaction output item.
+        sig { returns(String) }
+        attr_accessor :item_id
+
+        # The index of the compaction output item.
+        sig { returns(Integer) }
+        attr_accessor :output_index
+
+        # The sequence number of the event that was emitted.
+        sig { returns(Integer) }
+        attr_accessor :sequence_number
+
+        # The type of the event, always `response.compaction.compacting`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted when new summary content is sampled for a compaction trigger. Contains
+        # no summary content.
+        sig do
+          params(
+
+            item_id: String,
+
+            output_index: Integer,
+
+            sequence_number: Integer,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The ID of the compaction output item.
+          item_id:,
+
+          # The index of the compaction output item.
+          output_index:,
+
+          # The sequence number of the event that was emitted.
+          sequence_number:,
+
+          # The type of the event, always `response.compaction.compacting`.
+
+          type: :"response.compaction.compacting"
+        )
+        end
+
+        sig do
+          override.returns(
+            {item_id: String, output_index: Integer, sequence_number: Integer, type: Symbol}
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/responses/response_create_params.rbi

@@ -1176,6 +1176,14 @@ module OpenAI
           sig { params(mode: OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol).void }
           attr_writer :mode
 
+          # Prepares the prompt cache without generating output. Defaults to `false`. When
+          # set to `true`, overrides the `generate` field to `false`.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :prewarm
+
+          sig { params(prewarm: T::Boolean).void }
+          attr_writer :prewarm
+
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
           # written by the request. Defaults to `30m`, which is currently the only supported
           # value. The backend may retain cache entries for longer.
@@ -1201,6 +1209,8 @@ module OpenAI
 
               mode: OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
 
+              prewarm: T::Boolean,
+
               ttl: OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
             )
               .returns(T.attached_class)
@@ -1219,6 +1229,10 @@ module OpenAI
             # request does not use prompt caching.
             mode: nil,
 
+            # Prepares the prompt cache without generating output. Defaults to `false`. When
+            # set to `true`, overrides the `generate` field to `false`.
+            prewarm: nil,
+
             # The minimum lifetime applied to every implicit and explicit cache breakpoint
             # written by the request. Defaults to `30m`, which is currently the only supported
             # value. The backend may retain cache entries for longer.
@@ -1232,6 +1246,7 @@ module OpenAI
               {
                 comparison_response_id: T.nilable(String),
                 mode: OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
+                prewarm: T::Boolean,
                 ttl: OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
               }
             )

data/rbi/openai/models/responses/response_stream_event.rbi

@@ -20,6 +20,7 @@ module OpenAI
             OpenAI::Responses::ResponseCodeInterpreterCallCompletedEvent,
             OpenAI::Responses::ResponseCodeInterpreterCallInProgressEvent,
             OpenAI::Responses::ResponseCodeInterpreterCallInterpretingEvent,
+            OpenAI::Responses::ResponseCompactionCompactingEvent,
             OpenAI::Responses::ResponseCompletedEvent,
             OpenAI::Responses::ResponseContentPartAddedEvent,
             OpenAI::Responses::ResponseContentPartDoneEvent,

data/rbi/openai/models/responses/responses_client_event.rbi

@@ -1327,6 +1327,14 @@ module OpenAI
             }
             attr_writer :mode
 
+            # Prepares the prompt cache without generating output. Defaults to `false`. When
+            # set to `true`, overrides the `generate` field to `false`.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :prewarm
+
+            sig { params(prewarm: T::Boolean).void }
+            attr_writer :prewarm
+
             # The minimum lifetime applied to every implicit and explicit cache breakpoint
             # written by the request. Defaults to `30m`, which is currently the only supported
             # value. The backend may retain cache entries for longer.
@@ -1359,6 +1367,8 @@ module OpenAI
 
                 mode: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode::OrSymbol,
 
+                prewarm: T::Boolean,
+
                 ttl: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl::OrSymbol
               )
                 .returns(T.attached_class)
@@ -1377,6 +1387,10 @@ module OpenAI
               # request does not use prompt caching.
               mode: nil,
 
+              # Prepares the prompt cache without generating output. Defaults to `false`. When
+              # set to `true`, overrides the `generate` field to `false`.
+              prewarm: nil,
+
               # The minimum lifetime applied to every implicit and explicit cache breakpoint
               # written by the request. Defaults to `30m`, which is currently the only supported
               # value. The backend may retain cache entries for longer.
@@ -1392,6 +1406,7 @@ module OpenAI
                   mode: T.nilable(
                     OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode::OrSymbol
                   ),
+                  prewarm: T.nilable(T::Boolean),
                   ttl: T.nilable(
                     OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl::OrSymbol
                   )

data/rbi/openai/models/responses/responses_server_event.rbi

@@ -24,6 +24,7 @@ module OpenAI
             OpenAI::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsCompleted,
             OpenAI::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallInWsProgress,
             OpenAI::Responses::ResponsesServerEvent::ResponseCodeInterpreterCallWsInterpreting,
+            OpenAI::Responses::ResponsesServerEvent::ResponseCompactionWsCompacting,
             OpenAI::Responses::ResponsesServerEvent::ResponseWsCompleted,
             OpenAI::Responses::ResponsesServerEvent::ResponseContentPartWsAdded,
             OpenAI::Responses::ResponsesServerEvent::ResponseContentPartWsDone,
@@ -658,6 +659,76 @@ module OpenAI
 
         end
 
+        class ResponseCompactionWsCompacting < OpenAI::Models::Responses::ResponseCompactionCompactingEvent
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Responses::ResponsesServerEvent::ResponseCompactionWsCompacting,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The WebSocket lane that emitted this event. This field is present when the
+          # originating `response.create` event supplied a `stream_id`.
+          sig { returns(T.nilable(String)) }
+          attr_reader :stream_id
+
+          sig { params(stream_id: String).void }
+          attr_writer :stream_id
+
+          # Emitted when new summary content is sampled for a compaction trigger. Contains
+          # no summary content.
+          sig do
+            params(
+
+              item_id: String,
+
+              output_index: Integer,
+
+              sequence_number: Integer,
+
+              stream_id: String,
+
+              type: Symbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The ID of the compaction output item.
+            item_id:,
+
+            # The index of the compaction output item.
+            output_index:,
+
+            # The sequence number of the event that was emitted.
+            sequence_number:,
+
+            # The WebSocket lane that emitted this event. This field is present when the
+            # originating `response.create` event supplied a `stream_id`.
+            stream_id: nil,
+
+            # The type of the event, always `response.compaction.compacting`.
+
+            type: :"response.compaction.compacting"
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                item_id: String,
+                output_index: Integer,
+                sequence_number: Integer,
+                type: Symbol,
+                stream_id: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         class ResponseWsCompleted < OpenAI::Models::Responses::ResponseCompletedEvent
           OrHash = T.type_alias do
             T.any(

data/rbi/openai/models/webhooks/realtime_call_incoming_webhook_event.rbi

@@ -100,10 +100,9 @@ module OpenAI
             )
           end
 
-          # 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.
           sig { returns(String) }
           attr_accessor :call_id
 
@@ -125,10 +124,9 @@ module OpenAI
           end
           def self.new(
 
-            # 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.
             call_id:,
 
             # Headers from the SIP INVITE, excluding SIP authorization headers. Retained

data/rbi/openai/resources/beta/agents/environments/files.rbi

@@ -0,0 +1,79 @@
+# typed: strong
+
+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).
+            sig {
+              params(
+                environment_id: String,
+                hosted_environment_file_param: T.any(
+                  OpenAI::Beta::HostedEnvironmentFileParam::FileID::OrHash,
+                  OpenAI::Beta::HostedEnvironmentFileParam::Inline::OrHash
+                ),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Beta::Agents::Environments::EnvironmentFile)
+            }
+            def create(
+              # The ID of the environment.
+              environment_id,
+              # A file materialized in an OpenAI-hosted execution environment.
+              hosted_environment_file_param:,
+              request_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).
+            sig {
+              params(
+                environment_id: String,
+                limit: T.nilable(Integer),
+                order: OpenAI::Beta::Agents::Environments::FileListParams::Order::OrSymbol,
+                page: String,
+                path: T.nilable(String),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Internal::TokenPage[OpenAI::Beta::Agents::Environments::EnvironmentFile])
+            }
+            def list(
+              # The ID of the environment.
+              environment_id,
+              # The maximum number of files to return, between 1 and 100.
+              limit: nil,
+              # Sort by case-sensitive path components. Defaults to descending.
+              order: nil,
+              # The opaque token from the previous page. Keep the same path, order, and limit.
+              page: nil,
+              # Restrict the listing to this absolute workspace directory.
+              path: nil,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta/agents/environments/templates.rbi

@@ -0,0 +1,194 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Environments
+
+          class Templates
+
+            # Creates reusable environment configuration without returning confidential setup
+            # commands or environment values. See
+            # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
+            sig {
+              params(
+                capability_directories: T.nilable(T::Array[String]),
+                env: T.nilable(T::Hash[Symbol, String]),
+                files: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::HostedEnvironmentFileParam::FileID::OrHash,
+                      OpenAI::Beta::HostedEnvironmentFileParam::Inline::OrHash
+                    )
+                  ]
+                ),
+                name: T.nilable(String),
+                network: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network::OrHash),
+                packages: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Packages::OrHash),
+                plugins: T.nilable(T::Array[OpenAI::Beta::HostedPluginParam::OrHash]),
+                setup_commands: T.nilable(T::Array[OpenAI::Beta::SetupCommandParam::OrHash]),
+                skills: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::HostedSkillParam::SkillReference::OrHash,
+                      OpenAI::Beta::HostedSkillParam::Inline::OrHash
+                    )
+                  ]
+                ),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Beta::Agents::Environments::EnvironmentTemplate)
+            }
+            def create(
+              # Directories that contain capabilities exposed to the agent. Defaults to an empty
+              # list.
+              capability_directories: nil,
+              # Environment variables made available to the agent.
+              env: nil,
+              # Files available before the agent starts. Defaults to an empty list.
+              files: nil,
+              # An optional human-readable display name for the template.
+              name: nil,
+              # Network access for an OpenAI-hosted environment.
+              network: nil,
+              # Packages to install in an OpenAI-hosted environment.
+              packages: nil,
+              # Plugins provided as inline ZIP archives. Defaults to an empty list.
+              plugins: nil,
+              # Ordered, confidential setup commands. Command bodies are never returned.
+              setup_commands: nil,
+              # Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty
+              # list.
+              skills: nil,
+              request_options: {}
+            )
+            end
+
+            # Retrieves reusable environment configuration without returning confidential
+            # values. See
+            # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
+            sig {
+              params(environment_template_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+                OpenAI::Beta::Agents::Environments::EnvironmentTemplate
+              )
+            }
+            def retrieve(
+              # The ID of the reusable environment template.
+              environment_template_id,
+              request_options: {}
+            )
+            end
+
+            # Updates reusable environment configuration without returning confidential
+            # values. See
+            # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
+            sig {
+              params(
+                environment_template_id: String,
+                capability_directories: T.nilable(T::Array[String]),
+                env: T.nilable(T::Hash[Symbol, String]),
+                files: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::HostedEnvironmentFileParam::FileID::OrHash,
+                      OpenAI::Beta::HostedEnvironmentFileParam::Inline::OrHash
+                    )
+                  ]
+                ),
+                name: T.nilable(String),
+                network: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network::OrHash),
+                packages: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Packages::OrHash),
+                plugins: T.nilable(T::Array[OpenAI::Beta::HostedPluginParam::OrHash]),
+                setup_commands: T.nilable(T::Array[OpenAI::Beta::SetupCommandParam::OrHash]),
+                skills: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::HostedSkillParam::SkillReference::OrHash,
+                      OpenAI::Beta::HostedSkillParam::Inline::OrHash
+                    )
+                  ]
+                ),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Beta::Agents::Environments::EnvironmentTemplate)
+            }
+            def update(
+              # The ID of the reusable environment template.
+              environment_template_id,
+              # Directories that expose capabilities to the agent.
+              capability_directories: nil,
+              # Replacement confidential environment values.
+              env: nil,
+              # Replacement file configuration materialized for each new session.
+              files: nil,
+              # A replacement human-readable display name, or `null` to clear the name.
+              name: nil,
+              # Network access for an OpenAI-hosted environment.
+              network: nil,
+              # Packages to install in an OpenAI-hosted environment.
+              packages: nil,
+              # Replacement plugin configuration installed for each new session.
+              plugins: nil,
+              # Replacement confidential setup commands, never included in returned resources.
+              setup_commands: nil,
+              # Replacement skill configuration installed for each new session.
+              skills: nil,
+              request_options: {}
+            )
+            end
+
+            # Lists reusable environment templates without returning confidential values. See
+            # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
+            sig {
+              params(
+                after: String,
+                limit: Integer,
+                order: OpenAI::Beta::Agents::Environments::TemplateListParams::Order::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agents::Environments::EnvironmentTemplate])
+            }
+            def list(
+              # Return resources after this resource ID in the selected order.
+              after: nil,
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+              limit: nil,
+              # The order in which resources are returned. Defaults to `desc`.
+              order: nil,
+              request_options: {}
+            )
+            end
+
+            # Deletes reusable environment configuration and all confidential template inputs.
+            # See
+            # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
+            sig {
+              params(environment_template_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+                OpenAI::Beta::Agents::Environments::EnvironmentTemplateDeleted
+              )
+            }
+            def delete(
+              # The ID of the reusable environment template.
+              environment_template_id,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta/agents/environments.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Environments
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Environments::Files) }
+          attr_reader :files
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Environments::Templates) }
+          attr_reader :templates
+
+          # Retrieves an execution environment's connection status and safe installed
+          # metadata. See
+          # [environment lifecycle](https://developers.openai.com/api/docs/guides/agents-api/environments/lifecycle).
+          sig {
+            params(environment_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Beta::Agents::EnvironmentInfo
+            )
+          }
+          def retrieve(
+            # The ID of the environment.
+            environment_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+
+      end
+
+    end
+
+  end
+end