@pasko70/pibo 1.9.9 → 1.9.10

package/dist/mcp/index.js

@@ -0,0 +1,431 @@
+/**
+ * MCP-CLI - A lightweight CLI for interacting with MCP servers
+ *
+ * Commands:
+ *   mcp-cli                         List all servers and tools
+ *   mcp-cli info <server>            Show server details
+ *   mcp-cli info <server> <tool>     Show tool schema
+ *   mcp-cli grep <pattern>           Search tools by glob pattern
+ *   mcp-cli call <server> <tool>     Call tool (reads JSON from stdin if no args)
+ *   mcp-cli call <server> <tool> {}  Call tool with JSON args
+ */
+import { readFileSync } from 'node:fs';
+import { configCommand } from './config-command.js';
+import { ensureConfigExists, } from './config.js';
+import { ErrorCode, ambiguousCommandError, formatCliError, missingArgumentError, tooManyArgumentsError, unknownOptionError, unknownSubcommandError, } from './errors.js';
+import { registryCommand } from './registry.js';
+import { VERSION } from './version.js';
+/**
+ * Known subcommands
+ */
+const SUBCOMMANDS = ['info', 'grep', 'call', 'config', 'registry'];
+/**
+ * Check if a string looks like a subcommand (not a server name)
+ */
+function isKnownSubcommand(arg) {
+    return SUBCOMMANDS.includes(arg);
+}
+/**
+ * Check if a string looks like it could be an unknown subcommand
+ * (common aliases that users might try)
+ */
+function isPossibleSubcommand(arg) {
+    const aliases = [
+        'run',
+        'execute',
+        'exec',
+        'invoke',
+        'list',
+        'ls',
+        'get',
+        'show',
+        'describe',
+        'search',
+        'find',
+        'query',
+    ];
+    return aliases.includes(arg.toLowerCase());
+}
+/**
+ * Parse server/tool from either "server/tool" or "server tool" format
+ */
+function parseServerTool(args) {
+    if (args.length === 0) {
+        return { server: '' };
+    }
+    const first = args[0];
+    // Check for slash format: server/tool
+    if (first.includes('/')) {
+        const slashIndex = first.indexOf('/');
+        return {
+            server: first.substring(0, slashIndex),
+            tool: first.substring(slashIndex + 1) || undefined,
+        };
+    }
+    // Space format: server tool
+    return {
+        server: first,
+        tool: args[1],
+    };
+}
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args) {
+    const result = {
+        command: 'info',
+        withDescriptions: false,
+        registryRunSetup: true,
+    };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '-h':
+            case '--help':
+                result.command = 'help';
+                return result;
+            case '-v':
+            case '--version':
+                result.command = 'version';
+                return result;
+            case '-d':
+            case '--with-descriptions':
+                result.withDescriptions = true;
+                break;
+            case '-c':
+            case '--config':
+                result.configPath = args[++i];
+                if (!result.configPath) {
+                    console.error(formatCliError(missingArgumentError('-c/--config', 'path')));
+                    process.exit(ErrorCode.CLIENT_ERROR);
+                }
+                break;
+            case '--no-setup':
+            case '--skip-setup':
+                result.registryRunSetup = false;
+                break;
+            default:
+                // Single '-' is allowed (stdin indicator), but other dash-prefixed args are options
+                if (arg.startsWith('-') && arg !== '-') {
+                    console.error(formatCliError(unknownOptionError(arg)));
+                    process.exit(ErrorCode.CLIENT_ERROR);
+                }
+                positional.push(arg);
+        }
+    }
+    // No positional args = list all servers
+    if (positional.length === 0) {
+        result.command = 'list';
+        return result;
+    }
+    const firstArg = positional[0];
+    // =========================================================================
+    // Explicit subcommand routing
+    // =========================================================================
+    if (firstArg === 'info') {
+        result.command = 'info';
+        const remaining = positional.slice(1);
+        const { server, tool } = parseServerTool(remaining);
+        // info requires a server argument - show available servers in error
+        if (!server) {
+            // Try to load config synchronously to show available servers
+            let availableServers = [];
+            const configPaths = [
+                result.configPath,
+                process.env.MCP_CONFIG_PATH,
+                './mcp_servers.json',
+                `${process.env.HOME}/.mcp_servers.json`,
+                `${process.env.HOME}/.config/mcp/mcp_servers.json`,
+            ].filter(Boolean);
+            for (const cfgPath of configPaths) {
+                try {
+                    const content = readFileSync(cfgPath, 'utf-8');
+                    const config = JSON.parse(content);
+                    if (config.mcpServers) {
+                        availableServers = Object.keys(config.mcpServers);
+                        break;
+                    }
+                }
+                catch {
+                    // Try next path
+                }
+            }
+            const serverList = availableServers.length > 0
+                ? availableServers.join(', ')
+                : '(none found)';
+            console.error('Error [MISSING_ARGUMENT]: Missing required argument for info: server');
+            console.error(`  Available servers: ${serverList}`);
+            console.error(`  Suggestion: Use 'pibo mcp info <server>' to see server details, or just 'pibo mcp' to list all`);
+            process.exit(ErrorCode.CLIENT_ERROR);
+        }
+        result.server = server;
+        result.tool = tool;
+        return result;
+    }
+    if (firstArg === 'config') {
+        const action = positional[1] ?? 'help';
+        result.command = 'config';
+        switch (action) {
+            case 'help':
+            case 'schema':
+            case 'paths':
+            case 'init':
+            case 'path':
+            case 'show':
+                result.configAction = action;
+                return result;
+            case 'add':
+                result.configAction = 'add';
+                result.configName = positional[2];
+                result.configJson = positional.slice(3).join(' ') || undefined;
+                return result;
+            case 'remove':
+            case 'rm':
+                result.configAction = 'remove';
+                result.configName = positional[2];
+                return result;
+            case 'describe':
+                result.configAction = 'describe';
+                result.configName = positional[2];
+                result.configJson = positional.slice(3).join(' ') || undefined;
+                return result;
+            default:
+                console.error(formatCliError(unknownSubcommandError(`config ${action}`)));
+                process.exit(ErrorCode.CLIENT_ERROR);
+        }
+    }
+    if (firstArg === 'registry') {
+        const action = positional[1] ?? 'help';
+        result.command = 'registry';
+        switch (action) {
+            case 'help':
+            case 'list':
+                result.registryAction = action;
+                return result;
+            case 'show':
+            case 'install':
+            case 'doctor':
+            case 'remove':
+            case 'rm':
+                result.registryAction = action === 'rm' ? 'remove' : action;
+                result.registryName = positional[2];
+                return result;
+            default:
+                console.error(formatCliError(unknownSubcommandError(`registry ${action}`)));
+                process.exit(ErrorCode.CLIENT_ERROR);
+        }
+    }
+    if (firstArg === 'grep') {
+        result.command = 'grep';
+        result.pattern = positional[1];
+        if (!result.pattern) {
+            console.error(formatCliError(missingArgumentError('grep', 'pattern')));
+            process.exit(ErrorCode.CLIENT_ERROR);
+        }
+        if (positional.length > 2) {
+            console.error(formatCliError(tooManyArgumentsError('grep', positional.length - 1, 1)));
+            process.exit(ErrorCode.CLIENT_ERROR);
+        }
+        return result;
+    }
+    if (firstArg === 'call') {
+        result.command = 'call';
+        const remaining = positional.slice(1);
+        if (remaining.length === 0) {
+            console.error(formatCliError(missingArgumentError('call', 'server and tool')));
+            process.exit(ErrorCode.CLIENT_ERROR);
+        }
+        // Parse server/tool from remaining args
+        const { server, tool } = parseServerTool(remaining);
+        result.server = server;
+        if (!tool) {
+            // Check if it was slash format without tool
+            if (remaining[0].includes('/') && !remaining[0].split('/')[1]) {
+                console.error(formatCliError(missingArgumentError('call', 'tool')));
+                process.exit(ErrorCode.CLIENT_ERROR);
+            }
+            // Space format with only server
+            if (remaining.length < 2) {
+                console.error(formatCliError(missingArgumentError('call', 'tool')));
+                process.exit(ErrorCode.CLIENT_ERROR);
+            }
+        }
+        result.tool = tool;
+        // Determine where args start
+        let argsStartIndex;
+        if (remaining[0].includes('/')) {
+            // slash format: call server/tool '{}' → args at index 1
+            argsStartIndex = 1;
+        }
+        else {
+            // space format: call server tool '{}' → args at index 2
+            argsStartIndex = 2;
+        }
+        // Collect remaining args as JSON (support '-' for stdin)
+        const jsonArgs = remaining.slice(argsStartIndex);
+        if (jsonArgs.length > 0) {
+            const argsValue = jsonArgs.join(' ');
+            result.args = argsValue === '-' ? undefined : argsValue;
+        }
+        return result;
+    }
+    // =========================================================================
+    // Check for unknown subcommand (common aliases)
+    // =========================================================================
+    if (isPossibleSubcommand(firstArg)) {
+        console.error(formatCliError(unknownSubcommandError(firstArg)));
+        process.exit(ErrorCode.CLIENT_ERROR);
+    }
+    // =========================================================================
+    // Slash format without subcommand → error (require explicit subcommand)
+    // =========================================================================
+    if (firstArg.includes('/')) {
+        const parts = firstArg.split('/');
+        const serverName = parts[0];
+        const toolName = parts[1] || '';
+        const hasArgs = positional.length > 1;
+        console.error(formatCliError(ambiguousCommandError(serverName, toolName, hasArgs)));
+        process.exit(ErrorCode.CLIENT_ERROR);
+    }
+    // =========================================================================
+    // Ambiguous command detection: server tool without subcommand
+    // =========================================================================
+    if (positional.length >= 2) {
+        const serverName = positional[0];
+        const possibleTool = positional[1];
+        // Check if second arg looks like a tool name (not JSON)
+        const looksLikeJson = possibleTool.startsWith('{') || possibleTool.startsWith('[');
+        const looksLikeToolName = /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(possibleTool);
+        if (!looksLikeJson && looksLikeToolName) {
+            const hasArgs = positional.length > 2;
+            console.error(formatCliError(ambiguousCommandError(serverName, possibleTool, hasArgs)));
+            process.exit(ErrorCode.CLIENT_ERROR);
+        }
+    }
+    // =========================================================================
+    // Default: single server name → info
+    // =========================================================================
+    result.command = 'info';
+    result.server = firstArg;
+    return result;
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+pibo mcp (mcp-cli v${VERSION}) - A lightweight CLI for MCP servers
+
+Commands:
+  pibo mcp                                      List configured servers and tools
+  pibo mcp info <server>                       Show server tools
+  pibo mcp info <server> <tool>                Show one tool schema
+  pibo mcp grep <pattern>                      Search tool names
+  pibo mcp call <server> <tool> [json]         Call one tool
+  pibo mcp config                              Discover config commands
+  pibo mcp registry                            Discover curated server presets
+
+Options:
+  -v, --version            Show version number
+  -d, --with-descriptions  Show full tool descriptions (default: first 100 chars)
+  -c, --config <path>      Path to mcp_servers.json config file
+  --no-setup               Skip registry setup commands during install
+
+Next:
+  pibo mcp config help
+  pibo mcp registry help
+`);
+}
+/**
+ * Build target string from server and tool
+ */
+function buildTarget(server, tool) {
+    if (!server)
+        return '';
+    if (!tool)
+        return server;
+    return `${server}/${tool}`;
+}
+/**
+ * Main entry point
+ */
+export async function runMcpCli(argv = process.argv) {
+    try {
+        const args = parseArgs(argv.slice(2));
+        switch (args.command) {
+            case 'help':
+                printHelp();
+                break;
+            case 'version':
+                console.log(`pibo mcp (mcp-cli v${VERSION})`);
+                break;
+            case 'list':
+                await ensureConfigExists(args.configPath);
+                {
+                    const { listCommand } = await import('./commands/list.js');
+                    await listCommand({
+                        withDescriptions: args.withDescriptions,
+                        configPath: args.configPath,
+                    });
+                }
+                break;
+            case 'info':
+                await ensureConfigExists(args.configPath);
+                {
+                    const { infoCommand } = await import('./commands/info.js');
+                    // info always has a server (validated in parseArgs)
+                    await infoCommand({
+                        target: buildTarget(args.server, args.tool),
+                        withDescriptions: args.withDescriptions,
+                        configPath: args.configPath,
+                    });
+                }
+                break;
+            case 'grep':
+                await ensureConfigExists(args.configPath);
+                {
+                    const { grepCommand } = await import('./commands/grep.js');
+                    await grepCommand({
+                        pattern: args.pattern ?? '',
+                        withDescriptions: args.withDescriptions,
+                        configPath: args.configPath,
+                    });
+                }
+                break;
+            case 'call':
+                await ensureConfigExists(args.configPath);
+                {
+                    const { callCommand } = await import('./commands/call.js');
+                    await callCommand({
+                        target: buildTarget(args.server, args.tool),
+                        args: args.args,
+                        configPath: args.configPath,
+                    });
+                }
+                break;
+            case 'config':
+                await configCommand({
+                    action: args.configAction ?? 'help',
+                    name: args.configName,
+                    serverJson: args.configJson,
+                    description: args.configJson,
+                    configPath: args.configPath,
+                });
+                break;
+            case 'registry':
+                await registryCommand({
+                    action: args.registryAction ?? 'help',
+                    name: args.registryName,
+                    configPath: args.configPath,
+                    runSetup: args.registryRunSetup,
+                });
+                break;
+        }
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exitCode = ErrorCode.CLIENT_ERROR;
+    }
+}
+export { VERSION as MCP_CLI_VERSION } from './version.js';

package/dist/mcp/output.js

@@ -0,0 +1,226 @@
+/**
+ * Output formatting utilities
+ */
+import { isHttpServer } from './config.js';
+// ANSI color codes
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+};
+/**
+ * Check if output should be colorized
+ */
+function shouldColorize() {
+    return process.stdout.isTTY && !process.env.NO_COLOR;
+}
+/**
+ * Apply color if terminal supports it
+ */
+function color(text, colorCode) {
+    if (!shouldColorize())
+        return text;
+    return `${colorCode}${text}${colors.reset}`;
+}
+/**
+ * Default character budget for truncated tool descriptions in compact views.
+ * Single-line summaries stay readable while keeping server overviews short.
+ */
+export const TOOL_DESCRIPTION_TRUNCATE_LENGTH = 100;
+/**
+ * Return a compact, single-line summary of a tool description.
+ *
+ * - Prefers the first paragraph (text before a blank line or line break).
+ * - Truncates at `maxLength` characters with an ellipsis suffix when needed.
+ * - Returns undefined when there is no description to summarize.
+ */
+export function truncateToolDescription(description, maxLength = TOOL_DESCRIPTION_TRUNCATE_LENGTH) {
+    if (!description)
+        return undefined;
+    // Collapse whitespace so newlines and runs of spaces become single spaces.
+    const normalized = description.replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return undefined;
+    if (normalized.length <= maxLength)
+        return normalized;
+    return `${normalized.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
+}
+/**
+ * Return an info-view summary without generated OpenAPI error-response noise.
+ */
+export function summarizeToolDescriptionForInfo(description) {
+    if (!description)
+        return undefined;
+    const withoutErrorResponses = description
+        .replace(/\s*Error Responses:\s*[\s\S]*$/i, '')
+        .trim();
+    return truncateToolDescription(withoutErrorResponses);
+}
+/**
+ * Format server list for display
+ */
+export function formatServerList(servers, withDescriptions) {
+    const lines = [];
+    for (const server of servers) {
+        lines.push(color(server.name, colors.bold + colors.cyan));
+        // Show instructions if available (first line only in list view, or all if short)
+        if (server.instructions) {
+            const instructionLines = server.instructions.split('\n');
+            const firstLine = instructionLines[0].slice(0, 100);
+            const suffix = instructionLines.length > 1 || instructionLines[0].length > 100
+                ? '...'
+                : '';
+            lines.push(`  ${color(`Instructions: ${firstLine}${suffix}`, colors.dim)}`);
+        }
+        for (const tool of server.tools) {
+            // Always try to show a short summary so agents can pick a tool without -d.
+            const summary = withDescriptions
+                ? tool.description
+                : truncateToolDescription(tool.description);
+            if (summary) {
+                lines.push(`  • ${tool.name} - ${color(summary, colors.dim)}`);
+            }
+            else {
+                lines.push(`  • ${tool.name}`);
+            }
+        }
+        lines.push(''); // Empty line between servers
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Format search results
+ */
+export function formatSearchResults(results, withDescriptions) {
+    const lines = [];
+    for (const result of results) {
+        const server = color(result.server, colors.cyan);
+        const tool = color(result.tool.name, colors.green);
+        // Always show a short summary so agents can decide without -d; full text on -d.
+        const summary = withDescriptions
+            ? result.tool.description
+            : truncateToolDescription(result.tool.description);
+        if (summary) {
+            lines.push(`${server} ${tool} ${color(summary, colors.dim)}`);
+        }
+        else {
+            lines.push(`${server} ${tool}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format server details
+ */
+export function formatServerDetails(serverName, config, tools, withDescriptions = false, instructions) {
+    const lines = [];
+    lines.push(`${color('Server:', colors.bold)} ${color(serverName, colors.cyan)}`);
+    if (isHttpServer(config)) {
+        lines.push(`${color('Transport:', colors.bold)} HTTP`);
+        lines.push(`${color('URL:', colors.bold)} ${config.url}`);
+    }
+    else {
+        lines.push(`${color('Transport:', colors.bold)} stdio`);
+        lines.push(`${color('Command:', colors.bold)} ${config.command} ${(config.args || []).join(' ')}`);
+    }
+    // Surface the agent-facing Pibo description so it is visible without -d.
+    const piboDescription = config.pibo?.description?.trim();
+    if (piboDescription) {
+        lines.push('');
+        lines.push(`${color('Description:', colors.bold)}`);
+        lines.push(`  ${piboDescription}`);
+    }
+    if (instructions) {
+        lines.push('');
+        lines.push(`${color('Instructions:', colors.bold)}`);
+        // Indent multi-line instructions
+        const indentedInstructions = instructions
+            .split('\n')
+            .map((line) => `  ${line}`)
+            .join('\n');
+        lines.push(indentedInstructions);
+    }
+    lines.push('');
+    lines.push(`${color(`Tools (${tools.length}):`, colors.bold)}`);
+    for (const tool of tools) {
+        lines.push(`  ${color(tool.name, colors.green)}`);
+        const toolSummary = withDescriptions
+            ? tool.description
+            : summarizeToolDescriptionForInfo(tool.description);
+        if (toolSummary) {
+            lines.push(`    ${color(toolSummary, colors.dim)}`);
+        }
+        // Show parameters from schema
+        const schema = tool.inputSchema;
+        const parameters = Object.entries(schema.properties ?? {});
+        lines.push(`    ${color('Parameters:', colors.yellow)}`);
+        if (parameters.length === 0) {
+            lines.push(`      ${color('No parameters', colors.dim)}`);
+        }
+        else {
+            for (const [name, prop] of parameters) {
+                const required = schema.required?.includes(name)
+                    ? 'required'
+                    : 'optional';
+                const type = prop.type || 'any';
+                const desc = withDescriptions && prop.description ? ` - ${prop.description}` : '';
+                lines.push(`      • ${name} (${type}, ${required})${desc}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Format tool schema
+ */
+export function formatToolSchema(serverName, tool) {
+    const lines = [];
+    lines.push(`${color('Tool:', colors.bold)} ${color(tool.name, colors.green)}`);
+    lines.push(`${color('Server:', colors.bold)} ${color(serverName, colors.cyan)}`);
+    lines.push('');
+    if (tool.description) {
+        lines.push(`${color('Description:', colors.bold)}`);
+        lines.push(`  ${tool.description}`);
+        lines.push('');
+    }
+    lines.push(`${color('Input Schema:', colors.bold)}`);
+    lines.push(JSON.stringify(tool.inputSchema, null, 2));
+    return lines.join('\n');
+}
+/**
+ * Format tool call result
+ */
+export function formatToolResult(result) {
+    if (typeof result === 'object' && result !== null) {
+        const r = result;
+        // Handle MCP tool result format
+        if (r.content && Array.isArray(r.content)) {
+            const textParts = r.content
+                .filter((c) => c.type === 'text' && c.text)
+                .map((c) => c.text);
+            if (textParts.length > 0) {
+                return textParts.join('\n');
+            }
+        }
+    }
+    // Fallback to JSON
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Format as JSON
+ */
+export function formatJson(data) {
+    return JSON.stringify(data, null, 2);
+}
+/**
+ * Format error message
+ */
+export function formatError(message) {
+    return color(`Error: ${message}`, '\x1b[31m'); // Red
+}