echopai 2.3.0 → 2.4.0

package/dist/verbs/_spec.js

@@ -1,15 +0,0 @@
-/**
- * VerbSpec —— curated verb 的源声明，CLI 与 MCP 两条入口共享。
- *
- * - CLI (commander): build*Command() 内部把 spec.handler 接到 commander.action
- *   外加 executeVerb (process.exit / stderr / 错误 envelope) 包装。
- * - MCP: tools/mcp.ts 启动时枚举所有 spec，把 inputSchema 直接喂 SDK
- *   registerTool，handler 包成 MCP tool callback。
- *
- * 单源声明保证两个入口的 verb 名称 / 参数语义 / 输出形态完全同步。
- *
- * inputSchema 用 Zod raw shape (Record<string, ZodType>) —— MCP SDK 原生
- * 接受；CLI 端不重复用它做校验 (commander Option + 我们 verb 内部的
- * clamp/parse 已足够)。
- */
-export {};

package/dist/verbs/announcements.js

@@ -1,195 +0,0 @@
-/**
- * `echopai announcements ...` + MCP tools `announcements_feed` /
- * `announcements_stock` / `announcements_detail`.
- *
- * A 股公告 (cninfo 主源)：
- *   - feed    —— 全市场最近公告，按 published_at desc
- *   - stock   —— 指定 canonical_code 的公告历史窗口（最长 5 年）
- *   - detail  —— 单条公告完整正文（content_md + content_text + meta）
- *
- * 三个 op 共享 `announcements:read` scope，calling 协议参数与底层 OpenAPI
- * 一致（type slug / since_days 等）。MCP 注册成三个 discrete tool，AI agent
- * 可按 "我要看 X 的财报披露" / "今天市场公告" / "把这条公告全文给我" 各自取用。
- */
-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 CODE_RE = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
-const ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?$/;
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-export const announcementsFeedSpec = {
-    name: "announcements_feed",
-    description: "Recent A-share announcement feed (cninfo source, sorted by published_at desc). Filter by `type` slug (e.g. annual_report / equity_change / restructuring) or `since` lower bound. Use when surveying market-wide disclosures over a recent window — for a specific stock prefer `announcements_stock`.",
-    inputSchema: {
-        type: z
-            .string()
-            .max(64)
-            .optional()
-            .describe("分类 slug 过滤（如 annual_report / equity_change / restructuring）。"),
-        since: z
-            .string()
-            .regex(ISO_DATETIME_RE)
-            .optional()
-            .describe("ISO datetime 下限（published_at >= since）。"),
-        limit: z
-            .number()
-            .int()
-            .min(1)
-            .max(200)
-            .default(50)
-            .describe("Max items (1-200, default 50)"),
-        offset: z
-            .number()
-            .int()
-            .min(0)
-            .default(0)
-            .describe("Pagination offset"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["announcements.feed"];
-        if (!op)
-            throw new Error("announcements.feed op missing");
-        const callArgs = {
-            limit: args.limit,
-            offset: args.offset,
-        };
-        if (args.type)
-            callArgs.type = args.type;
-        if (args.since)
-            callArgs.since = args.since;
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["announcements.feed"],
-};
-export const announcementsStockSpec = {
-    name: "announcements_stock",
-    description: "Announcement history for a single A-share security (cninfo). Default lookback 30 days, max 5 years. AH dual-listing: pass the A-share canonical (announcements are A-share only — HK side has separate HKEX disclosures not covered here).",
-    inputSchema: {
-        code: z
-            .string()
-            .regex(CODE_RE)
-            .describe("A-share canonical code (e.g. SSE:600519)"),
-        since_days: z
-            .number()
-            .int()
-            .min(1)
-            .max(1825)
-            .default(30)
-            .describe("Lookback window in days (1-1825, default 30)"),
-        type: z
-            .string()
-            .max(64)
-            .optional()
-            .describe("分类 slug 过滤（与 feed 同集合）"),
-        limit: z
-            .number()
-            .int()
-            .min(1)
-            .max(200)
-            .default(50)
-            .describe("Max items (1-200, default 50)"),
-        offset: z
-            .number()
-            .int()
-            .min(0)
-            .default(0)
-            .describe("Pagination offset"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["announcements.stock"];
-        if (!op)
-            throw new Error("announcements.stock op missing");
-        const callArgs = {
-            code: args.code,
-            since_days: args.since_days,
-            limit: args.limit,
-            offset: args.offset,
-        };
-        if (args.type)
-            callArgs.type = args.type;
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["announcements.stock"],
-};
-export const announcementsDetailSpec = {
-    name: "announcements_detail",
-    description: "Fetch one announcement by id (UUID from feed/stock items[].id). Returns full content_md + content_text + cninfo meta + parse status. Use when the summary in feed/stock is not enough and you need the full document body for citation or NLP.",
-    inputSchema: {
-        announcement_id: z
-            .string()
-            .regex(UUID_RE)
-            .describe("UUID (feed / stock 返回的 items[].id)"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["announcements.detail"];
-        if (!op)
-            throw new Error("announcements.detail op missing");
-        return callOp(op, { announcement_id: args.announcement_id }, ctx);
-    },
-    backingOps: ["announcements.detail"],
-};
-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 buildAnnouncementsCommand() {
-    const cmd = new Command("announcements").description("A-share announcements (cninfo) — recent feed, per-stock history, single-item detail.");
-    const feed = cmd.command("feed").description(announcementsFeedSpec.description);
-    feed.addOption(new Option("--type <slug>", "Filter by 分类 slug (annual_report, equity_change, ...)"));
-    feed.addOption(new Option("--since <ISO-datetime>", "Lower bound published_at (RFC3339)"));
-    feed.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
-    feed.addOption(new Option("--offset <n>", "Pagination offset").default("0"));
-    feed.action(async (opts) => {
-        if (!OPERATIONS["announcements.feed"]) {
-            emitVerbError("internal_error", "announcements.feed missing", undefined, 2);
-        }
-        const args = {
-            limit: clampInt(opts.limit, 1, 200, 50),
-            offset: Math.max(0, Math.floor(Number(opts.offset)) || 0),
-        };
-        if (opts.type)
-            args.type = opts.type;
-        if (opts.since)
-            args.since = opts.since;
-        await executeVerb(async (ctx) => announcementsFeedSpec.handler(args, ctx));
-    });
-    const stock = cmd.command("stock").description(announcementsStockSpec.description);
-    stock.addOption(new Option("--code <canonical_code>", "A-share canonical (e.g. SSE:600519)")
-        .makeOptionMandatory(true));
-    stock.addOption(new Option("--since-days <n>", "Lookback window in days (1-1825)").default("30"));
-    stock.addOption(new Option("--type <slug>", "Filter by 分类 slug"));
-    stock.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
-    stock.addOption(new Option("--offset <n>", "Pagination offset").default("0"));
-    stock.action(async (opts) => {
-        if (!OPERATIONS["announcements.stock"]) {
-            emitVerbError("internal_error", "announcements.stock missing", undefined, 2);
-        }
-        const args = {
-            code: opts.code,
-            since_days: clampInt(opts.sinceDays, 1, 1825, 30),
-            limit: clampInt(opts.limit, 1, 200, 50),
-            offset: Math.max(0, Math.floor(Number(opts.offset)) || 0),
-        };
-        if (opts.type)
-            args.type = opts.type;
-        await executeVerb(async (ctx) => announcementsStockSpec.handler(args, ctx));
-    });
-    const detail = cmd
-        .command("detail <announcement_id>")
-        .description(announcementsDetailSpec.description);
-    detail.action(async (announcementId) => {
-        if (!OPERATIONS["announcements.detail"]) {
-            emitVerbError("internal_error", "announcements.detail missing", undefined, 2);
-        }
-        await executeVerb(async (ctx) => announcementsDetailSpec.handler({ announcement_id: announcementId }, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/bars_batch.js

@@ -1,66 +0,0 @@
-/**
- * `echopai bars-batch` + MCP tool `bars_batch`.
- */
-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 CODE_RE = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
-export const barsBatchSpec = {
-    name: "bars_batch",
-    description: "Batch K-line for multiple A-share securities in one round-trip. Daily: ≤100 codes × ≤1yr; minute: ≤20 codes × ≤7d. Returns partial-success envelope {items, errors}.",
-    inputSchema: {
-        codes: z
-            .array(z.string().regex(CODE_RE))
-            .min(1)
-            .max(100)
-            .describe("Canonical codes (daily ≤100; minute ≤20)"),
-        from: z.string().regex(DATE_RE).describe("Inclusive start date YYYY-MM-DD"),
-        to: z.string().regex(DATE_RE).describe("Inclusive end date YYYY-MM-DD"),
-        minute: z
-            .boolean()
-            .optional()
-            .describe("Minute-level bars instead of daily (tighter caps apply)"),
-    },
-    handler: async (args, ctx) => {
-        const isMinute = Boolean(args.minute);
-        const cap = isMinute ? 20 : 100;
-        const codes = args.codes;
-        if (codes.length > cap) {
-            throw new Error(`codes count ${codes.length} exceeds cap ${cap} for ${isMinute ? "minute" : "daily"} bars_batch`);
-        }
-        const cliKey = isMinute ? "bars.minute-batch" : "bars.daily-batch";
-        const op = OPERATIONS[cliKey];
-        if (!op)
-            throw new Error(`${cliKey} op missing from codegen`);
-        return callOp(op, { codes, from: args.from, to: args.to }, ctx);
-    },
-    backingOps: ["bars.daily-batch", "bars.minute-batch"],
-};
-export function buildBarsBatchCommand() {
-    // CLI alias keeps the hyphenated form. MCP tool name uses underscore (MCP
-    // convention; underscores parse cleaner across hosts).
-    const cmd = new Command("bars-batch").description(barsBatchSpec.description);
-    cmd.addOption(new Option("--codes <csv>", "Canonical codes, comma-separated")
-        .makeOptionMandatory(true));
-    cmd.addOption(new Option("--from <date>", "Inclusive start YYYY-MM-DD").makeOptionMandatory(true));
-    cmd.addOption(new Option("--to <date>", "Inclusive end YYYY-MM-DD").makeOptionMandatory(true));
-    cmd.addOption(new Option("--minute", "Minute-level bars instead of daily"));
-    cmd.action(async (opts) => {
-        const codes = opts.codes.split(",").map((s) => s.trim()).filter(Boolean);
-        const isMinute = Boolean(opts.minute);
-        const cap = isMinute ? 20 : 100;
-        if (codes.length === 0 || codes.length > cap) {
-            emitVerbError("invalid_args", `codes count ${codes.length} out of range; expected 1-${cap} for ${isMinute ? "minute" : "daily"} bars-batch`, isMinute
-                ? "Daily mode (default) allows up to 100 codes; drop --minute or chunk the request."
-                : "Chunk the request into batches of ≤100 codes.", 1);
-        }
-        const args = { codes, from: opts.from, to: opts.to };
-        if (opts.minute)
-            args.minute = true;
-        await executeVerb(async (ctx) => barsBatchSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/chart.js

@@ -1,110 +0,0 @@
-/**
- * `echopai chart` + MCP tool `chart`.
- */
-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}$/;
-export const chartSpec = {
-    name: "chart",
-    description: "Single-security K-line (daily by default; set minute=true for intraday with a single date). For multi-code use `bars_batch` instead.",
-    inputSchema: {
-        code: z
-            .string()
-            .regex(/^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/)
-            .describe("Single canonical code (e.g. SSE:600519)"),
-        days: z
-            .number()
-            .int()
-            .min(1)
-            .max(365)
-            .default(30)
-            .describe("Daily lookback (ignored when from/to or minute mode are set)"),
-        from: z
-            .string()
-            .regex(DATE_RE)
-            .optional()
-            .describe("YYYY-MM-DD inclusive start (daily mode; overrides days)"),
-        to: z
-            .string()
-            .regex(DATE_RE)
-            .optional()
-            .describe("YYYY-MM-DD inclusive end (daily mode; overrides days)"),
-        minute: z.boolean().optional().describe("Switch to minute-level bars (requires date)"),
-        date: z.string().regex(DATE_RE).optional().describe("Single trade date YYYY-MM-DD (minute mode)"),
-    },
-    handler: async (args, ctx) => {
-        if (args.minute) {
-            if (!args.date) {
-                throw new Error("minute=true requires date (YYYY-MM-DD)");
-            }
-            const op = OPERATIONS["bars.minute"];
-            if (!op)
-                throw new Error("bars.minute op missing");
-            // bars.minute expects a single `date` (YYYY-MM-DD), not from/to —
-            // see stockpulse-rs MinuteBarsQuery + OpenAPI 2026-05-12 correction.
-            return callOp(op, { code: args.code, date: args.date }, ctx);
-        }
-        const op = OPERATIONS["bars.daily"];
-        if (!op)
-            throw new Error("bars.daily op missing");
-        const callArgs = { code: args.code };
-        if (args.from && args.to) {
-            callArgs.from = args.from;
-            callArgs.to = args.to;
-        }
-        else {
-            // bars.daily requires from/to (additionalProperties:false; no `days`).
-            // Derive a from/to window from --days client-side. Includes today;
-            // server skips non-trading days automatically.
-            const days = Math.max(1, Number(args.days ?? 30));
-            const to = new Date();
-            const from = new Date(to.getTime() - (days - 1) * 24 * 3600 * 1000);
-            const fmt = (d) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
-            callArgs.from = fmt(from);
-            callArgs.to = fmt(to);
-        }
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["bars.daily", "bars.minute"],
-};
-function clamp(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 buildChartCommand() {
-    const cmd = new Command(chartSpec.name).description(chartSpec.description);
-    cmd.addOption(new Option("--code <canonical_code>", "Single canonical code").makeOptionMandatory(true));
-    cmd.addOption(new Option("--days <n>", "Daily lookback (1-365, default 30)").default("30"));
-    cmd.addOption(new Option("--from <date>", "Inclusive start date YYYY-MM-DD (overrides --days)"));
-    cmd.addOption(new Option("--to <date>", "Inclusive end date YYYY-MM-DD (overrides --days)"));
-    cmd.addOption(new Option("--minute", "Switch to minute-level bars (requires --date)"));
-    cmd.addOption(new Option("--date <date>", "Single trade date YYYY-MM-DD (minute mode)"));
-    cmd.action(async (opts) => {
-        if (opts.minute && !opts.date) {
-            emitVerbError("invalid_args", "--minute requires --date YYYY-MM-DD (single trade date)", "Example: echopai chart --minute --code SSE:600519 --date 2026-05-09", 1);
-        }
-        const args = {
-            code: opts.code,
-            days: clamp(opts.days, 1, 365, 30),
-        };
-        if (opts.from)
-            args.from = opts.from;
-        if (opts.to)
-            args.to = opts.to;
-        if (opts.minute)
-            args.minute = true;
-        if (opts.date)
-            args.date = opts.date;
-        await executeVerb(async (ctx) => chartSpec.handler(args, ctx));
-    });
-    return cmd;
-}