@cmdoss/memwal-sdk 0.6.0

package/dist/hooks.wip/useMemoryManager.js

@@ -0,0 +1,86 @@
+/**
+ * useMemoryManager - Foundation hook for Personal Data Wallet
+ *
+ * Creates and maintains a stable ClientMemoryManager instance.
+ * Auto-configured from environment variables with optional overrides.
+ *
+ * @example
+ * ```tsx
+ * import { useMemoryManager } from 'personal-data-wallet-sdk/hooks';
+ * import { useCurrentAccount } from '@mysten/dapp-kit';
+ *
+ * function MyComponent() {
+ *   const account = useCurrentAccount();
+ *   const manager = useMemoryManager({
+ *     packageId: process.env.NEXT_PUBLIC_PACKAGE_ID
+ *   });
+ *
+ *   if (!manager) return <div>Connect wallet to continue</div>;
+ *
+ *   return <div>Manager ready!</div>;
+ * }
+ * ```
+ */
+import { useMemo } from 'react';
+import { ClientMemoryManager } from '../client/ClientMemoryManager.js';
+/**
+ * Get environment variable with fallback
+ */
+function getEnvVar(key, fallback) {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key] || fallback;
+    }
+    return fallback;
+}
+/**
+ * Initialize and provide access to ClientMemoryManager instance
+ *
+ * @param config - Optional configuration (uses env vars as defaults)
+ * @returns ClientMemoryManager instance or null if wallet not connected
+ */
+export function useMemoryManager(config) {
+    // Merge config with environment variables
+    const memoizedConfig = useMemo(() => {
+        const packageId = config?.packageId || getEnvVar('NEXT_PUBLIC_PACKAGE_ID');
+        const accessRegistryId = config?.accessRegistryId || getEnvVar('NEXT_PUBLIC_ACCESS_REGISTRY_ID');
+        const walrusAggregator = config?.walrusAggregator || getEnvVar('NEXT_PUBLIC_WALRUS_AGGREGATOR');
+        const geminiApiKey = config?.geminiApiKey || getEnvVar('NEXT_PUBLIC_GEMINI_API_KEY');
+        // Validate required config
+        if (!packageId || !accessRegistryId || !walrusAggregator || !geminiApiKey) {
+            console.warn('⚠️ Missing required configuration for ClientMemoryManager');
+            return null;
+        }
+        return {
+            packageId,
+            accessRegistryId,
+            walrusAggregator,
+            geminiApiKey,
+            sealServerObjectIds: config?.sealServerObjectIds,
+            walrusNetwork: config?.walrusNetwork || 'testnet',
+            categories: config?.categories,
+        };
+    }, [
+        config?.packageId,
+        config?.accessRegistryId,
+        config?.walrusAggregator,
+        config?.geminiApiKey,
+        config?.sealServerObjectIds,
+        config?.walrusNetwork,
+        config?.categories,
+    ]);
+    // Create stable manager instance
+    const manager = useMemo(() => {
+        if (!memoizedConfig)
+            return null;
+        try {
+            return new ClientMemoryManager(memoizedConfig);
+        }
+        catch (error) {
+            console.error('Failed to create ClientMemoryManager:', error);
+            return null;
+        }
+    }, [memoizedConfig]);
+    return manager;
+}
+export default useMemoryManager;
+//# sourceMappingURL=useMemoryManager.js.map

package/dist/hooks.wip/useMemoryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryManager.js","sourceRoot":"","sources":["../../src/hooks.wip/useMemoryManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAKpE;;GAEG;AACH,SAAS,SAAS,CAAC,GAAW,EAAE,QAAiB;IAC/C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,0CAA0C;IAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE;QAClC,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAC3E,MAAM,gBAAgB,GAAG,MAAM,EAAE,gBAAgB,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACjG,MAAM,gBAAgB,GAAG,MAAM,EAAE,gBAAgB,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAChG,MAAM,YAAY,GAAG,MAAM,EAAE,YAAY,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QAErF,2BAA2B;QAC3B,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,IAAI,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,SAAS;YACT,gBAAgB;YAChB,gBAAgB;YAChB,YAAY;YACZ,mBAAmB,EAAE,MAAM,EAAE,mBAAmB;YAChD,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,SAAS;YACjD,UAAU,EAAE,MAAM,EAAE,UAAU;SAC/B,CAAC;IACJ,CAAC,EAAE;QACD,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QAEjC,IAAI,CAAC;YACH,OAAO,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/hooks.wip/useMemorySearch.d.ts

