desic-okx-agent 0.1.0

package/dist/core/sanitize.js

@@ -0,0 +1,19 @@
+const PRIVATE_KEYS = /^(tag|api[-_]?key|secret(?:[-_]?key)?|passphrase|ok-access-(?:key|sign|passphrase))$/i;
+export function sanitizeValue(value, accounts = []) {
+    const secrets = [...accounts].flatMap((account) => [account.apiKey, account.secretKey, account.passphrase]).filter(Boolean);
+    return sanitizeInner(value, secrets);
+}
+function sanitizeInner(value, secrets) {
+    if (Array.isArray(value))
+        return value.map((item) => sanitizeInner(item, secrets));
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([key]) => !PRIVATE_KEYS.test(key))
+            .map(([key, item]) => [key, sanitizeInner(item, secrets)]));
+    }
+    if (typeof value === "string") {
+        return secrets.reduce((text, secret) => (secret ? text.split(secret).join("[REDACTED]") : text), value);
+    }
+    return value;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/core/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/core/sanitize.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,uFAAuF,CAAC;AAE7G,MAAM,UAAU,aAAa,CAAI,KAAQ,EAAE,WAAyC,EAAE;IACpF,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5H,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAM,CAAC;AAC5C,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,OAAiB;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,38 @@
+export type OkxEnvironment = "demo" | "live";
+export interface AccountCredentials {
+    name: string;
+    environment: OkxEnvironment;
+    apiKey: string;
+    secretKey: string;
+    passphrase: string;
+}
+export type DataSource = "memory" | "rest" | "websocket" | "sqlite" | "derived" | "mixed";
+export interface ResultMeta {
+    requestId: string;
+    environment: OkxEnvironment | "public";
+    source: DataSource;
+    exchangeTs: number | null;
+    receivedAt: number;
+    ageMs: number | null;
+    warnings: string[];
+    account?: string;
+}
+export interface ToolResult<T = unknown> {
+    data: T;
+    meta: ResultMeta;
+}
+export interface OkxEnvelope<T = Record<string, unknown>> {
+    code: string;
+    msg: string;
+    data: T[];
+    inTime?: string;
+    outTime?: string;
+}
+export interface TimedValue<T> {
+    value: T;
+    exchangeTs: number;
+    receivedAt: number;
+    source: DataSource;
+}
+export declare function requestId(): string;
+export declare function resultMeta(options: Partial<ResultMeta> & Pick<ResultMeta, "source">): ResultMeta;

package/dist/core/types.js

