feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-f23ab92b85d838bfa0c2741f96f4bf7acf09a22cc17aa88d78ae8a1cafb0c7f0.yml
-openapi_spec_hash: 641b62af26fa7bc744bbebc50aeb2ac6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-a0e9f5a245a9ad4bf712a35826463af573957da6d3714136cfab643140664566.yml
+openapi_spec_hash: 20f2776cd458320c8b66fec4ec4f9332
 config_hash: 0fb0ceca5946298c416cec0cca5260c7

src/context/dev/resources/web.py

@@ -386,6 +386,7 @@ def extract_styleguide(
     def screenshot(
         self,
         *,
+        clear_popups: bool | Omit = omit,
         color_scheme: Literal["light", "dark"] | Omit = omit,
         country: Literal[
             "ad",
@@ -617,6 +618,12 @@ def screenshot(
         Capture a screenshot of a website.
 
         Args:
+          clear_popups: Optional parameter for comprehensive popup cleanup. If 'true', the browser
+              dismisses detected cookie/consent UI and clears other detected obstructive
+              popups and overlays before capture. If 'false' or not provided, this parameter
+              requests no cleanup; handleCookiePopup can still request cookie/consent handling
+              independently.
+
           color_scheme: Optional parameter to choose the site's visual theme in the screenshot. Use
               'light' or 'dark' when the site offers both appearances.
 
@@ -692,6 +699,7 @@ def screenshot(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "clear_popups": clear_popups,
                         "color_scheme": color_scheme,
                         "country": country,
                         "direct_url": direct_url,
@@ -2616,6 +2624,7 @@ async def extract_styleguide(
     async def screenshot(
         self,
         *,
+        clear_popups: bool | Omit = omit,
         color_scheme: Literal["light", "dark"] | Omit = omit,
         country: Literal[
             "ad",
@@ -2847,6 +2856,12 @@ async def screenshot(
         Capture a screenshot of a website.
 
         Args:
+          clear_popups: Optional parameter for comprehensive popup cleanup. If 'true', the browser
+              dismisses detected cookie/consent UI and clears other detected obstructive
+              popups and overlays before capture. If 'false' or not provided, this parameter
+              requests no cleanup; handleCookiePopup can still request cookie/consent handling
+              independently.
+
           color_scheme: Optional parameter to choose the site's visual theme in the screenshot. Use
               'light' or 'dark' when the site offers both appearances.
 
@@ -2922,6 +2937,7 @@ async def screenshot(
                 timeout=timeout,
                 query=await async_maybe_transform(
                     {
+                        "clear_popups": clear_popups,
                         "color_scheme": color_scheme,
                         "country": country,
                         "direct_url": direct_url,

src/context/dev/types/web_screenshot_params.py

@@ -12,6 +12,15 @@
 
 
 class WebScreenshotParams(TypedDict, total=False):
+    clear_popups: Annotated[bool, PropertyInfo(alias="clearPopups")]
+    """Optional parameter for comprehensive popup cleanup.
+
+    If 'true', the browser dismisses detected cookie/consent UI and clears other
+    detected obstructive popups and overlays before capture. If 'false' or not
+    provided, this parameter requests no cleanup; handleCookiePopup can still
+    request cookie/consent handling independently.
+    """
+
     color_scheme: Annotated[Literal["light", "dark"], PropertyInfo(alias="colorScheme")]
     """Optional parameter to choose the site's visual theme in the screenshot.
 

tests/api_resources/test_web.py

@@ -248,6 +248,7 @@ def test_method_screenshot(self, client: ContextDev) -> None:
     @parametrize
     def test_method_screenshot_with_all_params(self, client: ContextDev) -> None:
         web = client.web.screenshot(
+            clear_popups=True,
             color_scheme="light",
             country="de",
             direct_url="https://example.com",
@@ -894,6 +895,7 @@ async def test_method_screenshot(self, async_client: AsyncContextDev) -> None:
     @parametrize
     async def test_method_screenshot_with_all_params(self, async_client: AsyncContextDev) -> None:
         web = await async_client.web.screenshot(
+            clear_popups=True,
             color_scheme="light",
             country="de",
             direct_url="https://example.com",