@qverisai/cli 0.1.0 → 0.3.0

package/README.md

@@ -57,7 +57,7 @@ tool: weather_gov...  ·  id: 7ebcaf9d-...
 **One-liner (recommended):**
 
 ```bash
-curl -fsSL https://qveris.ai/install | bash
+curl -fsSL https://qveris.ai/cli/install | bash
 ```
 
 **Or via npm:**
@@ -242,6 +242,28 @@ qveris discover "weather" --api-key "sk-1_..."
 
 **Resolution order:** `--api-key` flag > `QVERIS_API_KEY` env > config file
 
+### Region
+
+The API region is auto-detected from your key prefix:
+
+| Key prefix | Region | Base URL |
+|------------|--------|----------|
+| `sk-xxx` | Global | `https://qveris.ai/api/v1` |
+| `sk-cn-xxx` | China | `https://qveris.cn/api/v1` |
+
+No extra configuration needed. To override manually:
+
+```bash
+# Via environment variable
+export QVERIS_REGION=cn
+
+# Or set a custom base URL
+export QVERIS_BASE_URL=https://custom.endpoint/api/v1
+
+# Or per-command
+qveris discover "weather" --base-url https://qveris.cn/api/v1
+```
+
 ### Config File
 
 Located at `~/.config/qveris/config.json` (respects `XDG_CONFIG_HOME`).
