@cmdoss/memwal-sdk 0.6.0

package/dist/vector/VectorManager.d.ts

@@ -0,0 +1,142 @@
+/**
+ * VectorManager - High-level Vector Operations Orchestrator
+ *
+ * Provides a unified interface for vector operations combining
+ * embedding generation and HNSW indexing with smart caching.
+ * Uses hybrid HNSW implementation (browser: wasm, node: native).
+ */
+import { VectorEmbedding, EmbeddingConfig, HNSWIndexConfig, BatchConfig, VectorSearchMatch } from '../embedding/types';
+export interface VectorManagerConfig {
+    embedding: EmbeddingConfig;
+    index?: Partial<HNSWIndexConfig>;
+    batch?: Partial<BatchConfig>;
+    enableAutoIndex?: boolean;
+    enableMemoryCache?: boolean;
+}
+export interface VectorOperationResult {
+    success: boolean;
+    vectorId?: number;
+    embedding?: VectorEmbedding;
+    indexBlobId?: string;
+    processingTime: number;
+    error?: string;
+}
+export interface VectorSearchStats {
+    searchTime: number;
+    embeddingTime: number;
+    indexSearchTime: number;
+    totalResults: number;
+    cacheHits: number;
+    indexSize: number;
+}
+/**
+ * Unified vector operations manager
+ */
+export declare class VectorManager {
+    private embeddingService;
+    private indexService;
+    private indexServicePromise;
+    private vectorIdCounter;
+    private memoryCache;
+    private config;
+    constructor(config: VectorManagerConfig);
+    /**
+     * Initialize HNSW service using factory
+     */
+    private initializeIndexService;
+    /**
+     * Get HNSW service (waits for initialization if needed)
+     */
+    private getIndexService;
+    /**
+     * Add text content to vector index (embed + index)
+     */
+    addTextToIndex(userAddress: string, text: string, options?: {
+        vectorId?: number;
+        metadata?: any;
+        embeddingType?: 'content' | 'metadata' | 'query';
+        enableCache?: boolean;
+    }): Promise<VectorOperationResult>;
+    /**
+     * Search for similar texts using vector similarity
+     */
+    searchSimilarTexts(userAddress: string, queryText: string, options?: {
+        k?: number;
+        threshold?: number;
+        efSearch?: number;
+        category?: string;
+        metadata?: any;
+        includeEmbeddings?: boolean;
+    }): Promise<{
+        results: VectorSearchMatch[];
+        stats: VectorSearchStats;
+    }>;
+    /**
+     * Batch add multiple texts to index
+     */
+    addTextsBatch(userAddress: string, texts: Array<{
+        text: string;
+        metadata?: any;
+        embeddingType?: 'content' | 'metadata' | 'query';
+    }>, options?: {
+        batchSize?: number;
+        enableCache?: boolean;
+    }): Promise<{
+        results: VectorOperationResult[];
+        stats: {
+            totalTime: number;
+            embeddingTime: number;
+            indexingTime: number;
+            successCount: number;
+            failureCount: number;
+        };
+    }>;
+    /**
+     * Load user's vector index from storage
+     */
+    loadUserIndex(userAddress: string, indexBlobId?: string): Promise<void>;
+    /**
+     * Save user's vector index to storage
+     */
+    saveUserIndex(userAddress: string): Promise<void>;
+    /**
+     * Force flush pending vectors for a user
+     */
+    forceFlushUser(userAddress: string): Promise<void>;
+    /**
+     * Get vector processing statistics
+     */
+    getStats(): Promise<{
+        index: import("./IHnswService").IHnswBatchStats | null;
+        embedding: {
+            totalRequests: number;
+            requestsThisMinute: number;
+            model: string;
+            dimensions: number;
+            rateLimit: number;
+            provider: string;
+        };
+        cache: {
+            memoryCache: {
+                size: number;
+                enabled: boolean | undefined;
+            };
+            vectorIdCounters: {
+                [k: string]: number;
+            };
+        };
+    }>;
+    /**
+     * Clear cache and reset state for a user
+     */
+    clearUserData(userAddress: string): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    private getNextVectorId;
+    private hashText;
+    private matchesMetadata;
+}
+export default VectorManager;
+//# sourceMappingURL=VectorManager.d.ts.map

