openai 0.123.0 → 0.124.0

data/rbi/openai/models/admin/organization/external_key_create_params.rbi

@@ -24,7 +24,8 @@ module OpenAI
               T.any(
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws,
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp,
-                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure,
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci
               )
             )
           }
@@ -36,7 +37,8 @@ module OpenAI
               body: T.any(
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws::OrHash,
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp::OrHash,
-                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure::OrHash
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure::OrHash,
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::OrHash
               ),
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -57,7 +59,8 @@ module OpenAI
                 body: T.any(
                   OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws,
                   OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp,
-                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure
+                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure,
+                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci
                 ),
                 request_options: OpenAI::RequestOptions
               }
@@ -73,7 +76,8 @@ module OpenAI
               T.any(
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws,
                 OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp,
-                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure,
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci
               )
             }
 
@@ -516,6 +520,135 @@ module OpenAI
               end
             end
 
+            class Oci < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The OCI Vault key OCID
+              sig { returns(String) }
+              attr_accessor :key_ocid
+
+              # A friendly name to identify this config
+              sig { returns(String) }
+              attr_accessor :name
+
+              # The OCI region containing the vault
+              sig { returns(String) }
+              attr_accessor :region
+
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # The customer OCI Vault OCID
+              sig { returns(String) }
+              attr_accessor :vault_ocid
+
+              # The exact OCI key version OCID for PSP decryption.
+              sig { returns(T.nilable(String)) }
+              attr_reader :key_version_ocid
+
+              sig { params(key_version_ocid: String).void }
+              attr_writer :key_version_ocid
+
+              sig {
+                returns(T.nilable(OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::OrSymbol))
+              }
+              attr_reader :purpose
+
+              sig {
+                params(purpose: OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::OrSymbol).void
+              }
+              attr_writer :purpose
+
+              sig do
+                params(
+
+                  key_ocid: String,
+
+                  name: String,
+
+                  region: String,
+
+                  vault_ocid: String,
+
+                  key_version_ocid: String,
+
+                  purpose: OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::OrSymbol,
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The OCI Vault key OCID
+                key_ocid:,
+
+                # A friendly name to identify this config
+                name:,
+
+                # The OCI region containing the vault
+                region:,
+
+                # The customer OCI Vault OCID
+                vault_ocid:,
+
+                # The exact OCI key version OCID for PSP decryption.
+                key_version_ocid: nil,
+
+                purpose: nil,
+
+                type: :oci
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    key_ocid: String,
+                    name: String,
+                    region: String,
+                    type: Symbol,
+                    vault_ocid: String,
+                    key_version_ocid: String,
+                    purpose: OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::OrSymbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module Purpose
+                extend OpenAI::Internal::Type::Enum
+
+                TaggedSymbol = T.type_alias {
+                  T.all(Symbol, OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose)
+                }
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                EKM = T.let(
+                  :ekm,
+                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::TaggedSymbol
+                )
+                PSP_DECRYPTION = T.let(
+                  :psp_decryption,
+                  OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::TaggedSymbol
+                )
+
+                sig {
+                  override.returns(
+                    T::Array[OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Oci::Purpose::TaggedSymbol]
+                  )
+                }
+                def self.values
+                end
+              end
+            end
+
             sig { override.returns(T::Array[OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Variants]) }
             def self.variants
             end

data/rbi/openai/models/beta/agent_output_command_execution_output_delta_event.rbi

@@ -42,6 +42,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted when command execution produces an output delta.
         sig do
           params(
@@ -58,6 +65,8 @@ module OpenAI
 
             turn_id: T.nilable(String),
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -82,6 +91,9 @@ module OpenAI
           # The ID of the turn associated with the event, when applicable.
           turn_id:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.output.command_execution_output.delta`.
 
           type: :"agent.output.command_execution_output.delta"
@@ -97,7 +109,8 @@ module OpenAI
               output_index: Integer,
               session_id: String,
               turn_id: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              obfuscation: String
             }
           )
         end

data/rbi/openai/models/beta/agent_session.rbi

@@ -69,6 +69,13 @@ module OpenAI
         sig { returns(T::Array[String]) }
         attr_accessor :vault_ids
 
+        # Default prompt cache lifetime for turns in this session, when configured.
+        sig { returns(T.nilable(OpenAI::Beta::AgentSession::PromptCacheOptions)) }
+        attr_reader :prompt_cache_options
+
+        sig { params(prompt_cache_options: T.nilable(OpenAI::Beta::AgentSession::PromptCacheOptions::OrHash)).void }
+        attr_writer :prompt_cache_options
+
         # Review applied to eligible actions in this session. Omitted when review is none
         # and automatic review is not enabled. Omission means none.
         sig { returns(T.nilable(OpenAI::Beta::AgentSession::Review::TaggedSymbol)) }
@@ -109,6 +116,7 @@ module OpenAI
 
             required_actions: T::Array[
               T.any(
+                OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::OrHash,
                 OpenAI::Beta::AgentSession::RequiredAction::ComputerUseApprovalRequest::OrHash,
                 OpenAI::Beta::AgentSession::RequiredAction::FunctionCall::OrHash,
                 OpenAI::Beta::AgentSession::RequiredAction::EnvironmentConnection::OrHash
@@ -121,6 +129,8 @@ module OpenAI
 
             vault_ids: T::Array[String],
 
+            prompt_cache_options: T.nilable(OpenAI::Beta::AgentSession::PromptCacheOptions::OrHash),
+
             review: OpenAI::Beta::AgentSession::Review::OrSymbol,
 
             spend_control: OpenAI::Beta::AgentSession::SpendControl::OrHash,
@@ -165,6 +175,9 @@ module OpenAI
           # The IDs of vaults made available to the session.
           vault_ids:,
 
+          # Default prompt cache lifetime for turns in this session, when configured.
+          prompt_cache_options: nil,
+
           # Review applied to eligible actions in this session. Omitted when review is none
           # and automatic review is not enabled. Omission means none.
           review: nil,
@@ -194,6 +207,7 @@ module OpenAI
               status: OpenAI::Beta::AgentSession::Status::TaggedSymbol,
               usage: T.nilable(OpenAI::Beta::TokenUsage),
               vault_ids: T::Array[String],
+              prompt_cache_options: T.nilable(OpenAI::Beta::AgentSession::PromptCacheOptions),
               review: OpenAI::Beta::AgentSession::Review::TaggedSymbol,
               spend_control: OpenAI::Beta::AgentSession::SpendControl
             }
@@ -468,12 +482,157 @@ module OpenAI
 
           Variants = T.type_alias {
             T.any(
+              OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest,
               OpenAI::Beta::AgentSession::RequiredAction::ComputerUseApprovalRequest,
               OpenAI::Beta::AgentSession::RequiredAction::FunctionCall,
               OpenAI::Beta::AgentSession::RequiredAction::EnvironmentConnection
             )
           }
 
+          class McpApprovalRequest < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Information for presenting an MCP approval.
+            sig { returns(OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::Request) }
+            attr_reader :request
+
+            sig {
+              params(request: OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::Request::OrHash).void
+            }
+            attr_writer :request
+
+            # The opaque approval ID to echo when responding.
+            sig { returns(String) }
+            attr_accessor :request_id
+
+            # The turn that requested approval.
+            sig { returns(String) }
+            attr_accessor :turn_id
+
+            # The type of the object. Always `mcp_approval_request`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Respond to an MCP tool-call approval request.
+            sig do
+              params(
+
+                request: OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::Request::OrHash,
+
+                request_id: String,
+
+                turn_id: String,
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Information for presenting an MCP approval.
+              request:,
+
+              # The opaque approval ID to echo when responding.
+              request_id:,
+
+              # The turn that requested approval.
+              turn_id:,
+
+              # The type of the object. Always `mcp_approval_request`.
+
+              type: :mcp_approval_request
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  request: OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::Request,
+                  request_id: String,
+                  turn_id: String,
+                  type: Symbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Request < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::AgentSession::RequiredAction::McpApprovalRequest::Request,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The tool arguments as JSON, or null when CCA does not provide them.
+              sig { returns(T.anything) }
+              attr_accessor :arguments
+
+              sig { returns(String) }
+              attr_accessor :message
+
+              # The tool name, or null when CCA does not provide it.
+              sig { returns(T.nilable(String)) }
+              attr_accessor :name
+
+              sig { returns(String) }
+              attr_accessor :server_label
+
+              # The type of the object. Always `mcp_tool_call`.
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # Information for presenting an MCP approval.
+              sig do
+                params(
+
+                  arguments: T.anything,
+
+                  message: String,
+
+                  name: T.nilable(String),
+
+                  server_label: String,
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The tool arguments as JSON, or null when CCA does not provide them.
+                arguments:,
+
+                message:,
+
+                # The tool name, or null when CCA does not provide it.
+                name:,
+
+                server_label:,
+
+                # The type of the object. Always `mcp_tool_call`.
+
+                type: :mcp_tool_call
+              )
+              end
+
+              sig do
+                override.returns(
+                  {arguments: T.anything, message: String, name: T.nilable(String), server_label: String, type: Symbol}
+                )
+              end
+              def to_hash
+              end
+
+            end
+          end
+
           class ComputerUseApprovalRequest < OpenAI::Internal::Type::BaseModel
             OrHash = T.type_alias do
               T.any(
@@ -994,6 +1153,54 @@ module OpenAI
           end
         end
 
+        class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentSession::PromptCacheOptions,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          sig { returns(OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::TaggedSymbol) }
+          attr_accessor :ttl
+
+          # Default prompt cache lifetime for turns in this session, when configured.
+          sig do
+            params(
+
+              ttl: OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::OrSymbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            ttl:
+          )
+          end
+
+          sig do
+            override.returns(
+              {ttl: OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::TaggedSymbol}
+            )
+          end
+          def to_hash
+          end
+
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(:"30m", OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::TaggedSymbol)
+            TTL_12H = T.let(:"12h", OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::Beta::AgentSession::PromptCacheOptions::Ttl::TaggedSymbol]) }
+            def self.values
+            end
+          end
+        end
+
         # Review applied to eligible actions in this session. Omitted when review is none
         # and automatic review is not enabled. Omission means none.
         module Review

data/rbi/openai/models/beta/agent_session_created_event.rbi

@@ -29,6 +29,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted when a session is created.
         sig do
           params(
@@ -37,6 +44,8 @@ module OpenAI
 
             session: OpenAI::Beta::AgentSession::OrHash,
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -49,6 +58,9 @@ module OpenAI
           # The session that was created.
           session:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.session.created`.
 
           type: :"agent.session.created"
@@ -57,7 +69,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {event_id: String, session: OpenAI::Beta::AgentSession, type: Symbol}
+            {event_id: String, session: OpenAI::Beta::AgentSession, type: Symbol, obfuscation: String}
           )
         end
         def to_hash

data/rbi/openai/models/beta/agent_session_environment_connected_event.rbi

@@ -37,6 +37,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted when a session environment connects.
         sig do
           params(
@@ -49,6 +56,8 @@ module OpenAI
 
             turn_id: T.nilable(String),
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -67,6 +76,9 @@ module OpenAI
           # The ID of the turn associated with the event, when applicable.
           turn_id:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.session.environment.connected`.
 
           type: :"agent.session.environment.connected"
@@ -80,7 +92,8 @@ module OpenAI
               event_id: String,
               session_id: String,
               turn_id: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              obfuscation: String
             }
           )
         end

data/rbi/openai/models/beta/agent_session_environment_disconnected_event.rbi

@@ -37,6 +37,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted when a session environment disconnects.
         sig do
           params(
@@ -49,6 +56,8 @@ module OpenAI
 
             turn_id: T.nilable(String),
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -67,6 +76,9 @@ module OpenAI
           # The ID of the turn associated with the event, when applicable.
           turn_id:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.session.environment.disconnected`.
 
           type: :"agent.session.environment.disconnected"
@@ -80,7 +92,8 @@ module OpenAI
               event_id: String,
               session_id: String,
               turn_id: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              obfuscation: String
             }
           )
         end

