@yumdee/mcp-studio-agent-kit 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+# License
+
+MIT License
+
+Copyright (c) 2024 yumdee-Mcp-studio Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @yumdee/mcp-studio-agent-kit
+
+Compose 2+ installed MCP servers into a single agent with a unified tool list.
+
+## Features
+
+- Compose multiple MCP servers into one agent
+- Unified tool list (de-duped, namespaced)
+- Adapters for Anthropic, OpenAI, Ollama
+- Basic agentic loop (plan → call tool → observe → repeat)
+- Auto-record all steps to core's session format
+
+## Usage
+
+```typescript
+import { ComposedAgent } from "@yumdee/mcp-studio-agent-kit";
+import { createStdioClient } from "@yumdee/mcp-studio-core";
+
+const postgres = createStdioClient("npx postgres-mcp");
+const filesystem = createStdioClient("npx filesystem-mcp");
+
+const agent = new ComposedAgent([postgres, filesystem], {
+  model: "gpt-4",
+  maxSteps: 10,
+});
+
+const result = await agent.run("Query my database and save results to file");
+```
+
+## Development
+
+See [../../CONTRIBUTING.md](../../CONTRIBUTING.md)

package/dist/__tests__/agent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent.test.d.ts.map

package/dist/__tests__/agent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/agent.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/agent.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect, afterAll } from "vitest";
+import { createAgent } from "../index.js";
+import { createStdioClient } from "@yumdee/mcp-studio-core";
+import * as path from "path";
+describe("Agent-Kit Multi-Server Orchestrator", () => {
+    let client;
+    const serverPath = path.resolve(__dirname, "../../../../examples/math-server/dist/index.js");
+    afterAll(async () => {
+        if (client) {
+            await client.disconnect();
+        }
+    });
+    it("should aggregate tools across servers and run an agent loop", async () => {
+        client = createStdioClient("node", [serverPath]);
+        const agent = createAgent({
+            servers: [client],
+            model: "mock",
+        });
+        const answer = await agent.run("Please add two numbers together");
+        expect(answer).toContain("42");
+        const session = agent.getSession();
+        expect(session).toBeDefined();
+        expect(session?.metadata?.tags).toContain("agent-run");
+        expect(session?.events.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=agent.test.js.map

package/dist/__tests__/agent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test.js","sourceRoot":"","sources":["../../src/__tests__/agent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAa,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,IAAI,MAAiB,CAAC;IACtB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gDAAgD,CAAC,CAAC;IAE7F,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,OAAO,EAAE,CAAC,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=router.test.d.ts.map

package/dist/__tests__/router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/router.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/router.test.js

@@ -0,0 +1,163 @@
+import { describe, it, expect } from "vitest";
+import { SemanticToolRouter, SparseSemanticVectorizer, cosineSimilarity, createAgent, } from "../index.js";
+describe("Vector Similarity & Tokenizer", () => {
+    it("computes cosine similarity accurately", () => {
+        expect(cosineSimilarity([1, 0, 0], [0, 1, 0])).toBe(0);
+        expect(cosineSimilarity([1, 1], [1, 1])).toBeCloseTo(1, 5);
+        expect(cosineSimilarity([2, 0], [10, 0])).toBeCloseTo(1, 5);
+        expect(cosineSimilarity([], [])).toBe(0);
+    });
+    it("tokenizes camelCase, snake_case, and subword n-grams", () => {
+        const vectorizer = new SparseSemanticVectorizer();
+        const tokens = vectorizer.tokenize("calculateTax_rate in postgresDB");
+        expect(tokens).toContain("calculate");
+        expect(tokens).toContain("tax");
+        expect(tokens).toContain("rate");
+        expect(tokens).toContain("postgres");
+        expect(tokens).toContain("db");
+    });
+});
+describe("SemanticToolRouter", () => {
+    const tools = [
+        {
+            name: "calculate",
+            description: "Perform mathematical calculations like addition, multiplication, division, and subtraction.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    operation: { type: "string", description: "The arithmetic operation: add, subtract, multiply, divide" },
+                    a: { type: "number", description: "First operand" },
+                    b: { type: "number", description: "Second operand" },
+                },
+                required: ["operation", "a", "b"],
+            },
+        },
+        {
+            name: "read_file",
+            description: "Read contents of a text or markdown file from the local filesystem.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filepath: { type: "string", description: "Absolute path to the target file on disk" },
+                },
+                required: ["filepath"],
+            },
+        },
+        {
+            name: "send_slack_message",
+            description: "Post a chat notification message or alert to a team Slack channel.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    channel: { type: "string", description: "Slack channel ID or name" },
+                    message: { type: "string", description: "Text message to send" },
+                },
+                required: ["channel", "message"],
+            },
+        },
+        {
+            name: "execute_sql_query",
+            description: "Run SQL SELECT or UPDATE queries against the production PostgreSQL database.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "SQL query string to execute" },
+                    timeoutMs: { type: "number", description: "Query timeout in milliseconds" },
+                },
+                required: ["query"],
+            },
+        },
+    ];
+    it("routes math queries to calculate tool and prunes unrelated tools", async () => {
+        const router = new SemanticToolRouter({ topK: 1, minScore: 0.05 });
+        await router.indexTools(tools);
+        const result = await router.route("What is 45 multiplied by 8?");
+        expect(result.selectedTools.length).toBe(1);
+        expect(result.selectedTools[0].name).toBe("calculate");
+        expect(result.metrics.totalTools).toBe(4);
+        expect(result.metrics.selectedCount).toBe(1);
+        expect(result.metrics.prunedCount).toBe(3);
+        expect(result.metrics.reductionPercentage).toBeGreaterThanOrEqual(70);
+        expect(result.metrics.tokensSaved).toBeGreaterThan(0);
+    });
+    it("routes database queries to execute_sql_query", async () => {
+        const router = new SemanticToolRouter({ topK: 2, minScore: 0.05 });
+        await router.indexTools(tools);
+        const result = await router.route("Run a SELECT count(*) from customer orders in postgres");
+        expect(result.selectedTools.length).toBeGreaterThanOrEqual(1);
+        expect(result.selectedTools[0].name).toBe("execute_sql_query");
+    });
+    it("routes file operations to read_file", async () => {
+        const router = new SemanticToolRouter({ topK: 1, minScore: 0.05 });
+        await router.indexTools(tools);
+        const result = await router.route("Open and read the file from disk");
+        expect(result.selectedTools[0].name).toBe("read_file");
+    });
+    it("supports custom embedding providers", async () => {
+        // Mock dense embedding function
+        const mockEmbedFn = async (text) => {
+            const isMath = text.includes("math") || text.includes("calculate") || text.includes("add");
+            return isMath ? [1, 0, 0] : [0, 1, 0];
+        };
+        const router = new SemanticToolRouter({
+            topK: 1,
+            minScore: 0.5,
+            embedFn: mockEmbedFn,
+        });
+        await router.indexTools(tools);
+        const result = await router.route("calculate 20 plus 30");
+        expect(result.selectedTools[0].name).toBe("calculate");
+    });
+});
+describe("Agent with Semantic Routing", () => {
+    it("runs with semantic routing enabled and tracks token savings metrics", async () => {
+        const mockClient = {
+            connect: async () => ({ name: "math-server", version: "1.0.0", transport: "stdio" }),
+            disconnect: async () => { },
+            isConnected: () => true,
+            call: async () => ({ content: [{ type: "text", text: "42" }] }),
+            notify: async () => { },
+            onNotification: () => () => { },
+            getCapabilities: () => ({}),
+            getSession: () => ({
+                id: "mock-session",
+                serverInfo: { name: "math-server", version: "1.0.0", transport: "stdio" },
+                clientInfo: { name: "yumdee-mcp-studio", version: "0.1.0" },
+                startedAt: new Date().toISOString(),
+                events: [],
+            }),
+            clearSession: () => { },
+            getServerInfo: () => ({ name: "math-server", version: "1.0.0", transport: "stdio" }),
+            getTools: () => [
+                {
+                    name: "add",
+                    description: "Add two numbers together",
+                    inputSchema: { type: "object", properties: { a: { type: "number" }, b: { type: "number" } } },
+                },
+                {
+                    name: "delete_database",
+                    description: "Drop all tables in database",
+                    inputSchema: { type: "object", properties: {} },
+                },
+            ],
+            getResources: () => [],
+            getPrompts: () => [],
+            getEvents: () => [],
+        };
+        const agent = createAgent({
+            servers: [mockClient],
+            model: "mock",
+            useSemanticRouting: true,
+            semanticRouterConfig: { topK: 1 },
+        });
+        const result = await agent.run("Please add two numbers");
+        expect(result).toBe("The calculation was completed successfully. The answer is 42.");
+        const metrics = agent.getRoutingMetrics();
+        expect(metrics).toBeDefined();
+        expect(metrics?.totalTools).toBe(2);
+        expect(metrics?.selectedCount).toBe(1);
+        expect(metrics?.prunedCount).toBe(1);
+        expect(metrics?.reductionPercentage).toBe(50);
+    });
+});
+//# sourceMappingURL=router.test.js.map

