agentdog 1.1.0

package/dist/router/tool-router.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ToolRouter } from './tool-router';
+import { EventEmitter } from 'events';
+// Mock ServerAdapter
+class MockAdapter extends EventEmitter {
+    name;
+    config;
+    isConnected = false;
+    tools;
+    constructor(name, tools) {
+        super();
+        this.name = name;
+        this.tools = tools;
+        this.config = {};
+    }
+    connect = vi.fn(async () => {
+        this.isConnected = true;
+        this.emit('connected');
+    });
+    disconnect = vi.fn(async () => {
+        this.isConnected = false;
+        this.emit('disconnected');
+    });
+    getTools = vi.fn(async () => {
+        if (!this.isConnected)
+            throw new Error('Not connected');
+        return this.tools;
+    });
+    callTool = vi.fn(async (toolName, args) => {
+        if (!this.isConnected)
+            throw new Error('Not connected');
+        return {
+            jsonrpc: '2.0',
+            id: 1,
+            result: { content: `Result from ${this.name}.${toolName}` },
+        };
+    });
+    // Added to satisfy ServerAdapter interface
+    sendRequest = vi.fn(async (request) => {
+        return {
+            jsonrpc: '2.0',
+            id: request.id,
+            result: { message: 'Mocked sendRequest' }
+        };
+    });
+}
+describe('ToolRouter', () => {
+    let toolRouter;
+    beforeEach(() => {
+        toolRouter = new ToolRouter();
+    });
+    it('should add an adapter and refresh routes on connect', async () => {
+        const mockTools = [{ name: 'tool1', description: 'desc1', inputSchema: { type: 'object' } }];
+        const adapter = new MockAdapter('server1', mockTools);
+        toolRouter.addAdapter(adapter);
+        await adapter.connect();
+        const allTools = await toolRouter.getAllTools();
+        expect(allTools).toHaveLength(1);
+        expect(allTools[0].name).toBe('tool1');
+        expect(toolRouter.getAdapter('server1')).toBe(adapter);
+    });
+    it('should handle tool name conflicts by prefixing', async () => {
+        const tools1 = [{ name: 'shared_tool', description: 'desc1', inputSchema: { type: 'object' } }];
+        const tools2 = [{ name: 'shared_tool', description: 'desc2', inputSchema: { type: 'object' } }];
+        const adapter1 = new MockAdapter('server1', tools1);
+        const adapter2 = new MockAdapter('server2', tools2);
+        toolRouter.addAdapter(adapter1);
+        toolRouter.addAdapter(adapter2);
+        await adapter1.connect();
+        await adapter2.connect();
+        const allTools = await toolRouter.getAllTools();
+        expect(allTools).toHaveLength(2);
+        const toolNames = allTools.map(t => t.name).sort();
+        expect(toolNames).toEqual(['server1-shared_tool', 'server2-shared_tool']);
+    });
+    it('should route a tool call to the correct adapter', async () => {
+        const tools1 = [{ name: 'tool1', description: 'desc1', inputSchema: { type: 'object' } }];
+        const tools2 = [{ name: 'tool2', description: 'desc2', inputSchema: { type: 'object' } }];
+        const adapter1 = new MockAdapter('server1', tools1);
+        const adapter2 = new MockAdapter('server2', tools2);
+        toolRouter.addAdapter(adapter1);
+        toolRouter.addAdapter(adapter2);
+        await adapter1.connect();
+        await adapter2.connect();
+        // Need to manually trigger route creation for testing since it happens on 'connect' event
+        // @ts-ignore - access private method for test
+        await toolRouter.refreshToolRoutes('server1');
+        // @ts-ignore
+        await toolRouter.refreshToolRoutes('server2');
+        const response = await toolRouter.callTool('tool2', {});
+        expect(response.result.content).toBe('Result from server2.tool2');
+        expect(adapter2.callTool).toHaveBeenCalledWith('tool2', {});
+        expect(adapter1.callTool).not.toHaveBeenCalled();
+    });
+    it('should return an error if a tool is not found', async () => {
+        const response = await toolRouter.callTool('non_existent_tool', {});
+        expect(response.error).toBeDefined();
+        expect(response.error?.code).toBe(-32601);
+        expect(response.error?.message).toContain('Tool not found');
+    });
+    it('should remove routes when an adapter disconnects', async () => {
+        const mockTools = [{ name: 'tool1', description: 'desc1', inputSchema: { type: 'object' } }];
+        const adapter = new MockAdapter('server1', mockTools);
+        toolRouter.addAdapter(adapter);
+        await adapter.connect();
+        let allTools = await toolRouter.getAllTools();
+        expect(allTools).toHaveLength(1);
+        adapter.emit('disconnected');
+        const route = toolRouter.findToolRoute('tool1');
+        expect(route).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tool-router.test.js.map

package/dist/router/tool-router.test.js.map

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

package/dist/streamable-http-server.d.ts

@@ -0,0 +1,27 @@
+import { EventEmitter } from 'events';
+import { ConfigManager } from './config/config-manager.js';
+export declare class StreamableHttpMCPServer extends EventEmitter {
+    private server;
+    private httpServer;
+    private port;
+    private authToken?;
+    private authMiddleware?;
+    private sessions;
+    private sessionTimeout;
+    constructor(configManager: ConfigManager, port?: number, authToken?: string);
+    private setupServer;
+    private setupHttpServer;
+    private handleAuthenticatedRequest;
+    private handleHealthCheck;
+    private handleHttpRequest;
+    private sendMCPResponse;
+    private shouldUseStreaming;
+    private sendErrorResponse;
+    private createSession;
+    private validateSession;
+    private updateSessionActivity;
+    private cleanupExpiredSessions;
+    start(): Promise<void>;
+    private shutdown;
+}
+//# sourceMappingURL=streamable-http-server.d.ts.map

package/dist/streamable-http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-server.d.ts","sourceRoot":"","sources":["../src/streamable-http-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAwE;IAC/F,OAAO,CAAC,QAAQ,CAKD;IACf,OAAO,CAAC,cAAc,CAA0B;gBAEpC,aAAa,EAAE,aAAa,EAAE,IAAI,GAAE,MAAa,EAAE,SAAS,CAAC,EAAE,MAAM;IAgBjF,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,iBAAiB;YAUX,iBAAiB;IA6F/B,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,sBAAsB;IAUxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgCd,QAAQ;CA4BvB"}

package/dist/streamable-http-server.js

@@ -0,0 +1,302 @@
+import { createServer } from 'http';
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+import { MCPDogServer } from './core/mcpdog-server.js';
+import { createAuthMiddleware } from './middleware/auth.js';
+export class StreamableHttpMCPServer extends EventEmitter {
+    server;
+    httpServer;
+    port;
+    authToken;
+    authMiddleware;
+    sessions = new Map();
+    sessionTimeout = 30 * 60 * 1000; // 30 minutes
+    constructor(configManager, port = 4000, authToken) {
+        super();
+        console.error(`[HTTP] Creating StreamableHttpMCPServer instance on port ${port}${authToken ? ' with authentication' : ''}`);
+        this.port = port;
+        this.authToken = authToken;
+        this.server = new MCPDogServer(configManager);
+        // Setup auth middleware if token is provided
+        if (this.authToken) {
+            this.authMiddleware = createAuthMiddleware(this.authToken);
+        }
+        this.setupServer();
+        this.setupHttpServer();
+    }
+    setupServer() {
+        this.server.on('notification', (notification) => {
+            // HTTP mode doesn't push notifications like stdio, they're request-response based
+            console.error(`[HTTP] Received notification: ${notification.method}`);
+        });
+        this.server.on('error', ({ error, context }) => {
+            console.error(`MCPDog error [${context}]:`, error);
+        });
+        this.server.on('started', () => {
+            console.error('MCPDog Server started (HTTP streamable mode)');
+        });
+        this.server.on('stopped', () => {
+            console.error('MCPDog Server stopped');
+        });
+    }
+    setupHttpServer() {
+        this.httpServer = createServer();
+        // Enable CORS for web-based MCP clients
+        this.httpServer.on('request', (req, res) => {
+            // Set CORS headers
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, mcp-session-id');
+            if (req.method === 'OPTIONS') {
+                res.writeHead(200);
+                res.end();
+                return;
+            }
+            // Apply authentication middleware if configured
+            if (this.authMiddleware) {
+                this.authMiddleware(req, res, () => {
+                    this.handleAuthenticatedRequest(req, res);
+                });
+            }
+            else {
+                this.handleAuthenticatedRequest(req, res);
+            }
+        });
+        this.httpServer.on('error', (error) => {
+            console.error('HTTP server error:', error);
+        });
+        // Handle process signals
+        process.on('SIGINT', () => this.shutdown());
+        process.on('SIGTERM', () => this.shutdown());
+        process.on('uncaughtException', (error) => {
+            console.error('Uncaught exception:', error);
+            this.shutdown();
+        });
+    }
+    handleAuthenticatedRequest(req, res) {
+        if (req.method === 'POST') {
+            this.handleHttpRequest(req, res);
+        }
+        else if (req.method === 'GET') {
+            this.handleHealthCheck(req, res);
+        }
+        else {
+            res.writeHead(405, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Method not allowed' }));
+        }
+    }
+    handleHealthCheck(req, res) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            status: 'healthy',
+            service: 'mcpdog-streamable-http',
+            version: '2.0.15',
+            timestamp: new Date().toISOString()
+        }));
+    }
+    async handleHttpRequest(req, res) {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += chunk.toString();
+        });
+        req.on('end', async () => {
+            try {
+                console.error(`[HTTP] Received request: ${body.substring(0, 100)}...`);
+                if (!body.trim()) {
+                    this.sendErrorResponse(res, 400, 'Empty request body');
+                    return;
+                }
+                const message = JSON.parse(body);
+                // Extract session ID from headers
+                const sessionId = req.headers['mcp-session-id'];
+                // Check if it's a notification message (no id field)
+                if (!('id' in message)) {
+                    const notification = message;
+                    console.error(`[HTTP] Handling notification: ${notification.method}`);
+                    // Validate session for non-initialize notifications
+                    if (sessionId && !this.validateSession(sessionId)) {
+                        this.sendErrorResponse(res, 401, 'Invalid or expired session');
+                        return;
+                    }
+                    // Notifications get 204 No Content response
+                    res.writeHead(204);
+                    res.end();
+                    return;
+                }
+                // Handle regular requests
+                const request = message;
+                console.error(`[HTTP] Processing request: ${request.method} (id: ${request.id})`);
+                // Handle initialize request - create new session
+                if (request.method === 'initialize') {
+                    const response = await this.server.handleRequest(request, 'http-client');
+                    if (!response.error) {
+                        // Create new session
+                        const newSessionId = this.createSession(req.socket?.remoteAddress || 'unknown');
+                        console.error(`[HTTP] Created new session: ${newSessionId}`);
+                        // Add session ID to response headers
+                        res.setHeader('mcp-session-id', newSessionId);
+                        this.sendMCPResponse(res, response);
+                    }
+                    else {
+                        this.sendMCPResponse(res, response);
+                    }
+                    return;
+                }
+                // For non-initialize requests, validate session
+                if (!sessionId) {
+                    this.sendErrorResponse(res, 400, 'Missing mcp-session-id header');
+                    return;
+                }
+                if (!this.validateSession(sessionId)) {
+                    this.sendErrorResponse(res, 401, 'Invalid or expired session');
+                    return;
+                }
+                // Update session activity
+                this.updateSessionActivity(sessionId);
+                const response = await this.server.handleRequest(request, sessionId);
+                console.error(`[HTTP] Sending response for: ${request.method} (id: ${request.id})`);
+                this.sendMCPResponse(res, response);
+            }
+            catch (error) {
+                console.error('[HTTP] Error processing request:', error);
+                this.sendErrorResponse(res, 500, 'Internal server error');
+            }
+        });
+        req.on('error', (error) => {
+            console.error('[HTTP] Request error:', error);
+            this.sendErrorResponse(res, 400, 'Bad request');
+        });
+    }
+    sendMCPResponse(res, response) {
+        const responseBody = JSON.stringify(response);
+        // Check if this could be a streaming response (for future SSE support)
+        const isStreamingRequest = this.shouldUseStreaming(response);
+        if (isStreamingRequest) {
+            // Send as Server-Sent Events for streaming responses
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive'
+            });
+            res.write(`event: message\n`);
+            res.write(`data: ${responseBody}\n\n`);
+            res.end();
+        }
+        else {
+            // Send as regular JSON response
+            res.writeHead(200, {
+                'Content-Type': 'application/json'
+            });
+            res.end(responseBody);
+        }
+    }
+    shouldUseStreaming(response) {
+        // For now, always use JSON responses
+        // In the future, we could detect streaming scenarios (e.g., tool calls that take time)
+        return false;
+    }
+    sendErrorResponse(res, statusCode, message) {
+        res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            error: {
+                code: statusCode,
+                message: message
+            }
+        }));
+    }
+    createSession(clientId) {
+        const sessionId = randomUUID();
+        const now = new Date();
+        this.sessions.set(sessionId, {
+            id: sessionId,
+            clientId: clientId,
+            created: now,
+            lastActivity: now
+        });
+        return sessionId;
+    }
+    validateSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return false;
+        }
+        // Check if session has expired
+        const now = new Date();
+        if (now.getTime() - session.lastActivity.getTime() > this.sessionTimeout) {
+            this.sessions.delete(sessionId);
+            return false;
+        }
+        return true;
+    }
+    updateSessionActivity(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActivity = new Date();
+        }
+    }
+    cleanupExpiredSessions() {
+        const now = new Date();
+        for (const [sessionId, session] of this.sessions) {
+            if (now.getTime() - session.lastActivity.getTime() > this.sessionTimeout) {
+                console.error(`[HTTP] Cleaning up expired session: ${sessionId}`);
+                this.sessions.delete(sessionId);
+            }
+        }
+    }
+    async start() {
+        try {
+            console.error(`[HTTP] Starting StreamableHttpMCPServer...`);
+            await this.server.start();
+            // Start session cleanup timer
+            const cleanupInterval = setInterval(() => {
+                this.cleanupExpiredSessions();
+            }, 5 * 60 * 1000); // Clean up every 5 minutes
+            // Store cleanup interval for shutdown
+            this.cleanupInterval = cleanupInterval;
+            return new Promise((resolve, reject) => {
+                this.httpServer.listen(this.port, (error) => {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        console.error(`[HTTP] StreamableHttpMCPServer started successfully on port ${this.port}`);
+                        console.error(`[HTTP] Health check endpoint: http://localhost:${this.port}/`);
+                        console.error(`[HTTP] MCP endpoint: POST http://localhost:${this.port}/`);
+                        console.error(`[HTTP] Session management enabled with ${this.sessionTimeout / 1000}s timeout`);
+                        resolve();
+                    }
+                });
+            });
+        }
+        catch (error) {
+            console.error('Failed to start HTTP server:', error);
+            process.exit(1);
+        }
+    }
+    async shutdown() {
+        console.error('Shutting down StreamableHttpMCPServer...');
+        try {
+            // Clean up session cleanup timer
+            if (this.cleanupInterval) {
+                clearInterval(this.cleanupInterval);
+            }
+            // Clear all sessions
+            this.sessions.clear();
+            if (this.httpServer) {
+                await new Promise((resolve) => {
+                    this.httpServer.close(() => {
+                        console.error('HTTP server closed');
+                        resolve();
+                    });
+                });
+            }
+            await this.server.stop();
+            process.exit(0);
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=streamable-http-server.js.map

package/dist/streamable-http-server.js.map

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

package/dist/tool-finder.d.ts

@@ -0,0 +1,21 @@
+import { MCPTool } from './mcp-registry.js';
+import { UserIntent } from './intent-analyzer.js';
+export interface ToolMatch {
+    server: string;
+    tool: MCPTool;
+    matchScore: number;
+    suggestedCall?: {
+        toolName: string;
+        parameters: any;
+        reasoning: string;
+    };
+}
+export declare class ToolFinder {
+    private registry;
+    constructor();
+    findMatchingTools(intent: UserIntent): Promise<ToolMatch[]>;
+    private generateToolCall;
+    getServerConfig(serverName: string): import("./mcp-registry.js").MCPServerConfig | undefined;
+    getAllServers(): import("./mcp-registry.js").MCPServerInfo[];
+}
+//# sourceMappingURL=tool-finder.d.ts.map

package/dist/tool-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-finder.d.ts","sourceRoot":"","sources":["../src/tool-finder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,GAAG,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAc;;IAMxB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoBjE,OAAO,CAAC,gBAAgB;IAiExB,eAAe,CAAC,UAAU,EAAE,MAAM;IAKlC,aAAa;CAGd"}

package/dist/tool-finder.js

@@ -0,0 +1,86 @@
+import { MCPRegistry } from './mcp-registry.js';
+export class ToolFinder {
+    registry;
+    constructor() {
+        this.registry = new MCPRegistry();
+    }
+    async findMatchingTools(intent) {
+        // Use keyword matching to find tools
+        const matches = this.registry.findToolsByKeywords(intent.keywords);
+        // Generate call suggestions for each matched tool
+        const toolMatches = matches.map(match => {
+            const suggestedCall = this.generateToolCall(match.tool, intent);
+            return {
+                server: match.server,
+                tool: match.tool,
+                matchScore: match.matchScore,
+                suggestedCall
+            };
+        });
+        // Return top 3 best matches
+        return toolMatches.slice(0, 3);
+    }
+    generateToolCall(tool, intent) {
+        const parameters = {};
+        let reasoning = `Based on your request "${intent.description}", `;
+        // Intelligently fill parameters based on tool type and user intent
+        switch (tool.name) {
+            case 'browser_navigate':
+                if (intent.extractedData.url) {
+                    parameters.url = intent.extractedData.url;
+                    reasoning += `I have prepared a call to navigate to ${intent.extractedData.url}.`;
+                }
+                else {
+                    parameters.url = 'https://www.google.com';
+                    reasoning += `I suggest navigating to Google homepage first.`;
+                }
+                break;
+            case 'browser_type':
+                if (intent.extractedData.text) {
+                    parameters.text = intent.extractedData.text;
+                    parameters.submit = true;
+                    reasoning += `I will input the text "${intent.extractedData.text}" and submit.`;
+                }
+                else {
+                    parameters.text = 'Sample text';
+                    parameters.submit = false;
+                    reasoning += `This is a sample call for text input.`;
+                }
+                // Need to get page snapshot first to find input element
+                parameters.element = 'Need to get page snapshot to determine input element';
+                parameters.ref = 'Need to get element reference from snapshot';
+                break;
+            case 'browser_click':
+                parameters.element = 'Need to get page snapshot to determine click element';
+                parameters.ref = 'Need to get element reference from snapshot';
+                reasoning += `Need to get page snapshot to determine which element to click.`;
+                break;
+            case 'browser_screenshot':
+            case 'browser_snapshot':
+            case 'browser_go_back':
+            case 'browser_go_forward':
+                // These tools don't need parameters
+                reasoning += `This tool can be called directly.`;
+                break;
+            case 'browser_wait':
+                parameters.time = 2;
+                reasoning += `I suggest waiting 2 seconds.`;
+                break;
+            default:
+                reasoning += `This is a generic tool call.`;
+        }
+        return {
+            toolName: tool.name,
+            parameters,
+            reasoning
+        };
+    }
+    getServerConfig(serverName) {
+        const serverInfo = this.registry.getServerByName(serverName);
+        return serverInfo?.config;
+    }
+    getAllServers() {
+        return this.registry.getAllServers();
+    }
+}
+//# sourceMappingURL=tool-finder.js.map

package/dist/tool-finder.js.map

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

package/dist/tool-recommender.d.ts

@@ -0,0 +1,23 @@
+import { UserIntent } from "./intent-analyzer.js";
+import { MockToolDatabase, MCPTool } from "./mock-tool-database.js";
+export interface ToolRecommendation {
+    tool: MCPTool;
+    score: number;
+    rating: number;
+    reasoning: string;
+    usageInstructions: string[];
+    configurationSteps: string[];
+}
+export declare class ToolRecommendationEngine {
+    private toolDatabase;
+    constructor(toolDatabase: MockToolDatabase);
+    getRecommendations(intent: UserIntent): Promise<ToolRecommendation[]>;
+    private calculateRecommendationScore;
+    private hasRequiredData;
+    private calculateDisplayRating;
+    private generateReasoning;
+    private generateUsageInstructions;
+    private generateContextualExample;
+    private generateConfigurationSteps;
+}
+//# sourceMappingURL=tool-recommender.d.ts.map

package/dist/tool-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-recommender.d.ts","sourceRoot":"","sources":["../src/tool-recommender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,qBAAa,wBAAwB;IACvB,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,gBAAgB;IAE5C,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkC3E,OAAO,CAAC,4BAA4B;IAqDpC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,yBAAyB;IA8BjC,OAAO,CAAC,yBAAyB;IAwBjC,OAAO,CAAC,0BAA0B;CAoCnC"}