feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-d571232203ef4e00986a3245224267db6f8aaffdad57780f712e0694dc8d9e37.yml
-openapi_spec_hash: d5d635dd7b24a2e1255c6f2a895253ff
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-817d1d4e845b1946dac8ee10fd34b3f533aa36f74ac598582ffb1b0399a5a932.yml
+openapi_spec_hash: 9d856db62b34909fec94743235b3d7be
 config_hash: 88e87ba7021be93d267ecfc8f5e6b891

src/ServiceContracts/SessionsContract.php

@@ -21,6 +21,7 @@
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint\HTTPVersion;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint\OperatingSystem;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\Region;
+use Stagehand\Sessions\SessionStartParams\Verbose;
 use Stagehand\Sessions\SessionStartResponse;
 
 interface SessionsContract
@@ -270,7 +271,7 @@ public function observe(
      * @param bool $experimental Body param:
      * @param bool $selfHeal Body param: Enable self-healing for failed actions
      * @param string $systemPrompt Body param: Custom system prompt for AI operations
-     * @param int $verbose Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
+     * @param 0|1|2|Verbose $verbose Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
      * @param bool $waitForCaptchaSolves Body param:
      * @param 'typescript'|'python'|'playground'|\Stagehand\Sessions\SessionStartParams\XLanguage $xLanguage Header param: Client SDK language
      * @param string $xSDKVersion Header param: Version of the Stagehand SDK
@@ -290,7 +291,7 @@ public function start(
         ?bool $experimental = null,
         ?bool $selfHeal = null,
         ?string $systemPrompt = null,
-        ?int $verbose = null,
+        int|Verbose|null $verbose = null,
         ?bool $waitForCaptchaSolves = null,
         string|\Stagehand\Sessions\SessionStartParams\XLanguage|null $xLanguage = null,
         ?string $xSDKVersion = null,

src/Services/SessionsRawService.php

@@ -29,6 +29,7 @@
 use Stagehand\Sessions\SessionStartParams\Browser\Type;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint\HTTPVersion;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\Region;
+use Stagehand\Sessions\SessionStartParams\Verbose;
 use Stagehand\Sessions\SessionStartResponse;
 
 final class SessionsRawService implements SessionsRawContract
@@ -444,7 +445,7 @@ public function observe(
      *   experimental?: bool,
      *   selfHeal?: bool,
      *   systemPrompt?: string,
-     *   verbose?: int,
+     *   verbose?: 0|1|2|Verbose,
      *   waitForCaptchaSolves?: bool,
      *   xLanguage?: 'typescript'|'python'|'playground'|SessionStartParams\XLanguage,
      *   xSDKVersion?: string,

src/Services/SessionsService.php

@@ -24,6 +24,7 @@
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint\HTTPVersion;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\BrowserSettings\Fingerprint\OperatingSystem;
 use Stagehand\Sessions\SessionStartParams\BrowserbaseSessionCreateParams\Region;
+use Stagehand\Sessions\SessionStartParams\Verbose;
 use Stagehand\Sessions\SessionStartResponse;
 
 final class SessionsService implements SessionsContract
@@ -400,7 +401,7 @@ public function observe(
      * @param bool $experimental Body param:
      * @param bool $selfHeal Body param: Enable self-healing for failed actions
      * @param string $systemPrompt Body param: Custom system prompt for AI operations
-     * @param int $verbose Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
+     * @param 0|1|2|Verbose $verbose Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
      * @param bool $waitForCaptchaSolves Body param:
      * @param 'typescript'|'python'|'playground'|\Stagehand\Sessions\SessionStartParams\XLanguage $xLanguage Header param: Client SDK language
      * @param string $xSDKVersion Header param: Version of the Stagehand SDK
@@ -420,7 +421,7 @@ public function start(
         ?bool $experimental = null,
         ?bool $selfHeal = null,
         ?string $systemPrompt = null,
-        ?int $verbose = null,
+        int|Verbose|null $verbose = null,
         ?bool $waitForCaptchaSolves = null,
         string|\Stagehand\Sessions\SessionStartParams\XLanguage|null $xLanguage = null,
         ?string $xSDKVersion = null,

src/Sessions/ModelConfig.php

@@ -7,12 +7,14 @@
 use Stagehand\Core\Concerns\SdkUnion;
 use Stagehand\Core\Conversion\Contracts\Converter;
 use Stagehand\Core\Conversion\Contracts\ConverterSource;
-use Stagehand\Sessions\ModelConfig\UnionMember1;
+use Stagehand\Sessions\ModelConfig\ModelConfigObject;
 
 /**
- * @phpstan-import-type UnionMember1Shape from \Stagehand\Sessions\ModelConfig\UnionMember1
+ * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
  *
- * @phpstan-type ModelConfigShape = string|UnionMember1Shape
+ * @phpstan-import-type ModelConfigObjectShape from \Stagehand\Sessions\ModelConfig\ModelConfigObject
+ *
+ * @phpstan-type ModelConfigShape = string|ModelConfigObjectShape
  */
 final class ModelConfig implements ConverterSource
 {
@@ -23,6 +25,6 @@ final class ModelConfig implements ConverterSource
      */
     public static function variants(): array
     {
-        return ['string', UnionMember1::class];
+        return ['string', ModelConfigObject::class];
     }
 }

src/Sessions/ModelConfig/UnionMember1.php …ssions/ModelConfig/ModelConfigObject.phpsrc/Sessions/ModelConfig/UnionMember1.php renamed to src/Sessions/ModelConfig/ModelConfigObject.php src/Sessions/ModelConfig/UnionMember1.php renamed to src/Sessions/ModelConfig/ModelConfigObject.php

@@ -10,36 +10,45 @@
 use Stagehand\Core\Contracts\BaseModel;
 
 /**
- * @phpstan-type UnionMember1Shape = array{
+ * @phpstan-type ModelConfigObjectShape = array{
  *   modelName: string, apiKey?: string|null, baseURL?: string|null
  * }
  */
-final class UnionMember1 implements BaseModel
+final class ModelConfigObject implements BaseModel
 {
-    /** @use SdkModel<UnionMember1Shape> */
+    /** @use SdkModel<ModelConfigObjectShape> */
     use SdkModel;
 
+    /**
+     * Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus').
+     */
     #[Required]
     public string $modelName;
 
+    /**
+     * API key for the model provider.
+     */
     #[Optional]
     public ?string $apiKey;
 
+    /**
+     * Base URL for the model provider.
+     */
     #[Optional]
     public ?string $baseURL;
 
     /**
-     * `new UnionMember1()` is missing required properties by the API.
+     * `new ModelConfigObject()` is missing required properties by the API.
      *
      * To enforce required parameters use
      * ```
-     * UnionMember1::with(modelName: ...)
+     * ModelConfigObject::with(modelName: ...)
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new UnionMember1)->withModelName(...)
+     * (new ModelConfigObject)->withModelName(...)
      * ```
      */
     public function __construct()
@@ -67,6 +76,9 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus').
+     */
     public function withModelName(string $modelName): self
     {
         $self = clone $this;
@@ -75,6 +87,9 @@ public function withModelName(string $modelName): self
         return $self;
     }
 
+    /**
+     * API key for the model provider.
+     */
     public function withAPIKey(string $apiKey): self
     {
         $self = clone $this;
@@ -83,6 +98,9 @@ public function withAPIKey(string $apiKey): self
         return $self;
     }
 
+    /**
+     * Base URL for the model provider.
+     */
     public function withBaseURL(string $baseURL): self
     {
         $self = clone $this;

src/Sessions/SessionActParams/Options.php

@@ -7,7 +7,7 @@
 use Stagehand\Core\Attributes\Optional;
 use Stagehand\Core\Concerns\SdkModel;
 use Stagehand\Core\Contracts\BaseModel;
-use Stagehand\Sessions\ModelConfig\UnionMember1;
+use Stagehand\Sessions\ModelConfig\ModelConfigObject;
 
 /**
  * @phpstan-import-type ModelConfigShape from \Stagehand\Sessions\ModelConfig
@@ -23,8 +23,11 @@ final class Options implements BaseModel
     /** @use SdkModel<OptionsShape> */
     use SdkModel;
 
+    /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     */
     #[Optional]
-    public string|UnionMember1|null $model;
+    public string|ModelConfigObject|null $model;
 
     /**
      * Timeout in ms for the action.
@@ -54,7 +57,7 @@ public function __construct()
      * @param array<string,string> $variables
      */
     public static function with(
-        string|UnionMember1|array|null $model = null,
+        string|ModelConfigObject|array|null $model = null,
         ?float $timeout = null,
         ?array $variables = null,
     ): self {
@@ -68,9 +71,11 @@ public static function with(
     }
 
     /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     *
      * @param ModelConfigShape $model
      */
-    public function withModel(string|UnionMember1|array $model): self
+    public function withModel(string|ModelConfigObject|array $model): self
     {
         $self = clone $this;
         $self['model'] = $model;

src/Sessions/SessionEndResponse.php

@@ -16,9 +16,26 @@ final class SessionEndResponse implements BaseModel
     /** @use SdkModel<SessionEndResponseShape> */
     use SdkModel;
 
+    /**
+     * Indicates whether the request was successful.
+     */
     #[Required]
-    public bool $success = true;
+    public bool $success;
 
+    /**
+     * `new SessionEndResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * SessionEndResponse::with(success: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new SessionEndResponse)->withSuccess(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -29,8 +46,23 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      */
-    public static function with(): self
+    public static function with(bool $success): self
     {
-        return new self;
+        $self = new self;
+
+        $self['success'] = $success;
+
+        return $self;
+    }
+
+    /**
+     * Indicates whether the request was successful.
+     */
+    public function withSuccess(bool $success): self
+    {
+        $self = clone $this;
+        $self['success'] = $success;
+
+        return $self;
     }
 }

src/Sessions/SessionExecuteParams/AgentConfig.php

@@ -7,7 +7,7 @@
 use Stagehand\Core\Attributes\Optional;
 use Stagehand\Core\Concerns\SdkModel;
 use Stagehand\Core\Contracts\BaseModel;
-use Stagehand\Sessions\ModelConfig\UnionMember1;
+use Stagehand\Sessions\ModelConfig\ModelConfigObject;
 
 /**
  * @phpstan-import-type ModelConfigShape from \Stagehand\Sessions\ModelConfig
@@ -27,8 +27,11 @@ final class AgentConfig implements BaseModel
     #[Optional]
     public ?bool $cua;
 
+    /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     */
     #[Optional]
-    public string|UnionMember1|null $model;
+    public string|ModelConfigObject|null $model;
 
     /**
      * Custom system prompt for the agent.
@@ -50,7 +53,7 @@ public function __construct()
      */
     public static function with(
         ?bool $cua = null,
-        string|UnionMember1|array|null $model = null,
+        string|ModelConfigObject|array|null $model = null,
         ?string $systemPrompt = null,
     ): self {
         $self = new self;
@@ -74,9 +77,11 @@ public function withCua(bool $cua): self
     }
 
     /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     *
      * @param ModelConfigShape $model
      */
-    public function withModel(string|UnionMember1|array $model): self
+    public function withModel(string|ModelConfigObject|array $model): self
     {
         $self = clone $this;
         $self['model'] = $model;

src/Sessions/SessionExtractParams/Options.php

@@ -7,7 +7,7 @@
 use Stagehand\Core\Attributes\Optional;
 use Stagehand\Core\Concerns\SdkModel;
 use Stagehand\Core\Contracts\BaseModel;
-use Stagehand\Sessions\ModelConfig\UnionMember1;
+use Stagehand\Sessions\ModelConfig\ModelConfigObject;
 
 /**
  * @phpstan-import-type ModelConfigShape from \Stagehand\Sessions\ModelConfig
@@ -21,8 +21,11 @@ final class Options implements BaseModel
     /** @use SdkModel<OptionsShape> */
     use SdkModel;
 
+    /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     */
     #[Optional]
-    public string|UnionMember1|null $model;
+    public string|ModelConfigObject|null $model;
 
     /**
      * CSS selector to scope extraction to a specific element.
@@ -49,7 +52,7 @@ public function __construct()
      * @param ModelConfigShape $model
      */
     public static function with(
-        string|UnionMember1|array|null $model = null,
+        string|ModelConfigObject|array|null $model = null,
         ?string $selector = null,
         ?float $timeout = null,
     ): self {
@@ -63,9 +66,11 @@ public static function with(
     }
 
     /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus').
+     *
      * @param ModelConfigShape $model
      */
-    public function withModel(string|UnionMember1|array $model): self
+    public function withModel(string|ModelConfigObject|array $model): self
     {
         $self = clone $this;
         $self['model'] = $model;