universal-agent-memory 1.0.18 → 1.0.20

package/dist/mcp-router/executor/client.js

@@ -0,0 +1,187 @@
+/**
+ * MCP Client Executor
+ * Spawns and communicates with MCP servers
+ */
+import { spawn } from 'child_process';
+export class McpClient {
+    process = null;
+    requestId = 0;
+    pendingRequests = new Map();
+    buffer = '';
+    initialized = false;
+    serverName;
+    config;
+    constructor(serverName, config) {
+        this.serverName = serverName;
+        this.config = config;
+    }
+    async connect() {
+        if (this.process)
+            return;
+        if (this.config.url) {
+            // HTTP/SSE transport - not implemented in lightweight version
+            throw new Error(`HTTP transport not yet supported for ${this.serverName}`);
+        }
+        if (!this.config.command) {
+            throw new Error(`No command specified for server ${this.serverName}`);
+        }
+        const env = { ...process.env, ...this.config.env };
+        this.process = spawn(this.config.command, this.config.args || [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env,
+        });
+        this.process.stdout?.on('data', (data) => {
+            this.handleData(data.toString());
+        });
+        this.process.stderr?.on('data', (data) => {
+            // Log stderr but don't fail
+            console.error(`[${this.serverName}] stderr:`, data.toString());
+        });
+        this.process.on('error', (err) => {
+            console.error(`[${this.serverName}] process error:`, err);
+            this.cleanup();
+        });
+        this.process.on('exit', (code) => {
+            if (code !== 0) {
+                console.error(`[${this.serverName}] exited with code ${code}`);
+            }
+            this.cleanup();
+        });
+        // Initialize MCP connection
+        await this.initialize();
+    }
+    handleData(data) {
+        this.buffer += data;
+        // Process complete JSON-RPC messages (newline-delimited)
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const response = JSON.parse(line);
+                const pending = this.pendingRequests.get(response.id);
+                if (pending) {
+                    this.pendingRequests.delete(response.id);
+                    if (response.error) {
+                        pending.reject(new Error(response.error.message));
+                    }
+                    else {
+                        pending.resolve(response.result);
+                    }
+                }
+            }
+            catch (e) {
+                // Ignore non-JSON lines
+            }
+        }
+    }
+    async sendRequest(method, params) {
+        if (!this.process?.stdin) {
+            throw new Error(`Not connected to ${this.serverName}`);
+        }
+        const id = ++this.requestId;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            params,
+        };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request timeout for ${method}`));
+            }, 30000);
+            const originalResolve = this.pendingRequests.get(id).resolve;
+            this.pendingRequests.get(id).resolve = (value) => {
+                clearTimeout(timeout);
+                originalResolve(value);
+            };
+            this.process.stdin.write(JSON.stringify(request) + '\n');
+        });
+    }
+    async initialize() {
+        await this.sendRequest('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: {
+                name: 'uam-mcp-router',
+                version: '1.0.0',
+            },
+        });
+        // Send initialized notification
+        this.process?.stdin?.write(JSON.stringify({
+            jsonrpc: '2.0',
+            method: 'notifications/initialized',
+        }) + '\n');
+        this.initialized = true;
+    }
+    async listTools() {
+        if (!this.initialized) {
+            await this.connect();
+        }
+        const result = await this.sendRequest('tools/list');
+        return (result.tools || []).map(tool => ({
+            name: tool.name,
+            description: tool.description || '',
+            inputSchema: tool.inputSchema,
+            serverName: this.serverName,
+            serverConfig: this.config,
+        }));
+    }
+    async callTool(toolName, args = {}) {
+        if (!this.initialized) {
+            await this.connect();
+        }
+        const result = await this.sendRequest('tools/call', {
+            name: toolName,
+            arguments: args,
+        });
+        return result;
+    }
+    cleanup() {
+        this.process = null;
+        this.initialized = false;
+        this.buffer = '';
+        // Reject all pending requests
+        for (const [_id, { reject }] of this.pendingRequests) {
+            reject(new Error('Connection closed'));
+        }
+        this.pendingRequests.clear();
+    }
+    disconnect() {
+        if (this.process) {
+            this.process.stdin?.end();
+            this.process.kill();
+            this.cleanup();
+        }
+    }
+    get isConnected() {
+        return this.process !== null && this.initialized;
+    }
+}
+// Connection pool for reusing MCP clients
+export class McpClientPool {
+    clients = new Map();
+    getClient(serverName, config) {
+        let client = this.clients.get(serverName);
+        if (!client) {
+            client = new McpClient(serverName, config);
+            this.clients.set(serverName, client);
+        }
+        return client;
+    }
+    async disconnectAll() {
+        for (const client of this.clients.values()) {
+            client.disconnect();
+        }
+        this.clients.clear();
+    }
+    getConnectedServers() {
+        return Array.from(this.clients.entries())
+            .filter(([_, client]) => client.isConnected)
+            .map(([name]) => name);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/mcp-router/executor/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/mcp-router/executor/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AAiBzD,MAAM,OAAO,SAAS;IACZ,OAAO,GAAwB,IAAI,CAAC;IACpC,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,IAAI,GAAG,EAG7B,CAAC;IACG,MAAM,GAAG,EAAE,CAAC;IACZ,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,CAAS;IACnB,MAAM,CAAkB;IAEhC,YAAY,UAAkB,EAAE,MAAuB;QACrD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACpB,8DAA8D;YAC9D,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAEnD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE;YAChE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC/C,4BAA4B;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,kBAAkB,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,sBAAsB,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAEpB,yDAAyD;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAE3B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;gBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAEtD,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACzC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;oBACpD,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,wBAAwB;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAgB;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;QAC5B,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,MAAM;SACP,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAElD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,OAAO,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;gBAChD,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,eAAe,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC,CAAC;YAEF,IAAI,CAAC,OAAQ,CAAC,KAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YACnC,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE;gBACV,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,OAAO;aACjB;SACF,CAAC,CAAC;QAEH,gCAAgC;QAChC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YACxC,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,2BAA2B;SACpC,CAAC,GAAG,IAAI,CAAC,CAAC;QAEX,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAI9C,CAAC;QAEL,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,WAAW,EAAE,IAAI,CAAC,WAA4C;YAC9D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,MAAM;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,OAAgC,EAAE;QACjE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAClD,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,8BAA8B;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;IACnD,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE/C,SAAS,CAAC,UAAkB,EAAE,MAAuB;QACnD,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,mBAAmB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACtC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/mcp-router/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Router - Lightweight Hierarchical Router for 98%+ Token Reduction
+ *
+ * Instead of exposing 150+ tools to the LLM, exposes just 2:
+ * - discover_tools: Find tools matching a query
+ * - execute_tool: Execute a tool by path
+ *
+ * This reduces context window consumption from ~75,000 tokens to ~700 tokens.
+ */
+export { McpRouter, runStdioServer } from './server.js';
+export type { RouterOptions } from './server.js';
+export { loadConfigFromPaths, loadConfigFromFile, mergeConfigs } from './config/parser.js';
+export { ToolSearchIndex } from './search/fuzzy.js';
+export { McpClient, McpClientPool } from './executor/client.js';
+export { DISCOVER_TOOLS_DEFINITION, handleDiscoverTools, estimateDiscoverToolsTokens, } from './tools/discover.js';
+export { EXECUTE_TOOL_DEFINITION, handleExecuteTool, estimateExecuteToolTokens, } from './tools/execute.js';
+export type { McpConfig, McpServerConfig, ToolDefinition, ToolSearchResult, DiscoverToolsArgs, ExecuteToolArgs, ToolRegistry, RouterStats, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/mcp-router/index.js

@@ -0,0 +1,16 @@
+/**
+ * MCP Router - Lightweight Hierarchical Router for 98%+ Token Reduction
+ *
+ * Instead of exposing 150+ tools to the LLM, exposes just 2:
+ * - discover_tools: Find tools matching a query
+ * - execute_tool: Execute a tool by path
+ *
+ * This reduces context window consumption from ~75,000 tokens to ~700 tokens.
+ */
+export { McpRouter, runStdioServer } from './server.js';
+export { loadConfigFromPaths, loadConfigFromFile, mergeConfigs } from './config/parser.js';
+export { ToolSearchIndex } from './search/fuzzy.js';
+export { McpClient, McpClientPool } from './executor/client.js';
+export { DISCOVER_TOOLS_DEFINITION, handleDiscoverTools, estimateDiscoverToolsTokens, } from './tools/discover.js';
+export { EXECUTE_TOOL_DEFINITION, handleExecuteTool, estimateExecuteToolTokens, } from './tools/execute.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/mcp-router/search/fuzzy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Fuzzy Search for MCP Tools
+ * Uses Fuse.js for semantic-like matching
+ */
+import type { ToolDefinition, ToolSearchResult } from '../types.js';
+interface FuzzyOptions {
+    threshold?: number;
+    keys?: string[];
+}
+export declare class ToolSearchIndex {
+    private tools;
+    private options;
+    constructor(options?: FuzzyOptions);
+    addTools(tools: ToolDefinition[]): void;
+    clear(): void;
+    search(query: string, limit?: number): ToolSearchResult[];
+    searchByServer(serverName: string, limit?: number): ToolSearchResult[];
+    getAllTools(): ToolDefinition[];
+    getToolByPath(path: string): ToolDefinition | undefined;
+    getStats(): {
+        servers: number;
+        tools: number;
+    };
+}
+export {};
+//# sourceMappingURL=fuzzy.d.ts.map

package/dist/mcp-router/search/fuzzy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../../../src/mcp-router/search/fuzzy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpE,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AA+BD,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,GAAE,YAAiB;IAOtC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE;IA4BrD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAalE,WAAW,IAAI,cAAc,EAAE;IAI/B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKvD,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAO/C"}

package/dist/mcp-router/search/fuzzy.js

@@ -0,0 +1,94 @@
+/**
+ * Fuzzy Search for MCP Tools
+ * Uses Fuse.js for semantic-like matching
+ */
+function tokenize(str) {
+    return str.toLowerCase().split(/[\s_\-./]+/).filter(Boolean);
+}
+function calculateScore(query, target) {
+    const queryTokens = tokenize(query);
+    const targetTokens = tokenize(target);
+    if (queryTokens.length === 0 || targetTokens.length === 0)
+        return 0;
+    let matchCount = 0;
+    let partialMatches = 0;
+    for (const qToken of queryTokens) {
+        for (const tToken of targetTokens) {
+            if (tToken === qToken) {
+                matchCount++;
+                break;
+            }
+            else if (tToken.includes(qToken) || qToken.includes(tToken)) {
+                partialMatches += 0.5;
+                break;
+            }
+        }
+    }
+    const totalMatches = matchCount + partialMatches;
+    return totalMatches / queryTokens.length;
+}
+export class ToolSearchIndex {
+    tools = [];
+    options;
+    constructor(options = {}) {
+        this.options = {
+            threshold: options.threshold ?? 0.3,
+            keys: options.keys ?? ['name', 'description'],
+        };
+    }
+    addTools(tools) {
+        this.tools.push(...tools);
+    }
+    clear() {
+        this.tools = [];
+    }
+    search(query, limit = 10) {
+        const results = [];
+        for (const tool of this.tools) {
+            // Calculate score across all searchable fields
+            const nameScore = calculateScore(query, tool.name) * 1.5; // Weight name higher
+            const descScore = calculateScore(query, tool.description);
+            const serverScore = calculateScore(query, tool.serverName) * 0.5;
+            const score = Math.max(nameScore, descScore, serverScore);
+            if (score >= this.options.threshold) {
+                results.push({ tool, score });
+            }
+        }
+        // Sort by score descending
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit).map(({ tool, score }) => ({
+            path: `${tool.serverName}.${tool.name}`,
+            name: tool.name,
+            description: tool.description,
+            server: tool.serverName,
+            score: Math.round(score * 100) / 100,
+        }));
+    }
+    searchByServer(serverName, limit = 50) {
+        return this.tools
+            .filter(t => t.serverName === serverName)
+            .slice(0, limit)
+            .map(tool => ({
+            path: `${tool.serverName}.${tool.name}`,
+            name: tool.name,
+            description: tool.description,
+            server: tool.serverName,
+            score: 1.0,
+        }));
+    }
+    getAllTools() {
+        return [...this.tools];
+    }
+    getToolByPath(path) {
+        const [serverName, toolName] = path.split('.');
+        return this.tools.find(t => t.serverName === serverName && t.name === toolName);
+    }
+    getStats() {
+        const servers = new Set(this.tools.map(t => t.serverName));
+        return {
+            servers: servers.size,
+            tools: this.tools.length,
+        };
+    }
+}
+//# sourceMappingURL=fuzzy.js.map

package/dist/mcp-router/search/fuzzy.js.map

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

package/dist/mcp-router/server.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MCP Router Server
+ * Exposes 2 meta-tools: discover_tools and execute_tool
+ * Achieves 98%+ token reduction by hiding individual tool definitions
+ */
+import { DISCOVER_TOOLS_DEFINITION } from './tools/discover.js';
+import { EXECUTE_TOOL_DEFINITION } from './tools/execute.js';
+import type { McpConfig, RouterStats } from './types.js';
+export interface RouterOptions {
+    configPath?: string;
+    autoDiscover?: boolean;
+    verbose?: boolean;
+}
+export declare class McpRouter {
+    private config;
+    private searchIndex;
+    private clientPool;
+    private options;
+    private toolsLoaded;
+    constructor(options?: RouterOptions);
+    /**
+     * Load tools from all configured MCP servers
+     */
+    loadTools(): Promise<void>;
+    /**
+     * Get the 2 meta-tool definitions (for MCP tools/list)
+     */
+    getToolDefinitions(): Array<typeof DISCOVER_TOOLS_DEFINITION | typeof EXECUTE_TOOL_DEFINITION>;
+    /**
+     * Handle tool call
+     */
+    handleToolCall(name: string, args: unknown): Promise<unknown>;
+    /**
+     * Get router statistics
+     */
+    getStats(): RouterStats;
+    /**
+     * Shutdown - cleanup all connections
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get loaded config
+     */
+    getConfig(): McpConfig;
+}
+/**
+ * Run as stdio MCP server
+ */
+export declare function runStdioServer(options?: RouterOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-router/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-router/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,yBAAyB,EAG1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EAGxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,aAAkB;IAkBvC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAuChC;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC,OAAO,yBAAyB,GAAG,OAAO,uBAAuB,CAAC;IAI9F;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBnE;;OAEG;IACH,QAAQ,IAAI,WAAW;IAsBvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACH,SAAS,IAAI,SAAS;CAGvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsH/E"}

package/dist/mcp-router/server.js

@@ -0,0 +1,229 @@
+/**
+ * MCP Router Server
+ * Exposes 2 meta-tools: discover_tools and execute_tool
+ * Achieves 98%+ token reduction by hiding individual tool definitions
+ */
+import { loadConfigFromPaths, loadConfigFromFile } from './config/parser.js';
+import { ToolSearchIndex } from './search/fuzzy.js';
+import { McpClient, McpClientPool } from './executor/client.js';
+import { DISCOVER_TOOLS_DEFINITION, handleDiscoverTools, estimateDiscoverToolsTokens, } from './tools/discover.js';
+import { EXECUTE_TOOL_DEFINITION, handleExecuteTool, estimateExecuteToolTokens, } from './tools/execute.js';
+export class McpRouter {
+    config;
+    searchIndex;
+    clientPool;
+    options;
+    toolsLoaded = false;
+    constructor(options = {}) {
+        this.options = {
+            autoDiscover: true,
+            verbose: false,
+            ...options,
+        };
+        // Load config
+        if (options.configPath) {
+            this.config = loadConfigFromFile(options.configPath);
+        }
+        else {
+            this.config = loadConfigFromPaths();
+        }
+        this.searchIndex = new ToolSearchIndex({ threshold: 0.2 });
+        this.clientPool = new McpClientPool();
+    }
+    /**
+     * Load tools from all configured MCP servers
+     */
+    async loadTools() {
+        if (this.toolsLoaded)
+            return;
+        const servers = Object.entries(this.config.mcpServers);
+        if (this.options.verbose) {
+            console.error(`[router] Loading tools from ${servers.length} servers...`);
+        }
+        const allTools = [];
+        for (const [serverName, serverConfig] of servers) {
+            try {
+                const client = new McpClient(serverName, serverConfig);
+                await client.connect();
+                const tools = await client.listTools();
+                allTools.push(...tools);
+                client.disconnect();
+                if (this.options.verbose) {
+                    console.error(`[router] ${serverName}: ${tools.length} tools`);
+                }
+            }
+            catch (error) {
+                if (this.options.verbose) {
+                    console.error(`[router] ${serverName}: failed to load - ${error}`);
+                }
+            }
+        }
+        this.searchIndex.clear();
+        this.searchIndex.addTools(allTools);
+        this.toolsLoaded = true;
+        if (this.options.verbose) {
+            const stats = this.searchIndex.getStats();
+            console.error(`[router] Loaded ${stats.tools} tools from ${stats.servers} servers`);
+        }
+    }
+    /**
+     * Get the 2 meta-tool definitions (for MCP tools/list)
+     */
+    getToolDefinitions() {
+        return [DISCOVER_TOOLS_DEFINITION, EXECUTE_TOOL_DEFINITION];
+    }
+    /**
+     * Handle tool call
+     */
+    async handleToolCall(name, args) {
+        // Ensure tools are loaded
+        if (!this.toolsLoaded && this.options.autoDiscover) {
+            await this.loadTools();
+        }
+        switch (name) {
+            case 'discover_tools':
+                return handleDiscoverTools(args, this.searchIndex);
+            case 'execute_tool':
+                return handleExecuteTool(args, this.searchIndex, this.clientPool);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    /**
+     * Get router statistics
+     */
+    getStats() {
+        const { servers, tools } = this.searchIndex.getStats();
+        // Estimate traditional token usage: ~500 tokens per tool
+        const traditionalTokens = tools * 500;
+        // Router uses only 2 tools
+        const routerTokens = estimateDiscoverToolsTokens() + estimateExecuteToolTokens();
+        const savings = traditionalTokens > 0
+            ? ((traditionalTokens - routerTokens) / traditionalTokens * 100).toFixed(1) + '%'
+            : '0%';
+        return {
+            totalServers: servers,
+            totalTools: tools,
+            traditionalTokens,
+            routerTokens,
+            savings,
+        };
+    }
+    /**
+     * Shutdown - cleanup all connections
+     */
+    async shutdown() {
+        await this.clientPool.disconnectAll();
+    }
+    /**
+     * Get loaded config
+     */
+    getConfig() {
+        return this.config;
+    }
+}
+/**
+ * Run as stdio MCP server
+ */
+export async function runStdioServer(options = {}) {
+    const router = new McpRouter({ ...options, verbose: true });
+    let buffer = '';
+    function send(message) {
+        process.stdout.write(JSON.stringify(message) + '\n');
+    }
+    function handleMessage(message) {
+        const { id, method, params } = message;
+        switch (method) {
+            case 'initialize':
+                send({
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: {
+                            tools: {},
+                        },
+                        serverInfo: {
+                            name: 'uam-mcp-router',
+                            version: '1.0.0',
+                        },
+                    },
+                });
+                break;
+            case 'notifications/initialized':
+                // No response needed
+                break;
+            case 'tools/list':
+                send({
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        tools: router.getToolDefinitions(),
+                    },
+                });
+                break;
+            case 'tools/call': {
+                const { name, arguments: args } = params;
+                router.handleToolCall(name, args)
+                    .then(result => {
+                    send({
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                        },
+                    });
+                })
+                    .catch(error => {
+                    send({
+                        jsonrpc: '2.0',
+                        id,
+                        error: {
+                            code: -32000,
+                            message: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+                });
+                break;
+            }
+            default:
+                if (id !== undefined) {
+                    send({
+                        jsonrpc: '2.0',
+                        id,
+                        error: {
+                            code: -32601,
+                            message: `Method not found: ${method}`,
+                        },
+                    });
+                }
+        }
+    }
+    process.stdin.on('data', (data) => {
+        buffer += data.toString();
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                handleMessage(message);
+            }
+            catch (e) {
+                console.error('[router] Invalid JSON:', e);
+            }
+        }
+    });
+    process.stdin.on('end', async () => {
+        await router.shutdown();
+        process.exit(0);
+    });
+    process.on('SIGINT', async () => {
+        await router.shutdown();
+        process.exit(0);
+    });
+    console.error('[router] MCP Router server started (stdio)');
+    console.error('[router] Exposing 2 tools: discover_tools, execute_tool');
+}
+//# sourceMappingURL=server.js.map