@mcp-use/cli 3.2.0-canary.11 → 3.2.0-canary.12

package/dist/index.js

@@ -2866,7 +2866,7 @@ async function captureScreenshot(opts) {
       {
         width: opts.width,
         height: opts.height,
-        deviceScaleFactor: 1,
+        deviceScaleFactor: opts.deviceScaleFactor ?? 1,
         mobile: false
       },
       sessionId
@@ -3101,7 +3101,8 @@ async function captureToolScreenshot(inputs, options = {}) {
       chromePath,
       cdpUrl: options.cdpUrl,
       delayMs: Number.isFinite(delayMs) && delayMs > 0 ? delayMs : 0,
-      bundle
+      bundle,
+      deviceScaleFactor: options.deviceScaleFactor
     });
     return { outputPath, width, height, view };
   } finally {
@@ -3244,6 +3245,20 @@ function parseDimension(raw, name) {
   }
   return n;
 }
+function parseDeviceScaleFactor(raw) {
+  const n = parseFloat(raw);
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new Error(
+      `--device-scale-factor must be a positive number (got "${raw}")`
+    );
+  }
+  if (n > 4) {
+    throw new Error(
+      `--device-scale-factor must be <= 4 to avoid excessive pixel counts (got "${raw}")`
+    );
+  }
+  return n;
+}
 var AD_HOC_SESSION_NAME = "__screenshot_ad_hoc__";
 async function resolveSessionForScreenshot(options, sessionName, headers) {
   if (sessionName) {
@@ -3320,6 +3335,7 @@ async function screenshotCommand(options, argsList, context) {
     const height = parseDimension(options.height, "height");
     const navTimeout = parseInt(options.timeout, 10) || 3e4;
     const delayMs = options.delay ? parseInt(options.delay, 10) : 0;
+    const deviceScaleFactor = options.deviceScaleFactor ? parseDeviceScaleFactor(options.deviceScaleFactor) : void 0;
     const session = await resolveSessionForScreenshot(
       options,
       context.sessionName,
@@ -3391,7 +3407,8 @@ async function screenshotCommand(options, argsList, context) {
         timeoutMs: navTimeout,
         inspector: options.inspector,
         quiet: options.quiet,
-        cdpUrl: options.cdpUrl
+        cdpUrl: options.cdpUrl,
+        deviceScaleFactor
       }
     );
     console.log(
@@ -3413,6 +3430,9 @@ function withCommonScreenshotOptions(cmd) {
     "--tool <name>",
     "Tool to call. Its UI resource is rendered with the result."
   ).option("--width <px>", "Browser viewport width in pixels.", "800").option("--height <px>", "Browser viewport height in pixels.", "600").option(
+    "--device-scale-factor <n>",
+    "Device pixel ratio for rendering (e.g. 2 for Retina). Output PNG is (width \xD7 dsf) \xD7 (height \xD7 dsf). Must be > 0 and <= 4."
+  ).option(
     "--inspector <url>",
     "Inspector host that serves /inspector/preview/:view. When omitted, auto-spawns `@mcp-use/inspector` on a free port."
   ).option(
@@ -3890,6 +3910,15 @@ async function callToolCommand(name, toolName, argsList, options) {
           formatInfo(`Capturing widget screenshot (${resourceUri})...`)
         );
         try {
+          const screenshotOpts = {};
+          if (options?.screenshotOutput) {
+            screenshotOpts.output = options.screenshotOutput;
+          }
+          if (options?.screenshotDeviceScaleFactor) {
+            screenshotOpts.deviceScaleFactor = parseDeviceScaleFactor(
+              options.screenshotDeviceScaleFactor
+            );
+          }
           const shot = await captureToolScreenshot(
             {
               session,
@@ -3898,7 +3927,7 @@ async function callToolCommand(name, toolName, argsList, options) {
               toolOutput: callResult,
               resourceUri
             },
-            options?.screenshotOutput ? { output: options.screenshotOutput } : {}
+            screenshotOpts
           );
           screenshot = {
             path: shot.outputPath,
@@ -4344,6 +4373,9 @@ function createPerClientCommand(name) {
   ).option(
     "--screenshot-output <path>",
     "Output PNG path for the widget screenshot (defaults to ./<view>-<timestamp>.png)"
+  ).option(
+    "--screenshot-device-scale-factor <n>",
+    "Device pixel ratio for the auto-screenshot (e.g. 2 for Retina). Defaults to 1."
   ).action(
     (tool, args, options) => callToolCommand(name, tool, args, options)
   );