@dcyfr/ai 1.0.1 → 1.0.2

package/dist/ai/mcp/mcp-registry.js

@@ -0,0 +1,355 @@
+/**
+ * MCP Registry - MCP Server Discovery and Management
+ *
+ * Manages MCP servers across the application with discovery, health monitoring,
+ * and tier-based organization.
+ *
+ * @module @dcyfr/ai/mcp/mcp-registry
+ * @example
+ * ```typescript
+ * import { MCPRegistry } from '@dcyfr/ai/mcp/mcp-registry';
+ *
+ * const registry = new MCPRegistry({
+ *   autoDiscover: true,
+ *   searchPaths: ['.mcp.json', '.vscode/mcp.json'],
+ * });
+ *
+ * // Initialize and discover servers
+ * await registry.initialize();
+ *
+ * // Get available servers
+ * const servers = registry.getAvailableServers();
+ * ```
+ */
+/**
+ * Default registry configuration
+ */
+const DEFAULT_CONFIG = {
+    autoDiscover: false,
+    searchPaths: ['.mcp.json', '.vscode/mcp.json'],
+    configFileName: '.mcp.json',
+    healthCheckInterval: 60000, // 1 minute
+    healthMonitoring: false,
+};
+/**
+ * MCP Registry - manages MCP servers
+ */
+export class MCPRegistry {
+    servers = new Map();
+    config;
+    healthCheckTimer = null;
+    initialized = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize the registry
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.config.autoDiscover && this.config.searchPaths) {
+            for (const searchPath of this.config.searchPaths) {
+                await this.loadFromFile(searchPath);
+            }
+        }
+        if (this.config.healthMonitoring) {
+            this.startHealthMonitoring();
+        }
+        this.initialized = true;
+    }
+    /**
+     * Load MCP servers from a config file
+     */
+    async loadFromFile(filePath) {
+        try {
+            const fs = await import('fs/promises');
+            const path = await import('path');
+            const absolutePath = path.isAbsolute(filePath)
+                ? filePath
+                : path.resolve(process.cwd(), filePath);
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const config = JSON.parse(content);
+            // Handle different config formats
+            const servers = config.mcpServers || config.servers || config;
+            for (const [name, serverConfig] of Object.entries(servers)) {
+                if (typeof serverConfig === 'object' && serverConfig !== null) {
+                    const config = serverConfig;
+                    await this.registerServer({
+                        ...config,
+                        name: config.name || name,
+                    }, absolutePath);
+                }
+            }
+        }
+        catch (error) {
+            // File doesn't exist or is invalid - skip silently
+            if (error.code !== 'ENOENT') {
+                console.warn(`⚠️  Failed to load MCP config from ${filePath}:`, error);
+            }
+        }
+    }
+    /**
+     * Register an MCP server
+     */
+    async registerServer(config, source = 'runtime') {
+        const server = {
+            config: {
+                enabled: true,
+                tier: 'project',
+                ...config,
+            },
+            status: 'available',
+            lastChecked: new Date(),
+            source,
+        };
+        this.servers.set(config.name, server);
+        // Perform initial health check if monitoring is enabled
+        if (this.config.healthMonitoring) {
+            await this.checkServerHealth(config.name);
+        }
+        return server;
+    }
+    /**
+     * Unregister an MCP server
+     */
+    unregisterServer(name) {
+        return this.servers.delete(name);
+    }
+    /**
+     * Get a server by name
+     */
+    getServer(name) {
+        return this.servers.get(name);
+    }
+    /**
+     * Get all registered servers
+     */
+    getAllServers() {
+        return Array.from(this.servers.values());
+    }
+    /**
+     * Get available (enabled and healthy) servers
+     */
+    getAvailableServers() {
+        return this.getAllServers().filter((s) => s.config.enabled !== false && s.status === 'available');
+    }
+    /**
+     * Get servers by tier
+     */
+    getServersByTier(tier) {
+        return this.getAllServers().filter((s) => s.config.tier === tier);
+    }
+    /**
+     * Get servers by tag
+     */
+    getServersByTag(tag) {
+        return this.getAllServers().filter((s) => s.config.tags?.includes(tag));
+    }
+    /**
+     * Enable a server
+     */
+    enableServer(name) {
+        const server = this.servers.get(name);
+        if (!server)
+            return false;
+        server.config.enabled = true;
+        return true;
+    }
+    /**
+     * Disable a server
+     */
+    disableServer(name) {
+        const server = this.servers.get(name);
+        if (!server)
+            return false;
+        server.config.enabled = false;
+        server.status = 'disabled';
+        return true;
+    }
+    /**
+     * Check health of a specific server
+     */
+    async checkServerHealth(name) {
+        const server = this.servers.get(name);
+        if (!server) {
+            return {
+                server: name,
+                status: 'unavailable',
+                error: 'Server not found',
+                timestamp: new Date(),
+            };
+        }
+        const startTime = Date.now();
+        try {
+            // For stdio servers, check if command exists
+            if (server.config.transport === 'stdio' && server.config.command) {
+                const { execSync } = await import('child_process');
+                try {
+                    execSync(`which ${server.config.command}`, { stdio: 'ignore' });
+                    server.status = 'available';
+                }
+                catch {
+                    server.status = 'unavailable';
+                    server.error = `Command '${server.config.command}' not found`;
+                }
+            }
+            // For URL-based servers, attempt a connection check
+            else if (server.config.url) {
+                try {
+                    const response = await fetch(server.config.url, {
+                        method: 'HEAD',
+                        signal: AbortSignal.timeout(5000),
+                    });
+                    server.status = response.ok ? 'available' : 'unavailable';
+                }
+                catch (error) {
+                    server.status = 'unavailable';
+                    server.error = `Cannot reach ${server.config.url}`;
+                }
+            }
+            server.lastChecked = new Date();
+            return {
+                server: name,
+                status: server.status,
+                responseTime: Date.now() - startTime,
+                error: server.error,
+                timestamp: server.lastChecked,
+            };
+        }
+        catch (error) {
+            server.status = 'error';
+            server.error = error instanceof Error ? error.message : String(error);
+            server.lastChecked = new Date();
+            return {
+                server: name,
+                status: 'error',
+                error: server.error,
+                timestamp: server.lastChecked,
+            };
+        }
+    }
+    /**
+     * Check health of all servers
+     */
+    async checkAllHealth() {
+        const results = [];
+        for (const [name] of this.servers) {
+            const result = await this.checkServerHealth(name);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Start health monitoring
+     */
+    startHealthMonitoring() {
+        if (this.healthCheckTimer)
+            return;
+        this.healthCheckTimer = setInterval(async () => {
+            await this.checkAllHealth();
+        }, this.config.healthCheckInterval || 60000);
+    }
+    /**
+     * Stop health monitoring
+     */
+    stopHealthMonitoring() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const servers = this.getAllServers();
+        const byTier = {};
+        const byTransport = {};
+        let available = 0;
+        let unavailable = 0;
+        let disabled = 0;
+        let errorCount = 0;
+        for (const server of servers) {
+            // Count by status
+            switch (server.status) {
+                case 'available':
+                    available++;
+                    break;
+                case 'unavailable':
+                    unavailable++;
+                    break;
+                case 'disabled':
+                    disabled++;
+                    break;
+                case 'error':
+                    errorCount++;
+                    break;
+            }
+            // Count by tier
+            const tier = server.config.tier || 'project';
+            byTier[tier] = (byTier[tier] || 0) + 1;
+            // Count by transport
+            const transport = server.config.transport;
+            byTransport[transport] = (byTransport[transport] || 0) + 1;
+        }
+        return {
+            totalServers: servers.length,
+            available,
+            unavailable,
+            disabled,
+            error: errorCount,
+            byTier,
+            byTransport,
+        };
+    }
+    /**
+     * Export configuration for all servers
+     */
+    exportConfig() {
+        const config = {};
+        for (const [name, server] of this.servers) {
+            config[name] = server.config;
+        }
+        return config;
+    }
+    /**
+     * Clear all servers
+     */
+    clearAll() {
+        this.stopHealthMonitoring();
+        this.servers.clear();
+        this.initialized = false;
+    }
+    /**
+     * Shutdown the registry
+     */
+    async shutdown() {
+        this.stopHealthMonitoring();
+        this.servers.clear();
+        this.initialized = false;
+    }
+}
+/**
+ * Global MCP registry instance
+ */
+let globalRegistry = null;
+/**
+ * Get or create global MCP registry
+ */
+export function getGlobalMCPRegistry(config) {
+    if (!globalRegistry) {
+        globalRegistry = new MCPRegistry(config);
+    }
+    return globalRegistry;
+}
+/**
+ * Reset global MCP registry
+ */
+export function resetGlobalMCPRegistry() {
+    if (globalRegistry) {
+        globalRegistry.shutdown();
+    }
+    globalRegistry = null;
+}
+//# sourceMappingURL=mcp-registry.js.map

