@mseep/mcp-agent-social 1.1.0

package/dist/middleware/timeout.d.ts

@@ -0,0 +1,52 @@
+export interface TimeoutConfig {
+    defaultTimeout: number;
+    methodTimeouts: Record<string, number>;
+    maxTimeout: number;
+}
+export declare class TimeoutManager {
+    private readonly config;
+    private timeoutCount;
+    private activeTimeouts;
+    private readonly timeoutLock;
+    constructor(config?: Partial<TimeoutConfig>);
+    /**
+     * Create a timeout promise for a specific method
+     */
+    createTimeout(method: string): Promise<never>;
+    /**
+     * Create a timeout promise that can be cleared
+     */
+    createClearableTimeout(method: string): {
+        promise: Promise<never>;
+        clear: () => void;
+    };
+    /**
+     * Wrap a promise with timeout
+     */
+    withTimeout<T>(promise: Promise<T>, method: string): Promise<T>;
+    /**
+     * Get timeout duration for a specific method
+     */
+    private getTimeoutForMethod;
+    /**
+     * Clear all active timeouts
+     */
+    clearAllTimeouts(): Promise<void>;
+    /**
+     * Get timeout statistics
+     */
+    getStats(): {
+        totalTimeouts: number;
+        activeTimeouts: number;
+        config: {
+            defaultTimeout: number;
+            maxTimeout: number;
+            methodTimeoutCount: number;
+        };
+    };
+    /**
+     * Update timeout configuration
+     */
+    updateConfig(newConfig: Partial<TimeoutConfig>): void;
+}
+//# sourceMappingURL=timeout.d.ts.map

package/dist/middleware/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/middleware/timeout.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAEnC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAyB3C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA6B7C;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG;QACtC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,EAAE,MAAM,IAAI,CAAC;KACnB;IA2CD;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAarE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAavC;;OAEG;IACH,QAAQ;;;;;;;;;IAYR;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;CAItD"}

package/dist/middleware/timeout.js

