@elliotding/ai-agent-mcp 0.1.0

package/dist/utils/validation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Request Validation Utilities
+ * Enhanced validation with clear error messages
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    expected?: string;
+    received?: any;
+    suggestion?: string;
+}
+export declare class RequestValidationError extends Error {
+    errors: ValidationError[];
+    statusCode: number;
+    constructor(errors: ValidationError[], statusCode?: number);
+    toJSON(): {
+        error: string;
+        message: string;
+        details: ValidationError[];
+    };
+}
+/**
+ * Validate required field
+ */
+export declare function validateRequired(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate string type
+ */
+export declare function validateString(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate enum value
+ */
+export declare function validateEnum(value: any, fieldName: string, allowedValues: readonly string[]): ValidationError | null;
+/**
+ * Validate array type
+ */
+export declare function validateArray(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate object type
+ */
+export declare function validateObject(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate boolean type
+ */
+export declare function validateBoolean(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate number type
+ */
+export declare function validateNumber(value: any, fieldName: string): ValidationError | null;
+/**
+ * Validate SSE connection parameters
+ */
+export declare function validateSSEConnectionParams(_body: any): ValidationError[];
+/**
+ * Validate message parameters
+ */
+export declare function validateMessageParams(body: any): ValidationError[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IACxC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;gBAEd,MAAM,EAAE,eAAe,EAAE,EAAE,UAAU,SAAM;IAQvD,MAAM;;;;;CAOP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,eAAe,GAAG,IAAI,CAcxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAUxB;AA8DD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,GAAG,GAAG,eAAe,EAAE,CAOzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,CAqBlE"}

package/dist/utils/validation.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Request Validation Utilities
+ * Enhanced validation with clear error messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestValidationError = void 0;
+exports.validateRequired = validateRequired;
+exports.validateString = validateString;
+exports.validateEnum = validateEnum;
+exports.validateArray = validateArray;
+exports.validateObject = validateObject;
+exports.validateBoolean = validateBoolean;
+exports.validateNumber = validateNumber;
+exports.validateSSEConnectionParams = validateSSEConnectionParams;
+exports.validateMessageParams = validateMessageParams;
+class RequestValidationError extends Error {
+    errors;
+    statusCode;
+    constructor(errors, statusCode = 400) {
+        const message = errors.map(e => `${e.field}: ${e.message}`).join('; ');
+        super(message);
+        this.name = 'RequestValidationError';
+        this.errors = errors;
+        this.statusCode = statusCode;
+    }
+    toJSON() {
+        return {
+            error: 'Validation Error',
+            message: this.message,
+            details: this.errors,
+        };
+    }
+}
+exports.RequestValidationError = RequestValidationError;
+/**
+ * Validate required field
+ */
+function validateRequired(value, fieldName) {
+    if (value === undefined || value === null || value === '') {
+        return {
+            field: fieldName,
+            message: `Missing required field: '${fieldName}'`,
+            expected: 'non-empty value',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate string type
+ */
+function validateString(value, fieldName) {
+    if (typeof value !== 'string') {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a string`,
+            expected: 'string',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate enum value
+ */
+function validateEnum(value, fieldName, allowedValues) {
+    if (!allowedValues.includes(value)) {
+        // Find closest match for suggestion
+        const suggestion = findClosestMatch(value, allowedValues);
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' has invalid value`,
+            expected: `one of: ${allowedValues.map(v => `'${v}'`).join(', ')}`,
+            received: value,
+            suggestion: suggestion ? `Did you mean '${suggestion}'?` : undefined,
+        };
+    }
+    return null;
+}
+/**
+ * Validate array type
+ */
+function validateArray(value, fieldName) {
+    if (!Array.isArray(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be an array`,
+            expected: 'array',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate object type
+ */
+function validateObject(value, fieldName) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be an object`,
+            expected: 'object',
+            received: Array.isArray(value) ? 'array' : typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate boolean type
+ */
+function validateBoolean(value, fieldName) {
+    if (typeof value !== 'boolean') {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a boolean`,
+            expected: 'boolean (true or false)',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate number type
+ */
+function validateNumber(value, fieldName) {
+    if (typeof value !== 'number' || isNaN(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a number`,
+            expected: 'number',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Find closest string match (simple Levenshtein distance)
+ */
+function findClosestMatch(value, candidates) {
+    if (!value || typeof value !== 'string') {
+        return null;
+    }
+    let minDistance = Infinity;
+    let closest = null;
+    for (const candidate of candidates) {
+        const distance = levenshteinDistance(value.toLowerCase(), candidate.toLowerCase());
+        if (distance < minDistance && distance <= 2) {
+            // Only suggest if distance is small
+            minDistance = distance;
+            closest = candidate;
+        }
+    }
+    return closest;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Validate SSE connection parameters
+ */
+function validateSSEConnectionParams(_body) {
+    const errors = [];
+    // Validate Authorization header (will be checked in middleware)
+    // No body parameters required for SSE connection
+    return errors;
+}
+/**
+ * Validate message parameters
+ */
+function validateMessageParams(body) {
+    const errors = [];
+    // sessionId is required
+    const sessionIdError = validateRequired(body.sessionId, 'sessionId');
+    if (sessionIdError) {
+        errors.push(sessionIdError);
+    }
+    else {
+        const sessionIdTypeError = validateString(body.sessionId, 'sessionId');
+        if (sessionIdTypeError) {
+            errors.push(sessionIdTypeError);
+        }
+    }
+    // message is required
+    const messageError = validateRequired(body.message, 'message');
+    if (messageError) {
+        errors.push(messageError);
+    }
+    return errors;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@elliotding/ai-agent-mcp",
+  "version": "0.1.0",
+  "description": "CSP AI Agent MCP Server - Centralized AI tools distribution and management",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "csp-ai-agent-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "NODE_PATH=. node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "type-check": "tsc --noEmit",
+    "test": "echo \"Error: no test runner configured yet\" && exit 1",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "cursor",
+    "tools-management"
+  ],
+  "author": "CSP Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "dependencies": {
+    "@fastify/cors": "^11.2.0",
+    "@fastify/helmet": "^13.0.2",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "dotenv": "^16.4.0",
+    "fastify": "^5.8.2",
+    "ioredis": "^5.10.0",
+    "lru-cache": "^11.2.6",
+    "pino": "^8.19.0",
+    "pino-pretty": "^11.0.0",
+    "pino-roll": "^4.0.0",
+    "simple-git": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/api/cached-client.ts

@@ -0,0 +1,144 @@
+/**
+ * Cached API Client
+ * Wraps API Client with caching layer
+ */
+
+import { CacheManager } from '../cache';
+import { apiClient } from './client';
+import { config } from '../config';
+import { logger } from '../utils/logger';
+import { AxiosRequestConfig } from 'axios';
+
+class CachedAPIClient {
+  private cache: CacheManager | null = null;
+  private readonly cacheNamespace = 'api';
+
+  constructor() {
+    if (config.cache.enabled) {
+      this.cache = CacheManager.getInstance({ namespace: this.cacheNamespace });
+      logger.info('Cached API client initialized with caching enabled');
+    } else {
+      logger.info('Cached API client initialized without caching');
+    }
+  }
+
+  /**
+   * Initialize cache connection
+   */
+  async connect(): Promise<void> {
+    if (this.cache) {
+      await this.cache.connect();
+    }
+  }
+
+  /**
+   * Generate cache key from URL and config
+   */
+  private generateCacheKey(method: string, url: string, data?: unknown): string {
+    const parts = [method.toUpperCase(), url];
+    if (data) {
+      parts.push(JSON.stringify(data));
+    }
+    return parts.join(':');
+  }
+
+  /**
+   * GET request with caching
+   */
+  async get<T>(url: string, options?: { config?: AxiosRequestConfig; skipCache?: boolean }): Promise<T> {
+    const cacheKey = this.generateCacheKey('GET', url);
+
+    // Try cache first (if enabled and not skipped)
+    if (this.cache && !options?.skipCache) {
+      const cached = await this.cache.get(cacheKey);
+      if (cached !== null) {
+        logger.debug({ url, cacheKey }, 'API cache hit');
+        return cached as T;
+      }
+      logger.debug({ url, cacheKey }, 'API cache miss');
+    }
+
+    // Fetch from API
+    const result = await apiClient.get<T>(url, options?.config);
+
+    // Store in cache (if enabled)
+    if (this.cache && !options?.skipCache) {
+      await this.cache.set(cacheKey, result);
+      logger.debug({ url, cacheKey }, 'API response cached');
+    }
+
+    return result;
+  }
+
+  /**
+   * POST request (no caching for mutations)
+   */
+  async post<T>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T> {
+    const result = await apiClient.post<T>(url, data, config);
+
+    // Invalidate related cache entries
+    if (this.cache) {
+      // Clear GET cache for the same URL
+      const getCacheKey = this.generateCacheKey('GET', url);
+      await this.cache.del(getCacheKey);
+      logger.debug({ url }, 'Cache invalidated after POST');
+    }
+
+    return result;
+  }
+
+  /**
+   * PUT request (no caching for mutations)
+   */
+  async put<T>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T> {
+    const result = await apiClient.put<T>(url, data, config);
+
+    // Invalidate related cache entries
+    if (this.cache) {
+      const getCacheKey = this.generateCacheKey('GET', url);
+      await this.cache.del(getCacheKey);
+      logger.debug({ url }, 'Cache invalidated after PUT');
+    }
+
+    return result;
+  }
+
+  /**
+   * DELETE request (no caching for mutations)
+   */
+  async delete<T>(url: string, config?: AxiosRequestConfig): Promise<T> {
+    const result = await apiClient.delete<T>(url, config);
+
+    // Invalidate related cache entries
+    if (this.cache) {
+      const getCacheKey = this.generateCacheKey('GET', url);
+      await this.cache.del(getCacheKey);
+      logger.debug({ url }, 'Cache invalidated after DELETE');
+    }
+
+    return result;
+  }
+
+  /**
+   * Clear all API cache
+   */
+  async clearCache(): Promise<void> {
+    if (this.cache) {
+      await this.cache.clear();
+      logger.info('API cache cleared');
+    }
+  }
+
+  /**
+   * Get cache statistics
+   */
+  getCacheStats() {
+    if (this.cache) {
+      return this.cache.getStats();
+    }
+    return null;
+  }
+}
+
+// Singleton instance
+export const cachedAPIClient = new CachedAPIClient();