@identikey/coding-mcp 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kleneway
+
+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,134 @@
+# 🤖 Cursor Tools MCP Server
+
+An MCP (Model Context Protocol) server providing powerful tools with expert personas for intelligent assistance:
+
+## Core Tools
+- **Ask**: Natural language queries automatically routed to the best expert
+- **Discover**: Explore available expert personas and their specialties
+- **Persona**: Direct access to specific expert personas
+- **Screenshot**: Capture screenshots from URLs
+- **Architect**: Comprehensive architectural code reviews
+- **Code Review**: Git diff analysis and improvement suggestions
+
+## ✨ Features
+
+### 🎨 Code Architect
+
+Call advanced reasoning LLMs to generate plans and instructions for coding agents.
+
+### 📸 Screenshot Buddy
+
+Take UI design screenshots and use them with the composer agent.
+
+### 🔍 Code Review
+
+Use git diffs to trigger code reviews.
+
+### 🎭 Persona System
+
+Transform AI responses with distinct personalities:
+- **Charles**: Distinguished British architect with dry wit
+- **Ada**: Pragmatic performance engineer, metrics-focused
+
+### 📊 Code Advice
+
+Get focused guidance on specific coding problems.
+
+### 🔬 Researcher
+
+Deep-dive analysis for complex technical questions.
+
+## 🚀 Getting Started
+
+### 1. Environment Setup
+
+First, you'll need to set up your environment variables. Create a file at `src/env/keys.ts`:
+
+```typescript
+export const OPENAI_API_KEY = "your_key_here";
+// Add any other keys you need
+```
+
+> ⚠️ **Security Note**: Storing API keys directly in source code is not recommended for production environments. This is only for local development and learning purposes. You can set the env var inline in the Cursor MCP interface as well.
+
+### 2. Installation
+
+```bash
+npm install
+# or
+yarn install
+```
+
+### 3. Build the Server
+
+```bash
+npm run build
+```
+
+### 4. Adding to Cursor
+
+This project is designed to be used as an MCP server in Cursor. Here's how to set it up:
+
+1. Open Cursor
+2. Go to `Cursor Settings > Features > MCP`
+3. Click `+ Add New MCP Server`
+4. Fill out the form:
+   - **Name**: AI Development Assistant
+   - **Type**: stdio
+   - **Command**: `node /path/to/your/project/dist/index.js`
+
+> 📘 **Pro Tip**: You might need to use the full path to your project's built index.js file.
+
+After adding the server, you should see your tools listed under "Available Tools". If not, try clicking the refresh button in the top right corner of the MCP server section.
+
+For more details about MCP setup, check out the [Cursor MCP Documentation](https://docs.cursor.com/advanced/model-context-protocol).
+
+## 🛠️ Using the Tools
+
+Once configured, you can use these tools directly in Cursor's Composer. The AI will automatically suggest using relevant tools, or you can explicitly request them by name or description.
+
+For example, try typing in Composer:
+
+- "Review this code for best practices"
+- "Help me architect a new feature"
+- "Analyze this UI screenshot"
+
+The agent will ask for your approval before making any tool calls.
+
+> 📘 **Pro Tip**: You can update your .cursorrules file with instructions on how to use the tools for certain scenarios, and the agent will use the tools automatically.
+
+## 📁 Project Structure
+
+```
+src/
+├── tools/
+│   ├── architect.ts    # Code structure generator
+│   ├── screenshot.ts   # Screenshot analysis tool
+│   └── codeReview.ts   # Code review tool
+├── env/
+│   └── keys.ts         # Environment configuration (add your API keys here!)
+└── index.ts           # Main entry point
+```
+
+## 🤝 Contributing
+
+Contributions welcome! Please feel free to submit a Pull Request.
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🐛 Issues & Support
+
+Found a bug or need help? Open an issue with:
+
+1. What you were trying to do
+2. What happened instead
+3. Steps to reproduce
+4. Your environment details
+
+---
+
+I'll be honest though, this is a tutorial demo, and not a production-ready tool so I likely won't be fixing issues. But feel free to fork it and make it your own!
+
+Made with ❤️ by developers, for developers

package/build/common/apiClient.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generic AI provider API client utilities
+ */
+import { type AIProvider, type ReasoningEffort } from "./providerConfig.js";
+export interface AICallConfig {
+    systemPrompt: string;
+    task: string;
+    code: string;
+    analysisType: "comprehensive" | "advice" | "research" | "review";
+    reasoningEffort: ReasoningEffort;
+    provider: AIProvider;
+}
+export declare function callAIProvider(config: AICallConfig): Promise<string>;
+//# sourceMappingURL=apiClient.d.ts.map

package/build/common/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/common/apiClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAoDD,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1E"}

package/build/common/apiClient.js

@@ -0,0 +1,68 @@
+/**
+ * Generic AI provider API client utilities
+ */
+import OpenAI from "openai";
+import { xai } from "@ai-sdk/xai";
+import { generateText } from "ai";
+import { OPENAI_API_KEY, validateProvider } from "./providerConfig.js";
+import { formatTokenInfo } from "./tokenFormatter.js";
+import { buildUserPrompt } from "./promptBuilder.js";
+async function callXaiProvider(config) {
+    const userPrompt = buildUserPrompt({
+        task: config.task,
+        code: config.code,
+        analysisType: config.analysisType,
+    });
+    const result = await generateText({
+        model: xai("grok-4"),
+        messages: [
+            { role: "system", content: config.systemPrompt },
+            { role: "user", content: userPrompt },
+        ],
+        // Note: xAI doesn't support reasoningEffort parameter
+    });
+    const tokenInfo = formatTokenInfo("xai", result.usage, config.reasoningEffort);
+    return result.text + tokenInfo;
+}
+async function callOpenAIProvider(config) {
+    const openai = new OpenAI({
+        apiKey: OPENAI_API_KEY,
+    });
+    const userPrompt = buildUserPrompt({
+        task: config.task,
+        code: config.code,
+        analysisType: config.analysisType,
+    });
+    const response = await openai.chat.completions.create({
+        model: "gpt-5",
+        messages: [
+            { role: "system", content: config.systemPrompt },
+            { role: "user", content: userPrompt },
+        ],
+        reasoning_effort: config.reasoningEffort, // GPT-5 supports this
+    });
+    const assistantMessage = response.choices?.[0]?.message?.content ?? "No response from model.";
+    const usage = {
+        totalTokens: response.usage?.total_tokens,
+        reasoning_tokens: response.usage?.reasoning_tokens,
+    };
+    const tokenInfo = formatTokenInfo("openai", usage, config.reasoningEffort);
+    return assistantMessage + tokenInfo;
+}
+export async function callAIProvider(config) {
+    validateProvider(config.provider);
+    if (config.provider === "xai") {
+        // xAI doesn't support reasoning_effort, so create config without it
+        const xaiConfig = {
+            ...config,
+            reasoningEffort: undefined // Remove for xAI
+        };
+        return callXaiProvider(xaiConfig);
+    }
+    else if (config.provider === "openai") {
+        return callOpenAIProvider(config);
+    }
+    else {
+        throw new Error(`Unsupported provider: ${config.provider}`);
+    }
+}

package/build/common/personaClient.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Persona-aware AI client that enhances API calls with personality layers
+ */
+import { type AIProvider, type ReasoningEffort } from "./providerConfig.js";
+export interface PersonaCallConfig {
+    /** System prompt to use as base */
+    systemPrompt: string;
+    /** User's task or question */
+    task: string;
+    /** Code or context to analyze */
+    code: string;
+    /** Type of analysis being performed */
+    analysisType: "comprehensive" | "advice" | "research" | "review";
+    /** Reasoning effort level */
+    reasoningEffort: ReasoningEffort;
+    /**
+     * AI provider override (generally avoid passing; provider is auto-selected
+     * based on persona traits, analysis type, and reasoning effort)
+     */
+    providerOverride?: AIProvider;
+    /** Persona ID to use */
+    personaId: string;
+    /** Conversation context if available */
+    conversationContext?: string[];
+    /** Response tone control */
+    toneStyle?: "concise" | "detailed" | "humorous" | "straight";
+    /** Output format preference */
+    outputFormat?: "tldr" | "detailed" | "dual";
+    /** Target audience level */
+    audienceLevel?: "beginner" | "intermediate" | "expert" | "auto";
+    /** Include visual diagrams */
+    includeDiagrams?: boolean;
+    /** User constraints for empathy */
+    userConstraints?: string;
+}
+/**
+ * Call AI provider with optional persona enhancement
+ */
+export declare function callAIWithPersona(config: PersonaCallConfig): Promise<string>;
+/**
+ * Helper to list available personas
+ */
+export declare function getAvailablePersonas(): Array<{
+    id: string;
+    name: string;
+    description: string;
+}>;
+//# sourceMappingURL=personaClient.d.ts.map

package/build/common/personaClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaClient.d.ts","sourceRoot":"","sources":["../../src/common/personaClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAEjE,6BAA6B;IAC7B,eAAe,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAE9B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IAE7D,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAE5C,4BAA4B;IAC5B,aAAa,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEhE,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,CAsGjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD"}

package/build/common/personaClient.js

@@ -0,0 +1,101 @@
+/**
+ * Persona-aware AI client that enhances API calls with personality layers
+ */
+import { callAIProvider } from "./apiClient.js";
+import { chooseProvider, getDefaultProvider, } from "./providerConfig.js";
+import { PersonaRegistry } from "../personas/types.js";
+/**
+ * Call AI provider with optional persona enhancement
+ */
+export async function callAIWithPersona(config) {
+    const { systemPrompt, task, code, analysisType, reasoningEffort, personaId, conversationContext, } = config;
+    let enhancedSystemPrompt = systemPrompt;
+    let enhancedTask = task;
+    let response;
+    let selectedProvider = getDefaultProvider();
+    let effectiveReasoningEffort = reasoningEffort;
+    // If persona is specified, apply persona enhancements
+    if (personaId) {
+        const persona = PersonaRegistry.get(personaId);
+        if (!persona) {
+            throw new Error(`Persona '${personaId}' not found in registry`);
+        }
+        // Auto-select provider with persona preference and optional override
+        selectedProvider = chooseProvider({
+            analysisType,
+            reasoningEffort: effectiveReasoningEffort,
+            personaPreferredProvider: config.providerOverride
+                ? undefined
+                : persona.traits.preferredProvider,
+            textHint: task,
+        });
+        if (config.providerOverride) {
+            selectedProvider = config.providerOverride;
+        }
+        // Use persona's preferred reasoning effort if available
+        if (persona.traits.providerPreferences?.reasoning &&
+            selectedProvider === "openai") {
+            effectiveReasoningEffort = persona.traits.providerPreferences.reasoning;
+        }
+        // Build persona context
+        const context = {
+            task,
+            analysisType,
+            reasoningEffort: effectiveReasoningEffort,
+            conversationContext,
+            toneStyle: config.toneStyle,
+            outputFormat: config.outputFormat,
+            audienceLevel: config.audienceLevel,
+            includeDiagrams: config.includeDiagrams,
+            userConstraints: config.userConstraints,
+            providerOverride: config.providerOverride,
+        };
+        // Enhance prompts with persona
+        enhancedSystemPrompt = persona.enhanceSystemPrompt(systemPrompt, context);
+        enhancedTask = persona.enhanceUserPrompt(task, context);
+        // Call AI provider with enhanced prompts
+        response = await callAIProvider({
+            systemPrompt: enhancedSystemPrompt,
+            task: enhancedTask,
+            code,
+            analysisType,
+            reasoningEffort: effectiveReasoningEffort,
+            provider: selectedProvider,
+        });
+        // Post-process response if persona has custom processing
+        if (persona.processResponse) {
+            response = persona.processResponse(response, context);
+        }
+        // Format output according to persona preferences
+        if (persona.formatOutput) {
+            response = persona.formatOutput(response, context);
+        }
+    }
+    else {
+        // No persona specified, auto-select provider
+        selectedProvider = chooseProvider({
+            analysisType,
+            reasoningEffort: effectiveReasoningEffort,
+            textHint: task,
+        });
+        response = await callAIProvider({
+            systemPrompt: enhancedSystemPrompt,
+            task: enhancedTask,
+            code,
+            analysisType,
+            reasoningEffort: effectiveReasoningEffort,
+            provider: selectedProvider,
+        });
+    }
+    return response;
+}
+/**
+ * Helper to list available personas
+ */
+export function getAvailablePersonas() {
+    return PersonaRegistry.list().map((p) => ({
+        id: p.id,
+        name: p.name,
+        description: p.description,
+    }));
+}

package/build/common/promptBuilder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Prompt construction utilities
+ */
+export interface PromptConfig {
+    task: string;
+    code: string;
+    analysisType: "comprehensive" | "advice" | "research" | "review";
+}
+export declare function buildUserPrompt(config: PromptConfig): string;
+//# sourceMappingURL=promptBuilder.d.ts.map

package/build/common/promptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptBuilder.d.ts","sourceRoot":"","sources":["../../src/common/promptBuilder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;CAClE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAY5D"}

package/build/common/promptBuilder.js

@@ -0,0 +1,14 @@
+/**
+ * Prompt construction utilities
+ */
+export function buildUserPrompt(config) {
+    const { task, code, analysisType } = config;
+    const analysisRequest = analysisType === "comprehensive"
+        ? "Please provide a comprehensive architectural analysis."
+        : analysisType === "research"
+            ? "Please synthesize the research findings with proper source attribution."
+            : analysisType === "review"
+                ? "Please provide a thorough code review with constructive feedback."
+                : "Please provide quick, actionable advice.";
+    return `Task: ${task}\n\nCode:\n${code}\n\n${analysisRequest}`;
+}

package/build/common/providerConfig.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Provider configuration and validation utilities
+ */
+export declare const OPENAI_API_KEY: string | undefined;
+export declare const XAI_API_KEY: string | undefined;
+export declare const AI_PROVIDER: string;
+export type AIProvider = "xai" | "openai";
+export type ReasoningEffort = "low" | "medium" | "high";
+export declare function validateProvider(provider: AIProvider): void;
+export declare function getDefaultProvider(): AIProvider;
+/**
+ * Heuristic provider selector. Prefers persona's choice; otherwise:
+ * - "openai" for comprehensive or high-effort reasoning tasks
+ * - "xai" for quick/advice-style prompts
+ * - falls back to env default
+ */
+export declare function chooseProvider(params: {
+    analysisType: "comprehensive" | "advice" | "research" | "review";
+    reasoningEffort?: ReasoningEffort;
+    personaPreferredProvider?: AIProvider;
+    textHint?: string;
+}): AIProvider;
+//# sourceMappingURL=providerConfig.d.ts.map

package/build/common/providerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerConfig.d.ts","sourceRoot":"","sources":["../../src/common/providerConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,oBAA6B,CAAC;AACzD,eAAO,MAAM,WAAW,oBAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,QAAmC,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC1C,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAW3D;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wBAAwB,CAAC,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,CA0Bb"}

package/build/common/providerConfig.js

@@ -0,0 +1,43 @@
+/**
+ * Provider configuration and validation utilities
+ */
+export const OPENAI_API_KEY = process.env.OPENAI_API_KEY;
+export const XAI_API_KEY = process.env.XAI_API_KEY;
+export const AI_PROVIDER = process.env.AI_PROVIDER || "xai";
+export function validateProvider(provider) {
+    if (provider === "xai" && !XAI_API_KEY) {
+        throw new Error("XAI_API_KEY environment variable is required for xAI provider");
+    }
+    if (provider === "openai" && !OPENAI_API_KEY) {
+        throw new Error("OPENAI_API_KEY environment variable is required for OpenAI provider");
+    }
+}
+export function getDefaultProvider() {
+    return AI_PROVIDER;
+}
+/**
+ * Heuristic provider selector. Prefers persona's choice; otherwise:
+ * - "openai" for comprehensive or high-effort reasoning tasks
+ * - "xai" for quick/advice-style prompts
+ * - falls back to env default
+ */
+export function chooseProvider(params) {
+    const { analysisType, reasoningEffort, personaPreferredProvider, textHint } = params;
+    if (personaPreferredProvider)
+        return personaPreferredProvider;
+    const hint = (textHint || "").toLowerCase();
+    const strongReasoning = analysisType === "comprehensive" ||
+        analysisType === "review" ||
+        analysisType === "research" ||
+        reasoningEffort === "high" ||
+        /(architecture|design|spec|deep|rigor|formal)/.test(hint);
+    if (strongReasoning)
+        return "openai";
+    const quick = /(quick|concise|tl;dr|fast|simple|bug|fix|snippet)/.test(hint) ||
+        analysisType === "advice" ||
+        reasoningEffort === "low" ||
+        reasoningEffort === "medium";
+    if (quick)
+        return "xai";
+    return getDefaultProvider();
+}

package/build/common/tokenFormatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Token usage formatting utilities
+ */
+import type { AIProvider, ReasoningEffort } from "./providerConfig.js";
+export interface TokenUsage {
+    totalTokens?: number;
+    reasoning_tokens?: number;
+}
+export declare function formatXaiTokenInfo(usage: TokenUsage | undefined, reasoningEffort: ReasoningEffort): string;
+export declare function formatOpenAITokenInfo(usage: TokenUsage | undefined, reasoningEffort: ReasoningEffort): string;
+export declare function formatTokenInfo(provider: AIProvider, usage: TokenUsage | undefined, reasoningEffort: ReasoningEffort): string;
+//# sourceMappingURL=tokenFormatter.d.ts.map

package/build/common/tokenFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenFormatter.d.ts","sourceRoot":"","sources":["../../src/common/tokenFormatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,GAC/B,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,GAC/B,MAAM,CAUR;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,GAC/B,MAAM,CAIR"}

package/build/common/tokenFormatter.js

@@ -0,0 +1,24 @@
+/**
+ * Token usage formatting utilities
+ */
+export function formatXaiTokenInfo(usage, reasoningEffort) {
+    const baseInfo = `Provider: xAI Grok-4 | Reasoning effort: ${reasoningEffort}`;
+    if (usage?.totalTokens) {
+        return `\n\n---\n*Tokens used: ${usage.totalTokens} | ${baseInfo}*`;
+    }
+    return `\n\n---\n*${baseInfo}*`;
+}
+export function formatOpenAITokenInfo(usage, reasoningEffort) {
+    const baseInfo = `Provider: OpenAI GPT-5 | Reasoning effort: ${reasoningEffort}`;
+    const reasoningTokens = usage?.reasoning_tokens ?? 0;
+    const totalTokens = usage?.totalTokens ?? 0;
+    if (reasoningTokens > 0) {
+        return `\n\n---\n*Reasoning tokens used: ${reasoningTokens} | Total tokens: ${totalTokens} | ${baseInfo}*`;
+    }
+    return `\n\n---\n*${baseInfo}*`;
+}
+export function formatTokenInfo(provider, usage, reasoningEffort) {
+    return provider === "xai"
+        ? formatXaiTokenInfo(usage, reasoningEffort)
+        : formatOpenAITokenInfo(usage, reasoningEffort);
+}

package/build/core/CommandDispatcher.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Command Dispatcher - Replaces the monolithic switch statement
+ * Routes MCP requests to appropriate tool commands with structured error handling
+ */
+import { CallToolRequest } from "@modelcontextprotocol/sdk/types.js";
+import { MCPToolResponse } from './ToolCommand.js';
+import { ToolRegistry } from './ToolRegistry.js';
+import { type EventBus } from '../infra/eventBus.js';
+export interface DispatcherConfig {
+    /** Default execution timeout in milliseconds */
+    defaultTimeout?: number;
+    /** Enable execution tracing */
+    enableTracing?: boolean;
+    /** Maximum concurrent executions */
+    maxConcurrentExecutions?: number;
+}
+export declare class CommandDispatcher {
+    private readonly registry;
+    private readonly eventBus;
+    private readonly config;
+    private activeExecutions;
+    private executionCounter;
+    constructor(registry: ToolRegistry, eventBusInstance?: EventBus, config?: DispatcherConfig);
+    /**
+     * Dispatch an MCP tool request to the appropriate command
+     */
+    dispatch(request: CallToolRequest): Promise<MCPToolResponse>;
+    /**
+     * Execute a tool with timeout and validation
+     */
+    private executeWithTimeout;
+    /**
+     * Execute a promise with timeout
+     */
+    private withTimeout;
+    /**
+     * Normalize errors to ToolError instances
+     */
+    private normalizeError;
+    /**
+     * Format successful result as MCP response
+     */
+    private formatMCPResponse;
+    /**
+     * Format error as MCP response
+     */
+    private formatErrorResponse;
+    /**
+     * Check if result is already in MCP response format
+     */
+    private isMCPResponse;
+    /**
+     * Generate unique request ID
+     */
+    private generateRequestId;
+    /**
+     * Get active executions for monitoring
+     */
+    getActiveExecutions(): ReadonlyMap<string, {
+        toolName: string;
+        startTime: number;
+    }>;
+    /**
+     * Get dispatcher statistics
+     */
+    getStats(): {
+        activeExecutions: number;
+        totalExecutions: number;
+        averageExecutionTime: number;
+        errorRate: number;
+    };
+    /**
+     * Create dispatcher with default configuration
+     */
+    static create(registry: ToolRegistry, config?: DispatcherConfig): CommandDispatcher;
+}
+/**
+ * Create a simple dispatch function for MCP server integration
+ */
+export declare function createDispatchHandler(registry: ToolRegistry, config?: DispatcherConfig): (request: CallToolRequest) => Promise<MCPToolResponse>;
+//# sourceMappingURL=CommandDispatcher.d.ts.map

package/build/core/CommandDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandDispatcher.d.ts","sourceRoot":"","sources":["../../src/core/CommandDispatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EASL,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,gBAAgB,CAA8D;IACtF,OAAO,CAAC,gBAAgB,CAAK;gBAG3B,QAAQ,EAAE,YAAY,EACtB,gBAAgB,CAAC,EAAE,QAAQ,EAC3B,MAAM,GAAE,gBAAqB;IAW/B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiFlE;;OAEG;YACW,kBAAkB;IAiEhC;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAInF;;OAEG;IACH,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB;IAWD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB;CAGpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,gBAAgB,GACxB,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAGxD"}