openai 0.95.0 → 0.97.0

data/sig/openai/models/beta/agents/environments/template_update_params.rbs

@@ -7,6 +7,7 @@ module OpenAI
             {
               environment_template_id: String,
               ?capability_directories: ::Array[String]?,
+              ?desktop: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop?,
               ?env: ::Hash[Symbol, String]?,
               ?files: ::Array[OpenAI::Models::Beta::hosted_environment_file_param]?,
               ?name: String?,
@@ -27,6 +28,9 @@ module OpenAI
             # Directories that expose capabilities to the agent.
             attr_accessor capability_directories: ::Array[String]?
 
+            # Replacement desktop configuration, or null to disable the desktop.
+            attr_accessor desktop: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop?
+
             # Replacement confidential environment values.
             attr_accessor env: ::Hash[Symbol, String]?
 
@@ -37,8 +41,8 @@ module OpenAI
             attr_accessor name: String?
 
             # 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
-            # alpha/beta requests.
+            # policy, or pass `null` to reset to disabled for GA requests or enabled for beta
+            # requests.
             attr_accessor network: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network?
 
             # Packages installed before the runtime network policy applies.
@@ -55,6 +59,8 @@ module OpenAI
 
             # @param capability_directories
             #   Directories that expose capabilities to the agent.
+            # @param desktop
+            #   Replacement desktop configuration, or null to disable the desktop.
             # @param env
             #   Replacement confidential environment values.
             # @param files
@@ -63,8 +69,8 @@ module OpenAI
             #   A replacement human-readable display name, or `null` to clear the name.
             # @param network
             #   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
-            #   alpha/beta requests.
+            #   policy, or pass `null` to reset to disabled for GA requests or enabled for beta
+            #   requests.
             # @param packages
             #   Packages installed before the runtime network policy applies.
             # @param plugins
@@ -76,6 +82,7 @@ module OpenAI
             def initialize: (
               environment_template_id: String,
               ?capability_directories: ::Array[String]?,
+              ?desktop: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop?,
               ?env: ::Hash[Symbol, String]?,
               ?files: ::Array[OpenAI::Models::Beta::hosted_environment_file_param]?,
               ?name: String?,
@@ -90,6 +97,7 @@ module OpenAI
             def to_hash: -> {
               environment_template_id: String,
               ?capability_directories: ::Array[String]?,
+              ?desktop: OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop?,
               ?env: ::Hash[Symbol, String]?,
               ?files: ::Array[OpenAI::Models::Beta::hosted_environment_file_param]?,
               ?name: String?,
@@ -101,10 +109,24 @@ module OpenAI
               ?request_options: OpenAI::RequestOptions
             }
 
+            type desktop = { enabled: bool }
+
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              # Whether to provision the desktop and its browser proxy.
+              attr_accessor enabled: bool
+
+              # @param enabled
+              #   Whether to provision the desktop and its browser proxy.
+              def initialize: (enabled: bool) -> void
+
+              def to_hash: -> { enabled: bool }
+            end
+
             type network =
               {
                 access: OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network::access,
-                ?allowed_domains: ::Array[String]?
+                ?allowed_domains: ::Array[String]?,
+                ?blocked_domains: ::Array[String]?
               }
 
             class Network < OpenAI::Internal::Type::BaseModel
@@ -114,18 +136,29 @@ module OpenAI
               # Domains the environment may access when network access is restricted.
               attr_accessor allowed_domains: ::Array[String]?
 
+              # 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.
+              attr_accessor blocked_domains: ::Array[String]?
+
               # @param access
               #   The environment's network access mode.
               # @param allowed_domains
               #   Domains the environment may access when network access is restricted.
+              # @param blocked_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.
               def initialize: (
                 access: OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network::access,
-                ?allowed_domains: ::Array[String]?
+                ?allowed_domains: ::Array[String]?,
+                ?blocked_domains: ::Array[String]?
               ) -> void
 
               def to_hash: -> {
                 access: OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network::access,
-                ?allowed_domains: ::Array[String]?
+                ?allowed_domains: ::Array[String]?,
+                ?blocked_domains: ::Array[String]?
               }
 
               type access = :enabled | :disabled | :restricted
@@ -139,7 +172,7 @@ module OpenAI
                 # Disables network access.
                 DISABLED: :disabled
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED: :restricted
 
                 def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network::access]

data/sig/openai/models/beta/agents/session_create_params.rbs

@@ -163,7 +163,8 @@ module OpenAI
               ?tools: ::Array[OpenAI::Models::Beta::agent_tool_param]?
             }
 
