@poncho-ai/browser 0.6.0 → 0.6.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/browser@0.6.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/browser
+> @poncho-ai/browser@0.6.1 build /Users/cesar/Dev/latitude/poncho-ai/packages/browser
 > tsup src/index.ts --format esm --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 40.85 KB
-ESM ⚡️ Build success in 76ms
+ESM dist/index.js 41.37 KB
+ESM ⚡️ Build success in 83ms
 DTS Build start
-DTS ⚡️ Build success in 1346ms
-DTS dist/index.d.ts 13.55 KB
+DTS ⚡️ Build success in 1112ms
+DTS dist/index.d.ts 13.59 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @poncho-ai/browser
 
+## 0.6.1
+
+### Patch Changes
+
+- Pass `@sparticuz/chromium` recommended args (--no-sandbox, --disable-gpu, etc.) when launching on serverless platforms. Fixes Chromium sandbox crash on Vercel/Lambda.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -111,10 +111,11 @@ declare class BrowserSession {
     private get isRemote();
     private get isServerless();
     /**
-     * Resolve executablePath for local launches. When no explicit path is set
-     * and we're on a serverless platform, try `@sparticuz/chromium` automatically.
+     * Resolve executablePath and launch args for serverless platforms.
+     * When `@sparticuz/chromium` is installed, uses its executable and
+     * recommended args (--no-sandbox, --disable-gpu, etc.).
      */
-    private resolveExecutablePath;
+    private resolveServerlessChromium;
     private launchFreshManager;
     private ensureManager;
     private evictOldestTab;

package/dist/index.js

@@ -345,12 +345,13 @@ var BrowserSession = class {
     return !!(process.env.VERCEL || process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.AWS_EXECUTION_ENV || process.env.SERVERLESS);
   }
   /**
-   * Resolve executablePath for local launches. When no explicit path is set
-   * and we're on a serverless platform, try `@sparticuz/chromium` automatically.
+   * Resolve executablePath and launch args for serverless platforms.
+   * When `@sparticuz/chromium` is installed, uses its executable and
+   * recommended args (--no-sandbox, --disable-gpu, etc.).
    */
-  async resolveExecutablePath() {
-    if (this.config.executablePath) return this.config.executablePath;
-    if (!this.isServerless) return void 0;
+  async resolveServerlessChromium() {
+    if (this.config.executablePath) return { executablePath: this.config.executablePath };
+    if (!this.isServerless) return {};
     try {
       const spec = ["@sparticuz", "chromium"].join("/");
       const mod = await import(
@@ -358,23 +359,24 @@ var BrowserSession = class {
         spec
       );
       const chromium = mod.default ?? mod;
-      const path = await chromium.executablePath();
-      console.log(`[poncho][browser] Auto-detected @sparticuz/chromium: ${path}`);
-      return path;
+      const executablePath = await chromium.executablePath();
+      const args = Array.isArray(chromium.args) ? chromium.args : [];
+      console.log(`[poncho][browser] Auto-detected @sparticuz/chromium: ${executablePath} (${args.length} args)`);
+      return { executablePath, args };
     } catch {
-      return void 0;
+      return {};
     }
   }
   async launchFreshManager() {
     const Ctor = await getBrowserManagerCtor();
     const mgr = new Ctor();
     const viewport = this.config.viewport ?? { width: 1280, height: 720 };
-    const executablePath = await this.resolveExecutablePath();
+    const serverless = await this.resolveServerlessChromium();
     const launchOpts = {
       action: "launch",
       headless: this.config.headless ?? true,
       viewport: { width: viewport.width ?? 1280, height: viewport.height ?? 720 },
-      executablePath
+      executablePath: serverless.executablePath
     };
     if (this.config.cdpUrl) {
       launchOpts.cdpUrl = this.config.cdpUrl;
@@ -387,16 +389,25 @@ var BrowserSession = class {
       await mkdir(profileDir, { recursive: true });
       launchOpts.profile = profileDir;
     }
+    const baseArgs = serverless.args ?? [];
     if (this.stealthEnabled) {
       const ua = this.stealthUserAgent;
       launchOpts.userAgent = ua;
       if (!this.isRemote) {
-        launchOpts.args = buildStealthArgs(ua);
+        const stealthArgs = buildStealthArgs(ua);
+        const merged = [...baseArgs];
+        for (const arg of stealthArgs) {
+          if (!merged.includes(arg)) merged.push(arg);
+        }
+        launchOpts.args = merged;
       }
       console.log("[poncho][browser] Launching with stealth mode enabled (UA: " + ua + ")");
     } else if (this.config.userAgent) {
       launchOpts.userAgent = this.config.userAgent;
     }
+    if (!launchOpts.args && baseArgs.length > 0) {
+      launchOpts.args = baseArgs;
+    }
     await mgr.launch(launchOpts);
     this._contextStealthInstalled = false;
     this._uaOverrideApplied.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/browser",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Browser automation for Poncho agents, powered by agent-browser",
   "repository": {
     "type": "git",

package/src/session.ts

@@ -258,23 +258,26 @@ export class BrowserSession {
   }
 
   /**
-   * Resolve executablePath for local launches. When no explicit path is set
-   * and we're on a serverless platform, try `@sparticuz/chromium` automatically.
+   * Resolve executablePath and launch args for serverless platforms.
+   * When `@sparticuz/chromium` is installed, uses its executable and
+   * recommended args (--no-sandbox, --disable-gpu, etc.).
    */
-  private async resolveExecutablePath(): Promise<string | undefined> {
-    if (this.config.executablePath) return this.config.executablePath;
-    if (!this.isServerless) return undefined;
+  private async resolveServerlessChromium(): Promise<{
+    executablePath?: string;
+    args?: string[];
+  }> {
+    if (this.config.executablePath) return { executablePath: this.config.executablePath };
+    if (!this.isServerless) return {};
     try {
-      // Dynamic require — @sparticuz/chromium is an optional peer dependency
-      // that the user installs in their agent project for serverless runtimes.
       const spec = ["@sparticuz", "chromium"].join("/");
       const mod = await import(/* webpackIgnore: true */ spec);
       const chromium = mod.default ?? mod;
-      const path = await chromium.executablePath();
-      console.log(`[poncho][browser] Auto-detected @sparticuz/chromium: ${path}`);
-      return path;
+      const executablePath = await chromium.executablePath();
+      const args: string[] = Array.isArray(chromium.args) ? chromium.args : [];
+      console.log(`[poncho][browser] Auto-detected @sparticuz/chromium: ${executablePath} (${args.length} args)`);
+      return { executablePath, args };
     } catch {
-      return undefined;
+      return {};
     }
   }
 
@@ -283,13 +286,13 @@ export class BrowserSession {
     const mgr = new Ctor();
 
     const viewport = this.config.viewport ?? { width: 1280, height: 720 };
-    const executablePath = await this.resolveExecutablePath();
+    const serverless = await this.resolveServerlessChromium();
 
     const launchOpts: Record<string, unknown> = {
       action: "launch",
       headless: this.config.headless ?? true,
       viewport: { width: viewport.width ?? 1280, height: viewport.height ?? 720 },
-      executablePath,
+      executablePath: serverless.executablePath,
     };
 
     if (this.config.cdpUrl) {
@@ -306,17 +309,29 @@ export class BrowserSession {
       launchOpts.profile = profileDir;
     }
 
+    // Merge args: serverless chromium args (--no-sandbox etc.) + stealth args
+    const baseArgs: string[] = serverless.args ?? [];
+
     if (this.stealthEnabled) {
       const ua = this.stealthUserAgent!;
       launchOpts.userAgent = ua;
       if (!this.isRemote) {
-        launchOpts.args = buildStealthArgs(ua);
+        const stealthArgs = buildStealthArgs(ua);
+        const merged = [...baseArgs];
+        for (const arg of stealthArgs) {
+          if (!merged.includes(arg)) merged.push(arg);
+        }
+        launchOpts.args = merged;
       }
       console.log("[poncho][browser] Launching with stealth mode enabled (UA: " + ua + ")");
     } else if (this.config.userAgent) {
       launchOpts.userAgent = this.config.userAgent;
     }
 
+    if (!launchOpts.args && baseArgs.length > 0) {
+      launchOpts.args = baseArgs;
+    }
+
     await mgr.launch(launchOpts as Parameters<BrowserManagerInstance["launch"]>[0]);
 
     // Reset stealth tracking for fresh browser