Merge pull request #34 from perplexityai/release-please--branches--main--changes--next--components--perplexity_ai

kesku · web-flow · commit 39e847a6d87f · 2026-02-23T18:54:59.000Z
release: 0.26.0
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.25.0"
+  ".": "0.26.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-78325ecc9bdc8e9850866fcdd3be3d209b06f151059c774afc7e6005a1775f09.yml
-openapi_spec_hash: 19a34c8ddd46f81dd0b0850af5ee42f3
-config_hash: 620d4d190431b939dd17ac5d442918e6
+configured_endpoints: 10
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-e5052719572f5155f4cf704d996e5c7a875700a16f68f2335975ea3d06140b17.yml
+openapi_spec_hash: 97d9df5dc228bb6d71be54212bc5b600
+config_hash: e09a1767e929614701fb498eaaac682d
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.26.0 (2026-02-23)
+
+Full Changelog: [v0.25.0...v0.26.0](https://github.com/perplexityai/perplexity-node/compare/v0.25.0...v0.26.0)
+
+### Features
+
+* **api:** Add browser and sandbox API endpoints ([a35f39c](https://github.com/perplexityai/perplexity-node/commit/a35f39c37eddf661d131c9f07a7b4ea25d95ab5d))
+* **api:** manual updates ([bb5e5a8](https://github.com/perplexityai/perplexity-node/commit/bb5e5a8e815f9d3ef3419e5b841ce40430e5df95))
+
+
+### Bug Fixes
+
+* **docs/contributing:** correct pnpm link command ([2976eab](https://github.com/perplexityai/perplexity-node/commit/2976eab295ea08f4743af92a36d96c659ec90e3c))
+
+
+### Chores
+
+* **internal/client:** fix form-urlencoded requests ([36bfdb4](https://github.com/perplexityai/perplexity-node/commit/36bfdb4f151bc3d20e946f5658679edfe78d7f73))
+* **internal:** remove mock server code ([4ea1e20](https://github.com/perplexityai/perplexity-node/commit/4ea1e202b3d5c6fa7bb993c5e4e62b690bdb48f6))
+* update mock server docs ([73990f1](https://github.com/perplexityai/perplexity-node/commit/73990f1119a8240fa06d0985b06ecf7066cc1caf))
+
 ## 0.25.0 (2026-02-12)
 
 Full Changelog: [v0.24.0...v0.25.0](https://github.com/perplexityai/perplexity-node/compare/v0.24.0...v0.25.0)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -60,17 +60,11 @@ $ yarn link @perplexity-ai/perplexity_ai
 # With pnpm
 $ pnpm link --global
 $ cd ../my-package
-$ pnpm link -—global @perplexity-ai/perplexity_ai
+$ pnpm link --global @perplexity-ai/perplexity_ai
 ```
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```sh
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```sh
 $ yarn run test
 ```
diff --git a/api.md b/api.md
@@ -3,6 +3,7 @@
 Types:
 
 - <code><a href="./src/resources/shared.ts">APIPublicSearchResult</a></code>
+- <code><a href="./src/resources/shared.ts">BrowserSessionResponse</a></code>
 - <code><a href="./src/resources/shared.ts">ChatMessageInput</a></code>
 - <code><a href="./src/resources/shared.ts">ChatMessageOutput</a></code>
 - <code><a href="./src/resources/shared.ts">Choice</a></code>
@@ -78,6 +79,15 @@ Methods:
 
 - <code title="post /v1/contextualizedembeddings">client.contextualizedEmbeddings.<a href="./src/resources/contextualized-embeddings.ts">create</a>({ ...params }) -> ContextualizedEmbeddingCreateResponse</code>
 
+# Browser
+
+## Sessions
+
+Methods:
+
+- <code title="post /v1/browser/sessions">client.browser.sessions.<a href="./src/resources/browser/sessions.ts">create</a>() -> BrowserSessionResponse</code>
+- <code title="delete /v1/browser/sessions/{session_id}">client.browser.sessions.<a href="./src/resources/browser/sessions.ts">delete</a>(sessionID) -> void</code>
+
 # Async
 
 ## Chat
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@perplexity-ai/perplexity_ai",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "The official TypeScript library for the Perplexity API",
   "author": "Perplexity <api@perplexity.ai>",
   "types": "dist/index.d.ts",
diff --git a/scripts/mock b/scripts/mock
diff --git a/scripts/test b/scripts/test
@@ -4,53 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-NC='\033[0m' # No Color
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
-}
-
-kill_server_on_port() {
-  pids=$(lsof -t -i tcp:"$1" || echo "")
-  if [ "$pids" != "" ]; then
-    kill "$pids"
-    echo "Stopped $pids."
-  fi
-}
-
-function is_overriding_api_base_url() {
-  [ -n "$TEST_API_BASE_URL" ]
-}
-
-if ! is_overriding_api_base_url && ! prism_is_running ; then
-  # When we exit this script, make sure to kill the background mock server process
-  trap 'kill_server_on_port 4010' EXIT
-
-  # Start the dev server
-  ./scripts/mock --daemon
-fi
-
-if is_overriding_api_base_url ; then
-  echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
-  echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
-  echo -e "running against your OpenAPI spec."
-  echo
-  echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
-  echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
-  echo
-
-  exit 1
-else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
-  echo
-fi
 
 echo "==> Running tests"
 ./node_modules/.bin/jest "$@"
diff --git a/src/client.ts b/src/client.ts
@@ -41,6 +41,7 @@ import {
 } from './resources/responses';
 import { Search, SearchCreateParams, SearchCreateResponse } from './resources/search';
 import { Async } from './resources/async/async';
+import { Browser } from './resources/browser/browser';
 import { Chat, StreamChunk } from './resources/chat/chat';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -722,6 +723,14 @@ export class Perplexity {
         (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))
     ) {
       return { bodyHeaders: undefined, body: Shims.ReadableStreamFrom(body as AsyncIterable<Uint8Array>) };
+    } else if (
+      typeof body === 'object' &&
+      headers.values.get('content-type') === 'application/x-www-form-urlencoded'
+    ) {
+      return {
+        bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
+        body: this.stringifyQuery(body as Record<string, unknown>),
+      };
     } else {
       return this.#encoder({ body, headers });
     }
@@ -751,6 +760,7 @@ export class Perplexity {
   responses: API.Responses = new API.Responses(this);
   embeddings: API.Embeddings = new API.Embeddings(this);
   contextualizedEmbeddings: API.ContextualizedEmbeddings = new API.ContextualizedEmbeddings(this);
+  browser: API.Browser = new API.Browser(this);
   async: API.Async = new API.Async(this);
 }
 
@@ -759,6 +769,7 @@ Perplexity.Search = Search;
 Perplexity.Responses = Responses;
 Perplexity.Embeddings = Embeddings;
 Perplexity.ContextualizedEmbeddings = ContextualizedEmbeddings;
+Perplexity.Browser = Browser;
 Perplexity.Async = Async;
 
 export declare namespace Perplexity {
@@ -802,9 +813,12 @@ export declare namespace Perplexity {
     type ContextualizedEmbeddingCreateParams as ContextualizedEmbeddingCreateParams,
   };
 
+  export { Browser as Browser };
+
   export { Async as Async };
 
   export type APIPublicSearchResult = API.APIPublicSearchResult;
+  export type BrowserSessionResponse = API.BrowserSessionResponse;
   export type ChatMessageInput = API.ChatMessageInput;
   export type ChatMessageOutput = API.ChatMessageOutput;
   export type Choice = API.Choice;
diff --git a/src/resources/browser.ts b/src/resources/browser.ts
@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './browser/index';
diff --git a/src/resources/browser/browser.ts b/src/resources/browser/browser.ts
@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as SessionsAPI from './sessions';
+import { SessionCreateParams, Sessions } from './sessions';
+
+export class Browser extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+}
+
+Browser.Sessions = Sessions;
+
+export declare namespace Browser {
+  export { Sessions as Sessions, type SessionCreateParams as SessionCreateParams };
+}
diff --git a/src/resources/browser/index.ts b/src/resources/browser/index.ts
@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Browser } from './browser';
+export { Sessions, type SessionCreateParams } from './sessions';
diff --git a/src/resources/browser/sessions.ts b/src/resources/browser/sessions.ts
@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+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 Sessions extends APIResource {
+  /**
+   * Create a new remote browser session for CDP-based automation.
+   */
+  create(
+    body?: SessionCreateParams | null | undefined,
+    options?: RequestOptions,
+  ): APIPromise<Shared.BrowserSessionResponse> {
+    return this._client.post('/v1/browser/sessions', { body, ...options });
+  }
+
+  /**
+   * Stop and clean up a remote browser session.
+   */
+  delete(sessionID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/browser/sessions/${sessionID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface SessionCreateParams {}
+
+export declare namespace Sessions {
+  export { type SessionCreateParams as SessionCreateParams };
+}
diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -2,6 +2,7 @@
 
 export * from './shared';
 export { Async } from './async/async';
+export { Browser } from './browser/browser';
 export { Chat, type StreamChunk } from './chat/chat';
 export {
   ContextualizedEmbeddings,
diff --git a/src/resources/shared.ts b/src/resources/shared.ts
@@ -16,6 +16,21 @@ export interface APIPublicSearchResult {
   source?: 'web' | 'attachment';
 }
 
+/**
+ * Response containing browser session details
+ */
+export interface BrowserSessionResponse {
+  /**
+   * Unique identifier for the browser session
+   */
+  session_id?: string;
+
+  /**
+   * Current status of the session
+   */
+  status?: 'running' | 'stopped';
+}
+
 export interface ChatMessageInput {
   content:
     | string
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '0.25.0'; // x-release-please-version
+export const VERSION = '0.26.0'; // x-release-please-version
diff --git a/tests/api-resources/async/chat/completions.test.ts b/tests/api-resources/async/chat/completions.test.ts
@@ -8,7 +8,7 @@ const client = new Perplexity({
 });
 
 describe('resource completions', () => {
-  // Prism tests are disabled
+  // Mock server tests are disabled
   test.skip('create: only required params', async () => {
     const responsePromise = client.async.chat.completions.create({
       request: { messages: [{ content: 'string', role: 'system' }], model: 'model' },
@@ -22,7 +22,7 @@ describe('resource completions', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // Prism tests are disabled
+  // Mock server tests are disabled
   test.skip('create: required and optional params', async () => {
     const response = await client.async.chat.completions.create({
       request: {
@@ -161,7 +161,7 @@ describe('resource completions', () => {
     });
   });
 
-  // Prism tests are disabled
+  // Mock server tests are disabled
   test.skip('list', async () => {
     const responsePromise = client.async.chat.completions.list();
     const rawResponse = await responsePromise.asResponse();
@@ -173,7 +173,7 @@ describe('resource completions', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // Prism tests are disabled
+  // Mock server tests are disabled
   test.skip('get', async () => {
     const responsePromise = client.async.chat.completions.get('api_request');
     const rawResponse = await responsePromise.asResponse();
@@ -185,7 +185,7 @@ describe('resource completions', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // Prism tests are disabled
+  // Mock server tests are disabled
   test.skip('get: request options and params are passed correctly', async () => {
     // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
     await expect(
diff --git a/tests/api-resources/browser/sessions.test.ts b/tests/api-resources/browser/sessions.test.ts
diff --git a/tests/api-resources/chat/completions.test.ts b/tests/api-resources/chat/completions.test.ts
diff --git a/tests/api-resources/contextualized-embeddings.test.ts b/tests/api-resources/contextualized-embeddings.test.ts
diff --git a/tests/api-resources/embeddings.test.ts b/tests/api-resources/embeddings.test.ts
diff --git a/tests/api-resources/responses.test.ts b/tests/api-resources/responses.test.ts
diff --git a/tests/api-resources/search.test.ts b/tests/api-resources/search.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.25.0"`
	`2`	`+ ".": "0.26.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@perplexity-ai/perplexity_ai",`
`3`		`- "version": "0.25.0",`
	`3`	`+ "version": "0.26.0",`
`4`	`4`	`"description": "The official TypeScript library for the Perplexity API",`
`5`	`5`	`"author": "Perplexity <api@perplexity.ai>",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.`
	`2`	`+`
	`3`	`+export * from './browser/index';`