@dshtrading/connector-stooq 0.5.0 → 0.6.1

package/lib/index.d.ts

@@ -11,7 +11,7 @@ declare const name = "dsh-trading-us-connector-stooq";
 interface Config {
   /** 交易安全闸门（铁律 #3）：true 时下单类工具强制 dry-run。 */
   dryRun: boolean;
-  /** 实盘总闸门：默认 false；false 时无论 dryRun 与否都拒绝实盘下单 [S4]。 */
+  /** 实盘镜像：默认 false。它是非权威镜像——只能收紧、永不能授予；实盘授权由 @dshtrading/authority 的人工签署平面裁定 [S4]。 */
   liveTrading: boolean;
 }
 declare const Config: Schema<Config>;
@@ -68,7 +68,7 @@ declare function buildDryRunReceipt(args: PlaceOrderArgs, marketData: Pick<Marke
 interface PlaceOrderToolDeps {
   /** 行情服务（dry-run 回执的市价参照），按接口取用，不直连 HTTP。 */
   readonly marketData: Pick<MarketDataService, 'getTicker'>;
-  /** 插件配置（dryRun 强制模拟 / liveTrading 总闸门）。 */
+  /** 插件配置（dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
   readonly config: Config;
 }
 /**

package/lib/index.js

@@ -1,9 +1,27 @@
 import { INTERVAL_VOCABULARY, StooqRestClient, TradingServiceError, easternWallTimeToEpochMs, isSupportedInterval, normalizeStooqSymbol } from "./rest.js";
+import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
 /**
+* Stooq 连接器插件（dsh-trading us 切片）：真实 MarketDataService。
+*
+* 能力三角色（与 connector-binance 同构）：
+* - 声明：ctx 键 `tradingUsMarketData` 由 @dshtrading/api 的模块增强统一声明；
+* - provide：StooqMarketDataService（Service 基类，随插件 fiber 自动注销）；
+* - inject：工具经 ctx.inject 等待服务就绪后注册，一律经服务执行，不直连 HTTP。
+*
+* 下单三段闸门语义照抄 crypto 切片（README 铁律 #3 / S4 修订）：工具名 `us_place_order`
+* 落在 base 闸门模式 `/^(?:crypto|us|cn|hk)_(?:place|cancel)_order$/`；审批不在工具内做。
+* Stooq 本身无交易 API——live 路径恒为 TRADING_NOT_IMPLEMENTED（券商 API 是后续任务）。
+*
+* 合规（README 铁律 #5）：Stooq 免费公开 CSV 端点、无 key、本仓不缓存不再分发；
+* 个人/非商业使用边界以 stooq.com 条款为准（详见 src/rest.ts 头注与 README 数据源节）。
+*
+* @module @dshtrading/connector-stooq
+*/
+/**
 * Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-us-*` 市场命名空间，
 * 全仓唯一（insert-only 铁律 #1）。
 */
@@ -42,10 +60,10 @@ var StooqMarketDataService = class extends Service {
 };
 function evaluateOrderGate(config, args) {
 	const requestedDryRun = args.dryRun ?? true;
-	if (!requestedDryRun && !config.liveTrading) return {
+	if (!requestedDryRun && !liveTradingEnabled(config.liveTrading)) return {
 		action: "reject",
 		code: "TRADING_LIVE_TRADING_DISABLED",
-		message: `us_place_order rejected: the call requests real execution (dryRun=${String(args.dryRun)}) but live trading is disabled (liveTrading=false). Ask the user to enable liveTrading explicitly after confirmation, or keep dryRun=true for a simulated fill.`
+		message: `us_place_order rejected: the call requests real execution (dryRun=${String(args.dryRun)}) but live trading is disabled (no signed live-trading grant from the authority plane). Ask the operator to sign a live-trading grant (packages/authority/bin/sign-live-trading.mjs) after confirmation, or keep dryRun=true for a simulated fill.`
 	};
 	if (requestedDryRun || config.dryRun) return { action: "simulate" };
 	return { action: "live" };
@@ -111,7 +129,7 @@ async function buildDryRunReceipt(args, marketData) {
 function createPlaceOrderTool(deps) {
 	return defineTool({
 		name: "us_place_order",
-		description: "Place a US stock order, or simulate one. dryRun defaults to true and returns a DRY-RUN simulated fill receipt referencing the latest Stooq daily close. Real execution (dryRun=false) requires the plugin liveTrading switch plus user approval, and is not implemented yet in this slice (Stooq has no trading API).",
+		description: "Place a US stock order, or simulate one. dryRun defaults to true and returns a DRY-RUN simulated fill receipt referencing the latest Stooq daily close. Real execution (dryRun=false) requires a signed live-trading grant (see @dshtrading/authority) plus user approval, and is not implemented yet in this slice (Stooq has no trading API).",
 		parameters: {
 			symbol: {
 				type: "string",
@@ -141,7 +159,7 @@ function createPlaceOrderTool(deps) {
 			},
 			dryRun: {
 				type: "boolean",
-				description: "true (default) = simulate only and return a DRY-RUN receipt; false = request real execution (gated by liveTrading and user approval)",
+				description: "true (default) = simulate only and return a DRY-RUN receipt; false = request real execution (gated by the signed live-trading authority and user approval)",
 				default: true
 			}
 		},
@@ -172,7 +190,7 @@ function apply(ctx, config) {
 		const marketData = ctx.tradingUsMarketData;
 		ctx.tools.register(defineTool({
 			name: "us_get_ticker",
-			description: "Get the latest market snapshot for a US stock via the Stooq public CSV endpoint. NOTE: the original Stooq quote endpoint is gone, so this returns the latest DAILY close (price, volume, close time) — it does not reflect intraday or pre/post-market moves. No credentials required; personal/non-commercial use per stooq.com terms.",
+			description: "Get the latest market snapshot for a US stock via Stooq. The original Stooq quote endpoint is gone, so this returns the latest DAILY close (price, volume, close time) and does not reflect intraday or pre/post-market moves. No credentials required; personal/non-commercial use per stooq.com terms.",
 			parameters: { symbol: {
 				type: "string",
 				required: true,
@@ -192,7 +210,7 @@ function apply(ctx, config) {
 		}));
 		ctx.tools.register(defineTool({
 			name: "us_get_klines",
-			description: "Get recent OHLCV candles for a US stock via the Stooq public CSV endpoint. Supported intervals: 1/5/15/30 minute (intraday availability depends on Stooq policy), 1h, 1d, 1w, 1M. No credentials required; personal/non-commercial use per stooq.com terms.",
+			description: "Get recent OHLCV candles for a US stock via Stooq. Supported intervals: 1/5/15/30 minute (intraday availability depends on Stooq policy), 1h, 1d, 1w, 1M. No credentials required; personal/non-commercial use per stooq.com terms.",
 			parameters: {
 				symbol: {
 					type: "string",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-stooq",
   "description": "US market connector plugin for dsh-trading: public market data from Stooq CSV endpoints implementing the @dshtrading/api contracts (no key; personal/non-commercial use per stooq.com terms)",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -17,7 +17,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.5.0"
+    "@dshtrading/api": "^0.6.1",
+    "@dshtrading/authority": "^0.6.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",