release: 0.26.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.25.0"
+  ".": "0.26.0"
 }

.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: 23
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-e7ac06ada1aa9e0a37a95c1aa5927efe563fc2683c7a144638fa8bd6f68012ac.yml
+openapi_spec_hash: 3ced2367a3f063e4eddce3a3253a4087
+config_hash: 12ef310e24ea5bae135eacbbe1a391ca

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.26.0 (2026-02-17)
+
+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))
+
+
+### Chores
+
+* **internal/client:** fix form-urlencoded requests ([36bfdb4](https://github.com/perplexityai/perplexity-node/commit/36bfdb4f151bc3d20e946f5658679edfe78d7f73))
+
 ## 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)

api.md

@@ -3,18 +3,29 @@
 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>
 - <code><a href="./src/resources/shared.ts">ContextualizedEmbeddingObject</a></code>
 - <code><a href="./src/resources/shared.ts">EmbeddingObject</a></code>
 - <code><a href="./src/resources/shared.ts">EmbeddingsUsage</a></code>
+- <code><a href="./src/resources/shared.ts">ExecuteCodeResponse</a></code>
+- <code><a href="./src/resources/shared.ts">FileEntry</a></code>
 - <code><a href="./src/resources/shared.ts">JsonSchemaFormat</a></code>
+- <code><a href="./src/resources/shared.ts">ListFilesResponse</a></code>
+- <code><a href="./src/resources/shared.ts">ListProcessesResponse</a></code>
+- <code><a href="./src/resources/shared.ts">ModifiedFilesResponse</a></code>
+- <code><a href="./src/resources/shared.ts">PauseSandboxResponse</a></code>
+- <code><a href="./src/resources/shared.ts">ProcessInfo</a></code>
+- <code><a href="./src/resources/shared.ts">ReadFileResponse</a></code>
 - <code><a href="./src/resources/shared.ts">ResponseFormat</a></code>
+- <code><a href="./src/resources/shared.ts">SandboxSessionResponse</a></code>
 - <code><a href="./src/resources/shared.ts">SearchResult</a></code>
 - <code><a href="./src/resources/shared.ts">UsageInfo</a></code>
 - <code><a href="./src/resources/shared.ts">UserLocation</a></code>
 - <code><a href="./src/resources/shared.ts">WebSearchOptions</a></code>
+- <code><a href="./src/resources/shared.ts">WriteFileResponse</a></code>
 
 # Chat
 
@@ -78,6 +89,60 @@ 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>
+
+# Sandbox
+
+## Sessions
+
+Methods:
+
+- <code title="post /v1/sandbox/sessions">client.sandbox.sessions.<a href="./src/resources/sandbox/sessions/sessions.ts">create</a>({ ...params }) -> SandboxSessionResponse</code>
+- <code title="delete /v1/sandbox/sessions/{session_id}">client.sandbox.sessions.<a href="./src/resources/sandbox/sessions/sessions.ts">delete</a>(sessionID) -> void</code>
+- <code title="get /v1/sandbox/sessions/{session_id}">client.sandbox.sessions.<a href="./src/resources/sandbox/sessions/sessions.ts">get</a>(sessionID) -> SandboxSessionResponse</code>
+
+### Execute
+
+Methods:
+
+- <code title="post /v1/sandbox/sessions/{session_id}/execute">client.sandbox.sessions.execute.<a href="./src/resources/sandbox/sessions/execute.ts">create</a>(sessionID, { ...params }) -> ExecuteCodeResponse</code>
+
+### Pause
+
+Methods:
+
+- <code title="post /v1/sandbox/sessions/{session_id}/pause">client.sandbox.sessions.pause.<a href="./src/resources/sandbox/sessions/pause.ts">create</a>(sessionID) -> PauseSandboxResponse</code>
+
+### Resume
+
+Methods:
+
+- <code title="post /v1/sandbox/sessions/{session_id}/resume">client.sandbox.sessions.resume.<a href="./src/resources/sandbox/sessions/resume.ts">create</a>(sessionID, { ...params }) -> SandboxSessionResponse</code>
+
+### Files
+
+Methods:
+
+- <code title="get /v1/sandbox/sessions/{session_id}/files/list">client.sandbox.sessions.files.<a href="./src/resources/sandbox/sessions/files.ts">list</a>(sessionID, { ...params }) -> ListFilesResponse</code>
+- <code title="get /v1/sandbox/sessions/{session_id}/files/modified">client.sandbox.sessions.files.<a href="./src/resources/sandbox/sessions/files.ts">modified</a>(sessionID) -> ModifiedFilesResponse</code>
+- <code title="get /v1/sandbox/sessions/{session_id}/files">client.sandbox.sessions.files.<a href="./src/resources/sandbox/sessions/files.ts">read</a>(sessionID, { ...params }) -> ReadFileResponse</code>
+- <code title="post /v1/sandbox/sessions/{session_id}/files">client.sandbox.sessions.files.<a href="./src/resources/sandbox/sessions/files.ts">write</a>(sessionID, { ...params }) -> WriteFileResponse</code>
+
+### Processes
+
+Methods:
+
+- <code title="get /v1/sandbox/sessions/{session_id}/processes">client.sandbox.sessions.processes.<a href="./src/resources/sandbox/sessions/processes.ts">list</a>(sessionID) -> ListProcessesResponse</code>
+- <code title="delete /v1/sandbox/sessions/{session_id}/processes/{pid}">client.sandbox.sessions.processes.<a href="./src/resources/sandbox/sessions/processes.ts">delete</a>(pid, { ...params }) -> void</code>
+- <code title="get /v1/sandbox/sessions/{session_id}/processes/{pid}">client.sandbox.sessions.processes.<a href="./src/resources/sandbox/sessions/processes.ts">get</a>(pid, { ...params }) -> ProcessInfo</code>
+
 # Async
 
 ## Chat

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",

src/client.ts

@@ -41,7 +41,9 @@ 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 { Sandbox } from './resources/sandbox/sandbox';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -722,6 +724,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 +761,8 @@ 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);
+  sandbox: API.Sandbox = new API.Sandbox(this);
   async: API.Async = new API.Async(this);
 }
 
