sub-agents-mcp 0.1.2

package/dist/resources/AgentResources.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * AgentResources implementation for publishing agent definitions via MCP
+ *
+ * Provides MCP resources for agent discovery including a list of all
+ * available agents and individual agent definition resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResources = void 0;
+const Logger_1 = require("../utils/Logger");
+/**
+ * AgentResources class for managing agent definition resources in MCP
+ *
+ * Publishes agent information as MCP resources that clients can discover
+ * and read to understand available agents and their capabilities.
+ */
+class AgentResources {
+    constructor(agentManager) {
+        this.agentManager = agentManager;
+        this.logger = new Logger_1.Logger('info');
+    }
+    /**
+     * Get list of all published agent resources
+     *
+     * @returns Promise resolving to array of MCP resource definitions
+     */
+    async listResources() {
+        const startTime = Date.now();
+        this.logger.debug('Starting resource listing', {
+            timestamp: new Date().toISOString(),
+        });
+        const resources = [];
+        // Add agent list resource
+        resources.push({
+            uri: 'agents://list',
+            name: 'Agent List',
+            description: 'List of available Claude Code sub-agents',
+            mimeType: 'text/plain',
+        });
+        // Add individual agent resources if agent manager is available
+        if (this.agentManager) {
+            try {
+                const agents = await this.agentManager.listAgents();
+                this.logger.debug('Agents loaded for resource listing', {
+                    agentCount: agents.length,
+                    loadTime: Date.now() - startTime,
+                });
+                for (const agent of agents) {
+                    resources.push({
+                        uri: `agents://${agent.name}`,
+                        name: `Agent: ${agent.name}`,
+                        description: agent.description || 'Agent definition',
+                        mimeType: 'text/markdown',
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error('Failed to load agents for resource listing', error instanceof Error ? error : undefined, {
+                    loadTime: Date.now() - startTime,
+                });
+                // If we can't load agents, just return the list resource
+            }
+        }
+        else {
+            this.logger.warn('Agent manager not available for resource listing');
+        }
+        this.logger.info('Resource listing completed', {
+            resourceCount: resources.length,
+            totalTime: Date.now() - startTime,
+        });
+        return resources;
+    }
+    /**
+     * Read content of a specific agent resource
+     *
+     * @param uri - Resource URI to read
+     * @returns Promise resolving to resource content
+     * @throws {Error} When resource URI is invalid or not found
+     */
+    async readResource(uri) {
+        const startTime = Date.now();
+        const requestId = this.generateRequestId();
+        this.logger.info('Resource read requested', {
+            requestId,
+            uri,
+            timestamp: new Date().toISOString(),
+        });
+        try {
+            let result;
+            if (uri === 'agents://list') {
+                result = await this.getAgentListContent();
+            }
+            else {
+                // Check for individual agent resource
+                const agentNameMatch = uri.match(/^agents:\/\/(.+)$/);
+                if (agentNameMatch?.[1]) {
+                    const agentName = agentNameMatch[1];
+                    result = await this.getAgentContent(agentName);
+                }
+                else {
+                    throw new Error(`Invalid resource URI format: ${uri}`);
+                }
+            }
+            this.logger.info('Resource read completed', {
+                requestId,
+                uri,
+                readTime: Date.now() - startTime,
+                contentLength: result.contents[0]?.text?.length || 0,
+            });
+            return result;
+        }
+        catch (error) {
+            this.logger.error('Resource read failed', error instanceof Error ? error : undefined, {
+                requestId,
+                uri,
+                readTime: Date.now() - startTime,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get content for the agent list resource
+     *
+     * @private
+     * @returns Promise resolving to agent list content
+     */
+    async getAgentListContent() {
+        if (!this.agentManager) {
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: 'Agent manager not available. No agents can be listed.',
+                        uri: 'agents://list',
+                    },
+                ],
+            };
+        }
+        try {
+            const agents = await this.agentManager.listAgents();
+            if (agents.length === 0) {
+                return {
+                    contents: [
+                        {
+                            type: 'text',
+                            text: 'No agents available. Check agent directory configuration.',
+                            uri: 'agents://list',
+                        },
+                    ],
+                };
+            }
+            let listText = `Available Claude Code Sub-Agents (${agents.length} total):\n\n`;
+            for (const agent of agents) {
+                listText += `## ${agent.name}\n`;
+                listText += `**Description:** ${agent.description}\n`;
+                listText += `**File:** ${agent.filePath}\n`;
+                listText += `**Last Modified:** ${agent.lastModified.toISOString()}\n`;
+                listText += `**Resource URI:** agents://${agent.name}\n\n`;
+            }
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: listText,
+                        uri: 'agents://list',
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: `Error loading agent list: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        uri: 'agents://list',
+                    },
+                ],
+            };
+        }
+    }
+    /**
+     * Get content for a specific agent resource
+     *
+     * @private
+     * @param agentName - Name of the agent to get content for
+     * @returns Promise resolving to agent content
+     */
+    async getAgentContent(agentName) {
+        if (!this.agentManager) {
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: 'Agent manager not available. Agent content cannot be retrieved.',
+                        uri: `agents://${agentName}`,
+                    },
+                ],
+            };
+        }
+        try {
+            const agent = await this.agentManager.getAgent(agentName);
+            if (!agent) {
+                const availableAgents = await this.getAvailableAgentNames();
+                let errorText = `Agent '${agentName}' not found.`;
+                if (availableAgents.length > 0) {
+                    errorText += `\n\nAvailable agents:\n${availableAgents.map((name) => `- ${name}`).join('\n')}`;
+                }
+                return {
+                    contents: [
+                        {
+                            type: 'text',
+                            text: errorText,
+                            uri: `agents://${agentName}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: this.formatAgentContent(agent),
+                        uri: `agents://${agentName}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        type: 'text',
+                        text: `Error loading agent '${agentName}': ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        uri: `agents://${agentName}`,
+                    },
+                ],
+            };
+        }
+    }
+    /**
+     * Format agent definition content for display
+     *
+     * @private
+     * @param agent - Agent definition to format
+     * @returns Formatted content string
+     */
+    formatAgentContent(agent) {
+        let content = `# Agent: ${agent.name}\n\n`;
+        content += `**Description:** ${agent.description}\n`;
+        content += `**File Path:** ${agent.filePath}\n`;
+        content += `**Last Modified:** ${agent.lastModified.toISOString()}\n`;
+        content += `**Content Length:** ${agent.content.length} characters\n\n`;
+        content += '## Agent Definition\n\n';
+        content += agent.content;
+        return content;
+    }
+    /**
+     * Get list of available agent names
+     *
+     * @private
+     * @returns Promise resolving to array of agent names
+     */
+    async getAvailableAgentNames() {
+        if (!this.agentManager) {
+            return [];
+        }
+        try {
+            const agents = await this.agentManager.listAgents();
+            return agents.map((agent) => agent.name);
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Generate unique request ID for tracking
+     *
+     * @private
+     * @returns Unique request identifier
+     */
+    generateRequestId() {
+        return `resource_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Check if a resource URI is valid with enhanced validation
+     *
+     * @param uri - Resource URI to validate
+     * @returns True if URI is valid
+     */
+    isValidResourceUri(uri) {
+        if (!uri || typeof uri !== 'string') {
+            return false;
+        }
+        if (uri === 'agents://list') {
+            return true;
+        }
+        const agentNameMatch = uri.match(/^agents:\/\/(.+)$/);
+        if (!agentNameMatch || !agentNameMatch[1]) {
+            return false;
+        }
+        const agentName = agentNameMatch[1];
+        // Validate agent name format
+        if (agentName.length === 0 || agentName.length > 100) {
+            return false;
+        }
+        // Check for valid characters (same as RunAgentTool validation)
+        if (!/^[a-zA-Z0-9_-]+$/.test(agentName)) {
+            return false;
+        }
+        return true;
+    }
+}
+exports.AgentResources = AgentResources;
+//# sourceMappingURL=AgentResources.js.map

package/dist/resources/AgentResources.js.map

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

package/dist/server/McpServer.d.ts

@@ -0,0 +1,138 @@
+/**
+ * MCP Server implementation using @modelcontextprotocol/sdk
+ *
+ * Provides the foundational MCP server functionality with StdioServerTransport
+ * for stdin/stdout communication. This class serves as the entry point for
+ * the MCP server and handles basic server lifecycle operations.
+ *
+ * @example
+ * ```typescript
+ * const config = await ServerConfig.fromEnvironment()
+ * const server = new McpServer(config)
+ * await server.start()
+ * ```
+ */
+import type { ServerConfig } from '../config/ServerConfig';
+/**
+ * Server information interface for MCP server identification
+ */
+interface ServerInfo {
+    name: string;
+    version: string;
+}
+/**
+ * MCP Server class providing foundational server functionality
+ */
+export declare class McpServer {
+    private server;
+    private transport;
+    private config;
+    private agentManager;
+    private agentExecutor;
+    private runAgentTool;
+    private agentResources;
+    /**
+     * Create a new MCP server instance
+     * @param config Server configuration object
+     * @throws {Error} When server name is empty
+     */
+    constructor(config: ServerConfig);
+    /**
+     * Validate server configuration
+     * @param config Configuration to validate
+     * @throws {Error} When configuration is invalid
+     */
+    private validateConfig;
+    /**
+     * Log message with structured format
+     * @param level Log level
+     * @param message Log message
+     * @param metadata Additional metadata
+     */
+    private log;
+    /**
+     * Setup StdioServerTransport for MCP communication
+     */
+    private setupTransport;
+    /**
+     * Setup MCP protocol handlers with performance monitoring
+     */
+    private setupHandlers;
+    /**
+     * Get server information
+     * @returns Server name and version
+     */
+    getServerInfo(): ServerInfo;
+    /**
+     * Check if transport is configured
+     * @returns True if transport is available
+     */
+    hasTransport(): boolean;
+    /**
+     * Check if server is ready to start
+     * @returns True if server is ready
+     */
+    isReady(): boolean;
+    /**
+     * Start the MCP server
+     * @throws {Error} When server is not ready or transport setup fails
+     */
+    start(): Promise<void>;
+    /**
+     * List available tools (for testing)
+     * @returns Promise resolving to array of tool definitions
+     */
+    listTools(): Promise<Array<{
+        name: string;
+        description: string;
+        inputSchema: unknown;
+    }>>;
+    /**
+     * List available resources (for testing)
+     * @returns Promise resolving to array of resource definitions
+     */
+    listResources(): Promise<Array<{
+        uri: string;
+        name: string;
+        description: string;
+    }>>;
+    /**
+     * Call a tool (for testing)
+     * @param toolName - Name of the tool to call
+     * @param params - Tool parameters
+     * @returns Promise resolving to tool response
+     */
+    callTool(toolName: string, params: unknown): Promise<unknown>;
+    /**
+     * Read a resource (for testing)
+     * @param uri - Resource URI to read
+     * @returns Promise resolving to resource content
+     */
+    readResource(uri: string): Promise<unknown>;
+    /**
+     * Get server performance statistics
+     *
+     * @returns Performance and usage statistics
+     */
+    getServerStats(): {
+        serverInfo: {
+            name: string;
+            version: string;
+        };
+        executionStats: Map<string, {
+            count: number;
+            totalTime: number;
+            lastUsed: Date;
+        }>;
+    };
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Close the server and cleanup resources
+     */
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/server/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAO3D;;GAEG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAOD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAgB;IAEtC;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IA+ChC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAqBX;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuIrB;;;OAGG;IACH,aAAa,IAAI,UAAU;IAO3B;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAU9F;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IASzF;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnE;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjD;;;;OAIG;IACH,cAAc,IAAI;QAChB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QAC7C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAClF;IAOD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7B"}