feat: EOL persistent browsers: openapi limits

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 113
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-2118a79fa452fad5922776130ea4877059e9568b603ef146171b7bb6a0f8458a.yml
-openapi_spec_hash: 686e8c5855ed88b2944b9d9ec21d22ce
-config_hash: 37661d89120558d34b6cc184292632f2
+configured_endpoints: 112
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-346b1affebf16e7f943bcf4db307a5589fcae636c9147dd0afbe5c02cf12ad30.yml
+openapi_spec_hash: 348df436759d220264f12450919211c3
+config_hash: ae3dea7997fb5d36fa41979f9585ed78

api.md

@@ -66,7 +66,6 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/browsers/browsers.ts">BrowserPersistence</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserPoolRef</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserUsage</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">Profile</a></code>
@@ -82,7 +81,6 @@ Methods:
 - <code title="get /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">retrieve</a>(id, { ...params }) -> BrowserRetrieveResponse</code>
 - <code title="patch /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">update</a>(id, { ...params }) -> BrowserUpdateResponse</code>
 - <code title="get /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">list</a>({ ...params }) -> BrowserListResponsesOffsetPagination</code>
-- <code title="delete /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">delete</a>({ ...params }) -> void</code>
 - <code title="post /browsers/{id}/curl">client.browsers.<a href="./src/resources/browsers/browsers.ts">curl</a>(id, { ...params }) -> BrowserCurlResponse</code>
 - <code title="delete /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">deleteByID</a>(id) -> void</code>
 - <code title="post /browsers/{id}/extensions">client.browsers.<a href="./src/resources/browsers/browsers.ts">loadExtensions</a>(id, { ...params }) -> void</code>

src/client.ts

@@ -110,12 +110,10 @@ import {
   BrowserCreateResponse,
   BrowserCurlParams,
   BrowserCurlResponse,
-  BrowserDeleteParams,
   BrowserListParams,
   BrowserListResponse,
   BrowserListResponsesOffsetPagination,
   BrowserLoadExtensionsParams,
-  BrowserPersistence,
   BrowserPoolRef,
   BrowserRetrieveParams,
   BrowserRetrieveResponse,
@@ -1038,7 +1036,6 @@ export declare namespace Kernel {
 
   export {
     Browsers as Browsers,
-    type BrowserPersistence as BrowserPersistence,
     type BrowserPoolRef as BrowserPoolRef,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
@@ -1052,7 +1049,6 @@ export declare namespace Kernel {
     type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
-    type BrowserDeleteParams as BrowserDeleteParams,
     type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
   };

src/resources/browser-pools.ts

@@ -349,12 +349,6 @@ export interface BrowserPoolAcquireResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowsersAPI.BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */

src/resources/browsers/browsers.ts

@@ -192,21 +192,6 @@ export class Browsers extends APIResource {
     return this._client.getAPIList('/browsers', OffsetPagination<BrowserListResponse>, { query, ...options });
   }
 
-  /**
-   * DEPRECATED: Use DELETE /browsers/{id} instead. Delete a persistent browser
-   * session by its persistent_id.
-   *
-   * @deprecated
-   */
-  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]),
-    });
-  }
-
   /**
    * Sends an HTTP request through Chrome's HTTP request stack, inheriting the
    * browser's TLS fingerprint, cookies, proxy configuration, and headers. Returns a
@@ -279,17 +264,6 @@ export type BrowserListResponsesOffsetPagination = OffsetPagination<BrowserListR
 
 export type ProfilesOffsetPagination = OffsetPagination<Profile>;
 
-/**
- * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
- * instead.
- */
-export interface BrowserPersistence {
-  /**
-   * DEPRECATED: Unique identifier for the persistent browser session.
-   */
-  id: string;
-}
-
 /**
  * Browser pool this session was acquired from, if any.
  */
