@qverisai/cli 0.1.0 → 0.2.0

package/README.md

@@ -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.2.0",
   "description": "QVeris CLI -- discover, inspect, and call 10,000+ capabilities",
   "type": "module",
   "bin": {

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/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 };