@1mcp/agent 0.25.4 → 0.26.0

package/build/domains/registry/searchFiltering.js

@@ -0,0 +1,201 @@
+import { OFFICIAL_REGISTRY_KEY } from '../../domains/registry/types.js';
+/**
+ * Search and filtering utilities for MCP servers
+ */
+export class SearchEngine {
+    /**
+     * Perform fuzzy search on server name and description
+     */
+    fuzzySearch(query, servers) {
+        if (!query.trim()) {
+            return servers;
+        }
+        const normalizedQuery = query.toLowerCase().trim();
+        const queryWords = normalizedQuery.split(/\s+/);
+        return servers
+            .map((server) => ({
+            server,
+            score: this.calculateRelevanceScore(server, normalizedQuery, queryWords),
+        }))
+            .filter(({ score }) => score > 10) // Higher threshold for matches
+            .sort((a, b) => b.score - a.score)
+            .map(({ server }) => server);
+    }
+    /**
+     * Filter servers by status
+     */
+    filterByStatus(servers, status) {
+        if (!status || status === 'all') {
+            return servers;
+        }
+        return servers.filter((server) => {
+            // Try to get status from the server object first (legacy)
+            if (server.status) {
+                return server.status === status;
+            }
+            // If not found, try to get from metadata
+            const registryMeta = server._meta?.[OFFICIAL_REGISTRY_KEY];
+            if (registryMeta?.status) {
+                return registryMeta.status === status;
+            }
+            // If no status found, include the server (assume active)
+            return status === 'active';
+        });
+    }
+    /**
+     * Filter servers by registry type
+     */
+    filterByRegistryType(servers, type) {
+        if (!type) {
+            return servers;
+        }
+        // Since new schema doesn't have registry_type, return all servers
+        return servers;
+    }
+    /**
+     * Filter servers by transport method
+     */
+    filterByTransport(servers, transport) {
+        if (!transport) {
+            return servers;
+        }
+        return servers.filter((server) => (server.remotes && server.remotes.some((remote) => remote.type === transport)) ||
+            (server.packages && server.packages.some((pkg) => pkg.transport?.type === transport)));
+    }
+    /**
+     * Rank search results by relevance and recency
+     */
+    rankResults(servers, query) {
+        if (!query) {
+            // Sort by update recency if no query
+            return servers.sort((a, b) => {
+                const aMeta = a._meta?.[OFFICIAL_REGISTRY_KEY];
+                const bMeta = b._meta?.[OFFICIAL_REGISTRY_KEY];
+                if (!aMeta || !bMeta) {
+                    return 0;
+                }
+                return new Date(bMeta.updatedAt || 0).getTime() - new Date(aMeta.updatedAt || 0).getTime();
+            });
+        }
+        // Use fuzzy search which already includes ranking
+        return this.fuzzySearch(query, servers);
+    }
+    /**
+     * Calculate relevance score for a server against a search query
+     */
+    calculateRelevanceScore(server, normalizedQuery, queryWords) {
+        let score = 0;
+        const name = server.name.toLowerCase();
+        const description = server.description.toLowerCase();
+        // Exact name match gets highest score
+        if (name === normalizedQuery) {
+            score += 100;
+        }
+        else if (name.includes(normalizedQuery)) {
+            // Name contains full query
+            score += 50;
+        }
+        else if (description.includes(normalizedQuery)) {
+            // Description contains full query
+            score += 30;
+        }
+        else {
+            // Score for individual word matches (only if no full match found)
+            let nameWordMatches = 0;
+            let descWordMatches = 0;
+            queryWords.forEach((word) => {
+                if (name.includes(word)) {
+                    score += 20;
+                    nameWordMatches++;
+                }
+                if (description.includes(word)) {
+                    score += 10;
+                    descWordMatches++;
+                }
+            });
+            // Bonus for matching multiple words - prioritize better matches
+            if (nameWordMatches > 1) {
+                score += nameWordMatches * 10; // Bonus for multiple name word matches
+            }
+            if (descWordMatches > 1) {
+                score += descWordMatches * 5; // Bonus for multiple description word matches
+            }
+            // Only give fuzzy points if there are some exact word matches
+            if (nameWordMatches > 0 || descWordMatches > 0) {
+                score += this.calculateFuzzyScore(name, normalizedQuery) * 2;
+                score += this.calculateFuzzyScore(description, normalizedQuery) * 1;
+            }
+        }
+        // Only apply multipliers if we have a base score
+        if (score > 0) {
+            // Boost active servers, penalize deprecated ones
+            if (server.status === 'active') {
+                score *= 1.3;
+            }
+            else if (server.status === 'deprecated') {
+                score *= 0.5; // Heavy penalty for deprecated servers
+            }
+            // Boost recently updated servers (within last 6 months)
+            const sixMonthsAgo = new Date();
+            sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
+            const updatedAt = server._meta[OFFICIAL_REGISTRY_KEY].updatedAt;
+            if (updatedAt && new Date(updatedAt) > sixMonthsAgo) {
+                score *= 1.2;
+            }
+            // Boost latest versions
+            if (server._meta[OFFICIAL_REGISTRY_KEY].isLatest) {
+                score *= 1.1;
+            }
+        }
+        return Math.round(score);
+    }
+    /**
+     * Calculate fuzzy matching score using simplified Levenshtein approach
+     */
+    calculateFuzzyScore(text, query) {
+        if (text === query)
+            return 10;
+        if (text.includes(query))
+            return 8;
+        let matches = 0;
+        const queryChars = query.split('');
+        const textChars = text.split('');
+        queryChars.forEach((char) => {
+            if (textChars.includes(char)) {
+                matches++;
+            }
+        });
+        return (matches / query.length) * 5;
+    }
+    /**
+     * Apply all filters and search to a server list
+     */
+    applyFilters(servers, options) {
+        let filtered = servers;
+        // Apply filters
+        if (options.status) {
+            filtered = this.filterByStatus(filtered, options.status);
+        }
+        if (options.registry_type) {
+            filtered = this.filterByRegistryType(filtered, options.registry_type);
+        }
+        if (options.transport) {
+            filtered = this.filterByTransport(filtered, options.transport);
+        }
+        // Apply search and ranking
+        if (options.query) {
+            filtered = this.fuzzySearch(options.query, filtered);
+        }
+        else {
+            filtered = this.rankResults(filtered);
+        }
+        return filtered;
+    }
+}
+/**
+ * Create a search engine instance
+ */
+export function createSearchEngine() {
+    return new SearchEngine();
+}
+//# sourceMappingURL=searchFiltering.js.map

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

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

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