@@ -0,0 +1,189 @@
+// ABOUTME: Timeout management for MCP requests
+// ABOUTME: Prevents hanging requests and provides configurable timeout handling
+import { logger } from '../logger.js';
+import { McpTimeoutError } from './error-handler.js';
+// Simple async lock implementation for thread safety
+class AsyncLock {
+    queue = [];
+    locked = false;
+    async acquire() {
+        return new Promise((resolve) => {
+            const unlock = () => {
+                this.locked = false;
+                const next = this.queue.shift();
+                if (next) {
+                    this.locked = true;
+                    next();
+                }
+            };
+            if (this.locked) {
+                this.queue.push(() => resolve(unlock));
+            }
+            else {
+                this.locked = true;
+                resolve(unlock);
+            }
+        });
+    }
+}
+export class TimeoutManager {
+    config;
+    timeoutCount = 0;
+    activeTimeouts = new Set();
+    timeoutLock = new AsyncLock();
+    constructor(config) {
+        this.config = {
+            defaultTimeout: 30000, // 30 seconds
+            maxTimeout: 120000, // 2 minutes
+            methodTimeouts: {
+                'tools/call': 60000, // Tool calls can take longer
+                'sampling/create': 90000, // LLM requests need more time
+                'resources/read': 10000, // Resource reads should be fast
+                'resources/list': 5000,
+                'tools/list': 5000,
+                'prompts/list': 5000,
+                'prompts/get': 10000,
+                'roots/list': 5000,
+                ...config?.methodTimeouts,
+            },
+            ...config,
+        };
+        logger.info('Timeout manager initialized', {
+            defaultTimeout: this.config.defaultTimeout,
+            maxTimeout: this.config.maxTimeout,
+            methodTimeouts: Object.keys(this.config.methodTimeouts).length,
+        });
+    }
+    /**
+     * Create a timeout promise for a specific method
+     */
+    createTimeout(method) {
+        const timeoutMs = this.getTimeoutForMethod(method);
+        return new Promise((_, reject) => {
+            const timeoutId = setTimeout(async () => {
+                // Use lock for thread-safe updates
+                const unlock = await this.timeoutLock.acquire();
+                try {
+                    this.timeoutCount++;
+                    this.activeTimeouts.delete(timeoutId);
+                }
+                finally {
+                    unlock();
+                }
+                logger.warn('Request timed out', {
+                    method,
+                    timeout: timeoutMs,
+                    totalTimeouts: this.timeoutCount,
+                });
+                const error = new McpTimeoutError(`Request timed out after ${timeoutMs}ms`, timeoutMs);
+                reject(error);
+            }, timeoutMs);
+            // Thread-safe addition to active timeouts
+            this.activeTimeouts.add(timeoutId);
+        });
+    }
+    /**
+     * Create a timeout promise that can be cleared
+     */
+    createClearableTimeout(method) {
+        const timeoutMs = this.getTimeoutForMethod(method);
+        let timeoutId;
+        const promise = new Promise((_, reject) => {
+            timeoutId = setTimeout(async () => {
+                // Use lock for thread-safe updates
+                const unlock = await this.timeoutLock.acquire();
+                try {
+                    this.timeoutCount++;
+                    this.activeTimeouts.delete(timeoutId);
+                }
+                finally {
+                    unlock();
+                }
+                logger.warn('Request timed out', {
+                    method,
+                    timeout: timeoutMs,
+                });
+                const error = new McpTimeoutError(`Request timed out after ${timeoutMs}ms`, timeoutMs);
+                reject(error);
+            }, timeoutMs);
+            this.activeTimeouts.add(timeoutId);
+        });
+        const clear = async () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                // Use lock for thread-safe removal
+                const unlock = await this.timeoutLock.acquire();
+                try {
+                    this.activeTimeouts.delete(timeoutId);
+                }
+                finally {
+                    unlock();
+                }
+            }
+        };
+        return { promise, clear };
+    }
+    /**
+     * Wrap a promise with timeout
+     */
+    async withTimeout(promise, method) {
+        const { promise: timeoutPromise, clear } = this.createClearableTimeout(method);
+        try {
+            const result = await Promise.race([promise, timeoutPromise]);
+            clear();
+            return result;
+        }
+        catch (error) {
+            clear();
+            throw error;
+        }
+    }
+    /**
+     * Get timeout duration for a specific method
+     */
+    getTimeoutForMethod(method) {
+        const methodTimeout = this.config.methodTimeouts[method];
+        if (methodTimeout) {
+            return Math.min(methodTimeout, this.config.maxTimeout);
+        }
+        return this.config.defaultTimeout;
+    }
+    /**
+     * Clear all active timeouts
+     */
+    async clearAllTimeouts() {
+        const unlock = await this.timeoutLock.acquire();
+        try {
+            for (const timeoutId of this.activeTimeouts) {
+                clearTimeout(timeoutId);
+            }
+            this.activeTimeouts.clear();
+        }
+        finally {
+            unlock();
+        }
+        logger.info('Cleared all active timeouts');
+    }
+    /**
+     * Get timeout statistics
+     */
+    getStats() {
+        return {
+            totalTimeouts: this.timeoutCount,
+            activeTimeouts: this.activeTimeouts.size,
+            config: {
+                defaultTimeout: this.config.defaultTimeout,
+                maxTimeout: this.config.maxTimeout,
+                methodTimeoutCount: Object.keys(this.config.methodTimeouts).length,
+            },
+        };
+    }
+    /**
+     * Update timeout configuration
+     */
+    updateConfig(newConfig) {
+        Object.assign(this.config, newConfig);
+        logger.info('Timeout configuration updated', { config: this.config });
+    }
+}
+//# sourceMappingURL=timeout.js.map

package/dist/middleware/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/middleware/timeout.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,gFAAgF;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,qDAAqD;AACrD,MAAM,SAAS;IACL,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAG,KAAK,CAAC;IAEvB,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;gBACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;oBACnB,IAAI,EAAE,CAAC;gBACT,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAQD,MAAM,OAAO,cAAc;IACR,MAAM,CAAgB;IAC/B,YAAY,GAAG,CAAC,CAAC;IACjB,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,WAAW,GAAG,IAAI,SAAS,EAAE,CAAC;IAE/C,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,KAAK,EAAE,aAAa;YACpC,UAAU,EAAE,MAAM,EAAE,YAAY;YAChC,cAAc,EAAE;gBACd,YAAY,EAAE,KAAK,EAAE,6BAA6B;gBAClD,iBAAiB,EAAE,KAAK,EAAE,8BAA8B;gBACxD,gBAAgB,EAAE,KAAK,EAAE,gCAAgC;gBACzD,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,KAAK;gBACpB,YAAY,EAAE,IAAI;gBAClB,GAAG,MAAM,EAAE,cAAc;aAC1B;YACD,GAAG,MAAM;SACV,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM;SAC/D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEnD,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBACtC,mCAAmC;gBACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC;wBAAS,CAAC;oBACT,MAAM,EAAE,CAAC;gBACX,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBAC/B,MAAM;oBACN,OAAO,EAAE,SAAS;oBAClB,aAAa,EAAE,IAAI,CAAC,YAAY;iBACjC,CAAC,CAAC;gBAEH,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,2BAA2B,SAAS,IAAI,EAAE,SAAS,CAAC,CAAC;gBACvF,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,0CAA0C;YAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAc;QAInC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,SAAyB,CAAC;QAE9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBAChC,mCAAmC;gBACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC;wBAAS,CAAC;oBACT,MAAM,EAAE,CAAC;gBACX,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBAC/B,MAAM;oBACN,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;gBAEH,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,2BAA2B,SAAS,IAAI,EAAE,SAAS,CAAC,CAAC;gBACvF,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;YACvB,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,mCAAmC;gBACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC;wBAAS,CAAC;oBACT,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAI,OAAmB,EAAE,MAAc;QACtD,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YAC7D,KAAK,EAAE,CAAC;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,EAAE,CAAC;YACR,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAc;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC5C,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;YACxC,MAAM,EAAE;gBACN,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;gBAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM;aACnE;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiC;QAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/middleware/validator.d.ts

