@tronsfey/ucli 0.3.0

package/assets/logo.svg

@@ -0,0 +1,138 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 160" width="480" height="160">
+  <defs>
+    <!-- Background gradient border -->
+    <linearGradient id="borderGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#7c3aed"/>
+      <stop offset="100%" stop-color="#2563eb"/>
+    </linearGradient>
+    <!-- Icon accent gradient -->
+    <linearGradient id="hexGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#7c3aed"/>
+      <stop offset="100%" stop-color="#38bdf8"/>
+    </linearGradient>
+    <!-- Glow filter -->
+    <filter id="glow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="softGlow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="6" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <!-- Clip path for rounded rect -->
+    <clipPath id="cardClip">
+      <rect width="480" height="160" rx="14" ry="14"/>
+    </clipPath>
+  </defs>
+
+  <!-- Card background -->
+  <rect width="480" height="160" rx="14" ry="14" fill="#0d1117"/>
+
+  <!-- Subtle gradient overlay -->
+  <rect width="480" height="160" rx="14" ry="14" fill="url(#borderGrad)" opacity="0.06"/>
+
+  <!-- Border stroke -->
+  <rect x="1" y="1" width="478" height="158" rx="13" ry="13"
+        fill="none" stroke="url(#borderGrad)" stroke-width="1.5" opacity="0.8"/>
+
+  <!-- ── Left panel: gateway icon ── -->
+  <!-- Central hexagon (API gateway node) -->
+  <g transform="translate(80, 80)" filter="url(#softGlow)">
+    <!-- Hexagon shape (flat-top) -->
+    <polygon
+      points="0,-36 31.2,-18 31.2,18 0,36 -31.2,18 -31.2,-18"
+      fill="#0d1117"
+      stroke="url(#hexGrad)"
+      stroke-width="2.5"
+    />
+    <!-- Inner hex fill accent -->
+    <polygon
+      points="0,-26 22.5,-13 22.5,13 0,26 -22.5,13 -22.5,-13"
+      fill="#7c3aed"
+      opacity="0.15"
+    />
+
+    <!-- Center dot -->
+    <circle cx="0" cy="0" r="5" fill="#38bdf8" opacity="0.9"/>
+
+    <!-- Route lines (3 spokes, 120° apart) -->
+    <!-- Right spoke (0°) -->
+    <line x1="5" y1="0" x2="28" y2="0" stroke="#38bdf8" stroke-width="1.8" stroke-linecap="round" opacity="0.85"/>
+    <circle cx="28" cy="0" r="3.5" fill="#38bdf8" opacity="0.85"/>
+
+    <!-- Lower-left spoke (120°) -->
+    <line x1="-2.5" y1="4.3" x2="-16" y2="27.7" stroke="#38bdf8" stroke-width="1.8" stroke-linecap="round" opacity="0.85"/>
+    <circle cx="-16" cy="27.7" r="3.5" fill="#38bdf8" opacity="0.85"/>
+
+    <!-- Upper-left spoke (240°) -->
+    <line x1="-2.5" y1="-4.3" x2="-16" y2="-27.7" stroke="#38bdf8" stroke-width="1.8" stroke-linecap="round" opacity="0.85"/>
+    <circle cx="-16" cy="-27.7" r="3.5" fill="#38bdf8" opacity="0.85"/>
+  </g>
+
+  <!-- Vertical divider -->
+  <line x1="142" y1="24" x2="142" y2="136" stroke="#30363d" stroke-width="1"/>
+
+  <!-- ── Right panel: text ── -->
+  <!-- Main title -->
+  <text
+    x="165" y="68"
+    font-family="'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', ui-monospace, monospace"
+    font-size="32"
+    font-weight="700"
+    letter-spacing="1"
+    fill="#e6edf3"
+  >OAS GATEWAY</text>
+
+  <!-- Subtitle -->
+  <text
+    x="166" y="95"
+    font-family="'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', ui-monospace, monospace"
+    font-size="13"
+    font-weight="400"
+    letter-spacing="0.5"
+    fill="#7d8590"
+  >by tronsfey</text>
+
+  <!-- Tag line -->
+  <text
+    x="166" y="122"
+    font-family="'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', ui-monospace, monospace"
+    font-size="11"
+    font-weight="400"
+    letter-spacing="0.3"
+    fill="#3d444d"
+  >OpenAPI · NestJS · CLI · AES-256-GCM</text>
+
+  <!-- Version badge -->
+  <g transform="translate(165, 132)">
+    <rect x="0" y="0" width="62" height="18" rx="9" fill="#1a2332" stroke="#2563eb" stroke-width="1" opacity="0.9"/>
+    <text
+      x="31" y="13"
+      text-anchor="middle"
+      font-family="'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', ui-monospace, monospace"
+      font-size="9.5"
+      font-weight="600"
+      fill="#2563eb"
+      letter-spacing="0.3"
+    >npm public</text>
+  </g>
+
+  <g transform="translate(234, 132)">
+    <rect x="0" y="0" width="52" height="18" rx="9" fill="#1a2a1a" stroke="#22c55e" stroke-width="1" opacity="0.9"/>
+    <text
+      x="26" y="13"
+      text-anchor="middle"
+      font-family="'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', ui-monospace, monospace"
+      font-size="9.5"
+      font-weight="600"
+      fill="#22c55e"
+      letter-spacing="0.3"
+    >v0.2.0</text>
+  </g>
+</svg>

