stagehand 3.19.3 → 3.21.0

data/lib/stagehand/models/session_observe_params.rb

@@ -52,10 +52,16 @@ module Stagehand
       #   @param request_options [Stagehand::RequestOptions, Hash{Symbol=>Object}]
 
       class Options < Stagehand::Internal::Type::BaseModel
+        # @!attribute ignore_selectors
+        #   Selectors for elements and subtrees that should be excluded from observation
+        #
+        #   @return [Array<String>, nil]
+        optional :ignore_selectors, Stagehand::Internal::Type::ArrayOf[String], api_name: :ignoreSelectors
+
         # @!attribute model
         #   Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
         #
-        #   @return [Stagehand::Models::ModelConfig, String, nil]
+        #   @return [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject, Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject, String, nil]
         optional :model, union: -> { Stagehand::SessionObserveParams::Options::Model }
 
         # @!attribute selector
@@ -79,11 +85,13 @@ module Stagehand
         optional :variables,
                  -> { Stagehand::Internal::Type::HashOf[union: Stagehand::SessionObserveParams::Options::Variable] }
 
-        # @!method initialize(model: nil, selector: nil, timeout: nil, variables: nil)
+        # @!method initialize(ignore_selectors: nil, model: nil, selector: nil, timeout: nil, variables: nil)
         #   Some parameter documentations has been truncated, see
         #   {Stagehand::Models::SessionObserveParams::Options} for more details.
         #
-        #   @param model [Stagehand::Models::ModelConfig, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
+        #   @param ignore_selectors [Array<String>] Selectors for elements and subtrees that should be excluded from observation
+        #
+        #   @param model [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject, Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject, String] Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
         #
         #   @param selector [String] CSS selector to scope observation to a specific element
         #
@@ -97,12 +105,339 @@ module Stagehand
         module Model
           extend Stagehand::Internal::Type::Union
 
-          variant -> { Stagehand::ModelConfig }
+          variant -> { Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject }
+
+          variant -> { Stagehand::SessionObserveParams::Options::Model::GenericModelConfigObject }
 
           variant String
 
