@okx_ai/okx-trade-cli 1.3.2-beta.1 → 1.3.2-beta.3

package/dist/index.js

@@ -892,19 +892,19 @@ import { get as httpsGet } from "https";
 import { get as httpGet } from "http";
 var EXEC_TIMEOUT_MS = 3e4;
 var ALLOWED_DOMAIN_RE = /^[\w.-]+\.okx\.com$/;
-var DOH_BIN_DIR = join(homedir(), ".okx", "bin");
-function getDohBinaryPath() {
-  if (process.env.OKX_DOH_BINARY_PATH) {
-    return process.env.OKX_DOH_BINARY_PATH;
+var PILOT_BIN_DIR = join(homedir(), ".okx", "bin");
+function getPilotBinaryPath() {
+  if (process.env.OKX_PILOT_BINARY_PATH) {
+    return process.env.OKX_PILOT_BINARY_PATH;
   }
   const ext = process.platform === "win32" ? ".exe" : "";
-  return join(DOH_BIN_DIR, `okx-pilot${ext}`);
+  return join(PILOT_BIN_DIR, `okx-pilot${ext}`);
 }
-function execDohBinary(domain, exclude = [], userAgent) {
+function execPilotBinary(domain, exclude = [], userAgent) {
   if (!ALLOWED_DOMAIN_RE.test(domain)) {
     return Promise.resolve(null);
   }
-  const binPath = getDohBinaryPath();
+  const binPath = getPilotBinaryPath();
   const args = ["--domain", domain];
   if (exclude.length > 0) {
     args.push("--exclude", exclude.join(","));
@@ -937,7 +937,7 @@ function execDohBinary(domain, exclude = [], userAgent) {
   });
 }
 function getDefaultCachePath() {
-  return process.env.OKX_DOH_CACHE_PATH || join2(homedir2(), ".okx", "doh-cache.json");
+  return process.env.OKX_PILOT_CACHE_PATH || join2(homedir2(), ".okx", "pilot-cache.json");
 }
 function readCache(hostname, cachePath = getDefaultCachePath()) {
   try {
@@ -991,7 +991,7 @@ function getActiveFailedNodes(nodes) {
   const now = Date.now();
   return nodes.filter((n) => now - n.failedAt < FAILED_NODE_TTL_MS);
 }
-function resolveDoh(hostname, cachePath) {
+function resolvePilot(hostname, cachePath) {
   const entry = readCache(hostname, cachePath);
   if (entry) {
     if (entry.mode === "direct") {
@@ -1003,53 +1003,53 @@ function resolveDoh(hostname, cachePath) {
   }
   return { mode: null, node: null };
 }
-async function reResolveDoh(hostname, failedIp, userAgent, cachePath) {
+async function reResolvePilot(hostname, failedIp, userAgent, cachePath) {
   const entry = readCache(hostname, cachePath);
   const active = getActiveFailedNodes(entry?.failedNodes);
   const now = Date.now();
   const alreadyFailed = failedIp && active.some((n) => n.ip === failedIp);
   const failedNodes = failedIp && !alreadyFailed ? [...active, { ip: failedIp, failedAt: now }] : active;
   const excludeIps = failedNodes.map((n) => n.ip);
-  const node = await execDohBinary(hostname, excludeIps, userAgent);
+  const node = await execPilotBinary(hostname, excludeIps, userAgent);
   return classifyAndCache(node, hostname, failedNodes, cachePath);
 }
 function vlog(message) {
   process.stderr.write(`[verbose] ${message}
 `);
 }
-var DohManager = class {
+var PilotManager = class {
   opts;
-  // DoH proxy state (lazy-resolved on first request)
-  dohResolved = false;
-  dohRetried = false;
+  // Pilot proxy state (lazy-resolved on first request)
+  pilotResolved = false;
+  pilotRetried = false;
   directUnverified = false;
   // The first direct connection has not yet been verified
-  dohNode = null;
-  dohAgent = null;
-  dohBaseUrl = null;
+  pilotNode = null;
+  pilotAgent = null;
+  pilotBaseUrl = null;
   constructor(opts) {
     this.opts = opts;
   }
   /**
-   * Lazily resolve the DoH proxy node on the first request.
+   * Lazily resolve the Pilot proxy node on the first request.
    * Uses cache-first strategy via the resolver.
    */
-  prepareDoh() {
-    if (this.dohResolved || this.opts.hasCustomProxy) return;
-    this.dohResolved = true;
+  preparePilot() {
+    if (this.pilotResolved || this.opts.hasCustomProxy) return;
+    this.pilotResolved = true;
     try {
       const { hostname, protocol } = new URL(this.opts.baseUrl);
-      const result = resolveDoh(hostname);
+      const result = resolvePilot(hostname);
       if (!result.mode) {
         this.directUnverified = true;
         if (this.opts.verbose) {
-          vlog("DoH: no cache, trying direct connection first");
+          vlog("Pilot: no cache, trying direct connection first");
         }
         return;
       }
       if (result.mode === "direct") {
         if (this.opts.verbose) {
-          vlog("DoH: mode=direct (overseas or cached), using direct connection");
+          vlog("Pilot: mode=direct (overseas or cached), using direct connection");
         }
         return;
       }
@@ -1059,57 +1059,57 @@ var DohManager = class {
     } catch (err) {
       if (this.opts.verbose) {
         const cause = err instanceof Error ? err.message : String(err);
-        vlog(`DoH resolution failed, falling back to direct: ${cause}`);
+        vlog(`Pilot resolution failed, falling back to direct: ${cause}`);
       }
     }
   }
   /** Get connection parameters for the current request. */
   getConnectionParams() {
-    const baseUrl = this.dohNode ? this.dohBaseUrl : this.opts.baseUrl;
+    const baseUrl = this.pilotNode ? this.pilotBaseUrl : this.opts.baseUrl;
     const result = { baseUrl };
-    if (this.dohAgent) {
-      result.dispatcher = this.dohAgent;
+    if (this.pilotAgent) {
+      result.dispatcher = this.pilotAgent;
     }
-    if (this.dohNode) {
-      result.userAgent = this.dohUserAgent;
+    if (this.pilotNode) {
+      result.userAgent = this.pilotUserAgent;
     }
     return result;
   }
-  /** Whether a DoH proxy node is currently active. */
+  /** Whether a Pilot proxy node is currently active. */
   get isProxyActive() {
-    return this.dohNode !== null;
+    return this.pilotNode !== null;
   }
   /** Whether we have already retried after network failure. */
   get hasRetried() {
-    return this.dohRetried;
+    return this.pilotRetried;
   }
   /**
    * Handle network failure: re-resolve with --exclude and retry once.
    * Returns true if retry should proceed, false if already retried.
    */
   async handleNetworkFailure() {
-    if (this.dohRetried) return false;
-    this.dohRetried = true;
-    const failedIp = this.dohNode?.ip ?? "";
+    if (this.pilotRetried) return false;
+    this.pilotRetried = true;
+    const failedIp = this.pilotNode?.ip ?? "";
     const { hostname, protocol } = new URL(this.opts.baseUrl);
-    this.dohNode = null;
-    this.dohAgent = null;
-    this.dohBaseUrl = null;
+    this.pilotNode = null;
+    this.pilotAgent = null;
+    this.pilotBaseUrl = null;
     if (!failedIp) this.directUnverified = false;
     if (this.opts.verbose) {
-      vlog(failedIp ? `DoH: proxy node ${failedIp} failed, re-resolving with --exclude` : "DoH: direct connection failed, calling binary for DoH resolution");
+      vlog(failedIp ? `Pilot: proxy node ${failedIp} failed, re-resolving with --exclude` : "Pilot: direct connection failed, calling binary for Pilot resolution");
     }
     try {
-      const result = await reResolveDoh(hostname, failedIp, this.dohUserAgent);
+      const result = await reResolvePilot(hostname, failedIp, this.pilotUserAgent);
       if (result.mode === "proxy" && result.node) {
         this.applyNode(result.node, protocol);
-        this.dohRetried = false;
+        this.pilotRetried = false;
         return true;
       }
     } catch {
     }
     if (this.opts.verbose) {
-      vlog("DoH: re-resolution failed or switched to direct, retrying with direct connection");
+      vlog("Pilot: re-resolution failed or switched to direct, retrying with direct connection");
     }
     return true;
   }
@@ -1118,7 +1118,7 @@ var DohManager = class {
    * (Even if the business response is an error, the network path is valid.)
    */
   cacheDirectIfNeeded() {
-    if (!this.directUnverified || this.dohNode) return;
+    if (!this.directUnverified || this.pilotNode) return;
     this.directUnverified = false;
     const { hostname } = new URL(this.opts.baseUrl);
     writeCache(hostname, {
@@ -1128,25 +1128,25 @@ var DohManager = class {
       updatedAt: Date.now()
     });
     if (this.opts.verbose) {
-      vlog("DoH: direct connection succeeded, cached mode=direct");
+      vlog("Pilot: direct connection succeeded, cached mode=direct");
     }
   }
-  /** User-Agent for DoH proxy requests: OKX/@okx_ai/{packageName}/{version} */
-  get dohUserAgent() {
+  /** User-Agent for Pilot proxy requests: OKX/@okx_ai/{packageName}/{version} */
+  get pilotUserAgent() {
     return `OKX/@okx_ai/${this.opts.packageUserAgent ?? "unknown"}`;
   }
   /**
-   * Apply a DoH node: set up the custom Agent + base URL.
+   * Apply a Pilot node: set up the custom Agent + base URL.
    *
    * node.ip may be a real IP or a domain (CNAME like *.aliyunddos1021.com).
    * - Real IP → use directly in lookup callback
    * - Domain  → dns.lookup on every connection to get a fresh IP
    */
   applyNode(node, protocol) {
-    this.dohNode = node;
-    this.dohBaseUrl = `${protocol}//${node.host}`;
+    this.pilotNode = node;
+    this.pilotBaseUrl = `${protocol}//${node.host}`;
     const nodeIpIsRealIp = !!isIP(node.ip);
-    this.dohAgent = new Agent({
+    this.pilotAgent = new Agent({
       connect: {
         lookup: (_hostname, options, callback) => {
           if (nodeIpIsRealIp) {
@@ -1170,7 +1170,7 @@ var DohManager = class {
       }
     });
     if (this.opts.verbose) {
-      vlog(`DoH proxy active: \u2192 ${node.host} (${node.ip}), ttl=${node.ttl}s`);
+      vlog(`Pilot proxy active: \u2192 ${node.host} (${node.ip}), ttl=${node.ttl}s`);
     }
   }
 };
@@ -1392,14 +1392,14 @@ var OkxRestClient = class _OkxRestClient {
   config;
   rateLimiter;
   dispatcher;
-  doh;
+  pilot;
   constructor(config) {
     this.config = config;
     this.rateLimiter = new RateLimiter(3e4, config.verbose);
     if (config.proxyUrl) {
       this.dispatcher = new ProxyAgent(config.proxyUrl);
     }
-    this.doh = new DohManager({
+    this.pilot = new PilotManager({
       baseUrl: config.baseUrl,
       packageUserAgent: config.userAgent,
       verbose: config.verbose,
@@ -1582,12 +1582,12 @@ var OkxRestClient = class _OkxRestClient {
    * Security: validates Content-Type and enforces maxBytes limit.
    */
   async privatePostBinary(path42, body, opts) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const maxBytes = opts?.maxBytes ?? _OkxRestClient.DEFAULT_MAX_BYTES;
     const expectedCT = opts?.expectedContentType ?? "application/octet-stream";
     const bodyJson = body ? JSON.stringify(body) : "";
     const endpoint = `POST ${path42}`;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     this.logRequest("POST", `${conn.baseUrl}${path42}`, "private");
     const reqConfig = { method: "POST", path: path42, auth: "private" };
     const headers = this.buildHeaders(reqConfig, path42, bodyJson, getNow());
@@ -1599,13 +1599,15 @@ var OkxRestClient = class _OkxRestClient {
     try {
       response = await this.fetchBinary(path42, endpoint, headers, bodyJson, t0);
     } catch (error) {
-      this.doh.handleNetworkFailure().catch(() => {
-      });
+      try {
+        await this.pilot.handleNetworkFailure();
+      } catch {
+      }
       throw error;
     }
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     if (!response.ok) {
       const text = await response.text();
       this.logResponse(response.status, text.length, elapsed, traceId, String(response.status));
@@ -1631,15 +1633,15 @@ var OkxRestClient = class _OkxRestClient {
   /**
    * Send an unauthenticated GET request and return the raw binary response.
    * Used for pre-signed download URLs where auth is embedded in the token.
-   * Inherits proxy, timeout, DoH, and verbose capabilities from the client.
+   * Inherits proxy, timeout, Pilot, and verbose capabilities from the client.
    */
   async publicGetBinary(path42, query, opts) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const maxBytes = opts?.maxBytes ?? _OkxRestClient.DEFAULT_MAX_BYTES;
     const expectedCT = opts?.expectedContentType ?? "application/octet-stream";
     const queryString = buildQueryString(query);
     const requestPath = queryString ? `${path42}?${queryString}` : path42;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     const url = `${conn.baseUrl}${requestPath}`;
     this.logRequest("GET", url, "public");
     const headers = new Headers({ Accept: "application/octet-stream" });
@@ -1655,13 +1657,15 @@ var OkxRestClient = class _OkxRestClient {
         dispatcher: this.dispatcher ?? conn.dispatcher
       });
     } catch (error) {
-      this.doh.handleNetworkFailure().catch(() => {
-      });
+      try {
+        await this.pilot.handleNetworkFailure();
+      } catch {
+      }
       throw new NetworkError(`Failed to call OKX endpoint GET ${path42}.`, `GET ${path42}`, error);
     }
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     if (!response.ok) {
       const text = await response.text();
       this.logResponse(response.status, text.length, elapsed, traceId, String(response.status));
@@ -1686,7 +1690,7 @@ var OkxRestClient = class _OkxRestClient {
   }
   /** Execute fetch for binary endpoint, wrapping network errors. */
   async fetchBinary(path42, endpoint, headers, bodyJson, t0) {
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     try {
       const fetchOptions = {
         method: "POST",
@@ -1733,16 +1737,16 @@ var OkxRestClient = class _OkxRestClient {
   // JSON request
   // ---------------------------------------------------------------------------
   /**
-   * Handle network error during a JSON request: refresh DoH and maybe retry.
+   * Handle network error during a JSON request: refresh Pilot and maybe retry.
    * Always either returns a retry result or throws NetworkError.
    */
   async handleRequestNetworkError(error, reqConfig, requestPath, t0) {
-    if (!this.doh.hasRetried) {
+    if (!this.pilot.hasRetried) {
       if (this.config.verbose) {
         const cause = error instanceof Error ? error.message : String(error);
-        vlog2(`Network failure, refreshing DoH: ${cause}`);
+        vlog2(`Network failure, refreshing Pilot: ${cause}`);
       }
-      const shouldRetry = await this.doh.handleNetworkFailure();
+      const shouldRetry = await this.pilot.handleNetworkFailure();
       if (shouldRetry && (reqConfig.method === "GET" || reqConfig.retryOnNetworkError)) {
         return this.request(reqConfig);
       }
@@ -1759,10 +1763,10 @@ var OkxRestClient = class _OkxRestClient {
     );
   }
   async request(reqConfig) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const queryString = buildQueryString(reqConfig.query);
     const requestPath = queryString.length > 0 ? `${reqConfig.path}?${queryString}` : reqConfig.path;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     const url = `${conn.baseUrl}${requestPath}`;
     const bodyJson = reqConfig.body ? JSON.stringify(reqConfig.body) : "";
     const timestamp = getNow();
@@ -1791,7 +1795,7 @@ var OkxRestClient = class _OkxRestClient {
     const rawText = await response.text();
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     return this.processResponse(rawText, response, elapsed, traceId, reqConfig, requestPath);
   }
 };
@@ -2248,7 +2252,7 @@ var MODULE_DESCRIPTIONS = {
   bot: "Trading bot strategies (grid, dca)",
   config: "Manage CLI configuration profiles",
   setup: "Set up client integrations (Cursor, Windsurf, Claude, etc.)",
-  doh: "Manage DoH (DNS-over-HTTPS) resolver binary",
+  pilot: "Manage Pilot proxy resolver binary",
   diagnose: "Run network / MCP server diagnostics",
   upgrade: "Upgrade okx CLI and MCP server to the latest stable version",
   skill: SKILLS_MARKETPLACE_DESC
@@ -2398,6 +2402,10 @@ function registerAccountTools() {
           showValuation: {
             type: "boolean",
             description: "Include total asset valuation breakdown by account type (trading/funding/earn). Default false."
+          },
+          valuationCcy: {
+            type: "string",
+            description: "Currency used to denominate the total asset valuation (e.g. USDT, BTC). Default USDT. Only applies when showValuation=true."
           }
         }
       },
@@ -2405,6 +2413,7 @@ function registerAccountTools() {
         const args = asRecord(rawArgs);
         const ccy = readString(args, "ccy");
         const showValuation = readBoolean(args, "showValuation");
+        const valuationCcy = readString(args, "valuationCcy") ?? "USDT";
         if (showValuation) {
           const balanceResp2 = await context.client.privateGet(
             "/api/v5/asset/balances",
@@ -2412,16 +2421,26 @@ function registerAccountTools() {
             privateRateLimit("account_get_asset_balance", 6)
           );
           let valuationData = null;
+          let valuationError;
           try {
             const valuationResp = await context.client.privateGet(
               "/api/v5/asset/asset-valuation",
-              {},
+              { ccy: valuationCcy },
               privateRateLimit("account_get_asset_valuation", 1)
             );
             valuationData = valuationResp.data;
-          } catch {
+          } catch (err) {
+            valuationError = err instanceof Error ? err.message : String(err);
           }
-          return { ...normalizeResponse(balanceResp2), valuation: valuationData };
+          const valuationResult = {
+            ...normalizeResponse(balanceResp2),
+            valuation: valuationData,
+            valuationCcy
+          };
+          if (valuationError !== void 0) {
+            valuationResult["valuationError"] = valuationError;
+          }
+          return valuationResult;
         }
         const balanceResp = await context.client.privateGet(
           "/api/v5/asset/balances",
@@ -6557,9 +6576,9 @@ function registerEventContractTools() {
 var PATH_LEADERBOARD = "/api/v5/orbit/public/leaderboard";
 var PATH_POSITION_CURRENT = "/api/v5/orbit/public/position-current";
 var PATH_TRADE_RECORDS = "/api/v5/orbit/public/trade-records";
-var PATH_OVERVIEW = "/api/v5/journal/public/smartmoney/overview";
-var PATH_SIGNAL = "/api/v5/journal/public/smartmoney/signal";
-var PATH_SIGNAL_HISTORY = "/api/v5/journal/public/smartmoney/signal-history";
+var PATH_OVERVIEW = "/api/v5/journal/smartmoney/overview";
+var PATH_SIGNAL = "/api/v5/journal/smartmoney/signal";
+var PATH_SIGNAL_HISTORY = "/api/v5/journal/smartmoney/signal-history";
 var SIGNAL_POOL_FILTER_PROPS = {
   sortType: {
     type: "string",
@@ -6629,23 +6648,6 @@ function extractLeaderboardData(data) {
   }
   return [];
 }
-var SMARTMONEY_DEMO_MESSAGE = "Smart Money features are not available in demo/simulated trading mode.";
-var SMARTMONEY_DEMO_SUGGESTION = "Switch to a live profile to use Smart Money features.";
-function withSmartmoneyDemoGuard(tool) {
-  const originalHandler = tool.handler;
-  return {
-    ...tool,
-    handler: async (args, context) => {
-      if (context.config.demo) {
-        throw new ConfigError(
-          SMARTMONEY_DEMO_MESSAGE,
-          SMARTMONEY_DEMO_SUGGESTION
-        );
-      }
-      return originalHandler(args, context);
-    }
-  };
-}
 function registerSmartmoneyTools() {
   const tools = [
     /* ---------- 1. Overview ---------- */
@@ -6799,11 +6801,11 @@ function registerSmartmoneyTools() {
           },
           granularity: {
             type: "string",
-            description: "1h or 1d"
+            description: "1h or 1d (default 1h)"
           },
           limit: {
             type: "string",
-            description: "Data points 1-500"
+            description: "Data points 1-500 (default 24)"
           },
           ...SIGNAL_POOL_FILTER_PROPS
         },
@@ -6947,7 +6949,7 @@ function registerSmartmoneyTools() {
       }
     }
   ];
-  return tools.map(withSmartmoneyDemoGuard);
+  return tools;
 }
 function buildContractTradeTools(cfg) {
   const { prefix, module, label, instTypes, instIdExample } = cfg;
@@ -10745,18 +10747,20 @@ var CDN_SOURCES = [
   { host: "static.okx.com", protocol: "https" },
   { host: "static.coinall.ltd", protocol: "https" }
 ];
-var CDN_PATH_PREFIX = "/upgradeapp/doh";
+var CDN_PATH_PREFIX = "/upgradeapp/tools/pilot";
 var DOWNLOAD_TIMEOUT_MS = 3e4;
+var PLATFORM_MAP = {
+  "darwin-arm64": "darwin-arm64",
+  "darwin-x64": "darwin-x64",
+  "linux-arm64": "linux-arm64",
+  "linux-x64": "linux-x64",
+  "win32-arm64": "win32-arm64",
+  "win32-x64": "win32-x64"
+};
 function getPlatformDir() {
   const p = platform();
   const a = arch();
-  const map = {
-    "darwin-arm64": "darwin-arm64",
-    "darwin-x64": "darwin-x64",
-    "linux-x64": "linux-x64",
-    "win32-x64": "win32-x64"
-  };
-  return map[`${p}-${a}`] ?? null;
+  return PLATFORM_MAP[`${p}-${a}`] ?? null;
 }
 function getBinaryName() {
   return platform() === "win32" ? "okx-pilot.exe" : "okx-pilot";
@@ -10768,8 +10772,8 @@ function hashFile(filePath) {
     sha256: createHash("sha256").update(buf).digest("hex")
   };
 }
-function getDohStatus(binaryPath, opts) {
-  const resolvedPath = binaryPath ?? getDohBinaryPath();
+function getPilotStatus(binaryPath, opts) {
+  const resolvedPath = binaryPath ?? getPilotBinaryPath();
   const platformDir = getPlatformDir();
   if (!existsSync6(resolvedPath)) {
     return {
@@ -10861,7 +10865,7 @@ function atomicReplace(tmpPath, resolvedDest) {
   }
 }
 function installPreChecks(destPath, sources) {
-  if (!destPath && process.env.OKX_DOH_BINARY_PATH) {
+  if (!destPath && process.env.OKX_PILOT_BINARY_PATH) {
     return { status: "up-to-date", source: "(env override)" };
   }
   if (!getPlatformDir()) {
@@ -10875,7 +10879,7 @@ function installPreChecks(destPath, sources) {
 function isLocalUpToDate(localHash, checksum) {
   return localHash !== null && localHash.size === checksum.size && localHash.sha256 === checksum.sha256;
 }
-async function installDohBinary(destPath, sources = CDN_SOURCES, onProgress) {
+async function installPilotBinary(destPath, sources = CDN_SOURCES, onProgress) {
   const earlyResult = installPreChecks(destPath, sources);
   if (earlyResult) return earlyResult;
   const platformDir = getPlatformDir();
@@ -10918,8 +10922,8 @@ async function installDohBinary(destPath, sources = CDN_SOURCES, onProgress) {
   return { status: "failed", error: `All CDN sources failed:
 ${errors.join("\n")}` };
 }
-function removeDohBinary(binaryPath) {
-  const resolvedPath = binaryPath ?? getDohBinaryPath();
+function removePilotBinary(binaryPath) {
+  const resolvedPath = binaryPath ?? getPilotBinaryPath();
   try {
     unlinkSync3(resolvedPath);
     return { status: "removed" };
@@ -11642,7 +11646,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "d5c8ab1" : "dev";
+var GIT_HASH = true ? "330e727a" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -11884,42 +11888,42 @@ async function cmdDiagnose(config, profile, options = {}) {
   }
   return runCliChecks(config, profile, options.output);
 }
-async function checkDoh(report) {
-  section("DoH Resolver");
-  const local = getDohStatus();
+async function checkPilot(report) {
+  section("Pilot");
+  const local = getPilotStatus();
   if (!local.exists) {
-    fail("DoH binary", "not installed", [
-      "Run: okx doh install",
+    fail("Pilot binary", "not installed", [
+      "Run: okx pilot install",
       "Or wait for the next npm install to auto-download"
     ]);
-    report.add("doh_binary", "not installed");
+    report.add("pilot_binary", "not installed");
     return;
   }
-  ok("DoH binary", local.binaryPath);
-  report.add("doh_binary", `installed (${local.platform ?? "unknown"})`);
+  ok("Pilot binary", local.binaryPath);
+  report.add("pilot_binary", `installed (${local.platform ?? "unknown"})`);
   const cdnChecksum = await fetchCdnChecksum(void 0, 5e3);
   if (!cdnChecksum) {
-    warn("DoH checksum", "CDN unreachable \u2014 cannot verify");
-    report.add("doh_checksum", "CDN unreachable");
+    warn("Pilot checksum", "CDN unreachable \u2014 cannot verify");
+    report.add("pilot_checksum", "CDN unreachable");
   } else if (cdnChecksum.sha256 === local.sha256) {
-    ok("DoH checksum", `match (${cdnChecksum.source})`);
-    report.add("doh_checksum", `match (${cdnChecksum.source})`);
+    ok("Pilot checksum", `match (${cdnChecksum.source})`);
+    report.add("pilot_checksum", `match (${cdnChecksum.source})`);
   } else {
-    warn("DoH checksum", "mismatch \u2014 update available", ["Run: okx doh install"]);
-    report.add("doh_checksum", "mismatch");
+    warn("Pilot checksum", "mismatch \u2014 update available", ["Run: okx pilot install"]);
+    report.add("pilot_checksum", "mismatch");
   }
   try {
     const cacheEntry = readCache("www.okx.com");
     if (cacheEntry) {
-      ok("DoH mode", cacheEntry.mode);
-      report.add("doh_mode", cacheEntry.mode);
+      ok("Pilot mode", cacheEntry.mode);
+      report.add("pilot_mode", cacheEntry.mode);
     } else {
-      ok("DoH mode", "no cache (will auto-detect on next request)");
-      report.add("doh_mode", "no cache");
+      ok("Pilot mode", "no cache (will auto-detect on next request)");
+      report.add("pilot_mode", "no cache");
     }
   } catch {
-    ok("DoH mode", "no cache");
-    report.add("doh_mode", "no cache");
+    ok("Pilot mode", "no cache");
+    report.add("pilot_mode", "no cache");
   }
 }
 function checkConfigFile(report) {
@@ -11950,7 +11954,7 @@ async function runCliChecks(config, profile, outputPath) {
   report.add("ts", (/* @__PURE__ */ new Date()).toISOString());
   const configFilePassed = checkConfigFile(report);
   const envPassed = checkEnvironment(report);
-  await checkDoh(report);
+  await checkPilot(report);
   if (!config) {
     fail("Config", "Could not load config (see Config File check above)", []);
     report.add("result", "FAIL");
@@ -11976,6 +11980,31 @@ async function runCliChecks(config, profile, outputPath) {
   writeReportIfRequested(report, outputPath);
 }
 
+// src/unknown-command.ts
+function unknownSubcommand(module, action, knownActions) {
+  const actionStr = action ?? "(missing)";
+  errorLine(`Unknown command: okx ${module} ${actionStr}`);
+  const hint = suggestSubcommand(action, knownActions);
+  if (hint) {
+    errorLine(`  Did you mean: okx ${module} ${hint} ?`);
+  }
+  if (knownActions.length > 0) {
+    errorLine(`  Available subcommands: ${knownActions.join(", ")}`);
+  }
+  errorLine(`  Run 'okx ${module} --help' for full usage.`);
+  process.exitCode = 1;
+}
+function suggestSubcommand(action, knownActions) {
+  if (!action || !action.includes("-")) return void 0;
+  const parts = action.split("-");
+  if (parts.length !== 2) return void 0;
+  const [a, b] = parts;
+  if (knownActions.includes(b)) {
+    return `${b} ${a}`;
+  }
+  return void 0;
+}
+
 // src/commands/upgrade.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { readFileSync as readFileSync8, writeFileSync as writeFileSync7, mkdirSync as mkdirSync9 } from "fs";
@@ -12981,24 +13010,24 @@ var CLI_REGISTRY = {
     description: "Set up client integrations (Cursor, Windsurf, Claude, etc.)",
     usage: `okx setup --client <${SUPPORTED_CLIENTS.join("|")}> [--profile <name>] [--modules <list>]`
   },
-  // ── doh ────────────────────────────────────────────────────────────────────
-  doh: {
-    description: "Manage DoH (DNS-over-HTTPS) resolver binary",
+  // ── pilot ──────────────────────────────────────────────────────────────────
+  pilot: {
+    description: "Manage Pilot proxy resolver binary",
     commands: {
       status: {
         toolName: null,
-        usage: "okx doh status [--json]",
-        description: "Show DoH binary info, checksum, and CDN match status"
+        usage: "okx pilot status [--json]",
+        description: "Show Pilot binary info, checksum, and CDN match status"
       },
       install: {
         toolName: null,
-        usage: "okx doh install [--json]",
-        description: "Download or update the DoH resolver binary"
+        usage: "okx pilot install [--json]",
+        description: "Download or update the Pilot binary"
       },
       remove: {
         toolName: null,
-        usage: "okx doh remove [--force] [--json]",
-        description: "Remove the DoH resolver binary (prompts for confirmation without --force)"
+        usage: "okx pilot remove [--force] [--json]",
+        description: "Remove the Pilot binary (prompts for confirmation without --force)"
       }
     }
   },
@@ -13685,6 +13714,7 @@ var CLI_OPTIONS = {
   // account extras
   archive: { type: "boolean", default: false },
   valuation: { type: "boolean", default: false },
+  valuationCcy: { type: "string" },
   posMode: { type: "string" },
   ccy: { type: "string" },
   from: { type: "string" },
@@ -14217,12 +14247,13 @@ async function cmdMarketOiHistory(run, instId, opts) {
   });
   const data = getData2(result);
   if (opts.json) return printJson(data);
-  const rows = data?.["rows"] ?? [];
+  const entry = Array.isArray(data) ? data[0] : data;
+  const rows = entry?.["rows"] ?? [];
   if (!rows.length) {
     outputLine("No OI data");
     return;
   }
-  outputLine(`${data?.["instId"] ?? instId}  bar=${data?.["bar"] ?? opts.bar ?? "1H"}`);
+  outputLine(`${entry?.["instId"] ?? instId}  bar=${entry?.["bar"] ?? opts.bar ?? "1H"}`);
   printTable(
     rows.map((r) => ({
       ts: new Date(Number(r["ts"])).toLocaleString(),
@@ -14288,13 +14319,14 @@ async function cmdAccountBalance(run, ccy, json) {
   }
   printTable(rows);
 }
-async function cmdAccountAssetBalance(run, ccy, json, showValuation) {
+async function cmdAccountAssetBalance(run, ccy, json, showValuation, valuationCcy) {
   const result = await run("account_get_asset_balance", {
     ccy,
-    ...showValuation ? { showValuation: true } : {}
+    ...showValuation ? { showValuation: true } : {},
+    ...valuationCcy !== void 0 ? { valuationCcy } : {}
   });
   const data = result.data ?? [];
-  if (json) return printJson(showValuation ? { data, valuation: result.valuation } : data);
+  if (json) return printJson(showValuation ? { data, valuation: result.valuation, valuationCcy: result.valuationCcy } : data);
   const assetRows = data.filter((r) => Number(r["bal"]) > 0).map((r) => ({
     ccy: r["ccy"],
     bal: r["bal"],
@@ -14309,7 +14341,7 @@ async function cmdAccountAssetBalance(run, ccy, json, showValuation) {
   if (showValuation && result.valuation) {
     const valuationData = result.valuation ?? [];
     outputLine("");
-    outputLine("Asset Valuation by Account Type:");
+    outputLine(`Asset Valuation by Account Type (${String(result.valuationCcy ?? "USDT")}):`);
     printTable(
       valuationData.map((v) => {
         const details = v["details"] ?? {};
@@ -17205,7 +17237,7 @@ function printSkillInstallResult(meta, json) {
   }
 }
 
-// src/commands/doh.ts
+// src/commands/pilot.ts
 import readline from "readline";
 function resolveChecksumMatch(local, cdnChecksum, cdnError) {
   if (!local.exists) return "not-installed";
@@ -17220,7 +17252,7 @@ function checksumMatchLabel(match) {
 }
 function formatStatusText(local, checksumMatch, cdnChecksum, runtimeMode) {
   outputLine("");
-  outputLine("  DoH Resolver Status");
+  outputLine("  Pilot Status");
   outputLine("  " + "\u2500".repeat(40));
   outputLine(`  Binary path : ${local.binaryPath}`);
   outputLine(`  Installed   : ${local.exists ? "yes" : "no"}`);
@@ -17236,8 +17268,8 @@ function formatStatusText(local, checksumMatch, cdnChecksum, runtimeMode) {
   outputLine(`  Runtime mode: ${runtimeMode}`);
   outputLine("");
 }
-async function cmdDohStatus(json, binaryPath) {
-  const local = getDohStatus(binaryPath);
+async function cmdPilotStatus(json, binaryPath) {
+  const local = getPilotStatus(binaryPath);
   let runtimeMode = "no cache";
   try {
     const cacheEntry = readCache("www.okx.com");
@@ -17274,7 +17306,7 @@ async function cmdDohStatus(json, binaryPath) {
   }
   formatStatusText(local, checksumMatch, cdnChecksum, runtimeMode);
 }
-async function cmdDohInstall(json, binaryPath) {
+async function cmdPilotInstall(json, binaryPath) {
   const messages2 = [];
   const onProgress = (msg) => {
     if (!json) {
@@ -17284,9 +17316,9 @@ async function cmdDohInstall(json, binaryPath) {
   };
   if (!json) {
     outputLine("");
-    outputLine("  Installing DoH resolver...");
+    outputLine("  Installing Pilot...");
   }
-  const result = await installDohBinary(binaryPath, void 0, onProgress);
+  const result = await installPilotBinary(binaryPath, void 0, onProgress);
   if (json) {
     outputLine(JSON.stringify({ status: result.status, source: result.source ?? null, error: result.error ?? null, messages: messages2 }));
     if (result.status === "failed") {
@@ -17295,9 +17327,9 @@ async function cmdDohInstall(json, binaryPath) {
     return;
   }
   if (result.status === "installed") {
-    outputLine(`  \u2713 DoH resolver installed successfully (${result.source ?? ""})`);
+    outputLine(`  \u2713 Pilot installed successfully (${result.source ?? ""})`);
   } else if (result.status === "up-to-date") {
-    outputLine("  \u2713 DoH resolver is already up to date");
+    outputLine("  \u2713 Pilot is already up to date");
   } else {
     errorLine(`  \u2717 Installation failed: ${result.error ?? "unknown error"}`);
     errorLine("  Hint: check network connectivity or try again later");
@@ -17305,13 +17337,13 @@ async function cmdDohInstall(json, binaryPath) {
   }
   outputLine("");
 }
-async function cmdDohRemove(force, json, binaryPath) {
-  const local = getDohStatus(binaryPath);
+async function cmdPilotRemove(force, json, binaryPath) {
+  const local = getPilotStatus(binaryPath);
   if (!local.exists) {
     if (json) {
       outputLine(JSON.stringify({ status: "not-installed" }));
     } else {
-      outputLine("  DoH resolver is not installed.");
+      outputLine("  Pilot is not installed.");
     }
     return;
   }
@@ -17322,14 +17354,14 @@ async function cmdDohRemove(force, json, binaryPath) {
       return;
     }
     const confirmed = await askConfirmation(
-      `  Remove DoH resolver at ${local.binaryPath}? [y/N] `
+      `  Remove Pilot at ${local.binaryPath}? [y/N] `
     );
     if (!confirmed) {
       outputLine("  Cancelled.");
       return;
     }
   }
-  const result = removeDohBinary(binaryPath);
+  const result = removePilotBinary(binaryPath);
   if (json) {
     outputLine(JSON.stringify({ status: result.status, path: local.binaryPath }));
     return;
@@ -17337,7 +17369,7 @@ async function cmdDohRemove(force, json, binaryPath) {
   if (result.status === "removed") {
     outputLine(`  \u2713 Removed: ${local.binaryPath}`);
   } else {
-    outputLine("  DoH resolver is not installed.");
+    outputLine("  Pilot is not installed.");
   }
 }
 function formatBytes(bytes) {
@@ -17804,13 +17836,13 @@ async function cmdEventCancel(run, opts) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "d5c8ab1" : "dev";
-function handleDohCommand(action, json, force, binaryPath) {
-  if (action === "status") return cmdDohStatus(json, binaryPath);
-  if (action === "install") return cmdDohInstall(json, binaryPath);
-  if (action === "remove") return cmdDohRemove(force, json, binaryPath);
-  errorLine(`Unknown doh command: ${action}`);
-  errorLine("Usage: okx doh <status|install|remove>");
+var GIT_HASH2 = true ? "330e727a" : "dev";
+function handlePilotCommand(action, json, force, binaryPath) {
+  if (action === "status") return cmdPilotStatus(json, binaryPath);
+  if (action === "install") return cmdPilotInstall(json, binaryPath);
+  if (action === "remove") return cmdPilotRemove(force, json, binaryPath);
+  errorLine(`Unknown pilot command: ${action}`);
+  errorLine("Usage: okx pilot <status|install|remove>");
   process.exitCode = 1;
 }
 function handleConfigCommand(action, rest, json, lang, force) {
@@ -17909,9 +17941,6 @@ function handleMarketFilterCommand(run, action, rest, v, json) {
       limit,
       json
     });
-  errorLine(`Unknown market command: ${action}`);
-  errorLine("Valid: ticker, tickers, orderbook, candles, trades, instruments, mark-price, funding-rate, open-interest, index-ticker, price-limit, stock-tokens, instruments-by-category, indicator, filter, oi-history, oi-change");
-  process.exitCode = 1;
 }
 function handleIndicatorAction(run, rest, v, json) {
   if (rest[0] === "list") return cmdMarketIndicatorList(json);
@@ -17940,7 +17969,28 @@ function handleMarketDataCommand(run, action, rest, v, json) {
     return cmdMarketIndexCandles(run, rest[0], { bar: v.bar, limit, history: v.history ?? false, json, demo: v.demo });
 }
 function handleMarketCommand(run, action, rest, v, json) {
-  return handleMarketPublicCommand(run, action, rest, v, json) ?? handleMarketDataCommand(run, action, rest, v, json);
+  const result = handleMarketPublicCommand(run, action, rest, v, json) ?? handleMarketDataCommand(run, action, rest, v, json);
+  if (result !== void 0) return result;
+  unknownSubcommand("market", action, [
+    "ticker",
+    "tickers",
+    "orderbook",
+    "candles",
+    "trades",
+    "instruments",
+    "mark-price",
+    "funding-rate",
+    "open-interest",
+    "index-ticker",
+    "price-limit",
+    "stock-tokens",
+    "instruments-by-category",
+    "indicator",
+    "filter",
+    "oi-history",
+    "oi-change",
+    "index-candles"
+  ]);
 }
 function handleAccountWriteCommand(run, action, v, json) {
   if (action === "set-position-mode")
@@ -17960,13 +18010,28 @@ function handleAccountWriteCommand(run, action, v, json) {
       subAcct: v.subAcct,
       json
     });
+  unknownSubcommand("account", action, [
+    "audit",
+    "balance",
+    "asset-balance",
+    "positions",
+    "positions-history",
+    "bills",
+    "fees",
+    "config",
+    "set-position-mode",
+    "max-size",
+    "max-avail-size",
+    "max-withdrawal",
+    "transfer"
+  ]);
 }
 function handleAccountCommand(run, action, rest, v, json) {
   if (action === "audit")
     return cmdAccountAudit({ limit: v.limit, tool: v.tool, since: v.since, json });
   const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
   if (action === "balance") return cmdAccountBalance(run, rest[0], json);
-  if (action === "asset-balance") return cmdAccountAssetBalance(run, v.ccy, json, v.valuation);
+  if (action === "asset-balance") return cmdAccountAssetBalance(run, v.ccy, json, v.valuation, v.valuationCcy);
   if (action === "positions")
     return cmdAccountPositions(run, { instType: v.instType, instId: v.instId, json });
   if (action === "positions-history")
@@ -18039,6 +18104,7 @@ function handleSpotAlgoCommand(run, subAction, v, json) {
       ordType: v.ordType,
       json
     });
+  unknownSubcommand("spot algo", subAction, ["trail", "place", "amend", "cancel", "orders"]);
 }
 function handleSpotCommand(run, action, rest, v, json) {
   if (action === "orders")
@@ -18090,6 +18156,17 @@ function handleSpotCommand(run, action, rest, v, json) {
       mgnMode: v.mgnMode,
       json
     });
+  unknownSubcommand("spot", action, [
+    "orders",
+    "get",
+    "fills",
+    "place",
+    "cancel",
+    "amend",
+    "algo",
+    "batch",
+    "leverage"
+  ]);
 }
 function handleSwapAlgoCommand(run, subAction, v, json) {
   if (subAction === "trail")
@@ -18145,6 +18222,7 @@ function handleSwapAlgoCommand(run, subAction, v, json) {
       ordType: v.ordType,
       json
     });
+  unknownSubcommand("swap algo", subAction, ["trail", "place", "amend", "cancel", "orders"]);
 }
 function handleSwapQuery(run, action, rest, v, json) {
   if (action === "positions")
@@ -18220,6 +18298,20 @@ function handleSwapCommand(run, action, rest, v, json) {
     return handleSwapAlgoCommand(run, rest[0], v, json);
   if (action === "batch")
     return cmdSwapBatch(run, { action: v.action, orders: v.orders, json });
+  unknownSubcommand("swap", action, [
+    "positions",
+    "orders",
+    "get",
+    "fills",
+    "get-leverage",
+    "place",
+    "cancel",
+    "amend",
+    "close",
+    "leverage",
+    "algo",
+    "batch"
+  ]);
 }
 function handleOptionAlgoCommand(run, subAction, v, json) {
   if (subAction === "place")
@@ -18258,6 +18350,7 @@ function handleOptionAlgoCommand(run, subAction, v, json) {
       ordType: v.ordType,
       json
     });
+  unknownSubcommand("option algo", subAction, ["place", "amend", "cancel", "orders"]);
 }
 function handleOptionCommand(run, action, rest, v, json) {
   if (action === "orders") {
@@ -18308,6 +18401,19 @@ function handleOptionCommand(run, action, rest, v, json) {
     return cmdOptionBatchCancel(run, { orders: v.orders, json });
   if (action === "algo")
     return handleOptionAlgoCommand(run, rest[0], v, json);
+  unknownSubcommand("option", action, [
+    "orders",
+    "get",
+    "positions",
+    "fills",
+    "instruments",
+    "greeks",
+    "place",
+    "cancel",
+    "amend",
+    "batch-cancel",
+    "algo"
+  ]);
 }
 function handleFuturesAlgoCommand(run, subAction, v, json) {
   if (subAction === "trail")
@@ -18363,6 +18469,7 @@ function handleFuturesAlgoCommand(run, subAction, v, json) {
       ordType: v.ordType,
       json
     });
+  unknownSubcommand("futures algo", subAction, ["trail", "place", "amend", "cancel", "orders"]);
 }
 function resolveFuturesOrdersStatus(v) {
   if (v.archive) return "archive";
@@ -18438,6 +18545,20 @@ function handleFuturesCommand(run, action, rest, v, json) {
     return cmdFuturesBatch(run, { action: v.action, orders: v.orders, json });
   if (action === "algo")
     return handleFuturesAlgoCommand(run, rest[0], v, json);
+  unknownSubcommand("futures", action, [
+    "orders",
+    "positions",
+    "fills",
+    "get",
+    "get-leverage",
+    "place",
+    "cancel",
+    "amend",
+    "close",
+    "leverage",
+    "batch",
+    "algo"
+  ]);
 }
 function handleBotGridCommand(run, v, rest, json) {
   const subAction = rest[0];
@@ -18505,6 +18626,7 @@ function handleBotGridCommand(run, v, rest, json) {
       stopType: v.stopType,
       json
     });
+  unknownSubcommand("bot grid", subAction, ["orders", "details", "sub-orders", "create", "amend", "stop"]);
 }
 function handleBotDcaCommand(run, subAction, v, json) {
   const algoOrdType = v.algoOrdType ?? "contract_dca";
@@ -18543,10 +18665,12 @@ function handleBotDcaCommand(run, subAction, v, json) {
     });
   if (subAction === "stop")
     return cmdDcaStop(run, { algoId: v.algoId, algoOrdType, stopType: v.stopType, json });
+  unknownSubcommand("bot dca", subAction, ["orders", "details", "sub-orders", "create", "stop"]);
 }
 function handleBotCommand(run, action, rest, v, json) {
   if (action === "grid") return handleBotGridCommand(run, v, rest, json);
   if (action === "dca") return handleBotDcaCommand(run, rest[0], v, json);
+  unknownSubcommand("bot", action, ["grid", "dca"]);
 }
 function handleEarnCommand(run, submodule, rest, v, json) {
   const action = rest[0];
@@ -18888,11 +19012,11 @@ async function runDiagnose(v) {
 }
 function printVersion() {
   outputLine(`${CLI_VERSION2} (${GIT_HASH2})`);
-  const dohStatus = getDohStatus(void 0, { skipHash: true });
-  if (dohStatus.exists) {
-    outputLine(`DoH resolver: installed (${dohStatus.platform ?? "unknown"})`);
+  const pilotStatus = getPilotStatus(void 0, { skipHash: true });
+  if (pilotStatus.exists) {
+    outputLine(`Pilot: installed (${pilotStatus.platform ?? "unknown"})`);
   } else {
-    outputLine("DoH resolver: not installed");
+    outputLine("Pilot: not installed");
   }
 }
 function routeManagementCommand(module, action, rest, json, v) {
@@ -18905,8 +19029,8 @@ function routeManagementCommand(module, action, rest, json, v) {
     return true;
   }
   if (module === "upgrade") return cmdUpgrade(CLI_VERSION2, { beta: v.beta, check: v.check, force: v.force }, json);
-  if (module === "doh") {
-    const r = handleDohCommand(action, json, v.force ?? false);
+  if (module === "pilot") {
+    const r = handlePilotCommand(action, json, v.force ?? false);
     return r ?? true;
   }
   if (module === "diagnose") return runDiagnose(v);
@@ -18976,7 +19100,6 @@ export {
   handleBotDcaCommand,
   handleBotGridCommand,
   handleConfigCommand,
-  handleDohCommand,
   handleEarnCommand,
   handleEventCommand,
   handleFuturesAlgoCommand,
@@ -18987,6 +19110,7 @@ export {
   handleNewsCommand,
   handleOptionAlgoCommand,
   handleOptionCommand,
+  handlePilotCommand,
   handleSetupCommand,
   handleSkillCommand,
   handleSmartmoneyCommand,