stagehand 3.19.3 → 3.21.0

data/lib/stagehand/models/session_execute_params.rb

@@ -73,7 +73,7 @@ module Stagehand
         #   tool execution (observe/act calls within agent tools). If not specified,
         #   inherits from the main model configuration.
         #
-        #   @return [Stagehand::Models::ModelConfig, String, nil]
+        #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject, String, nil]
         optional :execution_model,
                  union: -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel },
                  api_name: :executionModel
@@ -87,7 +87,7 @@ module Stagehand
         # @!attribute model
         #   Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
         #
-        #   @return [Stagehand::Models::ModelConfig, String, nil]
+        #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject, String, nil]
         optional :model, union: -> { Stagehand::SessionExecuteParams::AgentConfig::Model }
 
         # @!attribute provider
@@ -108,11 +108,11 @@ module Stagehand
         #
         #   @param cua [Boolean] Deprecated. Use mode: 'cua' instead. If both are provided, mode takes precedence
         #
-        #   @param execution_model [Stagehand::Models::ModelConfig, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano') for
+        #   @param execution_model [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano') for
         #
         #   @param mode [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Mode] Tool mode for the agent (dom, hybrid, cua). If set, overrides cua.
         #
-        #   @param model [Stagehand::Models::ModelConfig, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
+        #   @param model [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
         #
         #   @param provider [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Provider] AI provider for the agent (legacy, use model: openai/gpt-5-nano instead)
         #
@@ -126,12 +126,340 @@ module Stagehand
         module ExecutionModel
           extend Stagehand::Internal::Type::Union
 
-          variant -> { Stagehand::ModelConfig }
+          variant -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject }
+
+          variant -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject }
 
           variant String
 
