@cmdoss/memwal-sdk 0.6.0

package/dist/services/storage/MemorySearchManager.js

@@ -0,0 +1,260 @@
+/**
+ * MemorySearchManager - Memory Indexing and Search Operations
+ *
+ * Handles HNSW vector indexing and semantic search for memories.
+ * Extracted from StorageService for better separation of concerns.
+ *
+ * Features:
+ * - Automatic memory indexing with embeddings
+ * - Semantic search via HNSW
+ * - Metadata-based filtering
+ * - Category and temporal search
+ */
+/**
+ * MemorySearchManager - Manages memory indexing and semantic search
+ *
+ * Coordinates between:
+ * - EmbeddingService for vector generation
+ * - MemoryIndexService for HNSW indexing
+ * - Metadata filtering and relevance scoring
+ */
+export class MemorySearchManager {
+    constructor() {
+        // Services will be initialized via initializeSearch()
+    }
+    /**
+     * Initialize search capabilities
+     */
+    initializeSearch(embeddingService, memoryIndexService) {
+        this.embeddingService = embeddingService;
+        this.memoryIndexService = memoryIndexService;
+        if (this.memoryIndexService) {
+            this.memoryIndexService.initialize(embeddingService, undefined);
+        }
+        console.log('✅ MemorySearchManager: Search capabilities initialized');
+    }
+    /**
+     * Index a memory for semantic search
+     *
+     * @param userAddress - Owner address
+     * @param memoryId - Unique memory identifier
+     * @param blobId - Walrus blob ID
+     * @param textContent - Content for embedding generation
+     * @param metadata - Memory metadata
+     * @returns Indexing result with vector ID
+     */
+    async indexMemory(userAddress, memoryId, blobId, textContent, metadata) {
+        if (!this.embeddingService || !this.memoryIndexService) {
+            throw new Error('Search capabilities not initialized. Call initializeSearch() first.');
+        }
+        // Option A+: Pass isEncrypted flag to control content storage in index
+        // When encrypted, content is NOT stored locally (security consideration)
+        const indexResult = await this.memoryIndexService.indexMemory(userAddress, memoryId, blobId, textContent, metadata, undefined, // embedding - let MemoryIndexService generate it
+        { isEncrypted: metadata.isEncrypted ?? false });
+        console.log(`✅ Indexed memory ${memoryId} → vector ${indexResult.vectorId}`);
+        return {
+            vectorId: indexResult.vectorId,
+            blobId,
+            memoryId
+        };
+    }
+    /**
+     * Search memories by metadata with semantic understanding
+     *
+     * @param userAddress - Owner address
+     * @param searchQuery - Search query with filters
+     * @returns Array of matching memories with relevance scores
+     */
+    async searchByMetadata(userAddress, searchQuery) {
+        if (!this.embeddingService || !this.memoryIndexService) {
+            throw new Error('Search capabilities not initialized. Call initializeSearch() first.');
+        }
+        try {
+            console.log(`🔍 Searching memories for user ${userAddress}`);
+            // Convert to MemoryIndexService query format
+            const memoryQuery = {
+                query: searchQuery.query,
+                vector: searchQuery.vector,
+                userAddress,
+                k: searchQuery.k || 10,
+                threshold: searchQuery.threshold,
+                categories: searchQuery.filters?.category
+                    ? (Array.isArray(searchQuery.filters.category)
+                        ? searchQuery.filters.category
+                        : [searchQuery.filters.category])
+                    : undefined,
+                dateRange: searchQuery.filters?.dateRange,
+                importanceRange: searchQuery.filters?.importance,
+                tags: searchQuery.filters?.tags,
+                includeContent: searchQuery.includeContent
+            };
+            const results = await this.memoryIndexService.searchMemories(memoryQuery);
+            // Convert to MetadataSearchResult format
+            const metadataResults = results.map(result => ({
+                blobId: result.blobId,
+                content: result.content,
+                metadata: result.metadata,
+                similarity: result.similarity,
+                relevanceScore: result.relevanceScore
+            }));
+            console.log(`✅ Found ${metadataResults.length} matching memories`);
+            return metadataResults;
+        }
+        catch (error) {
+            console.error('❌ Metadata search failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get all indexed memories for a user with optional filtering
+     */
+    async getUserMemoriesWithMetadata(userAddress, filters) {
+        if (!this.memoryIndexService) {
+            throw new Error('Memory indexing not initialized. Call initializeSearch() first.');
+        }
+        // Convert filters to MemoryIndexService format
+        const indexFilters = filters ? {
+            categories: filters.category
+                ? (Array.isArray(filters.category) ? filters.category : [filters.category])
+                : undefined,
+            dateRange: filters.dateRange,
+            importanceRange: filters.importance
+        } : undefined;
+        const memories = await this.memoryIndexService.getUserMemories(userAddress, indexFilters);
+        // Convert to MetadataSearchResult format
+        return memories.map(memory => ({
+            blobId: memory.blobId,
+            metadata: memory.metadata,
+            similarity: memory.similarity,
+            relevanceScore: memory.relevanceScore
+        }));
+    }
+    /**
+     * Search by category with additional filtering
+     */
+    async searchByCategory(userAddress, category, additionalFilters) {
+        return this.searchByMetadata(userAddress, {
+            filters: {
+                category,
+                ...additionalFilters
+            },
+            k: 50,
+            includeContent: false
+        });
+    }
+    /**
+     * Search memories within time range
+     */
+    async searchByTimeRange(userAddress, startDate, endDate, additionalFilters) {
+        return this.searchByMetadata(userAddress, {
+            filters: {
+                dateRange: { start: startDate, end: endDate },
+                ...additionalFilters
+            },
+            k: 100,
+            includeContent: false
+        });
+    }
+    /**
+     * Get search analytics and statistics
+     */
+    getSearchAnalytics(userAddress) {
+        if (!this.memoryIndexService) {
+            return {
+                totalMemories: 0,
+                categoryCounts: {},
+                averageImportance: 0,
+                timeRange: null,
+                topTags: []
+            };
+        }
+        const stats = this.memoryIndexService.getIndexStats(userAddress);
+        return {
+            totalMemories: stats.totalMemories,
+            categoryCounts: stats.categoryCounts,
+            averageImportance: stats.averageImportance,
+            timeRange: stats.oldestMemory && stats.newestMemory ? {
+                earliest: stats.oldestMemory,
+                latest: stats.newestMemory
+            } : null,
+            topTags: [] // TODO: Implement tag extraction
+        };
+    }
+    /**
+     * Get service statistics
+     */
+    getServiceStats() {
+        return this.memoryIndexService?.getServiceStats() || {
+            totalUsers: 0,
+            totalMemories: 0,
+            averageMemoriesPerUser: 0
+        };
+    }
+    /**
+     * Calculate relevance score combining similarity, importance, and recency
+     */
+    calculateRelevanceScore(similarity, metadata, query) {
+        let score = similarity * 0.6; // Base similarity weight
+        // Boost by importance
+        score += (metadata.importance || 5) * 0.1;
+        // Recent content boost
+        const ageInDays = (Date.now() - (metadata.createdTimestamp || 0)) / (1000 * 60 * 60 * 24);
+        const recencyBoost = Math.max(0, (30 - ageInDays) / 30) * 0.2;
+        score += recencyBoost;
+        // Category exact match boost
+        if (query.filters?.category && metadata.category === query.filters.category) {
+            score += 0.1;
+        }
+        return Math.min(1.0, score);
+    }
+    /**
+     * Check if memory matches filters
+     */
+    matchesFilters(metadata, filters) {
+        // Category filter
+        if (filters.category) {
+            const categories = Array.isArray(filters.category) ? filters.category : [filters.category];
+            if (!categories.includes(metadata.category))
+                return false;
+        }
+        // Topic filter
+        if (filters.topic) {
+            const topics = Array.isArray(filters.topic) ? filters.topic : [filters.topic];
+            if (!topics.includes(metadata.topic))
+                return false;
+        }
+        // Importance range
+        if (filters.importance) {
+            const importance = metadata.importance || 5;
+            if (filters.importance.min && importance < filters.importance.min)
+                return false;
+            if (filters.importance.max && importance > filters.importance.max)
+                return false;
+        }
+        // Content type filter
+        if (filters.contentType) {
+            const contentTypes = Array.isArray(filters.contentType)
+                ? filters.contentType
+                : [filters.contentType];
+            if (!contentTypes.includes(metadata.contentType))
+                return false;
+        }
+        // Content size filter
+        if (filters.contentSize) {
+            const size = metadata.contentSize || 0;
+            if (filters.contentSize.min && size < filters.contentSize.min)
+                return false;
+            if (filters.contentSize.max && size > filters.contentSize.max)
+                return false;
+        }
+        // Custom tag filtering
+        if (filters.tags && filters.tags.length > 0) {
+            const metadataText = JSON.stringify(metadata).toLowerCase();
+            const hasMatchingTag = filters.tags.some(tag => metadataText.includes(tag.toLowerCase()));
+            if (!hasMatchingTag)
+                return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=MemorySearchManager.js.map

package/dist/services/storage/MemorySearchManager.js.map

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

package/dist/services/storage/QuiltBatchManager.d.ts

@@ -0,0 +1,185 @@
+/**
+ * QuiltBatchManager - Batch Memory Operations via Walrus Quilts
+ *
+ * Handles batch uploads and queries using Walrus Quilt functionality.
+ * Extracted from StorageService for better separation of concerns.
+ *
+ * Features:
+ * - Batch upload with ~90% gas savings (single transaction for multiple files)
+ * - Tag-based filtering at the Walrus level
+ * - Multi-file retrieval via quiltPatchId
+ * - Browser-compatible using writeFilesFlow
+ *
+ * Quilt Structure:
+ * - quiltId: ID of the entire batch (blob containing all files)
+ * - quiltPatchId: Unique ID for each file within the quilt
+ * - identifier: Human-readable name for each file
+ * - tags: Metadata for filtering (category, importance, etc.)
+ *
+ * @see https://sdk.mystenlabs.com/walrus/index
+ */
+import { WalrusClient, WalrusFile } from '@mysten/walrus';
+import type { Signer } from '@mysten/sui/cryptography';
+import type { ClientWithExtensions } from '@mysten/sui/experimental';
+import type { SuiClient } from '@mysten/sui/client';
+export interface BatchMemory {
+    content: string;
+    category: string;
+    importance: number;
+    topic: string;
+    embedding: number[];
+    encryptedContent: Uint8Array;
+    summary?: string;
+    id?: string;
+}
+export interface QuiltUploadOptions {
+    signer: Signer;
+    epochs?: number;
+    userAddress: string;
+    deletable?: boolean;
+}
+export interface QuiltFileResult {
+    identifier: string;
+    blobId: string;
+    quiltPatchId?: string;
+    tags: Record<string, string>;
+    size: number;
+}
+export interface QuiltUploadResult {
+    quiltId: string;
+    blobObjectId?: string;
+    files: QuiltFileResult[];
+    uploadTimeMs: number;
+    totalSize: number;
+    gasSaved: string;
+}
+export interface QuiltRetrieveResult {
+    identifier: string;
+    content: Uint8Array;
+    tags: Record<string, string>;
+    retrievalTimeMs: number;
+}
+export interface QuiltListResult {
+    identifier: string;
+    quiltPatchId: string;
+    tags: Record<string, string>;
+}
+/**
+ * QuiltBatchManager - Manages batch memory operations via Quilts
+ *
+ * Quilts provide:
+ * - Multi-file uploads in single transaction (~90% gas savings)
+ * - Tag-based metadata for filtering
+ * - Efficient retrieval via identifier or quiltPatchId
+ *
+ * @example
+ * ```typescript
+ * const manager = new QuiltBatchManager(walrus, sui, true, 3);
+ *
+ * // Upload batch
+ * const result = await manager.uploadMemoryBatch(memories, { signer, userAddress });
+ *
+ * // Retrieve all files
+ * const files = await manager.getQuiltFiles(result.quiltId);
+ *
+ * // Retrieve by identifier
+ * const file = await manager.getFileByIdentifier(result.quiltId, 'memory-123.json');
+ *
+ * // Filter by tags
+ * const facts = await manager.getQuiltFilesByTags(result.quiltId, [{ category: 'fact' }]);
+ * ```
+ */
+export declare class QuiltBatchManager {
+    private walrusWithRelay;
+    private walrusWithoutRelay;
+    private suiClient;
+    private useUploadRelay;
+    private epochs;
+    constructor(walrusWithRelay: WalrusClient, walrusWithoutRelay: WalrusClient, suiClient: ClientWithExtensions<{
+        jsonRpc: SuiClient;
+        walrus: WalrusClient;
+    }>, useUploadRelay: boolean, epochs: number);
+    /**
+     * Upload batch of memories as a Quilt
+     *
+     * Each memory becomes a WalrusFile with:
+     * - Identifier: unique file name (memory-{timestamp}-{index}-{random}.json)
+     * - Tags: plaintext metadata (searchable)
+     * - Content: encrypted data (Uint8Array)
+     *
+     * @param memories - Array of BatchMemory objects
+     * @param options - Upload options including signer and userAddress
+     * @returns QuiltUploadResult with quiltId and file details
+     */
+    uploadMemoryBatch(memories: BatchMemory[], options: QuiltUploadOptions): Promise<QuiltUploadResult>;
+    /**
+     * Upload raw files as a Quilt (non-memory data)
+     *
+     * @param files - Array of { identifier, data, tags }
+     * @param options - Upload options
+     * @returns QuiltUploadResult
+     */
+    uploadFilesBatch(files: Array<{
+        identifier: string;
+        data: Uint8Array;
+        tags?: Record<string, string>;
+    }>, options: QuiltUploadOptions): Promise<QuiltUploadResult>;
+    /**
+     * Retrieve all files from a Quilt
+     *
+     * @param quiltId - The Quilt blob ID
+     * @returns Array of WalrusFile objects
+     */
+    getQuiltFiles(quiltId: string): Promise<Array<WalrusFile>>;
+    /**
+     * Retrieve a specific file by identifier from a Quilt
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param identifier - The file identifier within the quilt
+     * @returns QuiltRetrieveResult with content and metadata
+     */
+    getFileByIdentifier(quiltId: string, identifier: string): Promise<QuiltRetrieveResult>;
+    /**
+     * List all patches in a Quilt with their metadata
+     *
+     * @param quiltId - The Quilt blob ID
+     * @returns Array of QuiltListResult with identifiers and tags
+     */
+    listQuiltPatches(quiltId: string): Promise<QuiltListResult[]>;
+    /**
+     * Query Quilt files by tags (client-side filtering)
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param tagFilters - Array of tag key-value pairs to match
+     * @returns Array of matching WalrusFile objects
+     */
+    getQuiltFilesByTags(quiltId: string, tagFilters: Array<Record<string, string>>): Promise<Array<WalrusFile>>;
+    /**
+     * Query files by category
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param category - Category to filter by
+     * @returns Array of matching WalrusFile objects
+     */
+    getFilesByCategory(quiltId: string, category: string): Promise<Array<WalrusFile>>;
+    /**
+     * Query files by importance threshold
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param minImportance - Minimum importance value
+     * @returns Array of matching WalrusFile objects
+     */
+    getFilesByImportance(quiltId: string, minImportance: number): Promise<Array<WalrusFile>>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        useUploadRelay: boolean;
+        epochs: number;
+    };
+    /**
+     * Get Walrus client
+     */
+    getWalrusClient(useRelay?: boolean): WalrusClient;
+}
+//# sourceMappingURL=QuiltBatchManager.d.ts.map

package/dist/services/storage/QuiltBatchManager.d.ts.map

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