-            type service_tier = :auto | :default | :flex | :priority | :fast
+            type service_tier =
+              :auto | :default | :flex | :priority | :fast | :ultrafast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -183,6 +184,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST: :ultrafast
+
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/beta/agents/session_update_params.rbs

@@ -129,7 +129,8 @@ module OpenAI
               end
             end
 
-            type service_tier = :auto | :default | :flex | :priority | :fast
+            type service_tier =
+              :auto | :default | :flex | :priority | :fast | :ultrafast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -149,6 +150,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST: :ultrafast
+
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/beta/agents/vaults/credential.rbs

@@ -8,6 +8,7 @@ module OpenAI
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
+              metadata: ::Hash[Symbol, String],
               name: String,
               ?object: :"vault.credential",
               updated_at: Integer,
@@ -24,6 +25,9 @@ module OpenAI
             # The Unix timestamp, in seconds, when the credential was created.
             attr_accessor created_at: Integer
 
+            # Application-defined key-value pairs associated with this credential.
+            attr_accessor metadata: ::Hash[Symbol, String]
+
             # The human-readable name of the credential.
             attr_accessor name: String
 
@@ -42,6 +46,8 @@ module OpenAI
             #   The authentication method and non-secret configuration of the credential.
             # @param created_at
             #   The Unix timestamp, in seconds, when the credential was created.
+            # @param metadata
+            #   Application-defined key-value pairs associated with this credential.
             # @param name
             #   The human-readable name of the credential.
             # @param updated_at
@@ -54,6 +60,7 @@ module OpenAI
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
+              metadata: ::Hash[Symbol, String],
               name: String,
               updated_at: Integer,
               vault_id: String,
@@ -64,6 +71,7 @@ module OpenAI
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
+              metadata: ::Hash[Symbol, String],
               name: String,
               ?object: :"vault.credential",
               updated_at: Integer,

data/sig/openai/models/beta/agents/vaults/credential_create_params.rbs

@@ -8,6 +8,7 @@ module OpenAI
               vault_id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_create_param,
               name: String,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::request_opts
             }
 
@@ -24,15 +25,27 @@ module OpenAI
             # trimming.
             attr_accessor name: String
 
+            # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            # characters. Defaults to an empty map.
+            attr_reader metadata: ::Hash[Symbol, String]?
+
+            # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            # characters. Defaults to an empty map.
+            def metadata=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
             # @param auth
             #   The authentication method and write-only secret values to store.
             # @param name
             #   The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
             #   trimming.
+            # @param metadata
+            #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            #   characters. Defaults to an empty map.
             def initialize: (
               vault_id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_create_param,
               name: String,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::request_opts
             ) -> void
 
@@ -40,6 +53,7 @@ module OpenAI
               vault_id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_create_param,
               name: String,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::RequestOptions
             }
           end

data/sig/openai/models/beta/agents/vaults/credential_update_params.rbs

@@ -7,7 +7,8 @@ module OpenAI
             {
               vault_id: String,
               credential_id: String,
-              auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::request_opts
             }
 
@@ -20,21 +21,39 @@ module OpenAI
             attr_accessor credential_id: String
 
             # Replacement values for the credential's existing authentication method.
-            attr_accessor auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param
+            attr_reader auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param?
+
+            # Replacement values for the credential's existing authentication method.
+            def auth=: (
+              OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param
+            ) -> OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param
+
+            # Replaces all metadata. Omit to preserve it, or pass {} to clear it. Up to 16
+            # string key-value pairs, with keys up to 64 and values up to 512 characters.
+            attr_reader metadata: ::Hash[Symbol, String]?
+
+            # Replaces all metadata. Omit to preserve it, or pass {} to clear it. Up to 16
+            # string key-value pairs, with keys up to 64 and values up to 512 characters.
+            def metadata=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
 
             # @param auth
             #   Replacement values for the credential's existing authentication method.
