feat: [wip] Browser pools polish pass

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-cbef7e4fef29ad40af5c767aceb762ee68811c2287f255c05d2ee44a9a9247a2.yml
-openapi_spec_hash: 467e61e072773ec9f2d49c7dd3de8c2f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3a68acd8c46e121c66be5b4c30bb4e962967840ca0f31070905baa39635fbc2d.yml
+openapi_spec_hash: 9453963fbb01de3e0afb462b16cdf115
 config_hash: 6dbe88d2ba9df1ec46cedbfdb7d00000

src/kernel/resources/browser_pools.py

@@ -106,11 +106,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 
@@ -209,7 +209,7 @@ def update(
           size: Number of browsers to create in the pool
 
           discard_all_idle: Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-              to true.
+              to false.
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
@@ -236,11 +236,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 
@@ -540,11 +540,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 
@@ -643,7 +643,7 @@ async def update(
           size: Number of browsers to create in the pool
 
           discard_all_idle: Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-              to true.
+              to false.
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
@@ -670,11 +670,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 

src/kernel/resources/browsers/browsers.py

@@ -181,11 +181,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 
@@ -526,11 +526,11 @@ 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 (commonly 1024x768@60). Only specific viewport
-              configurations are supported. The server will reject unsupported combinations.
-              Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 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
+              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,
+              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
 

src/kernel/types/browser_create_params.py

@@ -69,7 +69,7 @@ class BrowserCreateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_create_response.py

@@ -54,7 +54,7 @@ class BrowserCreateResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_list_response.py

@@ -54,7 +54,7 @@ class BrowserListResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_pool_acquire_response.py

@@ -54,7 +54,7 @@ class BrowserPoolAcquireResponse(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_pool_create_params.py

@@ -65,7 +65,7 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_pool_request.py

@@ -63,7 +63,7 @@ class BrowserPoolRequest(BaseModel):
     viewport: Optional[BrowserViewport] = None
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will

src/kernel/types/browser_pool_update_params.py

@@ -19,7 +19,7 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     discard_all_idle: bool
     """Whether to discard all idle browsers and rebuild the pool immediately.
 
-    Defaults to true.
+    Defaults to false.
     """
 
     extensions: Iterable[BrowserExtension]
@@ -71,7 +71,7 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     viewport: BrowserViewport
     """Initial browser window size in pixels with optional refresh rate.
 
-    If omitted, image defaults apply (commonly 1024x768@60). Only specific viewport
+    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, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will