@elliotding/ai-agent-mcp 0.1.0

package/dist/config/index.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Configuration Management Module
+ * Loads and validates configuration from environment variables
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.loadConfig = loadConfig;
+const dotenv = __importStar(require("dotenv"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+// Load .env file if exists
+// Try multiple paths to find .env file
+const possibleEnvPaths = [
+    path.resolve(process.cwd(), '.env'), // Current working directory
+    path.resolve(__dirname, '../../.env'), // Relative to compiled dist/config/
+    path.resolve(__dirname, '../../../.env'), // Project root (if deeper nesting)
+];
+let envLoaded = false;
+for (const envPath of possibleEnvPaths) {
+    if (fs.existsSync(envPath)) {
+        dotenv.config({ path: envPath });
+        console.log(`✓ Loaded .env from: ${envPath}`);
+        envLoaded = true;
+        break;
+    }
+}
+if (!envLoaded) {
+    console.warn('⚠ No .env file found, using environment variables only');
+}
+function getEnv(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        throw new Error(`Missing required environment variable: ${key}`);
+    }
+    return value;
+}
+function getEnvNumber(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        throw new Error(`Missing required environment variable: ${key}`);
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        throw new Error(`Environment variable ${key} must be a number, got: ${value}`);
+    }
+    return parsed;
+}
+function getEnvBoolean(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return value.toLowerCase() === 'true';
+}
+function loadConfig() {
+    const nodeEnv = (process.env.NODE_ENV || 'development');
+    const logLevel = (process.env.LOG_LEVEL || 'info');
+    const transportMode = (process.env.TRANSPORT_MODE || 'stdio');
+    // Debug: Log CSP_API_TOKEN to verify it was loaded
+    console.log(`🔑 CSP_API_TOKEN from env: ${process.env.CSP_API_TOKEN ? process.env.CSP_API_TOKEN.substring(0, 20) + '...' : 'NOT SET'}`);
+    return {
+        nodeEnv,
+        port: getEnvNumber('PORT', 5090),
+        logLevel,
+        transport: {
+            mode: transportMode,
+        },
+        http: transportMode === 'sse' ? {
+            host: getEnv('HTTP_HOST', '0.0.0.0'),
+            port: getEnvNumber('HTTP_PORT', 3000),
+        } : undefined,
+        session: transportMode === 'sse' ? {
+            timeout: getEnvNumber('SESSION_TIMEOUT', 3600),
+        } : undefined,
+        csp: {
+            apiBaseUrl: getEnv('CSP_API_BASE_URL', 'https://csp.example.com'),
+            apiToken: getEnv('CSP_API_TOKEN', 'test-token-12345'),
+            timeout: getEnvNumber('CSP_API_TIMEOUT', 30000),
+        },
+        git: {
+            userName: getEnv('GIT_USER_NAME', 'CSP Agent'),
+            userEmail: getEnv('GIT_USER_EMAIL', 'agent@example.com'),
+        },
+        resource: {},
+        cache: {
+            enabled: getEnvBoolean('ENABLE_CACHE', true),
+            redis: process.env.REDIS_URL
+                ? {
+                    url: process.env.REDIS_URL,
+                    ttl: getEnvNumber('REDIS_TTL', 900),
+                }
+                : undefined,
+            memory: {
+                maxSize: getEnvNumber('CACHE_MAX_SIZE', 100),
+            },
+        },
+        database: process.env.DATABASE_URL
+            ? {
+                url: process.env.DATABASE_URL,
+            }
+            : undefined,
+        metrics: {
+            enabled: getEnvBoolean('ENABLE_METRICS', true),
+            port: process.env.METRICS_PORT ? getEnvNumber('METRICS_PORT') : undefined,
+        },
+        logging: {
+            dir: getEnv('LOG_DIR', '../Logs'),
+            retentionDays: getEnvNumber('LOG_RETENTION_DAYS', 3),
+        },
+    };
+}
+// Validate configuration on load
+let config;
+try {
+    exports.config = config = loadConfig();
+}
+catch (error) {
+    // Use logger for consistent error reporting
+    const logger = require('../utils/logger').logger;
+    logger.error({
+        type: 'config',
+        operation: 'load_config',
+        error: error.message,
+        stack: error.stack
+    }, 'Configuration loading failed');
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/filesystem/manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Filesystem Manager
+ * Atomic filesystem operations for resource management
+ */
+declare class FilesystemManager {
+    /**
+     * Write resource file atomically
+     */
+    writeResource(filePath: string, content: string): Promise<void>;
+    /**
+     * Read resource file with validation
+     */
+    readResource(filePath: string): Promise<string>;
+    /**
+     * Delete resource file with backup
+     */
+    deleteResource(filePath: string): Promise<void>;
+    /**
+     * Validate resource content
+     */
+    private validateResourceContent;
+    /**
+     * Check if file exists
+     */
+    fileExists(filePath: string): Promise<boolean>;
+    /**
+     * List files in directory
+     */
+    listFiles(dirPath: string, pattern?: RegExp): Promise<string[]>;
+    /**
+     * Recursively scan a directory and return all text files as FileEntry[]
+     * Supported extensions: .md, .mdc, .txt, .yaml, .yml, .json
+     */
+    scanDirectory(dirPath: string): Promise<Array<{
+        path: string;
+        content: string;
+    }>>;
+    /**
+     * Remove empty directories recursively
+     */
+    removeEmptyDirs(dirPath: string): Promise<void>;
+}
+export declare const filesystemManager: FilesystemManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/filesystem/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/filesystem/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,cAAM,iBAAiB;IACrB;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBrD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrD;;OAEG;YACW,uBAAuB;IAuBrC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAcrE;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiDvF;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBtD;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/filesystem/manager.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Filesystem Manager
+ * Atomic filesystem operations for resource management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filesystemManager = void 0;
+const fs = __importStar(require("fs/promises"));
+const fsSync = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const errors_1 = require("../types/errors");
+class FilesystemManager {
+    /**
+     * Write resource file atomically
+     */
+    async writeResource(filePath, content) {
+        const tempPath = `${filePath}.tmp`;
+        try {
+            // Ensure directory exists
+            const dir = path.dirname(filePath);
+            await fs.mkdir(dir, { recursive: true });
+            // Write to temporary file
+            await fs.writeFile(tempPath, content, 'utf-8');
+            // Validate content (basic check)
+            await this.validateResourceContent(tempPath, content);
+            // Atomic rename
+            await fs.rename(tempPath, filePath);
+            logger_1.logger.debug({ filePath }, 'Resource file written successfully');
+        }
+        catch (error) {
+            // Cleanup temporary file
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw (0, errors_1.createFileSystemError)('write', filePath, error);
+        }
+    }
+    /**
+     * Read resource file with validation
+     */
+    async readResource(filePath) {
+        try {
+            // Check if file exists
+            await fs.access(filePath, fsSync.constants.R_OK);
+            // Read file
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Validate format
+            await this.validateResourceContent(filePath, content);
+            return content;
+        }
+        catch (error) {
+            throw (0, errors_1.createFileSystemError)('read', filePath, error);
+        }
+    }
+    /**
+     * Delete resource file with backup
+     */
+    async deleteResource(filePath) {
+        const backupPath = `${filePath}.backup`;
+        try {
+            // Create backup
+            if (fsSync.existsSync(filePath)) {
+                await fs.copyFile(filePath, backupPath);
+            }
+            // Delete file
+            await fs.unlink(filePath);
+            // Remove backup on success
+            try {
+                await fs.unlink(backupPath);
+            }
+            catch {
+                // Ignore backup cleanup errors
+            }
+            logger_1.logger.debug({ filePath }, 'Resource file deleted successfully');
+        }
+        catch (error) {
+            // Restore from backup on failure
+            try {
+                if (fsSync.existsSync(backupPath)) {
+                    await fs.copyFile(backupPath, filePath);
+                    await fs.unlink(backupPath);
+                }
+            }
+            catch {
+                // Ignore restore errors
+            }
+            throw (0, errors_1.createFileSystemError)('delete', filePath, error);
+        }
+    }
+    /**
+     * Validate resource content
+     */
+    async validateResourceContent(filePath, content) {
+        const ext = path.extname(filePath);
+        // Check if empty
+        if (!content || content.trim().length === 0) {
+            throw (0, errors_1.createValidationError)(filePath, ext, 'File content is empty');
+        }
+        // Validate based on file type
+        if (ext === '.json') {
+            try {
+                JSON.parse(content);
+            }
+            catch (error) {
+                throw (0, errors_1.createValidationError)(filePath, 'json', 'Invalid JSON format');
+            }
+        }
+        else if (ext === '.md') {
+            // Basic markdown validation (check for minimum content)
+            if (content.length < 10) {
+                throw (0, errors_1.createValidationError)(filePath, 'markdown', 'Markdown content too short');
+            }
+        }
+    }
+    /**
+     * Check if file exists
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath, fsSync.constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List files in directory
+     */
+    async listFiles(dirPath, pattern) {
+        try {
+            const files = await fs.readdir(dirPath, { recursive: true });
+            if (pattern) {
+                return files.filter((file) => pattern.test(file));
+            }
+            return files;
+        }
+        catch (error) {
+            throw (0, errors_1.createFileSystemError)('list', dirPath, error);
+        }
+    }
+    /**
+     * Recursively scan a directory and return all text files as FileEntry[]
+     * Supported extensions: .md, .mdc, .txt, .yaml, .yml, .json
+     */
+    async scanDirectory(dirPath) {
+        const TEXT_EXTENSIONS = new Set(['.md', '.mdc', '.txt', '.yaml', '.yml', '.json']);
+        const results = [];
+        const walk = async (currentPath, relBase) => {
+            let entries;
+            try {
+                entries = await fs.readdir(currentPath, { withFileTypes: true });
+            }
+            catch (error) {
+                throw (0, errors_1.createFileSystemError)('list', currentPath, error);
+            }
+            for (const entry of entries) {
+                const fullPath = path.join(currentPath, entry.name);
+                const relPath = path.join(relBase, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath, relPath);
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name).toLowerCase();
+                    if (TEXT_EXTENSIONS.has(ext)) {
+                        try {
+                            const content = await fs.readFile(fullPath, 'utf-8');
+                            if (content.trim().length > 0) {
+                                results.push({ path: relPath, content });
+                            }
+                        }
+                        catch {
+                            // Skip unreadable files silently
+                            logger_1.logger.warn({ filePath: fullPath }, 'Skipped unreadable file during directory scan');
+                        }
+                    }
+                }
+            }
+        };
+        await walk(dirPath, '');
+        if (results.length === 0) {
+            throw (0, errors_1.createValidationError)(dirPath, 'directory', `No text files found in directory: ${dirPath}`);
+        }
+        logger_1.logger.debug({ dirPath, fileCount: results.length }, 'Directory scan completed');
+        return results;
+    }
+    /**
+     * Remove empty directories recursively
+     */
+    async removeEmptyDirs(dirPath) {
+        try {
+            const files = await fs.readdir(dirPath);
+            if (files.length === 0) {
+                await fs.rmdir(dirPath);
+                logger_1.logger.debug({ dirPath }, 'Empty directory removed');
+                // Check parent directory
+                const parentDir = path.dirname(dirPath);
+                if (parentDir !== dirPath) {
+                    await this.removeEmptyDirs(parentDir);
+                }
+            }
+        }
+        catch (error) {
+            // Ignore errors (directory might not be empty or already deleted)
+        }
+    }
+}
+exports.filesystemManager = new FilesystemManager();
+//# sourceMappingURL=manager.js.map

