release: 0.59.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.58.0"
+  ".": "0.59.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-3b34d85c005a4058ac1faaea092615af577d12cee6e420f102de57339251672d.yml
-openapi_spec_hash: fad386b8e8712e6639ed9689e9dfc070
-config_hash: 0f222358f24700d1811c5d27078a3849
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-4bada2a5bdbde93018e5a1b1e80e134acbc5509cfdea94db6e4c5b799eba7b82.yml
+openapi_spec_hash: e0d541d480f5663b1e6bd3bb19a0fe61
+config_hash: e0741f8035aea13f71e54e0fdb88eaa4

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.59.0 (2026-05-29)
+
+Full Changelog: [v0.58.0...v0.59.0](https://github.com/kernel/kernel-node-sdk/compare/v0.58.0...v0.59.0)
+
+### Features
+
+* api: surface category field on browser telemetry events ([131f0e9](https://github.com/kernel/kernel-node-sdk/commit/131f0e923dc19f803330fb0397fd42aa8c738cd1))
+* Support Byteful mobile proxies ([c591523](https://github.com/kernel/kernel-node-sdk/commit/c591523059b7032d3081b7c2d996f92ede3eeff7))
+
 ## 0.58.0 (2026-05-27)
 
 Full Changelog: [v0.57.0...v0.58.0](https://github.com/kernel/kernel-node-sdk/compare/v0.57.0...v0.58.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.58.0",
+  "version": "0.59.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "dist/index.d.ts",

src/resources/browsers/telemetry.ts

@@ -108,6 +108,8 @@ export namespace BrowserCallStack {
  * source_url, and stack_trace. Fields not applicable to the source are absent.
  */
 export interface BrowserConsoleErrorEvent {
+  category: 'console';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -188,6 +190,8 @@ export namespace BrowserConsoleErrorEvent {
  * A browser console log event (console.log, console.info, console.warn, etc.).
  */
 export interface BrowserConsoleLogEvent {
+  category: 'console';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -323,6 +327,8 @@ export type BrowserHTTPHeaders = { [key: string]: unknown };
  * A browser user click event captured via injected page script.
  */
 export interface BrowserInteractionClickEvent {
+  category: 'interaction';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -386,6 +392,8 @@ export namespace BrowserInteractionClickEvent {
  * A browser keyboard event captured via injected page script.
  */
 export interface BrowserInteractionKeyEvent {
+  category: 'interaction';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -440,6 +448,8 @@ export namespace BrowserInteractionKeyEvent {
  * captured via injected page script.
  */
 export interface BrowserInteractionScrollSettledEvent {
+  category: 'interaction';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -505,6 +515,8 @@ export namespace BrowserInteractionScrollSettledEvent {
  * page_layout_settled) as unreliable until then.
  */
 export interface BrowserMonitorDisconnectedEvent {
+  category: 'system';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -538,6 +550,8 @@ export namespace BrowserMonitorDisconnectedEvent {
  * The CDP session could not be initialized.
  */
 export interface BrowserMonitorInitFailedEvent {
+  category: 'system';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -572,6 +586,8 @@ export namespace BrowserMonitorInitFailedEvent {
  * reconnection attempts. No further telemetry events will arrive on this session.
  */
 export interface BrowserMonitorReconnectFailedEvent {
+  category: 'system';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -608,6 +624,8 @@ export namespace BrowserMonitorReconnectFailedEvent {
  * so navigation and network tracking restart fresh from this point.
  */
 export interface BrowserMonitorReconnectedEvent {
+  category: 'system';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -641,6 +659,8 @@ export namespace BrowserMonitorReconnectedEvent {
  * A periodic screenshot of the browser viewport.
  */
 export interface BrowserMonitorScreenshotEvent {
+  category: 'system';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -675,6 +695,8 @@ export namespace BrowserMonitorScreenshotEvent {
  * in-flight HTTP requests.
  */
 export interface BrowserNetworkIdleEvent {
+  category: 'network';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -707,6 +729,8 @@ export interface BrowserNetworkIdleEvent {
  * populated in that case.
  */
 export interface BrowserNetworkLoadingFailedEvent {
+  category: 'network';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -767,6 +791,8 @@ export namespace BrowserNetworkLoadingFailedEvent {
  * A browser network request sent event.
  */
 export interface BrowserNetworkRequestEvent {
+  category: 'network';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -854,6 +880,8 @@ export namespace BrowserNetworkRequestEvent {
  * fully received, not when headers arrive.
  */
 export interface BrowserNetworkResponseEvent {
+  category: 'network';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -934,6 +962,8 @@ export namespace BrowserNetworkResponseEvent {
  * A browser DOMContentLoaded event (CDP Page.domContentEventFired).
  */
 export interface BrowserPageDomContentLoadedEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -980,6 +1010,8 @@ export namespace BrowserPageDomContentLoadedEvent {
  * the 1-second timer.
  */
 export interface BrowserPageLayoutSettledEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1009,6 +1041,8 @@ export interface BrowserPageLayoutSettledEvent {
  * A browser cumulative layout shift (CLS) event from the Performance Timeline API.
  */
 export interface BrowserPageLayoutShiftEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1087,6 +1121,8 @@ export namespace BrowserPageLayoutShiftEvent {
  * API.
  */
 export interface BrowserPageLcpEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1178,6 +1214,8 @@ export namespace BrowserPageLcpEvent {
  * A browser page load event (CDP Page.loadEventFired).
  */
 export interface BrowserPageLoadEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1224,6 +1262,8 @@ export namespace BrowserPageLoadEvent {
  * epoch.
  */
 export interface BrowserPageNavigationEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1290,6 +1330,8 @@ export namespace BrowserPageNavigationEvent {
  * Independent of network_idle; a single pending request does not block it.
  */
 export interface BrowserPageNavigationSettledEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */
@@ -1323,6 +1365,8 @@ export interface BrowserPageNavigationSettledEvent {
  * treat it as a special case.
  */
 export interface BrowserPageTabOpenedEvent {
+  category: 'page';
+
   /**
    * Provenance metadata identifying which producer emitted the event.
    */