package/dist/ai/mcp/mcp-registry.js.map

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

package/dist/ai/mcp/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * MCP (Model Context Protocol) Type Definitions
+ *
+ * Defines interfaces for MCP server registration, discovery, and management.
+ *
+ * @module @dcyfr/ai/mcp/types
+ */
+/**
+ * MCP server transport type
+ */
+export type MCPTransport = 'stdio' | 'sse' | 'websocket';
+/**
+ * MCP server status
+ */
+export type MCPServerStatus = 'available' | 'unavailable' | 'error' | 'disabled';
+/**
+ * MCP tool definition
+ */
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * MCP resource definition
+ */
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Server identifier */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Transport type */
+    transport: MCPTransport;
+    /** Command to start the server (for stdio transport) */
+    command?: string;
+    /** Command arguments */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** URL for SSE/WebSocket transports */
+    url?: string;
+    /** Whether the server is enabled */
+    enabled?: boolean;
+    /** Tier (public, private, project) */
+    tier?: 'public' | 'private' | 'project';
+    /** Tags for filtering */
+    tags?: string[];
+}
+/**
+ * MCP server manifest (runtime info)
+ */
+export interface MCPServerManifest {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Protocol version */
+    protocolVersion: string;
+    /** Server capabilities */
+    capabilities: MCPServerCapabilities;
+    /** Available tools */
+    tools?: MCPTool[];
+    /** Available resources */
+    resources?: MCPResource[];
+}
+/**
+ * MCP server capabilities
+ */
+export interface MCPServerCapabilities {
+    tools?: boolean;
+    resources?: boolean;
+    prompts?: boolean;
+    logging?: boolean;
+}
+/**
+ * Loaded MCP server instance
+ */
+export interface LoadedMCPServer {
+    /** Server configuration */
+    config: MCPServerConfig;
+    /** Server manifest (populated after connection) */
+    manifest?: MCPServerManifest;
+    /** Current status */
+    status: MCPServerStatus;
+    /** Last status check */
+    lastChecked: Date;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Source (file path or package) */
+    source: string;
+}
+/**
+ * MCP registry configuration
+ */
+export interface MCPRegistryConfig {
+    /** Enable auto-discovery */
+    autoDiscover?: boolean;
+    /** Paths to search for MCP configs */
+    searchPaths?: string[];
+    /** Default config file name */
+    configFileName?: string;
+    /** Health check interval (ms) */
+    healthCheckInterval?: number;
+    /** Enable health monitoring */
+    healthMonitoring?: boolean;
+}
+/**
+ * MCP health check result
+ */
+export interface MCPHealthCheckResult {
+    server: string;
+    status: MCPServerStatus;
+    responseTime?: number;
+    error?: string;
+    timestamp: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../packages/ai/mcp/types.ts"],"names":[],"mappings":"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"}

package/dist/ai/mcp/types.js

@@ -0,0 +1,9 @@
+/**
+ * MCP (Model Context Protocol) Type Definitions
+ *
+ * Defines interfaces for MCP server registration, discovery, and management.
+ *
+ * @module @dcyfr/ai/mcp/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../packages/ai/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ai/utils/storage.d.ts

@@ -4,7 +4,7 @@
  */
 import type { StorageAdapter, StorageType } from '../types';
 /**
- * In-memory storage adapter (default, no persistence)
+ * In-memory storage adapter (default, works in both browser and Node.js)
  */
 export declare class MemoryStorageAdapter implements StorageAdapter {
     type: StorageType;
@@ -17,6 +17,8 @@ export declare class MemoryStorageAdapter implements StorageAdapter {
 }
 /**
  * File-based storage adapter (Node.js only)
+ *
+ * This adapter requires Node.js and will throw an error if used in a browser environment.
  */
 export declare class FileStorageAdapter implements StorageAdapter {
     type: StorageType;
@@ -30,6 +32,9 @@ export declare class FileStorageAdapter implements StorageAdapter {
 }
 /**
  * Storage adapter factory
+ *
+ * In browser environments, only 'memory' storage is available.
+ * File-based storage requires a Node.js environment.
  */
 export declare function createStorageAdapter(type: StorageType, options?: {
     basePath?: string;

package/dist/ai/utils/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../packages/ai/utils/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,IAAI,EAAE,WAAW,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAmC;IAE1C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,IAAI,EAAE,WAAW,CAAU;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAItB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAetC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoBxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAevG"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../packages/ai/utils/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAS5D;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,IAAI,EAAE,WAAW,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAmC;IAE1C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,IAAI,EAAE,WAAW,CAAU;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAUtB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoBtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB7B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAsBvG"}