stagehand 3.19.3 → 3.21.0

data/sig/stagehand/models/session_observe_params.rbs

@@ -54,6 +54,7 @@ module Stagehand
 
       type options =
         {
+          ignore_selectors: ::Array[String],
           model: Stagehand::Models::SessionObserveParams::Options::model,
           selector: String,
           timeout: Float,
@@ -61,6 +62,10 @@ module Stagehand
         }
 
       class Options < Stagehand::Internal::Type::BaseModel
+        attr_reader ignore_selectors: ::Array[String]?
+
+        def ignore_selectors=: (::Array[String]) -> ::Array[String]
+
         attr_reader model: Stagehand::Models::SessionObserveParams::Options::model?
 
         def model=: (
@@ -82,6 +87,7 @@ module Stagehand
         ) -> ::Hash[Symbol, Stagehand::Models::SessionObserveParams::Options::variable]
 
         def initialize: (
+          ?ignore_selectors: ::Array[String],
           ?model: Stagehand::Models::SessionObserveParams::Options::model,
           ?selector: String,
           ?timeout: Float,
@@ -89,17 +95,341 @@ module Stagehand
         ) -> void
 
         def to_hash: -> {
+          ignore_selectors: ::Array[String],
           model: Stagehand::Models::SessionObserveParams::Options::model,
           selector: String,
           timeout: Float,
           variables: ::Hash[Symbol, Stagehand::Models::SessionObserveParams::Options::variable]
         }
 
-        type model = Stagehand::ModelConfig | String
+        type model =
+          Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject
+          | Stagehand::SessionObserveParams::Options::Model::GenericModelConfigObject
+          | String
 
         module Model
           extend Stagehand::Internal::Type::Union
 
