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

@@ -213,7 +213,9 @@ export namespace BrowserPool {
     extensions?: Array<Shared.BrowserExtension>;
 
     /**
-     * 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.
      */
     fill_rate_per_minute?: number;
 
@@ -263,7 +265,7 @@ export namespace BrowserPool {
 
     /**
      * 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).
      */
     timeout_seconds?: number;
 
@@ -439,7 +441,9 @@ export interface BrowserPoolCreateParams {
   extensions?: Array<Shared.BrowserExtension>;
 
   /**
-   * 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.
    */
   fill_rate_per_minute?: number;
 
@@ -489,7 +493,7 @@ export interface BrowserPoolCreateParams {
 
   /**
    * 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).
    */
   timeout_seconds?: number;
 
@@ -531,7 +535,9 @@ export interface BrowserPoolUpdateParams {
   extensions?: Array<Shared.BrowserExtension>;
 
   /**
-   * 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.
    */
   fill_rate_per_minute?: number;
 
@@ -588,7 +594,7 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * 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).
    */
   timeout_seconds?: number;
 

src/resources/shared.ts

@@ -79,18 +79,18 @@ export interface BrowserProfile {
  */
 export interface BrowserViewport {
   /**
-   * Browser window height in pixels.
+   * Browser window height in pixels. Any positive integer is accepted.
    */
   height: number;
 
   /**
-   * Browser window width in pixels.
+   * Browser window width in pixels. Any positive integer is accepted.
    */
   width: number;
 
   /**
-   * Display refresh rate in Hz. If omitted, automatically determined from width and
-   * height.
+   * Display refresh rate in Hz. Any positive integer is accepted; if omitted,
+   * automatically determined from width and height.
    */
   refresh_rate?: number;
 }

tests/api-resources/browser-pools.test.ts

@@ -38,7 +38,7 @@ describe('resource browserPools', () => {
       proxy_id: 'proxy_id',
       start_url: 'https://example.com',
       stealth: true,
-      timeout_seconds: 60,
+      timeout_seconds: 10,
       viewport: {
         height: 800,
         width: 1280,