closeli-mcp-gateway 1.0.0

package/dist/server.js

@@ -0,0 +1,201 @@
+/**
+ * MCP Server Setup
+ * Register tools and start server
+ */
+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 { z } from 'zod';
+import { logger } from './utils/logger.js';
+import { sessionManager } from './session/SessionManager.js';
+import { handleCodexTool } from './tools/codex.js';
+import { handleClaudeCodeTool } from './tools/claude-code.js';
+import { handleResumeTool } from './tools/resume.js';
+import { handleGetSessionStatusTool } from './tools/get-session-status.js';
+/**
+ * Tool parameter schema definitions
+ */
+const CodexParamsSchema = z.object({
+    workspace: z.string().describe('Working directory path'),
+    prompt: z.string().describe('Task prompt'),
+});
+const ClaudeCodeParamsSchema = z.object({
+    workspace: z.string().describe('Working directory path'),
+    prompt: z.string().describe('Task prompt'),
+});
+const ResumeParamsSchema = z.object({
+    sessionId: z.string().describe('Session ID (UUID)'),
+});
+const GetSessionStatusParamsSchema = z.object({
+    sessionId: z.string().describe('Session ID (UUID)'),
+});
+/**
+ * Create and configure MCP server
+ */
+export function createServer() {
+    const server = new Server({
+        name: 'closeli-mcp-gateway',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register tools list handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'codex',
+                    description: 'Start a new codex task. Executes codex exec command to handle long-running tasks. If task does not complete within timeout, returns sessionId for client to continue waiting using resume tool.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            workspace: {
+                                type: 'string',
+                                description: 'Absolute path of working directory',
+                            },
+                            prompt: {
+                                type: 'string',
+                                description: 'Task prompt to execute',
+                            },
+                        },
+                        required: ['workspace', 'prompt'],
+                    },
+                },
+                {
+                    name: 'claude-code',
+                    description: 'Start a new claude-code task. Executes claude command to handle long-running tasks. If task does not complete within timeout, returns sessionId for client to continue waiting using resume tool.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            workspace: {
+                                type: 'string',
+                                description: 'Absolute path of working directory',
+                            },
+                            prompt: {
+                                type: 'string',
+                                description: 'Task prompt to execute',
+                            },
+                        },
+                        required: ['workspace', 'prompt'],
+                    },
+                },
+                {
+                    name: 'resume',
+                    description: 'Continue waiting for previously started task result. This is a universal tool that works with any task type (codex or claude-code). Use the sessionId returned from previous call to continue waiting.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: {
+                                type: 'string',
+                                description: 'Session ID (UUID format)',
+                            },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+                {
+                    name: 'get-session-status',
+                    description: 'Query current running status of a session. View whether task is still running, running duration, output line count, recent output, etc. Used to monitor progress of long-running tasks.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: {
+                                type: 'string',
+                                description: 'Session ID (UUID format)',
+                            },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+            ],
+        };
+    });
+    // Register tool call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        logger.info('Tool called', { name, args });
+        try {
+            switch (name) {
+                case 'codex': {
+                    const params = CodexParamsSchema.parse(args);
+                    return await handleCodexTool(params);
+                }
+                case 'claude-code': {
+                    const params = ClaudeCodeParamsSchema.parse(args);
+                    return await handleClaudeCodeTool(params);
+                }
+                case 'resume': {
+                    const params = ResumeParamsSchema.parse(args);
+                    return await handleResumeTool(params);
+                }
+                case 'get-session-status': {
+                    const params = GetSessionStatusParamsSchema.parse(args);
+                    return await handleGetSessionStatusTool(params);
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            logger.error('Error handling tool call', {
+                name,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/**
+ * Start server
+ */
+export async function startServer() {
+    logger.info('Starting MCP server...');
+    // Start orphan cleanup
+    sessionManager.startOrphanCleanup();
+    // Create server
+    const server = createServer();
+    // Use stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('MCP server started successfully');
+    // Setup graceful shutdown
+    setupGracefulShutdown(server);
+}
+/**
+ * Setup graceful shutdown handling
+ */
+function setupGracefulShutdown(server) {
+    const shutdown = async (signal) => {
+        logger.info(`Received ${signal}, shutting down gracefully...`);
+        try {
+            // Stop orphan cleanup
+            sessionManager.stopOrphanCleanup();
+            // Cleanup all sessions
+            await sessionManager.cleanupAllSessions();
+            // Close server
+            await server.close();
+            logger.info('Server shutdown complete');
+            process.exit(0);
+        }
+        catch (error) {
+            logger.error('Error during shutdown', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            process.exit(1);
+        }
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session/ProcessExecutor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Process Execution Module
+ * Responsible for starting, monitoring, and terminating child processes
+ */
+import { ChildProcess } from 'child_process';
+import * as pty from 'node-pty';
+import { Session, ToolType } from './Session.js';
+/**
+ * Start a process and return the process instance
+ */
+export declare function spawnProcess(tool: ToolType, workspace: string, prompt: string): ChildProcess | pty.IPty;
+/**
+ * Set up process output capture
+ */
+export declare function setupOutputCapture(childProcess: ChildProcess | pty.IPty, session: Session): void;
+/**
+ * Gracefully terminate a process
+ */
+export declare function killProcessGracefully(childProcess: ChildProcess | pty.IPty): Promise<void>;
+//# sourceMappingURL=ProcessExecutor.d.ts.map

package/dist/session/ProcessExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessExecutor.d.ts","sourceRoot":"","sources":["../../src/session/ProcessExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAIhC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,GAAG,CAAC,IAAI,CAsCzB;AA+BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyLhG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChG"}

package/dist/session/ProcessExecutor.js

@@ -0,0 +1,286 @@
+/**
+ * Process Execution Module
+ * Responsible for starting, monitoring, and terminating child processes
+ */
+import { spawn } from 'child_process';
+import { logger } from '../utils/logger.js';
+import { config } from '../config/environment.js';
+import { ProcessExecutionError } from '../utils/errors.js';
+/**
+ * Start a process and return the process instance
+ */
+export function spawnProcess(tool, workspace, prompt) {
+    const { command, args } = buildCommand(tool, prompt);
+    logger.info('Spawning process', {
+        tool,
+        command,
+        workspace,
+        promptLength: prompt.length,
+    });
+    try {
+        // Currently using normal spawn for all, as node-pty has compatibility issues with Node v25
+        const childProcess = spawn(command, args, {
+            cwd: workspace,
+            env: {
+                ...process.env,
+                // For claude, try to disable TTY detection
+                TERM: tool === 'claude-code' ? 'xterm-256color' : 'dumb',
+                CI: 'true',
+            },
+            shell: false,
+        });
+        if (!childProcess.pid) {
+            throw new ProcessExecutionError('Failed to spawn process: no PID assigned');
+        }
+        logger.info('Process spawned successfully', {
+            pid: childProcess.pid,
+            tool,
+        });
+        return childProcess;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('Failed to spawn process', { tool, error: message });
+        throw new ProcessExecutionError(`Failed to spawn ${tool}: ${message}`);
+    }
+}
+/**
+ * Build command and arguments based on tool type
+ */
+function buildCommand(tool, prompt) {
+    switch (tool) {
+        case 'codex':
+            return {
+                command: 'codex',
+                args: ['exec', '--skip-git-repo-check', '--full-auto', prompt],
+            };
+        case 'claude-code':
+            const args = ['--print'];
+            // Add arguments based on VERBOSE environment variable
+            if (config.VERBOSE) {
+                args.push('--verbose', '--output-format', 'stream-json');
+            }
+            args.push('--dangerously-skip-permissions', prompt);
+            return {
+                command: 'claude',
+                args,
+            };
+        default:
+            throw new ProcessExecutionError(`Unknown tool type: ${tool}`);
+    }
+}
+/**
+ * Set up process output capture
+ */
+export function setupOutputCapture(childProcess, session) {
+    // Now using normal ChildProcess for all
+    const normalProcess = childProcess;
+    // Close stdin - this is important for claude in --print mode
+    // claude waits for stdin to close before starting output
+    if (normalProcess.stdin) {
+        try {
+            normalProcess.stdin.end();
+            logger.debug('Closed process stdin', {
+                sessionId: session.id,
+                tool: session.tool,
+            });
+        }
+        catch (error) {
+            logger.warn('Failed to close stdin', {
+                sessionId: session.id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // Check if stdout exists
+    if (!normalProcess.stdout) {
+        logger.error('Process stdout is null', {
+            sessionId: session.id,
+            pid: session.pid,
+        });
+    }
+    else {
+        logger.debug('Setting up stdout capture', {
+            sessionId: session.id,
+            pid: session.pid,
+        });
+    }
+    // Check if stderr exists
+    if (!normalProcess.stderr) {
+        logger.error('Process stderr is null', {
+            sessionId: session.id,
+            pid: session.pid,
+        });
+    }
+    else {
+        logger.debug('Setting up stderr capture', {
+            sessionId: session.id,
+            pid: session.pid,
+        });
+    }
+    // Capture stdout
+    normalProcess.stdout?.on('data', (chunk) => {
+        const text = chunk.toString('utf-8');
+        logger.debug('Received stdout data', {
+            sessionId: session.id,
+            chunkSize: chunk.length,
+            textLength: text.length,
+        });
+        const lines = text.split('\n').filter((line) => line.length > 0);
+        // VERBOSE mode: output detailed logs
+        if (config.VERBOSE) {
+            // Log all output
+            lines.forEach((line) => {
+                logger.info('[PROCESS OUTPUT]', {
+                    sessionId: session.id,
+                    tool: session.tool,
+                    stream: 'stdout',
+                    line,
+                });
+            });
+            // claude-code VERBOSE mode uses stream-json, only save final result
+            if (session.tool === 'claude-code') {
+                lines.forEach((line) => {
+                    try {
+                        const json = JSON.parse(line);
+                        if (json.type === 'result') {
+                            // Save result text content (may be multi-line)
+                            const resultText = json.result || '';
+                            const resultLines = resultText.split('\n');
+                            session.stdout = resultLines;
+                            logger.info('Captured final result for claude-code', {
+                                sessionId: session.id,
+                                isError: json.is_error,
+                                duration: json.duration_ms,
+                                lines: resultLines.length,
+                            });
+                        }
+                    }
+                    catch (e) {
+                        // Not valid JSON, ignore
+                    }
+                });
+            }
+            else {
+                // Other tools: save all output
+                session.stdout.push(...lines);
+                if (session.stdout.length > config.MAX_OUTPUT_LINES) {
+                    const excess = session.stdout.length - config.MAX_OUTPUT_LINES;
+                    session.stdout.splice(0, excess);
+                    logger.warn('Output buffer limit reached, discarding oldest lines', {
+                        sessionId: session.id,
+                        discarded: excess,
+                    });
+                }
+            }
+        }
+        else {
+            // Non-VERBOSE mode: don't output logs, save all output
+            session.stdout.push(...lines);
+            if (session.stdout.length > config.MAX_OUTPUT_LINES) {
+                const excess = session.stdout.length - config.MAX_OUTPUT_LINES;
+                session.stdout.splice(0, excess);
+                logger.warn('Output buffer limit reached, discarding oldest lines', {
+                    sessionId: session.id,
+                    discarded: excess,
+                });
+            }
+        }
+    });
+    // Capture stderr
+    normalProcess.stderr?.on('data', (chunk) => {
+        const text = chunk.toString('utf-8');
+        logger.debug('Received stderr data', {
+            sessionId: session.id,
+            chunkSize: chunk.length,
+            textLength: text.length,
+        });
+        const lines = text.split('\n').filter((line) => line.length > 0);
+        // VERBOSE mode: output stderr to logs (including tokens used, etc.)
+        if (config.VERBOSE) {
+            lines.forEach((line) => {
+                logger.info('[PROCESS ERROR]', {
+                    sessionId: session.id,
+                    tool: session.tool,
+                    stream: 'stderr',
+                    line,
+                });
+            });
+        }
+        // stderr not saved to session (not returned to client)
+    });
+    // Handle process exit
+    normalProcess.on('exit', (code, signal) => {
+        session.exitCode = code;
+        session.completedAt = new Date();
+        if (signal) {
+            session.status = 'killed';
+            logger.warn('Process killed by signal', {
+                sessionId: session.id,
+                signal,
+                pid: session.pid,
+            });
+        }
+        else if (code === 0) {
+            session.status = 'completed';
+            logger.info('Process completed successfully', {
+                sessionId: session.id,
+                pid: session.pid,
+            });
+        }
+        else {
+            session.status = 'failed';
+            logger.error('Process failed with exit code', {
+                sessionId: session.id,
+                exitCode: code,
+                pid: session.pid,
+            });
+        }
+    });
+    // Handle process errors
+    normalProcess.on('error', (error) => {
+        session.status = 'failed';
+        session.completedAt = new Date();
+        logger.error('Process error', {
+            sessionId: session.id,
+            error: error.message,
+            pid: session.pid,
+        });
+    });
+}
+/**
+ * Gracefully terminate a process
+ */
+export async function killProcessGracefully(childProcess) {
+    // Now using normal ChildProcess for all
+    const normalProcess = childProcess;
+    if (!normalProcess.pid || normalProcess.killed) {
+        return;
+    }
+    const pid = normalProcess.pid;
+    logger.info('Attempting graceful process termination', { pid });
+    // Attempt graceful termination
+    normalProcess.kill('SIGTERM');
+    // Wait for grace period
+    await sleep(config.KILL_GRACE_PERIOD_MS);
+    // If still running, force kill
+    if (!normalProcess.killed) {
+        logger.warn('Process did not terminate gracefully, forcing kill', { pid });
+        normalProcess.kill('SIGKILL');
+        // Try to kill process group (Unix systems)
+        try {
+            process.kill(-pid, 'SIGKILL');
+        }
+        catch (error) {
+            // Process may have already exited, ignore error
+        }
+    }
+    logger.info('Process terminated', { pid });
+}
+/**
+ * Helper function: async sleep
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=ProcessExecutor.js.map

package/dist/session/ProcessExecutor.js.map

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

package/dist/session/Session.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Session-related type definitions
+ */
+import { ChildProcess } from 'child_process';
+import * as pty from 'node-pty';
+/**
+ * Tool type
+ */
+export type ToolType = 'codex' | 'claude-code';
+/**
+ * Session status
+ */
+export type SessionStatus = 'running' | 'completed' | 'failed' | 'killed';
+/**
+ * Session data structure
+ */
+export interface Session {
+    /** Unique session ID (UUID) */
+    id: string;
+    /** Tool type used */
+    tool: ToolType;
+    /** Working directory */
+    workspace: string;
+    /** Task prompt */
+    prompt: string;
+    /** Node process reference (supports both normal process and PTY) */
+    process: ChildProcess | pty.IPty;
+    /** Process ID */
+    pid: number;
+    /** Standard output lines */
+    stdout: string[];
+    /** Standard error output lines */
+    stderr: string[];
+    /** Exit code (when completed) */
+    exitCode: number | null;
+    /** Session creation time */
+    createdAt: Date;
+    /** Last client check time */
+    lastClientCheckTime: Date;
+    /** Completion time (if completed) */
+    completedAt: Date | null;
+    /** Current status */
+    status: SessionStatus;
+}
+/**
+ * Wait result return type
+ */
+export interface WaitResult {
+    /** Whether completed */
+    complete: boolean;
+    /** Standard output */
+    stdout?: string[];
+    /** Standard error output */
+    stderr?: string[];
+    /** Exit code */
+    exitCode?: number | null;
+    /** Status */
+    status?: SessionStatus;
+}
+//# sourceMappingURL=Session.d.ts.map

package/dist/session/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/session/Session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC;IACjC,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAGZ,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,6BAA6B;IAC7B,mBAAmB,EAAE,IAAI,CAAC;IAC1B,qCAAqC;IACrC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IAGzB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB"}

package/dist/session/Session.js

@@ -0,0 +1,5 @@
+/**
+ * Session-related type definitions
+ */
+export {};
+//# sourceMappingURL=Session.js.map

package/dist/session/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../src/session/Session.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/session/SessionManager.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Session Manager
+ * Responsible for creating, managing, and cleaning up sessions
+ */
+import { Session, ToolType, WaitResult } from './Session.js';
+/**
+ * SessionManager singleton class
+ */
+export declare class SessionManager {
+    private sessions;
+    private cleanupTimer;
+    /**
+     * Create new session and start process
+     */
+    createSession(tool: ToolType, workspace: string, prompt: string): Promise<string>;
+    /**
+     * Get session and update last check time
+     */
+    getSession(sessionId: string): Session;
+    /**
+     * Wait for session result, throw error if timeout
+     */
+    waitForResult(sessionId: string, maxWaitMs: number): Promise<WaitResult>;
+    /**
+     * Clean up session (terminate process and remove from Map)
+     */
+    cleanupSession(sessionId: string): Promise<void>;
+    /**
+     * Start orphan session cleanup
+     */
+    startOrphanCleanup(): void;
+    /**
+     * Stop orphan session cleanup
+     */
+    stopOrphanCleanup(): void;
+    /**
+     * Check and clean up orphaned sessions
+     */
+    private checkOrphanedSessions;
+    /**
+     * Clean up all sessions (used when shutting down server)
+     */
+    cleanupAllSessions(): Promise<void>;
+    /**
+     * Get current active session count
+     */
+    getActiveSessionCount(): number;
+}
+/**
+ * Global singleton instance
+ */
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/session/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG7D;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,YAAY,CAA+B;IAEnD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyDvF;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IActC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiD9E;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAgB1B;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;YACW,qBAAqB;IAwBnC;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAczC;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAGhC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}