+            # @param metadata
+            #   Replaces all metadata. Omit to preserve it, or pass {} to clear it. Up to 16
+            #   string key-value pairs, with keys up to 64 and values up to 512 characters.
             def initialize: (
               vault_id: String,
               credential_id: String,
-              auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::request_opts
             ) -> void
 
             def to_hash: -> {
               vault_id: String,
               credential_id: String,
-              auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth_rotate_param,
+              ?metadata: ::Hash[Symbol, String],
               ?request_options: OpenAI::RequestOptions
             }
           end

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

@@ -6,6 +6,7 @@ module OpenAI
       type beta_response =
         {
           id: String,
+          access_programs: OpenAI::Beta::BetaResponse::AccessPrograms?,
           created_at: Float,
           error: OpenAI::Beta::BetaResponseError?,
           incomplete_details: OpenAI::Beta::BetaResponse::IncompleteDetails?,
@@ -46,6 +47,8 @@ module OpenAI
         # Unique identifier for this Response.
         attr_accessor id: String
 
+        attr_accessor access_programs: OpenAI::Beta::BetaResponse::AccessPrograms?
+
         # Unix timestamp (in seconds) of when this Response was created.
         attr_accessor created_at: Float
 
@@ -515,6 +518,7 @@ module OpenAI
         #   The object type of this resource - always set to `response`.
         def initialize: (
           id: String,
+          access_programs: OpenAI::Beta::BetaResponse::AccessPrograms?,
           created_at: Float,
           error: OpenAI::Beta::BetaResponseError?,
           incomplete_details: OpenAI::Beta::BetaResponse::IncompleteDetails?,
@@ -553,6 +557,7 @@ module OpenAI
 
         def to_hash: -> {
           id: String,
+          access_programs: OpenAI::Beta::BetaResponse::AccessPrograms?,
           created_at: Float,
           error: OpenAI::Beta::BetaResponseError?,
           incomplete_details: OpenAI::Beta::BetaResponse::IncompleteDetails?,
@@ -589,6 +594,36 @@ module OpenAI
           ?user: String
         }
 
+        type access_programs =
+          { cyber: OpenAI::Models::Beta::BetaResponse::AccessPrograms::cyber }
+
+        class AccessPrograms < OpenAI::Internal::Type::BaseModel
+          # The effective Cyber access program used for this response.
+          attr_accessor cyber: OpenAI::Models::Beta::BetaResponse::AccessPrograms::cyber
+
+          # @param cyber
+          #   The effective Cyber access program used for this response.
+          def initialize: (
+            cyber: OpenAI::Models::Beta::BetaResponse::AccessPrograms::cyber
+          ) -> void
+
+          def to_hash: -> {
+            cyber: OpenAI::Models::Beta::BetaResponse::AccessPrograms::cyber
+          }
+
+          type cyber = :standard | :daybreak_blue | :daybreak_red
+
+          module Cyber
+            extend OpenAI::Internal::Type::Enum
+
+            STANDARD: :standard
+            DAYBREAK_BLUE: :daybreak_blue
+            DAYBREAK_RED: :daybreak_red
+
+            def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponse::AccessPrograms::cyber]
+          end
+        end
+
         type incomplete_details =
           {
             ?reason: OpenAI::Models::Beta::BetaResponse::IncompleteDetails::reason
@@ -647,6 +682,7 @@ module OpenAI
 
         type model =
           :"gpt-6-astra"
+          | :"gpt-6.1-sol"
           | :"gpt-6-sol"
           | :"gpt-6-luna"
           | :"gpt-5.6-sol"
@@ -762,6 +798,7 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponse::model]
 
           GPT_6_ASTRA: :"gpt-6-astra"
+          GPT_6_1_SOL: :"gpt-6.1-sol"
           GPT_6_SOL: :"gpt-6-sol"
           GPT_6_LUNA: :"gpt-6-luna"
           GPT_5_6_SOL: :"gpt-5.6-sol"

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

@@ -14,6 +14,7 @@ module OpenAI
         type response_create =
           {
             ?type: :"response.create",
+            ?access_programs: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms,
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
@@ -53,6 +54,14 @@ module OpenAI
           # The type of the client event. Always `response.create`.
           attr_accessor type: :"response.create"
 
+          # Domain-specific access programs to use for this request.
+          attr_reader access_programs: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms?
+
+          # Domain-specific access programs to use for this request.
+          def access_programs=: (
+            OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms
+          ) -> OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms
+
           # Whether to run the model response in the background.
           # [Learn more](https://developers.openai.com/api/docs/guides/background).
           attr_accessor background: bool?
@@ -405,6 +414,8 @@ module OpenAI
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           def user=: (String) -> String
 
+          # @param access_programs
+          #   Domain-specific access programs to use for this request.
           # @param background
           #   Whether to run the model response in the background.
           #   [Learn more](https://developers.openai.com/api/docs/guides/background).
@@ -638,6 +649,7 @@ module OpenAI
           # @param type
           #   The type of the client event. Always `response.create`.
           def initialize: (
+            ?access_programs: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms,
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
@@ -676,6 +688,7 @@ module OpenAI
 
           def to_hash: -> {
             ?type: :"response.create",
+            ?access_programs: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms,
             ?background: bool?,
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
@@ -711,6 +724,70 @@ module OpenAI
             ?user: String
           }
 
+          type access_programs =
+            {
+              ?cyber: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber
+            }
+
+          class AccessPrograms < OpenAI::Internal::Type::BaseModel
+            # The Cyber access program to use for this request. Supported values are
+            # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            # the program from the model's Cyber tier and your organization and project
+            # access, subject to model-specific eligibility restrictions. By default, models
+            # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            # authorized; otherwise they fall back to Standard unless the model requires
+            # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            # Requests that require unavailable Daybreak access return 403. An implicit
+            # Standard fallback is represented by null in the response's access_programs
+            # field, rather than an explicit Standard selection.
+            attr_reader cyber: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber?
+
+            # The Cyber access program to use for this request. Supported values are
+            # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            # the program from the model's Cyber tier and your organization and project
+            # access, subject to model-specific eligibility restrictions. By default, models
+            # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            # authorized; otherwise they fall back to Standard unless the model requires
+            # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            # Requests that require unavailable Daybreak access return 403. An implicit
+            # Standard fallback is represented by null in the response's access_programs
+            # field, rather than an explicit Standard selection.
+            def cyber=: (
+              OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber
+            ) -> OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber
+
+            # @param cyber
+            #   The Cyber access program to use for this request. Supported values are
+            #   `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            #   the program from the model's Cyber tier and your organization and project
+            #   access, subject to model-specific eligibility restrictions. By default, models
+            #   without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            #   authorized; otherwise they fall back to Standard unless the model requires
+            #   Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            #   Requests that require unavailable Daybreak access return 403. An implicit
+            #   Standard fallback is represented by null in the response's access_programs
+            #   field, rather than an explicit Standard selection.
+            def initialize: (
+              ?cyber: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber
+            ) -> void
+
+            def to_hash: -> {
+              ?cyber: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber
+            }
+
+            type cyber = :standard | :daybreak_blue | :daybreak_red
+
+            module Cyber
+              extend OpenAI::Internal::Type::Enum
+
+              STANDARD: :standard
+              DAYBREAK_BLUE: :daybreak_blue
+              DAYBREAK_RED: :daybreak_red
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::AccessPrograms::cyber]
+            end
+          end
+
           type context_management =
             { type: String, ?compact_threshold: Integer? }
 
@@ -749,6 +826,7 @@ module OpenAI
 
           type model =
             :"gpt-6-astra"
+            | :"gpt-6.1-sol"
             | :"gpt-6-sol"
             | :"gpt-6-luna"
             | :"gpt-5.6-sol"
@@ -864,6 +942,7 @@ module OpenAI
             def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::model]
 
             GPT_6_ASTRA: :"gpt-6-astra"
+            GPT_6_1_SOL: :"gpt-6.1-sol"
             GPT_6_SOL: :"gpt-6-sol"
             GPT_6_LUNA: :"gpt-6-luna"
             GPT_5_6_SOL: :"gpt-5.6-sol"

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

@@ -32,7 +32,9 @@ module OpenAI
           OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_context_size
         ) -> OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_context_size
 