package/dist/filesystem/manager.js.map

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

package/dist/git/multi-source-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Multi-Source Git Manager
+ * Manages multiple AI Resources Git repositories efficiently
+ */
+interface SyncResult {
+    source: string;
+    action: 'cloned' | 'pulled' | 'up-to-date' | 'skipped';
+    changes: number;
+    duration: number;
+}
+declare class MultiSourceGitManager {
+    private configPath;
+    private baseDir;
+    constructor(baseDir: string);
+    /**
+     * Load AI Resources configuration
+     */
+    private loadConfig;
+    /**
+     * Get all enabled sources (including default)
+     */
+    private getEnabledSources;
+    /**
+     * Check if a Git repository exists at the given path
+     */
+    private repositoryExists;
+    /**
+     * Get Git repository URL from existing repo
+     */
+    private getRepoUrl;
+    /**
+     * Clone a Git repository
+     */
+    private cloneRepository;
+    /**
+     * Pull latest changes using fetch + fast-forward merge.
+     *
+     * Deliberately avoids --depth=1 on fetch: shallow fetches truncate local
+     * history, causing "no merge base" divergence errors on subsequent pulls.
+     */
+    private pullRepository;
+    /**
+     * Sync a single source repository
+     */
+    private syncSource;
+    /**
+     * Sync all enabled sources
+     */
+    syncAllSources(): Promise<SyncResult[]>;
+    /**
+     * Check status of all sources without pulling
+     */
+    checkAllSources(): Promise<Array<{
+        source: string;
+        exists: boolean;
+        hasRemote: boolean;
+        repoUrl: string | null;
+    }>>;
+}
+export declare const multiSourceGitManager: MultiSourceGitManager;
+export {};
+//# sourceMappingURL=multi-source-manager.d.ts.map

package/dist/git/multi-source-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-source-manager.d.ts","sourceRoot":"","sources":["../../src/git/multi-source-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,cAAM,qBAAqB;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAK3B;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;YACW,gBAAgB;IAU9B;;OAEG;YACW,UAAU;IAWxB;;OAEG;YACW,eAAe;IAwB7B;;;;;OAKG;YACW,cAAc;IA+C5B;;OAEG;YACW,UAAU;IAgExB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAyC7C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;CAuBJ;AAID,eAAO,MAAM,qBAAqB,uBAA+C,CAAC"}