feat: Add GPU viewport presets and GPU encoder defaults

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-e6936890166ce5b11abaccd511a43a8807e2abf96c1f542d4f8d94655ef27d1f.yml
-openapi_spec_hash: 0146ecaea96d8136ef4a35cd04aacf22
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-95bb1cbe27cbed0339067fa133590e675b99cda4a9c04fad802a5b14563eb572.yml
+openapi_spec_hash: 3a24e61711eedb9ea7bb7589a7df956f
 config_hash: cff4d43372b6fa66b64e2d4150f6aa76

src/kernel/resources/browser_pools.py

@@ -110,9 +110,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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
@@ -242,9 +246,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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
@@ -550,9 +558,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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
@@ -682,9 +694,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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

src/kernel/resources/browsers/browsers.py

@@ -196,9 +196,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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
@@ -623,9 +627,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). 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.
+              image defaults apply (1920x1080@25). For GPU images, the default is
+              1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+              Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
               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

src/kernel/types/browser_create_params.py

@@ -73,13 +73,17 @@ class BrowserCreateParams(TypedDict, total=False):
     """
 
     viewport: BrowserViewport
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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

@@ -66,13 +66,17 @@ class BrowserCreateResponse(BaseModel):
     """Session usage metrics."""
 
     viewport: Optional[BrowserViewport] = None
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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

@@ -66,13 +66,17 @@ class BrowserListResponse(BaseModel):
     """Session usage metrics."""
 
     viewport: Optional[BrowserViewport] = None
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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

@@ -68,15 +68,19 @@ class BrowserPoolConfig(BaseModel):
     """
 
     viewport: Optional[BrowserViewport] = None
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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

@@ -66,13 +66,17 @@ class BrowserPoolAcquireResponse(BaseModel):
     """Session usage metrics."""
 
     viewport: Optional[BrowserViewport] = None
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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

@@ -67,13 +67,17 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     """
 
     viewport: BrowserViewport
-    """Initial browser window size in pixels with optional refresh rate.
-
-    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).
+    """
+    Initial browser window size in pixels with optional refresh rate. If omitted,
+    image defaults apply (1920x1080@25). For GPU images, the default is
+    1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+    Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
+    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).
     """