@elliotding/ai-agent-mcp 0.1.26 → 0.1.28

package/dist/cache/redis-client.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Redis Client Module
+ * Connection management with retry strategy and basic cache operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redisClient = exports.RedisClient = void 0;
+const ioredis_1 = __importDefault(require("ioredis"));
+const logger_1 = require("../utils/logger");
+const config_1 = require("../config");
+const RETRY_BASE_MS = 100;
+const RETRY_MAX_MS = 5000;
+const RETRY_MAX_ATTEMPTS = 10;
+/**
+ * Exponential backoff: base * 2^times, capped at max
+ */
+function exponentialBackoff(times) {
+    if (times > RETRY_MAX_ATTEMPTS) {
+        return 0; // Stop retrying
+    }
+    const delay = Math.min(RETRY_BASE_MS * Math.pow(2, times), RETRY_MAX_MS);
+    return delay;
+}
+class RedisClient {
+    static instance = null;
+    client = null;
+    isConnecting = false;
+    constructor() { }
+    static getInstance() {
+        if (RedisClient.instance === null) {
+            RedisClient.instance = new RedisClient();
+        }
+        return RedisClient.instance;
+    }
+    /**
+     * Connect to Redis with config and retry strategy
+     */
+    async connect() {
+        const redisConfig = config_1.config.cache?.redis;
+        if (!redisConfig?.url) {
+            logger_1.logger.warn({ type: 'redis', event: 'connect_skipped' }, 'Redis URL not configured (REDIS_URL), skipping connection');
+            return;
+        }
+        if (this.client && this.isConnected()) {
+            logger_1.logger.debug({ type: 'redis', event: 'connect' }, 'Redis already connected');
+            return;
+        }
+        if (this.isConnecting) {
+            logger_1.logger.debug({ type: 'redis', event: 'connect' }, 'Redis connection in progress');
+            return;
+        }
+        this.isConnecting = true;
+        try {
+            this.client = new ioredis_1.default(redisConfig.url, {
+                retryStrategy: (times) => {
+                    const delay = exponentialBackoff(times);
+                    if (delay === 0) {
+                        logger_1.logger.error({ type: 'redis', event: 'retry_exhausted', times }, 'Redis retry exhausted, giving up');
+                        return undefined;
+                    }
+                    logger_1.logger.warn({ type: 'redis', event: 'retry', times, delayMs: delay }, `Redis reconnecting in ${delay}ms (attempt ${times})`);
+                    return delay;
+                },
+                maxRetriesPerRequest: null,
+                connectTimeout: 10000,
+                lazyConnect: true,
+            });
+            this.client.on('connect', () => {
+                logger_1.logger.info({ type: 'redis', event: 'connect' }, 'Redis connection established');
+            });
+            this.client.on('ready', () => {
+                this.isConnecting = false;
+                logger_1.logger.info({ type: 'redis', event: 'ready' }, 'Redis client ready');
+            });
+            this.client.on('error', (err) => {
+                logger_1.logger.error({ type: 'redis', event: 'error', error: err.message }, `Redis error: ${err.message}`);
+            });
+            this.client.on('close', () => {
+                logger_1.logger.info({ type: 'redis', event: 'close' }, 'Redis connection closed');
+            });
+            await this.client.connect();
+        }
+        catch (error) {
+            this.isConnecting = false;
+            if (this.client) {
+                this.client.disconnect();
+                this.client = null;
+            }
+            (0, logger_1.logError)(error, { type: 'redis', event: 'connect_failed' });
+            throw error;
+        }
+    }
+    /**
+     * Gracefully disconnect from Redis
+     */
+    async disconnect() {
+        if (!this.client) {
+            logger_1.logger.debug({ type: 'redis', event: 'disconnect' }, 'Redis not connected');
+            return;
+        }
+        try {
+            await this.client.quit();
+            this.client = null;
+            logger_1.logger.info({ type: 'redis', event: 'disconnect' }, 'Redis disconnected gracefully');
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', event: 'disconnect_failed' });
+            this.client = null;
+            throw error;
+        }
+    }
+    /**
+     * Check if Redis client is connected
+     */
+    isConnected() {
+        return this.client?.status === 'ready';
+    }
+    /**
+     * Get value by key
+     */
+    async get(key) {
+        if (!this.client) {
+            logger_1.logger.warn({ type: 'redis', operation: 'get', key }, 'Redis not connected');
+            return null;
+        }
+        try {
+            const value = await this.client.get(key);
+            return value;
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', operation: 'get', key });
+            throw error;
+        }
+    }
+    /**
+     * Set value with optional TTL (seconds)
+     */
+    async set(key, value, ttl) {
+        if (!this.client) {
+            logger_1.logger.warn({ type: 'redis', operation: 'set', key }, 'Redis not connected');
+            throw new Error('Redis not connected');
+        }
+        try {
+            const ttlSeconds = ttl ?? config_1.config.cache?.redis?.ttl ?? 900;
+            await this.client.set(key, value, 'EX', ttlSeconds);
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', operation: 'set', key });
+            throw error;
+        }
+    }
+    /**
+     * Delete key
+     */
+    async del(key) {
+        if (!this.client) {
+            logger_1.logger.warn({ type: 'redis', operation: 'del', key }, 'Redis not connected');
+            throw new Error('Redis not connected');
+        }
+        try {
+            await this.client.del(key);
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', operation: 'del', key });
+            throw error;
+        }
+    }
+    /**
+     * Clear all keys matching a pattern. Use with caution.
+     */
+    async clear(pattern = '*') {
+        if (!this.client) {
+            logger_1.logger.warn({ type: 'redis', operation: 'clear', pattern }, 'Redis not connected');
+            throw new Error('Redis not connected');
+        }
+        try {
+            const keys = await this.client.keys(pattern);
+            if (keys.length > 0) {
+                await this.client.del(...keys);
+            }
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', operation: 'clear', pattern });
+            throw error;
+        }
+    }
+    /**
+     * Check if key exists
+     */
+    async exists(key) {
+        if (!this.client) {
+            logger_1.logger.warn({ type: 'redis', operation: 'exists', key }, 'Redis not connected');
+            return false;
+        }
+        try {
+            const result = await this.client.exists(key);
+            return result === 1;
+        }
+        catch (error) {
+            (0, logger_1.logError)(error, { type: 'redis', operation: 'exists', key });
+            throw error;
+        }
+    }
+}
+exports.RedisClient = RedisClient;
+exports.redisClient = RedisClient.getInstance();
+//# sourceMappingURL=redis-client.js.map