+          class VertexModelConfigObject < Stagehand::Internal::Type::BaseModel
+            # @!attribute auth
+            #   Vertex provider authentication configuration
+            #
+            #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth]
+            required :auth,
+                     -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth }
+
+            # @!attribute model_name
+            #   Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @return [String]
+            required :model_name, String, api_name: :modelName
+
+            # @!attribute provider
+            #   Vertex AI model provider
+            #
+            #   @return [Symbol, :vertex]
+            required :provider, const: :vertex
+
+            # @!attribute provider_options
+            #   Vertex provider-specific model configuration
+            #
+            #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions]
+            required :provider_options,
+                     -> {
+                       Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions
+                     },
+                     api_name: :providerOptions
+
+            # @!attribute api_key
+            #   API key for the model provider
+            #
+            #   @return [String, nil]
+            optional :api_key, String, api_name: :apiKey
+
+            # @!attribute base_url
+            #   Base URL for the model provider
+            #
+            #   @return [String, nil]
+            optional :base_url, String, api_name: :baseURL
+
+            # @!attribute headers
+            #   Custom headers sent with every request to the model provider
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+            # @!method initialize(auth:, model_name:, provider_options:, api_key: nil, base_url: nil, headers: nil, provider: :vertex)
+            #   @param auth [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth] Vertex provider authentication configuration
+            #
+            #   @param model_name [String] Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @param provider_options [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions] Vertex provider-specific model configuration
+            #
+            #   @param api_key [String] API key for the model provider
+            #
+            #   @param base_url [String] Base URL for the model provider
+            #
+            #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the model provider
+            #
+            #   @param provider [Symbol, :vertex] Vertex AI model provider
+
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject#auth
+            class Auth < Stagehand::Internal::Type::BaseModel
+              # @!attribute credentials
+              #   Google Cloud service account credentials
+              #
+              #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials]
+              required :credentials,
+                       -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials }
+
+              # @!attribute type
+              #   Use inline Google Cloud service account credentials for provider authentication
+              #
+              #   @return [Symbol, :googleServiceAccount]
+              required :type, const: :googleServiceAccount
+
+              # @!attribute project_id
+              #   Google Cloud project ID used by google-auth-library
+              #
+              #   @return [String, nil]
+              optional :project_id, String, api_name: :projectId
+
+              # @!attribute scopes
+              #   Google auth scopes for the desired API request
+              #
+              #   @return [String, Array<String>, nil]
+              optional :scopes,
+                       union: -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Scopes }
+
+              # @!attribute universe_domain
+              #   Google Cloud universe domain
+              #
+              #   @return [String, nil]
+              optional :universe_domain, String, api_name: :universeDomain
+
+              # @!method initialize(credentials:, project_id: nil, scopes: nil, universe_domain: nil, type: :googleServiceAccount)
+              #   Vertex provider authentication configuration
+              #
+              #   @param credentials [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials] Google Cloud service account credentials
+              #
+              #   @param project_id [String] Google Cloud project ID used by google-auth-library
+              #
+              #   @param scopes [String, Array<String>] Google auth scopes for the desired API request
+              #
+              #   @param universe_domain [String] Google Cloud universe domain
+              #
+              #   @param type [Symbol, :googleServiceAccount] Use inline Google Cloud service account credentials for provider authentication
+
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth#credentials
+              class Credentials < Stagehand::Internal::Type::BaseModel
+                # @!attribute client_email
+                #
+                #   @return [String]
+                required :client_email, String
+
+                # @!attribute private_key
+                #
+                #   @return [String]
+                required :private_key, String
+
+                # @!attribute auth_provider_x509_cert_url
+                #
+                #   @return [String, nil]
+                optional :auth_provider_x509_cert_url, String
+
+                # @!attribute auth_uri
+                #
+                #   @return [String, nil]
+                optional :auth_uri, String
+
+                # @!attribute client_id
+                #
+                #   @return [String, nil]
+                optional :client_id, String
+
+                # @!attribute client_x509_cert_url
+                #
+                #   @return [String, nil]
+                optional :client_x509_cert_url, String
+
+                # @!attribute private_key_id
+                #
+                #   @return [String, nil]
+                optional :private_key_id, String
+
+                # @!attribute project_id
+                #
+                #   @return [String, nil]
+                optional :project_id, String
+
+                # @!attribute token_uri
+                #
+                #   @return [String, nil]
+                optional :token_uri, String
+
+                # @!attribute type
+                #
+                #   @return [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials::Type, nil]
+                optional :type,
+                         enum: -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials::Type }
+
+                # @!attribute universe_domain
+                #
+                #   @return [String, nil]
+                optional :universe_domain, String
+
+                # @!method initialize(client_email:, private_key:, auth_provider_x509_cert_url: nil, auth_uri: nil, client_id: nil, client_x509_cert_url: nil, private_key_id: nil, project_id: nil, token_uri: nil, type: nil, universe_domain: nil)
+                #   Google Cloud service account credentials
+                #
+                #   @param client_email [String]
+                #   @param private_key [String]
+                #   @param auth_provider_x509_cert_url [String]
+                #   @param auth_uri [String]
+                #   @param client_id [String]
+                #   @param client_x509_cert_url [String]
+                #   @param private_key_id [String]
+                #   @param project_id [String]
+                #   @param token_uri [String]
+                #   @param type [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials::Type]
+                #   @param universe_domain [String]
+
+                # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Credentials#type
+                module Type
+                  extend Stagehand::Internal::Type::Enum
+
+                  SERVICE_ACCOUNT = :service_account
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              # Google auth scopes for the desired API request
+              #
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth#scopes
+              module Scopes
+                extend Stagehand::Internal::Type::Union
+
+                variant String
+
+                variant -> { Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::Auth::Scopes::StringArray }
+
+                # @!method self.variants
+                #   @return [Array(String, Array<String>)]
+
+                # @type [Stagehand::Internal::Type::Converter]
+                StringArray = Stagehand::Internal::Type::ArrayOf[String]
+              end
+            end
+
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject#provider_options
+            class ProviderOptions < Stagehand::Internal::Type::BaseModel
+              # @!attribute vertex
+              #   Vertex AI provider-specific settings
+              #
+              #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions::Vertex]
+              required :vertex,
+                       -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions::Vertex }
+
+              # @!method initialize(vertex:)
+              #   Vertex provider-specific model configuration
+              #
+              #   @param vertex [Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions::Vertex] Vertex AI provider-specific settings
+
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject::ProviderOptions#vertex
+              class Vertex < Stagehand::Internal::Type::BaseModel
+                # @!attribute location
+                #   Google Cloud location for Vertex AI models
+                #
+                #   @return [String]
+                required :location, String
+
+                # @!attribute project
+                #   Google Cloud project ID for Vertex AI models
+                #
+                #   @return [String]
+                required :project, String
+
+                # @!attribute base_url
+                #   Base URL for the Vertex AI provider
+                #
+                #   @return [String, nil]
+                optional :base_url, String, api_name: :baseURL
+
+                # @!attribute headers
+                #   Custom headers sent with every request to the Vertex AI provider
+                #
+                #   @return [Hash{Symbol=>String}, nil]
+                optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+                # @!method initialize(location:, project:, base_url: nil, headers: nil)
+                #   Vertex AI provider-specific settings
+                #
+                #   @param location [String] Google Cloud location for Vertex AI models
+                #
+                #   @param project [String] Google Cloud project ID for Vertex AI models
+                #
+                #   @param base_url [String] Base URL for the Vertex AI provider
+                #
+                #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the Vertex AI provider
+              end
+            end
+          end
+
+          class GenericModelConfigObject < Stagehand::Internal::Type::BaseModel
+            # @!attribute model_name
+            #   Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @return [String]
+            required :model_name, String, api_name: :modelName
+
+            # @!attribute api_key
+            #   API key for the model provider
+            #
+            #   @return [String, nil]
+            optional :api_key, String, api_name: :apiKey
+
+            # @!attribute base_url
+            #   Base URL for the model provider
+            #
+            #   @return [String, nil]
+            optional :base_url, String, api_name: :baseURL
+
+            # @!attribute headers
+            #   Custom headers sent with every request to the model provider
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+            # @!attribute provider
+            #   AI provider for the model (or provide a baseURL endpoint instead)
+            #
+            #   @return [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject::Provider, nil]
+            optional :provider,
+                     enum: -> { Stagehand::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject::Provider }
+
+            # @!method initialize(model_name:, api_key: nil, base_url: nil, headers: nil, provider: nil)
+            #   @param model_name [String] Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @param api_key [String] API key for the model provider
+            #
+            #   @param base_url [String] Base URL for the model provider
+            #
+            #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the model provider
+            #
+            #   @param provider [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject::Provider] AI provider for the model (or provide a baseURL endpoint instead)
+
+            # AI provider for the model (or provide a baseURL endpoint instead)
+            #
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject#provider
+            module Provider
+              extend Stagehand::Internal::Type::Enum
+
+              OPENAI = :openai
+              ANTHROPIC = :anthropic
+              GOOGLE = :google
+              MICROSOFT = :microsoft
+              BEDROCK = :bedrock
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # @!method self.variants
-          #   @return [Array(Stagehand::Models::ModelConfig, String)]
+          #   @return [Array(Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::ExecutionModel::GenericModelConfigObject, String)]
         end
 
         # Tool mode for the agent (dom, hybrid, cua). If set, overrides cua.
