echopai 2.2.0 → 2.4.0

package/dist/verbs/lookup.js

@@ -1,72 +0,0 @@
-/**
- * `echopai lookup --text <q> [--limit N]` + MCP tool `lookup`.
- *
- * Curated verb: 解析中文名 / 代码 / 拼音 → canonical_code 列表。Agent 几乎
- * 每个会话的第一步。底层调 raw OpenAPI op `semantic.find`。
- */
-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 function mapLookupResponse(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const item of raw) {
-        if (!item || typeof item !== "object")
-            continue;
-        const r = item;
-        if (typeof r.canonical_code !== "string")
-            continue;
-        out.push({
-            canonical_code: r.canonical_code,
-            name_cn: typeof r.name_cn === "string" ? r.name_cn : "",
-            ticker: typeof r.ticker === "string" ? r.ticker : "",
-            exchange: typeof r.exchange === "string" ? r.exchange : "",
-        });
-    }
-    return out;
-}
-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.",
-    inputSchema: {
-        text: z
-            .string()
-            .min(1)
-            .max(50)
-            .describe("Search text: Chinese name (贵州茅台), code (600519), or pinyin (gzmt)"),
-        limit: z.number().int().min(1).max(30).default(10).describe("Max matches (1-30)"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["semantic.find"];
-        if (!op)
-            throw new Error("semantic.find op missing from codegen");
-        const env = await callOp(op, { query: args.text, limit: args.limit }, ctx);
-        const matches = mapLookupResponse(env.data);
-        return { data: { matches, count: matches.length }, meta: env.meta };
-    },
-    backingOps: ["semantic.find"],
-};
-function clampLimit(raw, min = 1, max = 30) {
-    const n = Math.floor(Number(raw));
-    if (!Number.isFinite(n) || n < min)
-        return min;
-    if (n > max)
-        return max;
-    return n;
-}
-export function buildLookupCommand() {
-    const cmd = new Command(lookupSpec.name).description(lookupSpec.description);
-    cmd.addOption(new Option("--text <text>", "Search text (Chinese name / code / pinyin)")
-        .makeOptionMandatory(true));
-    cmd.addOption(new Option("--limit <n>", "Max matches (1-30)").default("10"));
-    cmd.action(async (opts) => {
-        if (!OPERATIONS["semantic.find"]) {
-            emitVerbError("internal_error", "semantic.find missing from codegen", undefined, 2);
-        }
-        await executeVerb(async (ctx) => lookupSpec.handler({ text: opts.text, limit: clampLimit(opts.limit) }, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/news.js

@@ -1,67 +0,0 @@
-/**
- * `echopai news ...` + MCP tool `news`.
- *
- * SUPPLEMENTARY breadth source (feedback_views_over_news.md).
- */
-import { Command, Option } from "commander";
-import { z } from "zod";
-import { OPERATIONS } from "../_generated/operations.js";
-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.",
-    inputSchema: {
-        query: z
-            .string()
-            .optional()
-            .describe("Free-text query (Chinese or English); omit for time-window feed"),
-        hours: z
-            .number()
-            .int()
-            .min(1)
-            .max(168)
-            .default(24)
-            .describe("Lookback window in hours (default 24 — much narrower than views)"),
-        limit: z.number().int().min(1).max(100).default(20).describe("Max items"),
-    },
-    handler: async (args, ctx) => {
-        if (args.query) {
-            const op = OPERATIONS["news.search"];
-            if (!op)
-                throw new Error("news.search op missing");
-            return callOp(op, { query: args.query, since_hours: args.hours, limit: args.limit }, ctx);
-        }
-        const op = OPERATIONS["news.feed"];
-        if (!op)
-            throw new Error("news.feed op missing");
-        return callOp(op, {}, ctx);
-    },
-    backingOps: ["news.search", "news.feed"],
-};
-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 buildNewsCommand() {
-    const cmd = new Command(newsSpec.name).description(newsSpec.description);
-    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"));
-    cmd.action(async (opts) => {
-        const args = {
-            hours: clamp(opts.hours, 1, 168, 24),
-            limit: clamp(opts.limit, 1, 100, 20),
-        };
-        if (opts.query)
-            args.query = opts.query;
-        await executeVerb(async (ctx) => newsSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/quote.js

@@ -1,53 +0,0 @@
-/**
- * `echopai quote --codes A,B,C` + MCP tool `quote`.
- */
-import { Command, Option } from "commander";
-import { z } from "zod";
-import { OPERATIONS } from "../_generated/operations.js";
-import { CallApiError } from "../runtime/errors.js";
-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.",
-    inputSchema: {
-        codes: z
-            .array(z.string().regex(/^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/))
-            .min(1)
-            .max(200)
-            .describe("Array of canonical codes (e.g. ['SSE:600519', 'SZSE:000001'])"),
-        include_l2: z
-            .boolean()
-            .optional()
-            .describe("Include L2 5-level order book (requires quote:l2 scope)"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["quote"];
-        if (!op)
-            throw new Error("quote op missing from codegen");
-        return callOp(op, args, ctx);
-    },
-    backingOps: ["quote"],
-};
-export function buildQuoteCommand() {
-    const cmd = new Command(quoteSpec.name).description(quoteSpec.description);
-    cmd.addOption(new Option("--codes <csv>", "Canonical codes, comma-separated (e.g. SSE:600519,SZSE:000001)")
-        .makeOptionMandatory(true));
-    cmd.addOption(new Option("--include-l2", "Include L2 order book (requires quote:l2 scope)"));
-    cmd.action(async (opts) => {
-        const codes = opts.codes.split(",").map((s) => s.trim()).filter(Boolean);
-        if (codes.length === 0 || codes.length > 200) {
-            emitVerbError("invalid_args", `codes count ${codes.length} out of range; expected 1-200`, "Use `echopai scan` for full-market snapshot (>200 codes).", 1);
-        }
-        if (!OPERATIONS["quote"]) {
-            emitVerbError("internal_error", "quote op missing from codegen", undefined, 2);
-        }
-        const args = { codes };
-        if (opts.includeL2)
-            args.include_l2 = true;
-        await executeVerb(async (ctx) => quoteSpec.handler(args, ctx));
-    });
-    return cmd;
-}
-// Re-export CallApiError so handler call sites have a typed throw signature.
-export { CallApiError };

package/dist/verbs/scan.js

@@ -1,42 +0,0 @@
-/**
- * `echopai scan` + MCP tool `scan`.
- */
-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 scanSpec = {
-    name: "scan",
-    description: "Full-market real-time quote scan (~5800 A-share securities in one round-trip). Use for universe discovery; agents should slim output with field/byte limits in their tool host or post-processing.",
-    inputSchema: {
-        exchange: z
-            .enum(["SSE", "SZSE", "BSE"])
-            .optional()
-            .describe("Filter by exchange (omit for all)"),
-    },
-    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;
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["quote.scan"],
-};
-export function buildScanCommand() {
-    const cmd = new Command(scanSpec.name).description(scanSpec.description);
-    cmd.addOption(new Option("--exchange <code>", "Filter by exchange").choices(["SSE", "SZSE", "BSE"]));
-    cmd.action(async (opts) => {
-        if (!OPERATIONS["quote.scan"]) {
-            emitVerbError("internal_error", "quote.scan missing", undefined, 2);
-        }
-        const args = {};
-        if (opts.exchange)
-            args.exchange = opts.exchange;
-        await executeVerb(async (ctx) => scanSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/search.js

@@ -1,105 +0,0 @@
-/**
- * `echopai search ...` + MCP tool `search`.
- *
- * HYBRID semantic search across news + analyst views.
- *
- * Use this verb when:
- *   - the user is exploring a THEME / 概念 ("锂电池", "芯片", "AI 算力") — pure
- *     vector + concept expansion brings out the full supply chain even when
- *     the query word never appears verbatim in the doc.
- *   - the user gives a non-canonical company name or analyst name — entity
- *     lane resolves it through securities / research_entities tables.
- *
- * Prefer this over `news` / `views` for open-ended discovery. For strict
- * time-window listing or filtered feed, keep using `views` / `news`.
- */
-import { Command, Option } from "commander";
-import { z } from "zod";
-import { OPERATIONS } from "../_generated/operations.js";
-import { executeVerb } from "../runtime/verb_cmd.js";
-import { callOp } from "../runtime/verb_runner.js";
-export const searchSpec = {
-    name: "search",
-    description: "HYBRID semantic search across analyst views + news (views weighted higher per feedback_views_over_news). Combines entity lookup (company codes, analyst names), pgvector kNN, trigram fuzzy and exact ILIKE; RRF-fused then reranked. Best for theme/concept queries: '锂电池' brings out 正极材料/碳酸锂/宁德时代; '芯片' brings out 存储芯片/洁净室/晶圆代工. Use `news` or `views` instead if you need strict time-window listing.",
-    inputSchema: {
-        q: z
-            .string()
-            .min(1)
-            .max(200)
-            .describe("Free-text query (Chinese or English)"),
-        type: z
-            .enum(["news", "views", "all"])
-            .default("all")
-            .describe("Search scope (views weighted higher in 'all')"),
-        mode: z
-            .enum(["hybrid", "exact"])
-            .default("hybrid")
-            .describe("hybrid = semantic + concept expansion + rerank; exact = ILIKE only"),
-        hours: z
-            .number()
-            .int()
-            .min(1)
-            .max(720)
-            .optional()
-            .describe("Lookback window in hours; omit for no time limit"),
-        limit: z
-            .number()
-            .int()
-            .min(1)
-            .max(50)
-            .default(20)
-            .describe("Max items returned"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["search.semantic"];
-        if (!op)
-            throw new Error("search.semantic op missing from codegen");
-        const callArgs = {
-            q: args.q,
-            type: args.type,
-            mode: args.mode,
-            limit: args.limit,
-        };
-        if (args.hours !== undefined)
-            callArgs.hours = args.hours;
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["search.semantic"],
-};
-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 buildSearchCommand() {
-    const cmd = new Command(searchSpec.name).description(searchSpec.description);
-    cmd.argument("<query...>", "Search query (Chinese or English)");
-    cmd.addOption(new Option("--type <scope>", "Search scope")
-        .choices(["news", "views", "all"])
-        .default("all"));
-    cmd.addOption(new Option("--mode <mode>", "hybrid | exact")
-        .choices(["hybrid", "exact"])
-        .default("hybrid"));
-    cmd.addOption(new Option("--exact", "shortcut for --mode exact"));
-    cmd.addOption(new Option("--hours <n>", "Lookback window (1-720 hours)"));
-    cmd.addOption(new Option("--limit <n>", "Max items (1-50)").default("20"));
-    cmd.action(async (queryTokens, opts) => {
-        const q = queryTokens.join(" ").trim();
-        const args = {
-            q,
-            type: opts.type,
-            mode: opts.exact ? "exact" : opts.mode,
-            limit: clamp(opts.limit, 1, 50, 20),
-        };
-        if (opts.hours !== undefined) {
-            args.hours = clamp(opts.hours, 1, 720, 24);
-        }
-        await executeVerb(async (ctx) => searchSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/sentiment.js

@@ -1,46 +0,0 @@
-/**
- * `echopai sentiment [--scope <universe>]` + MCP tool `sentiment`.
- */
-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 SCOPE_VALUES = [
-    "all_a",
-    "all_a_ex_st",
-    "main_board",
-    "star_market",
-    "chinext",
-    "bse",
-];
-export const sentimentSpec = {
-    name: "sentiment",
-    description: "Aggregate market sentiment indicators (limit-up/down counts, breadth, divergence index, top movers). Defaults to all_a_ex_st (all A-shares ex-ST).",
-    inputSchema: {
-        scope: z
-            .enum(SCOPE_VALUES)
-            .default("all_a_ex_st")
-            .describe("Universe filter"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["sentiment.overview"];
-        if (!op)
-            throw new Error("sentiment.overview op missing");
-        return callOp(op, { scope: args.scope }, ctx);
-    },
-    backingOps: ["sentiment.overview"],
-};
-export function buildSentimentCommand() {
-    const cmd = new Command(sentimentSpec.name).description(sentimentSpec.description);
-    cmd.addOption(new Option("--scope <universe>", "Universe filter")
-        .choices([...SCOPE_VALUES])
-        .default("all_a_ex_st"));
-    cmd.action(async (opts) => {
-        if (!OPERATIONS["sentiment.overview"]) {
-            emitVerbError("internal_error", "sentiment.overview missing", undefined, 2);
-        }
-        await executeVerb(async (ctx) => sentimentSpec.handler({ scope: opts.scope }, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/views.js

@@ -1,83 +0,0 @@
-/**
- * `echopai views ...` + MCP tool `views`.
- *
- * PRIMARY research source (feedback_views_over_news.md).
- */
-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 viewsSpec = {
-    name: "views",
-    description: "PRIMARY research source for stock judgement: analyst views / sell-side reports / long-form opinion stream, with research_entity_id attribution. Prefer this over `news` when forming an investment opinion.",
-    inputSchema: {
-        code: z
-            .string()
-            .regex(/^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/)
-            .optional()
-            .describe("Filter by security canonical_code (e.g. SSE:600519)"),
-        analyst: z.string().optional().describe("Analyst Chinese name (exact / fuzzy)"),
-        institution: z.string().optional().describe("Broker / institution Chinese name"),
-        since_days: z
-            .number()
-            .int()
-            .min(1)
-            .max(90)
-            .default(7)
-            .describe("Lookback window in days (research time-horizon is longer than news)"),
-        limit: z.number().int().min(1).max(100).default(30).describe("Max items"),
-    },
-    handler: async (args, ctx) => {
-        const op = OPERATIONS["views.recent"];
-        if (!op)
-            throw new Error("views.recent op missing from codegen");
-        const callArgs = {
-            since_days: args.since_days,
-            limit: args.limit,
-        };
-        if (args.code)
-            callArgs.security = args.code;
-        if (args.analyst)
-            callArgs.analyst = args.analyst;
-        if (args.institution)
-            callArgs.institution = args.institution;
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["views.recent"],
-};
-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 buildViewsCommand() {
-    const cmd = new Command(viewsSpec.name).description(viewsSpec.description);
-    cmd.addOption(new Option("--code <canonical_code>", "Filter by security canonical_code"));
-    cmd.addOption(new Option("--analyst <name>", "Analyst Chinese name (exact / fuzzy)"));
-    cmd.addOption(new Option("--institution <name>", "Broker / institution Chinese name"));
-    cmd.addOption(new Option("--since-days <n>", "Lookback window (1-90 days)").default("7"));
-    cmd.addOption(new Option("--limit <n>", "Max items (1-100)").default("30"));
-    cmd.action(async (opts) => {
-        if (!OPERATIONS["views.recent"]) {
-            emitVerbError("internal_error", "views.recent missing from codegen", undefined, 2);
-        }
-        const args = {
-            since_days: clamp(opts.sinceDays, 1, 90, 7),
-            limit: clamp(opts.limit, 1, 100, 30),
-        };
-        if (opts.code)
-            args.code = opts.code;
-        if (opts.analyst)
-            args.analyst = opts.analyst;
-        if (opts.institution)
-            args.institution = opts.institution;
-        await executeVerb(async (ctx) => viewsSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/version.js

@@ -1,5 +0,0 @@
-/**
- * Pinned at build time. Don't read package.json at runtime — adds startup latency
- * and breaks bundling.
- */
-export const CLI_VERSION = "2.2.0";