@su-record/vibe 2.7.2 → 2.7.5

package/dist/agent/preprocessors/MediaPreprocessor.d.ts

@@ -0,0 +1,63 @@
+/**
+ * MediaPreprocessor - 미디어 메시지 전처리
+ * Phase 5: Voice Flow Integration
+ *
+ * 기능:
+ * - voice → gemini_stt 자동 호출 (텍스트 변환)
+ * - image → Gemini analyzeImage로 설명 생성
+ * - file → 파일 메타데이터 추출
+ * - 음성 파일 20MB 크기 제한
+ */
+import type { ExternalMessage } from '../../interface/types.js';
+export interface PreprocessResult {
+    success: boolean;
+    transcribedText?: string;
+    error?: string;
+}
+export interface MediaPreprocessorConfig {
+    showConfirmation?: boolean;
+}
+/** 파일 다운로더 (Telegram downloadFile 등) */
+export type FileDownloader = (fileId: string) => Promise<Buffer>;
+export type SendFn = (chatId: string, text: string) => Promise<void>;
+export declare class MediaPreprocessor {
+    private config;
+    private fileDownloader?;
+    constructor(config?: MediaPreprocessorConfig, fileDownloader?: FileDownloader);
+    /** 파일 다운로더 설정 (런타임에 TelegramBot.downloadFile 등 주입) */
+    setFileDownloader(downloader: FileDownloader): void;
+    preprocess(message: ExternalMessage, sendFn: SendFn): Promise<PreprocessResult>;
+    /** Phase 2: Process all FileAttachments + location */
+    private handleFileAttachments;
+    /** Route a single FileAttachment to its handler */
+    private processAttachment;
+    /** STT from local voice/audio file */
+    private processVoiceFile;
+    /** Vision analysis from local photo file */
+    private processPhotoFile;
+    /** Extract text from document or return metadata description */
+    private processDocumentFile;
+    /** Read text-based files directly */
+    private extractTextFile;
+    /** Video metadata description (frame extraction deferred) */
+    private processVideoFile;
+    private handleVoice;
+    /** 파일 다운로드 (downloader가 없으면 null) */
+    private downloadVoiceFile;
+    private handleFile;
+    private handleImage;
+    private cleanupTimer;
+    /** Start periodic file cleanup (call from daemon init) */
+    startFileCleanup(): void;
+    /** Stop periodic file cleanup */
+    stopFileCleanup(): void;
+    /** Clean up old files (TTL 24h) and enforce 500MB quota */
+    private runFileCleanup;
+    /** Collect msg_* directories with size and mtime */
+    private collectFileEntries;
+    /** Recursively find msg_* directories */
+    private walkMsgDirs;
+    /** Calculate total size of a directory */
+    private dirSize;
+}
+//# sourceMappingURL=MediaPreprocessor.d.ts.map

package/dist/agent/preprocessors/MediaPreprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaPreprocessor.d.ts","sourceRoot":"","sources":["../../../src/agent/preprocessors/MediaPreprocessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,0BAA0B,CAAC;AAOhF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,MAAM,CAAC,EAAE,uBAAuB,EAAE,cAAc,CAAC,EAAE,cAAc;IAK7E,sDAAsD;IACtD,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAI7C,UAAU,CACd,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAiB5B,sDAAsD;YACxC,qBAAqB;IAyBnC,mDAAmD;YACrC,iBAAiB;IAoB/B,sCAAsC;YACxB,gBAAgB;IAoB9B,4CAA4C;YAC9B,gBAAgB;IAqB9B,gEAAgE;YAClD,mBAAmB;IAYjC,qCAAqC;IACrC,OAAO,CAAC,eAAe;IAavB,6DAA6D;YAC/C,gBAAgB;YAMhB,WAAW;IAqDzB,qCAAqC;YACvB,iBAAiB;YAOjB,UAAU;YAcV,WAAW;IAuBzB,OAAO,CAAC,YAAY,CAA+C;IAEnE,0DAA0D;IAC1D,gBAAgB,IAAI,IAAI;IAKxB,iCAAiC;IACjC,eAAe,IAAI,IAAI;IAOvB,2DAA2D;IAC3D,OAAO,CAAC,cAAc;IA8BtB,oDAAoD;IACpD,OAAO,CAAC,kBAAkB;IAQ1B,yCAAyC;IACzC,OAAO,CAAC,WAAW;IAkBnB,0CAA0C;IAC1C,OAAO,CAAC,OAAO;CAahB"}