@@ -0,0 +1,204 @@
+/**
+ * Type definitions for MCP Registry data structures
+ */
+export declare const OFFICIAL_REGISTRY_KEY = "io.modelcontextprotocol.registry/official";
+export interface Repository {
+    id?: string;
+    source: string;
+    subfolder?: string;
+    url: string;
+}
+/**
+ * Server data structure
+ */
+export interface RegistryServer {
+    $schema?: string;
+    name: string;
+    description: string;
+    status: string;
+    version: string;
+    repository: Repository;
+    packages?: ServerPackage[];
+    remotes?: ServerRemote[];
+    websiteUrl?: string;
+    _meta: ServerMeta;
+}
+export interface Input {
+    choices?: string[];
+    default?: string;
+    description?: string;
+    format?: string;
+    isRequired?: boolean;
+    isSecret?: boolean;
+    value?: string;
+    variables?: Record<string, Input>;
+}
+export interface Argument {
+    choices?: string[];
+    default?: string;
+    description?: string;
+    format?: string;
+    isRepeated?: boolean;
+    isRequired?: boolean;
+    isSecret?: boolean;
+    name?: string;
+    type?: string;
+    value?: string;
+    valueHint?: string;
+    variables?: Record<string, Input>;
+}
+export interface ServerPackage {
+    environmentVariables?: Input[];
+    fileSha256?: string;
+    identifier: string;
+    packageArguments?: Argument[];
+    registryBaseUrl?: string;
+    registryType: string;
+    runtimeArguments?: Argument[];
+    runtimeHint?: string;
+    transport?: Transport;
+    version?: string;
+}
+export interface ServerRemote {
+    headers?: Input[];
+    type: string;
+    url: string;
+}
+export interface OfficialMeta {
+    isLatest: boolean;
+    publishedAt: string;
+    serverId: string;
+    updatedAt: string;
+    versionId: string;
+}
+export interface ServerMeta {
+    [OFFICIAL_REGISTRY_KEY]: RegistryExtensions;
+    [key: string]: Record<string, any>;
+}
+export interface ServerListOptions {
+    limit?: number;
+    cursor?: string;
+    updated_since?: string;
+    search?: string;
+    version?: string;
+}
+export interface SearchOptions extends ServerListOptions {
+    query?: string;
+    status?: 'active' | 'archived' | 'deprecated' | 'all';
+    registry_type?: 'npm' | 'pypi' | 'docker';
+    transport?: 'stdio' | 'sse' | 'webhook';
+}
+export interface Transport {
+    headers?: Input[];
+    type: string;
+    url?: string;
+}
+export interface ServersListResponse {
+    servers: ServerResponse[] | null;
+    metadata: {
+        nextCursor?: string;
+        count: number;
+    };
+}
+export interface ServerListResponse {
+    servers: ServerResponse[] | null;
+    metadata: {
+        nextCursor?: string;
+        count: number;
+    };
+}
+export interface ServerResponse {
+    server: RegistryServer;
+    _meta: ResponseMeta;
+}
+export interface ResponseMeta {
+    'io.modelcontextprotocol.registry/official': RegistryExtensions;
+}
+export interface RegistryExtensions {
+    isLatest: boolean;
+    publishedAt: string;
+    status: 'active' | 'deprecated' | 'deleted';
+    updatedAt: string;
+    serverId: string;
+    versionId: string;
+}
+export interface ServerVersion {
+    version: string;
+    publishedAt: string;
+    updatedAt: string;
+    isLatest: boolean;
+    status: 'active' | 'archived' | 'deprecated';
+}
+export interface ServerVersionsResponse {
+    versions: ServerVersion[];
+    serverId: string;
+    name: string;
+}
+export interface RegistryStatusResult {
+    available: boolean;
+    url: string;
+    response_time_ms: number;
+    last_updated: string;
+    github_client_id?: string;
+    stats?: {
+        total_servers: number;
+        active_servers: number;
+        deprecated_servers: number;
+        by_registry_type: Record<string, number>;
+        by_transport: Record<string, number>;
+    };
+}
+export interface CacheOptions {
+    defaultTtl: number;
+    maxSize: number;
+    cleanupInterval: number;
+}
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+    createdAt: number;
+}
+export interface RegistryClientOptions {
+    baseUrl: string;
+    timeout: number;
+    cache?: CacheOptions;
+    proxy?: {
+        url: string;
+        auth?: {
+            username: string;
+            password: string;
+        };
+    };
+}
+/**
+ * CLI registry options interface - maps to command line options
+ */
+export interface RegistryOptions {
+    url?: string;
+    timeout?: number;
+    cacheTtl?: number;
+    cacheMaxSize?: number;
+    cacheCleanupInterval?: number;
+    proxy?: string;
+    proxyAuth?: string;
+}
+/**
+ * Output format types for registry commands
+ */
+export type OutputFormat = 'table' | 'json' | 'detailed';
+/**
+ * Show command arguments
+ */
+export interface ShowCommandArgs {
+    serverId: string;
+    version?: string;
+    format?: OutputFormat;
+}
+/**
+ * Versions command arguments
+ */
+export interface VersionsCommandArgs {
+    serverId: string;
+    format?: OutputFormat;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/build/domains/registry/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for MCP Registry data structures
+ */
+export const OFFICIAL_REGISTRY_KEY = 'io.modelcontextprotocol.registry/official';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domains/registry/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,2CAA2C,CAAC"}

package/build/index.js

@@ -9,6 +9,7 @@ import { setupAppCommands } from './commands/app/index.js';
 import { setupMcpCommands } from './commands/mcp/index.js';
 import { setupPresetCommands } from './commands/preset/index.js';
 import { setupProxyCommand } from './commands/proxy/index.js';
+import { setupRegistryCommands } from './commands/registry/index.js';
 import { serverOptions, setupServeCommand } from './commands/serve/index.js';
 import { configureGlobalLogger } from './logger/configureGlobalLogger.js';
 // Parse command line arguments and set up commands
@@ -45,6 +46,7 @@ yargsInstance = setupMcpCommands(yargsInstance);
 yargsInstance = setupPresetCommands(yargsInstance);
 yargsInstance = setupServeCommand(yargsInstance);
 yargsInstance = setupProxyCommand(yargsInstance);
+yargsInstance = setupRegistryCommands(yargsInstance);
 /**
  * Check for conflicting global options (options specified both before and after the command)
  */

package/build/index.js.map

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

package/build/transport/http/restorableStreamableTransport.d.ts

@@ -0,0 +1,52 @@
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+/**
+ * RestorableStreamableHTTPServerTransport extends the MCP SDK's StreamableHTTPServerTransport
+ * to provide proper session restoration capabilities without directly accessing private fields.
+ *
+ * This wrapper class encapsulates the initialization logic needed for restored sessions,
+ * providing a clean interface that's less likely to break with SDK updates.
+ *
+ * @example
+ * ```typescript
+ * // For session restoration
+ * const transport = new RestorableStreamableHTTPServerTransport({
+ *   sessionIdGenerator: () => sessionId,
+ * });
+ * transport.markAsInitialized();
+ *
+ * // Check if session was restored
+ * if (transport.isRestored()) {
+ *   // Handle restored session logic
+ * }
+ * ```
+ */
+export declare class RestorableStreamableHTTPServerTransport extends StreamableHTTPServerTransport {
+    private _isRestored;
+    /**
+     * Marks the transport as initialized for restored sessions.
+     *
+     * When restoring a session, the client won't send an initialize request again
+     * because from the client's perspective, the session is already initialized.
+     * The MCP SDK checks the _initialized flag and rejects requests if it's false.
+     * This method safely sets that flag to allow the restored session to work.
+     *
+     * @throws Will log a warning if initialization fails but won't throw an error
+     */
+    markAsInitialized(): void;
+    /**
+     * Returns whether this transport was created for a restored session.
+     *
+     * @returns true if the transport was restored from persistent storage, false otherwise
+     */
+    isRestored(): boolean;
+    /**
+     * Gets the restoration status for debugging purposes.
+     *
+     * @returns Object containing restoration metadata
+     */
+    getRestorationInfo(): {
+        isRestored: boolean;
+        sessionId?: string;
+    };
+}
+//# sourceMappingURL=restorableStreamableTransport.d.ts.map

package/build/transport/http/restorableStreamableTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restorableStreamableTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,uCAAwC,SAAQ,6BAA6B;IACxF,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;;;OASG;IACH,iBAAiB,IAAI,IAAI;IAYzB;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,kBAAkB,IAAI;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;CAMlE"}

package/build/transport/http/restorableStreamableTransport.js

@@ -0,0 +1,68 @@
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import logger from '../../logger/logger.js';
+/**
+ * RestorableStreamableHTTPServerTransport extends the MCP SDK's StreamableHTTPServerTransport
+ * to provide proper session restoration capabilities without directly accessing private fields.
+ *
+ * This wrapper class encapsulates the initialization logic needed for restored sessions,
+ * providing a clean interface that's less likely to break with SDK updates.
+ *
+ * @example
+ * ```typescript
+ * // For session restoration
+ * const transport = new RestorableStreamableHTTPServerTransport({
+ *   sessionIdGenerator: () => sessionId,
+ * });
+ * transport.markAsInitialized();
+ *
+ * // Check if session was restored
+ * if (transport.isRestored()) {
+ *   // Handle restored session logic
+ * }
+ * ```
+ */
+export class RestorableStreamableHTTPServerTransport extends StreamableHTTPServerTransport {
+    _isRestored = false;
+    /**
+     * Marks the transport as initialized for restored sessions.
+     *
+     * When restoring a session, the client won't send an initialize request again
+     * because from the client's perspective, the session is already initialized.
+     * The MCP SDK checks the _initialized flag and rejects requests if it's false.
+     * This method safely sets that flag to allow the restored session to work.
+     *
+     * @throws Will log a warning if initialization fails but won't throw an error
+     */
+    markAsInitialized() {
+        try {
+            // Safely set the SDK's internal _initialized flag
+            this._initialized = true;
+            this._isRestored = true;
+            logger.debug('Transport marked as initialized for restored session');
+        }
+        catch (error) {
+            logger.warn('Could not mark transport as initialized:', error);
+            // Don't throw - let the session attempt to work without the flag
+        }
+    }
+    /**
+     * Returns whether this transport was created for a restored session.
+     *
+     * @returns true if the transport was restored from persistent storage, false otherwise
+     */
+    isRestored() {
+        return this._isRestored;
+    }
+    /**
+     * Gets the restoration status for debugging purposes.
+     *
+     * @returns Object containing restoration metadata
+     */
+    getRestorationInfo() {
+        return {
+            isRestored: this._isRestored,
+            sessionId: this.sessionId,
+        };
+    }
+}
+//# sourceMappingURL=restorableStreamableTransport.js.map

package/build/transport/http/restorableStreamableTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restorableStreamableTransport.js","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,uCAAwC,SAAQ,6BAA6B;IAChF,WAAW,GAAG,KAAK,CAAC;IAE5B;;;;;;;;;OASG;IACH,iBAAiB;QACf,IAAI,CAAC;YACH,kDAAkD;YACjD,IAAY,CAAC,YAAY,GAAG,IAAI,CAAC;YAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YAC/D,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF"}

package/build/transport/http/routes/streamableHttpRoutes.d.ts

@@ -1,5 +1,6 @@
 import { AsyncLoadingOrchestrator } from '../../../core/capabilities/asyncLoadingOrchestrator.js';
 import { ServerManager } from '../../../core/server/serverManager.js';
+import { StreamableSessionRepository } from '../../../transport/http/storage/streamableSessionRepository.js';
 import { Router } from 'express';
-export declare function setupStreamableHttpRoutes(router: Router, serverManager: ServerManager, authMiddleware: any, availabilityMiddleware?: any, asyncOrchestrator?: AsyncLoadingOrchestrator, customTemplate?: string): void;
+export declare function setupStreamableHttpRoutes(router: Router, serverManager: ServerManager, sessionRepository: StreamableSessionRepository, authMiddleware: any, availabilityMiddleware?: any, asyncOrchestrator?: AsyncLoadingOrchestrator, customTemplate?: string): void;
 //# sourceMappingURL=streamableHttpRoutes.d.ts.map

package/build/transport/http/routes/streamableHttpRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamableHttpRoutes.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/streamableHttpRoutes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAYlE,OAAO,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,GAAG,EACnB,sBAAsB,CAAC,EAAE,GAAG,EAC5B,iBAAiB,CAAC,EAAE,wBAAwB,EAC5C,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAoJN"}
+{"version":3,"file":"streamableHttpRoutes.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/streamableHttpRoutes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAYlE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAEzG,OAAO,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAwEpD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,2BAA2B,EAC9C,cAAc,EAAE,GAAG,EACnB,sBAAsB,CAAC,EAAE,GAAG,EAC5B,iBAAiB,CAAC,EAAE,wBAAwB,EAC5C,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CA0LN"}