aiexecode 1.0.88 → 1.0.89

package/index.js

@@ -164,7 +164,7 @@ if (viewerMode) {
     console.log(chalk.green(`✓ Payload viewer is running`));
     console.log(chalk.yellow(`Press Ctrl+C to stop the server`));
     // Keep process alive
-    await new Promise(() => {});
+    await new Promise(() => { });
 }
 
 // 전역 설정
@@ -175,7 +175,7 @@ process.app_custom.__dirname = dirname(fileURLToPath(import.meta.url));
 // (글로벌 설치 후 aiexecode 명령으로 실행 시에는 다른 경로에서 실행됨)
 const packageJsonPath = join(process.app_custom.__dirname, 'package.json');
 const isDevelopment = existsSync(packageJsonPath) &&
-                      process.app_custom.__dirname === dirname(fileURLToPath(import.meta.url));
+    process.app_custom.__dirname === dirname(fileURLToPath(import.meta.url));
 process.env.IS_DEVELOPMENT = isDevelopment ? 'true' : 'false';
 
 // Session ID 생성 함수 (16자리 hex)
@@ -307,19 +307,100 @@ if (!process.env.OPENAI_API_KEY) {
     process.exit(1);
 }
 
-// MCP Integration 초기화 (백그라운드에서 실행)
-let mcpIntegration = null;
-let mcpToolFunctions = {};
-let mcpToolSchemas = [];
+// ========================================
+// MCP Integration 초기화
+// ========================================
+// MCP (Model Context Protocol) 서버들과의 연결을 설정하고 사용 가능한 도구 목록을 준비
+// 프로그램 시작 시 백그라운드에서 비동기로 실행되어 UI 로딩을 블로킹하지 않음
 