@@ -0,0 +1,18 @@
+export function requestId() {
+    return crypto.randomUUID();
+}
+export function resultMeta(options) {
+    const receivedAt = options.receivedAt ?? Date.now();
+    const exchangeTs = options.exchangeTs ?? null;
+    return {
+        requestId: options.requestId ?? requestId(),
+        environment: options.environment ?? "public",
+        source: options.source,
+        exchangeTs,
+        receivedAt,
+        ageMs: exchangeTs === null ? null : Math.max(0, receivedAt - exchangeTs),
+        warnings: options.warnings ?? [],
+        ...(options.account ? { account: options.account } : {})
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAyD;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS,EAAE;QAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ;QAC5C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU;QACV,UAAU;QACV,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;QACxE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/derivatives/service.d.ts

@@ -0,0 +1,28 @@
+import { OkxClient } from "../core/okx-client.js";
+import { type ToolResult } from "../core/types.js";
+import type { RuntimeDatabase } from "../storage/database.js";
+export interface DerivativesQuery {
+    instId: string;
+    period?: string;
+    begin?: number;
+    end?: number;
+    limit?: number;
+}
+export declare class DerivativesService {
+    private readonly client;
+    private readonly database;
+    private nextRubikAt;
+    private rubikChain;
+    constructor(client: OkxClient, database: RuntimeDatabase);
+    positioning(query: DerivativesQuery): Promise<ToolResult<unknown[]>>;
+    takerFlow(query: DerivativesQuery): Promise<ToolResult<unknown[]>>;
+    crowding(query: DerivativesQuery): Promise<ToolResult<Record<string, unknown>>>;
+    fundingBasis(query: DerivativesQuery): Promise<ToolResult<Record<string, unknown>>>;
+    liquidations(query: DerivativesQuery): Promise<ToolResult<unknown[]>>;
+    systemStress(query: DerivativesQuery): Promise<ToolResult<Record<string, unknown>>>;
+    positionChanges(query: DerivativesQuery): Promise<ToolResult<unknown[]>>;
+    consensus(query: DerivativesQuery): Promise<ToolResult<Record<string, unknown>>>;
+    decisionSnapshot(query: DerivativesQuery): Promise<ToolResult<Record<string, unknown>>>;
+    private rubik;
+    private persist;
+}

package/dist/derivatives/service.js

@@ -0,0 +1,144 @@
+import crypto from "node:crypto";
+import { resultMeta } from "../core/types.js";
+export class DerivativesService {
+    client;
+    database;
+    nextRubikAt = 0;
+    rubikChain = Promise.resolve();
+    constructor(client, database) {
+        this.client = client;
+        this.database = database;
+    }
+    async positioning(query) {
+        const data = await this.rubik("/api/v5/rubik/stat/contracts/open-interest-history", query);
+        this.persist("positioning", query.instId, data);
+        return wrap(data);
+    }
+    async takerFlow(query) {
+        const data = await this.rubik("/api/v5/rubik/stat/taker-volume-contract", query, { unit: "2" });
+        this.persist("taker_flow", query.instId, data);
+        return wrap(data);
+    }
+    async crowding(query) {
+        const paths = [
+            "/api/v5/rubik/stat/contracts/long-short-account-ratio-contract",
+            "/api/v5/rubik/stat/contracts/long-short-account-ratio-contract-top-trader",
+            "/api/v5/rubik/stat/contracts/long-short-position-ratio-contract-top-trader"
+        ];
+        const [accountRatio, topAccountRatio, topPositionRatio] = await Promise.all(paths.map((path) => this.rubik(path, query)));
+        const data = { accountRatio, topAccountRatio, topPositionRatio };
+        this.persist("crowding", query.instId, [data]);
+        return wrap(data);
+    }
+    async fundingBasis(query) {
+        const family = query.instId.replace(/-SWAP$/, "");
+        const [current, history, premium, mark, index] = await Promise.all([
+            this.client.publicGet("/api/v5/public/funding-rate", { instId: query.instId }),
+            this.client.publicGet("/api/v5/public/funding-rate-history", { instId: query.instId, limit: Math.min(query.limit ?? 100, 100) }),
+            this.client.publicGet("/api/v5/public/premium-history", common(query)),
+            this.client.publicGet("/api/v5/public/mark-price", { instType: "SWAP", instId: query.instId }),
+            this.client.publicGet("/api/v5/market/index-tickers", { instId: family })
+        ]);
+        const data = { current, history, premium, mark, index };
+        this.persist("funding_basis", query.instId, [data]);
+        return wrap(data);
+    }
+    async liquidations(query) {
+        const data = await this.client.publicGet("/api/v5/public/liquidation-orders", {
+            instType: "SWAP",
+            instFamily: query.instId.replace(/-SWAP$/, ""),
+            state: "filled",
+            limit: Math.min(query.limit ?? 100, 100)
+        });
+        this.persist("liquidations", query.instId, data);
+        return wrap(data);
+    }
+    async systemStress(query) {
+        const family = query.instId.replace(/-SWAP$/, "");
+        const [insuranceFund, priceLimit, positionTiers] = await Promise.all([
+            this.client.publicGet("/api/v5/public/insurance-fund", { instType: "SWAP", instFamily: family }),
+            this.client.publicGet("/api/v5/public/price-limit", { instId: query.instId }),
+            this.client.publicGet("/api/v5/public/position-tiers", { instType: "SWAP", tdMode: "cross", instFamily: family })
+        ]);
+        const data = { insuranceFund, priceLimit, positionTiers };
+        this.persist("system_stress", query.instId, [data]);
+        return wrap(data);
+    }
+    async positionChanges(query) {
+        const positioning = await this.positioning(query);
+        const rows = normalizeRows(positioning.data);
+        const data = rows.slice(1).map((row, index) => {
+            const previous = rows[index];
+            const currentOi = numeric(row[1] ?? row.oi);
+            const previousOi = numeric(previous[1] ?? previous.oi);
+            return { current: row, previous, absoluteChange: currentOi - previousOi, percentChange: previousOi ? (currentOi - previousOi) / previousOi : null };
+        });
+        return { data, meta: { ...positioning.meta, source: "derived" } };
+    }
+    async consensus(query) {
+        const [crowding, taker, positioning] = await Promise.all([this.crowding(query), this.takerFlow(query), this.positionChanges(query)]);
+        return {
+            data: { crowding: crowding.data, takerFlow: taker.data, positionChanges: positioning.data },
+            meta: resultMeta({ source: "derived" })
+        };
+    }
+    async decisionSnapshot(query) {
+        const [positioning, takerFlow, fundingBasis, liquidations, systemStress, crowding] = await Promise.all([
+            this.positioning(query), this.takerFlow(query), this.fundingBasis(query), this.liquidations(query), this.systemStress(query), this.crowding(query)
+        ]);
+        return {
+            data: { instId: query.instId, asOf: Date.now(), positioning: positioning.data, takerFlow: takerFlow.data, fundingBasis: fundingBasis.data, liquidations: liquidations.data, systemStress: systemStress.data, crowding: crowding.data },
+            meta: resultMeta({ source: "mixed" })
+        };
+    }
+    async rubik(path, query, extra = {}) {
+        let release;
+        const previous = this.rubikChain;
+        this.rubikChain = new Promise((resolve) => { release = resolve; });
+        await previous;
+        try {
+            const wait = this.nextRubikAt - Date.now();
+            if (wait > 0)
+                await new Promise((resolve) => setTimeout(resolve, wait));
+            return await this.client.publicGet(path, { ...common(query), ...extra });
+        }
+        finally {
+            this.nextRubikAt = Date.now() + 420;
+            release();
+        }
+    }
+    persist(kind, instId, values) {
+        for (const value of values) {
+            const text = JSON.stringify(value);
+            const id = crypto.createHash("sha256").update(`${kind}:${instId}:${text}`).digest("hex").slice(0, 24);
+            const timestamp = extractTimestamp(value) ?? Date.now();
+            this.database.upsertIntelligence(`derivatives:${kind}:${instId}`, id, timestamp, value);
+        }
+    }
+}
+function common(query) {
+    return { instId: query.instId, period: query.period ?? "5m", begin: query.begin, end: query.end, limit: Math.min(query.limit ?? 100, 100) };
+}
+function wrap(data) {
+    return { data, meta: resultMeta({ source: "rest" }) };
+}
+function normalizeRows(values) {
+    return values.filter(Array.isArray);
+}
+function numeric(value) {
+    const parsed = Number(value ?? 0);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function extractTimestamp(value) {
+    if (Array.isArray(value)) {
+        const parsed = Number(value[0]);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    if (value && typeof value === "object") {
+        const object = value;
+        const parsed = Number(object.ts ?? object.timestamp ?? object.fundingTime);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=service.js.map

package/dist/derivatives/service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./core/errors.js";
+export * from "./core/types.js";
+export * from "./runtime/client.js";
+export * from "./tools/catalog.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./core/errors.js";
+export * from "./core/types.js";
+export * from "./runtime/client.js";
+export * from "./tools/catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/intelligence/service.d.ts

@@ -0,0 +1,38 @@
+import type { AccountService } from "../account/service.js";
+import type { ToolResult } from "../core/types.js";
+import type { OkxClient } from "../core/okx-client.js";
+import type { DerivativesService } from "../derivatives/service.js";
+import type { MarketService } from "../market/service.js";
+import type { RuntimeDatabase } from "../storage/database.js";
+import type { RuntimeConfig } from "../config/schema.js";
+export declare class IntelligenceService {
+    private readonly config;
+    private readonly client;
+    private readonly accounts;
+    private readonly database;
+    private readonly market;
+    private readonly derivatives;
+    private readonly pollTimers;
+    private polling;
+    constructor(config: RuntimeConfig, client: OkxClient, accounts: AccountService, database: RuntimeDatabase, market: MarketService, derivatives: DerivativesService);
+    start(): void;
+    stop(): void;
+    newsList(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    newsDetail(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    newsSources(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    sentiment(args: Record<string, unknown>, trend?: boolean): Promise<ToolResult<unknown[]>>;
+    sentimentRanking(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    economicCalendar(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    listEvents(args: Record<string, unknown>): ToolResult<unknown[]>;
+    readEvent(args: Record<string, unknown>): ToolResult<unknown>;
+    marketReaction(args: Record<string, unknown>): Promise<ToolResult<Record<string, unknown>>>;
+    anomalies(args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    dailyBriefing(args: Record<string, unknown>): Promise<ToolResult<Record<string, unknown>>>;
+    smart(operation: SmartOperation, args: Record<string, unknown>): Promise<ToolResult<unknown[]>>;
+    private fetchExperimental;
+    private local;
+    private liveAccount;
+    private persist;
+    private schedulePoll;
+}
+export type SmartOperation = "list_traders" | "search_trader" | "read_performance" | "read_positions" | "read_position_history" | "read_order_history" | "read_signal_overview_by_filter" | "read_signal_overview_by_trader" | "read_signal_trend_by_filter" | "read_signal_trend_by_trader";

package/dist/intelligence/service.js

@@ -0,0 +1,324 @@
+import crypto from "node:crypto";
+import { resultMeta } from "../core/types.js";
+import { RuntimeError } from "../core/errors.js";
+const PATHS = {
+    news: "/api/v5/orbit/news-search",
+    newsDetail: "/api/v5/orbit/news-detail",
+    newsSources: "/api/v5/orbit/news-platform",
+    sentiment: "/api/v5/orbit/currency-sentiment-query",
+    sentimentRanking: "/api/v5/orbit/currency-sentiment-ranking",
+    calendar: "/api/v5/public/economic-calendar",
+    traders: "/api/v5/orbit/public/leaderboard",
+    traderSearch: "/api/v5/orbit/top-trader-search",
+    positions: "/api/v5/orbit/public/position-current",
+    positionHistory: "/api/v5/orbit/public/position-history",
+    orderHistory: "/api/v5/orbit/public/trade-records",
+    signalOverview: "/api/v5/journal/smartmoney/overview",
+    signalTrend: "/api/v5/journal/smartmoney/signal-history"
+};
+export class IntelligenceService {
+    config;
+    client;
+    accounts;
+    database;
+    market;
+    derivatives;
+    pollTimers = new Set();
+    polling = false;
+    constructor(config, client, accounts, database, market, derivatives) {
+        this.config = config;
+        this.client = client;
+        this.accounts = accounts;
+        this.database = database;
+        this.market = market;
+        this.derivatives = derivatives;
+    }
+    start() {
+        if (!this.config.defaultAccount || this.config.accounts[this.config.defaultAccount]?.environment !== "live")
+            return;
+        this.polling = true;
+        this.schedulePoll(this.config.intelligence.newsPollSeconds * 1_000, () => this.newsList({ account: this.config.defaultAccount, limit: 50 }));
+        this.schedulePoll(this.config.intelligence.sentimentPollMinutes * 60_000, () => this.sentimentRanking({ account: this.config.defaultAccount, limit: 50 }));
+        this.schedulePoll(this.config.intelligence.smartMoneyPollMinutes * 60_000, () => this.smart("list_traders", { account: this.config.defaultAccount, limit: 50 }));
+    }
+    stop() {
+        this.polling = false;
+        for (const timer of this.pollTimers)
+            clearTimeout(timer);
+        this.pollTimers.clear();
+    }
+    async newsList(args) {
+        return this.fetchExperimental("news", PATHS.news, args, {
+            sortBy: args.sortBy ?? (args.keyword ? "relevant" : "latest"),
+            keyword: args.keyword,
+            importance: args.importance,
+            platform: args.platform,
+            ccyList: csv(args.coins),
+            sentiment: args.sentiment,
+            begin: args.begin,
+            end: args.end,
+            detailLvl: args.detailLevel ?? "summary",
+            limit: clamp(args.limit, 1, 100, 30),
+            cursor: args.after
+        });
+    }
+    async newsDetail(args) {
+        if (!args.id)
+            throw new RuntimeError("VALIDATION", "id is required");
+        return this.fetchExperimental("news_detail", PATHS.newsDetail, args, { id: args.id });
+    }
+    async newsSources(args) {
+        return this.fetchExperimental("news_source", PATHS.newsSources, args, {});
+    }
+    async sentiment(args, trend = false) {
+        const coins = csv(args.coins ?? args.ccy);
+        if (!coins)
+            throw new RuntimeError("VALIDATION", "coins is required");
+        return this.fetchExperimental("sentiment", PATHS.sentiment, args, {
+            ccy: coins,
+            period: args.period ?? (trend ? "1h" : "24h"),
+            inclTrend: trend ? "true" : undefined,
+            limit: trend ? clamp(args.limit, 1, 500, 24) : undefined
+        });
+    }
+    async sentimentRanking(args) {
+        return this.fetchExperimental("sentiment_ranking", PATHS.sentimentRanking, args, {
+            period: args.period ?? "24h",
+            sortBy: args.sortBy ?? "hot",
+            limit: clamp(args.limit, 1, 50, 20)
+        });
+    }
+    async economicCalendar(args) {
+        return this.fetchExperimental("calendar", PATHS.calendar, args, {
+            region: args.region,
+            importance: args.importance,
+            before: args.begin,
+            after: args.end,
+            limit: clamp(args.limit, 1, 100, 50)
+        });
+    }
+    listEvents(args) {
+        const since = Number(args.since ?? Date.now() - 7 * 86_400_000);
+        const articles = this.database.queryIntelligence("news", 1_000, since);
+        const events = clusterNews(articles).slice(0, clamp(args.limit, 1, 200, 50));
+        return { data: events, meta: resultMeta({ source: "derived" }) };
+    }
+    readEvent(args) {
+        if (!args.id)
+            throw new RuntimeError("VALIDATION", "id is required");
+        const event = this.listEvents({ limit: 1_000 }).data.find((item) => item.id === args.id);
+        if (!event)
+            throw new RuntimeError("NOT_FOUND", `News event '${String(args.id)}' was not found`);
+        return { data: event, meta: resultMeta({ source: "derived" }) };
+    }
+    async marketReaction(args) {
+        const event = this.readEvent(args).data;
+        const coins = Array.isArray(event.coins) ? event.coins.map(String) : [];
+        const instId = String(args.instId ?? `${coins[0] ?? "BTC"}-USDT-SWAP`);
+        const candles = await this.market.getCandles(instId, String(args.bar ?? "5m"), clamp(args.limit, 20, 300, 100));
+        const rows = candles.data;
+        const first = Number(rows[0]?.[4]);
+        const last = Number(rows.at(-1)?.[4]);
+        return {
+            data: { event, instId, from: first, to: last, absoluteChange: last - first, percentChange: first ? (last - first) / first : null, candles: rows },
+            meta: { ...candles.meta, source: "derived" }
+        };
+    }
+    async anomalies(args) {
+        const instId = String(args.instId ?? "BTC-USDT-SWAP");
+        const changes = await this.derivatives.positionChanges({ instId, period: String(args.period ?? "5m"), limit: clamp(args.limit, 10, 100, 50) });
+        const threshold = Number(args.threshold ?? 0.03);
+        const data = changes.data.filter((item) => Math.abs(Number(item.percentChange ?? 0)) >= threshold);
+        return { data, meta: { ...changes.meta, source: "derived" } };
+    }
+    async dailyBriefing(args) {
+        const instId = String(args.instId ?? "BTC-USDT-SWAP");
+        const [news, ranking, derivatives] = await Promise.all([
+            this.newsList({ ...args, limit: clamp(args.newsLimit, 1, 100, 30) }),
+            this.sentimentRanking({ ...args, limit: 20 }),
+            this.derivatives.decisionSnapshot({ instId, period: String(args.period ?? "5m"), limit: 50 })
+        ]);
+        return { data: { asOf: Date.now(), instId, news: news.data, sentimentRanking: ranking.data, derivatives: derivatives.data }, meta: resultMeta({ source: "mixed" }) };
+    }
+    async smart(operation, args) {
+        const mapping = smartRequest(operation, args);
+        return this.fetchExperimental(`smart:${operation}`, mapping.path, args, mapping.query);
+    }
+    async fetchExperimental(kind, path, args, query) {
+        if (args.localOnly === true)
+            return this.local(kind, args);
+        const account = this.liveAccount(typeof args.account === "string" ? args.account : undefined);
+        try {
+            const data = await this.client.privateGet(path, account, query, {
+                "Accept-Language": typeof args.language === "string" ? args.language : "en-US"
+            });
+            this.persist(kind, data);
+            return {
+                data,
+                meta: resultMeta({ source: "rest", account: account.name, environment: account.environment })
+            };
+        }
+        catch (error) {
+            const local = this.database.queryIntelligence(kind, clamp(args.limit, 1, 1_000, 100), Number(args.since ?? 0));
+            if (local.length) {
+                return {
+                    data: local,
+                    meta: resultMeta({ source: "sqlite", account: account.name, environment: account.environment, warnings: ["Remote intelligence capability is unavailable; returned local history"] })
+                };
+            }
+            const message = error instanceof Error ? error.message : "Unknown upstream response";
+            throw new RuntimeError("CAPABILITY_UNAVAILABLE", `Experimental OKX intelligence capability is unavailable: ${message}`, true);
+        }
+    }
+    local(kind, args) {
+        return {
+            data: this.database.queryIntelligence(kind, clamp(args.limit, 1, 1_000, 100), Number(args.since ?? 0)),
+            meta: resultMeta({ source: "sqlite" })
+        };
+    }
+    liveAccount(name) {
+        const account = this.accounts.account(name);
+        if (account.environment !== "live") {
+            throw new RuntimeError("CAPABILITY_UNAVAILABLE", "News and Smart Money require a live read-only OKX account");
+        }
+        return account;
+    }
+    persist(kind, data) {
+        for (const item of flattenItems(data)) {
+            const timestamp = itemTimestamp(item) ?? Date.now();
+            const id = itemId(kind, item);
+            this.database.upsertIntelligence(kind, id, timestamp, item);
+        }
+    }
+    schedulePoll(intervalMs, operation) {
+        let timer;
+        const run = () => {
+            this.pollTimers.delete(timer);
+            void operation().catch(() => undefined).finally(() => {
+                if (!this.polling)
+                    return;
+                timer = setTimeout(run, intervalMs);
+                timer.unref();
+                this.pollTimers.add(timer);
+            });
+        };
+        timer = setTimeout(run, Math.min(5_000, intervalMs));
+        timer.unref();
+        this.pollTimers.add(timer);
+    }
+}
+function smartRequest(operation, args) {
+    const common = {
+        sortType: args.sortType ?? "pnl",
+        period: args.period ?? "7",
+        pnl: args.pnl,
+        winRatio: args.winRatio,
+        maxRetreat: args.maxRetreat,
+        asset: args.asset,
+        lmtNum: args.lmtNum
+    };
+    switch (operation) {
+        case "list_traders":
+            return { path: PATHS.traders, query: { ...common, period: args.period ?? "90", after: args.after, before: args.before, limit: clamp(args.limit, 1, 100, 20) } };
+        case "search_trader":
+            return { path: PATHS.traderSearch, query: { keyword: args.keyword } };
+        case "read_performance":
+            return { path: PATHS.traders, query: { authorIds: csv(args.authorIds ?? args.authorId), sortType: args.sortType ?? "pnl", period: args.period ?? "90" } };
+        case "read_positions":
+            return { path: PATHS.positions, query: { authorId: args.authorId, instCcy: args.instId } };
+        case "read_position_history":
+            return { path: PATHS.positionHistory, query: { authorId: args.authorId, instCcy: args.instId, after: args.after, before: args.before, limit: clamp(args.limit, 1, 100, 50) } };
+        case "read_order_history":
+            return { path: PATHS.orderHistory, query: { authorId: args.authorId, instCcy: args.instId, after: args.after, before: args.before, limit: clamp(args.limit, 1, 100, 50) } };
+        case "read_signal_overview_by_filter":
+        case "read_signal_overview_by_trader":
+            return { path: PATHS.signalOverview, query: { ...common, authorIds: csv(args.authorIds ?? args.authorId), instCcyList: csv(args.instCcyList), topInstruments: args.topInstruments ?? 20 } };
+        case "read_signal_trend_by_filter":
+        case "read_signal_trend_by_trader":
+            return { path: PATHS.signalTrend, query: { ...common, authorIds: csv(args.authorIds ?? args.authorId), instId: args.instId, dataVersion: args.dataVersion, granularity: args.granularity ?? "1h", limit: clamp(args.limit, 1, 500, 24) } };
+    }
+}
+function flattenItems(data) {
+    const result = [];
+    const visit = (value) => {
+        if (Array.isArray(value))
+            value.forEach(visit);
+        else if (value && typeof value === "object") {
+            const object = value;
+            const nested = object.items ?? object.list ?? object.newsList ?? object.result;
+            if (Array.isArray(nested))
+                nested.forEach(visit);
+            else
+                result.push(object);
+        }
+    };
+    data.forEach(visit);
+    return result;
+}
+function clusterNews(articles) {
+    const sorted = [...articles].sort((a, b) => (itemTimestamp(b) ?? 0) - (itemTimestamp(a) ?? 0));
+    const events = [];
+    for (const article of sorted) {
+        const title = String(article.title ?? article.headline ?? article.name ?? "Untitled");
+        const timestamp = itemTimestamp(article) ?? Date.now();
+        const coins = values(article.coins ?? article.ccyList ?? article.ccy);
+        const tokens = titleTokens(title);
+        const match = events.find((event) => Math.abs(event.lastPublishedAt - timestamp) <= 12 * 3_600_000 && overlaps(event.coins, coins) && jaccard(event.tokens, tokens) >= 0.45);
+        if (match) {
+            match.articles.push(article);
+            match.firstPublishedAt = Math.min(match.firstPublishedAt, timestamp);
+            match.lastPublishedAt = Math.max(match.lastPublishedAt, timestamp);
+            match.coins = [...new Set([...match.coins, ...coins])];
+        }
+        else {
+            events.push({ id: itemId("event", { title, timestamp, coins }), title, coins, firstPublishedAt: timestamp, lastPublishedAt: timestamp, articles: [article], tokens });
+        }
+    }
+    return events.map(({ tokens: _tokens, ...event }) => ({ ...event, articleCount: event.articles.length, sourceCount: new Set(event.articles.map((item) => String(item.platform ?? item.source ?? "unknown"))).size }));
+}
+function titleTokens(value) {
+    return new Set(value.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g, " ").split(/\s+/).filter((token) => token.length > 1));
+}
+function jaccard(a, b) {
+    if (!a.size || !b.size)
+        return 0;
+    const intersection = [...a].filter((value) => b.has(value)).length;
+    return intersection / (a.size + b.size - intersection);
+}
+function overlaps(a, b) {
+    return a.length === 0 || b.length === 0 || a.some((value) => b.includes(value));
+}
+function csv(value) {
+    if (Array.isArray(value))
+        return value.map(String).filter(Boolean).join(",") || undefined;
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    return String(value);
+}
+function values(value) {
+    if (Array.isArray(value))
+        return value.map(String);
+    if (typeof value === "string")
+        return value.split(",").map((item) => item.trim()).filter(Boolean);
+    return [];
+}
+function clamp(value, min, max, fallback) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.floor(parsed)));
+}
+function itemTimestamp(item) {
+    const parsed = Number(item.publishTime ?? item.publishedAt ?? item.eventTime ?? item.ts ?? item.timestamp ?? item.updateTime);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function itemId(kind, item) {
+    if (item && typeof item === "object") {
+        const object = item;
+        const existing = object.id ?? object.newsId ?? object.authorId ?? object.eventId;
+        if (existing)
+            return String(existing);
+    }
+    return crypto.createHash("sha256").update(`${kind}:${JSON.stringify(item)}`).digest("hex").slice(0, 24);
+}
+//# sourceMappingURL=service.js.map