@defai.digital/ax-cli 3.14.18 → 3.15.1

package/dist/mcp/content-length-transport.js

@@ -45,8 +45,11 @@ export class ContentLengthStdioTransport extends EventEmitter {
         this._started = true;
         return new Promise((resolve, reject) => {
             try {
+                // Use "pipe" for stderr in quiet mode to suppress INFO/DEBUG logs
+                // Use "inherit" otherwise to show all output (default behavior)
+                const stderrOption = this.config.quiet ? "pipe" : "inherit";
                 this.process = spawn(this.config.command, this.config.args || [], {
-                    stdio: ["pipe", "pipe", "inherit"], // Inherit stderr for debugging
+                    stdio: ["pipe", "pipe", stderrOption],
                     env: {
                         ...process.env,
                         ...this.config.env,

package/dist/mcp/content-length-transport.js.map

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

package/dist/mcp/index.d.ts

@@ -33,5 +33,7 @@ export { Result, Ok, Err } from "./type-safety.js";
 export { resolveMCPReferences, extractMCPReferences } from "./resources.js";
 export { ProgressTracker, getProgressTracker, resetProgressTracker, formatProgress, formatElapsedTime, type ProgressUpdate, type ProgressCallback, } from "./progress.js";
 export { CancellationManager, getCancellationManager, resetCancellationManager, isRequestCancelled, createCancellationError, CANCELLED_ERROR_CODE, type CancellableRequest, type CancellationResult, } from "./cancellation.js";
+export { SubscriptionManager, getSubscriptionManager, resetSubscriptionManager, type ResourceSubscription, } from "./subscriptions.js";
+export { ToolOutputValidator, getToolOutputValidator, resetToolOutputValidator, type SchemaValidationResult, type SchemaValidationStatus, } from "./schema-validator.js";
 export { ZAI_SERVER_NAMES, ZAI_ENDPOINTS, ZAI_VISION_PACKAGE, ZAI_MCP_TEMPLATES, ZAI_QUOTA_LIMITS, generateZAIServerConfig, getAllZAIServerNames, isZAIServer, getZAITemplate, type ZAIServerName, type ZAIPlanTier, type ZAIMCPTemplate, } from "./zai-templates.js";
 export { detectZAIServices, getEnabledZAIServers, validateZAIApiKey, getZAIApiKey, isZAIMCPConfigured, getRecommendedServers, isGLMModel, isZAIBaseURL, formatZAIStatus, type ZAIServiceStatus, } from "./zai-detector.js";

package/dist/mcp/index.js

@@ -40,6 +40,10 @@ export { resolveMCPReferences, extractMCPReferences } from "./resources.js";
 export { ProgressTracker, getProgressTracker, resetProgressTracker, formatProgress, formatElapsedTime, } from "./progress.js";
 // Cancellation support (MCP 2025-06-18)
 export { CancellationManager, getCancellationManager, resetCancellationManager, isRequestCancelled, createCancellationError, CANCELLED_ERROR_CODE, } from "./cancellation.js";
+// Resource subscriptions (MCP 2025-06-18)
+export { SubscriptionManager, getSubscriptionManager, resetSubscriptionManager, } from "./subscriptions.js";
+// Schema validation (MCP 2025-06-18)
+export { ToolOutputValidator, getToolOutputValidator, resetToolOutputValidator, } from "./schema-validator.js";
 // Z.AI MCP Integration
 export { ZAI_SERVER_NAMES, ZAI_ENDPOINTS, ZAI_VISION_PACKAGE, ZAI_MCP_TEMPLATES, ZAI_QUOTA_LIMITS, generateZAIServerConfig, getAllZAIServerNames, isZAIServer, getZAITemplate, } from "./zai-templates.js";
 export { detectZAIServices, getEnabledZAIServers, validateZAIApiKey, getZAIApiKey, isZAIMCPConfigured, getRecommendedServers, isGLMModel, isZAIBaseURL, formatZAIStatus, } from "./zai-detector.js";

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qDAAqD;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,uDAAuD;AACvD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,GAIf,MAAM,gBAAgB,CAAC;AAGxB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAAE,6CAA6C;AACjE,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,aAAa;AACb,OAAO,EACL,eAAe,GAKhB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEtG,wBAAwB;AACxB,OAAO,EAAU,EAAE,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oBAAoB;AACpB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,qCAAqC;AACrC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAGlB,MAAM,eAAe,CAAC;AAEvB,wCAAwC;AACxC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAE3B,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,eAAe,GAEhB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qDAAqD;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,uDAAuD;AACvD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,GAIf,MAAM,gBAAgB,CAAC;AAGxB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAAE,6CAA6C;AACjE,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,aAAa;AACb,OAAO,EACL,eAAe,GAKhB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEtG,wBAAwB;AACxB,OAAO,EAAU,EAAE,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oBAAoB;AACpB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,qCAAqC;AACrC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAGlB,MAAM,eAAe,CAAC;AAEvB,wCAAwC;AACxC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAE3B,0CAA0C;AAC1C,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,GAEzB,MAAM,oBAAoB,CAAC;AAE5B,qCAAqC;AACrC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,GAGzB,MAAM,uBAAuB,CAAC;AAE/B,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,eAAe,GAEhB,MAAM,mBAAmB,CAAC"}

package/dist/mcp/schema-validator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MCP Tool Output Schema Validation
+ *
+ * Validates tool outputs against their declared JSON schemas using Ajv.
+ * Uses the MCP SDK's AjvJsonSchemaValidator for consistency.
+ *
+ * MCP Specification: Tool Output Schemas (2025-06-18)
+ *
+ * @module mcp/schema-validator
+ */
+/**
+ * Schema validation result status
+ */
+export type SchemaValidationStatus = 'valid' | 'invalid' | 'no-schema';
+/**
+ * Schema validation result
+ */
+export interface SchemaValidationResult {
+    /** Validation status */
+    status: SchemaValidationStatus;
+    /** Validation errors (if status is 'invalid') */
+    errors?: string[];
+    /** The schema that was used for validation */
+    schema?: unknown;
+}
+/**
+ * Tool Output Schema Validator
+ *
+ * Validates MCP tool outputs against their declared JSON schemas.
+ *
+ * @example
+ * ```typescript
+ * const validator = new ToolOutputValidator();
+ *
+ * // Validate tool output
+ * const result = validator.validate(outputSchema, toolOutput);
+ *
+ * if (result.status === 'invalid') {
+ *   console.warn('Tool output validation failed:', result.errors);
+ * }
+ * ```
+ */
+export declare class ToolOutputValidator {
+    private validator;
+    constructor();
+    /**
+     * Validate tool output against schema
+     *
+     * @param schema - JSON schema to validate against (or undefined if no schema)
+     * @param output - Tool output to validate
+     * @returns Validation result
+     */
+    validate(schema: unknown, output: unknown): SchemaValidationResult;
+    /**
+     * Validate tool output content array
+     *
+     * MCP tool results return an array of content items.
+     * This method validates the extracted content.
+     *
+     * @param schema - JSON schema
+     * @param content - MCP tool result content array
+     * @returns Validation result
+     */
+    validateContent(schema: unknown, content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>): SchemaValidationResult;
+}
+/**
+ * Get the singleton validator instance
+ */
+export declare function getToolOutputValidator(): ToolOutputValidator;
+/**
+ * Reset the validator (for testing)
+ */
+export declare function resetToolOutputValidator(): void;

package/dist/mcp/schema-validator.js

@@ -0,0 +1,125 @@
+/**
+ * MCP Tool Output Schema Validation
+ *
+ * Validates tool outputs against their declared JSON schemas using Ajv.
+ * Uses the MCP SDK's AjvJsonSchemaValidator for consistency.
+ *
+ * MCP Specification: Tool Output Schemas (2025-06-18)
+ *
+ * @module mcp/schema-validator
+ */
+import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+/**
+ * Tool Output Schema Validator
+ *
+ * Validates MCP tool outputs against their declared JSON schemas.
+ *
+ * @example
+ * ```typescript
+ * const validator = new ToolOutputValidator();
+ *
+ * // Validate tool output
+ * const result = validator.validate(outputSchema, toolOutput);
+ *
+ * if (result.status === 'invalid') {
+ *   console.warn('Tool output validation failed:', result.errors);
+ * }
+ * ```
+ */
+export class ToolOutputValidator {
+    validator;
+    constructor() {
+        this.validator = new AjvJsonSchemaValidator();
+    }
+    /**
+     * Validate tool output against schema
+     *
+     * @param schema - JSON schema to validate against (or undefined if no schema)
+     * @param output - Tool output to validate
+     * @returns Validation result
+     */
+    validate(schema, output) {
+        // No schema defined
+        if (schema === undefined || schema === null) {
+            return { status: 'no-schema' };
+        }
+        // Empty schema (matches anything)
+        if (typeof schema === 'object' && Object.keys(schema).length === 0) {
+            return { status: 'valid', schema };
+        }
+        try {
+            // Use the SDK's validator - getValidator returns a function
+            const validateFn = this.validator.getValidator(schema);
+            const result = validateFn(output);
+            if (result.valid) {
+                return { status: 'valid', schema };
+            }
+            // Extract error message
+            return {
+                status: 'invalid',
+                errors: result.errorMessage ? [result.errorMessage] : ['Validation failed'],
+                schema,
+            };
+        }
+        catch (error) {
+            // Schema compilation error
+            return {
+                status: 'invalid',
+                errors: [`Schema compilation error: ${error instanceof Error ? error.message : String(error)}`],
+                schema,
+            };
+        }
+    }
+    /**
+     * Validate tool output content array
+     *
+     * MCP tool results return an array of content items.
+     * This method validates the extracted content.
+     *
+     * @param schema - JSON schema
+     * @param content - MCP tool result content array
+     * @returns Validation result
+     */
+    validateContent(schema, content) {
+        if (schema === undefined || schema === null) {
+            return { status: 'no-schema' };
+        }
+        // Extract text content and try to parse as JSON
+        const textContent = content
+            .filter((item) => item.type === 'text' && item.text)
+            .map((item) => item.text)
+            .join('');
+        if (!textContent) {
+            // No text content to validate
+            return { status: 'valid', schema };
+        }
+        // Try to parse as JSON
+        let parsedOutput;
+        try {
+            parsedOutput = JSON.parse(textContent);
+        }
+        catch {
+            // Not JSON - validate as string if schema allows
+            parsedOutput = textContent;
+        }
+        return this.validate(schema, parsedOutput);
+    }
+}
+// Singleton instance
+let validatorInstance = null;
+/**
+ * Get the singleton validator instance
+ */
+export function getToolOutputValidator() {
+    if (!validatorInstance) {
+        validatorInstance = new ToolOutputValidator();
+    }
+    return validatorInstance;
+}
+/**
+ * Reset the validator (for testing)
+ */
+export function resetToolOutputValidator() {
+    validatorInstance = null;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/mcp/schema-validator.js.map

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

package/dist/mcp/subscriptions.d.ts

@@ -0,0 +1,164 @@
+/**
+ * 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 type { ServerName } from './type-safety.js';
+import { Result } from './type-safety.js';
+/**
+ * Resource subscription information
+ */
+export interface ResourceSubscription {
+    /** Resource URI */
+    uri: string;
+    /** Server providing the resource */
+    serverName: ServerName;
+    /** When the subscription was created */
+    subscribedAt: Date;
+}
+/**
+ * Callback for sending subscription requests to server
+ */
+export type SendSubscriptionRequest = (serverName: ServerName, method: 'resources/subscribe' | 'resources/unsubscribe', uri: string) => Promise<Result<void, Error>>;
+/**
+ * Callback for checking server capabilities
+ */
+export type CheckServerCapabilities = (serverName: ServerName) => Promise<{
+    supportsSubscriptions: boolean;
+}>;
+/**
+ * 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 declare class SubscriptionManager extends EventEmitter {
+    private subscriptions;
+    private sendRequest;
+    private checkCapabilities;
+    /**
+     * Set the request sender function
+     * Called by MCPManagerV2 to wire up the request mechanism
+     */
+    setSendRequest(fn: SendSubscriptionRequest): void;
+    /**
+     * Set the capabilities checker function
+     * Called by MCPManagerV2 to wire up capability checking
+     */
+    setCheckCapabilities(fn: CheckServerCapabilities): void;
+    /**
+     * Get subscription key for internal storage
+     */
+    private getKey;
+    /**
+     * Subscribe to a resource
+     *
+     * @param serverName - Server providing the resource
+     * @param uri - Resource URI to subscribe to
+     * @returns Result indicating success or error
+     */
+    subscribe(serverName: ServerName, uri: string): Promise<Result<void, Error>>;
+    /**
+     * Unsubscribe from a resource
+     *
+     * @param serverName - Server providing the resource
+     * @param uri - Resource URI to unsubscribe from
+     * @returns Result indicating success or error
+     */
+    unsubscribe(serverName: ServerName, uri: string): Promise<Result<void, Error>>;
+    /**
+     * Handle resource update notification from server
+     *
+     * @param serverName - Server that sent the notification
+     * @param uri - Updated resource URI
+     */
+    handleResourceUpdated(serverName: ServerName, uri: string): void;
+    /**
+     * Handle resource list change notification from server
+     *
+     * @param serverName - Server that sent the notification
+     */
+    handleResourceListChanged(serverName: ServerName): void;
+    /**
+     * Get all active subscriptions
+     *
+     * @returns Array of active subscriptions
+     */
+    getActiveSubscriptions(): ResourceSubscription[];
+    /**
+     * Get subscriptions for a specific server
+     *
+     * @param serverName - Server to get subscriptions for
+     * @returns Array of subscriptions for the server
+     */
+    getSubscriptionsForServer(serverName: ServerName): ResourceSubscription[];
+    /**
+     * Check if subscribed to a resource
+     *
+     * @param serverName - Server providing the resource
+     * @param uri - Resource URI
+     * @returns true if subscribed
+     */
+    isSubscribed(serverName: ServerName, uri: string): boolean;
+    /**
+     * Get the number of active subscriptions
+     *
+     * @returns Number of active subscriptions
+     */
+    getSubscriptionCount(): number;
+    /**
+     * Resubscribe all subscriptions for a server
+     * Called after server reconnection
+     *
+     * @param serverName - Server to resubscribe for
+     * @returns Results of resubscription attempts
+     */
+    resubscribeForServer(serverName: ServerName): Promise<Array<{
+        uri: string;
+        result: Result<void, Error>;
+    }>>;
+    /**
+     * Unsubscribe from all resources on a server
+     * Called during server disconnection
+     *
+     * @param serverName - Server to unsubscribe from
+     */
+    unsubscribeAllForServer(serverName: ServerName): void;
+    /**
+     * Cleanup all subscriptions
+     */
+    cleanupAll(): void;
+}
+/**
+ * Get the singleton subscription manager instance
+ */
+export declare function getSubscriptionManager(): SubscriptionManager;
+/**
+ * Reset the subscription manager (for testing)
+ */
+export declare function resetSubscriptionManager(): void;

package/dist/mcp/subscriptions.js

@@ -0,0 +1,242 @@
+/**
+ * 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);
+        }
+    }
+}
+// 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