@okx_ai/okx-trade-cli 1.3.0-beta.4 → 1.3.0

package/dist/index.js

@@ -4,37 +4,25 @@
 import { createRequire as createRequire3 } from "module";
 
 // ../core/dist/index.js
-import { Agent, ProxyAgent } from "undici";
-import { execFile } from "child_process";
-import { homedir } from "os";
-import { join } from "path";
-import {
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
-  unlinkSync,
-  renameSync
-} from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2, dirname } from "path";
+import { ProxyAgent } from "undici";
 import { createHmac } from "crypto";
 import fs from "fs";
 import path from "path";
 import os from "os";
-import { writeFileSync as writeFileSync2, renameSync as renameSync2, unlinkSync as unlinkSync2, mkdirSync as mkdirSync2 } from "fs";
-import { join as join3, resolve, basename, sep } from "path";
+import { writeFileSync, renameSync, unlinkSync, mkdirSync } from "fs";
+import { join, resolve, basename, sep } from "path";
 import { randomUUID } from "crypto";
 import yauzl from "yauzl";
-import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
-import { resolve as resolve2, dirname as dirname2 } from "path";
-import { readFileSync as readFileSync2, existsSync } from "fs";
-import { join as join4 } from "path";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync2 } from "fs";
-import { join as join5, dirname as dirname3 } from "path";
-import { homedir as homedir3 } from "os";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, existsSync as existsSync3 } from "fs";
-import { join as join6, dirname as dirname4 } from "path";
-import { homedir as homedir4 } from "os";
+import { createWriteStream, mkdirSync as mkdirSync2 } from "fs";
+import { resolve as resolve2, dirname } from "path";
+import { readFileSync, existsSync } from "fs";
+import { join as join2 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, existsSync as existsSync2 } from "fs";
+import { join as join3, dirname as dirname2 } from "path";
+import { homedir } from "os";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync3 } from "fs";
+import { join as join4, dirname as dirname3 } from "path";
+import { homedir as homedir2 } from "os";
 
 // ../../node_modules/.pnpm/smol-toml@1.6.0/node_modules/smol-toml/dist/error.js
 function getLineColFromPtr(string, ptr) {
@@ -863,9 +851,9 @@ function stringify(obj, { maxDepth = 1e3, numbersAsFloat = false } = {}) {
 }
 
 // ../core/dist/index.js
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, mkdirSync as mkdirSync6, existsSync as existsSync4 } from "fs";
-import { join as join7 } from "path";
-import { homedir as homedir5 } from "os";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, existsSync as existsSync4 } from "fs";
+import { join as join5 } from "path";
+import { homedir as homedir3 } from "os";
 import fs2 from "fs";
 import path2 from "path";
 import os2 from "os";
@@ -873,123 +861,6 @@ import * as fs3 from "fs";
 import * as path3 from "path";
 import * as os3 from "os";
 import { execFileSync } from "child_process";
-var EXEC_TIMEOUT_MS = 3e4;
-var DOH_BIN_DIR = join(homedir(), ".okx", "bin");
-function getDohBinaryPath() {
-  if (process.env.OKX_DOH_BINARY_PATH) {
-    return process.env.OKX_DOH_BINARY_PATH;
-  }
-  const ext = process.platform === "win32" ? ".exe" : "";
-  return join(DOH_BIN_DIR, `okx-doh-resolver${ext}`);
-}
-function execDohBinary(domain, exclude = [], userAgent) {
-  const binPath = getDohBinaryPath();
-  const args = ["--domain", domain];
-  if (exclude.length > 0) {
-    args.push("--exclude", exclude.join(","));
-  }
-  if (userAgent) {
-    args.push("--user-agent", userAgent);
-  }
-  return new Promise((resolve3) => {
-    execFile(
-      binPath,
-      args,
-      { timeout: EXEC_TIMEOUT_MS, encoding: "utf-8" },
-      (error, stdout) => {
-        if (error) {
-          resolve3(null);
-          return;
-        }
-        try {
-          const result = JSON.parse(stdout);
-          if (result.code === 0 && result.data) {
-            resolve3(result.data);
-          } else {
-            resolve3(null);
-          }
-        } catch {
-          resolve3(null);
-        }
-      }
-    );
-  });
-}
-var DOH_CACHE_PATH = join2(homedir2(), ".okx", "doh-node-cache.json");
-function readCache(hostname, cachePath = DOH_CACHE_PATH) {
-  try {
-    const raw = readFileSync(cachePath, "utf-8");
-    const file = JSON.parse(raw);
-    return file[hostname] ?? null;
-  } catch {
-    return null;
-  }
-}
-function writeCache(hostname, entry, cachePath = DOH_CACHE_PATH) {
-  try {
-    const dir = dirname(cachePath);
-    mkdirSync(dir, { recursive: true });
-    let file = {};
-    try {
-      file = JSON.parse(readFileSync(cachePath, "utf-8"));
-    } catch {
-    }
-    file[hostname] = entry;
-    const tmpPath = `${cachePath}.tmp`;
-    writeFileSync(tmpPath, JSON.stringify(file));
-    renameSync(tmpPath, cachePath);
-  } catch {
-  }
-}
-var FAILED_NODE_TTL_MS = 60 * 60 * 1e3;
-function classifyAndCache(node, hostname, failedNodes, cachePath) {
-  if (!node) {
-    return { mode: null, node: null };
-  }
-  if (node.ip === hostname || node.host === hostname) {
-    writeCache(hostname, {
-      mode: "direct",
-      node: null,
-      failedNodes,
-      updatedAt: Date.now()
-    }, cachePath);
-    return { mode: "direct", node: null };
-  }
-  writeCache(hostname, {
-    mode: "proxy",
-    node,
-    failedNodes,
-    updatedAt: Date.now()
-  }, cachePath);
-  return { mode: "proxy", node };
-}
-function getActiveFailedNodes(nodes) {
-  if (!nodes || nodes.length === 0) return [];
-  const now = Date.now();
-  return nodes.filter((n) => now - n.failedAt < FAILED_NODE_TTL_MS);
-}
-function resolveDoh(hostname, cachePath) {
-  const entry = readCache(hostname, cachePath);
-  if (entry) {
-    if (entry.mode === "direct") {
-      return { mode: "direct", node: null };
-    }
-    if (entry.mode === "proxy" && entry.node) {
-      return { mode: "proxy", node: entry.node };
-    }
-  }
-  return { mode: null, node: null };
-}
-async function reResolveDoh(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);
-  return classifyAndCache(node, hostname, failedNodes, cachePath);
-}
 function getNow() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
