feat(browser): add downloads + response bodies

src/cli/browser-cli-actions-observe.ts

@@ -3,6 +3,7 @@ import { resolveBrowserControlUrl } from "../browser/client.js";
 import {
   browserConsoleMessages,
   browserPdfSave,
+  browserResponseBody,
 } from "../browser/client-actions.js";
 import { danger } from "../globals.js";
 import { defaultRuntime } from "../runtime.js";
@@ -61,4 +62,44 @@ export function registerBrowserActionObserveCommands(
         defaultRuntime.exit(1);
       }
     });
+
+  browser
+    .command("responsebody")
+    .description("Wait for a network response and return its body")
+    .argument("<url>", "URL (exact, substring, or glob like **/api)")
+    .option("--target-id <id>", "CDP target id (or unique prefix)")
+    .option(
+      "--timeout-ms <ms>",
+      "How long to wait for the response (default: 20000)",
+      (v: string) => Number(v),
+    )
+    .option(
+      "--max-chars <n>",
+      "Max body chars to return (default: 200000)",
+      (v: string) => Number(v),
+    )
+    .action(async (url: string, opts, cmd) => {
+      const parent = parentOpts(cmd);
+      const baseUrl = resolveBrowserControlUrl(parent?.url);
+      const profile = parent?.browserProfile;
+      try {
+        const result = await browserResponseBody(baseUrl, {
+          url,
+          targetId: opts.targetId?.trim() || undefined,
+          timeoutMs: Number.isFinite(opts.timeoutMs)
+            ? opts.timeoutMs
+            : undefined,
+          maxChars: Number.isFinite(opts.maxChars) ? opts.maxChars : undefined,
+          profile,
+        });
+        if (parent?.json) {
+          defaultRuntime.log(JSON.stringify(result, null, 2));
+          return;
+        }
+        defaultRuntime.log(result.response.body);
+      } catch (err) {
+        defaultRuntime.error(danger(String(err)));
+        defaultRuntime.exit(1);
+      }
+    });
 }