feat: [STG-1798] feat: support Browserbase verified sessions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-7773ef4ca29c983daafb787ee918cfa6b5b12c5bbdc088308653f2737c26e51f.yml
-openapi_spec_hash: 47fc8f2540be0b6374e4230c021072d9
-config_hash: 0cc516caf1432087f40654336e0fa8cd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-a8db51c6460b3daff67b35262517848a0d4e783c6805c2edd531b155a5db71dd.yml
+openapi_spec_hash: c6e7127f211f946673d6389e1d8db1ba
+config_hash: a962ae71493deb11a1c903256fb25386

lib/stagehand/models/session_start_params.rb

@@ -415,6 +415,16 @@ class BrowserSettings < Stagehand::Internal::Type::BaseModel
           #   @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]
@@ -437,6 +447,12 @@ class BrowserSettings < Stagehand::Internal::Type::BaseModel
           #   @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]
@@ -447,21 +463,30 @@ class BrowserSettings < Stagehand::Internal::Type::BaseModel
           #   @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
@@ -610,6 +635,20 @@ class Screen < Stagehand::Internal::Type::BaseModel
             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

rbi/stagehand/models/session_start_params.rbi

@@ -842,6 +842,18 @@ module Stagehand
           sig { params(block_ads: T::Boolean).void }
           attr_writer :block_ads
 
+          sig { returns(T.nilable(String)) }
+          attr_reader :captcha_image_selector
+
+          sig { params(captcha_image_selector: String).void }
+          attr_writer :captcha_image_selector
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :captcha_input_selector
+
+          sig { params(captcha_input_selector: String).void }
+          attr_writer :captcha_input_selector
+
           sig do
             returns(
               T.nilable(
@@ -888,6 +900,23 @@ module Stagehand
           sig { params(log_session: T::Boolean).void }
           attr_writer :log_session
 
+          sig do
+            returns(
+              T.nilable(
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::OrSymbol
+              )
+            )
+          end
+          attr_reader :os
+
+          sig do
+            params(
+              os:
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::OrSymbol
+            ).void
+          end
+          attr_writer :os
+
           sig { returns(T.nilable(T::Boolean)) }
           attr_reader :record_session
 
@@ -900,6 +929,12 @@ module Stagehand
           sig { params(solve_captchas: T::Boolean).void }
           attr_writer :solve_captchas
 
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :verified
+
+          sig { params(verified: T::Boolean).void }
+          attr_writer :verified
+
           sig do
             returns(
               T.nilable(
@@ -921,27 +956,36 @@ module Stagehand
             params(
               advanced_stealth: T::Boolean,
               block_ads: T::Boolean,
+              captcha_image_selector: String,
+              captcha_input_selector: String,
               context:
                 Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Context::OrHash,
               extension_id: String,
               fingerprint:
                 Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Fingerprint::OrHash,
               log_session: T::Boolean,
+              os:
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::OrSymbol,
               record_session: T::Boolean,
               solve_captchas: T::Boolean,
+              verified: T::Boolean,
               viewport:
                 Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport::OrHash
             ).returns(T.attached_class)
           end
           def self.new(
             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
           )
           end
@@ -951,14 +995,19 @@ module Stagehand
               {
                 advanced_stealth: T::Boolean,
                 block_ads: T::Boolean,
+                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: T::Boolean,
+                os:
+                  Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::OrSymbol,
                 record_session: T::Boolean,
                 solve_captchas: T::Boolean,
+                verified: T::Boolean,
                 viewport:
                   Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Viewport
               }
@@ -1390,6 +1439,55 @@ module Stagehand
             end
           end
 
+          module Os
+            extend Stagehand::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            WINDOWS =
+              T.let(
+                :windows,
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+              )
+            MAC =
+              T.let(
+                :mac,
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+              )
+            LINUX =
+              T.let(
+                :linux,
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+              )
+            MOBILE =
+              T.let(
+                :mobile,
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+              )
+            TABLET =
+              T.let(
+                :tablet,
+                Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::BrowserSettings::Os::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
           class Viewport < Stagehand::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

sig/stagehand/models/session_start_params.rbs

@@ -459,12 +459,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
           }
 
@@ -477,6 +481,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=: (
@@ -497,6 +509,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
@@ -505,6 +523,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=: (
@@ -514,24 +536,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
           }
 
@@ -702,6 +732,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