-        # The user's location.
+        # The approximate location of the user. If omitted or null, defaults to the United
+        # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        # fields. To localize results, provide the relevant location fields.
         attr_accessor user_location: OpenAI::Beta::BetaWebSearchPreviewTool::UserLocation?
 
         # @param type
@@ -42,7 +44,9 @@ module OpenAI
         #   High level guidance for the amount of context window space to use for the
         #   search. One of `low`, `medium`, or `high`. `medium` is the default.
         # @param user_location
-        #   The user's location.
+        #   The approximate location of the user. If omitted or null, defaults to the United
+        #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #   fields. To localize results, provide the relevant location fields.
         def initialize: (
           type: OpenAI::Models::Beta::BetaWebSearchPreviewTool::type_,
           ?search_content_types: ::Array[OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_content_type],

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

@@ -39,7 +39,9 @@ module OpenAI
           OpenAI::Models::Beta::BetaWebSearchTool::search_context_size
         ) -> OpenAI::Models::Beta::BetaWebSearchTool::search_context_size
 
-        # The approximate location of the user.
+        # The approximate location of the user. If omitted or null, defaults to the United
+        # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        # fields. To localize results, provide the relevant location fields.
         attr_accessor user_location: OpenAI::Beta::BetaWebSearchTool::UserLocation?
 
         # @param type
