fix(cli): omit undefined screenshot options

.changeset/bright-pages-shoot.md

@@ -0,0 +1,5 @@
+---
+"browse": patch
+---
+
+Omit unset screenshot options so Stagehand V4 accepts default CLI screenshots.

packages/cli/src/lib/driver/commands/runtime.ts

@@ -26,13 +26,13 @@ export const runtimeHandlers: DriverCommandHandlers = {
       .parse(params);
     const page = await manager.activePage();
     const buffer = await page.screenshot({
-      animations: options.animations,
-      caret: options.caret,
-      clip: options.clip,
-      fullPage: options.fullPage,
-      quality: options.quality,
+      ...(options.animations === undefined ? {} : { animations: options.animations }),
+      ...(options.caret === undefined ? {} : { caret: options.caret }),
+      ...(options.clip === undefined ? {} : { clip: options.clip }),
+      ...(options.fullPage === undefined ? {} : { fullPage: options.fullPage }),
+      ...(options.quality === undefined ? {} : { quality: options.quality }),
       timeout: 10_000,
-      type: options.type,
+      ...(options.type === undefined ? {} : { type: options.type }),
     });
     if (options.path) {
       await fs.writeFile(options.path, buffer);

packages/cli/tests/driver-commands.test.ts

@@ -448,6 +448,36 @@ describe("driver commands", () => {
     expect(page.waitForTimeout).toHaveBeenCalledWith(100);
   });
 
+  it("omits undefined screenshot options from V4 wire requests", async () => {
+    const page = { screenshot: vi.fn().mockResolvedValue(Buffer.from("image")) };
+    const manager = {
+      activePage: async () => page,
+    } as unknown as Parameters<NonNullable<(typeof runtimeHandlers)["screenshot"]>>[0];
+
+    await expect(runtimeHandlers.screenshot!(manager, {})).resolves.toEqual({
+      base64: Buffer.from("image").toString("base64"),
+    });
+    expect(page.screenshot).toHaveBeenCalledWith({ timeout: 10_000 });
+
+    await runtimeHandlers.screenshot!(manager, {
+      animations: "disabled",
+      caret: "hide",
+      clip: { height: 200, width: 300, x: 10, y: 20 },
+      fullPage: true,
+      quality: 80,
+      type: "jpeg",
+    });
+    expect(page.screenshot).toHaveBeenLastCalledWith({
+      animations: "disabled",
+      caret: "hide",
+      clip: { height: 200, width: 300, x: 10, y: 20 },
+      fullPage: true,
+      quality: 80,
+      timeout: 10_000,
+      type: "jpeg",
+    });
+  });
+
   it("accepts fractional viewport scale values", async () => {
     const daemonDir = await fs.mkdtemp(join(tmpdir(), "browse-viewport-scale-"));
     const previousDaemonDir = process.env.BROWSE_DAEMON_DIR;