kernel 0.56.0__tar.gz → 0.57.0__tar.gz

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

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

{kernel-0.56.0 → kernel-0.57.0}/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.57.0 (2026-05-22)
+
+Full Changelog: [v0.56.0...v0.57.0](https://github.com/kernel/kernel-python-sdk/compare/v0.56.0...v0.57.0)
+
+### Features
+
+* [kernel-1116] browser events api integration ([bfd4043](https://github.com/kernel/kernel-python-sdk/commit/bfd404368adf8a4305aabe2fad448e7eeba40322))
+* **api:** type can_reauth_reason as an enum on ManagedAuth ([c9a6c75](https://github.com/kernel/kernel-python-sdk/commit/c9a6c7571ca9eb18b3ef11974571fa1426d2dd61))
+* browsers: accept chrome_policy on POST /browsers (KERNEL-1216) ([b1807a2](https://github.com/kernel/kernel-python-sdk/commit/b1807a2d690f206e7482f5862acde36e692d07aa))
+* EOL persistent browsers: openapi limits ([253be85](https://github.com/kernel/kernel-python-sdk/commit/253be85c497bf65329c484e28a3732b3bd5b3208))
+
 ## 0.56.0 (2026-05-18)
 
 Full Changelog: [v0.55.0...v0.56.0](https://github.com/kernel/kernel-python-sdk/compare/v0.55.0...v0.56.0)

{kernel-0.56.0 → kernel-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.56.0
+Version: 0.57.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
@@ -238,9 +238,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    persistence={"id": "my-awesome-browser-for-user-1234"},
+    profile={},
 )
-print(browser.persistence)
+print(browser.profile)
 ```
 
 ## File uploads

{kernel-0.56.0 → kernel-0.57.0}/README.md

@@ -203,9 +203,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    persistence={"id": "my-awesome-browser-for-user-1234"},
+    profile={},
 )
-print(browser.persistence)
+print(browser.profile)
 ```
 
 ## File uploads

{kernel-0.56.0 → kernel-0.57.0}/api.md

@@ -80,7 +80,6 @@ Types:
 
 ```python
 from kernel.types import (
-    BrowserPersistence,
     BrowserPoolRef,
     BrowserUsage,
     Profile,
@@ -98,11 +97,54 @@ Methods:
 - <code title="get /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">retrieve</a>(id, \*\*<a href="src/kernel/types/browser_retrieve_params.py">params</a>) -> <a href="./src/kernel/types/browser_retrieve_response.py">BrowserRetrieveResponse</a></code>
 - <code title="patch /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">update</a>(id, \*\*<a href="src/kernel/types/browser_update_params.py">params</a>) -> <a href="./src/kernel/types/browser_update_response.py">BrowserUpdateResponse</a></code>
 - <code title="get /browsers">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">list</a>(\*\*<a href="src/kernel/types/browser_list_params.py">params</a>) -> <a href="./src/kernel/types/browser_list_response.py">SyncOffsetPagination[BrowserListResponse]</a></code>
-- <code title="delete /browsers">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete</a>(\*\*<a href="src/kernel/types/browser_delete_params.py">params</a>) -> None</code>
 - <code title="post /browsers/{id}/curl">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">curl</a>(id, \*\*<a href="src/kernel/types/browser_curl_params.py">params</a>) -> <a href="./src/kernel/types/browser_curl_response.py">BrowserCurlResponse</a></code>
 - <code title="delete /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete_by_id</a>(id) -> None</code>
 - <code title="post /browsers/{id}/extensions">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">load_extensions</a>(id, \*\*<a href="src/kernel/types/browser_load_extensions_params.py">params</a>) -> None</code>
 
+## Telemetry
+
+Types:
+
+```python
+from kernel.types.browsers import (
+    BrowserCallStack,
+    BrowserConsoleErrorEvent,
+    BrowserConsoleLogEvent,
+    BrowserEventContext,
+    BrowserEventSource,
+    BrowserHTTPHeaders,
+    BrowserInteractionClickEvent,
+    BrowserInteractionKeyEvent,
+    BrowserInteractionScrollSettledEvent,
+    BrowserMonitorDisconnectedEvent,
+    BrowserMonitorInitFailedEvent,
+    BrowserMonitorReconnectFailedEvent,
+    BrowserMonitorReconnectedEvent,
+    BrowserMonitorScreenshotEvent,
+    BrowserNetworkIdleEvent,
+    BrowserNetworkLoadingFailedEvent,
+    BrowserNetworkRequestEvent,
+    BrowserNetworkResponseEvent,
+    BrowserPageDomContentLoadedEvent,
+    BrowserPageLayoutSettledEvent,
+    BrowserPageLayoutShiftEvent,
+    BrowserPageLcpEvent,
+    BrowserPageLoadEvent,
+    BrowserPageNavigationEvent,
+    BrowserPageNavigationSettledEvent,
+    BrowserPageTabOpenedEvent,
+    BrowserTelemetryCategoriesConfig,
+    BrowserTelemetryCategoryConfig,
+    BrowserTelemetryConfig,
+    BrowserTelemetryEvent,
+    TelemetryStreamResponse,
+)
+```
+
+Methods:
+
+- <code title="get /browsers/{id}/telemetry">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">stream</a>(id) -> <a href="./src/kernel/types/browsers/telemetry_stream_response.py">TelemetryStreamResponse</a></code>
+
 ## Replays
 
 Types:

{kernel-0.56.0 → kernel-0.57.0}/pyproject.toml

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

{kernel-0.56.0 → kernel-0.57.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.56.0"  # x-release-please-version
+__version__ = "0.57.0"  # x-release-please-version

{kernel-0.56.0 → kernel-0.57.0}/src/kernel/resources/browser_pools.py

@@ -110,9 +110,11 @@ 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 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.
+          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.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -259,9 +261,11 @@ 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 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.
+          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.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -584,9 +588,11 @@ 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 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.
+          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.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
@@ -733,9 +739,11 @@ 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 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.
+          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.
 
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.

{kernel-0.56.0 → kernel-0.57.0}/src/kernel/resources/browsers/__init__.py

@@ -48,6 +48,14 @@ from .computer import (
     ComputerResourceWithStreamingResponse,
     AsyncComputerResourceWithStreamingResponse,
 )
+from .telemetry import (
+    TelemetryResource,
+    AsyncTelemetryResource,
+    TelemetryResourceWithRawResponse,
+    AsyncTelemetryResourceWithRawResponse,
+    TelemetryResourceWithStreamingResponse,
+    AsyncTelemetryResourceWithStreamingResponse,
+)
 from .playwright import (
     PlaywrightResource,
     AsyncPlaywrightResource,
@@ -58,6 +66,12 @@ from .playwright import (
 )
 
 __all__ = [
+    "TelemetryResource",
+    "AsyncTelemetryResource",
+    "TelemetryResourceWithRawResponse",
+    "AsyncTelemetryResourceWithRawResponse",
+    "TelemetryResourceWithStreamingResponse",
+    "AsyncTelemetryResourceWithStreamingResponse",
     "ReplaysResource",
     "AsyncReplaysResource",
     "ReplaysResourceWithRawResponse",