@zenalexa/unicli 0.207.1

package/dist/mcp/server.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) stdio server for Uni-CLI.
+ *
+ * Lazy tool registration strategy:
+ *   - At startup, only two tools are registered: list_adapters + run_command
+ *   - run_command takes site + command as params, resolves the adapter dynamically
+ *   - This avoids registering 600+ tools upfront, keeping MCP handshake fast
+ *
+ * Protocol: JSON-RPC 2.0 over stdio (newline-delimited JSON)
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/mcp/server.js

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) stdio server for Uni-CLI.
+ *
+ * Lazy tool registration strategy:
+ *   - At startup, only two tools are registered: list_adapters + run_command
+ *   - run_command takes site + command as params, resolves the adapter dynamically
+ *   - This avoids registering 600+ tools upfront, keeping MCP handshake fast
+ *
+ * Protocol: JSON-RPC 2.0 over stdio (newline-delimited JSON)
+ */
+import { createInterface } from "node:readline";
+import { loadAllAdapters, loadTsAdapters } from "../discovery/loader.js";
+import { getAllAdapters, listCommands, resolveCommand } from "../registry.js";
+import { runPipeline } from "../engine/yaml-runner.js";
+import { VERSION } from "../constants.js";
+// ── Tool Definitions ────────────────────────────────────────────────────────
+function buildCoreTools() {
+    return [
+        {
+            name: "list_adapters",
+            description: "List all available Uni-CLI adapters and their commands. " +
+                "Use this to discover what sites and commands are available before calling run_command.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    site: {
+                        type: "string",
+                        description: "Filter by site name (optional, partial match)",
+                    },
+                    type: {
+                        type: "string",
+                        description: "Filter by adapter type: web-api, desktop, browser, bridge, service",
+                        enum: ["web-api", "desktop", "browser", "bridge", "service"],
+                    },
+                },
+            },
+        },
+        {
+            name: "run_command",
+            description: "Execute a Uni-CLI adapter command. Equivalent to running `unicli <site> <command>` on the CLI. " +
+                "Returns JSON results. Use list_adapters first to discover available commands.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    site: {
+                        type: "string",
+                        description: "The adapter site name (e.g. hackernews, github, bilibili)",
+                    },
+                    command: {
+                        type: "string",
+                        description: "The command to run (e.g. top, search, hot)",
+                    },
+                    args: {
+                        type: "object",
+                        description: 'Command arguments as key-value pairs (e.g. {"query": "ai", "limit": 10})',
+                        additionalProperties: true,
+                    },
+                },
+                required: ["site", "command"],
+            },
+        },
+    ];
+}
+// ── Tool Handlers ───────────────────────────────────────────────────────────
+function handleListAdapters(params) {
+    let commands = listCommands();
+    const site = params.site;
+    const type = params.type;
+    if (site) {
+        commands = commands.filter((c) => c.site.includes(site));
+    }
+    if (type) {
+        commands = commands.filter((c) => c.type === type);
+    }
+    const adapters = getAllAdapters();
+    const siteMap = new Map();
+    for (const cmd of commands) {
+        let entry = siteMap.get(cmd.site);
+        if (!entry) {
+            const adapter = adapters.find((a) => a.name === cmd.site);
+            entry = { type: adapter?.type ?? cmd.type, commands: [] };
+            siteMap.set(cmd.site, entry);
+        }
+        entry.commands.push({ name: cmd.command, description: cmd.description });
+    }
+    const result = Array.from(siteMap.entries()).map(([name, info]) => ({
+        site: name,
+        type: info.type,
+        commands: info.commands,
+    }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    total_sites: result.length,
+                    total_commands: commands.length,
+                    adapters: result,
+                }, null, 2),
+            },
+        ],
+    };
+}
+async function handleRunCommand(params) {
+    const site = params.site;
+    const command = params.command;
+    const args = params.args ?? {};
+    if (!site || !command) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: "site and command are required" }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const resolved = resolveCommand(site, command);
+    if (!resolved) {
+        // Provide helpful suggestion
+        const adapters = getAllAdapters();
+        const matchingSites = adapters
+            .filter((a) => a.name.includes(site))
+            .map((a) => ({
+            site: a.name,
+            commands: Object.keys(a.commands),
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `Unknown command: ${site} ${command}`,
+                        suggestion: matchingSites.length > 0
+                            ? `Did you mean one of these? ${JSON.stringify(matchingSites)}`
+                            : "Use list_adapters to see all available commands.",
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { adapter, command: cmd } = resolved;
+    // Merge default args
+    const mergedArgs = { limit: 20, ...args };
+    if (args.limit !== undefined) {
+        mergedArgs.limit =
+            typeof args.limit === "number"
+                ? args.limit
+                : parseInt(String(args.limit), 10) || 20;
+    }
+    try {
+        let results;
+        if (cmd.pipeline) {
+            results = await runPipeline(cmd.pipeline, mergedArgs, adapter.base, {
+                site: adapter.name,
+                strategy: adapter.strategy,
+            });
+        }
+        else if (cmd.func) {
+            const raw = await cmd.func(null, mergedArgs);
+            results = Array.isArray(raw) ? raw : [raw];
+        }
+        else {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "No pipeline or function defined for this command",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ count: results.length, results }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: message,
+                        adapter_path: `src/adapters/${adapter.name}/${command}.yaml`,
+                        suggestion: "The adapter may need updating. Check the YAML file.",
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+// ── MCP Protocol Handler ────────────────────────────────────────────────────
+const PROTOCOL_VERSION = "2024-11-05";
+const tools = buildCoreTools();
+function handleRequest(req) {
+    const id = req.id ?? null;
+    switch (req.method) {
+        case "initialize":
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    protocolVersion: PROTOCOL_VERSION,
+                    capabilities: {
+                        tools: {},
+                    },
+                    serverInfo: {
+                        name: "unicli",
+                        version: VERSION,
+                    },
+                },
+            };
+        case "notifications/initialized":
+            // Client acknowledgement — no response needed for notifications
+            return null;
+        case "tools/list":
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: { tools },
+            };
+        case "tools/call": {
+            const params = req.params;
+            if (!params?.name) {
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    error: { code: -32602, message: "Missing tool name" },
+                };
+            }
+            const toolArgs = params.arguments ?? {};
+            switch (params.name) {
+                case "list_adapters": {
+                    const result = handleListAdapters(toolArgs);
+                    return { jsonrpc: "2.0", id, result };
+                }
+                case "run_command":
+                    return handleRunCommand(toolArgs).then((result) => ({
+                        jsonrpc: "2.0",
+                        id,
+                        result,
+                    }));
+                default:
+                    return {
+                        jsonrpc: "2.0",
+                        id,
+                        error: {
+                            code: -32601,
+                            message: `Unknown tool: ${params.name}. Available tools: ${tools.map((t) => t.name).join(", ")}`,
+                        },
+                    };
+            }
+        }
+        case "ping":
+            return { jsonrpc: "2.0", id, result: {} };
+        default:
+            // Unknown method — return error for requests (has id), ignore notifications
+            if (id !== null && id !== undefined) {
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    error: { code: -32601, message: `Method not found: ${req.method}` },
+                };
+            }
+            return null;
+    }
+}
+// ── Stdio Transport ─────────────────────────────────────────────────────────
+function send(response) {
+    const json = JSON.stringify(response);
+    process.stdout.write(json + "\n");
+}
+async function main() {
+    // Load adapters (same as CLI)
+    loadAllAdapters();
+    await loadTsAdapters();
+    const rl = createInterface({
+        input: process.stdin,
+        terminal: false,
+    });
+    rl.on("line", async (line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let req;
+        try {
+            req = JSON.parse(trimmed);
+        }
+        catch {
+            send({
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: -32700, message: "Parse error" },
+            });
+            return;
+        }
+        try {
+            const response = await handleRequest(req);
+            if (response) {
+                send(response);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            send({
+                jsonrpc: "2.0",
+                id: req.id ?? null,
+                error: { code: -32603, message: `Internal error: ${message}` },
+            });
+        }
+    });
+    rl.on("close", () => {
+        process.exit(0);
+    });
+    // Log to stderr so it doesn't interfere with JSON-RPC on stdout
+    const adapterCount = getAllAdapters().length;
+    const commandCount = listCommands().length;
+    process.stderr.write(`unicli MCP server v${VERSION} — ${adapterCount} sites, ${commandCount} commands (2 tools registered)\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/output/formatter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Output formatter — renders command results in multiple formats.
+ *
+ * Formats: table (human), json (agent), yaml, csv, md
+ * Auto-detects piped output and switches to json for agent consumption.
+ */
+import type { OutputFormat } from "../types.js";
+export declare function format(data: unknown[], columns: string[] | undefined, fmt: OutputFormat): string;
+/** Auto-detect if output should be agent-optimized (piped stdout) */
+export declare function detectFormat(explicit?: OutputFormat): OutputFormat;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,YAAY,GAChB,MAAM,CAkBR;AAsED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,CAIlE"}

package/dist/output/formatter.js

@@ -0,0 +1,90 @@
+/**
+ * Output formatter — renders command results in multiple formats.
+ *
+ * Formats: table (human), json (agent), yaml, csv, md
+ * Auto-detects piped output and switches to json for agent consumption.
+ */
+import chalk from "chalk";
+import Table from "cli-table3";
+export function format(data, columns, fmt) {
+    if (!data || data.length === 0) {
+        return fmt === "json" ? "[]" : chalk.dim("No results");
+    }
+    switch (fmt) {
+        case "json":
+            return JSON.stringify(data, null, 2);
+        case "yaml":
+            return toYaml(data);
+        case "csv":
+            return toCsv(data, columns);
+        case "md":
+            return toMarkdown(data, columns);
+        case "table":
+        default:
+            return toTable(data, columns);
+    }
+}
+function toTable(data, columns) {
+    const rows = data;
+    const cols = columns ?? Object.keys(rows[0] ?? {});
+    const table = new Table({
+        head: cols.map((c) => chalk.bold.cyan(c)),
+        style: { head: [], border: [] },
+        wordWrap: true,
+    });
+    for (const row of rows) {
+        table.push(cols.map((c) => truncate(String(row[c] ?? ""), 60)));
+    }
+    return table.toString();
+}
+function toCsv(data, columns) {
+    const rows = data;
+    const cols = columns ?? Object.keys(rows[0] ?? {});
+    const header = cols.join(",");
+    const body = rows.map((r) => cols.map((c) => csvEscape(String(r[c] ?? ""))).join(","));
+    return [header, ...body].join("\n");
+}
+function toMarkdown(data, columns) {
+    const rows = data;
+    const cols = columns ?? Object.keys(rows[0] ?? {});
+    const header = `| ${cols.join(" | ")} |`;
+    const separator = `| ${cols.map(() => "---").join(" | ")} |`;
+    const body = rows.map((r) => `| ${cols.map((c) => String(r[c] ?? "")).join(" | ")} |`);
+    return [header, separator, ...body].join("\n");
+}
+function toYaml(data) {
+    return data
+        .map((item, i) => {
+        const obj = item;
+        const entries = Object.entries(obj)
+            .map(([k, v]) => `  ${k}: ${yamlValue(v)}`)
+            .join("\n");
+        return `- # ${i + 1}\n${entries}`;
+    })
+        .join("\n");
+}
+function yamlValue(v) {
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "string")
+        return v.includes(":") || v.includes("#") ? `"${v}"` : v;
+    return String(v);
+}
+function csvEscape(s) {
+    if (s.includes(",") || s.includes('"') || s.includes("\n")) {
+        return `"${s.replace(/"/g, '""')}"`;
+    }
+    return s;
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+/** Auto-detect if output should be agent-optimized (piped stdout) */
+export function detectFormat(explicit) {
+    if (explicit)
+        return explicit;
+    if (!process.stdout.isTTY)
+        return "json";
+    return "table";
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

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

package/dist/plugin/loader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Plugin Loader — discovers and loads third-party plugins from ~/.unicli/plugins/.
+ *
+ * Each plugin directory may contain a `unicli-plugin.json` manifest that declares:
+ *   - adapters directory (YAML adapters loaded via discovery/loader)
+ *   - steps directory (custom pipeline steps)
+ *   - main entry point (JS file executed at startup)
+ *
+ * Plugins without a manifest are treated as legacy adapter-only plugins and
+ * are loaded by the existing src/plugin.ts system.
+ */
+export interface PluginManifest {
+    name: string;
+    version: string;
+    unicli?: string;
+    description?: string;
+    adapters?: string;
+    steps?: string;
+    main?: string;
+}
+/**
+ * Discover and load all installed plugins that have a unicli-plugin.json manifest.
+ * Returns names of loaded plugins and any errors encountered.
+ */
+export declare function loadPlugins(): Promise<{
+    loaded: string[];
+    errors: string[];
+}>;
+/**
+ * List plugins that have a unicli-plugin.json manifest.
+ */
+export declare function listManifestPlugins(): PluginManifest[];
+/**
+ * Scaffold a new plugin directory with a unicli-plugin.json manifest.
+ * Returns the absolute path to the created directory.
+ */
+export declare function createPlugin(name: string, destDir?: string): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugin/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CA6DD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAmBtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BnE"}

package/dist/plugin/loader.js

@@ -0,0 +1,112 @@
+/**
+ * Plugin Loader — discovers and loads third-party plugins from ~/.unicli/plugins/.
+ *
+ * Each plugin directory may contain a `unicli-plugin.json` manifest that declares:
+ *   - adapters directory (YAML adapters loaded via discovery/loader)
+ *   - steps directory (custom pipeline steps)
+ *   - main entry point (JS file executed at startup)
+ *
+ * Plugins without a manifest are treated as legacy adapter-only plugins and
+ * are loaded by the existing src/plugin.ts system.
+ */
+import { readdirSync, readFileSync, existsSync, mkdirSync, writeFileSync, } from "node:fs";
+import { join, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+import { pathToFileURL } from "node:url";
+const PLUGINS_DIR = join(homedir(), ".unicli", "plugins");
+/**
+ * Discover and load all installed plugins that have a unicli-plugin.json manifest.
+ * Returns names of loaded plugins and any errors encountered.
+ */
+export async function loadPlugins() {
+    const loaded = [];
+    const errors = [];
+    if (!existsSync(PLUGINS_DIR))
+        return { loaded, errors };
+    const dirs = readdirSync(PLUGINS_DIR, { withFileTypes: true })
+        .filter((d) => d.isDirectory() || d.isSymbolicLink())
+        .map((d) => d.name);
+    for (const dir of dirs) {
+        const pluginDir = join(PLUGINS_DIR, dir);
+        const manifestPath = join(pluginDir, "unicli-plugin.json");
+        // Skip plugins without a manifest — they are handled by src/plugin.ts
+        if (!existsSync(manifestPath))
+            continue;
+        try {
+            const raw = readFileSync(manifestPath, "utf-8");
+            const manifest = JSON.parse(raw);
+            // Load adapters if the manifest declares an adapters directory
+            if (manifest.adapters) {
+                const adaptersDir = resolve(pluginDir, manifest.adapters);
+                // Guard against path traversal
+                if (!adaptersDir.startsWith(pluginDir + sep) &&
+                    adaptersDir !== pluginDir) {
+                    errors.push(`${dir}: adapters path escapes plugin directory`);
+                    continue;
+                }
+                if (existsSync(adaptersDir)) {
+                    const { loadAdaptersFromDir } = await import("../discovery/loader.js");
+                    loadAdaptersFromDir(adaptersDir);
+                }
+            }
+            // Load entry point if specified (registers hooks, steps, etc.)
+            if (manifest.main) {
+                const mainPath = resolve(pluginDir, manifest.main);
+                // Guard against path traversal
+                if (!mainPath.startsWith(pluginDir + sep) && mainPath !== pluginDir) {
+                    errors.push(`${dir}: main path escapes plugin directory`);
+                    continue;
+                }
+                if (existsSync(mainPath)) {
+                    await import(pathToFileURL(mainPath).href);
+                }
+            }
+            loaded.push(manifest.name);
+        }
+        catch (err) {
+            errors.push(`${dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return { loaded, errors };
+}
+/**
+ * List plugins that have a unicli-plugin.json manifest.
+ */
+export function listManifestPlugins() {
+    if (!existsSync(PLUGINS_DIR))
+        return [];
+    const plugins = [];
+    const dirs = readdirSync(PLUGINS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory() || d.isSymbolicLink());
+    for (const dir of dirs) {
+        const manifestPath = join(PLUGINS_DIR, dir.name, "unicli-plugin.json");
+        try {
+            const raw = readFileSync(manifestPath, "utf-8");
+            plugins.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip plugins without a valid manifest
+        }
+    }
+    return plugins;
+}
+/**
+ * Scaffold a new plugin directory with a unicli-plugin.json manifest.
+ * Returns the absolute path to the created directory.
+ */
+export function createPlugin(name, destDir) {
+    const dir = destDir ?? join(process.cwd(), `unicli-plugin-${name}`);
+    mkdirSync(join(dir, "adapters"), { recursive: true });
+    mkdirSync(join(dir, "steps"), { recursive: true });
+    const manifest = {
+        name,
+        version: "1.0.0",
+        unicli: ">=0.206.0",
+        description: `${name} plugin for Uni-CLI`,
+        adapters: "adapters/",
+        steps: "steps/",
+    };
+    writeFileSync(join(dir, "unicli-plugin.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+    writeFileSync(join(dir, "README.md"), `# unicli-plugin-${name}\n\nA Uni-CLI plugin.\n`, "utf-8");
+    return dir;
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugin/loader.js.map

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