release: 2.9.0 (#179)

stainless-app[bot] · web-flow · commit a4956b15d60b · 2026-03-16T20:58:50.000Z
Automated Release PR --- ## 2.9.0 (2026-03-16) Full Changelog: [v2.8.0...v2.9.0](v2.8.0...v2.9.0) ### Features * [CORE-1796][apps/api] Update Node.js SDK ([0b1a1ff](0b1a1ff)) * [GRO-000] docs: Add guide + docs for search api ([a87b397](a87b397)) * **api:** api update ([#19](#19)) ([8df9cc8](8df9cc8)) * **api:** update via SDK Studio ([#10](#10)) ([2c6c15d](2c6c15d)) * **api:** update via SDK Studio ([#11](#11)) ([9191ed6](9191ed6)) * **api:** update via SDK Studio ([#12](#12)) ([ebeaf82](ebeaf82)) * **api:** update via SDK Studio ([#13](#13)) ([c0ffdce](c0ffdce)) * **api:** update via SDK Studio ([#16](#16)) ([a96a86c](a96a86c)) * **api:** update via SDK Studio ([#17](#17)) ([52cf741](52cf741)) * **api:** update via SDK Studio ([#3](#3)) ([8a06f81](8a06f81)) * **api:** update via SDK Studio ([#4](#4)) ([cf6309b](cf6309b)) * **api:** update via SDK Studio ([#5](#5)) ([4275810](4275810)) * **api:** update via SDK Studio ([#6](#6)) ([299d77e](299d77e)) * **api:** update via SDK Studio ([#7](#7)) ([e1e4738](e1e4738)) * **api:** update via SDK Studio ([#8](#8)) ([2d845ff](2d845ff)) * **api:** update via SDK Studio ([#9](#9)) ([a17fadc](a17fadc)) ### Bug Fixes * use npm publish instead of yarn publish ([#173](#173)) ([05b3225](05b3225)) ### Chores * go live ([#1](#1)) ([bc9e36e](bc9e36e)) * **release:** prepare alpha ([#36](#36)) ([c5e0f61](c5e0f61)) * **release:** v2.0.0 ([#39](#39)) ([2ecb572](2ecb572)) * update SDK settings ([#21](#21)) ([dd2956f](dd2956f)) --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "2.8.0"
+  ".": "2.9.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 20
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-b20f9fea14d79990ab1af3d276f931e026cd955ac623ec6ace80b2af90de170f.yml
-openapi_spec_hash: 943ff4b3297014503fdc9854544cb9a4
-config_hash: 55c54fdafc9e80be584829b5724b00ab
+configured_endpoints: 21
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-9b1e2a2abf39dd780601935a9a9ee04cb939e2c3ba76627535f625b6aeaf5eb7.yml
+openapi_spec_hash: 12fe5f4306c43fdfb394a33f79391a82
+config_hash: cf04ecfb8dad5fbd8b85be25d6e9ec55
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,41 @@
 # Changelog
 
+## 2.9.0 (2026-03-16)
+
+Full Changelog: [v2.8.0...v2.9.0](https://github.com/browserbase/sdk-node/compare/v2.8.0...v2.9.0)
+
+### Features
+
+* [CORE-1796][apps/api] Update Node.js SDK ([0b1a1ff](https://github.com/browserbase/sdk-node/commit/0b1a1ff40f260ca4994e4a5a82a72d3518985a2f))
+* [GRO-000] docs: Add guide + docs for search api ([a87b397](https://github.com/browserbase/sdk-node/commit/a87b3970711487245762479ea5cc8f488ed3bb86))
+* **api:** api update ([#19](https://github.com/browserbase/sdk-node/issues/19)) ([8df9cc8](https://github.com/browserbase/sdk-node/commit/8df9cc8c76e4a615ba63d4568086bd60e88a0dfb))
+* **api:** update via SDK Studio ([#10](https://github.com/browserbase/sdk-node/issues/10)) ([2c6c15d](https://github.com/browserbase/sdk-node/commit/2c6c15d148d1a5e74a48f92087580d8c590288af))
+* **api:** update via SDK Studio ([#11](https://github.com/browserbase/sdk-node/issues/11)) ([9191ed6](https://github.com/browserbase/sdk-node/commit/9191ed631256b52a39de1aafcf1d7deb2788efdb))
+* **api:** update via SDK Studio ([#12](https://github.com/browserbase/sdk-node/issues/12)) ([ebeaf82](https://github.com/browserbase/sdk-node/commit/ebeaf82736747398450d739e27d6874603c4f942))
+* **api:** update via SDK Studio ([#13](https://github.com/browserbase/sdk-node/issues/13)) ([c0ffdce](https://github.com/browserbase/sdk-node/commit/c0ffdce615059b9523817d22ef18e01e778f3454))
+* **api:** update via SDK Studio ([#16](https://github.com/browserbase/sdk-node/issues/16)) ([a96a86c](https://github.com/browserbase/sdk-node/commit/a96a86c2e7c5025cacd7edd89f88b914de3596e3))
+* **api:** update via SDK Studio ([#17](https://github.com/browserbase/sdk-node/issues/17)) ([52cf741](https://github.com/browserbase/sdk-node/commit/52cf741bc4c5712f2fe15ee6eaa48e4c3643ec58))
+* **api:** update via SDK Studio ([#3](https://github.com/browserbase/sdk-node/issues/3)) ([8a06f81](https://github.com/browserbase/sdk-node/commit/8a06f81c1cd5dc8a64b9fd10ed26f8547469fdeb))
+* **api:** update via SDK Studio ([#4](https://github.com/browserbase/sdk-node/issues/4)) ([cf6309b](https://github.com/browserbase/sdk-node/commit/cf6309bb5de1376139fb0ba6b8e45b5d0801bee5))
+* **api:** update via SDK Studio ([#5](https://github.com/browserbase/sdk-node/issues/5)) ([4275810](https://github.com/browserbase/sdk-node/commit/427581035437844d44333c0e3471db675dff89c7))
+* **api:** update via SDK Studio ([#6](https://github.com/browserbase/sdk-node/issues/6)) ([299d77e](https://github.com/browserbase/sdk-node/commit/299d77ebc0994b0ab39a9c908157d42d605e9765))
+* **api:** update via SDK Studio ([#7](https://github.com/browserbase/sdk-node/issues/7)) ([e1e4738](https://github.com/browserbase/sdk-node/commit/e1e47381dc142f94bd61e7f5819eafbf5b4797a7))
+* **api:** update via SDK Studio ([#8](https://github.com/browserbase/sdk-node/issues/8)) ([2d845ff](https://github.com/browserbase/sdk-node/commit/2d845ffc683ea988980e42ea2c03699034af6980))
+* **api:** update via SDK Studio ([#9](https://github.com/browserbase/sdk-node/issues/9)) ([a17fadc](https://github.com/browserbase/sdk-node/commit/a17fadcac323079f3e36e0c965f6d6c1be26f1d8))
+
+
+### Bug Fixes
+
+* use npm publish instead of yarn publish ([#173](https://github.com/browserbase/sdk-node/issues/173)) ([05b3225](https://github.com/browserbase/sdk-node/commit/05b3225efe94473f2b49988dab63a9e67beb9802))
+
+
+### Chores
+
+* go live ([#1](https://github.com/browserbase/sdk-node/issues/1)) ([bc9e36e](https://github.com/browserbase/sdk-node/commit/bc9e36ec17be8df65bc4bd43bad6ad6617e4973c))
+* **release:** prepare alpha ([#36](https://github.com/browserbase/sdk-node/issues/36)) ([c5e0f61](https://github.com/browserbase/sdk-node/commit/c5e0f61f324c607421449db10cf861a0a5100b4a))
+* **release:** v2.0.0 ([#39](https://github.com/browserbase/sdk-node/issues/39)) ([2ecb572](https://github.com/browserbase/sdk-node/commit/2ecb5720bc6102a3487ecd71f06fd3c548b5f760))
+* update SDK settings ([#21](https://github.com/browserbase/sdk-node/issues/21)) ([dd2956f](https://github.com/browserbase/sdk-node/commit/dd2956f0b22aac232b6ae3cdd572a4d6b688099d))
+
 ## 2.8.0-alpha.1 (2026-03-11)
 
 Full Changelog: [v2.7.0...v2.8.0-alpha.1](https://github.com/browserbase/sdk-node/compare/v2.7.0...v2.8.0-alpha.1)
diff --git a/api.md b/api.md
@@ -49,6 +49,16 @@ Methods:
 - <code title="get /v1/projects">client.projects.<a href="./src/resources/projects.ts">list</a>() -> ProjectListResponse</code>
 - <code title="get /v1/projects/{id}/usage">client.projects.<a href="./src/resources/projects.ts">usage</a>(id) -> ProjectUsage</code>
 
+# Search
+
+Types:
+
+- <code><a href="./src/resources/search.ts">SearchWebResponse</a></code>
+
+Methods:
+
+- <code title="post /v1/search">client.search.<a href="./src/resources/search.ts">web</a>({ ...params }) -> SearchWebResponse</code>
+
 # Sessions
 
 Types:
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/sdk",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "The official Node.js library for the Browserbase API",
   "author": "Browserbase <support@browserbase.com>",
   "types": "dist/index.d.ts",
diff --git a/src/index.ts b/src/index.ts
@@ -15,6 +15,7 @@ import {
 import { Extension, ExtensionCreateParams, Extensions } from './resources/extensions';
 import { FetchAPI, FetchAPICreateParams, FetchAPICreateResponse } from './resources/fetch-api';
 import { Project, ProjectListResponse, ProjectUsage, Projects } from './resources/projects';
+import { Search, SearchWebParams, SearchWebResponse } from './resources/search';
 import {
   Session,
   SessionCreateParams,
@@ -147,6 +148,7 @@ export class Browserbase extends Core.APIClient {
   extensions: API.Extensions = new API.Extensions(this);
   fetchAPI: API.FetchAPI = new API.FetchAPI(this);
   projects: API.Projects = new API.Projects(this);
+  search: API.Search = new API.Search(this);
   sessions: API.Sessions = new API.Sessions(this);
 
   /**
@@ -196,6 +198,7 @@ Browserbase.Contexts = Contexts;
 Browserbase.Extensions = Extensions;
 Browserbase.FetchAPI = FetchAPI;
 Browserbase.Projects = Projects;
+Browserbase.Search = Search;
 Browserbase.Sessions = Sessions;
 
 export declare namespace Browserbase {
@@ -228,6 +231,12 @@ export declare namespace Browserbase {
     type ProjectListResponse as ProjectListResponse,
   };
 
+  export {
+    Search as Search,
+    type SearchWebResponse as SearchWebResponse,
+    type SearchWebParams as SearchWebParams,
+  };
+
   export {
     Sessions as Sessions,
     type Session as Session,
diff --git a/src/resources/fetch-api.ts b/src/resources/fetch-api.ts
@@ -12,9 +12,6 @@ export class FetchAPI extends APIResource {
   }
 }
 
-/**
- * Response body for fetch
- */
 export interface FetchAPICreateResponse {
   /**
    * Unique identifier for the fetch request
diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -10,6 +10,7 @@ export {
 export { Extensions, type Extension, type ExtensionCreateParams } from './extensions';
 export { FetchAPI, type FetchAPICreateResponse, type FetchAPICreateParams } from './fetch-api';
 export { Projects, type Project, type ProjectUsage, type ProjectListResponse } from './projects';
+export { Search, type SearchWebResponse, type SearchWebParams } from './search';
 export {
   Sessions,
   type Session,
diff --git a/src/resources/search.ts b/src/resources/search.ts
@@ -0,0 +1,88 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class Search extends APIResource {
+  /**
+   * Perform a web search and return structured results.
+   */
+  web(body: SearchWebParams, options?: Core.RequestOptions): Core.APIPromise<SearchWebResponse> {
+    return this._client.post('/v1/search', { body, ...options });
+  }
+}
+
+/**
+ * Response body for web search
+ */
+export interface SearchWebResponse {
+  /**
+   * The search query that was executed
+   */
+  query: string;
+
+  /**
+   * Unique identifier for the request
+   */
+  requestId: string;
+
+  /**
+   * List of search results
+   */
+  results: Array<SearchWebResponse.Result>;
+}
+
+export namespace SearchWebResponse {
+  export interface Result {
+    /**
+     * Unique identifier for the result
+     */
+    id: string;
+
+    /**
+     * The title of the search result
+     */
+    title: string;
+
+    /**
+     * The URL of the search result
+     */
+    url: string;
+
+    /**
+     * Author of the content if available
+     */
+    author?: string;
+
+    /**
+     * Favicon URL
+     */
+    favicon?: string;
+
+    /**
+     * Image URL if available
+     */
+    image?: string;
+
+    /**
+     * Publication date in ISO 8601 format
+     */
+    publishedDate?: string;
+  }
+}
+
+export interface SearchWebParams {
+  /**
+   * The search query string
+   */
+  query: string;
+
+  /**
+   * Number of results to return (1-25)
+   */
+  numResults?: number;
+}
+
+export declare namespace Search {
+  export { type SearchWebResponse as SearchWebResponse, type SearchWebParams as SearchWebParams };
+}
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '2.8.0'; // x-release-please-version
+export const VERSION = '2.9.0'; // x-release-please-version
diff --git a/tests/api-resources/search.test.ts b/tests/api-resources/search.test.ts
@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Browserbase from '@browserbasehq/sdk';
+import { Response } from 'node-fetch';
+
+const client = new Browserbase({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource search', () => {
+  test('web: only required params', async () => {
+    const responsePromise = client.search.web({ query: 'x' });
+    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);
+  });
+
+  test('web: required and optional params', async () => {
+    const response = await client.search.web({ query: 'x', numResults: 1 });
+  });
+});

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "2.8.0"`
	`2`	`+ ".": "2.9.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@browserbasehq/sdk",`
`3`		`- "version": "2.8.0",`
	`3`	`+ "version": "2.9.0",`
`4`	`4`	`"description": "The official Node.js library for the Browserbase API",`
`5`	`5`	`"author": "Browserbase <support@browserbase.com>",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -12,9 +12,6 @@ export class FetchAPI extends APIResource {`
`12`	`12`	`}`
`13`	`13`	`}`
`14`	`14`
`15`		`-/**`
`16`		`- * Response body for fetch`
`17`		`- */`
`18`	`15`	`export interface FetchAPICreateResponse {`
`19`	`16`	`/**`
`20`	`17`	`* Unique identifier for the fetch request`