@tronsfey/ucli 0.5.1 → 0.5.2

package/dist/index.js

@@ -371,7 +371,7 @@ function buildSafeEnv(authEnv) {
 }
 async function runOperation(opts) {
   const bin = resolveOpenapi2CliBin();
-  const { entry, operationArgs, format, query } = opts;
+  const { entry, operationArgs, format, query, machine, dryRun } = opts;
   const args = [
     "run",
     "--oas",
@@ -379,6 +379,8 @@ async function runOperation(opts) {
     "--cache-ttl",
     String(entry.cacheTtl),
     ...entry.baseEndpoint ? ["--endpoint", entry.baseEndpoint] : [],
+    ...machine ? ["--machine"] : [],
+    ...dryRun ? ["--dry-run"] : [],
     ...format ? ["--format", format] : [],
     ...query ? ["--query", query] : [],
     ...operationArgs
@@ -582,7 +584,7 @@ Service: ${entry.name}`);
 
 // src/commands/run.ts
 function registerRun(program2) {
-  program2.command("run [service] [args...]").description("Execute an operation on a service").option("--service <name>", "Service name (from `services list`)").option("--operation <id>", "OperationId to execute").option("--params <json>", "JSON string of operation parameters").option("--format <fmt>", "Output format: json | table | yaml", "json").option("--query <jmespath>", "Filter response with JMESPath expression").option("--data <json>", "Request body (JSON string or @filename)").allowUnknownOption(true).action(async (serviceArg, args, opts) => {
+  program2.command("run [service] [args...]").description("Execute an operation on a service").option("--service <name>", "Service name (from `services list`)").option("--operation <id>", "OperationId to execute").option("--params <json>", "JSON string of operation parameters").option("--format <fmt>", "Output format: json | table | yaml", "json").option("--query <jmespath>", "Filter response with JMESPath expression").option("--data <json>", "Request body (JSON string or @filename)").option("--machine", "Agent-friendly mode: structured JSON envelope output").option("--dry-run", "Preview the HTTP request without executing (implies --machine)").allowUnknownOption(true).action(async (serviceArg, args, opts) => {
     if (serviceArg && opts.service && serviceArg !== opts.service) {
       outputError(
         ExitCode.USAGE_ERROR,
@@ -638,12 +640,16 @@ function registerRun(program2) {
     }
     const format = opts.format;
     const query = opts.query;
+    const machine = opts.machine ?? false;
+    const dryRun = opts.dryRun ?? false;
     try {
       await runOperation({
         entry,
         operationArgs,
         ...format !== void 0 ? { format } : {},
-        ...query !== void 0 ? { query } : {}
+        ...query !== void 0 ? { query } : {},
+        ...machine ? { machine } : {},
+        ...dryRun ? { dryRun } : {}
       });
     } catch (err) {
       outputError(
@@ -814,12 +820,14 @@ function resolve(mod, name) {
   throw new Error(`Cannot resolve export "${name}" from module`);
 }
 async function getMcp2cli() {
-  const clientMod = await import("./client-LCWUZRZX.js");
-  const runnerMod = await import("./runner-HH357SRR.js");
+  const clientMod = await import("./client-Y6NONDCI.js");
+  const runnerMod = await import("./runner-ROLDMGH3.js");
   return {
     createMcpClient: resolve(clientMod, "createMcpClient"),
     getTools: resolve(runnerMod, "getTools"),
-    runTool: resolve(runnerMod, "runTool")
+    runTool: resolve(runnerMod, "runTool"),
+    describeTool: resolve(runnerMod, "describeTool"),
+    describeToolJson: resolve(runnerMod, "describeToolJson")
   };
 }
 async function closeClient(client) {
@@ -853,7 +861,24 @@ async function listMcpTools(entry) {
     await closeClient(client);
   }
 }
-async function runMcpTool(entry, toolName, rawArgs) {
+async function describeMcpTool(entry, toolName, opts) {
+  const { createMcpClient, getTools, describeTool, describeToolJson } = await getMcp2cli();
+  const config = buildMcpConfig(entry);
+  const client = await createMcpClient(config);
+  try {
+    const tools = await getTools(client, config, { noCache: false, cacheTtl: 3600 });
+    const tool = tools.find((t) => t.name === toolName);
+    if (!tool) throw new Error(`Tool "${toolName}" not found on MCP server "${entry.name}"`);
+    if (opts?.json) {
+      describeToolJson(tool);
+    } else {
+      describeTool(tool);
+    }
+  } finally {
+    await closeClient(client);
+  }
+}
+async function runMcpTool(entry, toolName, rawArgs, opts) {
   const { createMcpClient, getTools, runTool } = await getMcp2cli();
   const config = buildMcpConfig(entry);
   const client = await createMcpClient(config);
@@ -872,7 +897,10 @@ async function runMcpTool(entry, toolName, rawArgs) {
         normalizedArgs.push(arg);
       }
     }
-    await runTool(client, tool, normalizedArgs, {});
+    await runTool(client, tool, normalizedArgs, {
+      ...opts?.json ? { json: true } : {},
+      ...opts?.inputJson ? { inputJson: opts.inputJson } : {}
+    });
   } finally {
     await closeClient(client);
   }
@@ -961,7 +989,26 @@ Tools on "${serverName}":`);
     }
     console.log();
   });
