@dshtrading/connector-yahoo 0.6.1 → 0.6.2

package/lib/dataplane.d.ts

@@ -1,6 +1,7 @@
+import { Config } from "./index.js";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/dataplane.d.ts
 declare const inject: string[];
 declare function apply(ctx: Context): void;
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/dataplane.js

@@ -1,4 +1,4 @@
-import { TRADING_US_MARKET_DATA_KEY, YahooMarketDataService } from "./index.js";
+import { Config, ROUTER_PROVIDER, TRADING_US_MARKET_DATA_KEY, YahooMarketDataService } from "./index.js";
 //#region src/dataplane.ts
 const inject = [];
 /** 解析注册表服务；老部署（base/router 未升级）返回 undefined → 调用方回退旧的直接 provide 路径。 */
@@ -6,8 +6,6 @@ function resolveMarketDataRegistry(ctx) {
 	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
 	return candidate !== void 0 ? candidate : void 0;
 }
-/** 本连接器的路由 provider slug（路由层词汇，docs/exchange-routing.md §2.2）。 */
-const ROUTER_PROVIDER = "yahoo";
 function apply(ctx) {
 	const registry = resolveMarketDataRegistry(ctx);
 	if (registry === void 0) {
@@ -19,4 +17,4 @@ function apply(ctx) {
 	ctx.effect(() => registry.register("us", ROUTER_PROVIDER, service));
 }
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-import { INTERVAL_VOCABULARY, TradingServiceError, YahooChartEnvelope, YahooChartResult, YahooRestClient, YahooRestOptions, isSupportedInterval, normalizeYahooSymbol, parseChartBars } from "./rest.js";
+import { INTERVAL_VOCABULARY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooChartEnvelope, YahooChartResult, YahooRestClient, YahooRestOptions, isSupportedInterval, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities } from "./rest.js";
 import { Context, Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
-import { Disposable, Interval, Kline, MarketDataService, Ticker } from "@dshtrading/api";
+import { Disposable, Interval, Kline, KlineCapability, MarketDataService, Ticker } from "@dshtrading/api";
 //#region src/index.d.ts
 /**
  * Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-us-*` 市场命名空间，
@@ -28,8 +28,19 @@ declare class YahooMarketDataService extends Service implements MarketDataServic
   constructor(ctx: Context, options?: YahooRestOptions, name?: string);
   getTicker(symbol: string): Promise<Ticker>;
   getKlines(symbol: string, interval: Interval, limit?: number): Promise<Kline[]>;
+  /**
+   * K 线能力声明（api 可选契约，2026-10-15 跨源 K 线路由）：周期集 = Yahoo chart 的受支持
+   * 子集；深度只有 1m 有实测值（2730 根 = range=7d 原窗口），其余周期声明承接闸门
+   * （口径与证据见 rest.ts 的 yahooKlineCapabilities）。
+   */
+  klineCapabilities(): readonly KlineCapability[];
   subscribeTicker(symbol: string, cb: (ticker: Ticker) => void, options?: SubscribeTickerOptions): Disposable;
 }
+/**
+ * 本连接器在路由层的 provider slug（路由层词汇 = 交易所 slug；
+ * docs/guides/exchange-routing.md §2.2）。
+ */
+declare const ROUTER_PROVIDER = "yahoo";
 /** us_place_order 参数契约（美股词汇，dryRun 缺省 true）。 */
 interface PlaceOrderArgs {
   /** 股票代码，如 `AAPL` 或 `brk-b`（执行前归一化为 Yahoo 大写形态）。 */
@@ -80,4 +91,4 @@ interface PlaceOrderToolDeps {
 declare function createPlaceOrderTool(deps: PlaceOrderToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, DryRunReference, INTERVAL_VOCABULARY, OrderGateVerdict, PlaceOrderArgs, PlaceOrderToolDeps, SubscribeTickerOptions, TRADING_US_MARKET_DATA_KEY, TradingServiceError, YahooChartEnvelope, YahooChartResult, YahooMarketDataService, YahooRestClient, YahooRestOptions, apply, buildDryRunReceipt, createPlaceOrderTool, evaluateOrderGate, inject, isSupportedInterval, name, normalizeYahooSymbol, parseChartBars };
+export { Config, DryRunReference, INTERVAL_VOCABULARY, OrderGateVerdict, PlaceOrderArgs, PlaceOrderToolDeps, ROUTER_PROVIDER, SubscribeTickerOptions, TRADING_US_MARKET_DATA_KEY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooChartEnvelope, YahooChartResult, YahooMarketDataService, YahooRestClient, YahooRestOptions, apply, buildDryRunReceipt, createPlaceOrderTool, evaluateOrderGate, inject, isSupportedInterval, name, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { INTERVAL_VOCABULARY, TradingServiceError, YahooRestClient, isSupportedInterval, normalizeYahooSymbol, parseChartBars } from "./rest.js";
+import { INTERVAL_VOCABULARY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooRestClient, isSupportedInterval, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities } from "./rest.js";
 import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -46,7 +46,15 @@ var YahooMarketDataService = class extends Service {
 		return this.client.getTicker(symbol);
 	}
 	getKlines(symbol, interval, limit) {
-		return this.client.getKlines(symbol, interval).then((all) => typeof limit === "number" && Number.isInteger(limit) && limit > 0 ? all.slice(-limit) : all);
+		return this.client.getKlines(symbol, interval, limit);
+	}
+	/**
+	* K 线能力声明（api 可选契约，2026-10-15 跨源 K 线路由）：周期集 = Yahoo chart 的受支持
+	* 子集；深度只有 1m 有实测值（2730 根 = range=7d 原窗口），其余周期声明承接闸门
+	* （口径与证据见 rest.ts 的 yahooKlineCapabilities）。
+	*/
+	klineCapabilities() {
+		return this.client.klineCapabilities();
 	}
 	subscribeTicker(symbol, cb, options) {
 		const ms = Math.max(options?.intervalMs ?? SUBSCRIBE_DEFAULT_MS, SUBSCRIBE_MIN_MS);
@@ -58,6 +66,11 @@ var YahooMarketDataService = class extends Service {
 		return { dispose: () => clearInterval(timer) };
 	}
 };
+/**
+* 本连接器在路由层的 provider slug（路由层词汇 = 交易所 slug；
+* docs/guides/exchange-routing.md §2.2）。
+*/
+const ROUTER_PROVIDER = "yahoo";
 function evaluateOrderGate(config, args) {
 	const requestedDryRun = args.dryRun ?? true;
 	if (!requestedDryRun && !liveTradingEnabled(config.liveTrading)) return {
@@ -250,4 +263,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { Config, INTERVAL_VOCABULARY, TRADING_US_MARKET_DATA_KEY, TradingServiceError, YahooMarketDataService, YahooRestClient, apply, buildDryRunReceipt, createPlaceOrderTool, evaluateOrderGate, inject, isSupportedInterval, name, normalizeYahooSymbol, parseChartBars };
+export { Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_US_MARKET_DATA_KEY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooMarketDataService, YahooRestClient, apply, buildDryRunReceipt, createPlaceOrderTool, evaluateOrderGate, inject, isSupportedInterval, name, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities };

package/lib/rest.d.ts

@@ -1,4 +1,4 @@
-import { Interval, Kline, Ticker, TradingErrorCode } from "@dshtrading/api";
+import { Interval, Kline, KlineCapability, Ticker, TradingErrorCode } from "@dshtrading/api";
 //#region src/rest.d.ts
 /** api 包 TradingError 契约的运行时 Error 实现。 */
 declare class TradingServiceError extends Error {
@@ -10,6 +10,24 @@ declare function normalizeYahooSymbol(symbol: string): string;
 /** 工具 parameters enum 用：受支持 interval 词汇（与 connector-stooq 同一子集口径）。 */
 declare const INTERVAL_VOCABULARY: readonly string[];
 declare function isSupportedInterval(value: Interval): boolean;
+/**
+ * 能承接的请求深度上限 = 桥的 K 线参数闸门（packages/bot-api MAX_KLINE_LIMIT = 2500）：
+ * 上游没有 limit 语义（窗口由 range= 决定，本客户端只在返回后按 limit 截尾），故闸门内的
+ * 任何 limit 都被诚实承接、返回根数以该周期的取数窗口（RANGE_BY_INTERVAL）为界。
+ */
+declare const YAHOO_KLINE_MAX_BARS = 2500;
+/**
+ * 1m 的实测窗口深度 = 2730 根（chart/AAPL|MSFT?interval=1m&range=7d → 2730 根非空 bar，
+ * 覆盖 7 个会话，2026-10-05..10-13；窗口超出即上游 422「Only 8 days worth of 1m
+ * granularity data are allowed」）——见 spikes/impl-five-day-1m-probe/EVIDENCE.md §5。
+ */
+declare const YAHOO_ONE_MINUTE_MAX_BARS = 2730;
+/**
+ * K 线能力声明（api 可选契约 klineCapabilities）：周期集 = INTERVAL_TO_YAHOO 的键。
+ * 深度只有 1m 有实测值（窗口型端点，上表 2730 根的原始证据），其余周期声明承接闸门
+ * ——它们的窗口根数随市场与交易日数浮动，本客户端代码里没有可报的实测数字，不据印象编。
+ */
+declare function yahooKlineCapabilities(): KlineCapability[];
 /** v8 chart 响应的最小类型面（只取本客户端消费的字段）。 */
 interface YahooChartResult {
   meta: {
@@ -60,8 +78,16 @@ interface YahooRestOptions {
 declare class YahooRestClient {
   #private;
   constructor(options?: YahooRestOptions);
-  /** 拉取并解析 K 线（旧→新全窗口，由服务层按 limit 截尾）。 */
-  getKlines(symbol: string, interval: Interval): Promise<Kline[]>;
+  /** K 线能力声明（api 可选契约）：周期集与深度口径见 yahooKlineCapabilities。 */
+  klineCapabilities(): readonly KlineCapability[];
+  /**
+   * 拉取并解析 K 线（旧→新全窗口）；limit 给出时取尾部最近 limit 根。
+   *
+   * 窗口由上游 range 决定、上游没有 limit 语义（1m 的 range=7d ≈ 7 个会话 2730 根，
+   * 1m 单请求上限 8 天，见 spikes/impl-five-day-1m-probe/ §5），因此「只要最近 N 根」
+   * 只能在这一层截尾：消费方拿到几根就是几根。
+   */
+  getKlines(symbol: string, interval: Interval, limit?: number): Promise<Kline[]>;
   /**
    * 最新行情快照：单请求 interval=1d&range=1d。
    * price/time/volume/prevClose 全取 meta（权威实时面）：昨收锚点取 meta.chartPreviousClose
@@ -74,4 +100,4 @@ declare class YahooRestClient {
   getTicker(symbol: string): Promise<Ticker>;
 }
 //#endregion
-export { INTERVAL_VOCABULARY, TradingServiceError, YahooChartEnvelope, YahooChartResult, YahooRestClient, YahooRestOptions, isSupportedInterval, normalizeYahooSymbol, parseChartBars };
+export { INTERVAL_VOCABULARY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooChartEnvelope, YahooChartResult, YahooRestClient, YahooRestOptions, isSupportedInterval, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities };

package/lib/rest.js

@@ -34,6 +34,29 @@ const INTERVAL_VOCABULARY = [...INTERVAL_TO_YAHOO.keys()];
 function isSupportedInterval(value) {
 	return INTERVAL_TO_YAHOO.has(value);
 }
+/**
+* 能承接的请求深度上限 = 桥的 K 线参数闸门（packages/bot-api MAX_KLINE_LIMIT = 2500）：
+* 上游没有 limit 语义（窗口由 range= 决定，本客户端只在返回后按 limit 截尾），故闸门内的
+* 任何 limit 都被诚实承接、返回根数以该周期的取数窗口（RANGE_BY_INTERVAL）为界。
+*/
+const YAHOO_KLINE_MAX_BARS = 2500;
+/**
+* 1m 的实测窗口深度 = 2730 根（chart/AAPL|MSFT?interval=1m&range=7d → 2730 根非空 bar，
+* 覆盖 7 个会话，2026-10-05..10-13；窗口超出即上游 422「Only 8 days worth of 1m
+* granularity data are allowed」）——见 spikes/impl-five-day-1m-probe/EVIDENCE.md §5。
+*/
+const YAHOO_ONE_MINUTE_MAX_BARS = 2730;
+/**
+* K 线能力声明（api 可选契约 klineCapabilities）：周期集 = INTERVAL_TO_YAHOO 的键。
+* 深度只有 1m 有实测值（窗口型端点，上表 2730 根的原始证据），其余周期声明承接闸门
+* ——它们的窗口根数随市场与交易日数浮动，本客户端代码里没有可报的实测数字，不据印象编。
+*/
+function yahooKlineCapabilities() {
+	return [...INTERVAL_TO_YAHOO].map(([interval]) => ({
+		interval,
+		maxBars: interval === "1m" ? YAHOO_ONE_MINUTE_MAX_BARS : YAHOO_KLINE_MAX_BARS
+	}));
+}
 /** 每个 interval 的默认取数窗口（1m 上限 7 天；日线给足近三年——服务层再按 limit 截尾）。 */
 const RANGE_BY_INTERVAL = /* @__PURE__ */ new Map([
 	["1m", "7d"],
@@ -131,12 +154,22 @@ var YahooRestClient = class {
 		if (!result || !Array.isArray(result.timestamp) || result.timestamp.length === 0) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `Yahoo chart ${sym}: no data rows (unknown/delisted symbol?)`);
 		return result;
 	}
-	/** 拉取并解析 K 线（旧→新全窗口，由服务层按 limit 截尾）。 */
-	async getKlines(symbol, interval) {
+	/** K 线能力声明（api 可选契约）：周期集与深度口径见 yahooKlineCapabilities。 */
+	klineCapabilities() {
+		return yahooKlineCapabilities();
+	}
+	/**
+	* 拉取并解析 K 线（旧→新全窗口）；limit 给出时取尾部最近 limit 根。
+	*
+	* 窗口由上游 range 决定、上游没有 limit 语义（1m 的 range=7d ≈ 7 个会话 2730 根，
+	* 1m 单请求上限 8 天，见 spikes/impl-five-day-1m-probe/ §5），因此「只要最近 N 根」
+	* 只能在这一层截尾：消费方拿到几根就是几根。
+	*/
+	async getKlines(symbol, interval, limit) {
 		const sym = normalizeYahooSymbol(symbol);
 		const bars = parseChartBars(await this.#requestChart(sym, interval), interval);
 		if (bars.length === 0) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Yahoo klines for ${sym}: no non-null bars in range`);
-		return bars;
+		return typeof limit === "number" && Number.isInteger(limit) && limit > 0 ? bars.slice(-limit) : bars;
 	}
 	/**
 	* 最新行情快照：单请求 interval=1d&range=1d。
@@ -172,4 +205,4 @@ var YahooRestClient = class {
 	}
 };
 //#endregion
-export { INTERVAL_VOCABULARY, TradingServiceError, YahooRestClient, isSupportedInterval, normalizeYahooSymbol, parseChartBars };
+export { INTERVAL_VOCABULARY, TradingServiceError, YAHOO_KLINE_MAX_BARS, YAHOO_ONE_MINUTE_MAX_BARS, YahooRestClient, isSupportedInterval, normalizeYahooSymbol, parseChartBars, yahooKlineCapabilities };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-yahoo",
   "description": "US market connector plugin for dsh-trading: public market data from the Yahoo Finance v8 chart API implementing the @dshtrading/api contracts (unofficial API, no key; personal use per Yahoo terms of use)",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,12 +21,12 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/authority": "^0.6.1",
-    "@dshtrading/api": "^0.6.1"
+    "@dshtrading/authority": "^0.6.2",
+    "@dshtrading/api": "^0.6.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2",
     "@deepseek-ai/schemastery": ">=3.18.0"
   },
   "devDependencies": {