agentdb 1.0.12 → 1.1.0

package/dist/cli/cache/query-cache.js

@@ -1,244 +0,0 @@
-"use strict";
-/**
- * Query Cache with LRU eviction for ultra-fast repeated queries
- *
- * Provides 50-100x speedup for repeated vector searches by caching results.
- * Uses LRU (Least Recently Used) eviction strategy with TTL (Time To Live).
- *
- * @example
- * ```typescript
- * const cache = new QueryCache({ maxSize: 1000, ttl: 300000 }); // 5 min TTL
- *
- * // First query: miss, executes full search
- * const results1 = cache.get(key) ?? performSearch();
- * cache.set(key, results1);
- *
- * // Second query: hit, returns cached results (sub-millisecond)
- * const results2 = cache.get(key); // 50-100x faster
- * ```
- */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryCache = void 0;
-var QueryCache = /** @class */ (function () {
-    function QueryCache(config) {
-        if (config === void 0) { config = {}; }
-        var _a, _b, _c;
-        this.cache = new Map();
-        // Statistics
-        this.stats = {
-            hits: 0,
-            misses: 0,
-            evictions: 0,
-            totalAccessTime: 0,
-            accessCount: 0
-        };
-        this.config = {
-            maxSize: (_a = config.maxSize) !== null && _a !== void 0 ? _a : 1000,
-            ttl: (_b = config.ttl) !== null && _b !== void 0 ? _b : 300000, // 5 minutes
-            enableStats: (_c = config.enableStats) !== null && _c !== void 0 ? _c : true
-        };
-    }
-    /**
-     * Generate cache key from query parameters
-     */
-    QueryCache.generateKey = function (embedding, k, metric, threshold) {
-        // Use first 8 dimensions for key (balance between uniqueness and performance)
-        var prefix = embedding.slice(0, 8).map(function (v) { return v.toFixed(4); }).join(',');
-        return "".concat(prefix, ":").concat(k, ":").concat(metric !== null && metric !== void 0 ? metric : 'cosine', ":").concat(threshold !== null && threshold !== void 0 ? threshold : 0);
-    };
-    /**
-     * Get cached results if available and not expired
-     */
-    QueryCache.prototype.get = function (key) {
-        var startTime = performance.now();
-        var entry = this.cache.get(key);
-        if (!entry) {
-            this.recordMiss(startTime);
-            return null;
-        }
-        // Check expiry
-        var now = Date.now();
-        if (now > entry.expiry) {
-            this.cache.delete(key);
-            this.recordMiss(startTime);
-            return null;
-        }
-        // Update access metadata
-        entry.lastAccessed = now;
-        entry.accessCount++;
-        this.recordHit(startTime);
-        return entry.results;
-    };
-    /**
-     * Store results in cache with LRU eviction
-     */
-    QueryCache.prototype.set = function (key, results) {
-        // Evict if at capacity
-        if (this.cache.size >= this.config.maxSize) {
-            this.evictLRU();
-        }
-        var now = Date.now();
-        this.cache.set(key, {
-            results: results,
-            expiry: now + this.config.ttl,
-            lastAccessed: now,
-            accessCount: 1
-        });
-    };
-    /**
-     * Evict least recently used entry
-     */
-    QueryCache.prototype.evictLRU = function () {
-        var oldestKey = null;
-        var oldestTime = Infinity;
-        for (var _i = 0, _a = this.cache.entries(); _i < _a.length; _i++) {
-            var _b = _a[_i], key = _b[0], entry = _b[1];
-            if (entry.lastAccessed < oldestTime) {
-                oldestTime = entry.lastAccessed;
-                oldestKey = key;
-            }
-        }
-        if (oldestKey) {
-            this.cache.delete(oldestKey);
-            if (this.config.enableStats) {
-                this.stats.evictions++;
-            }
-        }
-    };
-    /**
-     * Clear all cached entries
-     */
-    QueryCache.prototype.clear = function () {
-        this.cache.clear();
-    };
-    /**
-     * Clear expired entries
-     */
-    QueryCache.prototype.clearExpired = function () {
-        var _this = this;
-        var now = Date.now();
-        var toDelete = [];
-        for (var _i = 0, _a = this.cache.entries(); _i < _a.length; _i++) {
-            var _b = _a[_i], key = _b[0], entry = _b[1];
-            if (now > entry.expiry) {
-                toDelete.push(key);
-            }
-        }
-        toDelete.forEach(function (key) { return _this.cache.delete(key); });
-    };
-    /**
-     * Get cache statistics
-     */
-    QueryCache.prototype.getStats = function () {
-        var total = this.stats.hits + this.stats.misses;
-        return {
-            hits: this.stats.hits,
-            misses: this.stats.misses,
-            hitRate: total > 0 ? this.stats.hits / total : 0,
-            size: this.cache.size,
-            evictions: this.stats.evictions,
-            avgAccessTime: this.stats.accessCount > 0
-                ? this.stats.totalAccessTime / this.stats.accessCount
-                : 0
-        };
-    };
-    /**
-     * Reset statistics
-     */
-    QueryCache.prototype.resetStats = function () {
-        this.stats = {
-            hits: 0,
-            misses: 0,
-            evictions: 0,
-            totalAccessTime: 0,
-            accessCount: 0
-        };
-    };
-    QueryCache.prototype.recordHit = function (startTime) {
-        if (this.config.enableStats) {
-            this.stats.hits++;
-            this.stats.totalAccessTime += performance.now() - startTime;
-            this.stats.accessCount++;
-        }
-    };
-    QueryCache.prototype.recordMiss = function (startTime) {
-        if (this.config.enableStats) {
-            this.stats.misses++;
-            this.stats.totalAccessTime += performance.now() - startTime;
-            this.stats.accessCount++;
-        }
-    };
-    Object.defineProperty(QueryCache.prototype, "size", {
-        /**
-         * Get current cache size
-         */
-        get: function () {
-            return this.cache.size;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * Check if cache has key
-     */
-    QueryCache.prototype.has = function (key) {
-        var entry = this.cache.get(key);
-        if (!entry)
-            return false;
-        // Check expiry
-        if (Date.now() > entry.expiry) {
-            this.cache.delete(key);
-            return false;
-        }
-        return true;
-    };
-    /**
-     * Delete specific entry
-     */
-    QueryCache.prototype.delete = function (key) {
-        return this.cache.delete(key);
-    };
-    /**
-     * Get all cache keys
-     */
-    QueryCache.prototype.keys = function () {
-        return Array.from(this.cache.keys());
-    };
-    /**
-     * Get cache configuration
-     */
-    QueryCache.prototype.getConfig = function () {
-        return __assign({}, this.config);
-    };
-    /**
-     * Update cache configuration
-     */
-    QueryCache.prototype.updateConfig = function (config) {
-        if (config.maxSize !== undefined) {
-            this.config.maxSize = config.maxSize;
-            // Evict excess entries if new size is smaller
-            while (this.cache.size > this.config.maxSize) {
-                this.evictLRU();
-            }
-        }
-        if (config.ttl !== undefined) {
-            this.config.ttl = config.ttl;
-        }
-        if (config.enableStats !== undefined) {
-            this.config.enableStats = config.enableStats;
-        }
-    };
-    return QueryCache;
-}());
-exports.QueryCache = QueryCache;

package/dist/cli/cli/db-commands.d.ts

@@ -1,48 +0,0 @@
-/**
- * Database CLI Commands
- * Full-featured CLI commands for database operations
- */
-import { Command } from 'commander';
-/**
- * Format options for import/export
- */
-type FileFormat = 'json' | 'csv';
-/**
- * Import vectors from file
- */
-export declare function importVectors(dbPath: string, filePath: string, options?: {
-    format?: FileFormat;
-    batchSize?: number;
-    verbose?: boolean;
-}): Promise<void>;
-/**
- * Export vectors to file
- */
-export declare function exportVectors(dbPath: string, filePath: string, options?: {
-    format?: FileFormat;
-    limit?: number;
-    where?: string;
-    verbose?: boolean;
-}): Promise<void>;
-/**
- * Query database with vector
- */
-export declare function queryVectors(dbPath: string, embeddingInput: string, options?: {
-    k?: number;
-    metric?: 'cosine' | 'euclidean' | 'dot';
-    threshold?: number;
-    format?: 'table' | 'json';
-    verbose?: boolean;
-}): Promise<void>;
-/**
- * Show database statistics
- */
-export declare function showStats(dbPath: string, options?: {
-    detailed?: boolean;
-    format?: 'table' | 'json';
-}): Promise<void>;
-/**
- * Setup database CLI commands
- */
-export declare function setupDatabaseCommands(program: Command): void;
-export {};