@nordsym/apiclaw 1.5.17 → 1.5.19

package/dist/src/cli/commands/doctor.js

@@ -1,324 +0,0 @@
-/**
- * Doctor Command
- * Health check for APIClaw installation and MCP client configurations
- */
-import { existsSync } from 'fs';
-import { execSync } from 'child_process';
-import { getAllClients, getClientConfig } from '../../utils/paths.js';
-import { readConfig, hasApiclawConfig } from '../../utils/config.js';
-import { getApiUrl, readEnvConfig, ENV_VARS } from '../../enterprise/env.js';
-/**
- * Check Node.js availability and version
- */
-function checkNode() {
-    try {
-        const version = execSync('node --version', { encoding: 'utf-8' }).trim();
-        const major = parseInt(version.replace('v', '').split('.')[0], 10);
-        if (major < 18) {
-            return {
-                category: 'System',
-                name: 'Node.js',
-                status: 'warn',
-                message: `${version} (recommend v18+)`,
-            };
-        }
-        return {
-            category: 'System',
-            name: 'Node.js',
-            status: 'pass',
-            message: version,
-        };
-    }
-    catch {
-        return {
-            category: 'System',
-            name: 'Node.js',
-            status: 'fail',
-            message: 'Not found',
-            details: 'Node.js is required. Install from https://nodejs.org',
-        };
-    }
-}
-/**
- * Check npm availability
- */
-function checkNpm() {
-    try {
-        const version = execSync('npm --version', { encoding: 'utf-8' }).trim();
-        return {
-            category: 'System',
-            name: 'npm',
-            status: 'pass',
-            message: `v${version}`,
-        };
-    }
-    catch {
-        return {
-            category: 'System',
-            name: 'npm',
-            status: 'fail',
-            message: 'Not found',
-            details: 'npm is required for npx to work',
-        };
-    }
-}
-/**
- * Check npx availability
- */
-function checkNpx() {
-    try {
-        execSync('npx --version', { encoding: 'utf-8', stdio: 'pipe' });
-        return {
-            category: 'System',
-            name: 'npx',
-            status: 'pass',
-            message: 'Available',
-        };
-    }
-    catch {
-        return {
-            category: 'System',
-            name: 'npx',
-            status: 'fail',
-            message: 'Not found',
-            details: 'npx is required for MCP server execution',
-        };
-    }
-}
-/**
- * Check MCP client configuration
- */
-function checkClient(client, serverName = 'apiclaw') {
-    const config = getClientConfig(client);
-    const configPath = config.configPath;
-    // Check if config file exists
-    if (!existsSync(configPath)) {
-        // Check if config directory exists (client might be installed but not configured)
-        const dirExists = existsSync(config.configDir);
-        if (dirExists) {
-            return {
-                category: 'MCP Clients',
-                name: config.displayName,
-                status: 'warn',
-                message: 'Installed but not configured',
-                details: `Config file: ${configPath}`,
-            };
-        }
-        return {
-            category: 'MCP Clients',
-            name: config.displayName,
-            status: 'skip',
-            message: 'Not installed',
-        };
-    }
-    // Read and check config
-    const readResult = readConfig(configPath);
-    if (!readResult.success) {
-        return {
-            category: 'MCP Clients',
-            name: config.displayName,
-            status: 'fail',
-            message: 'Invalid config',
-            details: readResult.error,
-        };
-    }
-    // Check if APIClaw is configured
-    if (readResult.config && hasApiclawConfig(readResult.config, serverName)) {
-        return {
-            category: 'MCP Clients',
-            name: config.displayName,
-            status: 'pass',
-            message: 'Configured',
-        };
-    }
-    return {
-        category: 'MCP Clients',
-        name: config.displayName,
-        status: 'warn',
-        message: 'APIClaw not configured',
-        details: `Run: npx @nordsym/apiclaw setup --client ${client}`,
-    };
-}
-/**
- * Check API connectivity
- */
-async function checkConnectivity() {
-    const apiUrl = getApiUrl();
-    const convexUrl = process.env.CONVEX_URL || 'https://brilliant-puffin-712.eu-west-1.convex.cloud';
-    const candidates = [
-        `${apiUrl}/health`,
-        'https://apiclaw.nordsym.com',
-        `${convexUrl.replace('.cloud', '.site')}/workspace/poll`,
-    ];
-    const failures = [];
-    for (const testUrl of candidates) {
-        try {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), 5000);
-            const response = await fetch(testUrl, {
-                method: 'GET',
-                signal: controller.signal,
-            });
-            clearTimeout(timeout);
-            // Any HTTP response proves network + host reachability.
-            if (response.ok) {
-                return {
-                    category: 'Connectivity',
-                    name: 'API Server',
-                    status: 'pass',
-                    message: `${testUrl} reachable`,
-                };
-            }
-            if (testUrl.includes('/workspace/poll') && response.status === 400) {
-                return {
-                    category: 'Connectivity',
-                    name: 'API Server',
-                    status: 'pass',
-                    message: `${testUrl} reachable (auth endpoint responding)`,
-                };
-            }
-            failures.push(`${testUrl} -> HTTP ${response.status}`);
-        }
-        catch (error) {
-            const reason = error instanceof Error ? error.message : 'Unknown error';
-            failures.push(`${testUrl} -> ${reason}`);
-        }
-    }
-    return {
-        category: 'Connectivity',
-        name: 'API Server',
-        status: 'skip',
-        message: 'Could not reach API (offline or DNS/TLS issue?)',
-        details: failures.join(' | '),
-    };
-}
-/**
- * Check environment variables
- */
-function checkEnvVars() {
-    const envConfig = readEnvConfig();
-    const results = [];
-    if (envConfig.workspace) {
-        results.push({
-            category: 'Environment',
-            name: ENV_VARS.WORKSPACE,
-            status: 'pass',
-            message: envConfig.workspace,
-        });
-    }
-    if (envConfig.apiUrl) {
-        results.push({
-            category: 'Environment',
-            name: ENV_VARS.API_URL,
-            status: 'pass',
-            message: envConfig.apiUrl,
-        });
-    }
-    if (envConfig.disableTelemetry) {
-        results.push({
-            category: 'Environment',
-            name: ENV_VARS.DISABLE_TELEMETRY,
-            status: 'pass',
-            message: 'true',
-        });
-    }
-    return results;
-}
-/**
- * Run all health checks
- */
-export async function runDoctor(options = {}) {
-    const checks = [];
-    const serverName = options.serverName || 'apiclaw';
-    // System checks
-    checks.push(checkNode());
-    checks.push(checkNpm());
-    checks.push(checkNpx());
-    // Client checks
-    for (const client of getAllClients()) {
-        checks.push(checkClient(client, serverName));
-    }
-    // Connectivity check
-    checks.push(await checkConnectivity());
-    // Environment checks
-    checks.push(...checkEnvVars());
-    // Calculate health status
-    const failures = checks.filter(c => c.status === 'fail');
-    const warnings = checks.filter(c => c.status === 'warn');
-    const passes = checks.filter(c => c.status === 'pass');
-    let healthy = failures.length === 0;
-    let summary;
-    if (failures.length > 0) {
-        summary = `${failures.length} issue(s) found`;
-    }
-    else if (warnings.length > 0) {
-        summary = `All systems operational (${warnings.length} warning(s))`;
-    }
-    else {
-        summary = 'All systems operational ✓';
-    }
-    return { healthy, checks, summary };
-}
-/**
- * Format doctor results for display
- */
-export function formatDoctorOutput(result) {
-    const lines = [];
-    lines.push('');
-    lines.push('🔍 APIClaw Health Check');
-    lines.push('========================');
-    lines.push('');
-    // Group checks by category
-    const categories = new Map();
-    for (const check of result.checks) {
-        const existing = categories.get(check.category) || [];
-        existing.push(check);
-        categories.set(check.category, existing);
-    }
-    // Format each category
-    for (const [category, checks] of categories) {
-        // Skip empty categories
-        if (checks.length === 0)
-            continue;
-        lines.push(`${category}:`);
-        for (const check of checks) {
-            const icon = getStatusIcon(check.status);
-            lines.push(`  ${icon} ${check.name} - ${check.message}`);
-            if (check.details && (check.status === 'fail' || check.status === 'warn')) {
-                lines.push(`      ${check.details}`);
-            }
-        }
-        lines.push('');
-    }
-    // Summary
-    lines.push(`Status: ${result.summary}`);
-    lines.push('');
-    return lines.join('\n');
-}
-/**
- * Get icon for status
- */
-function getStatusIcon(status) {
-    switch (status) {
-        case 'pass': return '✓';
-        case 'fail': return '✗';
-        case 'warn': return '⚠';
-        case 'skip': return '○';
-    }
-}
-/**
- * Doctor command handler
- */
-export async function doctorCommand(options = {}) {
-    const result = await runDoctor(options);
-    if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-    }
-    else {
-        console.log(formatDoctorOutput(result));
-    }
-    // Exit with error code if unhealthy
-    if (!result.healthy) {
-        process.exit(1);
-    }
-}

