kernel 0.68.0__tar.gz → 0.70.0__tar.gz

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

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

{kernel-0.68.0 → kernel-0.70.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.70.0 (2026-06-24)
+
+Full Changelog: [v0.69.0...v0.70.0](https://github.com/kernel/kernel-python-sdk/compare/v0.69.0...v0.70.0)
+
+### Features
+
+* Add GET /browsers/{id}/telemetry/events (read from S2) ([57eb393](https://github.com/kernel/kernel-python-sdk/commit/57eb393ea1eb5fb0d2e5211845f338610198a0fd))
+* Align browser-pool timeout/viewport/fill-rate contract with implementation; reject save_changes on update ([4fddd6b](https://github.com/kernel/kernel-python-sdk/commit/4fddd6bb3f2ccb86ec3cc492311d5fe9c061ba49))
+* api: support per-acquire start_url override on browser pool acquire ([3e11311](https://github.com/kernel/kernel-python-sdk/commit/3e11311f835d558c4fa6ab0c0fb8a9c7e3536a13))
+* **api:** add GET /extensions/{id_or_name}/metadata ([681a8fc](https://github.com/kernel/kernel-python-sdk/commit/681a8fcd7d8ec5c3373a66c81fb405a6844308eb))
+* **api:** resolve GET /org/projects/{id} by ID or name ([52eb598](https://github.com/kernel/kernel-python-sdk/commit/52eb598c7bfd6e696f0d510585439ba5658dc161))
+* Forward replay param through telemetry stream passthrough ([a8001d2](https://github.com/kernel/kernel-python-sdk/commit/a8001d239ae583fa177164e1ce900e767797c853))
+
+
+### Bug Fixes
+
+* don't misroute telemetry/events to the browser VM ([9bcc418](https://github.com/kernel/kernel-python-sdk/commit/9bcc418b4294295c0d8377adfc921c3748d42019))
+
+## 0.69.0 (2026-06-18)
+
+Full Changelog: [v0.68.0...v0.69.0](https://github.com/kernel/kernel-python-sdk/compare/v0.68.0...v0.69.0)
+
+### Features
+
+* Add free-text search to remaining paginated list endpoints ([b34f843](https://github.com/kernel/kernel-python-sdk/commit/b34f843f664307beeb23ec96a1162ee70fd3df1e))
+
 ## 0.68.0 (2026-06-15)
 
 Full Changelog: [v0.67.0...v0.68.0](https://github.com/kernel/kernel-python-sdk/compare/v0.67.0...v0.68.0)

{kernel-0.68.0 → kernel-0.70.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.68.0
+Version: 0.70.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.68.0 → kernel-0.70.0}/api.md

@@ -146,13 +146,15 @@ from kernel.types.browsers import (
     BrowserTelemetryCategoryConfig,
     BrowserTelemetryConfig,
     BrowserTelemetryEvent,
+    TelemetryEventsResponse,
     TelemetryStreamResponse,
 )
 ```
 
 Methods:
 
-- <code title="get /browsers/{id}/telemetry/stream">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>
+- <code title="get /browsers/{id}/telemetry/events">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">events</a>(id, \*\*<a href="src/kernel/types/browsers/telemetry_events_params.py">params</a>) -> <a href="./src/kernel/types/browsers/telemetry_events_response.py">SyncOffsetPagination[TelemetryEventsResponse]</a></code>
+- <code title="get /browsers/{id}/telemetry/stream">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">stream</a>(id, \*\*<a href="src/kernel/types/browsers/telemetry_stream_params.py">params</a>) -> <a href="./src/kernel/types/browsers/telemetry_stream_response.py">TelemetryStreamResponse</a></code>
 
 ## Replays
 
@@ -342,7 +344,7 @@ Methods:
 Types:
 
 ```python
-from kernel.types import ExtensionListResponse, ExtensionUploadResponse
+from kernel.types import ExtensionListResponse, ExtensionGetResponse, ExtensionUploadResponse
 ```
 
 Methods:
@@ -351,6 +353,7 @@ Methods:
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/kernel/resources/extensions.py">download_from_chrome_store</a>(\*\*<a href="src/kernel/types/extension_download_from_chrome_store_params.py">params</a>) -> BinaryAPIResponse</code>
+- <code title="get /extensions/{id_or_name}/metadata">client.extensions.<a href="./src/kernel/resources/extensions.py">get</a>(id_or_name) -> <a href="./src/kernel/types/extension_get_response.py">ExtensionGetResponse</a></code>
 - <code title="post /extensions">client.extensions.<a href="./src/kernel/resources/extensions.py">upload</a>(\*\*<a href="src/kernel/types/extension_upload_params.py">params</a>) -> <a href="./src/kernel/types/extension_upload_response.py">ExtensionUploadResponse</a></code>
 
 # BrowserPools

{kernel-0.68.0 → kernel-0.70.0}/pyproject.toml

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

{kernel-0.68.0 → kernel-0.70.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.68.0"  # x-release-please-version
+__version__ = "0.70.0"  # x-release-please-version

{kernel-0.68.0 → kernel-0.70.0}/src/kernel/lib/browser_routing/routing.py

@@ -41,7 +41,10 @@ _BROWSER_POOL_RELEASE_PATH = re.compile(r"^/(?:v\d+/)?browser_pools/[^/]+/releas
 def browser_routing_config_from_env() -> BrowserRoutingConfig:
     raw = os.environ.get("KERNEL_BROWSER_ROUTING_SUBRESOURCES")
     if raw is None:
-        return BrowserRoutingConfig(subresources=("curl", "telemetry"))
+        # Path prefixes eligible for direct-to-VM routing. "telemetry/stream" is
+        # the live SSE endpoint (VM); "telemetry/events" is a historical read
+        # served by the control plane (S2) and must NOT be here.
+        return BrowserRoutingConfig(subresources=("curl", "telemetry/stream"))
     if raw.strip() == "":
         return BrowserRoutingConfig()
 
@@ -188,6 +191,21 @@ def _session_id_from_browser_pool_release_request(request: httpx.Request, path:
     return normalized or None
 
 
+def _matches_direct_vm_prefix(tail: str, prefixes: tuple[str, ...]) -> bool:
+    """Whether tail (the path after browsers/{id}/) is covered by an allow prefix,
+    matching on segment boundaries: "telemetry/stream" matches "telemetry/stream"
+    and "telemetry/stream/...", but not "telemetry/events" or "telemetry/streamfoo".
+    Keeps historical control-plane reads (e.g. telemetry/events, served from S2)
+    off the VM.
+    """
+    tail = tail.strip("/")
+    for prefix in prefixes:
+        prefix = prefix.strip("/")
+        if prefix and (tail == prefix or tail.startswith(prefix + "/")):
+            return True
+    return False
+
+
 def rewrite_direct_vm_options(
     options: FinalRequestOptions,
     *,
@@ -199,7 +217,7 @@ def rewrite_direct_vm_options(
         return options
 
     session_id, subresource, suffix = match
-    if subresource not in set(config.subresources):
+    if not _matches_direct_vm_prefix(f"{subresource}{suffix}", config.subresources):
         return options
 
     route = cache.get(session_id)

{kernel-0.68.0 → kernel-0.70.0}/src/kernel/resources/auth/connections.py

@@ -310,6 +310,7 @@ class ConnectionsResource(SyncAPIResource):
         limit: int | Omit = omit,
         offset: int | Omit = omit,
         profile_name: str | Omit = omit,
+        query: str | 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,
@@ -329,6 +330,8 @@ class ConnectionsResource(SyncAPIResource):
 
           profile_name: Filter by profile name
 
+          query: Search auth connections by ID, domain, or profile name.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -351,6 +354,7 @@ class ConnectionsResource(SyncAPIResource):
                         "limit": limit,
                         "offset": offset,
                         "profile_name": profile_name,
+                        "query": query,
                     },
                     connection_list_params.ConnectionListParams,
                 ),
@@ -827,6 +831,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
         limit: int | Omit = omit,
         offset: int | Omit = omit,
         profile_name: str | Omit = omit,
+        query: str | 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,
@@ -846,6 +851,8 @@ class AsyncConnectionsResource(AsyncAPIResource):
 
           profile_name: Filter by profile name
 
+          query: Search auth connections by ID, domain, or profile name.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -868,6 +875,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
                         "limit": limit,
                         "offset": offset,
                         "profile_name": profile_name,
+                        "query": query,
                     },
                     connection_list_params.ConnectionListParams,
                 ),

{kernel-0.68.0 → kernel-0.70.0}/src/kernel/resources/browser_pools.py

@@ -96,7 +96,9 @@ class BrowserPoolsResource(SyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -122,7 +124,7 @@ class BrowserPoolsResource(SyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -243,7 +245,9 @@ class BrowserPoolsResource(SyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -273,7 +277,7 @@ class BrowserPoolsResource(SyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -330,6 +334,7 @@ class BrowserPoolsResource(SyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | 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,
@@ -345,6 +350,8 @@ class BrowserPoolsResource(SyncAPIResource):
 
           offset: Offset the number of browser pools to return.
 
+          query: Search browser pools by name or ID.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -365,6 +372,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
                     },
                     browser_pool_list_params.BrowserPoolListParams,
                 ),
@@ -419,6 +427,7 @@ class BrowserPoolsResource(SyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -444,6 +453,10 @@ class BrowserPoolsResource(SyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: 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: 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.
@@ -464,6 +477,7 @@ class BrowserPoolsResource(SyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
@@ -617,7 +631,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -643,7 +659,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -764,7 +780,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -794,7 +812,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -851,6 +869,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | 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,
@@ -866,6 +885,8 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           offset: Offset the number of browser pools to return.
 
+          query: Search browser pools by name or ID.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -886,6 +907,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
                     },
                     browser_pool_list_params.BrowserPoolListParams,
                 ),
@@ -940,6 +962,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -965,6 +988,10 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: 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: 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.
@@ -985,6 +1012,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,