Browser Use

Browser Use Cloud's hosted browser agent. Not callable directly: use bowmark.browser_agent, which runs it for you with a private watch link and bills the session to your account.

Domain: browser-use.com

Also known as: Browser Use, browser-use, browser-use.com, Browser Use Cloud

Prefer the capability

bowmark.browser_agent covers this provider and routes around it when it is having a bad day. Reach for this page when you need browser-use.com specifically.

Call it directly

bowmark.providers.browser_use.createRun(args: BrowserUseCreateRunArgs): Promise<BrowserUseCreatedRun>
bowmark.providers.browser_use.getRun(runId: string): Promise<BrowserUseRun>
bowmark.providers.browser_use.getRunStatus(runId: string): Promise<BrowserUseRunStatusReading>
bowmark.providers.browser_use.listRunEvents(args: BrowserUseEventsArgs): Promise<BrowserUseEventsPage>
bowmark.providers.browser_use.listSessionRuns(sessionId: string): Promise<BrowserUseRunList>
bowmark.providers.browser_use.cancelRun(runId: string): Promise<BrowserUseRun>
bowmark.providers.browser_use.getSession(sessionId: string): Promise<BrowserUseSession>
bowmark.providers.browser_use.queueMessage(args: BrowserUseQueueArgs): Promise<BrowserUseQueuedMessage>
bowmark.providers.browser_use.findSessionBrowser(sessionId: string): Promise<BrowserUseBrowser | null>
bowmark.providers.browser_use.getBrowser(browserId: string): Promise<BrowserUseBrowser>
bowmark.providers.browser_use.stopBrowser(browserId: string): Promise<BrowserUseBrowser>

Functions

Function	What it does
`createRun`	Starts a Browser Use agent run on a natural-language task, optionally continuing an existing session.
`getRun`	Reads one run: status, final result or error, token totals and LLM cost.
`getRunStatus`	The cheap status poll for one run.
`listRunEvents`	A run's step-by-step event stream after a cursor — the agent's reasoning, tool calls, and the `browser.ready` event carrying the live view url.
`listSessionRuns`	Lists every run (agent turn) in a session, newest first, each with its status and LLM cost — how a session's whole spend is read.
`cancelRun`	Cancels an in-flight run; idempotent on a finished one.
`getSession`	Reads a session, including the id of its latest run (a queued message becomes a new run).
`queueMessage`	Sends a follow-up instruction into a session: it runs as the next turn when the current one ends, or at once with `interrupt: true`.
`findSessionBrowser`	The cloud browser attached to a session, with its live view url and running cost, or null.
`getBrowser`	Reads one cloud browser: status, live view url, browser and proxy cost.
`stopBrowser`	Stops a cloud browser (cannot be undone). Its cost is then settled down to the time actually used.

Types

type BrowserUseRunStatus = "queued" | "dispatching" | "running" | "completed" | "failed" | "cancelled";

interface BrowserUseCreateRunArgs {
  task: string;
  model?: string;             // e.g. "claude-sonnet-5"; absent = vendor default
  sessionId?: string;         // continue a session
  maxCostUsd?: number;
  proxyCountryCode?: string;  // e.g. "us"
}

interface BrowserUseRunStatusReading { runId: string; status: BrowserUseRunStatus }
interface BrowserUseCreatedRun { id: string; status: BrowserUseRunStatus; model: string; sessionId: string; workspaceId: string }

interface BrowserUseRun {
  id: string; sessionId: string; task: string; title: string | null; model: string;
  status: BrowserUseRunStatus; result: string | null; error: string | null;
  inputTokens: number; outputTokens: number;
  costUsd: number;            // LLM cost only
  createdAt: string; updatedAt: string;
}

interface BrowserUseRunList { runs: BrowserUseRun[]; hasMore: boolean }
interface BrowserUseEvent { id: number; ts: string; type: string; data: Record<string, unknown> }
interface BrowserUseEventsPage { events: BrowserUseEvent[]; nextAfter: number | null; hasMore: boolean }
interface BrowserUseEventsArgs { runId: string; after?: number; limit?: number }

interface BrowserUseSession { sessionId: string; latestRunId: string; status: string; title: string | null; createdAt: string; updatedAt: string }

interface BrowserUseQueueArgs { sessionId: string; text: string; interrupt?: boolean }
interface BrowserUseQueuedMessage { id: number; sessionId: string; status: string; mode: string }

interface BrowserUseBrowser {
  id: string; status: string;
  liveUrl: string | null;     // interactive; whoever holds it drives the browser
  agentSessionId: string | null;
  timeoutAt: string; startedAt: string; finishedAt: string | null;
  browserCostUsd: number; proxyCostUsd: number; proxyUsedMb: number;
}


`browser_agent`	Browser agent — the capability this provider backs.

Call it directly

Functions

Types

Related

On this page