openai 0.96.0 → 0.97.0

data/rbi/openai/models/beta/agent_tool_param.rbi

@@ -15,7 +15,8 @@ module OpenAI
             OpenAI::Beta::AgentToolParam::ToolSearch,
             OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
             OpenAI::Beta::AgentToolParam::Mcp,
-            OpenAI::Beta::AgentToolParam::WebSearch
+            OpenAI::Beta::AgentToolParam::WebSearch,
+            OpenAI::Beta::AgentToolParam::ComputerUse
           )
         end
 
@@ -524,6 +525,56 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentToolParam::ComputerUse,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The type of the object. Always `computer_use`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # Whether computer tool outputs include screenshots. Defaults to `false`.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :include_screenshots
+
+          sig { params(include_screenshots: T::Boolean).void }
+          attr_writer :include_screenshots
+
+          # Browser use in an OpenAI-hosted session.
+          sig do
+            params(
+
+              include_screenshots: T::Boolean,
+
+              type: Symbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Whether computer tool outputs include screenshots. Defaults to `false`.
+            include_screenshots: nil,
+
+            # The type of the object. Always `computer_use`.
+
+            type: :computer_use
+          )
+          end
+
+          sig do
+            override.returns(
+              {type: Symbol, include_screenshots: T::Boolean}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         sig { override.returns(T::Array[OpenAI::Beta::AgentToolParam::Variants]) }
         def self.variants
         end

data/rbi/openai/models/beta/agent_update_params.rbi

@@ -78,7 +78,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ToolSearch,
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp,
-                  OpenAI::Beta::PersistedAgentToolParam::WebSearch
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch,
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse
                 )
               ]
             )
@@ -114,7 +115,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ToolSearch::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
-                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash
                 )
               ]
             ),
@@ -181,7 +183,8 @@ module OpenAI
                     OpenAI::Beta::PersistedAgentToolParam::ToolSearch,
                     OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                     OpenAI::Beta::PersistedAgentToolParam::Mcp,
-                    OpenAI::Beta::PersistedAgentToolParam::WebSearch
+                    OpenAI::Beta::PersistedAgentToolParam::WebSearch,
+                    OpenAI::Beta::PersistedAgentToolParam::ComputerUse
                   )
                 ]
               ),

data/rbi/openai/models/beta/agents/environments/environment_template.rbi

@@ -70,6 +70,13 @@ module OpenAI
             sig { returns(Integer) }
             attr_accessor :updated_at
 
+            # Desktop configuration for each OpenAI-hosted environment.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop)) }
+            attr_reader :desktop
+
+            sig { params(desktop: OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop::OrHash).void }
+            attr_writer :desktop
+
             # Reusable configuration that provisions a fresh OpenAI-hosted environment for
             # each session.
             sig do
@@ -105,6 +112,8 @@ module OpenAI
 
                 updated_at: Integer,
 
+                desktop: OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop::OrHash,
+
                 object: Symbol
               )
                 .returns(T.attached_class)
@@ -141,6 +150,9 @@ module OpenAI
               # The Unix timestamp, in seconds, when the template was last updated.
               updated_at:,
 
+              # Desktop configuration for each OpenAI-hosted environment.
+              desktop: nil,
+
               # The object type. Always `agent.environment.template`.
 
               object: :"agent.environment.template"
@@ -160,7 +172,8 @@ module OpenAI
                   packages: OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Packages,
                   plugins: T::Array[OpenAI::Beta::HostedPlugin],
                   skills: T::Array[OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Skill::Variants],
-                  updated_at: Integer
+                  updated_at: Integer,
+                  desktop: OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop
                 }
               )
             end