@@ -313,9 +335,9 @@ QVeris CLI uses only Node.js built-in APIs. No `chalk`, no `commander`, no `yarg
 
 ## Links
 
-- Website: https://qveris.ai
+- Website: https://qveris.ai (global) / https://qveris.cn (China)
 - API Docs: https://qveris.ai/docs
-- Get API Key: https://qveris.ai/account?page=api-keys
+- Get API Key: https://qveris.ai/account?page=api-keys (global) / https://qveris.cn/account?page=api-keys (China)
 - GitHub: https://github.com/QVerisAI/QVerisAI
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qverisai/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "QVeris CLI -- discover, inspect, and call 10,000+ capabilities",
   "type": "module",
   "bin": {

package/scripts/install.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # QVeris CLI Installer
-# Usage: curl -fsSL https://qveris.ai/install | bash
+# Usage: curl -fsSL https://qveris.ai/cli/install | bash
 set -euo pipefail
 
 BOLD='\033[1m'

package/src/client/api.mjs

@@ -1,8 +1,8 @@
-import { resolve } from "../config/resolve.mjs";
+import { resolveBaseUrl } from "../config/region.mjs";
 import { CliError } from "../errors/handler.mjs";
 
-function getBaseUrl(flagValue) {
-  return resolve("base_url", flagValue).value;
+function getBaseUrl(baseUrlFlag, apiKey) {
+  return resolveBaseUrl({ baseUrlFlag, apiKey }).baseUrl;
 }
 
 async function requestJson(path, { method = "POST", query = {}, body, timeoutMs = 30000, apiKey, baseUrl }) {
@@ -10,7 +10,7 @@ async function requestJson(path, { method = "POST", query = {}, body, timeoutMs
   const timeout = setTimeout(() => controller.abort(), timeoutMs);
 
   try {
-    const url = new URL(baseUrl.replace(/\/$/, "") + path);
+    const url = new URL(baseUrl.replace(/\/+$/, "") + path);
     for (const [key, value] of Object.entries(query)) {
       if (value !== undefined && value !== null) {
         url.searchParams.set(key, String(value));
@@ -35,8 +35,6 @@ async function requestJson(path, { method = "POST", query = {}, body, timeoutMs
         jsonBody = JSON.parse(rawText);
         errorDetail = jsonBody.error_message || jsonBody.message || null;
       } catch { /* not JSON */ }
-      // For known error codes, pass errorDetail only if it's a meaningful message
-      // (not raw JSON); otherwise let the CliError template message apply
       if (status === 401 || status === 403) throw new CliError("AUTH_INVALID_KEY", errorDetail);
       if (status === 402) throw new CliError("CREDITS_INSUFFICIENT", errorDetail);
       if (status === 429) throw new CliError("RATE_LIMITED", errorDetail);
@@ -60,12 +58,12 @@ async function requestJson(path, { method = "POST", query = {}, body, timeoutMs
 }
 
 export async function discoverTools({ apiKey, baseUrl: baseUrlFlag, query, limit = 5, timeoutMs = 30000 }) {
-  const baseUrl = getBaseUrl(baseUrlFlag);
+  const baseUrl = getBaseUrl(baseUrlFlag, apiKey);
   return requestJson("/search", { apiKey, baseUrl, body: { query, limit }, timeoutMs });
 }
 
 export async function inspectToolsByIds({ apiKey, baseUrl: baseUrlFlag, toolIds, discoveryId, timeoutMs = 30000 }) {
-  const baseUrl = getBaseUrl(baseUrlFlag);
+  const baseUrl = getBaseUrl(baseUrlFlag, apiKey);
   const body = { tool_ids: toolIds };
   if (discoveryId) body.search_id = discoveryId;
   return requestJson("/tools/by-ids", { apiKey, baseUrl, body, timeoutMs });
@@ -80,7 +78,7 @@ export async function callTool({
   maxResponseSize = 102400,
   timeoutMs = 120000,
 }) {
-  const baseUrl = getBaseUrl(baseUrlFlag);
+  const baseUrl = getBaseUrl(baseUrlFlag, apiKey);
   return requestJson("/tools/execute", {
     apiKey,
     baseUrl,
@@ -93,4 +91,3 @@ export async function callTool({
     timeoutMs,
   });
 }
-

package/src/commands/interactive.mjs

@@ -5,7 +5,9 @@ import { resolveParams } from "../utils/params.mjs";
 import { formatDiscoverResult, formatInspectResult, formatCallResult } from "../output/formatter.mjs";
 import { generateSnippet } from "../output/codegen.mjs";
 import { writeSession } from "../session/session.mjs";
+import { VERSION } from "../config/defaults.mjs";
 import { bold, dim, cyan } from "../output/colors.mjs";
+import { printWelcomeBanner } from "../output/banner.mjs";
 import { handleError } from "../errors/handler.mjs";
 import { createSpinner } from "../output/spinner.mjs";
 
@@ -22,7 +24,11 @@ export async function runInteractive(flags) {
     lastCallContext: null,
   };
 
-  console.log(`\n  ${bold("QVeris Interactive Mode")}`);
+  if (!flags.json) {
+    printWelcomeBanner({ version: VERSION, noColor: flags.noColor, compact: true });
+  }
+
+  console.log(`  ${bold("QVeris Interactive Mode")}`);
   console.log(`  ${dim("Type 'help' for commands, 'exit' to quit.")}\n`);
 
   const rl = createInterface({

package/src/commands/login.mjs

@@ -4,7 +4,9 @@ import { platform } from "node:os";
 import { resolve } from "../config/resolve.mjs";
 import { setConfigValue, deleteConfigValue } from "../config/store.mjs";
 import { discoverTools } from "../client/api.mjs";
+import { VERSION } from "../config/defaults.mjs";
 import { bold, green, red, dim, cyan } from "../output/colors.mjs";
+import { printLoginBanner } from "../output/banner.mjs";
 
 const ACCOUNT_URL = "https://qveris.ai/account?page=api-keys";
 
@@ -91,7 +93,11 @@ export async function runLogin(flags) {
     return;
   }
 
-  console.log(`\n  Get your API key at: ${cyan(ACCOUNT_URL)}\n`);
+  if (!flags.json) {
+    printLoginBanner({ version: VERSION, noColor: flags.noColor });
+  }
+
+  console.log(`  Get your API key at: ${cyan(ACCOUNT_URL)}\n`);
 
   if (!flags.noBrowser) {
     openBrowser(ACCOUNT_URL);

package/src/config/region.mjs

@@ -0,0 +1,64 @@
+/**
+ * Region resolution for QVeris API.
+ *
+ * Priority: --base-url flag > QVERIS_BASE_URL env > QVERIS_REGION env > key prefix auto-detect > default (global)
+ *
+ * Key prefix convention:
+ *   sk-cn-xxx  → cn region  (qveris.cn)
+ *   sk-xxx     → global     (qveris.ai)
+ */
+
+const REGION_URLS = {
+  global: "https://qveris.ai/api/v1",
+  cn: "https://qveris.cn/api/v1",
+};
+
+/**
+ * Detect region from API key prefix.
+ * @param {string} apiKey
+ * @returns {"cn"|"global"}
+ */
+export function detectRegionFromKey(apiKey) {
+  if (typeof apiKey === "string" && apiKey.startsWith("sk-cn-")) return "cn";
+  return "global";
+}
+
+/**
+ * Resolve the base URL for the QVeris API.
+ *
+ * Priority:
+ *   1. Explicit base URL (--base-url flag or QVERIS_BASE_URL env)
+ *   2. Explicit region (QVERIS_REGION env or config)
+ *   3. Auto-detect from API key prefix
+ *   4. Default: global (qveris.ai)
+ *
+ * @param {{ baseUrlFlag?: string, apiKey?: string }} options
+ * @returns {{ baseUrl: string, region: string, source: string }}
+ */
+export function resolveBaseUrl({ baseUrlFlag, apiKey } = {}) {
+  // 1. Explicit base URL flag or env var
+  if (baseUrlFlag) {
+    return { baseUrl: baseUrlFlag.replace(/\/+$/, ""), region: "custom", source: "flag" };
+  }
+  if (process.env.QVERIS_BASE_URL) {
+    return { baseUrl: process.env.QVERIS_BASE_URL.replace(/\/+$/, ""), region: "custom", source: "env (QVERIS_BASE_URL)" };
+  }
+
+  // 2. Explicit region env var
+  if (process.env.QVERIS_REGION) {
+    const region = process.env.QVERIS_REGION.toLowerCase();
+    const url = REGION_URLS[region] || REGION_URLS.global;
+    return { baseUrl: url, region, source: "env (QVERIS_REGION)" };
+  }
+
+  // 3. Auto-detect from API key prefix
+  if (apiKey) {
+    const region = detectRegionFromKey(apiKey);
+    return { baseUrl: REGION_URLS[region], region, source: "auto (key prefix)" };
+  }
+
+  // 4. Default
+  return { baseUrl: REGION_URLS.global, region: "global", source: "default" };
+}
+
+export { REGION_URLS };

package/src/main.mjs

@@ -2,6 +2,7 @@ import { normalizeLegacyArgs } from "./compat/aliases.mjs";
 import { handleError } from "./errors/handler.mjs";
 import { VERSION } from "./config/defaults.mjs";
 import { bold, dim, cyan } from "./output/colors.mjs";
+import { printWelcomeBanner } from "./output/banner.mjs";
 
 export async function main(argv) {
   const rawArgs = argv.slice(2);
@@ -12,6 +13,10 @@ export async function main(argv) {
   }
 
   const flags = extractGlobalFlags(args);
+  if (flags.noColor) {
+    process.env.NO_COLOR = "1";
+  }
+
   const positional = flags._positional;
   const command = positional[0];
   const rest = positional.slice(1);
@@ -22,7 +27,7 @@ export async function main(argv) {
   }
 
   if (!command || flags.help) {
-    printUsage();
+    printUsage(flags);
     return;
   }
 
@@ -202,9 +207,13 @@ function extractGlobalFlags(args) {
   return flags;
 }
 
-function printUsage() {
+function printUsage(flags = {}) {
+  if (!flags.json) {
+    printWelcomeBanner({ version: VERSION, noColor: flags.noColor, compact: false });
+  }
+
   console.log(`
