@zenalexa/unicli 0.210.0 → 0.211.2

package/dist/commands/mcp.js

@@ -1,15 +1,14 @@
 /**
  * MCP gateway CLI — wrapper around src/mcp/server.ts.
  *
- *   unicli mcp serve [--transport stdio|http] [--port 19826] [--lazy]
- *   unicli mcp health                       # list registered tools (no server)
+ *   unicli mcp serve [--transport stdio|http] [--port 19826] [--expanded]
+ *   unicli mcp health                       # pre-flight check (no server)
  *
  * `serve` shells out to the same `src/mcp/server.ts` entry point as
  * `npm run mcp` so the two paths share exactly one implementation.
  *
  * `health` is intentionally fast and offline: it loads adapters into the
- * registry and prints the same tool list the server would build, without
- * binding stdio or HTTP. Useful as a Claude Desktop / Cursor pre-flight.
+ * registry and prints a structured health report. Exit 0 if healthy, 1 if not.
  */
 import chalk from "chalk";
 import { spawn } from "node:child_process";
@@ -26,14 +25,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
  * stable relative position from this commands file.
  */
 function resolveServerEntry() {
-    // After build: __dirname is dist/commands → ../mcp/server.js
-    // In dev (tsx): __dirname is src/commands  → ../mcp/server.ts
     const candidateJs = join(__dirname, "..", "mcp", "server.js");
     const candidateTs = join(__dirname, "..", "mcp", "server.ts");
-    // Prefer TS if it exists (dev mode); otherwise JS.
-    // We can't easily statSync here without importing fs, but join + spawn will
-    // surface the error if neither exists. Use TS by default in dev.
-    // The simpler heuristic: if __dirname contains "/dist/", we're built.
     if (__dirname.includes("/dist/")) {
         return { kind: "js", path: candidateJs };
     }
@@ -48,16 +41,12 @@ export function registerMcpCommand(program) {
         .description("Start the MCP server (stdio default, --transport http for HTTP/JSON-RPC)")
         .option("--transport <kind>", "stdio or http", "stdio")
         .option("--port <n>", "Port for http transport", "19826")
-        .option("--lazy", "Register only list_adapters + run_command (compat mode)")
+        .option("--expanded", "Register one tool per adapter command (full catalog)")
         .action((opts) => {
         const entry = resolveServerEntry();
-        const args = [];
-        if (entry.kind === "ts")
-            args.unshift(entry.path);
-        else
-            args.unshift(entry.path);
-        if (opts.lazy)
-            args.push("--lazy");
+        const args = [entry.path];
+        if (opts.expanded)
+            args.push("--expanded");
         if (opts.transport) {
             args.push("--transport", opts.transport);
         }
@@ -81,55 +70,51 @@ export function registerMcpCommand(program) {
     });
     mcp
         .command("health")
-        .description("Pre-flight check — list tools the MCP server would expose")
-        .option("--json", "Output as JSON")
+        .description("Pre-flight check — verify adapters load and report tool counts")
+        .option("--json", "Output as JSON (default when piped)")
         .action(async (opts) => {
-        // Load adapters into the registry the same way the server does
-        loadAllAdapters();
-        await loadTsAdapters();
-        const adapters = getAllAdapters();
-        const commands = listCommands();
-        const tools = [
-            {
-                name: "list_adapters",
-                description: "List all Uni-CLI adapters and their commands",
-            },
-        ];
-        for (const adapter of adapters) {
-            for (const [cmdName, cmd] of Object.entries(adapter.commands)) {
-                const toolName = `unicli_${adapter.name}_${cmdName}`.replace(/[^a-zA-Z0-9_]/g, "_");
-                tools.push({
-                    name: toolName,
-                    description: cmd.description?.trim() ||
-                        adapter.description?.trim() ||
-                        `${cmdName} for ${adapter.name}`,
-                });
+        const useJson = opts.json || !process.stdout.isTTY;
+        try {
+            // Load adapters into the registry the same way the server does
+            loadAllAdapters();
+            await loadTsAdapters();
+            const adapters = getAllAdapters();
+            const commands = listCommands();
+            // Count expanded tools (1 per command + 3 default)
+            let expandedToolCount = 3; // unicli_run, unicli_list, unicli_discover
+            for (const adapter of adapters) {
+                expandedToolCount += Object.keys(adapter.commands).length;
             }
-        }
-        if (opts.json) {
-            console.log(JSON.stringify({
-                version: VERSION,
-                sites: adapters.length,
+            const health = {
+                status: "ok",
+                adapters: adapters.length,
                 commands: commands.length,
-                tools: tools.length,
-                entries: tools,
-            }, null, 2));
-            return;
-        }
-        console.log(chalk.bold(`unicli MCP gateway v${VERSION}`));
-        console.log(`  sites:    ${chalk.green(adapters.length)}`);
-        console.log(`  commands: ${chalk.green(commands.length)}`);
-        console.log(`  tools:    ${chalk.green(tools.length)} (1 core + ${commands.length} per-command)`);
-        console.log();
-        console.log(chalk.dim("Sample tools:"));
-        for (const t of tools.slice(0, 8)) {
-            console.log(`  ${chalk.cyan(t.name)}: ${t.description.slice(0, 60)}`);
+                tools: { default: 3, expanded: expandedToolCount },
+                version: VERSION,
+            };
+            if (useJson) {
+                console.log(JSON.stringify(health, null, 2));
+                return;
+            }
+            console.log(chalk.bold(`unicli MCP health v${VERSION}`));
+            console.log(`  status:   ${chalk.green("ok")}`);
+            console.log(`  adapters: ${chalk.green(adapters.length)}`);
+            console.log(`  commands: ${chalk.green(commands.length)}`);
+            console.log(`  tools:    ${chalk.green("3")} default, ${chalk.green(expandedToolCount)} expanded`);
+            console.log();
+            console.log(chalk.dim("Default tools: unicli_run, unicli_list, unicli_discover"));
+            console.log(chalk.dim("To start: unicli mcp serve [--expanded] [--transport http]"));
         }
-        if (tools.length > 8) {
-            console.log(chalk.dim(`  … and ${tools.length - 8} more`));
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (useJson) {
+                console.log(JSON.stringify({ status: "error", error: message, version: VERSION }, null, 2));
+            }
+            else {
+                console.error(chalk.red(`Health check failed: ${message}`));
+            }
+            process.exit(1);
         }
-        console.log();
-        console.log(chalk.dim("To start: unicli mcp serve [--transport http]"));
     });
 }
 //# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}

package/dist/commands/schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Schema command — output JSON Schema for adapter command input/output.
+ *
+ * Usage:
+ *   unicli schema <site> <command>   — Schema for a specific command
+ *   unicli schema --all              — Schema for ALL commands
+ *
+ * Output is always JSON, suitable for machine consumption.
+ */
+import { Command } from "commander";
+export declare function registerSchemaCommand(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkE5D"}

package/dist/commands/schema.js

@@ -0,0 +1,72 @@
+/**
+ * Schema command — output JSON Schema for adapter command input/output.
+ *
+ * Usage:
+ *   unicli schema <site> <command>   — Schema for a specific command
+ *   unicli schema --all              — Schema for ALL commands
+ *
+ * Output is always JSON, suitable for machine consumption.
+ */
+import chalk from "chalk";
+import { getAllAdapters, resolveCommand } from "../registry.js";
+import { ExitCode } from "../types.js";
+import { buildInputSchema, buildOutputSchema, } from "../mcp/schema.js";
+function buildCommandSchema(site, cmdName, cmd) {
+    return {
+        site,
+        command: cmdName,
+        description: cmd.description ?? "",
+        input: buildInputSchema(cmd),
+        output: buildOutputSchema(cmd, "flat"),
+    };
+}
+// ── Command registration ─────────────────────────────────────────────────
+export function registerSchemaCommand(program) {
+    program
+        .command("schema [site] [command]")
+        .description("Output JSON Schema for adapter command input/output")
+        .option("--all", "output schema for ALL commands")
+        .action((site, command, opts) => {
+        if (opts.all) {
+            // Schema for all commands
+            const schemas = [];
+            for (const adapter of getAllAdapters()) {
+                for (const [cmdName, cmd] of Object.entries(adapter.commands)) {
+                    schemas.push(buildCommandSchema(adapter.name, cmdName, cmd));
+                }
+            }
+            if (schemas.length === 0) {
+                console.error(chalk.red("No adapters loaded"));
+                process.exit(ExitCode.GENERIC_ERROR);
+            }
+            console.log(JSON.stringify(schemas, null, 2));
+            return;
+        }
+        if (!site || !command) {
+            console.error(chalk.red("Usage: unicli schema <site> <command>  or  unicli schema --all"));
+            process.exit(ExitCode.USAGE_ERROR);
+        }
+        const resolved = resolveCommand(site, command);
+        if (!resolved) {
+            // Try to suggest similar commands
+            const adapters = getAllAdapters();
+            const matching = adapters
+                .filter((a) => a.name.includes(site))
+                .map((a) => ({
+                site: a.name,
+                commands: Object.keys(a.commands),
+            }));
+            if (matching.length > 0) {
+                console.error(chalk.red(`Unknown command: ${site} ${command}`));
+                console.error(chalk.dim(`Available for matching sites: ${JSON.stringify(matching)}`));
+            }
+            else {
+                console.error(chalk.red(`Unknown site: ${site}`));
+            }
+            process.exit(ExitCode.USAGE_ERROR);
+        }
+        const schema = buildCommandSchema(site, command, resolved.command);
+        console.log(JSON.stringify(schema, null, 2));
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"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"}

package/dist/commands/search.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Search command — bilingual semantic search across all adapters.
+ *
+ * Usage:
+ *   unicli search "推特热门"           → finds twitter/trending
+ *   unicli search "download video"     → finds bilibili/download, youtube/download, ...
+ *   unicli search "股票行情"           → finds xueqiu/stock, eastmoney/stock, ...
+ *   unicli search --category finance   → lists all finance commands
+ */
+import { Command } from "commander";
+export declare function registerSearchCommand(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD5D"}

package/dist/commands/search.js

@@ -0,0 +1,47 @@
+/**
+ * Search command — bilingual semantic search across all adapters.
+ *
+ * Usage:
+ *   unicli search "推特热门"           → finds twitter/trending
+ *   unicli search "download video"     → finds bilibili/download, youtube/download, ...
+ *   unicli search "股票行情"           → finds xueqiu/stock, eastmoney/stock, ...
+ *   unicli search --category finance   → lists all finance commands
+ */
+import chalk from "chalk";
+import { search } from "../discovery/search.js";
+import { format, detectFormat } from "../output/formatter.js";
+export function registerSearchCommand(program) {
+    program
+        .command("search [query...]")
+        .description("Search commands by intent (bilingual). Example: unicli search 推特热门")
+        .option("-n, --limit <n>", "max results", "8")
+        .option("--category <cat>", "filter by category")
+        .action((queryParts, opts) => {
+        const query = queryParts.join(" ");
+        const limit = parseInt(opts.limit, 10) || 8;
+        if (!query && !opts.category) {
+            console.error(chalk.red("Usage: unicli search <query>  or  unicli search --category <cat>"));
+            process.exitCode = 2;
+            return;
+        }
+        const effectiveQuery = opts.category
+            ? `${opts.category} ${query}`.trim()
+            : query;
+        const results = search(effectiveQuery, limit);
+        if (results.length === 0) {
+            console.error(chalk.yellow(`No commands found for: ${effectiveQuery}`));
+            process.exitCode = 66; // EX_EMPTY
+            return;
+        }
+        const fmt = detectFormat(program.parent?.opts().format);
+        const rows = results.map((r) => ({
+            command: `${r.site} ${r.command}`,
+            description: r.description || `${r.command} for ${r.site}`,
+            score: r.score,
+            category: r.category,
+            usage: r.usage,
+        }));
+        console.log(format(rows, ["command", "description", "score", "usage"], fmt));
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CACV,oEAAoE,CACrE;SACA,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;SAChD,MAAM,CACL,CAAC,UAAoB,EAAE,IAA0C,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,kEAAkE,CACnE,CACF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ;YAClC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE;YACpC,CAAC,CAAC,KAAK,CAAC;QAEV,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAE9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,0BAA0B,cAAc,EAAE,CAAC,CACzD,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,WAAW;YAClC,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CACtB,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,MAAkC,CAC1D,CAAC;QAEF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE;YACjC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,EAAE;YAC1D,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAC;QAEJ,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAChE,CAAC;IACJ,CAAC,CACF,CAAC;AACN,CAAC"}

package/dist/discovery/aliases.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Bilingual alias table for command discovery.
+ *
+ * Three alias categories enable Chinese↔English search:
+ *   1. Site aliases — 推特→twitter, B站→bilibili
+ *   2. Action verbs — 搜索→[search, find], 下载→[download]
+ *   3. Domain terms — 股票→[stock, quote, finance]
+ *
+ * Used by the BM25 search engine to expand queries before scoring.
+ * Curated for quality over quantity — ~200 entries covering common
+ * agent intents across all supported categories.
+ */
+export declare const SITE_ALIASES: ReadonlyMap<string, string>;
+export declare const ACTION_ALIASES: ReadonlyMap<string, readonly string[]>;
+export declare const DOMAIN_ALIASES: ReadonlyMap<string, readonly string[]>;
+export declare const SITE_CATEGORIES: ReadonlyMap<string, string>;
+export declare const CATEGORY_ALIASES: ReadonlyMap<string, string>;
+/**
+ * Expand a single query token using all alias tables.
+ * Returns an array of canonical English terms.
+ */
+export declare function expandToken(token: string): string[];
+/**
+ * Tokenize a query string, handling both Chinese and English.
+ *
+ * Strategy: accumulate characters into segments by script type.
+ * Chinese chars form contiguous phrases that get sub-phrase expanded.
+ * English/Latin chars form words split by whitespace.
+ */
+export declare function tokenizeQuery(query: string): string[];
+//# sourceMappingURL=aliases.d.ts.map

package/dist/discovery/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/discovery/aliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAkEnD,CAAC;AAKH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAqEhE,CAAC;AAKH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAoFhE,CAAC;AAKH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAsJtD,CAAC;AAKH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CA4BvD,CAAC;AAIH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4DrD"}