Browser

Oya Browser docs

TypeScript SDK for browser agents

@oya-ai/browser, the TypeScript SDK with no runtime dependencies: start a browser, analyze the page, act on elements by ID, or bring Playwright over the CDP URL.

SDK

@oya-ai/browser is TypeScript with no runtime dependencies, shipped as ESM, CJS and types. Element IDs come from analyze() and are only valid until the page changes, after a navigation or a click that redraws, analyze again.

Example
const page = await browser.analyze();      // markdown + numbered elements ({ format: 'toon' } for TOON)
const els  = await browser.elements();     // just the visible ones

await browser.click(13);
await browser.type(9, "hello");
await browser.pressKey("Enter");
await browser.waitFor("[data-testid=results]");
await browser.scroll("bottom");

const png = await browser.screenshot();    // base64
const answer = await browser.ask("find the pricing page");

await browser.solveCaptcha();              // { solved, method }
await browser.completeMfa();               // { completed, method, liveViewUrl }
await browser.close();

Bring your own tools

browser.cdpUrl is our gateway URL, not the vendor's, point Playwright, Puppeteer, Stagehand or browser-use at it and you get routing, profile capture and session recording without any of them knowing this exists.

Example
const browser = await oya.browser.start();
const pw = await chromium.connectOverCDP(browser.cdpUrl);

The gateway also answers /json/version and /json/list, which is what lets those clients treat it as an ordinary browser.