feat: [feat]: add ignoreSelectors to observe()

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-49b40c7425adba9e67fc102838c5216c45ca1f7ef4c10823c5665fd413538504.yml
-openapi_spec_hash: 6880dc029df2e88dfe8943c0dec5a3a5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-eae8400fade7b2c8329c4148f56de92e147c34c0feecb420c015aab6544a9acc.yml
+openapi_spec_hash: 0a9eff1ac1d464e89cbd9db64709b08a
 config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

src/Sessions/SessionObserveParams/Options.php

@@ -17,6 +17,7 @@
  * @phpstan-import-type VariableShape from \Stagehand\Sessions\SessionObserveParams\Options\Variable
  *
  * @phpstan-type OptionsShape = array{
+ *   ignoreSelectors?: list<string>|null,
  *   model?: ModelShape|null,
  *   selector?: string|null,
  *   timeout?: float|null,
@@ -28,6 +29,14 @@ final class Options implements BaseModel
     /** @use SdkModel<OptionsShape> */
     use SdkModel;
 
+    /**
+     * Selectors for elements and subtrees that should be excluded from observation.
+     *
+     * @var list<string>|null $ignoreSelectors
+     */
+    #[Optional(list: 'string')]
+    public ?array $ignoreSelectors;
+
     /**
      * Model configuration object or model name string (e.g., 'openai/gpt-5-nano').
      *
@@ -66,17 +75,20 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param list<string>|null $ignoreSelectors
      * @param ModelShape|null $model
      * @param array<string,VariableShape>|null $variables
      */
     public static function with(
+        ?array $ignoreSelectors = null,
         string|ModelConfig|array|null $model = null,
         ?string $selector = null,
         ?float $timeout = null,
         ?array $variables = null,
     ): self {
         $self = new self;
 
+        null !== $ignoreSelectors && $self['ignoreSelectors'] = $ignoreSelectors;
         null !== $model && $self['model'] = $model;
         null !== $selector && $self['selector'] = $selector;
         null !== $timeout && $self['timeout'] = $timeout;
@@ -85,6 +97,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Selectors for elements and subtrees that should be excluded from observation.
+     *
+     * @param list<string> $ignoreSelectors
+     */
+    public function withIgnoreSelectors(array $ignoreSelectors): self
+    {
+        $self = clone $this;
+        $self['ignoreSelectors'] = $ignoreSelectors;
+
+        return $self;
+    }
+
     /**
      * Model configuration object or model name string (e.g., 'openai/gpt-5-nano').
      *