echopai 2.2.0 → 2.3.0

package/dist/verbs/index.js

@@ -5,48 +5,79 @@
  *   - ALL_VERB_SPECS: 共用声明，MCP serve 枚举出 tools/list
  *   - build*Command(): commander 端入口工厂
  */
+export { announcementsFeedSpec, announcementsStockSpec, announcementsDetailSpec, buildAnnouncementsCommand, } from "./announcements.js";
 export { barsBatchSpec, buildBarsBatchCommand } from "./bars_batch.js";
 export { chartSpec, buildChartCommand } from "./chart.js";
+export { conceptsListSpec, conceptsSnapshotSpec, conceptsShowSpec, conceptsAlertsSpec, conceptsAlertsHistorySpec, conceptsDailyBarsSpec, conceptsMinuteBarsSpec, conceptsNewsSpec, conceptsViewsSpec, buildConceptsCommand, } from "./concepts.js";
 export { digestSpec, buildDigestCommand } from "./digest.js";
 export { financialsQuoteSnapshotSpec, financialsPitSpec, financialsReportsSpec, financialsSeriesSpec, buildFinancialsCommand, } from "./financials.js";
 export { hotSpec, buildHotCommand } from "./hot.js";
+export { limitUpPoolSpec, limitUpSummarySpec, limitUpHistorySpec, buildLimitUpCommand, } from "./limit_up.js";
 export { lookupSpec, buildLookupCommand } from "./lookup.js";
+export { marketStatusSpec, marketMoversSpec, buildMarketCommand } from "./market.js";
 export { newsSpec, buildNewsCommand } from "./news.js";
 export { quoteSpec, buildQuoteCommand } from "./quote.js";
 export { scanSpec, buildScanCommand } from "./scan.js";
 export { searchSpec, buildSearchCommand } from "./search.js";
-export { sentimentSpec, buildSentimentCommand } from "./sentiment.js";
+export { sentimentSpec, sentimentOverviewSpec, sentimentBreadthSpec, sentimentTurnoverSpec, sentimentPctDistributionSpec, buildSentimentCommand, } from "./sentiment.js";
 export { viewsSpec, buildViewsCommand } from "./views.js";
+import { announcementsFeedSpec, announcementsStockSpec, announcementsDetailSpec, } from "./announcements.js";
 import { barsBatchSpec } from "./bars_batch.js";
 import { chartSpec } from "./chart.js";
+import { conceptsListSpec, conceptsSnapshotSpec, conceptsShowSpec, conceptsAlertsSpec, conceptsAlertsHistorySpec, conceptsDailyBarsSpec, conceptsMinuteBarsSpec, conceptsNewsSpec, conceptsViewsSpec, } from "./concepts.js";
 import { digestSpec } from "./digest.js";
 import { financialsQuoteSnapshotSpec, financialsPitSpec, financialsReportsSpec, financialsSeriesSpec, } from "./financials.js";
 import { hotSpec } from "./hot.js";
+import { limitUpPoolSpec, limitUpSummarySpec, limitUpHistorySpec, } from "./limit_up.js";
 import { lookupSpec } from "./lookup.js";
+import { marketStatusSpec, marketMoversSpec } from "./market.js";
 import { newsSpec } from "./news.js";
 import { quoteSpec } from "./quote.js";
 import { scanSpec } from "./scan.js";
 import { searchSpec } from "./search.js";
