@coopah/bentley-tool-browser

Browser automation tool for Bentley agents, powered by Playwright. Lets agents navigate pages, take screenshots, and extract content as clean markdown (via Mozilla Readability + Turndown).

Install

pnpm add @coopah/bentley-tool-browser playwright

Dependencies

• @coopah/bentley-core
• @mozilla/readability — Article content extraction
• turndown — HTML to Markdown conversion
• turndown-plugin-gfm — GitHub Flavored Markdown support
• linkedom — Lightweight DOM parser
• ai ^6.0.116
• zod ^4.3.6

Peer Dependencies

| Peer | Version | Required | |------|---------|----------| | playwright | >=1.40.0 | Optional (needed at runtime) |

Usage

import { createBentley } from "@coopah/bentley-core";
import { bentleyBrowserPlugin } from "@coopah/bentley-tool-browser";

const bentley = createBentley({
  plugins: [bentleyBrowserPlugin()],
});

Once registered, agents can use the browser tool to interact with web pages.

API

• bentleyBrowserPlugin() — BentleyPlugin that registers the browser automation tool
• createBrowserTool() — Low-level Vercel AI tool factory
• closeBrowser() — Cleanup function to close the browser connection pool

Tool Schema

// Input
{
  action: "navigate" | "screenshot" | "extract";
  url?: string;       // Required for navigate
  selector?: string;  // Optional CSS selector for extract
}

Actions

| Action | Description | Returns | |--------|-------------|---------| | navigate | Load a URL | Page title | | screenshot | Capture page as PNG | Base64-encoded image | | extract | Get page content as clean markdown (falls back to raw text if Readability fails) | Title + markdown text (or text by CSS selector) |

Related Packages

| Package | Role | |---------|------| | @coopah/bentley-core | Core runtime (required) | | @coopah/bentley-tool-web-search | Web search tool | | @coopah/bentley-tool-exec | Shell execution tool |

License

MIT