echopai 2.0.0

package/dist/verbs/scan.js

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

@@ -0,0 +1,46 @@
+/**
+ * `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

@@ -0,0 +1,83 @@
+/**
+ * `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 (use `research` verb to query hit-rate). 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

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "echopai",
+  "version": "2.0.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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evanzhangx/EchoPulse.git",
+    "directory": "cli"
+  },
+  "keywords": [
+    "echopai",
+    "stock-market",
+    "ai",
+    "agent",
+    "cli",
+    "openapi"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "echopai": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "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"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "commander": "^12.1.0",
+    "jmespath": "^0.16.0",
+    "smol-toml": "^1.4.2",
+    "undici": "^7.16.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/jmespath": "^0.15.2",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.9"
+  }
+}