kernel 0.63.0__tar.gz → 0.65.0__tar.gz

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

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

{kernel-0.63.0 → kernel-0.65.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.65.0 (2026-06-08)
+
+Full Changelog: [v0.64.0...v0.65.0](https://github.com/kernel/kernel-python-sdk/compare/v0.64.0...v0.65.0)
+
+### Features
+
+* **api:** allow setting a name and tags on a pool-acquired browser session ([2977911](https://github.com/kernel/kernel-python-sdk/commit/2977911151def0f4193c5e8063ab33800d167585))
+* **api:** support id-or-name lookup on browser session get/patch/delete ([7e6d287](https://github.com/kernel/kernel-python-sdk/commit/7e6d28795b4b2b9f9e14cf14711a72053530b576))
+
+## 0.64.0 (2026-06-05)
+
+Full Changelog: [v0.63.0...v0.64.0](https://github.com/kernel/kernel-python-sdk/compare/v0.63.0...v0.64.0)
+
+### Features
+
+* Telemetry: expose opt-in categories + full event taxonomy (public API) ([a1502dd](https://github.com/kernel/kernel-python-sdk/commit/a1502dd2639b97fb14ec57bfef5e37668b379db7))
+
 ## 0.63.0 (2026-06-05)
 
 Full Changelog: [v0.62.0...v0.63.0](https://github.com/kernel/kernel-python-sdk/compare/v0.62.0...v0.63.0)

{kernel-0.63.0 → kernel-0.65.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.63.0
+Version: 0.65.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.63.0 → kernel-0.65.0}/api.md

@@ -95,11 +95,11 @@ from kernel.types import (
 Methods:
 
 - <code title="post /browsers">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">create</a>(\*\*<a href="src/kernel/types/browser_create_params.py">params</a>) -> <a href="./src/kernel/types/browser_create_response.py">BrowserCreateResponse</a></code>
-- <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/{id_or_name}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">retrieve</a>(id_or_name, \*\*<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_or_name}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">update</a>(id_or_name, \*\*<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="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="delete /browsers/{id_or_name}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete_by_id</a>(id_or_name) -> 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
@@ -108,7 +108,11 @@ Types:
 
 ```python
 from kernel.types.browsers import (
+    BrowserAPICallEvent,
     BrowserCallStack,
+    BrowserCaptchaSolveResultEvent,
+    BrowserCdpConnectEvent,
+    BrowserCdpDisconnectEvent,
     BrowserConsoleErrorEvent,
     BrowserConsoleLogEvent,
     BrowserEventContext,
@@ -117,6 +121,8 @@ from kernel.types.browsers import (
     BrowserInteractionClickEvent,
     BrowserInteractionKeyEvent,
     BrowserInteractionScrollSettledEvent,
+    BrowserLiveViewConnectEvent,
+    BrowserLiveViewDisconnectEvent,
     BrowserMonitorDisconnectedEvent,
     BrowserMonitorInitFailedEvent,
     BrowserMonitorReconnectFailedEvent,
@@ -134,6 +140,8 @@ from kernel.types.browsers import (
     BrowserPageNavigationEvent,
     BrowserPageNavigationSettledEvent,
     BrowserPageTabOpenedEvent,
+    BrowserServiceCrashedEvent,
+    BrowserSystemOomKillEvent,
     BrowserTelemetryCategoriesConfig,
     BrowserTelemetryCategoryConfig,
     BrowserTelemetryConfig,

{kernel-0.63.0 → kernel-0.65.0}/pyproject.toml

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

{kernel-0.63.0 → kernel-0.65.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.63.0"  # x-release-please-version
+__version__ = "0.65.0"  # x-release-please-version

{kernel-0.63.0 → kernel-0.65.0}/src/kernel/resources/browser_pools.py

@@ -26,6 +26,7 @@ from .._response import (
 )
 from ..pagination import SyncOffsetPagination, AsyncOffsetPagination
 from .._base_client import AsyncPaginator, make_request_options
+from ..types.tags_param import TagsParam
 from ..types.browser_pool import BrowserPool
 from ..types.browser_pool_acquire_response import BrowserPoolAcquireResponse
 from ..types.shared_params.browser_profile import BrowserProfile
@@ -417,6 +418,8 @@ class BrowserPoolsResource(SyncAPIResource):
         id_or_name: str,
         *,
         acquire_timeout_seconds: int | Omit = omit,
+        name: 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.
         extra_headers: Headers | None = None,
@@ -436,6 +439,15 @@ class BrowserPoolsResource(SyncAPIResource):
               calculated time it would take to fill the pool at the currently configured fill
               rate.
 
+          name: Optional human-readable name for the acquired browser session, used to find it
+              later in the dashboard. Must be unique among active sessions within the pool's
+              project. Applies to this lease only and is cleared when the browser is released
+              back to the pool.
+
+          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.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -449,7 +461,11 @@ class BrowserPoolsResource(SyncAPIResource):
         return self._post(
             path_template("/browser_pools/{id_or_name}/acquire", id_or_name=id_or_name),
             body=maybe_transform(
-                {"acquire_timeout_seconds": acquire_timeout_seconds},
+                {
+                    "acquire_timeout_seconds": acquire_timeout_seconds,
+                    "name": name,
+                    "tags": tags,
+                },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
             ),
             options=make_request_options(
@@ -923,6 +939,8 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         id_or_name: str,
         *,
         acquire_timeout_seconds: int | Omit = omit,
+        name: 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.
         extra_headers: Headers | None = None,
@@ -942,6 +960,15 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               calculated time it would take to fill the pool at the currently configured fill
               rate.
 
+          name: Optional human-readable name for the acquired browser session, used to find it
+              later in the dashboard. Must be unique among active sessions within the pool's
+              project. Applies to this lease only and is cleared when the browser is released
+              back to the pool.
+
+          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.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -955,7 +982,11 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         return await self._post(
             path_template("/browser_pools/{id_or_name}/acquire", id_or_name=id_or_name),
             body=await async_maybe_transform(
-                {"acquire_timeout_seconds": acquire_timeout_seconds},
+                {
+                    "acquire_timeout_seconds": acquire_timeout_seconds,
+                    "name": name,
+                    "tags": tags,
+                },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
             ),
             options=make_request_options(

{kernel-0.63.0 → kernel-0.65.0}/src/kernel/resources/browsers/browsers.py

@@ -292,7 +292,7 @@ class BrowsersResource(SyncAPIResource):
 
     def retrieve(
         self,
-        id: str,
+        id_or_name: str,
         *,
         include_deleted: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -316,10 +316,10 @@ class BrowsersResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._get(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -334,7 +334,7 @@ class BrowsersResource(SyncAPIResource):
 
     def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -377,10 +377,10 @@ class BrowsersResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._patch(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             body=maybe_transform(
                 {
                     "disable_default_proxy": disable_default_proxy,
@@ -590,7 +590,7 @@ class BrowsersResource(SyncAPIResource):
 
     def delete_by_id(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # 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.
@@ -600,7 +600,7 @@ class BrowsersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Delete a browser session by ID
+        Delete a browser session by ID or name
 
         Args:
           extra_headers: Send extra headers
@@ -611,11 +611,11 @@ class BrowsersResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -857,7 +857,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
     async def retrieve(
         self,
-        id: str,
+        id_or_name: str,
         *,
         include_deleted: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -881,10 +881,10 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._get(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -899,7 +899,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
     async def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -942,10 +942,10 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._patch(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             body=await async_maybe_transform(
                 {
                     "disable_default_proxy": disable_default_proxy,
@@ -1155,7 +1155,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
     async def delete_by_id(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # 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.
@@ -1165,7 +1165,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Delete a browser session by ID
+        Delete a browser session by ID or name
 
         Args:
           extra_headers: Send extra headers
@@ -1176,11 +1176,11 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
-            path_template("/browsers/{id}", id=id),
+            path_template("/browsers/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

{kernel-0.63.0 → kernel-0.65.0}/src/kernel/types/browser_create_params.py

@@ -131,17 +131,18 @@ class Telemetry(TypedDict, total=False):
     """
 
     browser: BrowserTelemetryCategoriesConfigParam
-    """Per-category enable/disable flags.
+    """Per-category capture flags.
 
-    If enabled is true and browser is omitted or empty, the VM default category set
-    is used. Explicitly disabling all four categories stops capture on update and
-    starts no capture on create.
+    Selection is opt-in: only the categories set to enabled=true are captured;
+    anything omitted is off. If enabled is true and browser is omitted or empty, the
+    default category set is used. A browser config that enables nothing stops
+    capture on update and starts no capture on create.
     """
 
     enabled: bool
     """Request shortcut for browser telemetry capture.
 
-    True enables capture using VM defaults unless browser category settings are
-    provided. False stops capture on update and starts no capture on create.
-    enabled=false cannot be combined with browser category settings.
+    True enables capture using the default category set unless browser category
+    settings are provided. False stops capture on update and starts no capture on
+    create. enabled=false cannot be combined with browser category settings.
     """

kernel-0.65.0/src/kernel/types/browser_pool_acquire_params.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .tags_param import TagsParam
+
+__all__ = ["BrowserPoolAcquireParams"]
+
+
+class BrowserPoolAcquireParams(TypedDict, total=False):
+    acquire_timeout_seconds: int
+    """Maximum number of seconds to wait for a browser to be available.
+
+    Defaults to the calculated time it would take to fill the pool at the currently
+    configured fill rate.
+    """
+
+    name: str
+    """
+    Optional human-readable name for the acquired browser session, used to find it
+    later in the dashboard. Must be unique among active sessions within the pool's
+    project. Applies to this lease only and is cleared when the browser is released
+    back to the pool.
+    """
+
+    tags: TagsParam
+    """
+    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.
+    """

{kernel-0.63.0 → kernel-0.65.0}/src/kernel/types/browser_update_params.py

@@ -52,19 +52,20 @@ class Telemetry(TypedDict, total=False):
     """
 
     browser: BrowserTelemetryCategoriesConfigParam
-    """Per-category enable/disable flags.
+    """Per-category capture flags.
 
-    If enabled is true and browser is omitted or empty, the VM default category set
-    is used. Explicitly disabling all four categories stops capture on update and
-    starts no capture on create.
+    Selection is opt-in: only the categories set to enabled=true are captured;
+    anything omitted is off. If enabled is true and browser is omitted or empty, the
+    default category set is used. A browser config that enables nothing stops
+    capture on update and starts no capture on create.
     """
 
     enabled: bool
     """Request shortcut for browser telemetry capture.
 
-    True enables capture using VM defaults unless browser category settings are
-    provided. False stops capture on update and starts no capture on create.
-    enabled=false cannot be combined with browser category settings.
+    True enables capture using the default category set unless browser category
+    settings are provided. False stops capture on update and starts no capture on
+    create. enabled=false cannot be combined with browser category settings.
     """
 
 

{kernel-0.63.0 → kernel-0.65.0}/src/kernel/types/browsers/__init__.py

@@ -28,6 +28,7 @@ from .process_exec_response import ProcessExecResponse as ProcessExecResponse
 from .process_kill_response import ProcessKillResponse as ProcessKillResponse
 from .process_resize_params import ProcessResizeParams as ProcessResizeParams
 from .replay_start_response import ReplayStartResponse as ReplayStartResponse
+from .browser_api_call_event import BrowserAPICallEvent as BrowserAPICallEvent
 from .browser_page_lcp_event import BrowserPageLcpEvent as BrowserPageLcpEvent
 from .computer_scroll_params import ComputerScrollParams as ComputerScrollParams
 from .process_spawn_response import ProcessSpawnResponse as ProcessSpawnResponse
@@ -37,6 +38,7 @@ from .browser_telemetry_event import BrowserTelemetryEvent as BrowserTelemetryEv
 from .process_resize_response import ProcessResizeResponse as ProcessResizeResponse
 from .process_status_response import ProcessStatusResponse as ProcessStatusResponse
 from .browser_telemetry_config import BrowserTelemetryConfig as BrowserTelemetryConfig
+from .browser_cdp_connect_event import BrowserCdpConnectEvent as BrowserCdpConnectEvent
 from .browser_console_log_event import BrowserConsoleLogEvent as BrowserConsoleLogEvent
 from .computer_press_key_params import ComputerPressKeyParams as ComputerPressKeyParams
 from .computer_type_text_params import ComputerTypeTextParams as ComputerTypeTextParams
@@ -51,14 +53,18 @@ from .computer_move_mouse_params import ComputerMoveMouseParams as ComputerMoveM
 from .browser_console_error_event import BrowserConsoleErrorEvent as BrowserConsoleErrorEvent
 from .computer_click_mouse_params import ComputerClickMouseParams as ComputerClickMouseParams
 from .playwright_execute_response import PlaywrightExecuteResponse as PlaywrightExecuteResponse
+from .browser_cdp_disconnect_event import BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent
 from .browser_interaction_key_event import BrowserInteractionKeyEvent as BrowserInteractionKeyEvent
 from .browser_network_request_event import BrowserNetworkRequestEvent as BrowserNetworkRequestEvent
 from .browser_page_navigation_event import BrowserPageNavigationEvent as BrowserPageNavigationEvent
 from .browser_page_tab_opened_event import BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent
+from .browser_service_crashed_event import BrowserServiceCrashedEvent as BrowserServiceCrashedEvent
+from .browser_system_oom_kill_event import BrowserSystemOomKillEvent as BrowserSystemOomKillEvent
 from .f_set_file_permissions_params import FSetFilePermissionsParams as FSetFilePermissionsParams
 from .browser_network_response_event import BrowserNetworkResponseEvent as BrowserNetworkResponseEvent
 from .process_stdout_stream_response import ProcessStdoutStreamResponse as ProcessStdoutStreamResponse
 from .browser_interaction_click_event import BrowserInteractionClickEvent as BrowserInteractionClickEvent
+from .browser_live_view_connect_event import BrowserLiveViewConnectEvent as BrowserLiveViewConnectEvent
 from .browser_page_layout_shift_event import BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent
 from .computer_write_clipboard_params import ComputerWriteClipboardParams as ComputerWriteClipboardParams
 from .browser_monitor_screenshot_event import BrowserMonitorScreenshotEvent as BrowserMonitorScreenshotEvent
@@ -67,6 +73,8 @@ from .browser_monitor_init_failed_event import BrowserMonitorInitFailedEvent as
 from .browser_monitor_reconnected_event import BrowserMonitorReconnectedEvent as BrowserMonitorReconnectedEvent
 from .browser_page_layout_settled_event import BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent
 from .browser_telemetry_category_config import BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig
+from .browser_captcha_solve_result_event import BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent
+from .browser_live_view_disconnect_event import BrowserLiveViewDisconnectEvent as BrowserLiveViewDisconnectEvent
 from .browser_monitor_disconnected_event import BrowserMonitorDisconnectedEvent as BrowserMonitorDisconnectedEvent
 from .computer_capture_screenshot_params import ComputerCaptureScreenshotParams as ComputerCaptureScreenshotParams
 from .browser_telemetry_categories_config import BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig

kernel-0.65.0/src/kernel/types/browsers/browser_api_call_event.py

@@ -0,0 +1,42 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .browser_event_source import BrowserEventSource
+
+__all__ = ["BrowserAPICallEvent", "Data"]
+
+
+class Data(BaseModel):
+    duration_ms: float
+    """Wall-clock duration of the handler in milliseconds."""
+
+    operation_id: str
+    """OpenAPI operationId of the matched route (e.g. processExec, takeScreenshot)."""
+
+    request_id: str
+    """Per-request identifier from the in-VM API request middleware."""
+
+    status: int
+    """HTTP response status code."""
+
+
+class BrowserAPICallEvent(BaseModel):
+    """An agent-driven HTTP call handled by the in-VM API server."""
+
+    category: Literal["control"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["api_call"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

kernel-0.65.0/src/kernel/types/browsers/browser_captcha_solve_result_event.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .browser_event_source import BrowserEventSource
+
+__all__ = ["BrowserCaptchaSolveResultEvent", "Data"]
+
+
+class Data(BaseModel):
+    captcha_type: Literal["hcaptcha", "recaptcha_v2", "recaptcha_v3", "turnstile", "geetest", "other"]
+    """Captcha vendor family.
+
+    Provider-specific task names are normalized into this set; anything not covered
+    is reported as other.
+    """
+
+    duration_ms: float
+    """Wall-clock duration from solve start to terminal outcome."""
+
+    status: Literal["success", "failure", "timeout", "abandoned"]
+    """Terminal outcome.
+
+    success: solver returned a usable solution. failure: solver returned an error
+    (see error_code). timeout: solver did not return within the caller's wait
+    budget. abandoned: caller cancelled or the page navigated away mid-solve.
+    """
+
+    error_code: Optional[str] = None
+    """Solver-specific error code on failure (e.g.
+
+    ERROR_CAPTCHA_UNSOLVABLE). Absent on success.
+    """
+
+    task_id: Optional[str] = None
+    """Solver-assigned identifier. Opaque, useful for support cross-references."""
+
+    website_host: Optional[str] = None
+    """Host of the page where the captcha was solved."""
+
+    website_path: Optional[str] = None
+    """Path of the page where the captcha was solved. Query string excluded."""
+
+
+class BrowserCaptchaSolveResultEvent(BaseModel):
+    """A captcha solve attempt reached a terminal outcome."""
+
+    category: Literal["captcha"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["captcha_solve_result"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

kernel-0.65.0/src/kernel/types/browsers/browser_cdp_connect_event.py

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .browser_event_source import BrowserEventSource
+
+__all__ = ["BrowserCdpConnectEvent"]
+
+
+class BrowserCdpConnectEvent(BaseModel):
+    """An external client (e.g.
+
+    customer SDK, Playwright, Puppeteer) connected to the CDP WebSocket proxy on this VM.
+    """
+
+    category: Literal["connection"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["cdp_connect"]
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""