@gguf/coder 0.0.1

package/dist/mcp/transport-factory.js

@@ -0,0 +1,257 @@
+import { execFileSync } from 'child_process';
+import { accessSync, constants as fsConstants } from 'fs';
+import { logWarning } from '../utils/message-queue.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { WebSocketClientTransport } from '@modelcontextprotocol/sdk/client/websocket.js';
+/**
+ * Installation instructions for common MCP server dependencies
+ */
+const COMMAND_INSTALL_HINTS = {
+    uvx: `'uvx' is part of the 'uv' Python package manager.
+
+Install uv:
+  • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
+  • Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+  • pip: pip install uv
+  • Homebrew: brew install uv
+
+After installation, restart your terminal and try again.`,
+    npx: `'npx' is part of Node.js.
+
+Install Node.js from: https://nodejs.org/
+Or use a version manager like nvm, fnm, or volta.`,
+    node: `'node' is not installed.
+
+Install Node.js from: https://nodejs.org/
+Or use a version manager like nvm, fnm, or volta.`,
+    python: `'python' is not installed.
+
+Install Python from: https://python.org/downloads/
+Or use a version manager like pyenv.`,
+    python3: `'python3' is not installed.
+
+Install Python from: https://python.org/downloads/
+Or use a version manager like pyenv.`,
+};
+/**
+ * Checks if a command exists in the system PATH or as an executable path.
+ * Uses execFileSync with separate arguments to prevent shell injection.
+ * Handles both PATH lookups and direct path references (./bin/cmd, /usr/bin/cmd).
+ */
+function commandExists(command) {
+    // Check if command is a path (contains path separators)
+    if (command.includes('/') || command.includes('\\')) {
+        try {
+            // Check if file exists and is executable
+            accessSync(command, fsConstants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // PATH lookup using which/where
+    try {
+        const checkCmd = process.platform === 'win32' ? 'where' : 'which';
+        execFileSync(checkCmd, [command], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Gets installation hint for a missing command
+ */
+function getInstallHint(command) {
+    return (COMMAND_INSTALL_HINTS[command] ||
+        `'${command}' is not installed or not in your PATH.`);
+}
+/**
+ * Factory for creating MCP client transports based on server configuration
+ */
+export class TransportFactory {
+    /**
+     * Creates a transport instance for the given MCP server configuration
+     */
+    static createTransport(server) {
+        switch (server.transport) {
+            case 'stdio':
+                return this.createStdioTransport(server);
+            case 'websocket':
+                return this.createWebSocketTransport(server);
+            case 'http':
+                return this.createHTTPTransport(server);
+            default: {
+                const _exhaustiveCheck = server.transport;
+                throw new Error(`Unsupported transport type: ${_exhaustiveCheck}`);
+            }
+        }
+    }
+    /**
+     * Creates a stdio transport for local MCP servers
+     */
+    static createStdioTransport(server) {
+        if (!server.command) {
+            throw new Error(`MCP server "${server.name}" missing command for stdio transport`);
+        }
+        return new StdioClientTransport({
+            command: server.command,
+            args: server.args || [],
+            env: server.env
+                ? { ...process.env, ...server.env }
+                : undefined,
+        });
+    }
+    /**
+     * Creates a WebSocket transport for remote MCP servers
+     */
+    static createWebSocketTransport(server) {
+        if (!server.url) {
+            throw new Error(`MCP server "${server.name}" missing URL for websocket transport`);
+        }
+        const url = new URL(server.url);
+        // Validate WebSocket URL
+        if (!url.protocol.startsWith('ws')) {
+            throw new Error(`Invalid WebSocket URL protocol: ${url.protocol}. Expected ws:// or wss://`);
+        }
+        const transport = new WebSocketClientTransport(url);
+        // Note: The WebSocketClientTransport doesn't directly support headers in the current SDK
+        // Authentication would need to be handled at the protocol level or via URL parameters
+        if (server.auth) {
+            logWarning('WebSocket transport has unsupported auth config', true, {
+                context: {
+                    serverName: server.name,
+                    transportType: 'websocket',
+                    reason: 'Current SDK does not support headers for WebSocket transport',
+                },
+            });
+        }
+        return transport;
+    }
+    /**
+     * Creates an HTTP transport for remote MCP servers
+     */
+    static createHTTPTransport(server) {
+        if (!server.url) {
+            throw new Error(`MCP server "${server.name}" missing URL for http transport`);
+        }
+        const url = new URL(server.url);
+        // Validate HTTP URL
+        if (!url.protocol.startsWith('http')) {
+            throw new Error(`Invalid HTTP URL protocol: ${url.protocol}. Expected http:// or https://`);
+        }
+        // Create transport with headers if provided
+        const transportOptions = server.headers
+            ? { requestInit: { headers: server.headers } }
+            : undefined;
+        const transport = new StreamableHTTPClientTransport(url, transportOptions);
+        if (server.auth) {
+            logWarning('HTTP transport has unsupported auth config', true, {
+                context: {
+                    serverName: server.name,
+                    transportType: 'http',
+                    reason: 'Current SDK does not support custom headers for HTTP transport',
+                },
+            });
+        }
+        // Check if headers are specified but cannot be used
+        if (server.headers) {
+            const headerKeys = Object.keys(server.headers);
+            if (headerKeys.length > 0) {
+                // Headers are now being used, so don't show the warning anymore
+                // console.warn(...) - Commented out since headers are now supported
+            }
+        }
+        return transport;
+    }
+    /**
+     * Validates the server configuration for the given transport type
+     */
+    static validateServerConfig(server) {
+        const errors = [];
+        switch (server.transport) {
+            case 'stdio':
+                if (!server.command) {
+                    errors.push('stdio transport requires a command');
+                }
+                else if (!commandExists(server.command)) {
+                    const hint = getInstallHint(server.command);
+                    errors.push(`Command '${server.command}' not found.\n\n${hint}`);
+                }
+                break;
+            case 'websocket':
+                if (!server.url) {
+                    errors.push('websocket transport requires a URL');
+                }
+                else {
+                    try {
+                        const url = new URL(server.url);
+                        if (!url.protocol.startsWith('ws')) {
+                            errors.push('websocket URL must use ws:// or wss:// protocol'); // nosemgrep
+                        }
+                    }
+                    catch {
+                        errors.push('websocket URL is invalid');
+                    }
+                }
+                break;
+            case 'http':
+                if (!server.url) {
+                    errors.push('http transport requires a URL');
+                }
+                else {
+                    try {
+                        const url = new URL(server.url);
+                        if (!url.protocol.startsWith('http')) {
+                            errors.push('http URL must use http:// or https:// protocol');
+                        }
+                    }
+                    catch {
+                        errors.push('http URL is invalid');
+                    }
+                }
+                // Headers are now supported, so we don't need to warn about them being ignored
+                // The actual warning logic has been moved to the createHTTPTransport method
+                break;
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Gets transport-specific configuration tips for users
+     */
+    static getTransportTips(transportType) {
+        switch (transportType) {
+            case 'stdio':
+                return [
+                    'Stdio transport spawns a local process',
+                    'Requires a command and optional arguments',
+                    'Environment variables can be passed to the process',
+                    'Best for local MCP servers and tools',
+                ];
+            case 'websocket':
+                return [
+                    'WebSocket transport connects to remote MCP servers',
+                    'Requires a ws:// or wss:// URL', // nosemgrep
+                    'Supports real-time bidirectional communication',
+                    'Best for interactive remote services',
+                    'Note: Custom headers are not currently supported by the SDK and will be ignored',
+                ];
+            case 'http':
+                return [
+                    'HTTP transport connects to remote MCP servers via REST API',
+                    'Requires an http:// or https:// URL',
+                    'Uses the StreamableHTTP protocol from MCP specification',
+                    'Best for stateless remote services and APIs',
+                    'Custom headers are now supported for authentication',
+                ];
+            default:
+                return ['Unknown transport type'];
+        }
+    }
+}
+//# sourceMappingURL=transport-factory.js.map

package/dist/mcp/transport-factory.js.map

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

package/dist/mcp/transport-factory.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport-factory.spec.d.ts.map

package/dist/mcp/transport-factory.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-factory.spec.d.ts","sourceRoot":"","sources":["../../source/mcp/transport-factory.spec.ts"],"names":[],"mappings":""}

package/dist/mcp/transport-factory.spec.js

@@ -0,0 +1,299 @@
+import test from 'ava';
+import { TransportFactory } from './transport-factory.js';
+console.log(`\ntransport-factory.spec.ts`);
+// ============================================================================
+// Tests for TransportFactory
+// ============================================================================
+test('TransportFactory.createTransport: creates stdio transport', t => {
+    const server = {
+        name: 'test-stdio',
+        transport: 'stdio',
+        command: 'node',
+        args: ['server.js'],
+        env: { NODE_ENV: 'test' },
+    };
+    const transport = TransportFactory.createTransport(server);
+    t.truthy(transport);
+});
+test('TransportFactory.createTransport: creates websocket transport', t => {
+    const server = {
+        name: 'test-websocket',
+        transport: 'websocket',
+        url: 'ws://localhost:3000/mcp',
+    };
+    const transport = TransportFactory.createTransport(server);
+    t.truthy(transport);
+});
+test('TransportFactory.createTransport: creates http transport', t => {
+    const server = {
+        name: 'test-http',
+        transport: 'http',
+        url: 'https://example.com/mcp',
+    };
+    const transport = TransportFactory.createTransport(server);
+    t.truthy(transport);
+});
+test('TransportFactory.createTransport: throws error for unsupported transport', t => {
+    const server = {
+        name: 'test-unsupported',
+        transport: 'unsupported',
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /Unsupported transport type: unsupported/,
+    });
+});
+test('TransportFactory.createTransport: throws error for stdio missing command', t => {
+    const server = {
+        name: 'test-stdio-no-command',
+        transport: 'stdio',
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /missing command for stdio transport/,
+    });
+});
+test('TransportFactory.createTransport: throws error for websocket missing URL', t => {
+    const server = {
+        name: 'test-websocket-no-url',
+        transport: 'websocket',
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /missing URL for websocket transport/,
+    });
+});
+test('TransportFactory.createTransport: throws error for http missing URL', t => {
+    const server = {
+        name: 'test-http-no-url',
+        transport: 'http',
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /missing URL for http transport/,
+    });
+});
+test('TransportFactory.createTransport: throws error for invalid websocket URL', t => {
+    const server = {
+        name: 'test-websocket-invalid-url',
+        transport: 'websocket',
+        url: 'http://example.com/mcp', // Should be ws:// or wss://
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /Invalid WebSocket URL protocol/,
+    });
+});
+test('TransportFactory.createTransport: throws error for invalid http URL', t => {
+    const server = {
+        name: 'test-http-invalid-url',
+        transport: 'http',
+        url: 'ws://example.com/mcp', // Should be http:// or https://
+    };
+    t.throws(() => {
+        TransportFactory.createTransport(server);
+    }, {
+        message: /Invalid HTTP URL protocol/,
+    });
+});
+// ============================================================================
+// Tests for TransportFactory.validateServerConfig
+// ============================================================================
+test('TransportFactory.validateServerConfig: validates stdio config', t => {
+    const server = {
+        name: 'test-stdio',
+        transport: 'stdio',
+        command: 'node',
+        args: ['server.js'],
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.true(result.valid);
+    t.is(result.errors.length, 0);
+});
+test('TransportFactory.validateServerConfig: validates websocket config', t => {
+    const server = {
+        name: 'test-websocket',
+        transport: 'websocket',
+        url: 'wss://example.com/mcp',
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.true(result.valid);
+    t.is(result.errors.length, 0);
+});
+test('TransportFactory.validateServerConfig: validates http config', t => {
+    const server = {
+        name: 'test-http',
+        transport: 'http',
+        url: 'https://example.com/mcp',
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.true(result.valid);
+    t.is(result.errors.length, 0);
+});
+test('TransportFactory.validateServerConfig: detects invalid stdio config', t => {
+    const server = {
+        name: 'test-stdio-invalid',
+        transport: 'stdio',
+        // Missing command
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.false(result.valid);
+    t.true(result.errors.some((error) => error.includes('stdio transport requires a command')));
+});
+test('TransportFactory.validateServerConfig: detects invalid websocket config', t => {
+    const server = {
+        name: 'test-websocket-invalid',
+        transport: 'websocket',
+        url: 'http://example.com/mcp', // Invalid protocol
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.false(result.valid);
+    t.true(result.errors.some((error) => error.includes('websocket URL must use ws:// or wss:// protocol')));
+});
+test('TransportFactory.validateServerConfig: detects invalid http config', t => {
+    const server = {
+        name: 'test-http-invalid',
+        transport: 'http',
+        url: 'ws://example.com/mcp', // Invalid protocol
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.false(result.valid);
+    t.true(result.errors.some((error) => error.includes('http URL must use http:// or https:// protocol')));
+});
+// ============================================================================
+// Tests for TransportFactory.getTransportTips
+// ============================================================================
+test('TransportFactory.getTransportTips: returns stdio tips', t => {
+    const tips = TransportFactory.getTransportTips('stdio');
+    t.true(tips.length > 0);
+    t.true(tips.some((tip) => tip.includes('Stdio transport')));
+});
+test('TransportFactory.getTransportTips: returns websocket tips', t => {
+    const tips = TransportFactory.getTransportTips('websocket');
+    t.true(tips.length > 0);
+    t.true(tips.some((tip) => tip.includes('WebSocket')));
+});
+test('TransportFactory.getTransportTips: returns http tips', t => {
+    const tips = TransportFactory.getTransportTips('http');
+    t.true(tips.length > 0);
+    t.true(tips.some((tip) => tip.includes('HTTP')));
+});
+test('TransportFactory.getTransportTips: handles unknown transport', t => {
+    const tips = TransportFactory.getTransportTips('unknown');
+    t.is(tips.length, 1);
+    t.is(tips[0], 'Unknown transport type');
+});
+// ============================================================================
+// Tests for Header Warning Functionality (New Feature)
+// ============================================================================
+test('TransportFactory.createTransport: warns about auth config for websocket transport', t => {
+    // Test that transport is created despite auth config warning
+    // Note: Warnings are now logged via the logging system (logWarning),
+    // not console.warn directly
+    const server = {
+        name: 'test-websocket-with-auth',
+        transport: 'websocket',
+        url: 'ws://localhost:3000/mcp',
+        auth: {
+            type: 'bearer',
+            token: 'token123',
+        },
+    };
+    const transport = TransportFactory.createTransport(server);
+    // Transport should still be created even with unsupported auth config
+    t.truthy(transport);
+    // Warning is logged via logWarning() to the logging system
+});
+test('TransportFactory.createTransport: creates http transport with headers', t => {
+    const server = {
+        name: 'test-http-with-headers',
+        transport: 'http',
+        url: 'https://example.com/mcp',
+        headers: {
+            Authorization: 'Bearer token123',
+        },
+    };
+    const transport = TransportFactory.createTransport(server);
+    t.truthy(transport);
+});
+test('TransportFactory.createTransport: warns about auth config for http transport', t => {
+    // Test that transport is created despite auth config warning
+    // Note: Warnings are now logged via the logging system (logWarning),
+    // not console.warn directly
+    const server = {
+        name: 'test-http-with-auth',
+        transport: 'http',
+        url: 'https://example.com/mcp',
+        auth: {
+            type: 'bearer',
+            token: 'token123',
+        },
+    };
+    const transport = TransportFactory.createTransport(server);
+    // Transport should still be created even with unsupported auth config
+    t.truthy(transport);
+    // Warning is logged via logWarning() to the logging system
+});
+test('TransportFactory.validateServerConfig: validates http config with headers', t => {
+    const server = {
+        name: 'test-http-with-headers-validation',
+        transport: 'http',
+        url: 'https://example.com/mcp',
+        headers: {
+            'Custom-Header': 'value',
+        },
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.true(result.valid);
+    t.is(result.errors.length, 0);
+});
+// ============================================================================
+// Tests for Command Existence Validation (Issue #148 Fix)
+// ============================================================================
+test('TransportFactory.validateServerConfig: detects missing command', t => {
+    const server = {
+        name: 'test-stdio-missing-command',
+        transport: 'stdio',
+        command: 'this-command-definitely-does-not-exist-xyz123',
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.false(result.valid);
+    t.true(result.errors.some((error) => error.includes("Command 'this-command-definitely-does-not-exist-xyz123' not found")));
+});
+test('TransportFactory.validateServerConfig: returns uvx-specific installation hint', t => {
+    const server = {
+        name: 'test-stdio-uvx-hint',
+        transport: 'stdio',
+        command: 'uvx',
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    // Note: uvx may or may not be installed in different test environments
+    // If uvx is installed and valid, the test passes
+    // If uvx is not installed, check for uvx-specific installation instructions
+    if (result.valid) {
+        t.pass('uvx is installed in this environment');
+    }
+    else {
+        t.true(result.errors.length > 0);
+        t.true(result.errors.some((error) => error.includes("'uv' Python package manager")));
+        t.true(result.errors.some((error) => error.includes('astral.sh/uv/install.sh')));
+    }
+});
+test('TransportFactory.validateServerConfig: validates existing command (node)', t => {
+    // node should exist since we're running tests with it
+    const server = {
+        name: 'test-stdio-node-exists',
+        transport: 'stdio',
+        command: 'node',
+        args: ['--version'],
+    };
+    const result = TransportFactory.validateServerConfig(server);
+    t.true(result.valid);
+    t.is(result.errors.length, 0);
+});
+//# sourceMappingURL=transport-factory.spec.js.map

package/dist/mcp/transport-factory.spec.js.map

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

package/dist/message-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolManager } from './tools/tool-manager.js';
+import type { ToolCall, ToolHandler, ToolResult } from './types/index.js';
+export declare function setToolRegistryGetter(getter: () => Record<string, ToolHandler>): void;
+export declare function setToolManagerGetter(getter: () => ToolManager | null): void;
+export declare function getToolManager(): ToolManager | null;
+export declare function processToolUse(toolCall: ToolCall): Promise<ToolResult>;
+//# sourceMappingURL=message-handler.d.ts.map

package/dist/message-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../source/message-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,eAAe,CAAC;AAUrE,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,QAGzC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,QAEpE;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAyC5E"}

package/dist/message-handler.js

@@ -0,0 +1,53 @@
+import { formatError } from './utils/error-formatter.js';
+import { parseToolArguments } from './utils/tool-args-parser.js';
+// This will be set by the ChatSession
+let toolRegistryGetter = null;
+// This will be set by the App
+let toolManagerGetter = null;
+export function setToolRegistryGetter(getter) {
+    toolRegistryGetter = getter;
+}
+export function setToolManagerGetter(getter) {
+    toolManagerGetter = getter;
+}
+export function getToolManager() {
+    return toolManagerGetter ? toolManagerGetter() : null;
+}
+export async function processToolUse(toolCall) {
+    // Handle XML validation errors by throwing (will be caught and returned as error ToolResult)
+    if (toolCall.function.name === '__xml_validation_error__') {
+        const args = toolCall.function.arguments;
+        throw new Error(args.error);
+    }
+    if (!toolRegistryGetter) {
+        throw new Error('Tool registry not initialized');
+    }
+    const toolRegistry = toolRegistryGetter();
+    const handler = toolRegistry[toolCall.function.name];
+    if (!handler) {
+        throw new Error(`Unknown tool: ${toolCall.function.name}`);
+    }
+    try {
+        // Parse arguments - use strict mode to throw error on parse failure
+        // Strict mode is required here to catch malformed arguments before tool execution
+        const parsedArgs = parseToolArguments(toolCall.function.arguments, { strict: true });
+        const result = await handler(parsedArgs);
+        return {
+            tool_call_id: toolCall.id,
+            role: 'tool',
+            name: toolCall.function.name,
+            content: result,
+        };
+    }
+    catch (error) {
+        // Convert exceptions to error messages that the model can see and correct
+        const errorMessage = `Error: ${formatError(error)}`;
+        return {
+            tool_call_id: toolCall.id,
+            role: 'tool',
+            name: toolCall.function.name,
+            content: errorMessage,
+        };
+    }
+}
+//# sourceMappingURL=message-handler.js.map

package/dist/message-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.js","sourceRoot":"","sources":["../source/message-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAE5D,sCAAsC;AACtC,IAAI,kBAAkB,GAA+C,IAAI,CAAC;AAE1E,8BAA8B;AAC9B,IAAI,iBAAiB,GAAsC,IAAI,CAAC;AAEhE,MAAM,UAAU,qBAAqB,CACpC,MAAyC;IAEzC,kBAAkB,GAAG,MAAM,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACpE,iBAAiB,GAAG,MAAM,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAkB;IACtD,6FAA6F;IAC7F,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAA4B,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC;QACJ,oEAAoE;QACpE,kFAAkF;QAClF,MAAM,UAAU,GAAG,kBAAkB,CACpC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAC3B,EAAC,MAAM,EAAE,IAAI,EAAC,CACd,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO;YACN,YAAY,EAAE,QAAQ,CAAC,EAAE;YACzB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;YAC5B,OAAO,EAAE,MAAM;SACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,0EAA0E;QAC1E,MAAM,YAAY,GAAG,UAAU,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO;YACN,YAAY,EAAE,QAAQ,CAAC,EAAE;YACzB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;YAC5B,OAAO,EAAE,YAAY;SACrB,CAAC;IACH,CAAC;AACF,CAAC"}