feat: Align browser-pool timeout/viewport/fill-rate contract with implementation; reject save_changes on update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-d70be5e703da22000f3f7e76b19d5fa3e3bf8c33be2e9570bfafb5cf9d956a17.yml
-openapi_spec_hash: deaa8926543116d1f81d34d1e01e0c0a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-ab4e7c50c41fefd891648fa84ba0258986f192ba1bde9f42cbdf487f64c4cc27.yml
+openapi_spec_hash: b4bcd6557f7045ecff30b01e02d28ac5
 config_hash: 03c7e57f268c750e2415831662e95969

src/kernel/resources/browser_pools.py

@@ -96,7 +96,9 @@ def create(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -122,7 +124,7 @@ def create(
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -243,7 +245,9 @@ def update(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -273,7 +277,7 @@ def update(
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -621,7 +625,9 @@ async def create(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -647,7 +653,7 @@ async def create(
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -768,7 +774,9 @@ async def update(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -798,7 +806,7 @@ async def update(
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is

src/kernel/types/browser_pool.py

@@ -36,7 +36,11 @@ class BrowserPoolConfig(BaseModel):
     """
 
     fill_rate_per_minute: Optional[int] = None
-    """Percentage of the pool to fill per minute. Defaults to 10%."""
+    """Percentage of the pool to fill per minute.
+
+    Defaults to 10. The cap is 25 for most organizations but can be raised
+    per-organization, so only the lower bound is enforced here.
+    """
 
     headless: Optional[bool] = None
     """If true, launches the browser using a headless image. Defaults to false."""
@@ -81,7 +85,7 @@ class BrowserPoolConfig(BaseModel):
     timeout_seconds: Optional[int] = None
     """
     Default idle timeout in seconds for browsers acquired from this pool before they
-    are destroyed. Defaults to 600 seconds if not specified
+    are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
     """
 
     viewport: Optional[BrowserViewport] = None

src/kernel/types/browser_pool_create_params.py

@@ -35,7 +35,11 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     """
 
     fill_rate_per_minute: int
-    """Percentage of the pool to fill per minute. Defaults to 10%."""
+    """Percentage of the pool to fill per minute.
+
+    Defaults to 10. The cap is 25 for most organizations but can be raised
+    per-organization, so only the lower bound is enforced here.
+    """
 
     headless: bool
     """If true, launches the browser using a headless image. Defaults to false."""
@@ -80,7 +84,7 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     timeout_seconds: int
     """
     Default idle timeout in seconds for browsers acquired from this pool before they
-    are destroyed. Defaults to 600 seconds if not specified
+    are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
     """
 
     viewport: BrowserViewport

src/kernel/types/browser_pool_update_params.py

@@ -34,7 +34,11 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     """
 
     fill_rate_per_minute: int
-    """Percentage of the pool to fill per minute. Defaults to 10%."""
+    """Percentage of the pool to fill per minute.
+
+    Defaults to 10. The cap is 25 for most organizations but can be raised
+    per-organization, so only the lower bound is enforced here.
+    """
 
     headless: bool
     """If true, launches the browser using a headless image. Defaults to false."""
@@ -86,7 +90,7 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     timeout_seconds: int
     """
     Default idle timeout in seconds for browsers acquired from this pool before they
-    are destroyed. Defaults to 600 seconds if not specified
+    are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
     """
 
     viewport: BrowserViewport

src/kernel/types/shared/browser_viewport.py

@@ -23,13 +23,14 @@ class BrowserViewport(BaseModel):
     """
 
     height: int
-    """Browser window height in pixels."""
+    """Browser window height in pixels. Any positive integer is accepted."""
 
     width: int
-    """Browser window width in pixels."""
+    """Browser window width in pixels. Any positive integer is accepted."""
 
     refresh_rate: Optional[int] = None
     """Display refresh rate in Hz.
 
-    If omitted, automatically determined from width and height.
+    Any positive integer is accepted; if omitted, automatically determined from
+    width and height.
     """

src/kernel/types/shared_params/browser_viewport.py

@@ -23,13 +23,14 @@ class BrowserViewport(TypedDict, total=False):
     """
 
     height: Required[int]
-    """Browser window height in pixels."""
+    """Browser window height in pixels. Any positive integer is accepted."""
 
     width: Required[int]
-    """Browser window width in pixels."""
+    """Browser window width in pixels. Any positive integer is accepted."""
 
     refresh_rate: int
     """Display refresh rate in Hz.
 
-    If omitted, automatically determined from width and height.
+    Any positive integer is accepted; if omitted, automatically determined from
+    width and height.
     """

tests/api_resources/test_browser_pools.py

@@ -53,7 +53,7 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
             proxy_id="proxy_id",
             start_url="https://example.com",
             stealth=True,
-            timeout_seconds=60,
+            timeout_seconds=10,
             viewport={
                 "height": 800,
                 "width": 1280,
@@ -164,7 +164,7 @@ def test_method_update_with_all_params(self, client: Kernel) -> None:
             size=10,
             start_url="https://example.com",
             stealth=True,
-            timeout_seconds=60,
+            timeout_seconds=10,
             viewport={
                 "height": 800,
                 "width": 1280,
@@ -488,7 +488,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
             proxy_id="proxy_id",
             start_url="https://example.com",
             stealth=True,
-            timeout_seconds=60,
+            timeout_seconds=10,
             viewport={
                 "height": 800,
                 "width": 1280,
@@ -599,7 +599,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncKernel) ->
             size=10,
             start_url="https://example.com",
             stealth=True,
-            timeout_seconds=60,
+            timeout_seconds=10,
             viewport={
                 "height": 800,
                 "width": 1280,