openai 0.92.0 → 0.93.0

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

@@ -0,0 +1,110 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        class ExternalStorageListParams < OpenAI::Internal::Type::BaseModel
+
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Admin::Organization::ExternalStorageListParams,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Return external storage configurations after this ID.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :after
+
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :limit
+
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          sig { returns(T.nilable(OpenAI::Admin::Organization::ExternalStorageListParams::Order::OrSymbol)) }
+          attr_reader :order
+
+          sig { params(order: OpenAI::Admin::Organization::ExternalStorageListParams::Order::OrSymbol).void }
+          attr_writer :order
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :project_id
+
+          sig do
+            params(
+
+              after: T.nilable(String),
+
+              limit: Integer,
+
+              order: OpenAI::Admin::Organization::ExternalStorageListParams::Order::OrSymbol,
+
+              project_id: T.nilable(String),
+
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Return external storage configurations after this ID.
+            after: nil,
+
+            limit: nil,
+
+            order: nil,
+
+            project_id: nil,
+
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                after: T.nilable(String),
+                limit: Integer,
+                order: OpenAI::Admin::Organization::ExternalStorageListParams::Order::OrSymbol,
+                project_id: T.nilable(String),
+                request_options: OpenAI::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Order
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Admin::Organization::ExternalStorageListParams::Order)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ASC = T.let(:asc, OpenAI::Admin::Organization::ExternalStorageListParams::Order::TaggedSymbol)
+            DESC = T.let(:desc, OpenAI::Admin::Organization::ExternalStorageListParams::Order::TaggedSymbol)
+
+            sig {
+              override.returns(T::Array[OpenAI::Admin::Organization::ExternalStorageListParams::Order::TaggedSymbol])
+            }
+            def self.values
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

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

