@siemens/ix-mcp-angular 4.0.0-v.1.7.0

package/dist/src/index.js

@@ -0,0 +1,342 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { EmbeddingService } from './embeddings.js';
+import { DatabaseHandler } from './db-handler.js';
+import { loadConfig } from './config.js';
+import { ObservabilityLogger } from './logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const config = loadConfig();
+const buildSearchConfigs = () => {
+    const configs = {
+        [config.searchToolName]: {
+            type: 'documentation',
+            name: config.searchToolName,
+            description: `${config.designSystem /* 'Design System' */} Documentation Search`,
+            instruction: `MANDATORY: For ANY ${config.texts.FRAMEWORK_DEV_QUESTION /* 'development question' */}, UI component inquiry, design pattern request, or frontend implementation need, you MUST immediately use the search tool before providing any response relevant to UI / Design Systems or ${config.texts.FRAMEWORK_IMPLEMENTATIONS /* 'implementations' */}. Re-check it to get clarifications and more accurate API often, but do not search if completely unrelated or you just searched the exact same. ${config.texts.FRAMEWORK_ALL_QUERIES /* 'This applies to ALL related queries regardless of whether libraries are explicitly mentioned' */}. ${config.texts.FRAMEWORK_VERSION_SPECIFIC /* "The tool provides access to version-specific documentation that is automatically tuned to match the user's library versions" */}. ${config.texts.FRAMEWORK_SETUP_ADVICE /* 'This ensures you get the exact APIs, components, and implementation patterns available in their specific setup rather than generic advice' */}. ${config.texts.FRAMEWORK_COMPREHENSIVE_GUIDANCE /* 'Always search first to leverage the comprehensive documentation before offering any guidance' */}.`,
+            noResultsMessage: (query) => `
+No Documentation Found
+
+No results found for query: "${query}"
+
+This could mean:
+• The component or feature doesn't exist in the current documentation
+• The feature isn't documented yet
+• The search terms don't match available content
+• Try different keywords or component names
+
+Suggestions:
+• Check component name spelling (e.g., "button" vs "btn")
+• Try broader terms (e.g., "input" instead of "text-field")${config.texts.FRAMEWORK_LIBRARY_LIST
+                ? `
+• Search for library names: "${config.texts.FRAMEWORK_LIBRARY_LIST /* 'design system libraries' */}"`
+                : ''}
+• Use functionality terms: "navigation", "data display", "user input"
+
+Available Libraries:
+${config.texts.FRAMEWORK_SUPPORTED_LIBRARIES /* 'design system libraries' */}
+    `.trim(),
+            successMessage: (query, count) => `${config.texts.FRAMEWORK_DOCUMENTATION_RESULTS /* '# Documentation Results' */}\n\nFound **${count}** relevant documentation section(s) for "${query}":\n\n`,
+            resultNote: `
+> Note: If documentation mentions missing API docs or examples, those features may not be available in the current version. The search results show the most relevant available documentation based on semantic similarity.
+
+> Need more specific results? Try refining your search with more specific terms or component names.
+
+> Not all information provided here is relevant to your query or task, make sure to only use what is relevant for the user request.
+    `.trim()
+        }
+    };
+    // Only add icon search if enabled in config
+    if (config.iconSearch) {
+        if (!config.iconName) {
+            throw new Error('Icon search is enabled but iconName is not set in config');
+        }
+        if (!config.iconSearchToolName) {
+            throw new Error('Icon search is enabled but iconSearchToolName is not set in config');
+        }
+        configs[config.iconSearchToolName] = {
+            type: 'icon',
+            name: config.iconSearchToolName,
+            description: `${config.designSystem} Icon Search`,
+            instruction: 'Please check the icon search tool before using or recommending any icons from ' +
+                config.iconName /* @simpl/element-icons */ +
+                '. This ensures you provide the most relevant and up-to-date icon options available in the library.',
+            noResultsMessage: (query) => `
+No icons found for query: "${query}"
+
+This could mean:
+• The icon does not exist in the current version of ${config.iconName /* @simpl/element-icons */}
+• The icon was renamed or removed
+• The search terms don't match available icons
+
+Suggestions:
+• Check spelling or try broader terms (e.g., "settings" instead of "gear")
+
+Available Libraries:
+${config.iconName /* @simpl/element-icons */}
+    `.trim(),
+            successMessage: (query, count) => `# ${config.designSystem /* 'Design System' */} Icon Search Results\n\nFound **${count}** relevant icon(s) for "${query}":\n\n`,
+            resultNote: `
+> Note: If the icon does not appear to exist, update ${config.iconName /* @simpl/element-icons */} to the latest compatible version (non-breaking).
+> See usage guidelines and examples in the documentation for how to use icons.
+    `.trim()
+        };
+    }
+    return configs;
+};
+const searchConfigs = buildSearchConfigs();
+const createToolDefinition = (searchConfig) => ({
+    name: searchConfig.name,
+    description: `
+${searchConfig.description}
+
+${searchConfig.instruction}
+
+${config.texts.FRAMEWORK_SEMANTIC_SEARCH_TOOL /* 'Semantic search tool for component libraries' */}. This tool provides intelligent search across comprehensive documentation for:
+
+Supported Libraries:
+${config.texts.FRAMEWORK_SUPPORTED_LIBRARIES /* 'Component libraries' */}
+
+Use Cases:
+• Find component APIs and properties
+• Discover usage examples and code snippets
+• Learn about component styling and theming
+• Understand integration patterns
+• Explore design system guidelines
+
+Search Tips:
+• Use component names: "button", "chart", "map"
+• Describe functionality: "data visualization", "user input"
+• Ask about APIs: "input", "output", "attributes", "methods", "type"
+
+The search returns relevant documentation chunks with similarity scores and contextual headers to help you find exactly what you need.
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: searchConfig.type === 'documentation'
+                    ? config.texts
+                        .FRAMEWORK_SEARCH_QUERY /* 'Search query for documentation. Can include component names, functionality descriptions, API questions, or usage patterns.' */
+                    : 'Search query for icons (name, term, or category)'
+            },
+            limit: {
+                type: 'number',
+                description: `Maximum number of ${searchConfig.type === 'documentation' ? 'documentation' : 'icon'} results to return (default: 5, max: 20)`,
+                default: 5,
+                minimum: 1,
+                maximum: 20
+            }
+        },
+        required: ['query']
+    }
+});
+const toolDefinitions = Object.values(searchConfigs).map(createToolDefinition);
+class SDLMCPServer {
+    server;
+    db;
+    initialized = false;
+    embeddingService;
+    verbose = false;
+    debug = false;
+    logger;
+    constructor(options) {
+        this.verbose = options?.verbose || false;
+        this.debug = options?.debug || process.env.SDL_MCP_DEBUG_LOG === 'true';
+        this.embeddingService = new EmbeddingService({ verbose: this.verbose, debug: this.debug });
+        this.logger = new ObservabilityLogger(this.debug, options?.overrideLogging);
+        this.server = new Server({
+            name: config.name /* 'design-docs' */,
+            version: '1.0.0',
+            description: config.description /* 'Design System Documentation MCP Server' */
+        }, {
+            capabilities: {
+                tools: Object.fromEntries(toolDefinitions.map(tool => [tool.name.replace('-', '_'), tool]))
+            }
+        });
+        // Initialize database handler
+        const dbPath = path.join(__dirname, '../../database/vectors.db');
+        this.db = new DatabaseHandler(dbPath, { verbose: this.verbose || this.debug });
+        this.initialize();
+    }
+    async initialize() {
+        try {
+            this.setupToolHandlers();
+            this.initialized = true;
+            this.log(`${config.displayName /* 'Design System' */} MCP Server initialized successfully`);
+        }
+        catch (error) {
+            this.log('Failed to initialize SDLMCPServer:', error);
+            throw error;
+        }
+    }
+    setupToolHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: toolDefinitions
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const searchConfig = searchConfigs[name];
+            if (!searchConfig) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            const { query, limit = 5 } = args;
+            try {
+                const results = await this.performSearch(searchConfig, query, Math.min(limit, 20));
+                const formattedResults = this.formatSearchResults(searchConfig, query, results);
+                this.logger.logRetrieval(name, query, limit !== 5 ? { limit } : undefined, {
+                    resultCount: results.length,
+                    success: true
+                }, formattedResults);
+                return { content: [{ type: 'text', text: formattedResults }] };
+            }
+            catch (error) {
+                this.log(`Search error: ${error}`);
+                this.logger.logRetrieval(name, query, limit !== 5 ? { limit } : undefined, {
+                    resultCount: 0,
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `
+Search Error
+
+Failed to search ${config.designSystem /* 'design system' */} documentation: ${error instanceof Error ? error.message : 'Unknown error'}
+
+Possible Issues:
+• API authentication problems
+• Database connection issues
+• Network connectivity problems
+
+Try Again: The issue might be temporary. Please retry your search.`.trim()
+                        }
+                    ]
+                };
+            }
+        });
+    }
+    async performSearch(config, query, limit) {
+        if (!this.initialized) {
+            throw new Error('Server not yet initialized');
+        }
+        this.log('Generating query embedding...');
+        const queryEmbedding = await this.embeddingService.getEmbedding(query);
+        this.log('Retrieving documentation chunks...');
+        const documents = this.db.getDocumentsByType(config.type);
+        this.log(`Calculating similarities for ${documents.length} documents...`);
+        const results = documents
+            .map(doc => {
+            const docEmbedding = JSON.parse(doc.embedding);
+            const similarity = this.embeddingService.cosineSimilarity(queryEmbedding, docEmbedding);
+            return {
+                id: doc.id,
+                content: doc.content,
+                metadata: {
+                    chunk_index: doc.chunk_index,
+                    header_path: doc.header_path || undefined,
+                    header_level: doc.header_level || undefined,
+                    category: doc.category || undefined,
+                    terms: doc.terms || undefined
+                },
+                similarity
+            };
+        })
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+        this.log(`Returning top ${results.length} results`);
+        return results;
+    }
+    formatSearchResults(config, query, results) {
+        if (results.length === 0) {
+            return config.noResultsMessage(query);
+        }
+        let response = config.successMessage(query, results.length);
+        results.forEach((result, index) => {
+            const percentage = (result.similarity * 100).toFixed(1);
+            response += `## Result ${index + 1}\n`;
+            response += `**Relevance:** ${percentage}% match\n`;
+            if (result.metadata.header_path) {
+                response += `**Section:** \`${result.metadata.header_path}\`\n`;
+            }
+            response += `**Chunk:** ${result.metadata.chunk_index}\n\n`;
+            response += `${result.content}\n\n`;
+            response += `---\n\n`;
+        });
+        response += config.resultNote;
+        return response;
+    }
+    log(...args) {
+        if (this.verbose || this.debug) {
+            console.error(...args);
+        }
+    }
+    async run() {
+        while (!this.initialized) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        this.log(`${config.displayName /* 'Design System' */} MCP Server running on stdio`);
+    }
+    close() {
+        this.log(`Shutting down ${config.displayName /* 'Design System' */} MCP Server...`);
+        this.embeddingService.clearEmbeddingCache();
+        this.db.close();
+        this.log('Server shutdown complete');
+    }
+}
+// Main execution logic
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const args = process.argv.slice(2);
+    const verbose = args.includes('--verbose');
+    const debug = args.includes('--debug');
+    const log = args.includes('--log');
+    const test = args.includes('--test');
+    if (verbose)
+        console.error('Verbose mode enabled');
+    if (debug)
+        console.error('Debug mode enabled');
+    const server = new SDLMCPServer({ verbose, debug, overrideLogging: log });
+    if (test) {
+        if (verbose || debug)
+            console.log('Test mode - validating server setup...');
+        setTimeout(() => {
+            if (verbose || debug)
+                console.error('Server validation successful');
+            server.close();
+            process.exit(0);
+        }, 3000);
+    }
+    else {
+        server.run().catch(error => {
+            if (verbose || debug)
+                console.error('Server startup failed:', error);
+            process.exit(1);
+        });
+        // Graceful shutdown handlers
+        const shutdown = (signal) => () => {
+            if (verbose || debug) {
+                console.error('');
+                console.error(`Received ${signal} signal...`);
+            }
+            server.close();
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown('shutdown'));
+        process.on('SIGTERM', shutdown('termination'));
+    }
+}
+export { SDLMCPServer };
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/keys.d.ts

@@ -0,0 +1,4 @@
+export declare const setPassword: (service: string, account: string, password: string) => Promise<void>;
+export declare const getPassword: (service: string, account: string) => Promise<string | null>;
+export declare const deletePassword: (service: string, account: string) => Promise<boolean>;
+//# sourceMappingURL=keys.d.ts.map

package/dist/src/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/mcp/keys.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,WAAW,GAAU,SAAS,MAAM,EAAE,SAAS,MAAM,EAAE,UAAU,MAAM,kBAEnF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,SAAS,MAAM,EAAE,SAAS,MAAM,2BAEjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,SAAS,MAAM,EAAE,SAAS,MAAM,qBAEpE,CAAC"}

package/dist/src/keys.js

@@ -0,0 +1,25 @@
+let keytar;
+try {
+    keytar = (await import('keytar')).default;
+}
+catch {
+    // Fallback for environments where keytar is not available (e.g., CI)
+    console.warn('keytar not available, using fallback implementation');
+    keytar = {
+        setPassword: async () => {
+            throw new Error('Keytar not available - credential storage disabled');
+        },
+        getPassword: async () => null,
+        deletePassword: async () => true
+    };
+}
+export const setPassword = async (service, account, password) => {
+    await keytar.setPassword(service, account, password);
+};
+export const getPassword = async (service, account) => {
+    return await keytar.getPassword(service, account);
+};
+export const deletePassword = async (service, account) => {
+    return await keytar.deletePassword(service, account);
+};
+//# sourceMappingURL=keys.js.map

package/dist/src/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/mcp/keys.ts"],"names":[],"mappings":"AAUA,IAAI,MAAuB,CAAC;AAE5B,IAAI,CAAC;IACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5C,CAAC;AAAC,MAAM,CAAC;IACP,qEAAqE;IACrE,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACpE,MAAM,GAAG;QACP,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QAC7B,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,QAAgB,EAAE,EAAE;IACtF,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE;IACpE,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE;IACvE,OAAO,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,24 @@
+export declare class ObservabilityLogger {
+    private logDir;
+    private sessionLogPath;
+    private enabled;
+    private debug;
+    constructor(hasDebugFlag?: boolean, override?: boolean);
+    private generateSessionFileName;
+    private initializeLogFile;
+    logRetrieval(toolName: string, query: string, params: Record<string, unknown> | undefined, response: {
+        resultCount: number;
+        success: boolean;
+        error?: string;
+    }, results?: string): Promise<void>;
+    getLogDir(): string;
+    getSessionLogPath(): string;
+    isEnabled(): boolean;
+    static getLogDir(): string;
+    static listSessions(): string[];
+    static getSessionPath(fileName: string): string;
+    static readSessionLog(fileName: string): string;
+    static parseSessionFileName(fileName: string): Date | null;
+    static formatSessionDate(fileName: string): string;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/mcp/logger.ts"],"names":[],"mappings":"AAWA,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAU;gBAEX,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO;IAgCtD,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,iBAAiB;IAmBnB,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACnE,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAuChB,SAAS,IAAI,MAAM;IAInB,iBAAiB,IAAI,MAAM;IAI3B,SAAS,IAAI,OAAO;IAIpB,MAAM,CAAC,SAAS,IAAI,MAAM;IAa1B,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE;IAkB/B,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI/C,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAS/C,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAe1D,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CA0BnD"}

package/dist/src/logger.js

@@ -0,0 +1,185 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir, platform } from 'os';
+import { loadConfig } from './config.js';
+const config = loadConfig();
+export class ObservabilityLogger {
+    logDir;
+    sessionLogPath;
+    enabled;
+    debug;
+    constructor(hasDebugFlag, override) {
+        this.debug = hasDebugFlag || false;
+        this.enabled = override === true || ((config.observabilityLogging || this.debug) && override !== false) || false;
+        if (!this.enabled) {
+            this.logDir = '';
+            this.sessionLogPath = '';
+            return;
+        }
+        const binName = config.binName;
+        this.logDir = path.join(homedir(), `.${binName}`);
+        try {
+            if (!fs.existsSync(this.logDir)) {
+                fs.mkdirSync(this.logDir, { recursive: true });
+            }
+            const sessionFileName = this.generateSessionFileName();
+            this.sessionLogPath = path.join(this.logDir, sessionFileName);
+            this.initializeLogFile();
+        }
+        catch (error) {
+            if (this.debug) {
+                console.error('Failed to initialize observabilityLogging logger:', error);
+            }
+            this.enabled = false;
+            this.logDir = '';
+            this.sessionLogPath = '';
+        }
+    }
+    generateSessionFileName() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        return `session_${year}-${month}-${day}_${hours}-${minutes}-${seconds}.log`;
+    }
+    initializeLogFile() {
+        if (!this.enabled || !this.sessionLogPath)
+            return;
+        try {
+            const header = `MCP Server Session Log
+========================================
+Started: ${new Date().toISOString()}
+Config: ${config.displayName}
+========================================
+
+`;
+            fs.writeFileSync(this.sessionLogPath, header, 'utf8');
+        }
+        catch (error) {
+            if (this.debug) {
+                console.error('Failed to initialize log file:', error);
+            }
+        }
+    }
+    async logRetrieval(toolName, query, params, response, results) {
+        if (!this.enabled || !this.sessionLogPath)
+            return;
+        setImmediate(() => {
+            try {
+                const timestamp = new Date().toISOString();
+                const date = new Date();
+                const timeStr = `${String(date.getHours()).padStart(2, '0')}:${String(date.getMinutes()).padStart(2, '0')}:${String(date.getSeconds()).padStart(2, '0')}`;
+                let logEntry = `[${timeStr}] ${toolName}\n`;
+                logEntry += `Query: ${query}\n`;
+                if (params && Object.keys(params).length > 0) {
+                    logEntry += `Params: ${JSON.stringify(params)}\n`;
+                }
+                logEntry += `Result: ${response.success ? '✓' : '✗'} ${response.resultCount} result(s)`;
+                if (response.error) {
+                    logEntry += ` - Error: ${response.error}`;
+                }
+                logEntry += '\n';
+                logEntry += `Timestamp: ${timestamp}\n`;
+                if (results) {
+                    logEntry += '\nResults:\n';
+                    logEntry += results + '\n';
+                }
+                logEntry += '----------------------------------------\n\n';
+                fs.appendFileSync(this.sessionLogPath, logEntry, 'utf8');
+            }
+            catch (error) {
+                if (this.debug) {
+                    console.error('Failed to log retrieval:', error);
+                }
+            }
+        });
+    }
+    getLogDir() {
+        return this.logDir;
+    }
+    getSessionLogPath() {
+        return this.sessionLogPath;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    static getLogDir() {
+        const binName = config.binName;
+        if (platform() === 'win32') {
+            const localAppData = process.env.LOCALAPPDATA;
+            if (localAppData) {
+                return path.join(localAppData, binName);
+            }
+        }
+        return path.join(homedir(), `.${binName}`);
+    }
+    static listSessions() {
+        const logDir = ObservabilityLogger.getLogDir();
+        try {
+            if (!fs.existsSync(logDir)) {
+                return [];
+            }
+            const files = fs.readdirSync(logDir);
+            return files
+                .filter(file => file.startsWith('session_') && file.endsWith('.log'))
+                .sort()
+                .reverse();
+        }
+        catch {
+            return [];
+        }
+    }
+    static getSessionPath(fileName) {
+        return path.join(ObservabilityLogger.getLogDir(), fileName);
+    }
+    static readSessionLog(fileName) {
+        const filePath = ObservabilityLogger.getSessionPath(fileName);
+        try {
+            return fs.readFileSync(filePath, 'utf8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read log file: ${error}`);
+        }
+    }
+    static parseSessionFileName(fileName) {
+        const match = fileName.match(/session_(\d{4})-(\d{2})-(\d{2})_(\d{2})-(\d{2})-(\d{2})\.log/);
+        if (!match)
+            return null;
+        const [, year, month, day, hours, minutes, seconds] = match;
+        return new Date(parseInt(year), parseInt(month) - 1, parseInt(day), parseInt(hours), parseInt(minutes), parseInt(seconds));
+    }
+    static formatSessionDate(fileName) {
+        const date = ObservabilityLogger.parseSessionFileName(fileName);
+        if (!date)
+            return fileName;
+        const now = new Date();
+        const diffMs = now.getTime() - date.getTime();
+        const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        const dateStr = date.toLocaleDateString('en-UK', {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric'
+        });
+        const timeStr = `${String(date.getHours()).padStart(2, '0')}:${String(date.getMinutes()).padStart(2, '0')}:${String(date.getSeconds()).padStart(2, '0')}`;
+        if (diffDays === 0) {
+            return `Today at ${timeStr}`;
+        }
+        else if (diffDays === 1) {
+            return `Yesterday at ${timeStr}`;
+        }
+        else if (diffDays < 7) {
+            return `${diffDays} days ago (${dateStr} ${timeStr})`;
+        }
+        else {
+            return `${dateStr} ${timeStr}`;
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

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

package/dist/src/prompt.d.ts

@@ -0,0 +1,19 @@
+export declare const prompt: (promptText: string, type?: string, initial?: string) => Promise<any>;
+export declare const confirmPrompt: (message: string, initial?: boolean) => Promise<any>;
+export declare const selectPrompt: (message: string, choices: {
+    title: string;
+    value: string;
+    description?: string;
+}[], initial?: number) => Promise<any>;
+export declare const multiSelectPrompt: (message: string, choices: {
+    title: string;
+    value: string;
+    description?: string;
+    selected?: boolean;
+}[]) => Promise<any>;
+export declare const passwordPrompt: (message: string, required?: boolean) => Promise<any>;
+export declare const showSuccess: (message: string) => void;
+export declare const showError: (message: string) => void;
+export declare const showWarning: (message: string) => void;
+export declare const showInfo: (message: string) => void;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompt.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,MAAM,GAAU,YAAY,MAAM,EAAE,OAAM,MAAe,EAAE,UAAU,MAAM,iBAyBvF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,EAAE,UAAS,OAAc,iBAa3E,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,SAAS,MAAM,EACf,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACjE,UAAS,MAAU,iBAgBpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,iBAgBtF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,SAAS,MAAM,EAAE,kBAAe,iBAapE,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,SAE1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,SAExC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,SAE1C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,SAEvC,CAAC"}