kernel 0.81.0__tar.gz → 0.83.0__tar.gz

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

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

{kernel-0.81.0 → kernel-0.83.0}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.83.0 (2026-07-24)
+
+Full Changelog: [v0.82.0...v0.83.0](https://github.com/kernel/kernel-python-sdk/compare/v0.82.0...v0.83.0)
+
+### Features
+
+* Add browser telemetry to managed auth connections ([c19bfbe](https://github.com/kernel/kernel-python-sdk/commit/c19bfbed5eed67758e735fb477c8c6c2afff9e7a))
+
+## 0.82.0 (2026-07-23)
+
+Full Changelog: [v0.81.0...v0.82.0](https://github.com/kernel/kernel-python-sdk/compare/v0.81.0...v0.82.0)
+
+### Features
+
+* Count project names by Unicode code point ([cecdf6d](https://github.com/kernel/kernel-python-sdk/commit/cecdf6d4a4ef7919b6eef5d03f76542b6ade0906))
+* Stream profile downloads as tar archives ([3a2eb97](https://github.com/kernel/kernel-python-sdk/commit/3a2eb97686f3ecf02db16d7bccea803476cb730f))
+* Use format-neutral profile download Accept header ([95d1334](https://github.com/kernel/kernel-python-sdk/commit/95d1334660d2ebaed70d2170233e4bdf3b074958))
+
 ## 0.81.0 (2026-07-21)
 
 Full Changelog: [v0.80.0...v0.81.0](https://github.com/kernel/kernel-python-sdk/compare/v0.80.0...v0.81.0)

{kernel-0.81.0 → kernel-0.83.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.81.0
+Version: 0.83.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.81.0 → kernel-0.83.0}/api.md

@@ -288,7 +288,7 @@ Methods:
 - <code title="patch /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/profile_update_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
 - <code title="get /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">list</a>(\*\*<a href="src/kernel/types/profile_list_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">SyncOffsetPagination[Profile]</a></code>
 - <code title="delete /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">delete</a>(id_or_name) -> None</code>
-- <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/kernel/resources/profiles.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
+- <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/kernel/resources/profiles.py">download</a>(id_or_name, \*\*<a href="src/kernel/types/profile_download_params.py">params</a>) -> BinaryAPIResponse</code>
 
 # Auth
 

{kernel-0.81.0 → kernel-0.83.0}/pyproject.toml

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

{kernel-0.81.0 → kernel-0.83.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.81.0"  # x-release-please-version
+__version__ = "0.83.0"  # x-release-please-version

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/resources/auth/connections.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Dict, cast
+from typing import Any, Dict, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -66,6 +66,7 @@ class ConnectionsResource(SyncAPIResource):
         profile_name: str,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
         auto_reauth: bool | Omit = omit,
+        browser_telemetry: Optional[connection_create_params.BrowserTelemetry] | Omit = omit,
         credential: connection_create_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
         health_checks: bool | Omit = omit,
@@ -119,6 +120,10 @@ class ConnectionsResource(SyncAPIResource):
               false, expired sessions are marked as `NEEDS_AUTH` instead of attempting
               re-auth. Defaults to true.
 
+          browser_telemetry: Browser telemetry configuration used by this connection's browser sessions by
+              default. Uses the exact create-browser configuration. Can be overridden
+              per-login.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -166,6 +171,7 @@ class ConnectionsResource(SyncAPIResource):
                     "profile_name": profile_name,
                     "allowed_domains": allowed_domains,
                     "auto_reauth": auto_reauth,
+                    "browser_telemetry": browser_telemetry,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
                     "health_checks": health_checks,
@@ -223,6 +229,7 @@ class ConnectionsResource(SyncAPIResource):
         *,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
         auto_reauth: bool | Omit = omit,
+        browser_telemetry: Optional[connection_update_params.BrowserTelemetry] | Omit = omit,
         credential: connection_update_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
         health_checks: bool | Omit = omit,
@@ -253,6 +260,10 @@ class ConnectionsResource(SyncAPIResource):
               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_telemetry: Browser telemetry configuration used by future browser sessions for this
+              connection. Uses the exact create-browser configuration. Set enabled to false to
+              disable telemetry.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -294,6 +305,7 @@ class ConnectionsResource(SyncAPIResource):
                 {
                     "allowed_domains": allowed_domains,
                     "auto_reauth": auto_reauth,
+                    "browser_telemetry": browser_telemetry,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
                     "health_checks": health_checks,
@@ -452,6 +464,7 @@ class ConnectionsResource(SyncAPIResource):
         self,
         id: str,
         *,
+        browser_telemetry: Optional[connection_login_params.BrowserTelemetry] | Omit = omit,
         proxy: connection_login_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -468,6 +481,10 @@ class ConnectionsResource(SyncAPIResource):
         credentials are stored.
 
         Args:
+          browser_telemetry: Override the connection's default browser telemetry configuration for this
+              login. When omitted, the connection's browser_telemetry default is used. Uses
+              the exact create-browser configuration.
+
           proxy: Proxy selection. Provide either id or name. The proxy must be in the same
               project as the resource referencing it. When selecting by name, the name must
               match exactly one active proxy in the project. Ambiguous names return a 400; use
@@ -490,6 +507,7 @@ class ConnectionsResource(SyncAPIResource):
             path_template("/auth/connections/{id}/login", id=id),
             body=maybe_transform(
                 {
+                    "browser_telemetry": browser_telemetry,
                     "proxy": proxy,
                     "record_session": record_session,
                 },
@@ -657,6 +675,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
         profile_name: str,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
         auto_reauth: bool | Omit = omit,
+        browser_telemetry: Optional[connection_create_params.BrowserTelemetry] | Omit = omit,
         credential: connection_create_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
         health_checks: bool | Omit = omit,
@@ -710,6 +729,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
               false, expired sessions are marked as `NEEDS_AUTH` instead of attempting
               re-auth. Defaults to true.
 
+          browser_telemetry: Browser telemetry configuration used by this connection's browser sessions by
+              default. Uses the exact create-browser configuration. Can be overridden
+              per-login.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -757,6 +780,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
                     "profile_name": profile_name,
                     "allowed_domains": allowed_domains,
                     "auto_reauth": auto_reauth,
+                    "browser_telemetry": browser_telemetry,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
                     "health_checks": health_checks,
@@ -814,6 +838,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
         *,
         allowed_domains: SequenceNotStr[str] | Omit = omit,
         auto_reauth: bool | Omit = omit,
+        browser_telemetry: Optional[connection_update_params.BrowserTelemetry] | Omit = omit,
         credential: connection_update_params.Credential | Omit = omit,
         health_check_interval: int | Omit = omit,
         health_checks: bool | Omit = omit,
@@ -844,6 +869,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
               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_telemetry: Browser telemetry configuration used by future browser sessions for this
+              connection. Uses the exact create-browser configuration. Set enabled to false to
+              disable telemetry.
+
           credential:
               Reference to credentials for the auth connection. Use one of:
 
@@ -885,6 +914,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
                 {
                     "allowed_domains": allowed_domains,
                     "auto_reauth": auto_reauth,
+                    "browser_telemetry": browser_telemetry,
                     "credential": credential,
                     "health_check_interval": health_check_interval,
                     "health_checks": health_checks,
@@ -1043,6 +1073,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
         self,
         id: str,
         *,
+        browser_telemetry: Optional[connection_login_params.BrowserTelemetry] | Omit = omit,
         proxy: connection_login_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1059,6 +1090,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
         credentials are stored.
 
         Args:
+          browser_telemetry: Override the connection's default browser telemetry configuration for this
+              login. When omitted, the connection's browser_telemetry default is used. Uses
+              the exact create-browser configuration.
+
           proxy: Proxy selection. Provide either id or name. The proxy must be in the same
               project as the resource referencing it. When selecting by name, the name must
               match exactly one active proxy in the project. Ambiguous names return a 400; use
@@ -1081,6 +1116,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
             path_template("/auth/connections/{id}/login", id=id),
             body=await async_maybe_transform(
                 {
+                    "browser_telemetry": browser_telemetry,
                     "proxy": proxy,
                     "record_session": record_session,
                 },

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/resources/profiles.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
+from typing_extensions import Literal
+
 import httpx
 
-from ..types import profile_list_params, profile_create_params, profile_update_params
+from ..types import profile_list_params, profile_create_params, profile_update_params, profile_download_params
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -264,6 +266,7 @@ class ProfilesResource(SyncAPIResource):
         self,
         id_or_name: str,
         *,
+        format: Literal["tar.zst", "tar"] | 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,
@@ -271,10 +274,17 @@ class ProfilesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BinaryAPIResponse:
-        """
-        Returns a zstd-compressed tar file of the full user-data directory.
+        """Downloads the profile in its stored format by default.
+
+        Current profiles are
+        returned as zstd-compressed tar archives, while legacy profiles remain JSON. Set
+        `format=tar` to decompress current profiles during download; legacy profiles
+        remain JSON.
 
         Args:
+          format: Response format for current profile archives. Legacy profiles are always
+              returned as JSON.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -289,7 +299,11 @@ class ProfilesResource(SyncAPIResource):
         return self._get(
             path_template("/profiles/{id_or_name}/download", id_or_name=id_or_name),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"format": format}, profile_download_params.ProfileDownloadParams),
             ),
             cast_to=BinaryAPIResponse,
         )
@@ -529,6 +543,7 @@ class AsyncProfilesResource(AsyncAPIResource):
         self,
         id_or_name: str,
         *,
+        format: Literal["tar.zst", "tar"] | 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,
@@ -536,10 +551,17 @@ class AsyncProfilesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncBinaryAPIResponse:
-        """
-        Returns a zstd-compressed tar file of the full user-data directory.
+        """Downloads the profile in its stored format by default.
+
+        Current profiles are
+        returned as zstd-compressed tar archives, while legacy profiles remain JSON. Set
+        `format=tar` to decompress current profiles during download; legacy profiles
+        remain JSON.
 
         Args:
+          format: Response format for current profile archives. Legacy profiles are always
+              returned as JSON.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -554,7 +576,11 @@ class AsyncProfilesResource(AsyncAPIResource):
         return await self._get(
             path_template("/profiles/{id_or_name}/download", id_or_name=id_or_name),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"format": format}, profile_download_params.ProfileDownloadParams),
             ),
             cast_to=AsyncBinaryAPIResponse,
         )

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/resources/projects/projects.py

@@ -74,7 +74,7 @@ class ProjectsResource(SyncAPIResource):
         Create a new project within the authenticated organization.
 
         Args:
-          name: Project name (1-255 characters)
+          name: Project name (1-255 Unicode code points)
 
           extra_headers: Send extra headers
 
@@ -144,7 +144,7 @@ class ProjectsResource(SyncAPIResource):
         Update a project's name or status.
 
         Args:
-          name: New project name
+          name: New project name (1-255 Unicode code points)
 
           status: New project status
 
@@ -307,7 +307,7 @@ class AsyncProjectsResource(AsyncAPIResource):
         Create a new project within the authenticated organization.
 
         Args:
-          name: Project name (1-255 characters)
+          name: Project name (1-255 Unicode code points)
 
           extra_headers: Send extra headers
 
@@ -377,7 +377,7 @@ class AsyncProjectsResource(AsyncAPIResource):
         Update a project's name or status.
 
         Args:
-          name: New project name
+          name: New project name (1-255 Unicode code points)
 
           status: New project status
 

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/types/__init__.py

@@ -67,6 +67,7 @@ from .browser_retrieve_params import BrowserRetrieveParams as BrowserRetrievePar
 from .browser_update_response import BrowserUpdateResponse as BrowserUpdateResponse
 from .extension_list_response import ExtensionListResponse as ExtensionListResponse
 from .extension_upload_params import ExtensionUploadParams as ExtensionUploadParams
+from .profile_download_params import ProfileDownloadParams as ProfileDownloadParams
 from .proxy_retrieve_response import ProxyRetrieveResponse as ProxyRetrieveResponse
 from .browser_pool_list_params import BrowserPoolListParams as BrowserPoolListParams
 from .credential_create_params import CredentialCreateParams as CredentialCreateParams

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/types/auth/connection_create_params.py

@@ -2,11 +2,13 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Required, TypedDict
 
 from ..._types import SequenceNotStr
+from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["ConnectionCreateParams", "Credential", "Proxy"]
+__all__ = ["ConnectionCreateParams", "BrowserTelemetry", "Credential", "Proxy"]
 
 
 class ConnectionCreateParams(TypedDict, total=False):
@@ -52,6 +54,13 @@ class ConnectionCreateParams(TypedDict, total=False):
     re-auth. Defaults to true.
     """
 
+    browser_telemetry: Optional[BrowserTelemetry]
+    """
+    Browser telemetry configuration used by this connection's browser sessions by
+    default. Uses the exact create-browser configuration. Can be overridden
+    per-login.
+    """
+
     credential: Credential
     """Reference to credentials for the auth connection. Use one of:
 
@@ -102,6 +111,39 @@ class ConnectionCreateParams(TypedDict, total=False):
     """
 
 
+class BrowserTelemetry(TypedDict, total=False):
+    """
+    Browser telemetry configuration used by this connection's browser sessions by default. Uses the exact create-browser configuration. Can be overridden per-login.
+    """
+
+    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.
+    """
+
+
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.
 

kernel-0.83.0/src/kernel/types/auth/connection_login_params.py

@@ -0,0 +1,83 @@
+# 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 ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
+
+__all__ = ["ConnectionLoginParams", "BrowserTelemetry", "Proxy"]
+
+
+class ConnectionLoginParams(TypedDict, total=False):
+    browser_telemetry: Optional[BrowserTelemetry]
+    """Override the connection's default browser telemetry configuration for this
+    login.
+
+    When omitted, the connection's browser_telemetry default is used. Uses the exact
+    create-browser configuration.
+    """
+
+    proxy: Proxy
+    """Proxy selection.
+
+    Provide either id or name. The proxy must be in the same project as the resource
+    referencing it. When selecting by name, the name must match exactly one active
+    proxy in the project. Ambiguous names return a 400; use id for stable
+    references.
+    """
+
+    record_session: bool
+    """Override the connection's default for recording this login's browser session.
+
+    When omitted, the connection's record_session default is used.
+    """
+
+
+class BrowserTelemetry(TypedDict, total=False):
+    """Override the connection's default browser telemetry configuration for this login.
+
+    When omitted, the connection's browser_telemetry default is used. Uses the exact create-browser configuration.
+    """
+
+    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.
+    """
+
+
+class Proxy(TypedDict, total=False):
+    """Proxy selection.
+
+    Provide either id or name. The proxy must be in the same project as the resource referencing it.
+    When selecting by name, the name must match exactly one active proxy in the project. Ambiguous names return a 400; use id for stable references.
+    """
+
+    id: str
+    """Proxy ID"""
+
+    name: str
+    """Proxy name"""

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/types/auth/connection_update_params.py

@@ -2,11 +2,13 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import TypedDict
 
 from ..._types import SequenceNotStr
+from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["ConnectionUpdateParams", "Credential", "Proxy"]
+__all__ = ["ConnectionUpdateParams", "BrowserTelemetry", "Credential", "Proxy"]
 
 
 class ConnectionUpdateParams(TypedDict, total=False):
@@ -25,6 +27,13 @@ class ConnectionUpdateParams(TypedDict, total=False):
     re-auth.
     """
 
+    browser_telemetry: Optional[BrowserTelemetry]
+    """
+    Browser telemetry configuration used by future browser sessions for this
+    connection. Uses the exact create-browser configuration. Set enabled to false to
+    disable telemetry.
+    """
+
     credential: Credential
     """Reference to credentials for the auth connection. Use one of:
 
@@ -63,6 +72,39 @@ class ConnectionUpdateParams(TypedDict, total=False):
     """Whether to save credentials after every successful login"""
 
 
+class BrowserTelemetry(TypedDict, total=False):
+    """
+    Browser telemetry configuration used by future browser sessions for this connection. Uses the exact create-browser configuration. Set enabled to false to disable telemetry.
+    """
+
+    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.
+    """
+
+
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.
 

{kernel-0.81.0 → kernel-0.83.0}/src/kernel/types/auth/managed_auth.py

@@ -5,9 +5,11 @@ from datetime import datetime
 from typing_extensions import Literal
 
 from ..._models import BaseModel
+from ..browsers.browser_telemetry_categories_config import BrowserTelemetryCategoriesConfig
 
 __all__ = [
     "ManagedAuth",
+    "BrowserTelemetry",
     "Choice",
     "Credential",
     "DiscoveredField",
@@ -18,6 +20,39 @@ __all__ = [
 ]
 
 
+class BrowserTelemetry(BaseModel):
+    """
+    Browser telemetry configuration used by this connection's browser sessions by default. The exact create-browser configuration is preserved and can be overridden per-login.
+    """
+
+    browser: Optional[BrowserTelemetryCategoriesConfig] = None
+    """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: Optional[bool] = None
+    """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.
+    """
+
+
 class Choice(BaseModel):
     """Canonical auth-flow choice awaiting user selection."""
 
@@ -237,6 +272,13 @@ class ManagedAuth(BaseModel):
     `/browsers` API.
     """
 
+    browser_telemetry: Optional[BrowserTelemetry] = None
+    """
+    Browser telemetry configuration used by this connection's browser sessions by
+    default. The exact create-browser configuration is preserved and can be
+    overridden per-login.
+    """
+
     can_reauth: Optional[bool] = None
     """
     Whether Kernel can automatically re-authenticate this connection when the