feat: add force flag to viewport resize to bypass live view/recording check

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 103
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2ba004ce5444b5f8abe3bcf66fd7c6da394bc964e8b2bf197576841135a48046.yml
-openapi_spec_hash: f156ea2ae35e4d148704c6e4ce051239
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ef24d4bf172555bcbe8e3b432c644a25a1c6afd99c958a2eda8c3b1ea9568113.yml
+openapi_spec_hash: b603c5a983e837928fa7d1100ed64fc9
 config_hash: cff4d43372b6fa66b64e2d4150f6aa76

src/kernel/resources/browsers/browsers.py

@@ -284,7 +284,7 @@ def update(
         *,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        viewport: BrowserViewport | Omit = omit,
+        viewport: browser_update_params.Viewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -711,7 +711,7 @@ async def update(
         *,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        viewport: BrowserViewport | Omit = omit,
+        viewport: browser_update_params.Viewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,

src/kernel/types/browser_update_params.py

@@ -8,7 +8,7 @@
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
 
-__all__ = ["BrowserUpdateParams"]
+__all__ = ["BrowserUpdateParams", "Viewport"]
 
 
 class BrowserUpdateParams(TypedDict, total=False):
@@ -24,5 +24,17 @@ class BrowserUpdateParams(TypedDict, total=False):
     Omit to leave unchanged, set to empty string to remove proxy.
     """
 
-    viewport: BrowserViewport
+    viewport: Viewport
     """Viewport configuration to apply to the browser session."""
+
+
+class Viewport(BrowserViewport, total=False):
+    """Viewport configuration to apply to the browser session."""
+
+    force: bool
+    """
+    If true, allow the viewport change even when a live view or recording/replay is
+    active. Active recordings will be gracefully stopped and restarted at the new
+    resolution as separate segments. If false (default), the resize is refused when
+    a live view or recording is active.
+    """

tests/api_resources/test_browsers.py

@@ -158,6 +158,7 @@ def test_method_update_with_all_params(self, client: Kernel) -> None:
                 "height": 800,
                 "width": 1280,
                 "refresh_rate": 60,
+                "force": True,
             },
         )
         assert_matches_type(BrowserUpdateResponse, browser, path=["response"])
@@ -521,6 +522,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncKernel) ->
                 "height": 800,
                 "width": 1280,
                 "refresh_rate": 60,
+                "force": True,
             },
         )
         assert_matches_type(BrowserUpdateResponse, browser, path=["response"])