openai 0.96.0 → 0.97.0

data/rbi/openai/models/beta/environment_param.rbi

@@ -72,6 +72,14 @@ 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::EnvironmentParam::OpenAIHosted::Desktop)) }
+          attr_reader :desktop
+
+          sig { params(desktop: T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop::OrHash)).void }
+          attr_writer :desktop
+
           # Environment variables made available to the agent.
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :env
@@ -140,6 +148,8 @@ module OpenAI
 
               capability_directories: T.nilable(T::Array[String]),
 
+              desktop: T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop::OrHash),
+
               env: T.nilable(T::Hash[Symbol, String]),
 
               environment_template_id: String,
@@ -180,6 +190,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,
 
@@ -218,6 +232,7 @@ module OpenAI
               {
                 type: Symbol,
                 capability_directories: T.nilable(T::Array[String]),
+                desktop: T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop),
                 env: T.nilable(T::Hash[Symbol, String]),
                 environment_template_id: String,
                 files: T.nilable(
@@ -243,6 +258,45 @@ module OpenAI
           def to_hash
           end
 
+          class Desktop < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::EnvironmentParam::OpenAIHosted::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(
@@ -259,6 +313,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
@@ -266,7 +326,9 @@ module OpenAI
 
                 access: OpenAI::Beta::EnvironmentParam::OpenAIHosted::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
@@ -276,8 +338,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
 
@@ -285,7 +352,8 @@ module OpenAI
               override.returns(
                 {
                   access: OpenAI::Beta::EnvironmentParam::OpenAIHosted::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
@@ -307,7 +375,7 @@ module OpenAI
               # Disables network access.
               DISABLED = T.let(:disabled, OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network::Access::TaggedSymbol)
 
-              # Allows access only to configured domains.
+              # Applies the configured domain restrictions.
               RESTRICTED = T.let(
                 :restricted,
                 OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network::Access::TaggedSymbol

data/rbi/openai/models/beta/persisted_agent_tool.rbi

@@ -15,7 +15,8 @@ module OpenAI
             OpenAI::Beta::PersistedAgentTool::ToolSearch,
             OpenAI::Beta::PersistedAgentTool::ProgrammaticToolCalling,
             OpenAI::Beta::PersistedAgentTool::Mcp,
-            OpenAI::Beta::PersistedAgentTool::WebSearch
+            OpenAI::Beta::PersistedAgentTool::WebSearch,
+            OpenAI::Beta::PersistedAgentTool::ComputerUse
           )
         end
 
@@ -495,6 +496,53 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::PersistedAgentTool::ComputerUse,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Whether computer tool outputs include screenshots.
+          sig { returns(T::Boolean) }
+          attr_accessor :include_screenshots
+
+          # The type of the object. Always `computer_use`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # 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.
+            include_screenshots:,
+
+            # The type of the object. Always `computer_use`.
+
+            type: :computer_use
+          )
+          end
+
+          sig do
+            override.returns(
+              {include_screenshots: T::Boolean, type: Symbol}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         sig { override.returns(T::Array[OpenAI::Beta::PersistedAgentTool::Variants]) }
         def self.variants
         end

data/rbi/openai/models/beta/persisted_agent_tool_param.rbi

@@ -15,7 +15,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
           )
         end
 
@@ -534,6 +535,56 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::PersistedAgentToolParam::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::PersistedAgentToolParam::Variants]) }
         def self.variants
         end

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

