release: 0.147.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.146.0"
+  ".": "0.147.0"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.147.0](https://github.com/kernel/kernel-python-sdk/compare/v0.146.0...v0.147.0) (2026-11-12)
+
+
+### Features
+
+* Prepare native OAuth for MCP: path resource, exchange targets, static exchange client, retention, Clerk OAuth cutoff ([5976b83](https://github.com/kernel/kernel-python-sdk/commit/5976b838d244effe63464f64a35a8671a7624426))
+
 ## [0.146.0](https://github.com/kernel/kernel-python-sdk/compare/v0.145.0...v0.146.0) (2026-11-10)
 
 

api.md

@@ -436,6 +436,7 @@ from kernel.types.auth import (
     LoginResponse,
     ManagedAuth,
     ManagedAuthBrowserConfig,
+    ManagedAuthBrowserLocation,
     ManagedAuthCreateRequest,
     ManagedAuthTimelineEvent,
     ManagedAuthUpdateRequest,

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.146.0"
+version = "0.147.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.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.146.0"  # x-release-please-version
+__version__ = "0.147.0"  # x-release-please-version

src/kernel/types/auth/__init__.py

@@ -15,4 +15,6 @@
 from .connection_timeline_params import ConnectionTimelineParams as ConnectionTimelineParams
 from .managed_auth_browser_config import ManagedAuthBrowserConfig as ManagedAuthBrowserConfig
 from .managed_auth_timeline_event import ManagedAuthTimelineEvent as ManagedAuthTimelineEvent
+from .managed_auth_browser_location import ManagedAuthBrowserLocation as ManagedAuthBrowserLocation
 from .managed_auth_browser_config_param import ManagedAuthBrowserConfigParam as ManagedAuthBrowserConfigParam
+from .managed_auth_browser_location_param import ManagedAuthBrowserLocationParam as ManagedAuthBrowserLocationParam

src/kernel/types/auth/managed_auth_browser_config.py

@@ -5,6 +5,7 @@
 
 from ..._models import BaseModel
 from ..browser_proxy_config import BrowserProxyConfig
+from .managed_auth_browser_location import ManagedAuthBrowserLocation
 from ..browsers.browser_telemetry_categories_config import BrowserTelemetryCategoriesConfig
 
 __all__ = [
@@ -117,6 +118,12 @@ class ManagedAuthBrowserConfig(BaseModel):
     Browser configuration applied to browser sessions created for a managed auth connection. Managed auth controls the profile, headless mode, timeout, start URL, kiosk mode, and viewport.
     """
 
+    location: Optional[ManagedAuthBrowserLocation] = None
+    """
+    Browser locale for the connection's login, reauthentication, and health-check
+    sessions. Set on create or update; not supported on login.
+    """
+
     proxy: Optional[BrowserProxyConfig] = None
     """Proxy configuration for managed auth browser sessions.
 

src/kernel/types/auth/managed_auth_browser_config_param.py

@@ -6,6 +6,7 @@
 from typing_extensions import Literal, TypedDict
 
 from ..browser_proxy_config_param import BrowserProxyConfigParam
+from .managed_auth_browser_location_param import ManagedAuthBrowserLocationParam
 from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
 __all__ = [
@@ -118,6 +119,12 @@ class ManagedAuthBrowserConfigParam(TypedDict, total=False):
     Browser configuration applied to browser sessions created for a managed auth connection. Managed auth controls the profile, headless mode, timeout, start URL, kiosk mode, and viewport.
     """
 
+    location: ManagedAuthBrowserLocationParam
+    """
+    Browser locale for the connection's login, reauthentication, and health-check
+    sessions. Set on create or update; not supported on login.
+    """
+
     proxy: BrowserProxyConfigParam
     """Proxy configuration for managed auth browser sessions.
 

src/kernel/types/auth/managed_auth_browser_location.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ManagedAuthBrowserLocation"]
+
+
+class ManagedAuthBrowserLocation(BaseModel):
+    """
+    Browser locale applied to browser sessions created for a managed auth connection.
+    """
+
+    locale: Optional[str] = None
+    """
+    Supported canonical BCP 47 locale for the browser's language and Accept-Language
+    header. Omit to use the default for the browser's region, or omit on update to
+    keep the current locale. Null clears it on update.
+    """

src/kernel/types/auth/managed_auth_browser_location_param.py

@@ -0,0 +1,21 @@
+# 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
+
+__all__ = ["ManagedAuthBrowserLocationParam"]
+
+
+class ManagedAuthBrowserLocationParam(TypedDict, total=False):
+    """
+    Browser locale applied to browser sessions created for a managed auth connection.
+    """
+
+    locale: Optional[str]
+    """
+    Supported canonical BCP 47 locale for the browser's language and Accept-Language
+    header. Omit to use the default for the browser's region, or omit on update to
+    keep the current locale. Null clears it on update.
+    """

src/kernel/types/browser_create_response.py

@@ -18,7 +18,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["BrowserCreateResponse"]
+__all__ = ["BrowserCreateResponse", "Replay"]
+
+
+class Replay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class BrowserCreateResponse(BaseModel):
@@ -116,6 +134,13 @@ class BrowserCreateResponse(BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[Replay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.
 

src/kernel/types/browser_list_response.py

@@ -18,7 +18,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["BrowserListResponse"]
+__all__ = ["BrowserListResponse", "Replay"]
+
+
+class Replay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class BrowserListResponse(BaseModel):
@@ -116,6 +134,13 @@ class BrowserListResponse(BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[Replay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.
 

src/kernel/types/browser_pool_acquire_response.py

@@ -19,7 +19,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["BrowserPoolAcquireResponse"]
+__all__ = ["BrowserPoolAcquireResponse", "Replay"]
+
+
+class Replay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class BrowserPoolAcquireResponse(NoContentAsNone, BaseModel):
@@ -117,6 +135,13 @@ class BrowserPoolAcquireResponse(NoContentAsNone, BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[Replay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.
 

src/kernel/types/browser_retrieve_response.py

@@ -18,7 +18,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["BrowserRetrieveResponse"]
+__all__ = ["BrowserRetrieveResponse", "Replay"]
+
+
+class Replay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class BrowserRetrieveResponse(BaseModel):
@@ -116,6 +134,13 @@ class BrowserRetrieveResponse(BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[Replay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.
 

src/kernel/types/browser_update_response.py

@@ -18,7 +18,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["BrowserUpdateResponse"]
+__all__ = ["BrowserUpdateResponse", "Replay"]
+
+
+class Replay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class BrowserUpdateResponse(BaseModel):
@@ -116,6 +134,13 @@ class BrowserUpdateResponse(BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[Replay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.
 

src/kernel/types/invocation_list_browsers_response.py

@@ -18,7 +18,25 @@
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
-__all__ = ["InvocationListBrowsersResponse", "Browser"]
+__all__ = ["InvocationListBrowsersResponse", "Browser", "BrowserReplay"]
+
+
+class BrowserReplay(BaseModel):
+    """
+    Replay recording started by `start_replay` when this browser was created or acquired. Omitted otherwise; list replays with `GET /browsers/{id_or_name}/replays`.
+    """
+
+    replay_id: str
+    """Unique identifier for the replay recording."""
+
+    finished_at: Optional[datetime] = None
+    """Timestamp when replay finished"""
+
+    replay_view_url: Optional[str] = None
+    """URL for viewing the replay recording."""
+
+    started_at: Optional[datetime] = None
+    """Timestamp when replay started"""
 
 
 class Browser(BaseModel):
@@ -116,6 +134,13 @@ class Browser(BaseModel):
     Deprecated in favor of proxy.
     """
 
+    replay: Optional[BrowserReplay] = None
+    """
+    Replay recording started by `start_replay` when this browser was created or
+    acquired. Omitted otherwise; list replays with
+    `GET /browsers/{id_or_name}/replays`.
+    """
+
     start_url: Optional[str] = None
     """URL the session was most recently asked to navigate to, if any.