@qverisai/cli 0.5.0 → 0.6.1

package/src/errors/codes.mjs

@@ -29,9 +29,24 @@ export const ERROR_CODES = {
   },
   PARAMS_INVALID_JSON: {
     message: "Invalid JSON in --params",
-    hint: "Check JSON syntax in --params value",
+    hint: "Check JSON syntax in --params value, or pass a file with --params @params.json",
     exit: EX_USAGE,
   },
+  INIT_PARAMS_REQUIRED: {
+    message: "Init could not infer safe parameters for the selected capability",
+    hint: "Run 'qveris inspect 1' to review required params, then rerun 'qveris init --resume --params <json>'",
+    exit: EX_USAGE,
+  },
+  TOOL_CALL_FAILED: {
+    message: "Capability call failed",
+    hint: "Review the error, adjust --params, then rerun 'qveris init --resume --params <json>'",
+    exit: EX_UNAVAILABLE,
+  },
+  PROVIDER_FAILURE: {
+    message: "Remote provider failed",
+    hint: "Try another discovered capability with 'qveris inspect 2' and 'qveris call 2', or rerun discovery with a broader query",
+    exit: EX_UNAVAILABLE,
+  },
   TOOL_NOT_FOUND: {
     message: "Tool not found",
     hint: "Run 'qveris discover' to find available tools",
@@ -44,12 +59,12 @@ export const ERROR_CODES = {
   },
   CREDITS_INSUFFICIENT: {
     message: "Insufficient credits",
-    hint: "Purchase credits at https://qveris.ai/pricing",
+    hint: "Purchase credits at https://qveris.ai/pricing, then confirm balance with 'qveris credits'",
     exit: EX_NOPERM,
   },
   SESSION_EXPIRED: {
     message: "Session expired",
-    hint: "Run 'qveris discover' to start a new session",
+    hint: "Run 'qveris discover' or 'qveris init' to start a new session",
     exit: EX_USAGE,
   },
 };

package/src/main.mjs

@@ -52,6 +52,11 @@ export async function main(argv) {
         await runCall(rest[0], flags);
         break;
       }
