@elliotding/ai-agent-mcp 0.1.26 → 0.1.28

package/dist/server.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * MCP Server Main Logic
+ * Implements Model Context Protocol server with dual transport support
+ */
+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.startServer = startServer;
+exports.stopServer = stopServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const logger_1 = require("./utils/logger");
+const config_1 = require("./config");
+const registry_1 = require("./tools/registry");
+const tools_1 = require("./tools");
+const http_1 = require("./server/http");
+let server = null;
+/**
+ * Register all MCP tools
+ */
+function registerTools() {
+    logger_1.logger.info('Registering MCP tools...');
+    registry_1.toolRegistry.registerTool(tools_1.syncResourcesTool);
+    registry_1.toolRegistry.registerTool(tools_1.manageSubscriptionTool);
+    registry_1.toolRegistry.registerTool(tools_1.searchResourcesTool);
+    registry_1.toolRegistry.registerTool(tools_1.uploadResourceTool);
+    registry_1.toolRegistry.registerTool(tools_1.uninstallResourceTool);
+    registry_1.toolRegistry.registerTool(tools_1.trackUsageTool);
+    registry_1.toolRegistry.registerTool(tools_1.resolvePromptContentTool);
+    logger_1.logger.info({ toolCount: registry_1.toolRegistry.getToolCount() }, `Registered ${registry_1.toolRegistry.getToolCount()} MCP tools`);
+}
+/**
+ * Start MCP Server with stdio transport
+ */
+async function startStdioServer() {
+    logger_1.logger.info('Starting MCP Server with stdio transport...');
+    // Create MCP Server
+    server = new index_js_1.Server({
+        name: 'csp-ai-agent-mcp',
+        version: '0.2.0',
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    // Install Prompt list/get handlers so Command and Skill resources are
+    // exposed as MCP Prompts (Cursor slash commands).
+    const { promptManager } = await Promise.resolve().then(() => __importStar(require('./prompts/index.js')));
+    promptManager.installHandlers(server);
+    // Handle tools/list request
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => {
+        const tools = registry_1.toolRegistry.getMCPToolDefinitions();
+        logger_1.logger.debug({ toolCount: tools.length }, 'tools/list request handled');
+        return {
+            tools,
+        };
+    });
+    // Handle tools/call request
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        logger_1.logger.info({ toolName: name, arguments: args }, `tools/call request: ${name}`);
+        const tool = registry_1.toolRegistry.getTool(name);
+        if (!tool) {
+            const error = `Tool not found: ${name}`;
+            logger_1.logger.error({ toolName: name }, error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: {
+                                code: 'TOOL_NOT_FOUND',
+                                message: error,
+                            },
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Call the tool handler
+            const result = await tool.handler(args || {});
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error({ toolName: name, error: errorMessage }, `Tool execution failed: ${name}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: {
+                                code: 'TOOL_EXECUTION_ERROR',
+                                message: errorMessage,
+                            },
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Connect to stdio transport
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    // Flush any pending telemetry immediately — stdio reconnects when Cursor
+    // restarts the process, so treat connect as a reconnect event.
+    const { telemetry: tel } = await Promise.resolve().then(() => __importStar(require('./telemetry/index.js')));
+    tel.flushOnReconnect();
+    logger_1.logger.info('✅ MCP Server started successfully (stdio transport)');
+}
+/**
+ * Start MCP Server with SSE transport
+ */
+async function startSSEServer() {
+    logger_1.logger.info('Starting MCP Server with SSE transport...');
+    // Start HTTP server
+    await http_1.httpServer.start();
+    logger_1.logger.info('✅ MCP Server started successfully (SSE transport)');
+}
+/**
+ * Start MCP Server (auto-detect transport mode)
+ */
+async function startServer() {
+    // Register all tools (common for both transports)
+    registerTools();
+    // Start server based on transport mode
+    const transportMode = config_1.config.transport.mode;
+    logger_1.logger.info({ transportMode }, `Starting server with ${transportMode} transport`);
+    if (transportMode === 'sse') {
+        await startSSEServer();
+    }
+    else {
+        await startStdioServer();
+    }
+}
+/**
+ * Stop MCP Server
+ */
+async function stopServer() {
+    logger_1.logger.info('Stopping MCP Server...');
+    const transportMode = config_1.config.transport.mode;
+    if (transportMode === 'sse') {
+        // Stop HTTP server
+        await http_1.httpServer.stop();
+    }
+    else {
+        // Stop stdio server
+        if (server) {
+            await server.close();
+            server = null;
+        }
+    }
+    logger_1.logger.info('MCP Server stopped');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session/manager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Session Manager
+ * Manages SSE sessions and connections
+ */
+import type { ServerResponse } from 'http';
+export interface Session {
+    id: string;
+    userId: string;
+    email: string;
+    groups: string[];
+    token: string;
+    ip: string;
+    createdAt: Date;
+    lastActivity: Date;
+    connection?: ServerResponse;
+}
+export interface CreateSessionOptions {
+    userId?: string;
+    email?: string;
+    groups?: string[];
+}
+export declare class SessionManager {
+    private sessions;
+    private totalSessions;
+    private cleanupInterval?;
+    constructor();
+    /**
+     * Create new session
+     * @param token - Auth token (JWT from CSP)
+     * @param ip - Client IP address
+     * @param options - User info from /user/permissions API (userId, email, groups)
+     */
+    createSession(token: string, ip: string, options?: CreateSessionOptions): Promise<Session>;
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId: string): Session | undefined;
+    /**
+     * Register SSE connection with session
+     */
+    registerConnection(sessionId: string, connection: ServerResponse): void;
+    /**
+     * Send message to session via SSE
+     * Enhanced error handling to prevent EPIPE errors
+     * Note: This is synchronous for SSE transport compatibility
+     */
+    sendMessage(sessionId: string, message: unknown): boolean;
+    /**
+     * Update session activity timestamp
+     */
+    updateActivity(sessionId: string): void;
+    /**
+     * Close session with improved error handling
+     */
+    closeSession(sessionId: string): void;
+    /**
+     * Close all sessions
+     */
+    closeAllSessions(): void;
+    /**
+     * Get active session count
+     */
+    getActiveSessionCount(): number;
+    /**
+     * Get total session count (since server start)
+     */
+    getTotalSessionCount(): number;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): Session[];
+    /**
+     * Start cleanup interval for expired sessions
+     */
+    private startCleanup;
+    /**
+     * Stop cleanup interval
+     */
+    stopCleanup(): void;
+    /**
+     * Cleanup expired sessions
+     */
+    private cleanupExpiredSessions;
+    /**
+     * Extract user ID from token (simplified)
+     * TODO: Implement proper JWT validation in Stage 5
+     */
+    private extractUserIdFromToken;
+}
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAI3C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,eAAe,CAAC,CAAiB;;IAOzC;;;;;OAKG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC;IA0BnB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI;IAQvE;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAoDzD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA0CrC;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAQxB;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,iBAAiB,IAAI,OAAO,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAK/B;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/session/manager.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Session Manager
+ * Manages SSE sessions and connections
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionManager = exports.SessionManager = void 0;
+const crypto_1 = require("crypto");
+const logger_1 = require("../utils/logger");
+const config_1 = require("../config");
+class SessionManager {
+    sessions = new Map();
+    totalSessions = 0;
+    cleanupInterval;
+    constructor() {
+        // Start cleanup interval
+        this.startCleanup();
+    }
+    /**
+     * Create new session
+     * @param token - Auth token (JWT from CSP)
+     * @param ip - Client IP address
+     * @param options - User info from /user/permissions API (userId, email, groups)
+     */
+    async createSession(token, ip, options) {
+        const sessionId = (0, crypto_1.randomUUID)();
+        const userId = options?.userId ?? this.extractUserIdFromToken(token);
+        const email = options?.email ?? '';
+        const groups = options?.groups ?? [];
+        const session = {
+            id: sessionId,
+            userId,
+            email,
+            groups,
+            token,
+            ip,
+            createdAt: new Date(),
+            lastActivity: new Date(),
+        };
+        this.sessions.set(sessionId, session);
+        this.totalSessions++;
+        logger_1.logger.info({ sessionId, userId, email, groups, ip }, 'Session created');
+        return session;
+    }
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Register SSE connection with session
+     */
+    registerConnection(sessionId, connection) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.connection = connection;
+            logger_1.logger.debug({ sessionId }, 'Connection registered with session');
+        }
+    }
+    /**
+     * Send message to session via SSE
+     * Enhanced error handling to prevent EPIPE errors
+     * Note: This is synchronous for SSE transport compatibility
+     */
+    sendMessage(sessionId, message) {
+        const session = this.sessions.get(sessionId);
+        if (!session || !session.connection || session.connection.destroyed) {
+            logger_1.logger.debug({ sessionId }, 'Cannot send message: session not found or connection closed');
+            return false;
+        }
+        try {
+            const data = JSON.stringify(message);
+            // Use write callback to detect errors (fire-and-forget)
+            let writeSuccess = true;
+            session.connection.write(`data: ${data}\n\n`, (err) => {
+                if (err) {
+                    // Handle specific error types
+                    if (err.message.includes('EPIPE') || err.message.includes('ECONNRESET')) {
+                        logger_1.logger.debug({
+                            sessionId,
+                            error: err.message
+                        }, 'Message write failed (client disconnected)');
+                    }
+                    else {
+                        logger_1.logger.warn({
+                            sessionId,
+                            error: err.message
+                        }, 'Message write failed');
+                    }
+                    writeSuccess = false;
+                }
+                else {
+                    logger_1.logger.debug({ sessionId, messageSize: data.length }, 'Message sent to session');
+                }
+            });
+            return writeSuccess;
+        }
+        catch (error) {
+            // Catch synchronous errors
+            if (error instanceof Error) {
+                if (error.message.includes('EPIPE') || error.message.includes('ECONNRESET')) {
+                    logger_1.logger.debug({
+                        sessionId,
+                        error: error.message
+                    }, 'Message send failed (client disconnected)');
+                }
+                else {
+                    logger_1.logger.error({
+                        error: error.message,
+                        sessionId
+                    }, 'Failed to send message to session');
+                }
+            }
+            return false;
+        }
+    }
+    /**
+     * Update session activity timestamp
+     */
+    updateActivity(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActivity = new Date();
+        }
+    }
+    /**
+     * Close session with improved error handling
+     */
+    closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            // Close connection if exists
+            if (session.connection && !session.connection.destroyed) {
+                try {
+                    // Try to send close message
+                    session.connection.write(`data: ${JSON.stringify({ type: 'close' })}\n\n`, (err) => {
+                        if (err) {
+                            logger_1.logger.debug({
+                                sessionId,
+                                error: err.message
+                            }, 'Close message write failed (expected if client already disconnected)');
+                        }
+                    });
+                    // End connection
+                    session.connection.end();
+                }
+                catch (error) {
+                    if (error instanceof Error) {
+                        // Only log non-EPIPE errors as warnings
+                        if (error.message.includes('EPIPE') || error.message.includes('ECONNRESET')) {
+                            logger_1.logger.debug({
+                                sessionId,
+                                error: error.message
+                            }, 'Connection already closed');
+                        }
+                        else {
+                            logger_1.logger.warn({
+                                sessionId,
+                                error: error.message
+                            }, 'Error closing connection');
+                        }
+                    }
+                }
+            }
+            // Remove session
+            this.sessions.delete(sessionId);
+            logger_1.logger.info({ sessionId }, 'Session closed');
+        }
+    }
+    /**
+     * Close all sessions
+     */
+    closeAllSessions() {
+        logger_1.logger.info({ count: this.sessions.size }, 'Closing all sessions');
+        for (const [sessionId] of this.sessions) {
+            this.closeSession(sessionId);
+        }
+    }
+    /**
+     * Get active session count
+     */
+    getActiveSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Get total session count (since server start)
+     */
+    getTotalSessionCount() {
+        return this.totalSessions;
+    }
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Start cleanup interval for expired sessions
+     */
+    startCleanup() {
+        const timeout = config_1.config.session?.timeout || 3600; // Default 1 hour
+        const cleanupInterval = 60000; // Check every 1 minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupExpiredSessions(timeout);
+        }, cleanupInterval);
+        logger_1.logger.info({ timeout, cleanupInterval }, 'Session cleanup started');
+    }
+    /**
+     * Stop cleanup interval
+     */
+    stopCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+            logger_1.logger.info('Session cleanup stopped');
+        }
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    cleanupExpiredSessions(timeoutSeconds) {
+        const now = Date.now();
+        const expiredSessions = [];
+        for (const [sessionId, session] of this.sessions) {
+            const inactiveTime = (now - session.lastActivity.getTime()) / 1000;
+            if (inactiveTime > timeoutSeconds) {
+                expiredSessions.push(sessionId);
+            }
+        }
+        if (expiredSessions.length > 0) {
+            logger_1.logger.info({ count: expiredSessions.length }, 'Cleaning up expired sessions');
+            for (const sessionId of expiredSessions) {
+                this.closeSession(sessionId);
+            }
+        }
+    }
+    /**
+     * Extract user ID from token (simplified)
+     * TODO: Implement proper JWT validation in Stage 5
+     */
+    extractUserIdFromToken(token) {
+        // For now, use a simple hash or the token itself
+        // In Stage 5, this should decode and validate JWT
+        return token.substring(0, 16);
+    }
+}
+exports.SessionManager = SessionManager;
+// Singleton instance
+exports.sessionManager = new SessionManager();
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export { TelemetryManager, telemetry } from './manager.js';
+export type { ResourceCategory, InvocationEvent, SubscribedRule, ConfiguredMcp, TelemetryFile, TelemetryReportPayload, ReportFn, } from './manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,QAAQ,GACT,MAAM,cAAc,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.telemetry = exports.TelemetryManager = void 0;
+var manager_js_1 = require("./manager.js");
+Object.defineProperty(exports, "TelemetryManager", { enumerable: true, get: function () { return manager_js_1.TelemetryManager; } });
+Object.defineProperty(exports, "telemetry", { enumerable: true, get: function () { return manager_js_1.telemetry; } });
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAAlD,8GAAA,gBAAgB,OAAA;AAAE,uGAAA,SAAS,OAAA"}