@@ -367,7 +380,7 @@ module OpenAI
                   OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Network::Access::TaggedSymbol
                 )
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = T.let(
                   :restricted,
                   OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Network::Access::TaggedSymbol
@@ -570,6 +583,44 @@ module OpenAI
 
             end
 
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Whether the environment provisions a desktop and browser proxy.
+              sig { returns(T::Boolean) }
+              attr_accessor :enabled
+
+              # Desktop configuration for each OpenAI-hosted environment.
+              sig do
+                params(
+
+                  enabled: T::Boolean
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Whether the environment provisions a desktop and browser proxy.
+
+                enabled:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {enabled: T::Boolean}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
           end
 
         end

data/rbi/openai/models/beta/agents/environments/template_create_params.rbi

@@ -26,6 +26,16 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :capability_directories
 
+            # Desktop provisioning. Omission or null inherits the template setting, or
+            # defaults to disabled.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop)) }
+            attr_reader :desktop
+
+            sig {
+              params(desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop::OrHash)).void
+            }
+            attr_writer :desktop
+
             # Environment variables made available to the agent.
             sig { returns(T.nilable(T::Hash[Symbol, String])) }
             attr_accessor :env
@@ -95,6 +105,8 @@ module OpenAI
 
                 capability_directories: T.nilable(T::Array[String]),
 
+                desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop::OrHash),
+
                 env: T.nilable(T::Hash[Symbol, String]),
 
                 files: T.nilable(
@@ -135,6 +147,10 @@ module OpenAI
               # list.
               capability_directories: nil,
 
+              # Desktop provisioning. Omission or null inherits the template setting, or
+              # defaults to disabled.
+              desktop: nil,
+
               # Environment variables made available to the agent.
               env: nil,
 
@@ -169,6 +185,7 @@ module OpenAI
               override.returns(
                 {
                   capability_directories: T.nilable(T::Array[String]),
+                  desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop),
                   env: T.nilable(T::Hash[Symbol, String]),
                   files: T.nilable(
                     T::Array[
@@ -195,6 +212,45 @@ module OpenAI
             def to_hash
             end
 
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Whether to provision the desktop and its browser proxy.
+              sig { returns(T::Boolean) }
+              attr_accessor :enabled
+
+              # Desktop provisioning. Omission or null inherits the template setting, or
+              # defaults to disabled.
+              sig do
+                params(
+
+                  enabled: T::Boolean
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Whether to provision the desktop and its browser proxy.
+
+                enabled:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {enabled: T::Boolean}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
             class Network < OpenAI::Internal::Type::BaseModel
               OrHash = T.type_alias do
                 T.any(
@@ -211,6 +267,12 @@ module OpenAI
               sig { returns(T.nilable(T::Array[String])) }
               attr_accessor :allowed_domains
 
+              # Domains blocked for both executor and browser when access is restricted. A
+              # nonempty list requires `access: restricted` and cannot be combined with nonempty
+              # `allowed_domains`. Wildcard domains are not supported.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_accessor :blocked_domains
+
               # Network access policy for the environment. Defaults to disabled for GA requests
               # and enabled for beta requests.
               sig do
@@ -218,7 +280,9 @@ module OpenAI
 
                   access: OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network::Access::OrSymbol,
 
-                  allowed_domains: T.nilable(T::Array[String])
+                  allowed_domains: T.nilable(T::Array[String]),
+
+                  blocked_domains: T.nilable(T::Array[String])
                 )
                   .returns(T.attached_class)
               end
@@ -228,8 +292,13 @@ module OpenAI
                 access:,
 
                 # Domains the environment may access when network access is restricted.
+                allowed_domains: nil,
+
+                # Domains blocked for both executor and browser when access is restricted. A
+                # nonempty list requires `access: restricted` and cannot be combined with nonempty
+                # `allowed_domains`. Wildcard domains are not supported.
 
-                allowed_domains: nil
+                blocked_domains: nil
               )
               end
 
@@ -237,7 +306,8 @@ module OpenAI
                 override.returns(
                   {
                     access: OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network::Access::OrSymbol,
-                    allowed_domains: T.nilable(T::Array[String])
+                    allowed_domains: T.nilable(T::Array[String]),
+                    blocked_domains: T.nilable(T::Array[String])
                   }
                 )
               end
@@ -265,7 +335,7 @@ module OpenAI
                   OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network::Access::TaggedSymbol
                 )
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = T.let(
                   :restricted,
                   OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network::Access::TaggedSymbol

data/rbi/openai/models/beta/agents/environments/template_update_params.rbi

@@ -28,6 +28,15 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :capability_directories
 
+            # Replacement desktop configuration, or null to disable the desktop.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop)) }
+            attr_reader :desktop
+
+            sig {
+              params(desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop::OrHash)).void
+            }
+            attr_writer :desktop
+
             # Replacement confidential environment values.
             sig { returns(T.nilable(T::Hash[Symbol, String])) }
             attr_accessor :env
@@ -99,6 +108,8 @@ module OpenAI
 
                 capability_directories: T.nilable(T::Array[String]),
 
+                desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop::OrHash),
+
                 env: T.nilable(T::Hash[Symbol, String]),
 
                 files: T.nilable(
@@ -140,6 +151,9 @@ module OpenAI
               # Directories that expose capabilities to the agent.
               capability_directories: nil,
 
+              # Replacement desktop configuration, or null to disable the desktop.
+              desktop: nil,
+
               # Replacement confidential environment values.
               env: nil,
 
@@ -175,6 +189,7 @@ module OpenAI
                 {
                   environment_template_id: String,
                   capability_directories: T.nilable(T::Array[String]),
+                  desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop),
                   env: T.nilable(T::Hash[Symbol, String]),
                   files: T.nilable(
                     T::Array[
@@ -201,6 +216,44 @@ module OpenAI
             def to_hash
             end
 
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Whether to provision the desktop and its browser proxy.
+              sig { returns(T::Boolean) }
+              attr_accessor :enabled
+
+              # Replacement desktop configuration, or null to disable the desktop.
+              sig do
+                params(
+
+                  enabled: T::Boolean
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Whether to provision the desktop and its browser proxy.
+
+                enabled:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {enabled: T::Boolean}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
             class Network < OpenAI::Internal::Type::BaseModel
               OrHash = T.type_alias do
                 T.any(
@@ -217,6 +270,12 @@ module OpenAI
               sig { returns(T.nilable(T::Array[String])) }
               attr_accessor :allowed_domains
 
+              # Domains blocked for both executor and browser when access is restricted. A
+              # nonempty list requires `access: restricted` and cannot be combined with nonempty
+              # `allowed_domains`. Wildcard domains are not supported.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_accessor :blocked_domains
+
               # Network access available after setup completes. Omit to preserve the current
               # policy, or pass `null` to reset to disabled for GA requests or enabled for beta
               # requests.
@@ -225,7 +284,9 @@ module OpenAI
 
                   access: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network::Access::OrSymbol,
 
-                  allowed_domains: T.nilable(T::Array[String])
+                  allowed_domains: T.nilable(T::Array[String]),
+
+                  blocked_domains: T.nilable(T::Array[String])
                 )
                   .returns(T.attached_class)
               end
@@ -235,8 +296,13 @@ module OpenAI
                 access:,
 
                 # Domains the environment may access when network access is restricted.
+                allowed_domains: nil,
+
+                # Domains blocked for both executor and browser when access is restricted. A
+                # nonempty list requires `access: restricted` and cannot be combined with nonempty
+                # `allowed_domains`. Wildcard domains are not supported.
 
-                allowed_domains: nil
+                blocked_domains: nil
               )
               end
 
@@ -244,7 +310,8 @@ module OpenAI
                 override.returns(
                   {
                     access: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network::Access::OrSymbol,
-                    allowed_domains: T.nilable(T::Array[String])
+                    allowed_domains: T.nilable(T::Array[String]),
+                    blocked_domains: T.nilable(T::Array[String])
                   }
                 )
               end
@@ -272,7 +339,7 @@ module OpenAI
                   OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network::Access::TaggedSymbol
                 )
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = T.let(
                   :restricted,
                   OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network::Access::TaggedSymbol

data/rbi/openai/models/beta/agents/session_create_params.rbi

@@ -192,7 +192,8 @@ module OpenAI
                       OpenAI::Beta::AgentToolParam::ToolSearch,
                       OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
                       OpenAI::Beta::AgentToolParam::Mcp,
-                      OpenAI::Beta::AgentToolParam::WebSearch
+                      OpenAI::Beta::AgentToolParam::WebSearch,
+                      OpenAI::Beta::AgentToolParam::ComputerUse
                     )
                   ]
                 )
@@ -224,7 +225,8 @@ module OpenAI
                       OpenAI::Beta::AgentToolParam::ToolSearch::OrHash,
                       OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling::OrHash,
                       OpenAI::Beta::AgentToolParam::Mcp::OrHash,
-                      OpenAI::Beta::AgentToolParam::WebSearch::OrHash
+                      OpenAI::Beta::AgentToolParam::WebSearch::OrHash,
+                      OpenAI::Beta::AgentToolParam::ComputerUse::OrHash
                     )
                   ]
                 )