+      case "init": {
+        const { runInit } = await import("./commands/init.mjs");
+        await runInit(rest.join(" "), flags);
+        break;
+      }
       case "login": {
         const { runLogin } = await import("./commands/login.mjs");
         await runLogin(flags);
@@ -90,6 +95,14 @@ export async function main(argv) {
         await runConfig(subcommand, subArgs, flags);
         break;
       }
+      case "mcp": {
+        const subcommand = rest[0];
+        const subArgs = rest.slice(1);
+        if (!subcommand) { console.error("  Usage: qveris mcp <configure|validate> [target]"); process.exitCode = 2; return; }
+        const { runMcp } = await import("./commands/mcp.mjs");
+        await runMcp(subcommand, subArgs, flags);
+        break;
+      }
       case "interactive":
       case "repl": {
         const { runInteractive } = await import("./commands/interactive.mjs");
@@ -129,6 +142,7 @@ const VALUE_FLAGS = {
   "api-key": "apiKey", "base-url": "baseUrl", timeout: "timeout",
   limit: "limit", "discovery-id": "discoveryId", params: "params",
   "max-size": "maxSize", codegen: "codegen", token: "token",
+  query: "query", "tool-id": "toolId", target: "target", output: "output",
   mode: "mode", "start-date": "startDate", "end-date": "endDate",
   bucket: "bucket", "execution-id": "executionId", "search-id": "searchId",
   "event-type": "eventType", kind: "kind", success: "success",
@@ -192,6 +206,18 @@ function extractGlobalFlags(args) {
         flags.version = true; break;
       case "--dry-run":
         flags.dryRun = true; break;
+      case "--write":
+        flags.write = true; break;
+      case "--print":
+        flags.print = true; break;
+      case "--include-key":
+        flags.includeKey = true; break;
+      case "--validate":
+        flags.validate = true; break;
+      case "--probe":
+        flags.probe = true; break;
+      case "--resume":
+        flags.resume = true; break;
       case "--no-browser":
         flags.noBrowser = true; break;
       case "--clear":
@@ -214,6 +240,14 @@ function extractGlobalFlags(args) {
         flags.codegen = takeNext(args, i++, arg); break;
       case "--token":
         flags.token = takeNext(args, i++, arg); break;
+      case "--target":
+        flags.target = takeNext(args, i++, arg); break;
+      case "--output":
+        flags.output = takeNext(args, i++, arg); break;
+      case "--query":
+        flags.query = takeNext(args, i++, arg); break;
+      case "--tool-id":
+        flags.toolId = takeNext(args, i++, arg); break;
       case "--mode":
         flags.mode = takeNext(args, i++, arg); break;
       case "--start-date":
@@ -262,6 +296,7 @@ function printUsage(flags = {}) {
     qveris <command> [args] [flags]
 
   ${bold("Core Commands:")}
+    ${cyan("init")}                         Guided first-call wizard
     ${cyan("discover")} <query>             Find capabilities by natural language
     ${cyan("inspect")}  <tool_id|index>     View tool details, parameters, and stats
     ${cyan("call")}     <tool_id|index>     Execute a capability
@@ -276,6 +311,7 @@ function printUsage(flags = {}) {
 
   ${bold("Configuration:")}
     ${cyan("config")}   set|get|list|reset  Manage CLI settings
+    ${cyan("mcp")}      configure|validate   Generate and validate MCP client config
 
   ${bold("Utilities:")}
     ${cyan("interactive")}                  Launch interactive REPL mode
@@ -288,6 +324,14 @@ function printUsage(flags = {}) {
     --api-key <key>        Override API key
     --base-url <url>       Override API base URL
     --timeout <seconds>    Request timeout
+    --target <target>      MCP target: cursor | claude-desktop | claude-code | opencode | openclaw | generic
+    --output <path>        MCP config output path
+    --write                Write MCP config to disk
+    --include-key          Include resolved API key instead of placeholder
+    --probe                Start MCP server and verify visible tools during validation
+    --query <query>        Init discovery query override
+    --tool-id <id>         Init selected capability override
+    --resume               Resume init from the last discovery session
     --mode <mode>          summary | search | export-file for usage/ledger
     --start-date <date>    Usage/ledger range start (YYYY-MM-DD)
     --end-date <date>      Usage/ledger range end (YYYY-MM-DD)
@@ -304,10 +348,15 @@ function printUsage(flags = {}) {
     QVERIS_BASE_URL        Custom API base URL
 
   ${bold("Examples:")}
+    qveris init
+    qveris init --query "weather forecast API"
+    qveris init --resume --params '{"city": "London"}'
     qveris discover "weather forecast API"
     qveris inspect 1
     qveris call 1 --params '{"city": "London"}'
     qveris call 1 --params @params.json --codegen curl
+    qveris mcp configure --target cursor --write --include-key
+    qveris mcp validate --target cursor
     qveris usage --mode search --execution-id <id>
     qveris ledger --mode search --min-credits 50 --direction consume
     qveris interactive

package/src/output/formatter.mjs

@@ -23,7 +23,7 @@ export function formatDiscoverResult(result) {
     const toolId = t.tool_id ?? "";
     const desc = stringifyDesc(t.description);
     const provider = t.provider_name ?? "";
-    const categories = Array.isArray(t.categories) ? t.categories.join(", ") : "";
+    const categories = formatCategories(t.categories);
     const region = t.region ?? "global";
     const stats = t.stats ?? {};
 
@@ -92,7 +92,7 @@ export function formatInspectResult(tools) {
     const desc = stringifyDesc(t.description);
     const provider = t.provider_name ?? "";
     const providerDesc = stringifyDesc(t.provider_description);
-    const categories = Array.isArray(t.categories) ? t.categories.join(", ") : "";
+    const categories = formatCategories(t.categories);
     const region = t.region ?? "global";
     const docsUrl = t.docs_url ?? "";
     const stats = t.stats ?? {};
@@ -290,6 +290,27 @@ function formatSchema(schema, indent = "", depth = 0) {
   return lines.join("\n");
 }
 
+/** Categories may be strings or objects like {slug, name, description}. */
+function formatCategories(categories) {
+  if (!Array.isArray(categories)) return "";
+  const seen = new Set();
+  const names = [];
+  for (const c of categories) {
+    let label = "";
+    if (typeof c === "string") label = c;
+    else if (c && typeof c === "object") {
+      label = stringifyDesc(c.name) || (typeof c.slug === "string" ? c.slug : "");
+    }
+    label = label.trim();
+    if (!label) continue;
+    const key = label.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    names.push(label);
+  }
+  return names.join(", ");
+}
+
 /** Handle description that may be a string, i18n object {en: "...", zh: "..."}, or other. */
 function stringifyDesc(desc) {
   if (!desc) return "";