@1mcp/agent 0.16.0 → 0.18.0

package/build/utils/appPresets.js

@@ -0,0 +1,430 @@
+import path from 'path';
+import os from 'os';
+/**
+ * Supported desktop applications with their configuration presets
+ *
+ * ⚠️  PLATFORM SUPPORT STATUS:
+ * - macOS (darwin): ✅ Fully tested and verified
+ * - Windows (win32): ⚠️  Paths researched but untested - see commented sections
+ * - Linux: ⚠️  Paths researched but untested - see commented sections
+ *
+ * 🤝 CONTRIBUTION NEEDED:
+ * If you're using Windows or Linux, please help verify these paths by:
+ * 1. Uncommenting the relevant sections for your platform
+ * 2. Testing the functionality
+ * 3. Reporting results or submitting fixes
+ *
+ * 📝 STANDARD LOCATIONS RESEARCH:
+ * The commented paths below are based on official documentation and
+ * common conventions, but have not been tested in real environments.
+ */
+export const APP_PRESETS = {
+    'claude-desktop': {
+        name: 'claude-desktop',
+        displayName: 'Claude Desktop',
+        configurable: true,
+        configFormat: 'claude-desktop',
+        locations: [
+            {
+                platform: 'darwin',
+                path: '~/Library/Application Support/Claude/claude_desktop_config.json',
+                level: 'user',
+                priority: 10,
+            },
+            // UNTESTED - Based on Claude Desktop documentation and Windows conventions
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Claude\\claude_desktop_config.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // UNTESTED - Based on XDG Base Directory specification and Linux conventions
+            // {
+            //   platform: 'linux',
+            //   path: '~/.config/claude/claude_desktop_config.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    cursor: {
+        name: 'cursor',
+        displayName: 'Cursor',
+        configurable: true,
+        configFormat: 'generic',
+        locations: [
+            {
+                platform: 'all',
+                path: '.cursor/mcp.json',
+                level: 'project',
+                priority: 20,
+            },
+            {
+                platform: 'darwin',
+                path: '~/.cursor/mcp.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Cursor\\User\\settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.cursor/mcp.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    vscode: {
+        name: 'vscode',
+        displayName: 'VS Code',
+        configurable: true,
+        configFormat: 'vscode',
+        locations: [
+            {
+                platform: 'all',
+                path: '.vscode/mcp.json',
+                level: 'project',
+                priority: 20,
+            },
+            {
+                platform: 'darwin',
+                path: '~/Library/Application Support/Code/User/settings.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Code\\User\\settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.config/Code/User/settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    'claude-code': {
+        name: 'claude-code',
+        displayName: 'Claude Code',
+        configurable: true,
+        configFormat: 'generic',
+        locations: [
+            {
+                platform: 'all',
+                path: '.mcp.json',
+                level: 'project',
+                priority: 20,
+            },
+        ],
+    },
+    'gemini-code': {
+        name: 'gemini-code',
+        displayName: 'Gemini Code',
+        configurable: true,
+        configFormat: 'generic',
+        locations: [
+            {
+                platform: 'darwin',
+                path: '~/.gemini/settings.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Gemini\\settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.gemini/settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    'augment-code': {
+        name: 'augment-code',
+        displayName: 'Augment Code',
+        configurable: true,
+        configFormat: 'augment',
+        locations: [
+            {
+                platform: 'darwin',
+                path: '~/Library/Application Support/Code/User/settings.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Code\\User\\settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.config/Code/User/settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    'roo-code': {
+        name: 'roo-code',
+        displayName: 'Roo Code',
+        configurable: true,
+        configFormat: 'generic',
+        locations: [
+            {
+                platform: 'all',
+                path: '.roo/mcp.json',
+                level: 'project',
+                priority: 20,
+            },
+            {
+                platform: 'darwin',
+                path: '~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Code\\User\\globalStorage\\rooveterinaryinc.roo-cline\\settings\\mcp_settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    cline: {
+        name: 'cline',
+        displayName: 'Cline',
+        configurable: true,
+        configFormat: 'generic',
+        locations: [
+            {
+                platform: 'darwin',
+                path: '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json',
+                level: 'user',
+                priority: 10,
+            },
+            // {
+            //   platform: 'win32',
+            //   path: '%APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+            // {
+            //   platform: 'linux',
+            //   path: '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json',
+            //   level: 'user',
+            //   priority: 10,
+            // },
+        ],
+    },
+    'cherry-studio': {
+        name: 'cherry-studio',
+        displayName: 'Cherry Studio',
+        configurable: false,
+        configFormat: 'generic',
+        locations: [],
+        manualInstructions: `
+═══ Cherry Studio Setup Instructions ═══
+1. Open Cherry Studio → Settings → MCP Servers
+2. Remove any existing MCP server configurations (if any)
+3. Add new server with these details:
+
+   Name: 1mcp
+   URL: {url}
+
+4. Save and restart Cherry Studio
+
+✅ After setup, Cherry Studio will connect to 1mcp which can proxy
+   to all your MCP servers from other clients!
+
+💡 Add servers to 1mcp: npx @1mcp/agent server add <server-config>`,
+    },
+    continue: {
+        name: 'continue',
+        displayName: 'Continue (VS Code Extension)',
+        configurable: false,
+        configFormat: 'generic',
+        locations: [],
+        manualInstructions: `
+═══ Continue (VS Code Extension) Setup Instructions ═══
+1. Open VS Code → Extensions → Continue settings
+2. Navigate to MCP Server configuration section
+3. Remove any existing MCP server configurations (if any)
+4. Add new server configuration:
+
+   URL: {url}
+
+5. Save settings and restart VS Code
+
+✅ After setup, Continue will connect to 1mcp which can proxy
+   to all your MCP servers from other clients!
+
+💡 Add servers to 1mcp: npx @1mcp/agent server add <server-config>`,
+    },
+};
+/**
+ * Get all supported application names
+ */
+export function getSupportedApps() {
+    return Object.keys(APP_PRESETS);
+}
+/**
+ * Get configurable applications (can be auto-consolidated)
+ */
+export function getConfigurableApps() {
+    return Object.entries(APP_PRESETS)
+        .filter(([_, preset]) => preset.configurable)
+        .map(([name, _]) => name);
+}
+/**
+ * Get manual-only applications (require manual setup instructions)
+ */
+export function getManualOnlyApps() {
+    return Object.entries(APP_PRESETS)
+        .filter(([_, preset]) => !preset.configurable)
+        .map(([name, _]) => name);
+}
+/**
+ * Get preset configuration for an application
+ */
+export function getAppPreset(appName) {
+    return APP_PRESETS[appName] || null;
+}
+/**
+ * Resolve platform-specific paths for an application
+ */
+export function getAppConfigPaths(appName) {
+    const preset = getAppPreset(appName);
+    if (!preset || !preset.configurable) {
+        return [];
+    }
+    const platform = process.platform;
+    const relevantLocations = preset.locations.filter((location) => location.platform === 'all' || location.platform === platform);
+    // Sort by priority (highest first)
+    relevantLocations.sort((a, b) => b.priority - a.priority);
+    return relevantLocations.map((location) => resolvePath(location.path));
+}
+/**
+ * Check if the current platform has verified support for an app
+ */
+export function isPlatformTested(appName) {
+    const preset = getAppPreset(appName);
+    if (!preset)
+        return false;
+    const platform = process.platform;
+    // Only macOS is currently tested
+    if (platform !== 'darwin')
+        return false;
+    return preset.locations.some((loc) => loc.platform === 'darwin' || loc.platform === 'all');
+}
+/**
+ * Get platform support message for CLI users
+ */
+export function getPlatformSupportMessage(_appName) {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        return '✅ Fully supported and tested on macOS';
+    }
+    const platformName = platform === 'win32' ? 'Windows' : 'Linux';
+    return `⚠️  ${platformName} support is experimental - paths researched but untested.
+     If you encounter issues, please contribute by:
+     1. Testing the functionality
+     2. Reporting results at https://github.com/1mcp-app/agent/issues
+     3. Submitting corrections if needed`;
+}
+/**
+ * Display platform support warning for CLI commands if needed
+ */
+export function showPlatformWarningIfNeeded() {
+    const platform = process.platform;
+    if (platform !== 'darwin') {
+        const platformName = platform === 'win32' ? 'Windows' : 'Linux';
+        console.log('⚠️  PLATFORM SUPPORT WARNING');
+        console.log(`${platformName} support is experimental - paths researched but untested.`);
+        console.log('If you encounter issues, please contribute by:');
+        console.log('  1. Testing the functionality');
+        console.log('  2. Reporting results at https://github.com/1mcp-app/agent/issues');
+        console.log('  3. Submitting corrections if needed');
+        console.log('');
+    }
+}
+/**
+ * Resolve path with environment variable expansion
+ */
+function resolvePath(pathStr) {
+    // Replace ~ with home directory
+    if (pathStr.startsWith('~')) {
+        pathStr = path.join(os.homedir(), pathStr.slice(1));
+    }
+    // Replace %APPDATA% on Windows
+    if (process.platform === 'win32' && pathStr.includes('%APPDATA%')) {
+        const appData = process.env.APPDATA || '';
+        pathStr = pathStr.replace('%APPDATA%', appData);
+    }
+    // Handle other environment variables
+    pathStr = pathStr.replace(/\$\{([^}]+)\}/g, (match, envVar) => {
+        return process.env[envVar] || match;
+    });
+    return path.resolve(pathStr);
+}
+/**
+ * Generate manual setup instructions for an app
+ */
+export function generateManualInstructions(appName, url) {
+    const preset = getAppPreset(appName);
+    if (!preset || !preset.manualInstructions) {
+        return `Manual setup instructions not available for ${appName}.`;
+    }
+    return preset.manualInstructions.replace(/\{url\}/g, url);
+}
+/**
+ * Check if an application is supported
+ */
+export function isAppSupported(appName) {
+    return appName in APP_PRESETS;
+}
+/**
+ * Check if an application is configurable (auto-consolidation supported)
+ */
+export function isAppConfigurable(appName) {
+    const preset = getAppPreset(appName);
+    return preset ? preset.configurable : false;
+}
+/**
+ * Generate dynamic supported apps list for CLI help text
+ */
+export function generateSupportedAppsHelp() {
+    const configurableApps = getConfigurableApps();
+    const manualApps = getManualOnlyApps();
+    let helpText = 'SUPPORTED APPS:\n';
+    // Add configurable apps
+    configurableApps.forEach((appName) => {
+        const preset = APP_PRESETS[appName];
+        helpText += `  - ${appName}: ${preset.displayName}\n`;
+    });
+    // Add manual apps with note
+    manualApps.forEach((appName) => {
+        const preset = APP_PRESETS[appName];
+        helpText += `  - ${appName}: ${preset.displayName} (manual setup only)\n`;
+    });
+    return helpText.trimEnd();
+}
+//# sourceMappingURL=appPresets.js.map

package/build/utils/appPresets.js.map

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

package/build/utils/backupManager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Backup and recovery system for app configuration consolidation.
+ *
+ * Provides safe backup creation, metadata tracking, and rollback
+ * capabilities for configuration operations.
+ */
+export interface BackupInfo {
+    originalPath: string;
+    backupPath: string;
+    timestamp: number;
+    checksum: string;
+    metadata: {
+        app: string;
+        operation: string;
+        version: string;
+        serverCount: number;
+        fileSize: number;
+    };
+}
+export interface BackupListItem {
+    app: string;
+    backupPath: string;
+    metaPath: string;
+    timestamp: number;
+    operation: string;
+    serverCount: number;
+    age: string;
+}
+/**
+ * Create a backup of configuration file with metadata
+ */
+export declare function createBackup(configPath: string, app: string, operation: string, serverCount?: number): BackupInfo;
+/**
+ * Rollback from backup file
+ */
+export declare function rollbackFromBackup(backup: BackupInfo): Promise<void>;
+/**
+ * Rollback from backup file path
+ */
+export declare function rollbackFromBackupPath(backupPath: string): Promise<void>;
+/**
+ * List all available backups for a specific app
+ */
+export declare function listAppBackups(app?: string): BackupListItem[];
+/**
+ * Find backup by metadata file path
+ */
+export declare function findBackupByMetaPath(metaPath: string): BackupInfo | null;
+/**
+ * Clean up old backups (older than specified days)
+ */
+export declare function cleanupOldBackups(maxAgeDays?: number): number;
+/**
+ * Verify backup integrity
+ */
+export declare function verifyBackupIntegrity(backupInfo: BackupInfo): boolean;
+/**
+ * File locking mechanism for atomic operations
+ */
+export declare function withFileLock<T>(filePath: string, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=backupManager.d.ts.map

package/build/utils/backupManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupManager.d.ts","sourceRoot":"","sources":["../../src/utils/backupManager.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,MAAU,GAAG,UAAU,CA0CpH;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAoC7D;AA6FD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAkBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM,CA2BjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAarE;AA0BD;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAsC/F"}