package/dist/__tests__/router.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @yumdee/mcp-studio-agent-kit
+ *
+ * Orchestration layer for composing multiple MCP servers into a unified agent.
+ *
+ * Supports chaining multiple MCP servers with different reasoning models:
+ * - Local Ollama models (free, local, no API keys needed)
+ * - OpenAI GPT
+ * - Anthropic Claude
+ * - Deterministic/Mock agent for testing & offline workflows
+ */
+import { McpClient, McpSession, ToolDefinition } from "@yumdee/mcp-studio-core";
+import { SemanticToolRouter, type SemanticRouterConfig, type RouteResult, SparseSemanticVectorizer, cosineSimilarity } from "./router.js";
+export { SemanticToolRouter, type SemanticRouterConfig, type RouteResult, SparseSemanticVectorizer, cosineSimilarity, };
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+    servers: McpClient[];
+    model: "claude" | "gpt" | "ollama" | "mock";
+    modelName?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    maxSteps?: number;
+    systemPrompt?: string;
+    /**
+     * Enable dynamic semantic tool routing using vector embeddings
+     * Prunes unused tools from prompts, drastically reducing tokens and preventing hallucination.
+     */
+    useSemanticRouting?: boolean;
+    semanticRouterConfig?: SemanticRouterConfig;
+}
+interface DiscoveredTool {
+    client: McpClient;
+    originalName: string;
+    uniqueName: string;
+    definition: ToolDefinition;
+}
+/**
+ * Agent orchestrator
+ */
+export declare class Agent {
+    private servers;
+    private model;
+    private modelName;
+    private apiKey?;
+    private baseUrl?;
+    private maxSteps;
+    private systemPrompt?;
+    private useSemanticRouting;
+    private router?;
+    private lastRoutingMetrics?;
+    private toolsMap;
+    private session?;
+    constructor(config: AgentConfig);
+    /**
+     * Introspect and aggregate tools across all connected MCP servers
+     */
+    discoverTools(): Promise<Map<string, DiscoveredTool>>;
+    /**
+     * Run the agent to achieve a goal
+     */
+    run(goal: string): Promise<string>;
+    /**
+     * Internal model dispatch
+     */
+    private callModel;
+    /**
+     * Get the session recording for this agent run
+     */
+    getSession(): McpSession | undefined;
+    /**
+     * Get metrics from the latest semantic routing step
+     */
+    getRoutingMetrics(): RouteResult["metrics"] | undefined;
+    /**
+     * Get the underlying SemanticToolRouter instance
+     */
+    getRouter(): SemanticToolRouter | undefined;
+}
+export declare function createAgent(config: AgentConfig): Agent;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAY,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,wBAAwB,EACxB,gBAAgB,GACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,kBAAkB,CAAC,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,OAAO,CAAC,CAAa;gBAEjB,MAAM,EAAE,WAAW;IAc/B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAgC3D;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsHxC;;OAEG;YACW,SAAS;IA8IvB;;OAEG;IACH,UAAU,IAAI,UAAU,GAAG,SAAS;IAIpC;;OAEG;IACH,iBAAiB,IAAI,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS;IAIvD;;OAEG;IACH,SAAS,IAAI,kBAAkB,GAAG,SAAS;CAG5C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAEtD"}