package/dist/cache/redis-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.js","sourceRoot":"","sources":["../../src/cache/redis-client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,sDAA6D;AAC7D,4CAAmD;AACnD,sCAAmC;AAEnC,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC,CAAC,gBAAgB;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAa,WAAW;IACd,MAAM,CAAC,QAAQ,GAAuB,IAAI,CAAC;IAC3C,MAAM,GAAyB,IAAI,CAAC;IACpC,YAAY,GAAG,KAAK,CAAC;IAE7B,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,WAAW,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClC,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,WAAW,GAAG,eAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QACxC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;YACtB,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAC3C,2DAA2D,CAC5D,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACtC,eAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,eAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAClF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAK,CAAC,WAAW,CAAC,GAAG,EAAE;gBACvC,aAAa,EAAE,CAAC,KAAa,EAAE,EAAE;oBAC/B,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;oBACxC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;wBAChB,eAAM,CAAC,KAAK,CACV,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAClD,kCAAkC,CACnC,CAAC;wBACF,OAAO,SAAS,CAAC;oBACnB,CAAC;oBACD,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EACxD,yBAAyB,KAAK,eAAe,KAAK,GAAG,CACtD,CAAC;oBACF,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,oBAAoB,EAAE,IAAI;gBAC1B,cAAc,EAAE,KAAK;gBACrB,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC7B,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EACnC,8BAA8B,CAC/B,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC1B,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EACjC,oBAAoB,CACrB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBACrC,eAAM,CAAC,KAAK,CACV,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EACrD,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAC9B,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EACjC,yBAAyB,CAC1B,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,CAAC;YACD,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACrE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,eAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EACtC,+BAA+B,CAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,GAAY;QAChD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,GAAG,IAAI,eAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,CAAC;YAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7C,OAAO,MAAM,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,iBAAQ,EAAC,KAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACtE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;;AA7NH,kCA8NC;AAEY,QAAA,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC"}

