@su-record/vibe 2.5.12 → 2.5.13

package/dist/orchestrator/SmartRouter.js

@@ -0,0 +1,256 @@
+/**
+ * SmartRouter - LLM 스마트 라우팅 및 fallback 관리
+ * orchestrator.ts에서 추출된 라우팅 전용 모듈
+ */
+import { TASK_LLM_PRIORITY } from './types.js';
+import * as gptApi from '../lib/gpt-api.js';
+import * as geminiApi from '../lib/gemini-api.js';
+import { debugLog } from '../lib/utils.js';
+// LLM 가용성 캐시 (5분 TTL)
+const LLM_CACHE_TTL = 5 * 60 * 1000;
+/**
+ * SmartRouter - Task 유형별 최적 LLM 선택 + fallback chain
+ */
+export class SmartRouter {
+    cache;
+    verbose;
+    constructor(options = {}) {
+        this.verbose = options.verbose ?? false;
+        this.cache = {
+            gpt: { available: true, checkedAt: 0, errorCount: 0 },
+            gemini: { available: true, checkedAt: 0, errorCount: 0 }
+        };
+    }
+    /**
+     * 스마트 라우팅 - 작업 유형에 따라 최적의 LLM 선택 + fallback
+     */
+    async route(request) {
+        const startTime = Date.now();
+        const { type, prompt, systemPrompt = 'You are a helpful assistant.', preferredLlm, maxRetries = 2 } = request;
+        // LLM 우선순위 결정
+        const providers = this.getProviderPriority(type, preferredLlm);
+        const attemptedProviders = [];
+        const errors = {};
+        // 각 LLM 순차 시도 (fallback chain)
+        for (const provider of providers) {
+            if (this.isUnavailable(provider)) {
+                if (this.verbose) {
+                    debugLog(`[SmartRouter] Skipping ${provider} (recently failed)`);
+                }
+                continue;
+            }
+            attemptedProviders.push(provider);
+            // 재시도 로직
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    const content = await this.callLlm(provider, prompt, systemPrompt);
+                    this.markAvailable(provider);
+                    return {
+                        content,
+                        provider,
+                        success: true,
+                        usedFallback: attemptedProviders.length > 1,
+                        attemptedProviders,
+                        duration: Date.now() - startTime
+                    };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    errors[provider] = errorMsg;
+                    if (this.verbose) {
+                        debugLog(`[SmartRouter] ${provider} attempt ${attempt + 1} failed: ${errorMsg}`);
+                    }
+                    if (this.shouldSkipRetry(errorMsg)) {
+                        this.markUnavailable(provider);
+                        break;
+                    }
+                    if (attempt < maxRetries) {
+                        await this.delay(1000 * (attempt + 1));
+                    }
+                }
+            }
+            this.markUnavailable(provider);
+        }
+        // 모든 외부 LLM 실패 - Claude fallback
+        return {
+            content: this.buildFallbackMessage(type, prompt, errors),
+            provider: 'claude',
+            success: true,
+            usedFallback: true,
+            attemptedProviders,
+            errors: errors,
+            duration: Date.now() - startTime
+        };
+    }
+    /**
+     * LLM 우선순위 결정
+     */
+    getProviderPriority(type, preferredLlm) {
+        if (preferredLlm) {
+            const others = TASK_LLM_PRIORITY[type].filter(p => p !== preferredLlm);
+            return [preferredLlm, ...others];
+        }
+        return [...TASK_LLM_PRIORITY[type]];
+    }
+    /**
+     * LLM 호출
+     */
+    async callLlm(provider, prompt, systemPrompt) {
+        switch (provider) {
+            case 'gpt':
+                return gptApi.vibeGptOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'gemini':
+                return geminiApi.vibeGeminiOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'claude':
+                throw new Error('Claude fallback - handled by caller');
+            default:
+                throw new Error(`Unknown provider: ${provider}`);
+        }
+    }
+    /**
+     * 재시도 없이 즉시 다음 LLM으로 넘어가야 하는 에러
+     */
+    shouldSkipRetry(errorMsg) {
+        const skipPatterns = [
+            'rate limit', 'quota', 'exhausted', '429', 'usage limit', 'too many requests',
+            'no token', 'token not set', 'no api key', 'api key not set',
+            'missing token', 'missing api key', 'not authenticated',
+            'authentication failed', 'unauthorized', '401', 'auth'
+        ];
+        const lowerMsg = errorMsg.toLowerCase();
+        return skipPatterns.some(pattern => lowerMsg.includes(pattern));
+    }
+    /**
+     * LLM 가용성 확인 (캐시 기반)
+     */
+    isUnavailable(provider) {
+        if (provider === 'claude')
+            return false;
+        const cache = this.cache[provider];
+        const now = Date.now();
+        if (now - cache.checkedAt > LLM_CACHE_TTL) {
+            cache.available = true;
+            cache.errorCount = 0;
+            return false;
+        }
+        return !cache.available || cache.errorCount >= 3;
+    }
+    /**
+     * LLM 가용 상태로 마킹
+     */
+    markAvailable(provider) {
+        if (provider === 'claude')
+            return;
+        this.cache[provider] = {
+            available: true,
+            checkedAt: Date.now(),
+            errorCount: 0
+        };
+    }
+    /**
+     * LLM 불가용 상태로 마킹
+     */
+    markUnavailable(provider) {
+        if (provider === 'claude')
+            return;
+        const cache = this.cache[provider];
+        cache.errorCount++;
+        cache.checkedAt = Date.now();
+        if (cache.errorCount >= 3) {
+            cache.available = false;
+        }
+    }
+    /**
+     * Fallback 메시지 생성
+     */
+    buildFallbackMessage(type, prompt, errors) {
+        const errorSummary = Object.entries(errors)
+            .map(([provider, msg]) => `- ${provider}: ${msg}`)
+            .join('\n');
+        return `[External LLM Unavailable - Claude Direct Handling]
+
+All external LLMs failed. Claude should handle this ${type} task directly.
+
+**Original Request:**
+${prompt}
+
+**Failed Providers:**
+${errorSummary}
+
+**Action Required:**
+Claude, please handle this task using your own capabilities. Do NOT retry external LLMs.`;
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // ============================================
+    // Convenience Methods (Smart* shortcuts)
+    // ============================================
+    async webSearch(query) {
+        return this.route({
+            type: 'web-search',
+            prompt: query,
+            systemPrompt: 'Search the web and provide relevant information.'
+        });
+    }
+    async architectureReview(prompt) {
+        return this.route({
+            type: 'architecture',
+            prompt,
+            systemPrompt: 'You are a software architect. Analyze and review the architecture.'
+        });
+    }
+    async uiuxReview(prompt) {
+        return this.route({
+            type: 'uiux',
+            prompt,
+            systemPrompt: 'You are a UI/UX expert. Analyze and provide feedback.'
+        });
+    }
+    async codeAnalysis(prompt) {
+        return this.route({
+            type: 'code-analysis',
+            prompt,
+            systemPrompt: 'You are a code analysis expert. Review and analyze the code.'
+        });
+    }
+    async debugging(prompt) {
+        return this.route({
+            type: 'debugging',
+            prompt,
+            systemPrompt: 'You are a debugging expert. Find bugs and suggest fixes.'
+        });
+    }
+    async codeGen(description, context) {
+        const prompt = context ? `${description}\n\nContext:\n${context}` : description;
+        return this.route({
+            type: 'code-gen',
+            prompt,
+            systemPrompt: 'Generate clean, well-documented code.'
+        });
+    }
+    /**
+     * 캐시 상태 조회 (디버깅용)
+     */
+    getCacheStatus() {
+        return { ...this.cache };
+    }
+    /**
+     * 캐시 초기화
+     */
+    resetCache() {
+        this.cache = {
+            gpt: { available: true, checkedAt: 0, errorCount: 0 },
+            gemini: { available: true, checkedAt: 0, errorCount: 0 }
+        };
+    }
+}
+// 싱글톤 인스턴스
+let defaultRouter = null;
+export function getSmartRouter(options) {
+    if (!defaultRouter || options) {
+        defaultRouter = new SmartRouter(options);
+    }
+    return defaultRouter;
+}
+//# sourceMappingURL=SmartRouter.js.map