package/dist/agent/preprocessors/MediaPreprocessor.js

@@ -0,0 +1,320 @@
+/**
+ * MediaPreprocessor - 미디어 메시지 전처리
+ * Phase 5: Voice Flow Integration
+ *
+ * 기능:
+ * - voice → gemini_stt 자동 호출 (텍스트 변환)
+ * - image → Gemini analyzeImage로 설명 생성
+ * - file → 파일 메타데이터 추출
+ * - 음성 파일 20MB 크기 제한
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+const MAX_VOICE_SIZE_BYTES = 20 * 1024 * 1024; // 20MB
+const FILE_TTL_MS = 24 * 60 * 60 * 1000; // 24시간
+const MAX_QUOTA_BYTES = 500 * 1024 * 1024; // 500MB
+const CLEANUP_INTERVAL_MS = 10 * 60 * 1000; // 10분
+export class MediaPreprocessor {
+    config;
+    fileDownloader;
+    constructor(config, fileDownloader) {
+        this.config = { showConfirmation: true, ...config };
+        this.fileDownloader = fileDownloader;
+    }
+    /** 파일 다운로더 설정 (런타임에 TelegramBot.downloadFile 등 주입) */
+    setFileDownloader(downloader) {
+        this.fileDownloader = downloader;
+    }
+    async preprocess(message, sendFn) {
+        // Phase 2: FileAttachment[] based processing
+        if (message.files?.length || message.location) {
+            return this.handleFileAttachments(message, sendFn);
+        }
+        // Legacy: metadata-based processing (backward compat)
+        switch (message.type) {
+            case 'voice':
+                return this.handleVoice(message, sendFn);
+            case 'file':
+                return this.handleFile(message);
+            default:
+                return { success: true };
+        }
+    }
+    /** Phase 2: Process all FileAttachments + location */
+    async handleFileAttachments(message, sendFn) {
+        const descriptions = [];
+        if (message.files) {
+            for (const file of message.files) {
+                const desc = await this.processAttachment(file, message, sendFn);
+                if (desc)
+                    descriptions.push(desc);
+            }
+        }
+        if (message.location) {
+            const { latitude, longitude } = message.location;
+            const mapUrl = `https://maps.google.com/?q=${latitude},${longitude}`;
+            descriptions.push(`[위치: ${latitude}, ${longitude}] ${mapUrl}`);
+        }
+        if (descriptions.length > 0) {
+            return { success: true, transcribedText: descriptions.join('\n\n') };
+        }
+        return { success: true };
+    }
+    /** Route a single FileAttachment to its handler */
+    async processAttachment(file, message, sendFn) {
+        switch (file.type) {
+            case 'voice':
+            case 'audio':
+                return this.processVoiceFile(file, message, sendFn);
+            case 'photo':
+                return this.processPhotoFile(file, message, sendFn);
+            case 'document':
+                return this.processDocumentFile(file);
+            case 'video':
+                return this.processVideoFile(file);
+            default:
+                return null;
+        }
+    }
+    /** STT from local voice/audio file */
+    async processVoiceFile(file, message, sendFn) {
+        if (!fs.existsSync(file.path))
+            return null;
+        try {
+            const { transcribeAudio } = await import('../../infra/lib/gemini/capabilities.js');
+            const result = await transcribeAudio(file.path, { language: 'Korean' });
+            const text = result.transcription?.trim();
+            if (!text)
+                return null;
+            if (this.config.showConfirmation) {
+                await sendFn(message.chatId, `음성 인식: "${text}"`);
+            }
+            return text;
+        }
+        catch {
+            return `[음성 파일: ${file.name}]`;
+        }
+    }
+    /** Vision analysis from local photo file */
+    async processPhotoFile(file, message, sendFn) {
+        if (!fs.existsSync(file.path))
+            return `[이미지: ${file.name}]`;
+        try {
+            if (this.config.showConfirmation) {
+                await sendFn(message.chatId, '🔄 이미지 분석 중...');
+            }
+            const { analyzeImage } = await import('../../infra/lib/gemini/capabilities.js');
+            const description = await analyzeImage(file.path, '이 이미지를 한국어로 자세히 설명해주세요.');
+            if (this.config.showConfirmation) {
+                await sendFn(message.chatId, '✅ 이미지 분석 완료!');
+            }
+            return `[이미지 설명]\n${description}`;
+        }
+        catch {
+            return `[이미지: ${file.name}]`;
+        }
+    }
+    /** Extract text from document or return metadata description */
+    async processDocumentFile(file) {
+        if (!fs.existsSync(file.path)) {
+            return `[파일: ${file.name}]`;
+        }
+        const ext = path.extname(file.name).toLowerCase();
+        if (['.txt', '.csv', '.json', '.md', '.log'].includes(ext)) {
+            return this.extractTextFile(file);
+        }
+        const sizeKB = file.size ? Math.round(file.size / 1024) : 0;
+        return `[파일: ${file.name}, 크기: ${sizeKB}KB, 형식: ${file.mimeType || ext}]`;
+    }
+    /** Read text-based files directly */
+    extractTextFile(file) {
+        try {
+            const content = fs.readFileSync(file.path, 'utf-8');
+            const MAX_CHARS = 4000;
+            const trimmed = content.length > MAX_CHARS
+                ? content.slice(0, MAX_CHARS) + '\n...(잘림)'
+                : content;
+            return `[${file.name} 내용]\n${trimmed}`;
+        }
+        catch {
+            return `[파일: ${file.name} (읽기 실패)]`;
+        }
+    }
+    /** Video metadata description (frame extraction deferred) */
+    async processVideoFile(file) {
+        const sizeKB = file.size ? Math.round(file.size / 1024) : 0;
+        const dur = file.duration ? `, 길이: ${file.duration}초` : '';
+        return `[동영상: ${file.name}, 크기: ${sizeKB}KB${dur}]`;
+    }
+    async handleVoice(message, sendFn) {
+        const fileId = message.metadata?.telegramFileId;
+        if (!fileId) {
+            return { success: false, error: '음성 파일 정보가 없습니다.' };
+        }
+        // Check file size
+        const fileSize = message.metadata?.fileSize;
+        if (fileSize && fileSize > MAX_VOICE_SIZE_BYTES) {
+            return { success: false, error: '음성 파일이 너무 큽니다 (최대 20MB)' };
+        }
+        try {
+            // 파일 다운로드 → 임시 저장 → STT
+            const audioBuffer = await this.downloadVoiceFile(fileId);
+            if (!audioBuffer) {
+                return { success: false, error: '음성 파일 다운로드에 실패했습니다.' };
+            }
+            const mimeType = message.metadata?.voiceMimeType || 'audio/ogg';
+            const ext = mimeType.includes('ogg') ? '.ogg' : '.mp3';
+            const tmpDir = path.join(os.tmpdir(), 'vibe-stt');
+            if (!fs.existsSync(tmpDir)) {
+                fs.mkdirSync(tmpDir, { recursive: true });
+            }
+            const tmpFile = path.join(tmpDir, `voice-${Date.now()}${ext}`);
+            fs.writeFileSync(tmpFile, audioBuffer);
+            try {
+                const { transcribeAudio } = await import('../../infra/lib/gemini/capabilities.js');
+                const result = await transcribeAudio(tmpFile, { language: 'Korean' });
+                const text = result.transcription?.trim();
+                if (!text) {
+                    return { success: false, error: '음성을 인식하지 못했습니다. 다시 시도해주세요.' };
+                }
+                if (this.config.showConfirmation) {
+                    await sendFn(message.chatId, `음성 인식: "${text}"`);
+                }
+                return { success: true, transcribedText: text };
+            }
+            finally {
+                try {
+                    fs.unlinkSync(tmpFile);
+                }
+                catch { /* ignore */ }
+            }
+        }
+        catch {
+            return { success: false, error: '음성을 인식하지 못했습니다. 다시 시도해주세요.' };
+        }
+    }
+    /** 파일 다운로드 (downloader가 없으면 null) */
+    async downloadVoiceFile(fileId) {
+        if (!this.fileDownloader) {
+            return null;
+        }
+        return this.fileDownloader(fileId);
+    }
+    async handleFile(message) {
+        const fileName = message.content || 'unknown';
+        const mimeType = message.metadata?.fileMimeType || '';
+        // Image files → analyze
+        if (mimeType.startsWith('image/')) {
+            return this.handleImage(message, fileName, mimeType);
+        }
+        // Other files → metadata description
+        const description = `파일 분석 요청: ${fileName} (${mimeType})`;
+        return { success: true, transcribedText: description };
+    }
+    async handleImage(message, fileName, mimeType) {
+        const fileId = message.metadata?.telegramFileId;
+        if (!fileId) {
+            return { success: true, transcribedText: `이미지 분석 요청: ${fileName}` };
+        }
+        try {
+            const { analyzeImage } = await import('../../infra/lib/gemini/capabilities.js');
+            const description = await analyzeImage(fileId, '이 이미지를 한국어로 자세히 설명해주세요.');
+            return { success: true, transcribedText: `[이미지 설명]\n${description}` };
+        }
+        catch {
+            return { success: true, transcribedText: `이미지 분석 요청: ${fileName} (${mimeType})` };
+        }
+    }
+    // ========================================================================
+    // File Retention (Phase 2-5)
+    // ========================================================================
+    cleanupTimer = null;
+    /** Start periodic file cleanup (call from daemon init) */
+    startFileCleanup() {
+        this.runFileCleanup(); // 1회 즉시 실행
+        this.cleanupTimer = setInterval(() => this.runFileCleanup(), CLEANUP_INTERVAL_MS);
+    }
+    /** Stop periodic file cleanup */
+    stopFileCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /** Clean up old files (TTL 24h) and enforce 500MB quota */
+    runFileCleanup() {
+        const baseDir = path.join(os.homedir(), '.vibe', 'files');
+        if (!fs.existsSync(baseDir))
+            return;
+        try {
+            const entries = this.collectFileEntries(baseDir);
+            const now = Date.now();
+            // Phase 1: Delete TTL-expired files
+            for (const entry of entries) {
+                if (now - entry.mtimeMs > FILE_TTL_MS) {
+                    try {
+                        fs.rmSync(entry.dir, { recursive: true, force: true });
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            // Phase 2: Enforce quota (delete oldest first)
+            const remaining = this.collectFileEntries(baseDir);
+            let totalSize = remaining.reduce((sum, e) => sum + e.size, 0);
+            const sorted = remaining.sort((a, b) => a.mtimeMs - b.mtimeMs);
+            for (const entry of sorted) {
+                if (totalSize <= MAX_QUOTA_BYTES)
+                    break;
+                try {
+                    fs.rmSync(entry.dir, { recursive: true, force: true });
+                    totalSize -= entry.size;
+                }
+                catch { /* ignore */ }
+            }
+        }
+        catch { /* ignore cleanup errors */ }
+    }
+    /** Collect msg_* directories with size and mtime */
+    collectFileEntries(baseDir) {
+        const results = [];
+        try {
+            this.walkMsgDirs(baseDir, results);
+        }
+        catch { /* ignore */ }
+        return results;
+    }
+    /** Recursively find msg_* directories */
+    walkMsgDirs(dir, results) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            if (entry.name.startsWith('msg_')) {
+                const stat = fs.statSync(fullPath);
+                const size = this.dirSize(fullPath);
+                results.push({ dir: fullPath, size, mtimeMs: stat.mtimeMs });
+            }
+            else {
+                this.walkMsgDirs(fullPath, results);
+            }
+        }
+    }
+    /** Calculate total size of a directory */
+    dirSize(dir) {
+        let total = 0;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isFile()) {
+                    total += fs.statSync(fullPath).size;
+                }
+            }
+        }
+        catch { /* ignore */ }
+        return total;
+    }
+}
+//# sourceMappingURL=MediaPreprocessor.js.map

