@mendable/firecrawl 4.12.1 → 4.13.1

package/dist/{chunk-GAAHPN3I.js → chunk-37UG5UXZ.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.12.1",
+      version: "4.13.1",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -71,7 +71,8 @@ var require_package = __commonJS({
       },
       pnpm: {
         overrides: {
-          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1"
+          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1",
+          "minimatch@<10.2.1": ">=10.2.1"
         }
       }
     };

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.12.1",
+      version: "4.13.1",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -98,7 +98,8 @@ var require_package = __commonJS({
       },
       pnpm: {
         overrides: {
-          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1"
+          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1",
+          "minimatch@<10.2.1": ">=10.2.1"
         }
       }
     };
@@ -928,6 +929,64 @@ async function cancelAgent(http, jobId) {
   }
 }
 
+// src/v2/methods/browser.ts
+async function browser(http, args = {}) {
+  const body = {};
+  if (args.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+  try {
+    const res = await http.post("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+async function browserExecute(http, sessionId, args) {
+  const body = {
+    code: args.code,
+    language: args.language ?? "bash"
+  };
+  if (args.timeout != null) body.timeout = args.timeout;
+  try {
+    const res = await http.post(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+async function deleteBrowser(http, sessionId) {
+  try {
+    const res = await http.delete(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+async function listBrowsers(http, args = {}) {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+  try {
+    const res = await http.get(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}
+
 // src/v2/methods/usage.ts
 async function getConcurrency(http) {
   try {
@@ -1370,6 +1429,8 @@ var FirecrawlClient = class {
    * Start an extract job (async).
    * @param args Extraction request (urls, schema or prompt, flags).
    * @returns Job id or processing state.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async startExtract(args) {
     return startExtract(this.http, args);
@@ -1377,6 +1438,8 @@ var FirecrawlClient = class {
   /**
    * Get extract job status/data.
    * @param jobId Extract job id.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId) {
     return getExtractStatus(this.http, jobId);
@@ -1385,6 +1448,8 @@ var FirecrawlClient = class {
    * Convenience waiter: start an extract and poll until it finishes.
    * @param args Extraction request plus waiter controls (pollInterval, timeout seconds).
    * @returns Final extract response.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract(args) {
     return extract(this.http, args);
@@ -1421,6 +1486,39 @@ var FirecrawlClient = class {
   async cancelAgent(jobId) {
     return cancelAgent(this.http, jobId);
   }
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
+   */
+  async browser(args = {}) {
+    return browser(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
+   */
+  async browserExecute(sessionId, args) {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId) {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(args = {}) {
+    return listBrowsers(this.http, args);
+  }
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {
@@ -2031,10 +2129,11 @@ var FirecrawlApp = class {
   }
   /**
    * Extracts information from URLs using the Firecrawl API.
-   * Currently in Beta. Expect breaking changes on future minor versions.
    * @param urls - The URLs to extract information from. Optional if using other methods for data extraction.
    * @param params - Additional parameters for the extract request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract(urls, params) {
     const headers = this.prepareHeaders();
@@ -2086,6 +2185,8 @@ var FirecrawlApp = class {
    * @param params - Additional parameters for the extract request.
    * @param idempotencyKey - Optional idempotency key for the request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async asyncExtract(urls, params, idempotencyKey) {
     const headers = this.prepareHeaders(idempotencyKey);
@@ -2111,6 +2212,8 @@ var FirecrawlApp = class {
    * Retrieves the status of an extract job.
    * @param jobId - The ID of the extract job.
    * @returns The status of the extract job.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId) {
     try {

package/dist/index.d.cts

@@ -554,6 +554,43 @@ interface QueueStatusResponse$1 {
     maxConcurrency: number;
     mostRecentSuccess: string | null;
 }
+interface BrowserCreateResponse {
+    success: boolean;
+    id?: string;
+    cdpUrl?: string;
+    liveViewUrl?: string;
+    expiresAt?: string;
+    error?: string;
+}
+interface BrowserExecuteResponse {
+    success: boolean;
+    stdout?: string;
+    result?: string;
+    stderr?: string;
+    exitCode?: number;
+    killed?: boolean;
+    error?: string;
+}
+interface BrowserDeleteResponse {
+    success: boolean;
+    sessionDurationMs?: number;
+    creditsBilled?: number;
+    error?: string;
+}
+interface BrowserSession {
+    id: string;
+    status: string;
+    cdpUrl: string;
+    liveViewUrl: string;
+    streamWebView: boolean;
+    createdAt: string;
+    lastActivity: string;
+}
+interface BrowserListResponse {
+    success: boolean;
+    sessions?: BrowserSession[];
+    error?: string;
+}
 
 interface HttpClientOptions {
     apiKey: string;
@@ -592,6 +629,10 @@ declare function prepareExtractPayload(args: {
     integration?: string;
     agent?: AgentOptions$1;
 }): Record<string, unknown>;
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 declare function startExtract(http: HttpClient, args: Parameters<typeof prepareExtractPayload>[0]): Promise<ExtractResponse$1>;
 
 declare function prepareAgentPayload(args: {
@@ -606,6 +647,20 @@ declare function prepareAgentPayload(args: {
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
+declare function browser(http: HttpClient, args?: {
+    ttl?: number;
+    activityTtl?: number;
+    streamWebView?: boolean;
+}): Promise<BrowserCreateResponse>;
+declare function browserExecute(http: HttpClient, sessionId: string, args: {
+    code: string;
+    language?: "python" | "node" | "bash";
+    timeout?: number;
+}): Promise<BrowserExecuteResponse>;
+declare function listBrowsers(http: HttpClient, args?: {
+    status?: "active" | "destroyed";
+}): Promise<BrowserListResponse>;
+
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
@@ -769,17 +824,23 @@ declare class FirecrawlClient {
      * Start an extract job (async).
      * @param args Extraction request (urls, schema or prompt, flags).
      * @returns Job id or processing state.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     startExtract(args: Parameters<typeof startExtract>[1]): Promise<ExtractResponse$1>;
     /**
      * Get extract job status/data.
      * @param jobId Extract job id.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     getExtractStatus(jobId: string): Promise<ExtractResponse$1>;
     /**
      * Convenience waiter: start an extract and poll until it finishes.
      * @param args Extraction request plus waiter controls (pollInterval, timeout seconds).
      * @returns Final extract response.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     extract(args: Parameters<typeof startExtract>[1] & {
         pollInterval?: number;
@@ -811,6 +872,30 @@ declare class FirecrawlClient {
      * @returns True if cancelled.
      */
     cancelAgent(jobId: string): Promise<boolean>;
+    /**
+     * Create a new browser session.
+     * @param args Session options (ttl, activityTtl, streamWebView).
+     * @returns Session id, CDP URL, live view URL, and expiration time.
+     */
+    browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
+    /**
+     * Execute code in a browser session.
+     * @param sessionId Browser session id.
+     * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+     * @returns Execution result including stdout, stderr, exitCode, and killed status.
+     */
+    browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
+    /**
+     * Delete a browser session.
+     * @param sessionId Browser session id.
+     */
+    deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse>;
+    /**
+     * List browser sessions.
+     * @param args Optional filter (status: "active" | "destroyed").
+     * @returns List of browser sessions.
+     */
+    listBrowsers(args?: Parameters<typeof listBrowsers>[1]): Promise<BrowserListResponse>;
     /** Current concurrency usage. */
     getConcurrency(): Promise<ConcurrencyCheck>;
     /** Current credit usage. */
@@ -1524,10 +1609,11 @@ declare class FirecrawlApp {
     checkBatchScrapeErrors(id: string): Promise<CrawlErrorsResponse | ErrorResponse>;
     /**
      * Extracts information from URLs using the Firecrawl API.
-     * Currently in Beta. Expect breaking changes on future minor versions.
      * @param urls - The URLs to extract information from. Optional if using other methods for data extraction.
      * @param params - Additional parameters for the extract request.
      * @returns The response from the extract operation.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     extract<T extends zt.ZodSchema = any>(urls?: string[], params?: ExtractParams<T>): Promise<ExtractResponse<zt.infer<T>> | ErrorResponse>;
     /**
@@ -1536,12 +1622,16 @@ declare class FirecrawlApp {
      * @param params - Additional parameters for the extract request.
      * @param idempotencyKey - Optional idempotency key for the request.
      * @returns The response from the extract operation.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     asyncExtract(urls: string[], params?: ExtractParams, idempotencyKey?: string): Promise<ExtractResponse | ErrorResponse>;
     /**
      * Retrieves the status of an extract job.
      * @param jobId - The ID of the extract job.
      * @returns The status of the extract job.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     getExtractStatus(jobId: string): Promise<any>;
     /**
@@ -1736,4 +1826,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -554,6 +554,43 @@ interface QueueStatusResponse$1 {
     maxConcurrency: number;
     mostRecentSuccess: string | null;
 }
+interface BrowserCreateResponse {
+    success: boolean;
+    id?: string;
+    cdpUrl?: string;
+    liveViewUrl?: string;
+    expiresAt?: string;
+    error?: string;
+}
+interface BrowserExecuteResponse {
+    success: boolean;
+    stdout?: string;
+    result?: string;
+    stderr?: string;
+    exitCode?: number;
+    killed?: boolean;
+    error?: string;
+}
+interface BrowserDeleteResponse {
+    success: boolean;
+    sessionDurationMs?: number;
+    creditsBilled?: number;
+    error?: string;
+}
+interface BrowserSession {
+    id: string;
+    status: string;
+    cdpUrl: string;
+    liveViewUrl: string;
+    streamWebView: boolean;
+    createdAt: string;
+    lastActivity: string;
+}
+interface BrowserListResponse {
+    success: boolean;
+    sessions?: BrowserSession[];
+    error?: string;
+}
 
 interface HttpClientOptions {
     apiKey: string;
@@ -592,6 +629,10 @@ declare function prepareExtractPayload(args: {
     integration?: string;
     agent?: AgentOptions$1;
 }): Record<string, unknown>;
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 declare function startExtract(http: HttpClient, args: Parameters<typeof prepareExtractPayload>[0]): Promise<ExtractResponse$1>;
 
 declare function prepareAgentPayload(args: {
@@ -606,6 +647,20 @@ declare function prepareAgentPayload(args: {
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
+declare function browser(http: HttpClient, args?: {
+    ttl?: number;
+    activityTtl?: number;
+    streamWebView?: boolean;
+}): Promise<BrowserCreateResponse>;
+declare function browserExecute(http: HttpClient, sessionId: string, args: {
+    code: string;
+    language?: "python" | "node" | "bash";
+    timeout?: number;
+}): Promise<BrowserExecuteResponse>;
+declare function listBrowsers(http: HttpClient, args?: {
+    status?: "active" | "destroyed";
+}): Promise<BrowserListResponse>;
+
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
@@ -769,17 +824,23 @@ declare class FirecrawlClient {
      * Start an extract job (async).
      * @param args Extraction request (urls, schema or prompt, flags).
      * @returns Job id or processing state.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     startExtract(args: Parameters<typeof startExtract>[1]): Promise<ExtractResponse$1>;
     /**
      * Get extract job status/data.
      * @param jobId Extract job id.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     getExtractStatus(jobId: string): Promise<ExtractResponse$1>;
     /**
      * Convenience waiter: start an extract and poll until it finishes.
      * @param args Extraction request plus waiter controls (pollInterval, timeout seconds).
      * @returns Final extract response.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     extract(args: Parameters<typeof startExtract>[1] & {
         pollInterval?: number;
@@ -811,6 +872,30 @@ declare class FirecrawlClient {
      * @returns True if cancelled.
      */
     cancelAgent(jobId: string): Promise<boolean>;
+    /**
+     * Create a new browser session.
+     * @param args Session options (ttl, activityTtl, streamWebView).
+     * @returns Session id, CDP URL, live view URL, and expiration time.
+     */
+    browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
+    /**
+     * Execute code in a browser session.
+     * @param sessionId Browser session id.
+     * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+     * @returns Execution result including stdout, stderr, exitCode, and killed status.
+     */
+    browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
+    /**
+     * Delete a browser session.
+     * @param sessionId Browser session id.
+     */
+    deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse>;
+    /**
+     * List browser sessions.
+     * @param args Optional filter (status: "active" | "destroyed").
+     * @returns List of browser sessions.
+     */
+    listBrowsers(args?: Parameters<typeof listBrowsers>[1]): Promise<BrowserListResponse>;
     /** Current concurrency usage. */
     getConcurrency(): Promise<ConcurrencyCheck>;
     /** Current credit usage. */
@@ -1524,10 +1609,11 @@ declare class FirecrawlApp {
     checkBatchScrapeErrors(id: string): Promise<CrawlErrorsResponse | ErrorResponse>;
     /**
      * Extracts information from URLs using the Firecrawl API.
-     * Currently in Beta. Expect breaking changes on future minor versions.
      * @param urls - The URLs to extract information from. Optional if using other methods for data extraction.
      * @param params - Additional parameters for the extract request.
      * @returns The response from the extract operation.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     extract<T extends zt.ZodSchema = any>(urls?: string[], params?: ExtractParams<T>): Promise<ExtractResponse<zt.infer<T>> | ErrorResponse>;
     /**
@@ -1536,12 +1622,16 @@ declare class FirecrawlApp {
      * @param params - Additional parameters for the extract request.
      * @param idempotencyKey - Optional idempotency key for the request.
      * @returns The response from the extract operation.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     asyncExtract(urls: string[], params?: ExtractParams, idempotencyKey?: string): Promise<ExtractResponse | ErrorResponse>;
     /**
      * Retrieves the status of an extract job.
      * @param jobId - The ID of the extract job.
      * @returns The status of the extract job.
+     * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+     * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
      */
     getExtractStatus(jobId: string): Promise<any>;
     /**
@@ -1736,4 +1826,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-GAAHPN3I.js";
+} from "./chunk-37UG5UXZ.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -812,6 +812,64 @@ async function cancelAgent(http, jobId) {
   }
 }
 
+// src/v2/methods/browser.ts
+async function browser(http, args = {}) {
+  const body = {};
+  if (args.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+  try {
+    const res = await http.post("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+async function browserExecute(http, sessionId, args) {
+  const body = {
+    code: args.code,
+    language: args.language ?? "bash"
+  };
+  if (args.timeout != null) body.timeout = args.timeout;
+  try {
+    const res = await http.post(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+async function deleteBrowser(http, sessionId) {
+  try {
+    const res = await http.delete(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+async function listBrowsers(http, args = {}) {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+  try {
+    const res = await http.get(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}
+
 // src/v2/methods/usage.ts
 async function getConcurrency(http) {
   try {
@@ -1254,6 +1312,8 @@ var FirecrawlClient = class {
    * Start an extract job (async).
    * @param args Extraction request (urls, schema or prompt, flags).
    * @returns Job id or processing state.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async startExtract(args) {
     return startExtract(this.http, args);
@@ -1261,6 +1321,8 @@ var FirecrawlClient = class {
   /**
    * Get extract job status/data.
    * @param jobId Extract job id.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId) {
     return getExtractStatus(this.http, jobId);
@@ -1269,6 +1331,8 @@ var FirecrawlClient = class {
    * Convenience waiter: start an extract and poll until it finishes.
    * @param args Extraction request plus waiter controls (pollInterval, timeout seconds).
    * @returns Final extract response.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract(args) {
     return extract(this.http, args);
@@ -1305,6 +1369,39 @@ var FirecrawlClient = class {
   async cancelAgent(jobId) {
     return cancelAgent(this.http, jobId);
   }
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
+   */
+  async browser(args = {}) {
+    return browser(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
+   */
+  async browserExecute(sessionId, args) {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId) {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(args = {}) {
+    return listBrowsers(this.http, args);
+  }
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {
@@ -1374,7 +1471,7 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-CMQJ5STA.js");
+      const packageJson = await import("./package-JD6PB5ZT.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -1915,10 +2012,11 @@ var FirecrawlApp = class {
   }
   /**
    * Extracts information from URLs using the Firecrawl API.
-   * Currently in Beta. Expect breaking changes on future minor versions.
    * @param urls - The URLs to extract information from. Optional if using other methods for data extraction.
    * @param params - Additional parameters for the extract request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract(urls, params) {
     const headers = this.prepareHeaders();
@@ -1970,6 +2068,8 @@ var FirecrawlApp = class {
    * @param params - Additional parameters for the extract request.
    * @param idempotencyKey - Optional idempotency key for the request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async asyncExtract(urls, params, idempotencyKey) {
     const headers = this.prepareHeaders(idempotencyKey);
@@ -1995,6 +2095,8 @@ var FirecrawlApp = class {
    * Retrieves the status of an extract job.
    * @param jobId - The ID of the extract job.
    * @returns The status of the extract job.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId) {
     try {

package/dist/{package-CMQJ5STA.js → package-JD6PB5ZT.js}

@@ -1,4 +1,4 @@
 import {
   require_package
-} from "./chunk-GAAHPN3I.js";
+} from "./chunk-37UG5UXZ.js";
 export default require_package();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mendable/firecrawl",
-  "version": "4.12.1",
+  "version": "4.13.1",
   "description": "JavaScript SDK for Firecrawl API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/v1/index.ts

@@ -1278,10 +1278,11 @@ export default class FirecrawlApp {
 
   /**
    * Extracts information from URLs using the Firecrawl API.
-   * Currently in Beta. Expect breaking changes on future minor versions.
    * @param urls - The URLs to extract information from. Optional if using other methods for data extraction.
    * @param params - Additional parameters for the extract request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract<T extends zt.ZodSchema = any>(urls?: string[], params?: ExtractParams<T>): Promise<ExtractResponse<zt.infer<T>> | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -1337,6 +1338,8 @@ export default class FirecrawlApp {
    * @param params - Additional parameters for the extract request.
    * @param idempotencyKey - Optional idempotency key for the request.
    * @returns The response from the extract operation.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async asyncExtract(
     urls: string[],
@@ -1369,6 +1372,8 @@ export default class FirecrawlApp {
    * Retrieves the status of an extract job.
    * @param jobId - The ID of the extract job.
    * @returns The status of the extract job.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId: string): Promise<any> {
     try {

package/src/v2/client.ts

@@ -20,6 +20,12 @@ import {
 } from "./methods/batch";
 import { startExtract, getExtractStatus, extract as extractWaiter } from "./methods/extract";
 import { startAgent, getAgentStatus, cancelAgent, agent as agentWaiter } from "./methods/agent";
+import {
+  browser as browserMethod,
+  browserExecute,
+  deleteBrowser,
+  listBrowsers,
+} from "./methods/browser";
 import { getConcurrency, getCreditUsage, getQueueStatus, getTokenUsage, getCreditUsageHistorical, getTokenUsageHistorical } from "./methods/usage";
 import type {
   Document,
@@ -40,6 +46,10 @@ import type {
   CrawlOptions,
   BatchScrapeOptions,
   PaginationConfig,
+  BrowserCreateResponse,
+  BrowserExecuteResponse,
+  BrowserDeleteResponse,
+  BrowserListResponse,
 } from "./types";
 import { Watcher } from "./watcher";
 import type { WatcherOptions } from "./watcher";
@@ -245,6 +255,8 @@ export class FirecrawlClient {
    * Start an extract job (async).
    * @param args Extraction request (urls, schema or prompt, flags).
    * @returns Job id or processing state.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async startExtract(args: Parameters<typeof startExtract>[1]): Promise<ExtractResponse> {
     return startExtract(this.http, args);
@@ -252,6 +264,8 @@ export class FirecrawlClient {
   /**
    * Get extract job status/data.
    * @param jobId Extract job id.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async getExtractStatus(jobId: string): Promise<ExtractResponse> {
     return getExtractStatus(this.http, jobId);
@@ -260,6 +274,8 @@ export class FirecrawlClient {
    * Convenience waiter: start an extract and poll until it finishes.
    * @param args Extraction request plus waiter controls (pollInterval, timeout seconds).
    * @returns Final extract response.
+   * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+   * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
    */
   async extract(args: Parameters<typeof startExtract>[1] & { pollInterval?: number; timeout?: number }): Promise<ExtractResponse> {
     return extractWaiter(this.http, args);
@@ -298,6 +314,47 @@ export class FirecrawlClient {
     return cancelAgent(this.http, jobId);
   }
 
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
+   */
+  async browser(
+    args: Parameters<typeof browserMethod>[1] = {}
+  ): Promise<BrowserCreateResponse> {
+    return browserMethod(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
+   */
+  async browserExecute(
+    sessionId: string,
+    args: Parameters<typeof browserExecute>[2]
+  ): Promise<BrowserExecuteResponse> {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse> {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(
+    args: Parameters<typeof listBrowsers>[1] = {}
+  ): Promise<BrowserListResponse> {
+    return listBrowsers(this.http, args);
+  }
+
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {

package/src/v2/methods/browser.ts

@@ -0,0 +1,94 @@
+import type {
+  BrowserCreateResponse,
+  BrowserExecuteResponse,
+  BrowserDeleteResponse,
+  BrowserListResponse,
+} from "../types";
+import { HttpClient } from "../utils/httpClient";
+import { normalizeAxiosError, throwForBadResponse } from "../utils/errorHandler";
+
+export async function browser(
+  http: HttpClient,
+  args: {
+    ttl?: number;
+    activityTtl?: number;
+    streamWebView?: boolean;
+  } = {}
+): Promise<BrowserCreateResponse> {
+  const body: Record<string, unknown> = {};
+  if (args.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+
+  try {
+    const res = await http.post<BrowserCreateResponse>("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+
+export async function browserExecute(
+  http: HttpClient,
+  sessionId: string,
+  args: {
+    code: string;
+    language?: "python" | "node" | "bash";
+    timeout?: number;
+  }
+): Promise<BrowserExecuteResponse> {
+  const body: Record<string, unknown> = {
+    code: args.code,
+    language: args.language ?? "bash",
+  };
+  if (args.timeout != null) body.timeout = args.timeout;
+
+  try {
+    const res = await http.post<BrowserExecuteResponse>(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+
+export async function deleteBrowser(
+  http: HttpClient,
+  sessionId: string
+): Promise<BrowserDeleteResponse> {
+  try {
+    const res = await http.delete<BrowserDeleteResponse>(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+
+export async function listBrowsers(
+  http: HttpClient,
+  args: {
+    status?: "active" | "destroyed";
+  } = {}
+): Promise<BrowserListResponse> {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+
+  try {
+    const res = await http.get<BrowserListResponse>(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}

package/src/v2/methods/extract.ts

@@ -38,6 +38,10 @@ function prepareExtractPayload(args: {
   return body;
 }
 
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 export async function startExtract(http: HttpClient, args: Parameters<typeof prepareExtractPayload>[0]): Promise<ExtractResponse> {
   const payload = prepareExtractPayload(args);
   try {
@@ -50,6 +54,10 @@ export async function startExtract(http: HttpClient, args: Parameters<typeof pre
   }
 }
 
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 export async function getExtractStatus(http: HttpClient, jobId: string): Promise<ExtractResponse> {
   try {
     const res = await http.get<ExtractResponse>(`/v2/extract/${jobId}`);
@@ -61,6 +69,10 @@ export async function getExtractStatus(http: HttpClient, jobId: string): Promise
   }
 }
 
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 export async function waitExtract(
   http: HttpClient,
   jobId: string,
@@ -76,6 +88,10 @@ export async function waitExtract(
   }
 }
 
+/**
+ * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
+ * Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement.
+ */
 export async function extract(
   http: HttpClient,
   args: Parameters<typeof prepareExtractPayload>[0] & { pollInterval?: number; timeout?: number }

package/src/v2/types.ts

@@ -683,3 +683,46 @@ export interface QueueStatusResponse {
   maxConcurrency: number;
   mostRecentSuccess: string | null;
 }
+
+// Browser types
+export interface BrowserCreateResponse {
+  success: boolean;
+  id?: string;
+  cdpUrl?: string;
+  liveViewUrl?: string;
+  expiresAt?: string;
+  error?: string;
+}
+
+export interface BrowserExecuteResponse {
+  success: boolean;
+  stdout?: string;
+  result?: string;
+  stderr?: string;
+  exitCode?: number;
+  killed?: boolean;
+  error?: string;
+}
+
+export interface BrowserDeleteResponse {
+  success: boolean;
+  sessionDurationMs?: number;
+  creditsBilled?: number;
+  error?: string;
+}
+
+export interface BrowserSession {
+  id: string;
+  status: string;
+  cdpUrl: string;
+  liveViewUrl: string;
+  streamWebView: boolean;
+  createdAt: string;
+  lastActivity: string;
+}
+
+export interface BrowserListResponse {
+  success: boolean;
+  sessions?: BrowserSession[];
+  error?: string;
+}