@@ -0,0 +1,100 @@
+/**
+ * useMemorySearch - Hook for searching memories with vector similarity
+ *
+ * Provides high-level interface for semantic memory search combining:
+ * - Vector similarity (HNSW)
+ * - Knowledge graph expansion
+ * - Metadata filtering
+ * - Relevance scoring
+ */
+import { type MemoryServicesConfig } from './useMemoryServices';
+import type { HNSWSearchResult } from '../embedding/types';
+export interface SearchOptions {
+    /** Number of results to return */
+    k?: number;
+    /** Similarity threshold (0-1) */
+    threshold?: number;
+    /** Search mode */
+    mode?: 'semantic' | 'hybrid' | 'exact';
+    /** Filter by categories */
+    categories?: string[];
+    /** Date range filter */
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    /** Importance range filter */
+    importanceRange?: {
+        min?: number;
+        max?: number;
+    };
+    /** Include knowledge graph expansion */
+    includeGraph?: boolean;
+    /** Boost recent memories */
+    boostRecent?: boolean;
+    /** Result diversity factor (0-1) */
+    diversityFactor?: number;
+}
+export interface SearchResult {
+    /** Vector search results */
+    vectorResults: {
+        ids: number[];
+        distances: number[];
+        similarities: number[];
+    };
+    /** Graph search results (if enabled) */
+    graphResults?: {
+        entities: any[];
+        relationships: any[];
+        relatedMemories: string[];
+    };
+    /** Search metadata */
+    metadata: {
+        queryTime: number;
+        totalResults: number;
+        mode: string;
+    };
+}
+/**
+ * Search memories using semantic vector similarity
+ *
+ * @param userAddress - User's blockchain address
+ * @param config - Optional services configuration
+ * @returns Search function and state
+ *
+ * @example
+ * ```tsx
+ * function SearchComponent() {
+ *   const account = useCurrentAccount();
+ *   const { search, results, isSearching, error } = useMemorySearch(account?.address);
+ *
+ *   const handleSearch = async () => {
+ *     const results = await search('memories about Paris', {
+ *       k: 10,
+ *       categories: ['travel'],
+ *       includeGraph: true
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleSearch} disabled={isSearching}>
+ *         Search
+ *       </button>
+ *       {results && <ResultsList results={results} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMemorySearch(userAddress?: string, config?: MemoryServicesConfig): {
+    search: (query: string, options?: SearchOptions) => Promise<SearchResult>;
+    searchByVector: (vector: number[], options?: Omit<SearchOptions, "includeGraph">) => Promise<HNSWSearchResult>;
+    results: SearchResult | null;
+    isSearching: boolean;
+    isReady: boolean;
+    error: Error | null;
+    lastQuery: string;
+    clearResults: () => void;
+};
+//# sourceMappingURL=useMemorySearch.d.ts.map

package/dist/hooks.wip/useMemorySearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemorySearch.d.ts","sourceRoot":"","sources":["../../src/hooks.wip/useMemorySearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wBAAwB;IACxB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,IAAI,CAAC;QACb,GAAG,CAAC,EAAE,IAAI,CAAC;KACZ,CAAC;IACF,8BAA8B;IAC9B,eAAe,CAAC,EAAE;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,aAAa,EAAE;QACb,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,wCAAwC;IACxC,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,aAAa,EAAE,GAAG,EAAE,CAAC;QACrB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,sBAAsB;IACtB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAC7B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,oBAAoB;oBAcpB,MAAM,YACJ,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC;6BAwJd,MAAM,EAAE,YACP,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,KAC3C,OAAO,CAAC,gBAAgB,CAAC;;;;;;;EAoD7B"}

package/dist/hooks.wip/useMemorySearch.js

@@ -0,0 +1,278 @@
+/**
+ * useMemorySearch - Hook for searching memories with vector similarity
+ *
+ * Provides high-level interface for semantic memory search combining:
+ * - Vector similarity (HNSW)
+ * - Knowledge graph expansion
+ * - Metadata filtering
+ * - Relevance scoring
+ */
+import { useState, useCallback } from 'react';
+import { useMemoryServices } from './useMemoryServices.js';
+/**
+ * Search memories using semantic vector similarity
+ *
+ * @param userAddress - User's blockchain address
+ * @param config - Optional services configuration
+ * @returns Search function and state
+ *
+ * @example
+ * ```tsx
+ * function SearchComponent() {
+ *   const account = useCurrentAccount();
+ *   const { search, results, isSearching, error } = useMemorySearch(account?.address);
+ *
+ *   const handleSearch = async () => {
+ *     const results = await search('memories about Paris', {
+ *       k: 10,
+ *       categories: ['travel'],
+ *       includeGraph: true
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleSearch} disabled={isSearching}>
+ *         Search
+ *       </button>
+ *       {results && <ResultsList results={results} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useMemorySearch(userAddress, config) {
+    const { embeddingService, hnswService, graphManager, isReady, error: servicesError } = useMemoryServices(userAddress, config);
+    const [results, setResults] = useState(null);
+    const [isSearching, setIsSearching] = useState(false);
+    const [error, setError] = useState(null);
+    const [lastQuery, setLastQuery] = useState('');
+    /**
+     * Search memories by text query
+     */
+    const search = useCallback(async (query, options = {}) => {
+        console.log('🔍 [useMemorySearch] search() called', {
+            query,
+            hasEmbeddingService: !!embeddingService,
+            hasHnswService: !!hnswService,
+            userAddress,
+            options
+        });
+        if (!embeddingService || !hnswService || !userAddress) {
+            const error = new Error('Services not initialized');
+            console.error('❌ [useMemorySearch] Services not initialized', {
+                embeddingService: !!embeddingService,
+                hnswService: !!hnswService,
+                userAddress
+            });
+            throw error;
+        }
+        try {
+            setIsSearching(true);
+            setError(null);
+            setLastQuery(query);
+            const startTime = performance.now();
+            console.log('⏱️ [useMemorySearch] Starting search at', new Date().toISOString());
+            // 1. Generate query embedding
+            const embeddingResult = await embeddingService.embedText({
+                text: query,
+                type: 'query'
+            });
+            // 2. Determine search parameters based on mode
+            const k = options.k || 10;
+            const efSearch = options.mode === 'exact' ? k * 4 :
+                options.mode === 'hybrid' ? k * 2 : k;
+            // 3. Create metadata filter
+            const filter = createMetadataFilter(options);
+            // 4. Search HNSW index
+            let vectorResults;
+            try {
+                vectorResults = await hnswService.searchVectors(userAddress, embeddingResult.vector, {
+                    k: Math.min(k * 2, 100), // Get more candidates for filtering
+                    efSearch,
+                    filter
+                });
+            }
+            catch (searchError) {
+                // Handle "No index found" gracefully - return empty results
+                if (searchError.message?.includes('No index found')) {
+                    console.info(`No memories indexed yet for user ${userAddress}`);
+                    const searchResult = {
+                        vectorResults: {
+                            ids: [],
+                            distances: [],
+                            similarities: []
+                        },
+                        metadata: {
+                            queryTime: performance.now() - startTime,
+                            totalResults: 0,
+                            mode: options.mode || 'semantic'
+                        }
+                    };
+                    setResults(searchResult);
+                    return searchResult;
+                }
+                // Re-throw other errors
+                throw searchError;
+            }
+            // 5. Apply threshold filtering
+            let filteredIds = vectorResults.ids;
+            let filteredDistances = vectorResults.distances;
+            // Compute similarities if not provided
+            let filteredSimilarities = vectorResults.similarities ||
+                vectorResults.distances.map(d => 1 / (1 + d));
+            if (options.threshold) {
+                const filtered = applyThreshold(vectorResults.ids, vectorResults.distances, filteredSimilarities, options.threshold);
+                filteredIds = filtered.ids;
+                filteredDistances = filtered.distances;
+                filteredSimilarities = filtered.similarities;
+            }
+            // Limit to requested k
+            filteredIds = filteredIds.slice(0, k);
+            filteredDistances = filteredDistances.slice(0, k);
+            filteredSimilarities = filteredSimilarities.slice(0, k);
+            // 6. Optional: Expand with knowledge graph
+            let graphResults;
+            if (options.includeGraph && graphManager) {
+                try {
+                    const graphSearchResult = await graphManager.searchGraph(userAddress, {
+                        keywords: query.split(' ').filter(w => w.length > 2),
+                        maxResults: k
+                    });
+                    graphResults = {
+                        entities: graphSearchResult.entities,
+                        relationships: graphSearchResult.relationships,
+                        relatedMemories: graphSearchResult.relatedMemories
+                    };
+                }
+                catch (graphError) {
+                    console.warn('Graph search failed:', graphError);
+                    // Continue without graph results
+                }
+            }
+            const queryTime = performance.now() - startTime;
+            const searchResult = {
+                vectorResults: {
+                    ids: filteredIds,
+                    distances: filteredDistances,
+                    similarities: filteredSimilarities
+                },
+                graphResults,
+                metadata: {
+                    queryTime,
+                    totalResults: filteredIds.length + (graphResults?.entities.length || 0),
+                    mode: options.mode || 'semantic'
+                }
+            };
+            setResults(searchResult);
+            return searchResult;
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsSearching(false);
+        }
+    }, [userAddress, embeddingService, hnswService, graphManager]);
+    /**
+     * Search by pre-computed embedding vector
+     */
+    const searchByVector = useCallback(async (vector, options = {}) => {
+        if (!hnswService || !userAddress) {
+            throw new Error('Services not initialized');
+        }
+        try {
+            setIsSearching(true);
+            setError(null);
+            const k = options.k || 10;
+            const filter = createMetadataFilter(options);
+            const vectorResults = await hnswService.searchVectors(userAddress, vector, {
+                k,
+                efSearch: 50,
+                filter
+            });
+            return vectorResults;
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsSearching(false);
+        }
+    }, [userAddress, hnswService]);
+    /**
+     * Clear current search results
+     */
+    const clearResults = useCallback(() => {
+        setResults(null);
+        setError(null);
+        setLastQuery('');
+    }, []);
+    return {
+        search,
+        searchByVector,
+        results,
+        isSearching,
+        isReady,
+        error: error || servicesError,
+        lastQuery,
+        clearResults
+    };
+}
+// ==================== HELPER FUNCTIONS ====================
+function createMetadataFilter(options) {
+    if (!options.categories && !options.dateRange && !options.importanceRange) {
+        return undefined;
+    }
+    return (metadata) => {
+        // Category filter
+        if (options.categories && options.categories.length > 0) {
+            if (!options.categories.includes(metadata.category)) {
+                return false;
+            }
+        }
+        // Date range filter
+        if (options.dateRange) {
+            const created = new Date(metadata.createdTimestamp || 0);
+            if (options.dateRange.start && created < options.dateRange.start) {
+                return false;
+            }
+            if (options.dateRange.end && created > options.dateRange.end) {
+                return false;
+            }
+        }
+        // Importance range filter
+        if (options.importanceRange) {
+            const importance = metadata.importance || 5;
+            if (options.importanceRange.min && importance < options.importanceRange.min) {
+                return false;
+            }
+            if (options.importanceRange.max && importance > options.importanceRange.max) {
+                return false;
+            }
+        }
+        return true;
+    };
+}
+function applyThreshold(ids, distances, similarities, threshold) {
+    const filteredIds = [];
+    const filteredDistances = [];
+    const filteredSimilarities = [];
+    for (let i = 0; i < ids.length; i++) {
+        if (similarities[i] >= threshold) {
+            filteredIds.push(ids[i]);
+            filteredDistances.push(distances[i]);
+            filteredSimilarities.push(similarities[i]);
+        }
+    }
+    return {
+        ids: filteredIds,
+        distances: filteredDistances,
+        similarities: filteredSimilarities
+    };
+}
+//# sourceMappingURL=useMemorySearch.js.map