package/dist/index.js

@@ -0,0 +1,550 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { createRequire as createRequire2 } from "module";
+
+// src/config.ts
+import Conf from "conf";
+import { homedir } from "os";
+import { join } from "path";
+var conf = new Conf({
+  projectName: "ucli",
+  schema: {
+    serverUrl: { type: "string" },
+    token: { type: "string" }
+  }
+});
+var cacheDir = join(homedir(), ".cache", "ucli");
+function getConfig() {
+  const serverUrl = conf.get("serverUrl");
+  const token = conf.get("token");
+  if (!serverUrl || !token) {
+    console.error("ucli is not configured. Run: ucli configure --server <url> --token <jwt>");
+    process.exit(1);
+  }
+  return { serverUrl, token };
+}
+function saveConfig(cfg) {
+  conf.set("serverUrl", cfg.serverUrl);
+  conf.set("token", cfg.token);
+}
+function isConfigured() {
+  return Boolean(conf.get("serverUrl") && conf.get("token"));
+}
+
+// src/lib/server-client.ts
+import axios from "axios";
+var ServerClient = class {
+  http;
+  constructor(cfg) {
+    this.http = axios.create({
+      baseURL: cfg.serverUrl.replace(/\/$/, ""),
+      headers: {
+        Authorization: `Bearer ${cfg.token}`,
+        "Content-Type": "application/json"
+      },
+      timeout: 15e3
+    });
+    this.http.interceptors.response.use(
+      (r) => r,
+      (err) => {
+        if (axios.isAxiosError(err)) {
+          const status = err.response?.status;
+          const message = err.response?.data?.message ?? err.message;
+          if (status === 401) {
+            console.error("Authentication failed. Run: ucli configure --server <url> --token <jwt>");
+            process.exit(1);
+          }
+          throw new Error(`Server error ${status ?? "unknown"}: ${message}`);
+        }
+        throw err;
+      }
+    );
+  }
+  async listOAS() {
+    const { data } = await this.http.get("/api/v1/oas");
+    return data;
+  }
+  async getOAS(name) {
+    const { data } = await this.http.get(`/api/v1/oas/${encodeURIComponent(name)}`);
+    return data;
+  }
+  async listMCP() {
+    const { data } = await this.http.get("/api/v1/mcp");
+    return data;
+  }
+  async getMCP(name) {
+    const { data } = await this.http.get(`/api/v1/mcp/${encodeURIComponent(name)}`);
+    return data;
+  }
+};
+
+// src/commands/configure.ts
+function registerConfigure(program2) {
+  program2.command("configure").description("Configure the OAS Gateway server URL and authentication token").requiredOption("--server <url>", "OAS Gateway server URL (e.g. https://oas.example.com)").requiredOption("--token <jwt>", "Group JWT token issued by the server admin").action(async (opts) => {
+    const serverUrl = opts.server.replace(/\/$/, "");
+    const token = opts.token;
+    console.log(`Connecting to ${serverUrl}...`);
+    const client = new ServerClient({ serverUrl, token });
+    try {
+      await client.listOAS();
+      saveConfig({ serverUrl, token });
+      console.log("\u2713 Configuration saved successfully.");
+      console.log(`  Server: ${serverUrl}`);
+      console.log(`  Token:  ${token.slice(0, 20)}...`);
+    } catch (err) {
+      console.error("Connection failed:", err.message);
+      console.error("Please check the server URL and token.");
+      process.exit(1);
+    }
+  });
+}
+
+// src/lib/cache.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { join as join2 } from "path";
+var LIST_CACHE_FILE = join2(cacheDir, "oas-list.json");
+async function ensureCacheDir() {
+  await mkdir(cacheDir, { recursive: true });
+}
+async function readOASListCache() {
+  try {
+    const raw = await readFile(LIST_CACHE_FILE, "utf8");
+    const cached = JSON.parse(raw);
+    const age = (Date.now() - cached.fetchedAt) / 1e3;
+    if (cached.ttlSec === 0 || age > cached.ttlSec) return null;
+    return cached.entries;
+  } catch {
+    return null;
+  }
+}
+async function writeOASListCache(entries, ttlSec) {
+  await ensureCacheDir();
+  const cached = { entries, fetchedAt: Date.now(), ttlSec };
+  await writeFile(LIST_CACHE_FILE, JSON.stringify(cached, null, 2), "utf8");
+}
+async function clearOASListCache() {
+  try {
+    await writeFile(LIST_CACHE_FILE, "{}", "utf8");
+  } catch {
+  }
+}
+
+// src/lib/oas-runner.ts
+import { spawn } from "child_process";
+import { createRequire } from "module";
+import { join as join3, dirname } from "path";
+var require2 = createRequire(import.meta.url);
+function resolveOpenapi2CliBin() {
+  try {
+    const pkgPath = require2.resolve("@tronsfey/openapi2cli/package.json");
+    const pkgDir = dirname(pkgPath);
+    const pkg2 = require2("@tronsfey/openapi2cli/package.json");
+    const binEntry = pkg2.bin?.["openapi2cli"] ?? "bin/openapi2cli.js";
+    return join3(pkgDir, binEntry);
+  } catch {
+    throw new Error(
+      "@tronsfey/openapi2cli is not installed. Run: pnpm add @tronsfey/openapi2cli in packages/cli"
+    );
+  }
+}
+function buildAuthEnv(entry) {
+  const cfg = entry.authConfig;
+  const prefix = entry.name.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+  switch (cfg["type"]) {
+    case "bearer":
+      return { [`${prefix}_TOKEN`]: cfg["token"] };
+    case "api_key":
+      return { [`${prefix}_API_KEY`]: cfg["key"] };
+    case "basic":
+      return { [`${prefix}_CREDENTIALS`]: `${cfg["username"]}:${cfg["password"]}` };
+    case "oauth2_cc":
+      return {
+        [`${prefix}_CLIENT_ID`]: cfg["clientId"],
+        [`${prefix}_CLIENT_SECRET`]: cfg["clientSecret"],
+        [`${prefix}_SCOPES`]: cfg["scopes"].join(" ")
+      };
+    default:
+      return {};
+  }
+}
+async function runOperation(opts) {
+  const bin = resolveOpenapi2CliBin();
+  const { entry, operationArgs, format, query } = opts;
+  const args = [
+    "run",
+    "--oas",
+    entry.remoteUrl,
+    "--cache-ttl",
+    String(entry.cacheTtl),
+    ...entry.baseEndpoint ? ["--endpoint", entry.baseEndpoint] : [],
+    ...format ? ["--format", format] : [],
+    ...query ? ["--query", query] : [],
+    ...operationArgs
+  ];
+  const authEnv = buildAuthEnv(entry);
+  await new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [bin, ...args], {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        ...authEnv
+        // inject auth — not visible to parent shell
+      }
+    });
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`openapi2cli exited with code ${code}`));
+    });
+    child.on("error", reject);
+  });
+}
+async function getServiceHelp(entry) {
+  const bin = resolveOpenapi2CliBin();
+  const args = [
+    "run",
+    "--oas",
+    entry.remoteUrl,
+    "--cache-ttl",
+    String(entry.cacheTtl),
+    "--help"
+  ];
+  return new Promise((resolve, reject) => {
+    let output = "";
+    const child = spawn(process.execPath, [bin, ...args], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    child.stdout?.on("data", (d) => {
+      output += d.toString();
+    });
+    child.stderr?.on("data", (d) => {
+      output += d.toString();
+    });
+    child.on("close", () => resolve(output));
+    child.on("error", reject);
+  });
+}
+
+// src/commands/services.ts
+function registerServices(program2) {
+  const services = program2.command("services").description("Manage and inspect available OAS services");
+  services.command("list").description("List all OAS services available in the current group").option("--no-cache", "Bypass local cache and fetch fresh from server").action(async (opts) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entries = opts.cache ? await readOASListCache() : null;
+    if (!entries) {
+      entries = await client.listOAS();
+      if (entries.length > 0) {
+        const maxTtl = Math.min(...entries.map((e) => e.cacheTtl));
+        await writeOASListCache(entries, maxTtl);
+      }
+    }
+    if (entries.length === 0) {
+      console.log("No services registered in this group.");
+      return;
+    }
+    const nameWidth = Math.max(10, ...entries.map((e) => e.name.length));
+    console.log(`
+${"SERVICE".padEnd(nameWidth)}  AUTH      DESCRIPTION`);
+    console.log(`${"-".repeat(nameWidth)}  --------  ${"-".repeat(40)}`);
+    for (const e of entries) {
+      const auth = e.authType.padEnd(8);
+      const desc = e.description.length > 60 ? e.description.slice(0, 57) + "..." : e.description;
+      console.log(`${e.name.padEnd(nameWidth)}  ${auth}  ${desc}`);
+    }
+    console.log();
+  });
+  services.command("info <name>").description("Show detailed information and available operations for a service").action(async (name) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getOAS(name);
+    } catch (err) {
+      console.error(`Service not found: ${name}`);
+      console.error("Run `ucli services list` to see available services.");
+      process.exit(1);
+    }
+    console.log(`
+Service: ${entry.name}`);
+    console.log(`Description: ${entry.description || "(none)"}`);
+    console.log(`OAS URL: ${entry.remoteUrl}`);
+    if (entry.baseEndpoint) console.log(`Base endpoint: ${entry.baseEndpoint}`);
+    console.log(`Auth type: ${entry.authType}`);
+    console.log(`Cache TTL: ${entry.cacheTtl}s`);
+    console.log("\nAvailable operations:");
+    console.log("\u2500".repeat(60));
+    const help = await getServiceHelp(entry);
+    console.log(help);
+  });
+}
+
+// src/commands/run.ts
+function registerRun(program2) {
+  program2.command("run <service> [args...]").description("Execute an operation on a service").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 (service, args, opts) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getOAS(service);
+    } catch {
+      console.error(`Unknown service: ${service}`);
+      console.error("Run `ucli services list` to see available services.");
+      process.exit(1);
+    }
+    const extraArgs = opts.args ?? [];
+    const operationArgs = [
+      ...args,
+      ...extraArgs,
+      ...opts.data ? ["--data", opts.data] : []
+    ];
+    const format = opts.format;
+    const query = opts.query;
+    try {
+      await runOperation({
+        entry,
+        operationArgs,
+        ...format !== void 0 ? { format } : {},
+        ...query !== void 0 ? { query } : {}
+      });
+    } catch (err) {
+      console.error("Operation failed:", err.message);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/refresh.ts
+function registerRefresh(program2) {
+  program2.command("refresh").description("Force-refresh the local OAS cache from the server").action(async () => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    console.log("Refreshing OAS list from server...");
+    await clearOASListCache();
+    const entries = await client.listOAS();
+    if (entries.length > 0) {
+      const maxTtl = Math.min(...entries.map((e) => e.cacheTtl));
+      await writeOASListCache(entries, maxTtl);
+    }
+    console.log(`\u2713 Refreshed ${entries.length} service(s).`);
+  });
+}
+
+// src/commands/help-cmd.ts
+function registerHelp(program2) {
+  program2.command("help [service]").description("Show usage guide. Pass a service name for service-specific operations.").action(async (service) => {
+    if (!service) {
+      printGeneralHelp();
+      if (isConfigured()) {
+        const cfg2 = getConfig();
+        const client2 = new ServerClient(cfg2);
+        let entries = await readOASListCache();
+        if (!entries) {
+          entries = await client2.listOAS();
+          if (entries.length > 0) {
+            const maxTtl = Math.min(...entries.map((e) => e.cacheTtl));
+            await writeOASListCache(entries, maxTtl);
+          }
+        }
+        if (entries.length > 0) {
+          console.log("\nAvailable services:");
+          for (const e of entries) {
+            console.log(`  ${e.name.padEnd(20)} ${e.description}`);
+          }
+          console.log("\nTip: Run `ucli help <service>` for service-specific operations.");
+        }
+      } else {
+        console.log("\nRun `ucli configure --server <url> --token <jwt>` to get started.");
+      }
+      return;
+    }
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getOAS(service);
+    } catch {
+      console.error(`Unknown service: ${service}`);
+      console.error("Run `ucli services list` to see available services.");
+      process.exit(1);
+    }
+    console.log(`
+=== ${entry.name} ===`);
+    console.log(`${entry.description}`);
+    console.log(`
+OAS spec: ${entry.remoteUrl}`);
+    console.log("\nOperations:");
+    console.log("\u2500".repeat(60));
+    const help = await getServiceHelp(entry);
+    console.log(help);
+    console.log("\nExamples:");
+    console.log(`  ucli run ${entry.name} <operation>`);
+    console.log(`  ucli run ${entry.name} <operation> --format table`);
+    console.log(`  ucli run ${entry.name} <operation> --query "results[*].id"`);
+    console.log(`  ucli run ${entry.name} <operation> --data '{"key":"value"}'`);
+  });
+}
+function printGeneralHelp() {
+  console.log(`
+ucli \u2014 OpenAPI & MCP Gateway for AI Agents
+\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
+
+SETUP
+  ucli configure --server <url> --token <jwt>
+      Configure server connection and authentication.
+
+DISCOVERY
+  ucli services list
+      List all OAS services available in your group.
+
+  ucli services info <service>
+      Show detailed service info and all available operations.
+
+  ucli help [service]
+      Show this guide, or service-specific operations.
+
+EXECUTION
+  ucli run <service> <operation> [options]
+      Execute a service operation.
+
+      Options:
+        --format json|table|yaml   Output format (default: json)
+        --query <jmespath>         Filter response with JMESPath
+        --data <json|@file>        Request body for POST/PUT/PATCH
+
+MAINTENANCE
+  ucli refresh
+      Force-refresh the local OAS cache from the server.
+
+ERRORS
+  401 Unauthorized  \u2192 Run: ucli configure --server <url> --token <jwt>
+  404 Not Found     \u2192 Check service name: ucli services list
+  4xx Client Error  \u2192 Check operation args: ucli services info <service>
+  5xx Server Error  \u2192 Retry or run: ucli refresh
+`);
+}
+
+// src/lib/mcp-runner.ts
+async function getMcp2cli() {
+  const clientMod = await import("@tronsfey/mcp2cli/dist/client/index.js");
+  const runnerMod = await import("@tronsfey/mcp2cli/dist/runner/index.js");
+  return { createMcpClient: clientMod.createMcpClient, getTools: runnerMod.getTools, runTool: runnerMod.runTool };
+}
+function buildMcpConfig(entry) {
+  const base = { type: entry.transport };
+  if (entry.transport === "http") {
+    base.url = entry.serverUrl;
+  } else {
+    base.command = entry.command;
+  }
+  const auth = entry.authConfig;
+  if (auth.type === "http_headers") {
+    base.headers = auth.headers;
+  } else if (auth.type === "env") {
+    base.env = auth.env;
+  }
+  return base;
+}
+async function listMcpTools(entry) {
+  const { createMcpClient, getTools } = await getMcp2cli();
+  const config = buildMcpConfig(entry);
+  const client = await createMcpClient(config);
+  const tools = await getTools(client, config, { noCache: true });
+  return tools;
+}
+async function runMcpTool(entry, toolName, rawArgs) {
+  const { createMcpClient, getTools, runTool } = await getMcp2cli();
+  const config = buildMcpConfig(entry);
+  const client = await createMcpClient(config);
+  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}"`);
+  await runTool(client, tool, rawArgs, {});
+}
+
+// src/commands/mcp.ts
+function registerMcp(program2) {
+  const mcp = program2.command("mcp").description("Interact with MCP servers registered in your group");
+  mcp.command("list").description("List all MCP servers available in the current group").action(async () => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    const entries = await client.listMCP();
+    if (entries.length === 0) {
+      console.log("No MCP servers registered in this group.");
+      return;
+    }
+    const nameWidth = Math.max(10, ...entries.map((e) => e.name.length));
+    console.log(`
+${"SERVER".padEnd(nameWidth)}  TRANSPORT  DESCRIPTION`);
+    console.log(`${"-".repeat(nameWidth)}  ---------  ${"-".repeat(40)}`);
+    for (const e of entries) {
+      const desc = e.description.length > 60 ? e.description.slice(0, 57) + "..." : e.description;
+      console.log(`${e.name.padEnd(nameWidth)}  ${e.transport.padEnd(9)}  ${desc}`);
+    }
+    console.log();
+  });
+  mcp.command("tools <server>").description("List tools available on a MCP server").action(async (serverName) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getMCP(serverName);
+    } catch {
+      console.error(`Unknown MCP server: ${serverName}`);
+      console.error("Run `ucli mcp list` to see available servers.");
+      process.exit(1);
+    }
+    let tools;
+    try {
+      tools = await listMcpTools(entry);
+    } catch (err) {
+      console.error("Failed to fetch tools:", err.message);
+      process.exit(1);
+    }
+    if (tools.length === 0) {
+      console.log(`No tools found on MCP server "${serverName}".`);
+      return;
+    }
+    console.log(`
+Tools on "${serverName}":`);
+    console.log("\u2500".repeat(60));
+    for (const t of tools) {
+      console.log(`  ${t.name}`);
+      if (t.description) console.log(`    ${t.description}`);
+    }
+    console.log();
+  });
+  mcp.command("run <server> <tool> [args...]").description("Call a tool on a MCP server").action(async (serverName, toolName, args) => {
+    const cfg = getConfig();
+    const client = new ServerClient(cfg);
+    let entry;
+    try {
+      entry = await client.getMCP(serverName);
+    } catch {
+      console.error(`Unknown MCP server: ${serverName}`);
+      console.error("Run `ucli mcp list` to see available servers.");
+      process.exit(1);
+    }
+    try {
+      await runMcpTool(entry, toolName, args);
+    } catch (err) {
+      console.error("Tool execution failed:", err.message);
+      process.exit(1);
+    }
+  });
+}
+
+// src/index.ts
+var require3 = createRequire2(import.meta.url);
+var pkg = require3("../package.json");
+var program = new Command();
+program.name("ucli").description(pkg.description).version(pkg.version, "-v, --version").addHelpCommand(false);
+registerConfigure(program);
+registerServices(program);
+registerRun(program);
+registerRefresh(program);
+registerMcp(program);
+registerHelp(program);
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map