desic-okx-agent 0.1.8 → 0.2.0

package/dist/tools/help.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { toolByName } from "./catalog.js";
+export function getToolHelp(name) {
+    const definition = toolByName(name);
+    if (!definition)
+        return undefined;
+    return {
+        name: definition.name,
+        description: definition.description,
+        accountRequirement: accountRequirement(name),
+        inputSchema: z.toJSONSchema(definition.schema),
+        example: toolExample(name)
+    };
+}
+export function toolExample(name) {
+    const exact = EXAMPLES[name];
+    if (exact)
+        return structuredClone(exact);
+    if (name.startsWith("market_"))
+        return { instId: "BTC-USDT-SWAP" };
+    if (name.startsWith("derivatives_"))
+        return { instId: "BTC-USDT-SWAP", period: "5m", limit: 50 };
+    if (name.startsWith("news_"))
+        return { account: "default", limit: 20 };
+    if (name.startsWith("smart_money_"))
+        return { account: "default", period: "7", limit: 20 };
+    if (name.startsWith("account_"))
+        return { account: "default" };
+    return {};
+}
+function accountRequirement(name) {
+    if (name.startsWith("news_") || name.startsWith("smart_money_"))
+        return "live-read-only";
+    if (name.startsWith("account_") || name.startsWith("trade_precheck_"))
+        return "account-read";
+    if (name.startsWith("trade_") && name !== "trade_evaluate_plan")
+        return "account-trade";
+    return "none";
+}
+const EXAMPLES = {
+    market_get_candles: { instId: "BTC-USDT-SWAP", bar: "5m", limit: 100 },
+    market_get_indicators: { instId: "BTC-USDT-SWAP", bar: "5m", limit: 200 },
+    market_get_decision_snapshot: { instId: "BTC-USDT-SWAP", bar: "1m", limit: 100 },
+    market_scan_watchlist: { instIds: ["BTC-USDT-SWAP", "ETH-USDT-SWAP"], bar: "5m" },
+    news_search: { account: "default", keyword: "Bitcoin ETF", coins: ["BTC"], limit: 20 },
+    news_read_detail: { account: "default", id: "NEWS_ITEM_ID" },
+    news_read_coin_sentiment: { account: "default", coins: ["BTC", "ETH"], period: "24h" },
+    news_read_coin_sentiment_trend: { account: "default", coins: ["BTC"], period: "1h", limit: 24 },
+    news_read_market_reaction: { id: "LOCAL_EVENT_ID", instId: "BTC-USDT-SWAP", bar: "5m", limit: 100 },
+    smart_money_search_trader: { account: "default", keyword: "TRADER_NAME" },
+    smart_money_read_positions: { account: "default", authorId: "TRADER_ID" },
+    account_get_positions: { account: "default", instId: "BTC-USDT-SWAP" },
+    account_get_order: { account: "default", instId: "BTC-USDT-SWAP", ordId: "ORDER_ID" },
+    account_get_order_history: { account: "default", instType: "SWAP", limit: 50 },
+    trade_evaluate_plan: { instId: "BTC-USDT-SWAP", side: "buy", size: "1", leverage: "3", stopLossPrice: "90000" },
+    trade_precheck_order: ordinaryOrder("precheck-btc-001"),
+    trade_place_order: ordinaryOrder("place-btc-001"),
+    trade_place_batch_orders: {
+        account: "default", executionKey: "batch-btc-001",
+        orders: [{ instId: "BTC-USDT-SWAP", tdMode: "cross", side: "buy", ordType: "limit", size: "1", price: "90000" }]
+    },
+    trade_set_leverage: { account: "default", executionKey: "leverage-btc-001", instId: "BTC-USDT-SWAP", lever: "3", mgnMode: "cross" },
+    trade_amend_order: { account: "default", executionKey: "amend-btc-001", instId: "BTC-USDT-SWAP", ordId: "ORDER_ID", newPrice: "90500" },
+    trade_cancel_order: { account: "default", executionKey: "cancel-btc-001", instId: "BTC-USDT-SWAP", ordId: "ORDER_ID" },
+    trade_precheck_algo_order: algoOrder("precheck-algo-btc-001"),
+    trade_place_algo_order: algoOrder("place-algo-btc-001"),
+    trade_amend_algo_order: { account: "default", executionKey: "amend-algo-btc-001", instId: "BTC-USDT-SWAP", algoId: "ALGO_ID", newTriggerPrice: "88000" },
+    trade_cancel_algo_order: { account: "default", executionKey: "cancel-algo-btc-001", instId: "BTC-USDT-SWAP", algoId: "ALGO_ID" },
+    trade_close_position: { account: "default", executionKey: "close-btc-001", instId: "BTC-USDT-SWAP", mgnMode: "cross", posSide: "net" },
+    trade_cancel_instrument_orders: { account: "default", executionKey: "cancel-all-btc-001", instId: "BTC-USDT-SWAP" },
+    trade_close_instrument_positions: { account: "default", executionKey: "close-all-btc-001", instId: "BTC-USDT-SWAP" }
+};
+function ordinaryOrder(executionKey) {
+    return { account: "default", executionKey, instId: "BTC-USDT-SWAP", tdMode: "cross", side: "buy", ordType: "limit", size: "1", price: "90000" };
+}
+function algoOrder(executionKey) {
+    return { account: "default", executionKey, instId: "BTC-USDT-SWAP", tdMode: "cross", side: "sell", ordType: "trigger", size: "1", triggerPrice: "88000", orderPrice: "-1", reduceOnly: true };
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,kBAAkB,EAAE,kBAAkB,CAAC,IAAI,CAAC;QAC5C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;QAC9C,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,KAAK;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACnE,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjG,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvE,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3F,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC/D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACzF,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,cAAc,CAAC;IAC7F,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,qBAAqB;QAAE,OAAO,eAAe,CAAC;IACxF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,QAAQ,GAA4C;IACxD,kBAAkB,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IACtE,qBAAqB,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IACzE,4BAA4B,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAChF,qBAAqB,EAAE,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE;IACjF,WAAW,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACtF,gBAAgB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;IAC5D,wBAAwB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;IACtF,8BAA8B,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IAC/F,yBAAyB,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IACnG,yBAAyB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IACzE,0BAA0B,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE;IACzE,qBAAqB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE;IACtE,iBAAiB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE;IACrF,yBAAyB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9E,mBAAmB,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE;IAC/G,oBAAoB,EAAE,aAAa,CAAC,kBAAkB,CAAC;IACvD,iBAAiB,EAAE,aAAa,CAAC,eAAe,CAAC;IACjD,wBAAwB,EAAE;QACxB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe;QACjD,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;KACjH;IACD,kBAAkB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE;IACnI,iBAAiB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE;IACvI,kBAAkB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE;IACtH,yBAAyB,EAAE,SAAS,CAAC,uBAAuB,CAAC;IAC7D,sBAAsB,EAAE,SAAS,CAAC,oBAAoB,CAAC;IACvD,sBAAsB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE;IACxJ,uBAAuB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE;IAChI,oBAAoB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACtI,8BAA8B,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,EAAE;IACnH,gCAAgC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,eAAe,EAAE;CACrH,CAAC;AAEF,SAAS,aAAa,CAAC,YAAoB;IACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClJ,CAAC;AAED,SAAS,SAAS,CAAC,YAAoB;IACrC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAChM,CAAC"}

package/dist/update/service.d.ts

@@ -0,0 +1,10 @@
+export declare const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org";
+export interface UpdateInfo {
+    current: string;
+    latest: string;
+    updateAvailable: boolean;
+    registry: string;
+}
+export declare function checkForUpdate(registry?: string, configuredProxy?: string): Promise<UpdateInfo>;
+export declare function installLatestVersion(info: UpdateInfo): Promise<number>;
+export declare function runInstalledCommand(args: string[]): Promise<number>;

package/dist/update/service.js

@@ -0,0 +1,104 @@
+import { spawn } from "node:child_process";
+import { ProxyAgent } from "undici";
+import { PACKAGE_VERSION } from "../core/version.js";
+import { resolveProxy } from "../network/proxy.js";
+import { RuntimeClient } from "../runtime/client.js";
+import { isProcessRunning, readRuntimeState } from "../runtime/state.js";
+export const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org";
+export async function checkForUpdate(registry = OFFICIAL_NPM_REGISTRY, configuredProxy) {
+    const proxy = resolveProxy(configuredProxy);
+    const dispatcher = proxy.url ? new ProxyAgent(proxy.url) : undefined;
+    try {
+        const base = registry.replace(/\/$/, "");
+        const response = await fetch(`${base}/desic-okx-agent/latest`, {
+            signal: AbortSignal.timeout(10_000),
+            ...(dispatcher ? { dispatcher } : {})
+        });
+        if (!response.ok)
+            throw new Error(`npm registry returned HTTP ${response.status}`);
+        const data = await response.json();
+        if (!data.version)
+            throw new Error("npm registry did not return a package version");
+        return {
+            current: PACKAGE_VERSION,
+            latest: data.version,
+            updateAvailable: compareVersions(data.version, PACKAGE_VERSION) > 0,
+            registry: base
+        };
+    }
+    finally {
+        await dispatcher?.close();
+    }
+}
+export async function installLatestVersion(info) {
+    await stopRuntimeForUpdate();
+    const command = process.platform === "win32" ? "npm.cmd" : "npm";
+    const args = ["install", "--global", `desic-okx-agent@${info.latest}`, `--registry=${info.registry}`];
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: "inherit",
+            windowsHide: false,
+            shell: process.platform === "win32"
+        });
+        child.once("error", reject);
+        child.once("exit", (code) => resolve(code ?? 1));
+    });
+}
+export async function runInstalledCommand(args) {
+    const command = process.platform === "win32" ? "desic-okx.cmd" : "desic-okx";
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: "inherit",
+            windowsHide: false,
+            shell: process.platform === "win32"
+        });
+        child.once("error", reject);
+        child.once("exit", (code) => resolve(code ?? 1));
+    });
+}
+async function stopRuntimeForUpdate() {
+    const state = readRuntimeState();
+    if (!state)
+        return;
+    let pid = state.pid;
+    let stopRequested = false;
+    try {
+        const client = await RuntimeClient.connect({ start: false });
+        const health = await client.health();
+        pid = Number(health.pid);
+        await client.stop();
+        stopRequested = true;
+    }
+    catch (error) {
+        if (isProcessRunning(pid))
+            throw new Error(`Runtime PID ${pid} is running but could not be contacted safely: ${error instanceof Error ? error.message : "unknown error"}`);
+        return;
+    }
+    await waitForProcess(pid, 5_000);
+    if (stopRequested && isProcessRunning(pid)) {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch { }
+        await waitForProcess(pid, 2_000);
+    }
+    if (isProcessRunning(pid))
+        throw new Error(`Runtime PID ${pid} did not stop`);
+}
+async function waitForProcess(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Number.isInteger(pid) && isProcessRunning(pid) && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+}
+function compareVersions(left, right) {
+    const parse = (value) => value.split(".").map((part) => Number.parseInt(part, 10) || 0);
+    const a = parse(left);
+    const b = parse(right);
+    for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
+        if ((a[index] ?? 0) !== (b[index] ?? 0))
+            return (a[index] ?? 0) > (b[index] ?? 0) ? 1 : -1;
+    }
+    return 0;
+}
+//# sourceMappingURL=service.js.map