package/dist/hooks.wip/useMemorySearch.js.map

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

package/dist/hooks.wip/useMemoryServices.d.ts

@@ -0,0 +1,80 @@
+/**
+ * useMemoryServices - Core hook for client-side memory services
+ *
+ * Manages lifecycle of browser-compatible services:
+ * - EmbeddingService (Gemini API)
+ * - BrowserHnswIndexService (hnswlib-wasm + IndexedDB)
+ * - BrowserKnowledgeGraphManager (IndexedDB)
+ *
+ * Services are singletons per user address, shared across components.
+ */
+import { EmbeddingService } from '../services/EmbeddingService';
+import { GeminiAIService } from '../services/GeminiAIService';
+import { BrowserHnswIndexService } from '../vector/BrowserHnswIndexService';
+import { BrowserKnowledgeGraphManager } from '../graph/BrowserKnowledgeGraphManager';
+import { StorageService } from '../services/StorageService';
+import { EncryptionService } from '../services/EncryptionService';
+export interface MemoryServicesConfig {
+    geminiApiKey?: string;
+    embeddingModel?: string;
+    embeddingDimension?: number;
+    hnswMaxElements?: number;
+    hnswM?: number;
+    hnswEfConstruction?: number;
+    batchSize?: number;
+    batchDelayMs?: number;
+    packageId?: string;
+    walrusAggregator?: string;
+    walrusPublisher?: string;
+    sealServerObjectIds?: string[];
+    suiClient?: any;
+}
+export interface MemoryServices {
+    embeddingService: EmbeddingService | null;
+    geminiAIService: GeminiAIService | null;
+    hnswService: BrowserHnswIndexService | null;
+    graphManager: BrowserKnowledgeGraphManager | null;
+    storageService: StorageService | null;
+    encryptionService: EncryptionService | null;
+    isReady: boolean;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * Initialize and manage memory services for client-side operations
+ *
+ * @param userAddress - User's blockchain address (used as unique identifier)
+ * @param config - Optional configuration for services
+ * @returns Memory services and loading state
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const account = useCurrentAccount();
+ *   const { embeddingService, hnswService, isReady } = useMemoryServices(
+ *     account?.address,
+ *     { geminiApiKey: process.env.NEXT_PUBLIC_GEMINI_API_KEY }
+ *   );
+ *
+ *   if (!isReady) return <Loading />;
+ *   // Use services...
+ * }
+ * ```
+ */
+export declare function useMemoryServices(userAddress?: string, config?: MemoryServicesConfig): MemoryServices;
+/**
+ * Clear all services for a specific user (useful for logout)
+ */
+export declare function clearMemoryServices(userAddress: string): void;
+/**
+ * Get current service statistics
+ */
+export declare function getMemoryServicesStats(): {
+    activeUsers: number;
+    services: {
+        userAddress: string;
+        refCount: number;
+        hnswStats: import("../vector").BatchStats;
+    }[];
+};
+//# sourceMappingURL=useMemoryServices.d.ts.map

package/dist/hooks.wip/useMemoryServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryServices.d.ts","sourceRoot":"","sources":["../../src/hooks.wip/useMemoryServices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,YAAY,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAClD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAaD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,GAAE,oBAAyB,GAChC,cAAc,CAiOhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB;;;;;;;EASrC"}