@mendable/firecrawl 4.12.1 → 4.13.0

package/dist/{chunk-GAAHPN3I.js → chunk-22A4MB4F.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.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",

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.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -928,6 +928,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 {
@@ -1421,6 +1479,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() {

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;
@@ -606,6 +643,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;
@@ -811,6 +862,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. */
@@ -1736,4 +1811,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;
@@ -606,6 +643,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;
@@ -811,6 +862,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. */
@@ -1736,4 +1811,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-22A4MB4F.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 {
@@ -1305,6 +1363,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 +1465,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-5SIMNZMX.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-CMQJ5STA.js → package-5SIMNZMX.js}

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

package/package.json

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

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";
@@ -298,6 +308,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/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;
+}