nitrostack 1.0.0

package/dist/core/server.js

@@ -0,0 +1,406 @@
+import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { createResource } from './resource.js';
+import { createLogger } from './logger.js';
+import { ToolExecutionError, ValidationError, ResourceNotFoundError } from './errors.js';
+import { v4 as uuidv4 } from 'uuid';
+import { isModule, getModuleMetadata } from './module.js';
+import { buildController } from './builders.js';
+/**
+ * NitroStackServer - Main server class
+ */
+export class NitroStackServer {
+    mcpServer;
+    tools = new Map();
+    resources = new Map();
+    prompts = new Map();
+    config;
+    logger;
+    stats = {
+        toolCalls: 0,
+        resourceReads: 0,
+        promptExecutions: 0,
+        errors: 0,
+    };
+    pendingComponentRegistrations = [];
+    constructor(config) {
+        this.config = config;
+        this.logger = createLogger({
+            level: config.logging?.level || 'info',
+            file: config.logging?.file,
+            serviceName: config.name,
+            enableConsole: false, // CRITICAL: Console disabled for MCP compatibility
+        });
+        this.mcpServer = new McpServer({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    /**
+     * Add a tool to the server
+     */
+    tool(tool) {
+        this.tools.set(tool.name, tool);
+        this.logger.info(`Tool registered: ${tool.name}`);
+        // Auto-register component if attached
+        if (tool.hasComponent()) {
+            const component = tool.getComponent();
+            // Track async component registration
+            const registration = this.registerComponentResource(component).catch(err => {
+                this.logger.error(`Failed to register component for tool ${tool.name}: ${err.message}`);
+            });
+            this.pendingComponentRegistrations.push(registration);
+            this.logger.info(`Component auto-registered for tool: ${tool.name} -> ${component.getResourceUri()}`);
+        }
+        return this;
+    }
+    /**
+     * Register a component as an MCP resource
+     */
+    async registerComponentResource(component) {
+        // Compile component
+        await component.compile();
+        // Create resource for component
+        const resource = createResource({
+            uri: component.getResourceUri(),
+            name: component.name,
+            description: component.description || `UI component for ${component.name}`,
+            mimeType: 'text/html',
+            handler: async (context) => {
+                context.logger.info(`Serving component: ${component.getResourceUri()}`);
+                return {
+                    type: 'text',
+                    data: component.getBundle(),
+                };
+            },
+        });
+        // Add resource metadata
+        const metadata = component.getResourceMetadata();
+        if (metadata && Object.keys(metadata).length > 0) {
+            resource.metadata = metadata;
+        }
+        // Register resource
+        this.resource(resource);
+    }
+    /**
+     * Add a resource to the server
+     */
+    resource(resource) {
+        this.resources.set(resource.uri, resource);
+        this.logger.info(`Resource registered: ${resource.uri}`);
+        return this;
+    }
+    /**
+     * Add a prompt to the server
+     */
+    prompt(prompt) {
+        this.prompts.set(prompt.name, prompt);
+        this.logger.info(`Prompt registered: ${prompt.name}`);
+        return this;
+    }
+    /**
+     * Register a module with all its controllers
+     * Automatically extracts and registers all tools, resources, and prompts
+     *
+     * @example
+     * ```typescript
+     * server.module(AuthModule);
+     * server.module(ProductsModule);
+     * ```
+     */
+    module(moduleClass) {
+        // Check if it's a module
+        if (!isModule(moduleClass)) {
+            throw new Error(`Class ${moduleClass.name} is not decorated with @Module. Use @Module decorator.`);
+        }
+        // Get module metadata
+        const metadata = getModuleMetadata(moduleClass);
+        if (!metadata) {
+            throw new Error(`Failed to get metadata for module ${moduleClass.name}`);
+        }
+        this.logger.info(`Registering module: ${metadata.name}`);
+        // Process all controllers in the module
+        const controllers = metadata.controllers || [];
+        for (const controller of controllers) {
+            this.logger.info(`  Processing controller: ${controller.name}`);
+            // Build all tools, resources, and prompts from controller
+            const { tools, resources, prompts } = buildController(controller);
+            // Register tools
+            tools.forEach(tool => {
+                this.tool(tool);
+                this.logger.info(`    ✓ Tool: ${tool.name}`);
+            });
+            // Register resources
+            resources.forEach(resource => {
+                this.resource(resource);
+                this.logger.info(`    ✓ Resource: ${resource.uri}`);
+            });
+            // Register prompts
+            prompts.forEach(prompt => {
+                this.prompt(prompt);
+                this.logger.info(`    ✓ Prompt: ${prompt.name}`);
+            });
+        }
+        this.logger.info(`Module registered: ${metadata.name} (${controllers.length} controller(s))`);
+        return this;
+    }
+    /**
+     * Get server statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Create execution context
+     */
+    createContext(metadata) {
+        return {
+            logger: this.logger,
+            requestId: uuidv4(),
+            metadata: metadata || {},
+        };
+    }
+    /**
+     * Setup MCP protocol handlers
+     */
+    setupHandlers() {
+        // List tools
+        this.mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
+            this.logger.debug('Listing tools');
+            const tools = await Promise.all(Array.from(this.tools.values()).map((tool) => tool.toMcpTool()));
+            return {
+                tools,
+            };
+        });
+        // Call tool
+        this.mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const tool = this.tools.get(name);
+            if (!tool) {
+                throw new ToolExecutionError(name, new Error('Tool not found'));
+            }
+            // Extract _meta from args if present and add to context metadata
+            const { _meta, ...toolArgs } = args || {};
+            const context = this.createContext(_meta);
+            try {
+                // Pass original args (including _meta) to tool
+                const result = await tool.execute(args, context);
+                this.stats.toolCalls++;
+                // Check if tool has a UI component
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+                // Add structured content if component is attached
+                if (tool.hasComponent()) {
+                    const component = tool.getComponent();
+                    const transformedData = await component.transformData(result, context);
+                    response.structuredContent = transformedData;
+                    context.logger.info(`Tool response includes structured content for component: ${component.id}`);
+                }
+                return response;
+            }
+            catch (error) {
+                this.stats.errors++;
+                context.logger.error(`Tool execution failed: ${name}`, error);
+                const formattedError = error instanceof ValidationError || error instanceof ToolExecutionError
+                    ? error
+                    : new ToolExecutionError(name, error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${formattedError.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // List resources
+        this.mcpServer.setRequestHandler(ListResourcesRequestSchema, async () => {
+            this.logger.debug('Listing resources');
+            return {
+                resources: Array.from(this.resources.values()).map((resource) => resource.toMcpResource()),
+            };
+        });
+        // Read resource
+        this.mcpServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            const resource = this.resources.get(uri);
+            if (!resource) {
+                throw new ResourceNotFoundError(uri);
+            }
+            const context = this.createContext();
+            try {
+                const content = await resource.fetch(context);
+                let responseContent;
+                switch (content.type) {
+                    case 'text':
+                        responseContent = {
+                            uri: uri,
+                            mimeType: resource.mimeType || 'text/plain',
+                            text: content.data,
+                        };
+                        break;
+                    case 'binary':
+                        responseContent = {
+                            uri: uri,
+                            mimeType: resource.mimeType || 'application/octet-stream',
+                            blob: content.data.toString('base64'),
+                        };
+                        break;
+                    case 'json':
+                        responseContent = {
+                            uri: uri,
+                            mimeType: resource.mimeType || 'application/json',
+                            text: JSON.stringify(content.data, null, 2),
+                        };
+                        break;
+                }
+                this.stats.resourceReads++;
+                return {
+                    contents: [responseContent],
+                };
+            }
+            catch (error) {
+                context.logger.error(`Resource fetch failed: ${uri}`, error);
+                throw error;
+            }
+        });
+        // List prompts
+        this.mcpServer.setRequestHandler(ListPromptsRequestSchema, async () => {
+            this.logger.debug('Listing prompts');
+            return {
+                prompts: Array.from(this.prompts.values()).map((prompt) => prompt.toMcpPrompt()),
+            };
+        });
+        // Get prompt
+        this.mcpServer.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const prompt = this.prompts.get(name);
+            if (!prompt) {
+                throw new Error(`Prompt not found: ${name}`);
+            }
+            const context = this.createContext();
+            try {
+                const result = await prompt.execute(args || {}, context);
+                this.stats.promptExecutions++;
+                // Transform messages to MCP protocol format
+                // MCP expects content to be an object with type and text, not a plain string
+                const messages = result.map((msg) => ({
+                    role: msg.role,
+                    content: {
+                        type: 'text',
+                        text: msg.content,
+                    },
+                }));
+                return {
+                    description: prompt.description,
+                    messages,
+                };
+            }
+            catch (error) {
+                this.stats.errors++;
+                context.logger.error(`Prompt execution failed: ${name}`, error);
+                throw error;
+            }
+        });
+        // Error handler
+        this.mcpServer.onerror = (error) => {
+            this.logger.error('MCP Server error', error);
+            this.stats.errors++;
+        };
+    }
+    /**
+     * Start the server with specified transport
+     * @param transportType - 'stdio', 'http', or 'dual' (default: 'stdio')
+     * @param transportOptions - Transport-specific options
+     */
+    async start(transportType = 'stdio', transportOptions) {
+        try {
+            // Wait for all component registrations to complete
+            if (this.pendingComponentRegistrations.length > 0) {
+                this.logger.info(`Waiting for ${this.pendingComponentRegistrations.length} component(s) to compile...`);
+                await Promise.all(this.pendingComponentRegistrations);
+                this.pendingComponentRegistrations = []; // Clear after completion
+                this.logger.info('All components compiled and registered');
+            }
+            if (transportType === 'dual') {
+                // DUAL transport: STDIO for MCP + HTTP for OAuth metadata
+                // This is the recommended mode for OAuth 2.1 servers
+                // 1. Start HTTP server for OAuth metadata (non-blocking)
+                const { HttpServerTransport } = await import('./transports/http-server.js');
+                const httpTransport = new HttpServerTransport(transportOptions);
+                await httpTransport.start();
+                // Store HTTP transport reference for later cleanup
+                this._httpTransport = httpTransport;
+                // 2. Connect MCP server via STDIO for protocol communication
+                const stdioTransport = new StdioServerTransport();
+                await this.mcpServer.connect(stdioTransport);
+                this.logger.info(`${this.config.name} started successfully (DUAL: STDIO + HTTP)`);
+                this.logger.info(`📡 MCP Protocol: STDIO (for Studio/Claude)`);
+                this.logger.info(`🌐 OAuth Metadata: HTTP (port ${transportOptions?.port || 3000})`);
+            }
+            else if (transportType === 'http') {
+                // HTTP-only transport (for pure HTTP MCP servers)
+                const { HttpServerTransport } = await import('./transports/http-server.js');
+                const transport = new HttpServerTransport(transportOptions);
+                // Start HTTP server first
+                await transport.start();
+                // Then connect MCP server
+                await this.mcpServer.connect(transport);
+                this.logger.info(`${this.config.name} started successfully (HTTP transport)`);
+            }
+            else {
+                // STDIO-only transport (default, no OAuth)
+                const transport = new StdioServerTransport();
+                await this.mcpServer.connect(transport);
+                this.logger.info(`${this.config.name} started successfully (STDIO transport)`);
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to start server', error);
+            throw error;
+        }
+    }
+    /**
+     * Stop the server
+     */
+    async stop() {
+        try {
+            // Close HTTP transport if running in dual mode
+            const httpTransport = this._httpTransport;
+            if (httpTransport) {
+                await httpTransport.close();
+                this._httpTransport = null;
+            }
+            // Close MCP server
+            await this.mcpServer.close();
+            this.logger.info('Server stopped');
+        }
+        catch (error) {
+            this.logger.error('Error stopping server', error);
+            throw error;
+        }
+    }
+}
+/**
+ * Helper function to create a server
+ */
+export function createServer(config) {
+    return new NitroStackServer(config);
+}
+//# sourceMappingURL=server.js.map

package/dist/core/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAY,cAAc,EAAE,MAAM,eAAe,CAAC;AASzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAgB,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAY;IACrB,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IACrC,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAC7C,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IACzC,MAAM,CAAkB;IACxB,MAAM,CAAS;IACf,KAAK,GAAgB;QAC3B,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,CAAC;QACnB,MAAM,EAAE,CAAC;KACV,CAAC;IACM,6BAA6B,GAAoB,EAAE,CAAC;IAE5D,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;YACzB,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,MAAM;YACtC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;YAC1B,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,aAAa,EAAE,KAAK,EAAE,mDAAmD;SAC1E,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAC5B;YACE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,EAAE;aACZ;SACF,CACF,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAU;QACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAElD,sCAAsC;QACtC,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAG,CAAC;YACvC,qCAAqC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;gBACzE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1F,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,IAAI,CAAC,IAAI,OAAO,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,yBAAyB,CAAC,SAAoB;QAC1D,oBAAoB;QACpB,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;QAE1B,gCAAgC;QAChC,MAAM,QAAQ,GAAG,cAAc,CAAC;YAC9B,GAAG,EAAE,SAAS,CAAC,cAAc,EAAE;YAC/B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,oBAAoB,SAAS,CAAC,IAAI,EAAE;YAC1E,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;gBACxE,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE;iBAC5B,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,QAAQ,GAAG,SAAS,CAAC,mBAAmB,EAAE,CAAC;QACjD,IAAI,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,QAAgB,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxC,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAkB;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAgB;QACrB,yBAAyB;QACzB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,WAAW,CAAC,IAAI,wDAAwD,CAAC,CAAC;QACrG,CAAC;QAED,sBAAsB;QACtB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzD,wCAAwC;QACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;QAE/C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YAEhE,0DAA0D;YAC1D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAElE,iBAAiB;YACjB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YAEH,qBAAqB;YACrB,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YAEH,mBAAmB;YACnB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM,iBAAiB,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAGD;;OAEG;IACH,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAA8B;QAClD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,MAAM,EAAE;YACnB,QAAQ,EAAE,QAAQ,IAAI,EAAE;SACzB,CAAC;IACJ,CAAC;IAGD;;OAEG;IACK,aAAa;QACnB,aAAa;QACb,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAClE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAChE,CAAC;YACF,OAAO;gBACL,KAAK;aACN,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,YAAY;QACZ,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAClE,CAAC;YAED,iEAAiE;YACjE,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAwC,CAAC,CAAC;YAE7E,IAAI,CAAC;gBACH,+CAA+C;gBAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAEjD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBAEvB,mCAAmC;gBACnC,MAAM,QAAQ,GAAQ;oBACpB,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBAC5E;qBACF;iBACF,CAAC;gBAEF,kDAAkD;gBAClD,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAG,CAAC;oBACvC,MAAM,eAAe,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBACvE,QAAQ,CAAC,iBAAiB,GAAG,eAAe,CAAC;oBAC7C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,4DAA4D,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClG,CAAC;gBAED,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;gBAE9D,MAAM,cAAc,GAAG,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,kBAAkB;oBAC5F,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,EAAE,KAAc,CAAC,CAAC;gBAEjD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,UAAU,cAAc,CAAC,OAAO,EAAE;yBACzC;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACtE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC9D,QAAQ,CAAC,aAAa,EAAE,CACzB;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC5E,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAErC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAE9C,IAAI,eAAoB,CAAC;gBAEzB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,MAAM;wBACT,eAAe,GAAG;4BAChB,GAAG,EAAE,GAAG;4BACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,YAAY;4BAC3C,IAAI,EAAE,OAAO,CAAC,IAAI;yBACnB,CAAC;wBACF,MAAM;oBACR,KAAK,QAAQ;wBACX,eAAe,GAAG;4BAChB,GAAG,EAAE,GAAG;4BACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,0BAA0B;4BACzD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;yBACtC,CAAC;wBACF,MAAM;oBACR,KAAK,MAAM;wBACT,eAAe,GAAG;4BAChB,GAAG,EAAE,GAAG;4BACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,kBAAkB;4BACjD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;yBAC5C,CAAC;wBACF,MAAM;gBACV,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;gBAE3B,OAAO;oBACL,QAAQ,EAAE,CAAC,eAAe,CAAC;iBAC5B,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC7D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,eAAe;QACf,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACpE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACxD,MAAM,CAAC,WAAW,EAAE,CACrB;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,aAAa;QACb,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAErC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;gBAEzD,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBAE9B,4CAA4C;gBAC5C,6EAA6E;gBAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBACpC,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,GAAG,CAAC,OAAO;qBAClB;iBACF,CAAC,CAAC,CAAC;gBAEJ,OAAO;oBACL,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,QAAQ;iBACT,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,gBAA2C,OAAO,EAAE,gBAAsB;QACpF,IAAI,CAAC;YACH,mDAAmD;YACnD,IAAI,IAAI,CAAC,6BAA6B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,6BAA6B,CAAC,MAAM,6BAA6B,CAAC,CAAC;gBACxG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBACtD,IAAI,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC,yBAAyB;gBAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;gBAC7B,0DAA0D;gBAC1D,qDAAqD;gBAErD,yDAAyD;gBACzD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBAC5E,MAAM,aAAa,GAAG,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;gBAChE,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC;gBAE5B,mDAAmD;gBAClD,IAAY,CAAC,cAAc,GAAG,aAAa,CAAC;gBAE7C,6DAA6D;gBAC7D,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;gBAClD,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBAE7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,4CAA4C,CAAC,CAAC;gBAClF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;gBAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,gBAAgB,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;YAEvF,CAAC;iBAAM,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;gBACpC,kDAAkD;gBAClD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBAC5E,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;gBAE5D,0BAA0B;gBAC1B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;gBAExB,0BAA0B;gBAC1B,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAExC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,wCAAwC,CAAC,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACN,2CAA2C;gBAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;gBAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAExC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,yCAAyC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,aAAa,GAAI,IAAY,CAAC,cAAc,CAAC;YACnD,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC;gBAC3B,IAAY,CAAC,cAAc,GAAG,IAAI,CAAC;YACtC,CAAC;YAED,mBAAmB;YACnB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/core/tool.d.ts

@@ -0,0 +1,78 @@
+import { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import { Component } from './component.js';
+import { ExecutionContext } from './types.js';
+import { GuardConstructor } from './guards/guard.interface.js';
+import { MiddlewareConstructor } from './middleware/middleware.interface.js';
+import { InterceptorConstructor } from './interceptors/interceptor.interface.js';
+import { PipeConstructor } from './pipes/pipe.interface.js';
+import { ExceptionFilterConstructor } from './filters/exception-filter.interface.js';
+export interface ToolOptions {
+    name: string;
+    description: string;
+    inputSchema: any;
+    handler: (input: any, context: ExecutionContext) => Promise<any>;
+    guards?: GuardConstructor[];
+    middlewares?: MiddlewareConstructor[];
+    interceptors?: InterceptorConstructor[];
+    pipes?: PipeConstructor[];
+    filters?: ExceptionFilterConstructor[];
+    examples?: {
+        request?: any;
+        response?: any;
+    };
+    widget?: {
+        route: string;
+    };
+    outputTemplate?: string;
+}
+export declare class Tool {
+    name: string;
+    description: string;
+    inputSchema: any;
+    examples?: {
+        request?: any;
+        response?: any;
+    };
+    widget?: {
+        route: string;
+    };
+    outputTemplate?: string;
+    private handler;
+    private guards;
+    private middlewares;
+    private interceptors;
+    private pipes;
+    private filters;
+    private component?;
+    constructor(options: ToolOptions);
+    /**
+     * Execute the tool with full pipeline:
+     * Exception Filters -> Guards -> Middleware -> Interceptors -> Pipes -> Handler
+     */
+    execute(input: any, context: ExecutionContext): Promise<any>;
+    /**
+     * Execute with interceptor chain
+     */
+    private executeWithInterceptors;
+    /**
+     * Execute pipes and then the handler
+     */
+    private executeWithPipes;
+    /**
+     * Attach a UI component to this tool
+     */
+    setComponent(component: Component): void;
+    /**
+     * Check if tool has a component
+     */
+    hasComponent(): boolean;
+    /**
+     * Get the attached component
+     */
+    getComponent(): Component | undefined;
+    /**
+     * Convert to MCP tool format
+     */
+    toMcpTool(): Promise<McpTool>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/core/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/core/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAS,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAuB,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAwB,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACvG,OAAO,EAAiB,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAA4B,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAG/G,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,IAAI;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,OAAO,CAA0D;IACzE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAY;gBAElB,OAAO,EAAE,WAAW;IAehC;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAuDlE;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI,SAAS,GAAG,SAAS;IAIrC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CA8DpC"}