release: 0.65.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.64.0"
+  ".": "0.65.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-9d489e3e43edfa64a754d4281241718e01c85d9a82ef3687df12bbd3c4ff5b42.yml
-openapi_spec_hash: a953cafb7f40ec8495dbd7df8bab8bad
-config_hash: bb7acce8576a50dd449b0c8f58ef0f1d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-08c2d6a44f4cdcbfb6803a3043fdc1a3e33911dec4652cb3a870f01bc584421f.yml
+openapi_spec_hash: c816491451347eb93b793cddf6a78648
+config_hash: 9e45c27425021d49b5391f5cc980b046

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.65.0 (2026-06-08)
+
+Full Changelog: [v0.64.0...v0.65.0](https://github.com/kernel/kernel-node-sdk/compare/v0.64.0...v0.65.0)
+
+### Features
+
+* **api:** allow setting a name and tags on a pool-acquired browser session ([0c107dd](https://github.com/kernel/kernel-node-sdk/commit/0c107ddca43080fea6e209e252b49e697035d7f8))
+* **api:** support id-or-name lookup on browser session get/patch/delete ([1384691](https://github.com/kernel/kernel-node-sdk/commit/1384691c39a0af40184379b50417f7cfeb34ed60))
+
 ## 0.64.0 (2026-06-05)
 
 Full Changelog: [v0.63.0...v0.64.0](https://github.com/kernel/kernel-node-sdk/compare/v0.63.0...v0.64.0)

api.md

@@ -79,11 +79,11 @@ Types:
 Methods:
 
 - <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, { ...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/{id_or_name}">client.browsers.<a href="./src/resources/browsers/browsers.ts">retrieve</a>(idOrName, { ...params }) -> BrowserRetrieveResponse</code>
+- <code title="patch /browsers/{id_or_name}">client.browsers.<a href="./src/resources/browsers/browsers.ts">update</a>(idOrName, { ...params }) -> BrowserUpdateResponse</code>
 - <code title="get /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">list</a>({ ...params }) -> BrowserListResponsesOffsetPagination</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="delete /browsers/{id_or_name}">client.browsers.<a href="./src/resources/browsers/browsers.ts">deleteByID</a>(idOrName) -> void</code>
 - <code title="post /browsers/{id}/extensions">client.browsers.<a href="./src/resources/browsers/browsers.ts">loadExtensions</a>(id, { ...params }) -> void</code>
 
 ## Telemetry

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.64.0",
+  "version": "0.65.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "dist/index.d.ts",

src/resources/browser-pools.ts

@@ -626,6 +626,21 @@ export interface BrowserPoolAcquireParams {
    * rate.
    */
   acquire_timeout_seconds?: number;
+
+  /**
+   * Optional human-readable name for the acquired browser session, used to find it
+   * later in the dashboard. Must be unique among active sessions within the pool's
+   * project. Applies to this lease only and is cleared when the browser is released
+   * back to the pool.
+   */
+  name?: string;
+
+  /**
+   * Optional user-defined key-value tags for the acquired browser session, used to
+   * find and group sessions later. Applies to this lease only and are cleared when
+   * the browser is released back to the pool. Up to 50 pairs.
+   */
+  tags?: BrowsersAPI.Tags;
 }
 
 export interface BrowserPoolReleaseParams {

src/resources/browsers/browsers.ts

@@ -160,11 +160,11 @@ export class Browsers extends APIResource {
    * ```
    */
   retrieve(
-    id: string,
+    idOrName: string,
     query: BrowserRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<BrowserRetrieveResponse> {
-    return this._client.get(path`/browsers/${id}`, { query, ...options });
+    return this._client.get(path`/browsers/${idOrName}`, { query, ...options });
   }
 
   /**
@@ -177,8 +177,12 @@ export class Browsers extends APIResource {
    * );
    * ```
    */
-  update(id: string, body: BrowserUpdateParams, options?: RequestOptions): APIPromise<BrowserUpdateResponse> {
-    return this._client.patch(path`/browsers/${id}`, { body, ...options });
+  update(
+    idOrName: string,
+    body: BrowserUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<BrowserUpdateResponse> {
+    return this._client.patch(path`/browsers/${idOrName}`, { body, ...options });
   }
 
   /**
@@ -225,7 +229,7 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Delete a browser session by ID
+   * Delete a browser session by ID or name
    *
    * @example
    * ```ts
@@ -234,8 +238,8 @@ export class Browsers extends APIResource {
    * );
    * ```
    */
-  deleteByID(id: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/browsers/${id}`, {
+  deleteByID(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/browsers/${idOrName}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.64.0'; // x-release-please-version
+export const VERSION = '0.65.0'; // x-release-please-version