package/dist/src/cli/commands/mcp-install.js

@@ -1,255 +0,0 @@
-/**
- * MCP Install Command
- * Simple, focused command to install APIClaw into MCP config files
- * Supports Claude Desktop and Claude Code
- */
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-import { platform, homedir } from 'os';
-import chalk from 'chalk';
-/**
- * Detect operating system
- */
-function detectOS() {
-    const os = platform();
-    switch (os) {
-        case 'darwin': return 'mac';
-        case 'win32': return 'win';
-        default: return 'linux';
-    }
-}
-/**
- * Get home directory
- */
-function getHome() {
-    return homedir();
-}
-/**
- * Get config paths for supported clients
- */
-function getClientConfigs() {
-    const os = detectOS();
-    const home = getHome();
-    const clients = [
-        {
-            name: 'claude-desktop',
-            displayName: 'Claude Desktop',
-            configKey: 'mcpServers',
-            getConfigPath: () => {
-                switch (os) {
-                    case 'mac':
-                        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-                    case 'win':
-                        return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
-                    case 'linux':
-                        return join(home, '.config', 'Claude', 'claude_desktop_config.json');
-                }
-            },
-        },
-        {
-            name: 'claude-code',
-            displayName: 'Claude Code',
-            configKey: 'mcpServers',
-            getConfigPath: () => {
-                // Claude Code uses ~/.claude.json on all platforms
-                return join(home, '.claude.json');
-            },
-        },
-    ];
-    return clients;
-}
-/**
- * APIClaw MCP server configuration
- */
-const APICLAW_CONFIG = {
-    command: 'npx',
-    args: ['-y', '@nordsym/apiclaw', 'serve'],
-};
-/**
- * Read JSON config file
- */
-function readConfig(path) {
-    try {
-        if (!existsSync(path)) {
-            return { success: true, config: {}, isNew: true };
-        }
-        const content = readFileSync(path, 'utf-8');
-        if (!content.trim()) {
-            return { success: true, config: {}, isNew: true };
-        }
-        return { success: true, config: JSON.parse(content), isNew: false };
-    }
-    catch (error) {
-        return {
-            success: false,
-            config: null,
-            error: error instanceof Error ? error.message : 'Unknown error'
-        };
-    }
-}
-/**
- * Write JSON config file with backup
- */
-function writeConfig(path, config, createBackup = true) {
-    try {
-        const dir = dirname(path);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        // Create backup if file exists
-        if (createBackup && existsSync(path)) {
-            const backupPath = `${path}.backup.${Date.now()}.json`;
-            const existing = readFileSync(path, 'utf-8');
-            writeFileSync(backupPath, existing, 'utf-8');
-        }
-        writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
-        return { success: true };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Unknown error'
-        };
-    }
-}
-/**
- * Install APIClaw into a client config
- */
-function installToClient(client, dryRun) {
-    const configPath = client.getConfigPath();
-    // Read existing config
-    const readResult = readConfig(configPath);
-    if (!readResult.success) {
-        return { success: false, message: `Failed to read config: ${readResult.error}` };
-    }
-    const config = readResult.config;
-    // Initialize mcpServers if not present
-    if (!config.mcpServers) {
-        config.mcpServers = {};
-    }
-    // Check if already installed
-    if (config.mcpServers.apiclaw) {
-        return { success: true, message: 'Already installed', skipped: true };
-    }
-    // Add APIClaw config
-    config.mcpServers.apiclaw = APICLAW_CONFIG;
-    if (dryRun) {
-        console.log(chalk.cyan(`\n  Would add to ${configPath}:`));
-        console.log(chalk.gray(JSON.stringify({ apiclaw: APICLAW_CONFIG }, null, 4)));
-        return { success: true, message: 'Dry run - no changes made', skipped: true };
-    }
-    // Write config
-    const writeResult = writeConfig(configPath, config);
-    if (!writeResult.success) {
-        return { success: false, message: `Failed to write config: ${writeResult.error}` };
-    }
-    return {
-        success: true,
-        message: readResult.isNew ? 'Created new config' : 'Updated config'
-    };
-}
-/**
- * Main mcp-install command handler
- */
-export async function mcpInstallCommand(options) {
-    const os = detectOS();
-    const osName = os === 'mac' ? 'macOS' : os === 'win' ? 'Windows' : 'Linux';
-    console.log(chalk.bold('\n🦞 APIClaw MCP Install\n'));
-    console.log(`Platform: ${osName}\n`);
-    const clients = getClientConfigs();
-    let targetClients = clients;
-    // Filter to specific client if requested
-    if (options.client) {
-        const normalizedClient = options.client.toLowerCase().replace(/[_\s]/g, '-');
-        const aliases = {
-            'claude': 'claude-desktop',
-            'claude-desktop': 'claude-desktop',
-            'claudedesktop': 'claude-desktop',
-            'desktop': 'claude-desktop',
-            'code': 'claude-code',
-            'claude-code': 'claude-code',
-            'claudecode': 'claude-code',
-        };
-        const targetName = aliases[normalizedClient];
-        if (!targetName) {
-            console.log(chalk.red(`❌ Unknown client: ${options.client}`));
-            console.log('   Supported: claude-desktop, claude-code');
-            process.exit(1);
-        }
-        targetClients = clients.filter(c => c.name === targetName);
-    }
-    // Detect which clients exist
-    console.log('🔍 Detecting MCP clients...\n');
-    const detectedClients = [];
-    for (const client of targetClients) {
-        const configPath = client.getConfigPath();
-        const configDir = dirname(configPath);
-        const exists = existsSync(configPath) || existsSync(configDir);
-        const icon = exists ? chalk.green('✓') : chalk.gray('✗');
-        const status = exists ? 'found' : 'not found';
-        console.log(`   ${icon} ${client.displayName} ${status}`);
-        if (exists) {
-            detectedClients.push(client);
-        }
-    }
-    console.log('');
-    if (detectedClients.length === 0) {
-        console.log(chalk.yellow('⚠️  No MCP clients detected.'));
-        console.log('   Install Claude Desktop or Claude Code first.\n');
-        process.exit(0);
-    }
-    // Install to each detected client
-    let successCount = 0;
-    let skipCount = 0;
-    let failCount = 0;
-    for (const client of detectedClients) {
-        const result = installToClient(client, options.dryRun || false);
-        if (result.success) {
-            if (result.skipped) {
-                skipCount++;
-                console.log(chalk.yellow(`⏭️  ${client.displayName}: ${result.message}`));
-            }
-            else {
-                successCount++;
-                console.log(chalk.green(`✓ ${client.displayName}: ${result.message}`));
-            }
-        }
-        else {
-            failCount++;
-            console.log(chalk.red(`✗ ${client.displayName}: ${result.message}`));
-        }
-    }
-    // Summary
-    console.log('\n' + '═'.repeat(50));
-    if (failCount === 0) {
-        if (options.dryRun) {
-            console.log(chalk.cyan('\n✅ Dry run complete! Run without --dry-run to apply changes.\n'));
-        }
-        else if (successCount > 0) {
-            console.log(chalk.green('\n✅ APIClaw installed successfully!\n'));
-            console.log(chalk.bold('What you get:\n'));
-            console.log(chalk.cyan('  🔍 Search') + '      22,000+ APIs to discover');
-            console.log(chalk.cyan('  🌐 Open APIs') + '   1,600 free APIs');
-            console.log(chalk.cyan('  🔑 Direct Call') + ' 1,500+ premium (APIClaw manages keys)');
-            console.log('');
-            console.log('Next:');
-            console.log('  1. Restart your MCP client');
-            console.log('  2. Try: "Find weather APIs"');
-            console.log('');
-            console.log('Docs: https://apiclaw.com/docs\n');
-        }
-        else {
-            console.log(chalk.yellow('\n✅ APIClaw already installed in all clients.\n'));
-            console.log(chalk.bold('What you have:\n'));
-            console.log(chalk.cyan('  🔍 Search') + '      22,000+ APIs to discover');
-            console.log(chalk.cyan('  🌐 Open APIs') + '   1,600 free APIs');
-            console.log(chalk.cyan('  🔑 Direct Call') + ' 1,500+ premium (APIClaw manages keys)');
-            console.log('');
-            console.log('Run with --force to reinstall (coming soon).\n');
-        }
-    }
-    else {
-        console.log(chalk.red(`\n⚠️  Installation completed with ${failCount} error(s).\n`));
-        process.exit(1);
-    }
-}