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/resources/browser-pools.ts

@@ -243,9 +243,13 @@ export namespace BrowserPool {
 
     /**
      * 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
@@ -342,9 +346,13 @@ export interface BrowserPoolAcquireResponse {
 
   /**
    * 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
@@ -414,9 +422,13 @@ export interface BrowserPoolCreateParams {
 
   /**
    * 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
@@ -492,9 +504,13 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * 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/resources/browsers/browsers.ts

@@ -367,9 +367,13 @@ export interface BrowserCreateResponse {
 
   /**
    * 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
@@ -463,9 +467,13 @@ export interface BrowserRetrieveResponse {
 
   /**
    * 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
@@ -559,9 +567,13 @@ export interface BrowserUpdateResponse {
 
   /**
    * 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
@@ -655,9 +667,13 @@ export interface BrowserListResponse {
 
   /**
    * 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
@@ -731,9 +747,13 @@ export interface BrowserCreateParams {
 
   /**
    * 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/resources/invocations.ts

@@ -502,9 +502,13 @@ export namespace InvocationListBrowsersResponse {
 
     /**
      * 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/resources/shared.ts

@@ -65,9 +65,13 @@ export interface BrowserProfile {
 
 /**
  * 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