echopai 2.2.0 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echopai",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Command-line interface for the EchoPai Open Platform: stock-market data, news, analyst views, sentiment, signals, backtests.",
   "license": "MIT",
   "homepage": "https://echopai.com",
@@ -25,18 +25,18 @@
     "echopai": "dist/bin.js"
   },
   "files": [
-    "dist",
+    "dist/bin.js",
     "README.md"
   ],
   "scripts": {
     "codegen": "cd .. && (test -x scripts/codegen/.venv/bin/python || (python3 -m venv scripts/codegen/.venv && scripts/codegen/.venv/bin/pip install -q -r scripts/codegen/requirements.txt)) && scripts/codegen/.venv/bin/python scripts/codegen/generate_cli_v2.py --in docs/api-contract/openapi.yaml --out cli/src/_generated",
-    "prebuild": "npm run codegen",
-    "build": "tsc",
-    "pretest": "npm run codegen",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "dev": "npm run codegen && tsx src/bin.ts",
-    "prepublishOnly": "npm run build"
+    "typecheck": "tsc --noEmit",
+    "build": "bun run codegen && bun build src/bin.ts --target=node --packages=external --outfile=dist/bin.js",
+    "compile": "bun run codegen && bun run scripts/compile.ts",
+    "test": "bun run codegen && bun test",
+    "test:watch": "bun test --watch",
+    "dev": "bun run codegen && bun run src/bin.ts",
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -45,14 +45,12 @@
     "commander": "^12.1.0",
     "jmespath": "^0.16.0",
     "smol-toml": "^1.4.2",
-    "undici": "^7.16.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@types/bun": "^1.1.14",
     "@types/jmespath": "^0.15.2",
     "@types/node": "^20.0.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.9"
+    "typescript": "^5.6.3"
   }
 }

package/dist/_generated/commands.js