@@ -759,6 +771,8 @@ Perplexity.Search = Search;
 Perplexity.Responses = Responses;
 Perplexity.Embeddings = Embeddings;
 Perplexity.ContextualizedEmbeddings = ContextualizedEmbeddings;
+Perplexity.Browser = Browser;
+Perplexity.Sandbox = Sandbox;
 Perplexity.Async = Async;
 
 export declare namespace Perplexity {
@@ -802,19 +816,34 @@ export declare namespace Perplexity {
     type ContextualizedEmbeddingCreateParams as ContextualizedEmbeddingCreateParams,
   };
 
+  export { Browser as Browser };
+
+  export { Sandbox as Sandbox };
+
   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;
   export type ContextualizedEmbeddingObject = API.ContextualizedEmbeddingObject;
   export type EmbeddingObject = API.EmbeddingObject;
   export type EmbeddingsUsage = API.EmbeddingsUsage;
+  export type ExecuteCodeResponse = API.ExecuteCodeResponse;
+  export type FileEntry = API.FileEntry;
   export type JsonSchemaFormat = API.JsonSchemaFormat;
+  export type ListFilesResponse = API.ListFilesResponse;
+  export type ListProcessesResponse = API.ListProcessesResponse;
+  export type ModifiedFilesResponse = API.ModifiedFilesResponse;
+  export type PauseSandboxResponse = API.PauseSandboxResponse;
+  export type ProcessInfo = API.ProcessInfo;
+  export type ReadFileResponse = API.ReadFileResponse;
   export type ResponseFormat = API.ResponseFormat;
+  export type SandboxSessionResponse = API.SandboxSessionResponse;
   export type SearchResult = API.SearchResult;
   export type UsageInfo = API.UsageInfo;
   export type UserLocation = API.UserLocation;
   export type WebSearchOptions = API.WebSearchOptions;
+  export type WriteFileResponse = API.WriteFileResponse;
 }

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';

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 };
+}

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';

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 };
+}

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,
@@ -26,4 +27,5 @@ export {
   type ResponseCreateParamsNonStreaming,
   type ResponseCreateParamsStreaming,
 } from './responses';
+export { Sandbox } from './sandbox/sandbox';
 export { Search, type SearchCreateResponse, type SearchCreateParams } from './search';

src/resources/sandbox.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './sandbox/index';

src/resources/sandbox/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Sandbox } from './sandbox';
+export { Sessions, type SessionCreateParams } from './sessions/index';

src/resources/sandbox/sandbox.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/sessions';
+import { SessionCreateParams, Sessions } from './sessions/sessions';
+
+export class Sandbox extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+}
+
+Sandbox.Sessions = Sessions;
+
+export declare namespace Sandbox {
+  export { Sessions as Sessions, type SessionCreateParams as SessionCreateParams };
+}

src/resources/sandbox/sessions.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './sessions/index';

src/resources/sandbox/sessions/execute.ts

@@ -0,0 +1,46 @@
+// 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 { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Execute extends APIResource {
+  /**
+   * Execute Python or Bash code in the sandbox environment.
+   */
+  create(
+    sessionID: string,
+    body: ExecuteCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<Shared.ExecuteCodeResponse> {
+    return this._client.post(path`/v1/sandbox/sessions/${sessionID}/execute`, { body, ...options });
+  }
+}
+
+export interface ExecuteCreateParams {
+  /**
+   * Base64 encoded code to execute
+   */
+  code: string;
+
+  /**
+   * Programming language of the code
+   */
+  language: 'python' | 'bash';
+
+  /**
+   * Run in background (bash only)
+   */
+  background?: boolean;
+
+  /**
+   * Execution timeout in seconds (max 120)
+   */
+  execution_timeout?: number;
+}
+
+export declare namespace Execute {
+  export { type ExecuteCreateParams as ExecuteCreateParams };
+}