@@ -0,0 +1,57 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        class ExternalStorageRetrieveParams < OpenAI::Internal::Type::BaseModel
+
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Admin::Organization::ExternalStorageRetrieveParams,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          sig { returns(String) }
+          attr_accessor :external_storage_id
+
+          sig do
+            params(
+
+              external_storage_id: String,
+
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            external_storage_id:,
+
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {external_storage_id: String, request_options: OpenAI::RequestOptions}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

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

@@ -0,0 +1,57 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Admin
+
+      module Organization
+
+        class ExternalStorageValidateParams < OpenAI::Internal::Type::BaseModel
+
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Admin::Organization::ExternalStorageValidateParams,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          sig { returns(String) }
+          attr_accessor :external_storage_id
+
+          sig do
+            params(
+
+              external_storage_id: String,
+
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            external_storage_id:,
+
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {external_storage_id: String, request_options: OpenAI::RequestOptions}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agent_create_params.rbi

@@ -31,7 +31,8 @@ module OpenAI
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
-        # Explicit configuration for creating and coordinating subagents.
+        # Configuration for creating and coordinating subagents. Subagent tools are
+        # disabled by default.
         sig { returns(T.nilable(OpenAI::Beta::MultiAgentConfigParam)) }
         attr_reader :multi_agent
 
@@ -42,18 +43,19 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :name
 
-        # Reasoning configuration for the agent.
+        # Configuration for model reasoning. Omission uses the model's default effort.
         sig { returns(T.nilable(OpenAI::Beta::AgentReasoningParam)) }
         attr_reader :reasoning
 
         sig { params(reasoning: T.nilable(OpenAI::Beta::AgentReasoningParam::OrHash)).void }
         attr_writer :reasoning
 
-        # The service tier used for model requests.
+        # The service tier used for model requests. Defaults to `auto`.
         sig { returns(T.nilable(OpenAI::Beta::AgentCreateParams::ServiceTier::OrSymbol)) }
         attr_accessor :service_tier
 
-        # Configuration for text generated by the agent.
+        # Configuration for generated text. Defaults to the `text` format and medium
+        # verbosity.
         sig { returns(T.nilable(OpenAI::Beta::AgentTextParam)) }
         attr_reader :text
 
@@ -126,19 +128,21 @@ module OpenAI
           # characters. Omission or null defaults to an empty map.
           metadata: nil,
 
-          # Explicit configuration for creating and coordinating subagents.
+          # Configuration for creating and coordinating subagents. Subagent tools are
+          # disabled by default.
           multi_agent: nil,
 
           # A human-readable name for the agent. Omission or null leaves the agent unnamed.
           name: nil,
 
-          # Reasoning configuration for the agent.
+          # Configuration for model reasoning. Omission uses the model's default effort.
           reasoning: nil,
 
-          # The service tier used for model requests.
+          # The service tier used for model requests. Defaults to `auto`.
           service_tier: nil,
 
-          # Configuration for text generated by the agent.
+          # Configuration for generated text. Defaults to the `text` format and medium
+          # verbosity.
           text: nil,
 
           # Tools available to the agent. Defaults to an empty list.
@@ -177,7 +181,7 @@ module OpenAI
         def to_hash
         end
 
-        # The service tier used for model requests.
+        # The service tier used for model requests. Defaults to `auto`.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/agent_reasoning.rbi

@@ -14,11 +14,12 @@ module OpenAI
           )
         end
 
-        # The amount of reasoning effort used by an agent.
+        # The requested reasoning effort, or `null` when the model selects its own
+        # default.
         sig { returns(T.nilable(OpenAI::Beta::AgentReasoning::Effort::TaggedSymbol)) }
         attr_accessor :effort
 
-        # The reasoning summary format requested from an agent.
+        # The requested reasoning summary format, or `null` when summaries are disabled.
         sig { returns(T.nilable(OpenAI::Beta::AgentReasoning::Summary::TaggedSymbol)) }
         attr_accessor :summary
 
@@ -34,10 +35,11 @@ module OpenAI
         end
         def self.new(
 
-          # The amount of reasoning effort used by an agent.
+          # The requested reasoning effort, or `null` when the model selects its own
+          # default.
           effort:,
 
-          # The reasoning summary format requested from an agent.
+          # The requested reasoning summary format, or `null` when summaries are disabled.
 
           summary:
         )
@@ -54,7 +56,8 @@ module OpenAI
         def to_hash
         end
 
-        # The amount of reasoning effort used by an agent.
+        # The requested reasoning effort, or `null` when the model selects its own
+        # default.
         module Effort
           extend OpenAI::Internal::Type::Enum
 
@@ -74,7 +77,7 @@ module OpenAI
           end
         end
 
-        # The reasoning summary format requested from an agent.
+        # The requested reasoning summary format, or `null` when summaries are disabled.
         module Summary
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/agent_reasoning_item.rbi

@@ -18,7 +18,7 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :id
 
-        # The status of an agent output item.
+        # The status of the reasoning item.
         sig { returns(T.nilable(OpenAI::Beta::AgentOutputItemStatus::TaggedSymbol)) }
         attr_accessor :status
 
@@ -55,7 +55,7 @@ module OpenAI
           # The ID of the reasoning item.
           id:,
 
-          # The status of an agent output item.
+          # The status of the reasoning item.
           status:,
 
           # The reasoning summaries produced by the agent.

data/rbi/openai/models/beta/agent_reasoning_param.rbi

@@ -14,11 +14,12 @@ module OpenAI
           )
         end
 
-        # The amount of reasoning effort the model should use.
+        # The amount of reasoning effort the model should use. Omission lets the model
+        # select it.
         sig { returns(T.nilable(OpenAI::Beta::AgentReasoningParam::Effort::OrSymbol)) }
         attr_accessor :effort
 
-        # The reasoning summary format requested from the model.
+        # Controls whether the response includes a reasoning summary.
         sig { returns(T.nilable(OpenAI::Beta::AgentReasoningParam::Summary::OrSymbol)) }
         attr_accessor :summary
 
