@pasko70/pibo 1.9.7 → 1.9.9

package/dist/mcp/index.js

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

@@ -1,226 +0,0 @@
-/**
- * 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
-}