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

package/dist/index.js

@@ -3259,6 +3259,11 @@ function parseDeviceScaleFactor(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) {
@@ -3387,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(
@@ -3900,12 +3917,14 @@ async function callToolCommand(name, toolName, argsList, options) {
     const callResult = await session.callTool(toolName, args, {
       timeout: options?.timeout
     });
+    const toolWithMeta = session.tools.find((t) => t.name === toolName);
+    const resourceUri = detectToolResourceUri(toolWithMeta);
+    const wantsScreenshot = options?.screenshot === true || options?.screenshotOutput !== void 0 || options?.screenshotDeviceScaleFactor !== void 0;
     let screenshot = null;
     let screenshotError = null;
-    if (options?.screenshot !== false) {
-      const tool2 = session.tools.find((t) => t.name === toolName);
-      const resourceUri = detectToolResourceUri(tool2);
-      if (resourceUri) {
+    let widgetHintUri = null;
+    if (resourceUri) {
+      if (wantsScreenshot) {
         console.error(
           formatInfo(`Capturing widget screenshot (${resourceUri})...`)
         );
@@ -3938,6 +3957,8 @@ async function callToolCommand(name, toolName, argsList, options) {
         } catch (err) {
           screenshotError = err?.message ?? String(err);
         }
+      } else {
+        widgetHintUri = resourceUri;
       }
     }
     if (options?.json) {
@@ -3957,6 +3978,13 @@ async function callToolCommand(name, toolName, argsList, options) {
         formatWarning(`Skipped widget screenshot: ${screenshotError}`)
       );
     }
+    if (widgetHintUri) {
+      console.error(
+        formatInfo(
+          `This tool renders a widget (${widgetHintUri}). Re-run with --screenshot to save a PNG of it.`
+        )
+      );
+    }
     if (callResult.isError) {
       await cleanupAndExit(1);
     }
@@ -4368,14 +4396,14 @@ function createPerClientCommand(name) {
   toolsCommand.command("call <tool> [args...]").description(
     "Call a tool. Args as key=value pairs (use key:=<json> for nested values, or pass a JSON object)"
   ).option("--timeout <ms>", "Request timeout in milliseconds", parseInt).option("--json", "Output as JSON").option(
-    "--no-screenshot",
-    "Skip the auto-screenshot for tools that render a widget"
+    "--screenshot",
+    "Capture a PNG screenshot of the rendered widget for tools that declare a UI resource"
   ).option(
     "--screenshot-output <path>",
-    "Output PNG path for the widget screenshot (defaults to ./<view>-<timestamp>.png)"
+    "Output PNG path for the widget screenshot (implies --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."
+    "Device pixel ratio for the widget screenshot (implies --screenshot; e.g. 2 for Retina). Defaults to 1."
   ).action(
     (tool, args, options) => callToolCommand(name, tool, args, options)
   );