feat: Allow arbitrary viewport dimensions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-b7d469021adcd1493f74dad38746ffa3817dcf86a0a12561a88eb554824e3ffb.yml
-openapi_spec_hash: 4134c95bf3012dca38797ca56d62395b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-47ee6a2b624baddb41a681feff758bf1893cd3d65edf3ab51219ebe4d942932b.yml
+openapi_spec_hash: 76178c41ede593e76bfacb176057d2f0
 config_hash: 27c0ea01aeb797a1767af139851c5b66

src/kernel/resources/browser_pools.py

@@ -108,13 +108,13 @@ def create(
               are destroyed. Defaults to 600 seconds if not specified
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -240,13 +240,13 @@ def update(
               are destroyed. Defaults to 600 seconds if not specified
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -546,13 +546,13 @@ async def create(
               are destroyed. Defaults to 600 seconds if not specified
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -678,13 +678,13 @@ async def update(
               are destroyed. Defaults to 600 seconds if not specified
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 

src/kernel/resources/browsers/browsers.py

@@ -185,13 +185,13 @@ def create(
               see is +/- 5 seconds around the specified value.
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -596,13 +596,13 @@ async def create(
               see is +/- 5 seconds around the specified value.
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
-              image defaults apply (1920x1080@25). Only specific viewport configurations are
-              supported. The server will reject unsupported combinations. Supported
-              resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-              1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-              be automatically determined from the width and height if they match a supported
-              configuration exactly. Note: Higher resolutions may affect the responsiveness of
-              live view browser
+              image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
+              but the following configurations are known-good and fully tested: 2560x1440@10,
+              1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+              Viewports outside this list may exhibit unstable live view or recording
+              behavior. If refresh_rate is not provided, it will be automatically determined
+              based on the resolution (higher resolutions use lower refresh rates to keep
+              bandwidth reasonable).
 
           extra_headers: Send extra headers
 

src/kernel/types/browser_create_params.py

@@ -69,11 +69,11 @@ class BrowserCreateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """

src/kernel/types/browser_create_response.py

@@ -54,11 +54,11 @@ class BrowserCreateResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """

src/kernel/types/browser_list_response.py

@@ -54,11 +54,11 @@ class BrowserListResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """

src/kernel/types/browser_pool.py

@@ -70,13 +70,13 @@ class BrowserPoolConfig(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """
 
 

src/kernel/types/browser_pool_acquire_response.py

@@ -54,11 +54,11 @@ class BrowserPoolAcquireResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """

src/kernel/types/browser_pool_create_params.py

@@ -69,11 +69,11 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """

src/kernel/types/browser_pool_update_params.py

@@ -75,11 +75,11 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (1920x1080@25). Only specific viewport
-    configurations are supported. The server will reject unsupported combinations.
-    Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60 If refresh_rate is not
-    provided, it will be automatically determined from the width and height if they
-    match a supported configuration exactly. Note: Higher resolutions may affect the
-    responsiveness of live view browser
+    If omitted, image defaults apply (1920x1080@25). Arbitrary viewport dimensions
+    are accepted, but the following configurations are known-good and fully tested:
+    2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60,
+    1200x800@60. Viewports outside this list may exhibit unstable live view or
+    recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """