@limo-labs/deity 0.1.0-alpha.0

package/dist/src/memory/tiered-memory.d.ts

@@ -0,0 +1,116 @@
+import { HotMemoryConfig } from "./hot-memory.js";
+import { WarmStorageConfig } from "./warm-storage.js";
+import { ColdStorageConfig } from "./cold-storage.js";
+/**
+ * Configuration for tiered memory system.
+ */
+export interface TieredMemoryConfig {
+    hot?: HotMemoryConfig;
+    warm?: WarmStorageConfig;
+    cold?: ColdStorageConfig;
+}
+/**
+ * Statistics for the entire tiered memory system.
+ */
+export interface MemoryStats {
+    hot: {
+        itemCount: number;
+        estimatedSize: number;
+        hitCount: number;
+        missCount: number;
+        evictionCount: number;
+    };
+    warm: {
+        fileCount: number;
+        totalSize: number;
+        compressionRatio: number;
+    };
+    cold: {
+        fileCount: number;
+        totalSize: number;
+    };
+    promotions: number;
+    demotions: number;
+}
+/**
+ * Tiered memory manager coordinating hot/warm/cold storage.
+ * Automatically promotes frequently accessed data and demotes cold data.
+ */
+export declare class TieredMemoryManager {
+    private hot;
+    private warm;
+    private cold;
+    private pinnedKeys;
+    private accessPatterns;
+    private promotionCount;
+    private demotionCount;
+    private evictionQueue;
+    constructor(config?: TieredMemoryConfig);
+    /**
+     * Initialize storage layers.
+     */
+    init(): Promise<void>;
+    /**
+     * Get a value from tiered memory.
+     * Automatically promotes from cold → warm → hot on access.
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Set a value in tiered memory.
+     * Always starts in hot memory.
+     */
+    set<T>(key: string, value: T): Promise<void>;
+    /**
+     * Check if a key exists in any tier.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete a value from all tiers.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Pin a key to prevent eviction and ensure persistence.
+     * Pinned keys are always saved to cold storage.
+     */
+    pin(key: string): Promise<void>;
+    /**
+     * Unpin a key.
+     */
+    unpin(key: string): void;
+    /**
+     * Manually promote a key to hot memory.
+     */
+    promote(key: string): Promise<void>;
+    /**
+     * Manually demote a key to cold storage.
+     */
+    demote(key: string): Promise<void>;
+    /**
+     * Get statistics for all tiers.
+     */
+    stats(): Promise<MemoryStats>;
+    /**
+     * Clear all tiers.
+     */
+    clear(): Promise<void>;
+    /**
+     * Process queued evictions from hot memory.
+     * Move to warm storage unless pinned.
+     */
+    private processEvictionQueue;
+    /**
+     * Update access pattern for a key.
+     */
+    private updateAccessPattern;
+    /**
+     * Determine if a key should be promoted to hot memory.
+     * Promotes if accessed more than 2 times.
+     */
+    private shouldPromoteToHot;
+    /**
+     * Determine if a key should be promoted to warm storage.
+     * Promotes if accessed at least once from cold.
+     */
+    private shouldPromoteToWarm;
+}
+//# sourceMappingURL=tiered-memory.d.ts.map

package/dist/src/memory/tiered-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/tiered-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAe,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAe,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE;QACH,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAA8C;gBAEvD,MAAM,GAAE,kBAAuB;IAc3C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmCjD;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrC;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAcnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;;OAGG;YACW,oBAAoB;IAelC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAI5B"}

package/dist/src/memory/tiered-memory.js

@@ -0,0 +1,215 @@
+import { HotMemory } from "./hot-memory.js";
+import { WarmStorage } from "./warm-storage.js";
+import { ColdStorage } from "./cold-storage.js";
+/**
+ * Tiered memory manager coordinating hot/warm/cold storage.
+ * Automatically promotes frequently accessed data and demotes cold data.
+ */
+export class TieredMemoryManager {
+    hot;
+    warm;
+    cold;
+    pinnedKeys = new Set();
+    accessPatterns = new Map();
+    promotionCount = 0;
+    demotionCount = 0;
+    evictionQueue = [];
+    constructor(config = {}) {
+        // Initialize hot memory with eviction callback
+        this.hot = new HotMemory({
+            ...config.hot,
+            onEvict: (key, value) => {
+                // Queue evictions for async processing
+                this.evictionQueue.push({ key, value });
+            },
+        });
+        this.warm = new WarmStorage(config.warm);
+        this.cold = new ColdStorage(config.cold);
+    }
+    /**
+     * Initialize storage layers.
+     */
+    async init() {
+        await this.warm.init();
+        await this.cold.init();
+    }
+    /**
+     * Get a value from tiered memory.
+     * Automatically promotes from cold → warm → hot on access.
+     */
+    async get(key) {
+        // Update access pattern
+        this.updateAccessPattern(key);
+        // Try hot memory first
+        const hotValue = this.hot.get(key);
+        if (hotValue !== undefined) {
+            return hotValue;
+        }
+        // Try warm storage
+        const warmValue = await this.warm.get(key);
+        if (warmValue !== undefined) {
+            // Promote to hot if frequently accessed
+            if (this.shouldPromoteToHot(key)) {
+                this.hot.set(key, warmValue);
+                this.promotionCount++;
+            }
+            return warmValue;
+        }
+        // Try cold storage
+        const coldValue = await this.cold.get(key);
+        if (coldValue !== undefined) {
+            // Promote to warm if frequently accessed
+            if (this.shouldPromoteToWarm(key)) {
+                await this.warm.set(key, coldValue);
+                this.promotionCount++;
+            }
+            return coldValue;
+        }
+        return undefined;
+    }
+    /**
+     * Set a value in tiered memory.
+     * Always starts in hot memory.
+     */
+    async set(key, value) {
+        this.updateAccessPattern(key);
+        // Store in hot memory
+        this.hot.set(key, value);
+        // Process any queued evictions
+        await this.processEvictionQueue();
+        // If pinned, also save to cold immediately for persistence
+        if (this.pinnedKeys.has(key)) {
+            await this.cold.set(key, value);
+        }
+    }
+    /**
+     * Check if a key exists in any tier.
+     */
+    async has(key) {
+        return (this.hot.has(key) ||
+            (await this.warm.has(key)) ||
+            (await this.cold.has(key)));
+    }
+    /**
+     * Delete a value from all tiers.
+     */
+    async delete(key) {
+        this.hot.delete(key);
+        await this.warm.delete(key);
+        await this.cold.delete(key);
+        this.accessPatterns.delete(key);
+        this.pinnedKeys.delete(key);
+    }
+    /**
+     * Pin a key to prevent eviction and ensure persistence.
+     * Pinned keys are always saved to cold storage.
+     */
+    async pin(key) {
+        this.pinnedKeys.add(key);
+        // If key exists in hot, save to cold
+        const value = this.hot.get(key);
+        if (value !== undefined) {
+            await this.cold.set(key, value);
+        }
+    }
+    /**
+     * Unpin a key.
+     */
+    unpin(key) {
+        this.pinnedKeys.delete(key);
+    }
+    /**
+     * Manually promote a key to hot memory.
+     */
+    async promote(key) {
+        // Try to load from warm or cold
+        let value = await this.warm.get(key);
+        if (value === undefined) {
+            value = await this.cold.get(key);
+        }
+        if (value !== undefined) {
+            this.hot.set(key, value);
+            this.promotionCount++;
+        }
+    }
+    /**
+     * Manually demote a key to cold storage.
+     */
+    async demote(key) {
+        const value = this.hot.get(key);
+        if (value !== undefined) {
+            await this.cold.set(key, value);
+            this.hot.delete(key);
+            this.demotionCount++;
+        }
+    }
+    /**
+     * Get statistics for all tiers.
+     */
+    async stats() {
+        const hotStats = this.hot.stats();
+        const warmStats = await this.warm.stats();
+        const coldStats = await this.cold.stats();
+        return {
+            hot: hotStats,
+            warm: warmStats,
+            cold: coldStats,
+            promotions: this.promotionCount,
+            demotions: this.demotionCount,
+        };
+    }
+    /**
+     * Clear all tiers.
+     */
+    async clear() {
+        this.hot.clear();
+        await this.warm.clear();
+        await this.cold.clear();
+        this.accessPatterns.clear();
+        this.pinnedKeys.clear();
+        this.promotionCount = 0;
+        this.demotionCount = 0;
+    }
+    /**
+     * Process queued evictions from hot memory.
+     * Move to warm storage unless pinned.
+     */
+    async processEvictionQueue() {
+        while (this.evictionQueue.length > 0) {
+            const { key, value } = this.evictionQueue.shift();
+            // Don't demote pinned keys (they're already in cold)
+            if (this.pinnedKeys.has(key)) {
+                continue;
+            }
+            // Move to warm storage
+            await this.warm.set(key, value);
+            this.demotionCount++;
+        }
+    }
+    /**
+     * Update access pattern for a key.
+     */
+    updateAccessPattern(key) {
+        const pattern = this.accessPatterns.get(key) ?? { count: 0, lastAccess: 0 };
+        pattern.count++;
+        pattern.lastAccess = Date.now();
+        this.accessPatterns.set(key, pattern);
+    }
+    /**
+     * Determine if a key should be promoted to hot memory.
+     * Promotes if accessed more than 2 times.
+     */
+    shouldPromoteToHot(key) {
+        const pattern = this.accessPatterns.get(key);
+        return pattern !== undefined && pattern.count > 2;
+    }
+    /**
+     * Determine if a key should be promoted to warm storage.
+     * Promotes if accessed at least once from cold.
+     */
+    shouldPromoteToWarm(key) {
+        const pattern = this.accessPatterns.get(key);
+        return pattern !== undefined && pattern.count > 0;
+    }
+}
+//# sourceMappingURL=tiered-memory.js.map

package/dist/src/memory/tiered-memory.js.map

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

package/dist/src/memory/warm-storage.d.ts

@@ -0,0 +1,74 @@
+import { type CompressionAlgorithm } from "./compression.js";
+/**
+ * Configuration for warm storage (compressed disk cache).
+ */
+export interface WarmStorageConfig {
+    /** Directory for warm cache files (default: .deity/cache) */
+    directory?: string;
+    /** Maximum total size in bytes (default: 1GB) */
+    maxSize?: number;
+    /** Compression algorithm to use (default: gzip) */
+    compressionAlgorithm?: CompressionAlgorithm;
+}
+/**
+ * Statistics for warm storage usage.
+ */
+export interface WarmStorageStats {
+    fileCount: number;
+    totalSize: number;
+    compressionRatio: number;
+}
+/**
+ * Warm storage layer using compressed JSON files on disk.
+ * Automatically cleans up oldest files when size limit is exceeded.
+ */
+export declare class WarmStorage {
+    private config;
+    private sizeCache;
+    private accessTimes;
+    private compressor;
+    constructor(config?: WarmStorageConfig);
+    /**
+     * Initialize warm storage directory.
+     */
+    init(): Promise<void>;
+    /**
+     * Get a value from warm storage.
+     * Returns undefined if not found.
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Set a value in warm storage.
+     * May trigger cleanup if size limit is exceeded.
+     */
+    set<T>(key: string, value: T): Promise<void>;
+    /**
+     * Check if a key exists in warm storage.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete a value from warm storage.
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear all files from warm storage.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get statistics about warm storage usage.
+     */
+    stats(): Promise<WarmStorageStats>;
+    /**
+     * Get file path for a key.
+     */
+    private getFilePath;
+    /**
+     * Update size cache by scanning directory.
+     */
+    private updateSizeCache;
+    /**
+     * Cleanup oldest files if over size limit.
+     */
+    private cleanup;
+}
+//# sourceMappingURL=warm-storage.d.ts.map

package/dist/src/memory/warm-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-storage.d.ts","sourceRoot":"","sources":["../../../src/memory/warm-storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,UAAU,CAAqB;gBAE3B,MAAM,GAAE,iBAAsB;IAW1C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmBjD;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA+BxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;YACW,eAAe;IAsB7B;;OAEG;YACW,OAAO;CA2BtB"}

package/dist/src/memory/warm-storage.js

@@ -0,0 +1,207 @@
+import { promises as fs } from "node:fs";
+import { join, dirname } from "node:path";
+import { createCompressionAdapter, } from "./compression.js";
+/**
+ * Warm storage layer using compressed JSON files on disk.
+ * Automatically cleans up oldest files when size limit is exceeded.
+ */
+export class WarmStorage {
+    config;
+    sizeCache = new Map();
+    accessTimes = new Map();
+    compressor;
+    constructor(config = {}) {
+        this.config = {
+            directory: config.directory ?? join(process.cwd(), ".deity", "cache"),
+            maxSize: config.maxSize ?? 1024 * 1024 * 1024, // 1GB
+            compressionAlgorithm: config.compressionAlgorithm ?? "gzip",
+        };
+        // Initialize compression adapter
+        this.compressor = createCompressionAdapter(this.config.compressionAlgorithm);
+    }
+    /**
+     * Initialize warm storage directory.
+     */
+    async init() {
+        await fs.mkdir(this.config.directory, { recursive: true });
+        await this.updateSizeCache();
+    }
+    /**
+     * Get a value from warm storage.
+     * Returns undefined if not found.
+     */
+    async get(key) {
+        const filePath = this.getFilePath(key);
+        try {
+            const compressed = await fs.readFile(filePath);
+            const decompressed = await this.compressor.decompress(compressed);
+            const json = decompressed.toString("utf-8");
+            const value = JSON.parse(json);
+            // Update access time for LRU tracking
+            this.accessTimes.set(key, Date.now());
+            return value;
+        }
+        catch (err) {
+            // File doesn't exist or is corrupted
+            return undefined;
+        }
+    }
+    /**
+     * Set a value in warm storage.
+     * May trigger cleanup if size limit is exceeded.
+     */
+    async set(key, value) {
+        const filePath = this.getFilePath(key);
+        // Ensure directory exists
+        await fs.mkdir(dirname(filePath), { recursive: true });
+        // Compress and write
+        const json = JSON.stringify(value);
+        const compressed = await this.compressor.compress(Buffer.from(json, "utf-8"));
+        // Write atomically (write to temp file, then rename)
+        const tempPath = `${filePath}.tmp`;
+        await fs.writeFile(tempPath, compressed);
+        await fs.rename(tempPath, filePath);
+        // Update tracking
+        const size = compressed.length;
+        this.sizeCache.set(key, size);
+        this.accessTimes.set(key, Date.now());
+        // Cleanup if over size limit
+        await this.cleanup();
+    }
+    /**
+     * Check if a key exists in warm storage.
+     */
+    async has(key) {
+        const filePath = this.getFilePath(key);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Delete a value from warm storage.
+     */
+    async delete(key) {
+        const filePath = this.getFilePath(key);
+        try {
+            await fs.unlink(filePath);
+            this.sizeCache.delete(key);
+            this.accessTimes.delete(key);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Clear all files from warm storage.
+     */
+    async clear() {
+        try {
+            await fs.rm(this.config.directory, { recursive: true, force: true });
+            await fs.mkdir(this.config.directory, { recursive: true });
+            this.sizeCache.clear();
+            this.accessTimes.clear();
+        }
+        catch (err) {
+            // Directory might not exist yet
+        }
+    }
+    /**
+     * Get statistics about warm storage usage.
+     */
+    async stats() {
+        await this.updateSizeCache();
+        const totalSize = Array.from(this.sizeCache.values()).reduce((sum, size) => sum + size, 0);
+        // Calculate average compression ratio
+        let totalOriginal = 0;
+        let totalCompressed = 0;
+        for (const [key, compressedSize] of this.sizeCache) {
+            const value = await this.get(key);
+            if (value !== undefined) {
+                const originalSize = JSON.stringify(value).length * 2; // UTF-16
+                totalOriginal += originalSize;
+                totalCompressed += compressedSize;
+            }
+        }
+        const compressionRatio = totalCompressed > 0 ? totalOriginal / totalCompressed : 1;
+        return {
+            fileCount: this.sizeCache.size,
+            totalSize,
+            compressionRatio,
+        };
+    }
+    /**
+     * Get file path for a key.
+     */
+    getFilePath(key) {
+        // Sanitize key to be filesystem-safe
+        const safeKey = key.replace(/[^a-zA-Z0-9_-]/g, "_");
+        // Choose extension based on compression algorithm
+        let extension;
+        switch (this.config.compressionAlgorithm) {
+            case "gzip":
+                extension = ".json.gz";
+                break;
+            case "lz4":
+                extension = ".json.lz4";
+                break;
+            case "none":
+                extension = ".json";
+                break;
+            default:
+                extension = ".json.gz"; // fallback
+        }
+        return join(this.config.directory, `${safeKey}${extension}`);
+    }
+    /**
+     * Update size cache by scanning directory.
+     */
+    async updateSizeCache() {
+        try {
+            const files = await fs.readdir(this.config.directory);
+            // Determine which extensions to scan based on compression
+            const extensions = [".json.gz", ".json.lz4", ".json"];
+            for (const file of files) {
+                // Check if file matches any extension
+                const matchingExt = extensions.find((ext) => file.endsWith(ext));
+                if (matchingExt) {
+                    const filePath = join(this.config.directory, file);
+                    const stat = await fs.stat(filePath);
+                    const key = file.replace(matchingExt, "");
+                    this.sizeCache.set(key, stat.size);
+                }
+            }
+        }
+        catch {
+            // Directory might not exist yet
+        }
+    }
+    /**
+     * Cleanup oldest files if over size limit.
+     */
+    async cleanup() {
+        const totalSize = Array.from(this.sizeCache.values()).reduce((sum, size) => sum + size, 0);
+        if (totalSize <= this.config.maxSize) {
+            return;
+        }
+        // Sort keys by access time (oldest first)
+        const sortedKeys = Array.from(this.accessTimes.entries())
+            .sort((a, b) => a[1] - b[1])
+            .map(([key]) => key);
+        // Delete oldest files until under limit
+        let currentSize = totalSize;
+        for (const key of sortedKeys) {
+            if (currentSize <= this.config.maxSize) {
+                break;
+            }
+            const size = this.sizeCache.get(key) ?? 0;
+            await this.delete(key);
+            currentSize -= size;
+        }
+    }
+}
+//# sourceMappingURL=warm-storage.js.map

package/dist/src/memory/warm-storage.js.map

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

package/dist/src/openai-adapter.d.ts

@@ -0,0 +1,20 @@
+import type { Message } from "./component.js";
+import type { LLMAdapter, LLMResponse, GenerationConfig } from "./llm.js";
+import type { Tool } from "./tool.js";
+export interface OpenAIAdapterConfig {
+    apiKey: string;
+    model?: string;
+    baseURL?: string;
+}
+/**
+ * OpenAI-compatible LLM adapter.
+ * Works with OpenAI API and compatible endpoints (Azure, local proxies).
+ */
+export declare class OpenAIAdapter implements LLMAdapter {
+    private apiKey;
+    private model;
+    private baseURL;
+    constructor(config: OpenAIAdapterConfig);
+    generate(messages: Message[], tools?: Tool[], config?: GenerationConfig): Promise<LLMResponse>;
+}
+//# sourceMappingURL=openai-adapter.d.ts.map

package/dist/src/openai-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../../src/openai-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAY,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAMjC,QAAQ,CACZ,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC;CAgFxB"}