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

src/Sessions/SessionStartParams/BrowserbaseSessionCreateParams/BrowserSettings.php

@@ -9,6 +9,7 @@
 use Stagehand\Core\Contracts\BaseModel;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Context;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint;
+use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Os;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Viewport;
 
 /**
@@ -19,12 +20,16 @@
  * @phpstan-type BrowserSettingsShape = array{
  *   advancedStealth?: bool|null,
  *   blockAds?: bool|null,
+ *   captchaImageSelector?: string|null,
+ *   captchaInputSelector?: string|null,
  *   context?: null|Context|ContextShape,
  *   extensionID?: string|null,
  *   fingerprint?: null|Fingerprint|FingerprintShape,
  *   logSession?: bool|null,
+ *   os?: null|Os|value-of<Os>,
  *   recordSession?: bool|null,
  *   solveCaptchas?: bool|null,
+ *   verified?: bool|null,
  *   viewport?: null|Viewport|ViewportShape,
  * }
  */
@@ -39,6 +44,12 @@ final class BrowserSettings implements BaseModel
     #[Optional]
     public ?bool $blockAds;
 
+    #[Optional]
+    public ?string $captchaImageSelector;
+
+    #[Optional]
+    public ?string $captchaInputSelector;
+
     #[Optional]
     public ?Context $context;
 
@@ -51,12 +62,19 @@ final class BrowserSettings implements BaseModel
     #[Optional]
     public ?bool $logSession;
 
+    /** @var value-of<Os>|null $os */
+    #[Optional(enum: Os::class)]
+    public ?string $os;
+
     #[Optional]
     public ?bool $recordSession;
 
     #[Optional]
     public ?bool $solveCaptchas;
 
+    #[Optional]
+    public ?bool $verified;
+
     #[Optional]
     public ?Viewport $viewport;
 
@@ -72,29 +90,38 @@ public function __construct()
      *
      * @param Context|ContextShape|null $context
      * @param Fingerprint|FingerprintShape|null $fingerprint
+     * @param Os|value-of<Os>|null $os
      * @param Viewport|ViewportShape|null $viewport
      */
     public static function with(
         ?bool $advancedStealth = null,
         ?bool $blockAds = null,
+        ?string $captchaImageSelector = null,
+        ?string $captchaInputSelector = null,
         Context|array|null $context = null,
         ?string $extensionID = null,
         Fingerprint|array|null $fingerprint = null,
         ?bool $logSession = null,
+        Os|string|null $os = null,
         ?bool $recordSession = null,
         ?bool $solveCaptchas = null,
+        ?bool $verified = null,
         Viewport|array|null $viewport = null,
     ): self {
         $self = new self;
 
         null !== $advancedStealth && $self['advancedStealth'] = $advancedStealth;
         null !== $blockAds && $self['blockAds'] = $blockAds;
+        null !== $captchaImageSelector && $self['captchaImageSelector'] = $captchaImageSelector;
+        null !== $captchaInputSelector && $self['captchaInputSelector'] = $captchaInputSelector;
         null !== $context && $self['context'] = $context;
         null !== $extensionID && $self['extensionID'] = $extensionID;
         null !== $fingerprint && $self['fingerprint'] = $fingerprint;
         null !== $logSession && $self['logSession'] = $logSession;
+        null !== $os && $self['os'] = $os;
         null !== $recordSession && $self['recordSession'] = $recordSession;
         null !== $solveCaptchas && $self['solveCaptchas'] = $solveCaptchas;
+        null !== $verified && $self['verified'] = $verified;
         null !== $viewport && $self['viewport'] = $viewport;
 
         return $self;
@@ -116,6 +143,22 @@ public function withBlockAds(bool $blockAds): self
         return $self;
     }
 
+    public function withCaptchaImageSelector(string $captchaImageSelector): self
+    {
+        $self = clone $this;
+        $self['captchaImageSelector'] = $captchaImageSelector;
+
+        return $self;
+    }
+
+    public function withCaptchaInputSelector(string $captchaInputSelector): self
+    {
+        $self = clone $this;
+        $self['captchaInputSelector'] = $captchaInputSelector;
+
+        return $self;
+    }
+
     /**
      * @param Context|ContextShape $context
      */
@@ -154,6 +197,17 @@ public function withLogSession(bool $logSession): self
         return $self;
     }
 
+    /**
+     * @param Os|value-of<Os> $os
+     */
+    public function withOs(Os|string $os): self
+    {
+        $self = clone $this;
+        $self['os'] = $os;
+
+        return $self;
+    }
+
     public function withRecordSession(bool $recordSession): self
     {
         $self = clone $this;
@@ -170,6 +224,14 @@ public function withSolveCaptchas(bool $solveCaptchas): self
         return $self;
     }
 
+    public function withVerified(bool $verified): self
+    {
+        $self = clone $this;
+        $self['verified'] = $verified;
+
+        return $self;
+    }
+
     /**
      * @param Viewport|ViewportShape $viewport
      */

src/Sessions/SessionStartParams/BrowserbaseSessionCreateParams/BrowserSettings/Os.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings;
+
+enum Os: string
+{
+    case WINDOWS = 'windows';
+
+    case MAC = 'mac';
+
+    case LINUX = 'linux';
+
+    case MOBILE = 'mobile';
+
+    case TABLET = 'tablet';
+}

tests/Services/SessionsTest.php

@@ -314,6 +314,8 @@ public function testStartWithOptionalParams(): void
                 'browserSettings' => [
                     'advancedStealth' => true,
                     'blockAds' => true,
+                    'captchaImageSelector' => 'captchaImageSelector',
+                    'captchaInputSelector' => 'captchaInputSelector',
                     'context' => ['id' => 'id', 'persist' => true],
                     'extensionID' => 'extensionId',
                     'fingerprint' => [
@@ -330,8 +332,10 @@ public function testStartWithOptionalParams(): void
                         ],
                     ],
                     'logSession' => true,
+                    'os' => 'windows',
                     'recordSession' => true,
                     'solveCaptchas' => true,
+                    'verified' => true,
                     'viewport' => ['height' => 0, 'width' => 0],
                 ],
                 'extensionID' => 'extensionId',