@@ -154,12 +482,339 @@ module Stagehand
         module Model
           extend Stagehand::Internal::Type::Union
 
-          variant -> { Stagehand::ModelConfig }
+          variant -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject }
+
+          variant -> { Stagehand::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject }
 
           variant String
 
+          class VertexModelConfigObject < Stagehand::Internal::Type::BaseModel
+            # @!attribute auth
+            #   Vertex provider authentication configuration
+            #
+            #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth]
+            required :auth, -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth }
+
+            # @!attribute model_name
+            #   Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @return [String]
+            required :model_name, String, api_name: :modelName
+
+            # @!attribute provider
+            #   Vertex AI model provider
+            #
+            #   @return [Symbol, :vertex]
+            required :provider, const: :vertex
+
+            # @!attribute provider_options
+            #   Vertex provider-specific model configuration
+            #
+            #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions]
+            required :provider_options,
+                     -> {
+                       Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions
+                     },
+                     api_name: :providerOptions
+
+            # @!attribute api_key
+            #   API key for the model provider
+            #
+            #   @return [String, nil]
+            optional :api_key, String, api_name: :apiKey
+
+            # @!attribute base_url
+            #   Base URL for the model provider
+            #
+            #   @return [String, nil]
+            optional :base_url, String, api_name: :baseURL
+
+            # @!attribute headers
+            #   Custom headers sent with every request to the model provider
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+            # @!method initialize(auth:, model_name:, provider_options:, api_key: nil, base_url: nil, headers: nil, provider: :vertex)
+            #   @param auth [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth] Vertex provider authentication configuration
+            #
+            #   @param model_name [String] Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @param provider_options [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions] Vertex provider-specific model configuration
+            #
+            #   @param api_key [String] API key for the model provider
+            #
+            #   @param base_url [String] Base URL for the model provider
+            #
+            #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the model provider
+            #
+            #   @param provider [Symbol, :vertex] Vertex AI model provider
+
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject#auth
+            class Auth < Stagehand::Internal::Type::BaseModel
+              # @!attribute credentials
+              #   Google Cloud service account credentials
+              #
+              #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials]
+              required :credentials,
+                       -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials }
+
+              # @!attribute type
+              #   Use inline Google Cloud service account credentials for provider authentication
+              #
+              #   @return [Symbol, :googleServiceAccount]
+              required :type, const: :googleServiceAccount
+
+              # @!attribute project_id
+              #   Google Cloud project ID used by google-auth-library
+              #
+              #   @return [String, nil]
+              optional :project_id, String, api_name: :projectId
+
+              # @!attribute scopes
+              #   Google auth scopes for the desired API request
+              #
+              #   @return [String, Array<String>, nil]
+              optional :scopes,
+                       union: -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Scopes }
+
+              # @!attribute universe_domain
+              #   Google Cloud universe domain
+              #
+              #   @return [String, nil]
+              optional :universe_domain, String, api_name: :universeDomain
+
+              # @!method initialize(credentials:, project_id: nil, scopes: nil, universe_domain: nil, type: :googleServiceAccount)
+              #   Vertex provider authentication configuration
+              #
+              #   @param credentials [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials] Google Cloud service account credentials
+              #
+              #   @param project_id [String] Google Cloud project ID used by google-auth-library
+              #
+              #   @param scopes [String, Array<String>] Google auth scopes for the desired API request
+              #
+              #   @param universe_domain [String] Google Cloud universe domain
+              #
+              #   @param type [Symbol, :googleServiceAccount] Use inline Google Cloud service account credentials for provider authentication
+
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth#credentials
+              class Credentials < Stagehand::Internal::Type::BaseModel
+                # @!attribute client_email
+                #
+                #   @return [String]
+                required :client_email, String
+
+                # @!attribute private_key
+                #
+                #   @return [String]
+                required :private_key, String
+
+                # @!attribute auth_provider_x509_cert_url
+                #
+                #   @return [String, nil]
+                optional :auth_provider_x509_cert_url, String
+
+                # @!attribute auth_uri
+                #
+                #   @return [String, nil]
+                optional :auth_uri, String
+
+                # @!attribute client_id
+                #
+                #   @return [String, nil]
+                optional :client_id, String
+
+                # @!attribute client_x509_cert_url
+                #
+                #   @return [String, nil]
+                optional :client_x509_cert_url, String
+
+                # @!attribute private_key_id
+                #
+                #   @return [String, nil]
+                optional :private_key_id, String
+
+                # @!attribute project_id
+                #
+                #   @return [String, nil]
+                optional :project_id, String
+
+                # @!attribute token_uri
+                #
+                #   @return [String, nil]
+                optional :token_uri, String
+
+                # @!attribute type
+                #
+                #   @return [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials::Type, nil]
+                optional :type,
+                         enum: -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials::Type }
+
+                # @!attribute universe_domain
+                #
+                #   @return [String, nil]
+                optional :universe_domain, String
+
+                # @!method initialize(client_email:, private_key:, auth_provider_x509_cert_url: nil, auth_uri: nil, client_id: nil, client_x509_cert_url: nil, private_key_id: nil, project_id: nil, token_uri: nil, type: nil, universe_domain: nil)
+                #   Google Cloud service account credentials
+                #
+                #   @param client_email [String]
+                #   @param private_key [String]
+                #   @param auth_provider_x509_cert_url [String]
+                #   @param auth_uri [String]
+                #   @param client_id [String]
+                #   @param client_x509_cert_url [String]
+                #   @param private_key_id [String]
+                #   @param project_id [String]
+                #   @param token_uri [String]
+                #   @param type [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials::Type]
+                #   @param universe_domain [String]
+
+                # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Credentials#type
+                module Type
+                  extend Stagehand::Internal::Type::Enum
+
+                  SERVICE_ACCOUNT = :service_account
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              # Google auth scopes for the desired API request
+              #
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth#scopes
+              module Scopes
+                extend Stagehand::Internal::Type::Union
+
+                variant String
+
+                variant -> { Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::Auth::Scopes::StringArray }
+
+                # @!method self.variants
+                #   @return [Array(String, Array<String>)]
+
+                # @type [Stagehand::Internal::Type::Converter]
+                StringArray = Stagehand::Internal::Type::ArrayOf[String]
+              end
+            end
+
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject#provider_options
+            class ProviderOptions < Stagehand::Internal::Type::BaseModel
+              # @!attribute vertex
+              #   Vertex AI provider-specific settings
+              #
+              #   @return [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions::Vertex]
+              required :vertex,
+                       -> { Stagehand::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions::Vertex }
+
+              # @!method initialize(vertex:)
+              #   Vertex provider-specific model configuration
+              #
+              #   @param vertex [Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions::Vertex] Vertex AI provider-specific settings
+
+              # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject::ProviderOptions#vertex
+              class Vertex < Stagehand::Internal::Type::BaseModel
+                # @!attribute location
+                #   Google Cloud location for Vertex AI models
+                #
+                #   @return [String]
+                required :location, String
+
+                # @!attribute project
+                #   Google Cloud project ID for Vertex AI models
+                #
+                #   @return [String]
+                required :project, String
+
+                # @!attribute base_url
+                #   Base URL for the Vertex AI provider
+                #
+                #   @return [String, nil]
+                optional :base_url, String, api_name: :baseURL
+
+                # @!attribute headers
+                #   Custom headers sent with every request to the Vertex AI provider
+                #
+                #   @return [Hash{Symbol=>String}, nil]
+                optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+                # @!method initialize(location:, project:, base_url: nil, headers: nil)
+                #   Vertex AI provider-specific settings
+                #
+                #   @param location [String] Google Cloud location for Vertex AI models
+                #
+                #   @param project [String] Google Cloud project ID for Vertex AI models
+                #
+                #   @param base_url [String] Base URL for the Vertex AI provider
+                #
+                #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the Vertex AI provider
+              end
+            end
+          end
+
+          class GenericModelConfigObject < Stagehand::Internal::Type::BaseModel
+            # @!attribute model_name
+            #   Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @return [String]
+            required :model_name, String, api_name: :modelName
+
+            # @!attribute api_key
+            #   API key for the model provider
+            #
+            #   @return [String, nil]
+            optional :api_key, String, api_name: :apiKey
+
+            # @!attribute base_url
+            #   Base URL for the model provider
+            #
+            #   @return [String, nil]
+            optional :base_url, String, api_name: :baseURL
+
+            # @!attribute headers
+            #   Custom headers sent with every request to the model provider
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, Stagehand::Internal::Type::HashOf[String]
+
+            # @!attribute provider
+            #   AI provider for the model (or provide a baseURL endpoint instead)
+            #
+            #   @return [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject::Provider, nil]
+            optional :provider,
+                     enum: -> { Stagehand::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject::Provider }
+
+            # @!method initialize(model_name:, api_key: nil, base_url: nil, headers: nil, provider: nil)
+            #   @param model_name [String] Model name string with provider prefix (e.g., 'openai/gpt-5-nano')
+            #
+            #   @param api_key [String] API key for the model provider
+            #
+            #   @param base_url [String] Base URL for the model provider
+            #
+            #   @param headers [Hash{Symbol=>String}] Custom headers sent with every request to the model provider
+            #
+            #   @param provider [Symbol, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject::Provider] AI provider for the model (or provide a baseURL endpoint instead)
+
+            # AI provider for the model (or provide a baseURL endpoint instead)
+            #
+            # @see Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject#provider
+            module Provider
+              extend Stagehand::Internal::Type::Enum
+
+              OPENAI = :openai
+              ANTHROPIC = :anthropic
+              GOOGLE = :google
+              MICROSOFT = :microsoft
+              BEDROCK = :bedrock
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # @!method self.variants
-          #   @return [Array(Stagehand::Models::ModelConfig, String)]
+          #   @return [Array(Stagehand::Models::SessionExecuteParams::AgentConfig::Model::VertexModelConfigObject, Stagehand::Models::SessionExecuteParams::AgentConfig::Model::GenericModelConfigObject, String)]
         end
 
         # AI provider for the agent (legacy, use model: openai/gpt-5-nano instead)
