@1mcp/agent 0.25.5 → 0.26.0

package/build/domains/registry/cacheManager.d.ts

@@ -0,0 +1,61 @@
+import { CacheOptions } from './types.js';
+/**
+ * In-memory cache manager with TTL support for MCP Registry responses
+ */
+export declare class CacheManager {
+    private cache;
+    private cleanupTimer?;
+    private options;
+    constructor(options?: Partial<CacheOptions>);
+    /**
+     * Get a cached value by key
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value in the cache with optional TTL
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    invalidate(pattern: string): Promise<void>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        totalEntries: number;
+        validEntries: number;
+        expiredEntries: number;
+        maxSize: number;
+        hitRatio: number;
+    };
+    /**
+     * Generate a cache key for registry requests
+     */
+    generateKey(endpoint: string, params?: Record<string, any>): string;
+    /**
+     * Start the cleanup timer
+     */
+    private startCleanupTimer;
+    /**
+     * Stop the cleanup timer
+     */
+    destroy(): void;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Evict oldest entries when cache is full
+     */
+    private evictOldest;
+    /**
+     * Calculate hit ratio (placeholder for future hit/miss tracking)
+     */
+    private getHitRatio;
+}
+//# sourceMappingURL=cacheManager.d.ts.map

package/build/domains/registry/cacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheManager.d.ts","sourceRoot":"","sources":["../../../src/domains/registry/cacheManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,YAAY,CAAC,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM;IAU/C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,QAAQ;;;;;;;IAsBR;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM;IASvE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,OAAO,CAAC,OAAO;IAiBf;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,WAAW;CAIpB"}

package/build/domains/registry/cacheManager.js

@@ -0,0 +1,158 @@
+import logger from '../../logger/logger.js';
+/**
+ * In-memory cache manager with TTL support for MCP Registry responses
+ */
+export class CacheManager {
+    cache = new Map();
+    cleanupTimer;
+    options;
+    constructor(options = {}) {
+        this.options = {
+            defaultTtl: options.defaultTtl || 300, // 5 minutes default
+            maxSize: options.maxSize || 1000,
+            cleanupInterval: options.cleanupInterval || 60000, // 1 minute
+        };
+        this.startCleanupTimer();
+    }
+    /**
+     * Get a cached value by key
+     */
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    /**
+     * Set a value in the cache with optional TTL
+     */
+    async set(key, value, ttlSeconds) {
+        const ttl = ttlSeconds || this.options.defaultTtl;
+        const now = Date.now();
+        const entry = {
+            value,
+            expiresAt: now + ttl * 1000,
+            createdAt: now,
+        };
+        // Remove oldest entries if cache is full
+        if (this.cache.size >= this.options.maxSize) {
+            this.evictOldest();
+        }
+        this.cache.set(key, entry);
+        logger.debug(`Cache set: ${key} (TTL: ${ttl}s)`);
+    }
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    async invalidate(pattern) {
+        const regex = new RegExp(pattern);
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (regex.test(key)) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach((key) => this.cache.delete(key));
+        logger.debug(`Cache invalidated: ${keysToDelete.length} entries matching "${pattern}"`);
+    }
+    /**
+     * Clear all cache entries
+     */
+    async clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        logger.debug(`Cache cleared: ${size} entries removed`);
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const now = Date.now();
+        let expiredCount = 0;
+        let validCount = 0;
+        for (const entry of this.cache.values()) {
+            if (now > entry.expiresAt) {
+                expiredCount++;
+            }
+            else {
+                validCount++;
+            }
+        }
+        return {
+            totalEntries: this.cache.size,
+            validEntries: validCount,
+            expiredEntries: expiredCount,
+            maxSize: this.options.maxSize,
+            hitRatio: this.getHitRatio(),
+        };
+    }
+    /**
+     * Generate a cache key for registry requests
+     */
+    generateKey(endpoint, params = {}) {
+        const sortedParams = Object.keys(params)
+            .sort()
+            .map((key) => `${key}=${params[key]}`)
+            .join('&');
+        return `${endpoint}${sortedParams ? `?${sortedParams}` : ''}`;
+    }
+    /**
+     * Start the cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.options.cleanupInterval);
+    }
+    /**
+     * Stop the cleanup timer
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        const keysToDelete = [];
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach((key) => this.cache.delete(key));
+        if (keysToDelete.length > 0) {
+            logger.debug(`Cache cleanup: ${keysToDelete.length} expired entries removed`);
+        }
+    }
+    /**
+     * Evict oldest entries when cache is full
+     */
+    evictOldest() {
+        const entries = Array.from(this.cache.entries());
+        entries.sort((a, b) => a[1].createdAt - b[1].createdAt);
+        const toRemove = Math.ceil(this.options.maxSize * 0.1); // Remove 10% of entries
+        for (let i = 0; i < toRemove && entries.length > 0; i++) {
+            const [key] = entries[i];
+            this.cache.delete(key);
+        }
+        logger.debug(`Cache eviction: ${toRemove} oldest entries removed`);
+    }
+    /**
+     * Calculate hit ratio (placeholder for future hit/miss tracking)
+     */
+    getHitRatio() {
+        // TODO: Implement hit/miss tracking for more accurate statistics
+        return 0;
+    }
+}
+//# sourceMappingURL=cacheManager.js.map

