universal-agent-protocol 0.5.0

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

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

package/dist/mcp-router/session-stats.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session Stats - Real-time context consumption tracking.
+ *
+ * Records per-tool-call byte usage (raw vs compressed) so users
+ * can see where their context window budget goes.
+ */
+export interface ToolCallRecord {
+    tool: string;
+    timestamp: number;
+    rawBytes: number;
+    contextBytes: number;
+}
+export interface ToolBreakdown {
+    tool: string;
+    calls: number;
+    contextBytes: number;
+    rawBytes: number;
+}
+export interface StatsSummary {
+    uptimeMs: number;
+    totalCalls: number;
+    totalContextBytes: number;
+    totalRawBytes: number;
+    savingsRatio: number;
+    savingsPercent: string;
+    byTool: ToolBreakdown[];
+}
+export declare class SessionStats {
+    private startTime;
+    private calls;
+    record(tool: string, rawBytes: number, contextBytes: number): void;
+    getSummary(): StatsSummary;
+    reset(): void;
+    getCalls(): ReadonlyArray<ToolCallRecord>;
+}
+export declare const globalSessionStats: SessionStats;
+//# sourceMappingURL=session-stats.d.ts.map

package/dist/mcp-router/session-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-stats.d.ts","sourceRoot":"","sources":["../../src/mcp-router/session-stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,KAAK,CAAwB;IAErC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IASlE,UAAU,IAAI,YAAY;IAiC1B,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC;CAG1C;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

package/dist/mcp-router/session-stats.js

@@ -0,0 +1,56 @@
+/**
+ * Session Stats - Real-time context consumption tracking.
+ *
+ * Records per-tool-call byte usage (raw vs compressed) so users
+ * can see where their context window budget goes.
+ */
+export class SessionStats {
+    startTime = Date.now();
+    calls = [];
+    record(tool, rawBytes, contextBytes) {
+        this.calls.push({
+            tool,
+            timestamp: Date.now(),
+            rawBytes,
+            contextBytes,
+        });
+    }
+    getSummary() {
+        const totalRawBytes = this.calls.reduce((s, c) => s + c.rawBytes, 0);
+        const totalContextBytes = this.calls.reduce((s, c) => s + c.contextBytes, 0);
+        const savingsRatio = totalContextBytes > 0 ? totalRawBytes / totalContextBytes : 1;
+        const savingsPercent = totalRawBytes > 0
+            ? `${Math.round((1 - totalContextBytes / totalRawBytes) * 100)}%`
+            : '0%';
+        // Aggregate by tool
+        const toolMap = new Map();
+        for (const call of this.calls) {
+            const existing = toolMap.get(call.tool) || { calls: 0, contextBytes: 0, rawBytes: 0 };
+            existing.calls++;
+            existing.contextBytes += call.contextBytes;
+            existing.rawBytes += call.rawBytes;
+            toolMap.set(call.tool, existing);
+        }
+        const byTool = Array.from(toolMap.entries())
+            .map(([tool, data]) => ({ tool, ...data }))
+            .sort((a, b) => b.contextBytes - a.contextBytes);
+        return {
+            uptimeMs: Date.now() - this.startTime,
+            totalCalls: this.calls.length,
+            totalContextBytes,
+            totalRawBytes,
+            savingsRatio: Math.round(savingsRatio * 10) / 10,
+            savingsPercent,
+            byTool,
+        };
+    }
+    reset() {
+        this.startTime = Date.now();
+        this.calls = [];
+    }
+    getCalls() {
+        return this.calls;
+    }
+}
+export const globalSessionStats = new SessionStats();
+//# sourceMappingURL=session-stats.js.map

package/dist/mcp-router/session-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-stats.js","sourceRoot":"","sources":["../../src/mcp-router/session-stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,MAAM,OAAO,YAAY;IACf,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,GAAqB,EAAE,CAAC;IAErC,MAAM,CAAC,IAAY,EAAE,QAAgB,EAAE,YAAoB;QACzD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ;YACR,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,YAAY,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,cAAc,GAAG,aAAa,GAAG,CAAC;YACtC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC,GAAG;YACjE,CAAC,CAAC,IAAI,CAAC;QAET,oBAAoB;QACpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqE,CAAC;QAC7F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACtF,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,QAAQ,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;YAC3C,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACzC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;QAEnD,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACrC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YAC7B,iBAAiB;YACjB,aAAa;YACb,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,EAAE;YAChD,cAAc;YACd,MAAM;SACP,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/mcp-router/tools/discover.d.ts