package/dist/vector/VectorManager.d.ts.map

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

package/dist/vector/VectorManager.js

@@ -0,0 +1,339 @@
+/**
+ * VectorManager - High-level Vector Operations Orchestrator
+ *
+ * Provides a unified interface for vector operations combining
+ * embedding generation and HNSW indexing with smart caching.
+ * Uses hybrid HNSW implementation (browser: wasm, node: native).
+ */
+import { EmbeddingService } from '../services/EmbeddingService.js';
+import { createHnswService, isBrowser, isNode } from './createHnswService.js';
+/**
+ * Unified vector operations manager
+ */
+export class VectorManager {
+    constructor(config) {
+        this.indexService = null;
+        this.indexServicePromise = null;
+        this.vectorIdCounter = new Map(); // userAddress -> nextVectorId
+        this.memoryCache = new Map(); // text hash -> embedding
+        this.config = config;
+        // Initialize embedding service
+        this.embeddingService = new EmbeddingService(config.embedding);
+        // Initialize HNSW index service asynchronously using factory
+        this.indexServicePromise = this.initializeIndexService();
+        const envType = isBrowser() ? 'browser (hnswlib-wasm)' : isNode() ? 'Node.js (hnswlib-node)' : 'unknown';
+        console.log(`✅ VectorManager initializing with hybrid HNSW (${envType})`);
+    }
+    /**
+     * Initialize HNSW service using factory
+     */
+    async initializeIndexService() {
+        try {
+            const service = await createHnswService({
+                indexConfig: {
+                    dimension: this.config.index?.dimension || 3072,
+                    maxElements: this.config.index?.maxElements || 10000,
+                    efConstruction: this.config.index?.efConstruction || 200,
+                    m: this.config.index?.m || 16
+                },
+                batchConfig: this.config.batch
+            });
+            this.indexService = service;
+            console.log('✅ VectorManager HNSW service initialized successfully');
+            return service;
+        }
+        catch (error) {
+            console.error('❌ Failed to initialize HNSW service:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get HNSW service (waits for initialization if needed)
+     */
+    async getIndexService() {
+        if (this.indexService) {
+            return this.indexService;
+        }
+        if (this.indexServicePromise) {
+            return this.indexServicePromise;
+        }
+        throw new Error('HNSW service not initialized');
+    }
+    /**
+     * Add text content to vector index (embed + index)
+     */
+    async addTextToIndex(userAddress, text, options = {}) {
+        const startTime = Date.now();
+        try {
+            // Generate or get cached embedding
+            let embedding;
+            const textHash = this.hashText(text);
+            if (options.enableCache !== false && this.config.enableMemoryCache && this.memoryCache.has(textHash)) {
+                embedding = this.memoryCache.get(textHash);
+                console.debug(`Using cached embedding for text hash: ${textHash.substring(0, 8)}`);
+            }
+            else {
+                // Generate new embedding
+                const embeddingResult = await this.embeddingService.embedText({
+                    text,
+                    type: options.embeddingType || 'content'
+                });
+                embedding = {
+                    vector: embeddingResult.vector,
+                    dimension: embeddingResult.dimension,
+                    model: embeddingResult.model,
+                    metadata: {
+                        contentType: 'text/plain',
+                        timestamp: Date.now(),
+                        source: 'vector-manager',
+                        ...options.metadata
+                    }
+                };
+                // Cache if enabled
+                if (this.config.enableMemoryCache) {
+                    this.memoryCache.set(textHash, embedding);
+                }
+            }
+            // Get vector ID
+            const vectorId = options.vectorId || this.getNextVectorId(userAddress);
+            // Add to HNSW index
+            if (this.config.enableAutoIndex !== false) {
+                const indexService = await this.getIndexService();
+                await indexService.addVector(userAddress, vectorId, embedding.vector, { text, ...options.metadata });
+            }
+            return {
+                success: true,
+                vectorId,
+                embedding,
+                processingTime: Date.now() - startTime
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                processingTime: Date.now() - startTime,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Search for similar texts using vector similarity
+     */
+    async searchSimilarTexts(userAddress, queryText, options = {}) {
+        const totalStartTime = Date.now();
+        try {
+            // Generate query embedding
+            const embeddingStartTime = Date.now();
+            const queryEmbedding = await this.embeddingService.embedText({
+                text: queryText,
+                type: 'query'
+            });
+            const embeddingTime = Date.now() - embeddingStartTime;
+            // Search in HNSW index
+            const indexStartTime = Date.now();
+            const indexService = await this.getIndexService();
+            const searchResults = await indexService.search(userAddress, queryEmbedding.vector, {
+                k: options.k || 10,
+                ef: options.efSearch || 50,
+                filter: options.metadata ? (meta) => this.matchesMetadata(meta, options.metadata) : undefined
+            });
+            const indexSearchTime = Date.now() - indexStartTime;
+            // Convert HNSW results to VectorSearchMatch format
+            const results = [];
+            for (const result of searchResults) {
+                const vectorId = result.vectorId;
+                const distance = result.distance;
+                const similarity = result.score;
+                // Apply threshold filter
+                if (options.threshold && similarity < options.threshold) {
+                    continue;
+                }
+                const match = {
+                    memoryId: `memory_${vectorId}`, // TODO: Map to actual memory ID
+                    vectorId,
+                    similarity,
+                    distance,
+                    metadata: {} // TODO: Get metadata from index
+                };
+                if (options.includeEmbeddings) {
+                    match.embedding = {
+                        vector: [], // TODO: Store and retrieve vectors
+                        dimension: queryEmbedding.dimension,
+                        model: queryEmbedding.model
+                    };
+                }
+                results.push(match);
+            }
+            const stats = {
+                searchTime: Date.now() - totalStartTime,
+                embeddingTime,
+                indexSearchTime,
+                totalResults: results.length,
+                cacheHits: 0, // TODO: Track cache hits
+                indexSize: 0 // TODO: Get from index service
+            };
+            return { results, stats };
+        }
+        catch (error) {
+            throw new Error(`Vector search failed: ${error}`);
+        }
+    }
+    /**
+     * Batch add multiple texts to index
+     */
+    async addTextsBatch(userAddress, texts, options = {}) {
+        const startTime = Date.now();
+        const batchSize = options.batchSize || 10;
+        const results = [];
+        // Extract texts for batch embedding
+        const textContents = texts.map(t => t.text);
+        // Generate embeddings in batch
+        const embeddingStartTime = Date.now();
+        const batchEmbeddings = await this.embeddingService.embedBatch(textContents);
+        const embeddingTime = Date.now() - embeddingStartTime;
+        // Add to index
+        const indexingStartTime = Date.now();
+        for (let i = 0; i < texts.length; i++) {
+            try {
+                const text = texts[i];
+                const vector = batchEmbeddings.vectors[i];
+                const vectorId = this.getNextVectorId(userAddress);
+                const embedding = {
+                    vector,
+                    dimension: batchEmbeddings.dimension,
+                    model: batchEmbeddings.model,
+                    metadata: {
+                        contentType: 'text/plain',
+                        timestamp: Date.now(),
+                        ...text.metadata
+                    }
+                };
+                // Add to index
+                if (this.config.enableAutoIndex !== false) {
+                    const indexService = await this.getIndexService();
+                    await indexService.addVector(userAddress, vectorId, vector, text.metadata);
+                }
+                // Cache embedding
+                if (this.config.enableMemoryCache && options.enableCache !== false) {
+                    const textHash = this.hashText(text.text);
+                    this.memoryCache.set(textHash, embedding);
+                }
+                results.push({
+                    success: true,
+                    vectorId,
+                    embedding,
+                    processingTime: 0 // Individual timing not tracked in batch
+                });
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    processingTime: 0,
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                });
+            }
+        }
+        const indexingTime = Date.now() - indexingStartTime;
+        const totalTime = Date.now() - startTime;
+        return {
+            results,
+            stats: {
+                totalTime,
+                embeddingTime,
+                indexingTime,
+                successCount: results.filter(r => r.success).length,
+                failureCount: results.filter(r => !r.success).length
+            }
+        };
+    }
+    /**
+     * Load user's vector index from storage
+     */
+    async loadUserIndex(userAddress, indexBlobId) {
+        const indexService = await this.getIndexService();
+        await indexService.loadIndex(userAddress);
+    }
+    /**
+     * Save user's vector index to storage
+     */
+    async saveUserIndex(userAddress) {
+        const indexService = await this.getIndexService();
+        await indexService.saveIndex(userAddress);
+    }
+    /**
+     * Force flush pending vectors for a user
+     */
+    async forceFlushUser(userAddress) {
+        const indexService = await this.getIndexService();
+        await indexService.flushBatch(userAddress);
+    }
+    /**
+     * Get vector processing statistics
+     */
+    async getStats() {
+        const embeddingStats = this.embeddingService.getStats();
+        let indexStats = null;
+        if (this.indexService) {
+            indexStats = this.indexService.getBatchStats();
+        }
+        return {
+            index: indexStats,
+            embedding: embeddingStats,
+            cache: {
+                memoryCache: {
+                    size: this.memoryCache.size,
+                    enabled: this.config.enableMemoryCache
+                },
+                vectorIdCounters: Object.fromEntries(this.vectorIdCounter)
+            }
+        };
+    }
+    /**
+     * Clear cache and reset state for a user
+     */
+    async clearUserData(userAddress) {
+        const indexService = await this.getIndexService();
+        await indexService.deleteIndex(userAddress);
+        this.vectorIdCounter.delete(userAddress);
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        if (this.indexService) {
+            this.indexService.destroy();
+        }
+        this.indexService = null;
+        this.indexServicePromise = null;
+        this.memoryCache.clear();
+        this.vectorIdCounter.clear();
+    }
+    // ==================== PRIVATE METHODS ====================
+    getNextVectorId(userAddress) {
+        const current = this.vectorIdCounter.get(userAddress) || 0;
+        const next = current + 1;
+        this.vectorIdCounter.set(userAddress, next);
+        return next;
+    }
+    hashText(text) {
+        // Simple hash function for text caching
+        let hash = 0;
+        for (let i = 0; i < text.length; i++) {
+            const char = text.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+    matchesMetadata(metadata, filter) {
+        if (!metadata || !filter)
+            return true;
+        for (const [key, value] of Object.entries(filter)) {
+            if (metadata[key] !== value)
+                return false;
+        }
+        return true;
+    }
+}
+export default VectorManager;
+//# sourceMappingURL=VectorManager.js.map

package/dist/vector/VectorManager.js.map

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

package/dist/vector/createHnswService.d.ts

@@ -0,0 +1,51 @@
+/**
+ * createHnswService - Factory for Environment-Aware HNSW Service
+ *
+ * Automatically detects the runtime environment and returns the appropriate
+ * HNSW implementation:
+ * - Browser: BrowserHnswIndexService (hnswlib-wasm)
+ * - Node.js: NodeHnswService (hnswlib-node)
+ *
+ * Uses singleton pattern to prevent redundant initializations.
+ */
+import type { IHnswService, HnswServiceConfig } from './IHnswService';
+import { isBrowser, isNode } from './IHnswService';
+export { isBrowser, isNode };
+/**
+ * Create an HNSW service appropriate for the current environment.
+ * Uses singleton pattern - subsequent calls return the same instance.
+ *
+ * @param config - Service configuration (only used on first call)
+ * @returns Promise<IHnswService> - The appropriate HNSW service for the environment
+ *
+ * @example
+ * ```typescript
+ * const hnswService = await createHnswService({
+ *   indexConfig: { dimension: 768 }
+ * });
+ *
+ * await hnswService.addVector(userAddress, vectorId, embedding);
+ * const results = await hnswService.search(userAddress, queryEmbedding);
+ * ```
+ */
+export declare function createHnswService(config?: HnswServiceConfig): Promise<IHnswService>;
+/**
+ * Reset the singleton instance (useful for testing)
+ */
+export declare function resetHnswServiceSingleton(): void;
+/**
+ * Get singleton statistics
+ */
+export declare function getHnswServiceStats(): {
+    instanceCount: number;
+    isInitialized: boolean;
+};
+/**
+ * Check if HNSW service is available in the current environment
+ */
+export declare function isHnswAvailable(): boolean;
+/**
+ * Get the type of HNSW service that would be used
+ */
+export declare function getHnswServiceType(): 'browser' | 'node' | 'none';
+//# sourceMappingURL=createHnswService.d.ts.map

package/dist/vector/createHnswService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHnswService.d.ts","sourceRoot":"","sources":["../../src/vector/createHnswService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAO7B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2B7F;AA+BD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAQhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAKvF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,GAAG,MAAM,GAAG,MAAM,CAIhE"}

package/dist/vector/createHnswService.js

@@ -0,0 +1,120 @@
+/**
+ * createHnswService - Factory for Environment-Aware HNSW Service
+ *
+ * Automatically detects the runtime environment and returns the appropriate
+ * HNSW implementation:
+ * - Browser: BrowserHnswIndexService (hnswlib-wasm)
+ * - Node.js: NodeHnswService (hnswlib-node)
+ *
+ * Uses singleton pattern to prevent redundant initializations.
+ */
+import { isBrowser, isNode } from './IHnswService.js';
+// Re-export environment detection functions
+export { isBrowser, isNode };
+// Singleton instance and initialization promise
+let singletonInstance = null;
+let singletonInitPromise = null;
+let instanceCount = 0;
+/**
+ * Create an HNSW service appropriate for the current environment.
+ * Uses singleton pattern - subsequent calls return the same instance.
+ *
+ * @param config - Service configuration (only used on first call)
+ * @returns Promise<IHnswService> - The appropriate HNSW service for the environment
+ *
+ * @example
+ * ```typescript
+ * const hnswService = await createHnswService({
+ *   indexConfig: { dimension: 768 }
+ * });
+ *
+ * await hnswService.addVector(userAddress, vectorId, embedding);
+ * const results = await hnswService.search(userAddress, queryEmbedding);
+ * ```
+ */
+export async function createHnswService(config = {}) {
+    // Return existing singleton if available
+    if (singletonInstance) {
+        instanceCount++;
+        console.log(`[createHnswService] Returning singleton instance (request #${instanceCount})`);
+        return singletonInstance;
+    }
+    // Return pending initialization promise if already in progress
+    if (singletonInitPromise) {
+        instanceCount++;
+        console.log(`[createHnswService] Waiting for pending initialization (request #${instanceCount})`);
+        return singletonInitPromise;
+    }
+    // Create new singleton instance
+    instanceCount = 1;
+    singletonInitPromise = createNewInstance(config);
+    try {
+        singletonInstance = await singletonInitPromise;
+        return singletonInstance;
+    }
+    catch (error) {
+        // Reset on failure to allow retry
+        singletonInitPromise = null;
+        throw error;
+    }
+}
+/**
+ * Internal function to create a new HNSW service instance
+ */
+async function createNewInstance(config) {
+    if (isBrowser()) {
+        console.log('[createHnswService] Browser environment detected, using hnswlib-wasm');
+        // Dynamic import for browser service
+        const { BrowserHnswIndexService } = await import('./BrowserHnswIndexService.js');
+        const service = new BrowserHnswIndexService(config.indexConfig);
+        return service;
+    }
+    if (isNode()) {
+        console.log('[createHnswService] Node.js environment detected, using hnswlib-node');
+        // Dynamic import for Node.js service
+        const { NodeHnswService } = await import('./NodeHnswService.js');
+        const service = new NodeHnswService(config);
+        await service.initialize();
+        return service;
+    }
+    throw new Error('Unsupported environment: HNSW service requires either a browser (for hnswlib-wasm) ' +
+        'or Node.js (for hnswlib-node) environment.');
+}
+/**
+ * Reset the singleton instance (useful for testing)
+ */
+export function resetHnswServiceSingleton() {
+    if (singletonInstance) {
+        singletonInstance.destroy();
+    }
+    singletonInstance = null;
+    singletonInitPromise = null;
+    instanceCount = 0;
+    console.log('[createHnswService] Singleton instance reset');
+}
+/**
+ * Get singleton statistics
+ */
+export function getHnswServiceStats() {
+    return {
+        instanceCount,
+        isInitialized: singletonInstance !== null
+    };
+}
+/**
+ * Check if HNSW service is available in the current environment
+ */
+export function isHnswAvailable() {
+    return isBrowser() || isNode();
+}
+/**
+ * Get the type of HNSW service that would be used
+ */
+export function getHnswServiceType() {
+    if (isBrowser())
+        return 'browser';
+    if (isNode())
+        return 'node';
+    return 'none';
+}
+//# sourceMappingURL=createHnswService.js.map