package/build/domains/registry/cacheManager.js.map

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

package/build/domains/registry/formatters/commonFormatters.d.ts

@@ -0,0 +1,34 @@
+import { ServerPackage, Transport } from '../../../domains/registry/types.js';
+/**
+ * Truncate string to specified length with ellipsis
+ */
+export declare function truncateString(str: string | null | undefined, maxLength: number): string;
+/**
+ * Format transport value to handle objects and undefined values
+ */
+export declare function formatTransport(transport?: Transport | string): string;
+/**
+ * Format status with colors
+ */
+export declare function formatStatus(status: string | null | undefined): string;
+/**
+ * Format registry types without colors (for table display)
+ */
+export declare function formatRegistryTypesPlain(packages?: ServerPackage[] | null | undefined): string;
+/**
+ * Format transport types without colors (for table display)
+ */
+export declare function formatTransportTypesPlain(packages?: ServerPackage[] | null | undefined): string;
+/**
+ * Format ISO date string to readable format
+ */
+export declare function formatDate(isoString: string): string;
+/**
+ * Format date as relative time (e.g., "2 days ago")
+ */
+export declare function formatRelativeDate(isoString: string): string;
+/**
+ * Format ISO timestamp to readable format with time
+ */
+export declare function formatTimestamp(isoString: string): string;
+//# sourceMappingURL=commonFormatters.d.ts.map

package/build/domains/registry/formatters/commonFormatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonFormatters.d.ts","sourceRoot":"","sources":["../../../../src/domains/registry/formatters/commonFormatters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAI1E;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAQtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CActE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,GAAE,aAAa,EAAE,GAAG,IAAI,GAAG,SAAc,GAAG,MAAM,CAYlG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,GAAE,aAAa,EAAE,GAAG,IAAI,GAAG,SAAc,GAAG,MAAM,CASnG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkBpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA0B5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBzD"}

package/build/domains/registry/formatters/commonFormatters.js

