@onkernel/sdk 0.68.0 → 0.70.0

package/src/resources/browsers/telemetry.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as TelemetryAPI from './telemetry';
 import { APIPromise } from '../../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -12,6 +13,34 @@ import { path } from '../../internal/utils/path';
  * Stream live telemetry events from a browser session.
  */
 export class Telemetry extends APIResource {
+  /**
+   * Reads a page of telemetry events for the browser session in ascending sequence
+   * order. To page through results, pass the X-Next-Offset value from the previous
+   * response as offset and repeat while X-Has-More is true. Returns an empty list
+   * when telemetry data is unavailable.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const telemetryEventsResponse of client.browsers.telemetry.events(
+   *   'id',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  events(
+    id: string,
+    query: TelemetryEventsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<TelemetryEventsResponsesOffsetPagination, TelemetryEventsResponse> {
+    return this._client.getAPIList(
+      path`/browsers/${id}/telemetry/events`,
+      OffsetPagination<TelemetryEventsResponse>,
+      { query, ...options },
+    );
+  }
+
   /**
    * Streams browser telemetry events as a server-sent events (SSE) stream. The
    * stream closes when the browser session terminates. Each event frame includes an
@@ -20,7 +49,8 @@ export class Telemetry extends APIResource {
    * set; all frames carry JSON in the data: field. A keepalive comment frame is sent
    * every 15 seconds when no events arrive. Returns 404 if the browser session does
    * not exist. If telemetry was not enabled on the session, the stream opens but no
-   * events are delivered.
+   * events are delivered. Fresh connections only see new events; pass replay=all to
+   * start from the oldest retained event instead.
    *
    * @example
    * ```ts
@@ -34,8 +64,9 @@ export class Telemetry extends APIResource {
     params: TelemetryStreamParams | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Stream<TelemetryStreamResponse>> {
-    const { 'Last-Event-ID': lastEventID } = params ?? {};
+    const { 'Last-Event-ID': lastEventID, ...query } = params ?? {};
     return this._client.get(path`/browsers/${id}/telemetry/stream`, {
+      query,
       ...options,
       headers: buildHeaders([
         {
@@ -49,6 +80,8 @@ export class Telemetry extends APIResource {
   }
 }
 
+export type TelemetryEventsResponsesOffsetPagination = OffsetPagination<TelemetryEventsResponse>;
+
 /**
  * An agent-driven HTTP call handled by the in-VM API server.
  */
@@ -1973,6 +2006,32 @@ export type BrowserTelemetryEvent =
   | BrowserSystemOomKillEvent
   | BrowserServiceCrashedEvent;
 
+/**
+ * Envelope wrapping a browser telemetry event with its monotonic sequence number.
+ * Each SSE data: frame carries one envelope as JSON. The seq value is also emitted
+ * as the SSE id: field so clients can pass it as Last-Event-ID on reconnect.
+ */
+export interface TelemetryEventsResponse {
+  /**
+   * Union type representing any browser telemetry event. Discriminated on `type`.
+   * Each event's `category` determines when it is captured. The CDP collector-health
+   * events (monitor_disconnected, monitor_reconnected, monitor_reconnect_failed,
+   * monitor_init_failed) use the `monitor` category, which is not user-configurable:
+   * it flows automatically whenever any CDP category (console, network, page,
+   * interaction) is captured, and is silent otherwise. monitor_screenshot uses the
+   * opt-in `screenshot` category. All other event types are controlled by their
+   * per-category enable/disable flags.
+   */
+  event: BrowserTelemetryEvent;
+
+  /**
+   * Process-monotonic sequence number assigned by the browser VM. Pass as
+   * Last-Event-ID on reconnect to resume without gaps. Gaps in received seq values
+   * indicate dropped events.
+   */
+  seq: number;
+}
+
 /**
  * Envelope wrapping a browser telemetry event with its monotonic sequence number.
  * Each SSE data: frame carries one envelope as JSON. The seq value is also emitted
@@ -1999,10 +2058,49 @@ export interface TelemetryStreamResponse {
   seq: number;
 }
 
+export interface TelemetryEventsParams extends OffsetPaginationParams {
+  /**
+   * Restrict results to these event categories. Repeat the parameter for multiple
+   * values.
+   */
+  category?: Array<
+    | 'console'
+    | 'network'
+    | 'page'
+    | 'interaction'
+    | 'control'
+    | 'connection'
+    | 'system'
+    | 'screenshot'
+    | 'captcha'
+    | 'monitor'
+  >;
+
+  /**
+   * Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
+   * long ago. Defaults to 5m. Ignored when offset is set.
+   */
+  since?: string;
+
+  /**
+   * End of the window (exclusive): an RFC-3339 timestamp, or a duration like 5m
+   * meaning that long ago.
+   */
+  until?: string;
+}
+
 export interface TelemetryStreamParams {
   /**
-   * Last event sequence number for SSE reconnection (sent by SSE clients on
-   * reconnect)
+   * Query param: Pass `all` to start from the oldest retained event instead of only
+   * new events; any other value is treated as from-now. The buffer is bounded, so
+   * the first event id may be greater than 1 if older events were evicted.
+   */
+  replay?: string;
+
+  /**
+   * Header param: Last event sequence number for SSE reconnection (sent by SSE
+   * clients on reconnect). Takes precedence over replay when both are present, so
+   * reconnect resumes instead of re-replaying.
    */
   'Last-Event-ID'?: string;
 }
