@dshtrading/connector-okx 0.1.5 → 0.2.0

package/lib/index.d.ts

@@ -108,6 +108,15 @@ declare class OkxTradeService extends Service implements TradeService {
   private readonly instruments;
   constructor(ctx: Context, options: OkxTradeServiceOptions, serviceName?: string);
   private get simulated();
+  /**
+   * 运行环境自述（issue #86 / G1）：host 平面只读账户工具（base/market-tools）
+   * 鸭式读取本方法，把 demo/live 安全信号带进工具输出。api TradeService 契约
+   * 不声明它——可选扩展，缺席即省略该字段。
+   */
+  environment(): {
+    env: string;
+    simulated: boolean;
+  };
   private auth;
   /** 规格（带 TTL 缓存；demo/live 分桶）。查不到 → TRADING_UNSUPPORTED_SYMBOL。 */
   private getInstrument;

package/lib/index.js

@@ -206,6 +206,17 @@ var OkxTradeService = class extends Service {
 	get simulated() {
 		return this.config.env === "demo";
 	}
+	/**
+	* 运行环境自述（issue #86 / G1）：host 平面只读账户工具（base/market-tools）
+	* 鸭式读取本方法，把 demo/live 安全信号带进工具输出。api TradeService 契约
+	* 不声明它——可选扩展，缺席即省略该字段。
+	*/
+	environment() {
+		return {
+			env: String(this.config.env),
+			simulated: this.simulated
+		};
+	}
 	auth(credentials) {
 		return {
 			credentials,
@@ -642,12 +653,17 @@ function createPlaceOrderTool(deps) {
 /**
 * 互斥激活的注册面：dsh-tools 对同名重复注册直接抛错（会炸 boot/preset 挂载），
 * 而互斥纪律下「同时至多一个连接器激活」只是配置约定。这里把冲突降级为
-* 「先到先得 + log」：已被占用（binance 或 kit-crypto 先注册）的名字跳过。
+* 「先到先得 + log」：已被占用的名字跳过。
+*
+* 占用方有两类（2026-09-08 审查 P2-3 修正文案，此前一律说成「另一 provider 互斥」）：
+* 1. host 平面能力包工具（如 @dshtrading/base/market-tools 的 <market>_get_positions
+*    等只读账户工具，boot 时先注册）——这类跳过是**预期**的，连接器版本不再生效；
+* 2. 同市场另一连接器/kit 先注册（真正的互斥冲突，需要用户检查配置）。
 */
 function registerTool(ctx, tool, log) {
 	const tools = ctx.tools;
 	if (tools.get(tool.name) !== void 0) {
-		log.warn("[dsh-trading-crypto-connector-okx] tool %s already registered by another provider — skipped (mutual exclusion: at most one crypto connector/toolset may be active)", tool.name);
+		log.warn("[dsh-trading-crypto-connector-okx] tool %s already registered — skipped. If this name belongs to the host-plane @dshtrading/base/market-tools read-only family (crypto_get_positions/_get_balance/_get_order) this is expected and the host version serves the tool; otherwise another crypto connector/toolset registered it first (mutual exclusion) — check dshtrading.markets.crypto.provider.", tool.name);
 		return;
 	}
 	tools.register(tool);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-okx",
   "description": "OKX market connector plugin for dsh-trading: public market data + signed demo/live trading (R1-R3), mutual-exclusion activation with connector-binance",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,8 +21,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.1.5",
-    "@dshtrading/indicators": "^0.1.5"
+    "@dshtrading/api": "^0.2.0",
+    "@dshtrading/indicators": "^0.2.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
@@ -32,7 +32,7 @@
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
-    "@dshtrading/connector-binance": "^0.1.5"
+    "@dshtrading/connector-binance": "^0.2.0"
   },
   "scripts": {
     "build": "tsdown",