@dshtrading/kit-crypto 0.1.6 → 0.2.1

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+import { MarketDataService } from "./api/lib/index.js";
 import { CryptoFundamentalsOptions, CryptoFundamentalsResult, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals } from "./fundamentals.js";
 import { DerivativesFetchOptions, DerivativesResult, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
 import { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, deriveSymbolTokens, parseCryptoPanic, parseRss2 } from "./news.js";
@@ -21,6 +22,20 @@ declare function apply(ctx: Context, config: Config): void;
 declare function createGetDerivativesTool(options?: {
   fetch?: typeof globalThis.fetch;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** 行情注册表最小形状（与 @dshtrading/router 的 MarketDataRegistryLike 同构）。 */
+interface CryptoMarketDataRegistry {
+  active(market: string): {
+    provider: string;
+    service: MarketDataService;
+  } | undefined;
+}
+/**
+ * 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所：
+ * 与 crypto_get_derivatives 的硬编码 Binance 数据源不一致（审计既存项）有意不复刻。
+ */
+declare function createGetDerivativesHistoryTool(options: {
+  getRegistry: () => CryptoMarketDataRegistry | undefined;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
 declare function createGetFundamentalsTool(options?: {
   fetch?: typeof globalThis.fetch;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
@@ -28,4 +43,4 @@ declare function createGetNewsTool(toolOptions?: {
   cryptoPanicKey?: string;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
 //#endregion
-export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };
+export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };

package/lib/index.js

@@ -14,7 +14,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 *   1. skill provider：crypto-risk-checklist、crypto-instrument-analysis、indicator-authoring、trading-strategy-paradigms、knowledge-curation 与 trading-notes-setup 随包分发；
 *   2. crypto_funding_rate（Binance 公共资金费率）；
 *   3. crypto_get_news（动态聚合新闻）；
-*   4. crypto_get_derivatives 与 crypto_get_fundamentals 工具；
+*   4. crypto_get_derivatives、crypto_get_derivatives_history 与 crypto_get_fundamentals 工具；
 *   5. indicator_author 创作工具（Issue #19）；
 *   6. knowledge_ingest 与 knowledge_search 知识库工具（Issue #24）。
 *
@@ -222,6 +222,7 @@ function apply(ctx, config) {
 	registerOnce(createGetNewsTool({ cryptoPanicKey: router?.newsKey?.() }));
 	registerOnce(createGetDerivativesTool());
 	registerOnce(createGetFundamentalsTool());
+	registerOnce(createGetDerivativesHistoryTool({ getRegistry: () => resolveCryptoMarketDataRegistry(ctx) }));
 	const lifecycle = ctx;
 	lifecycle.inject?.(["tradingNewsRegistry"], (scope) => {
 		const registry = scope.tradingNewsRegistry;
@@ -256,6 +257,79 @@ function createGetDerivativesTool(options = {}) {
 		}
 	});
 }
+const DERIVATIVES_HISTORY_MIN_LIMIT = 1;
+const DERIVATIVES_HISTORY_MAX_LIMIT = 200;
+/** registry-first 解析（惰性：每次调用重新读取，路由切换即刻生效；老部署无此服务则 undefined）。 */
+function resolveCryptoMarketDataRegistry(ctx) {
+	return ctx.get?.("tradingMarketDataRegistry", false);
+}
+function parseDerivativesHistoryLimit(raw) {
+	if (raw === void 0 || raw === null) return void 0;
+	if (typeof raw !== "number" || !Number.isFinite(raw)) throw new Error(`crypto_get_derivatives_history: invalid limit ${JSON.stringify(raw)} — limit must be a number in ${DERIVATIVES_HISTORY_MIN_LIMIT}..${DERIVATIVES_HISTORY_MAX_LIMIT}`);
+	const limit = Math.trunc(raw);
+	if (limit < DERIVATIVES_HISTORY_MIN_LIMIT || limit > DERIVATIVES_HISTORY_MAX_LIMIT) throw new Error(`crypto_get_derivatives_history: invalid limit ${raw} — limit must be in ${DERIVATIVES_HISTORY_MIN_LIMIT}..${DERIVATIVES_HISTORY_MAX_LIMIT}`);
+	return limit;
+}
+/**
+* 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所：
+* 与 crypto_get_derivatives 的硬编码 Binance 数据源不一致（审计既存项）有意不复刻。
+*/
+function createGetDerivativesHistoryTool(options) {
+	return defineTool({
+		name: "crypto_get_derivatives_history",
+		description: `Read-only. Get the derivatives history series for a crypto perpetual contract — funding-rate history and open-interest history, both time-ascending (oldest first) — from the currently routed crypto market data provider (registry-first; never a hardcoded exchange). The returned symbol is the provider-canonical form. Optional limit keeps only the most recent N points per series (${DERIVATIVES_HISTORY_MIN_LIMIT}-${DERIVATIVES_HISTORY_MAX_LIMIT}) and reports truncatedTo. If the routed provider does not implement getDerivativesHistory the call fails with TRADING_NOT_IMPLEMENTED — an empty series is never substituted for "no data"; if no crypto provider is routed it fails with TRADING_NO_PROVIDER.`,
+		parameters: {
+			symbol: {
+				type: "string",
+				required: true,
+				description: "Perpetual contract symbol, market-canonical vocabulary, e.g. BTCUSDT or BTCUSDT-SWAP"
+			},
+			limit: {
+				type: "number",
+				description: `Keep only the most recent N points per series (${DERIVATIVES_HISTORY_MIN_LIMIT}-${DERIVATIVES_HISTORY_MAX_LIMIT}). Omit to return the provider's full series.`
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const symbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
+			if (!symbol) throw new Error("crypto_get_derivatives_history: symbol parameter is required (e.g. BTCUSDT or BTCUSDT-SWAP)");
+			const limit = parseDerivativesHistoryLimit(args.limit);
+			const entry = options.getRegistry()?.active("crypto");
+			if (entry === void 0) throw new Error("crypto_get_derivatives_history: TRADING_NO_PROVIDER — no crypto market data provider is active (market data registry absent, or no crypto provider installed/routed)");
+			const getHistory = entry.service.getDerivativesHistory;
+			if (typeof getHistory !== "function") throw new Error(`crypto_get_derivatives_history: TRADING_NOT_IMPLEMENTED — provider ${entry.provider} does not implement getDerivativesHistory (this is not "no data")`);
+			const returned = await getHistory.call(entry.service, symbol);
+			if (returned === null || typeof returned !== "object") throw new Error(`crypto_get_derivatives_history: provider ${entry.provider} returned an invalid derivatives history payload`);
+			const history = returned;
+			const longest = Math.max(history.fundingRates?.length ?? 0, history.openInterest?.length ?? 0);
+			const truncated = limit !== void 0 && longest > limit;
+			const result = {
+				ok: true,
+				market: "crypto",
+				provider: entry.provider,
+				symbol: typeof history.symbol === "string" && history.symbol !== "" ? history.symbol : symbol,
+				history,
+				truncated
+			};
+			if (truncated && limit !== void 0) {
+				result.truncatedTo = limit;
+				result.history = {
+					...history,
+					...history.fundingRates === void 0 ? {} : { fundingRates: history.fundingRates.slice(-limit) },
+					...history.openInterest === void 0 ? {} : { openInterest: history.openInterest.slice(-limit) }
+				};
+			}
+			return JSON.stringify(result);
+		}
+	});
+}
 function createGetFundamentalsTool(options = {}) {
 	return defineTool({
 		name: "crypto_get_fundamentals",
@@ -336,4 +410,4 @@ function createGetNewsTool(toolOptions = {}) {
 	});
 }
 //#endregion
-export { Config, aggregateNews, apply, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };
+export { Config, aggregateNews, apply, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/kit-crypto",
   "description": "Crypto toolkit plugin for dsh-trading: market-specific tools and bundled trading skills (skill provider); runs as a crypto-trader preset row (session-scoped)",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,19 +18,19 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/indicators": "0.1.6",
-    "@dshtrading/knowledge": "0.1.6"
+    "@dshtrading/knowledge": "0.2.1",
+    "@dshtrading/indicators": "0.2.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-skill": ">=0.1.2-rc.1",
-    "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1",
     "@deepseek-ai/schemastery": ">=3.18.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
-    "@dshtrading/api": "0.1.6"
+    "@dshtrading/api": "0.2.1"
   },
   "scripts": {
     "build": "tsdown",