@@ -54,7 +56,9 @@ module OpenAI
         #   High level guidance for the amount of context window space to use for the
         #   search. One of `low`, `medium`, or `high`. `medium` is the default.
         # @param user_location
-        #   The approximate location of the user.
+        #   The approximate location of the user. If omitted or null, defaults to the United
+        #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #   fields. To localize results, provide the relevant location fields.
         def initialize: (
           type: OpenAI::Models::Beta::BetaWebSearchTool::type_,
           ?external_web_access: bool,

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

@@ -31,7 +31,8 @@ module OpenAI
             packages: OpenAI::Beta::Environment::OpenAIHosted::Packages,
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
-            ?type: :openai_hosted
+            ?type: :openai_hosted,
+            ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop
           }
 
         class OpenAIHosted < OpenAI::Internal::Type::BaseModel
@@ -59,6 +60,14 @@ module OpenAI
           # The type of the object. Always `openai_hosted`.
           attr_accessor type: :openai_hosted
 
+          # The effective desktop configuration.
+          attr_reader desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop?
+
+          # The effective desktop configuration.
+          def desktop=: (
+            OpenAI::Beta::Environment::OpenAIHosted::Desktop
+          ) -> OpenAI::Beta::Environment::OpenAIHosted::Desktop
+
           # @param id
           #   The public ID of the environment.
           # @param capability_directories
@@ -73,6 +82,8 @@ module OpenAI
           #   Plugins installed in the environment, excluding their archive contents.
           # @param skills
           #   Skills installed in the environment, excluding their archive contents.
+          # @param desktop
+          #   The effective desktop configuration.
           # @param type
           #   The type of the object. Always `openai_hosted`.
           def initialize: (
@@ -83,6 +94,7 @@ module OpenAI
             packages: OpenAI::Beta::Environment::OpenAIHosted::Packages,
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
+            ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop,
             ?type: :openai_hosted
           ) -> void
 
@@ -94,7 +106,8 @@ module OpenAI
             packages: OpenAI::Beta::Environment::OpenAIHosted::Packages,
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
-            ?type: :openai_hosted
+            ?type: :openai_hosted,
+            ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop
           }
 
           type network =
@@ -135,7 +148,7 @@ module OpenAI
               # Disables network access.
               DISABLED: :disabled
 
-              # Allows access only to configured domains.
+              # Applies the configured domain restrictions.
               RESTRICTED: :restricted
 
               def self?.values: -> ::Array[OpenAI::Models::Beta::Environment::OpenAIHosted::Network::access]
@@ -177,6 +190,19 @@ module OpenAI
               system_: ::Array[String]
             }
           end
+
+          type desktop = { enabled: bool }
+
+          class Desktop < OpenAI::Internal::Type::BaseModel
+            # Whether the environment provisions a desktop and browser proxy.
+            attr_accessor enabled: bool
+
+            # @param enabled
+            #   Whether the environment provisions a desktop and browser proxy.
+            def initialize: (enabled: bool) -> void
+
+            def to_hash: -> { enabled: bool }
+          end
         end
 
         type self_hosted =