@jwikman/bc-code-intelligence-mcp 1.5.7-dev.1

package/dist/tools/specialist-tools.js

@@ -0,0 +1,372 @@
+/**
+ * MCP Tools for BC Specialist Interactions
+ *
+ * Provides a focused set of tools for AI-assisted Business Central development
+ * through personality-driven specialist consultations.
+ */
+import { BCSpecialistRoleplayEngine } from '../services/roleplay-engine.js';
+import { z } from 'zod';
+// Input validation schemas
+const SuggestSpecialistSchema = z.object({
+    question: z.string().min(10, 'Question must be at least 10 characters'),
+    context: z.string().optional().describe('Additional context about the problem')
+});
+const GetSpecialistAdviceSchema = z.object({
+    specialist_id: z.string().min(1, 'Specialist ID is required'),
+    message: z.string().min(1, 'Message is required'),
+    session_id: z.string().optional().describe('Session ID for multi-turn conversations'),
+    problem_context: z.string().optional().describe('Overall problem being solved')
+});
+const ListSpecialistsSchema = z.object({
+    domain: z.string().optional().describe('Filter by domain (e.g., performance, security)'),
+    expertise: z.string().optional().describe('Filter by expertise area')
+});
+export class SpecialistTools {
+    layerService;
+    sessionManager;
+    knowledgeService;
+    roleplayEngine;
+    constructor(layerService, sessionManager, knowledgeService) {
+        this.layerService = layerService;
+        this.sessionManager = sessionManager;
+        this.knowledgeService = knowledgeService;
+        this.roleplayEngine = new BCSpecialistRoleplayEngine(layerService, knowledgeService);
+    }
+    /**
+     * Get all specialist tool definitions for MCP registration
+     */
+    getToolDefinitions() {
+        return [
+            {
+                name: 'suggest_specialist',
+                description: 'Find the most appropriate BC specialist for your question. IMPORTANT: When user wants to "talk to" or "chat with" a specific specialist, use get_specialist_advice directly instead. This tool is for discovering which specialist to use when unsure.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        question: {
+                            type: 'string',
+                            description: 'Your question or problem description',
+                            minLength: 10
+                        },
+                        context: {
+                            type: 'string',
+                            description: 'Additional context about your project or situation (optional)'
+                        }
+                    },
+                    required: ['question']
+                }
+            },
+            {
+                name: 'get_specialist_advice',
+                description: `Connect directly with a BC specialist who responds authentically as themselves. CRITICAL FOR AGENTS: Respond AS the specialist, not as an AI describing roleplay. No menus, no explanations - dive straight into the specialist persona and expertise. Perfect for "Talk to Sam", "Chat with Dean", etc.
+
+⚠️ **MANDATORY KNOWLEDGE LOOKUP**: Before generating ANY BC development advice or code, ALWAYS search the knowledge base first using find_bc_knowledge. The knowledge base contains authoritative BC standards, patterns, and conventions that override general AI training. Never rely solely on training data for BC development guidance.
+
+Example: find_bc_knowledge({ query: "AL file naming conventions" }) before writing AL code.
+
+🔧 **AL/BC Platform Constraints**: All specialist advice MUST respect Business Central and AL language limitations:
+• Security specialists: Focus on AL permission objects, user groups, BC security framework - NOT external auth systems
+• UX specialists: Work within AL page/report constraints - BC controls rendering, NOT custom CSS/HTML  
+• Performance specialists: AL optimization patterns, table design, BC server constraints - NOT generic frameworks
+• API specialists: BC API pages, web services, AL integration - NOT generic REST frameworks
+• All specialists: Prioritize AL language capabilities and BC platform limitations over generic programming`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        specialist_id: {
+                            type: 'string',
+                            description: 'ID of the specialist (e.g., dean-debug, alex-architect)',
+                            minLength: 1
+                        },
+                        message: {
+                            type: 'string',
+                            description: 'Your question or message to the specialist',
+                            minLength: 1
+                        },
+                        session_id: {
+                            type: 'string',
+                            description: 'Session ID for ongoing conversations (optional - will create new session if not provided)'
+                        },
+                        problem_context: {
+                            type: 'string',
+                            description: 'Overall problem context to help the specialist understand the bigger picture (optional)'
+                        }
+                    },
+                    required: ['specialist_id', 'message']
+                }
+            },
+            {
+                name: 'list_specialists',
+                description: 'Discover available BC specialists and their expertise areas. Useful for understanding the team capabilities.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        domain: {
+                            type: 'string',
+                            description: 'Filter by domain (e.g., performance, security, api-design) - optional'
+                        },
+                        expertise: {
+                            type: 'string',
+                            description: 'Filter by expertise area (e.g., caching, authentication) - optional'
+                        }
+                    },
+                    required: []
+                }
+            }
+        ];
+    }
+    /**
+     * Handle specialist tool calls
+     */
+    async handleToolCall(request) {
+        try {
+            switch (request.params.name) {
+                case 'suggest_specialist':
+                    return await this.handleSuggestSpecialist(request);
+                case 'get_specialist_advice':
+                    return await this.handleGetSpecialistAdvice(request);
+                case 'list_specialists':
+                    return await this.handleListSpecialists(request);
+                default:
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Unknown specialist tool: ${request.params.name}`
+                            }],
+                        isError: true
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error in ${request.params.name}: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    }
+    /**
+     * Find the best specialist for a question
+     */
+    async handleSuggestSpecialist(request) {
+        const validated = SuggestSpecialistSchema.parse(request.params.arguments);
+        // Create basic session context for suggestion
+        const sessionContext = validated.context ? {
+            problem: validated.context,
+            solutions: [],
+            recommendations: [],
+            nextSteps: [],
+            userPreferences: {}
+        } : undefined;
+        const suggestions = await this.roleplayEngine.suggestSpecialist(validated.question, sessionContext);
+        if (suggestions.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '🤔 No specialists found for this question. Try rephrasing or providing more context about your BC development challenge.'
+                    }]
+            };
+        }
+        // Format suggestions with personality
+        let response = `🎯 **Specialist Recommendations for your question:**\n\n`;
+        for (let i = 0; i < suggestions.length; i++) {
+            const suggestion = suggestions[i];
+            const specialist = await this.layerService.getSpecialist(suggestion.specialist_id);
+            if (specialist) {
+                const confidence = Math.round(suggestion.confidence * 100);
+                response += `**${i + 1}. ${specialist.title}** (${suggestion.specialist_id}) - ${confidence}% match\n`;
+                response += `${specialist.persona.greeting}\n`;
+                response += `💡 **Why ${specialist.title}:** ${suggestion.reasoning}\n`;
+                response += `🔧 **Expertise:** ${specialist.expertise.primary.join(', ')}\n\n`;
+            }
+        }
+        response += `💬 **Next step:** Use \`get_specialist_advice\` with your chosen specialist_id to start the conversation!`;
+        return {
+            content: [{ type: 'text', text: response }]
+        };
+    }
+    /**
+     * Get advice from a specialist with automatic session management
+     */
+    async handleGetSpecialistAdvice(request) {
+        const validated = GetSpecialistAdviceSchema.parse(request.params.arguments);
+        // Try exact ID match first
+        let specialist = await this.layerService.getSpecialist(validated.specialist_id);
+        // If not found, try fuzzy matching
+        if (!specialist) {
+            specialist = await this.findSpecialistByFuzzyName(validated.specialist_id);
+        }
+        if (!specialist) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ Specialist '${validated.specialist_id}' not found. Tried exact ID match and fuzzy name matching. Use 'list_specialists' to see available experts.`
+                    }],
+                isError: true
+            };
+        }
+        // Handle session management
+        let sessionId = validated.session_id;
+        let session;
+        if (sessionId) {
+            // Get existing session with auto-recovery
+            session = await this.sessionManager.getSession(sessionId);
+            if (!session) {
+                // Auto-recover: create new session instead of failing
+                console.warn(`Session '${sessionId}' not found. Creating recovery session.`);
+                session = await this.sessionManager.startSession(validated.specialist_id, 'default-user', `Recovery session. Original session ${sessionId} was lost. Context: ${validated.problem_context || validated.message}`);
+                sessionId = session.sessionId;
+            }
+        }
+        else {
+            // Create new session
+            session = await this.sessionManager.startSession(validated.specialist_id, 'default-user', // TODO: Get actual user ID from context
+            validated.problem_context || validated.message);
+            sessionId = session.sessionId;
+        }
+        // Determine if this is a new session or handoff requiring introduction
+        const isNewSession = !validated.session_id || session.messages.length === 0;
+        const isHandoff = validated.session_id && session.context.current_specialist !== validated.specialist_id;
+        // Generate specialist response using conversation history
+        const roleplayContext = {
+            specialist,
+            userMessage: validated.message,
+            session: session.context,
+            conversationHistory: session.messages.map(m => ({
+                role: m.type === 'user' ? 'user' : 'assistant',
+                content: m.content,
+                timestamp: m.timestamp
+            })),
+            requiresIntroduction: isNewSession || isHandoff
+        };
+        const response = await this.roleplayEngine.generateResponse(roleplayContext);
+        // Add user and specialist messages to session
+        await this.sessionManager.continueSession(sessionId, validated.message);
+        // Update session with specialist response - we'll add this via continueSession flow
+        const updatedSession = await this.sessionManager.getSession(sessionId);
+        // Update context if provided
+        if (response.context_updates && updatedSession) {
+            await this.sessionManager.updateContext(sessionId, response.context_updates);
+        }
+        // Return agent roleplay instructions (NOT formatted user response)
+        let agentInstructions = '';
+        // **CRITICAL**: Include full specialist markdown content as instructions
+        agentInstructions += `SPECIALIST DEFINITION AND INSTRUCTIONS:\n\n`;
+        agentInstructions += specialist.content; // Full markdown content including Phase 0, workflows, etc.
+        agentInstructions += `\n\n${'='.repeat(80)}\n\n`;
+        agentInstructions += `CURRENT CONTEXT:\n\n`;
+        agentInstructions += response.content;
+        // Add knowledge context for the agent
+        if (response.topics_referenced.length > 0) {
+            agentInstructions += `\n\nKNOWLEDGE CONTEXT FOR RESPONSE:\n`;
+            agentInstructions += `- Referenced Topics: ${response.topics_referenced.join(', ')}\n`;
+            agentInstructions += `- Use this knowledge to provide specific, accurate guidance\n`;
+        }
+        // Add handoff guidance for the agent
+        if (response.suggested_handoffs && response.suggested_handoffs.length > 0) {
+            agentInstructions += `\n\nHANDOFF GUIDANCE:\n`;
+            for (const handoff of response.suggested_handoffs) {
+                const handoffSpecialist = await this.layerService.getSpecialist(handoff.specialist_id);
+                if (handoffSpecialist) {
+                    agentInstructions += `- If user needs ${handoff.reason}, suggest consulting ${handoffSpecialist.title}\n`;
+                }
+            }
+        }
+        agentInstructions += `\n\nRemember: You ARE ${specialist.title}. Respond directly as this character, not as an AI assistant.`;
+        // Add recommendations as agent guidance
+        if (response.recommendations_added && response.recommendations_added.length > 0) {
+            agentInstructions += `\n\nRECOMMENDATIONS TO INCLUDE:\n`;
+            response.recommendations_added.forEach((rec, i) => {
+                agentInstructions += `${i + 1}. ${rec}\n`;
+            });
+        }
+        return {
+            content: [{ type: 'text', text: agentInstructions }]
+        };
+    }
+    /**
+     * List available specialists with filtering
+     */
+    async handleListSpecialists(request) {
+        const validated = ListSpecialistsSchema.parse(request.params.arguments || {});
+        const specialists = await this.layerService.getAllSpecialists();
+        // Apply filters
+        let filteredSpecialists = specialists;
+        if (validated.domain) {
+            filteredSpecialists = specialists.filter(s => s.domains.some(d => d.toLowerCase().includes(validated.domain.toLowerCase())));
+        }
+        if (validated.expertise) {
+            filteredSpecialists = filteredSpecialists.filter(s => [...s.expertise.primary, ...s.expertise.secondary].some(e => e.toLowerCase().includes(validated.expertise.toLowerCase())));
+        }
+        if (filteredSpecialists.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '❌ No specialists found matching your criteria. Try different filters or remove them to see all specialists.'
+                    }]
+            };
+        }
+        // Group by domain for better organization
+        const specialistsByDomain = new Map();
+        filteredSpecialists.forEach(specialist => {
+            specialist.domains.forEach(domain => {
+                if (!specialistsByDomain.has(domain)) {
+                    specialistsByDomain.set(domain, []);
+                }
+                if (!specialistsByDomain.get(domain).includes(specialist)) {
+                    specialistsByDomain.get(domain).push(specialist);
+                }
+            });
+        });
+        let response = `👥 **BC Code Intelligence Specialists** ${validated.domain || validated.expertise ? '(filtered)' : ''}\n\n`;
+        // Show specialists organized by domain
+        for (const [domain, domainSpecialists] of specialistsByDomain.entries()) {
+            response += `## 🏷️ ${domain.charAt(0).toUpperCase() + domain.slice(1)}\n\n`;
+            for (const specialist of domainSpecialists) {
+                response += `**${specialist.title}** (\`${specialist.specialist_id}\`)\n`;
+                response += `💬 ${specialist.persona.greeting}\n`;
+                response += `🎯 **Primary Expertise:** ${specialist.expertise.primary.join(', ')}\n`;
+                if (specialist.expertise.secondary.length > 0) {
+                    response += `🔧 **Also helps with:** ${specialist.expertise.secondary.slice(0, 3).join(', ')}\n`;
+                }
+                response += `\n`;
+            }
+        }
+        response += `\n💡 **Getting Started:**\n`;
+        response += `• Use \`suggest_specialist\` with your question to get personalized recommendations\n`;
+        response += `• Use \`get_specialist_advice\` with a specialist_id to start a conversation\n`;
+        response += `• Sessions are automatically managed for multi-turn conversations`;
+        return {
+            content: [{ type: 'text', text: response }]
+        };
+    }
+    /**
+     * Find specialist by partial/fuzzy name matching
+     * Handles cases like "Sam" -> "sam-coder", "Dean" -> "dean-debug", etc.
+     */
+    async findSpecialistByFuzzyName(partialName) {
+        const allSpecialists = await this.layerService.getAllSpecialists();
+        const searchTerm = partialName.toLowerCase().trim();
+        // First try exact specialist_id match (case insensitive)
+        let match = allSpecialists.find(specialist => specialist.specialist_id.toLowerCase() === searchTerm);
+        if (match)
+            return match;
+        // Try partial match in specialist_id
+        match = allSpecialists.find(specialist => specialist.specialist_id.toLowerCase().includes(searchTerm));
+        if (match)
+            return match;
+        // Try matching first part of specialist_id (before the dash)
+        match = allSpecialists.find(specialist => {
+            const firstName = specialist.specialist_id.split('-')[0].toLowerCase();
+            return firstName === searchTerm;
+        });
+        if (match)
+            return match;
+        // Try matching in title
+        match = allSpecialists.find(specialist => specialist.title?.toLowerCase().includes(searchTerm));
+        return match || null;
+    }
+}
+//# sourceMappingURL=specialist-tools.js.map