@@ -34,10 +35,11 @@ module OpenAI
         end
         def self.new(
 
-          # The amount of reasoning effort the model should use.
+          # The amount of reasoning effort the model should use. Omission lets the model
+          # select it.
           effort: nil,
 
-          # The reasoning summary format requested from the model.
+          # Controls whether the response includes a reasoning summary.
 
           summary: nil
         )
@@ -54,7 +56,8 @@ module OpenAI
         def to_hash
         end
 
-        # The amount of reasoning effort the model should use.
+        # The amount of reasoning effort the model should use. Omission lets the model
+        # select it.
         module Effort
           extend OpenAI::Internal::Type::Enum
 
@@ -74,7 +77,7 @@ module OpenAI
           end
         end
 
-        # The reasoning summary format requested from the model.
+        # Controls whether the response includes a reasoning summary.
         module Summary
           extend OpenAI::Internal::Type::Enum
 

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

@@ -57,7 +57,8 @@ module OpenAI
         sig { returns(OpenAI::Beta::AgentSession::Status::TaggedSymbol) }
         attr_accessor :status
 
-        # Recorded token usage for a session or turn. Usage is best effort and may change.
+        # Best-effort token usage for the session, or null if unknown. Recorded usage may
+        # change.
         sig { returns(T.nilable(OpenAI::Beta::TokenUsage)) }
         attr_reader :usage
 
@@ -136,7 +137,8 @@ module OpenAI
           # The current status of the session.
           status:,
 
-          # Recorded token usage for a session or turn. Usage is best effort and may change.
+          # Best-effort token usage for the session, or null if unknown. Recorded usage may
+          # change.
           usage:,
 
           # The IDs of vaults made available to the session.

data/rbi/openai/models/beta/agent_session_assistant_message.rbi

@@ -22,7 +22,7 @@ module OpenAI
         sig { returns(T::Array[OpenAI::Beta::OutputText]) }
         attr_accessor :content
 
-        # The phase of an assistant message.
+        # The phase of the assistant message.
         sig { returns(T.nilable(OpenAI::Beta::AgentSessionAssistantMessage::Phase::TaggedSymbol)) }
         attr_accessor :phase
 
@@ -70,7 +70,7 @@ module OpenAI
           # The content of the message.
           content:,
 
-          # The phase of an assistant message.
+          # The phase of the assistant message.
           phase:,
 
           # The status of the message.
@@ -104,7 +104,7 @@ module OpenAI
         def to_hash
         end
 
