agent-ide 0.1.0

package/dist/infrastructure/cache/index.js.map

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

package/dist/infrastructure/cache/memory-cache.d.ts

@@ -0,0 +1,94 @@
+import { type CacheOptions, type CacheStats, type CacheEventListener } from './types.js';
+/**
+ * 高效能記憶體快取實作，支援多種淘汰策略
+ */
+export declare class MemoryCache<K, V> {
+    private readonly cache;
+    private readonly options;
+    private readonly listeners;
+    private readonly strategy;
+    private stats;
+    private cleanupTimer?;
+    constructor(options?: CacheOptions);
+    /**
+     * 取得快取值
+     */
+    get(key: K): V | undefined;
+    /**
+     * 設定快取值
+     */
+    set(key: K, value: V, customTTL?: number): void;
+    /**
+     * 檢查鍵是否存在（不更新存取時間）
+     */
+    has(key: K): boolean;
+    /**
+     * 刪除快取項目
+     */
+    delete(key: K): boolean;
+    /**
+     * 清空所有快取
+     */
+    clear(): void;
+    /**
+     * 取得快取大小
+     */
+    size(): number;
+    /**
+     * 批次取得
+     */
+    mget(keys: K[]): Map<K, V>;
+    /**
+     * 批次設定
+     */
+    mset(entries: Array<[K, V]>): void;
+    /**
+     * 取得統計資訊
+     */
+    getStats(): CacheStats;
+    /**
+     * 添加事件監聽器
+     */
+    addListener(listener: CacheEventListener<K, V>): void;
+    /**
+     * 移除事件監聽器
+     */
+    removeListener(listener: CacheEventListener<K, V>): void;
+    /**
+     * 清理資源
+     */
+    dispose(): void;
+    /**
+     * 檢查項目是否過期
+     */
+    private isExpired;
+    /**
+     * 計算值的大小（簡單估算）
+     */
+    private calculateSize;
+    /**
+     * 啟動清理定時器
+     */
+    private startCleanupTimer;
+    /**
+     * 清理過期項目
+     */
+    private cleanupExpired;
+    /**
+     * 淘汰項目
+     */
+    private evict;
+    /**
+     * 更新命中率
+     */
+    private updateHitRate;
+    /**
+     * 更新平均存取時間
+     */
+    private updateAverageAccessTime;
+    /**
+     * 發出事件
+     */
+    private emitEvent;
+}
+//# sourceMappingURL=memory-cache.d.ts.map

package/dist/infrastructure/cache/memory-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cache/memory-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,UAAU,EAEf,KAAK,kBAAkB,EAGxB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,OAAO,GAAE,YAAiB;IAmCtC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAiD1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAwC/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAYpB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAoBvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAa1B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;IAMlC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAIrD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,KAAK;IAgBb;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,SAAS;CAmBlB"}

package/dist/infrastructure/cache/memory-cache.js