@@ -0,0 +1,154 @@
+import chalk from 'chalk';
+/**
+ * Truncate string to specified length with ellipsis
+ */
+export function truncateString(str, maxLength) {
+    if (!str || typeof str !== 'string')
+        return '';
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Format transport value to handle objects and undefined values
+ */
+export function formatTransport(transport) {
+    if (!transport)
+        return '';
+    if (typeof transport === 'string')
+        return transport;
+    if (typeof transport === 'object') {
+        // Handle case where transport is an object
+        return transport.type || String(transport);
+    }
+    return String(transport);
+}
+/**
+ * Format status with colors
+ */
+export function formatStatus(status) {
+    if (status === '')
+        return chalk.gray('● ');
+    if (!status)
+        return chalk.gray('● UNKNOWN');
+    switch (status) {
+        case 'active':
+            return chalk.green('● ACTIVE');
+        case 'deprecated':
+            return chalk.yellow('● DEPRECATED');
+        case 'archived':
+            return chalk.red('● ARCHIVED');
+        default:
+            return chalk.gray(`● ${status.toUpperCase()}`);
+    }
+}
+/**
+ * Format registry types without colors (for table display)
+ */
+export function formatRegistryTypesPlain(packages = []) {
+    if (!packages)
+        return 'unknown';
+    const types = packages
+        .map((p) => p.registryType)
+        .filter((type) => type && type !== 'unknown')
+        .filter(Boolean);
+    const uniqueTypes = [...new Set(types)];
+    if (uniqueTypes.length === 0)
+        return 'unknown';
+    return uniqueTypes.join(', ');
+}
+/**
+ * Format transport types without colors (for table display)
+ */
+export function formatTransportTypesPlain(packages = []) {
+    if (!packages)
+        return 'stdio';
+    const transports = packages.map((p) => formatTransport(p.transport)).filter(Boolean);
+    const uniqueTransports = [...new Set(transports)];
+    if (uniqueTransports.length === 0)
+        return 'stdio';
+    return uniqueTransports.join(', ');
+}
+/**
+ * Format ISO date string to readable format
+ */
+export function formatDate(isoString) {
+    if (!isoString || typeof isoString !== 'string') {
+        return 'Unknown';
+    }
+    try {
+        const date = new Date(isoString);
+        // Check if date is valid
+        if (isNaN(date.getTime())) {
+            return 'Invalid Date';
+        }
+        return date.toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric',
+        });
+    }
+    catch {
+        return 'Invalid Date';
+    }
+}
+/**
+ * Format date as relative time (e.g., "2 days ago")
+ */
+export function formatRelativeDate(isoString) {
+    if (!isoString)
+        return 'Unknown';
+    try {
+        const date = new Date(isoString);
+        if (isNaN(date.getTime()))
+            return 'Invalid Date';
+        const now = new Date();
+        const diffMs = now.getTime() - date.getTime();
+        const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+        const diffMinutes = Math.floor(diffMs / (1000 * 60));
+        if (diffDays > 7) {
+            return formatDate(isoString);
+        }
+        else if (diffDays > 0) {
+            return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+        }
+        else if (diffHours > 0) {
+            return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+        }
+        else if (diffMinutes > 0) {
+            return `${diffMinutes} minute${diffMinutes > 1 ? 's' : ''} ago`;
+        }
+        else {
+            return 'Just now';
+        }
+    }
+    catch {
+        return 'Invalid Date';
+    }
+}
+/**
+ * Format ISO timestamp to readable format with time
+ */
+export function formatTimestamp(isoString) {
+    if (!isoString)
+        return '';
+    try {
+        const date = new Date(isoString);
+        if (isNaN(date.getTime())) {
+            return isoString;
+        }
+        return date.toLocaleString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+    }
+    catch {
+        return isoString;
+    }
+}
+//# sourceMappingURL=commonFormatters.js.map

package/build/domains/registry/formatters/commonFormatters.js.map

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

package/build/domains/registry/formatters/serverDetailFormatter.d.ts

@@ -0,0 +1,6 @@
+import { OutputFormat, RegistryServer } from '../../../domains/registry/types.js';
+/**
+ * Format a server's details for display
+ */
+export declare function formatServerDetails(server: RegistryServer, format?: OutputFormat): string;
+//# sourceMappingURL=serverDetailFormatter.d.ts.map

package/build/domains/registry/formatters/serverDetailFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverDetailFormatter.d.ts","sourceRoot":"","sources":["../../../../src/domains/registry/formatters/serverDetailFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,cAAc,EAGf,MAAM,gCAAgC,CAAC;AAOxC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,GAAE,YAAsB,GAAG,MAAM,CAUlG"}