package/dist/orchestrator/SmartRouter.js.map

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

package/dist/orchestrator/backgroundAgent.d.ts

@@ -1,30 +1,13 @@
 /**
  * Background Agent - 백그라운드 에이전트 관리
- */
-import { BackgroundAgentArgs } from './types.js';
-import { ToolResult } from '../types/tool.js';
-/**
- * 백그라운드 에이전트 시작
- */
-export declare function launchBackgroundAgent(args: BackgroundAgentArgs): Promise<ToolResult>;
-/**
- * 백그라운드 에이전트 결과 조회
- */
-export declare function getBackgroundAgentResult(sessionId: string): Promise<ToolResult>;
-/**
- * 백그라운드 에이전트 취소
- */
-export declare function cancelBackgroundAgent(sessionId: string): ToolResult;
-/**
- * 활성 세션 목록
- */
-export declare function listActiveSessions(): ToolResult;
-/**
- * 세션 히스토리 조회
- */
-export declare function getSessionHistory(limit?: number): ToolResult;
-/**
- * 여러 백그라운드 에이전트 동시 실행
- */
-export declare function launchParallelAgents(agentConfigs: BackgroundAgentArgs[]): Promise<ToolResult>;
+ *
+ * v2.6.0: 기능이 2개 모듈로 분리됨
+ * - SessionStore: 세션 저장소, 정리, 히스토리 관리
+ * - AgentExecutor: 에이전트 실행 로직
+ *
+ * 이 파일은 하위 호환성을 위해 모든 함수를 re-export
+ */
+export { sessionStore, listActiveSessions, getSessionHistory } from './SessionStore.js';
+export type { SessionData } from './SessionStore.js';
+export { launchBackgroundAgent, getBackgroundAgentResult, cancelBackgroundAgent, launchParallelAgents } from './AgentExecutor.js';
 //# sourceMappingURL=backgroundAgent.d.ts.map

