feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2813f659cb4e9e81cd3d9c94df748fd6c54f966fd6fd4881da369394aa981ace.yml
-openapi_spec_hash: facb760f50156c700b5c016087a70d64
-config_hash: 3eb1ed1dd0067258984b31d53a0dab48
+configured_endpoints: 10
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ffefc234d11c041cadab66fa6e7c379cebbd9422d38f2b1b1019e425ae19bbd8.yml
+openapi_spec_hash: aa04a371ff95b44847450d657ad0a920
+config_hash: f33cc77a9c01e879ad127194c897a988

api.md

@@ -36,10 +36,15 @@ 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>
 
 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>

src/client.ts

@@ -23,6 +23,9 @@ import { FinalRequestOptions, RequestOptions } from './internal/request-options'
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
+  BrowserDeleteParams,
+  BrowserListResponse,
+  BrowserPersistence,
   BrowserRetrieveResponse,
   Browsers,
 } from './resources/browsers';
@@ -744,8 +747,11 @@ export declare namespace Kernel {
 
   export {
     Browsers as Browsers,
+    type BrowserPersistence as BrowserPersistence,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
+    type BrowserListResponse as BrowserListResponse,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserDeleteParams as BrowserDeleteParams,
   };
 }

src/resources/browsers.ts

@@ -1,7 +1,9 @@
 // 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';
 
@@ -33,6 +35,64 @@ export class Browsers extends APIResource {
   retrieve(id: string, options?: RequestOptions): APIPromise<BrowserRetrieveResponse> {
     return this._client.get(path`/browsers/${id}`, options);
   }
+
+  /**
+   * List active browser sessions for the authenticated user
+   *
+   * @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 persistent_id query parameter.
+   *
+   * @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 Browser Session by ID
+   *
+   * @example
+   * ```ts
+   * await client.browsers.deleteByID(
+   *   'e5bf36fe-9247-4e2b-8b5a-2f594cc1c073',
+   * );
+   * ```
+   */
+  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 {
@@ -54,19 +114,7 @@ export interface BrowserCreateResponse {
   /**
    * Optional persistence configuration for the browser session.
    */
-  persistence?: BrowserCreateResponse.Persistence;
-}
-
-export namespace BrowserCreateResponse {
-  /**
-   * Optional persistence configuration for the browser session.
-   */
-  export interface Persistence {
-    /**
-     * Unique identifier for the persistent browser session.
-     */
-    id: string;
-  }
+  persistence?: BrowserPersistence;
 }
 
 export interface BrowserRetrieveResponse {
@@ -88,18 +136,32 @@ export interface BrowserRetrieveResponse {
   /**
    * Optional persistence configuration for the browser session.
    */
-  persistence?: BrowserRetrieveResponse.Persistence;
+  persistence?: BrowserPersistence;
 }
 
-export namespace BrowserRetrieveResponse {
-  /**
-   * Optional persistence configuration for the browser session.
-   */
-  export interface Persistence {
+export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseItem>;
+
+export namespace BrowserListResponse {
+  export interface BrowserListResponseItem {
+    /**
+     * Remote URL for live viewing the browser session
+     */
+    browser_live_view_url: string;
+
+    /**
+     * Websocket URL for Chrome DevTools Protocol connections to the browser session
+     */
+    cdp_ws_url: string;
+
     /**
-     * Unique identifier for the persistent browser session.
+     * Unique identifier for the browser session
      */
-    id: string;
+    session_id: string;
+
+    /**
+     * Optional persistence configuration for the browser session.
+     */
+    persistence?: BrowsersAPI.BrowserPersistence;
   }
 }
 
@@ -112,25 +174,23 @@ export interface BrowserCreateParams {
   /**
    * Optional persistence configuration for the browser session.
    */
-  persistence?: BrowserCreateParams.Persistence;
+  persistence?: BrowserPersistence;
 }
 
-export namespace BrowserCreateParams {
+export interface BrowserDeleteParams {
   /**
-   * Optional persistence configuration for the browser session.
+   * Persistent browser identifier
    */
-  export interface Persistence {
-    /**
-     * Unique identifier for the persistent browser session.
-     */
-    id: string;
-  }
+  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,
   };
 }

src/resources/index.ts

@@ -3,7 +3,10 @@
 export { Apps, type AppListResponse, type AppListParams } from './apps/apps';
 export {
   Browsers,
+  type BrowserPersistence,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
+  type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserDeleteParams,
 } from './browsers';

tests/api-resources/browsers.test.ts

@@ -39,4 +39,45 @@ describe('resource browsers', () => {
     expect(dataAndResponse.data).toBe(response);
     expect(dataAndResponse.response).toBe(rawResponse);
   });
+
+  // skipped: tests are disabled for the time being
+  test.skip('list', async () => {
+    const responsePromise = client.browsers.list();
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  // skipped: tests are disabled for the time being
+  test.skip('delete: only required params', async () => {
+    const responsePromise = client.browsers.delete({ persistent_id: 'persistent_id' });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  // skipped: tests are disabled for the time being
+  test.skip('delete: required and optional params', async () => {
+    const response = await client.browsers.delete({ persistent_id: 'persistent_id' });
+  });
+
+  // skipped: tests are disabled for the time being
+  test.skip('deleteByID', async () => {
+    const responsePromise = client.browsers.deleteByID('e5bf36fe-9247-4e2b-8b5a-2f594cc1c073');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
 });