package/dist/index.js

@@ -0,0 +1,319 @@
+/**
+ * @yumdee/mcp-studio-agent-kit
+ *
+ * Orchestration layer for composing multiple MCP servers into a unified agent.
+ *
+ * Supports chaining multiple MCP servers with different reasoning models:
+ * - Local Ollama models (free, local, no API keys needed)
+ * - OpenAI GPT
+ * - Anthropic Claude
+ * - Deterministic/Mock agent for testing & offline workflows
+ */
+import { randomUUID } from "crypto";
+import { SemanticToolRouter, SparseSemanticVectorizer, cosineSimilarity, } from "./router.js";
+export { SemanticToolRouter, SparseSemanticVectorizer, cosineSimilarity, };
+/**
+ * Agent orchestrator
+ */
+export class Agent {
+    constructor(config) {
+        this.toolsMap = new Map();
+        this.servers = config.servers;
+        this.model = config.model;
+        this.modelName = config.modelName || (config.model === "ollama" ? "llama3" : config.model === "claude" ? "claude-3-5-sonnet-20241022" : "gpt-4o");
+        this.apiKey = config.apiKey || (config.model === "claude" ? process.env.ANTHROPIC_API_KEY : process.env.OPENAI_API_KEY);
+        this.baseUrl = config.baseUrl;
+        this.maxSteps = config.maxSteps || 10;
+        this.systemPrompt = config.systemPrompt;
+        this.useSemanticRouting = config.useSemanticRouting ?? false;
+        if (this.useSemanticRouting) {
+            this.router = new SemanticToolRouter(config.semanticRouterConfig);
+        }
+    }
+    /**
+     * Introspect and aggregate tools across all connected MCP servers
+     */
+    async discoverTools() {
+        this.toolsMap.clear();
+        for (const client of this.servers) {
+            if (!client.isConnected()) {
+                await client.connect();
+            }
+            const sInfo = client.getServerInfo();
+            const clientTools = client.getTools();
+            for (const tool of clientTools) {
+                let uniqueName = tool.name;
+                if (this.toolsMap.has(uniqueName)) {
+                    uniqueName = `${sInfo.name}__${tool.name}`;
+                }
+                this.toolsMap.set(uniqueName, {
+                    client,
+                    originalName: tool.name,
+                    uniqueName,
+                    definition: {
+                        ...tool,
+                        name: uniqueName,
+                    },
+                });
+            }
+        }
+        return this.toolsMap;
+    }
+    /**
+     * Run the agent to achieve a goal
+     */
+    async run(goal) {
+        await this.discoverTools();
+        if (this.useSemanticRouting && this.router) {
+            const toolDefs = Array.from(this.toolsMap.values()).map((t) => t.definition);
+            await this.router.indexTools(toolDefs);
+        }
+        const sessionId = randomUUID();
+        const startedAt = new Date().toISOString();
+        const messages = [
+            {
+                role: "system",
+                content: this.systemPrompt ||
+                    `You are an autonomous AI agent equipped with tools from multiple Model Context Protocol (MCP) servers. Your objective is to achieve the user's goal by selecting the right tools, analyzing results, and providing a final answer. Available tools: ${Array.from(this.toolsMap.keys()).join(", ")}.`,
+            },
+            {
+                role: "user",
+                content: goal,
+            },
+        ];
+        let currentStep = 0;
+        let finalAnswer = "";
+        while (currentStep < this.maxSteps) {
+            currentStep++;
+            // Dynamically select tools using semantic routing if enabled
+            let activeTools = Array.from(this.toolsMap.values());
+            if (this.useSemanticRouting && this.router) {
+                const lastMsg = messages[messages.length - 1]?.content;
+                const query = typeof lastMsg === "string" ? `${goal} ${lastMsg}` : goal;
+                const routeResult = await this.router.route(query);
+                this.lastRoutingMetrics = routeResult.metrics;
+                const selectedNames = new Set(routeResult.selectedTools.map((t) => t.name));
+                activeTools = activeTools.filter((t) => selectedNames.has(t.uniqueName) || selectedNames.has(t.originalName));
+            }
+            // Dispatch to model adapter with dynamically routed tools
+            const stepResponse = await this.callModel(messages, activeTools);
+            if (stepResponse.toolCalls && stepResponse.toolCalls.length > 0) {
+                messages.push({
+                    role: "assistant",
+                    content: stepResponse.content || null,
+                });
+                for (const tc of stepResponse.toolCalls) {
+                    const toolHandler = this.toolsMap.get(tc.name);
+                    if (!toolHandler) {
+                        messages.push({
+                            role: "user",
+                            content: `Error: Tool "${tc.name}" is not registered. Available tools: ${Array.from(this.toolsMap.keys()).join(", ")}`,
+                        });
+                        continue;
+                    }
+                    try {
+                        const toolResult = await toolHandler.client.call("tools/call", {
+                            name: toolHandler.originalName,
+                            arguments: tc.args || {},
+                        });
+                        messages.push({
+                            role: "user",
+                            content: `Tool Result for ${tc.name}:\n${JSON.stringify(toolResult, null, 2)}`,
+                        });
+                    }
+                    catch (err) {
+                        messages.push({
+                            role: "user",
+                            content: `Tool Execution Error for ${tc.name}: ${err.message}`,
+                        });
+                    }
+                }
+            }
+            else {
+                finalAnswer = stepResponse.content || "Goal completed.";
+                break;
+            }
+        }
+        if (!finalAnswer && currentStep >= this.maxSteps) {
+            finalAnswer = `Max execution steps (${this.maxSteps}) reached. Last state: ${JSON.stringify(messages[messages.length - 1].content)}`;
+        }
+        // Collate all events into a unified McpSession
+        const allEvents = [];
+        for (const client of this.servers) {
+            allEvents.push(...client.getEvents());
+        }
+        allEvents.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        this.session = {
+            id: sessionId,
+            serverInfo: {
+                name: `orchestrated-agent [${this.servers.map((s) => s.getServerInfo().name).join(", ")}]`,
+                version: "0.1.0",
+                transport: "stdio",
+            },
+            clientInfo: {
+                name: "yumdee-mcp-studio",
+                version: "0.1.0",
+            },
+            startedAt,
+            endedAt: new Date().toISOString(),
+            events: allEvents,
+            metadata: {
+                tags: ["agent-run", this.model, ...(this.useSemanticRouting ? ["semantic-routing"] : [])],
+                notes: `Goal: ${goal} | Steps: ${currentStep}`,
+                routingMetrics: this.lastRoutingMetrics,
+            },
+        };
+        return finalAnswer;
+    }
+    /**
+     * Internal model dispatch
+     */
+    async callModel(messages, activeTools) {
+        const toolsPool = activeTools && activeTools.length > 0 ? activeTools : Array.from(this.toolsMap.values());
+        if (this.model === "mock") {
+            // Deterministic mock agent for tests and headless verification
+            const lastMsg = messages[messages.length - 1].content;
+            if (typeof lastMsg === "string" && lastMsg.toLowerCase().includes("add")) {
+                const hasExecuted = messages.some((m) => typeof m.content === "string" && m.content.includes("Tool Result"));
+                if (!hasExecuted) {
+                    return {
+                        toolCalls: [{ name: "add", args: { a: 20, b: 22 } }],
+                    };
+                }
+                else {
+                    return {
+                        content: "The calculation was completed successfully. The answer is 42.",
+                    };
+                }
+            }
+            return { content: "Mock goal processed." };
+        }
+        if (this.model === "ollama") {
+            const host = this.baseUrl || process.env.OLLAMA_HOST || "http://localhost:11434";
+            const tools = toolsPool.map((t) => ({
+                type: "function",
+                function: {
+                    name: t.uniqueName,
+                    description: t.definition.description || "",
+                    parameters: t.definition.inputSchema || { type: "object", properties: {} },
+                },
+            }));
+            const res = await fetch(`${host}/api/chat`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    model: this.modelName,
+                    messages,
+                    tools,
+                    stream: false,
+                }),
+            });
+            if (!res.ok)
+                throw new Error(`Ollama request failed: ${res.statusText}`);
+            const data = await res.json();
+            const msg = data.message || {};
+            const toolCalls = msg.tool_calls?.map((tc) => ({
+                name: tc.function?.name,
+                args: tc.function?.arguments,
+            }));
+            return { content: msg.content, toolCalls };
+        }
+        if (this.model === "gpt") {
+            if (!this.apiKey) {
+                throw new Error("OPENAI_API_KEY is required for GPT model adapter");
+            }
+            const tools = toolsPool.map((t) => ({
+                type: "function",
+                function: {
+                    name: t.uniqueName,
+                    description: t.definition.description || "",
+                    parameters: t.definition.inputSchema || { type: "object", properties: {} },
+                },
+            }));
+            const res = await fetch("https://api.openai.com/v1/chat/completions", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.modelName,
+                    messages,
+                    tools: tools.length > 0 ? tools : undefined,
+                }),
+            });
+            if (!res.ok)
+                throw new Error(`OpenAI API error: ${res.statusText}`);
+            const data = await res.json();
+            const choice = data.choices?.[0]?.message;
+            const toolCalls = choice?.tool_calls?.map((tc) => ({
+                name: tc.function?.name,
+                args: JSON.parse(tc.function?.arguments || "{}"),
+            }));
+            return { content: choice?.content, toolCalls };
+        }
+        if (this.model === "claude") {
+            if (!this.apiKey) {
+                throw new Error("ANTHROPIC_API_KEY is required for Claude model adapter");
+            }
+            const tools = toolsPool.map((t) => ({
+                name: t.uniqueName,
+                description: t.definition.description || "",
+                input_schema: t.definition.inputSchema || { type: "object", properties: {} },
+            }));
+            // Extract system message for Anthropic format
+            const system = messages.find((m) => m.role === "system")?.content;
+            const conversation = messages
+                .filter((m) => m.role !== "system")
+                .map((m) => ({ role: m.role === "assistant" ? "assistant" : "user", content: m.content }));
+            const res = await fetch("https://api.anthropic.com/v1/messages", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": this.apiKey,
+                    "anthropic-version": "2023-06-01",
+                },
+                body: JSON.stringify({
+                    model: this.modelName,
+                    max_tokens: 1024,
+                    system,
+                    messages: conversation,
+                    tools: tools.length > 0 ? tools : undefined,
+                }),
+            });
+            if (!res.ok)
+                throw new Error(`Anthropic API error: ${res.statusText}`);
+            const data = await res.json();
+            const toolUseBlocks = data.content?.filter((c) => c.type === "tool_use");
+            const textBlocks = data.content?.filter((c) => c.type === "text").map((c) => c.text).join("\n");
+            const toolCalls = toolUseBlocks?.map((tb) => ({
+                name: tb.name,
+                args: tb.input,
+            }));
+            return { content: textBlocks, toolCalls };
+        }
+        return { content: "Unsupported model" };
+    }
+    /**
+     * Get the session recording for this agent run
+     */
+    getSession() {
+        return this.session;
+    }
+    /**
+     * Get metrics from the latest semantic routing step
+     */
+    getRoutingMetrics() {
+        return this.lastRoutingMetrics;
+    }
+    /**
+     * Get the underlying SemanticToolRouter instance
+     */
+    getRouter() {
+        return this.router;
+    }
+}
+export function createAgent(config) {
+    return new Agent(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @yumdee/mcp-studio-agent-kit - Semantic Tool Router
+ *
+ * Dynamic tool retrieval & context pruning using vector embeddings and cosine similarity.
+ * Drastically reduces context window bloat and eliminates tool hallucination
+ * in multi-server MCP environments with 50+ tools.
+ */
+import { ToolDefinition } from "@yumdee/mcp-studio-core";
+export interface SemanticRouterConfig {
+    /** Maximum number of tools to select for any given turn (default: 3) */
+    topK?: number;
+    /** Minimum similarity score threshold between 0 and 1 (default: 0.1) */
+    minScore?: number;
+    /** Optional custom embedding function (e.g. OpenAI text-embedding-3-small, Ollama nomic-embed-text) */
+    embedFn?: (text: string) => Promise<number[]>;
+}
+export interface RouteResult<T = ToolDefinition> {
+    selectedTools: T[];
+    scores: Array<{
+        toolName: string;
+        score: number;
+    }>;
+    metrics: {
+        totalTools: number;
+        selectedCount: number;
+        prunedCount: number;
+        estimatedTokensBefore: number;
+        estimatedTokensAfter: number;
+        tokensSaved: number;
+        reductionPercentage: number;
+    };
+}
+/**
+ * Fast cosine similarity between two dense vectors
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Built-in Sub-word & N-Gram Sparse Vectorizer
+ * High-speed, zero-dependency semantic vectorizer robust to typos,
+ * snake_case/camelCase function identifiers, and terminology variations.
+ */
+export declare class SparseSemanticVectorizer {
+    private vocabulary;
+    private docFrequencies;
+    private docCount;
+    /**
+     * Tokenize and normalize text into word stems and character 3-grams
+     */
+    tokenize(text: string): string[];
+    /**
+     * Build TF-IDF vocabulary across all documents
+     */
+    fit(documents: string[]): void;
+    /**
+     * Transform text into a normalized TF-IDF vector
+     */
+    transform(text: string): number[];
+}
+/**
+ * Semantic Tool Router
+ */
+export declare class SemanticToolRouter<T extends {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+} = ToolDefinition> {
+    private config;
+    private vectorizer;
+    private indexedTools;
+    constructor(config?: SemanticRouterConfig);
+    /**
+     * Convert a tool definition into rich textual signature for vectorization
+     */
+    static extractToolSignature(tool: {
+        name: string;
+        description?: string;
+        inputSchema?: any;
+    }): string;
+    /**
+     * Index all tools and build vector space representations
+     */
+    indexTools(tools: T[]): Promise<void>;
+    /**
+     * Semantically route a user query to the top-K relevant tools
+     */
+    route(query: string, options?: {
+        topK?: number;
+        minScore?: number;
+    }): Promise<RouteResult<T>>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,cAAc;IAC7C,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAa;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAsBhC;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAiB9B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;CAiClC;AAED;;GAEG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,cAAc;IAClH,OAAO,CAAC,MAAM,CAEZ;IACF,OAAO,CAAC,UAAU,CAA4D;IAC9E,OAAO,CAAC,YAAY,CAIZ;gBAEI,MAAM,GAAE,oBAAyB;IAQ7C;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,MAAM;IAkBpG;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB3C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuEpG"}

package/dist/router.js

@@ -0,0 +1,234 @@
+/**
+ * @yumdee/mcp-studio-agent-kit - Semantic Tool Router
+ *
+ * Dynamic tool retrieval & context pruning using vector embeddings and cosine similarity.
+ * Drastically reduces context window bloat and eliminates tool hallucination
+ * in multi-server MCP environments with 50+ tools.
+ */
+/**
+ * Fast cosine similarity between two dense vectors
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dotProduct / denom;
+}
+/**
+ * Built-in Sub-word & N-Gram Sparse Vectorizer
+ * High-speed, zero-dependency semantic vectorizer robust to typos,
+ * snake_case/camelCase function identifiers, and terminology variations.
+ */
+export class SparseSemanticVectorizer {
+    constructor() {
+        this.vocabulary = new Map();
+        this.docFrequencies = new Map();
+        this.docCount = 0;
+    }
+    /**
+     * Tokenize and normalize text into word stems and character 3-grams
+     */
+    tokenize(text) {
+        const tokens = [];
+        // Split camelCase, snake_case, kebab-case, punctuation
+        const words = text
+            .replace(/([a-z])([A-Z])/g, "$1 $2")
+            .toLowerCase()
+            .replace(/[^a-z0-9]/g, " ")
+            .split(/\s+/)
+            .filter((w) => w.length >= 2);
+        for (const word of words) {
+            tokens.push(word);
+            // Generate character 3-grams for subword matching
+            if (word.length >= 3) {
+                for (let i = 0; i <= word.length - 3; i++) {
+                    tokens.push(`__ng_${word.slice(i, i + 3)}`);
+                }
+            }
+        }
+        return tokens;
+    }
+    /**
+     * Build TF-IDF vocabulary across all documents
+     */
+    fit(documents) {
+        this.vocabulary.clear();
+        this.docFrequencies.clear();
+        this.docCount = documents.length;
+        let nextIndex = 0;
+        for (const doc of documents) {
+            const tokens = new Set(this.tokenize(doc));
+            for (const token of tokens) {
+                if (!this.vocabulary.has(token)) {
+                    this.vocabulary.set(token, nextIndex++);
+                }
+                this.docFrequencies.set(token, (this.docFrequencies.get(token) || 0) + 1);
+            }
+        }
+    }
+    /**
+     * Transform text into a normalized TF-IDF vector
+     */
+    transform(text) {
+        const vector = new Array(this.vocabulary.size).fill(0);
+        const tokens = this.tokenize(text);
+        if (tokens.length === 0 || this.vocabulary.size === 0)
+            return vector;
+        const termCounts = new Map();
+        for (const token of tokens) {
+            termCounts.set(token, (termCounts.get(token) || 0) + 1);
+        }
+        let normSq = 0;
+        for (const [token, count] of termCounts) {
+            const idx = this.vocabulary.get(token);
+            if (idx !== undefined) {
+                const tf = count / tokens.length;
+                const df = this.docFrequencies.get(token) || 1;
+                const idf = Math.log((this.docCount + 1) / df) + 1;
+                const tfidf = tf * idf;
+                vector[idx] = tfidf;
+                normSq += tfidf * tfidf;
+            }
+        }
+        // L2 Normalize
+        const norm = Math.sqrt(normSq);
+        if (norm > 0) {
+            for (let i = 0; i < vector.length; i++) {
+                vector[i] /= norm;
+            }
+        }
+        return vector;
+    }
+}
+/**
+ * Semantic Tool Router
+ */
+export class SemanticToolRouter {
+    constructor(config = {}) {
+        this.vectorizer = new SparseSemanticVectorizer();
+        this.indexedTools = [];
+        this.config = {
+            topK: config.topK ?? 3,
+            minScore: config.minScore ?? 0.08,
+            embedFn: config.embedFn,
+        };
+    }
+    /**
+     * Convert a tool definition into rich textual signature for vectorization
+     */
+    static extractToolSignature(tool) {
+        const parts = [tool.name, tool.description || ""];
+        const schema = tool.inputSchema;
+        if (schema && typeof schema === "object") {
+            if (schema.properties && typeof schema.properties === "object") {
+                for (const [key, prop] of Object.entries(schema.properties)) {
+                    parts.push(key);
+                    if (prop?.description)
+                        parts.push(prop.description);
+                    if (prop?.type)
+                        parts.push(prop.type);
+                }
+            }
+            if (Array.isArray(schema.required)) {
+                parts.push(schema.required.join(" "));
+            }
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Index all tools and build vector space representations
+     */
+    async indexTools(tools) {
+        this.indexedTools = [];
+        const documents = [];
+        for (const tool of tools) {
+            const signature = SemanticToolRouter.extractToolSignature(tool);
+            this.indexedTools.push({ tool, text: signature });
+            documents.push(signature);
+        }
+        if (this.config.embedFn) {
+            for (const item of this.indexedTools) {
+                item.vector = await this.config.embedFn(item.text);
+            }
+        }
+        else {
+            this.vectorizer.fit(documents);
+            for (const item of this.indexedTools) {
+                item.vector = this.vectorizer.transform(item.text);
+            }
+        }
+    }
+    /**
+     * Semantically route a user query to the top-K relevant tools
+     */
+    async route(query, options) {
+        const topK = options?.topK ?? this.config.topK;
+        const minScore = options?.minScore ?? this.config.minScore;
+        if (this.indexedTools.length === 0) {
+            return {
+                selectedTools: [],
+                scores: [],
+                metrics: {
+                    totalTools: 0,
+                    selectedCount: 0,
+                    prunedCount: 0,
+                    estimatedTokensBefore: 0,
+                    estimatedTokensAfter: 0,
+                    tokensSaved: 0,
+                    reductionPercentage: 0,
+                },
+            };
+        }
+        // Compute query vector
+        const queryVector = this.config.embedFn
+            ? await this.config.embedFn(query)
+            : this.vectorizer.transform(query);
+        // Score all tools
+        const scored = this.indexedTools.map((item) => {
+            const score = item.vector ? cosineSimilarity(queryVector, item.vector) : 0;
+            return { tool: item.tool, toolName: item.tool.name, score };
+        });
+        // Sort descending by score
+        scored.sort((a, b) => b.score - a.score);
+        // Filter by threshold and take top-K
+        let selected = scored.filter((item) => item.score >= minScore).slice(0, topK);
+        // Fallback: If no tools pass the threshold, return the single highest scoring tool if score > 0
+        if (selected.length === 0 && scored.length > 0 && scored[0].score > 0) {
+            selected = [scored[0]];
+        }
+        // If still empty (e.g. zero similarity everywhere), keep top-1 as safety fallback
+        if (selected.length === 0 && scored.length > 0) {
+            selected = [scored[0]];
+        }
+        // Estimate token metrics (approx 150 tokens per tool schema definition in JSON)
+        const tokensPerTool = 180;
+        const estimatedTokensBefore = this.indexedTools.length * tokensPerTool;
+        const estimatedTokensAfter = selected.length * tokensPerTool;
+        const tokensSaved = Math.max(0, estimatedTokensBefore - estimatedTokensAfter);
+        const reductionPercentage = estimatedTokensBefore > 0
+            ? Math.round((tokensSaved / estimatedTokensBefore) * 100)
+            : 0;
+        return {
+            selectedTools: selected.map((s) => s.tool),
+            scores: scored.map((s) => ({ toolName: s.toolName, score: Math.round(s.score * 1000) / 1000 })),
+            metrics: {
+                totalTools: this.indexedTools.length,
+                selectedCount: selected.length,
+                prunedCount: this.indexedTools.length - selected.length,
+                estimatedTokensBefore,
+                estimatedTokensAfter,
+                tokensSaved,
+                reductionPercentage,
+            },
+        };
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@yumdee/mcp-studio-agent-kit",
+  "version": "0.1.0",
+  "description": "Orchestration layer for chaining multiple MCP servers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/maheshsingh20/YumDee-MCP-Studio.git",
+    "directory": "packages/agent-kit"
+  },
+  "author": "Mahesh Singh <maheshsingh20>",
+  "license": "MIT",
+  "dependencies": {
+    "@yumdee/mcp-studio-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "dev": "tsc --watch --incremental",
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run"
+  }
+}