@perplexity-ai/perplexity_ai 0.23.0 → 0.26.0

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

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

package/src/resources/contextualized-embeddings.ts

@@ -0,0 +1,83 @@
+// 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';
+
+export class ContextualizedEmbeddings extends APIResource {
+  /**
+   * Generate contextualized embeddings for document chunks. Chunks from the same
+   * document share context awareness, improving retrieval quality for document-based
+   * applications.
+   */
+  create(
+    body: ContextualizedEmbeddingCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextualizedEmbeddingCreateResponse> {
+    return this._client.post('/v1/contextualizedembeddings', { body, ...options });
+  }
+}
+
+/**
+ * Response body for contextualized embeddings request
+ */
+export interface ContextualizedEmbeddingCreateResponse {
+  /**
+   * List of contextualized embedding objects
+   */
+  data?: Array<Shared.ContextualizedEmbeddingObject>;
+
+  /**
+   * The model used to generate embeddings
+   */
+  model?: string;
+
+  /**
+   * The object type
+   */
+  object?: string;
+
+  /**
+   * Token usage for the embeddings request
+   */
+  usage?: Shared.EmbeddingsUsage;
+}
+
+export interface ContextualizedEmbeddingCreateParams {
+  /**
+   * Nested array structure where each inner array contains chunks from a single
+   * document. Chunks within the same document are encoded with document-level
+   * context awareness. Maximum 512 documents. Total chunks across all documents must
+   * not exceed 16,000. Total tokens per document must not exceed 32K. All chunks in
+   * a single request must not exceed 120,000 tokens combined. Empty strings are not
+   * allowed.
+   */
+  input: Array<Array<string>>;
+
+  /**
+   * The contextualized embedding model to use
+   */
+  model: 'pplx-embed-context-v1-0.6b' | 'pplx-embed-context-v1-4b';
+
+  /**
+   * Number of dimensions for output embeddings (Matryoshka). Range: 128-1024 for
+   * pplx-embed-context-v1-0.6b, 128-2560 for pplx-embed-context-v1-4b. Defaults to
+   * full dimensions (1024 or 2560).
+   */
+  dimensions?: number;
+
+  /**
+   * Output encoding format for embeddings. base64_int8 returns base64-encoded signed
+   * int8 values. base64_binary returns base64-encoded packed binary (1 bit per
+   * dimension).
+   */
+  encoding_format?: 'base64_int8' | 'base64_binary';
+}
+
+export declare namespace ContextualizedEmbeddings {
+  export {
+    type ContextualizedEmbeddingCreateResponse as ContextualizedEmbeddingCreateResponse,
+    type ContextualizedEmbeddingCreateParams as ContextualizedEmbeddingCreateParams,
+  };
+}

package/src/resources/embeddings.ts

@@ -0,0 +1,76 @@
+// 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';
+
+export class Embeddings extends APIResource {
+  /**
+   * Generate embeddings for a list of texts. Use these embeddings for semantic
+   * search, clustering, and other machine learning applications.
+   */
+  create(body: EmbeddingCreateParams, options?: RequestOptions): APIPromise<EmbeddingCreateResponse> {
+    return this._client.post('/v1/embeddings', { body, ...options });
+  }
+}
+
+/**
+ * Response body for embeddings request
+ */
+export interface EmbeddingCreateResponse {
+  /**
+   * List of embedding objects
+   */
+  data?: Array<Shared.EmbeddingObject>;
+
+  /**
+   * The model used to generate embeddings
+   */
+  model?: string;
+
+  /**
+   * The object type
+   */
+  object?: string;
+
+  /**
+   * Token usage for the embeddings request
+   */
+  usage?: Shared.EmbeddingsUsage;
+}
+
+export interface EmbeddingCreateParams {
+  /**
+   * Input text to embed, encoded as a string or array of strings. Maximum 512 texts
+   * per request. Each input must not exceed 32K tokens. All inputs in a single
+   * request must not exceed 120,000 tokens combined. Empty strings are not allowed.
+   */
+  input: string | Array<string>;
+
+  /**
+   * The embedding model to use
+   */
+  model: 'pplx-embed-v1-0.6b' | 'pplx-embed-v1-4b';
+
+  /**
+   * Number of dimensions for output embeddings (Matryoshka). Range: 128-1024 for
+   * pplx-embed-v1-0.6b, 128-2560 for pplx-embed-v1-4b. Defaults to full dimensions
+   * (1024 or 2560).
+   */
+  dimensions?: number;
+
+  /**
+   * Output encoding format for embeddings. base64_int8 returns base64-encoded signed
+   * int8 values. base64_binary returns base64-encoded packed binary (1 bit per
+   * dimension).
+   */
+  encoding_format?: 'base64_int8' | 'base64_binary';
+}
+
+export declare namespace Embeddings {
+  export {
+    type EmbeddingCreateResponse as EmbeddingCreateResponse,
+    type EmbeddingCreateParams as EmbeddingCreateParams,
+  };
+}

package/src/resources/index.ts

@@ -2,7 +2,14 @@
 
 export * from './shared';
 export { Async } from './async/async';
+export { Browser } from './browser/browser';
 export { Chat, type StreamChunk } from './chat/chat';
+export {
+  ContextualizedEmbeddings,
+  type ContextualizedEmbeddingCreateResponse,
+  type ContextualizedEmbeddingCreateParams,
+} from './contextualized-embeddings';
+export { Embeddings, type EmbeddingCreateResponse, type EmbeddingCreateParams } from './embeddings';
 export {
   Responses,
   type Annotation,

package/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
@@ -328,6 +343,90 @@ export interface Choice {
   finish_reason?: 'stop' | 'length' | null;
 }
 
+/**
+ * A single contextualized embedding result
+ */
+export interface ContextualizedEmbeddingObject {
+  /**
+   * List of embedding objects for chunks in this document
+   */
+  data?: Array<EmbeddingObject>;
+
+  /**
+   * The index of the document this chunk belongs to
+   */
+  index?: number;
+
+  /**
+   * The object type
+   */
+  object?: string;
+}
+
+/**
+ * A single embedding result
+ */
+export interface EmbeddingObject {
+  /**
+   * Base64-encoded embedding vector. For base64_int8: decode to signed int8 array
+   * (length = dimensions). For base64_binary: decode to packed bits (length =
+   * dimensions / 8 bytes).
+   */
+  embedding?: string;
+
+  /**
+   * The index of the input text this embedding corresponds to
+   */
+  index?: number;
+
+  /**
+   * The object type
+   */
+  object?: string;
+}
+
+/**
+ * Token usage for the embeddings request
+ */
+export interface EmbeddingsUsage {
+  /**
+   * Cost breakdown for the request
+   */
+  cost?: EmbeddingsUsage.Cost;
+
+  /**
+   * Number of tokens in the input texts
+   */
+  prompt_tokens?: number;
+
+  /**
+   * Total number of tokens processed
+   */
+  total_tokens?: number;
+}
+
+export namespace EmbeddingsUsage {
+  /**
+   * Cost breakdown for the request
+   */
+  export interface Cost {
+    /**
+     * Currency of the cost values
+     */
+    currency?: 'USD';
+
+    /**
+     * Cost for input tokens in USD
+     */
+    input_cost?: number;
+
+    /**
+     * Total cost for the request in USD
+     */
+    total_cost?: number;
+  }
+}
+
 /**
  * Defines a JSON schema for structured output validation
  */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.26.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.26.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.26.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.23.0'; // x-release-please-version
+exports.VERSION = '0.26.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.26.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map