feat: Auto-default refresh_on_profile_update when browser pool profile changes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 127
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-9143bc729ef60beffa0bbd9b601bb095083e41e23c8994553e69302f586882f5.yml
-openapi_spec_hash: bd04c530cfa8188af0e63a784129645d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-25b48b79d356843aeda41e5e5c3c407c5bd5c12f9548500ffc0a6696e6acd941.yml
+openapi_spec_hash: f710169690ab7aca30c91968e752cff7
 config_hash: 77ee715aa17061166f9a02b264a21b8d

src/kernel/resources/browser_pools.py

@@ -122,8 +122,8 @@ def create(
               the same project as the browser session.
 
           refresh_on_profile_update: When true, flush idle browsers when the profile the pool uses is updated, so
-              pool browsers pick up the latest profile data. Requires a profile to be set on
-              the pool.
+              pool browsers pick up the latest profile data. When a profile is provided during
+              creation, this defaults to true. Requires a profile to be set on the pool.
 
           start_url: Optional URL to navigate to when a new browser is warmed into the pool.
               Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -291,7 +291,10 @@ def update(
               proxy unchanged.
 
           refresh_on_profile_update: If provided, replaces whether idle browsers are flushed when the profile the
-              pool uses is updated. Requires a profile to be set on the pool.
+              pool uses is updated. When the pool's profile reference is changed (including
+              newly attached) and this field is omitted, it defaults to true. Re-sending the
+              same profile reference leaves this setting unchanged. Clearing the profile also
+              disables this setting. Requires a profile to be set on the pool.
 
           size: If provided, replaces the number of browsers to maintain in the pool. The
               maximum size is determined by your organization's pooled sessions limit (the sum
@@ -697,8 +700,8 @@ async def create(
               the same project as the browser session.
 
           refresh_on_profile_update: When true, flush idle browsers when the profile the pool uses is updated, so
-              pool browsers pick up the latest profile data. Requires a profile to be set on
-              the pool.
+              pool browsers pick up the latest profile data. When a profile is provided during
+              creation, this defaults to true. Requires a profile to be set on the pool.
 
           start_url: Optional URL to navigate to when a new browser is warmed into the pool.
               Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -866,7 +869,10 @@ async def update(
               proxy unchanged.
 
           refresh_on_profile_update: If provided, replaces whether idle browsers are flushed when the profile the
-              pool uses is updated. Requires a profile to be set on the pool.
+              pool uses is updated. When the pool's profile reference is changed (including
+              newly attached) and this field is omitted, it defaults to true. Re-sending the
+              same profile reference leaves this setting unchanged. Clearing the profile also
+              disables this setting. Requires a profile to be set on the pool.
 
           size: If provided, replaces the number of browsers to maintain in the pool. The
               maximum size is determined by your organization's pooled sessions limit (the sum

src/kernel/types/browser_pool.py

@@ -91,8 +91,8 @@ class BrowserPoolConfig(BaseModel):
     refresh_on_profile_update: Optional[bool] = None
     """
     When true, flush idle browsers when the profile the pool uses is updated, so
-    pool browsers pick up the latest profile data. Requires a profile to be set on
-    the pool.
+    pool browsers pick up the latest profile data. When a profile is provided during
+    creation, this defaults to true. Requires a profile to be set on the pool.
     """
 
     start_url: Optional[str] = None

src/kernel/types/browser_pool_create_params.py

@@ -71,8 +71,8 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     refresh_on_profile_update: bool
     """
     When true, flush idle browsers when the profile the pool uses is updated, so
-    pool browsers pick up the latest profile data. Requires a profile to be set on
-    the pool.
+    pool browsers pick up the latest profile data. When a profile is provided during
+    creation, this defaults to true. Requires a profile to be set on the pool.
     """
 
     start_url: str

src/kernel/types/browser_pool_update_params.py

@@ -77,7 +77,10 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     refresh_on_profile_update: bool
     """
     If provided, replaces whether idle browsers are flushed when the profile the
-    pool uses is updated. Requires a profile to be set on the pool.
+    pool uses is updated. When the pool's profile reference is changed (including
+    newly attached) and this field is omitted, it defaults to true. Re-sending the
+    same profile reference leaves this setting unchanged. Clearing the profile also
+    disables this setting. Requires a profile to be set on the pool.
     """
 
     size: int