+          type vertex_model_config_object =
+            {
+              auth: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth,
+              model_name: String,
+              provider: :vertex,
+              provider_options: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions,
+              api_key: String,
+              base_url: String,
+              headers: ::Hash[Symbol, String]
+            }
+
+          class VertexModelConfigObject < Stagehand::Internal::Type::BaseModel
+            attr_accessor auth: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth
+
+            attr_accessor model_name: String
+
+            attr_accessor provider: :vertex
+
+            attr_accessor provider_options: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions
+
+            attr_reader api_key: String?
+
+            def api_key=: (String) -> String
+
+            attr_reader base_url: String?
+
+            def base_url=: (String) -> String
+
+            attr_reader headers: ::Hash[Symbol, String]?
+
+            def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
+            def initialize: (
+              auth: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth,
+              model_name: String,
+              provider_options: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions,
+              ?api_key: String,
+              ?base_url: String,
+              ?headers: ::Hash[Symbol, String],
+              ?provider: :vertex
+            ) -> void
+
+            def to_hash: -> {
+              auth: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth,
+              model_name: String,
+              provider: :vertex,
+              provider_options: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions,
+              api_key: String,
+              base_url: String,
+              headers: ::Hash[Symbol, String]
+            }
+
+            type auth =
+              {
+                credentials: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials,
+                type: :googleServiceAccount,
+                project_id: String,
+                scopes: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes,
+                universe_domain: String
+              }
+
+            class Auth < Stagehand::Internal::Type::BaseModel
+              attr_accessor credentials: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials
+
+              attr_accessor type: :googleServiceAccount
+
+              attr_reader project_id: String?
+
+              def project_id=: (String) -> String
+
+              attr_reader scopes: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes?
+
+              def scopes=: (
+                Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes
+              ) -> Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes
+
+              attr_reader universe_domain: String?
+
+              def universe_domain=: (String) -> String
+
+              def initialize: (
+                credentials: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials,
+                ?project_id: String,
+                ?scopes: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes,
+                ?universe_domain: String,
+                ?type: :googleServiceAccount
+              ) -> void
+
+              def to_hash: -> {
+                credentials: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials,
+                type: :googleServiceAccount,
+                project_id: String,
+                scopes: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes,
+                universe_domain: String
+              }
+
+              type credentials =
+                {
+                  client_email: String,
+                  private_key: String,
+                  :auth_provider_x509_cert_url => String,
+                  auth_uri: String,
+                  client_id: String,
+                  :client_x509_cert_url => String,
+                  private_key_id: String,
+                  project_id: String,
+                  token_uri: String,
+                  type: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_,
+                  universe_domain: String
+                }
+
+              class Credentials < Stagehand::Internal::Type::BaseModel
+                attr_accessor client_email: String
+
+                attr_accessor private_key: String
+
+                attr_reader auth_provider_x509_cert_url: String?
+
+                def auth_provider_x509_cert_url=: (String) -> String
+
+                attr_reader auth_uri: String?
+
+                def auth_uri=: (String) -> String
+
+                attr_reader client_id: String?
+
+                def client_id=: (String) -> String
+
+                attr_reader client_x509_cert_url: String?
+
+                def client_x509_cert_url=: (String) -> String
+
+                attr_reader private_key_id: String?
+
+                def private_key_id=: (String) -> String
+
+                attr_reader project_id: String?
+
+                def project_id=: (String) -> String
+
+                attr_reader token_uri: String?
+
+                def token_uri=: (String) -> String
+
+                attr_reader type: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_?
+
+                def type=: (
+                  Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_
+                ) -> Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_
+
+                attr_reader universe_domain: String?
+
+                def universe_domain=: (String) -> String
+
+                def initialize: (
+                  client_email: String,
+                  private_key: String,
+                  ?auth_provider_x509_cert_url: String,
+                  ?auth_uri: String,
+                  ?client_id: String,
+                  ?client_x509_cert_url: String,
+                  ?private_key_id: String,
+                  ?project_id: String,
+                  ?token_uri: String,
+                  ?type: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_,
+                  ?universe_domain: String
+                ) -> void
+
+                def to_hash: -> {
+                  client_email: String,
+                  private_key: String,
+                  :auth_provider_x509_cert_url => String,
+                  auth_uri: String,
+                  client_id: String,
+                  :client_x509_cert_url => String,
+                  private_key_id: String,
+                  project_id: String,
+                  token_uri: String,
+                  type: Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_,
+                  universe_domain: String
+                }
+
+                type type_ = :service_account
+
+                module Type
+                  extend Stagehand::Internal::Type::Enum
+
+                  SERVICE_ACCOUNT: :service_account
+
+                  def self?.values: -> ::Array[Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::Credentials::type_]
+                end
+              end
+
+              type scopes = String | ::Array[String]
+
+              module Scopes
+                extend Stagehand::Internal::Type::Union
+
+                def self?.variants: -> ::Array[Stagehand::Models::SessionObserveParams::Options::Model::VertexModelConfigObject::Auth::scopes]
+
+                StringArray: Stagehand::Internal::Type::Converter
+              end
+            end
+
+            type provider_options =
+              {
+                vertex: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex
+              }
+
+            class ProviderOptions < Stagehand::Internal::Type::BaseModel
+              attr_accessor vertex: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex
+
+              def initialize: (
+                vertex: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex
+              ) -> void
+
+              def to_hash: -> {
+                vertex: Stagehand::SessionObserveParams::Options::Model::VertexModelConfigObject::ProviderOptions::Vertex
+              }
+
+              type vertex =
+                {
+                  location: String,
+                  project: String,
+                  base_url: String,
+                  headers: ::Hash[Symbol, String]
+                }
+
+              class Vertex < Stagehand::Internal::Type::BaseModel
+                attr_accessor location: String
+
+                attr_accessor project: String
+
+                attr_reader base_url: String?
+
+                def base_url=: (String) -> String
+
+                attr_reader headers: ::Hash[Symbol, String]?
+
+                def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
+                def initialize: (
+                  location: String,
+                  project: String,
+                  ?base_url: String,
+                  ?headers: ::Hash[Symbol, String]
+                ) -> void
+
+                def to_hash: -> {
+                  location: String,
+                  project: String,
+                  base_url: String,
+                  headers: ::Hash[Symbol, String]
+                }
+              end
+            end
+          end
+
+          type generic_model_config_object =
+            {
+              model_name: String,
+              api_key: String,
+              base_url: String,
+              headers: ::Hash[Symbol, String],
+              provider: Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider
+            }
+
+          class GenericModelConfigObject < Stagehand::Internal::Type::BaseModel
+            attr_accessor model_name: String
+
+            attr_reader api_key: String?
+
+            def api_key=: (String) -> String
+
+            attr_reader base_url: String?
+
+            def base_url=: (String) -> String
+
+            attr_reader headers: ::Hash[Symbol, String]?
+
+            def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
+            attr_reader provider: Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider?
+
+            def provider=: (
+              Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider
+            ) -> Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider
+
+            def initialize: (
+              model_name: String,
+              ?api_key: String,
+              ?base_url: String,
+              ?headers: ::Hash[Symbol, String],
+              ?provider: Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider
+            ) -> void
+
+            def to_hash: -> {
+              model_name: String,
+              api_key: String,
+              base_url: String,
+              headers: ::Hash[Symbol, String],
+              provider: Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider
+            }
+
+            type provider =
+              :openai | :anthropic | :google | :microsoft | :bedrock
+
+            module Provider
+              extend Stagehand::Internal::Type::Enum
+
+              OPENAI: :openai
+              ANTHROPIC: :anthropic
+              GOOGLE: :google
+              MICROSOFT: :microsoft
+              BEDROCK: :bedrock
+
+              def self?.values: -> ::Array[Stagehand::Models::SessionObserveParams::Options::Model::GenericModelConfigObject::provider]
+            end
+          end
+
           def self?.variants: -> ::Array[Stagehand::Models::SessionObserveParams::Options::model]
         end
 

