SDK browser reference

const browserAgent = web.agent({
  model,
  approval: "ask",
});

const browser = await web.browser.create({
  recording: true,
  policy: { allowedDomains: ["vendor.example"] },
});

const result = await browserAgent.run({
  browserId: browser.id,
  startUrl: "https://vendor.example/dashboard",
  goal: "Find the latest paid invoice and download the PDF.",
});

const downloads = await browser.downloads.list();

interface WebBrowserResource {
  create(
    options?: BrowserCreateOptions,
    request?: { signal?: AbortSignal; idempotencyKey?: string; timeoutMs?: number }
  ): Promise<Browser>;

  get(id: BrowserId | string, request?: { signal?: AbortSignal }): Promise<Browser>;

  list(options?: BrowserListOptions): Promise<BrowserListResponse>;

  connect(id: BrowserId | string): Promise<Browser>;
}

interface Browser {
  readonly id: BrowserId;
  readonly lifecycleStatus?: BrowserStatus;
  readonly readiness?: unknown;
  readonly capabilities?: BrowserCapabilityAvailability;
  readonly metadata?: Record<string, string>;
  readonly createdAt?: string;
  readonly updatedAt?: string;
  readonly stoppedAt?: string;
  readonly retentionExpiresAt?: string;
  readonly recording?: unknown;
  readonly errorMessage?: string | null;

  playwright: BrowserPlaywright;
  files: BrowserFiles;
  downloads: BrowserDownloads;
  dialogs: BrowserDialogs;
  permissions: BrowserPermissions;
  recordings: BrowserRecordings;
  captcha: BrowserCaptcha;

  status(options?: BrowserStatusOptions): Promise<BrowserStatusResponse>;
  events(options?: BrowserEventsOptions): Promise<ListBrowserEventsResponse>;
  streamEvents(options?: BrowserEventStreamOptions): AsyncIterable<BrowserEvent>;
  pages(options?: { cursor?: string; limit?: number; signal?: AbortSignal }): Promise<BrowserPageSummary[]>;
  cdpUrl(): Promise<string>;
  debugUrl(): Promise<string>;
  stop(options?: { signal?: AbortSignal; idempotencyKey?: string }): Promise<BrowserLifecycleResponse>;
  resume(options?: { signal?: AbortSignal; idempotencyKey?: string }): Promise<BrowserLifecycleResponse>;
  close(options?: { signal?: AbortSignal; idempotencyKey?: string }): Promise<BrowserLifecycleResponse>;
}

const result = await browser.playwright.execute({
  code: `
    await page.goto("https://example.com");
    return await page.title();
  `,
  timeoutMs: 30_000,
  capture: {
    status: true,
    screenshot: "on_error",
    observation: {
      kind: "aria",
      depth: 5,
      maxChars: 20_000,
    },
  },
});

interface BrowserPlaywright {
  execute(
    request: BrowserPlaywrightExecuteRequest,
    options?: { signal?: AbortSignal }
  ): Promise<BrowserPlaywrightExecuteResponse>;
}