+          class VertexModelConfigObject < Stagehand::Internal::Type::BaseModel
+            # @!attribute auth
+            #   Vertex provider authentication configuration
+            #
+            #   @return [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth]
+            required :auth, -> { Stagehand::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions]
+            required :provider_options,
+                     -> {
+                       Stagehand::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject#auth
+            class Auth < Stagehand::Internal::Type::BaseModel
+              # @!attribute credentials
+              #   Google Cloud service account credentials
+              #
+              #   @return [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials]
+              required :credentials,
+                       -> { Stagehand::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::Type, nil]
+                optional :type,
+                         enum: -> { Stagehand::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::Type]
+                #   @param universe_domain [String]
+
+                # @see Stagehand::Models::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth#scopes
+              module Scopes
+                extend Stagehand::Internal::Type::Union
+
+                variant String
+
+                variant -> { Stagehand::Models::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject#provider_options
+            class ProviderOptions < Stagehand::Internal::Type::BaseModel
+              # @!attribute vertex
+              #   Vertex AI provider-specific settings
+              #
+              #   @return [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex]
+              required :vertex,
+                       -> { Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex }
+
+              # @!method initialize(vertex:)
+              #   Vertex provider-specific model configuration
+              #
+              #   @param vertex [Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex] Vertex AI provider-specific settings
+
+              # @see Stagehand::Models::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::GenericModelConfigObject::Provider, nil]
+            optional :provider,
+                     enum: -> { Stagehand::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::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::SessionObserveParams::Options::Model::VertexModelConfigObject, Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject, String)]
         end
 
         module Variable

data/lib/stagehand/models/session_start_params.rb

@@ -353,6 +353,10 @@ module Stagehand
         optional :keep_alive, Stagehand::Internal::Type::Boolean, api_name: :keepAlive
 
         # @!attribute project_id
+        #   @deprecated
+        #
+        #   Deprecated. Browserbase API keys are now project-scoped, so this field is no
+        #   longer required.
         #
         #   @return [String, nil]
         optional :project_id, String, api_name: :projectId
@@ -380,13 +384,24 @@ module Stagehand
                  api_name: :userMetadata
 
         # @!method initialize(browser_settings: nil, extension_id: nil, keep_alive: nil, project_id: nil, proxies: nil, region: nil, timeout: nil, user_metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams} for more
+        #   details.
+        #
         #   @param browser_settings [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings]
+        #
         #   @param extension_id [String]
+        #
         #   @param keep_alive [Boolean]
-        #   @param project_id [String]
+        #
+        #   @param project_id [String] Deprecated. Browserbase API keys are now project-scoped, so this field is no lon
+        #
         #   @param proxies [Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::ProxyConfigList::Browserbase, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::ProxyConfigList::External>]
+        #
         #   @param region [Symbol, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Region]
+        #
         #   @param timeout [Float]
+        #
         #   @param user_metadata [Hash{Symbol=>Object}]
 
         # @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams#browser_settings
@@ -401,6 +416,16 @@ module Stagehand
           #   @return [Boolean, nil]
           optional :block_ads, Stagehand::Internal::Type::Boolean, api_name: :blockAds
 
+          # @!attribute captcha_image_selector
+          #
+          #   @return [String, nil]
+          optional :captcha_image_selector, String, api_name: :captchaImageSelector
+
+          # @!attribute captcha_input_selector
+          #
+          #   @return [String, nil]
+          optional :captcha_input_selector, String, api_name: :captchaInputSelector
+
           # @!attribute context
           #
           #   @return [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context, nil]
@@ -423,6 +448,12 @@ module Stagehand
           #   @return [Boolean, nil]
           optional :log_session, Stagehand::Internal::Type::Boolean, api_name: :logSession
 
+          # @!attribute os
+          #
+          #   @return [Symbol, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os, nil]
+          optional :os,
+                   enum: -> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os }
+
           # @!attribute record_session
           #
           #   @return [Boolean, nil]
@@ -433,21 +464,30 @@ module Stagehand
           #   @return [Boolean, nil]
           optional :solve_captchas, Stagehand::Internal::Type::Boolean, api_name: :solveCaptchas
 
+          # @!attribute verified
+          #
+          #   @return [Boolean, nil]
+          optional :verified, Stagehand::Internal::Type::Boolean
+
           # @!attribute viewport
           #
           #   @return [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport, nil]
           optional :viewport,
                    -> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport }
 
-          # @!method initialize(advanced_stealth: nil, block_ads: nil, context: nil, extension_id: nil, fingerprint: nil, log_session: nil, record_session: nil, solve_captchas: nil, viewport: nil)
+          # @!method initialize(advanced_stealth: nil, block_ads: nil, captcha_image_selector: nil, captcha_input_selector: nil, context: nil, extension_id: nil, fingerprint: nil, log_session: nil, os: nil, record_session: nil, solve_captchas: nil, verified: nil, viewport: nil)
           #   @param advanced_stealth [Boolean]
           #   @param block_ads [Boolean]
+          #   @param captcha_image_selector [String]
+          #   @param captcha_input_selector [String]
           #   @param context [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context]
           #   @param extension_id [String]
           #   @param fingerprint [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Fingerprint]
           #   @param log_session [Boolean]
+          #   @param os [Symbol, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os]
           #   @param record_session [Boolean]
           #   @param solve_captchas [Boolean]
+          #   @param verified [Boolean]
           #   @param viewport [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport]
 
           # @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings#context
@@ -596,6 +636,20 @@ module Stagehand
             end
           end
 
+          # @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings#os
+          module Os
+            extend Stagehand::Internal::Type::Enum
+
+            WINDOWS = :windows
+            MAC = :mac
+            LINUX = :linux
+            MOBILE = :mobile
+            TABLET = :tablet
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings#viewport
           class Viewport < Stagehand::Internal::Type::BaseModel
             # @!attribute height