@@ -210,7 +865,14 @@ module Stagehand
         #   @return [Boolean, nil]
         optional :use_search, Stagehand::Internal::Type::Boolean, api_name: :useSearch
 
-        # @!method initialize(instruction:, highlight_cursor: nil, max_steps: nil, tool_timeout: nil, use_search: nil)
+        # @!attribute variables
+        #   Variables available to the agent via %variableName% syntax in supported tools
+        #
+        #   @return [Hash{Symbol=>String, Float, Boolean, Stagehand::Models::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3}, nil]
+        optional :variables,
+                 -> { Stagehand::Internal::Type::HashOf[union: Stagehand::SessionExecuteParams::ExecuteOptions::Variable] }
+
+        # @!method initialize(instruction:, highlight_cursor: nil, max_steps: nil, tool_timeout: nil, use_search: nil, variables: nil)
         #   @param instruction [String] Natural language instruction for the agent
         #
         #   @param highlight_cursor [Boolean] Whether to visually highlight the cursor during execution
@@ -220,6 +882,54 @@ module Stagehand
         #   @param tool_timeout [Float] Timeout in milliseconds for each agent tool call
         #
         #   @param use_search [Boolean] Whether to enable the web search tool powered by Browserbase Search API
+        #
+        #   @param variables [Hash{Symbol=>String, Float, Boolean, Stagehand::Models::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3}] Variables available to the agent via %variableName% syntax in supported tools
+
+        module Variable
+          extend Stagehand::Internal::Type::Union
+
+          variant String
+
+          variant Float
+
+          variant Stagehand::Internal::Type::Boolean
+
+          variant -> { Stagehand::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3 }
+
+          class UnionMember3 < Stagehand::Internal::Type::BaseModel
+            # @!attribute value
+            #
+            #   @return [String, Float, Boolean]
+            required :value,
+                     union: -> { Stagehand::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3::Value }
+
+            # @!attribute description
+            #
+            #   @return [String, nil]
+            optional :description, String
+
+            # @!method initialize(value:, description: nil)
+            #   @param value [String, Float, Boolean]
+            #   @param description [String]
+
+            # @see Stagehand::Models::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3#value
+            module Value
+              extend Stagehand::Internal::Type::Union
+
+              variant String
+
+              variant Float
+
+              variant Stagehand::Internal::Type::Boolean
+
+              # @!method self.variants
+              #   @return [Array(String, Float, Boolean)]
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(String, Float, Boolean, Stagehand::Models::SessionExecuteParams::ExecuteOptions::Variable::UnionMember3)]
+        end
       end
 
       # Whether to stream the response via SSE