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

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,25 @@ 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;
+}
+function requiresArguments(inputSchema) {
+  if (!inputSchema || typeof inputSchema !== "object") return false;
+  const required = inputSchema.required;
+  return Array.isArray(required) && required.length > 0;
+}
 var AD_HOC_SESSION_NAME = "__screenshot_ad_hoc__";
 async function resolveSessionForScreenshot(options, sessionName, headers) {
   if (sessionName) {
@@ -3320,6 +3340,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,
@@ -3371,6 +3392,18 @@ async function screenshotCommand(options, argsList, context) {
         exitCode = 1;
         return;
       }
+    } else if (requiresArguments(tool.inputSchema)) {
+      console.error(formatError("This tool requires arguments."));
+      console.log("");
+      console.log(formatInfo("Provide arguments as key=value pairs:"));
+      console.log(
+        `  npx ${context.usagePrefix} --tool ${options.tool} key=value [key2=value2 ...]`
+      );
+      console.log("");
+      console.log(formatInfo("Tool schema:"));
+      console.log(formatSchema(tool.inputSchema));
+      exitCode = 1;
+      return;
     }
     const toolOutput = await session.callTool(options.tool, toolArgs);
     const result = await captureToolScreenshot(
@@ -3391,7 +3424,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 +3447,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 +3927,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 +3944,7 @@ async function callToolCommand(name, toolName, argsList, options) {
               toolOutput: callResult,
               resourceUri
             },
-            options?.screenshotOutput ? { output: options.screenshotOutput } : {}
+            screenshotOpts
           );
           screenshot = {
             path: shot.outputPath,
@@ -4344,6 +4390,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)
   );