@@ -0,0 +1,327 @@
+import { EvictionStrategy, CacheEventType } from './types.js';
+import { StrategyFactory } from './strategies.js';
+/**
+ * 高效能記憶體快取實作，支援多種淘汰策略
+ */
+export class MemoryCache {
+    cache = new Map();
+    options;
+    listeners = new Set();
+    strategy;
+    stats;
+    cleanupTimer;
+    constructor(options = {}) {
+        // 設定預設選項
+        this.options = {
+            maxSize: options.maxSize ?? 1000,
+            maxMemory: options.maxMemory ?? 50 * 1024 * 1024, // 50MB
+            defaultTTL: options.defaultTTL ?? 0, // 0 表示永不過期
+            evictionStrategy: options.evictionStrategy ?? EvictionStrategy.LRU,
+            enableStats: options.enableStats ?? false,
+            cleanupInterval: options.cleanupInterval ?? 60000, // 1分鐘
+            serialize: options.serialize ?? JSON.stringify,
+            deserialize: options.deserialize ?? JSON.parse
+        };
+        // 建立淘汰策略
+        this.strategy = StrategyFactory.createStrategy(this.options.evictionStrategy);
+        // 初始化統計
+        this.stats = {
+            totalRequests: 0,
+            hits: 0,
+            misses: 0,
+            hitRate: 0,
+            size: 0,
+            memoryUsage: 0,
+            evictions: 0,
+            expirations: 0,
+            averageAccessTime: 0
+        };
+        // 如果啟用 TTL 或有預設 TTL，啟動清理定時器
+        if (this.options.defaultTTL > 0 || this.options.evictionStrategy === EvictionStrategy.TTL) {
+            this.startCleanupTimer();
+        }
+    }
+    /**
+     * 取得快取值
+     */
+    get(key) {
+        const startTime = Date.now();
+        if (this.options.enableStats) {
+            this.stats.totalRequests++;
+        }
+        const item = this.cache.get(key);
+        if (!item) {
+            if (this.options.enableStats) {
+                this.stats.misses++;
+                this.updateHitRate();
+            }
+            this.emitEvent(CacheEventType.MISS, key);
+            return undefined;
+        }
+        // 檢查是否過期
+        if (this.isExpired(item)) {
+            this.delete(key);
+            if (this.options.enableStats) {
+                this.stats.misses++;
+                this.stats.expirations++;
+                this.updateHitRate();
+            }
+            this.emitEvent(CacheEventType.EXPIRE, key, item.value);
+            return undefined;
+        }
+        // 更新存取資訊
+        item.lastAccessedAt = Date.now();
+        item.accessCount++;
+        // 通知策略項目被存取
+        this.strategy.onAccess(key, item);
+        if (this.options.enableStats) {
+            this.stats.hits++;
+            this.updateHitRate();
+            this.updateAverageAccessTime(Date.now() - startTime);
+        }
+        this.emitEvent(CacheEventType.HIT, key, item.value);
+        this.emitEvent(CacheEventType.GET, key, item.value);
+        return item.value;
+    }
+    /**
+     * 設定快取值
+     */
+    set(key, value, customTTL) {
+        const now = Date.now();
+        const ttl = customTTL ?? this.options.defaultTTL;
+        const expiresAt = ttl > 0 ? now + ttl : undefined;
+        // 如果已存在，先刪除（這樣可以更新 LRU 順序）
+        if (this.cache.has(key)) {
+            this.delete(key);
+        }
+        // 檢查是否需要淘汰
+        if (this.cache.size >= this.options.maxSize) {
+            this.evict();
+        }
+        // 建立快取項目
+        const item = {
+            value,
+            createdAt: now,
+            lastAccessedAt: now,
+            accessCount: 0,
+            ...(expiresAt && { expiresAt }),
+            size: this.calculateSize(value)
+        };
+        // 儲存到快取
+        this.cache.set(key, item);
+        // 通知策略項目被設定
+        this.strategy.onSet(key, item);
+        // 更新統計
+        if (this.options.enableStats) {
+            this.stats.size = this.cache.size;
+            this.stats.memoryUsage += item.size || 0;
+        }
+        this.emitEvent(CacheEventType.SET, key, value);
+    }
+    /**
+     * 檢查鍵是否存在（不更新存取時間）
+     */
+    has(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            return false;
+        }
+        if (this.isExpired(item)) {
+            this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 刪除快取項目
+     */
+    delete(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            return false;
+        }
+        // 從快取中刪除
+        this.cache.delete(key);
+        // 通知策略項目被刪除
+        this.strategy.onDelete(key);
+        // 更新統計
+        if (this.options.enableStats) {
+            this.stats.size = this.cache.size;
+            this.stats.memoryUsage -= item.size || 0;
+        }
+        this.emitEvent(CacheEventType.DELETE, key, item.value);
+        return true;
+    }
+    /**
+     * 清空所有快取
+     */
+    clear() {
+        this.cache.clear();
+        this.strategy.clear();
+        if (this.options.enableStats) {
+            this.stats.size = 0;
+            this.stats.memoryUsage = 0;
+        }
+        this.emitEvent(CacheEventType.CLEAR, undefined);
+    }
+    /**
+     * 取得快取大小
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * 批次取得
+     */
+    mget(keys) {
+        const result = new Map();
+        for (const key of keys) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                result.set(key, value);
+            }
+        }
+        return result;
+    }
+    /**
+     * 批次設定
+     */
+    mset(entries) {
+        for (const [key, value] of entries) {
+            this.set(key, value);
+        }
+    }
+    /**
+     * 取得統計資訊
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * 添加事件監聽器
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * 移除事件監聽器
+     */
+    removeListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * 清理資源
+     */
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+        }
+        this.clear();
+        this.listeners.clear();
+    }
+    // ===== 私有方法 =====
+    /**
+     * 檢查項目是否過期
+     */
+    isExpired(item) {
+        if (!item.expiresAt) {
+            return false;
+        }
+        return Date.now() > item.expiresAt;
+    }
+    /**
+     * 計算值的大小（簡單估算）
+     */
+    calculateSize(value) {
+        try {
+            return JSON.stringify(value).length * 2; // 每個字元約 2 位元組
+        }
+        catch {
+            return 100; // 預設大小
+        }
+    }
+    /**
+     * 啟動清理定時器
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupExpired();
+        }, this.options.cleanupInterval);
+    }
+    /**
+     * 清理過期項目
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        for (const [key, item] of this.cache.entries()) {
+            if (item.expiresAt && now > item.expiresAt) {
+                this.delete(key);
+                if (this.options.enableStats) {
+                    this.stats.expirations++;
+                }
+            }
+        }
+    }
+    /**
+     * 淘汰項目
+     */
+    evict() {
+        if (this.cache.size === 0) {
+            return;
+        }
+        const keyToEvict = this.strategy.selectEvictionKey(this.cache);
+        if (keyToEvict !== undefined) {
+            const item = this.cache.get(keyToEvict);
+            this.delete(keyToEvict);
+            if (this.options.enableStats) {
+                this.stats.evictions++;
+            }
+            this.emitEvent(CacheEventType.EVICT, keyToEvict, item?.value);
+        }
+    }
+    /**
+     * 更新命中率
+     */
+    updateHitRate() {
+        if (this.stats.totalRequests > 0) {
+            this.stats.hitRate = this.stats.hits / this.stats.totalRequests;
+        }
+    }
+    /**
+     * 更新平均存取時間
+     */
+    updateAverageAccessTime(accessTime) {
+        const currentAvg = this.stats.averageAccessTime;
+        const totalRequests = this.stats.totalRequests;
+        if (totalRequests === 1) {
+            this.stats.averageAccessTime = accessTime;
+        }
+        else {
+            this.stats.averageAccessTime = (currentAvg * (totalRequests - 1) + accessTime) / totalRequests;
+        }
+    }
+    /**
+     * 發出事件
+     */
+    emitEvent(type, key, value) {
+        if (this.listeners.size === 0) {
+            return;
+        }
+        const event = {
+            type,
+            key,
+            ...(value !== undefined && { value }),
+            timestamp: Date.now()
+        };
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                // 忽略監聽器錯誤，避免影響快取操作
+                console.error('Cache event listener error:', error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=memory-cache.js.map

package/dist/infrastructure/cache/memory-cache.js.map

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

package/dist/infrastructure/cache/strategies.d.ts

@@ -0,0 +1,99 @@
+import { EvictionStrategy, type CacheItem } from './types.js';
+/**
+ * 快取策略介面
+ */
+export interface CacheStrategy<K, V> {
+    /**
+     * 策略名稱
+     */
+    readonly name: EvictionStrategy;
+    /**
+     * 當項目被存取時呼叫
+     */
+    onAccess(key: K, item: CacheItem<V>): void;
+    /**
+     * 當項目被設定時呼叫
+     */
+    onSet(key: K, item: CacheItem<V>): void;
+    /**
+     * 當項目被刪除時呼叫
+     */
+    onDelete(key: K): void;
+    /**
+     * 選擇要淘汰的項目
+     */
+    selectEvictionKey(items: Map<K, CacheItem<V>>): K | undefined;
+    /**
+     * 清理策略內部狀態
+     */
+    clear(): void;
+}
+/**
+ * LRU (Least Recently Used) 策略實作
+ */
+export declare class LRUStrategy<K, V> implements CacheStrategy<K, V> {
+    readonly name = EvictionStrategy.LRU;
+    private head?;
+    private tail?;
+    private nodes;
+    onAccess(key: K, _item: CacheItem<V>): void;
+    onSet(key: K, _item: CacheItem<V>): void;
+    onDelete(key: K): void;
+    selectEvictionKey(_items: Map<K, CacheItem<V>>): K | undefined;
+    clear(): void;
+    private addToHead;
+    private moveToHead;
+    private removeNode;
+}
+/**
+ * LFU (Least Frequently Used) 策略實作
+ */
+export declare class LFUStrategy<K, V> implements CacheStrategy<K, V> {
+    readonly name = EvictionStrategy.LFU;
+    private frequencies;
+    onAccess(key: K, item: CacheItem<V>): void;
+    onSet(key: K, _item: CacheItem<V>): void;
+    onDelete(key: K): void;
+    selectEvictionKey(items: Map<K, CacheItem<V>>): K | undefined;
+    clear(): void;
+}
+/**
+ * FIFO (First In First Out) 策略實作
+ */
+export declare class FIFOStrategy<K, V> implements CacheStrategy<K, V> {
+    readonly name = EvictionStrategy.FIFO;
+    onAccess(_key: K, _item: CacheItem<V>): void;
+    onSet(_key: K, _item: CacheItem<V>): void;
+    onDelete(_key: K): void;
+    selectEvictionKey(items: Map<K, CacheItem<V>>): K | undefined;
+    clear(): void;
+}
+/**
+ * TTL (Time To Live) 策略實作
+ */
+export declare class TTLStrategy<K, V> implements CacheStrategy<K, V> {
+    readonly name = EvictionStrategy.TTL;
+    onAccess(_key: K, _item: CacheItem<V>): void;
+    onSet(_key: K, _item: CacheItem<V>): void;
+    onDelete(_key: K): void;
+    selectEvictionKey(items: Map<K, CacheItem<V>>): K | undefined;
+    clear(): void;
+}
+/**
+ * Random 隨機策略實作
+ */
+export declare class RandomStrategy<K, V> implements CacheStrategy<K, V> {
+    readonly name = EvictionStrategy.RANDOM;
+    onAccess(_key: K, _item: CacheItem<V>): void;
+    onSet(_key: K, _item: CacheItem<V>): void;
+    onDelete(_key: K): void;
+    selectEvictionKey(items: Map<K, CacheItem<V>>): K | undefined;
+    clear(): void;
+}
+/**
+ * 策略工廠
+ */
+export declare class StrategyFactory {
+    static createStrategy<K, V>(strategy: EvictionStrategy): CacheStrategy<K, V>;
+}
+//# sourceMappingURL=strategies.d.ts.map

package/dist/infrastructure/cache/strategies.d.ts.map

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