feat(api): manual updates

replays!

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d173129101e26f450c200e84430d993479c034700cf826917425d513b88912e6.yml
-openapi_spec_hash: 150b86da7588979d7619b1a894e4720c
-config_hash: eaeed470b1070b34df69c49d68e67355
+configured_endpoints: 21
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a5b1d2c806c42c1534eefc8d34516f7f6e4ab68cb6a836534ee549bdbe4653f3.yml
+openapi_spec_hash: 0be350cc8ddbd1fc7e058ce6c3a44ee8
+config_hash: 307153ecd5b85f77ce8e0d87f6e5dfab

api.md

@@ -70,16 +70,29 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/browsers.ts">BrowserPersistence</a></code>
-- <code><a href="./src/resources/browsers.ts">BrowserCreateResponse</a></code>
-- <code><a href="./src/resources/browsers.ts">BrowserRetrieveResponse</a></code>
-- <code><a href="./src/resources/browsers.ts">BrowserListResponse</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserPersistence</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserCreateResponse</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserRetrieveResponse</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserListResponse</a></code>
 
 Methods:
 
-- <code title="post /browsers">client.browsers.<a href="./src/resources/browsers.ts">create</a>({ ...params }) -> BrowserCreateResponse</code>
-- <code title="get /browsers/{id}">client.browsers.<a href="./src/resources/browsers.ts">retrieve</a>(id) -> BrowserRetrieveResponse</code>
-- <code title="get /browsers">client.browsers.<a href="./src/resources/browsers.ts">list</a>() -> BrowserListResponse</code>
-- <code title="delete /browsers">client.browsers.<a href="./src/resources/browsers.ts">delete</a>({ ...params }) -> void</code>
-- <code title="delete /browsers/{id}">client.browsers.<a href="./src/resources/browsers.ts">deleteByID</a>(id) -> void</code>
-- <code title="get /browsers/{id}/replay">client.browsers.<a href="./src/resources/browsers.ts">retrieveReplay</a>(id) -> Response</code>
+- <code title="post /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">create</a>({ ...params }) -> BrowserCreateResponse</code>
+- <code title="get /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">retrieve</a>(id) -> BrowserRetrieveResponse</code>
+- <code title="get /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">list</a>() -> BrowserListResponse</code>
+- <code title="delete /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">delete</a>({ ...params }) -> void</code>
+- <code title="delete /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">deleteByID</a>(id) -> void</code>
+
+## Replays
+
+Types:
+
+- <code><a href="./src/resources/browsers/replays.ts">ReplayListResponse</a></code>
+- <code><a href="./src/resources/browsers/replays.ts">ReplayStartResponse</a></code>
+
+Methods:
+
+- <code title="get /browsers/{id}/replays">client.browsers.replays.<a href="./src/resources/browsers/replays.ts">list</a>(id) -> ReplayListResponse</code>
+- <code title="get /browsers/{id}/replays/{replay_id}">client.browsers.replays.<a href="./src/resources/browsers/replays.ts">download</a>(replayID, { ...params }) -> Response</code>
+- <code title="post /browsers/{id}/replays">client.browsers.replays.<a href="./src/resources/browsers/replays.ts">start</a>(id, { ...params }) -> ReplayStartResponse</code>
+- <code title="post /browsers/{id}/replays/{replay_id}/stop">client.browsers.replays.<a href="./src/resources/browsers/replays.ts">stop</a>(replayID, { ...params }) -> void</code>

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';

src/resources/browsers.ts

@@ -1,253 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import * as BrowsersAPI from './browsers';
-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 {
-  /**
-   * 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]),
-    });
-  }
-
-  /**
-   * Get browser session replay.
-   *
-   * @example
-   * ```ts
-   * const response = await client.browsers.retrieveReplay(
-   *   'htzv5orfit78e1m2biiifpbv',
-   * );
-   *
-   * const content = await response.blob();
-   * console.log(content);
-   * ```
-   */
-  retrieveReplay(id: string, options?: RequestOptions): APIPromise<Response> {
-    return this._client.get(path`/browsers/${id}/replay`, {
-      ...options,
-      headers: buildHeaders([{ Accept: 'video/mp4' }, options?.headers]),
-      __binaryResponse: true,
-    });
-  }
-}
-
-/**
- * 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;
-
-  /**
-   * Remote URL for viewing the browser session replay if enabled
-   */
-  replay_view_url?: string;
-}
-
-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;
-
-  /**
-   * Remote URL for viewing the browser session replay if enabled
-   */
-  replay_view_url?: string;
-}
-
-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;
-
-    /**
-     * Remote URL for viewing the browser session replay if enabled
-     */
-    replay_view_url?: string;
-  }
-}
-
-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, enables replay recording of the browser session. Defaults to false.
-   */
-  replay?: boolean;
-
-  /**
-   * 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;
-}
-
-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 * from './browsers/index';