@okx_ai/okx-trade-mcp 1.3.2-beta.1 → 1.3.2-beta.2

package/dist/index.js

@@ -733,19 +733,19 @@ import * as os3 from "os";
 import { execFileSync } from "child_process";
 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(","));
@@ -778,7 +778,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 {
@@ -832,7 +832,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") {
@@ -844,53 +844,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;
       }
@@ -900,57 +900,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;
   }
@@ -959,7 +959,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, {
@@ -969,25 +969,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) {
@@ -1011,7 +1011,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`);
     }
   }
 };
@@ -1233,14 +1233,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,
@@ -1423,12 +1423,12 @@ var OkxRestClient = class _OkxRestClient {
    * Security: validates Content-Type and enforces maxBytes limit.
    */
   async privatePostBinary(path4, 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 ${path4}`;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     this.logRequest("POST", `${conn.baseUrl}${path4}`, "private");
     const reqConfig = { method: "POST", path: path4, auth: "private" };
     const headers = this.buildHeaders(reqConfig, path4, bodyJson, getNow());
@@ -1440,13 +1440,15 @@ var OkxRestClient = class _OkxRestClient {
     try {
       response = await this.fetchBinary(path4, 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));
@@ -1472,15 +1474,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(path4, 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 ? `${path4}?${queryString}` : path4;
-    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" });
@@ -1496,13 +1498,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 ${path4}.`, `GET ${path4}`, 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));
@@ -1527,7 +1531,7 @@ var OkxRestClient = class _OkxRestClient {
   }
   /** Execute fetch for binary endpoint, wrapping network errors. */
   async fetchBinary(path4, endpoint, headers, bodyJson, t0) {
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     try {
       const fetchOptions = {
         method: "POST",
@@ -1574,16 +1578,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);
       }
@@ -1600,10 +1604,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();
@@ -1632,7 +1636,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);
   }
 };
@@ -2211,6 +2215,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."
           }
         }
       },
@@ -2218,6 +2226,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",
@@ -2225,16 +2234,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);
+          }
+          const valuationResult = {
+            ...normalizeResponse(balanceResp2),
+            valuation: valuationData,
+            valuationCcy
+          };
+          if (valuationError !== void 0) {
+            valuationResult["valuationError"] = valuationError;
           }
-          return { ...normalizeResponse(balanceResp2), valuation: valuationData };
+          return valuationResult;
         }
         const balanceResp = await context.client.privateGet(
           "/api/v5/asset/balances",
@@ -6214,9 +6233,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",
@@ -6286,23 +6305,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 ---------- */
@@ -6373,18 +6375,18 @@ function registerSmartmoneyTools() {
     {
       name: "smartmoney_get_signal",
       module: "smartmoney",
-      description: "Single-currency consensus signal: long/short ratio, entry prices, trend, capital flow. Requires instId or instCcy. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For multi-currency overview, use smartmoney_get_overview. For timeline, use smartmoney_get_signal_history.",
+      description: "Single-currency consensus signal: long/short ratio, entry prices, trend, capital flow. Prefer instId (e.g. BTC-USDT-SWAP); instCcy is accepted but may return empty \u2014 use instId for reliable results. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For multi-currency overview, use smartmoney_get_overview. For timeline, use smartmoney_get_signal_history.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
           instId: {
             type: "string",
-            description: "e.g. BTC-USDT-SWAP (or use instCcy)"
+            description: "Recommended. e.g. BTC-USDT-SWAP"
           },
           instCcy: {
             type: "string",
-            description: "e.g. BTC, SPOT/SWAP only (or use instId)"
+            description: "e.g. BTC, SPOT/SWAP only. May return empty \u2014 prefer instId."
           },
           dataVersion: {
             type: "string",
@@ -6456,11 +6458,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
         },
@@ -6604,7 +6606,7 @@ function registerSmartmoneyTools() {
       }
     }
   ];
-  return tools.map(withSmartmoneyDemoGuard);
+  return tools;
 }
 function buildContractTradeTools(cfg) {
   const { prefix, module, label, instTypes, instIdExample } = cfg;
@@ -10383,7 +10385,7 @@ var _require = createRequire(import.meta.url);
 var pkg = _require("../package.json");
 var SERVER_NAME = "okx-trade-mcp";
 var SERVER_VERSION = pkg.version;
-var GIT_HASH = true ? "d5c8ab1" : "dev";
+var GIT_HASH = true ? "e0ee5a96" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";