@vfarcic/dot-ai 0.1.0

package/dist/interfaces/mcp.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Model Context Protocol (MCP) Interface for DevOps AI Toolkit
+ *
+ * Provides MCP server capabilities that expose DevOps AI Toolkit functionality
+ * to AI assistants like Claude through standardized protocol
+ */
+import { DotAI } from '../core/index';
+export interface MCPServerConfig {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+}
+export declare class MCPServer {
+    private server;
+    private dotAI;
+    private initialized;
+    private logger;
+    private requestIdCounter;
+    constructor(dotAI: DotAI, config: MCPServerConfig);
+    /**
+     * Register all tools with McpServer
+     */
+    private registerTools;
+    private generateRequestId;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isReady(): boolean;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/interfaces/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAoCtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IA2BjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAyErB,OAAO,CAAC,iBAAiB;IAKnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO;CAGnB"}

package/dist/interfaces/mcp.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Model Context Protocol (MCP) Interface for DevOps AI Toolkit
+ *
+ * Provides MCP server capabilities that expose DevOps AI Toolkit functionality
+ * to AI assistants like Claude through standardized protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPServer = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const error_handling_1 = require("../core/error-handling");
+const recommend_1 = require("../tools/recommend");
+const choose_solution_1 = require("../tools/choose-solution");
+const answer_question_1 = require("../tools/answer-question");
+const generate_manifests_1 = require("../tools/generate-manifests");
+const deploy_manifests_1 = require("../tools/deploy-manifests");
+class MCPServer {
+    server;
+    dotAI;
+    initialized = false;
+    logger;
+    requestIdCounter = 0;
+    constructor(dotAI, config) {
+        this.dotAI = dotAI;
+        this.logger = new error_handling_1.ConsoleLogger('MCPServer');
+        // Create McpServer instance
+        this.server = new mcp_js_1.McpServer({
+            name: config.name,
+            version: config.version
+        }, {
+            capabilities: {
+                tools: {}
+            }
+        });
+        this.logger.info('Initializing MCP Server', {
+            name: config.name,
+            version: config.version,
+            author: config.author
+        });
+        // Register all tools directly with McpServer
+        this.registerTools();
+    }
+    /**
+     * Register all tools with McpServer
+     */
+    registerTools() {
+        // Register recommend tool
+        this.server.tool(recommend_1.RECOMMEND_TOOL_NAME, recommend_1.RECOMMEND_TOOL_DESCRIPTION, recommend_1.RECOMMEND_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${recommend_1.RECOMMEND_TOOL_NAME} tool request`, { requestId });
+            return await (0, recommend_1.handleRecommendTool)(args, this.dotAI, this.logger, requestId);
+        });
+        // Register chooseSolution tool
+        this.server.tool(choose_solution_1.CHOOSESOLUTION_TOOL_NAME, choose_solution_1.CHOOSESOLUTION_TOOL_DESCRIPTION, choose_solution_1.CHOOSESOLUTION_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${choose_solution_1.CHOOSESOLUTION_TOOL_NAME} tool request`, { requestId });
+            return await (0, choose_solution_1.handleChooseSolutionTool)(args, this.dotAI, this.logger, requestId);
+        });
+        // Register answerQuestion tool
+        this.server.tool(answer_question_1.ANSWERQUESTION_TOOL_NAME, answer_question_1.ANSWERQUESTION_TOOL_DESCRIPTION, answer_question_1.ANSWERQUESTION_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${answer_question_1.ANSWERQUESTION_TOOL_NAME} tool request`, { requestId });
+            return await (0, answer_question_1.handleAnswerQuestionTool)(args, this.dotAI, this.logger, requestId);
+        });
+        // Register generateManifests tool
+        this.server.tool(generate_manifests_1.GENERATEMANIFESTS_TOOL_NAME, generate_manifests_1.GENERATEMANIFESTS_TOOL_DESCRIPTION, generate_manifests_1.GENERATEMANIFESTS_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${generate_manifests_1.GENERATEMANIFESTS_TOOL_NAME} tool request`, { requestId });
+            return await (0, generate_manifests_1.handleGenerateManifestsTool)(args, this.dotAI, this.logger, requestId);
+        });
+        // Register deployManifests tool
+        this.server.tool(deploy_manifests_1.DEPLOYMANIFESTS_TOOL_NAME, deploy_manifests_1.DEPLOYMANIFESTS_TOOL_DESCRIPTION, deploy_manifests_1.DEPLOYMANIFESTS_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${deploy_manifests_1.DEPLOYMANIFESTS_TOOL_NAME} tool request`, { requestId });
+            return await (0, deploy_manifests_1.handleDeployManifestsTool)(args, this.dotAI, this.logger, requestId);
+        });
+        this.logger.info('Registered all tools with McpServer', {
+            tools: [
+                recommend_1.RECOMMEND_TOOL_NAME,
+                choose_solution_1.CHOOSESOLUTION_TOOL_NAME,
+                answer_question_1.ANSWERQUESTION_TOOL_NAME,
+                generate_manifests_1.GENERATEMANIFESTS_TOOL_NAME,
+                deploy_manifests_1.DEPLOYMANIFESTS_TOOL_NAME
+            ],
+            totalTools: 5
+        });
+    }
+    generateRequestId() {
+        return `mcp_${Date.now()}_${++this.requestIdCounter}`;
+    }
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        this.initialized = true;
+    }
+    async stop() {
+        await this.server.close();
+        this.initialized = false;
+    }
+    isReady() {
+        return this.initialized;
+    }
+}
+exports.MCPServer = MCPServer;

package/dist/mcp/server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * MCP Server Entry Point for DevOps AI Toolkit
+ *
+ * This server exposes DevOps AI Toolkit functionality through the Model Context Protocol,
+ * enabling AI assistants like Claude Code to interact with Kubernetes deployment capabilities.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/mcp/server.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MCP Server Entry Point for DevOps AI Toolkit
+ *
+ * This server exposes DevOps AI Toolkit functionality through the Model Context Protocol,
+ * enabling AI assistants like Claude Code to interact with Kubernetes deployment capabilities.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("../interfaces/mcp.js");
+const index_js_1 = require("../core/index.js");
+async function main() {
+    try {
+        // Validate required environment variables
+        process.stderr.write('Validating MCP server configuration...\n');
+        // Check session directory configuration
+        const sessionDir = process.env.DOT_AI_SESSION_DIR;
+        if (!sessionDir) {
+            process.stderr.write('FATAL: DOT_AI_SESSION_DIR environment variable is required\n');
+            process.stderr.write('Configuration:\n');
+            process.stderr.write('- Set DOT_AI_SESSION_DIR in .mcp.json env section\n');
+            process.stderr.write('- Example: "DOT_AI_SESSION_DIR": "/tmp/dot-ai-sessions"\n');
+            process.stderr.write('- Ensure the directory exists and is writable\n');
+            process.exit(1);
+        }
+        // Validate session directory exists and is writable
+        try {
+            const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+            const path = await Promise.resolve().then(() => __importStar(require('path')));
+            // Check if directory exists
+            if (!fs.existsSync(sessionDir)) {
+                process.stderr.write(`FATAL: Session directory does not exist: ${sessionDir}\n`);
+                process.stderr.write('Solution: Create the directory or update DOT_AI_SESSION_DIR\n');
+                process.exit(1);
+            }
+            // Check if it's actually a directory
+            const stat = fs.statSync(sessionDir);
+            if (!stat.isDirectory()) {
+                process.stderr.write(`FATAL: Session directory path is not a directory: ${sessionDir}\n`);
+                process.stderr.write('Solution: Use a valid directory path in DOT_AI_SESSION_DIR\n');
+                process.exit(1);
+            }
+            // Test write permissions
+            const testFile = path.join(sessionDir, '.mcp-test-write');
+            try {
+                fs.writeFileSync(testFile, 'test');
+                fs.unlinkSync(testFile);
+                process.stderr.write(`Session directory validated: ${sessionDir}\n`);
+            }
+            catch (writeError) {
+                process.stderr.write(`FATAL: Session directory is not writable: ${sessionDir}\n`);
+                process.stderr.write('Solution: Fix directory permissions or use a different directory\n');
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            process.stderr.write(`FATAL: Session directory validation failed: ${error}\n`);
+            process.exit(1);
+        }
+        // Initialize DotAI - it will read KUBECONFIG and ANTHROPIC_API_KEY from environment
+        const dotAI = new index_js_1.DotAI();
+        // Test cluster connectivity immediately on startup
+        process.stderr.write('Testing cluster connectivity...\n');
+        try {
+            await dotAI.initialize();
+            await dotAI.discovery.connect();
+            process.stderr.write('Cluster connectivity verified successfully\n');
+        }
+        catch (connectError) {
+            process.stderr.write(`FATAL: Failed to connect to Kubernetes cluster: ${connectError}\n`);
+            process.stderr.write('Troubleshooting:\n');
+            process.stderr.write('- Check KUBECONFIG environment variable\n');
+            process.stderr.write('- Verify cluster is running: kubectl cluster-info\n');
+            process.stderr.write('- Test kubectl connectivity: kubectl get nodes\n');
+            process.exit(1);
+        }
+        // Create and configure MCP server
+        const mcpServer = new mcp_js_1.MCPServer(dotAI, {
+            name: 'dot-ai',
+            version: '0.1.0',
+            description: 'Universal Kubernetes application deployment agent with AI-powered orchestration',
+            author: 'Viktor Farcic'
+        });
+        // Start the MCP server
+        process.stderr.write('Starting DevOps AI Toolkit MCP server...\n');
+        await mcpServer.start();
+        process.stderr.write('DevOps AI Toolkit MCP server started successfully\n');
+        // Handle graceful shutdown
+        process.on('SIGINT', async () => {
+            process.stderr.write('Shutting down DevOps AI Toolkit MCP server...\n');
+            await mcpServer.stop();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            process.stderr.write('Shutting down DevOps AI Toolkit MCP server...\n');
+            await mcpServer.stop();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        process.stderr.write(`Failed to start DevOps AI Toolkit MCP server: ${error}\n`);
+        process.exit(1);
+    }
+}
+// Handle uncaught exceptions
+process.on('uncaughtException', (error) => {
+    process.stderr.write(`Uncaught exception in MCP server: ${error}\n`);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    process.stderr.write(`Unhandled rejection in MCP server: ${reason}\n`);
+    process.exit(1);
+});
+// Start the server
+main().catch((error) => {
+    process.stderr.write(`Fatal error starting MCP server: ${error}\n`);
+    process.exit(1);
+});

package/dist/tools/answer-question.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Answer Question Tool - Process user answers and return remaining questions
+ */
+import { z } from 'zod';
+import { DotAI } from '../core/index';
+import { Logger } from '../core/error-handling';
+export declare const ANSWERQUESTION_TOOL_NAME = "answerQuestion";
+export declare const ANSWERQUESTION_TOOL_DESCRIPTION = "Process user answers and return remaining questions or completion status";
+export declare const ANSWERQUESTION_TOOL_INPUT_SCHEMA: {
+    solutionId: z.ZodString;
+    stage: z.ZodEnum<["required", "basic", "advanced", "open"]>;
+    answers: z.ZodRecord<z.ZodString, z.ZodAny>;
+};
+/**
+ * Direct MCP tool handler for answerQuestion functionality
+ */
+export declare function handleAnswerQuestionTool(args: {
+    solutionId: string;
+    stage: 'required' | 'basic' | 'advanced' | 'open';
+    answers: Record<string, any>;
+}, dotAI: DotAI, logger: Logger, requestId: string): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=answer-question.d.ts.map

package/dist/tools/answer-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-question.d.ts","sourceRoot":"","sources":["../../src/tools/answer-question.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMhD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,+BAA+B,6EAA6E,CAAC;AAG1H,eAAO,MAAM,gCAAgC;;;;CAI5C,CAAC;AAodF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EAC7G,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAmTxD"}