AI Agents Overview

import { playwright } from '@bctrl/sdk';

const session = await playwright.connect({
  apiKey: process.env.BCTRL_API_KEY
});

// Stagehand methods
session.stagehand.act(...)
session.stagehand.extract(...)
session.stagehand.observe(...)
session.stagehand.agent(...)

// Browser-use methods
session.browserUse.agent(...)
session.browserUse.codeAgent(...)

import { bctrl } from '@bctrl/sdk';

const desktop = await bctrl.desktop.connect({
  apiKey: process.env.BCTRL_API_KEY,
  os: 'windows' // or 'macos', 'linux'
});

// CUA methods
desktop.cua.run(...)

import { playwright } from '@bctrl/sdk';
import { z } from 'zod';

const session = await playwright.connect({ apiKey: '...' });
const page = session.page;

// Traditional: fast, reliable navigation
await page.goto('https://example.com');
await page.locator('#username').fill('[email protected]');
await page.locator('#password').fill('password');
await page.locator('button[type="submit"]').click();

// AI: handle dynamic content
await session.stagehand.act('Dismiss any popup or modal that appears');

// Traditional: known selectors
await page.locator('nav a[href="/products"]').click();

// AI: extract unstructured data
const products = await session.stagehand.extract(
  'Get all products with name, price, and rating',
  z.array(z.object({
    name: z.string(),
    price: z.number(),
    rating: z.number()
  }))
);

console.log(products);
await session.close();

// Stagehand
await session.stagehand.act('Click login', {
  modelName: 'gpt-4o',           // or 'claude-3-5-sonnet', 'gemini-2.0-flash'
  temperature: 0.1
});

// Browser-use
const agent = session.browserUse.agent({
  llm: 'gpt-4o',
  useVision: true
});

// CUA
await desktop.cua.run('Open Notepad', {
  model: 'gpt-4o'
});