v0.6.37: release: libretto 0.6.37 and browser-tools 0.1.2 (#504)

Features

• startUrl workflow launch option: Workflows can now declare startUrl, gpu, and viewport directly in their definition. Libretto opens startUrl before the handler runs — on Kernel and Libretto Cloud it is sent at browser create time so the page loads before CDP attach, avoiding a double navigation that can trigger bot detection. Browserbase and Steel navigate to startUrl immediately after connect.

  export default workflow("bookFlight", {
    startUrl: "https://www.example.com/",
    gpu: true,
    viewport: { width: 1440, height: 900 },
    handler: async ({ page }) => {
      // Browser is already on startUrl — no page.goto needed here.
    },
  });

• MCP adapter for Browser Tools SDK: libretto-browser-tools/mcp exposes all six browser tools to any MCP-compatible client or gateway. Register tools on a caller-owned McpServer and connect your transport of choice. Screenshots are returned as MCP image content; failures set isError: true with actionable error text. Safety annotations are published for each tool.

  import { registerMcpBrowserTools } from "libretto-browser-tools/mcp";
  
  const { dispose } = registerMcpBrowserTools(
    server,
    new LocalBrowserProvider({ headless: true }),
  );

• Cloud job and schedule browser launch overrides: libretto cloud jobs create and libretto cloud schedules create now accept --start-url, --gpu, and --viewport WIDTHxHEIGHT flags to override workflow launch options at run time.

• Browser Tools SDK product page: The /browser-tools marketing page is now live with benchmarks, tool examples, integration grid (AI SDK, Pi, MCP, and coming-soon adapters), and FAQ.

• Browser Tools SDK ProviderSessionCreateOptions: startUrl, gpu, and viewport are now part of the createSession contract for all built-in providers (LocalBrowserProvider, KernelBrowserProvider, LibrettoCloudBrowserProvider, BrowserbaseBrowserProvider, SteelBrowserProvider, BrowserUseBrowserProvider). Kernel and Libretto Cloud preload startUrl; others navigate after connect. ProviderSessionCreateOptions and ProviderSession.startUrlPreloaded are exported from the package root.

Improvements

• Playwright debugger package renamed to libretto-playwright-debugger: The npm package is now published as libretto-playwright-debugger (previously libretto-playwright-debug). The createPlaywrightDebugger() and debugFailure() API is unchanged.

  pnpm add libretto-playwright-debugger

• Streamlined PR agent setup: GitHub repository connection is now the first setup step; the local-agent step has been removed from the wizard. Authenticated users with an incomplete PR agent setup are routed to /setup; users with a completed setup go to /dashboard.

• libretto status output simplified: When no sessions are open, the command now prints No open sessions. without the preceding Open sessions: header.

• libretto setup help text updated: The setup command description now points users to update for existing installations.

• Docs migrated to Holocron: The documentation site has moved from Mintlify to the Holocron runtime. The /docs proxy now points to the new deployment at libretto-docs.vercel.app.

• Browser Tools docs section: A new top-level Browser Tools tab is live in the docs, covering quickstart, tools reference, advanced topics (domain policy, borrowed pages, CDP attach), adapters (AI SDK, Pi, MCP, Custom), and providers (Local, Libretto Cloud, Kernel, Browserbase, Browser Use, Steel, Custom).

• Docs Open Graph images: Every docs page now has a branded 1200×630 social card using Satori for precise Flexbox layout. A pnpm docs:og script regenerates all images deterministically.

• Chrome extension auth return flow preserved: The cloud browsers dashboard now redirects signed-out visitors to sign-in with their original destination URL, so the Local Chrome Agent flow returns correctly after authentication.

• Browser Tools SDK README refreshed: The packages/browser-tools README now includes a centered header, install steps, quick example, cloud provider list, and links to docs and the product page.