nova-terminal-ai 0.3.4

package/dist/packages/core/src/utils/VectorMemoryStore.js

@@ -0,0 +1,320 @@
+// ============================================================================
+// VectorMemoryStore - Vector-based semantic memory storage
+// ============================================================================
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from './Logger.js';
+import { generateId } from './helpers.js';
+const logger = createLogger('VectorMemoryStore');
+// ============================================================================
+// Embedding Functions
+// ============================================================================
+/**
+ * Simple embedding function using character n-grams
+ * This is a lightweight alternative to neural embeddings
+ */
+function simpleEmbedding(text, dimension = 384) {
+    const embedding = new Array(dimension).fill(0);
+    // Normalize text
+    const normalized = text.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff\s]/g, ' ');
+    const words = normalized.split(/\s+/).filter(w => w.length > 0);
+    // Hash-based embedding
+    for (const word of words) {
+        // Simple hash function
+        let hash = 0;
+        for (let i = 0; i < word.length; i++) {
+            const char = word.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        // Map hash to embedding dimensions
+        const pos = Math.abs(hash) % dimension;
+        const sign = hash > 0 ? 1 : -1;
+        embedding[pos] += sign * (1 / words.length);
+        // Add n-gram features
+        for (let i = 0; i < word.length - 1; i++) {
+            const bigram = word.slice(i, i + 2);
+            let bigramHash = 0;
+            for (let j = 0; j < bigram.length; j++) {
+                bigramHash = ((bigramHash << 5) - bigramHash) + bigram.charCodeAt(j);
+                bigramHash = bigramHash & bigramHash;
+            }
+            const bigramPos = Math.abs(bigramHash) % dimension;
+            embedding[bigramPos] += 0.1 / words.length;
+        }
+    }
+    // Normalize embedding
+    const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));
+    if (norm > 0) {
+        for (let i = 0; i < embedding.length; i++) {
+            embedding[i] /= norm;
+        }
+    }
+    return embedding;
+}
+/**
+ * Calculate cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        const aVal = a[i] ?? 0;
+        const bVal = b[i] ?? 0;
+        dotProduct += aVal * bVal;
+        normA += aVal * aVal;
+        normB += bVal * bVal;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom > 0 ? dotProduct / denom : 0;
+}
+// ============================================================================
+// VectorMemoryStore
+// ============================================================================
+/**
+ * Vector-based memory store for semantic search
+ */
+export class VectorMemoryStore {
+    entries = [];
+    config;
+    storageFile;
+    isDirty = false;
+    constructor(config) {
+        this.config = {
+            maxEntries: config.maxEntries ?? 1000,
+            minSimilarity: config.minSimilarity ?? 0.5,
+            embeddingDimension: config.embeddingDimension ?? 384,
+            ...config,
+        };
+        this.storageFile = path.join(this.config.storageDir, 'vector-memory.json');
+        this.load();
+        // Auto-save on process exit
+        process.on('beforeExit', () => this.save());
+    }
+    // -----------------------------------------------------------------------
+    // Core Operations
+    // -----------------------------------------------------------------------
+    /**
+     * Add a memory entry
+     */
+    async addMemory(content, metadata) {
+        // Generate embedding
+        const embedding = simpleEmbedding(content, this.config.embeddingDimension);
+        const entry = {
+            id: generateId(),
+            content,
+            embedding,
+            metadata: {
+                ...metadata,
+                timestamp: metadata.timestamp ?? new Date(),
+            },
+        };
+        this.entries.push(entry);
+        this.isDirty = true;
+        // Prune if over limit
+        if (this.entries.length > this.config.maxEntries) {
+            this.prune();
+        }
+        logger.debug(`Added memory entry: ${entry.id}`, { type: metadata.type });
+        return entry;
+    }
+    /**
+     * Search for similar memories
+     */
+    async searchSimilar(query, options = {}) {
+        const { topK = 5, minSimilarity, type, tags } = options;
+        const threshold = minSimilarity ?? this.config.minSimilarity;
+        // Generate query embedding
+        const queryEmbedding = simpleEmbedding(query, this.config.embeddingDimension);
+        // Calculate similarities
+        const matches = [];
+        for (const entry of this.entries) {
+            // Filter by type
+            if (type && entry.metadata.type !== type)
+                continue;
+            // Filter by tags
+            if (tags && tags.length > 0) {
+                const hasTag = tags.some(t => entry.metadata.tags.includes(t));
+                if (!hasTag)
+                    continue;
+            }
+            const score = cosineSimilarity(queryEmbedding, entry.embedding);
+            if (score >= threshold) {
+                matches.push({ entry, score });
+            }
+        }
+        // Sort by score and return top K
+        matches.sort((a, b) => b.score - a.score);
+        return matches.slice(0, topK);
+    }
+    /**
+     * Get entry by ID
+     */
+    getEntry(id) {
+        return this.entries.find(e => e.id === id);
+    }
+    /**
+     * Delete entry by ID
+     */
+    deleteEntry(id) {
+        const index = this.entries.findIndex(e => e.id === id);
+        if (index >= 0) {
+            this.entries.splice(index, 1);
+            this.isDirty = true;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all entries of a specific type
+     */
+    getEntriesByType(type) {
+        return this.entries.filter(e => e.metadata.type === type);
+    }
+    /**
+     * Get entries by tags
+     */
+    getEntriesByTags(tags) {
+        return this.entries.filter(e => tags.some(t => e.metadata.tags.includes(t)));
+    }
+    /**
+     * Get entries for a session
+     */
+    getEntriesBySession(sessionId) {
+        return this.entries.filter(e => e.metadata.session === sessionId);
+    }
+    // -----------------------------------------------------------------------
+    // Persistence
+    // -----------------------------------------------------------------------
+    /**
+     * Save to disk
+     */
+    save() {
+        if (!this.isDirty)
+            return;
+        try {
+            // Ensure directory exists
+            const dir = path.dirname(this.storageFile);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Serialize entries
+            const data = {
+                version: 1,
+                entries: this.entries.map(e => ({
+                    ...e,
+                    metadata: {
+                        ...e.metadata,
+                        timestamp: e.metadata.timestamp.toISOString(),
+                    },
+                })),
+            };
+            fs.writeFileSync(this.storageFile, JSON.stringify(data, null, 2), 'utf-8');
+            this.isDirty = false;
+            logger.debug(`Saved ${this.entries.length} memory entries`);
+        }
+        catch (error) {
+            logger.error('Failed to save memory store', { error });
+        }
+    }
+    /**
+     * Load from disk
+     */
+    load() {
+        try {
+            if (!fs.existsSync(this.storageFile)) {
+                logger.debug('No existing memory store found, starting fresh');
+                return;
+            }
+            const data = JSON.parse(fs.readFileSync(this.storageFile, 'utf-8'));
+            if (data.version === 1 && Array.isArray(data.entries)) {
+                this.entries = data.entries.map((e) => ({
+                    ...e,
+                    metadata: {
+                        ...e.metadata,
+                        timestamp: new Date(e.metadata.timestamp),
+                    },
+                }));
+                logger.debug(`Loaded ${this.entries.length} memory entries`);
+            }
+        }
+        catch (error) {
+            logger.error('Failed to load memory store', { error });
+            this.entries = [];
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Maintenance
+    // -----------------------------------------------------------------------
+    /**
+     * Prune entries based on importance and age
+     */
+    prune() {
+        if (this.entries.length <= this.config.maxEntries)
+            return;
+        // Calculate age scores (newer is better)
+        const now = Date.now();
+        const maxAge = 30 * 24 * 60 * 60 * 1000; // 30 days
+        const scoredEntries = this.entries.map(entry => {
+            const age = now - entry.metadata.timestamp.getTime();
+            const ageScore = Math.max(0, 1 - age / maxAge);
+            // Combined score: importance * 0.7 + ageScore * 0.3
+            const score = entry.metadata.importance * 0.7 + ageScore * 0.3;
+            return { entry, score };
+        });
+        // Sort by score and keep top entries
+        scoredEntries.sort((a, b) => b.score - a.score);
+        this.entries = scoredEntries
+            .slice(0, this.config.maxEntries)
+            .map(s => s.entry);
+        this.isDirty = true;
+        logger.debug(`Pruned memory to ${this.entries.length} entries`);
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        const byType = {};
+        let oldest = null;
+        let newest = null;
+        let totalImportance = 0;
+        for (const entry of this.entries) {
+            byType[entry.metadata.type] = (byType[entry.metadata.type] ?? 0) + 1;
+            if (!oldest || entry.metadata.timestamp < oldest) {
+                oldest = entry.metadata.timestamp;
+            }
+            if (!newest || entry.metadata.timestamp > newest) {
+                newest = entry.metadata.timestamp;
+            }
+            totalImportance += entry.metadata.importance;
+        }
+        return {
+            totalEntries: this.entries.length,
+            byType,
+            oldestEntry: oldest,
+            newestEntry: newest,
+            avgImportance: this.entries.length > 0 ? totalImportance / this.entries.length : 0,
+        };
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.entries = [];
+        this.isDirty = true;
+    }
+}
+// ============================================================================
+// Factory function
+// ============================================================================
+/**
+ * Create a vector memory store with default configuration
+ */
+export function createVectorMemoryStore(storageDir) {
+    const defaultDir = storageDir ?? path.join(process.env.HOME ?? '~', '.nova', 'memory');
+    return new VectorMemoryStore({ storageDir: defaultDir });
+}
+//# sourceMappingURL=VectorMemoryStore.js.map

package/dist/packages/core/src/utils/VectorMemoryStore.js.map

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

package/dist/packages/core/src/utils/helpers.d.ts

@@ -0,0 +1,24 @@
+/** Generate a random ID */
+export declare function generateId(prefix?: string): string;
+/** Sleep for a specified duration */
+export declare function sleep(ms: number): Promise<void>;
+/** Retry a function with exponential backoff */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    shouldRetry?: (error: Error) => boolean;
+}): Promise<T>;
+/** Truncate text to a maximum length */
+export declare function truncate(text: string, maxLength: number, suffix?: string): string;
+/** Format bytes as human-readable string */
+export declare function formatBytes(bytes: number): string;
+/** Format duration as human-readable string */
+export declare function formatDuration(ms: number): string;
+/** Deep clone an object */
+export declare function deepClone<T>(obj: T): T;
+/** Debounce a function */
+export declare function debounce<T extends (...args: unknown[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/** Ensure a value is within a range */
+export declare function clamp(value: number, min: number, max: number): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/packages/core/src/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../core/src/utils/helpers.ts"],"names":[],"mappings":"AAMA,2BAA2B;AAC3B,wBAAgB,UAAU,CAAC,MAAM,SAAK,GAAG,MAAM,CAG9C;AAED,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,gDAAgD;AAChD,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACpC,GACL,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAGhF;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED,0BAA0B;AAC1B,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAMvH;AAED,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/packages/core/src/utils/helpers.js

@@ -0,0 +1,77 @@
+// ============================================================================
+// Utility Helpers
+// ============================================================================
+import { randomBytes } from 'node:crypto';
+/** Generate a random ID */
+export function generateId(prefix = '') {
+    const bytes = randomBytes(8).toString('hex');
+    return prefix ? `${prefix}_${bytes}` : bytes;
+}
+/** Sleep for a specified duration */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Retry a function with exponential backoff */
+export async function retry(fn, options = {}) {
+    const { maxAttempts = 3, baseDelay = 1000, maxDelay = 30000, shouldRetry } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt === maxAttempts)
+                break;
+            if (shouldRetry && !shouldRetry(lastError))
+                break;
+            const delay = Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/** Truncate text to a maximum length */
+export function truncate(text, maxLength, suffix = '...') {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - suffix.length) + suffix;
+}
+/** Format bytes as human-readable string */
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(unitIndex === 0 ? 0 : 1)} ${units[unitIndex]}`;
+}
+/** Format duration as human-readable string */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600000)
+        return `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;
+    return `${Math.floor(ms / 3600000)}h ${Math.floor((ms % 3600000) / 60000)}m`;
+}
+/** Deep clone an object */
+export function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/** Debounce a function */
+export function debounce(fn, delay) {
+    let timer;
+    return (...args) => {
+        clearTimeout(timer);
+        timer = setTimeout(() => fn(...args), delay);
+    };
+}
+/** Ensure a value is within a range */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=helpers.js.map

package/dist/packages/core/src/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../../core/src/utils/helpers.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,2BAA2B;AAC3B,MAAM,UAAU,UAAU,CAAC,MAAM,GAAG,EAAE;IACpC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,UAKI,EAAE;IAEN,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACrF,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAY,CAAC;YACzB,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM;YACnC,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBAAE,MAAM;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACvE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB,EAAE,MAAM,GAAG,KAAK;IACtE,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAC3D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,IAAI,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,IAAI,CAAC;QACb,SAAS,EAAE,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,IAAI,EAAE,GAAG,OAAO;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IAC1F,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;AAC/E,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,QAAQ,CAAyC,EAAK,EAAE,KAAa;IACnF,IAAI,KAAoC,CAAC;IACzC,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/packages/core/src/utils/index.d.ts

@@ -0,0 +1,11 @@
+export { Logger, createLogger } from './Logger.js';
+export type { LogEntry } from './Logger.js';
+export { CheckpointManager } from './CheckpointManager.js';
+export type { Checkpoint, CheckpointFile, CheckpointStats } from './CheckpointManager.js';
+export { generateId, sleep, retry, truncate, formatBytes, formatDuration, deepClone, debounce, clamp } from './helpers.js';
+export { TokenCounter, tokenCounter, countTokens, countMessagesTokens } from './TokenCounter.js';
+export { withRetry, createRetryWrapper, RateLimiter, withRateLimit, ConcurrencyLimiter, createResilientFunction, createDefaultApiRateLimiter, createDefaultConcurrencyLimiter, } from './RetryManager.js';
+export type { RetryConfig, RateLimiterConfig } from './RetryManager.js';
+export { VectorMemoryStore, createVectorMemoryStore } from './VectorMemoryStore.js';
+export type { VectorMemoryEntry, MemoryMatch, VectorMemoryConfig } from './VectorMemoryStore.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../core/src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/packages/core/src/utils/index.js

@@ -0,0 +1,7 @@
+export { Logger, createLogger } from './Logger.js';
+export { CheckpointManager } from './CheckpointManager.js';
+export { generateId, sleep, retry, truncate, formatBytes, formatDuration, deepClone, debounce, clamp } from './helpers.js';
+export { TokenCounter, tokenCounter, countTokens, countMessagesTokens } from './TokenCounter.js';
+export { withRetry, createRetryWrapper, RateLimiter, withRateLimit, ConcurrencyLimiter, createResilientFunction, createDefaultApiRateLimiter, createDefaultConcurrencyLimiter, } from './RetryManager.js';
+export { VectorMemoryStore, createVectorMemoryStore } from './VectorMemoryStore.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/core/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../core/src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/startup/IFlowRepl.d.ts

@@ -0,0 +1,50 @@
+import type { SessionInfo, NovaConfig } from '../../../core/src/types/config.js';
+export interface IFlowReplOptions {
+    enableDropdown?: boolean;
+    showPrompt?: boolean;
+    theme?: 'light' | 'dark';
+}
+export declare class IFlowRepl {
+    private session;
+    private config;
+    private options;
+    private dropdown;
+    constructor(options?: IFlowReplOptions);
+    /**
+     * Initialize the iFlow-style REPL
+     */
+    start(session: SessionInfo, config: NovaConfig): Promise<void>;
+    /**
+     * Show professional header similar to iFlow
+     */
+    private showHeader;
+    /**
+     * Show welcome message
+     */
+    private showWelcomeMessage;
+    /**
+     * Main input loop with iFlow-style handling
+     */
+    private runInputLoop;
+    /**
+     * Show iFlow-style prompt
+     */
+    private showPrompt;
+    /**
+     * Get user input
+     */
+    private getInput;
+    /**
+     * Handle iFlow-style dropdown
+     */
+    private handleDropdown;
+    /**
+     * Execute a command
+     */
+    private executeCommand;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=IFlowRepl.d.ts.map

package/dist/startup/IFlowRepl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFlowRepl.d.ts","sourceRoot":"","sources":["../../src/startup/IFlowRepl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAGjF,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,GAAE,gBAAqB;IAiB1C;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAepE;;OAEG;IACH,OAAO,CAAC,UAAU;IA8BlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;YACW,YAAY;IAoC1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;YACW,QAAQ;IAetB;;OAEG;YACW,cAAc;IAM5B;;OAEG;YACW,cAAc;IAS5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}