package/dist/update/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/update/service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "desic-okx-agent",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Independent Desic runtime, MCP server, CLI, and agent skills for OKX",
   "type": "module",
   "license": "MIT",

package/skills/okx-news-intelligence/SKILL.md

@@ -5,6 +5,8 @@ description: Research OKX news, sources, coin sentiment, economic events, cluste
 
 # OKX News Intelligence
 
+Remote News, source, sentiment, calendar, and briefing tools require a configured live OKX account. Read-only API permission is sufficient. Local event and history tools can use previously persisted data when available.
+
 1. Use `news_search` for a targeted question and `news_list` for current coverage.
 2. Read details when a headline is material; record source, publication time, language, and freshness.
 3. Use sentiment trends and rankings as aggregated observations, not as factual confirmation of an event.

package/skills/okx-smart-money-analysis/SKILL.md

@@ -5,6 +5,8 @@ description: Analyze OKX public trader rankings, performance, positions, histori
 
 # OKX Smart Money Analysis
 
+Remote Smart Money tools require a configured live OKX account. Read-only API permission is sufficient. Local history is available only after data has previously been persisted.
+
 1. Define the period, sort field, filters, and sample size before comparing traders.
 2. Use performance to shortlist; inspect current positions and history before interpreting behavior.
 3. Separate current positions, closed-position history, public order history, signal overview, and signal trend.