kernel 0.78.1__tar.gz → 0.80.0__tar.gz

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

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

{kernel-0.78.1 → kernel-0.80.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.80.0 (2026-07-19)
+
+Full Changelog: [v0.79.0...v0.80.0](https://github.com/kernel/kernel-python-sdk/compare/v0.79.0...v0.80.0)
+
+### Features
+
+* Add example to ProxyCheckRequest.url so API reference sample shows it ([2a288ca](https://github.com/kernel/kernel-python-sdk/commit/2a288ca546da7760cdc16e566260fd440ae36fb7))
+* Expose browser sessions on auth timeline events ([687b401](https://github.com/kernel/kernel-python-sdk/commit/687b401117d37d6db8e818cd08ee3983671a23f6))
+* **managed-auth:** add TS CUA worker contract (KERNEL-1456) ([de2fc59](https://github.com/kernel/kernel-python-sdk/commit/de2fc590e00152328ac6a4f5165da0fb727644bb))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([79f96e4](https://github.com/kernel/kernel-python-sdk/commit/79f96e4e8d8f0e04e21c37010e1faa765f17afb6))
+
+## 0.79.0 (2026-07-15)
+
+Full Changelog: [v0.78.1...v0.79.0](https://github.com/kernel/kernel-python-sdk/compare/v0.78.1...v0.79.0)
+
+### Features
+
+* Add telemetry support for browser pools with BAA enforcement ([a7f5d9e](https://github.com/kernel/kernel-python-sdk/commit/a7f5d9e4909fed534df873d90ac14481b18b7d20))
+
 ## 0.78.1 (2026-07-15)
 
 Full Changelog: [v0.78.0...v0.78.1](https://github.com/kernel/kernel-python-sdk/compare/v0.78.0...v0.78.1)

{kernel-0.78.1 → kernel-0.80.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.78.1
+Version: 0.80.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.78.1 → kernel-0.80.0}/pyproject.toml

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

{kernel-0.78.1 → kernel-0.80.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.78.1"  # x-release-please-version
+__version__ = "0.80.0"  # x-release-please-version

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/resources/auth/connections.py

@@ -505,8 +505,10 @@ class ConnectionsResource(SyncAPIResource):
         self,
         id: str,
         *,
+        field_values: Dict[str, str] | Omit = omit,
         fields: Dict[str, str] | Omit = omit,
         mfa_option_id: str | Omit = omit,
+        selected_choice_id: str | Omit = omit,
         sign_in_option_id: str | Omit = omit,
         sso_button_selector: str | Omit = omit,
         sso_provider: str | Omit = omit,
@@ -523,10 +525,14 @@ class ConnectionsResource(SyncAPIResource):
         progress and get results.
 
         Args:
+          field_values: Canonical map of field ID to submitted value.
+
           fields: Map of field name to value
 
           mfa_option_id: The MFA method type to select (when mfa_options were returned)
 
+          selected_choice_id: Canonical choice ID selected by the user.
+
           sign_in_option_id: The sign-in option ID to select (when sign_in_options were returned)
 
           sso_button_selector: XPath selector for the SSO button to click (ODA). Use sso_provider instead for
@@ -549,8 +555,10 @@ class ConnectionsResource(SyncAPIResource):
             path_template("/auth/connections/{id}/submit", id=id),
             body=maybe_transform(
                 {
+                    "field_values": field_values,
                     "fields": fields,
                     "mfa_option_id": mfa_option_id,
+                    "selected_choice_id": selected_choice_id,
                     "sign_in_option_id": sign_in_option_id,
                     "sso_button_selector": sso_button_selector,
                     "sso_provider": sso_provider,
@@ -1088,8 +1096,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
         self,
         id: str,
         *,
+        field_values: Dict[str, str] | Omit = omit,
         fields: Dict[str, str] | Omit = omit,
         mfa_option_id: str | Omit = omit,
+        selected_choice_id: str | Omit = omit,
         sign_in_option_id: str | Omit = omit,
         sso_button_selector: str | Omit = omit,
         sso_provider: str | Omit = omit,
@@ -1106,10 +1116,14 @@ class AsyncConnectionsResource(AsyncAPIResource):
         progress and get results.
 
         Args:
+          field_values: Canonical map of field ID to submitted value.
+
           fields: Map of field name to value
 
           mfa_option_id: The MFA method type to select (when mfa_options were returned)
 
+          selected_choice_id: Canonical choice ID selected by the user.
+
           sign_in_option_id: The sign-in option ID to select (when sign_in_options were returned)
 
           sso_button_selector: XPath selector for the SSO button to click (ODA). Use sso_provider instead for
@@ -1132,8 +1146,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
             path_template("/auth/connections/{id}/submit", id=id),
             body=await async_maybe_transform(
                 {
+                    "field_values": field_values,
                     "fields": fields,
                     "mfa_option_id": mfa_option_id,
+                    "selected_choice_id": selected_choice_id,
                     "sign_in_option_id": sign_in_option_id,
                     "sso_button_selector": sso_button_selector,
                     "sso_provider": sso_provider,

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/resources/browser_pools.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Iterable
+from typing import Dict, Iterable, Optional
 
 import httpx
 
@@ -72,6 +72,7 @@ class BrowserPoolsResource(SyncAPIResource):
         refresh_on_profile_update: bool | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        telemetry: Optional[browser_pool_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -134,6 +135,13 @@ class BrowserPoolsResource(SyncAPIResource):
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms. Defaults to false.
 
+          telemetry: Telemetry configuration applied to browsers warmed into this pool. Set enabled
+              to true to start capture using the default set, or provide browser category
+              settings. If omitted, null, set to an empty object ({}), set to enabled: false
+              without browser category settings, or all four CDP categories are explicitly
+              disabled, no telemetry is configured on the pool. Only applied to newly-warmed
+              browsers.
+
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
               are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
@@ -174,6 +182,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "refresh_on_profile_update": refresh_on_profile_update,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
                 },
@@ -235,6 +244,7 @@ class BrowserPoolsResource(SyncAPIResource):
         size: int | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        telemetry: Optional[browser_pool_update_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -306,6 +316,14 @@ class BrowserPoolsResource(SyncAPIResource):
 
           stealth: If provided, replaces whether browsers launch in stealth mode.
 
+          telemetry: If provided, updates the pool's telemetry configuration. Omit, set to null, or
+              set to an empty object ({}) to leave the existing configuration unchanged. Set
+              enabled to true to enable capture using the default set. Set enabled to false to
+              clear the pool's telemetry. Provide browser category settings for per-category
+              updates, merged onto the pool's current configuration. Only applied to browsers
+              warmed after the update; browsers already in the pool keep their configuration
+              until discarded.
+
           timeout_seconds: If provided, replaces the default idle timeout in seconds for browsers acquired
               from this pool before they are destroyed. Minimum 10, maximum 259200 (72 hours).
 
@@ -349,6 +367,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "size": size,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
                 },
@@ -468,6 +487,7 @@ class BrowserPoolsResource(SyncAPIResource):
         name: str | Omit = omit,
         start_url: str | Omit = omit,
         tags: TagsParam | Omit = omit,
+        telemetry: Optional[browser_pool_acquire_params.Telemetry] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -500,6 +520,15 @@ class BrowserPoolsResource(SyncAPIResource):
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
 
+          telemetry: Telemetry override for the acquired browser, applied to this lease only. Merges
+              onto the browser's current (pool-inherited) telemetry using the same
+              per-category semantics as PATCH /browsers: provided categories override the
+              current configuration, omitted categories are inherited. Set enabled to true to
+              resolve the config fresh from the default set, or enabled to false to stop
+              capture. When the browser is released back to the pool with reuse, its telemetry
+              is reset to the pool's baseline, so the override does not carry over to the next
+              lease.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -518,6 +547,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "name": name,
                     "start_url": start_url,
                     "tags": tags,
+                    "telemetry": telemetry,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
             ),
@@ -650,6 +680,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         refresh_on_profile_update: bool | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        telemetry: Optional[browser_pool_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -712,6 +743,13 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms. Defaults to false.
 
+          telemetry: Telemetry configuration applied to browsers warmed into this pool. Set enabled
+              to true to start capture using the default set, or provide browser category
+              settings. If omitted, null, set to an empty object ({}), set to enabled: false
+              without browser category settings, or all four CDP categories are explicitly
+              disabled, no telemetry is configured on the pool. Only applied to newly-warmed
+              browsers.
+
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
               are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
@@ -752,6 +790,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "refresh_on_profile_update": refresh_on_profile_update,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
                 },
@@ -813,6 +852,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         size: int | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        telemetry: Optional[browser_pool_update_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -884,6 +924,14 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           stealth: If provided, replaces whether browsers launch in stealth mode.
 
+          telemetry: If provided, updates the pool's telemetry configuration. Omit, set to null, or
+              set to an empty object ({}) to leave the existing configuration unchanged. Set
+              enabled to true to enable capture using the default set. Set enabled to false to
+              clear the pool's telemetry. Provide browser category settings for per-category
+              updates, merged onto the pool's current configuration. Only applied to browsers
+              warmed after the update; browsers already in the pool keep their configuration
+              until discarded.
+
           timeout_seconds: If provided, replaces the default idle timeout in seconds for browsers acquired
               from this pool before they are destroyed. Minimum 10, maximum 259200 (72 hours).
 
@@ -927,6 +975,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "size": size,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
                 },
@@ -1046,6 +1095,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         name: str | Omit = omit,
         start_url: str | Omit = omit,
         tags: TagsParam | Omit = omit,
+        telemetry: Optional[browser_pool_acquire_params.Telemetry] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1078,6 +1128,15 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
 
+          telemetry: Telemetry override for the acquired browser, applied to this lease only. Merges
+              onto the browser's current (pool-inherited) telemetry using the same
+              per-category semantics as PATCH /browsers: provided categories override the
+              current configuration, omitted categories are inherited. Set enabled to true to
+              resolve the config fresh from the default set, or enabled to false to stop
+              capture. When the browser is released back to the pool with reuse, its telemetry
+              is reset to the pool's baseline, so the override does not carry over to the next
+              lease.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1096,6 +1155,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "name": name,
                     "start_url": start_url,
                     "tags": tags,
+                    "telemetry": telemetry,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
             ),

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/types/auth/connection_follow_response.py

@@ -12,13 +12,36 @@ from ..shared.heartbeat_event import HeartbeatEvent
 __all__ = [
     "ConnectionFollowResponse",
     "ManagedAuthStateEvent",
+    "ManagedAuthStateEventChoice",
     "ManagedAuthStateEventDiscoveredField",
+    "ManagedAuthStateEventField",
     "ManagedAuthStateEventMfaOption",
     "ManagedAuthStateEventPendingSSOButton",
     "ManagedAuthStateEventSignInOption",
 ]
 
 
+class ManagedAuthStateEventChoice(BaseModel):
+    """Canonical auth-flow choice awaiting user selection."""
+
+    id: str
+    """Stable choice identifier for canonical submit."""
+
+    label: str
+    """Human-readable choice label."""
+
+    type: Literal[
+        "mfa_method", "sso_provider", "sign_in_method", "auth_method", "identifier_method", "account", "other"
+    ]
+    """Choice type."""
+
+    description: Optional[str] = None
+    """Additional context for the choice."""
+
+    observed_selector: Optional[str] = None
+    """Selector for the visible choice, when available."""
+
+
 class ManagedAuthStateEventDiscoveredField(BaseModel):
     """A discovered form field"""
 
@@ -53,6 +76,28 @@ class ManagedAuthStateEventDiscoveredField(BaseModel):
     """Whether field is required"""
 
 
+class ManagedAuthStateEventField(BaseModel):
+    """Canonical field awaiting user input."""
+
+    id: str
+    """Stable field identifier for canonical submit."""
+
+    ref: str
+    """Credential reference name to store the submitted value under."""
+
+    type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
+    """Managed-auth field type."""
+
+    label: Optional[str] = None
+    """Human-readable label shown to the user."""
+
+    observed_selector: Optional[str] = None
+    """Selector for the visible field, when available."""
+
+    required: Optional[bool] = None
+    """Whether this field is required."""
+
+
 class ManagedAuthStateEventMfaOption(BaseModel):
     """An MFA method option for verification"""
 
@@ -118,6 +163,13 @@ class ManagedAuthStateEvent(BaseModel):
     timestamp: datetime
     """Time the state was reported."""
 
+    choices: Optional[List[ManagedAuthStateEventChoice]] = None
+    """Canonical choices awaiting selection.
+
+    Prefer this over pending_sso_buttons, mfa_options, and sign_in_options when
+    present.
+    """
+
     discovered_fields: Optional[List[ManagedAuthStateEventDiscoveredField]] = None
     """
     Fields awaiting input (present when flow_step=AWAITING_INPUT; may also be
@@ -136,6 +188,12 @@ class ManagedAuthStateEvent(BaseModel):
     flow_step=AWAITING_EXTERNAL_ACTION).
     """
 
+    fields: Optional[List[ManagedAuthStateEventField]] = None
+    """Canonical fields awaiting input.
+
+    Prefer this over discovered_fields when present.
+    """
+
     flow_type: Optional[Literal["LOGIN", "REAUTH"]] = None
     """Type of the current flow."""
 

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/types/auth/connection_submit_params.py

@@ -9,12 +9,18 @@ __all__ = ["ConnectionSubmitParams"]
 
 
 class ConnectionSubmitParams(TypedDict, total=False):
+    field_values: Dict[str, str]
+    """Canonical map of field ID to submitted value."""
+
     fields: Dict[str, str]
     """Map of field name to value"""
 
     mfa_option_id: str
     """The MFA method type to select (when mfa_options were returned)"""
 
+    selected_choice_id: str
+    """Canonical choice ID selected by the user."""
+
     sign_in_option_id: str
     """The sign-in option ID to select (when sign_in_options were returned)"""
 

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/types/auth/managed_auth.py

@@ -6,7 +6,37 @@ from typing_extensions import Literal
 
 from ..._models import BaseModel
 
-__all__ = ["ManagedAuth", "Credential", "DiscoveredField", "MfaOption", "PendingSSOButton", "SignInOption"]
+__all__ = [
+    "ManagedAuth",
+    "Choice",
+    "Credential",
+    "DiscoveredField",
+    "Field",
+    "MfaOption",
+    "PendingSSOButton",
+    "SignInOption",
+]
+
+
+class Choice(BaseModel):
+    """Canonical auth-flow choice awaiting user selection."""
+
+    id: str
+    """Stable choice identifier for canonical submit."""
+
+    label: str
+    """Human-readable choice label."""
+
+    type: Literal[
+        "mfa_method", "sso_provider", "sign_in_method", "auth_method", "identifier_method", "account", "other"
+    ]
+    """Choice type."""
+
+    description: Optional[str] = None
+    """Additional context for the choice."""
+
+    observed_selector: Optional[str] = None
+    """Selector for the visible choice, when available."""
 
 
 class Credential(BaseModel):
@@ -65,6 +95,28 @@ class DiscoveredField(BaseModel):
     """Whether field is required"""
 
 
+class Field(BaseModel):
+    """Canonical field awaiting user input."""
+
+    id: str
+    """Stable field identifier for canonical submit."""
+
+    ref: str
+    """Credential reference name to store the submitted value under."""
+
+    type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
+    """Managed-auth field type."""
+
+    label: Optional[str] = None
+    """Human-readable label shown to the user."""
+
+    observed_selector: Optional[str] = None
+    """Selector for the visible field, when available."""
+
+    required: Optional[bool] = None
+    """Whether this field is required."""
+
+
 class MfaOption(BaseModel):
     """An MFA method option for verification"""
 
@@ -243,6 +295,13 @@ class ManagedAuth(BaseModel):
       automatically
     """
 
+    choices: Optional[List[Choice]] = None
+    """Canonical choices awaiting selection.
+
+    Prefer this over pending_sso_buttons, mfa_options, and sign_in_options when
+    present.
+    """
+
     credential: Optional[Credential] = None
     """Reference to credentials for the auth connection. Use one of:
 
@@ -269,6 +328,12 @@ class ManagedAuth(BaseModel):
     flow_step=awaiting_external_action)
     """
 
+    fields: Optional[List[Field]] = None
+    """Canonical fields awaiting input.
+
+    Prefer this over discovered_fields when present.
+    """
+
     flow_expires_at: Optional[datetime] = None
     """When the current flow expires (null when no flow in progress).
 

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/types/auth/managed_auth_timeline_event.py

@@ -35,6 +35,9 @@ class ManagedAuthTimelineEvent(BaseModel):
     session-validity check.
     """
 
+    browser_session_id: Optional[str] = None
+    """Browser session that produced the event, if one was created."""
+
     error_code: Optional[str] = None
     """Machine-readable error code. Present when a login/reauth event failed."""
 

{kernel-0.78.1 → kernel-0.80.0}/src/kernel/types/browser_pool.py

@@ -6,6 +6,7 @@ from datetime import datetime
 from .._models import BaseModel
 from .shared.browser_viewport import BrowserViewport
 from .shared.browser_extension import BrowserExtension
+from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
 __all__ = ["BrowserPool", "BrowserPoolConfig", "BrowserPoolConfigProfile"]
 
@@ -110,6 +111,12 @@ class BrowserPoolConfig(BaseModel):
     mechanisms.
     """
 
+    telemetry: Optional[BrowserTelemetryConfig] = None
+    """
+    Active telemetry configuration applied to browsers warmed into this pool, if
+    any.
+    """
+
     timeout_seconds: Optional[int] = None
     """
     Default idle timeout in seconds for browsers acquired from this pool before they

kernel-0.80.0/src/kernel/types/browser_pool_acquire_params.py

@@ -0,0 +1,88 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from .tags_param import TagsParam
+from .browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
+
+__all__ = ["BrowserPoolAcquireParams", "Telemetry"]
+
+
+class BrowserPoolAcquireParams(TypedDict, total=False):
+    acquire_timeout_seconds: int
+    """Maximum number of seconds to wait for a browser to be available.
+
+    Defaults to the calculated time it would take to fill the pool at the currently
+    configured fill rate.
+    """
+
+    name: str
+    """
+    Optional human-readable name for the acquired browser session, used to find it
+    later in the dashboard. Must be unique among active sessions within the pool's
+    project. Applies to this lease only and is cleared when the browser is released
+    back to the pool.
+    """
+
+    start_url: str
+    """Optional URL to navigate the acquired browser to.
+
+    Overrides the pool's start_url for this acquire only. Best-effort: failures to
+    navigate do not fail the acquire.
+    """
+
+    tags: TagsParam
+    """
+    Optional user-defined key-value tags for the acquired browser session, used to
+    find and group sessions later. Applies to this lease only and are cleared when
+    the browser is released back to the pool. Up to 50 pairs.
+    """
+
+    telemetry: Optional[Telemetry]
+    """Telemetry override for the acquired browser, applied to this lease only.
+
+    Merges onto the browser's current (pool-inherited) telemetry using the same
+    per-category semantics as PATCH /browsers: provided categories override the
+    current configuration, omitted categories are inherited. Set enabled to true to
+    resolve the config fresh from the default set, or enabled to false to stop
+    capture. When the browser is released back to the pool with reuse, its telemetry
+    is reset to the pool's baseline, so the override does not carry over to the next
+    lease.
+    """
+
+
+class Telemetry(TypedDict, total=False):
+    """Telemetry override for the acquired browser, applied to this lease only.
+
+    Merges onto the browser's current (pool-inherited) telemetry using the same per-category semantics as PATCH /browsers: provided categories override the current configuration, omitted categories are inherited. Set enabled to true to resolve the config fresh from the default set, or enabled to false to stop capture. When the browser is released back to the pool with reuse, its telemetry is reset to the pool's baseline, so the override does not carry over to the next lease.
+    """
+
+    browser: BrowserTelemetryCategoriesConfigParam
+    """Per-category capture flags.
+
+    The operational categories (control, connection, system, captcha) are captured
+    whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
+    categories (console, network, page, interaction) and screenshot are off by
+    default; set enabled=true to opt in. On create, provided categories layer onto
+    the default set. On update, provided categories merge onto the session's current
+    config; when no telemetry is active this falls back to the default set (matching
+    create). If browser is omitted or empty, the default set is used. A browser
+    config that disables every category stops capture on update and starts no
+    capture on create.
+    """
+
+    enabled: bool
+    """Request shortcut for browser telemetry capture.
+
+    True enables capture; with no browser category settings it captures the default
+    set (control, connection, system, captcha), and any browser category settings
+    are layered onto that default set. On update, enabled=true resolves the config
+    fresh from the default set plus any provided categories, replacing the session's
+    current selection rather than merging onto it; omit enabled to merge categories
+    onto the current selection instead. False stops capture on update and starts no
+    capture on create. enabled=false cannot be combined with browser category
+    settings.
+    """