feat: Add screenshot option to Extract

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/stagehand-e77d6b15f0a94b16a54ef87a84d2cabe49eb11cff5ceba76f00dd788ff483eab.yml
-openapi_spec_hash: a1dab7fe72a772d188a15305124ebd73
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-80502d74c1be605e77d45ff2b54297fe34ce85dbad1e8f2dfa30ba6d09601219.yml
+openapi_spec_hash: fd62f768756a400c3ecd695bfcf3845a
 config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

src/Sessions/SessionExtractParams/Options.php

@@ -16,6 +16,7 @@
  * @phpstan-type OptionsShape = array{
  *   ignoreSelectors?: list<string>|null,
  *   model?: ModelShape|null,
+ *   screenshot?: bool|null,
  *   selector?: string|null,
  *   timeout?: float|null,
  * }
@@ -41,6 +42,12 @@ final class Options implements BaseModel
     #[Optional]
     public string|ModelConfig|null $model;
 
+    /**
+     * When true, include a screenshot of the current viewport in the extraction LLM call. Defaults to false.
+     */
+    #[Optional]
+    public ?bool $screenshot;
+
     /**
      * CSS selector to scope extraction to a specific element.
      */
@@ -69,13 +76,15 @@ public function __construct()
     public static function with(
         ?array $ignoreSelectors = null,
         string|ModelConfig|array|null $model = null,
+        ?bool $screenshot = null,
         ?string $selector = null,
         ?float $timeout = null,
     ): self {
         $self = new self;
 
         null !== $ignoreSelectors && $self['ignoreSelectors'] = $ignoreSelectors;
         null !== $model && $self['model'] = $model;
+        null !== $screenshot && $self['screenshot'] = $screenshot;
         null !== $selector && $self['selector'] = $selector;
         null !== $timeout && $self['timeout'] = $timeout;
 
@@ -108,6 +117,17 @@ public function withModel(string|ModelConfig|array $model): self
         return $self;
     }
 
+    /**
+     * When true, include a screenshot of the current viewport in the extraction LLM call. Defaults to false.
+     */
+    public function withScreenshot(bool $screenshot): self
+    {
+        $self = clone $this;
+        $self['screenshot'] = $screenshot;
+
+        return $self;
+    }
+
     /**
      * CSS selector to scope extraction to a specific element.
      */