@elliotding/ai-agent-mcp 0.1.0

package/dist/cache/cache-manager.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Multi-Layer Cache Manager
+ * L1: In-memory LRU cache
+ * L2: Redis persistent cache
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const lru_cache_1 = require("lru-cache");
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+const redis_client_1 = require("./redis-client");
+const CACHE_KEY_PREFIX = 'csp:cache';
+class CacheManager {
+    static instance = null;
+    l1;
+    l2;
+    defaultTtlSeconds;
+    defaultNamespace;
+    l1Hits = 0;
+    l2Hits = 0;
+    misses = 0;
+    constructor(options) {
+        const ttlMs = (config_1.config.cache.redis?.ttl ?? 900) * 1000;
+        this.defaultTtlSeconds = config_1.config.cache.redis?.ttl ?? 900;
+        this.defaultNamespace = options?.namespace ?? 'default';
+        this.l1 = new lru_cache_1.LRUCache({
+            max: 100,
+            ttl: ttlMs,
+            ttlAutopurge: true,
+        });
+        this.l2 = redis_client_1.redisClient;
+        logger_1.logger.info({
+            type: 'cache',
+            message: 'CacheManager initialized',
+            l1Max: 100,
+            ttlSeconds: this.defaultTtlSeconds,
+            namespace: this.defaultNamespace,
+        }, 'Multi-layer cache initialized');
+    }
+    static getInstance(options) {
+        if (CacheManager.instance === null) {
+            CacheManager.instance = new CacheManager(options);
+        }
+        return CacheManager.instance;
+    }
+    static async resetInstance() {
+        if (CacheManager.instance) {
+            await CacheManager.instance.clear();
+            await CacheManager.instance.l2.disconnect();
+            CacheManager.instance = null;
+        }
+    }
+    buildKey(key, namespace) {
+        const ns = namespace ?? this.defaultNamespace;
+        return `${CACHE_KEY_PREFIX}:${ns}:${key}`;
+    }
+    getRedisPattern(namespace) {
+        const ns = namespace ?? this.defaultNamespace;
+        return `${CACHE_KEY_PREFIX}:${ns}:*`;
+    }
+    async connect() {
+        await this.l2.connect();
+    }
+    /**
+     * Get value from cache. Checks L1 first, then L2.
+     * On L2 hit, promotes value to L1.
+     */
+    async get(key, namespace) {
+        const fullKey = this.buildKey(key, namespace);
+        const l1Value = this.l1.get(fullKey);
+        if (l1Value !== undefined) {
+            this.l1Hits++;
+            logger_1.logger.debug({ type: 'cache', key: fullKey, layer: 'L1' }, 'Cache L1 hit');
+            return l1Value;
+        }
+        let l2Value = null;
+        try {
+            l2Value = await this.l2.get(fullKey);
+        }
+        catch (error) {
+            logger_1.logger.debug({ type: 'cache', key: fullKey, error: error.message }, 'L2 get failed, Redis may be unavailable');
+        }
+        if (l2Value !== null) {
+            this.l2Hits++;
+            try {
+                const parsed = JSON.parse(l2Value);
+                if (parsed !== null && parsed !== undefined) {
+                    this.l1.set(fullKey, parsed);
+                }
+                logger_1.logger.debug({ type: 'cache', key: fullKey, layer: 'L2' }, 'Cache L2 hit, promoted to L1');
+                return parsed;
+            }
+            catch (error) {
+                logger_1.logger.warn({ type: 'cache', key: fullKey, error: error.message }, 'Failed to parse L2 cache value');
+                try {
+                    await this.l2.del(fullKey);
+                }
+                catch {
+                    /* Redis may be unavailable */
+                }
+                this.misses++;
+                return null;
+            }
+        }
+        this.misses++;
+        logger_1.logger.debug({ type: 'cache', key: fullKey }, 'Cache miss');
+        return null;
+    }
+    /**
+     * Set value in both L1 and L2 caches.
+     */
+    async set(key, value, ttl, namespace) {
+        const fullKey = this.buildKey(key, namespace);
+        const ttlSeconds = ttl ?? this.defaultTtlSeconds;
+        const ttlMs = ttlSeconds * 1000;
+        if (value !== null && value !== undefined) {
+            this.l1.set(fullKey, value, { ttl: ttlMs });
+        }
+        const serialized = JSON.stringify(value);
+        try {
+            await this.l2.set(fullKey, serialized, ttlSeconds);
+        }
+        catch (error) {
+            logger_1.logger.debug({ type: 'cache', key: fullKey, error: error.message }, 'L2 set failed, Redis may be unavailable');
+        }
+        logger_1.logger.debug({ type: 'cache', key: fullKey, ttlSeconds }, 'Cache set');
+    }
+    /**
+     * Delete key from both caches.
+     */
+    async del(key, namespace) {
+        const fullKey = this.buildKey(key, namespace);
+        this.l1.delete(fullKey);
+        try {
+            await this.l2.del(fullKey);
+        }
+        catch (error) {
+            logger_1.logger.debug({ type: 'cache', key: fullKey, error: error.message }, 'L2 del failed, Redis may be unavailable');
+        }
+        logger_1.logger.debug({ type: 'cache', key: fullKey }, 'Cache del');
+    }
+    /**
+     * Clear all cache layers. If namespace provided, clear only that namespace.
+     */
+    async clear(namespace) {
+        if (namespace !== undefined) {
+            const pattern = this.getRedisPattern(namespace);
+            const prefix = `${CACHE_KEY_PREFIX}:${namespace}:`;
+            for (const k of this.l1.keys()) {
+                if (k.startsWith(prefix)) {
+                    this.l1.delete(k);
+                }
+            }
+            try {
+                await this.l2.clear(pattern);
+            }
+            catch (error) {
+                logger_1.logger.debug({ type: 'cache', namespace, error: error.message }, 'L2 clear failed, Redis may be unavailable');
+            }
+            logger_1.logger.info({ type: 'cache', namespace }, 'Cache cleared for namespace');
+        }
+        else {
+            this.l1.clear();
+            try {
+                await this.l2.clear(`${CACHE_KEY_PREFIX}:*`);
+            }
+            catch (error) {
+                logger_1.logger.debug({ type: 'cache', error: error.message }, 'L2 clear failed, Redis may be unavailable');
+            }
+            logger_1.logger.info({ type: 'cache' }, 'Cache cleared');
+        }
+    }
+    getStats() {
+        const total = this.l1Hits + this.l2Hits + this.misses;
+        const hitRate = total > 0 ? (this.l1Hits + this.l2Hits) / total : 0;
+        return {
+            l1Hits: this.l1Hits,
+            l2Hits: this.l2Hits,
+            misses: this.misses,
+            hitRate,
+        };
+    }
+    resetStats() {
+        this.l1Hits = 0;
+        this.l2Hits = 0;
+        this.misses = 0;
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=cache-manager.js.map

package/dist/cache/cache-manager.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cache module exports
+ */
+export { CacheManager, type CacheStats } from './cache-manager';
+export { redisClient, RedisClient } from './redis-client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Cache module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisClient = exports.redisClient = exports.CacheManager = void 0;
+var cache_manager_1 = require("./cache-manager");
+Object.defineProperty(exports, "CacheManager", { enumerable: true, get: function () { return cache_manager_1.CacheManager; } });
+var redis_client_1 = require("./redis-client");
+Object.defineProperty(exports, "redisClient", { enumerable: true, get: function () { return redis_client_1.redisClient; } });
+Object.defineProperty(exports, "RedisClient", { enumerable: true, get: function () { return redis_client_1.RedisClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAgE;AAAvD,6GAAA,YAAY,OAAA;AACrB,+CAA0D;AAAjD,2GAAA,WAAW,OAAA;AAAE,2GAAA,WAAW,OAAA"}

package/dist/cache/redis-client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Redis Client Module
+ * Connection management with retry strategy and basic cache operations
+ */
+export declare class RedisClient {
+    private static instance;
+    private client;
+    private isConnecting;
+    private constructor();
+    static getInstance(): RedisClient;
+    /**
+     * Connect to Redis with config and retry strategy
+     */
+    connect(): Promise<void>;
+    /**
+     * Gracefully disconnect from Redis
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if Redis client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get value by key
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Set value with optional TTL (seconds)
+     */
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    /**
+     * Delete key
+     */
+    del(key: string): Promise<void>;
+    /**
+     * Clear all keys matching a pattern. Use with caution.
+     */
+    clear(pattern?: string): Promise<void>;
+    /**
+     * Check if key exists
+     */
+    exists(key: string): Promise<boolean>;
+}
+export declare const redisClient: RedisClient;
+//# sourceMappingURL=redis-client.d.ts.map

package/dist/cache/redis-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.d.ts","sourceRoot":"","sources":["../../src/cache/redis-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqF9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe9C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrC;;OAEG;IACG,KAAK,CAAC,OAAO,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAc5C;AAED,eAAO,MAAM,WAAW,aAA4B,CAAC"}

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":"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"}

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,54 @@
+/**
+ * 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;
+    };
+    session?: {
+        timeout: number;
+    };
+    csp: {
+        apiBaseUrl: string;
+        apiToken: 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;KACd,CAAC;IAGF,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,GAAG,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,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,CAoEnC;AAGD,QAAA,IAAI,MAAM,EAAE,MAAM,CAAC;AAmBnB,OAAO,EAAE,MAAM,EAAE,CAAC"}