@onkernel/sdk 0.61.0 → 0.63.0

package/src/resources/extensions.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -17,11 +18,20 @@ export class Extensions extends APIResource {
    *
    * @example
    * ```ts
-   * const extensions = await client.extensions.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const extensionListResponse of client.extensions.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(options?: RequestOptions): APIPromise<ExtensionListResponse> {
-    return this._client.get('/extensions', options);
+  list(
+    query: ExtensionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ExtensionListResponsesOffsetPagination, ExtensionListResponse> {
+    return this._client.getAPIList('/extensions', OffsetPagination<ExtensionListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -103,39 +113,37 @@ export class Extensions extends APIResource {
   }
 }
 
-export type ExtensionListResponse = Array<ExtensionListResponse.ExtensionListResponseItem>;
+export type ExtensionListResponsesOffsetPagination = OffsetPagination<ExtensionListResponse>;
 
-export namespace ExtensionListResponse {
+/**
+ * A browser extension uploaded to Kernel.
+ */
+export interface ExtensionListResponse {
   /**
-   * A browser extension uploaded to Kernel.
+   * Unique identifier for the extension
    */
-  export interface ExtensionListResponseItem {
-    /**
-     * Unique identifier for the extension
-     */
-    id: string;
+  id: string;
 
-    /**
-     * Timestamp when the extension was created
-     */
-    created_at: string;
+  /**
+   * Timestamp when the extension was created
+   */
+  created_at: string;
 
-    /**
-     * Size of the extension archive in bytes
-     */
-    size_bytes: number;
+  /**
+   * Size of the extension archive in bytes
+   */
+  size_bytes: number;
 
-    /**
-     * Timestamp when the extension was last used
-     */
-    last_used_at?: string | null;
+  /**
+   * 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;
-  }
+  /**
+   * Optional, easier-to-reference name for the extension. Must be unique within the
+   * project.
+   */
+  name?: string | null;
 }
 
 /**
@@ -169,6 +177,8 @@ export interface ExtensionUploadResponse {
   name?: string | null;
 }
 
+export interface ExtensionListParams extends OffsetPaginationParams {}
+
 export interface ExtensionDownloadFromChromeStoreParams {
   /**
    * Chrome Web Store URL for the extension.
@@ -197,6 +207,8 @@ export declare namespace Extensions {
   export {
     type ExtensionListResponse as ExtensionListResponse,
     type ExtensionUploadResponse as ExtensionUploadResponse,
+    type ExtensionListResponsesOffsetPagination as ExtensionListResponsesOffsetPagination,
+    type ExtensionListParams as ExtensionListParams,
     type ExtensionDownloadFromChromeStoreParams as ExtensionDownloadFromChromeStoreParams,
     type ExtensionUploadParams as ExtensionUploadParams,
   };

package/src/resources/index.ts

@@ -20,19 +20,21 @@ export { Auth } from './auth/auth';
 export {
   BrowserPools,
   type BrowserPool,
-  type BrowserPoolListResponse,
   type BrowserPoolAcquireResponse,
   type BrowserPoolCreateParams,
   type BrowserPoolUpdateParams,
+  type BrowserPoolListParams,
   type BrowserPoolDeleteParams,
   type BrowserPoolAcquireParams,
   type BrowserPoolReleaseParams,
+  type BrowserPoolsOffsetPagination,
 } from './browser-pools';
 export {
   Browsers,
   type BrowserPoolRef,
   type BrowserUsage,
   type Profile,
+  type Tags,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
   type BrowserUpdateResponse,
@@ -54,10 +56,11 @@ export {
   type CredentialProviderItem,
   type CredentialProviderTestResult,
   type UpdateCredentialProviderRequest,
-  type CredentialProviderListResponse,
   type CredentialProviderListItemsResponse,
   type CredentialProviderCreateParams,
   type CredentialProviderUpdateParams,
+  type CredentialProviderListParams,
+  type CredentialProvidersOffsetPagination,
 } from './credential-providers';
 export {
   Credentials,
@@ -86,8 +89,10 @@ export {
   Extensions,
   type ExtensionListResponse,
   type ExtensionUploadResponse,
+  type ExtensionListParams,
   type ExtensionDownloadFromChromeStoreParams,
   type ExtensionUploadParams,
+  type ExtensionListResponsesOffsetPagination,
 } from './extensions';
 export {
   Invocations,
@@ -122,5 +127,7 @@ export {
   type ProxyListResponse,
   type ProxyCheckResponse,
   type ProxyCreateParams,
+  type ProxyListParams,
   type ProxyCheckParams,
+  type ProxyListResponsesOffsetPagination,
 } from './proxies';

package/src/resources/invocations.ts

@@ -488,6 +488,11 @@ export namespace InvocationListBrowsersResponse {
      */
     kiosk_mode?: boolean;
 
+    /**
+     * Human-readable name of the browser session, if one was set at creation.
+     */
+    name?: string;
+
     /**
      * Browser pool this session was acquired from, if any.
      */
@@ -512,6 +517,12 @@ export namespace InvocationListBrowsersResponse {
      */
     start_url?: string;
 
+    /**
+     * User-defined key-value tags that were set on this browser session, if any.
+     * Echoed back when present.
+     */
+    tags?: BrowsersAPI.Tags;
+
     /**
      * Active telemetry configuration for the session, if any.
      */

package/src/resources/proxies.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -27,8 +28,11 @@ export class Proxies extends APIResource {
   /**
    * List proxies owned by the caller's organization.
    */
-  list(options?: RequestOptions): APIPromise<ProxyListResponse> {
-    return this._client.get('/proxies', options);
+  list(
+    query: ProxyListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ProxyListResponsesOffsetPagination, ProxyListResponse> {
+    return this._client.getAPIList('/proxies', OffsetPagination<ProxyListResponse>, { query, ...options });
   }
 
   /**
@@ -58,6 +62,8 @@ export class Proxies extends APIResource {
   }
 }
 
+export type ProxyListResponsesOffsetPagination = OffsetPagination<ProxyListResponse>;
+
 /**
  * Configuration for routing traffic through a proxy.
  */
@@ -370,163 +376,159 @@ export namespace ProxyRetrieveResponse {
   }
 }
 
-export type ProxyListResponse = Array<ProxyListResponse.ProxyListResponseItem>;
+/**
+ * Configuration for routing traffic through a proxy.
+ */
+export interface ProxyListResponse {
+  /**
+   * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
+   * worst: `mobile` > `residential` > `isp` > `datacenter`.
+   */
+  type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
+
+  id?: string;
+
+  /**
+   * Hostnames that should bypass the parent proxy and connect directly.
+   */
+  bypass_hosts?: Array<string>;
+
+  /**
+   * Configuration specific to the selected proxy `type`.
+   */
+  config?:
+    | ProxyListResponse.DatacenterProxyConfig
+    | ProxyListResponse.IspProxyConfig
+    | ProxyListResponse.ResidentialProxyConfig
+    | ProxyListResponse.MobileProxyConfig
+    | ProxyListResponse.CustomProxyConfig;
+
+  /**
+   * IP address that the proxy uses when making requests.
+   */
+  ip_address?: string;
+
+  /**
+   * Timestamp of the last health check performed on this proxy.
+   */
+  last_checked?: string;
+
+  /**
+   * Readable name of the proxy.
+   */
+  name?: string;
+
+  /**
+   * Protocol to use for the proxy connection.
+   */
+  protocol?: 'http' | 'https';
+
+  /**
+   * Current health status of the proxy.
+   */
+  status?: 'available' | 'unavailable';
+}
 
 export namespace ProxyListResponse {
   /**
-   * Configuration for routing traffic through a proxy.
+   * Configuration for a datacenter proxy.
    */
-  export interface ProxyListResponseItem {
+  export interface DatacenterProxyConfig {
     /**
-     * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
-     * worst: `mobile` > `residential` > `isp` > `datacenter`.
+     * ISO 3166 country code. Defaults to US if not provided.
      */
-    type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
-
-    id?: string;
+    country?: string;
+  }
 
+  /**
+   * Configuration for an ISP proxy.
+   */
+  export interface IspProxyConfig {
     /**
-     * Hostnames that should bypass the parent proxy and connect directly.
+     * ISO 3166 country code. Defaults to US if not provided.
      */
-    bypass_hosts?: Array<string>;
+    country?: string;
+  }
 
+  /**
+   * Configuration for residential proxies.
+   */
+  export interface ResidentialProxyConfig {
     /**
-     * Configuration specific to the selected proxy `type`.
+     * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
      */
-    config?:
-      | ProxyListResponseItem.DatacenterProxyConfig
-      | ProxyListResponseItem.IspProxyConfig
-      | ProxyListResponseItem.ResidentialProxyConfig
-      | ProxyListResponseItem.MobileProxyConfig
-      | ProxyListResponseItem.CustomProxyConfig;
+    asn?: string;
 
     /**
-     * IP address that the proxy uses when making requests.
+     * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+     * provided.
      */
-    ip_address?: string;
+    city?: string;
 
     /**
-     * Timestamp of the last health check performed on this proxy.
+     * ISO 3166 country code.
      */
-    last_checked?: string;
+    country?: string;
 
     /**
-     * Readable name of the proxy.
+     * @deprecated Operating system of the residential device.
      */
-    name?: string;
+    os?: 'windows' | 'macos' | 'android';
 
     /**
-     * Protocol to use for the proxy connection.
+     * Two-letter state code.
      */
-    protocol?: 'http' | 'https';
+    state?: string;
 
     /**
-     * Current health status of the proxy.
+     * US ZIP code.
      */
-    status?: 'available' | 'unavailable';
+    zip?: string;
   }
 
-  export namespace ProxyListResponseItem {
+  /**
+   * Configuration for mobile proxies.
+   */
+  export interface MobileProxyConfig {
     /**
-     * Configuration for a datacenter proxy.
+     * Provider city alias. Mobile carrier routing can make observed geo vary.
      */
-    export interface DatacenterProxyConfig {
-      /**
-       * ISO 3166 country code. Defaults to US if not provided.
-       */
-      country?: string;
-    }
+    city?: string;
 
     /**
-     * Configuration for an ISP proxy.
+     * ISO 3166 country code
      */
-    export interface IspProxyConfig {
-      /**
-       * ISO 3166 country code. Defaults to US if not provided.
-       */
-      country?: string;
-    }
+    country?: string;
 
     /**
-     * Configuration for residential proxies.
+     * US-only state code. Mobile carrier routing can make observed geo vary.
      */
-    export interface ResidentialProxyConfig {
-      /**
-       * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
-       */
-      asn?: string;
-
-      /**
-       * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
-       * provided.
-       */
-      city?: string;
-
-      /**
-       * ISO 3166 country code.
-       */
-      country?: string;
-
-      /**
-       * @deprecated Operating system of the residential device.
-       */
-      os?: 'windows' | 'macos' | 'android';
-
-      /**
-       * Two-letter state code.
-       */
-      state?: string;
-
-      /**
-       * US ZIP code.
-       */
-      zip?: string;
-    }
+    state?: string;
+  }
 
+  /**
+   * Configuration for a custom proxy (e.g., private proxy server).
+   */
+  export interface CustomProxyConfig {
     /**
-     * Configuration for mobile proxies.
+     * Proxy host address or IP.
      */
-    export interface MobileProxyConfig {
-      /**
-       * Provider city alias. Mobile carrier routing can make observed geo vary.
-       */
-      city?: string;
-
-      /**
-       * ISO 3166 country code
-       */
-      country?: string;
-
-      /**
-       * US-only state code. Mobile carrier routing can make observed geo vary.
-       */
-      state?: string;
-    }
+    host: string;
 
     /**
-     * Configuration for a custom proxy (e.g., private proxy server).
+     * Proxy port.
      */
-    export interface CustomProxyConfig {
-      /**
-       * Proxy host address or IP.
-       */
-      host: string;
-
-      /**
-       * Proxy port.
-       */
-      port: number;
+    port: number;
 
-      /**
-       * Whether the proxy has a password.
-       */
-      has_password?: boolean;
+    /**
+     * Whether the proxy has a password.
+     */
+    has_password?: boolean;
 
-      /**
-       * Username for proxy authentication.
-       */
-      username?: string;
-    }
+    /**
+     * Username for proxy authentication.
+     */
+    username?: string;
   }
 }
 
@@ -822,6 +824,8 @@ export namespace ProxyCreateParams {
   }
 }
 
+export interface ProxyListParams extends OffsetPaginationParams {}
+
 export interface ProxyCheckParams {
   /**
    * An optional URL to test reachability against. If provided, the proxy check will
@@ -846,7 +850,9 @@ export declare namespace Proxies {
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyCheckResponse as ProxyCheckResponse,
+    type ProxyListResponsesOffsetPagination as ProxyListResponsesOffsetPagination,
     type ProxyCreateParams as ProxyCreateParams,
+    type ProxyListParams as ProxyListParams,
     type ProxyCheckParams as ProxyCheckParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.61.0'; // x-release-please-version
+export const VERSION = '0.63.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.61.0";
+export declare const VERSION = "0.63.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.61.0'; // x-release-please-version
+exports.VERSION = '0.63.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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