kernel 0.53.0__tar.gz → 0.55.0__tar.gz

kernel-0.55.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.55.0"
+}

{kernel-0.53.0 → kernel-0.55.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.55.0 (2026-05-15)
+
+Full Changelog: [v0.53.0...v0.55.0](https://github.com/kernel/kernel-python-sdk/compare/v0.53.0...v0.55.0)
+
+### Features
+
+* Add health check and auto-reauth controls for managed auth connections ([9a0655e](https://github.com/kernel/kernel-python-sdk/commit/9a0655efbeef25e4929397b04f492644339f839e))
+* Polish start URL OpenAPI descriptions ([4f16fb0](https://github.com/kernel/kernel-python-sdk/commit/4f16fb073e0d295fd962e8a8aabd55bdf3144e00))
+
 ## 0.53.0 (2026-05-12)
 
 Full Changelog: [v0.52.0...v0.53.0](https://github.com/kernel/kernel-python-sdk/compare/v0.52.0...v0.53.0)

{kernel-0.53.0 → kernel-0.55.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.53.0
+Version: 0.55.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk

{kernel-0.53.0 → kernel-0.55.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.53.0"
+version = "0.55.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.53.0"  # x-release-please-version
+__version__ = "0.55.0"  # x-release-please-version

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/resources/auth/connections.py

@@ -62,8 +62,10 @@ class ConnectionsResource(SyncAPIResource):
         domain: str,
         profile_name: str,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
+        auto_reauth: bool | Omit = omit,
         credential: connection_create_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
+        health_checks: bool | Omit = omit,
         login_url: str | Omit = omit,
         proxy: connection_create_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
@@ -105,6 +107,15 @@ class ConnectionsResource(SyncAPIResource):
               - OneLogin: \\**.onelogin.com
               - Ping Identity: _.pingone.com, _.pingidentity.com
 
+          auto_reauth: Whether to permit automatic re-authentication when a scheduled health check
+              detects an expired session. This is an opt-in flag only — it does not check
+              whether re-auth is actually feasible. Even when true, re-auth only runs when the
+              system has what it needs to perform it (for example, saved credentials for the
+              required login fields), and only after a scheduled health check detects an
+              expired session — so this flag has no effect when `health_checks` is false. When
+              false, expired sessions are marked as `NEEDS_AUTH` instead of attempting
+              re-auth. Defaults to true.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -118,6 +129,11 @@ class ConnectionsResource(SyncAPIResource):
               depends on your plan: Enterprise: 300 (5 minutes), Startup: 1200 (20 minutes),
               Hobbyist: 3600 (1 hour).
 
+          health_checks: Whether to enable periodic health checks. When false, the system will not
+              automatically verify authentication status, and `auto_reauth` has no effect on
+              the automatic flow (since re-auth is only triggered by a failed scheduled health
+              check). Defaults to true.
+
           login_url: Optional login page URL to skip discovery
 
           proxy: Proxy selection. Provide either id or name. The proxy must belong to the
@@ -144,8 +160,10 @@ class ConnectionsResource(SyncAPIResource):
                     "domain": domain,
                     "profile_name": profile_name,
                     "allowed_domains": allowed_domains,
+                    "auto_reauth": auto_reauth,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
+                    "health_checks": health_checks,
                     "login_url": login_url,
                     "proxy": proxy,
                     "record_session": record_session,
@@ -199,8 +217,10 @@ class ConnectionsResource(SyncAPIResource):
         id: str,
         *,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
+        auto_reauth: bool | Omit = omit,
         credential: connection_update_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
+        health_checks: bool | Omit = omit,
         login_url: str | Omit = omit,
         proxy: connection_update_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
@@ -220,6 +240,14 @@ class ConnectionsResource(SyncAPIResource):
         Args:
           allowed_domains: Additional domains valid for this auth flow (replaces existing list)
 
+          auto_reauth: Whether automatic re-authentication is permitted for this connection. This is an
+              opt-in flag only — it does not check whether re-auth is actually feasible. Even
+              when true, re-auth only runs when the system has what it needs to perform it
+              (for example, saved credentials for the required login fields), and only after a
+              scheduled health check detects an expired session — so this flag has no effect
+              when `health_checks` is false. When false, expired sessions detected by a health
+              check are marked as `NEEDS_AUTH` instead of attempting re-auth.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -229,6 +257,11 @@ class ConnectionsResource(SyncAPIResource):
 
           health_check_interval: Interval in seconds between automatic health checks
 
+          health_checks: Whether periodic health checks are enabled. When set to false, the system will
+              not automatically verify authentication status, and `auto_reauth` has no effect
+              on the automatic flow (since re-auth is only triggered by a failed scheduled
+              health check).
+
           login_url: Login page URL. Set to empty string to clear.
 
           proxy: Proxy selection. Provide either id or name. The proxy must belong to the
@@ -253,8 +286,10 @@ class ConnectionsResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "allowed_domains": allowed_domains,
+                    "auto_reauth": auto_reauth,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
+                    "health_checks": health_checks,
                     "login_url": login_url,
                     "proxy": proxy,
                     "record_session": record_session,
@@ -544,8 +579,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
         domain: str,
         profile_name: str,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
+        auto_reauth: bool | Omit = omit,
         credential: connection_create_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
+        health_checks: bool | Omit = omit,
         login_url: str | Omit = omit,
         proxy: connection_create_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
@@ -587,6 +624,15 @@ class AsyncConnectionsResource(AsyncAPIResource):
               - OneLogin: \\**.onelogin.com
               - Ping Identity: _.pingone.com, _.pingidentity.com
 
+          auto_reauth: Whether to permit automatic re-authentication when a scheduled health check
+              detects an expired session. This is an opt-in flag only — it does not check
+              whether re-auth is actually feasible. Even when true, re-auth only runs when the
+              system has what it needs to perform it (for example, saved credentials for the
+              required login fields), and only after a scheduled health check detects an
+              expired session — so this flag has no effect when `health_checks` is false. When
+              false, expired sessions are marked as `NEEDS_AUTH` instead of attempting
+              re-auth. Defaults to true.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -600,6 +646,11 @@ class AsyncConnectionsResource(AsyncAPIResource):
               depends on your plan: Enterprise: 300 (5 minutes), Startup: 1200 (20 minutes),
               Hobbyist: 3600 (1 hour).
 
+          health_checks: Whether to enable periodic health checks. When false, the system will not
+              automatically verify authentication status, and `auto_reauth` has no effect on
+              the automatic flow (since re-auth is only triggered by a failed scheduled health
+              check). Defaults to true.
+
           login_url: Optional login page URL to skip discovery
 
           proxy: Proxy selection. Provide either id or name. The proxy must belong to the
@@ -626,8 +677,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
                     "domain": domain,
                     "profile_name": profile_name,
                     "allowed_domains": allowed_domains,
+                    "auto_reauth": auto_reauth,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
+                    "health_checks": health_checks,
                     "login_url": login_url,
                     "proxy": proxy,
                     "record_session": record_session,
@@ -681,8 +734,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
         id: str,
         *,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
+        auto_reauth: bool | Omit = omit,
         credential: connection_update_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
+        health_checks: bool | Omit = omit,
         login_url: str | Omit = omit,
         proxy: connection_update_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
@@ -702,6 +757,14 @@ class AsyncConnectionsResource(AsyncAPIResource):
         Args:
           allowed_domains: Additional domains valid for this auth flow (replaces existing list)
 
+          auto_reauth: Whether automatic re-authentication is permitted for this connection. This is an
+              opt-in flag only — it does not check whether re-auth is actually feasible. Even
+              when true, re-auth only runs when the system has what it needs to perform it
+              (for example, saved credentials for the required login fields), and only after a
+              scheduled health check detects an expired session — so this flag has no effect
+              when `health_checks` is false. When false, expired sessions detected by a health
+              check are marked as `NEEDS_AUTH` instead of attempting re-auth.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -711,6 +774,11 @@ class AsyncConnectionsResource(AsyncAPIResource):
 
           health_check_interval: Interval in seconds between automatic health checks
 
+          health_checks: Whether periodic health checks are enabled. When set to false, the system will
+              not automatically verify authentication status, and `auto_reauth` has no effect
+              on the automatic flow (since re-auth is only triggered by a failed scheduled
+              health check).
+
           login_url: Login page URL. Set to empty string to clear.
 
           proxy: Proxy selection. Provide either id or name. The proxy must belong to the
@@ -735,8 +803,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "allowed_domains": allowed_domains,
+                    "auto_reauth": auto_reauth,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
+                    "health_checks": health_checks,
                     "login_url": login_url,
                     "proxy": proxy,
                     "record_session": record_session,

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/resources/browser_pools.py

@@ -110,11 +110,9 @@ class BrowserPoolsResource(SyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          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
-              newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-              the previous lease left them on. Accepts any URL Chromium can resolve, including
-              chrome:// pages.
+          start_url: Optional URL to open when a browser is created for the pool. Navigation is
+              best-effort, so navigation failures do not prevent the pool from filling. Reused
+              browsers keep the page left by the previous lease.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -261,11 +259,9 @@ class BrowserPoolsResource(SyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          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
-              newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-              the previous lease left them on. Accepts any URL Chromium can resolve, including
-              chrome:// pages.
+          start_url: Optional URL to open when a browser is created for the pool. Navigation is
+              best-effort, so navigation failures do not prevent the pool from filling. Reused
+              browsers keep the page left by the previous lease.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -588,11 +584,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          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
-              newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-              the previous lease left them on. Accepts any URL Chromium can resolve, including
-              chrome:// pages.
+          start_url: Optional URL to open when a browser is created for the pool. Navigation is
+              best-effort, so navigation failures do not prevent the pool from filling. Reused
+              browsers keep the page left by the previous lease.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -739,11 +733,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          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
-              newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-              the previous lease left them on. Accepts any URL Chromium can resolve, including
-              chrome:// pages.
+          start_url: Optional URL to open when a browser is created for the pool. Navigation is
+              best-effort, so navigation failures do not prevent the pool from filling. Reused
+              browsers keep the page left by the previous lease.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/resources/browsers/browsers.py

@@ -197,11 +197,9 @@ class BrowsersResource(SyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          start_url: Optional URL to navigate to immediately after the browser is created.
-              Best-effort: failures to navigate do not fail browser creation. Any pre-existing
-              tabs are reduced to a single tab which is then navigated. Accepts any URL
-              Chromium can resolve, including chrome:// pages. Ignored when reusing an
-              existing persistent session.
+          start_url: Optional URL to open when the browser session is created. Navigation is
+              best-effort, so navigation failures do not prevent the session from being
+              created.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -763,11 +761,9 @@ class AsyncBrowsersResource(AsyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
-          start_url: Optional URL to navigate to immediately after the browser is created.
-              Best-effort: failures to navigate do not fail browser creation. Any pre-existing
-              tabs are reduced to a single tab which is then navigated. Accepts any URL
-              Chromium can resolve, including chrome:// pages. Ignored when reusing an
-              existing persistent session.
+          start_url: Optional URL to open when the browser session is created. Navigation is
+              best-effort, so navigation failures do not prevent the session from being
+              created.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/auth/connection_create_params.py

@@ -40,6 +40,18 @@ class ConnectionCreateParams(TypedDict, total=False):
     - Ping Identity: _.pingone.com, _.pingidentity.com
     """
 
+    auto_reauth: bool
+    """
+    Whether to permit automatic re-authentication when a scheduled health check
+    detects an expired session. This is an opt-in flag only — it does not check
+    whether re-auth is actually feasible. Even when true, re-auth only runs when the
+    system has what it needs to perform it (for example, saved credentials for the
+    required login fields), and only after a scheduled health check detects an
+    expired session — so this flag has no effect when `health_checks` is false. When
+    false, expired sessions are marked as `NEEDS_AUTH` instead of attempting
+    re-auth. Defaults to true.
+    """
+
     credential: Credential
     """Reference to credentials for the auth connection. Use one of:
 
@@ -57,6 +69,14 @@ class ConnectionCreateParams(TypedDict, total=False):
     Startup: 1200 (20 minutes), Hobbyist: 3600 (1 hour).
     """
 
+    health_checks: bool
+    """Whether to enable periodic health checks.
+
+    When false, the system will not automatically verify authentication status, and
+    `auto_reauth` has no effect on the automatic flow (since re-auth is only
+    triggered by a failed scheduled health check). Defaults to true.
+    """
+
     login_url: str
     """Optional login page URL to skip discovery"""
 

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/auth/connection_update_params.py

@@ -13,6 +13,18 @@ class ConnectionUpdateParams(TypedDict, total=False):
     allowed_domains: SequenceNotStr[str]
     """Additional domains valid for this auth flow (replaces existing list)"""
 
+    auto_reauth: bool
+    """Whether automatic re-authentication is permitted for this connection.
+
+    This is an opt-in flag only — it does not check whether re-auth is actually
+    feasible. Even when true, re-auth only runs when the system has what it needs to
+    perform it (for example, saved credentials for the required login fields), and
+    only after a scheduled health check detects an expired session — so this flag
+    has no effect when `health_checks` is false. When false, expired sessions
+    detected by a health check are marked as `NEEDS_AUTH` instead of attempting
+    re-auth.
+    """
+
     credential: Credential
     """Reference to credentials for the auth connection. Use one of:
 
@@ -24,6 +36,14 @@ class ConnectionUpdateParams(TypedDict, total=False):
     health_check_interval: int
     """Interval in seconds between automatic health checks"""
 
+    health_checks: bool
+    """Whether periodic health checks are enabled.
+
+    When set to false, the system will not automatically verify authentication
+    status, and `auto_reauth` has no effect on the automatic flow (since re-auth is
+    only triggered by a failed scheduled health check).
+    """
+
     login_url: str
     """Login page URL. Set to empty string to clear."""
 

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/auth/managed_auth.py

@@ -166,6 +166,18 @@ class ManagedAuth(BaseModel):
     - Ping Identity: _.pingone.com, _.pingidentity.com
     """
 
+    auto_reauth: Optional[bool] = None
+    """Whether automatic re-authentication is permitted for this connection.
+
+    This is an opt-in flag only — it does not check whether re-auth is actually
+    feasible. Even when true, re-auth only runs when the system has what it needs to
+    perform it (for example, saved credentials for the required login fields), and
+    only after a scheduled health check detects an expired session — so this flag
+    has no effect when `health_checks` is false. When false, expired sessions
+    detected by a health check are marked as `NEEDS_AUTH` instead of attempting
+    re-auth.
+    """
+
     browser_session_id: Optional[str] = None
     """
     ID of the underlying browser session driving the current flow (present when flow
@@ -236,6 +248,15 @@ class ManagedAuth(BaseModel):
     Startup: 1200 (20 minutes), Hobbyist: 3600 (1 hour).
     """
 
+    health_checks: Optional[bool] = None
+    """Whether periodic health checks are enabled for this connection.
+
+    When false, the system will not automatically verify authentication status, and
+    `auto_reauth` has no effect on the automatic flow (since re-auth is only
+    triggered by a failed scheduled health check). Manually triggering a health
+    check via the API still works regardless of this setting.
+    """
+
     hosted_url: Optional[str] = None
     """URL to redirect user to for hosted login (present when flow in progress)"""
 

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_create_params.py

@@ -58,12 +58,10 @@ class BrowserCreateParams(TypedDict, total=False):
     """
 
     start_url: str
-    """Optional URL to navigate to immediately after the browser is created.
+    """Optional URL to open when the browser session is created.
 
-    Best-effort: failures to navigate do not fail browser creation. Any pre-existing
-    tabs are reduced to a single tab which is then navigated. Accepts any URL
-    Chromium can resolve, including chrome:// pages. Ignored when reusing an
-    existing persistent session.
+    Navigation is best-effort, so navigation failures do not prevent the session
+    from being created.
     """
 
     stealth: bool

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_create_response.py

@@ -69,10 +69,7 @@ class BrowserCreateResponse(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_list_response.py

@@ -69,10 +69,7 @@ class BrowserListResponse(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_pool.py

@@ -64,12 +64,10 @@ class BrowserPoolConfig(BaseModel):
     """
 
     start_url: Optional[str] = None
-    """Optional URL to navigate to when a new browser is warmed into the pool.
+    """Optional URL to open when a browser is created for the pool.
 
-    Best-effort: failures to navigate do not fail pool fill. Only applied to
-    newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-    the previous lease left them on. Accepts any URL Chromium can resolve, including
-    chrome:// pages.
+    Navigation is best-effort, so navigation failures do not prevent the pool from
+    filling. Reused browsers keep the page left by the previous lease.
     """
 
     stealth: Optional[bool] = None

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_pool_acquire_response.py

@@ -69,10 +69,7 @@ class BrowserPoolAcquireResponse(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_pool_create_params.py

@@ -63,12 +63,10 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     """
 
     start_url: str
-    """Optional URL to navigate to when a new browser is warmed into the pool.
+    """Optional URL to open when a browser is created for the pool.
 
-    Best-effort: failures to navigate do not fail pool fill. Only applied to
-    newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-    the previous lease left them on. Accepts any URL Chromium can resolve, including
-    chrome:// pages.
+    Navigation is best-effort, so navigation failures do not prevent the pool from
+    filling. Reused browsers keep the page left by the previous lease.
     """
 
     stealth: bool

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_pool_update_params.py

@@ -69,12 +69,10 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     """
 
     start_url: str
-    """Optional URL to navigate to when a new browser is warmed into the pool.
+    """Optional URL to open when a browser is created for the pool.
 
-    Best-effort: failures to navigate do not fail pool fill. Only applied to
-    newly-warmed browsers — browsers reused via release/acquire keep whatever URL
-    the previous lease left them on. Accepts any URL Chromium can resolve, including
-    chrome:// pages.
+    Navigation is best-effort, so navigation failures do not prevent the pool from
+    filling. Reused browsers keep the page left by the previous lease.
     """
 
     stealth: bool

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_retrieve_response.py

@@ -69,10 +69,7 @@ class BrowserRetrieveResponse(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/browser_update_response.py

@@ -69,10 +69,7 @@ class BrowserUpdateResponse(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""

{kernel-0.53.0 → kernel-0.55.0}/src/kernel/types/invocation_list_browsers_response.py

@@ -69,10 +69,7 @@ class Browser(BaseModel):
     """ID of the proxy associated with this browser session, if any."""
 
     start_url: Optional[str] = None
-    """URL the session was asked to navigate to on creation, if any.
-
-    Recorded for debugging — navigation is best-effort and may have failed.
-    """
+    """Start URL requested for the session, if provided."""
 
     usage: Optional[BrowserUsage] = None
     """Session usage metrics."""