@cmdoss/memwal-sdk 0.6.0

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * useKnowledgeGraph - Hook for knowledge graph operations
+ *
+ * Provides interface for querying and traversing the knowledge graph.
+ * Knowledge graphs store entities and relationships extracted from memories.
+ */
+import { type MemoryServicesConfig } from './useMemoryServices';
+import type { GraphSearchQuery, GraphSearchResult } from '../graph/BrowserKnowledgeGraphManager';
+import type { Entity, KnowledgeGraph } from '../graph/GraphService';
+/**
+ * Query and traverse the knowledge graph
+ *
+ * @param userId - User's unique identifier
+ * @param config - Optional services configuration
+ * @returns Graph operations and state
+ *
+ * @example
+ * ```tsx
+ * function GraphExplorer() {
+ *   const account = useCurrentAccount();
+ *   const { searchGraph, findRelated, graph, isLoading } = useKnowledgeGraph(
+ *     account?.address
+ *   );
+ *
+ *   const handleSearch = async () => {
+ *     const results = await searchGraph({
+ *       keywords: ['paris', 'vacation'],
+ *       entityTypes: ['location', 'event']
+ *     });
+ *     console.log('Found:', results);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleSearch}>Search Graph</button>
+ *       <p>Entities: {graph?.entities.length || 0}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useKnowledgeGraph(userId?: string, config?: MemoryServicesConfig): {
+    searchGraph: (query: GraphSearchQuery) => Promise<GraphSearchResult>;
+    findRelated: (entityId: string, maxHops?: number) => Promise<Entity[]>;
+    addToGraph: (entities: Entity[], relationships: Array<{
+        source: string;
+        target: string;
+        label: string;
+        confidence?: number;
+    }>, memoryId: string) => Promise<void>;
+    clearGraph: () => Promise<void>;
+    reloadGraph: () => Promise<void>;
+    graph: KnowledgeGraph | null;
+    lastSearchResults: GraphSearchResult | null;
+    isLoading: boolean;
+    isReady: boolean;
+    error: Error | null;
+    stats: {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: Record<string, number>;
+        relationshipTypes: Record<string, number>;
+        sourceMemories: number;
+    };
+};
+//# sourceMappingURL=useKnowledgeGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKnowledgeGraph.d.ts","sourceRoot":"","sources":["../../src/hooks.wip/useKnowledgeGraph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AACjG,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,oBAAoB;yBA4CpB,gBAAgB,KACtB,OAAO,CAAC,iBAAiB,CAAC;4BA2BjB,MAAM,YACP,MAAM,KACd,OAAO,CAAC,MAAM,EAAE,CAAC;2BA8BR,MAAM,EAAE,iBACH,KAAK,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,YACQ,MAAM,KACf,OAAO,CAAC,IAAI,CAAC;sBA2ByB,OAAO,CAAC,IAAI,CAAC;uBA2BZ,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;EA6DxD"}

package/dist/hooks.wip/useKnowledgeGraph.js

@@ -0,0 +1,229 @@
+/**
+ * useKnowledgeGraph - Hook for knowledge graph operations
+ *
+ * Provides interface for querying and traversing the knowledge graph.
+ * Knowledge graphs store entities and relationships extracted from memories.
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { useMemoryServices } from './useMemoryServices.js';
+/**
+ * Query and traverse the knowledge graph
+ *
+ * @param userId - User's unique identifier
+ * @param config - Optional services configuration
+ * @returns Graph operations and state
+ *
+ * @example
+ * ```tsx
+ * function GraphExplorer() {
+ *   const account = useCurrentAccount();
+ *   const { searchGraph, findRelated, graph, isLoading } = useKnowledgeGraph(
+ *     account?.address
+ *   );
+ *
+ *   const handleSearch = async () => {
+ *     const results = await searchGraph({
+ *       keywords: ['paris', 'vacation'],
+ *       entityTypes: ['location', 'event']
+ *     });
+ *     console.log('Found:', results);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleSearch}>Search Graph</button>
+ *       <p>Entities: {graph?.entities.length || 0}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useKnowledgeGraph(userId, config) {
+    const { graphManager, isReady, error: servicesError } = useMemoryServices(userId, config);
+    const [graph, setGraph] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [lastSearchResults, setLastSearchResults] = useState(null);
+    // Load graph on mount
+    useEffect(() => {
+        if (!userId || !graphManager || !isReady)
+            return;
+        let mounted = true;
+        const loadGraph = async () => {
+            try {
+                setIsLoading(true);
+                const userGraph = await graphManager.getUserGraph(userId);
+                if (mounted) {
+                    setGraph(userGraph);
+                    setIsLoading(false);
+                }
+            }
+            catch (err) {
+                console.error('Failed to load graph:', err);
+                if (mounted) {
+                    setError(err);
+                    setIsLoading(false);
+                }
+            }
+        };
+        loadGraph();
+        return () => {
+            mounted = false;
+        };
+    }, [userId, graphManager, isReady]);
+    /**
+     * Search the knowledge graph
+     */
+    const searchGraph = useCallback(async (query) => {
+        if (!graphManager || !userId) {
+            throw new Error('Graph manager not initialized');
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            const results = await graphManager.searchGraph(userId, query);
+            setLastSearchResults(results);
+            return results;
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userId, graphManager]);
+    /**
+     * Find entities related to a specific entity
+     */
+    const findRelated = useCallback(async (entityId, maxHops = 2) => {
+        if (!graphManager || !userId) {
+            throw new Error('Graph manager not initialized');
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            const relatedEntities = await graphManager.findRelatedEntities(userId, entityId, maxHops);
+            return relatedEntities;
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userId, graphManager]);
+    /**
+     * Add entities and relationships to the graph
+     */
+    const addToGraph = useCallback(async (entities, relationships, memoryId) => {
+        if (!graphManager || !userId) {
+            throw new Error('Graph manager not initialized');
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            await graphManager.addToGraph(userId, entities, relationships, memoryId);
+            // Reload graph
+            const updatedGraph = await graphManager.getUserGraph(userId);
+            setGraph(updatedGraph);
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userId, graphManager]);
+    /**
+     * Clear the entire knowledge graph for the user
+     */
+    const clearGraph = useCallback(async () => {
+        if (!graphManager || !userId) {
+            throw new Error('Graph manager not initialized');
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            await graphManager.clearUserGraph(userId);
+            setGraph(null);
+            setLastSearchResults(null);
+            console.log('✅ Knowledge graph cleared');
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userId, graphManager]);
+    /**
+     * Reload graph from IndexedDB
+     */
+    const reloadGraph = useCallback(async () => {
+        if (!graphManager || !userId)
+            return;
+        try {
+            setIsLoading(true);
+            const userGraph = await graphManager.getUserGraph(userId);
+            setGraph(userGraph);
+        }
+        catch (err) {
+            setError(err);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userId, graphManager]);
+    /**
+     * Get graph statistics
+     */
+    const getStats = useCallback(() => {
+        if (!graph) {
+            return {
+                totalEntities: 0,
+                totalRelationships: 0,
+                entityTypes: {},
+                relationshipTypes: {},
+                sourceMemories: 0
+            };
+        }
+        const entityTypes = {};
+        graph.entities.forEach(entity => {
+            entityTypes[entity.type] = (entityTypes[entity.type] || 0) + 1;
+        });
+        const relationshipTypes = {};
+        graph.relationships.forEach(rel => {
+            const type = rel.type || rel.label;
+            relationshipTypes[type] = (relationshipTypes[type] || 0) + 1;
+        });
+        return {
+            totalEntities: graph.entities.length,
+            totalRelationships: graph.relationships.length,
+            entityTypes,
+            relationshipTypes,
+            sourceMemories: graph.metadata.sourceMemories?.length || 0
+        };
+    }, [graph]);
+    return {
+        searchGraph,
+        findRelated,
+        addToGraph,
+        clearGraph,
+        reloadGraph,
+        graph,
+        lastSearchResults,
+        isLoading,
+        isReady,
+        error: error || servicesError,
+        stats: getStats()
+    };
+}
+//# sourceMappingURL=useKnowledgeGraph.js.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * useMemoryChat - Complete memory-aware chat hook with context retrieval
+ *
+ * Drop-in solution for building memory-aware chatbots with AI integration.
+ *
+ * @example
+ * ```tsx
+ * import { useMemoryChat } from 'personal-data-wallet-sdk/hooks';
+ * import { useCurrentAccount } from '@mysten/dapp-kit';
+ *
+ * function ChatInterface() {
+ *   const account = useCurrentAccount();
+ *
+ *   const {
+ *     messages,
+ *     sendMessage,
+ *     createMemoryFromMessage,
+ *     isProcessing,
+ *     retrievedMemories
+ *   } = useMemoryChat(account?.address, {
+ *     systemPrompt: 'You are a helpful assistant with access to user memories.',
+ *     maxContextMemories: 5,
+ *     aiProvider: 'gemini'
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map((msg, i) => (
+ *         <div key={i} className={msg.role}>
+ *           {msg.content}
+ *           {msg.memories && (
+ *             <div className="context">
+ *               Used {msg.memories.length} memories
+ *             </div>
+ *           )}
+ *         </div>
+ *       ))}
+ *
+ *       <button onClick={() => sendMessage('Hello!')}>
+ *         Send Message
+ *       </button>
+ *
+ *       <button onClick={() => createMemoryFromMessage('Save this')}>
+ *         💾 Remember this
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import type { ChatMessage, MemoryChatConfig, SearchMemoryResult, MemoryManagerConfig } from './utils/types';
+export interface UseMemoryChatOptions extends MemoryChatConfig {
+    /**
+     * Optional memory manager config
+     */
+    config?: MemoryManagerConfig;
+    /**
+     * Session ID for chat history persistence
+     */
+    sessionId?: string;
+    /**
+     * Auto-save messages as memories
+     * @default false
+     */
+    autoSaveMessages?: boolean;
+    /**
+     * Gemini API key for embeddings
+     */
+    geminiApiKey?: string;
+}
+export interface UseMemoryChatReturn {
+    /**
+     * All chat messages
+     */
+    messages: ChatMessage[];
+    /**
+     * Send a message and get AI response
+     */
+    sendMessage: (content: string) => Promise<void>;
+    /**
+     * Create a memory from message content
+     */
+    createMemoryFromMessage: (content: string) => Promise<void>;
+    /**
+     * Whether the chat is processing (searching/generating response)
+     */
+    isProcessing: boolean;
+    /**
+     * Currently retrieved memories for context
+     */
+    retrievedMemories: SearchMemoryResult[];
+    /**
+     * Clear chat history
+     */
+    clearHistory: () => void;
+    /**
+     * Error if any
+     */
+    error: Error | null;
+}
+/**
+ * Hook for memory-aware chat with AI integration
+ */
+export declare function useMemoryChat(userAddress: string | undefined, options?: UseMemoryChatOptions): UseMemoryChatReturn;
+export default useMemoryChat;
+//# sourceMappingURL=useMemoryChat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryChat.d.ts","sourceRoot":"","sources":["../../src/hooks.wip/useMemoryChat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAOH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IAExC;;OAEG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CA6QrB;AAED,eAAe,aAAa,CAAC"}