@@ -415,12 +389,6 @@ export interface BrowserCreateResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -542,12 +510,6 @@ export interface BrowserRetrieveResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -669,12 +631,6 @@ export interface BrowserUpdateResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -796,12 +752,6 @@ export interface BrowserListResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -882,8 +832,7 @@ export interface BrowserCreateParams {
   /**
    * Custom Chrome enterprise policy overrides applied to this browser session. Keys
    * are Chrome enterprise policy names; values must match their expected types.
-   * Blocked: kernel-managed policies (extensions, proxy, CDP/automation). Ignored
-   * when reusing an existing persistent session. See
+   * Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
    * https://chromeenterprise.google/policies/
    */
   chrome_policy?: { [key: string]: unknown };
@@ -916,12 +865,6 @@ export interface BrowserCreateParams {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Profile selection for the browser session. Provide either id or name. If
    * specified, the matching profile will be loaded into the browser session.
@@ -1055,13 +998,6 @@ export interface BrowserListParams extends OffsetPaginationParams {
   status?: 'active' | 'deleted' | 'all';
 }
 
-export interface BrowserDeleteParams {
-  /**
-   * Persistent browser identifier
-   */
-  persistent_id: string;
-}
-
 export interface BrowserCurlParams {
   /**
    * Target URL (must be http or https).
@@ -1126,7 +1062,6 @@ Browsers.Playwright = Playwright;
 
 export declare namespace Browsers {
   export {
-    type BrowserPersistence as BrowserPersistence,
     type BrowserPoolRef as BrowserPoolRef,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
@@ -1140,7 +1075,6 @@ export declare namespace Browsers {
     type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
-    type BrowserDeleteParams as BrowserDeleteParams,
     type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
   };

src/resources/browsers/index.ts

@@ -2,7 +2,6 @@
 
 export {
   Browsers,
-  type BrowserPersistence,
   type BrowserPoolRef,
   type BrowserUsage,
   type Profile,
@@ -15,7 +14,6 @@ export {
   type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
-  type BrowserDeleteParams,
   type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
   type ProfilesOffsetPagination,

src/resources/index.ts

@@ -21,7 +21,6 @@ export {
 } from './browser-pools';
 export {
   Browsers,
-  type BrowserPersistence,
   type BrowserPoolRef,
   type BrowserUsage,
   type Profile,
@@ -34,7 +33,6 @@ export {
   type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
-  type BrowserDeleteParams,
   type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
   type ProfilesOffsetPagination,

src/resources/invocations.ts

@@ -488,12 +488,6 @@ export namespace InvocationListBrowsersResponse {
      */
     kiosk_mode?: boolean;
 
-    /**
-     * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-     * instead.
-     */
-    persistence?: BrowsersAPI.BrowserPersistence;
-
     /**
      * Browser pool this session was acquired from, if any.
      */

src/resources/projects/limits.ts

@@ -54,12 +54,6 @@ export interface ProjectLimits {
    */
   max_concurrent_sessions?: number | null;
 
-  /**
-   * Maximum persistent browser sessions for this project. Null means no
-   * project-level cap.
-   */
-  max_persistent_sessions?: number | null;
-
   /**
    * Maximum pooled sessions capacity for this project. Null means no project-level
    * cap.
@@ -80,12 +74,6 @@ export interface UpdateProjectLimitsRequest {
    */
   max_concurrent_sessions?: number | null;
 
-  /**
-   * Maximum persistent browser sessions for this project. Set to 0 to remove the
-   * cap; omit to leave unchanged.
-   */
-  max_persistent_sessions?: number | null;
-
   /**
    * Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
    * omit to leave unchanged.
@@ -106,12 +94,6 @@ export interface LimitUpdateParams {
    */
   max_concurrent_sessions?: number | null;
 
-  /**
-   * Maximum persistent browser sessions for this project. Set to 0 to remove the
-   * cap; omit to leave unchanged.
-   */
-  max_persistent_sessions?: number | null;
-
   /**
    * Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
    * omit to leave unchanged.

tests/api-resources/browsers/browsers.test.ts

@@ -32,7 +32,6 @@ describe('resource browsers', () => {
           headless: false,
           invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
           kiosk_mode: true,
-          persistence: { id: 'my-awesome-browser-for-user-1234' },
           profile: {
             id: 'id',
             name: 'name',
@@ -126,23 +125,6 @@ describe('resource browsers', () => {
     ).rejects.toThrow(Kernel.NotFoundError);
   });
 
-  // Mock server tests are disabled
-  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);
-  });
-
-  // Mock server tests are disabled
-  test.skip('delete: required and optional params', async () => {
-    const response = await client.browsers.delete({ persistent_id: 'persistent_id' });
-  });
-
   // Mock server tests are disabled
   test.skip('curl: only required params', async () => {
     const responsePromise = client.browsers.curl('id', { url: 'url' });