@@ -0,0 +1,25 @@
+export declare class RequestValidator {
+    private validationCount;
+    private validationErrors;
+    /**
+     * Validate an MCP request
+     */
+    validateRequest(request: any): Promise<void>;
+    /**
+     * Validate an MCP response
+     */
+    validateResponse(response: any, method: string): Promise<void>;
+    /**
+     * Perform additional custom validations
+     */
+    private performCustomValidations;
+    /**
+     * Get validation statistics
+     */
+    getStats(): {
+        totalValidations: number;
+        validationErrors: number;
+        successRate: number;
+    };
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/middleware/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/middleware/validator.ts"],"names":[],"mappings":"AAkFA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsClD;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpE;;OAEG;YACW,wBAAwB;IA2CtC;;OAEG;IACH,QAAQ;;;;;CAUT"}

package/dist/middleware/validator.js

@@ -0,0 +1,186 @@
+// ABOUTME: Protocol-level request and response validation
+// ABOUTME: Ensures MCP protocol compliance and data integrity
+import { z } from 'zod';
+import { logger } from '../logger.js';
+// Base MCP request schema
+const McpRequestSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.union([z.string(), z.number(), z.null()]),
+    method: z.string(),
+    params: z.record(z.any()).optional(),
+});
+// Base MCP response schema
+const McpResponseSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.union([z.string(), z.number(), z.null()]),
+    result: z.any().optional(),
+    error: z
+        .object({
+        code: z.number(),
+        message: z.string(),
+        data: z.any().optional(),
+    })
+        .optional(),
+});
+// Method-specific validation schemas (only validate params, base structure already validated)
+const MethodSchemas = {
+    'tools/list': {
+        request: z.object({
+            params: z.object({}).optional(),
+        }),
+        response: z.object({
+            tools: z.array(z.object({
+                name: z.string(),
+                description: z.string(),
+                inputSchema: z.record(z.any()),
+            })),
+        }),
+    },
+    'tools/call': {
+        request: z.object({
+            params: z.object({
+                name: z.string(),
+                arguments: z.record(z.any()).optional(),
+            }),
+        }),
+        response: z.object({
+            content: z.array(z.object({
+                type: z.string(),
+                text: z.string().optional(),
+                data: z.any().optional(),
+            })),
+        }),
+    },
+    'resources/list': {
+        request: z.object({
+            params: z
+                .object({
+                cursor: z.string().optional(),
+            })
+                .optional(),
+        }),
+        response: z.object({
+            resources: z.array(z.object({
+                uri: z.string(),
+                name: z.string(),
+                description: z.string().optional(),
+                mimeType: z.string().optional(),
+            })),
+        }),
+    },
+};
+export class RequestValidator {
+    validationCount = 0;
+    validationErrors = 0;
+    /**
+     * Validate an MCP request
+     */
+    async validateRequest(request) {
+        this.validationCount++;
+        try {
+            // Validate base MCP structure
+            McpRequestSchema.parse(request);
+            // Then validate method-specific params only (avoiding redundant validation)
+            const methodSchema = MethodSchemas[request.method];
+            if (methodSchema?.request) {
+                // Extract just the params and validate them separately
+                const paramsToValidate = { params: request.params };
+                methodSchema.request.parse(paramsToValidate);
+            }
+            // Additional custom validations
+            await this.performCustomValidations(request);
+            logger.debug('Request validation passed', {
+                method: request.method,
+                id: request.id,
+            });
+        }
+        catch (error) {
+            this.validationErrors++;
+            if (error instanceof z.ZodError) {
+                const validationError = new Error(`Request validation failed: ${error.errors.map((e) => e.message).join(', ')}`);
+                validationError.code = -32602; // Invalid params
+                validationError.data = error.errors;
+                throw validationError;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate an MCP response
+     */
+    async validateResponse(response, method) {
+        try {
+            // Validate base response structure
+            McpResponseSchema.parse(response);
+            // Validate method-specific response if available
+            const methodSchema = MethodSchemas[method];
+            if (methodSchema?.response && response.result) {
+                methodSchema.response.parse(response.result);
+            }
+            logger.debug('Response validation passed', { method });
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const validationError = new Error(`Response validation failed: ${error.errors.map((e) => e.message).join(', ')}`);
+                validationError.code = -32603; // Internal error
+                validationError.data = error.errors;
+                throw validationError;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Perform additional custom validations
+     */
+    async performCustomValidations(request) {
+        // Validate content length limits
+        if (request.params) {
+            const stringContent = JSON.stringify(request.params);
+            if (stringContent.length > 100000) {
+                // 100KB limit
+                throw new Error('Request payload exceeds maximum size limit');
+            }
+        }
+        // Validate method exists
+        const allowedMethods = [
+            'tools/list',
+            'tools/call',
+            'resources/list',
+            'resources/read',
+            'prompts/list',
+            'prompts/get',
+            'sampling/create',
+            'roots/list',
+        ];
+        if (!allowedMethods.includes(request.method)) {
+            const error = new Error(`Method not found: ${request.method}`);
+            error.code = -32601;
+            throw error;
+        }
+        // Validate specific parameter constraints
+        if (request.method === 'sampling/create' && request.params?.messages) {
+            const messageCount = request.params.messages.length;
+            if (messageCount > 50) {
+                throw new Error('Too many messages in sampling request (max 50)');
+            }
+            for (const message of request.params.messages) {
+                if (message.content.length > 10000) {
+                    throw new Error('Message content exceeds maximum length (10000 characters)');
+                }
+            }
+        }
+    }
+    /**
+     * Get validation statistics
+     */
+    getStats() {
+        return {
+            totalValidations: this.validationCount,
+            validationErrors: this.validationErrors,
+            successRate: this.validationCount > 0
+                ? (this.validationCount - this.validationErrors) / this.validationCount
+                : 1,
+        };
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/middleware/validator.js.map

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

package/dist/prompts/analyze.d.ts

@@ -0,0 +1,46 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { GetPromptResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import type { IApiClient } from '../api-client.js';
+export interface AnalyzePromptContext {
+    apiClient: IApiClient;
+}
+export declare function analyzeSentimentPrompt(args: {
+    scope: string;
+    target?: string;
+}, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>, context: AnalyzePromptContext): Promise<GetPromptResult>;
+export declare function findRelatedDiscussionsPrompt(args: {
+    topic: string;
+    limit?: string;
+}, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>, context: AnalyzePromptContext): Promise<GetPromptResult>;
+export declare function generateEngagementReportPrompt(args: {
+    time_period?: string;
+    focus?: string;
+}, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>, context: AnalyzePromptContext): Promise<GetPromptResult>;
+export declare const analyzePrompts: {
+    analyzeSentiment: {
+        description: string;
+        argsSchema: {
+            scope: z.ZodString;
+            target: z.ZodOptional<z.ZodString>;
+        };
+        handler: typeof analyzeSentimentPrompt;
+    };
+    findRelatedDiscussions: {
+        description: string;
+        argsSchema: {
+            topic: z.ZodString;
+            limit: z.ZodOptional<z.ZodString>;
+        };
+        handler: typeof findRelatedDiscussionsPrompt;
+    };
+    generateEngagementReport: {
+        description: string;
+        argsSchema: {
+            time_period: z.ZodOptional<z.ZodString>;
+            focus: z.ZodOptional<z.ZodString>;
+        };
+        handler: typeof generateEngagementReportPrompt;
+    };
+};
+//# sourceMappingURL=analyze.d.ts.map

package/dist/prompts/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/prompts/analyze.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,UAAU,CAAC;CACvB;AAOD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,EAC9D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA8J1B;AAOD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACvC,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,EAC9D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAgF1B;AAOD,wBAAsB,8BAA8B,CAClD,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,EAC9D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAgG1B;AAGD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAgB1B,CAAC"}