parallel-web 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.0 (2025-10-21)
+
+Full Changelog: [v0.1.2...v0.2.0](https://github.com/parallel-web/parallel-sdk-typescript/compare/v0.1.2...v0.2.0)
+
+### Features
+
+* **api:** Add /v1beta/extract ([a709400](https://github.com/parallel-web/parallel-sdk-typescript/commit/a7094002235d15e4a5f68422b9447127b9448b4b))
+
 ## 0.1.2 (2025-10-07)
 
 Full Changelog: [v0.1.1...v0.1.2](https://github.com/parallel-web/parallel-sdk-typescript/compare/v0.1.1...v0.1.2)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "parallel-web",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "The official TypeScript library for the Parallel API",
   "author": "Parallel <support@parallel.ai>",
   "types": "./index.d.ts",

package/resources/beta/beta.d.mts

@@ -9,10 +9,85 @@ import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Beta extends APIResource {
     taskRun: TaskRunAPI.TaskRun;
     taskGroup: TaskGroupAPI.TaskGroup;
+    /**
+     * Extracts relevant content from specific web URLs.
+     *
+     * To access this endpoint, pass the `parallel-beta` header with the value
+     * `search-extract-2025-10-10`.
+     */
+    extract(params: BetaExtractParams, options?: RequestOptions): APIPromise<ExtractResponse>;
     /**
      * Searches the web.
      */
-    search(body: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult>;
+    search(params: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult>;
+}
+/**
+ * Optional settings for returning relevant excerpts.
+ */
+export interface ExcerptSettings {
+    /**
+     * Optional upper bound on the total number of characters to include across all
+     * excerpts for each url. Excerpts may contain fewer characters than this limit to
+     * maximize relevance and token efficiency.
+     */
+    max_chars_per_result?: number | null;
+}
+/**
+ * Extract error details.
+ */
+export interface ExtractError {
+    /**
+     * Content returned for http client or server errors, if any.
+     */
+    content: string | null;
+    /**
+     * Error type.
+     */
+    error_type: string;
+    /**
+     * HTTP status code, if available.
+     */
+    http_status_code: number | null;
+    url: string;
+}
+/**
+ * Fetch result.
+ */
+export interface ExtractResponse {
+    /**
+     * Extract errors: requested URLs not in the results.
+     */
+    errors: Array<ExtractError>;
+    /**
+     * Extract request ID, e.g. `extract_cad0a6d2dec046bd95ae900527d880e7`
+     */
+    extract_id: string;
+    /**
+     * Successful extract results.
+     */
+    results: Array<ExtractResult>;
+}
+/**
+ * Extract result for a single URL.
+ */
+export interface ExtractResult {
+    /**
+     * Relevant excerpted content from the URL, formatted as markdown.
+     */
+    excerpts: Array<string> | null;
+    /**
+     * Full content from the URL formatted as markdown, if requested.
+     */
+    full_content: string | null;
+    /**
+     * Publish date of the webpage, if available.
+     */
+    publish_date: string | null;
+    /**
+     * Title of the webpage, if available.
+     */
+    title: string | null;
+    url: string;
 }
 /**
  * Output for the Search API.
@@ -44,42 +119,123 @@ export interface WebSearchResult {
      */
     url: string;
 }
+export interface BetaExtractParams {
+    /**
+     * Body param:
+     */
+    urls: Array<string>;
+    /**
+     * Body param: Include excerpts from each URL relevant to the search objective and
+     * queries. Note that if neither objective nor search_queries is provided, excerpts
+     * are redundant with full content.
+     */
+    excerpts?: boolean | ExcerptSettings;
+    /**
+     * Body param: Fetch policy.
+     *
+     * Determines when to return content from the cache (faster) vs fetching live
+     * content (fresher).
+     */
+    fetch_policy?: BetaExtractParams.FetchPolicy | null;
+    /**
+     * Body param: Include full content from each URL. Note that if neither objective
+     * nor search_queries is provided, excerpts are redundant with full content.
+     */
+    full_content?: boolean | BetaExtractParams.FullContentSettings;
+    /**
+     * Body param: If provided, focuses extracted content on the specified search
+     * objective.
+     */
+    objective?: string | null;
+    /**
+     * Body param: If provided, focuses extracted content on the specified keyword
+     * search queries.
+     */
+    search_queries?: Array<string> | null;
+    /**
+     * Header param: Optional header to specify the beta version(s) to enable.
+     */
+    betas?: Array<TaskRunAPI.ParallelBeta>;
+}
+export declare namespace BetaExtractParams {
+    /**
+     * Fetch policy.
+     *
+     * Determines when to return content from the cache (faster) vs fetching live
+     * content (fresher).
+     */
+    interface FetchPolicy {
+        /**
+         * If false, fallback to cached content older than max-age if live fetch fails or
+         * times out. If true, returns an error instead.
+         */
+        disable_cache_fallback?: boolean;
+        /**
+         * Maximum age of cached content in seconds to trigger a live fetch. Minimum value
+         * 600 seconds (10 minutes). If not provided, a dynamic age policy will be used
+         * based on the search objective and url.
+         */
+        max_age_seconds?: number | null;
+        /**
+         * Timeout in seconds for fetching live content if unavailable in cache. If
+         * unspecified a dynamic timeout will be used based on the url, generally 15
+         * seconds for simple pages and up to 60 seconds for complex pages requiring
+         * javascript or PDF rendering.
+         */
+        timeout_seconds?: number | null;
+    }
+    /**
+     * Optional settings for returning full content.
+     */
+    interface FullContentSettings {
+        /**
+         * Optional limit on the number of characters to include in the full content for
+         * each url. Full content always starts at the beginning of the page and is
+         * truncated at the limit if necessary.
+         */
+        max_chars_per_result?: number | null;
+    }
+}
 export interface BetaSearchParams {
     /**
-     * Upper bound on the number of characters to include in excerpts for each search
-     * result.
+     * Body param: Upper bound on the number of characters to include in excerpts for
+     * each search result.
      */
     max_chars_per_result?: number | null;
     /**
-     * Upper bound on the number of results to return. May be limited by the processor.
-     * Defaults to 10 if not provided.
+     * Body param: Upper bound on the number of results to return. May be limited by
+     * the processor. Defaults to 10 if not provided.
      */
     max_results?: number | null;
     /**
-     * Natural-language description of what the web search is trying to find. May
-     * include guidance about preferred sources or freshness. At least one of objective
-     * or search_queries must be provided.
+     * Body param: Natural-language description of what the web search is trying to
+     * find. May include guidance about preferred sources or freshness. At least one of
+     * objective or search_queries must be provided.
      */
     objective?: string | null;
     /**
-     * Search processor.
+     * Body param: Search processor.
      */
-    processor?: 'base' | 'pro';
+    processor?: 'base' | 'pro' | null;
     /**
-     * Optional list of traditional keyword search queries to guide the search. May
-     * contain search operators. At least one of objective or search_queries must be
-     * provided.
+     * Body param: Optional list of traditional keyword search queries to guide the
+     * search. May contain search operators. At least one of objective or
+     * search_queries must be provided.
      */
     search_queries?: Array<string> | null;
     /**
-     * Source policy for web search results.
+     * Body param: Source policy for web search results.
      *
      * This policy governs which sources are allowed/disallowed in results.
      */
     source_policy?: Shared.SourcePolicy | null;
+    /**
+     * Header param: Optional header to specify the beta version(s) to enable.
+     */
+    betas?: Array<TaskRunAPI.ParallelBeta>;
 }
 export declare namespace Beta {
-    export { type SearchResult as SearchResult, type WebSearchResult as WebSearchResult, type BetaSearchParams as BetaSearchParams, };
+    export { type ExcerptSettings as ExcerptSettings, type ExtractError as ExtractError, type ExtractResponse as ExtractResponse, type ExtractResult as ExtractResult, type SearchResult as SearchResult, type WebSearchResult as WebSearchResult, type BetaExtractParams as BetaExtractParams, type BetaSearchParams as BetaSearchParams, };
     export { TaskRun as TaskRun, type BetaRunInput as BetaRunInput, type BetaTaskRunResult as BetaTaskRunResult, type ErrorEvent as ErrorEvent, type McpServer as McpServer, type McpToolCall as McpToolCall, type ParallelBeta as ParallelBeta, type TaskRunEvent as TaskRunEvent, type Webhook as Webhook, type TaskRunEventsResponse as TaskRunEventsResponse, type TaskRunCreateParams as TaskRunCreateParams, type TaskRunResultParams as TaskRunResultParams, };
     export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, };
 }

package/resources/beta/beta.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"beta.d.mts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"beta.d.mts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"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"}

package/resources/beta/beta.d.ts

@@ -9,10 +9,85 @@ import { RequestOptions } from "../../internal/request-options.js";
 export declare class Beta extends APIResource {
     taskRun: TaskRunAPI.TaskRun;
     taskGroup: TaskGroupAPI.TaskGroup;
+    /**
+     * Extracts relevant content from specific web URLs.
+     *
+     * To access this endpoint, pass the `parallel-beta` header with the value
+     * `search-extract-2025-10-10`.
+     */
+    extract(params: BetaExtractParams, options?: RequestOptions): APIPromise<ExtractResponse>;
     /**
      * Searches the web.
      */
-    search(body: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult>;
+    search(params: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult>;
+}
+/**
+ * Optional settings for returning relevant excerpts.
+ */
+export interface ExcerptSettings {
+    /**
+     * Optional upper bound on the total number of characters to include across all
+     * excerpts for each url. Excerpts may contain fewer characters than this limit to
+     * maximize relevance and token efficiency.
+     */
+    max_chars_per_result?: number | null;
+}
+/**
+ * Extract error details.
+ */
+export interface ExtractError {
+    /**
+     * Content returned for http client or server errors, if any.
+     */
+    content: string | null;
+    /**
+     * Error type.
+     */
+    error_type: string;
+    /**
+     * HTTP status code, if available.
+     */
+    http_status_code: number | null;
+    url: string;
+}
+/**
+ * Fetch result.
+ */
+export interface ExtractResponse {
+    /**
+     * Extract errors: requested URLs not in the results.
+     */
+    errors: Array<ExtractError>;
+    /**
+     * Extract request ID, e.g. `extract_cad0a6d2dec046bd95ae900527d880e7`
+     */
+    extract_id: string;
+    /**
+     * Successful extract results.
+     */
+    results: Array<ExtractResult>;
+}
+/**
+ * Extract result for a single URL.
+ */
+export interface ExtractResult {
+    /**
+     * Relevant excerpted content from the URL, formatted as markdown.
+     */
+    excerpts: Array<string> | null;
+    /**
+     * Full content from the URL formatted as markdown, if requested.
+     */
+    full_content: string | null;
+    /**
+     * Publish date of the webpage, if available.
+     */
+    publish_date: string | null;
+    /**
+     * Title of the webpage, if available.
+     */
+    title: string | null;
+    url: string;
 }
 /**
  * Output for the Search API.
@@ -44,42 +119,123 @@ export interface WebSearchResult {
      */
     url: string;
 }
+export interface BetaExtractParams {
+    /**
+     * Body param:
+     */
+    urls: Array<string>;
+    /**
+     * Body param: Include excerpts from each URL relevant to the search objective and
+     * queries. Note that if neither objective nor search_queries is provided, excerpts
+     * are redundant with full content.
+     */
+    excerpts?: boolean | ExcerptSettings;
+    /**
+     * Body param: Fetch policy.
+     *
+     * Determines when to return content from the cache (faster) vs fetching live
+     * content (fresher).
+     */
+    fetch_policy?: BetaExtractParams.FetchPolicy | null;
+    /**
+     * Body param: Include full content from each URL. Note that if neither objective
+     * nor search_queries is provided, excerpts are redundant with full content.
+     */
+    full_content?: boolean | BetaExtractParams.FullContentSettings;
+    /**
+     * Body param: If provided, focuses extracted content on the specified search
+     * objective.
+     */
+    objective?: string | null;
+    /**
+     * Body param: If provided, focuses extracted content on the specified keyword
+     * search queries.
+     */
+    search_queries?: Array<string> | null;
+    /**
+     * Header param: Optional header to specify the beta version(s) to enable.
+     */
+    betas?: Array<TaskRunAPI.ParallelBeta>;
+}
+export declare namespace BetaExtractParams {
+    /**
+     * Fetch policy.
+     *
+     * Determines when to return content from the cache (faster) vs fetching live
+     * content (fresher).
+     */
+    interface FetchPolicy {
+        /**
+         * If false, fallback to cached content older than max-age if live fetch fails or
+         * times out. If true, returns an error instead.
+         */
+        disable_cache_fallback?: boolean;
+        /**
+         * Maximum age of cached content in seconds to trigger a live fetch. Minimum value
+         * 600 seconds (10 minutes). If not provided, a dynamic age policy will be used
+         * based on the search objective and url.
+         */
+        max_age_seconds?: number | null;
+        /**
+         * Timeout in seconds for fetching live content if unavailable in cache. If
+         * unspecified a dynamic timeout will be used based on the url, generally 15
+         * seconds for simple pages and up to 60 seconds for complex pages requiring
+         * javascript or PDF rendering.
+         */
+        timeout_seconds?: number | null;
+    }
+    /**
+     * Optional settings for returning full content.
+     */
+    interface FullContentSettings {
+        /**
+         * Optional limit on the number of characters to include in the full content for
+         * each url. Full content always starts at the beginning of the page and is
+         * truncated at the limit if necessary.
+         */
+        max_chars_per_result?: number | null;
+    }
+}
 export interface BetaSearchParams {
     /**
-     * Upper bound on the number of characters to include in excerpts for each search
-     * result.
+     * Body param: Upper bound on the number of characters to include in excerpts for
+     * each search result.
      */
     max_chars_per_result?: number | null;
     /**
-     * Upper bound on the number of results to return. May be limited by the processor.
-     * Defaults to 10 if not provided.
+     * Body param: Upper bound on the number of results to return. May be limited by
+     * the processor. Defaults to 10 if not provided.
      */
     max_results?: number | null;
     /**
-     * Natural-language description of what the web search is trying to find. May
-     * include guidance about preferred sources or freshness. At least one of objective
-     * or search_queries must be provided.
+     * Body param: Natural-language description of what the web search is trying to
+     * find. May include guidance about preferred sources or freshness. At least one of
+     * objective or search_queries must be provided.
      */
     objective?: string | null;
     /**
-     * Search processor.
+     * Body param: Search processor.
      */
-    processor?: 'base' | 'pro';
+    processor?: 'base' | 'pro' | null;
     /**
-     * Optional list of traditional keyword search queries to guide the search. May
-     * contain search operators. At least one of objective or search_queries must be
-     * provided.
+     * Body param: Optional list of traditional keyword search queries to guide the
+     * search. May contain search operators. At least one of objective or
+     * search_queries must be provided.
      */
     search_queries?: Array<string> | null;
     /**
-     * Source policy for web search results.
+     * Body param: Source policy for web search results.
      *
      * This policy governs which sources are allowed/disallowed in results.
      */
     source_policy?: Shared.SourcePolicy | null;
+    /**
+     * Header param: Optional header to specify the beta version(s) to enable.
+     */
+    betas?: Array<TaskRunAPI.ParallelBeta>;
 }
 export declare namespace Beta {
-    export { type SearchResult as SearchResult, type WebSearchResult as WebSearchResult, type BetaSearchParams as BetaSearchParams, };
+    export { type ExcerptSettings as ExcerptSettings, type ExtractError as ExtractError, type ExtractResponse as ExtractResponse, type ExtractResult as ExtractResult, type SearchResult as SearchResult, type WebSearchResult as WebSearchResult, type BetaExtractParams as BetaExtractParams, type BetaSearchParams as BetaSearchParams, };
     export { TaskRun as TaskRun, type BetaRunInput as BetaRunInput, type BetaTaskRunResult as BetaTaskRunResult, type ErrorEvent as ErrorEvent, type McpServer as McpServer, type McpToolCall as McpToolCall, type ParallelBeta as ParallelBeta, type TaskRunEvent as TaskRunEvent, type Webhook as Webhook, type TaskRunEventsResponse as TaskRunEventsResponse, type TaskRunCreateParams as TaskRunCreateParams, type TaskRunResultParams as TaskRunResultParams, };
     export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, };
 }

package/resources/beta/beta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"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"}

package/resources/beta/beta.js

@@ -7,17 +7,43 @@ const resource_1 = require("../../core/resource.js");
 const TaskGroupAPI = tslib_1.__importStar(require("./task-group.js"));
 const TaskRunAPI = tslib_1.__importStar(require("./task-run.js"));
 const task_run_1 = require("./task-run.js");
+const headers_1 = require("../../internal/headers.js");
 class Beta extends resource_1.APIResource {
     constructor() {
         super(...arguments);
         this.taskRun = new TaskRunAPI.TaskRun(this._client);
         this.taskGroup = new TaskGroupAPI.TaskGroup(this._client);
     }
+    /**
+     * Extracts relevant content from specific web URLs.
+     *
+     * To access this endpoint, pass the `parallel-beta` header with the value
+     * `search-extract-2025-10-10`.
+     */
+    extract(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1beta/extract', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
     /**
      * Searches the web.
      */
-    search(body, options) {
-        return this._client.post('/v1beta/search', { body, ...options });
+    search(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1beta/search', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
     }
 }
 exports.Beta = Beta;

package/resources/beta/beta.js.map

@@ -1 +1 @@
-{"version":3,"file":"beta.js","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,sEAA6C;AAY7C,kEAAyC;AACzC,4CAaoB;AAIpB,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAQ/E,CAAC;IANC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAVD,oBAUC;AA6ED,IAAI,CAAC,OAAO,GAAG,kBAAO,CAAC"}
+{"version":3,"file":"beta.js","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,sEAA6C;AAY7C,kEAAyC;AACzC,4CAaoB;AAEpB,uDAAsD;AAGtD,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkC/E,CAAC;IAhCC;;;;;OAKG;IACH,OAAO,CAAC,MAAyB,EAAE,OAAwB;QACzD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACvF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAwB,EAAE,OAAwB;QACvD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACzC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACvF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AApCD,oBAoCC;AA2PD,IAAI,CAAC,OAAO,GAAG,kBAAO,CAAC"}

package/resources/beta/beta.mjs

@@ -3,17 +3,43 @@ import { APIResource } from "../../core/resource.mjs";
 import * as TaskGroupAPI from "./task-group.mjs";
 import * as TaskRunAPI from "./task-run.mjs";
 import { TaskRun, } from "./task-run.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
 export class Beta extends APIResource {
     constructor() {
         super(...arguments);
         this.taskRun = new TaskRunAPI.TaskRun(this._client);
         this.taskGroup = new TaskGroupAPI.TaskGroup(this._client);
     }
+    /**
+     * Extracts relevant content from specific web URLs.
+     *
+     * To access this endpoint, pass the `parallel-beta` header with the value
+     * `search-extract-2025-10-10`.
+     */
+    extract(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1beta/extract', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
     /**
      * Searches the web.
      */
-    search(body, options) {
-        return this._client.post('/v1beta/search', { body, ...options });
+    search(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1beta/search', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
     }
 }
 Beta.TaskRun = TaskRun;

package/resources/beta/beta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"beta.mjs","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,YAAY;OAYjB,KAAK,UAAU;OACf,EAOL,OAAO,GAMR;AAID,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAQ/E,CAAC;IANC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AA6ED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"beta.mjs","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,YAAY;OAYjB,KAAK,UAAU;OACf,EAOL,OAAO,GAMR;OAEM,EAAE,YAAY,EAAE;AAGvB,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkC/E,CAAC;IAhCC;;;;;OAKG;IACH,OAAO,CAAC,MAAyB,EAAE,OAAwB;QACzD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACvF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAwB,EAAE,OAAwB;QACvD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACzC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACvF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA2PD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC"}

package/src/resources/beta/beta.ts

@@ -30,20 +30,128 @@ import {
   Webhook,
 } from './task-run';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 
 export class Beta extends APIResource {
   taskRun: TaskRunAPI.TaskRun = new TaskRunAPI.TaskRun(this._client);
   taskGroup: TaskGroupAPI.TaskGroup = new TaskGroupAPI.TaskGroup(this._client);
 
+  /**
+   * Extracts relevant content from specific web URLs.
+   *
+   * To access this endpoint, pass the `parallel-beta` header with the value
+   * `search-extract-2025-10-10`.
+   */
+  extract(params: BetaExtractParams, options?: RequestOptions): APIPromise<ExtractResponse> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1beta/extract', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Searches the web.
    */
-  search(body: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult> {
-    return this._client.post('/v1beta/search', { body, ...options });
+  search(params: BetaSearchParams, options?: RequestOptions): APIPromise<SearchResult> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1beta/search', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(betas?.toString() != null ? { 'parallel-beta': betas?.toString() } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 }
 
+/**
+ * Optional settings for returning relevant excerpts.
+ */
+export interface ExcerptSettings {
+  /**
+   * Optional upper bound on the total number of characters to include across all
+   * excerpts for each url. Excerpts may contain fewer characters than this limit to
+   * maximize relevance and token efficiency.
+   */
+  max_chars_per_result?: number | null;
+}
+
+/**
+ * Extract error details.
+ */
+export interface ExtractError {
+  /**
+   * Content returned for http client or server errors, if any.
+   */
+  content: string | null;
+
+  /**
+   * Error type.
+   */
+  error_type: string;
+
+  /**
+   * HTTP status code, if available.
+   */
+  http_status_code: number | null;
+
+  url: string;
+}
+
+/**
+ * Fetch result.
+ */
+export interface ExtractResponse {
+  /**
+   * Extract errors: requested URLs not in the results.
+   */
+  errors: Array<ExtractError>;
+
+  /**
+   * Extract request ID, e.g. `extract_cad0a6d2dec046bd95ae900527d880e7`
+   */
+  extract_id: string;
+
+  /**
+   * Successful extract results.
+   */
+  results: Array<ExtractResult>;
+}
+
+/**
+ * Extract result for a single URL.
+ */
+export interface ExtractResult {
+  /**
+   * Relevant excerpted content from the URL, formatted as markdown.
+   */
+  excerpts: Array<string> | null;
+
+  /**
+   * Full content from the URL formatted as markdown, if requested.
+   */
+  full_content: string | null;
+
+  /**
+   * Publish date of the webpage, if available.
+   */
+  publish_date: string | null;
+
+  /**
+   * Title of the webpage, if available.
+   */
+  title: string | null;
+
+  url: string;
+}
+
 /**
  * Output for the Search API.
  */
@@ -79,52 +187,150 @@ export interface WebSearchResult {
   url: string;
 }
 
+export interface BetaExtractParams {
+  /**
+   * Body param:
+   */
+  urls: Array<string>;
+
+  /**
+   * Body param: Include excerpts from each URL relevant to the search objective and
+   * queries. Note that if neither objective nor search_queries is provided, excerpts
+   * are redundant with full content.
+   */
+  excerpts?: boolean | ExcerptSettings;
+
+  /**
+   * Body param: Fetch policy.
+   *
+   * Determines when to return content from the cache (faster) vs fetching live
+   * content (fresher).
+   */
+  fetch_policy?: BetaExtractParams.FetchPolicy | null;
+
+  /**
+   * Body param: Include full content from each URL. Note that if neither objective
+   * nor search_queries is provided, excerpts are redundant with full content.
+   */
+  full_content?: boolean | BetaExtractParams.FullContentSettings;
+
+  /**
+   * Body param: If provided, focuses extracted content on the specified search
+   * objective.
+   */
+  objective?: string | null;
+
+  /**
+   * Body param: If provided, focuses extracted content on the specified keyword
+   * search queries.
+   */
+  search_queries?: Array<string> | null;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) to enable.
+   */
+  betas?: Array<TaskRunAPI.ParallelBeta>;
+}
+
+export namespace BetaExtractParams {
+  /**
+   * Fetch policy.
+   *
+   * Determines when to return content from the cache (faster) vs fetching live
+   * content (fresher).
+   */
+  export interface FetchPolicy {
+    /**
+     * If false, fallback to cached content older than max-age if live fetch fails or
+     * times out. If true, returns an error instead.
+     */
+    disable_cache_fallback?: boolean;
+
+    /**
+     * Maximum age of cached content in seconds to trigger a live fetch. Minimum value
+     * 600 seconds (10 minutes). If not provided, a dynamic age policy will be used
+     * based on the search objective and url.
+     */
+    max_age_seconds?: number | null;
+
+    /**
+     * Timeout in seconds for fetching live content if unavailable in cache. If
+     * unspecified a dynamic timeout will be used based on the url, generally 15
+     * seconds for simple pages and up to 60 seconds for complex pages requiring
+     * javascript or PDF rendering.
+     */
+    timeout_seconds?: number | null;
+  }
+
+  /**
+   * Optional settings for returning full content.
+   */
+  export interface FullContentSettings {
+    /**
+     * Optional limit on the number of characters to include in the full content for
+     * each url. Full content always starts at the beginning of the page and is
+     * truncated at the limit if necessary.
+     */
+    max_chars_per_result?: number | null;
+  }
+}
+
 export interface BetaSearchParams {
   /**
-   * Upper bound on the number of characters to include in excerpts for each search
-   * result.
+   * Body param: Upper bound on the number of characters to include in excerpts for
+   * each search result.
    */
   max_chars_per_result?: number | null;
 
   /**
-   * Upper bound on the number of results to return. May be limited by the processor.
-   * Defaults to 10 if not provided.
+   * Body param: Upper bound on the number of results to return. May be limited by
+   * the processor. Defaults to 10 if not provided.
    */
   max_results?: number | null;
 
   /**
-   * Natural-language description of what the web search is trying to find. May
-   * include guidance about preferred sources or freshness. At least one of objective
-   * or search_queries must be provided.
+   * Body param: Natural-language description of what the web search is trying to
+   * find. May include guidance about preferred sources or freshness. At least one of
+   * objective or search_queries must be provided.
    */
   objective?: string | null;
 
   /**
-   * Search processor.
+   * Body param: Search processor.
    */
-  processor?: 'base' | 'pro';
+  processor?: 'base' | 'pro' | null;
 
   /**
-   * Optional list of traditional keyword search queries to guide the search. May
-   * contain search operators. At least one of objective or search_queries must be
-   * provided.
+   * Body param: Optional list of traditional keyword search queries to guide the
+   * search. May contain search operators. At least one of objective or
+   * search_queries must be provided.
    */
   search_queries?: Array<string> | null;
 
   /**
-   * Source policy for web search results.
+   * Body param: Source policy for web search results.
    *
    * This policy governs which sources are allowed/disallowed in results.
    */
   source_policy?: Shared.SourcePolicy | null;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) to enable.
+   */
+  betas?: Array<TaskRunAPI.ParallelBeta>;
 }
 
 Beta.TaskRun = TaskRun;
 
 export declare namespace Beta {
   export {
+    type ExcerptSettings as ExcerptSettings,
+    type ExtractError as ExtractError,
+    type ExtractResponse as ExtractResponse,
+    type ExtractResult as ExtractResult,
     type SearchResult as SearchResult,
     type WebSearchResult as WebSearchResult,
+    type BetaExtractParams as BetaExtractParams,
     type BetaSearchParams as BetaSearchParams,
   };
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.2'; // x-release-please-version
+export const VERSION = '0.2.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.2";
+export declare const VERSION = "0.2.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.1.2'; // x-release-please-version
+exports.VERSION = '0.2.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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