-import { sentimentSpec } from "./sentiment.js";
+import { sentimentSpec, sentimentOverviewSpec, sentimentBreadthSpec, sentimentTurnoverSpec, sentimentPctDistributionSpec, } from "./sentiment.js";
 import { viewsSpec } from "./views.js";
 /**
  * Ordering follows product priority (feedback_views_over_news.md):
  * lookup (universal first step) → digest (one-shot fan-out, agent's opening
  * move once it has a canonical_code) → search (hybrid semantic discovery
- * for themes / concepts) → quote → views (PRIMARY research) → news
- * (supplementary) → sentiment → hot → chart → bars_batch → scan →
- * financials (valuation snapshot is the headline; pit / reports / series
- * cover deeper fundamentals access).
+ * for themes / concepts) → quote → market_status (cheap session gate) →
+ * views (PRIMARY research) → news (supplementary) → announcements (cninfo
+ * disclosures) → sentiment → hot → concepts (theme universe + alerts) →
+ * limit-up (短线情绪/连板梯队) → chart → bars_batch → scan → financials
+ * (valuation snapshot is the headline; pit / reports / series cover deeper
+ * fundamentals access).
  */
 export const ALL_VERB_SPECS = [
     lookupSpec,
     digestSpec,
     searchSpec,
     quoteSpec,
+    marketStatusSpec,
+    marketMoversSpec,
     viewsSpec,
     newsSpec,
+    announcementsFeedSpec,
+    announcementsStockSpec,
+    announcementsDetailSpec,
     sentimentSpec,
+    sentimentOverviewSpec,
+    sentimentBreadthSpec,
+    sentimentTurnoverSpec,
+    sentimentPctDistributionSpec,
     hotSpec,
+    conceptsListSpec,
+    conceptsSnapshotSpec,
+    conceptsShowSpec,
+    conceptsAlertsSpec,
+    conceptsAlertsHistorySpec,
+    conceptsDailyBarsSpec,
+    conceptsMinuteBarsSpec,
+    conceptsNewsSpec,
+    conceptsViewsSpec,
+    limitUpPoolSpec,
+    limitUpSummarySpec,
+    limitUpHistorySpec,
     chartSpec,
     barsBatchSpec,
     scanSpec,

package/dist/verbs/limit_up.js

@@ -0,0 +1,156 @@
+/**
+ * `echopai limit-up ...` + MCP tools `limit_up_pool` / `limit_up_summary` /
+ * `limit_up_history`.
+ *
+ * 涨停股池 / 涨停统计 / 涨停趋势 — 短线情绪与连板梯队的核心数据源，全部走
+ * stockpulse-rs upstream（`market_limit_up_pool` ReplacingMergeTree + 与情绪页
+ * 同源的 `market_breadth_intraday` 炸板/跌停 snapshot）。
+ *
+ * 盘前回退（与所有行情类页面一致）：< 9:00 → 上一交易日；9:00-9:14 集合竞价
+ * 前空窗期返回 items=[] / trade_date=null；≥ 9:15 起取今日。
+ *
+ * 用例：
+ *   - 短线 agent: limit-up pool → 当日涨停股逐股；按 consecutive_days desc 取
+ *     最高连板；脉冲到 echopai chart 看 K 线
+ *   - 大盘情绪: limit-up summary → 涨停数 / 炸板数 / 连板梯队；配合
+ *     `sentiment overview` 形成情绪面板
+ *   - 趋势研判: limit-up history --days 30 → 近一月每日涨停数 / 最高连板
+ */
+import { Command, Option } from "commander";
+import { z } from "zod";
+import { OPERATIONS } from "../_generated/operations.js";
+import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
+import { callOp } from "../runtime/verb_runner.js";
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const INCLUDE_VALUES = ["active", "all"];
+function clampInt(raw, min, max, fallback) {
+    const n = Math.floor(Number(raw));
+    if (!Number.isFinite(n))
+        return fallback;
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+export const limitUpPoolSpec = {
+    name: "limit_up_pool",
+    description: "A-share limit-up pool for a given trade date — per-stock detail: first/last seal time, final pct, seal amount/volume, broken count, consecutive_days (连板数), board_count_within (N-day 板数), one-word-board flag, current status (limit_up / broken), board classification. Sort: consecutive_days desc → board_count_within desc → seal_amount desc. Pre-open fallback applies. Use when an agent needs the concrete list of '今天涨停了哪些票'.",
+    inputSchema: {
+        trade_date: z
+            .string()
+            .regex(DATE_RE)
+            .optional()
+            .describe("ISO date YYYY-MM-DD; omit for latest (pre-open fallback)"),
+        include: z
+            .enum(INCLUDE_VALUES)
+            .default("active")
+            .describe("active = 排除 ST/退市（默认）; all = 全部"),
+        include_broken: z
+            .boolean()
+            .default(false)
+            .describe("true 时连炸板（status=broken）也一起返回；默认只返回当前封板 status=limit_up"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["limit-up.pool"];
+        if (!op)
+            throw new Error("limit-up.pool op missing");
+        const callArgs = {
+            include: args.include,
+            include_broken: args.include_broken,
+        };
+        if (args.trade_date)
+            callArgs.trade_date = args.trade_date;
+        return callOp(op, callArgs, ctx);
+    },
+    backingOps: ["limit-up.pool"],
+};
+export const limitUpSummarySpec = {
+    name: "limit_up_summary",
+    description: "Limit-up summary for a given trade date: 涨停数 (limit_up_count) / 炸板数 (broken_count) / 跌停数 (limit_down_count) / 最高连板 (max_height) / 连板梯队 ladder[{height, count}]. 炸板/跌停 与情绪页同源 (market_breadth_intraday 当日最新分钟行). Pre-open fallback applies.",
+    inputSchema: {
+        trade_date: z
+            .string()
+            .regex(DATE_RE)
+            .optional()
+            .describe("ISO date YYYY-MM-DD; omit for latest"),
+        include: z
+            .enum(INCLUDE_VALUES)
+            .default("active")
+            .describe("active = all_a_ex_st 口径（默认）; all = all_a 口径"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["limit-up.summary"];
+        if (!op)
+            throw new Error("limit-up.summary op missing");
+        const callArgs = { include: args.include };
+        if (args.trade_date)
+            callArgs.trade_date = args.trade_date;
+        return callOp(op, callArgs, ctx);
+    },
+    backingOps: ["limit-up.summary"],
+};
+export const limitUpHistorySpec = {
+    name: "limit_up_history",
+    description: "Daily limit-up trend over the last N trading days: { trade_date, limit_up_count, broken_count, max_height }. 涨停数/最高连板 from market_limit_up_pool; 炸板数 from market_breadth_intraday (all_a_ex_st). Sorted by trade_date asc (oldest first).",
+    inputSchema: {
+        days: z
+            .number()
+            .int()
+            .min(1)
+            .max(250)
+            .default(30)
+            .describe("Lookback window in trading days (1-250, default 30)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["limit-up.history"];
+        if (!op)
+            throw new Error("limit-up.history op missing");
+        return callOp(op, { days: args.days }, ctx);
+    },
+    backingOps: ["limit-up.history"],
+};
+export function buildLimitUpCommand() {
+    const cmd = new Command("limit-up").description("A-share limit-up board — pool (per-stock detail) / summary (counts + ladder) / history (daily trend).");
+    const pool = cmd.command("pool").description(limitUpPoolSpec.description);
+    pool.addOption(new Option("--trade-date <YYYY-MM-DD>", "Trade date; omit for latest"));
+    pool.addOption(new Option("--include <s>", "active = 排除 ST/退市; all = 全部")
+        .choices([...INCLUDE_VALUES])
+        .default("active"));
+    pool.addOption(new Option("--include-broken", "Also return 炸板 (status=broken); default only limit_up"));
+    pool.action(async (opts) => {
+        if (!OPERATIONS["limit-up.pool"]) {
+            emitVerbError("internal_error", "limit-up.pool missing", undefined, 2);
+        }
+        const args = {
+            include: opts.include,
+            include_broken: Boolean(opts.includeBroken),
+        };
+        if (opts.tradeDate)
+            args.trade_date = opts.tradeDate;
+        await executeVerb(async (ctx) => limitUpPoolSpec.handler(args, ctx));
+    });
+    const summary = cmd.command("summary").description(limitUpSummarySpec.description);
+    summary.addOption(new Option("--trade-date <YYYY-MM-DD>", "Trade date; omit for latest"));
+    summary.addOption(new Option("--include <s>", "active = all_a_ex_st 口径; all = all_a 口径")
+        .choices([...INCLUDE_VALUES])
+        .default("active"));
+    summary.action(async (opts) => {
+        if (!OPERATIONS["limit-up.summary"]) {
+            emitVerbError("internal_error", "limit-up.summary missing", undefined, 2);
+        }
+        const args = { include: opts.include };
+        if (opts.tradeDate)
+            args.trade_date = opts.tradeDate;
+        await executeVerb(async (ctx) => limitUpSummarySpec.handler(args, ctx));
+    });
+    const history = cmd.command("history").description(limitUpHistorySpec.description);
+    history.addOption(new Option("--days <n>", "Lookback window (1-250)").default("30"));
+    history.action(async (opts) => {
+        if (!OPERATIONS["limit-up.history"]) {
+            emitVerbError("internal_error", "limit-up.history missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => limitUpHistorySpec.handler({ days: clampInt(opts.days, 1, 250, 30) }, ctx));
+    });
+    return cmd;
+}

package/dist/verbs/lookup.js

@@ -30,7 +30,7 @@ export function mapLookupResponse(raw) {
 }
 export const lookupSpec = {
     name: "lookup",
-    description: "Resolve a Chinese name / A-share code / pinyin initials to canonical codes (e.g. SSE:600519). Use this first whenever the agent has a description but needs a canonical_code for downstream calls.",
+    description: "Resolve a Chinese name / A-share code / pinyin initials to canonical codes (e.g. SSE:600519). Use this first whenever the agent has a description but needs a canonical_code for downstream calls. AH dual-listing: when a company is listed on both A-share and HK (e.g. 工商银行 SSE:601398 / HK:01398), prefer the A-share canonical for all downstream analysis unless the user explicitly asks for the HK side.",
     inputSchema: {
         text: z
             .string()

package/dist/verbs/market.js

@@ -0,0 +1,185 @@
+/**
+ * `echopai market ...` + MCP tools `market_status` / `market_movers`.
+ *
+ *   - status — A 股市场会话状态：pre-open / open / lunch / closed +
+ *     当前/下一交易日 + 节假日 flag。非计费，agent 在 quote / bars 前调一次
+ *     决定盘前回退口径。
+ *   - movers — /market 行情榜单：客户端对 `quote.scan` 的 ~5800 只 A 股
+ *     snapshot 按用户选择的字段 (pct / speed / amount / turnover / total_mv /
+ *     pct_asc) 排序后取 top N。仅本地排序，agent 不需要自行下载 3 MB 再筛。
+ *
+ * `market_movers` 不是新的 partner endpoint，而是 CLI 端对 `quote.scan` 的
+ * 客户端排序 + slice。背后 op 还是 `quote.scan`，scope 一致（quote:*）。
+ */
+import { Command, Option } from "commander";
+import { z } from "zod";
+import { OPERATIONS } from "../_generated/operations.js";
+import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
+import { callOp } from "../runtime/verb_runner.js";
+export const marketStatusSpec = {
+    name: "market_status",
+    description: "Current A-share market session: pre-open / open / lunch / closed; current and next trading day; holiday flag. Cheap and non-billable — call it before any quote / bars fetch when the agent needs to decide pre-market fallback vs intraday vs after-close behavior.",
+    inputSchema: {},
+    handler: async (_args, ctx) => {
+        const op = OPERATIONS["market.status"];
+        if (!op)
+            throw new Error("market.status op missing");
+        return callOp(op, {}, ctx);
+    },
+    backingOps: ["market.status"],
+};
+const EXCHANGE_VALUES = ["SSE", "SZSE", "BSE"];
+const INCLUDE_VALUES = ["active", "all"];
+// `pct_asc` = 跌幅榜 (ascending pct);  其余字段均按 desc 取头部.
+const MOVERS_SORT_VALUES = [
+    "pct",
+    "pct_asc",
+    "speed",
+    "amount",
+    "turnover",
+    "total_mv",
+];
+function moversFieldOf(sort) {
+    switch (sort) {
+        case "pct":
+        case "pct_asc":
+            return "pct";
+        case "speed":
+            return "speed_3min";
+        case "turnover":
+            return "turnover_rate";
+        case "total_mv":
+            return "total_mv";
+        case "amount":
+        default:
+            return "amount";
+    }
+}
+function numericOrNeg(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return Number.NEGATIVE_INFINITY;
+}
+export const marketMoversSpec = {
+    name: "market_movers",
+    description: "A-share market movers — top N from the full real-time snapshot, sorted by chosen field. Sort keys: `pct` (涨幅榜) / `pct_asc` (跌幅榜) / `speed` (3-min 涨速 speed_3min) / `amount` (成交额) / `turnover` (换手率 turnover_rate) / `total_mv` (总市值). Backed by `quote.scan` so 9:00-9:14 集合竞价时段会返空 (with `note`). Defaults: sort=pct, top=20, include=active (排除 ST / 退市). Use this for /market-style 'who's running today' instead of pulling the full 3 MB scan and sorting client-side.",
+    inputSchema: {
+        sort: z
+            .enum(MOVERS_SORT_VALUES)
+            .default("pct")
+            .describe("Sort field: pct / pct_asc / speed / amount / turnover / total_mv"),
+        top: z
+            .number()
+            .int()
+            .min(1)
+            .max(500)
+            .default(20)
+            .describe("Top N items (1-500, default 20)"),
+        exchange: z
+            .enum(EXCHANGE_VALUES)
+            .optional()
+            .describe("Narrow to one exchange: SSE / SZSE / BSE"),
+        include: z
+            .enum(INCLUDE_VALUES)
+            .default("active")
+            .describe("active = 排除 ST/退市（默认）; all = 全集（含 ST + 退市 + 未知 status）"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["quote.scan"];
+        if (!op)
+            throw new Error("quote.scan op missing");
+        const callArgs = {};
+        if (args.exchange)
+            callArgs.exchange = args.exchange;
+        // quote.scan input schema currently exposes only `exchange`; `include`
+        // is supported by the server side (see stockpulse-rs stocks.rs) but
+        // not yet declared in the partner inputSchema. Pass via raw URL anyway
+        // by injecting before callOp — but to avoid ajv strict mode kicking,
+        // we route through callOp which has additionalProperties:false. So we
+        // currently DON'T forward `include` until the contract picks it up.
+        // Default server behavior (`active`) matches our CLI default; if the
+        // user explicitly wants `all`, fall through to verb-level filter below.
+        const env = await callOp(op, callArgs, ctx);
+        return sliceMoversEnvelope(env, args.sort, Number(args.top ?? 20), args.include === "all");
+    },
+    backingOps: ["quote.scan"],
+};
+function sliceMoversEnvelope(env, sort, top, _includeAll) {
+    const body = env.data;
+    if (!body || typeof body !== "object" || !Array.isArray(body.items)) {
+        return env;
+    }
+    const items = body.items.slice();
+    const field = moversFieldOf(sort);
+    const asc = sort === "pct_asc";
+    items.sort((a, b) => {
+        const av = numericOrNeg(a[field]);
+        const bv = numericOrNeg(b[field]);
+        return asc ? av - bv : bv - av;
+    });
+    const sliced = items.slice(0, Math.max(1, Math.floor(top)));
+    const data = {
+        ...body,
+        items: sliced,
+        sort,
+        sort_field: field,
+        top,
+    };
+    const meta = {
+        ...(env.meta ?? {}),
+        client_sort: sort,
+        client_sort_field: field,
+        client_top: top,
+    };
+    return { data, meta };
+}
+function clampInt(raw, min, max, fallback) {
+    const n = Math.floor(Number(raw));
+    if (!Number.isFinite(n))
+        return fallback;
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+export function buildMarketCommand() {
+    const cmd = new Command("market").description("Market session state + real-time movers (涨幅/涨速/成交额/换手率/总市值).");
+    const status = cmd
+        .command("status")
+        .description(marketStatusSpec.description);
+    status.action(async () => {
+        if (!OPERATIONS["market.status"]) {
+            emitVerbError("internal_error", "market.status missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => marketStatusSpec.handler({}, ctx));
+    });
+    const movers = cmd.command("movers").description(marketMoversSpec.description);
+    movers.addOption(new Option("--sort <field>", "Sort field")
+        .choices([...MOVERS_SORT_VALUES])
+        .default("pct"));
+    movers.addOption(new Option("--top <n>", "Top N items (1-500)").default("20"));
+    movers.addOption(new Option("--exchange <ex>", "Filter by exchange").choices([...EXCHANGE_VALUES]));
+    movers.addOption(new Option("--include <s>", "active (默认排除 ST/退市) | all")
+        .choices([...INCLUDE_VALUES])
+        .default("active"));
+    movers.action(async (opts) => {
+        if (!OPERATIONS["quote.scan"]) {
+            emitVerbError("internal_error", "quote.scan missing", undefined, 2);
+        }
+        const args = {
+            sort: opts.sort,
+            top: clampInt(opts.top, 1, 500, 20),
+            include: opts.include,
+        };
+        if (opts.exchange)
+            args.exchange = opts.exchange;
+        await executeVerb(async (ctx) => marketMoversSpec.handler(args, ctx));
+    });
+    return cmd;
+}

package/dist/verbs/news.js

@@ -10,12 +10,17 @@ import { executeVerb } from "../runtime/verb_cmd.js";
 import { callOp } from "../runtime/verb_runner.js";
 export const newsSpec = {
     name: "news",
-    description: "SUPPLEMENTARY news / market briefs (short time-horizon event stream). Use ONLY to fill gaps not covered by `views`; prefer `views` as the primary research source. With `query` → full-text search; without `query` → time-window feed.",
+    description: "SUPPLEMENTARY news / market briefs (short time-horizon event stream). Use ONLY to fill gaps not covered by `views`; prefer `views` as the primary research source. Three modes: `code` (canonical) → news mentioning that security; `query` (free text) → full-text search; neither → recent time-window feed. AH dual-listing: when filtering by `code` for an A+H listed company, pass the A-share canonical (e.g. SSE:601398) for consolidated coverage; HK side only if the user explicitly asks. Note: `query` is matched against news text, so passing a canonical_code as `query` will not work — use `code` for security filtering.",
     inputSchema: {
+        code: z
+            .string()
+            .regex(/^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\-]{0,5})$/)
+            .optional()
+            .describe("Filter by security canonical_code (e.g. SSE:600519, HK:00700). Takes precedence over `query`."),
         query: z
             .string()
             .optional()
-            .describe("Free-text query (Chinese or English); omit for time-window feed"),
+            .describe("Free-text query (Chinese or English) matched against news content; omit for time-window feed. Do NOT pass canonical_code here — use `code` instead."),
         hours: z
             .number()
             .int()
@@ -26,6 +31,12 @@ export const newsSpec = {
         limit: z.number().int().min(1).max(100).default(20).describe("Max items"),
     },
     handler: async (args, ctx) => {
+        if (args.code) {
+            const op = OPERATIONS["news.list"];
+            if (!op)
+                throw new Error("news.list op missing");
+            return callOp(op, { security: args.code, since_hours: args.hours, limit: args.limit }, ctx);
+        }
         if (args.query) {
             const op = OPERATIONS["news.search"];
             if (!op)
@@ -37,7 +48,7 @@ export const newsSpec = {
             throw new Error("news.feed op missing");
         return callOp(op, {}, ctx);
     },
-    backingOps: ["news.search", "news.feed"],
+    backingOps: ["news.list", "news.search", "news.feed"],
 };
 function clamp(raw, min, max, fallback) {
     const n = Math.floor(Number(raw));
@@ -51,6 +62,7 @@ function clamp(raw, min, max, fallback) {
 }
 export function buildNewsCommand() {
     const cmd = new Command(newsSpec.name).description(newsSpec.description);
+    cmd.addOption(new Option("--code <canonical_code>", "Filter by security canonical_code (e.g. SSE:600519); takes precedence over --query"));
     cmd.addOption(new Option("--query <text>", "Free-text query; omit for time-window feed"));
     cmd.addOption(new Option("--hours <n>", "Lookback window (1-168 hours)").default("24"));
     cmd.addOption(new Option("--limit <n>", "Max items").default("20"));
@@ -59,6 +71,8 @@ export function buildNewsCommand() {
             hours: clamp(opts.hours, 1, 168, 24),
             limit: clamp(opts.limit, 1, 100, 20),
         };
+        if (opts.code)
+            args.code = opts.code;
         if (opts.query)
             args.query = opts.query;
         await executeVerb(async (ctx) => newsSpec.handler(args, ctx));

package/dist/verbs/quote.js

@@ -9,7 +9,7 @@ import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
 import { callOp } from "../runtime/verb_runner.js";
 export const quoteSpec = {
     name: "quote",
-    description: "Real-time quote for 1-200 A-share securities (last price, volume, change %, bid/ask). For >200 codes use `scan` instead.",
+    description: "Real-time quote for 1-200 A-share securities (last price, volume, change %, bid/ask). For >200 codes use `scan` instead. AH dual-listing: HK codes are not supported here; for an A+H listed company use the A-share canonical (e.g. SSE:601398 not HK:01398).",
     inputSchema: {
         codes: z
             .array(z.string().regex(/^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/))