Use playwright core on serverless env (#11)

Author: azhong-git

CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+- Used playwright-core in serverless environments
+
 ## [0.1.0] - 2025-06-13
 
 ### Added

README.md

@@ -28,25 +28,28 @@ npm install @lightfeed/browser-agent
 
 Perfect for AWS Lambda and other serverless environments. Uses [@sparticuz/chromium](https://github.com/Sparticuz/chromium) to run Chrome in serverless environments with minimal cold start times and memory usage.
 
+> [!IMPORTANT]
+> This project uses Playwright, which ships with a specific version of Chromium. You need to install the matching version of `@sparticuz/chromium`. For example, we are using [Playwright 1.48](https://playwright.dev/docs/release-notes#version-148) (which supports Chromium 130), you should install `@sparticuz/chromium@130`.
+
 ```typescript
-import { BrowserAgent } from '@lightfeed/browser-agent';
-import chromium from '@sparticuz/chromium';
-import { AxiosProxyConfig } from 'axios';
+import { BrowserAgent } from "@lightfeed/browser-agent";
+import chromium from "@sparticuz/chromium";
+import { AxiosProxyConfig } from "axios";
 
 const agent = new BrowserAgent({
-  browserProvider: 'Serverless',
+  browserProvider: "Serverless",
   serverlessConfig: {
     executablePath: await chromium.executablePath(),
     options: {
       args: chromium.args,
     },
     // Use proxy (optional)
     proxy: {
-      host: 'proxy.example.com',
+      host: "proxy.example.com",
       port: 8080,
       auth: {
-        username: 'user',
-        password: 'pass'
+        username: "user",
+        password: "pass"
       }
     } as AxiosProxyConfig
   }
@@ -55,9 +58,9 @@ const agent = new BrowserAgent({
 // Example Lambda handler
 export const handler = async (event) => {
   const page = await agent.newPage();
-  await page.goto('https://ycombinator.com/companies');
+  await page.goto("https://ycombinator.com/companies");
 
-  page.ai('Find real estate YC startups in the latest two batches');
+  page.ai("Find real estate YC startups in the latest two batches");
   // ...
 };
 ```
@@ -70,19 +73,19 @@ Connect to any remote browser instance via WebSocket. Great for:
 - Browser farms and proxy services
 
 ```typescript
-import { BrowserAgent } from '@lightfeed/browser-agent';
+import { BrowserAgent } from "@lightfeed/browser-agent";
 
 const agent = new BrowserAgent({
-  browserProvider: 'Remote',
+  browserProvider: "Remote",
   remoteConfig: {
-    browserWSEndpoint: 'ws://your-remote-browser:9222/devtools/browser/ws'
+    browserWSEndpoint: "ws://your-remote-browser:9222/devtools/browser/ws"
   }
 });
 
 const page = await agent.newPage();
-await page.goto('https://amazon.com');
+await page.goto("https://amazon.com");
 
-page.ai('Search for organic products and go to the second page');
+page.ai("Search for organic products and go to the second page");
 ```
 
 ### Local Browser
@@ -93,16 +96,16 @@ Use your local Chrome browser for development and testing. Perfect for:
 - Quick prototyping
 
 ```typescript
-import { BrowserAgent } from '@lightfeed/browser-agent';
+import { BrowserAgent } from "@lightfeed/browser-agent";
 
 const agent = new BrowserAgent({
-  browserProvider: 'Local'
+  browserProvider: "Local"
 });
 
 const page = await agent.newPage();
-await page.goto('https://news.ycombinator.com');
+await page.goto("https://news.ycombinator.com");
 
-page.ai('Navigate to show section and go to the second post');
+page.ai("Navigate to show section and go to the second post");
 ```
 
 ## Contributing

package-lock.json

@@ -57,7 +57,7 @@
     "merge-images": "^2.0.0",
     "minimatch": "^9.0.3",
     "ora": "5.4.1",
-    "playwright": "npm:rebrowser-playwright@1.49.1",
+    "playwright": "npm:rebrowser-playwright-core@1.48.2",
     "readline": "^1.3.0",
     "turndown": "^7.2.0",
     "zod": "^3.24.1",

package.json

@@ -5,7 +5,7 @@ import chalk from "chalk";
 dotenv.config();
 
 const agent = new BrowserAgent({
-  // a: process.env.OPENAI_API_KEY,
+  maxSteps: 2,
 });
 
 (async () => {

scripts/test-async.ts

@@ -4,7 +4,7 @@ abstract class BrowserProvider<T> {
   abstract session: unknown;
   abstract start(): Promise<Browser>;
   abstract close(): Promise<void>;
-  abstract getSession(): T|null;
+  abstract getSession(): T | null;
 }
 
 export default BrowserProvider;