-  mcp.command("run <server> <tool> [args...]").description("Call a tool on a MCP server").action(async (serverName, toolName, args) => {
+  mcp.command("describe <server> <tool>").description("Show detailed schema for a tool on a MCP server").option("--json", "Output full schema as JSON (for agent consumption)").action(async (serverName, toolName, opts) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getMCP(serverName);
+    } catch {
+      outputError(
+        ExitCode.NOT_FOUND,
+        `Unknown MCP server: ${serverName}`,
+        "Run: ucli mcp list  to see available servers"
+      );
+    }
+    try {
+      await describeMcpTool(entry, toolName, { json: opts.json });
+    } catch (err) {
+      outputError(ExitCode.GENERAL_ERROR, `Failed to describe tool: ${err.message}`);
+    }
+  });
+  mcp.command("run <server> <tool> [args...]").description("Call a tool on a MCP server").option("--json", "Machine-readable JSON output").option("--input-json <json>", "Pass tool arguments as a JSON object").action(async (serverName, toolName, args, opts) => {
     const cfg = getConfig();
     const client = new ServerClient(cfg);
     let entry;
@@ -975,7 +1022,10 @@ Tools on "${serverName}":`);
       );
     }
     try {
-      await runMcpTool(entry, toolName, args);
+      await runMcpTool(entry, toolName, args, {
+        json: opts.json,
+        inputJson: opts.inputJson
+      });
     } catch (err) {
       outputError(ExitCode.GENERAL_ERROR, `Tool execution failed: ${err.message}`);
     }
@@ -1307,12 +1357,14 @@ function getCommandReference() {
     {
       name: "run",
       description: "Execute an operation on an OAS service",
-      usage: "ucli run <service> <operation> [--format json|table|yaml] [--query <jmespath>] [--data <json|@file>] [--params <json>]",
+      usage: "ucli run <service> <operation> [--format json|table|yaml] [--query <jmespath>] [--data <json|@file>] [--params <json>] [--machine] [--dry-run]",
       examples: [
         "ucli run payments listTransactions",
         "ucli run payments getTransaction --transactionId txn_123",
         `ucli run payments createCharge --data '{"amount": 5000, "currency": "USD"}'`,
-        'ucli run inventory listProducts --query "items[?stock > `0`].name"'
+        'ucli run inventory listProducts --query "items[?stock > `0`].name"',
+        "ucli run payments listTransactions --machine",
+        `ucli run payments createCharge --dry-run --data '{"amount": 5000}'`
       ]
     },
     {
@@ -1333,13 +1385,24 @@ function getCommandReference() {
         "ucli mcp tools weather --format json"
       ]
     },
+    {
+      name: "mcp describe",
+      description: "Show detailed schema for a tool on a MCP server",
+      usage: "ucli mcp describe <server> <tool> [--json]",
+      examples: [
+        "ucli mcp describe weather get_forecast",
+        "ucli mcp describe weather get_forecast --json"
+      ]
+    },
     {
       name: "mcp run",
       description: "Call a tool on a MCP server",
-      usage: "ucli mcp run <server> <tool> [key=value ...]",
+      usage: "ucli mcp run <server> <tool> [key=value ...] [--json] [--input-json <json>]",
       examples: [
         'ucli mcp run weather get_forecast location="New York"',
-        'ucli mcp run search web_search query="ucli docs" limit=5'
+        'ucli mcp run search web_search query="ucli docs" limit=5',
+        `ucli mcp run weather get_forecast --input-json '{"location": "New York"}'`,
+        'ucli mcp run weather get_forecast --json location="New York"'
       ]
     },
     {