-        # The phase of an assistant message.
+        # The phase of the assistant message.
         module Phase
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/agent_session_environment_reset_event.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentSessionEnvironmentResetEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentSessionEnvironmentResetEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The stable environment ID, retained across sandbox replacements.
+        sig { returns(String) }
+        attr_accessor :environment_id
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :event_id
+
+        # Monotonically increasing reset number. Repeated notifications share this number.
+        sig { returns(Integer) }
+        attr_accessor :reset_count
+
+        # The ID of the session associated with the event.
+        sig { returns(String) }
+        attr_accessor :session_id
+
+        # The associated turn, when applicable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :turn_id
+
+        # The type of the object. Always `agent.session.environment.reset`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted after a hosted sandbox is replaced. Conversation history survives;
+        # changes to the previous sandbox's files and processes do not.
+        sig do
+          params(
+
+            environment_id: String,
+
+            event_id: String,
+
+            reset_count: Integer,
+
+            session_id: String,
+
+            turn_id: T.nilable(String),
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The stable environment ID, retained across sandbox replacements.
+          environment_id:,
+
+          # The unique ID of the event.
+          event_id:,
+
+          # Monotonically increasing reset number. Repeated notifications share this number.
+          reset_count:,
+
+          # The ID of the session associated with the event.
+          session_id:,
+
+          # The associated turn, when applicable.
+          turn_id:,
+
+          # The type of the object. Always `agent.session.environment.reset`.
+
+          type: :"agent.session.environment.reset"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              environment_id: String,
+              event_id: String,
+              reset_count: Integer,
+              session_id: String,
+              turn_id: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agent_session_environment_state.rbi

@@ -18,7 +18,7 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :id
 
-        # An error reported while preparing a session environment.
+        # The error reported while preparing the environment, if any.
         sig { returns(T.nilable(OpenAI::Beta::AgentSessionEnvironmentState::Error)) }
         attr_reader :error
 
@@ -52,7 +52,7 @@ module OpenAI
           # The public ID of the environment.
           id:,
 
-          # An error reported while preparing a session environment.
+          # The error reported while preparing the environment, if any.
           error:,
 
           # The environment's connection status.
@@ -97,7 +97,7 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :type
 
-          # An error reported while preparing a session environment.
+          # The error reported while preparing the environment, if any.
           sig do
             params(
 

data/rbi/openai/models/beta/agent_session_event.rbi

@@ -13,6 +13,7 @@ module OpenAI
           T.any(
             OpenAI::Beta::AgentSessionErrorEvent,
             OpenAI::Beta::AgentSessionEnvironmentReadyEvent,
+            OpenAI::Beta::AgentSessionEnvironmentResetEvent,
             OpenAI::Beta::AgentOutputCommandExecutionOutputDeltaEvent,
             OpenAI::Beta::AgentSessionCreatedEvent,
             OpenAI::Beta::AgentSessionTurnCreatedEvent,

data/rbi/openai/models/beta/agent_session_input_param.rbi

@@ -130,7 +130,7 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :error
 
-          # A function result represented as text or supported model-input content.
+          # The function result when the call succeeded.
           sig {
             returns(
               T.nilable(
@@ -187,7 +187,7 @@ module OpenAI
             # The error message when the call failed.
             error: nil,
 
-            # A function result represented as text or supported model-input content.
+            # The function result when the call succeeded.
             output: nil,
 
             # The type of the object. Always `agent.session.input.tool_result`.

data/rbi/openai/models/beta/agent_session_item.rbi

@@ -48,7 +48,7 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :error
 
-          # The text or model-input content supplied as a function result.
+          # The function result, if the call succeeded.
           sig { returns(T.nilable(OpenAI::Beta::AgentFunctionCallOutput::Variants)) }
           attr_accessor :output
 
@@ -102,7 +102,7 @@ module OpenAI
             # The error message, if the call failed.
             error:,
 
-            # The text or model-input content supplied as a function result.
+            # The function result, if the call succeeded.
             output:,
 
             # The status of the function call.

data/rbi/openai/models/beta/agent_session_message.rbi

@@ -23,7 +23,7 @@ module OpenAI
         sig { returns(T::Array[OpenAI::Beta::AgentSessionMessageContent::Variants]) }
         attr_accessor :content
 
-        # The phase of an assistant message.
+        # The phase of an assistant message. Null for user messages.
         sig { returns(T.nilable(OpenAI::Beta::AgentSessionMessage::Phase::TaggedSymbol)) }
         attr_accessor :phase
 
@@ -78,7 +78,7 @@ module OpenAI
           # assistant messages contain output text.
           content:,
 
-          # The phase of an assistant message.
+          # The phase of an assistant message. Null for user messages.
           phase:,
 
           # The role of the message author.
@@ -112,7 +112,7 @@ module OpenAI
         def to_hash
         end
 
-        # The phase of an assistant message.
+        # The phase of an assistant message. Null for user messages.
         module Phase
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/agent_session_turn_cancelled_event.rbi

@@ -37,7 +37,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # Recorded token usage for a session or turn. Usage is best effort and may change.
+        # Token usage by the root agent during the turn, when available.
         sig { returns(T.nilable(OpenAI::Beta::TokenUsage)) }
         attr_reader :usage
 
@@ -76,7 +76,7 @@ module OpenAI
           # The ID of the turn associated with the event.
           turn_id:,
 
-          # Recorded token usage for a session or turn. Usage is best effort and may change.
+          # Token usage by the root agent during the turn, when available.
           usage:,
 
           # The type of the object. Always `agent.session.turn.cancelled`.