echopai 2.0.0 → 2.2.0

package/dist/verbs/search.js

@@ -0,0 +1,105 @@
+/**
+ * `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/views.js

@@ -10,7 +10,7 @@ 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 (use `research` verb to query hit-rate). Prefer this over `news` when forming an investment opinion.",
+    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()

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echopai",
-  "version": "2.0.0",
+  "version": "2.2.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",

package/dist/verbs/research.js

@@ -1,44 +0,0 @@
-/**
- * `echopai research [--entity <id>]` + MCP tool `research`.
- *
- * Views quality signal layer.
- */
-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 researchSpec = {
-    name: "research",
-    description: "Research-entity performance — hit rate / coverage / avg excess return. Pair with `views` (which returns research_entity_id per row) to assess analyst quality. Omit entity_id for aggregate top-performers list.",
-    inputSchema: {
-        entity_id: z
-            .string()
-            .optional()
-            .describe("Specific research_entity_id; omit for aggregate top-performers list"),
-    },
-    handler: async (args, ctx) => {
-        if (args.entity_id) {
-            const op = OPERATIONS["research.entity-performance"];
-            if (!op)
-                throw new Error("research.entity-performance op missing");
-            return callOp(op, { entity_id: args.entity_id }, ctx);
-        }
-        const op = OPERATIONS["research.entity-performance-list"];
-        if (!op)
-            throw new Error("research.entity-performance-list op missing");
-        return callOp(op, {}, ctx);
-    },
-    backingOps: ["research.entity-performance-list", "research.entity-performance"],
-};
-export function buildResearchCommand() {
-    const cmd = new Command(researchSpec.name).description(researchSpec.description);
-    cmd.addOption(new Option("--entity <id>", "Specific research_entity_id; omit for aggregate list"));
-    cmd.action(async (opts) => {
-        const args = {};
-        if (opts.entity)
-            args.entity_id = opts.entity;
-        await executeVerb(async (ctx) => researchSpec.handler(args, ctx));
-    });
-    return cmd;
-}