-// MCP 초기화를 백그라운드에서 실행하되 Promise만 저장 (이벤트는 UI 시작 후에 발생)
-const mcpInitPromise = initializeMCPIntegration(process.cwd()).then(integration => {
+let mcpIntegration = null;      // MCP Integration 인스턴스 (서버 관리 및 도구 실행)
+let mcpToolFunctions = {};      // MCP 도구 실행 함수들 (toolName -> async function)
+let mcpToolSchemas = [];        // MCP 도구 스키마들 (AI 모델에 전달할 도구 정의)
+
+// MCP 초기화를 백그라운드에서 실행
+// Promise만 저장하고 실제 UI 이벤트는 UI 시작 후에 발생시킨다
+const mcpInitPromise = initializeMCPIntegration().then(async integration => {
+    // 초기화 성공 시 결과 저장
     mcpIntegration = integration;
+
+    // MCP 도구 실행 함수들을 가져옴 (session.js에서 도구 실행 시 사용)
     mcpToolFunctions = integration ? integration.getToolFunctions() : {};
+
+    // MCP 도구 스키마들을 가져옴 (orchestrator.js에서 AI에게 전달)
     mcpToolSchemas = integration ? integration.getToolSchemas() : [];
 
+    // 초기화 결과 로깅
     if (integration) {
         const servers = integration.getConnectedServers();
+        const logLines = [];
+
+        logLines.push('');
+        logLines.push(`MCP INTEGRATION COMPLETE`);
+        logLines.push(`Timestamp: ${new Date().toISOString()}`);
+        logLines.push(`Total Servers: ${servers.length}`);
+        logLines.push(`Total Tools: ${Object.keys(mcpToolFunctions).length}`);
+        logLines.push(`Total Schemas: ${mcpToolSchemas.length}`);
+        logLines.push('');
+
+        // MCP 서버별 상세 정보
+        if (servers.length > 0) {
+            logLines.push('Connected MCP Servers:');
+            servers.forEach((server, idx) => {
+                if (idx > 0) logLines.push('');
+                logLines.push(`[${idx + 1}] ${server.name}`);
+                logLines.push(`    Status: ${server.status}`);
+                logLines.push(`    Tool Count: ${server.toolCount}`);
+                if (server.transport) {
+                    logLines.push(`    Transport: ${JSON.stringify(server.transport, null, 2).split('\n').join('\n    ')}`);
+                }
+                if (server.tools && server.tools.length > 0) {
+                    logLines.push(`    Available Tools:`);
+                    server.tools.forEach(tool => {
+                        logLines.push(`      - ${tool.name}: ${tool.description || 'No description'}`);
+                    });
+                }
+            });
+            logLines.push('');
+        }
+
+        // mcpToolFunctions 구조 로깅
+        if (Object.keys(mcpToolFunctions).length > 0) {
+            logLines.push('MCP Tool Functions:');
+            Object.keys(mcpToolFunctions).forEach((toolName, idx) => {
+                const func = mcpToolFunctions[toolName];
+                logLines.push(`  [${idx + 1}] ${toolName}`);
+                logLines.push(`      Type: ${typeof func}`);
+                logLines.push(`      Function Name: ${func?.name || 'anonymous'}`);
+            });
+            logLines.push('');
+        }
+
+        // mcpToolSchemas 구조 로깅
+        if (mcpToolSchemas.length > 0) {
+            logLines.push('MCP Tool Schemas:');
+            mcpToolSchemas.forEach((schema, idx) => {
+                logLines.push(`  [${idx + 1}] ${schema.name}`);
+                logLines.push(`      Description: ${schema.description || 'No description'}`);
+                if (schema.inputSchema) {
+                    const props = schema.inputSchema.properties || {};
+                    const propCount = Object.keys(props).length;
+                    logLines.push(`      Input Properties: ${propCount}`);
+                    if (propCount > 0) {
+                        Object.entries(props).forEach(([key, value]) => {
+                            const required = schema.inputSchema.required?.includes(key) ? ' (required)' : '';
+                            logLines.push(`        - ${key}: ${value.type || 'unknown'}${required}`);
+                        });
+                    }
+                }
+            });
+            logLines.push('');
+        }
+
+        // 별도 파일에 기록 (createDebugLogger 사용)
+        const mcpLogger = createDebugLogger('mcp_initialization.log', 'MCP');
+        logLines.forEach(line => mcpLogger(line));
+
+        // 기존 디버그 로그에도 간략하게 출력
         debugLog(`MCP integration complete: ${servers.length} server(s), ${Object.keys(mcpToolFunctions).length} tool(s)`);
         servers.forEach(server => {
             debugLog(`   - ${server.name}: ${server.toolCount} tool(s) (${server.status})`);
@@ -327,16 +408,28 @@ const mcpInitPromise = initializeMCPIntegration(process.cwd()).then(integration
     }
     return integration;
 }).catch(err => {
+    // 초기화 실패 시에도 프로그램은 계속 실행 (MCP 없이도 동작)
     debugLog(`MCP initialization failed: ${err.message}`);
     return null;
 });
 
+// ========================================
 // 커맨드 레지스트리 초기화
+// ========================================
+// 사용자가 입력하는 슬래시 커맨드들(/mcp, /exit 등)을 관리
 const commandRegistry = new CommandRegistry();
-await loadCommands(commandRegistry, {
+
+// context 객체를 생성 - getter를 사용하여 mcpIntegration을 동적으로 참조
+// 이렇게 하면 나중에 MCP가 초기화되어도 최신 값을 참조할 수 있음
+const commandContext = {
     commandRegistry,
-    mcpIntegration
-});
+    get mcpIntegration() {
+        return mcpIntegration;  // 현재 mcpIntegration 값을 반환 (null이거나 초기화된 값)
+    }
+};
+
+// src/commands/ 디렉토리의 모든 커맨드 파일들을 자동으로 로드하고 등록
+await loadCommands(commandRegistry, commandContext);
 
 // 커맨드 목록 준비
 const commandList = Array.from(commandRegistry.commands.entries()).map(([name, cmd]) => ({
@@ -364,13 +457,14 @@ async function handleSubmit(text) {
         return;
     }
 
-    // 세션 실행 (시작/종료 알림 및 저장은 runSession 내부에서 처리)
+    // 세션 실행 (AI Agent의 미션 수행)
+    // 시작/종료 알림 및 저장은 runSession 내부에서 처리
     try {
         await runSession({
-            mission: text,
-            maxIterations: 50,
-            mcpToolSchemas,
-            mcpToolFunctions
+            mission: text,           // 사용자가 입력한 미션
+            maxIterations: 50,       // 최대 반복 횟수
+            mcpToolSchemas,          // AI 모델에 전달할 MCP 도구 스키마들
+            mcpToolFunctions         // 실제 MCP 도구 실행 함수들
         });
     } catch (err) {
         // API 인증 에러 등 세션 실행 중 발생한 에러를 history에 표시
@@ -483,23 +577,34 @@ uiInstance = startUI({
     updateInfo: null // 초기에는 null, 나중에 업데이트됨
 });
 
-// UI가 시작된 후 로딩 태스크 추가
+// ========================================
+// 백그라운드 초기화 태스크 UI 연동
+// ========================================
+// UI가 시작된 후 백그라운드에서 실행 중인 초기화 작업들을 사용자에게 표시
+
+// 버전 체크 로딩 표시
 uiEvents.emit('loading:task_add', {
     id: 'version_check',
     text: 'Checking for updates...'
 });
 
+// MCP 초기화 로딩 표시
 uiEvents.emit('loading:task_add', {
     id: 'mcp_init',
     text: 'Initializing MCP servers...'
 });
 
-// UI가 준비된 후 비동기 초기화 이벤트 발생 (Promise가 이미 완료된 경우에도 처리됨)
-// 첫 번째 catch에서 null을 반환하므로 항상 resolved 상태로 then이 실행됨
+// 백그라운드 초기화 완료 시 UI에 이벤트 발생
+// Promise가 이미 완료된 경우에도 then이 실행되어 UI가 업데이트됨
+// catch에서 null을 반환하므로 항상 resolved 상태로 then이 실행됨
+
+// 버전 체크 완료 이벤트
 versionCheckPromise.then(info => {
     uiEvents.emit('version:update', { updateInfo: info });
 });
 
+// MCP 초기화 완료 이벤트
+// 이 시점에서 MCP 서버들과의 연결이 완료되고 도구 목록이 준비됨
 mcpInitPromise.then(integration => {
     uiEvents.emit('mcp:initialized', { integration });
 });
@@ -515,7 +620,10 @@ process.on('SIGINT', handleExit);
 // UI가 종료될 때까지 대기
 await uiInstance.waitUntilExit();
 
-// MCP Integration 정리
+// ========================================
+// 프로그램 종료 시 MCP 정리
+// ========================================
+// 모든 MCP 서버와의 연결을 정상적으로 종료하고 리소스 정리
 if (mcpIntegration) {
     await mcpIntegration.cleanup();
 }