@defai.digital/ax-cli 4.4.7 → 4.4.10

package/dist/mcp/subscriptions.js

@@ -1,248 +0,0 @@
-/**
- * MCP Resource Subscriptions
- *
- * Enables clients to subscribe to resource changes and receive notifications
- * when resources are updated.
- *
- * MCP Specification:
- * - resources/subscribe - Subscribe to a resource
- * - resources/unsubscribe - Unsubscribe from a resource
- * - notifications/resources/updated - Resource update notification
- * - notifications/resources/list_changed - Resource list change notification
- *
- * @module mcp/subscriptions
- */
-import { EventEmitter } from 'events';
-import { Ok, Err } from './type-safety.js';
-/**
- * Subscription Manager
- *
- * Manages resource subscriptions across MCP servers.
- *
- * @example
- * ```typescript
- * const manager = new SubscriptionManager();
- *
- * // Subscribe to a resource
- * await manager.subscribe('filesystem', 'file:///config.json');
- *
- * // Listen for updates
- * manager.on('resource-updated', (uri, serverName) => {
- *   console.log(`Resource updated: ${uri} from ${serverName}`);
- * });
- *
- * // Unsubscribe
- * await manager.unsubscribe('filesystem', 'file:///config.json');
- * ```
- */
-export class SubscriptionManager extends EventEmitter {
-    subscriptions = new Map();
-    sendRequest = null;
-    checkCapabilities = null;
-    /**
-     * Set the request sender function
-     * Called by MCPManagerV2 to wire up the request mechanism
-     */
-    setSendRequest(fn) {
-        this.sendRequest = fn;
-    }
-    /**
-     * Set the capabilities checker function
-     * Called by MCPManagerV2 to wire up capability checking
-     */
-    setCheckCapabilities(fn) {
-        this.checkCapabilities = fn;
-    }
-    /**
-     * Get subscription key for internal storage
-     */
-    getKey(serverName, uri) {
-        return `${serverName}:${uri}`;
-    }
-    /**
-     * Subscribe to a resource
-     *
-     * @param serverName - Server providing the resource
-     * @param uri - Resource URI to subscribe to
-     * @returns Result indicating success or error
-     */
-    async subscribe(serverName, uri) {
-        // Check if already subscribed
-        const key = this.getKey(serverName, uri);
-        if (this.subscriptions.has(key)) {
-            return Ok(undefined); // Already subscribed
-        }
-        // Check server capabilities
-        if (this.checkCapabilities) {
-            const caps = await this.checkCapabilities(serverName);
-            if (!caps.supportsSubscriptions) {
-                return Err(new Error(`Server ${serverName} does not support resource subscriptions`));
-            }
-        }
-        // Send subscription request
-        if (!this.sendRequest) {
-            return Err(new Error('Subscription manager not initialized'));
-        }
-        const result = await this.sendRequest(serverName, 'resources/subscribe', uri);
-        if (!result.success) {
-            return result;
-        }
-        // Track the subscription
-        this.subscriptions.set(key, {
-            uri,
-            serverName,
-            subscribedAt: new Date(),
-        });
-        this.emit('subscribed', uri, serverName);
-        return Ok(undefined);
-    }
-    /**
-     * Unsubscribe from a resource
-     *
-     * @param serverName - Server providing the resource
-     * @param uri - Resource URI to unsubscribe from
-     * @returns Result indicating success or error
-     */
-    async unsubscribe(serverName, uri) {
-        const key = this.getKey(serverName, uri);
-        if (!this.subscriptions.has(key)) {
-            return Ok(undefined); // Not subscribed
-        }
-        // Send unsubscription request
-        if (this.sendRequest) {
-            const result = await this.sendRequest(serverName, 'resources/unsubscribe', uri);
-            if (!result.success) {
-                // Log but don't fail - we'll still clean up locally
-                console.warn(`Failed to unsubscribe from ${uri}: ${result.error.message}`);
-            }
-        }
-        // Remove from tracking
-        this.subscriptions.delete(key);
-        this.emit('unsubscribed', uri, serverName);
-        return Ok(undefined);
-    }
-    /**
-     * Handle resource update notification from server
-     *
-     * @param serverName - Server that sent the notification
-     * @param uri - Updated resource URI
-     */
-    handleResourceUpdated(serverName, uri) {
-        const key = this.getKey(serverName, uri);
-        if (this.subscriptions.has(key)) {
-            this.emit('resource-updated', uri, serverName);
-        }
-    }
-    /**
-     * Handle resource list change notification from server
-     *
-     * @param serverName - Server that sent the notification
-     */
-    handleResourceListChanged(serverName) {
-        this.emit('resource-list-changed', serverName);
-    }
-    /**
-     * Get all active subscriptions
-     *
-     * @returns Array of active subscriptions
-     */
-    getActiveSubscriptions() {
-        return Array.from(this.subscriptions.values());
-    }
-    /**
-     * Get subscriptions for a specific server
-     *
-     * @param serverName - Server to get subscriptions for
-     * @returns Array of subscriptions for the server
-     */
-    getSubscriptionsForServer(serverName) {
-        return this.getActiveSubscriptions().filter(sub => sub.serverName === serverName);
-    }
-    /**
-     * Check if subscribed to a resource
-     *
-     * @param serverName - Server providing the resource
-     * @param uri - Resource URI
-     * @returns true if subscribed
-     */
-    isSubscribed(serverName, uri) {
-        return this.subscriptions.has(this.getKey(serverName, uri));
-    }
-    /**
-     * Get the number of active subscriptions
-     *
-     * @returns Number of active subscriptions
-     */
-    getSubscriptionCount() {
-        return this.subscriptions.size;
-    }
-    /**
-     * Resubscribe all subscriptions for a server
-     * Called after server reconnection
-     *
-     * @param serverName - Server to resubscribe for
-     * @returns Results of resubscription attempts
-     */
-    async resubscribeForServer(serverName) {
-        const subs = this.getSubscriptionsForServer(serverName);
-        const results = [];
-        for (const sub of subs) {
-            // Remove existing subscription first
-            this.subscriptions.delete(this.getKey(serverName, sub.uri));
-            // Resubscribe
-            const result = await this.subscribe(serverName, sub.uri);
-            results.push({ uri: sub.uri, result });
-        }
-        return results;
-    }
-    /**
-     * Unsubscribe from all resources on a server
-     * Called during server disconnection
-     *
-     * @param serverName - Server to unsubscribe from
-     */
-    unsubscribeAllForServer(serverName) {
-        const subs = this.getSubscriptionsForServer(serverName);
-        for (const sub of subs) {
-            this.subscriptions.delete(this.getKey(serverName, sub.uri));
-            this.emit('unsubscribed', sub.uri, serverName);
-        }
-    }
-    /**
-     * Cleanup all subscriptions
-     */
-    cleanupAll() {
-        for (const [key, sub] of this.subscriptions.entries()) {
-            this.subscriptions.delete(key);
-            this.emit('unsubscribed', sub.uri, sub.serverName);
-        }
-    }
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy() {
-        this.removeAllListeners();
-    }
-}
-// Singleton instance
-let subscriptionManager = null;
-/**
- * Get the singleton subscription manager instance
- */
-export function getSubscriptionManager() {
-    if (!subscriptionManager) {
-        subscriptionManager = new SubscriptionManager();
-    }
-    return subscriptionManager;
-}
-/**
- * Reset the subscription manager (for testing)
- */
-export function resetSubscriptionManager() {
-    if (subscriptionManager) {
-        subscriptionManager.cleanupAll();
-        subscriptionManager.removeAllListeners();
-    }
-    subscriptionManager = null;
-}
-//# sourceMappingURL=subscriptions.js.map