data/rbi/openai/models/beta/agent_session_environment_expired_event.rbi

@@ -37,6 +37,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted after a suspended hosted session environment and its checkpoint expire.
         sig do
           params(
@@ -49,6 +56,8 @@ module OpenAI
 
             turn_id: T.nilable(String),
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -67,6 +76,9 @@ module OpenAI
           # The ID of the turn associated with the event, when applicable.
           turn_id:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.session.environment.expired`.
 
           type: :"agent.session.environment.expired"
@@ -80,7 +92,8 @@ module OpenAI
               event_id: String,
               session_id: String,
               turn_id: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              obfuscation: String
             }
           )
         end

data/rbi/openai/models/beta/agent_session_environment_failed_event.rbi

@@ -37,6 +37,13 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        sig { returns(T.nilable(String)) }
+        attr_reader :obfuscation
+
+        sig { params(obfuscation: String).void }
+        attr_writer :obfuscation
+
         # Emitted when a session environment fails.
         sig do
           params(
@@ -49,6 +56,8 @@ module OpenAI
 
             turn_id: T.nilable(String),
 
+            obfuscation: String,
+
             type: Symbol
           )
             .returns(T.attached_class)
@@ -67,6 +76,9 @@ module OpenAI
           # The ID of the turn associated with the event, when applicable.
           turn_id:,
 
+          # Random alphanumeric padding. Present when stream obfuscation is enabled.
+          obfuscation: nil,
+
           # The type of the object. Always `agent.session.environment.failed`.
 
           type: :"agent.session.environment.failed"
@@ -80,7 +92,8 @@ module OpenAI
               event_id: String,
               session_id: String,
               turn_id: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              obfuscation: String
             }
           )
         end