feat: [feat]: add ignoreSelectors 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-dbbff1a35360850898f7d60588e257faeac145a73cfcae634cfeb1b70109b6af.yml
-openapi_spec_hash: 28c4b734a5309067c39bb4c4b709b9ab
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-7182c741edd5e22cda9bd855d31ca7e60a97a409222bb887edf87b9ce15dd493.yml
+openapi_spec_hash: 174581867a9191c491b22855b64c4f19
 config_hash: a962ae71493deb11a1c903256fb25386

src/stagehand/types/session_extract_params.py

@@ -5,6 +5,7 @@
 from typing import Dict, Union, Optional
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 from .model_config_param import ModelConfigParam
 
@@ -37,6 +38,9 @@ class SessionExtractParamsBase(TypedDict, total=False):
 
 
 class Options(TypedDict, total=False):
+    ignore_selectors: Annotated[SequenceNotStr[str], PropertyInfo(alias="ignoreSelectors")]
+    """Selectors for elements and subtrees that should be excluded from extraction"""
+
     model: OptionsModel
     """Model configuration object or model name string (e.g., 'openai/gpt-5-nano')"""
 

tests/api_resources/test_sessions.py

@@ -443,6 +443,7 @@ def test_method_extract_with_all_params_overload_1(self, client: Stagehand) -> N
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
+                "ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
                 "model": {
                     "model_name": "openai/gpt-5.4-mini",
                     "api_key": "sk-some-openai-api-key",
@@ -511,6 +512,7 @@ def test_method_extract_with_all_params_overload_2(self, client: Stagehand) -> N
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
+                "ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
                 "model": {
                     "model_name": "openai/gpt-5.4-mini",
                     "api_key": "sk-some-openai-api-key",
@@ -1373,6 +1375,7 @@ async def test_method_extract_with_all_params_overload_1(self, async_client: Asy
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
+                "ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
                 "model": {
                     "model_name": "openai/gpt-5.4-mini",
                     "api_key": "sk-some-openai-api-key",
@@ -1441,6 +1444,7 @@ async def test_method_extract_with_all_params_overload_2(self, async_client: Asy
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
+                "ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
                 "model": {
                     "model_name": "openai/gpt-5.4-mini",
                     "api_key": "sk-some-openai-api-key",