package/dist/mcp/subscriptions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/mcp/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAU,EAAE,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AA8BnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAC3C,aAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,WAAW,GAAmC,IAAI,CAAC;IACnD,iBAAiB,GAAmC,IAAI,CAAC;IAEjE;;;OAGG;IACH,cAAc,CAAC,EAA2B;QACxC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,EAA2B;QAC9C,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,UAAsB,EAAE,GAAW;QAChD,OAAO,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,UAAsB,EACtB,GAAW;QAEX,8BAA8B;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB;QAC7C,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,UAAU,0CAA0C,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;YAC1B,GAAG;YACH,UAAU;YACV,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,UAAsB,EACtB,GAAW;QAEX,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB;QACzC,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAChF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,oDAAoD;gBACpD,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,UAAsB,EAAE,GAAW;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,yBAAyB,CAAC,UAAsB;QAC9C,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,yBAAyB,CAAC,UAAsB;QAC9C,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC,MAAM,CACzC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU,CACrC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,UAAsB,EAAE,GAAW;QAC9C,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,oBAAoB,CACxB,UAAsB;QAEtB,MAAM,IAAI,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,OAAO,GAAwD,EAAE,CAAC;QAExE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,qCAAqC;YACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAE5D,cAAc;YACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CAAC,UAAsB;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;CAEF;AAED,qBAAqB;AACrB,IAAI,mBAAmB,GAA+B,IAAI,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,mBAAmB,EAAE,CAAC;QACxB,mBAAmB,CAAC,UAAU,EAAE,CAAC;QACjC,mBAAmB,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IACD,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC"}

package/dist/mcp/templates.d.ts

@@ -1,52 +0,0 @@
-/**
- * Pre-configured MCP server templates for popular services
- * Enables one-command setup: ax-cli mcp add <name> --template
- */
-import { MCPServerConfig } from '../schemas/settings-schemas.js';
-export interface MCPServerTemplate {
-    name: string;
-    description: string;
-    category: 'design' | 'deployment' | 'testing' | 'monitoring' | 'backend' | 'version-control';
-    officialServer: boolean;
-    config: MCPServerConfig;
-    requiredEnv: Array<{
-        name: string;
-        description: string;
-        url?: string;
-    }>;
-    setupInstructions: string;
-    usageExamples: string[];
-    troubleshooting: Array<{
-        issue: string;
-        solution: string;
-    }>;
-}
-/**
- * Pre-configured templates for popular MCP servers
- * Focus on front-end development tools
- */
-export declare const TEMPLATES: Record<string, MCPServerTemplate>;
-/**
- * Get all available template names
- */
-export declare function getTemplateNames(): string[];
-/**
- * Get template by name
- */
-export declare function getTemplate(name: string): MCPServerTemplate | undefined;
-/**
- * Get templates by category
- */
-export declare function getTemplatesByCategory(category: MCPServerTemplate['category']): MCPServerTemplate[];
-/**
- * Search templates by keyword
- */
-export declare function searchTemplates(query: string): MCPServerTemplate[];
-/**
- * Check if a template exists
- */
-export declare function hasTemplate(name: string): boolean;
-/**
- * Generate MCP config from template with environment variables
- */
-export declare function generateConfigFromTemplate(templateName: string, envVars: Record<string, string>): MCPServerConfig;