package/dist/config/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Configuration Constants
+ */
+export declare const APP_NAME = "csp-ai-agent-mcp";
+export declare const APP_VERSION = "0.1.0";
+export declare const DEFAULT_PORT = 5090;
+export declare const DEFAULT_LOG_LEVEL = "info";
+export declare const DEFAULT_API_TIMEOUT = 30000;
+export declare const LOG_RETENTION_DAYS = 3;
+export declare const LOG_DIR = "logs";
+export declare const LOG_FILE_PATTERN = "app-{date}.log";
+export declare const CACHE_TTL_SECONDS = 900;
+export declare const MEMORY_CACHE_SIZE = 20;
+export declare const TOOL_NAMES: {
+    readonly SYNC_RESOURCES: "sync_resources";
+    readonly MANAGE_SUBSCRIPTION: "manage_subscription";
+    readonly SEARCH_RESOURCES: "search_resources";
+    readonly UPLOAD_RESOURCE: "upload_resource";
+    readonly UNINSTALL_RESOURCE: "uninstall_resource";
+};
+export declare const TOOL_TIMEOUTS: {
+    readonly search_resources: 10000;
+    readonly sync_resources: 60000;
+    readonly upload_resource: 120000;
+    readonly manage_subscription: 15000;
+    readonly uninstall_resource: 5000;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAC3C,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,OAAO,SAAS,CAAC;AAC9B,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC"}

package/dist/config/constants.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Configuration Constants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_TIMEOUTS = exports.TOOL_NAMES = exports.MEMORY_CACHE_SIZE = exports.CACHE_TTL_SECONDS = exports.LOG_FILE_PATTERN = exports.LOG_DIR = exports.LOG_RETENTION_DAYS = exports.DEFAULT_API_TIMEOUT = exports.DEFAULT_LOG_LEVEL = exports.DEFAULT_PORT = exports.APP_VERSION = exports.APP_NAME = void 0;
+exports.APP_NAME = 'csp-ai-agent-mcp';
+exports.APP_VERSION = '0.1.0';
+exports.DEFAULT_PORT = 5090;
+exports.DEFAULT_LOG_LEVEL = 'info';
+exports.DEFAULT_API_TIMEOUT = 30000;
+exports.LOG_RETENTION_DAYS = 3;
+exports.LOG_DIR = 'logs';
+exports.LOG_FILE_PATTERN = 'app-{date}.log';
+exports.CACHE_TTL_SECONDS = 900; // 15 minutes
+exports.MEMORY_CACHE_SIZE = 20;
+exports.TOOL_NAMES = {
+    SYNC_RESOURCES: 'sync_resources',
+    MANAGE_SUBSCRIPTION: 'manage_subscription',
+    SEARCH_RESOURCES: 'search_resources',
+    UPLOAD_RESOURCE: 'upload_resource',
+    UNINSTALL_RESOURCE: 'uninstall_resource',
+};
+exports.TOOL_TIMEOUTS = {
+    [exports.TOOL_NAMES.SEARCH_RESOURCES]: 10000, // 10s
+    [exports.TOOL_NAMES.SYNC_RESOURCES]: 60000, // 60s
+    [exports.TOOL_NAMES.UPLOAD_RESOURCE]: 120000, // 120s
+    [exports.TOOL_NAMES.MANAGE_SUBSCRIPTION]: 15000, // 15s
+    [exports.TOOL_NAMES.UNINSTALL_RESOURCE]: 5000, // 5s
+};
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,QAAQ,GAAG,kBAAkB,CAAC;AAC9B,QAAA,WAAW,GAAG,OAAO,CAAC;AAEtB,QAAA,YAAY,GAAG,IAAI,CAAC;AACpB,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAC3B,QAAA,mBAAmB,GAAG,KAAK,CAAC;AAE5B,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,OAAO,GAAG,MAAM,CAAC;AACjB,QAAA,gBAAgB,GAAG,gBAAgB,CAAC;AAEpC,QAAA,iBAAiB,GAAG,GAAG,CAAC,CAAC,aAAa;AACtC,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAEvB,QAAA,UAAU,GAAG;IACxB,cAAc,EAAE,gBAAgB;IAChC,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEE,QAAA,aAAa,GAAG;IAC3B,CAAC,kBAAU,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,MAAM;IAC5C,CAAC,kBAAU,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM;IAC1C,CAAC,kBAAU,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO;IAC7C,CAAC,kBAAU,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM;IAC/C,CAAC,kBAAU,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,KAAK;CACpC,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Configuration Management Module
+ * Loads and validates configuration from environment variables
+ */
+export interface Config {
+    nodeEnv: 'development' | 'production' | 'test';
+    port: number;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    transport: {
+        mode: 'stdio' | 'sse';
+    };
+    http?: {
+        host: string;
+        port: number;
+        /** URL path prefix when the server runs behind a reverse proxy sub-path.
+         *  e.g.  HTTP_BASE_PATH=/csp-agent  → SSE at /csp-agent/sse
+         *                                    → messages POST to /csp-agent/message
+         *  Leave empty (default) for direct / root-path deployments.
+         */
+        basePath: string;
+        /**
+         * The public-facing origin clients (Cursor) should use when posting
+         * JSON-RPC messages.  Derived from CSP_API_BASE_URL so that teams only
+         * need one URL configured — the API base and the MCP server share the
+         * same external hostname.
+         *
+         * e.g. CSP_API_BASE_URL=https://zct.zoomdev.us  →  publicOrigin=https://zct.zoomdev.us
+         *
+         * Falls back to PUBLIC_URL env var if set, then to the internal
+         * http://host:port when running locally (where 0.0.0.0 == localhost).
+         */
+        publicOrigin: string;
+    };
+    session?: {
+        timeout: number;
+    };
+    csp: {
+        apiBaseUrl: string;
+        timeout: number;
+    };
+    git: {
+        userName: string;
+        userEmail: string;
+    };
+    resource: Record<string, never>;
+    cache: {
+        enabled: boolean;
+        redis?: {
+            url: string;
+            ttl: number;
+        };
+        memory: {
+            maxSize: number;
+        };
+    };
+    database?: {
+        url: string;
+    };
+    metrics: {
+        enabled: boolean;
+        port?: number;
+    };
+    logging: {
+        dir: string;
+        retentionDays: number;
+    };
+}
+export declare function loadConfig(): Config;
+declare let config: Config;
+export { config };
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,MAAM,WAAW,MAAM;IAErB,OAAO,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;IAG/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAG9C,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;KACvB,CAAC;IAGF,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb;;;;WAIG;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB;;;;;;;;;;WAUG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,GAAG,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QAKnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAKF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAGhC,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YACN,GAAG,EAAE,MAAM,CAAC;YACZ,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;QACF,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IAGF,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAGF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAGF,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAoCD,wBAAgB,UAAU,IAAI,MAAM,CAwFnC;AAGD,QAAA,IAAI,MAAM,EAAE,MAAM,CAAC;AAmBnB,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,190 @@
+"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');
+    return {
+        nodeEnv,
+        port: getEnvNumber('PORT', 5090),
+        logLevel,
+        transport: {
+            mode: transportMode,
+        },
+        http: transportMode === 'sse' ? (() => {
+            const host = getEnv('HTTP_HOST', '0.0.0.0');
+            const port = getEnvNumber('HTTP_PORT', 3000);
+            const basePath = getEnv('HTTP_BASE_PATH', '');
+            // Derive the public-facing origin that external clients (Cursor) will use
+            // to POST JSON-RPC messages.  Priority:
+            //   1. PUBLIC_URL env var — explicit override (e.g. ngrok / custom domain)
+            //   2. Origin extracted from CSP_API_BASE_URL — same host as the API
+            //   3. http://host:port — safe for local dev where host==0.0.0.0==localhost
+            const publicUrl = process.env['PUBLIC_URL'];
+            const cspApiBase = process.env['CSP_API_BASE_URL'] ?? '';
+            let publicOrigin;
+            if (publicUrl) {
+                publicOrigin = publicUrl.replace(/\/$/, '');
+            }
+            else if (cspApiBase) {
+                try {
+                    const u = new URL(cspApiBase);
+                    publicOrigin = u.origin; // e.g. "https://zct.zoomdev.us"
+                }
+                catch {
+                    publicOrigin = `http://${host}:${port}`;
+                }
+            }
+            else {
+                publicOrigin = `http://${host}:${port}`;
+            }
+            return { host, port, basePath, publicOrigin };
+        })() : undefined,
+        session: transportMode === 'sse' ? {
+            timeout: getEnvNumber('SESSION_TIMEOUT', 3600),
+        } : undefined,
+        csp: {
+            apiBaseUrl: getEnv('CSP_API_BASE_URL', 'https://csp.example.com'),
+            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"}