@@ -2047,7 +2145,10 @@ export declare namespace Telemetry {
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
+    type TelemetryEventsResponse as TelemetryEventsResponse,
     type TelemetryStreamResponse as TelemetryStreamResponse,
+    type TelemetryEventsResponsesOffsetPagination as TelemetryEventsResponsesOffsetPagination,
+    type TelemetryEventsParams as TelemetryEventsParams,
     type TelemetryStreamParams as TelemetryStreamParams,
   };
 }

package/src/resources/credential-providers.ts

@@ -344,7 +344,12 @@ export interface CredentialProviderUpdateParams {
   priority?: number;
 }
 
-export interface CredentialProviderListParams extends OffsetPaginationParams {}
+export interface CredentialProviderListParams extends OffsetPaginationParams {
+  /**
+   * Search credential providers by name or ID.
+   */
+  query?: string;
+}
 
 export declare namespace CredentialProviders {
   export {

package/src/resources/credentials.ts

@@ -305,6 +305,11 @@ export interface CredentialListParams extends OffsetPaginationParams {
    * Filter by domain
    */
   domain?: string;
+
+  /**
+   * Search credentials by name, domain, or ID.
+   */
+  query?: string;
 }
 
 export declare namespace Credentials {

package/src/resources/deployments.ts

@@ -469,6 +469,11 @@ export interface DeploymentListParams extends OffsetPaginationParams {
    * Filter results by application version. Requires app_name to be set.
    */
   app_version?: string;
+
+  /**
+   * Search deployments by ID or app name.
+   */
+  query?: string;
 }
 
 export interface DeploymentFollowParams {

package/src/resources/extensions.ts

@@ -97,6 +97,19 @@ export class Extensions extends APIResource {
     });
   }
 
+  /**
+   * Get an extension's metadata (name, size, timestamps) by ID or name, without
+   * downloading the archive.
+   *
+   * @example
+   * ```ts
+   * const extension = await client.extensions.get('id_or_name');
+   * ```
+   */
+  get(idOrName: string, options?: RequestOptions): APIPromise<ExtensionGetResponse> {
+    return this._client.get(path`/extensions/${idOrName}/metadata`, options);
+  }
+
   /**
    * Upload a zip file containing an unpacked browser extension. Optionally provide a
    * unique name for later reference.
@@ -146,6 +159,37 @@ export interface ExtensionListResponse {
   name?: string | null;
 }
 
+/**
+ * A browser extension uploaded to Kernel.
+ */
+export interface ExtensionGetResponse {
+  /**
+   * Unique identifier for the extension
+   */
+  id: string;
+
+  /**
+   * Timestamp when the extension was created
+   */
+  created_at: string;
+
+  /**
+   * Size of the extension archive in bytes
+   */
+  size_bytes: number;
+
+  /**
+   * Timestamp when the extension was last used
+   */
+  last_used_at?: string | null;
+
+  /**
+   * Optional, easier-to-reference name for the extension. Must be unique within the
+   * project.
+   */
+  name?: string | null;
+}
+
 /**
  * A browser extension uploaded to Kernel.
  */
@@ -177,7 +221,12 @@ export interface ExtensionUploadResponse {
   name?: string | null;
 }
 
-export interface ExtensionListParams extends OffsetPaginationParams {}
+export interface ExtensionListParams extends OffsetPaginationParams {
+  /**
+   * Search extensions by name or ID.
+   */
+  query?: string;
+}
 
 export interface ExtensionDownloadFromChromeStoreParams {
   /**
@@ -206,6 +255,7 @@ export interface ExtensionUploadParams {
 export declare namespace Extensions {
   export {
     type ExtensionListResponse as ExtensionListResponse,
+    type ExtensionGetResponse as ExtensionGetResponse,
     type ExtensionUploadResponse as ExtensionUploadResponse,
     type ExtensionListResponsesOffsetPagination as ExtensionListResponsesOffsetPagination,
     type ExtensionListParams as ExtensionListParams,

package/src/resources/index.ts

@@ -90,6 +90,7 @@ export {
 export {
   Extensions,
   type ExtensionListResponse,
+  type ExtensionGetResponse,
   type ExtensionUploadResponse,
   type ExtensionListParams,
   type ExtensionDownloadFromChromeStoreParams,

package/src/resources/invocations.ts

@@ -613,6 +613,11 @@ export interface InvocationListParams extends OffsetPaginationParams {
    */
   deployment_id?: string;
 
+  /**
+   * Search invocations by ID, app name, or action name.
+   */
+  query?: string;
+
   /**
    * Show invocations that have started since the given time (RFC timestamps or
    * durations like 5m).

package/src/resources/projects/projects.ts

@@ -30,7 +30,7 @@ export class Projects extends APIResource {
   }
 
   /**
-   * Get a project by ID.
+   * Get a project by its ID or by its name. Names are unique within an organization.
    *
    * @example
    * ```ts

package/src/resources/proxies.ts

@@ -824,7 +824,12 @@ export namespace ProxyCreateParams {
   }
 }
 
-export interface ProxyListParams extends OffsetPaginationParams {}
+export interface ProxyListParams extends OffsetPaginationParams {
+  /**
+   * Search proxies by name, host, IP address, or ID.
+   */
+  query?: string;
+}
 
 export interface ProxyCheckParams {
   /**

package/src/resources/shared.ts

@@ -79,18 +79,18 @@ export interface BrowserProfile {
  */
 export interface BrowserViewport {
   /**
-   * Browser window height in pixels.
+   * Browser window height in pixels. Any positive integer is accepted.
    */
   height: number;
 
   /**
-   * Browser window width in pixels.
+   * Browser window width in pixels. Any positive integer is accepted.
    */
   width: number;
 
   /**
-   * Display refresh rate in Hz. If omitted, automatically determined from width and
-   * height.
+   * Display refresh rate in Hz. Any positive integer is accepted; if omitted,
+   * automatically determined from width and height.
    */
   refresh_rate?: number;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.68.0'; // x-release-please-version
+export const VERSION = '0.70.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.68.0";
+export declare const VERSION = "0.70.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.68.0";
+export declare const VERSION = "0.70.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.68.0'; // x-release-please-version
+exports.VERSION = '0.70.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.68.0'; // x-release-please-version
+export const VERSION = '0.70.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map