@cmdoss/memwal-sdk 0.6.0

package/dist/services/storage/BlobAttributesManager.js

@@ -0,0 +1,265 @@
+/**
+ * BlobAttributesManager - Sui Dynamic Field Operations for Blob Objects
+ *
+ * Handles mutable on-chain metadata via Sui dynamic fields.
+ * Extracted from StorageService for better separation of concerns.
+ *
+ * Features:
+ * - Set/get/update/remove dynamic fields
+ * - On-chain indexing and querying
+ * - Mutable metadata (unlike Walrus blob content)
+ * - Query by attribute filters
+ */
+import { Transaction } from '@mysten/sui/transactions';
+/**
+ * BlobAttributesManager - Manages Sui dynamic fields on Blob objects
+ *
+ * Dynamic fields enable:
+ * - Mutable on-chain metadata
+ * - Query/filter by attributes
+ * - Indexed searchability
+ * - No re-upload needed for metadata changes
+ */
+export class BlobAttributesManager {
+    constructor(suiClient) {
+        this.suiClient = suiClient;
+    }
+    /**
+     * Set attributes on a Walrus Blob object
+     *
+     * Adds dynamic fields to the Sui Blob object for:
+     * - On-chain metadata indexing
+     * - Queryable attributes
+     * - Mutable metadata
+     */
+    async setBlobAttributes(blobObjectId, attributes, signer) {
+        try {
+            console.log(`🏷️  Setting ${Object.keys(attributes).length} attributes on blob ${blobObjectId.slice(0, 10)}...`);
+            const tx = new Transaction();
+            // Add each attribute as a dynamic field
+            for (const [key, value] of Object.entries(attributes)) {
+                tx.moveCall({
+                    target: '0x2::dynamic_field::add',
+                    arguments: [
+                        tx.object(blobObjectId),
+                        tx.pure.string(key),
+                        tx.pure.string(value),
+                    ],
+                    typeArguments: [
+                        '0x1::string::String',
+                        '0x1::string::String',
+                    ],
+                });
+                console.log(`   ✓ ${key}: ${value.slice(0, 50)}${value.length > 50 ? '...' : ''}`);
+            }
+            tx.setSender(signer.toSuiAddress());
+            const result = await signer.signAndExecuteTransaction({
+                transaction: tx,
+                client: this.suiClient,
+            });
+            console.log(`✅ Attributes set successfully!`);
+            console.log(`   Transaction: ${result.digest}`);
+            return result.digest;
+        }
+        catch (error) {
+            console.error(`❌ Failed to set blob attributes:`, error);
+            throw new Error(`Failed to set blob attributes: ${error}`);
+        }
+    }
+    /**
+     * Get attributes from a Walrus Blob object
+     */
+    async getBlobAttributes(blobObjectId, attributeKeys) {
+        try {
+            console.log(`🔍 Fetching attributes from blob ${blobObjectId.slice(0, 10)}...`);
+            const attributes = {};
+            // Get the object
+            const object = await this.suiClient.getObject({
+                id: blobObjectId,
+                options: {
+                    showContent: true,
+                    showOwner: true,
+                },
+            });
+            if (!object.data) {
+                throw new Error(`Blob object not found: ${blobObjectId}`);
+            }
+            // Get dynamic fields
+            const dynamicFields = await this.suiClient.getDynamicFields({
+                parentId: blobObjectId,
+            });
+            console.log(`   Found ${dynamicFields.data.length} dynamic fields`);
+            // Fetch each dynamic field value
+            for (const field of dynamicFields.data) {
+                const fieldName = field.name.value;
+                // Skip if filtering and this field isn't in the list
+                if (attributeKeys && !attributeKeys.includes(fieldName)) {
+                    continue;
+                }
+                try {
+                    const fieldData = await this.suiClient.getDynamicFieldObject({
+                        parentId: blobObjectId,
+                        name: {
+                            type: '0x1::string::String',
+                            value: fieldName,
+                        },
+                    });
+                    if (fieldData.data?.content?.dataType === 'moveObject') {
+                        const value = fieldData.data.content.fields.value;
+                        attributes[fieldName] = value;
+                        console.log(`   ✓ ${fieldName}: ${value.slice(0, 50)}${value.length > 50 ? '...' : ''}`);
+                    }
+                }
+                catch (err) {
+                    console.warn(`   ⚠️  Could not fetch field ${fieldName}:`, err);
+                }
+            }
+            console.log(`✅ Retrieved ${Object.keys(attributes).length} attributes`);
+            return attributes;
+        }
+        catch (error) {
+            console.error(`❌ Failed to get blob attributes:`, error);
+            throw new Error(`Failed to get blob attributes: ${error}`);
+        }
+    }
+    /**
+     * Update blob attributes (replaces existing values)
+     */
+    async updateBlobAttributes(blobObjectId, attributes, signer) {
+        try {
+            console.log(`📝 Updating ${Object.keys(attributes).length} attributes on blob ${blobObjectId.slice(0, 10)}...`);
+            const tx = new Transaction();
+            // For each attribute, remove old value and add new value
+            for (const [key, value] of Object.entries(attributes)) {
+                // Remove existing field (if it exists)
+                tx.moveCall({
+                    target: '0x2::dynamic_field::remove_if_exists',
+                    arguments: [
+                        tx.object(blobObjectId),
+                        tx.pure.string(key),
+                    ],
+                    typeArguments: [
+                        '0x1::string::String',
+                        '0x1::string::String',
+                    ],
+                });
+                // Add new field
+                tx.moveCall({
+                    target: '0x2::dynamic_field::add',
+                    arguments: [
+                        tx.object(blobObjectId),
+                        tx.pure.string(key),
+                        tx.pure.string(value),
+                    ],
+                    typeArguments: [
+                        '0x1::string::String',
+                        '0x1::string::String',
+                    ],
+                });
+                console.log(`   ✓ Updated ${key}: ${value.slice(0, 50)}${value.length > 50 ? '...' : ''}`);
+            }
+            tx.setSender(signer.toSuiAddress());
+            const result = await signer.signAndExecuteTransaction({
+                transaction: tx,
+                client: this.suiClient,
+            });
+            console.log(`✅ Attributes updated successfully!`);
+            console.log(`   Transaction: ${result.digest}`);
+            return result.digest;
+        }
+        catch (error) {
+            console.error(`❌ Failed to update blob attributes:`, error);
+            throw new Error(`Failed to update blob attributes: ${error}`);
+        }
+    }
+    /**
+     * Remove specific attributes from a blob
+     */
+    async removeBlobAttributes(blobObjectId, attributeKeys, signer) {
+        try {
+            console.log(`🗑️  Removing ${attributeKeys.length} attributes from blob ${blobObjectId.slice(0, 10)}...`);
+            const tx = new Transaction();
+            for (const key of attributeKeys) {
+                tx.moveCall({
+                    target: '0x2::dynamic_field::remove_if_exists',
+                    arguments: [
+                        tx.object(blobObjectId),
+                        tx.pure.string(key),
+                    ],
+                    typeArguments: [
+                        '0x1::string::String',
+                        '0x1::string::String',
+                    ],
+                });
+                console.log(`   ✓ Removed ${key}`);
+            }
+            tx.setSender(signer.toSuiAddress());
+            const result = await signer.signAndExecuteTransaction({
+                transaction: tx,
+                client: this.suiClient,
+            });
+            console.log(`✅ Attributes removed successfully!`);
+            console.log(`   Transaction: ${result.digest}`);
+            return result.digest;
+        }
+        catch (error) {
+            console.error(`❌ Failed to remove blob attributes:`, error);
+            throw new Error(`Failed to remove blob attributes: ${error}`);
+        }
+    }
+    /**
+     * Query memories by attributes
+     *
+     * Finds all Blob objects with specific attribute values
+     */
+    async queryMemoriesByAttributes(filters, owner, walrusPackageId) {
+        try {
+            console.log(`🔍 Querying memories with filters:`, filters);
+            const results = [];
+            // Get all Blob objects owned by user
+            const ownedObjects = await this.suiClient.getOwnedObjects({
+                owner,
+                filter: {
+                    StructType: `${walrusPackageId}::blob::Blob`,
+                },
+                options: {
+                    showContent: true,
+                    showType: true,
+                },
+            });
+            console.log(`   Found ${ownedObjects.data.length} blob objects`);
+            // Filter by attributes
+            for (const obj of ownedObjects.data) {
+                if (!obj.data?.objectId)
+                    continue;
+                try {
+                    // Get attributes for this blob
+                    const attributes = await this.getBlobAttributes(obj.data.objectId, Object.keys(filters));
+                    // Check if all filters match
+                    const matches = Object.entries(filters).every(([key, value]) => attributes[key] === value);
+                    if (matches) {
+                        // Extract blob ID from content
+                        const content = obj.data.content;
+                        const blobId = content?.fields?.blob_id;
+                        results.push({
+                            blobObjectId: obj.data.objectId,
+                            blobId,
+                            attributes,
+                        });
+                        console.log(`   ✓ Match: ${obj.data.objectId.slice(0, 10)}...`);
+                    }
+                }
+                catch (err) {
+                    console.warn(`   ⚠️  Error checking ${obj.data.objectId}:`, err);
+                }
+            }
+            console.log(`✅ Found ${results.length} matching memories`);
+            return results;
+        }
+        catch (error) {
+            console.error(`❌ Failed to query memories:`, error);
+            throw new Error(`Failed to query memories: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=BlobAttributesManager.js.map

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

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

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

@@ -0,0 +1,162 @@
+/**
+ * KnowledgeGraphManager - Knowledge Graph Operations
+ *
+ * Handles entity extraction, relationship mapping, and graph querying.
+ * Extracted from StorageService for better separation of concerns.
+ *
+ * Features:
+ * - AI-powered entity/relationship extraction
+ * - In-memory graph storage with Walrus persistence
+ * - Graph traversal and querying
+ * - Batch extraction from multiple memories
+ */
+import type { GraphService, KnowledgeGraph, Entity, Relationship, GraphExtractionResult } from '../../graph/GraphService';
+import type { EmbeddingService } from '../EmbeddingService';
+export interface GraphCache {
+    graph: KnowledgeGraph;
+    lastSaved: Date;
+    isDirty: boolean;
+}
+export interface GraphQueryOptions {
+    keywords?: string[];
+    entityTypes?: string[];
+    relationshipTypes?: string[];
+    searchText?: string;
+    maxHops?: number;
+    limit?: number;
+}
+export interface GraphInitConfig {
+    confidenceThreshold?: number;
+    maxHops?: number;
+    deduplicationThreshold?: number;
+    geminiApiKey?: string;
+}
+/**
+ * KnowledgeGraphManager - Manages knowledge graph operations
+ *
+ * Coordinates:
+ * - GraphService for entity/relationship extraction
+ * - In-memory graph storage and caching
+ * - Walrus persistence for cross-device sync
+ */
+export declare class KnowledgeGraphManager {
+    private graphService?;
+    private knowledgeGraphs;
+    private graphCache;
+    constructor();
+    /**
+     * Initialize knowledge graph capabilities
+     */
+    initializeKnowledgeGraph(embeddingService?: EmbeddingService, graphConfig?: GraphInitConfig): Promise<GraphService>;
+    /**
+     * Extract entities and relationships from text content
+     */
+    extractKnowledgeGraph(content: string, memoryId: string, options?: {
+        confidenceThreshold?: number;
+        includeEmbeddings?: boolean;
+    }): Promise<GraphExtractionResult>;
+    /**
+     * Get or load user's knowledge graph
+     */
+    getUserKnowledgeGraph(userAddress: string): Promise<KnowledgeGraph>;
+    /**
+     * Add extraction results to user's knowledge graph
+     */
+    addToUserGraph(userAddress: string, entities: Entity[], relationships: Relationship[], sourceMemoryId: string): KnowledgeGraph;
+    /**
+     * Search knowledge graph with semantic queries
+     */
+    searchKnowledgeGraph(userAddress: string, query: GraphQueryOptions): Promise<import("../../graph").GraphQueryResult>;
+    /**
+     * Find related entities using graph traversal
+     */
+    findRelatedEntities(userAddress: string, seedEntityIds: string[], options?: {
+        maxHops?: number;
+        relationshipTypes?: string[];
+        includeWeights?: boolean;
+    }): Promise<import("../../graph").GraphQueryResult>;
+    /**
+     * Batch extract knowledge graphs from multiple memories
+     */
+    extractKnowledgeGraphBatch(memories: Array<{
+        id: string;
+        content: string;
+    }>, userAddress: string, options?: {
+        batchSize?: number;
+        delayMs?: number;
+        confidenceThreshold?: number;
+    }): Promise<GraphExtractionResult[]>;
+    /**
+     * Get graph statistics
+     */
+    getGraphStatistics(userAddress: string): {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: {
+            [k: string]: number;
+        };
+        relationshipTypes: {
+            [k: string]: number;
+        };
+        averageConnections: number;
+        graphDensity: number;
+        extractionStats: {
+            totalExtractions: number;
+            averageEntities: number;
+            averageRelationships: number;
+            averageConfidence: number;
+            processingTime: number;
+        };
+        lastUpdated: Date;
+    } | {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: {};
+        relationshipTypes: {};
+        averageConnections: number;
+        graphDensity: number;
+        extractionStats: null;
+        lastUpdated: null;
+    };
+    /**
+     * Get analytics about the knowledge graph
+     */
+    getKnowledgeGraphAnalytics(userAddress: string): {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: {};
+        relationshipTypes: {};
+        connectedComponents: number;
+        averageConnections: number;
+        lastUpdated: null;
+    } | {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: Record<string, number>;
+        relationshipTypes: Record<string, number>;
+        connectedComponents: number;
+        averageConnections: number;
+        lastUpdated: Date;
+    };
+    /**
+     * Check if graph needs to be saved
+     */
+    isGraphDirty(userAddress: string): boolean;
+    /**
+     * Mark graph as saved
+     */
+    markGraphAsSaved(userAddress: string): void;
+    /**
+     * Get all user addresses with cached graphs
+     */
+    getCachedUsers(): string[];
+    /**
+     * Clear graph cache for a user
+     */
+    clearUserGraph(userAddress: string): void;
+    /**
+     * Serialize graph for storage
+     */
+    serializeGraph(userAddress: string): string | null;
+}
+//# sourceMappingURL=KnowledgeGraphManager.d.ts.map

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

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