@@ -1,282 +0,0 @@
-/**
- * AUTO-GENERATED — DO NOT EDIT BY HAND.
- *
- * Source: docs/api-contract/openapi.yaml
- * Generator: scripts/codegen/generate_cli_v2.py
- */
-import { Option } from "commander";
-import { OPERATIONS } from "./operations.js";
-/**
- * commander v12 把 --since-hours 自动 camelCase 成 sinceHours，但 OpenAPI 这
- * 边期待 snake_case (since_hours)。一次性 camelCase → snake_case 反转。
- */
-function camelToSnake(s) {
-    return s.replace(/[A-Z]/g, (m) => "_" + m.toLowerCase());
-}
-function attachOperation(cmd, op, dispatch) {
-    cmd.description(op.summary || op.description);
-    // positional args
-    for (const pname of op.positional) {
-        const required = (op.inputSchema.required || []).includes(pname);
-        cmd.argument(required ? `<${pname}>` : `[${pname}]`, String(op.inputSchema.properties[pname]?.description ?? ""));
-    }
-    // remaining params → --flag (dashes for ergonomics; reverse camelCase later)
-    for (const [pname, pschema] of Object.entries(op.inputSchema.properties)) {
-        if (op.positional.includes(pname))
-            continue;
-        const required = (op.inputSchema.required || []).includes(pname);
-        const flagName = `--${pname.replace(/_/g, "-")} <value>`;
-        const desc = String(pschema?.description ?? "");
-        const opt = new Option(flagName, desc);
-        if (required)
-            opt.makeOptionMandatory(true);
-        cmd.addOption(opt);
-    }
-    cmd.addOption(new Option("--output <format>", "Output format: json|ndjson|table|csv|tsv|yaml").choices(["json", "ndjson", "table", "csv", "tsv", "yaml"]).default(op.outputDefault));
-    if (op.pagination !== 'none') {
-        cmd.addOption(new Option("--all", "Fetch all pages and stream NDJSON"));
-        cmd.addOption(new Option("--max-pages <n>", "Stop after N pages (default 1000)"));
-        cmd.addOption(new Option("--max-items <n>", "Stop after N items (default 100000)"));
-    }
-    if (op.idempotencyRequired) {
-        cmd.addOption(new Option("--idempotency-key <uuid>", "Override auto-generated Idempotency-Key (debug / replay)"));
-    }
-    // WS stream options removed (--reconnect / --max-frames). CLI no longer
-    // exposes /v1/ws/{news,views} as commands; codegen now drops x-cli-key
-    // for those ops so `op.stream` is always false here.
-    cmd.action(async (...rawArgs) => {
-        const opts = cmd.opts();
-        // reverse commander's camelCase: sinceHours → since_hours
-        const args = {};
-        for (const [k, v] of Object.entries(opts)) {
-            args[camelToSnake(k)] = v;
-        }
-        op.positional.forEach((pname, i) => {
-            if (rawArgs[i] !== undefined)
-                args[pname] = rawArgs[i];
-        });
-        await dispatch(op, args);
-    });
-}
-export function buildCommandTree(program, dispatch) {
-    {
-        const noun = program.command("agent");
-        noun.description("agent commands");
-        {
-            const cmd = noun.command("session-end");
-            attachOperation(cmd, OPERATIONS["agent.session-end"], dispatch);
-        }
-        {
-            const cmd = noun.command("session-start");
-            attachOperation(cmd, OPERATIONS["agent.session-start"], dispatch);
-        }
-        {
-            const cmd = noun.command("session-usage");
-            attachOperation(cmd, OPERATIONS["agent.session-usage"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("auth");
-        noun.description("auth commands");
-        {
-            const cmd = noun.command("whoami");
-            attachOperation(cmd, OPERATIONS["auth.whoami"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("bars");
-        noun.description("bars commands");
-        {
-            const cmd = noun.command("daily");
-            attachOperation(cmd, OPERATIONS["bars.daily"], dispatch);
-        }
-        {
-            const cmd = noun.command("daily-batch");
-            attachOperation(cmd, OPERATIONS["bars.daily-batch"], dispatch);
-        }
-        {
-            const cmd = noun.command("minute");
-            attachOperation(cmd, OPERATIONS["bars.minute"], dispatch);
-        }
-        {
-            const cmd = noun.command("minute-batch");
-            attachOperation(cmd, OPERATIONS["bars.minute-batch"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("digest");
-        noun.description("digest commands");
-        {
-            const cmd = noun.command("get");
-            attachOperation(cmd, OPERATIONS["digest.get"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("financials");
-        noun.description("financials commands");
-        {
-            const cmd = noun.command("pit");
-            attachOperation(cmd, OPERATIONS["financials.pit"], dispatch);
-        }
-        {
-            const cmd = noun.command("quote-snapshot");
-            attachOperation(cmd, OPERATIONS["financials.quote-snapshot"], dispatch);
-        }
-        {
-            const cmd = noun.command("reports");
-            attachOperation(cmd, OPERATIONS["financials.reports"], dispatch);
-        }
-        {
-            const cmd = noun.command("series");
-            attachOperation(cmd, OPERATIONS["financials.series"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("index");
-        noun.description("index commands");
-        {
-            const cmd = noun.command("daily-bars");
-            attachOperation(cmd, OPERATIONS["index.daily-bars"], dispatch);
-        }
-        {
-            const cmd = noun.command("minute-bars");
-            attachOperation(cmd, OPERATIONS["index.minute-bars"], dispatch);
-        }
-        {
-            const cmd = noun.command("snapshot");
-            attachOperation(cmd, OPERATIONS["index.snapshot"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("market");
-        noun.description("market commands");
-        {
-            const cmd = noun.command("status");
-            attachOperation(cmd, OPERATIONS["market.status"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("news");
-        noun.description("news commands");
-        {
-            const cmd = noun.command("feed");
-            attachOperation(cmd, OPERATIONS["news.feed"], dispatch);
-        }
-        {
-            const cmd = noun.command("get");
-            attachOperation(cmd, OPERATIONS["news.get"], dispatch);
-        }
-        {
-            const cmd = noun.command("list");
-            attachOperation(cmd, OPERATIONS["news.list"], dispatch);
-        }
-        {
-            const cmd = noun.command("search");
-            attachOperation(cmd, OPERATIONS["news.search"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("payment");
-        noun.description("payment commands");
-        {
-            const cmd = noun.command("plans");
-            attachOperation(cmd, OPERATIONS["payment.plans"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("quote");
-        noun.description("quote commands");
-        {
-            const cmd = noun.command("quote");
-            attachOperation(cmd, OPERATIONS["quote"], dispatch);
-        }
-        {
-            const cmd = noun.command("scan");
-            attachOperation(cmd, OPERATIONS["quote.scan"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("search");
-        noun.description("search commands");
-        {
-            const cmd = noun.command("semantic");
-            attachOperation(cmd, OPERATIONS["search.semantic"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("securities");
-        noun.description("securities commands");
-        {
-            const cmd = noun.command("industry");
-            attachOperation(cmd, OPERATIONS["securities.industry"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("semantic");
-        noun.description("semantic commands");
-        {
-            const cmd = noun.command("find");
-            attachOperation(cmd, OPERATIONS["semantic.find"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("sentiment");
-        noun.description("sentiment commands");
-        {
-            const cmd = noun.command("breadth");
-            attachOperation(cmd, OPERATIONS["sentiment.breadth"], dispatch);
-        }
-        {
-            const cmd = noun.command("overview");
-            attachOperation(cmd, OPERATIONS["sentiment.overview"], dispatch);
-        }
-        {
-            const cmd = noun.command("pct-distribution");
-            attachOperation(cmd, OPERATIONS["sentiment.pct-distribution"], dispatch);
-        }
-        {
-            const cmd = noun.command("turnover");
-            attachOperation(cmd, OPERATIONS["sentiment.turnover"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("squawk");
-        noun.description("squawk commands");
-        {
-            const cmd = noun.command("audio");
-            attachOperation(cmd, OPERATIONS["squawk.audio"], dispatch);
-        }
-        {
-            const cmd = noun.command("waveform");
-            attachOperation(cmd, OPERATIONS["squawk.waveform"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("stocks");
-        noun.description("stocks commands");
-        {
-            const cmd = noun.command("hot");
-            attachOperation(cmd, OPERATIONS["stocks.hot"], dispatch);
-        }
-        {
-            const cmd = noun.command("social-hot");
-            attachOperation(cmd, OPERATIONS["stocks.social-hot"], dispatch);
-        }
-    }
-    {
-        const noun = program.command("views");
-        noun.description("views commands");
-        {
-            const cmd = noun.command("feed");
-            attachOperation(cmd, OPERATIONS["views.feed"], dispatch);
-        }
-        {
-            const cmd = noun.command("get");
-            attachOperation(cmd, OPERATIONS["views.get"], dispatch);
-        }
-        {
-            const cmd = noun.command("recent");
-            attachOperation(cmd, OPERATIONS["views.recent"], dispatch);
-        }
-    }
-}

package/dist/_generated/help.js

@@ -1,195 +0,0 @@
-/**
- * AUTO-GENERATED — DO NOT EDIT BY HAND.
- */
-export const HELP = {
-    "agent.session-end": {
-        "summary": "End a billable agent session",
-        "description": "关闭 `/v1/agent/session/start` 开启的会话，最终用量提交入库。",
-        "example": "echopai agent session-end VALUE"
-    },
-    "agent.session-start": {
-        "summary": "Start a billable agent session",
-        "description": "开启 agent kind 凭据的计费会话。返回 session_id，用于将多次调用归并到一次 billable 单位。需要 `Idempotency-Key` 头。",
-        "example": "echopai agent session-start --agent-id agent-prod-1 --budget-usd 1.0"
-    },
-    "agent.session-usage": {
-        "summary": "Get cumulative usage of an agent session",
-        "description": "返回 session 内累计 billable 调用次数、各 scope 配额消耗。",
-        "example": "echopai agent session-usage VALUE"
-    },
-    "auth.whoami": {
-        "summary": "Token introspection (CLI/MCP capability discovery)",
-        "description": "Returns the calling token's kind, scopes, audience, app metadata,\nrate_limit, allowed_clients, agent_budget (if kind=agent), api_version,\nfeature_flags. Any valid JWT can call — no specific scope required.\n\nCLI/MCP call this once at startup, cache 5 minutes in-process, and use\nthe response to derive `verbs.available` (intersection of curated verb\nscopes with token scopes) and to populate `echopai doctor` checks.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §5.1.\n",
-        "example": "echopai auth whoami"
-    },
-    "bars.daily": {
-        "summary": "Daily OHLC bars for one A-share security",
-        "description": "Daily OHLC bars for one A-share security over a date range. Returns open / high / low / close / volume / turnover per trading day. Requires `bars:30d` (last 30 trading days) or `bars:full` (full history) scope.",
-        "example": "echopai bars daily --code SSE:600519 --from 2026-01-01 --to 2026-05-01"
-    },
-    "bars.daily-batch": {
-        "summary": "Batch daily OHLC bars for up to 100 A-share securities",
-        "description": "Batch daily OHLC bars for multiple A-share securities. Up to 100 codes\nper call, up to 1-year date range. Single round-trip; ClickHouse `IN(...)`\nunder the hood.\n\nReturns partial success envelope: codes denied by `allowed_securities`\nappear in `errors[]`, others in `items[]` (with empty `bars[]` if no\ndata found). Order in `items[]` matches input order.\n\nRequires `bars:30d` or `bars:full` scope.\n",
-        "example": "echopai bars daily-batch --codes ['SSE:600519', 'SZSE:000001']"
-    },
-    "bars.minute": {
-        "summary": "Minute-level OHLC bars for one A-share security",
-        "description": "Minute-level OHLC bars for one A-share security on a single trade date. Requires `bars:30d` or `bars:full` scope.",
-        "example": "echopai bars minute --code SSE:600519 --date 2026-05-09"
-    },
-    "bars.minute-batch": {
-        "summary": "Batch minute OHLC bars for up to 20 A-share securities",
-        "description": "Batch minute OHLC bars for multiple A-share securities. Up to 20 codes\nper call, up to 7 calendar days (≈5 trading days) date range. Single\nClickHouse round-trip; app groups rows by canonical_code.\n\nPartial success envelope same as daily-batch: codes denied by\n`allowed_securities` go to `errors[]`; others to `items[]` with flat\n`bars[]` (each bar carries its own `trade_date` for client grouping).\n\nRequires `bars:30d` or `bars:full` scope.\n",
-        "example": "echopai bars minute-batch --codes ['SSE:600519', 'SZSE:000001']"
-    },
-    "digest.get": {
-        "summary": "One-shot research digest for a single security (composite)",
-        "description": "Composite endpoint: in one HTTP call returns views (PRIMARY research),\nreal-time quote, valuation snapshot (PE/PB/PS/换手率/股息率/量比 等 14 字段),\nmarket sentiment context, and supplementary news.\nPartial-failure tolerant:\neach bucket is independently fetched and per-bucket failures surface\nin `meta.partial_failures[]` rather than poisoning the response. If\nevery sub-bucket fails the endpoint returns 502.\n\nBucket scopes are checked *per bucket* (not at gateway level): a\ntoken with only `views:read` gets the views bucket populated and the\nrest reported as `scope_insufficient` partial failures. This mirrors\nthe CLI fan-out contract exactly so `echopai digest` can either call\nthis endpoint (preferred, single round-trip) or fall back to local\nfan-out without behavior drift.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §3.3 (digest spec) and §11\nPhase 5.2 (server endpoint).\n",
-        "example": "echopai digest get VALUE"
-    },
-    "financials.pit": {
-        "summary": "Point-in-time financial indicators for one A-share at a given date",
-        "description": "基于 TDX 财务数据的 Point-in-time 查询。给定 `code` 和 `date`，返回该\n`trade_date` 当时市场上可见的最新一期财务报告（`announce_date <= date`，\n无公告日时保守延迟 90 天）。专为回测、AI agent、量化策略防未来函数泄漏。\n\n返回字段包括：EPS（基本/扣非/稀释）、BPS、ROE、毛利率、营收/净利润/总资产/\n归母权益等核心 ~25 字段。\n",
-        "example": "echopai financials pit --code SSE:600519 --date 2024-11-01"
-    },
-    "financials.quote-snapshot": {
-        "summary": "Real-time valuation / share / turnover snapshot for one A-share",
-        "description": "一站式估值快照 —— 一次返回 14 个字段，**全部基于 TDX 原始数据 + Sina 实时\n价自算，不依赖 Tushare**：\n\n- 估值: `pe` / `pe_ttm` / `pb` / `ps` / `ps_ttm`\n- 股本（万股）: `total_share` / `float_share` / `free_share`\n- 市值（万元）: `total_mv` / `circ_mv`\n- 流动性: `turnover_rate` / `turnover_rate_f`（%）/ `volume_ratio`（倍）\n- 分红: `dv_ratio` / `dv_ttm`（%）\n\n计算口径：\n- PE-TTM = 当前总市值 / 近 4 季度滚动净利润（PIT 表 `ni_parent_ttm`）\n- PE     = 当前总市值 / 上年报净利润（`ni_parent_last1y`）\n- PB     = 当前总市值 / 归母净资产（`equity_parent`，PIT 防穿越）\n- 换手率 = 当日累计成交量 / 流通股本 × 100\n- 量比   = 当日累计 / 近 5 日同时段累计平均（实时模式）\n          / 近 5 日全日成交量平均（指定历史日期模式）\n- 股息率 = Σ(去年 / 近12月内派息事件 派现/10) / 现价 × 100\n\n默认 `date` 留空 → 实时（Sina 5s 快照价 + 当日累计成交量）；\n给 `date=YYYY-MM-DD` 则按当日 close 取值（用于历史回测 / 校验）。\n\n财报数据走 `security_financial_indicators_pit` PIT 视图：保证 `visible_date`\n≤ trade_date，避免未来函数。\n\n准确性已对照 Tushare `daily_basic` 校验（见 `scripts/validation/validate_quote_snapshot_vs_tushare.py`）。\n",
-        "example": "echopai financials quote-snapshot --code SSE:600519 --date 2026-05-13"
-    },
-    "financials.reports": {
-        "summary": "Recent financial reports for one A-share security",
-        "description": "返回该股票最近 N 期财务报告的核心指标（EPS/BPS/ROE/毛利率/营收/净利润/总\n资产/归母权益/经营现金流/总股本 等 ~25 字段）。可按 `kind` 过滤季报/半年报/\n年报。每期 `announce_date` 字段告知何时市场可见，建议结合回测时使用。\n",
-        "example": "echopai financials reports --code SSE:600519"
-    },
-    "financials.series": {
-        "summary": "Time series of a single financial metric for one security",
-        "description": "返回某只股票某个财务指标的历史时间序列（按报告期排列）。`metric` 是\nindicators 表中的字段名（如 `roe_simple` / `revenue` / `ni_parent` /\n`debt_asset_ratio` / `gross_margin` / `eps_basic` 等共 150 个）。\n\n典型用法：画茅台 10 年 ROE 走势、对比 5 只白酒股 net_margin。\n",
-        "example": "echopai financials series --code SSE:600519 --metric roe_simple"
-    },
-    "index.daily-bars": {
-        "summary": "Daily OHLC bars for one A-share index",
-        "description": "指数日线 OHLC。覆盖 v2 表中的指数（上证综指 `SSE:000001` / 深证成指\n`SZSE:399001` / 沪深300 `SSE:000300` / 北证50 `BSE:899050` / 中证系列 `CSI:000922` 等）。\n与 `/v1/bars/daily` 同语义，但 index 没有 `turnover_rate` / `paused` 等股票特有字段。\n",
-        "example": "echopai index daily-bars --code SSE:000001 --from 2024-01-01 --to 2024-12-31"
-    },
-    "index.minute-bars": {
-        "summary": "Minute OHLC bars for one A-share index",
-        "description": "指数 1min OHLC。日期范围 ≤ 7 天（与 `/v1/bars/minute-batch` 对齐）。\n返回 `bar_time` / `trade_date` / OHLC / volume / amount / pct_change。\n",
-        "example": "echopai index minute-bars --code SSE:000001"
-    },
-    "index.snapshot": {
-        "summary": "Real-time snapshot of all Sina-OK A-share indices (172 indices)",
-        "description": "Returns the latest real-time snapshot for the 172 indices that Sina\nexposes a quote for (SSE / SZSE / BSE — includes 北证50 `BSE:899050`\nand 专精特新 `899601.BJ`). Source is the Redis hash\n`stockpulse:index_snapshots:latest` which the Rust collector refreshes\nevery ~15 seconds during market hours; outside trading hours the last\nintraday snapshot is returned.\n\nUse `codes` to narrow to a subset (canonical format `SSE:000001` (exchange-prefix; legacy `000001.SH` is also accepted but discouraged)).\nOmit to receive all 172.\n\nNote: CSI-series indices (e.g. `CSI:000922`) are not available here —\nSina has no quote feed for them. Daily/minute history for those still\nlives behind `/api/internal/index/{daily-bars,minute-bars-range}`.\n\nRequires `quote:l1`, `quote:l2`, or `quote:delayed` scope.\n",
-        "example": "echopai index snapshot --codes SSE:000001,SZSE:399001,BSE:899050"
-    },
-    "market.status": {
-        "summary": "Current A-share market session state",
-        "description": "Current A-share market session: pre-open / open / lunch / closed; current and next trading day; holiday flag. Requires `market:read` or any `quote:*` scope.",
-        "example": "echopai market status"
-    },
-    "news.feed": {
-        "summary": "List recent news (alias of /v1/news/list)",
-        "description": "与 `/v1/news/list` 行为一致，旧客户端兼容用。",
-        "example": "echopai news feed"
-    },
-    "news.get": {
-        "summary": "Fetch a single news item by id",
-        "description": "返回新闻完整内容：title、content snippet、tagged securities。（采集端字段 source / source_id / source_url 对外不暴露，admin 路径 /v1/admin/news/{id} 可见。）",
-        "example": "echopai news get VALUE"
-    },
-    "news.list": {
-        "summary": "List news mentioning a specific security",
-        "description": "List news mentioning a specific A-share security, ordered by published_at desc. Requires `news:read` scope.",
-        "example": "echopai news list --security SSE:600519"
-    },
-    "news.search": {
-        "summary": "Full-text search recent news",
-        "description": "Full-text search recent news / market briefs. Returns title, published_at, snippet, tagged securities. (Internal collector identifiers — `source`/`source_id`/`source_url` — are NOT exposed publicly; admin tools see them via /v1/admin/*.) Requires `news:read` scope. Note: news fields are user-generated; meta.untrusted_text_fields lists fields that need sanitization before passing to an LLM.",
-        "example": "echopai news search --query 光伏龙头"
-    },
-    "payment.plans": {
-        "summary": "List subscription plans",
-        "description": "返回订阅计划清单（plan_id + 价格 + 时长 + 描述）。",
-        "example": "echopai payment plans"
-    },
-    "quote": {
-        "summary": "Real-time quote for one or more A-share securities",
-        "description": "Real-time quote for one or more A-share securities. Returns last price, volume, change %, bid/ask. Up to 200 codes per call. Requires `quote:l1`, `quote:l2`, or `quote:delayed` scope.",
-        "example": "echopai quote --codes ['SSE:600519', 'SZSE:000001']"
-    },
-    "quote.scan": {
-        "summary": "Full-market real-time quote scan (~5800 A-share securities)",
-        "description": "Dumps the entire Redis snapshot of A-share real-time quotes in a single\nround-trip. Use for \"全市场扫描\" / agent universe-of-interest discovery\nwhen you don't yet know which codes to query.\n\nFiltering:\n- `exchange=SSE|SZSE|BSE` narrows to one exchange (canonical_code prefix)\n- `app.allowed_securities` is ALWAYS applied; codes outside drop silently\n\nResponse size: ~3 MB unfiltered (~5800 items). CLI users should pair\nwith `--max-bytes` / `--fields` / `--query` from Phase 1.4.\n\n9:00–9:14 集合竞价时段返回空 items + `note` 字段说明。\n\nRequires `quote:l1`, `quote:l2`, or `quote:delayed` scope.\n",
-        "example": "echopai quote scan"
-    },
-    "search.semantic": {
-        "summary": "Hybrid semantic search across news + analyst views",
-        "description": "语义 + 模糊泛化搜索。结合 entity 精确匹配（公司代码/分析师）、向量召回（pgvector\n+ DashScope embedding）、trigram 模糊、ILIKE 精确四路召回，RRF 融合后用 reranker\n精排，叠时间衰减 + views 加权（views 主源优先）。\n\n- 搜\"锂电池\"会带出新能源产业链（正极/负极/碳酸锂/宁德时代…）\n- 搜\"芯片\"会带出存储芯片/洁净室/晶圆代工…\n- mode=exact 兼容老 ILIKE 行为，仅在精确关键词命中时返回。\n",
-        "example": "echopai search semantic --q 锂电池"
-    },
-    "securities.industry": {
-        "summary": "TDX + 申万 industry classification for one A-share security",
-        "description": "返回该股票的 TDX 自定义行业代码（T1001 食品饮料等）与申万行业三级代码\nL1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。\n\n用法：\n- 股票详情页\"申万行业：白酒 / 食品饮料\"标签\n- 筛选器交叉过滤：行业 + ROE/营收增长率\n- AI agent `find_peers(code)` 用申万二级行业找同业\n",
-        "example": "echopai securities industry --code SSE:600519"
-    },
-    "semantic.find": {
-        "summary": "Find A-share securities by name / code / pinyin",
-        "description": "Find A-share securities matching a name (Chinese), code (e.g. 600519), or pinyin initials (e.g. gzmt). Use this when an agent has a description and needs canonical codes.",
-        "example": "echopai semantic find --query 贵州茅台"
-    },
-    "sentiment.breadth": {
-        "summary": "Intraday breadth time series",
-        "description": "Intraday breadth time series. Requires `sentiment:read` scope.",
-        "example": "echopai sentiment breadth"
-    },
-    "sentiment.overview": {
-        "summary": "Aggregate market sentiment indicators",
-        "description": "Aggregate sentiment: limit-up/down counts, breadth, divergence index, top movers. Requires `sentiment:read` scope.",
-        "example": "echopai sentiment overview --scope main_board"
-    },
-    "sentiment.pct-distribution": {
-        "summary": "Distribution of intraday percent change across the universe",
-        "description": "返回 A 股全市场涨跌幅分桶（≤-10% / -9% / ... / +10% / 涨停）的家数分布，用于市场宽度可视化。",
-        "example": "echopai sentiment pct-distribution"
-    },
-    "sentiment.turnover": {
-        "summary": "Intraday turnover time series",
-        "description": "Intraday turnover time series. Requires `sentiment:read` scope.",
-        "example": "echopai sentiment turnover"
-    },
-    "squawk.audio": {
-        "summary": "Stream squawk TTS audio",
-        "description": "返回 squawk 项的 TTS 音频（MP3）。直接 stream，可作为 `<audio>` src 用。",
-        "example": "echopai squawk audio VALUE"
-    },
-    "squawk.waveform": {
-        "summary": "Waveform peaks for squawk audio",
-        "description": "返回 squawk 音频的预计算波形 peak 数据，用于客户端波形可视化。",
-        "example": "echopai squawk waveform VALUE"
-    },
-    "stocks.hot": {
-        "summary": "Today's hot-stock leaderboard",
-        "description": "今日最热股票榜（来源 East-Money），按搜索 / 关注 / 评论综合分排序。",
-        "example": "echopai stocks hot"
-    },
-    "stocks.social-hot": {
-        "summary": "Cross-platform social-hot stocks",
-        "description": "跨平台（微博 / 雪球 / Twitter）社交媒体提及聚合榜，按提及量 / 情感打分。",
-        "example": "echopai stocks social-hot"
-    },
-    "views.feed": {
-        "summary": "List analyst views",
-        "description": "分析师观点 / 卖方研报 / 长文本观点流。可按机构 / 分析师 / 证券 / hours 过滤。需要 `views:read` scope。",
-        "example": "echopai views feed"
-    },
-    "views.get": {
-        "summary": "Fetch a single analyst view",
-        "description": "返回单条 view 完整内容、附件图片、tagged securities、AI 摘要。",
-        "example": "echopai views get VALUE"
-    },
-    "views.recent": {
-        "summary": "Recent broker / analyst views",
-        "description": "List recent broker / analyst views (research notes, price targets, ratings). Filter by analyst, institution, or a specific security. Requires `views:read` scope.",
-        "example": "echopai views recent"
-    }
-};