@@ -17,6 +17,7 @@ module OpenAI
             sig {
               params(
                 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(
                   T::Array[
@@ -47,6 +48,9 @@ module OpenAI
               # Directories that contain capabilities exposed to the agent. Defaults to an empty
               # 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,
               # Files available before the agent starts. Defaults to an empty list.
@@ -91,6 +95,7 @@ module OpenAI
               params(
                 environment_template_id: String,
                 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(
                   T::Array[
@@ -122,6 +127,8 @@ module OpenAI
               environment_template_id,
               # 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,
               # Replacement file configuration materialized for each new session.

data/rbi/openai/resources/beta/agents/sessions/events.rbi

@@ -22,6 +22,7 @@ module OpenAI
                 session_id: String,
                 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

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

@@ -35,7 +35,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
                 )
               ]
             ),
@@ -100,7 +101,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
                 )
               ]
             ),

data/sig/openai/models/beta/agent_browser_authentication_cancel_param.rbs

@@ -0,0 +1,21 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_browser_authentication_cancel_param =
+        { ?action: :cancel, ?type: :browser_authentication }
+
+      class AgentBrowserAuthenticationCancelParam < OpenAI::Internal::Type::BaseModel
+        attr_accessor action: :cancel
+
+        attr_accessor type: :browser_authentication
+
+        def initialize: (
+          ?action: :cancel,
+          ?type: :browser_authentication
+        ) -> void
+
+        def to_hash: -> { ?action: :cancel, ?type: :browser_authentication }
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_browser_authentication_submit_param.rbs

@@ -0,0 +1,63 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_browser_authentication_submit_param =
+        {
+          ?action: :submit,
+          fields: ::Array[OpenAI::Beta::AgentBrowserAuthenticationSubmitParam::Field],
+          ?type: :browser_authentication,
+          ?selected_option: String?
+        }
+
+      class AgentBrowserAuthenticationSubmitParam < OpenAI::Internal::Type::BaseModel
+        attr_accessor action: :submit
+
+        # Values for up to six active fields in the required action. The submitted
+        # field-value mapping and selected option must fit within 120 KiB of JSON.
+        attr_accessor fields: ::Array[OpenAI::Beta::AgentBrowserAuthenticationSubmitParam::Field]
+
+        attr_accessor type: :browser_authentication
+
+        # The chosen method. Required when the required action contains options.
+        attr_accessor selected_option: String?
+
+        # @param fields
+        #   Values for up to six active fields in the required action. The submitted
+        #   field-value mapping and selected option must fit within 120 KiB of JSON.
+        # @param selected_option
+        #   The chosen method. Required when the required action contains options.
+        def initialize: (
+          fields: ::Array[OpenAI::Beta::AgentBrowserAuthenticationSubmitParam::Field],
+          ?selected_option: String?,
+          ?action: :submit,
+          ?type: :browser_authentication
+        ) -> void
+
+        def to_hash: -> {
+          ?action: :submit,
+          fields: ::Array[OpenAI::Beta::AgentBrowserAuthenticationSubmitParam::Field],
+          ?type: :browser_authentication,
+          ?selected_option: String?
+        }
+
+        type field = { field_id: String, value: String }
+
+        class Field < OpenAI::Internal::Type::BaseModel
+          # The field ID from the required action.
+          attr_accessor field_id: String
+
+          # The value to enter into the registered control.
+          attr_accessor value: String
+
+          # @param field_id
+          #   The field ID from the required action.
+          # @param value
+          #   The value to enter into the registered control.
+          def initialize: (field_id: String, value: String) -> void
+
+          def to_hash: -> { field_id: String, value: String }
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_browser_origin_access_param.rbs

@@ -0,0 +1,47 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_browser_origin_access_param =
+        {
+          decision: OpenAI::Models::Beta::AgentBrowserOriginAccessParam::decision,
+          ?type: :browser_origin_access
+        }
+
+      class AgentBrowserOriginAccessParam < OpenAI::Internal::Type::BaseModel
+        # Whether to allow, deny, or cancel the requested origin access.
+        attr_accessor decision: OpenAI::Models::Beta::AgentBrowserOriginAccessParam::decision
+
+        attr_accessor type: :browser_origin_access
+
+        # @param decision
+        #   Whether to allow, deny, or cancel the requested origin access.
+        def initialize: (
+          decision: OpenAI::Models::Beta::AgentBrowserOriginAccessParam::decision,
+          ?type: :browser_origin_access
+        ) -> void
+
+        def to_hash: -> {
+          decision: OpenAI::Models::Beta::AgentBrowserOriginAccessParam::decision,
+          ?type: :browser_origin_access
+        }
+
+        type decision = :approve | :deny | :cancel
+
+        module Decision
+          extend OpenAI::Internal::Type::Enum
+
+          # Allow the browser to access this origin.
+          APPROVE: :approve
+
+          # Deny access to this origin.
+          DENY: :deny
+
+          # Dismiss this request without approving access.
+          CANCEL: :cancel
+
+          def self?.values: -> ::Array[OpenAI::Models::Beta::AgentBrowserOriginAccessParam::decision]
+        end
+      end
+    end
+  end
+end