data/lib/stagehand/resources/sessions.rb

@@ -77,8 +77,11 @@ module Stagehand
           path: ["v1/sessions/%1$s/act", id],
           headers: {
             "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
             **parsed.slice(*header_params.keys)
-          }.transform_keys(header_params),
+          }.transform_keys(
+            header_params
+          ),
           body: parsed.except(*header_params.keys),
           stream: Stagehand::Internal::Stream,
           model: Stagehand::StreamEvent,
@@ -193,8 +196,11 @@ module Stagehand
           path: ["v1/sessions/%1$s/agentExecute", id],
           headers: {
             "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
             **parsed.slice(*header_params.keys)
-          }.transform_keys(header_params),
+          }.transform_keys(
+            header_params
+          ),
           body: parsed.except(*header_params.keys),
           stream: Stagehand::Internal::Stream,
           model: Stagehand::StreamEvent,
@@ -279,8 +285,11 @@ module Stagehand
           path: ["v1/sessions/%1$s/extract", id],
           headers: {
             "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
             **parsed.slice(*header_params.keys)
-          }.transform_keys(header_params),
+          }.transform_keys(
+            header_params
+          ),
           body: parsed.except(*header_params.keys),
           stream: Stagehand::Internal::Stream,
           model: Stagehand::StreamEvent,
@@ -397,8 +406,11 @@ module Stagehand
           path: ["v1/sessions/%1$s/observe", id],
           headers: {
             "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
             **parsed.slice(*header_params.keys)
-          }.transform_keys(header_params),
+          }.transform_keys(
+            header_params
+          ),
           body: parsed.except(*header_params.keys),
           stream: Stagehand::Internal::Stream,
           model: Stagehand::StreamEvent,

data/lib/stagehand/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stagehand
-  VERSION = "3.19.3"
+  VERSION = "3.21.0"
 end

data/rbi/stagehand/client.rbi

@@ -14,7 +14,7 @@ module Stagehand
     sig { returns(String) }
     attr_reader :browserbase_api_key
 
-    # Your [Browserbase Project ID](https://www.browserbase.com/settings)
+    # Deprecated. Browserbase API keys are now project-scoped, so this value is accepted for backwards compatibility and ignored.
     sig { returns(String) }
     attr_reader :browserbase_project_id
 
@@ -63,17 +63,17 @@ module Stagehand
       # Your [Browserbase API Key](https://www.browserbase.com/settings) Defaults to
       # `ENV["BROWSERBASE_API_KEY"]`
       browserbase_api_key: ENV["BROWSERBASE_API_KEY"],
-      # Your [Browserbase Project ID](https://www.browserbase.com/settings) Defaults to
-      # `ENV["BROWSERBASE_PROJECT_ID"]`
-      browserbase_project_id: ENV["BROWSERBASE_PROJECT_ID"],
+      # Deprecated. Browserbase API keys are now project-scoped, so this value is accepted for backwards compatibility and ignored.
+      browserbase_project_id: nil,
       # Your LLM provider API key (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
       # Defaults to `ENV["MODEL_API_KEY"]`
       model_api_key: ENV["MODEL_API_KEY"],
       # Server mode to use ("remote" or "local"). Defaults to "remote"
       server: "remote",
       # Override the default base URL for the API, e.g.,
-      # `"https://api.example.com/v2/"`. Defaults to `ENV["STAGEHAND_BASE_URL"]`
-      base_url: ENV["STAGEHAND_BASE_URL"],
+      # `"https://api.example.com/v2/"`. Defaults to `ENV["STAGEHAND_API_URL"]`,
+      # then `ENV["STAGEHAND_BASE_URL"]`
+      base_url: ENV["STAGEHAND_API_URL"] || ENV["STAGEHAND_BASE_URL"],
       # Max number of retries to attempt after a failed retryable request.
       max_retries: Stagehand::Client::DEFAULT_MAX_RETRIES,
       timeout: Stagehand::Client::DEFAULT_TIMEOUT_IN_SECONDS,