package/dist/agent/preprocessors/MediaPreprocessor.js.map

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

package/dist/agent/providers/claude-head.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude HeadModel Provider (Fallback)
+ * Phase 1: Head Model Selection & Tool Registry
+ *
+ * Claude Opus 4.6을 fallback 헤드 모델로 사용.
+ * Anthropic Messages API를 직접 호출하여 tool use 수행.
+ */
+import type { AgentMessage, AgentToolDefinition, HeadModelProvider, HeadModelProviderType, HeadModelResponse } from '../types.js';
+export declare class ClaudeHeadModelProvider implements HeadModelProvider {
+    readonly provider: HeadModelProviderType;
+    readonly model: string;
+    chat(messages: AgentMessage[], tools?: AgentToolDefinition[]): Promise<HeadModelResponse>;
+}
+export declare class ClaudeHeadError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=claude-head.d.ts.map

package/dist/agent/providers/claude-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-head.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/claude-head.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAoHrB,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAY;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAY;IAE5B,IAAI,CACR,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,CAAC,EAAE,mBAAmB,EAAE,GAC5B,OAAO,CAAC,iBAAiB,CAAC;CAkC9B;AAID,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/agent/providers/claude-head.js

@@ -0,0 +1,124 @@
+/**
+ * Claude HeadModel Provider (Fallback)
+ * Phase 1: Head Model Selection & Tool Registry
+ *
+ * Claude Opus 4.6을 fallback 헤드 모델로 사용.
+ * Anthropic Messages API를 직접 호출하여 tool use 수행.
+ */
+const MODEL_ID = 'claude-opus-4-6';
+const API_URL = 'https://api.anthropic.com/v1/messages';
+const API_VERSION = '2023-06-01';
+const MAX_TOKENS = 8192;
+// === Helper Functions ===
+function getApiKey() {
+    const key = process.env.ANTHROPIC_API_KEY;
+    if (!key) {
+        throw new ClaudeHeadError('ANTHROPIC_API_KEY environment variable is not set');
+    }
+    return key;
+}
+function convertMessagesToAnthropic(messages) {
+    let system = '';
+    const apiMessages = [];
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            system = msg.content;
+            continue;
+        }
+        if (msg.role === 'tool') {
+            apiMessages.push({
+                role: 'user',
+                content: [{
+                        type: 'tool_result',
+                        tool_use_id: msg.toolCallId,
+                        content: msg.content,
+                    }],
+            });
+            continue;
+        }
+        if (msg.role === 'assistant' && msg.toolCalls?.length) {
+            const blocks = [];
+            if (msg.content)
+                blocks.push({ type: 'text', text: msg.content });
+            for (const tc of msg.toolCalls) {
+                blocks.push({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.arguments });
+            }
+            apiMessages.push({ role: 'assistant', content: blocks });
+            continue;
+        }
+        const role = msg.role === 'assistant' ? 'assistant' : 'user';
+        apiMessages.push({ role, content: msg.content });
+    }
+    return { system, messages: apiMessages };
+}
+function convertToolsToAnthropic(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        input_schema: t.parameters,
+    }));
+}
+function parseAnthropicResponse(result) {
+    let textContent = '';
+    const toolCalls = [];
+    for (const block of result.content) {
+        if (block.type === 'text' && block.text) {
+            textContent += block.text;
+        }
+        if (block.type === 'tool_use' && block.id && block.name) {
+            toolCalls.push({
+                id: block.id,
+                name: block.name,
+                arguments: (block.input ?? {}),
+            });
+        }
+    }
+    return {
+        content: textContent,
+        toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+        finishReason: result.stop_reason,
+        model: result.model || MODEL_ID,
+    };
+}
+// === Claude Head Provider ===
+export class ClaudeHeadModelProvider {
+    provider = 'claude';
+    model = MODEL_ID;
+    async chat(messages, tools) {
+        const apiKey = getApiKey();
+        const { system, messages: apiMessages } = convertMessagesToAnthropic(messages);
+        const anthropicTools = tools?.length ? convertToolsToAnthropic(tools) : undefined;
+        const requestBody = {
+            model: MODEL_ID,
+            max_tokens: MAX_TOKENS,
+            messages: apiMessages,
+        };
+        if (system)
+            requestBody.system = system;
+        if (anthropicTools?.length)
+            requestBody.tools = anthropicTools;
+        const response = await fetch(API_URL, {
+            method: 'POST',
+            headers: {
+                'x-api-key': apiKey,
+                'anthropic-version': API_VERSION,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new ClaudeHeadError(`Claude HeadModel API error (${response.status}): ${errorText.substring(0, 200)}`);
+        }
+        const result = (await response.json());
+        return parseAnthropicResponse(result);
+    }
+}
+// === Error Type ===
+export class ClaudeHeadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ClaudeHeadError';
+    }
+}
+//# sourceMappingURL=claude-head.js.map

