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

@@ -240,13 +240,13 @@ export namespace BrowserPool {
 
     /**
      * 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).
      */
     viewport?: Shared.BrowserViewport;
   }
@@ -319,13 +319,13 @@ export interface BrowserPoolAcquireResponse {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -391,13 +391,13 @@ export interface BrowserPoolCreateParams {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -469,13 +469,13 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }

src/resources/browsers/browsers.ts

@@ -315,13 +315,13 @@ export interface BrowserCreateResponse {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -391,13 +391,13 @@ export interface BrowserRetrieveResponse {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -467,13 +467,13 @@ export interface BrowserUpdateResponse {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -543,13 +543,13 @@ export interface BrowserListResponse {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -613,13 +613,13 @@ export interface BrowserCreateParams {
 
   /**
    * 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).
    */
   viewport?: Shared.BrowserViewport;
 }

src/resources/invocations.ts

@@ -479,13 +479,13 @@ export namespace InvocationListBrowsersResponse {
 
     /**
      * 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).
      */
     viewport?: Shared.BrowserViewport;
   }

src/resources/shared.ts

@@ -53,13 +53,13 @@ export interface BrowserProfile {
 
 /**
  * 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).
  */
 export interface BrowserViewport {
   /**