kernel 0.58.0__tar.gz → 0.60.0__tar.gz

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

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

{kernel-0.58.0 → kernel-0.60.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.60.0 (2026-06-03)
+
+Full Changelog: [v0.59.0...v0.60.0](https://github.com/kernel/kernel-python-sdk/compare/v0.59.0...v0.60.0)
+
+### Features
+
+* Add API-backed API key management endpoints ([55bd31e](https://github.com/kernel/kernel-python-sdk/commit/55bd31edfed74f3bc4b08f83e07448e2e53378b0))
+* **examples:** add browser-telemetry example ([4c29993](https://github.com/kernel/kernel-python-sdk/commit/4c29993cdda50fcde19ee7bf696a268cd8b0eb0b))
+* Fix browser pool update schema ([903fe13](https://github.com/kernel/kernel-python-sdk/commit/903fe13b84242acea9c27bc451c16fb5cd58e40c))
+* route browser telemetry directly to the VM by default ([cb50725](https://github.com/kernel/kernel-python-sdk/commit/cb5072516416627ffde7198900484c46dda5b9dc))
+
+
+### Bug Fixes
+
+* **streaming:** don't dispatch empty SSE keepalive comment frames ([a0ee2b2](https://github.com/kernel/kernel-python-sdk/commit/a0ee2b2653c581839be11bb29be5b68166e80658))
+
+## 0.59.0 (2026-06-03)
+
+Full Changelog: [v0.58.0...v0.59.0](https://github.com/kernel/kernel-python-sdk/compare/v0.58.0...v0.59.0)
+
+### Features
+
+* api: surface category field on browser telemetry events ([06a2f7b](https://github.com/kernel/kernel-python-sdk/commit/06a2f7babbc8f6ea31e46f3dfeb8d09dbaae88f0))
+* **api:** move browser telemetry SSE stream to /browsers/{id}/telemetry/stream ([5de851a](https://github.com/kernel/kernel-python-sdk/commit/5de851a5ff708a3e42e276e3cf9e2fe7ef0f2ed6))
+* Support Byteful mobile proxies ([8c0ce1c](https://github.com/kernel/kernel-python-sdk/commit/8c0ce1c1533a538483419f4da0937a6153eb5273))
+
+
+### Bug Fixes
+
+* **api:** move batch + get_mouse_position into Browser Computer Controls tag ([7cbc848](https://github.com/kernel/kernel-python-sdk/commit/7cbc848fe33394ee05f5eb96d62cdc8b5b9b9d9c))
+
 ## 0.58.0 (2026-05-27)
 
 Full Changelog: [v0.57.0...v0.58.0](https://github.com/kernel/kernel-python-sdk/compare/v0.57.0...v0.58.0)

{kernel-0.58.0 → kernel-0.60.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.58.0
+Version: 0.60.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.58.0 → kernel-0.60.0}/api.md

@@ -143,7 +143,7 @@ from kernel.types.browsers import (
 
 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>
+- <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>
 
 ## Replays
 

kernel-0.60.0/examples/browser_telemetry.py

@@ -0,0 +1,32 @@
+"""Example: stream live browser telemetry events from a session."""
+
+from kernel import Kernel
+
+
+def main() -> None:
+    client = Kernel()
+
+    # Enable telemetry capture when creating the browser.
+    browser = client.browsers.create(telemetry={"enabled": True})
+
+    try:
+        # Telemetry is a default direct-to-VM routing subresource, so the stream
+        # connects straight to the browser VM automatically.
+        stream = client.browsers.telemetry.stream(browser.session_id)
+
+        # Make a few browser activity calls to generate events. The "api" telemetry
+        # category emits an event per VM API call, so events arrive within ~1s.
+        for _ in range(3):
+            client.browsers.curl(browser.session_id, url="https://example.com", method="GET")
+
+        # Print a few events, then stop so we don't wait on the 15s keepalive.
+        for count, message in enumerate(stream, start=1):
+            print(message.seq, message.event.type)
+            if count >= 3:
+                break
+    finally:
+        client.browsers.delete_by_id(browser.session_id)
+
+
+if __name__ == "__main__":
+    main()

{kernel-0.58.0 → kernel-0.60.0}/pyproject.toml

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

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/_streaming.py

@@ -251,7 +251,12 @@ class SSEDecoder:
         # See: https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation  # noqa: E501
 
         if not line:
-            if not self._event and not self._data and not self._last_event_id and self._retry is None:
+            # Whether to dispatch depends only on what was set in the *current* block. last_event_id
+            # is sticky across events (per the SSE spec, it is intentionally not reset below), so it
+            # must not be part of this check -- otherwise, once any event carries an id, every
+            # subsequent comment-only block (e.g. a ``:\n\n`` keepalive) would dispatch an empty
+            # event, which then fails to JSON-decode in the typed Stream wrapper.
+            if not self._event and not self._data and self._retry is None:
                 return None
 
             sse = ServerSentEvent(

{kernel-0.58.0 → kernel-0.60.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.58.0"  # x-release-please-version
+__version__ = "0.60.0"  # x-release-please-version

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/lib/browser_routing/routing.py

@@ -41,7 +41,7 @@ _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",))
+        return BrowserRoutingConfig(subresources=("curl", "telemetry"))
     if raw.strip() == "":
         return BrowserRoutingConfig()
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/resources/api_keys.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
+from typing_extensions import Literal
 
 import httpx
 
@@ -171,6 +172,9 @@ class APIKeysResource(SyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | 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,
@@ -187,6 +191,13 @@ class APIKeysResource(SyncAPIResource):
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against API key name, creator, and project. API
+              key identifiers and masked keys match by exact value or prefix.
+
+          sort_by: Field to sort API keys by.
+
+          sort_direction: Sort direction for API keys.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -207,6 +218,9 @@ class APIKeysResource(SyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
                     },
                     api_key_list_params.APIKeyListParams,
                 ),
@@ -395,6 +409,9 @@ class AsyncAPIKeysResource(AsyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | 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,
@@ -411,6 +428,13 @@ class AsyncAPIKeysResource(AsyncAPIResource):
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against API key name, creator, and project. API
+              key identifiers and masked keys match by exact value or prefix.
+
+          sort_by: Field to sort API keys by.
+
+          sort_direction: Sort direction for API keys.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -431,6 +455,9 @@ class AsyncAPIKeysResource(AsyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
                     },
                     api_key_list_params.APIKeyListParams,
                 ),

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/resources/browser_pools.py

@@ -206,7 +206,6 @@ class BrowserPoolsResource(SyncAPIResource):
         self,
         id_or_name: str,
         *,
-        size: int,
         chrome_policy: Dict[str, object] | Omit = omit,
         discard_all_idle: bool | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
@@ -216,6 +215,7 @@ class BrowserPoolsResource(SyncAPIResource):
         name: str | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
+        size: int | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
         timeout_seconds: int | Omit = omit,
@@ -231,10 +231,6 @@ class BrowserPoolsResource(SyncAPIResource):
         Updates the configuration used to create browsers in the pool.
 
         Args:
-          size: Number of browsers to maintain in the pool. The maximum size is determined by
-              your organization's pooled sessions limit (the sum of all pool sizes cannot
-              exceed your limit).
-
           chrome_policy: Custom Chrome enterprise policy overrides applied to all browsers in this pool.
               Keys are Chrome enterprise policy names; values must match their expected types.
               Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
@@ -261,6 +257,10 @@ class BrowserPoolsResource(SyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
+          size: Number of browsers to maintain in the pool. The maximum size is determined by
+              your organization's pooled sessions limit (the sum of all pool sizes cannot
+              exceed your limit).
+
           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
@@ -300,7 +300,6 @@ class BrowserPoolsResource(SyncAPIResource):
             path_template("/browser_pools/{id_or_name}", id_or_name=id_or_name),
             body=maybe_transform(
                 {
-                    "size": size,
                     "chrome_policy": chrome_policy,
                     "discard_all_idle": discard_all_idle,
                     "extensions": extensions,
@@ -310,6 +309,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "name": name,
                     "profile": profile,
                     "proxy_id": proxy_id,
+                    "size": size,
                     "start_url": start_url,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,
@@ -684,7 +684,6 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         self,
         id_or_name: str,
         *,
-        size: int,
         chrome_policy: Dict[str, object] | Omit = omit,
         discard_all_idle: bool | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
@@ -694,6 +693,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         name: str | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
+        size: int | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
         timeout_seconds: int | Omit = omit,
@@ -709,10 +709,6 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         Updates the configuration used to create browsers in the pool.
 
         Args:
-          size: Number of browsers to maintain in the pool. The maximum size is determined by
-              your organization's pooled sessions limit (the sum of all pool sizes cannot
-              exceed your limit).
-
           chrome_policy: Custom Chrome enterprise policy overrides applied to all browsers in this pool.
               Keys are Chrome enterprise policy names; values must match their expected types.
               Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
@@ -739,6 +735,10 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
               belonging to the caller's org.
 
+          size: Number of browsers to maintain in the pool. The maximum size is determined by
+              your organization's pooled sessions limit (the sum of all pool sizes cannot
+              exceed your limit).
+
           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
@@ -778,7 +778,6 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
             path_template("/browser_pools/{id_or_name}", id_or_name=id_or_name),
             body=await async_maybe_transform(
                 {
-                    "size": size,
                     "chrome_policy": chrome_policy,
                     "discard_all_idle": discard_all_idle,
                     "extensions": extensions,
@@ -788,6 +787,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "name": name,
                     "profile": profile,
                     "proxy_id": proxy_id,
+                    "size": size,
                     "start_url": start_url,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/resources/browsers/browsers.py

@@ -133,6 +133,7 @@ class BrowsersResource(SyncAPIResource):
 
     @cached_property
     def computer(self) -> ComputerResource:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return ComputerResource(self._client)
 
     @cached_property
@@ -680,6 +681,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
     @cached_property
     def computer(self) -> AsyncComputerResource:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return AsyncComputerResource(self._client)
 
     @cached_property
@@ -1250,6 +1252,7 @@ class BrowsersResourceWithRawResponse:
 
     @cached_property
     def computer(self) -> ComputerResourceWithRawResponse:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return ComputerResourceWithRawResponse(self._browsers.computer)
 
     @cached_property
@@ -1311,6 +1314,7 @@ class AsyncBrowsersResourceWithRawResponse:
 
     @cached_property
     def computer(self) -> AsyncComputerResourceWithRawResponse:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return AsyncComputerResourceWithRawResponse(self._browsers.computer)
 
     @cached_property
@@ -1372,6 +1376,7 @@ class BrowsersResourceWithStreamingResponse:
 
     @cached_property
     def computer(self) -> ComputerResourceWithStreamingResponse:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return ComputerResourceWithStreamingResponse(self._browsers.computer)
 
     @cached_property
@@ -1433,6 +1438,7 @@ class AsyncBrowsersResourceWithStreamingResponse:
 
     @cached_property
     def computer(self) -> AsyncComputerResourceWithStreamingResponse:
+        """Control mouse, keyboard, and screen on the browser instance."""
         return AsyncComputerResourceWithStreamingResponse(self._browsers.computer)
 
     @cached_property

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/resources/browsers/computer.py

@@ -46,6 +46,8 @@ __all__ = ["ComputerResource", "AsyncComputerResource"]
 
 
 class ComputerResource(SyncAPIResource):
+    """Control mouse, keyboard, and screen on the browser instance."""
+
     @cached_property
     def with_raw_response(self) -> ComputerResourceWithRawResponse:
         """
@@ -649,6 +651,8 @@ class ComputerResource(SyncAPIResource):
 
 
 class AsyncComputerResource(AsyncAPIResource):
+    """Control mouse, keyboard, and screen on the browser instance."""
+
     @cached_property
     def with_raw_response(self) -> AsyncComputerResourceWithRawResponse:
         """

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/resources/browsers/telemetry.py

@@ -80,7 +80,7 @@ class TelemetryResource(SyncAPIResource):
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
         extra_headers = {**strip_not_given({"Last-Event-ID": last_event_id}), **(extra_headers or {})}
         return self._get(
-            path_template("/browsers/{id}/telemetry", id=id),
+            path_template("/browsers/{id}/telemetry/stream", id=id),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -149,7 +149,7 @@ class AsyncTelemetryResource(AsyncAPIResource):
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
         extra_headers = {**strip_not_given({"Last-Event-ID": last_event_id}), **(extra_headers or {})}
         return await self._get(
-            path_template("/browsers/{id}/telemetry", id=id),
+            path_template("/browsers/{id}/telemetry/stream", id=id),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

kernel-0.60.0/src/kernel/types/api_key_list_params.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["APIKeyListParams"]
+
+
+class APIKeyListParams(TypedDict, total=False):
+    limit: int
+    """Maximum number of results to return"""
+
+    offset: int
+    """Number of results to skip"""
+
+    query: str
+    """Case-insensitive substring match against API key name, creator, and project.
+
+    API key identifiers and masked keys match by exact value or prefix.
+    """
+
+    sort_by: Literal["created_at", "name", "expires_at"]
+    """Field to sort API keys by."""
+
+    sort_direction: Literal["asc", "desc"]
+    """Sort direction for API keys."""

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browser_pool_update_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Dict, Iterable
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
@@ -13,13 +13,6 @@ __all__ = ["BrowserPoolUpdateParams"]
 
 
 class BrowserPoolUpdateParams(TypedDict, total=False):
-    size: Required[int]
-    """Number of browsers to maintain in the pool.
-
-    The maximum size is determined by your organization's pooled sessions limit (the
-    sum of all pool sizes cannot exceed your limit).
-    """
-
     chrome_policy: Dict[str, object]
     """Custom Chrome enterprise policy overrides applied to all browsers in this pool.
 
@@ -68,6 +61,13 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     Must reference a proxy belonging to the caller's org.
     """
 
+    size: int
+    """Number of browsers to maintain in the pool.
+
+    The maximum size is determined by your organization's pooled sessions limit (the
+    sum of all pool sizes cannot exceed your limit).
+    """
+
     start_url: str
     """Optional URL to navigate to when a new browser is warmed into the pool.
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_console_error_event.py

@@ -65,6 +65,8 @@ class BrowserConsoleErrorEvent(BaseModel):
     Emitted from two distinct CDP sources with different data shapes. Runtime.consoleAPICalled (console.error calls) produces level, text, args, and stack_trace. Runtime.exceptionThrown (uncaught exceptions) produces text, line, column, source_url, and stack_trace. Fields not applicable to the source are absent.
     """
 
+    category: Literal["console"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_console_log_event.py

@@ -42,6 +42,8 @@ class Data(BrowserEventContext):
 class BrowserConsoleLogEvent(BaseModel):
     """A browser console log event (console.log, console.info, console.warn, etc.)."""
 
+    category: Literal["console"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_interaction_click_event.py

@@ -35,6 +35,8 @@ class Data(BrowserEventContext):
 class BrowserInteractionClickEvent(BaseModel):
     """A browser user click event captured via injected page script."""
 
+    category: Literal["interaction"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_interaction_key_event.py

@@ -29,6 +29,8 @@ class Data(BrowserEventContext):
 class BrowserInteractionKeyEvent(BaseModel):
     """A browser keyboard event captured via injected page script."""
 
+    category: Literal["interaction"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_interaction_scroll_settled_event.py

@@ -37,6 +37,8 @@ class BrowserInteractionScrollSettledEvent(BaseModel):
     A browser scroll settled event emitted after scroll position stops changing, captured via injected page script.
     """
 
+    category: Literal["interaction"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_monitor_disconnected_event.py

@@ -20,6 +20,8 @@ class BrowserMonitorDisconnectedEvent(BaseModel):
     Telemetry events may be dropped until monitor_reconnected arrives. Treat any in-progress computed state (network_idle, page_layout_settled) as unreliable until then.
     """
 
+    category: Literal["system"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_monitor_init_failed_event.py

@@ -17,6 +17,8 @@ class Data(BaseModel):
 class BrowserMonitorInitFailedEvent(BaseModel):
     """The CDP session could not be initialized."""
 
+    category: Literal["system"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_monitor_reconnect_failed_event.py

@@ -23,6 +23,8 @@ class BrowserMonitorReconnectFailedEvent(BaseModel):
     The CDP connection to Chrome could not be re-established after exhausting all reconnection attempts. No further telemetry events will arrive on this session.
     """
 
+    category: Literal["system"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_monitor_reconnected_event.py

@@ -19,6 +19,8 @@ class BrowserMonitorReconnectedEvent(BaseModel):
     The CDP connection to Chrome was successfully re-established after a disconnection. Events emitted during the gap are lost. Computed state is reset, so navigation and network tracking restart fresh from this point.
     """
 
+    category: Literal["system"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_monitor_screenshot_event.py

@@ -17,6 +17,8 @@ class Data(BaseModel):
 class BrowserMonitorScreenshotEvent(BaseModel):
     """A periodic screenshot of the browser viewport."""
 
+    category: Literal["system"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_network_idle_event.py

@@ -15,6 +15,8 @@ class BrowserNetworkIdleEvent(BaseModel):
     A browser network idle event emitted after a 500ms quiet period with no in-flight HTTP requests.
     """
 
+    category: Literal["network"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_network_loading_failed_event.py

@@ -39,6 +39,8 @@ class BrowserNetworkLoadingFailedEvent(BaseModel):
     If the request was already in flight when CDP attached (no prior network_request was emitted for it), url, frame_id, loader_id, and resource_type are absent; BrowserEventContext is partially populated in that case.
     """
 
+    category: Literal["network"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_network_request_event.py

@@ -55,6 +55,8 @@ class Data(BrowserEventContext):
 class BrowserNetworkRequestEvent(BaseModel):
     """A browser network request sent event."""
 
+    category: Literal["network"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_network_response_event.py

@@ -52,6 +52,8 @@ class BrowserNetworkResponseEvent(BaseModel):
     Fired after the response body is fully received, not when headers arrive.
     """
 
+    category: Literal["network"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_page_dom_content_loaded_event.py

@@ -26,6 +26,8 @@ class Data(BrowserEventContext):
 class BrowserPageDomContentLoadedEvent(BaseModel):
     """A browser DOMContentLoaded event (CDP Page.domContentEventFired)."""
 
+    category: Literal["page"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_page_layout_settled_event.py

@@ -15,6 +15,8 @@ class BrowserPageLayoutSettledEvent(BaseModel):
     A browser layout settled event emitted 1 second after page load with no intervening layout shifts, indicating visual stability. Each layout shift resets the 1-second timer.
     """
 
+    category: Literal["page"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_page_layout_shift_event.py

@@ -50,6 +50,8 @@ class BrowserPageLayoutShiftEvent(BaseModel):
     A browser cumulative layout shift (CLS) event from the Performance Timeline API.
     """
 
+    category: Literal["page"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""
 

{kernel-0.58.0 → kernel-0.60.0}/src/kernel/types/browsers/browser_page_lcp_event.py

@@ -56,6 +56,8 @@ class BrowserPageLcpEvent(BaseModel):
     A browser Largest Contentful Paint (LCP) event from the Performance Timeline API.
     """
 
+    category: Literal["page"]
+
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""