package/dist/tools/specialist-tools.js.map

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

package/dist/tools/workspace-tools.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Workspace management tools
+ * Handles workspace root configuration and MCP ecosystem awareness
+ */
+import { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Known Business Central MCP servers and their capabilities
+ */
+export declare const KNOWN_BC_MCPS: {
+    readonly 'bc-code-intelligence-mcp': "BC development knowledge with 14 specialist AI personas";
+    readonly 'al-dependency-mcp-server': "AL workspace symbol and dependency analysis from .app files";
+    readonly 'serena-mcp': "Multi-language LSP-based coding assistant with AL Language Server support";
+    readonly 'al-objid-mcp-server': "AL object ID collision prevention and management (Object ID Ninja)";
+    readonly 'bc-telemetry-buddy': "BC telemetry collection, KQL query generation, and performance analysis";
+    readonly 'azure-devops-mcp': "Azure DevOps integration (work items, repos, pipelines, wiki)";
+    readonly 'clockify-mcp': "Clockify time tracking and project management integration";
+    readonly 'nab-al-tools-mcp': "XLIFF/XLF translation tooling for AL projects";
+};
+/**
+ * Map of signature tools to their MCP server
+ * Use this to discover which MCP servers are available by checking for these tools
+ */
+export declare const MCP_TOOL_SIGNATURES: {
+    readonly search_telemetry_traces: "bc-telemetry-buddy";
+    readonly generate_kql_query: "bc-telemetry-buddy";
+    readonly analyze_performance_traces: "bc-telemetry-buddy";
+    readonly reserve_object_ids: "al-objid-mcp-server";
+    readonly check_object_id_collision: "al-objid-mcp-server";
+    readonly get_next_object_id: "al-objid-mcp-server";
+    readonly analyze_dependencies: "al-dependency-mcp-server";
+    readonly get_workspace_symbols: "al-dependency-mcp-server";
+    readonly find_references: "al-dependency-mcp-server";
+    readonly get_lsp_diagnostics: "serena-mcp";
+    readonly format_document: "serena-mcp";
+    readonly get_code_actions: "serena-mcp";
+    readonly create_work_item: "azure-devops-mcp";
+    readonly query_work_items: "azure-devops-mcp";
+    readonly get_pipeline_runs: "azure-devops-mcp";
+    readonly track_time_entry: "clockify-mcp";
+    readonly get_time_entries: "clockify-mcp";
+    readonly translate_xliff: "nab-al-tools-mcp";
+    readonly export_translations: "nab-al-tools-mcp";
+};
+export type KnownMcpServerId = keyof typeof KNOWN_BC_MCPS;
+export interface WorkspaceInfo {
+    workspace_root: string | null;
+    available_mcps: string[];
+}
+export interface WorkspaceToolsContext {
+    setWorkspaceInfo: (path: string, availableMcps?: string[]) => Promise<{
+        success: boolean;
+        message: string;
+        reloaded: boolean;
+    }>;
+    getWorkspaceInfo: () => WorkspaceInfo;
+}
+export declare class WorkspaceTools {
+    private context;
+    constructor(context: WorkspaceToolsContext);
+    getToolDefinitions(): ({
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                workspace_root: {
+                    type: string;
+                    description: string;
+                };
+                available_mcps: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                workspace_root?: undefined;
+                available_mcps?: undefined;
+            };
+            required: any[];
+        };
+    })[];
+    handleToolCall(request: CallToolRequest): Promise<any>;
+    private handleSetWorkspaceInfo;
+    private handleGetWorkspaceInfo;
+}
+//# sourceMappingURL=workspace-tools.d.ts.map

package/dist/tools/workspace-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tools.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAYhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;CAiCtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChI,gBAAgB,EAAE,MAAM,aAAa,CAAC;CACvC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAElD,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4CZ,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC;YAe9C,sBAAsB;YAwDtB,sBAAsB;CA4BrC"}