data/sig/stagehand/models/session_start_params.rbs

@@ -450,12 +450,16 @@ module Stagehand
           {
             advanced_stealth: bool,
             block_ads: bool,
+            captcha_image_selector: String,
+            captcha_input_selector: String,
             context: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context,
             extension_id: String,
             fingerprint: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Fingerprint,
             log_session: bool,
+            os: Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os,
             record_session: bool,
             solve_captchas: bool,
+            verified: bool,
             viewport: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport
           }
 
@@ -468,6 +472,14 @@ module Stagehand
 
           def block_ads=: (bool) -> bool
 
+          attr_reader captcha_image_selector: String?
+
+          def captcha_image_selector=: (String) -> String
+
+          attr_reader captcha_input_selector: String?
+
+          def captcha_input_selector=: (String) -> String
+
           attr_reader context: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context?
 
           def context=: (
@@ -488,6 +500,12 @@ module Stagehand
 
           def log_session=: (bool) -> bool
 
+          attr_reader os: Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os?
+
+          def os=: (
+            Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os
+          ) -> Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os
+
           attr_reader record_session: bool?
 
           def record_session=: (bool) -> bool
@@ -496,6 +514,10 @@ module Stagehand
 
           def solve_captchas=: (bool) -> bool
 
+          attr_reader verified: bool?
+
+          def verified=: (bool) -> bool
+
           attr_reader viewport: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport?
 
           def viewport=: (
@@ -505,24 +527,32 @@ module Stagehand
           def initialize: (
             ?advanced_stealth: bool,
             ?block_ads: bool,
+            ?captcha_image_selector: String,
+            ?captcha_input_selector: String,
             ?context: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context,
             ?extension_id: String,
             ?fingerprint: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Fingerprint,
             ?log_session: bool,
+            ?os: Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os,
             ?record_session: bool,
             ?solve_captchas: bool,
+            ?verified: bool,
             ?viewport: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport
           ) -> void
 
           def to_hash: -> {
             advanced_stealth: bool,
             block_ads: bool,
+            captcha_image_selector: String,
+            captcha_input_selector: String,
             context: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context,
             extension_id: String,
             fingerprint: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Fingerprint,
             log_session: bool,
+            os: Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os,
             record_session: bool,
             solve_captchas: bool,
+            verified: bool,
             viewport: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport
           }
 
@@ -693,6 +723,20 @@ module Stagehand
             end
           end
 
+          type os = :windows | :mac | :linux | :mobile | :tablet
+
+          module Os
+            extend Stagehand::Internal::Type::Enum
+
+            WINDOWS: :windows
+            MAC: :mac
+            LINUX: :linux
+            MOBILE: :mobile
+            TABLET: :tablet
+
+            def self?.values: -> ::Array[Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::os]
+          end
+
           type viewport = { height: Float, width: Float }
 
           class Viewport < Stagehand::Internal::Type::BaseModel

data/sig/stagehand/models.rbs

@@ -1,7 +1,7 @@
 module Stagehand
   class Action = Stagehand::Models::Action
 
-  class ModelConfig = Stagehand::Models::ModelConfig
+  module ModelConfig = Stagehand::Models::ModelConfig
 
   class SessionActParams = Stagehand::Models::SessionActParams
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stagehand
 version: !ruby/object:Gem::Version
-  version: 3.19.3
+  version: 3.21.0
 platform: ruby
 authors:
 - Stagehand
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi