@cognigy/mcp-server 0.1.0

package/dist/tools/index.js

@@ -0,0 +1,448 @@
+/**
+ * Tool definitions for the MCP server
+ */
+/**
+ * MCP Tool Definitions - 8 high-level workflow tools
+ */
+export const tools = [
+    // 1. AI Agent Management
+    {
+        name: 'manage_ai_agents',
+        description: 'Create, read, update, delete, list, or hire AI agents. Supports operations: create, get, update, delete, list, hire.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['create', 'get', 'update', 'delete', 'list', 'hire'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (24-character hex string, required for create/list)',
+                },
+                aiAgentId: {
+                    type: 'string',
+                    description: 'The AI agent ID (24-character hex string, required for get/update/delete/hire)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Name of the AI agent (required for create)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Description of the AI agent',
+                },
+                job: {
+                    type: 'string',
+                    description: 'Job description for the AI agent',
+                },
+                tools: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tools available to the AI agent',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit (1-100)',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip offset',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 2. Knowledge Management
+    {
+        name: 'manage_knowledge',
+        description: 'Manage knowledge stores, sources, and search knowledge chunks. Operations: create_store, create_source, search_chunks, list_stores.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['create_store', 'create_source', 'search_chunks', 'list_stores'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required for create_store/list_stores)',
+                },
+                knowledgeStoreId: {
+                    type: 'string',
+                    description: 'Knowledge store ID (required for create_source/search_chunks)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Name of the knowledge store (required for create_store)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Description',
+                },
+                embeddingModel: {
+                    type: 'string',
+                    description: 'Embedding model to use',
+                },
+                type: {
+                    type: 'string',
+                    enum: ['url', 'file', 'text'],
+                    description: 'Type of knowledge source (required for create_source)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Content for the knowledge source (URL, file path, or text)',
+                },
+                query: {
+                    type: 'string',
+                    description: 'Search query (required for search_chunks)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Result limit',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 3. Conversation Management
+    {
+        name: 'manage_conversations',
+        description: 'List conversations, get conversation details, or retrieve session state. Operations: list, get, get_session_state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['list', 'get', 'get_session_state'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required for list)',
+                },
+                sessionId: {
+                    type: 'string',
+                    description: 'The session ID (required for get/get_session_state)',
+                },
+                startDate: {
+                    type: 'string',
+                    description: 'Filter by start date (ISO 8601)',
+                },
+                endDate: {
+                    type: 'string',
+                    description: 'Filter by end date (ISO 8601)',
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Filter by channel (e.g., webchat3, voiceGateway2)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 4. Flow Management
+    {
+        name: 'manage_flows',
+        description: 'Create, update, list flows and manage flow nodes. Operations: create, update, list, create_node, get_node, update_node.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['create', 'update', 'list', 'create_node', 'get_node', 'update_node'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required for create/list)',
+                },
+                flowId: {
+                    type: 'string',
+                    description: 'The flow ID (required for update/create_node/get_node/update_node)',
+                },
+                nodeId: {
+                    type: 'string',
+                    description: 'The node ID (required for get_node/update_node)',
+                },
+                localeId: {
+                    type: 'string',
+                    description: 'The locale ID (optional for get_node/update_node)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Flow name',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Flow description',
+                },
+                type: {
+                    type: 'string',
+                    description: 'Node type (required for create_node)',
+                },
+                label: {
+                    type: 'string',
+                    description: 'Node label',
+                },
+                config: {
+                    type: 'object',
+                    description: 'Node configuration (for create_node/update_node)',
+                },
+                comment: {
+                    type: 'string',
+                    description: 'Node comment (for update_node)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 5. Intent & NLU Management
+    {
+        name: 'manage_intents',
+        description: 'Create, update, list intents and train NLU models. Operations: create, update, list, train.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['create', 'update', 'list', 'train'],
+                    description: 'The operation to perform',
+                },
+                flowId: {
+                    type: 'string',
+                    description: 'The flow ID (required for create/list/train)',
+                },
+                intentId: {
+                    type: 'string',
+                    description: 'The intent ID (required for update)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Intent name',
+                },
+                sentences: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Training sentences for the intent',
+                },
+                localeId: {
+                    type: 'string',
+                    description: 'Locale ID for training',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 6. Analytics & Monitoring
+    {
+        name: 'get_analytics',
+        description: 'Get analytics data, logs, and audit events. Operations: conversation_count, call_count, logs, audit_events.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['conversation_count', 'call_count', 'logs', 'audit_events'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required)',
+                },
+                year: {
+                    type: 'number',
+                    description: 'Year for analytics (required for conversation_count/call_count)',
+                },
+                month: {
+                    type: 'number',
+                    description: 'Month for analytics (1-12)',
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Channel filter',
+                },
+                startDate: {
+                    type: 'string',
+                    description: 'Start date filter (ISO 8601)',
+                },
+                endDate: {
+                    type: 'string',
+                    description: 'End date filter (ISO 8601)',
+                },
+                level: {
+                    type: 'string',
+                    enum: ['debug', 'info', 'warn', 'error'],
+                    description: 'Log level filter',
+                },
+                userId: {
+                    type: 'string',
+                    description: 'User ID filter for audit events',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation', 'projectId'],
+        },
+    },
+    // 7. Project & Endpoint Management
+    {
+        name: 'manage_projects',
+        description: 'Create and list projects, create and list endpoints. Operations: create_project, list_projects, create_endpoint, list_endpoints.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['create_project', 'list_projects', 'create_endpoint', 'list_endpoints'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required for create_endpoint/list_endpoints)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Name (required for create_project/create_endpoint)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Description',
+                },
+                defaultLocale: {
+                    type: 'string',
+                    description: 'Default locale for project',
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Channel type: "rest", "webchat3", "voiceGateway2", etc. (required for create_endpoint)',
+                },
+                flowId: {
+                    type: 'string',
+                    description: 'Flow ID to connect to the endpoint (required for create_endpoint)',
+                },
+                settings: {
+                    type: 'object',
+                    description: 'Optional endpoint settings/configuration',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation'],
+        },
+    },
+    // 8. Extension Management
+    {
+        name: 'manage_extensions',
+        description: 'List extensions and manage custom functions. Operations: list_extensions, create_function, update_function, list_functions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['list_extensions', 'create_function', 'update_function', 'list_functions'],
+                    description: 'The operation to perform',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'The project ID (required)',
+                },
+                functionId: {
+                    type: 'string',
+                    description: 'The function ID (required for update_function)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Function name',
+                },
+                code: {
+                    type: 'string',
+                    description: 'Function code',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Function description',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Pagination limit',
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Pagination skip',
+                },
+            },
+            required: ['operation', 'projectId'],
+        },
+    },
+    // 9. Talk to AI Agent (Iterative Improvement Loop)
+    {
+        name: 'talk_to_agent',
+        description: 'Send a message to a Cognigy AI Agent through its REST endpoint and get the response. Use this to test agent behavior, iterate on improvements, and create a feedback loop. Perfect for testing how an AI Agent responds before and after configuration changes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                endpointUrl: {
+                    type: 'string',
+                    description: 'The REST endpoint URL (e.g., https://endpoint-trial.cognigy.ai/xxxxx)',
+                },
+                message: {
+                    type: 'string',
+                    description: 'The message to send to the AI Agent',
+                },
+                sessionId: {
+                    type: 'string',
+                    description: 'Optional session ID to maintain conversation context. Use same ID for follow-up messages.',
+                },
+                userId: {
+                    type: 'string',
+                    description: 'Optional user ID to identify the conversation participant',
+                },
+                data: {
+                    type: 'object',
+                    description: 'Optional additional data to send with the message',
+                },
+            },
+            required: ['endpointUrl', 'message'],
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple logger utility for the MCP server
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare class Logger {
+    private level;
+    private levels;
+    constructor(level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAKZ;gBAEU,KAAK,GAAE,QAAiB;IAIpC,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAIxB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAMrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAOjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAOhC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAOhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAMlC;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,52 @@
+/**
+ * Simple logger utility for the MCP server
+ */
+class Logger {
+    level;
+    levels = {
+        debug: 0,
+        info: 1,
+        warn: 2,
+        error: 3,
+    };
+    constructor(level = 'info') {
+        this.level = level;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    shouldLog(level) {
+        return this.levels[level] >= this.levels[this.level];
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const metaStr = meta ? ` ${JSON.stringify(meta)}` : '';
+        return `[${timestamp}] [${level.toUpperCase()}] ${message}${metaStr}`;
+    }
+    debug(message, meta) {
+        if (this.shouldLog('debug')) {
+            // Use stderr to avoid polluting stdout (MCP uses stdio protocol)
+            console.error(this.formatMessage('debug', message, meta));
+        }
+    }
+    info(message, meta) {
+        if (this.shouldLog('info')) {
+            // Use stderr to avoid polluting stdout (MCP uses stdio protocol)
+            console.error(this.formatMessage('info', message, meta));
+        }
+    }
+    warn(message, meta) {
+        if (this.shouldLog('warn')) {
+            // Use stderr to avoid polluting stdout (MCP uses stdio protocol)
+            console.error(this.formatMessage('warn', message, meta));
+        }
+    }
+    error(message, meta) {
+        if (this.shouldLog('error')) {
+            // Use stderr to avoid polluting stdout (MCP uses stdio protocol)
+            console.error(this.formatMessage('error', message, meta));
+        }
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM;IACF,KAAK,CAAW;IAChB,MAAM,GAA6B;QACzC,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QAChE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,iEAAiE;YACjE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,iEAAiE;YACjE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,iEAAiE;YACjE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,iEAAiE;YACjE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/rateLimiter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Rate limiter to prevent API abuse
+ */
+interface RateLimitConfig {
+    maxRequests: number;
+    windowMs: number;
+}
+export declare class RateLimiter {
+    private requests;
+    private config;
+    private cleanupInterval?;
+    constructor(config: RateLimitConfig);
+    /**
+     * Stop the cleanup interval (important for tests and graceful shutdown)
+     */
+    destroy(): void;
+    /**
+     * Check if a request should be allowed
+     * @param key - Identifier for the rate limit bucket (e.g., API key, IP address)
+     * @returns true if request is allowed, false if rate limit exceeded
+     */
+    check(key: string): boolean;
+    /**
+     * Get remaining requests for a key
+     */
+    getRemaining(key: string): number;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+}
+export {};
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/utils/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../src/utils/rateLimiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAE7B,MAAM,EAAE,eAAe;IAMnC;;OAEG;IACH,OAAO;IAOP;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAuB3B;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQjC;;OAEG;IACH,OAAO,CAAC,OAAO;CAQhB"}

package/dist/utils/rateLimiter.js

@@ -0,0 +1,68 @@
+/**
+ * Rate limiter to prevent API abuse
+ */
+export class RateLimiter {
+    requests = new Map();
+    config;
+    cleanupInterval;
+    constructor(config) {
+        this.config = config;
+        // Clean up expired entries every minute
+        this.cleanupInterval = setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * Stop the cleanup interval (important for tests and graceful shutdown)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+    }
+    /**
+     * Check if a request should be allowed
+     * @param key - Identifier for the rate limit bucket (e.g., API key, IP address)
+     * @returns true if request is allowed, false if rate limit exceeded
+     */
+    check(key) {
+        const now = Date.now();
+        const record = this.requests.get(key);
+        if (!record || now > record.resetTime) {
+            // New window, allow request
+            this.requests.set(key, {
+                count: 1,
+                resetTime: now + this.config.windowMs,
+            });
+            return true;
+        }
+        if (record.count < this.config.maxRequests) {
+            // Within limit, allow request
+            record.count++;
+            return true;
+        }
+        // Rate limit exceeded
+        return false;
+    }
+    /**
+     * Get remaining requests for a key
+     */
+    getRemaining(key) {
+        const record = this.requests.get(key);
+        if (!record || Date.now() > record.resetTime) {
+            return this.config.maxRequests;
+        }
+        return Math.max(0, this.config.maxRequests - record.count);
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, record] of this.requests.entries()) {
+            if (now > record.resetTime) {
+                this.requests.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=rateLimiter.js.map

package/dist/utils/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/utils/rateLimiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,OAAO,WAAW;IACd,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAC;IACjD,MAAM,CAAkB;IACxB,eAAe,CAAkB;IAEzC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,wCAAwC;QACxC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,4BAA4B;YAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC3C,8BAA8B;YAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sBAAsB;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAW;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}