package/dist/agent/providers/claude-head.js.map

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

package/dist/agent/providers/gpt-head.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GPT HeadModel Provider
+ * Phase 1: Head Model Selection & Tool Registry
+ *
+ * OpenAI Responses API 사용 (Chat Completions 아님)
+ * - OAuth: chatgpt.com/backend-api/codex/responses
+ * - API Key: api.openai.com/v1/responses
+ * - Azure: chat/completions (Responses API 미지원)
+ * Temperature=0 고정 (결정론적 tool selection)
+ */
+import type { AgentMessage, AgentToolDefinition, HeadModelProvider, HeadModelProviderType, HeadModelResponse } from '../types.js';
+export declare class GptHeadModelProvider implements HeadModelProvider {
+    readonly provider: HeadModelProviderType;
+    readonly model: string;
+    chat(messages: AgentMessage[], tools?: AgentToolDefinition[]): Promise<HeadModelResponse>;
+    private callResponsesApi;
+    /**
+     * ChatGPT backend SSE 스트리밍 응답 파싱
+     * response.completed 이벤트에서 최종 결과 추출
+     */
+    private parseSSEResponse;
+    private callChatCompletionsApi;
+}
+export declare class GptHeadError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    constructor(statusCode: number, responseBody: string);
+    isRetryable(): boolean;
+}
+//# sourceMappingURL=gpt-head.d.ts.map

package/dist/agent/providers/gpt-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpt-head.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/gpt-head.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAyRrB,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAS;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAY;IAE5B,IAAI,CACR,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,CAAC,EAAE,mBAAmB,EAAE,GAC5B,OAAO,CAAC,iBAAiB,CAAC;YAUf,gBAAgB;IAuD9B;;;OAGG;YACW,gBAAgB;YAyEhB,sBAAsB;CAgCrC;AAID,qBAAa,YAAa,SAAQ,KAAK;aAEnB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBADpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;IAOtC,WAAW,IAAI,OAAO;CAGvB"}