@@ -0,0 +1,37 @@
+/**
+ * discover_tools - Meta-tool for finding MCP tools
+ *
+ * This is one of the 2 tools exposed by the router (the other being execute_tool).
+ * Instead of loading 150+ tool definitions, the LLM uses this to find relevant tools.
+ */
+import type { DiscoverToolsArgs, ToolSearchResult } from '../types.js';
+import type { ToolSearchIndex } from '../search/fuzzy.js';
+export declare const DISCOVER_TOOLS_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            server: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleDiscoverTools(args: DiscoverToolsArgs, searchIndex: ToolSearchIndex): {
+    tools: ToolSearchResult[];
+    hint: string;
+};
+export declare function estimateDiscoverToolsTokens(): number;
+//# sourceMappingURL=discover.d.ts.map

package/dist/mcp-router/tools/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/mcp-router/tools/discover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;CA6BrC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,eAAe,GAC3B;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA0B7C;AAGD,wBAAgB,2BAA2B,IAAI,MAAM,CAIpD"}

package/dist/mcp-router/tools/discover.js

@@ -0,0 +1,65 @@
+/**
+ * discover_tools - Meta-tool for finding MCP tools
+ *
+ * This is one of the 2 tools exposed by the router (the other being execute_tool).
+ * Instead of loading 150+ tool definitions, the LLM uses this to find relevant tools.
+ */
+export const DISCOVER_TOOLS_DEFINITION = {
+    name: 'discover_tools',
+    description: `Find MCP tools matching a natural language query. Returns tool paths that can be used with execute_tool.
+
+Examples:
+- "github issues" → finds github.create_issue, github.list_issues, etc.
+- "file operations" → finds filesystem.read_file, filesystem.write_file, etc.
+- "search" → finds tools across all servers with search capabilities
+
+Use this FIRST to discover available tools, then use execute_tool with the returned path.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Natural language search query (e.g., "create github issue", "read files", "search documentation")',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 10)',
+                default: 10,
+            },
+            server: {
+                type: 'string',
+                description: 'Optional: filter to specific server (e.g., "github", "filesystem")',
+            },
+        },
+        required: ['query'],
+    },
+};
+export function handleDiscoverTools(args, searchIndex) {
+    const { query, limit = 10, server } = args;
+    let results;
+    if (server) {
+        // Filter to specific server
+        results = searchIndex.searchByServer(server, limit);
+        if (query) {
+            // Further filter by query within server
+            const queryLower = query.toLowerCase();
+            results = results.filter(r => r.name.toLowerCase().includes(queryLower) ||
+                r.description.toLowerCase().includes(queryLower));
+        }
+    }
+    else {
+        results = searchIndex.search(query, limit);
+    }
+    // Format hint for LLM
+    const hint = results.length > 0
+        ? `Found ${results.length} tools. Use execute_tool with the path (e.g., execute_tool({ path: "${results[0].path}", args: {...} }))`
+        : 'No tools found. Try a different query or check available servers with discover_tools({ query: "*" })';
+    return { tools: results, hint };
+}
+// Token estimation for the discover_tools definition
+export function estimateDiscoverToolsTokens() {
+    const json = JSON.stringify(DISCOVER_TOOLS_DEFINITION);
+    // Rough estimate: ~4 chars per token
+    return Math.ceil(json.length / 4);
+}
+//# sourceMappingURL=discover.js.map

package/dist/mcp-router/tools/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/mcp-router/tools/discover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;0FAO2E;IACxF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mGAAmG;aACjH;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;gBAChE,OAAO,EAAE,EAAE;aACZ;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oEAAoE;aAClF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,IAAuB,EACvB,WAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE3C,IAAI,OAA2B,CAAC;IAEhC,IAAI,MAAM,EAAE,CAAC;QACX,4BAA4B;QAC5B,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC;YACV,wCAAwC;YACxC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC3B,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACzC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,sBAAsB;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7B,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,uEAAuE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,oBAAoB;QACnI,CAAC,CAAC,sGAAsG,CAAC;IAE3G,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,2BAA2B;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACvD,qCAAqC;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/mcp-router/tools/execute.d.ts

@@ -0,0 +1,43 @@
+/**
+ * execute_tool - Meta-tool for executing MCP tools
+ *
+ * This is one of the 2 tools exposed by the router (the other being discover_tools).
+ * Routes tool calls to the appropriate MCP server.
+ */
+import type { ExecuteToolArgs, OutputCompressionStats } from '../types.js';
+import type { ToolSearchIndex } from '../search/fuzzy.js';
+import type { McpClientPool } from '../executor/client.js';
+export declare const EXECUTE_TOOL_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            args: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+            intent: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ExecuteResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    toolPath: string;
+    executionTimeMs: number;
+    compressionStats?: OutputCompressionStats;
+}
+export declare function handleExecuteTool(args: ExecuteToolArgs, searchIndex: ToolSearchIndex, clientPool: McpClientPool): Promise<ExecuteResult>;
+export declare function estimateExecuteToolTokens(): number;
+//# sourceMappingURL=execute.d.ts.map

package/dist/mcp-router/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/mcp-router/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;CA+BnC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,aAAa,CAAC,CAmExB;AAGD,wBAAgB,yBAAyB,IAAI,MAAM,CAIlD"}

package/dist/mcp-router/tools/execute.js

@@ -0,0 +1,103 @@
+/**
+ * execute_tool - Meta-tool for executing MCP tools
+ *
+ * This is one of the 2 tools exposed by the router (the other being discover_tools).
+ * Routes tool calls to the appropriate MCP server.
+ */
+import { compressToolOutput } from '../output-compressor.js';
+import { globalSessionStats } from '../session-stats.js';
+export const EXECUTE_TOOL_DEFINITION = {
+    name: 'execute_tool',
+    description: `Execute an MCP tool by its path. Use discover_tools first to find the correct path.
+
+Path format: "server.tool_name" (e.g., "github.create_issue", "filesystem.read_file")
+
+Example:
+1. First: discover_tools({ query: "github issues" })
+   → Returns: [{ path: "github.create_issue", ... }]
+2. Then: execute_tool({ path: "github.create_issue", args: { title: "Bug", body: "..." } })
+
+The args object should match the tool's expected input schema.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Tool path in format "server.tool_name" (from discover_tools results)',
+            },
+            args: {
+                type: 'object',
+                description: 'Arguments to pass to the tool (schema depends on the specific tool)',
+                additionalProperties: true,
+            },
+            intent: {
+                type: 'string',
+                description: 'Optional: describe what you are looking for in the output. For large results (>10KB), only matching sections are returned instead of the full output.',
+            },
+        },
+        required: ['path'],
+    },
+};
+export async function handleExecuteTool(args, searchIndex, clientPool) {
+    const startTime = Date.now();
+    const { path, args: toolArgs = {}, intent } = args;
+    // Parse path
+    const dotIndex = path.indexOf('.');
+    if (dotIndex === -1) {
+        return {
+            success: false,
+            error: `Invalid tool path "${path}". Expected format: "server.tool_name"`,
+            toolPath: path,
+            executionTimeMs: Date.now() - startTime,
+        };
+    }
+    const serverName = path.slice(0, dotIndex);
+    const toolName = path.slice(dotIndex + 1);
+    // Find tool definition
+    const tool = searchIndex.getToolByPath(path);
+    if (!tool) {
+        // Try fuzzy match suggestion
+        const suggestions = searchIndex.search(toolName, 3);
+        const suggestionText = suggestions.length > 0
+            ? ` Did you mean: ${suggestions.map(s => s.path).join(', ')}?`
+            : '';
+        return {
+            success: false,
+            error: `Tool "${path}" not found.${suggestionText}`,
+            toolPath: path,
+            executionTimeMs: Date.now() - startTime,
+        };
+    }
+    // Get or create client for this server
+    const client = clientPool.getClient(serverName, tool.serverConfig);
+    try {
+        await client.connect();
+        const rawResult = await client.callTool(toolName, toolArgs);
+        // Compress output to save context window
+        const compressed = compressToolOutput(rawResult, { intent });
+        // Record stats
+        globalSessionStats.record(path, compressed.stats.originalBytes, compressed.stats.compressedBytes);
+        return {
+            success: true,
+            result: compressed.output,
+            toolPath: path,
+            executionTimeMs: Date.now() - startTime,
+            compressionStats: compressed.stats,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            toolPath: path,
+            executionTimeMs: Date.now() - startTime,
+        };
+    }
+}
+// Token estimation for the execute_tool definition
+export function estimateExecuteToolTokens() {
+    const json = JSON.stringify(EXECUTE_TOOL_DEFINITION);
+    // Rough estimate: ~4 chars per token
+    return Math.ceil(json.length / 4);
+}
+//# sourceMappingURL=execute.js.map

