@onkernel/sdk 0.7.1 → 0.8.0

package/resources/browsers.js

@@ -1,100 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Browsers = void 0;
-const resource_1 = require("../core/resource.js");
-const headers_1 = require("../internal/headers.js");
-const path_1 = require("../internal/utils/path.js");
-class Browsers extends resource_1.APIResource {
-    /**
-     * Create a new browser session from within an action.
-     *
-     * @example
-     * ```ts
-     * const browser = await client.browsers.create();
-     * ```
-     */
-    create(body = {}, options) {
-        return this._client.post('/browsers', { body, ...options });
-    }
-    /**
-     * Get information about a browser session.
-     *
-     * @example
-     * ```ts
-     * const browser = await client.browsers.retrieve(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     * ```
-     */
-    retrieve(id, options) {
-        return this._client.get((0, path_1.path) `/browsers/${id}`, options);
-    }
-    /**
-     * List active browser sessions
-     *
-     * @example
-     * ```ts
-     * const browsers = await client.browsers.list();
-     * ```
-     */
-    list(options) {
-        return this._client.get('/browsers', options);
-    }
-    /**
-     * Delete a persistent browser session by its persistent_id.
-     *
-     * @example
-     * ```ts
-     * await client.browsers.delete({
-     *   persistent_id: 'persistent_id',
-     * });
-     * ```
-     */
-    delete(params, options) {
-        const { persistent_id } = params;
-        return this._client.delete('/browsers', {
-            query: { persistent_id },
-            ...options,
-            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
-    /**
-     * Delete a browser session by ID
-     *
-     * @example
-     * ```ts
-     * await client.browsers.deleteByID(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     * ```
-     */
-    deleteByID(id, options) {
-        return this._client.delete((0, path_1.path) `/browsers/${id}`, {
-            ...options,
-            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
-    /**
-     * Get browser session replay.
-     *
-     * @example
-     * ```ts
-     * const response = await client.browsers.retrieveReplay(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     *
-     * const content = await response.blob();
-     * console.log(content);
-     * ```
-     */
-    retrieveReplay(id, options) {
-        return this._client.get((0, path_1.path) `/browsers/${id}/replay`, {
-            ...options,
-            headers: (0, headers_1.buildHeaders)([{ Accept: 'video/mp4' }, options?.headers]),
-            __binaryResponse: true,
-        });
-    }
-}
-exports.Browsers = Browsers;
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./browsers/index.js"), exports);
 //# sourceMappingURL=browsers.js.map

package/resources/browsers.js.map

@@ -1 +1 @@
-{"version":3,"file":"browsers.js","sourceRoot":"","sources":["../src/resources/browsers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;OAOG;IACH,MAAM,CACJ,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;YACtC,KAAK,EAAE,EAAE,aAAa,EAAE;YACxB,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,SAAS,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAlGD,4BAkGC"}
+{"version":3,"file":"browsers.js","sourceRoot":"","sources":["../src/resources/browsers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/browsers.mjs

@@ -1,96 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../core/resource.mjs";
-import { buildHeaders } from "../internal/headers.mjs";
-import { path } from "../internal/utils/path.mjs";
-export class Browsers extends APIResource {
-    /**
-     * Create a new browser session from within an action.
-     *
-     * @example
-     * ```ts
-     * const browser = await client.browsers.create();
-     * ```
-     */
-    create(body = {}, options) {
-        return this._client.post('/browsers', { body, ...options });
-    }
-    /**
-     * Get information about a browser session.
-     *
-     * @example
-     * ```ts
-     * const browser = await client.browsers.retrieve(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     * ```
-     */
-    retrieve(id, options) {
-        return this._client.get(path `/browsers/${id}`, options);
-    }
-    /**
-     * List active browser sessions
-     *
-     * @example
-     * ```ts
-     * const browsers = await client.browsers.list();
-     * ```
-     */
-    list(options) {
-        return this._client.get('/browsers', options);
-    }
-    /**
-     * Delete a persistent browser session by its persistent_id.
-     *
-     * @example
-     * ```ts
-     * await client.browsers.delete({
-     *   persistent_id: 'persistent_id',
-     * });
-     * ```
-     */
-    delete(params, options) {
-        const { persistent_id } = params;
-        return this._client.delete('/browsers', {
-            query: { persistent_id },
-            ...options,
-            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
-    /**
-     * Delete a browser session by ID
-     *
-     * @example
-     * ```ts
-     * await client.browsers.deleteByID(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     * ```
-     */
-    deleteByID(id, options) {
-        return this._client.delete(path `/browsers/${id}`, {
-            ...options,
-            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
-    /**
-     * Get browser session replay.
-     *
-     * @example
-     * ```ts
-     * const response = await client.browsers.retrieveReplay(
-     *   'htzv5orfit78e1m2biiifpbv',
-     * );
-     *
-     * const content = await response.blob();
-     * console.log(content);
-     * ```
-     */
-    retrieveReplay(id, options) {
-        return this._client.get(path `/browsers/${id}/replay`, {
-            ...options,
-            headers: buildHeaders([{ Accept: 'video/mp4' }, options?.headers]),
-            __binaryResponse: true,
-        });
-    }
-}
+export * from "./browsers/index.mjs";
 //# sourceMappingURL=browsers.mjs.map

package/resources/browsers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"browsers.mjs","sourceRoot":"","sources":["../src/resources/browsers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,MAAM,CACJ,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;YACtC,KAAK,EAAE,EAAE,aAAa,EAAE;YACxB,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,SAAS,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"browsers.mjs","sourceRoot":"","sources":["../src/resources/browsers.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/index.d.mts

@@ -1,6 +1,6 @@
 export * from "./shared.mjs";
 export { Apps, type AppListResponse, type AppListParams } from "./apps/apps.mjs";
-export { Browsers, type BrowserPersistence, type BrowserCreateResponse, type BrowserRetrieveResponse, type BrowserListResponse, type BrowserCreateParams, type BrowserDeleteParams, } from "./browsers.mjs";
+export { Browsers, type BrowserPersistence, type BrowserCreateResponse, type BrowserRetrieveResponse, type BrowserListResponse, type BrowserCreateParams, type BrowserDeleteParams, } from "./browsers/browsers.mjs";
 export { Deployments, type DeploymentStateEvent, type DeploymentCreateResponse, type DeploymentRetrieveResponse, type DeploymentListResponse, type DeploymentFollowResponse, type DeploymentCreateParams, type DeploymentListParams, type DeploymentFollowParams, } from "./deployments.mjs";
 export { Invocations, type InvocationStateEvent, type InvocationCreateResponse, type InvocationRetrieveResponse, type InvocationUpdateResponse, type InvocationFollowResponse, type InvocationCreateParams, type InvocationUpdateParams, } from "./invocations.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./shared.js";
 export { Apps, type AppListResponse, type AppListParams } from "./apps/apps.js";
-export { Browsers, type BrowserPersistence, type BrowserCreateResponse, type BrowserRetrieveResponse, type BrowserListResponse, type BrowserCreateParams, type BrowserDeleteParams, } from "./browsers.js";
+export { Browsers, type BrowserPersistence, type BrowserCreateResponse, type BrowserRetrieveResponse, type BrowserListResponse, type BrowserCreateParams, type BrowserDeleteParams, } from "./browsers/browsers.js";
 export { Deployments, type DeploymentStateEvent, type DeploymentCreateResponse, type DeploymentRetrieveResponse, type DeploymentListResponse, type DeploymentFollowResponse, type DeploymentCreateParams, type DeploymentListParams, type DeploymentFollowParams, } from "./deployments.js";
 export { Invocations, type InvocationStateEvent, type InvocationCreateResponse, type InvocationRetrieveResponse, type InvocationUpdateResponse, type InvocationFollowResponse, type InvocationCreateParams, type InvocationUpdateParams, } from "./invocations.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.js

@@ -6,7 +6,7 @@ const tslib_1 = require("../internal/tslib.js");
 tslib_1.__exportStar(require("./shared.js"), exports);
 var apps_1 = require("./apps/apps.js");
 Object.defineProperty(exports, "Apps", { enumerable: true, get: function () { return apps_1.Apps; } });
-var browsers_1 = require("./browsers.js");
+var browsers_1 = require("./browsers/browsers.js");
 Object.defineProperty(exports, "Browsers", { enumerable: true, get: function () { return browsers_1.Browsers; } });
 var deployments_1 = require("./deployments.js");
 Object.defineProperty(exports, "Deployments", { enumerable: true, get: function () { return deployments_1.Deployments; } });

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,sDAAyB;AACzB,uCAA6E;AAApE,4FAAA,IAAI,OAAA;AACb,0CAQoB;AAPlB,oGAAA,QAAQ,OAAA;AAQV,gDAUuB;AATrB,0GAAA,WAAW,OAAA;AAUb,gDASuB;AARrB,0GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,sDAAyB;AACzB,uCAA6E;AAApE,4FAAA,IAAI,OAAA;AACb,mDAQ6B;AAP3B,oGAAA,QAAQ,OAAA;AAQV,gDAUuB;AATrB,0GAAA,WAAW,OAAA;AAUb,gDASuB;AARrB,0GAAA,WAAW,OAAA"}

package/resources/index.mjs

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export * from "./shared.mjs";
 export { Apps } from "./apps/apps.mjs";
-export { Browsers, } from "./browsers.mjs";
+export { Browsers, } from "./browsers/browsers.mjs";
 export { Deployments, } from "./deployments.mjs";
 export { Invocations, } from "./invocations.mjs";
 //# sourceMappingURL=index.mjs.map

package/src/client.ts

@@ -16,15 +16,6 @@ import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import {
-  BrowserCreateParams,
-  BrowserCreateResponse,
-  BrowserDeleteParams,
-  BrowserListResponse,
-  BrowserPersistence,
-  BrowserRetrieveResponse,
-  Browsers,
-} from './resources/browsers';
 import {
   DeploymentCreateParams,
   DeploymentCreateResponse,
@@ -48,6 +39,15 @@ import {
   Invocations,
 } from './resources/invocations';
 import { AppListParams, AppListResponse, Apps } from './resources/apps/apps';
+import {
+  BrowserCreateParams,
+  BrowserCreateResponse,
+  BrowserDeleteParams,
+  BrowserListResponse,
+  BrowserPersistence,
+  BrowserRetrieveResponse,
+  Browsers,
+} from './resources/browsers/browsers';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -230,7 +230,7 @@ export class Kernel {
    * Create a new client instance re-using the same options given to the current client with optional overriding.
    */
   withOptions(options: Partial<ClientOptions>): this {
-    return new (this.constructor as any as new (props: ClientOptions) => typeof this)({
+    const client = new (this.constructor as any as new (props: ClientOptions) => typeof this)({
       ...this._options,
       environment: options.environment ? options.environment : undefined,
       baseURL: options.environment ? undefined : this.baseURL,
@@ -243,6 +243,7 @@ export class Kernel {
       apiKey: this.apiKey,
       ...options,
     });
+    return client;
   }
 
   /**
@@ -260,7 +261,7 @@ export class Kernel {
     return;
   }
 
-  protected authHeaders(opts: FinalRequestOptions): NullableHeaders | undefined {
+  protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }
 
@@ -392,7 +393,9 @@ export class Kernel {
 
     await this.prepareOptions(options);
 
-    const { req, url, timeout } = this.buildRequest(options, { retryCount: maxRetries - retriesRemaining });
+    const { req, url, timeout } = await this.buildRequest(options, {
+      retryCount: maxRetries - retriesRemaining,
+    });
 
     await this.prepareRequest(req, { url, options });
 
@@ -470,7 +473,7 @@ export class Kernel {
     } with status ${response.status} in ${headersTime - startTime}ms`;
 
     if (!response.ok) {
-      const shouldRetry = this.shouldRetry(response);
+      const shouldRetry = await this.shouldRetry(response);
       if (retriesRemaining && shouldRetry) {
         const retryMessage = `retrying, ${retriesRemaining} attempts remaining`;
 
@@ -569,7 +572,7 @@ export class Kernel {
     }
   }
 
-  private shouldRetry(response: Response): boolean {
+  private async shouldRetry(response: Response): Promise<boolean> {
     // Note this is not a standard header.
     const shouldRetryHeader = response.headers.get('x-should-retry');
 
@@ -646,10 +649,10 @@ export class Kernel {
     return sleepSeconds * jitter * 1000;
   }
 
-  buildRequest(
+  async buildRequest(
     inputOptions: FinalRequestOptions,
     { retryCount = 0 }: { retryCount?: number } = {},
-  ): { req: FinalizedRequestInit; url: string; timeout: number } {
+  ): Promise<{ req: FinalizedRequestInit; url: string; timeout: number }> {
     const options = { ...inputOptions };
     const { method, path, query, defaultBaseURL } = options;
 
@@ -657,7 +660,7 @@ export class Kernel {
     if ('timeout' in options) validatePositiveInteger('timeout', options.timeout);
     options.timeout = options.timeout ?? this.timeout;
     const { bodyHeaders, body } = this.buildBody({ options });
-    const reqHeaders = this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
+    const reqHeaders = await this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
 
     const req: FinalizedRequestInit = {
       method,
@@ -673,7 +676,7 @@ export class Kernel {
     return { req, url, timeout: options.timeout };
   }
 
-  private buildHeaders({
+  private async buildHeaders({
     options,
     method,
     bodyHeaders,
@@ -683,7 +686,7 @@ export class Kernel {
     method: HTTPMethod;
     bodyHeaders: HeadersLike;
     retryCount: number;
-  }): Headers {
+  }): Promise<Headers> {
     let idempotencyHeaders: HeadersLike = {};
     if (this.idempotencyHeader && method !== 'get') {
       if (!options.idempotencyKey) options.idempotencyKey = this.defaultIdempotencyKey();
@@ -699,7 +702,7 @@ export class Kernel {
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
       },
-      this.authHeaders(options),
+      await this.authHeaders(options),
       this._options.defaultHeaders,
       bodyHeaders,
       options.headers,

package/src/resources/browsers/browsers.ts

@@ -0,0 +1,234 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BrowsersAPI from './browsers';
+import * as ReplaysAPI from './replays';
+import {
+  ReplayDownloadParams,
+  ReplayListResponse,
+  ReplayStartParams,
+  ReplayStartResponse,
+  ReplayStopParams,
+  Replays,
+} from './replays';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Browsers extends APIResource {
+  replays: ReplaysAPI.Replays = new ReplaysAPI.Replays(this._client);
+
+  /**
+   * Create a new browser session from within an action.
+   *
+   * @example
+   * ```ts
+   * const browser = await client.browsers.create();
+   * ```
+   */
+  create(
+    body: BrowserCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BrowserCreateResponse> {
+    return this._client.post('/browsers', { body, ...options });
+  }
+
+  /**
+   * Get information about a browser session.
+   *
+   * @example
+   * ```ts
+   * const browser = await client.browsers.retrieve(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<BrowserRetrieveResponse> {
+    return this._client.get(path`/browsers/${id}`, options);
+  }
+
+  /**
+   * List active browser sessions
+   *
+   * @example
+   * ```ts
+   * const browsers = await client.browsers.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<BrowserListResponse> {
+    return this._client.get('/browsers', options);
+  }
+
+  /**
+   * Delete a persistent browser session by its persistent_id.
+   *
+   * @example
+   * ```ts
+   * await client.browsers.delete({
+   *   persistent_id: 'persistent_id',
+   * });
+   * ```
+   */
+  delete(params: BrowserDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { persistent_id } = params;
+    return this._client.delete('/browsers', {
+      query: { persistent_id },
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete a browser session by ID
+   *
+   * @example
+   * ```ts
+   * await client.browsers.deleteByID(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
+   * ```
+   */
+  deleteByID(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/browsers/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Optional persistence configuration for the browser session.
+ */
+export interface BrowserPersistence {
+  /**
+   * Unique identifier for the persistent browser session.
+   */
+  id: string;
+}
+
+export interface BrowserCreateResponse {
+  /**
+   * Websocket URL for Chrome DevTools Protocol connections to the browser session
+   */
+  cdp_ws_url: string;
+
+  /**
+   * Unique identifier for the browser session
+   */
+  session_id: string;
+
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
+}
+
+export interface BrowserRetrieveResponse {
+  /**
+   * Websocket URL for Chrome DevTools Protocol connections to the browser session
+   */
+  cdp_ws_url: string;
+
+  /**
+   * Unique identifier for the browser session
+   */
+  session_id: string;
+
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
+}
+
+export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseItem>;
+
+export namespace BrowserListResponse {
+  export interface BrowserListResponseItem {
+    /**
+     * Websocket URL for Chrome DevTools Protocol connections to the browser session
+     */
+    cdp_ws_url: string;
+
+    /**
+     * Unique identifier for the browser session
+     */
+    session_id: string;
+
+    /**
+     * Remote URL for live viewing the browser session. Only available for non-headless
+     * browsers.
+     */
+    browser_live_view_url?: string;
+
+    /**
+     * Optional persistence configuration for the browser session.
+     */
+    persistence?: BrowsersAPI.BrowserPersistence;
+  }
+}
+
+export interface BrowserCreateParams {
+  /**
+   * If true, launches the browser using a headless image (no VNC/GUI). Defaults to
+   * false.
+   */
+  headless?: boolean;
+
+  /**
+   * action invocation ID
+   */
+  invocation_id?: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
+
+  /**
+   * If true, launches the browser in stealth mode to reduce detection by anti-bot
+   * mechanisms.
+   */
+  stealth?: boolean;
+}
+
+export interface BrowserDeleteParams {
+  /**
+   * Persistent browser identifier
+   */
+  persistent_id: string;
+}
+
+Browsers.Replays = Replays;
+
+export declare namespace Browsers {
+  export {
+    type BrowserPersistence as BrowserPersistence,
+    type BrowserCreateResponse as BrowserCreateResponse,
+    type BrowserRetrieveResponse as BrowserRetrieveResponse,
+    type BrowserListResponse as BrowserListResponse,
+    type BrowserCreateParams as BrowserCreateParams,
+    type BrowserDeleteParams as BrowserDeleteParams,
+  };
+
+  export {
+    Replays as Replays,
+    type ReplayListResponse as ReplayListResponse,
+    type ReplayStartResponse as ReplayStartResponse,
+    type ReplayDownloadParams as ReplayDownloadParams,
+    type ReplayStartParams as ReplayStartParams,
+    type ReplayStopParams as ReplayStopParams,
+  };
+}

package/src/resources/browsers/index.ts

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Browsers,
+  type BrowserPersistence,
+  type BrowserCreateResponse,
+  type BrowserRetrieveResponse,
+  type BrowserListResponse,
+  type BrowserCreateParams,
+  type BrowserDeleteParams,
+} from './browsers';
+export {
+  Replays,
+  type ReplayListResponse,
+  type ReplayStartResponse,
+  type ReplayDownloadParams,
+  type ReplayStartParams,
+  type ReplayStopParams,
+} from './replays';