@@ -1208,14 +1079,6 @@ var OkxRestClient = class _OkxRestClient {
   config;
   rateLimiter;
   dispatcher;
-  // DoH proxy state (lazy-resolved on first request)
-  dohResolved = false;
-  dohRetried = false;
-  directUnverified = false;
-  // The first direct connection has not yet been verified
-  dohNode = null;
-  dohAgent = null;
-  dohBaseUrl = null;
   constructor(config) {
     this.config = config;
     this.rateLimiter = new RateLimiter(3e4, config.verbose);
@@ -1223,98 +1086,6 @@ var OkxRestClient = class _OkxRestClient {
       this.dispatcher = new ProxyAgent(config.proxyUrl);
     }
   }
-  /**
-   * Lazily resolve the DoH proxy node on the first request.
-   * Uses cache-first strategy via the resolver.
-   */
-  ensureDoh() {
-    if (this.dohResolved || this.dispatcher) return;
-    this.dohResolved = true;
-    try {
-      const { hostname, protocol } = new URL(this.config.baseUrl);
-      const result = resolveDoh(hostname);
-      if (!result.mode) {
-        this.directUnverified = true;
-        if (this.config.verbose) {
-          vlog("DoH: no cache, trying direct connection first");
-        }
-        return;
-      }
-      if (result.mode === "direct") {
-        if (this.config.verbose) {
-          vlog("DoH: mode=direct (overseas or cached), using direct connection");
-        }
-        return;
-      }
-      if (result.node) {
-        this.applyDohNode(result.node, protocol);
-      }
-    } catch (err) {
-      if (this.config.verbose) {
-        const cause = err instanceof Error ? err.message : String(err);
-        vlog(`DoH resolution failed, falling back to direct: ${cause}`);
-      }
-    }
-  }
-  /** Apply a DoH node: set up the custom Agent + base URL. */
-  applyDohNode(node, protocol) {
-    this.dohNode = node;
-    this.dohBaseUrl = `${protocol}//${node.host}`;
-    this.dohAgent = new Agent({
-      connect: {
-        lookup: (_hostname, options, callback) => {
-          if (options?.all) {
-            callback(null, [{ address: node.ip, family: 4 }]);
-          } else {
-            callback(null, node.ip, 4);
-          }
-        }
-      }
-    });
-    if (this.config.verbose) {
-      vlog(`DoH proxy active: \u2192 ${node.host} (${node.ip}), ttl=${node.ttl}s`);
-    }
-  }
-  /**
-   * Handle network failure: re-resolve with --exclude and retry once.
-   * Returns true if retry should proceed, false if already retried.
-   */
-  async handleDohNetworkFailure() {
-    if (this.dohRetried) return false;
-    this.dohRetried = true;
-    const failedIp = this.dohNode?.ip ?? "";
-    const { hostname, protocol } = new URL(this.config.baseUrl);
-    this.dohNode = null;
-    this.dohAgent = null;
-    this.dohBaseUrl = null;
-    if (!failedIp) this.directUnverified = false;
-    if (this.config.verbose) {
-      vlog(failedIp ? `DoH: proxy node ${failedIp} failed, re-resolving with --exclude` : "DoH: direct connection failed, calling binary for DoH resolution");
-    }
-    try {
-      const result = await reResolveDoh(hostname, failedIp, this.dohUserAgent);
-      if (result.mode === "proxy" && result.node) {
-        this.applyDohNode(result.node, protocol);
-        this.dohRetried = false;
-        return true;
-      }
-    } catch {
-    }
-    if (this.config.verbose) {
-      vlog("DoH: re-resolution failed or switched to direct, retrying with direct connection");
-    }
-    return true;
-  }
-  get activeBaseUrl() {
-    return this.dohNode ? this.dohBaseUrl : this.config.baseUrl;
-  }
-  get activeDispatcher() {
-    return this.dispatcher ?? this.dohAgent ?? void 0;
-  }
-  /** User-Agent for DoH proxy requests: OKX/@okx_ai/{packageName}/{version} */
-  get dohUserAgent() {
-    return `OKX/@okx_ai/${this.config.userAgent ?? "unknown"}`;
-  }
   logRequest(method, url, auth) {
     if (!this.config.verbose) return;
     vlog(`\u2192 ${method} ${url}`);
@@ -1329,13 +1100,14 @@ var OkxRestClient = class _OkxRestClient {
       vlog(`\u2190 ${status} | code=${code ?? "0"} | ${rawLen}B | ${elapsed}ms | trace=${traceId ?? "-"}`);
     }
   }
-  async publicGet(path42, query, rateLimit) {
+  async publicGet(path42, query, rateLimit, simulatedTrading) {
     return this.request({
       method: "GET",
       path: path42,
       auth: "public",
       query,
-      rateLimit
+      rateLimit,
+      simulatedTrading
     });
   }
   async privateGet(path42, query, rateLimit) {
@@ -1484,17 +1256,13 @@ var OkxRestClient = class _OkxRestClient {
    * Security: validates Content-Type and enforces maxBytes limit.
    */
   async privatePostBinary(path42, body, opts) {
-    this.ensureDoh();
     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}`;
-    this.logRequest("POST", `${this.activeBaseUrl}${path42}`, "private");
+    this.logRequest("POST", `${this.config.baseUrl}${path42}`, "private");
     const reqConfig = { method: "POST", path: path42, auth: "private" };
     const headers = this.buildHeaders(reqConfig, path42, bodyJson, getNow());
-    if (this.dohNode) {
-      headers.set("User-Agent", this.dohUserAgent);
-    }
     const t0 = Date.now();
     const response = await this.fetchBinary(path42, endpoint, headers, bodyJson, t0);
     const elapsed = Date.now() - t0;
@@ -1528,10 +1296,10 @@ var OkxRestClient = class _OkxRestClient {
         method: "POST",
         headers,
         body: bodyJson || void 0,
-        signal: AbortSignal.timeout(this.config.timeoutMs),
-        dispatcher: this.activeDispatcher
+        signal: AbortSignal.timeout(this.config.timeoutMs)
       };
-      return await fetch(`${this.activeBaseUrl}${path42}`, fetchOptions);
+      if (this.dispatcher) fetchOptions.dispatcher = this.dispatcher;
+      return await fetch(`${this.config.baseUrl}${path42}`, fetchOptions);
     } catch (error) {
       if (this.config.verbose) {
         vlog(`\u2717 NetworkError after ${Date.now() - t0}ms: ${error instanceof Error ? error.message : String(error)}`);
@@ -1553,7 +1321,8 @@ var OkxRestClient = class _OkxRestClient {
     if (reqConfig.auth === "private") {
       this.setAuthHeaders(headers, reqConfig.method, requestPath, bodyJson, timestamp);
     }
-    if (this.config.demo) {
+    const useSimulated = reqConfig.simulatedTrading !== void 0 ? reqConfig.simulatedTrading : this.config.demo;
+    if (useSimulated) {
       headers.set("x-simulated-trading", "1");
     }
     return headers;
@@ -1561,55 +1330,10 @@ var OkxRestClient = class _OkxRestClient {
   // ---------------------------------------------------------------------------
   // JSON request
   // ---------------------------------------------------------------------------
-  /**
-   * Handle network error during a JSON request: refresh DoH and maybe retry.
-   * Always either returns a retry result or throws NetworkError.
-   */
-  async handleRequestNetworkError(error, reqConfig, requestPath, t0) {
-    if (!this.dohRetried) {
-      if (this.config.verbose) {
-        const cause = error instanceof Error ? error.message : String(error);
-        vlog(`Network failure, refreshing DoH: ${cause}`);
-      }
-      const shouldRetry = await this.handleDohNetworkFailure();
-      if (shouldRetry && reqConfig.method === "GET") {
-        return this.request(reqConfig);
-      }
-    }
-    if (this.config.verbose) {
-      const elapsed = Date.now() - t0;
-      const cause = error instanceof Error ? error.message : String(error);
-      vlog(`\u2717 NetworkError after ${elapsed}ms: ${cause}`);
-    }
-    throw new NetworkError(
-      `Failed to call OKX endpoint ${reqConfig.method} ${requestPath}.`,
-      `${reqConfig.method} ${requestPath}`,
-      error
-    );
-  }
-  /**
-   * After a successful HTTP response on direct connection, cache mode=direct.
-   * (Even if the business response is an error, the network path is valid.)
-   */
-  cacheDirectConnectionIfNeeded() {
-    if (!this.directUnverified || this.dohNode) return;
-    this.directUnverified = false;
-    const { hostname } = new URL(this.config.baseUrl);
-    writeCache(hostname, {
-      mode: "direct",
-      node: null,
-      failedNodes: [],
-      updatedAt: Date.now()
-    });
-    if (this.config.verbose) {
-      vlog("DoH: direct connection succeeded, cached mode=direct");
-    }
-  }
   async request(reqConfig) {
-    this.ensureDoh();
     const queryString = buildQueryString(reqConfig.query);
     const requestPath = queryString.length > 0 ? `${reqConfig.path}?${queryString}` : reqConfig.path;
-    const url = `${this.activeBaseUrl}${requestPath}`;
+    const url = `${this.config.baseUrl}${requestPath}`;
     const bodyJson = reqConfig.body ? JSON.stringify(reqConfig.body) : "";
     const timestamp = getNow();
     this.logRequest(reqConfig.method, url, reqConfig.auth);
@@ -1617,9 +1341,6 @@ var OkxRestClient = class _OkxRestClient {
       await this.rateLimiter.consume(reqConfig.rateLimit);
     }
     const headers = this.buildHeaders(reqConfig, requestPath, bodyJson, timestamp);
-    if (this.dohNode) {
-      headers.set("User-Agent", this.dohUserAgent);
-    }
     const t0 = Date.now();
     let response;
     try {
@@ -1627,17 +1348,27 @@ var OkxRestClient = class _OkxRestClient {
         method: reqConfig.method,
         headers,
         body: reqConfig.method === "POST" ? bodyJson : void 0,
-        signal: AbortSignal.timeout(this.config.timeoutMs),
-        dispatcher: this.activeDispatcher
+        signal: AbortSignal.timeout(this.config.timeoutMs)
       };
+      if (this.dispatcher) {
+        fetchOptions.dispatcher = this.dispatcher;
+      }
       response = await fetch(url, fetchOptions);
     } catch (error) {
-      return await this.handleRequestNetworkError(error, reqConfig, requestPath, t0);
+      if (this.config.verbose) {
+        const elapsed2 = Date.now() - t0;
+        const cause = error instanceof Error ? error.message : String(error);
+        vlog(`\u2717 NetworkError after ${elapsed2}ms: ${cause}`);
+      }
+      throw new NetworkError(
+        `Failed to call OKX endpoint ${reqConfig.method} ${requestPath}.`,
+        `${reqConfig.method} ${requestPath}`,
+        error
+      );
     }
     const rawText = await response.text();
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.cacheDirectConnectionIfNeeded();
     return this.processResponse(rawText, response, elapsed, traceId, reqConfig, requestPath);
   }
 };
@@ -3516,19 +3247,19 @@ function safeWriteFile(targetDir, fileName, data) {
     throw new Error(`Invalid file name: "${fileName}"`);
   }
   const resolvedDir = resolve(targetDir);
-  const filePath = join3(resolvedDir, safeName);
+  const filePath = join(resolvedDir, safeName);
   const resolvedPath = resolve(filePath);
   if (!resolvedPath.startsWith(resolvedDir + sep)) {
     throw new Error(`Path traversal detected: "${fileName}" resolves outside target directory`);
   }
-  mkdirSync2(resolvedDir, { recursive: true });
+  mkdirSync(resolvedDir, { recursive: true });
   const tmpPath = `${resolvedPath}.${randomUUID()}.tmp`;
   try {
-    writeFileSync2(tmpPath, data);
-    renameSync2(tmpPath, resolvedPath);
+    writeFileSync(tmpPath, data);
+    renameSync(tmpPath, resolvedPath);
   } catch (err) {
     try {
-      unlinkSync2(tmpPath);
+      unlinkSync(tmpPath);
     } catch {
     }
     throw err;
@@ -3544,13 +3275,14 @@ function validateZipEntryPath(targetDir, entryName) {
   return resolvedEntry;
 }
 var MAX_DOWNLOAD_BYTES = 50 * 1024 * 1024;
-async function downloadSkillZip(client, name, targetDir) {
+async function downloadSkillZip(client, name, targetDir, format = "zip") {
   const result = await client.privatePostBinary(
     "/api/v5/skill/download",
     { name },
     { maxBytes: MAX_DOWNLOAD_BYTES }
   );
-  const fileName = `${name}.zip`;
+  const ext = format === "skill" ? "skill" : "zip";
+  const fileName = `${name}.${ext}`;
   const filePath = safeWriteFile(targetDir, fileName, result.data);
   return filePath;
 }
@@ -3593,7 +3325,7 @@ async function extractSkillZip(zipPath, targetDir, limits) {
   const maxFiles = limits?.maxFiles ?? DEFAULT_MAX_FILES;
   const maxCompressionRatio = limits?.maxCompressionRatio ?? DEFAULT_MAX_COMPRESSION_RATIO;
   const resolvedTarget = resolve2(targetDir);
-  mkdirSync3(resolvedTarget, { recursive: true });
+  mkdirSync2(resolvedTarget, { recursive: true });
   return new Promise((resolvePromise, reject) => {
     yauzl.open(zipPath, { lazyEntries: true }, (err, zipfile) => {
       if (err) return reject(err);
@@ -3616,7 +3348,7 @@ async function extractSkillZip(zipPath, targetDir, limits) {
             zipfile.close();
             return reject(streamErr);
           }
-          mkdirSync3(dirname2(resolvedPath), { recursive: true });
+          mkdirSync2(dirname(resolvedPath), { recursive: true });
           const writeStream = createWriteStream(resolvedPath);
           readStream.pipe(writeStream);
           writeStream.on("close", () => zipfile.readEntry());
@@ -3632,11 +3364,11 @@ async function extractSkillZip(zipPath, targetDir, limits) {
   });
 }
 function readMetaJson(contentDir) {
-  const metaPath = join4(contentDir, "_meta.json");
+  const metaPath = join2(contentDir, "_meta.json");
   if (!existsSync(metaPath)) {
     throw new Error(`_meta.json not found in ${contentDir}. Invalid skill package.`);
   }
-  const raw = readFileSync2(metaPath, "utf-8");
+  const raw = readFileSync(metaPath, "utf-8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -3658,26 +3390,26 @@ function readMetaJson(contentDir) {
   };
 }
 function validateSkillMdExists(contentDir) {
-  const skillMdPath = join4(contentDir, "SKILL.md");
+  const skillMdPath = join2(contentDir, "SKILL.md");
   if (!existsSync(skillMdPath)) {
     throw new Error(`SKILL.md not found in ${contentDir}. Invalid skill package.`);
   }
 }
-var DEFAULT_REGISTRY_PATH = join5(homedir3(), ".okx", "skills", "registry.json");
+var DEFAULT_REGISTRY_PATH = join3(homedir(), ".okx", "skills", "registry.json");
 function readRegistry(registryPath = DEFAULT_REGISTRY_PATH) {
   if (!existsSync2(registryPath)) {
     return { version: 1, skills: {} };
   }
   try {
-    const raw = readFileSync3(registryPath, "utf-8");
+    const raw = readFileSync2(registryPath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return { version: 1, skills: {} };
   }
 }
 function writeRegistry(registry, registryPath = DEFAULT_REGISTRY_PATH) {
-  mkdirSync4(dirname3(registryPath), { recursive: true });
-  writeFileSync3(registryPath, JSON.stringify(registry, null, 2) + "\n", "utf-8");
+  mkdirSync3(dirname2(registryPath), { recursive: true });
+  writeFileSync2(registryPath, JSON.stringify(registry, null, 2) + "\n", "utf-8");
 }
 function upsertSkillRecord(meta, registryPath = DEFAULT_REGISTRY_PATH) {
   const registry = readRegistry(registryPath);
@@ -3750,7 +3482,7 @@ function registerSkillsTools() {
     {
       name: "skills_download",
       module: "skills",
-      description: "Download a skill zip file from OKX Skills Marketplace to a local directory. Always call skills_search first to confirm the skill name exists. Downloads the latest approved version. NOTE: Downloads third-party developer content as a zip \u2014 does NOT install to agents. For full installation use CLI: okx skill add <name>. Use when the user wants to inspect or manually install a skill package.",
+      description: "Download a skill package from OKX Skills Marketplace to a local directory. Always call skills_search first to confirm the skill name exists. Downloads the latest approved version. NOTE: Downloads third-party developer content \u2014 does NOT install to agents. For full installation use CLI: okx skill add <name>. Use when the user wants to inspect or manually install a skill package.",
       inputSchema: {
         type: "object",
         properties: {
@@ -3760,7 +3492,12 @@ function registerSkillsTools() {
           },
           targetDir: {
             type: "string",
-            description: "Directory path where the zip file will be saved"
+            description: "Directory path where the file will be saved"
+          },
+          format: {
+            type: "string",
+            description: "Output file format: 'zip' or 'skill' (default: 'skill')",
+            enum: ["zip", "skill"]
           }
         },
         required: ["name", "targetDir"],
@@ -3793,7 +3530,8 @@ async function handleSearch(args, ctx) {
 async function handleDownload(args, ctx) {
   const name = String(args.name);
   const targetDir = String(args.targetDir);
-  const filePath = await downloadSkillZip(ctx.client, name, targetDir);
+  const format = args.format === "zip" ? "zip" : "skill";
+  const filePath = await downloadSkillZip(ctx.client, name, targetDir, format);
   return {
     endpoint: "POST /api/v5/skill/download",
     requestTime: (/* @__PURE__ */ new Date()).toISOString(),
@@ -5940,6 +5678,12 @@ function registerFuturesTools() {
   ];
 }
 var TWO_DAYS_MS = 2 * 24 * 60 * 60 * 1e3;
+var DEMO_PROPERTY = {
+  demo: {
+    type: "boolean",
+    description: "Query simulated trading (demo) market data. Default: false (live market data)."
+  }
+};
 function registerMarketTools() {
   return [
     {
@@ -5953,7 +5697,8 @@ function registerMarketTools() {
           instId: {
             type: "string",
             description: "e.g. BTC-USDT, BTC-USDT-SWAP"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -5962,7 +5707,8 @@ function registerMarketTools() {
         const response = await context.client.publicGet(
           "/api/v5/market/ticker",
           { instId: requireString(args, "instId") },
-          publicRateLimit("market_get_ticker", 20)
+          publicRateLimit("market_get_ticker", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -5986,7 +5732,8 @@ function registerMarketTools() {
           instFamily: {
             type: "string",
             description: "e.g. BTC-USD"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instType"]
       },
@@ -5999,7 +5746,8 @@ function registerMarketTools() {
             uly: readString(args, "uly"),
             instFamily: readString(args, "instFamily")
           }),
-          publicRateLimit("market_get_tickers", 20)
+          publicRateLimit("market_get_tickers", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6019,7 +5767,8 @@ function registerMarketTools() {
           sz: {
             type: "number",
             description: "Depth per side, default 1, max 400"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -6031,7 +5780,8 @@ function registerMarketTools() {
             instId: requireString(args, "instId"),
             sz: readNumber(args, "sz")
           }),
-          publicRateLimit("market_get_orderbook", 20)
+          publicRateLimit("market_get_orderbook", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6064,7 +5814,8 @@ function registerMarketTools() {
           limit: {
             type: "number",
             description: "Max results (default 100)"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -6072,6 +5823,7 @@ function registerMarketTools() {
         const args = asRecord(rawArgs);
         const afterTs = readString(args, "after");
         const beforeTs = readString(args, "before");
+        const demo = readBoolean(args, "demo") ?? false;
         const query = compactObject({
           instId: requireString(args, "instId"),
           bar: readString(args, "bar"),
@@ -6083,9 +5835,9 @@ function registerMarketTools() {
         const hasTimestamp = afterTs !== void 0 || beforeTs !== void 0;
         const useHistory = afterTs !== void 0 && Number(afterTs) < Date.now() - TWO_DAYS_MS;
         const path42 = useHistory ? "/api/v5/market/history-candles" : "/api/v5/market/candles";
-        const response = await context.client.publicGet(path42, query, rateLimit);
+        const response = await context.client.publicGet(path42, query, rateLimit, demo);
         if (!useHistory && hasTimestamp && Array.isArray(response.data) && response.data.length === 0) {
-          return normalizeResponse(await context.client.publicGet("/api/v5/market/history-candles", query, rateLimit));
+          return normalizeResponse(await context.client.publicGet("/api/v5/market/history-candles", query, rateLimit, demo));
         }
         return normalizeResponse(response);
       }
@@ -6113,7 +5865,8 @@ function registerMarketTools() {
           instFamily: {
             type: "string",
             description: "e.g. BTC-USD"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instType"]
       },
@@ -6127,7 +5880,8 @@ function registerMarketTools() {
             uly: readString(args, "uly"),
             instFamily: readString(args, "instFamily")
           }),
-          publicRateLimit("market_get_instruments", 20)
+          publicRateLimit("market_get_instruments", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6159,13 +5913,15 @@ function registerMarketTools() {
           limit: {
             type: "number",
             description: "History records (default 20, max 100)"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const isHistory = readBoolean(args, "history") ?? false;
+        const demo = readBoolean(args, "demo") ?? false;
         if (isHistory) {
           const response2 = await context.client.publicGet(
             "/api/v5/public/funding-rate-history",
@@ -6175,14 +5931,16 @@ function registerMarketTools() {
               before: readString(args, "before"),
               limit: readNumber(args, "limit") ?? 20
             }),
-            publicRateLimit("market_get_funding_rate", 20)
+            publicRateLimit("market_get_funding_rate", 20),
+            demo
           );
           return normalizeResponse(response2);
         }
         const response = await context.client.publicGet(
           "/api/v5/public/funding-rate",
           { instId: requireString(args, "instId") },
-          publicRateLimit("market_get_funding_rate", 20)
+          publicRateLimit("market_get_funding_rate", 20),
+          demo
         );
         return normalizeResponse(response);
       }
@@ -6209,7 +5967,8 @@ function registerMarketTools() {
           },
           instFamily: {
             type: "string"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instType"]
       },
@@ -6223,7 +5982,8 @@ function registerMarketTools() {
             uly: readString(args, "uly"),
             instFamily: readString(args, "instFamily")
           }),
-          publicRateLimit("market_get_mark_price", 10)
+          publicRateLimit("market_get_mark_price", 10),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6243,7 +6003,8 @@ function registerMarketTools() {
           limit: {
             type: "number",
             description: "Default 20, max 500"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -6255,7 +6016,8 @@ function registerMarketTools() {
             instId: requireString(args, "instId"),
             limit: readNumber(args, "limit") ?? 20
           }),
-          publicRateLimit("market_get_trades", 20)
+          publicRateLimit("market_get_trades", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6275,7 +6037,8 @@ function registerMarketTools() {
           quoteCcy: {
             type: "string",
             description: "e.g. USD or USDT"
-          }
+          },
+          ...DEMO_PROPERTY
         }
       },
       handler: async (rawArgs, context) => {
@@ -6286,7 +6049,8 @@ function registerMarketTools() {
             instId: readString(args, "instId"),
             quoteCcy: readString(args, "quoteCcy")
           }),
-          publicRateLimit("market_get_index_ticker", 20)
+          publicRateLimit("market_get_index_ticker", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6323,7 +6087,8 @@ function registerMarketTools() {
           history: {
             type: "boolean",
             description: "true=older historical data"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -6340,7 +6105,8 @@ function registerMarketTools() {
             before: readString(args, "before"),
             limit: readNumber(args, "limit")
           }),
-          publicRateLimit("market_get_index_candles", 20)
+          publicRateLimit("market_get_index_candles", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6356,7 +6122,8 @@ function registerMarketTools() {
           instId: {
             type: "string",
             description: "SWAP or FUTURES ID, e.g. BTC-USDT-SWAP"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instId"]
       },
@@ -6365,7 +6132,8 @@ function registerMarketTools() {
         const response = await context.client.publicGet(
           "/api/v5/public/price-limit",
           { instId: requireString(args, "instId") },
-          publicRateLimit("market_get_price_limit", 20)
+          publicRateLimit("market_get_price_limit", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6392,7 +6160,8 @@ function registerMarketTools() {
           },
           instFamily: {
             type: "string"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instType"]
       },
@@ -6406,7 +6175,8 @@ function registerMarketTools() {
             uly: readString(args, "uly"),
             instFamily: readString(args, "instFamily")
           }),
-          publicRateLimit("market_get_open_interest", 20)
+          publicRateLimit("market_get_open_interest", 20),
+          readBoolean(args, "demo") ?? false
         );
         return normalizeResponse(response);
       }
@@ -6427,7 +6197,8 @@ function registerMarketTools() {
           instId: {
             type: "string",
             description: "Optional: filter by specific instrument ID, e.g. AAPL-USDT-SWAP"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: []
       },
@@ -6438,7 +6209,8 @@ function registerMarketTools() {
         const response = await context.client.publicGet(
           "/api/v5/public/instruments",
           compactObject({ instType, instId }),
-          publicRateLimit("market_get_stock_tokens", 20)
+          publicRateLimit("market_get_stock_tokens", 20),
+          readBoolean(args, "demo") ?? false
         );
         const data = response.data;
         const filtered = Array.isArray(data) ? data.filter((item) => item.instCategory === "3") : data;
@@ -6448,7 +6220,7 @@ function registerMarketTools() {
     {
       name: "market_get_instruments_by_category",
       module: "market",
-      description: "Discover tradeable instruments by asset category. Stock tokens (instCategory=3, e.g. AAPL-USDT-SWAP, TSLA-USDT-SWAP), Metals (4, e.g. XAUUSDT-USDT-SWAP for gold), Commodities (5, e.g. OIL-USDT-SWAP for crude oil), Forex (6, e.g. EURUSDT-USDT-SWAP for EUR/USD), Bonds (7, e.g. US30Y-USDT-SWAP). Use this to find instIds before querying prices or placing orders. Filters client-side by instCategory.",
+      description: "Discover tradeable instruments by asset category. Stock tokens (instCategory=3, e.g. AAPL-USDT-SWAP, TSLA-USDT-SWAP), Metals (4, e.g. XAUUSDT-USDT-SWAP for gold), Commodities (5, e.g. OIL-USDT-SWAP for crude oil), Forex (6, e.g. EURUSDT-USDT-SWAP for EUR/USD), Bonds (7, e.g. US30Y-USDT-SWAP for crude oil). Use this to find instIds before querying prices or placing orders. Filters client-side by instCategory.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -6466,7 +6238,8 @@ function registerMarketTools() {
           instId: {
             type: "string",
             description: "Optional: filter by specific instrument ID"
-          }
+          },
+          ...DEMO_PROPERTY
         },
         required: ["instCategory"]
       },
@@ -6478,7 +6251,8 @@ function registerMarketTools() {
         const response = await context.client.publicGet(
           "/api/v5/public/instruments",
           compactObject({ instType, instId }),
-          publicRateLimit("market_get_instruments_by_category", 20)
+          publicRateLimit("market_get_instruments_by_category", 20),
+          readBoolean(args, "demo") ?? false
         );
         const data = response.data;
         const filtered = Array.isArray(data) ? data.filter((item) => item.instCategory === instCategory) : data;
@@ -8000,12 +7774,12 @@ function createToolRunner(client, config) {
   };
 }
 function configFilePath() {
-  return join6(homedir4(), ".okx", "config.toml");
+  return join4(homedir2(), ".okx", "config.toml");
 }
 function readFullConfig() {
   const path42 = configFilePath();
   if (!existsSync3(path42)) return { profiles: {} };
-  const raw = readFileSync4(path42, "utf-8");
+  const raw = readFileSync3(path42, "utf-8");
   try {
     return parse(raw);
   } catch (err) {
@@ -8033,11 +7807,11 @@ var CONFIG_HEADER = `# OKX Trade Kit Configuration
 `;
 function writeFullConfig(config) {
   const path42 = configFilePath();
-  const dir = dirname4(path42);
+  const dir = dirname3(path42);
   if (!existsSync3(dir)) {
-    mkdirSync5(dir, { recursive: true });
+    mkdirSync4(dir, { recursive: true });
   }
-  writeFileSync4(path42, CONFIG_HEADER + stringify(config), "utf-8");
+  writeFileSync3(path42, CONFIG_HEADER + stringify(config), "utf-8");
 }
 function expandShorthand(moduleId) {
   if (moduleId === "all") return [...MODULES];
@@ -8151,21 +7925,21 @@ function loadConfig(cli) {
     verbose: cli.verbose ?? false
   };
 }
-var CACHE_FILE = join7(homedir5(), ".okx", "update-check.json");
+var CACHE_FILE = join5(homedir3(), ".okx", "update-check.json");
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-function readCache2() {
+function readCache() {
   try {
     if (existsSync4(CACHE_FILE)) {
-      return JSON.parse(readFileSync5(CACHE_FILE, "utf-8"));
+      return JSON.parse(readFileSync4(CACHE_FILE, "utf-8"));
     }
   } catch {
   }
   return {};
 }
-function writeCache2(cache) {
+function writeCache(cache) {
   try {
-    mkdirSync6(join7(homedir5(), ".okx"), { recursive: true });
-    writeFileSync5(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+    mkdirSync5(join5(homedir3(), ".okx"), { recursive: true });
+    writeFileSync4(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
   } catch {
   }
 }
@@ -8212,14 +7986,14 @@ async function fetchLatestVersion(packageName) {
 function refreshCacheInBackground(packageName) {
   fetchLatestVersion(packageName).then((latest) => {
     if (!latest) return;
-    const cache = readCache2();
+    const cache = readCache();
     cache[packageName] = { latestVersion: latest, checkedAt: Date.now() };
-    writeCache2(cache);
+    writeCache(cache);
   }).catch(() => {
   });
 }
 function checkForUpdates(packageName, currentVersion) {
-  const cache = readCache2();
+  const cache = readCache();
   const entry = cache[packageName];
   if (entry && isNewerVersion(currentVersion, entry.latestVersion)) {
     process.stderr.write(
@@ -9074,7 +8848,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "caa6dae" : "dev";
+var GIT_HASH = true ? "6d4d559" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -9371,24 +9145,24 @@ async function runCliChecks(config, profile, outputPath) {
 
 // src/commands/upgrade.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync7, mkdirSync as mkdirSync8 } from "fs";
-import { dirname as dirname6, join as join9 } from "path";
-import { homedir as homedir7 } from "os";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync6, mkdirSync as mkdirSync7 } from "fs";
+import { dirname as dirname5, join as join7 } from "path";
+import { homedir as homedir5 } from "os";
 var PACKAGES = ["@okx_ai/okx-trade-mcp", "@okx_ai/okx-trade-cli"];
-var CACHE_FILE2 = join9(homedir7(), ".okx", "last_check");
+var CACHE_FILE2 = join7(homedir5(), ".okx", "last_check");
 var THROTTLE_MS = 12 * 60 * 60 * 1e3;
-var NPM_BIN = join9(dirname6(process.execPath), process.platform === "win32" ? "npm.cmd" : "npm");
+var NPM_BIN = join7(dirname5(process.execPath), process.platform === "win32" ? "npm.cmd" : "npm");
 function readLastCheck() {
   try {
-    return parseInt(readFileSync7(CACHE_FILE2, "utf-8").trim(), 10) || 0;
+    return parseInt(readFileSync6(CACHE_FILE2, "utf-8").trim(), 10) || 0;
   } catch {
     return 0;
   }
 }
 function writeLastCheck() {
   try {
-    mkdirSync8(join9(homedir7(), ".okx"), { recursive: true });
-    writeFileSync7(CACHE_FILE2, String(Math.floor(Date.now() / 1e3)), "utf-8");
+    mkdirSync7(join7(homedir5(), ".okx"), { recursive: true });
+    writeFileSync6(CACHE_FILE2, String(Math.floor(Date.now() / 1e3)), "utf-8");
   } catch {
   }
 }
@@ -10092,6 +9866,39 @@ var HELP_TREE = {
     description: "Run network / MCP server diagnostics",
     usage: "okx diagnose [--cli | --mcp | --all] [--profile <name>] [--demo | --live] [--output <file>]"
   },
+  skill: {
+    description: "OKX Skills Marketplace \u2014 search, install, and manage agent skills",
+    commands: {
+      search: {
+        usage: "okx skill search [--keyword <kw>] [--categories <id>] [--page <n>] [--limit <n>]",
+        description: "Search for skills in the marketplace"
+      },
+      categories: {
+        usage: "okx skill categories",
+        description: "List available skill categories"
+      },
+      add: {
+        usage: "okx skill add <name>",
+        description: "Download and install a skill to detected agents"
+      },
+      download: {
+        usage: "okx skill download <name> [--dir <path>] [--format zip|skill]",
+        description: "Download a skill package without installing"
+      },
+      remove: {
+        usage: "okx skill remove <name>",
+        description: "Remove an installed skill"
+      },
+      check: {
+        usage: "okx skill check <name>",
+        description: "Check if an installed skill has a newer version"
+      },
+      list: {
+        usage: "okx skill list",
+        description: "List all locally installed skills"
+      }
+    }
+  },
   upgrade: {
     description: "Upgrade okx CLI and MCP server to the latest stable version",
     usage: "okx upgrade [--check] [--beta] [--force] [--json]"
@@ -10387,6 +10194,7 @@ var CLI_OPTIONS = {
   categories: { type: "string" },
   dir: { type: "string" },
   page: { type: "string" },
+  format: { type: "string" },
   // diagnostics — cli/mcp/all/output are diagnose-specific; verbose is shared
   verbose: { type: "boolean", default: false },
   mcp: { type: "boolean", default: false },
@@ -10426,7 +10234,7 @@ function getData(result) {
   return result.data;
 }
 async function cmdMarketInstruments(run, opts) {
-  const result = await run("market_get_instruments", { instType: opts.instType, instId: opts.instId });
+  const result = await run("market_get_instruments", { instType: opts.instType, instId: opts.instId, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -10441,7 +10249,7 @@ async function cmdMarketInstruments(run, opts) {
   );
 }
 async function cmdMarketFundingRate(run, instId, opts) {
-  const result = await run("market_get_funding_rate", { instId, history: opts.history, limit: opts.limit });
+  const result = await run("market_get_funding_rate", { instId, history: opts.history, limit: opts.limit, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   if (opts.history) {
@@ -10469,7 +10277,7 @@ async function cmdMarketFundingRate(run, instId, opts) {
   }
 }
 async function cmdMarketMarkPrice(run, opts) {
-  const result = await run("market_get_mark_price", { instType: opts.instType, instId: opts.instId });
+  const result = await run("market_get_mark_price", { instType: opts.instType, instId: opts.instId, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -10482,7 +10290,7 @@ async function cmdMarketMarkPrice(run, opts) {
   );
 }
 async function cmdMarketTrades(run, instId, opts) {
-  const result = await run("market_get_trades", { instId, limit: opts.limit });
+  const result = await run("market_get_trades", { instId, limit: opts.limit, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -10496,7 +10304,7 @@ async function cmdMarketTrades(run, instId, opts) {
   );
 }
 async function cmdMarketIndexTicker(run, opts) {
-  const result = await run("market_get_index_ticker", { instId: opts.instId, quoteCcy: opts.quoteCcy });
+  const result = await run("market_get_index_ticker", { instId: opts.instId, quoteCcy: opts.quoteCcy, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -10510,7 +10318,7 @@ async function cmdMarketIndexTicker(run, opts) {
   );
 }
 async function cmdMarketIndexCandles(run, instId, opts) {
-  const result = await run("market_get_index_candles", { instId, bar: opts.bar, limit: opts.limit, history: opts.history });
+  const result = await run("market_get_index_candles", { instId, bar: opts.bar, limit: opts.limit, history: opts.history, demo: opts.demo ?? false });
   const candles = getData(result);
   if (opts.json) return printJson(candles);
   printTable(
@@ -10523,8 +10331,8 @@ async function cmdMarketIndexCandles(run, instId, opts) {
     }))
   );
 }
-async function cmdMarketPriceLimit(run, instId, json) {
-  const result = await run("market_get_price_limit", { instId });
+async function cmdMarketPriceLimit(run, instId, json, demo) {
+  const result = await run("market_get_price_limit", { instId, demo: demo ?? false });
   const items = getData(result);
   if (json) return printJson(items);
   const r = items?.[0];
@@ -10540,7 +10348,7 @@ async function cmdMarketPriceLimit(run, instId, json) {
   });
 }
 async function cmdMarketOpenInterest(run, opts) {
-  const result = await run("market_get_open_interest", { instType: opts.instType, instId: opts.instId });
+  const result = await run("market_get_open_interest", { instType: opts.instType, instId: opts.instId, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -10552,8 +10360,8 @@ async function cmdMarketOpenInterest(run, opts) {
     }))
   );
 }
-async function cmdMarketTicker(run, instId, json) {
-  const result = await run("market_get_ticker", { instId });
+async function cmdMarketTicker(run, instId, json, demo) {
+  const result = await run("market_get_ticker", { instId, demo: demo ?? false });
   const items = getData(result);
   if (json) return printJson(items);
   if (!items?.length) {
@@ -10576,8 +10384,8 @@ async function cmdMarketTicker(run, instId, json) {
     time: new Date(Number(t["ts"])).toLocaleString()
   });
 }
-async function cmdMarketTickers(run, instType, json) {
-  const result = await run("market_get_tickers", { instType });
+async function cmdMarketTickers(run, instType, json, demo) {
+  const result = await run("market_get_tickers", { instType, demo: demo ?? false });
   const items = getData(result);
   if (json) return printJson(items);
   printTable(
@@ -10590,8 +10398,8 @@ async function cmdMarketTickers(run, instType, json) {
     }))
   );
 }
-async function cmdMarketOrderbook(run, instId, sz, json) {
-  const result = await run("market_get_orderbook", { instId, sz });
+async function cmdMarketOrderbook(run, instId, sz, json, demo) {
+  const result = await run("market_get_orderbook", { instId, sz, demo: demo ?? false });
   const data = getData(result);
   if (json) return printJson(data);
   const book = data[0];
@@ -10608,7 +10416,7 @@ async function cmdMarketOrderbook(run, instId, sz, json) {
   for (const [p, s] of bids) outputLine(`  ${p.padStart(16)}  ${s}`);
 }
 async function cmdMarketCandles(run, instId, opts) {
-  const result = await run("market_get_candles", { instId, bar: opts.bar, limit: opts.limit, after: opts.after, before: opts.before });
+  const result = await run("market_get_candles", { instId, bar: opts.bar, limit: opts.limit, after: opts.after, before: opts.before, demo: opts.demo ?? false });
   const candles = getData(result);
   if (opts.json) return printJson(candles);
   printTable(
@@ -10678,7 +10486,8 @@ async function cmdMarketInstrumentsByCategory(run, opts) {
   const result = await run("market_get_instruments_by_category", {
     instCategory: opts.instCategory,
     instType: opts.instType,
-    instId: opts.instId
+    instId: opts.instId,
+    demo: opts.demo ?? false
   });
   const items = getData(result);
   if (opts.json) return printJson(items);
@@ -10706,7 +10515,7 @@ async function cmdMarketInstrumentsByCategory(run, opts) {
   );
 }
 async function cmdMarketStockTokens(run, opts) {
-  const result = await run("market_get_stock_tokens", { instType: opts.instType, instId: opts.instId });
+  const result = await run("market_get_stock_tokens", { instType: opts.instType, instId: opts.instId, demo: opts.demo ?? false });
   const items = getData(result);
   if (opts.json) return printJson(items);
   printTable(
@@ -13216,13 +13025,13 @@ async function cmdDcdQuoteAndBuy(run, opts) {
 }
 
 // src/commands/skill.ts
-import { tmpdir, homedir as homedir9 } from "os";
-import { join as join11, dirname as dirname7 } from "path";
-import { mkdirSync as mkdirSync9, rmSync, existsSync as existsSync7, copyFileSync as copyFileSync2 } from "fs";
+import { tmpdir, homedir as homedir7 } from "os";
+import { join as join9, dirname as dirname6 } from "path";
+import { mkdirSync as mkdirSync8, rmSync, existsSync as existsSync7, copyFileSync as copyFileSync2 } from "fs";
 import { execFileSync as execFileSync2 } from "child_process";
 import { randomUUID as randomUUID2 } from "crypto";
 function resolveNpx() {
-  const sibling = join11(dirname7(process.execPath), "npx");
+  const sibling = join9(dirname6(process.execPath), "npx");
   if (existsSync7(sibling)) return sibling;
   return "npx";
 }
@@ -13276,13 +13085,13 @@ async function cmdSkillCategories(run, json) {
   outputLine("");
 }
 async function cmdSkillAdd(name, config, json) {
-  const tmpBase = join11(tmpdir(), `okx-skill-${randomUUID2()}`);
-  mkdirSync9(tmpBase, { recursive: true });
+  const tmpBase = join9(tmpdir(), `okx-skill-${randomUUID2()}`);
+  mkdirSync8(tmpBase, { recursive: true });
   try {
     outputLine(`Downloading ${name}...`);
     const client = new OkxRestClient(config);
     const zipPath = await downloadSkillZip(client, name, tmpBase);
-    const contentDir = await extractSkillZip(zipPath, join11(tmpBase, "content"));
+    const contentDir = await extractSkillZip(zipPath, join9(tmpBase, "content"));
     const meta = readMetaJson(contentDir);
     validateSkillMdExists(contentDir);
     outputLine("Installing to detected agents...");
@@ -13292,7 +13101,7 @@ async function cmdSkillAdd(name, config, json) {
         timeout: 6e4
       });
     } catch (e) {
-      const savedZip = join11(process.cwd(), `${name}.zip`);
+      const savedZip = join9(process.cwd(), `${name}.zip`);
       try {
         copyFileSync2(zipPath, savedZip);
       } catch {
@@ -13307,14 +13116,14 @@ async function cmdSkillAdd(name, config, json) {
     rmSync(tmpBase, { recursive: true, force: true });
   }
 }
-async function cmdSkillDownload(name, targetDir, config, json) {
+async function cmdSkillDownload(name, targetDir, config, json, format = "zip") {
   outputLine(`Downloading ${name}...`);
   const client = new OkxRestClient(config);
-  const filePath = await downloadSkillZip(client, name, targetDir);
+  const filePath = await downloadSkillZip(client, name, targetDir, format);
   if (json) {
     outputLine(JSON.stringify({ name, filePath }, null, 2));
   } else {
-    outputLine(`\u2713 Downloaded ${name}.zip`);
+    outputLine(`\u2713 Downloaded ${name}.${format}`);
     outputLine(`  Path: ${filePath}`);
   }
 }
@@ -13331,7 +13140,7 @@ function cmdSkillRemove(name, json) {
       timeout: 6e4
     });
   } catch {
-    const agentsPath = join11(homedir9(), ".agents", "skills", name);
+    const agentsPath = join9(homedir7(), ".agents", "skills", name);
     try {
       rmSync(agentsPath, { recursive: true, force: true });
     } catch {
@@ -13407,7 +13216,7 @@ function printSkillInstallResult(meta, json) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "caa6dae" : "dev";
+var GIT_HASH2 = true ? "6d4d559" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -13437,25 +13246,26 @@ function handleSetupCommand(v) {
   });
 }
 function handleMarketPublicCommand(run, action, rest, v, json) {
-  if (action === "ticker") return cmdMarketTicker(run, rest[0], json);
-  if (action === "tickers") return cmdMarketTickers(run, rest[0], json);
+  if (action === "ticker") return cmdMarketTicker(run, rest[0], json, v.demo);
+  if (action === "tickers") return cmdMarketTickers(run, rest[0], json, v.demo);
   if (action === "instruments")
-    return cmdMarketInstruments(run, { instType: v.instType, instId: v.instId, json });
+    return cmdMarketInstruments(run, { instType: v.instType, instId: v.instId, json, demo: v.demo });
   if (action === "mark-price")
-    return cmdMarketMarkPrice(run, { instType: v.instType, instId: v.instId, json });
+    return cmdMarketMarkPrice(run, { instType: v.instType, instId: v.instId, json, demo: v.demo });
   if (action === "index-ticker")
-    return cmdMarketIndexTicker(run, { instId: v.instId, quoteCcy: v.quoteCcy, json });
-  if (action === "price-limit") return cmdMarketPriceLimit(run, rest[0], json);
+    return cmdMarketIndexTicker(run, { instId: v.instId, quoteCcy: v.quoteCcy, json, demo: v.demo });
+  if (action === "price-limit") return cmdMarketPriceLimit(run, rest[0], json, v.demo);
   if (action === "open-interest")
-    return cmdMarketOpenInterest(run, { instType: v.instType, instId: v.instId, json });
+    return cmdMarketOpenInterest(run, { instType: v.instType, instId: v.instId, json, demo: v.demo });
   if (action === "stock-tokens")
-    return cmdMarketStockTokens(run, { instType: v.instType, instId: v.instId, json });
+    return cmdMarketStockTokens(run, { instType: v.instType, instId: v.instId, json, demo: v.demo });
   if (action === "instruments-by-category")
     return cmdMarketInstrumentsByCategory(run, {
       instCategory: v.instCategory,
       instType: v.instType,
       instId: v.instId,
-      json
+      json,
+      demo: v.demo
     });
   if (action === "indicator") return handleIndicatorAction(run, rest, v, json);
 }
@@ -13475,15 +13285,15 @@ function handleIndicatorAction(run, rest, v, json) {
 function handleMarketDataCommand(run, action, rest, v, json) {
   const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
   if (action === "orderbook")
-    return cmdMarketOrderbook(run, rest[0], v.sz !== void 0 ? Number(v.sz) : void 0, json);
+    return cmdMarketOrderbook(run, rest[0], v.sz !== void 0 ? Number(v.sz) : void 0, json, v.demo);
   if (action === "candles")
-    return cmdMarketCandles(run, rest[0], { bar: v.bar, limit, after: v.after, before: v.before, json });
+    return cmdMarketCandles(run, rest[0], { bar: v.bar, limit, after: v.after, before: v.before, json, demo: v.demo });
   if (action === "funding-rate")
-    return cmdMarketFundingRate(run, rest[0], { history: v.history ?? false, limit, json });
+    return cmdMarketFundingRate(run, rest[0], { history: v.history ?? false, limit, json, demo: v.demo });
   if (action === "trades")
-    return cmdMarketTrades(run, rest[0], { limit, json });
+    return cmdMarketTrades(run, rest[0], { limit, json, demo: v.demo });
   if (action === "index-candles")
-    return cmdMarketIndexCandles(run, rest[0], { bar: v.bar, limit, history: v.history ?? false, 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);
@@ -14192,8 +14002,9 @@ function handleSkillAdd(rest, config, json) {
   if (n) return cmdSkillAdd(n, config, json);
 }
 function handleSkillDownload(rest, v, config, json) {
-  const n = requireSkillName(rest, "Usage: okx skill download <name> [--dir <path>]");
-  if (n) return cmdSkillDownload(n, v.dir ?? process.cwd(), config, json);
+  const n = requireSkillName(rest, "Usage: okx skill download <name> [--dir <path>] [--format zip|skill]");
+  const format = v.format === "skill" ? "skill" : "zip";
+  if (n) return cmdSkillDownload(n, v.dir ?? process.cwd(), config, json, format);
 }
 function handleSkillRemove(rest, json) {
   const n = requireSkillName(rest, "Usage: okx skill remove <name>");
@@ -14228,7 +14039,7 @@ function printHelpForLevel(positionals) {
   else if (!subgroup) printHelp(module);
   else printHelp(module, subgroup);
 }
-function wrapRunnerWithLogger(baseRunner, logger) {
+function wrapRunnerWithLogger(baseRunner, logger, verbose = false) {
   const writeToolNames = new Set(allToolSpecs().filter((t) => t.isWrite).map((t) => t.name));
   return async (toolName, args) => {
     const startTime = Date.now();
@@ -14237,7 +14048,11 @@ function wrapRunnerWithLogger(baseRunner, logger) {
       if (writeToolNames.has(toolName)) {
         markFailedIfSCodeError(result.data);
       }
-      logger.log("info", toolName, args, result, Date.now() - startTime);
+      const elapsed = Date.now() - startTime;
+      logger.log("info", toolName, args, { status: "ok" }, elapsed);
+      if (verbose) {
+        logger.log("debug", toolName, args, result, elapsed);
+      }
       return result;
     } catch (error) {
       logger.log("error", toolName, args, error, Date.now() - startTime);
@@ -14280,8 +14095,8 @@ async function main() {
   setJsonEnvEnabled(v.env ?? false);
   const client = new OkxRestClient(config);
   const baseRunner = createToolRunner(client, config);
-  const logger = new TradeLogger("info");
-  const run = wrapRunnerWithLogger(baseRunner, logger);
+  const logger = new TradeLogger(v.verbose ? "debug" : "info");
+  const run = wrapRunnerWithLogger(baseRunner, logger, v.verbose ?? false);
   const moduleHandlers = {
     market: () => handleMarketCommand(run, action, rest, v, json),
     account: () => handleAccountCommand(run, action, rest, v, json),