-  ${bold("QVeris CLI")} ${dim(`v${VERSION}`)} -- discover, inspect, and call 10,000+ capabilities
+  ${bold("QVeris CLI")} — ${dim("discover, inspect, and call 10,000+ capabilities")}
 
   ${bold("Usage:")}
     qveris <command> [args] [flags]

package/src/output/banner.mjs

@@ -0,0 +1,241 @@
+/**
+ * Welcome / login banners: gradient on solid block letters (brand cyan → indigo).
+ * Figlet font "Banner3" (filled #), mapped to █ for stronger contrast.
+ */
+
+import { homedir } from "node:os";
+import { cwd as processCwd } from "node:process";
+import { dim, cyan, isColorEnabled } from "./colors.mjs";
+
+/** @type {readonly [number, number, number][]} brand stops: highlight → mid → shadow */
+const BRAND_STOPS = [
+  [0, 242, 255], // #00F2FF
+  [0, 153, 255], // #0099FF
+  [26, 0, 255], // #1A00FF
+];
+
+const RESET = "\x1b[0m";
+
+/** Figlet -f Banner3 QVERIS (53 cols × 7 rows). # → █ at render. */
+const ASCII_QVERIS_HASH = [
+  " #######  ##     ## ######## ########  ####  ######  ",
+  "##     ## ##     ## ##       ##     ##  ##  ##    ## ",
+  "##     ## ##     ## ##       ##     ##  ##  ##       ",
+  "##     ## ##     ## ######   ########   ##   ######  ",
+  "##  ## ##  ##   ##  ##       ##   ##    ##        ## ",
+  "##    ##    ## ##   ##       ##    ##   ##  ##    ## ",
+  " ##### ##    ###    ######## ##     ## ####  ######  ",
+].join("\n");
+
+function solidBlockLines() {
+  return ASCII_QVERIS_HASH.split("\n").map((line) => line.replace(/#/g, "█"));
+}
+
+function colorDepth() {
+  try {
+    return typeof process.stdout.getColorDepth === "function"
+      ? process.stdout.getColorDepth()
+      : 8;
+  } catch {
+    return 8;
+  }
+}
+
+function lerp(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+
+/** RGB along multi-stop gradient, t in [0,1]. */
+function rgbAt(t) {
+  const n = BRAND_STOPS.length - 1;
+  const x = Math.min(1, Math.max(0, t)) * n;
+  const i = Math.min(Math.floor(x), n - 1);
+  const f = x - i;
+  const [r1, g1, b1] = BRAND_STOPS[i];
+  const [r2, g2, b2] = BRAND_STOPS[i + 1];
+  return [lerp(r1, r2, f), lerp(g1, g2, f), lerp(b1, b2, f)];
+}
+
+function truecolorFg(r, g, b) {
+  return `\x1b[38;2;${r};${g};${b}m`;
+}
+
+/**
+ * Map column index to gradient color (horizontal sweep across the banner).
+ * Spaces stay uncolored. Consecutive non-space chars with identical RGB share one SGR span.
+ */
+function paintLineTruecolor(line, maxCols) {
+  if (!line.length) return "";
+  const denom = Math.max(1, maxCols - 1);
+  let out = "";
+  let i = 0;
+  while (i < line.length) {
+    const ch = line[i];
+    if (ch === " ") {
+      out += ch;
+      i++;
+      continue;
+    }
+    const t0 = i / denom;
+    const [r0, g0, b0] = rgbAt(t0);
+    let j = i + 1;
+    while (j < line.length) {
+      const chj = line[j];
+      if (chj === " ") break;
+      const t = j / denom;
+      const [r, g, b] = rgbAt(t);
+      if (r !== r0 || g !== g0 || b !== b0) break;
+      j++;
+    }
+    out += truecolorFg(r0, g0, b0) + line.slice(i, j) + RESET;
+    i = j;
+  }
+  return out;
+}
+
+/** 16-color fallback: batched SGR per band (cyan / bold cyan / dim cyan). */
+function paintLineFallback(line, maxCols) {
+  if (!isColorEnabled()) return line;
+  const denom = Math.max(1, maxCols - 1);
+  let out = "";
+  let i = 0;
+  while (i < line.length) {
+    const ch = line[i];
+    if (ch === " ") {
+      out += ch;
+      i++;
+      continue;
+    }
+    const band0 = Math.min(2, Math.floor((i / denom) * 3));
+    let j = i + 1;
+    while (j < line.length) {
+      const chj = line[j];
+      if (chj === " ") break;
+      const band = Math.min(2, Math.floor((j / denom) * 3));
+      if (band !== band0) break;
+      j++;
+    }
+    const chunk = line.slice(i, j);
+    if (band0 === 0) out += `\x1b[36m${chunk}\x1b[0m`;
+    else if (band0 === 1) out += `\x1b[1;36m${chunk}\x1b[0m`;
+    else out += `\x1b[2;36m${chunk}\x1b[0m`;
+    i = j;
+  }
+  return out;
+}
+
+export function bannerColorAllowed(noColorFlag) {
+  if (noColorFlag) return false;
+  return isColorEnabled();
+}
+
+function shortenPath(p) {
+  const home = homedir();
+  if (p === home) return "~";
+  if (p.startsWith(home + "/")) return "~" + p.slice(home.length);
+  return p;
+}
+
+/** Strip SGR ANSI sequences (truecolor / 16-color). */
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+
+const RE_HAN = /\p{Script=Han}/u;
+const RE_HANGUL = /\p{Script=Hangul}/u;
+
+/** Terminal display width: CJK/Hangul/fullwidth = 2 cols (matches typical monospace). */
+function displayWidth(str) {
+  let w = 0;
+  for (const ch of str) {
+    const cp = ch.codePointAt(0);
+    if (RE_HAN.test(ch) || RE_HANGUL.test(ch)) w += 2;
+    else if (cp >= 0xff01 && cp <= 0xff60) w += 2; // fullwidth forms
+    else w += 1;
+  }
+  return w;
+}
+
+function centerBlock(lines, termCols) {
+  const widths = lines.map((l) => displayWidth(stripAnsi(l)));
+  const maxW = Math.max(...widths, 1);
+  const pad = termCols >= maxW + 4 ? Math.max(0, Math.floor((termCols - maxW) / 2)) : 2;
+  const prefix = " ".repeat(pad);
+  return lines.map((l) => prefix + l);
+}
+
+/**
+ * @param {object} opts
+ * @param {string} opts.version
+ * @param {boolean} [opts.noColor]
+ * @param {boolean} [opts.compact] — fewer blank lines (e.g. interactive)
+ */
+export function printWelcomeBanner(opts) {
+  const { version, noColor = false, compact = false } = opts;
+  if (!bannerColorAllowed(noColor)) {
+    printPlainBanner({ version, compact });
+    return;
+  }
+
+  const rawLines = solidBlockLines();
+  const maxW = Math.max(...rawLines.map((l) => l.length));
+  const termCols = process.stdout.columns || 80;
+  const useTc = colorDepth() >= 24;
+
+  const painted = rawLines.map((line) => {
+    const padded = line.padEnd(maxW);
+    return useTc ? paintLineTruecolor(padded, maxW) : paintLineFallback(padded, maxW);
+  });
+  const centered = centerBlock(painted, termCols);
+
+  const nl = compact ? "\n" : "\n\n";
+  console.log(nl + centered.join("\n"));
+
+  const tag = "✦ Discover · Inspect · Call · 10,000+ capabilities · intelligent orchestration ✦";
+  const meta = dim(`v${version} · ${shortenPath(processCwd())}`);
+  const tagLine = centerLine(dim(cyan(tag)), termCols);
+  const metaLine = centerLine(meta, termCols);
+
+  console.log("\n" + tagLine + "\n" + metaLine + (compact ? "\n" : "\n\n"));
+}
+
+function centerLine(text, termCols) {
+  const len = displayWidth(stripAnsi(text));
+  const pad = termCols >= len + 4 ? Math.max(0, Math.floor((termCols - len) / 2)) : 2;
+  return " ".repeat(pad) + text;
+}
+
+function printPlainBanner({ version, compact }) {
+  const rawLines = solidBlockLines();
+  const termCols = process.stdout.columns || 80;
+  const centered = centerBlock(rawLines, termCols);
+  const nl = compact ? "\n" : "\n\n";
+  console.log(nl + centered.join("\n"));
+  const tag = "✦ Discover · Inspect · Call · 10,000+ capabilities · intelligent orchestration ✦";
+  const meta = `v${version} · ${shortenPath(processCwd())}`;
+  const tagLine = centerLine(dim(tag), termCols);
+  const metaLine = centerLine(dim(meta), termCols);
+  console.log("\n" + tagLine + "\n" + metaLine + (compact ? "\n" : "\n\n"));
+}
+
+/**
+ * Login screen: banner + framed hint (cyan border).
+ */
+export function printLoginBanner(opts) {
+  const { version, noColor = false } = opts;
+  printWelcomeBanner({ version, noColor, compact: true });
+
+  if (!bannerColorAllowed(noColor)) {
+    console.log(dim("  ─ Secure login · paste your API key below"));
+    return;
+  }
+
+  const termCols = process.stdout.columns || 80;
+  const inner = " Secure login · API key ";
+  const maxInner = Math.min(inner.length + 4, termCols - 4);
+  const bar = "─".repeat(Math.max(8, maxInner));
+  const top = centerLine(cyan("╭" + bar + "╮"), termCols);
+  const mid = centerLine(cyan("│") + dim(inner) + cyan("│"), termCols);
+  const bot = centerLine(cyan("╰" + bar + "╯"), termCols);
+  console.log(top + "\n" + mid + "\n" + bot + "\n");
+}

package/src/output/colors.mjs

@@ -1,9 +1,13 @@
-const enabled =
-  !process.env.NO_COLOR &&
-  (process.env.FORCE_COLOR === "1" || (process.stdout.isTTY && process.stderr.isTTY));
+let memoizedEnabled;
+export const isColorEnabled = () => {
+  if (memoizedEnabled !== undefined) return memoizedEnabled;
+  memoizedEnabled = !process.env.NO_COLOR &&
+    (process.env.FORCE_COLOR === "1" || (process.stdout.isTTY && process.stderr.isTTY));
+  return memoizedEnabled;
+};
 
-const code = (open, close) =>
-  enabled ? (s) => `\x1b[${open}m${s}\x1b[${close}m` : (s) => s;
+const code = (open, close) => (s) =>
+  isColorEnabled() ? `\x1b[${open}m${s}\x1b[${close}m` : s;
 
 export const bold = code("1", "22");
 export const dim = code("2", "22");
@@ -12,5 +16,3 @@ export const green = code("32", "39");
 export const yellow = code("33", "39");
 export const cyan = code("36", "39");
 export const gray = code("90", "39");
-
-export const isColorEnabled = () => enabled;