package/dist/mcp-router/tools/execute.js.map

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

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

@@ -0,0 +1,62 @@
+/**
+ * MCP Router Types
+ * Lightweight hierarchical router for 98%+ token reduction
+ */
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    transport?: 'stdio' | 'http' | 'sse';
+    disabled?: boolean;
+}
+export interface McpConfig {
+    mcpServers: Record<string, McpServerConfig>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    serverName: string;
+    serverConfig: McpServerConfig;
+}
+export interface ToolSearchResult {
+    path: string;
+    name: string;
+    description: string;
+    server: string;
+    score: number;
+}
+export interface DiscoverToolsArgs {
+    query: string;
+    limit?: number;
+    server?: string;
+}
+export interface ExecuteToolArgs {
+    path: string;
+    args?: Record<string, unknown>;
+    intent?: string;
+}
+export interface OutputCompressionStats {
+    originalBytes: number;
+    compressedBytes: number;
+    savings: string;
+    method: 'passthrough' | 'truncated' | 'indexed';
+}
+export interface ToolRegistry {
+    tools: Map<string, ToolDefinition>;
+    servers: Map<string, McpServerConfig>;
+    searchIndex: unknown;
+}
+export interface RouterStats {
+    totalServers: number;
+    totalTools: number;
+    traditionalTokens: number;
+    routerTokens: number;
+    savings: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp-router/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACtC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/mcp-router/types.js

@@ -0,0 +1,6 @@
+/**
+ * MCP Router Types
+ * Lightweight hierarchical router for 98%+ token reduction
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp-router/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/memory/adaptive-context.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Hybrid Adaptive Context Selector for UAP (Option 4)
+ *
+ * VERSION: 2.0.0 - 21 Model Outcome Success Optimizations
+ *
+ * Combines task classification with time-budget awareness, runtime monitoring,
+ * and historical benefit tracking for optimal context loading decisions.
+ *
+ * OPTIMIZATIONS IMPLEMENTED:
+ * 1. Historical Data Persistence - SQLite instead of in-memory Map
+ * 2. Task-specific context sections for 5 failing tasks
+ * 3. Missing context sections (git_recovery, web_parsing, data_processing, theorem_proving)
+ * 4. Weighted keyword relevance scoring (TF-IDF-like specificity weights)
+ * 5. Token budget utilization - increase minimal sections from 1→2
+ * 6. Task-type-selective pattern injection
+ * 7. Smarter progressive context escalation with error-to-section mapping
+ * 8. Model Router fingerprint persistence integrated
+ * 9. Multi-category task classification support
+ * 10. Semantic caching foundation for task→outcome mappings
+ */
+import type { ModelId } from './model-router.js';
+export type ContextLevel = 'none' | 'minimal' | 'full';
+export type TimePressure = 'critical' | 'high' | 'medium' | 'low';
+export interface ContextDecision {
+    level: ContextLevel;
+    sections: string[];
+    reason: string;
+    estimatedOverheadMs: number;
+    taskType: string;
+    timePressure: TimePressure;
+    historicalBenefit: number;
+    secondaryCategories?: string[];
+    relevantPatterns?: string[];
+}
+export interface TaskMetadata {
+    timeout_sec?: number;
+    difficulty?: 'easy' | 'medium' | 'hard';
+    category?: string;
+    historical_uam_benefit?: number;
+    cacheKey?: string;
+}
+export interface HistoricalData {
+    taskType: string;
+    totalAttempts: number;
+    uapSuccesses: number;
+    noUamSuccesses: number;
+    avgTimeWithUam: number;
+    avgTimeWithoutUam: number;
+    lastUpdated: number;
+}
+export interface MultiCategoryClassification {
+    primary: string;
+    secondary: string[];
+    confidence: number;
+    keywords: string[];
+}
+export declare function classifyTaskMultiCategory(instruction: string): MultiCategoryClassification;
+/**
+ * Classify task type from instruction text (backward compatible)
+ */
+export declare function classifyTask(instruction: string): string;
+/**
+ * Assess time pressure based on timeout and task complexity
+ */
+export declare function assessTimePressure(timeoutSec: number, taskType: string, difficulty?: string): TimePressure;
+/**
+ * OPT 1: Get historical benefit from SQLite (persistent)
+ */
+export declare function getHistoricalBenefit(taskType: string): number;
+/**
+ * OPT 1: Record task outcome to SQLite (persistent)
+ */
+export declare function recordOutcome(taskType: string, usedUam: boolean, success: boolean, durationMs: number, modelId?: string): void;
+/**
+ * OPT 10: Cache lookup for similar tasks
+ */
+export declare function lookupSemanticCache(instructionHash: string): ContextDecision | null;
+/**
+ * OPT 10: Store decision in semantic cache
+ */
+export declare function storeSemanticCache(cacheKey: string, instructionHash: string, decision: ContextDecision, success: boolean): void;
+/**
+ * Select relevant context sections based on task type and instruction
+ * OPT 5: Returns at least 2 sections for minimal mode
+ */
+export declare function selectRelevantSections(instruction: string, taskType: string, secondaryCategories?: string[]): string[];
+/**
+ * Calculate estimated overhead for given sections in milliseconds
+ */
+export declare function calculateOverhead(sections: string[]): number;
+/**
+ * OPT 6: Get relevant patterns for task type
+ */
+export declare function getRelevantPatterns(taskType: string, sections: string[]): string[];
+/**
+ * Main decision function: determine optimal context level using hybrid approach
+ */
+export declare function decideContextLevel(instruction: string, metadata?: TaskMetadata): ContextDecision;
+/**
+ * Generate context string based on decision
+ */
+export declare function generateContext(decision: ContextDecision): string;
+/**
+ * OPT 7: Enhanced progressive context strategy with error-to-section mapping
+ */
+export declare function getProgressiveContextLevels(instruction: string, initialError: string, metadata?: TaskMetadata): ContextLevel[];
+/**
+ * OPT 7: Get additional sections to add based on error analysis
+ */
+export declare function getSectionsForError(error: string): string[];
+/**
+ * Export configuration for Python agent integration
+ */
+export declare function exportConfigForPython(instruction: string, metadata?: TaskMetadata): string;
+/**
+ * OPT 8: Get model fingerprint for routing integration
+ */
+export declare function getModelFingerprintForTask(taskType: string): {
+    recommended: ModelId;
+    reason: string;
+} | null;
+/**
+ * Close database connection (for cleanup)
+ */
+export declare function closeHistoricalDb(): void;
+export declare const HybridAdaptiveContext: {
+    classifyTask: typeof classifyTask;
+    classifyTaskMultiCategory: typeof classifyTaskMultiCategory;
+    assessTimePressure: typeof assessTimePressure;
+    getHistoricalBenefit: typeof getHistoricalBenefit;
+    recordOutcome: typeof recordOutcome;
+    decideContextLevel: typeof decideContextLevel;
+    generateContext: typeof generateContext;
+    selectRelevantSections: typeof selectRelevantSections;
+    calculateOverhead: typeof calculateOverhead;
+    getProgressiveContextLevels: typeof getProgressiveContextLevels;
+    getSectionsForError: typeof getSectionsForError;
+    getRelevantPatterns: typeof getRelevantPatterns;
+    exportConfigForPython: typeof exportConfigForPython;
+    lookupSemanticCache: typeof lookupSemanticCache;
+    storeSemanticCache: typeof storeSemanticCache;
+    getModelFingerprintForTask: typeof getModelFingerprintForTask;
+    closeHistoricalDb: typeof closeHistoricalDb;
+};
+export default HybridAdaptiveContext;
+//# sourceMappingURL=adaptive-context.d.ts.map

package/dist/memory/adaptive-context.d.ts.map

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