Runtimes

1
const runtime = await workspace.runtimes
2
  .browser("main")
3
  .playwright({ mode: "ephemeral" });

1
// Playwright
2
const pw = await workspace.runtimes.browser("a").playwright();
3
4
// Puppeteer
5
const pp = await workspace.runtimes.browser("b").puppeteer();
6
7
// Stagehand
8
const sh = await workspace.runtimes.browser("c").stagehand();
9
10
// Selenium
11
const se = await workspace.runtimes.browser("d").selenium();

1
const runtime = await workspace.runtimes.browser("quick").playwright({
2
  mode: "ephemeral",
3
});

1
const runtime = await workspace.runtimes.browser("stealth").playwright({
2
  mode: "ephemeral",
3
  config: {
4
    humanize: true,
5
    solveCaptchas: true,
6
  },
7
  extensionIds: ["captcha-solver-ext"],
8
});

1
const runtime = await workspace.runtimes.browser("crm").playwright({
2
  mode: "profile",
3
  profileId: "sales-bot",
4
});

1
// Navigate
2
await runtime.page.goto("https://example.com");
3
4
// Extract
5
const title = await runtime.page.title();
6
const html = await runtime.page.content();
7
8
// Interact
9
await runtime.page.locator("#search").fill("bctrl");
10
await runtime.page.locator("#submit").click();
11
12
// Screenshot
13
const screenshot = await runtime.page.screenshot();

1
// Stagehand — action by instruction
2
await runtime.stagehand.act("Click the login button");
3
4
// Stagehand — structured extraction
5
const data = await runtime.stagehand.extract(
6
  "Extract the product name and price",
7
  z.object({ name: z.string(), price: z.string() })
8
);
9
10
// Browser-use — autonomous agent
11
const op = await runtime.browserUse.agent.execute(
12
  "Export the latest invoices as CSV"
13
);

1
const result = await workspace.operations.wait(op.id, {
2
  until: "completed",
3
});

1
// Live view — interactive or view-only
2
const live = await runtime.live({ interactive: true });
3
console.log(live.url);
4
5
// Recording — replay after the fact
6
const recording = await runtime.recording();
7
console.log(recording.url);

1
const [crm, email, research] = await Promise.all([
2
  workspace.runtimes.browser("crm").playwright({ mode: "profile", profileId: "crm-bot" }),
3
  workspace.runtimes.browser("email").playwright({ mode: "profile", profileId: "email-bot" }),
4
  workspace.runtimes.browser("research").playwright({ mode: "ephemeral" }),
5
]);
6
7
// Each runtime operates independently
8
await crm.page.goto("https://crm.example.com");
9
await email.page.goto("https://mail.example.com");
10
await research.page.goto("https://google.com");

1
const result = await runtime.run({
2
  steps: [
3
    { call: "page.goto", args: ["https://example.com"] },
4
    { call: "page.screenshot" },
5
  ],
6
});

1
await runtime.stop();

1
const live = await runtime.live({ interactive: true });
2
console.log(live.iframeUrl);

1
const recording = await runtime.recording();
2
console.log(recording.iframeUrl);

1
const state = await runtime.state();

1
const events = await runtime.events.list({
2
  eventTypes: ["page.navigated", "console"],
3
  limit: 50,
4
});

1
const event = await runtime.events.wait({
2
  eventTypes: ["page.navigated"],
3
  timeoutMs: 10_000,
4
});

1
const result = await runtime.captcha.detect();
2
if (result.detected) {
3
  console.log(result.type); // e.g., "recaptcha", "hcaptcha"
4
}

1
const result = await runtime.captcha.solve();

1
await runtime.stagehand.act("Click the login button");

1
import { z } from "@bctrl/sdk";
2
3
const data = await runtime.stagehand.extract(
4
  "Extract the product name and price",
5
  z.object({ name: z.string(), price: z.string() })
6
);

1
const elements = await runtime.stagehand.observe("Find all clickable buttons");

1
const agent = runtime.stagehand.agent();
2
const result = await agent.execute("Navigate to settings and export data as CSV");

1
const metrics = await runtime.stagehand.getMetrics();
2
const history = await runtime.stagehand.getHistory();

1
const op = await runtime.browserUse.agent().execute(
2
  "Export the latest invoices as CSV"
3
);
4
5
const result = await workspace.operations.wait(op.id, {
6
  until: "completed",
7
});

1
const op = await runtime.browserUse.codeAgent().execute(
2
  "Scrape all product listings into a structured table"
3
);