package/dist/orchestrator/backgroundAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundAgent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/backgroundAgent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,mBAAmB,EAKpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAwD9C;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsK1F;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2CrF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAoBnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CA4B/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,UAAU,CAyBhE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mBAAmB,EAAE,GAClC,OAAO,CAAC,UAAU,CAAC,CA0CrB"}
+{"version":3,"file":"backgroundAgent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/backgroundAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC"}

package/dist/orchestrator/backgroundAgent.js

@@ -1,348 +1,14 @@
 /**
  * Background Agent - 백그라운드 에이전트 관리
- */
-import { getAgentSdkQuery } from '../lib/utils.js';
-import { DEFAULT_MODELS, AGENT } from '../lib/constants.js';
-// 활성 세션 저장소
-const activeSessions = new Map();
-// 세션 히스토리 (완료된 세션 포함)
-const sessionHistory = [];
-// TTL 설정 (기본 1시간)
-const SESSION_TTL = 60 * 60 * 1000;
-const SESSION_HISTORY_TTL = 24 * 60 * 60 * 1000; // 히스토리는 24시간
-const CLEANUP_INTERVAL = 10 * 60 * 1000; // 10분마다 정리
-// 세션 정리 함수
-function cleanupExpiredSessions() {
-    const now = Date.now();
-    // 활성 세션 정리 (TTL 초과 + running 상태인 경우 취소)
-    for (const [sessionId, session] of activeSessions.entries()) {
-        if (now - session.createdAt > SESSION_TTL) {
-            if (session.handle.status === 'running') {
-                session.cancelController.abort();
-            }
-            activeSessions.delete(sessionId);
-        }
-    }
-    // 히스토리 정리 (24시간 초과)
-    const cutoff = now - SESSION_HISTORY_TTL;
-    while (sessionHistory.length > 0 && sessionHistory[0].startTime < cutoff) {
-        sessionHistory.shift();
-    }
-}
-// 정리 타이머 시작 (모듈 로드 시 자동 시작)
-let cleanupTimer = null;
-function startCleanupTimer() {
-    if (cleanupTimer)
-        return;
-    cleanupTimer = setInterval(cleanupExpiredSessions, CLEANUP_INTERVAL);
-    // unref로 프로세스 종료를 막지 않음
-    if (cleanupTimer.unref) {
-        cleanupTimer.unref();
-    }
-}
-// 모듈 로드 시 타이머 시작
-startCleanupTimer();
-/**
- * 백그라운드 에이전트 시작
- */
-export async function launchBackgroundAgent(args) {
-    const { prompt, agentName = `agent-${Date.now()}`, model = DEFAULT_MODELS.BACKGROUND, maxTurns = AGENT.MAX_TURNS, allowedTools = AGENT.DEFAULT_ALLOWED_TOOLS, projectPath = process.cwd(), onProgress } = args;
-    const query = await getAgentSdkQuery();
-    // Agent SDK가 없으면 시뮬레이션
-    if (!query) {
-        const handle = {
-            sessionId: `simulated-${Date.now()}`,
-            agentName,
-            status: 'completed',
-            startTime: Date.now(),
-            getResult: async () => ({
-                agentName,
-                sessionId: `simulated-${Date.now()}`,
-                result: `[Agent SDK not installed] Would execute: ${prompt.slice(0, 100)}...`,
-                success: true,
-                duration: 0
-            }),
-            cancel: () => { }
-        };
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Background agent "${agentName}" started (simulated)\nSession ID: ${handle.sessionId}\n\nNote: Install @anthropic-ai/claude-agent-sdk for real execution.`
-                }],
-            handle
-        };
-    }
-    const startTime = Date.now();
-    const cancelController = new AbortController();
-    let sessionId = '';
-    let result = '';
-    let status = 'running';
-    // 결과 수집 Promise
-    const resultPromise = new Promise(async (resolve) => {
-        try {
-            const response = query({
-                prompt,
-                options: {
-                    model,
-                    maxTurns,
-                    allowedTools,
-                    cwd: projectPath
-                }
-            });
-            for await (const message of response) {
-                // 취소 체크
-                if (cancelController.signal.aborted) {
-                    status = 'cancelled';
-                    resolve({
-                        agentName,
-                        sessionId,
-                        result: 'Cancelled by user',
-                        success: false,
-                        error: 'Cancelled',
-                        duration: Date.now() - startTime
-                    });
-                    return;
-                }
-                const msg = message;
-                // 세션 ID 캡처
-                if (msg.type === 'system' && msg.subtype === 'init' && msg.session_id) {
-                    sessionId = msg.session_id;
-                }
-                // 진행 상황 콜백
-                if (msg.type === 'system' && msg.subtype === 'progress' && onProgress) {
-                    onProgress(msg.content || 'Processing...');
-                }
-                // 결과 수집
-                if (msg.type === 'result' && msg.result) {
-                    result = msg.result;
-                }
-                if (msg.type === 'assistant' && msg.message?.content) {
-                    const textContent = msg.message.content
-                        .filter(block => block.type === 'text' && block.text)
-                        .map(block => block.text)
-                        .join('\n');
-                    if (textContent) {
-                        result += textContent;
-                    }
-                }
-            }
-            status = 'completed';
-            resolve({
-                agentName,
-                sessionId,
-                result: result || 'No result',
-                success: true,
-                duration: Date.now() - startTime
-            });
-        }
-        catch (error) {
-            status = 'failed';
-            resolve({
-                agentName,
-                sessionId,
-                result: '',
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-                duration: Date.now() - startTime
-            });
-        }
-    });
-    // 핸들 생성
-    const handle = {
-        sessionId: sessionId || `pending-${Date.now()}`,
-        agentName,
-        status,
-        startTime,
-        getResult: () => resultPromise,
-        cancel: () => {
-            cancelController.abort();
-            status = 'cancelled';
-        }
-    };
-    // 세션 등록
-    activeSessions.set(handle.sessionId, {
-        handle,
-        resultPromise,
-        cancelController,
-        createdAt: startTime
-    });
-    // 완료 시 히스토리에 추가
-    resultPromise.then((result) => {
-        sessionHistory.push({
-            sessionId: result.sessionId,
-            agentName: result.agentName,
-            status: result.success ? 'completed' : 'failed',
-            startTime,
-            endTime: Date.now(),
-            prompt
-        });
-        // 활성 세션에서 제거
-        activeSessions.delete(handle.sessionId);
-    });
-    return {
-        content: [{
-                type: 'text',
-                text: `Background agent "${agentName}" started\nSession ID: ${handle.sessionId}\nModel: ${model}\nMax Turns: ${maxTurns}\n\nUse getBackgroundAgentResult("${handle.sessionId}") to check status.`
-            }],
-        handle
-    };
-}
-/**
- * 백그라운드 에이전트 결과 조회
- */
-export async function getBackgroundAgentResult(sessionId) {
-    const session = activeSessions.get(sessionId);
-    if (!session) {
-        // 히스토리에서 찾기
-        const historical = sessionHistory.find(s => s.sessionId === sessionId);
-        if (historical) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Session "${sessionId}" completed at ${new Date(historical.endTime).toISOString()}\nStatus: ${historical.status}`
-                    }]
-            };
-        }
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Session "${sessionId}" not found`
-                }]
-        };
-    }
-    // 진행 중인 세션
-    if (session.handle.status === 'running') {
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Session "${sessionId}" is still running\nAgent: ${session.handle.agentName}\nStarted: ${new Date(session.handle.startTime).toISOString()}`
-                }]
-        };
-    }
-    // 완료된 경우 결과 반환
-    const result = await session.resultPromise;
-    return {
-        content: [{
-                type: 'text',
-                text: `Session "${sessionId}" ${result.success ? 'completed' : 'failed'}\nDuration: ${(result.duration / 1000).toFixed(1)}s\n\nResult:\n${result.result}`
-            }],
-        result
-    };
-}
-/**
- * 백그라운드 에이전트 취소
- */
-export function cancelBackgroundAgent(sessionId) {
-    const session = activeSessions.get(sessionId);
-    if (!session) {
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Session "${sessionId}" not found or already completed`
-                }]
-        };
-    }
-    session.handle.cancel();
-    return {
-        content: [{
-                type: 'text',
-                text: `Session "${sessionId}" cancelled`
-            }]
-    };
-}
-/**
- * 활성 세션 목록
- */
-export function listActiveSessions() {
-    const sessions = Array.from(activeSessions.values()).map(s => ({
-        sessionId: s.handle.sessionId,
-        agentName: s.handle.agentName,
-        status: s.handle.status,
-        startTime: new Date(s.handle.startTime).toISOString(),
-        runningFor: `${((Date.now() - s.handle.startTime) / 1000).toFixed(0)}s`
-    }));
-    if (sessions.length === 0) {
-        return {
-            content: [{
-                    type: 'text',
-                    text: 'No active background agents'
-                }]
-        };
-    }
-    let summary = `## Active Background Agents (${sessions.length})\n\n`;
-    for (const session of sessions) {
-        summary += `- **${session.agentName}** (${session.sessionId})\n`;
-        summary += `  Status: ${session.status} | Running: ${session.runningFor}\n`;
-    }
-    return {
-        content: [{ type: 'text', text: summary }],
-        sessions
-    };
-}
-/**
- * 세션 히스토리 조회
- */
-export function getSessionHistory(limit = 10) {
-    const recent = sessionHistory.slice(-limit).reverse();
-    if (recent.length === 0) {
-        return {
-            content: [{
-                    type: 'text',
-                    text: 'No session history'
-                }]
-        };
-    }
-    let summary = `## Session History (last ${recent.length})\n\n`;
-    for (const session of recent) {
-        const duration = session.endTime
-            ? `${((session.endTime - session.startTime) / 1000).toFixed(1)}s`
-            : 'N/A';
-        summary += `- **${session.agentName}** (${session.sessionId})\n`;
-        summary += `  Status: ${session.status} | Duration: ${duration}\n`;
-    }
-    return {
-        content: [{ type: 'text', text: summary }],
-        history: recent
-    };
-}
-/**
- * 여러 백그라운드 에이전트 동시 실행
- */
-export async function launchParallelAgents(agentConfigs) {
-    const handles = [];
-    const errors = [];
-    // 병렬로 에이전트 시작
-    const results = await Promise.all(agentConfigs.map(async (config) => {
-        try {
-            const result = await launchBackgroundAgent(config);
-            if ('handle' in result) {
-                return result.handle;
-            }
-            return null;
-        }
-        catch (error) {
-            errors.push(`${config.agentName}: ${error instanceof Error ? error.message : String(error)}`);
-            return null;
-        }
-    }));
-    for (const result of results) {
-        if (result) {
-            handles.push(result);
-        }
-    }
-    let summary = `## Launched ${handles.length} Background Agents\n\n`;
-    for (const handle of handles) {
-        summary += `- ${handle.agentName}: ${handle.sessionId}\n`;
-    }
-    if (errors.length > 0) {
-        summary += `\n### Errors (${errors.length})\n`;
-        for (const error of errors) {
-            summary += `- ${error}\n`;
-        }
-    }
-    return {
-        content: [{ type: 'text', text: summary }],
-        handles
-    };
-}
+ *
+ * v2.6.0: 기능이 2개 모듈로 분리됨
+ * - SessionStore: 세션 저장소, 정리, 히스토리 관리
+ * - AgentExecutor: 에이전트 실행 로직
+ *
+ * 이 파일은 하위 호환성을 위해 모든 함수를 re-export
+ */
+// SessionStore
+export { sessionStore, listActiveSessions, getSessionHistory } from './SessionStore.js';
+// AgentExecutor
+export { launchBackgroundAgent, getBackgroundAgentResult, cancelBackgroundAgent, launchParallelAgents } from './AgentExecutor.js';
 //# sourceMappingURL=backgroundAgent.js.map