@kasarlabs/ask-starknet-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kasar Labs
+
+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,197 @@
+<div align="center">
+  <img src="https://github.com/KasarLabs/brand/blob/main/projects/ask-starknet/ask_full_logo_grey_alpha.png?raw=true" width="200" alt="Ask Starknet Logo">
+
+</div>
+
+# Ask Starknet MCP Server
+
+A unified Model Context Protocol (MCP) server that provides AI-powered routing to specialized Starknet MCP servers. Instead of manually selecting which MCP server to use, Ask Starknet intelligently analyzes your requests and routes them to the appropriate specialized server automatically.
+
+## Quick Start
+
+```bash
+npx -y @kasarlabs/ask-starknet-mcp
+```
+
+## Configuration
+
+### Required Environment Variables
+
+**At least one LLM API key is required:**
+
+- `ANTHROPIC_API_KEY`: Claude models (recommended)
+- `GEMINI_API_KEY`: Google Gemini models
+- `OPENAI_API_KEY`: OpenAI models
+
+**Optional:**
+
+- `MODEL_NAME`: Specify model (defaults: `claude-sonnet-4-20250514`, `gemini-2.5-flash`, or `gpt-4o-mini`)
+
+### Optional MCP-Specific Environment Variables
+
+Ask Starknet routes to specialized MCP servers based on your requests. **Only set the environment variables for the MCPs you want to use:**
+
+#### For Blockchain Operations
+
+- `STARKNET_RPC_URL`: Starknet RPC endpoint
+- `STARKNET_ACCOUNT_ADDRESS`: Your account address (for signing transactions)
+- `STARKNET_PRIVATE_KEY`: Your private key (for signing transactions)
+
+Used by: **ERC20**, **ERC721**, **AVNU**, **Contract**, **Transaction**, **Ekubo**, **Endurfi**, **Fibrous**, **Opus**, **Unruggable**, **Vesu**
+
+#### For Wallet Creation
+
+- `STARKNET_RPC_URL`: Starknet RPC endpoint
+
+Used by: **Argent**, **Braavos**, **OKX**, **OpenZeppelin**
+
+#### For Blockchain Data Queries
+
+- `STARKNET_RPC_URL`: Starknet RPC endpoint
+
+Used by: **Starknet RPC**
+
+#### For Perpetuals Trading
+
+- `EXTENDED_API_KEY`: Your Extended API key
+- `EXTENDED_API_URL`: Extended API endpoint
+- `EXTENDED_PRIVATE_KEY`: Your Stark private key for Extended
+
+Used by: **Extended**
+
+#### For AI Development Assistant
+
+- `CAIRO_CODER_API_KEY`: Your Cairo Coder API key
+
+Used by: **Cairo Coder**
+
+#### For Pixel Art
+
+- `STARKNET_RPC_URL`, `STARKNET_ACCOUNT_ADDRESS`, `STARKNET_PRIVATE_KEY`
+- `PATH_UPLOAD_DIR`: Upload directory path
+- `SECRET_PHRASE`: Secret phrase for authentication
+
+Used by: **Artpeace**
+
+#### For Cairo Development
+
+No additional environment variables needed for: **Scarb**
+
+### MCP Client Setup
+
+**Minimal setup** (LLM + read-only operations):
+
+```json
+{
+  "mcpServers": {
+    "ask-starknet": {
+      "command": "npx",
+      "args": ["-y", "@kasarlabs/ask-starknet-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-...",
+        "STARKNET_RPC_URL": "https://your-rpc-url"
+      }
+    }
+  }
+}
+```
+
+**With specialized MCPs** (e.g., you need Extended, Cairo Coder, ERC20 MCP...)
+
+```json
+{
+  "mcpServers": {
+    "ask-starknet": {
+      "command": "npx",
+      "args": ["-y", "@kasarlabs/ask-starknet-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-...",
+        "STARKNET_RPC_URL": "https://your-rpc-url",
+        "STARKNET_ACCOUNT_ADDRESS": "0x...",
+        "STARKNET_PRIVATE_KEY": "0x...",
+        "EXTENDED_API_KEY": "your-extended-key",
+        "EXTENDED_API_URL": "https://api.starknet.extended.exchange",
+        "EXTENDED_PRIVATE_KEY": "0x...",
+        "CAIRO_CODER_API_KEY": "your-cairo-coder-key"
+      }
+    }
+  }
+}
+```
+
+## Available Tool
+
+### ask_starknet
+
+Performs any Starknet-related action by intelligently routing to specialized MCP servers.
+
+**Parameters:**
+
+- `userInput` (string, required): Description of the Starknet action you want to perform
+
+**Examples:**
+
+```typescript
+{ "userInput": "Transfer 100 USDC to 0x123..." }
+{ "userInput": "Swap 1 ETH for USDC on AVNU" }
+{ "userInput": "Open a long position on ETH/USD with 5x leverage on Extended" }
+{ "userInput": "Transfer my NFT #42 from collection 0xabc... to 0xdef..." }
+{ "userInput": "How do I implement an ERC20 token in Cairo?" }
+```
+
+## What You Can Do
+
+Ask Starknet automatically routes your requests to the appropriate specialized MCP servers:
+
+### Wallets & Accounts
+
+- **Argent**, **Braavos**, **OKX**, **OpenZeppelin**: Create and deploy wallet accounts
+
+### DeFi Protocols
+
+- **AVNU**: DEX aggregator and token swaps
+- **Ekubo**: Concentrated liquidity AMM, swaps, and liquidity provision
+- **Endurfi**: Liquid staking (xSTRK, xyWBTC, xytBTC, xyLBTC)
+- **Extended**: Perpetuals trading, derivatives, position management
+- **Fibrous**: Multi-DEX swap routing for optimal prices
+- **Opus**: Collateralized debt positions (Troves) and CASH borrowing
+- **Vesu**: Lending, borrowing, and yield farming
+- **Unruggable**: Memecoin creation and liquidity locking
+
+### Blockchain Operations
+
+- **ERC20**: Token transfers, approvals, balances, deployment
+- **ERC721**: NFT transfers, approvals, metadata, deployment
+- **Transaction**: Transaction simulation and management
+- **Starknet RPC**: Blockchain data queries and on-chain information
+
+### Development Tools
+
+- **Scarb**: Cairo project initialization, compilation, execution, proving
+- **Contract**: Smart contract declaration and deployment
+- **Cairo Coder**: AI-powered Cairo development assistance and Starknet knowledge
+
+### Special
+
+- **Artpeace**: Collaborative pixel art on Starknet canvas
+
+## How It Works
+
+Ask Starknet uses an AI-powered routing system that:
+
+1. Analyzes your natural language request
+2. Determines which specialized MCP server(s) to use
+3. Routes the request with appropriate parameters
+4. Returns the result in a structured format
+
+No need to remember which MCP server handles what - just describe what you want to do!
+
+## License
+
+MIT
+
+## Support
+
+- GitHub Issues: [Create an issue](https://github.com/kasarlabs/ask-starknet/issues)
+- Documentation: [docs.kasar.io](https://docs.kasar.io)
+- MCP Documentation: [Model Context Protocol](https://modelcontextprotocol.io/)

package/build/graph/agents/prompts.d.ts

@@ -0,0 +1,9 @@
+interface SpecializedPromptInfo {
+    agentName: string;
+    expertise: string;
+    tools: string[];
+    description: string;
+}
+export declare const specializedPrompt: (info: SpecializedPromptInfo) => string;
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/build/graph/agents/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/graph/agents/prompts.ts"],"names":[],"mappings":"AAAA,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,qBAAqB,KAAG,MAwB/D,CAAC"}

package/build/graph/agents/prompts.js

@@ -0,0 +1,25 @@
+export const specializedPrompt = (info) => {
+    const toolsList = info.tools.map((tool) => `  - ${tool}`).join('\n');
+    return `You are a specialized MCP (Model Context Protocol) agent for ${info.agentName} on Starknet.
+
+## Description of ${info.agentName}
+${info.description}
+
+## Your Expertise
+${info.expertise}
+
+## Available Tools
+You have access to the following MCP tools:
+${toolsList}
+
+## Instructions
+1. **Tool Selection**: Analyze the user's request and select the most appropriate tool from your available tools
+3. **Parameters**: Ensure all required parameters are present before calling a tool
+4. **Error Handling**: If a tool call fails, explain the error clearly to the user
+5. **Scope**: Only handle requests within your domain (${info.expertise})
+6. **Response Format**: Provide clear, concise responses with relevant transaction hashes or data when applicable
+
+## Context
+This is a single-turn interaction. After you execute a tool and provide the result, the MCP client will decide if further actions are needed.`;
+};
+//# sourceMappingURL=prompts.js.map

package/build/graph/agents/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/graph/agents/prompts.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAA2B,EAAU,EAAE;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAErE,OAAO,gEAAgE,IAAI,CAAC,SAAS;;oBAEnE,IAAI,CAAC,SAAS;EAChC,IAAI,CAAC,WAAW;;;EAGhB,IAAI,CAAC,SAAS;;;;EAId,SAAS;;;;;;yDAM8C,IAAI,CAAC,SAAS;;;;8IAIuE,CAAC;AAC/I,CAAC,CAAC"}

package/build/graph/agents/selector.d.ts

@@ -0,0 +1,9 @@
+import { GraphAnnotation } from '../graph.js';
+export declare const selectorAgent: (state: typeof GraphAnnotation.State) => Promise<{
+    next: any;
+    routingInfo: {
+        reasoning: any;
+        timestamp: string;
+    };
+}>;
+//# sourceMappingURL=selector.d.ts.map

package/build/graph/agents/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/graph/agents/selector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAU9C,eAAO,MAAM,aAAa,GAAU,OAAO,OAAO,eAAe,CAAC,KAAK;;;;;;EA2DtE,CAAC"}

package/build/graph/agents/selector.js

@@ -0,0 +1,60 @@
+import { END } from '@langchain/langgraph';
+import { z } from 'zod';
+import { AvailableAgents, getMCPDescription } from '../mcps/utilities.js';
+import { logger } from '../../utils/logger.js';
+import { createLLM } from '../../utils/llm.js';
+const selectorOutputSchema = z.object({
+    selectedAgent: z.enum([END, ...AvailableAgents]),
+    reasoning: z.string().describe('Why this agent was chosen'),
+});
+export const selectorAgent = async (state) => {
+    const lastMessage = state.messages[state.messages.length - 1];
+    const userInput = lastMessage.content;
+    const agentDescriptions = AvailableAgents.map((agent) => `- ${agent}: ${getMCPDescription(agent)}`).join('\n');
+    const systemPrompt = `You are a supervisor that routes requests to specialized agents.
+
+Available agents:
+${agentDescriptions}
+
+Instructions:
+- Analyze the user's request
+- If the user's original request has been COMPLETED by a previous agent response, choose "__end__"
+- If a previous agent has already provided a complete answer or completed the requested action, choose "__end__"
+- Only choose a specialized agent if the request is NEW or INCOMPLETE
+- If no agent can handle the request, choose "__end__"
+
+
+IMPORTANT: Look at the conversation history. If an agent has already successfully completed the user's request (like creating an account, providing information, etc.), you MUST choose "__end__" to stop the conversation.
+
+Respond with the exact name of the chosen agent or "__end__".`;
+    const conversationHistory = state.messages
+        .map((msg, idx) => {
+        const role = msg.name || (idx === 0 ? 'user' : 'assistant');
+        const content = typeof msg.content === 'string'
+            ? msg.content.substring(0, 500)
+            : JSON.stringify(msg.content).substring(0, 500);
+        return `[${role}]: ${content}`;
+    })
+        .join('\n\n');
+    const model = createLLM(state.mcpEnvironment);
+    const structuredModel = model.withStructuredOutput(selectorOutputSchema);
+    const response = await structuredModel.invoke([
+        { role: 'system', content: systemPrompt },
+        {
+            role: 'user',
+            content: `Conversation history:\n${conversationHistory}\n\nOriginal user request: "${state.messages[0].content}"\n\nCurrent message: "${userInput}"\n\nHas the original request been completed? If yes, choose "__end__".`,
+        },
+    ]);
+    logger.error(`Routing decision`, {
+        selectedAgent: response.selectedAgent,
+        reasoning: response.reasoning,
+    });
+    return {
+        next: response.selectedAgent,
+        routingInfo: {
+            reasoning: response.reasoning,
+            timestamp: new Date().toISOString(),
+        },
+    };
+};
+//# sourceMappingURL=selector.js.map

package/build/graph/agents/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../../src/graph/agents/selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,eAAe,CAA0B,CAAC;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAmC,EAAE,EAAE;IACzE,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC;IAEtC,MAAM,iBAAiB,GAAG,eAAe,CAAC,GAAG,CAC3C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,iBAAiB,CAAC,KAAK,CAAC,EAAE,CACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG;;;EAGrB,iBAAiB;;;;;;;;;;;;8DAY2C,CAAC;IAG7D,MAAM,mBAAmB,GAAG,KAAK,CAAC,QAAQ;SACvC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC7B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;YAC/B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,OAAO,IAAI,IAAI,MAAM,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;QAC5C,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;QACzC;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,0BAA0B,mBAAmB,+BAA+B,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,0BAA0B,SAAS,yEAAyE;SAC3N;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;QAC/B,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,aAAa;QAC5B,WAAW,EAAE;YACX,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/build/graph/agents/specialized.d.ts

@@ -0,0 +1,6 @@
+import { HumanMessage } from '@langchain/core/messages';
+import { GraphAnnotation } from '../graph.js';
+export declare const specializedNode: (state: typeof GraphAnnotation.State) => Promise<{
+    messages: HumanMessage[];
+}>;
+//# sourceMappingURL=specialized.d.ts.map

package/build/graph/agents/specialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialized.d.ts","sourceRoot":"","sources":["../../../src/graph/agents/specialized.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AAIvE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiC9C,eAAO,MAAM,eAAe,GAAU,OAAO,OAAO,eAAe,CAAC,KAAK;;EA0DxE,CAAC"}

package/build/graph/agents/specialized.js

@@ -0,0 +1,71 @@
+import { MultiServerMCPClient } from '@langchain/mcp-adapters';
+import { HumanMessage, SystemMessage } from '@langchain/core/messages';
+import { ToolNode } from '@langchain/langgraph/prebuilt';
+import { getMCPClientConfig, getMCPPromptInfo } from '../mcps/utilities.js';
+import { logger } from '../../utils/logger.js';
+import { createLLM } from '../../utils/llm.js';
+import { specializedPrompt } from './prompts.js';
+async function specializedAgent(mcpServerName, env) {
+    const client = new MultiServerMCPClient({
+        mcpServers: {
+            [mcpServerName]: getMCPClientConfig(mcpServerName, env),
+        },
+    });
+    const tools = await client.getTools();
+    logger.error(`Loaded ${tools.length} MCP tools: ${tools
+        .map((tool) => tool.name)
+        .join(', ')}`, {});
+    const llm = createLLM(env);
+    if (!llm.bindTools) {
+        throw new Error('The selected LLM model does not support tool binding');
+    }
+    const model = llm.bindTools(tools);
+    const toolNode = new ToolNode(tools);
+    return { model, toolNode };
+}
+export const specializedNode = async (state) => {
+    logger.error(`Specialized node executing for agent: ${state.next}`, {});
+    const { model, toolNode } = await specializedAgent(state.next, state.mcpEnvironment);
+    const promptInfo = getMCPPromptInfo(state.next);
+    const systemPrompt = specializedPrompt(promptInfo);
+    const systemMessage = new SystemMessage(systemPrompt);
+    const response = await model.invoke([systemMessage, ...state.messages]);
+    if (response.tool_calls && response.tool_calls.length > 0) {
+        logger.error(`Tool calls detected: ${response.tool_calls.map((tc) => tc.name).join(', ')}`, {});
+        const toolResults = await toolNode.invoke({
+            messages: [...state.messages, response],
+        });
+        const finalResponse = await model.invoke([
+            ...state.messages,
+            response,
+            ...toolResults.messages,
+        ]);
+        logger.error('Agent response with tools completed', {
+            agent: state.next,
+            toolCalls: response.tool_calls,
+            toolResults: toolResults,
+            toolArgs: response.tool_calls[0].args,
+            toolArgsType: typeof response.tool_calls[0].args,
+        });
+        return {
+            messages: [
+                new HumanMessage({
+                    content: finalResponse.content,
+                    name: state.next,
+                }),
+            ],
+        };
+    }
+    else {
+        logger.error('Agent response without tools', {
+            agent: state.next,
+            messageLength: response.content.length,
+        });
+        return {
+            messages: [
+                new HumanMessage({ content: response.content, name: state.next }),
+            ],
+        };
+    }
+};
+//# sourceMappingURL=specialized.js.map

package/build/graph/agents/specialized.js.map

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

package/build/graph/graph.d.ts

@@ -0,0 +1,66 @@
+import type { BaseMessage } from '@langchain/core/messages';
+import { MCPEnvironment } from './mcps/interfaces.js';
+export declare const GraphAnnotation: import("@langchain/langgraph").AnnotationRoot<{
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    next: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    mcpEnvironment: import("@langchain/langgraph").BinaryOperatorAggregate<MCPEnvironment, MCPEnvironment>;
+    routingInfo: import("@langchain/langgraph").BinaryOperatorAggregate<{
+        reasoning?: string;
+        timestamp?: string;
+    }, {
+        reasoning?: string;
+        timestamp?: string;
+    }>;
+}>;
+export declare const routingFunction: (state: typeof GraphAnnotation.State) => Promise<"__end__" | "specialized">;
+export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
+    messages: BaseMessage[];
+    next: string;
+    mcpEnvironment: MCPEnvironment;
+    routingInfo: {
+        reasoning?: string;
+        timestamp?: string;
+    };
+}, {
+    messages?: BaseMessage[] | undefined;
+    next?: string | undefined;
+    mcpEnvironment?: MCPEnvironment | undefined;
+    routingInfo?: {
+        reasoning?: string;
+        timestamp?: string;
+    } | undefined;
+}, "__start__" | "selector" | "specialized", {
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    next: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    mcpEnvironment: import("@langchain/langgraph").BinaryOperatorAggregate<MCPEnvironment, MCPEnvironment>;
+    routingInfo: import("@langchain/langgraph").BinaryOperatorAggregate<{
+        reasoning?: string;
+        timestamp?: string;
+    }, {
+        reasoning?: string;
+        timestamp?: string;
+    }>;
+}, {
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    next: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    mcpEnvironment: import("@langchain/langgraph").BinaryOperatorAggregate<MCPEnvironment, MCPEnvironment>;
+    routingInfo: import("@langchain/langgraph").BinaryOperatorAggregate<{
+        reasoning?: string;
+        timestamp?: string;
+    }, {
+        reasoning?: string;
+        timestamp?: string;
+    }>;
+}, import("@langchain/langgraph").StateDefinition, {
+    selector: {
+        next: any;
+        routingInfo: {
+            reasoning: any;
+            timestamp: string;
+        };
+    };
+    specialized: {
+        messages: import("@langchain/core/messages").HumanMessage[];
+    };
+}>;
+//# sourceMappingURL=graph.d.ts.map

package/build/graph/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/graph/graph.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,eAAO,MAAM,eAAe;;;;;oBAaZ,MAAM;oBACN,MAAM;;oBADN,MAAM;oBACN,MAAM;;EAKpB,CAAC;AAEH,eAAO,MAAM,eAAe,GAAU,OAAO,OAAO,eAAe,CAAC,KAAK,uCAExE,CAAC;AAEF,eAAO,MAAM,KAAK;;;;;oBAZF,MAAM;oBACN,MAAM;;;;;;;oBADN,MAAM;oBACN,MAAM;;;;;;;oBADN,MAAM;oBACN,MAAM;;oBADN,MAAM;oBACN,MAAM;;;;;;;oBADN,MAAM;oBACN,MAAM;;oBADN,MAAM;oBACN,MAAM;;;;;;;;;;;;;EAiByB,CAAC"}

package/build/graph/graph.js

@@ -0,0 +1,31 @@
+import { StateGraph, MemorySaver, Annotation, START, END, messagesStateReducer, } from '@langchain/langgraph';
+import { selectorAgent } from './agents/selector.js';
+import { specializedNode } from './agents/specialized.js';
+export const GraphAnnotation = Annotation.Root({
+    messages: Annotation({
+        reducer: messagesStateReducer,
+        default: () => [],
+    }),
+    next: Annotation({
+        reducer: (x, y) => y ?? x,
+        default: () => END,
+    }),
+    mcpEnvironment: Annotation({
+        reducer: (x, y) => y ?? x,
+    }),
+    routingInfo: Annotation({
+        reducer: (x, y) => ({ ...x, ...y }),
+        default: () => ({}),
+    }),
+});
+export const routingFunction = async (state) => {
+    return state.next != END ? 'specialized' : END;
+};
+export const graph = new StateGraph(GraphAnnotation)
+    .addNode('selector', selectorAgent)
+    .addNode('specialized', specializedNode)
+    .addEdge(START, 'selector')
+    .addConditionalEdges('selector', routingFunction)
+    .addEdge('specialized', END)
+    .compile({ checkpointer: new MemorySaver() });
+//# sourceMappingURL=graph.js.map

package/build/graph/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/graph/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EACL,GAAG,EACH,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC;IAC7C,QAAQ,EAAE,UAAU,CAAgB;QAClC,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IACF,IAAI,EAAE,UAAU,CAAY;QAC1B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAgB;KAChC,CAAC;IACF,cAAc,EAAE,UAAU,CAAiB;QACzC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;KAC1B,CAAC;IACF,WAAW,EAAE,UAAU,CAGpB;QACD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,KAAmC,EAAE,EAAE;IAC3E,OAAO,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC;KACjD,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC;KAClC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC;KACvC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC;KAC1B,mBAAmB,CAAC,UAAU,EAAE,eAAe,CAAC;KAChD,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;KAC3B,OAAO,CAAC,EAAE,YAAY,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC,CAAC"}

package/build/graph/mcps/interfaces.d.ts

@@ -0,0 +1,27 @@
+export interface MCPEnvironment {
+    [key: string]: string | undefined;
+}
+export interface MCPClientConfig {
+    command: string;
+    args: string[];
+    transport: 'stdio';
+    env?: Record<string, string>;
+    encoding?: string;
+    stderr?: 'overlapped' | 'pipe' | 'ignore' | 'inherit';
+    cwd?: string;
+    restart?: {
+        enabled?: boolean;
+        maxAttempts?: number;
+        delayMs?: number;
+    };
+}
+export interface MCPPromptInfo {
+    expertise: string;
+    tools: string[];
+}
+export interface MCPServerInfo {
+    client: MCPClientConfig;
+    description: string;
+    promptInfo: MCPPromptInfo;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/build/graph/mcps/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/graph/mcps/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IAEnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,aAAa,CAAC;CAC3B"}

package/build/graph/mcps/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/build/graph/mcps/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/graph/mcps/interfaces.ts"],"names":[],"mappings":""}

package/build/graph/mcps/utilities.d.ts

@@ -0,0 +1,15 @@
+import { MCPServerInfo, MCPEnvironment, MCPClientConfig } from './interfaces.js';
+export declare function getMcpInfo(name: string): MCPServerInfo | undefined;
+export declare function getAllMcpInfo(): Record<string, MCPServerInfo>;
+export declare function getMcpNames(): string[];
+export declare const AvailableAgents: string[];
+export type AgentName = (typeof AvailableAgents)[number];
+export declare const getMCPClientConfig: (serverName: string, env?: MCPEnvironment) => MCPClientConfig;
+export declare const getMCPDescription: (serverName: string) => string;
+export declare const getMCPPromptInfo: (serverName: string) => {
+    agentName: string;
+    expertise: string;
+    tools: string[];
+    description: string;
+};
+//# sourceMappingURL=utilities.d.ts.map

package/build/graph/mcps/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/graph/mcps/utilities.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAqBzB,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAGlE;AAED,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAE7D;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAGtC;AAED,eAAO,MAAM,eAAe,UAAgB,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,MAAM,cAAc,KACnB,eAgCF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,MAEtD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,YAAY,MAAM,KACjB;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CAiBrB,CAAC"}