kernel 0.63.0__tar.gz → 0.64.0__tar.gz

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

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

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

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.64.0}/PKG-INFO

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

@@ -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.64.0}/pyproject.toml

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

{kernel-0.63.0 → kernel-0.64.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.64.0"  # x-release-please-version

{kernel-0.63.0 → kernel-0.64.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.63.0 → kernel-0.64.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.64.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.64.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.64.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.64.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."""

kernel-0.64.0/src/kernel/types/browsers/browser_cdp_disconnect_event.py

@@ -0,0 +1,49 @@
+# 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__ = ["BrowserCdpDisconnectEvent", "Data"]
+
+
+class Data(BaseModel):
+    duration_ms: float
+    """Wall-clock duration of the connection in milliseconds."""
+
+    message_count: int
+    """Number of CDP messages relayed across the connection in either direction."""
+
+    reason: Literal["client_close", "upstream_changed", "upstream_error", "context_cancelled"]
+    """Why the connection ended.
+
+    client_close: the client initiated the close. upstream_changed: Chromium
+    restarted mid-session and the proxy tore down so the client could reconnect
+    against the new upstream. upstream_error: upstream dial or message pump errored.
+    context_cancelled: the request context was cancelled (typically server
+    shutdown).
+    """
+
+
+class BrowserCdpDisconnectEvent(BaseModel):
+    """An external client disconnected from the CDP WebSocket proxy on this VM.
+
+    Pair with the immediately preceding cdp_connect on the same stream.
+    """
+
+    category: Literal["connection"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["cdp_disconnect"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

kernel-0.64.0/src/kernel/types/browsers/browser_live_view_connect_event.py

@@ -0,0 +1,40 @@
+# 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__ = ["BrowserLiveViewConnectEvent", "Data"]
+
+
+class Data(BaseModel):
+    session_id: str
+    """Live view session identifier.
+
+    Stable across reconnects, so a transient network blip can emit two events with
+    the same session_id.
+    """
+
+
+class BrowserLiveViewConnectEvent(BaseModel):
+    """A live view client connected to the headful browser's WebRTC server.
+
+    Headful only; not emitted for headless images.
+    """
+
+    category: Literal["connection"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["live_view_connect"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

kernel-0.64.0/src/kernel/types/browsers/browser_live_view_disconnect_event.py

@@ -0,0 +1,41 @@
+# 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__ = ["BrowserLiveViewDisconnectEvent", "Data"]
+
+
+class Data(BaseModel):
+    duration_ms: float
+    """Wall-clock duration of the connection in milliseconds."""
+
+    session_id: str
+    """
+    Live view session identifier; matches the corresponding live_view_connect event.
+    """
+
+
+class BrowserLiveViewDisconnectEvent(BaseModel):
+    """A live view client disconnected from the headful browser's WebRTC server.
+
+    Pair with live_view_connect by session_id.
+    """
+
+    category: Literal["connection"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["live_view_disconnect"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

{kernel-0.63.0 → kernel-0.64.0}/src/kernel/types/browsers/browser_monitor_disconnected_event.py

@@ -20,7 +20,7 @@ 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"]
+    category: Literal["monitor"]
 
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""

{kernel-0.63.0 → kernel-0.64.0}/src/kernel/types/browsers/browser_monitor_init_failed_event.py

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

{kernel-0.63.0 → kernel-0.64.0}/src/kernel/types/browsers/browser_monitor_reconnect_failed_event.py

@@ -23,7 +23,7 @@ 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"]
+    category: Literal["monitor"]
 
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""

{kernel-0.63.0 → kernel-0.64.0}/src/kernel/types/browsers/browser_monitor_reconnected_event.py

@@ -19,7 +19,7 @@ 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"]
+    category: Literal["monitor"]
 
     source: BrowserEventSource
     """Provenance metadata identifying which producer emitted the event."""

{kernel-0.63.0 → kernel-0.64.0}/src/kernel/types/browsers/browser_monitor_screenshot_event.py

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

kernel-0.64.0/src/kernel/types/browsers/browser_service_crashed_event.py

@@ -0,0 +1,50 @@
+# 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__ = ["BrowserServiceCrashedEvent", "Data"]
+
+
+class Data(BaseModel):
+    phase: Literal["startup", "running", "gave_up"]
+    """Lifecycle phase the crash occurred in.
+
+    startup: the process died before reaching a healthy running state. running: a
+    previously healthy process died unexpectedly. gave_up: the process manager
+    exhausted its restart attempts and stopped trying.
+    """
+
+    service_name: str
+    """Program name of the crashed service (e.g. chromium, mutter, kernel-images-api)."""
+
+    pid: Optional[int] = None
+    """PID of the crashed process.
+
+    Absent when the process manager gave up after exhausting restart attempts.
+    """
+
+
+class BrowserServiceCrashedEvent(BaseModel):
+    """A managed service exited unexpectedly.
+
+    Intentional stops do not produce this event; only unexpected exits and terminal restart-give-up transitions do.
+    """
+
+    category: Literal["system"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["service_crashed"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""

kernel-0.64.0/src/kernel/types/browsers/browser_system_oom_kill_event.py

@@ -0,0 +1,99 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .browser_event_source import BrowserEventSource
+
+__all__ = ["BrowserSystemOomKillEvent", "Data", "DataTopTask"]
+
+
+class DataTopTask(BaseModel):
+    name: str
+    """Comm of the process (max 15 chars, truncated by the kernel)."""
+
+    pid: int
+    """PID of the process."""
+
+    rss_kb: int
+    """Resident set size in KiB at the moment of the kill."""
+
+
+class Data(BaseModel):
+    pid: int
+    """PID of the killed process."""
+
+    process_name: str
+    """
+    Comm of the killed process as reported by the kernel (max 15 chars, truncated by
+    the kernel).
+    """
+
+    rss_kb: int
+    """
+    Resident set size of the killed process in KiB (sum of anon-rss, file-rss, and
+    shmem-rss).
+    """
+
+    constraint: Optional[Literal["none", "memcg", "cpuset", "memory_policy"]] = None
+    """Why the kernel decided to OOM-kill.
+
+    none means global memory exhaustion; memcg means a cgroup memory limit was hit;
+    cpuset / memory_policy are NUMA/policy-driven kills. Absent on kernels older
+    than 5.0.
+    """
+
+    mem_free_kb: Optional[int] = None
+    """Free system memory in KiB at the time of the kill.
+
+    Assumes a 4 KiB page size. Does not include reclaimable caches. Absent if the
+    kernel did not emit a parseable Mem-Info section.
+    """
+
+    mem_total_kb: Optional[int] = None
+    """Total system memory in KiB at the time of the kill.
+
+    Assumes a 4 KiB page size. Absent if the kernel did not emit a parseable
+    Mem-Info section.
+    """
+
+    top_tasks: Optional[List[DataTopTask]] = None
+    """Top processes by resident-set-size at the moment of the kill, sorted descending.
+
+    Empty if the kernel did not emit the Tasks state table. Capped at 5 entries.
+    """
+
+    trigger_pid: Optional[int] = None
+    """PID of the triggering process.
+
+    Absent if the kernel did not emit the standard header line.
+    """
+
+    trigger_process_name: Optional[str] = None
+    """
+    Comm of the process whose allocation request caused the kernel to invoke the
+    OOM-killer. Often the same as process_name but can differ. Max 15 chars.
+    """
+
+
+class BrowserSystemOomKillEvent(BaseModel):
+    """The Linux kernel OOM-killer terminated a process inside the VM.
+
+    Fires for any process killed by the kernel due to memory exhaustion, including Chrome renderer subprocesses that are not supervised.
+    """
+
+    category: Literal["system"]
+
+    source: BrowserEventSource
+    """Provenance metadata identifying which producer emitted the event."""
+
+    ts: int
+    """Event timestamp in Unix microseconds."""
+
+    type: Literal["system_oom_kill"]
+
+    data: Optional[Data] = None
+
+    truncated: Optional[bool] = None
+    """True if the data field was truncated due to size limits."""