@@ -275,7 +277,8 @@ module OpenAI
                         OpenAI::Beta::AgentToolParam::ToolSearch,
                         OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
                         OpenAI::Beta::AgentToolParam::Mcp,
-                        OpenAI::Beta::AgentToolParam::WebSearch
+                        OpenAI::Beta::AgentToolParam::WebSearch,
+                        OpenAI::Beta::AgentToolParam::ComputerUse
                       )
                     ]
                   )

data/rbi/openai/models/beta/agents/sessions/event_create_params.rbi

@@ -29,6 +29,7 @@ module OpenAI
               returns(
                 T::Array[
                   T.any(
+                    OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputToolResult
@@ -51,6 +52,7 @@ module OpenAI
 
                 events: T::Array[
                   T.any(
+                    OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputToolResult::OrHash
@@ -82,6 +84,7 @@ module OpenAI
                   session_id: String,
                   events: T::Array[
                     T.any(
+                      OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputToolResult

data/rbi/openai/models/beta/environment.rbi

@@ -102,6 +102,13 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # The effective desktop configuration.
+          sig { returns(T.nilable(OpenAI::Beta::Environment::OpenAIHosted::Desktop)) }
+          attr_reader :desktop
+
+          sig { params(desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop::OrHash).void }
+          attr_writer :desktop
+
           # An environment hosted by OpenAI.
           sig do
             params(
@@ -127,6 +134,8 @@ module OpenAI
                 T.any(OpenAI::Beta::HostedSkillReference::OrHash, OpenAI::Beta::HostedSkill::Inline::OrHash)
               ],
 
+              desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop::OrHash,
+
               type: Symbol
             )
               .returns(T.attached_class)
@@ -154,6 +163,9 @@ module OpenAI
             # Skills installed in the environment, excluding their archive contents.
             skills:,
 
+            # The effective desktop configuration.
+            desktop: nil,
+
             # The type of the object. Always `openai_hosted`.
 
             type: :openai_hosted
@@ -170,7 +182,8 @@ module OpenAI
                 packages: OpenAI::Beta::Environment::OpenAIHosted::Packages,
                 plugins: T::Array[OpenAI::Beta::HostedPlugin],
                 skills: T::Array[OpenAI::Beta::HostedSkill::Variants],
-                type: Symbol
+                type: Symbol,
+                desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop
               }
             )
           end
@@ -238,7 +251,7 @@ module OpenAI
               # Disables network access.
               DISABLED = T.let(:disabled, OpenAI::Beta::Environment::OpenAIHosted::Network::Access::TaggedSymbol)
 
-              # Allows access only to configured domains.
+              # Applies the configured domain restrictions.
               RESTRICTED = T.let(:restricted, OpenAI::Beta::Environment::OpenAIHosted::Network::Access::TaggedSymbol)
 
               sig {
@@ -304,6 +317,44 @@ module OpenAI
             end
 
           end
+
+          class Desktop < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Environment::OpenAIHosted::Desktop,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Whether the environment provisions a desktop and browser proxy.
+            sig { returns(T::Boolean) }
+            attr_accessor :enabled
+
+            # The effective desktop configuration.
+            sig do
+              params(
+
+                enabled: T::Boolean
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Whether the environment provisions a desktop and browser proxy.
+
+              enabled:
+            )
+            end
+
+            sig do
+              override.returns(
+                {enabled: T::Boolean}
+              )
+            end
+            def to_hash
+            end
+
+          end
         end
 
         class SelfHosted < OpenAI::Internal::Type::BaseModel