@claude-flow/mcp 3.0.0-alpha.1

package/dist/resource-registry.js

@@ -0,0 +1,405 @@
+/**
+ * @claude-flow/mcp - Resource Registry
+ *
+ * MCP 2025-11-25 compliant resource management
+ * Supports: list, read, subscribe, templates, pagination
+ */
+import { EventEmitter } from 'events';
+export class ResourceRegistry extends EventEmitter {
+    logger;
+    resources = new Map();
+    templates = new Map();
+    handlers = new Map();
+    subscriptions = new Map();
+    cache = new Map();
+    subscriptionCounter = 0;
+    options;
+    constructor(logger, options = {}) {
+        super();
+        this.logger = logger;
+        this.options = {
+            enableSubscriptions: options.enableSubscriptions ?? true,
+            maxSubscriptionsPerResource: options.maxSubscriptionsPerResource ?? 100,
+            cacheEnabled: options.cacheEnabled ?? true,
+            cacheTTL: options.cacheTTL ?? 60000, // 1 minute default
+            maxCacheSize: options.maxCacheSize ?? 1000, // SECURITY: Default max 1000 entries
+        };
+    }
+    /**
+     * Register a static resource
+     */
+    registerResource(resource, handler) {
+        if (this.resources.has(resource.uri)) {
+            this.logger.warn('Resource already registered', { uri: resource.uri });
+            return false;
+        }
+        this.resources.set(resource.uri, resource);
+        this.handlers.set(resource.uri, handler);
+        this.logger.debug('Resource registered', { uri: resource.uri, name: resource.name });
+        this.emit('resource:registered', { uri: resource.uri });
+        this.emitListChanged();
+        return true;
+    }
+    /**
+     * Register a resource template (dynamic URIs)
+     */
+    registerTemplate(template, handler) {
+        if (this.templates.has(template.uriTemplate)) {
+            this.logger.warn('Template already registered', { template: template.uriTemplate });
+            return false;
+        }
+        this.templates.set(template.uriTemplate, template);
+        this.handlers.set(template.uriTemplate, handler);
+        this.logger.debug('Resource template registered', { template: template.uriTemplate });
+        this.emit('template:registered', { template: template.uriTemplate });
+        return true;
+    }
+    /**
+     * Unregister a resource
+     */
+    unregisterResource(uri) {
+        if (!this.resources.has(uri)) {
+            return false;
+        }
+        this.resources.delete(uri);
+        this.handlers.delete(uri);
+        this.cache.delete(uri);
+        // Cancel subscriptions for this resource
+        const subs = this.subscriptions.get(uri) || [];
+        for (const sub of subs) {
+            this.emit('subscription:cancelled', { subscriptionId: sub.id, uri });
+        }
+        this.subscriptions.delete(uri);
+        this.logger.debug('Resource unregistered', { uri });
+        this.emit('resource:unregistered', { uri });
+        this.emitListChanged();
+        return true;
+    }
+    /**
+     * List resources with pagination
+     */
+    list(cursor, pageSize = 50) {
+        const allResources = Array.from(this.resources.values());
+        let startIndex = 0;
+        if (cursor) {
+            const decoded = this.decodeCursor(cursor);
+            startIndex = decoded.offset;
+        }
+        const endIndex = Math.min(startIndex + pageSize, allResources.length);
+        const resources = allResources.slice(startIndex, endIndex);
+        const result = { resources };
+        if (endIndex < allResources.length) {
+            result.nextCursor = this.encodeCursor({ offset: endIndex });
+        }
+        return result;
+    }
+    /**
+     * Read resource content
+     */
+    async read(uri) {
+        // Check cache first
+        if (this.options.cacheEnabled) {
+            const cached = this.cache.get(uri);
+            if (cached && Date.now() - cached.cachedAt < cached.ttl) {
+                this.logger.debug('Resource cache hit', { uri });
+                return { contents: cached.content };
+            }
+        }
+        // Find handler (exact match or template match)
+        let handler = this.handlers.get(uri);
+        if (!handler) {
+            handler = this.findTemplateHandler(uri);
+        }
+        if (!handler) {
+            throw new Error(`Resource not found: ${uri}`);
+        }
+        const contents = await handler(uri);
+        // Cache the result with size limit (LRU eviction)
+        if (this.options.cacheEnabled) {
+            // SECURITY: Enforce max cache size to prevent memory exhaustion
+            if (this.cache.size >= this.options.maxCacheSize) {
+                // Remove oldest entry (first entry in Map iteration order)
+                const oldestKey = this.cache.keys().next().value;
+                if (oldestKey) {
+                    this.cache.delete(oldestKey);
+                    this.logger.debug('Cache evicted oldest entry', { uri: oldestKey });
+                }
+            }
+            this.cache.set(uri, {
+                content: contents,
+                cachedAt: Date.now(),
+                ttl: this.options.cacheTTL,
+            });
+        }
+        this.emit('resource:read', { uri, contentCount: contents.length });
+        return { contents };
+    }
+    /**
+     * Subscribe to resource updates
+     */
+    subscribe(uri, callback) {
+        if (!this.options.enableSubscriptions) {
+            throw new Error('Subscriptions are disabled');
+        }
+        const existingSubs = this.subscriptions.get(uri) || [];
+        if (existingSubs.length >= this.options.maxSubscriptionsPerResource) {
+            throw new Error(`Maximum subscriptions reached for resource: ${uri}`);
+        }
+        const subscriptionId = `sub-${++this.subscriptionCounter}-${Date.now()}`;
+        const subscription = {
+            id: subscriptionId,
+            uri,
+            callback,
+            createdAt: new Date(),
+        };
+        existingSubs.push(subscription);
+        this.subscriptions.set(uri, existingSubs);
+        this.logger.debug('Subscription created', { subscriptionId, uri });
+        this.emit('subscription:created', { subscriptionId, uri });
+        return subscriptionId;
+    }
+    /**
+     * Unsubscribe from resource updates
+     */
+    unsubscribe(subscriptionId) {
+        for (const [uri, subs] of this.subscriptions) {
+            const index = subs.findIndex((s) => s.id === subscriptionId);
+            if (index !== -1) {
+                subs.splice(index, 1);
+                if (subs.length === 0) {
+                    this.subscriptions.delete(uri);
+                }
+                this.logger.debug('Subscription removed', { subscriptionId, uri });
+                this.emit('subscription:removed', { subscriptionId, uri });
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Notify subscribers of resource update
+     */
+    async notifyUpdate(uri) {
+        const subs = this.subscriptions.get(uri);
+        if (!subs || subs.length === 0) {
+            return;
+        }
+        // Invalidate cache
+        this.cache.delete(uri);
+        // Read fresh content
+        const { contents } = await this.read(uri);
+        // Notify all subscribers
+        for (const sub of subs) {
+            try {
+                sub.callback(uri, contents);
+            }
+            catch (error) {
+                this.logger.error('Subscription callback error', { subscriptionId: sub.id, error });
+            }
+        }
+        this.emit('resource:updated', { uri, subscriberCount: subs.length });
+    }
+    /**
+     * Get resource by URI
+     */
+    getResource(uri) {
+        return this.resources.get(uri);
+    }
+    /**
+     * Check if resource exists
+     */
+    hasResource(uri) {
+        return this.resources.has(uri) || this.matchesTemplate(uri);
+    }
+    /**
+     * Get resource count
+     */
+    getResourceCount() {
+        return this.resources.size;
+    }
+    /**
+     * Get all templates
+     */
+    getTemplates() {
+        return Array.from(this.templates.values());
+    }
+    /**
+     * Get subscription count for a resource
+     */
+    getSubscriptionCount(uri) {
+        return this.subscriptions.get(uri)?.length || 0;
+    }
+    /**
+     * Get stats
+     */
+    getStats() {
+        let totalSubscriptions = 0;
+        for (const subs of this.subscriptions.values()) {
+            totalSubscriptions += subs.length;
+        }
+        return {
+            totalResources: this.resources.size,
+            totalTemplates: this.templates.size,
+            totalSubscriptions,
+            cacheSize: this.cache.size,
+        };
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+        this.logger.debug('Resource cache cleared');
+    }
+    /**
+     * Find handler for template URI
+     */
+    findTemplateHandler(uri) {
+        for (const [template, handler] of this.handlers) {
+            if (this.matchesTemplate(uri, template)) {
+                return handler;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Escape regex metacharacters to prevent ReDoS attacks
+     * SECURITY: Critical for preventing regex denial of service
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Check if URI matches any template
+     * SECURITY: Uses escaped regex to prevent ReDoS
+     */
+    matchesTemplate(uri, template) {
+        if (template) {
+            // SECURITY: Escape regex metacharacters before converting template
+            // First extract placeholders, escape the rest, then add placeholder pattern
+            const escaped = this.escapeRegex(template);
+            // Replace escaped placeholder braces with the pattern
+            const pattern = escaped.replace(/\\\{[^}]+\\\}/g, '[^/]+');
+            try {
+                const regex = new RegExp('^' + pattern + '$');
+                return regex.test(uri);
+            }
+            catch {
+                // Invalid regex pattern - return false safely
+                return false;
+            }
+        }
+        for (const t of this.templates.keys()) {
+            const escaped = this.escapeRegex(t);
+            const pattern = escaped.replace(/\\\{[^}]+\\\}/g, '[^/]+');
+            try {
+                const regex = new RegExp('^' + pattern + '$');
+                if (regex.test(uri)) {
+                    return true;
+                }
+            }
+            catch {
+                // Skip invalid patterns
+                continue;
+            }
+        }
+        return false;
+    }
+    /**
+     * Encode cursor for pagination
+     */
+    encodeCursor(data) {
+        return Buffer.from(JSON.stringify(data)).toString('base64');
+    }
+    /**
+     * Decode cursor for pagination
+     */
+    decodeCursor(cursor) {
+        try {
+            return JSON.parse(Buffer.from(cursor, 'base64').toString('utf-8'));
+        }
+        catch {
+            return { offset: 0 };
+        }
+    }
+    /**
+     * Emit listChanged notification
+     */
+    emitListChanged() {
+        this.emit('resources:listChanged');
+    }
+}
+export function createResourceRegistry(logger, options) {
+    return new ResourceRegistry(logger, options);
+}
+/**
+ * Helper to create a static text resource
+ */
+export function createTextResource(uri, name, text, options) {
+    const resource = {
+        uri,
+        name,
+        description: options?.description,
+        mimeType: options?.mimeType || 'text/plain',
+        annotations: options?.annotations,
+    };
+    const handler = async () => [
+        {
+            uri,
+            mimeType: options?.mimeType || 'text/plain',
+            text,
+        },
+    ];
+    return { resource, handler };
+}
+/**
+ * Helper to create a file resource
+ * SECURITY: Validates path to prevent path traversal attacks
+ */
+export function createFileResource(uri, name, filePath, options) {
+    const resource = {
+        uri,
+        name,
+        description: options?.description,
+        mimeType: options?.mimeType || 'application/octet-stream',
+    };
+    const handler = async () => {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        // SECURITY: Normalize and validate the path
+        const normalizedPath = path.normalize(filePath);
+        // Prevent path traversal
+        if (normalizedPath.includes('..') || normalizedPath.includes('\0')) {
+            throw new Error('Invalid file path: path traversal detected');
+        }
+        // Prevent access to sensitive system paths
+        const blockedPaths = ['/etc/', '/proc/', '/sys/', '/dev/', '/root/', '/var/log/'];
+        const lowerPath = normalizedPath.toLowerCase();
+        for (const blocked of blockedPaths) {
+            if (lowerPath.startsWith(blocked) || lowerPath.includes('/.')) {
+                throw new Error('Access to system paths is not allowed');
+            }
+        }
+        // If allowedBasePaths specified, validate against them
+        if (options?.allowedBasePaths && options.allowedBasePaths.length > 0) {
+            const resolvedPath = path.resolve(normalizedPath);
+            const isAllowed = options.allowedBasePaths.some((basePath) => {
+                const resolvedBase = path.resolve(basePath);
+                return resolvedPath.startsWith(resolvedBase);
+            });
+            if (!isAllowed) {
+                throw new Error('File path is outside allowed directories');
+            }
+        }
+        const content = await fs.readFile(normalizedPath);
+        return [
+            {
+                uri,
+                mimeType: options?.mimeType || 'application/octet-stream',
+                blob: content.toString('base64'),
+            },
+        ];
+    };
+    return { resource, handler };
+}
+//# sourceMappingURL=resource-registry.js.map

package/dist/resource-registry.js.map

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

package/dist/sampling.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @claude-flow/mcp - Sampling (Server-Initiated LLM)
+ *
+ * MCP 2025-11-25 compliant sampling for server-initiated LLM calls
+ */
+import { EventEmitter } from 'events';
+import type { ModelPreferences, CreateMessageRequest, CreateMessageResult, ILogger } from './types.js';
+/**
+ * External LLM provider interface
+ */
+export interface LLMProvider {
+    name: string;
+    createMessage(request: CreateMessageRequest): Promise<CreateMessageResult>;
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Sampling configuration
+ */
+export interface SamplingConfig {
+    /** Default model preferences */
+    defaultModelPreferences?: ModelPreferences;
+    /** Maximum tokens for any request */
+    maxTokensLimit?: number;
+    /** Default temperature */
+    defaultTemperature?: number;
+    /** Timeout for LLM calls (ms) */
+    timeout?: number;
+    /** Enable request logging */
+    enableLogging?: boolean;
+}
+/**
+ * Sampling request context
+ */
+export interface SamplingContext {
+    sessionId: string;
+    serverId?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class SamplingManager extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private providers;
+    private defaultProvider?;
+    private requestCount;
+    private totalTokens;
+    constructor(logger: ILogger, config?: Partial<SamplingConfig>);
+    /**
+     * Register an LLM provider
+     */
+    registerProvider(provider: LLMProvider, isDefault?: boolean): void;
+    /**
+     * Unregister a provider
+     */
+    unregisterProvider(name: string): boolean;
+    /**
+     * Create a message (sampling/createMessage)
+     */
+    createMessage(request: CreateMessageRequest, context?: SamplingContext): Promise<CreateMessageResult>;
+    /**
+     * Check if sampling is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get available providers
+     */
+    getProviders(): string[];
+    /**
+     * Get stats
+     */
+    getStats(): {
+        requestCount: number;
+        totalTokens: number;
+        providerCount: number;
+        defaultProvider?: string;
+    };
+    /**
+     * Validate sampling request
+     */
+    private validateRequest;
+    /**
+     * Select provider based on preferences
+     */
+    private selectProvider;
+    /**
+     * Apply default values to request
+     */
+    private applyDefaults;
+    /**
+     * Call with timeout
+     */
+    private callWithTimeout;
+}
+export declare function createSamplingManager(logger: ILogger, config?: Partial<SamplingConfig>): SamplingManager;
+/**
+ * Create a mock LLM provider for testing
+ */
+export declare function createMockProvider(name?: string): LLMProvider;
+/**
+ * Create an Anthropic provider (requires API key)
+ */
+export declare function createAnthropicProvider(apiKey: string): LLMProvider;
+//# sourceMappingURL=sampling.d.ts.map

package/dist/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAEV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EAEnB,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,uBAAuB,CAAC,EAAE,gBAAgB,CAAC;IAC3C,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAcD,qBAAa,eAAgB,SAAQ,YAAY;IAQ7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;gBAGL,MAAM,EAAE,OAAO,EAChC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAMtC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,IAAI;IASzE;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQzC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAwE/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAcrC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IASD;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;YACW,eAAe;CAQ9B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAe,GAAG,WAAW,CAqBrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA2CnE"}