hanseol 3.2.7

package/dist/core/usage-tracker.js

@@ -0,0 +1,251 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+import { contextTracker } from './compact/context-tracker.js';
+const DATA_DIR = path.join(process.env['HOME'] || '.', '.hanseol');
+const USAGE_FILE = path.join(DATA_DIR, 'usage.json');
+class UsageTrackerClass {
+    data;
+    saveTimeout = null;
+    currentSession = {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        requestCount: 0,
+        startTime: Date.now(),
+        models: {},
+        lastPromptTokens: 0,
+    };
+    constructor() {
+        logger.enter('UsageTracker.constructor');
+        this.data = this.loadData();
+        logger.exit('UsageTracker.constructor');
+    }
+    loadData() {
+        logger.enter('UsageTracker.loadData');
+        try {
+            if (fs.existsSync(USAGE_FILE)) {
+                const content = fs.readFileSync(USAGE_FILE, 'utf-8');
+                const data = JSON.parse(content);
+                logger.vars({ name: 'recordCount', value: data.records.length });
+                logger.exit('UsageTracker.loadData', { loaded: true });
+                return data;
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to load usage data, starting fresh', error);
+        }
+        const emptyData = {
+            records: [],
+            dailyStats: {},
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalTokens: 0,
+            totalRequests: 0,
+            lastUpdated: new Date().toISOString(),
+        };
+        logger.exit('UsageTracker.loadData', { loaded: false });
+        return emptyData;
+    }
+    saveData() {
+        if (this.saveTimeout) {
+            clearTimeout(this.saveTimeout);
+        }
+        this.saveTimeout = setTimeout(() => {
+            logger.flow('Saving usage data');
+            try {
+                if (!fs.existsSync(DATA_DIR)) {
+                    fs.mkdirSync(DATA_DIR, { recursive: true });
+                }
+                this.data.lastUpdated = new Date().toISOString();
+                fs.writeFileSync(USAGE_FILE, JSON.stringify(this.data, null, 2));
+            }
+            catch (error) {
+                logger.error('Failed to save usage data', error);
+            }
+        }, 1000);
+    }
+    recordUsage(model, inputTokens, outputTokens, sessionId, promptTokens) {
+        logger.enter('UsageTracker.recordUsage', { model, inputTokens, outputTokens });
+        const timestamp = new Date().toISOString();
+        const date = timestamp.split('T')[0] || timestamp;
+        const totalTokens = inputTokens + outputTokens;
+        this.currentSession.inputTokens += inputTokens;
+        this.currentSession.outputTokens += outputTokens;
+        this.currentSession.totalTokens += totalTokens;
+        this.currentSession.requestCount += 1;
+        this.currentSession.models[model] = (this.currentSession.models[model] || 0) + totalTokens;
+        if (promptTokens !== undefined) {
+            this.currentSession.lastPromptTokens = promptTokens;
+            contextTracker.updateUsage(promptTokens);
+        }
+        const record = {
+            timestamp,
+            model,
+            inputTokens,
+            outputTokens,
+            totalTokens,
+            sessionId,
+        };
+        this.data.records.push(record);
+        this.data.totalInputTokens += inputTokens;
+        this.data.totalOutputTokens += outputTokens;
+        this.data.totalTokens += totalTokens;
+        this.data.totalRequests += 1;
+        if (!this.data.dailyStats[date]) {
+            this.data.dailyStats[date] = {
+                date,
+                totalInputTokens: 0,
+                totalOutputTokens: 0,
+                totalTokens: 0,
+                requestCount: 0,
+                models: {},
+            };
+        }
+        const daily = this.data.dailyStats[date];
+        daily.totalInputTokens += inputTokens;
+        daily.totalOutputTokens += outputTokens;
+        daily.totalTokens += totalTokens;
+        daily.requestCount += 1;
+        daily.models[model] = (daily.models[model] || 0) + totalTokens;
+        const thirtyDaysAgo = new Date();
+        thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
+        this.data.records = this.data.records.filter(r => new Date(r.timestamp) > thirtyDaysAgo);
+        this.saveData();
+        logger.exit('UsageTracker.recordUsage');
+    }
+    getSummary() {
+        logger.enter('UsageTracker.getSummary');
+        const today = new Date().toISOString().split('T')[0] || '';
+        const todayStats = this.data.dailyStats[today] || null;
+        const currentMonth = today.substring(0, 7);
+        let monthTokens = 0;
+        let monthRequests = 0;
+        let monthDays = 0;
+        for (const [date, stats] of Object.entries(this.data.dailyStats)) {
+            if (date.startsWith(currentMonth)) {
+                monthTokens += stats.totalTokens;
+                monthRequests += stats.requestCount;
+                monthDays += 1;
+            }
+        }
+        const firstRecord = this.data.records[0];
+        const firstUsed = firstRecord ? firstRecord.timestamp.split('T')[0] || null : null;
+        const summary = {
+            today: todayStats,
+            thisMonth: {
+                totalTokens: monthTokens,
+                totalRequests: monthRequests,
+                days: monthDays,
+            },
+            allTime: {
+                totalInputTokens: this.data.totalInputTokens,
+                totalOutputTokens: this.data.totalOutputTokens,
+                totalTokens: this.data.totalTokens,
+                totalRequests: this.data.totalRequests,
+                firstUsed,
+            },
+        };
+        logger.exit('UsageTracker.getSummary');
+        return summary;
+    }
+    getTodayUsage() {
+        const today = new Date().toISOString().split('T')[0] || '';
+        return this.data.dailyStats[today] || null;
+    }
+    getTotalTokens() {
+        return this.data.totalTokens;
+    }
+    getSessionUsage() {
+        return { ...this.currentSession };
+    }
+    getSessionElapsedSeconds() {
+        return Math.floor((Date.now() - this.currentSession.startTime) / 1000);
+    }
+    resetSession() {
+        logger.flow('Resetting session usage');
+        this.currentSession = {
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            requestCount: 0,
+            startTime: Date.now(),
+            models: {},
+            lastPromptTokens: 0,
+        };
+    }
+    formatSessionStatus(currentActivity) {
+        const elapsed = this.getSessionElapsedSeconds();
+        const tokens = this.currentSession.totalTokens;
+        let timeStr;
+        if (elapsed < 60) {
+            timeStr = `${elapsed}s`;
+        }
+        else {
+            const mins = Math.floor(elapsed / 60);
+            const secs = elapsed % 60;
+            timeStr = `${mins}m ${secs}s`;
+        }
+        let tokenStr;
+        if (tokens < 1000) {
+            tokenStr = tokens.toString();
+        }
+        else if (tokens < 1000000) {
+            tokenStr = `${(tokens / 1000).toFixed(1)}k`;
+        }
+        else {
+            tokenStr = `${(tokens / 1000000).toFixed(2)}M`;
+        }
+        const activity = currentActivity || '처리 중';
+        return `✶ ${activity}… (esc to interrupt · ${timeStr} · ↑ ${tokenStr} tokens)`;
+    }
+    formatUsageDisplay() {
+        logger.enter('UsageTracker.formatUsageDisplay');
+        const summary = this.getSummary();
+        const lines = [];
+        lines.push('📊 사용량 통계');
+        lines.push('');
+        lines.push('📅 오늘');
+        if (summary.today) {
+            lines.push(`   요청: ${summary.today.requestCount}회`);
+            lines.push(`   입력 토큰: ${summary.today.totalInputTokens.toLocaleString()}`);
+            lines.push(`   출력 토큰: ${summary.today.totalOutputTokens.toLocaleString()}`);
+            lines.push(`   총 토큰: ${summary.today.totalTokens.toLocaleString()}`);
+        }
+        else {
+            lines.push('   사용 기록 없음');
+        }
+        lines.push('');
+        lines.push('📆 이번 달');
+        lines.push(`   요청: ${summary.thisMonth.totalRequests.toLocaleString()}회`);
+        lines.push(`   총 토큰: ${summary.thisMonth.totalTokens.toLocaleString()}`);
+        lines.push(`   활성 일수: ${summary.thisMonth.days}일`);
+        lines.push('');
+        lines.push('📈 전체');
+        lines.push(`   총 요청: ${summary.allTime.totalRequests.toLocaleString()}회`);
+        lines.push(`   입력 토큰: ${summary.allTime.totalInputTokens.toLocaleString()}`);
+        lines.push(`   출력 토큰: ${summary.allTime.totalOutputTokens.toLocaleString()}`);
+        lines.push(`   총 토큰: ${summary.allTime.totalTokens.toLocaleString()}`);
+        if (summary.allTime.firstUsed) {
+            lines.push(`   최초 사용: ${summary.allTime.firstUsed}`);
+        }
+        logger.exit('UsageTracker.formatUsageDisplay');
+        return lines.join('\n');
+    }
+    clearData() {
+        logger.flow('Clearing all usage data');
+        this.data = {
+            records: [],
+            dailyStats: {},
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalTokens: 0,
+            totalRequests: 0,
+            lastUpdated: new Date().toISOString(),
+        };
+        this.saveData();
+    }
+}
+export const usageTracker = new UsageTrackerClass();
+export default usageTracker;
+//# sourceMappingURL=usage-tracker.js.map

package/dist/core/usage-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracker.js","sourceRoot":"","sources":["../../src/core/usage-tracker.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAwE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;AACnE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAKrD,MAAM,iBAAiB;IACb,IAAI,CAAY;IAChB,WAAW,GAAyC,IAAI,CAAC;IAGzD,cAAc,GAAiB;QACrC,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,EAAE;QACV,gBAAgB,EAAE,CAAC;KACpB,CAAC;IAEF;QACE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAKO,QAAQ;QACd,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjE,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,SAAS,GAAc;YAC3B,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,gBAAgB,EAAE,CAAC;YACnB,iBAAiB,EAAE,CAAC;YACpB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAKO,QAAQ;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACjC,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACjD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAc,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC;IAQD,WAAW,CACT,KAAa,EACb,WAAmB,EACnB,YAAoB,EACpB,SAAkB,EAClB,YAAqB;QAErB,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;QAE/E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAClD,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;QAG/C,IAAI,CAAC,cAAc,CAAC,WAAW,IAAI,WAAW,CAAC;QAC/C,IAAI,CAAC,cAAc,CAAC,YAAY,IAAI,YAAY,CAAC;QACjD,IAAI,CAAC,cAAc,CAAC,WAAW,IAAI,WAAW,CAAC;QAC/C,IAAI,CAAC,cAAc,CAAC,YAAY,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC;QAG3F,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,gBAAgB,GAAG,YAAY,CAAC;YAEpD,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;QAGD,MAAM,MAAM,GAAgB;YAC1B,SAAS;YACT,KAAK;YACL,WAAW;YACX,YAAY;YACZ,WAAW;YACX,SAAS;SACV,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAG/B,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,WAAW,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,YAAY,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QAG7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG;gBAC3B,IAAI;gBACJ,gBAAgB,EAAE,CAAC;gBACnB,iBAAiB,EAAE,CAAC;gBACpB,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,MAAM,EAAE,EAAE;aACX,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC;QAC1C,KAAK,CAAC,gBAAgB,IAAI,WAAW,CAAC;QACtC,KAAK,CAAC,iBAAiB,IAAI,YAAY,CAAC;QACxC,KAAK,CAAC,WAAW,IAAI,WAAW,CAAC;QACjC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QACxB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC;QAG/D,MAAM,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;QACjC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,aAAa,CAC3C,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAKD,UAAU;QACR,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAExC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAGvD,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;gBACjC,aAAa,IAAI,KAAK,CAAC,YAAY,CAAC;gBACpC,SAAS,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAGD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAEnF,MAAM,OAAO,GAAiB;YAC5B,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE;gBACT,WAAW,EAAE,WAAW;gBACxB,aAAa,EAAE,aAAa;gBAC5B,IAAI,EAAE,SAAS;aAChB;YACD,OAAO,EAAE;gBACP,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAC5C,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB;gBAC9C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;gBAClC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;gBACtC,SAAS;aACV;SACF,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAKD,aAAa;QACX,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7C,CAAC;IAKD,cAAc;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;IAC/B,CAAC;IAKD,eAAe;QACb,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAKD,wBAAwB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IACzE,CAAC;IAKD,YAAY;QACV,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG;YACpB,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,EAAE;YACV,gBAAgB,EAAE,CAAC;SACpB,CAAC;IACJ,CAAC;IAMD,mBAAmB,CAAC,eAAwB;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;QAG/C,IAAI,OAAe,CAAC;QACpB,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,OAAO,GAAG,GAAG,OAAO,GAAG,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;YAC1B,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;QAChC,CAAC;QAGD,IAAI,QAAgB,CAAC;QACrB,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;YAClB,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC/B,CAAC;aAAM,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;YAC5B,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QACjD,CAAC;QAGD,MAAM,QAAQ,GAAG,eAAe,IAAI,MAAM,CAAC;QAC3C,OAAO,KAAK,QAAQ,yBAAyB,OAAO,QAAQ,QAAQ,UAAU,CAAC;IACjF,CAAC;IAKD,kBAAkB;QAChB,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAEhD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAGf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAGf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAGf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAKD,SAAS;QACP,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG;YACV,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,gBAAgB,EAAE,CAAC;YACnB,iBAAiB,EAAE,CAAC;YACpB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;CACF;AAGD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEpD,eAAe,YAAY,CAAC"}

package/dist/errors/base.d.ts

@@ -0,0 +1,22 @@
+export interface ErrorDetails {
+    [key: string]: unknown;
+}
+export interface ErrorOptions {
+    cause?: Error;
+    details?: ErrorDetails;
+    isRecoverable?: boolean;
+    userMessage?: string;
+}
+export declare class BaseError extends Error {
+    readonly code: string;
+    readonly cause?: Error;
+    readonly details?: ErrorDetails;
+    readonly isRecoverable: boolean;
+    readonly userMessage: string;
+    readonly timestamp: Date;
+    constructor(message: string, code: string, options?: ErrorOptions);
+    toJSON(): Record<string, unknown>;
+    getUserMessage(): string;
+    canRecover(): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;IACvC,SAAgB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB;IAmB5B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBjC,cAAc,IAAI,MAAM;IAOxB,UAAU,IAAI,OAAO;CAGtB"}

package/dist/errors/base.js

@@ -0,0 +1,43 @@
+export class BaseError extends Error {
+    code;
+    cause;
+    details;
+    isRecoverable;
+    userMessage;
+    timestamp;
+    constructor(message, code, options = {}) {
+        super(message);
+        this.name = this.constructor.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.code = code;
+        this.cause = options.cause;
+        this.details = options.details;
+        this.isRecoverable = options.isRecoverable ?? false;
+        this.userMessage = options.userMessage ?? message;
+        this.timestamp = new Date();
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            userMessage: this.userMessage,
+            isRecoverable: this.isRecoverable,
+            details: this.details,
+            timestamp: this.timestamp,
+            stack: this.stack,
+            cause: this.cause ? {
+                name: this.cause.name,
+                message: this.cause.message,
+            } : undefined,
+        };
+    }
+    getUserMessage() {
+        return this.userMessage;
+    }
+    canRecover() {
+        return this.isRecoverable;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAS;IACJ,KAAK,CAAS;IACvB,OAAO,CAAgB;IACvB,aAAa,CAAU;IACvB,WAAW,CAAS;IACpB,SAAS,CAAO;IAEhC,YACE,OAAe,EACf,IAAY,EACZ,UAAwB,EAAE;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAG5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAKD,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBACrB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;aAC5B,CAAC,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAKD,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAKD,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/errors/file.d.ts

@@ -0,0 +1,31 @@
+import { BaseError, ErrorOptions } from './base.js';
+export declare class FileSystemError extends BaseError {
+    readonly path?: string;
+    constructor(message: string, path?: string, options?: ErrorOptions);
+}
+export declare class FileNotFoundError extends BaseError {
+    readonly path: string;
+    constructor(path: string, options?: ErrorOptions);
+}
+export declare class DirectoryNotFoundError extends BaseError {
+    readonly path: string;
+    constructor(path: string, options?: ErrorOptions);
+}
+export declare class PermissionError extends BaseError {
+    readonly path?: string;
+    readonly operation?: string;
+    constructor(message: string, path?: string, operation?: string, options?: ErrorOptions);
+}
+export declare class FileReadError extends BaseError {
+    readonly path: string;
+    constructor(path: string, options?: ErrorOptions);
+}
+export declare class FileWriteError extends BaseError {
+    readonly path: string;
+    constructor(path: string, options?: ErrorOptions);
+}
+export declare class InvalidPathError extends BaseError {
+    readonly path: string;
+    constructor(path: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/errors/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/errors/file.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKpD,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBvE;AAKD,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBrD;AAKD,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBrD;AAKD,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,YAAiB;CAmB7B;AAKD,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBrD;AAKD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBrD;AAKD,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgBrD"}

package/dist/errors/file.js

@@ -0,0 +1,110 @@
+import { BaseError } from './base.js';
+export class FileSystemError extends BaseError {
+    path;
+    constructor(message, path, options = {}) {
+        super(message, 'FILE_SYSTEM_ERROR', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: options.isRecoverable ?? false,
+            userMessage: options.userMessage ?? `파일 시스템 오류가 발생했습니다${path ? ` (경로: ${path})` : ''}.`,
+        });
+        this.path = path;
+    }
+}
+export class FileNotFoundError extends BaseError {
+    path;
+    constructor(path, options = {}) {
+        super(`File not found: ${path}`, 'FILE_NOT_FOUND', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: false,
+            userMessage: options.userMessage ?? `파일을 찾을 수 없습니다: ${path}`,
+        });
+        this.path = path;
+    }
+}
+export class DirectoryNotFoundError extends BaseError {
+    path;
+    constructor(path, options = {}) {
+        super(`Directory not found: ${path}`, 'DIRECTORY_NOT_FOUND', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: false,
+            userMessage: options.userMessage ?? `디렉토리를 찾을 수 없습니다: ${path}`,
+        });
+        this.path = path;
+    }
+}
+export class PermissionError extends BaseError {
+    path;
+    operation;
+    constructor(message, path, operation, options = {}) {
+        super(message, 'PERMISSION_ERROR', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+                operation,
+            },
+            isRecoverable: false,
+            userMessage: options.userMessage ?? `권한이 없습니다${path ? `: ${path}` : ''}${operation ? ` (작업: ${operation})` : ''}.`,
+        });
+        this.path = path;
+        this.operation = operation;
+    }
+}
+export class FileReadError extends BaseError {
+    path;
+    constructor(path, options = {}) {
+        super(`Failed to read file: ${path}`, 'FILE_READ_ERROR', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: false,
+            userMessage: options.userMessage ?? `파일을 읽을 수 없습니다: ${path}`,
+        });
+        this.path = path;
+    }
+}
+export class FileWriteError extends BaseError {
+    path;
+    constructor(path, options = {}) {
+        super(`Failed to write file: ${path}`, 'FILE_WRITE_ERROR', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: true,
+            userMessage: options.userMessage ?? `파일을 쓸 수 없습니다: ${path}. 디스크 공간을 확인해주세요.`,
+        });
+        this.path = path;
+    }
+}
+export class InvalidPathError extends BaseError {
+    path;
+    constructor(path, options = {}) {
+        super(`Invalid path: ${path}`, 'INVALID_PATH_ERROR', {
+            ...options,
+            details: {
+                ...options.details,
+                path,
+            },
+            isRecoverable: true,
+            userMessage: options.userMessage ?? `잘못된 경로입니다: ${path}`,
+        });
+        this.path = path;
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/errors/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/errors/file.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAgB,MAAM,WAAW,CAAC;AAKpD,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,IAAa,EAAE,UAAwB,EAAE;QACpE,KAAK,CACH,OAAO,EACP,mBAAmB,EACnB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,KAAK;YAC7C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;SACxF,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAKD,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,UAAwB,EAAE;QAClD,KAAK,CACH,mBAAmB,IAAI,EAAE,EACzB,gBAAgB,EAChB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,kBAAkB,IAAI,EAAE;SAC7D,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAKD,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACnC,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,UAAwB,EAAE;QAClD,KAAK,CACH,wBAAwB,IAAI,EAAE,EAC9B,qBAAqB,EACrB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB,IAAI,EAAE;SAC/D,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAKD,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,IAAI,CAAU;IACd,SAAS,CAAU;IAEnC,YACE,OAAe,EACf,IAAa,EACb,SAAkB,EAClB,UAAwB,EAAE;QAE1B,KAAK,CACH,OAAO,EACP,kBAAkB,EAClB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;gBACJ,SAAS;aACV;YACD,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,WAAW,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;SACnH,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAKD,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,UAAwB,EAAE;QAClD,KAAK,CACH,wBAAwB,IAAI,EAAE,EAC9B,iBAAiB,EACjB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,kBAAkB,IAAI,EAAE;SAC7D,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAKD,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,UAAwB,EAAE;QAClD,KAAK,CACH,yBAAyB,IAAI,EAAE,EAC/B,kBAAkB,EAClB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,iBAAiB,IAAI,mBAAmB;SAC7E,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAKD,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,UAAwB,EAAE;QAClD,KAAK,CACH,iBAAiB,IAAI,EAAE,EACvB,oBAAoB,EACpB;YACE,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI;aACL;YACD,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,cAAc,IAAI,EAAE;SACzD,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,10 @@
+export { BaseError } from './base.js';
+export type { ErrorDetails, ErrorOptions } from './base.js';
+export { NetworkError, APIError, TimeoutError, ConnectionError, } from './network.js';
+export { ValidationError, InputError, RequiredFieldError, InvalidFormatError, } from './validation.js';
+export { LLMError, StreamingError, ModelError, TokenLimitError, RateLimitError, ContextLengthError, } from './llm.js';
+export { FileSystemError, FileNotFoundError, DirectoryNotFoundError, PermissionError, FileReadError, FileWriteError, InvalidPathError, } from './file.js';
+export declare function isRecoverableError(error: unknown): boolean;
+export declare function getUserMessage(error: unknown): string;
+export declare function errorToJSON(error: unknown): Record<string, unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG5D,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAKnB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAKD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWrD;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAenE"}

package/dist/errors/index.js

@@ -0,0 +1,41 @@
+export { BaseError } from './base.js';
+export { NetworkError, APIError, TimeoutError, ConnectionError, } from './network.js';
+export { ValidationError, InputError, RequiredFieldError, InvalidFormatError, } from './validation.js';
+export { LLMError, StreamingError, ModelError, TokenLimitError, RateLimitError, ContextLengthError, } from './llm.js';
+export { FileSystemError, FileNotFoundError, DirectoryNotFoundError, PermissionError, FileReadError, FileWriteError, InvalidPathError, } from './file.js';
+export function isRecoverableError(error) {
+    if (error && typeof error === 'object' && 'canRecover' in error) {
+        const baseError = error;
+        return baseError.canRecover();
+    }
+    return false;
+}
+export function getUserMessage(error) {
+    if (error && typeof error === 'object') {
+        if ('getUserMessage' in error) {
+            const baseError = error;
+            return baseError.getUserMessage();
+        }
+        if (error instanceof Error) {
+            return error.message;
+        }
+    }
+    return String(error);
+}
+export function errorToJSON(error) {
+    if (error && typeof error === 'object' && 'toJSON' in error) {
+        const baseError = error;
+        return baseError.toJSON();
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    return {
+        error: String(error),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAKnB,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,KAAuB,CAAC;QAC1C,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,gBAAgB,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,KAAuB,CAAC;YAC1C,OAAO,SAAS,CAAC,cAAc,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAuB,CAAC;QAC1C,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;KACrB,CAAC;AACJ,CAAC"}

package/dist/errors/llm.d.ts

@@ -0,0 +1,26 @@
+import { BaseError, ErrorOptions } from './base.js';
+export declare class LLMError extends BaseError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class StreamingError extends BaseError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ModelError extends BaseError {
+    readonly modelId?: string;
+    constructor(message: string, modelId?: string, options?: ErrorOptions);
+}
+export declare class TokenLimitError extends BaseError {
+    readonly limit: number;
+    readonly actual?: number;
+    constructor(limit: number, actual?: number, options?: ErrorOptions);
+}
+export declare class RateLimitError extends BaseError {
+    readonly retryAfter?: number;
+    constructor(retryAfter?: number, options?: ErrorOptions);
+}
+export declare class ContextLengthError extends BaseError {
+    readonly maxLength: number;
+    readonly actualLength?: number;
+    constructor(maxLength: number, actualLength?: number, options?: ErrorOptions);
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/errors/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/errors/llm.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKpD,qBAAa,QAAS,SAAQ,SAAS;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAWxD;AAKD,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAWxD;AAKD,qBAAa,UAAW,SAAQ,SAAS;IACvC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgB1E;AAKD,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAG9B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB;CAmB7B;AAKD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;CAgB5D;AAKD,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;gBAGpC,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,GAAE,YAAiB;CAmB7B"}