@cmdoss/memwal-sdk 0.6.0

package/dist/services/ClassifierService.js

@@ -0,0 +1,374 @@
+/**
+ * ClassifierService - Content Classification and Filtering
+ *
+ * Determines if content should be saved as memory using pattern matching
+ * and AI classification. Provides category classification for content organization.
+ */
+/**
+ * Content classification service for determining memory worthiness
+ */
+export class ClassifierService {
+    constructor(client, config, embeddingService, aiApiKey) {
+        this.client = client;
+        this.config = config;
+        // Explicit memory command patterns - only these trigger by default
+        this.explicitPatterns = [
+            // Explicit memory requests
+            /remember that ([^.!?]+)/i,
+            /remember:?\s*([^.!?]+)/i,
+            /don't forget that ([^.!?]+)/i,
+            /don't forget:?\s*([^.!?]+)/i,
+            /please remember ([^.!?]+)/i,
+            /store (?:this )?(?:in|to) memory:?\s*([^.!?]*)/i,
+            /save (?:this )?(?:in|to) memory:?\s*([^.!?]*)/i,
+            /add (?:this )?to (?:my )?memory:?\s*([^.!?]*)/i,
+            /keep in mind:?\s*([^.!?]+)/i,
+            /note that ([^.!?]+)/i,
+        ];
+        // Full regex patterns for detecting factual statements (used when explicitOnly=false)
+        this.factPatterns = [
+            // Include explicit patterns first
+            ...this.explicitPatterns,
+            // Personal information
+            /my name is ([a-zA-Z\s]+)/i,
+            /my email is ([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})/i,
+            /i live in ([a-zA-Z\s,]+)/i,
+            /i work at ([a-zA-Z\s,&]+)/i,
+            /i am from ([a-zA-Z\s,]+)/i,
+            /i was born in ([a-zA-Z0-9\s,]+)/i,
+            /my birthday is ([a-zA-Z0-9\s,]+)/i,
+            /my phone (?:number|#) is ([0-9+\-\s()]+)/i,
+            /my address is ([a-zA-Z0-9\s,]+)/i,
+            // Preferences and likes/dislikes
+            /i love ([^.!?]+)/i,
+            /i like ([^.!?]+)/i,
+            /i enjoy ([^.!?]+)/i,
+            /i prefer ([^.!?]+)/i,
+            /i hate ([^.!?]+)/i,
+            /i dislike ([^.!?]+)/i,
+            /i don't like ([^.!?]+)/i,
+            /my favorite ([^.!?]+) is ([^.!?]+)/i,
+            /my favourite ([^.!?]+) is ([^.!?]+)/i,
+            // Personal facts
+            /i am ([^.!?]+)/i,
+            /i have ([^.!?]+)/i,
+            /i own ([^.!?]+)/i,
+            /i studied ([^.!?]+)/i,
+            /i graduated from ([^.!?]+)/i,
+        ];
+        // Map of regex patterns to categories (adapted from backend)
+        this.categoryMap = {
+            // Personal information
+            'my name is': 'personal_info',
+            'my email is': 'contact',
+            'i live in': 'location',
+            'i work at': 'career',
+            'i am from': 'background',
+            'i was born': 'background',
+            'my birthday': 'personal_info',
+            'my phone': 'contact',
+            'my address': 'contact',
+            // Preferences
+            'i love': 'preference',
+            'i like': 'preference',
+            'i enjoy': 'preference',
+            'i prefer': 'preference',
+            'i hate': 'preference',
+            'i dislike': 'preference',
+            "i don't like": 'preference',
+            'my favorite': 'preference',
+            'my favourite': 'preference',
+            // Explicit memory requests
+            'remember that': 'custom',
+            'remember': 'custom',
+            "don't forget": 'custom',
+            'please remember': 'custom',
+            'store': 'custom',
+            'save': 'custom',
+            'add': 'custom',
+            'keep in mind': 'custom',
+            'note that': 'custom',
+            // Personal facts
+            'i am': 'personal_info',
+            'i have': 'personal_info',
+            'i own': 'personal_info',
+            'i studied': 'education',
+            'i graduated': 'education',
+        };
+        this.embeddingService = embeddingService;
+        this.aiApiKey = aiApiKey;
+    }
+    /**
+     * Determine if a message contains information worth saving
+     * @param message User message to classify
+     * @param options Classification options
+     * @returns Classification result
+     */
+    async shouldSaveMemory(message, options = {}) {
+        try {
+            // Input validation
+            if (!message || typeof message !== 'string' || message.trim().length === 0) {
+                return {
+                    shouldSave: false,
+                    confidence: 0,
+                    category: 'general',
+                    reasoning: 'Empty or invalid message'
+                };
+            }
+            const { useAI = true, confidenceThreshold = 0.7, explicitOnly = true, // Default to explicit-only mode for user control
+            patterns = explicitOnly ? this.explicitPatterns : this.factPatterns } = options;
+            // Step 1: Check for obvious patterns using regex
+            const patternResult = this.matchPatterns(message, patterns);
+            if (patternResult.matched && patternResult.confidence >= confidenceThreshold) {
+                return {
+                    shouldSave: true,
+                    confidence: patternResult.confidence,
+                    category: patternResult.category,
+                    reasoning: `Matched pattern: ${patternResult.pattern}`
+                };
+            }
+            // Step 2: Use AI for more complex classification (if enabled and available)
+            if (useAI && (this.embeddingService || this.aiApiKey)) {
+                try {
+                    const aiResult = await this.classifyWithAI(message, options);
+                    if (aiResult.confidence >= confidenceThreshold) {
+                        return aiResult;
+                    }
+                }
+                catch (aiError) {
+                    if (process.env.NODE_ENV === 'development') {
+                        const errorMessage = aiError instanceof Error ? aiError.message : String(aiError);
+                        console.warn('AI classification failed, falling back to pattern-only result:', errorMessage);
+                    }
+                }
+            }
+            // Step 3: Return pattern result even if below threshold
+            if (patternResult.matched) {
+                return {
+                    shouldSave: patternResult.confidence >= confidenceThreshold,
+                    confidence: patternResult.confidence,
+                    category: patternResult.category,
+                    reasoning: `Pattern match (confidence: ${patternResult.confidence})`
+                };
+            }
+            // Step 4: Default to not saving
+            return {
+                shouldSave: false,
+                confidence: 0.1,
+                category: 'general',
+                reasoning: 'No significant patterns detected and AI classification unavailable or inconclusive'
+            };
+        }
+        catch (error) {
+            if (process.env.NODE_ENV === 'development') {
+                console.error('Error in classification:', error);
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                shouldSave: false,
+                confidence: 0,
+                category: 'error',
+                reasoning: `Classification error: ${errorMessage}`
+            };
+        }
+    }
+    /**
+     * Classify content into categories
+     * @param content Content to classify
+     * @param options Classification options
+     * @returns Category string
+     */
+    async classifyContent(content, options = {}) {
+        const result = await this.shouldSaveMemory(content, options);
+        return result.category;
+    }
+    /**
+     * Analyze patterns in text
+     * @param text Text to analyze
+     * @param patterns Optional custom patterns
+     * @returns Pattern analysis result
+     */
+    async analyzePatterns(text, patterns = this.factPatterns) {
+        const matches = [];
+        const foundPatterns = [];
+        const foundCategories = [];
+        for (const pattern of patterns) {
+            const match = text.match(pattern);
+            if (match) {
+                const patternStr = pattern.toString();
+                const category = this.getCategoryForPattern(patternStr);
+                const confidence = this.calculatePatternConfidence(pattern, match[0]);
+                matches.push({
+                    pattern: patternStr,
+                    match: match[0],
+                    category,
+                    confidence
+                });
+                if (!foundPatterns.includes(patternStr)) {
+                    foundPatterns.push(patternStr);
+                }
+                if (!foundCategories.includes(category)) {
+                    foundCategories.push(category);
+                }
+            }
+        }
+        return {
+            patterns: foundPatterns,
+            categories: foundCategories,
+            matches
+        };
+    }
+    /**
+     * Match patterns against text
+     * @param text Text to match
+     * @param patterns Patterns to use
+     * @returns Match result
+     */
+    matchPatterns(text, patterns) {
+        // Handle null/undefined text input
+        if (!text || typeof text !== 'string') {
+            return {
+                matched: false,
+                category: 'general',
+                confidence: 0.1
+            };
+        }
+        for (const pattern of patterns) {
+            try {
+                const match = text.match(pattern);
+                if (match) {
+                    const patternStr = pattern.toString();
+                    const category = this.getCategoryForPattern(patternStr);
+                    const confidence = this.calculatePatternConfidence(pattern, match[0]);
+                    return {
+                        matched: true,
+                        pattern: patternStr,
+                        category,
+                        confidence
+                    };
+                }
+            }
+            catch (error) {
+                // Skip invalid patterns
+                if (process.env.NODE_ENV === 'development') {
+                    console.warn(`Pattern matching error for pattern ${pattern}:`, error);
+                }
+            }
+        }
+        return {
+            matched: false,
+            category: 'general',
+            confidence: 0.1
+        };
+    }
+    /**
+     * Get category for a regex pattern
+     * @param patternString String representation of the regex
+     * @returns Category string
+     */
+    getCategoryForPattern(patternString) {
+        // Extract the key part of the pattern for lookup
+        const patternCore = patternString.toLowerCase()
+            .replace(/^\/|\/[a-z]*$/g, '') // Remove regex delimiters
+            .replace(/\([^)]*\)/g, '') // Remove capture groups
+            .replace(/\[[^\]]*\]/g, '') // Remove character classes
+            .replace(/[+*?{}|\\^$]/g, '') // Remove regex metacharacters
+            .trim();
+        // Find the best matching category
+        for (const [key, category] of Object.entries(this.categoryMap)) {
+            if (patternCore.includes(key.toLowerCase()) || key.toLowerCase().includes(patternCore)) {
+                return category;
+            }
+        }
+        return 'custom';
+    }
+    /**
+     * Calculate confidence score for pattern match
+     * @param pattern The regex pattern
+     * @param match The matched text
+     * @returns Confidence score (0-1)
+     */
+    calculatePatternConfidence(pattern, match) {
+        // Base confidence for any pattern match
+        let confidence = 0.85;
+        // Highest confidence for explicit memory commands
+        if (pattern.source.includes('remember') ||
+            pattern.source.includes('forget') ||
+            pattern.source.includes('store') ||
+            pattern.source.includes('save') ||
+            pattern.source.includes('note that') ||
+            pattern.source.includes('keep in mind')) {
+            confidence = 0.98;
+        }
+        // High confidence for specific personal info
+        else if (pattern.source.includes('my name is')) {
+            confidence = 0.95;
+        }
+        // Higher confidence for specific patterns (email, phone, etc.)
+        else if (pattern.source.includes('@') || pattern.source.includes('[0-9]')) {
+            confidence = 0.92;
+        }
+        // Adjust based on match length (longer matches tend to be more specific)
+        if (match.length > 30) {
+            confidence = Math.min(confidence + 0.02, 1.0);
+        }
+        return confidence;
+    }
+    /**
+     * Use AI for classification (fallback/enhancement)
+     * @param message Message to classify
+     * @param options Classification options
+     * @returns Classification result
+     */
+    async classifyWithAI(message, options) {
+        // For now, this is a placeholder that could integrate with:
+        // 1. EmbeddingService for semantic similarity
+        // 2. External AI APIs (OpenAI, Gemini, etc.)
+        // 3. Local AI models
+        if (this.embeddingService) {
+            // Use embedding-based classification
+            return await this.classifyWithEmbeddings(message, options);
+        }
+        // If no AI service is available, return low-confidence result
+        return {
+            shouldSave: false,
+            confidence: 0.3,
+            category: 'general',
+            reasoning: 'AI classification not available'
+        };
+    }
+    /**
+     * Classify using embeddings (semantic similarity approach)
+     * @param message Message to classify
+     * @param options Classification options
+     * @returns Classification result
+     */
+    async classifyWithEmbeddings(message, options) {
+        if (!this.embeddingService) {
+            throw new Error('EmbeddingService not available');
+        }
+        try {
+            // Generate embedding for the message
+            const result = await this.embeddingService.embedText({ text: message, type: 'content' });
+            // For now, use simple heuristics based on common memory-worthy patterns
+            // In a full implementation, this would compare against a database of 
+            // known memory-worthy content embeddings
+            const messageWords = message.toLowerCase().split(/\s+/);
+            const memoryKeywords = ['i', 'my', 'me', 'like', 'love', 'hate', 'prefer', 'enjoy', 'am', 'work', 'live'];
+            const memoryWordCount = messageWords.filter(word => memoryKeywords.includes(word)).length;
+            const confidence = Math.min(memoryWordCount * 0.15 + 0.1, 0.85);
+            const shouldSave = confidence > 0.6;
+            return {
+                shouldSave,
+                confidence,
+                category: shouldSave ? 'personal_info' : 'general',
+                reasoning: `Embedding-based classification (${memoryWordCount} memory keywords found)`
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Embedding classification failed: ${errorMessage}`);
+        }
+    }
+}
+//# sourceMappingURL=ClassifierService.js.map

package/dist/services/ClassifierService.js.map

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

package/dist/services/CrossContextPermissionService.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Cross-Context Permission Service
+ *
+ * Manages cross-context access permissions for the Personal Data Wallet.
+ * Enables apps to request and manage access to data from other app contexts.
+ */
+import { Transaction } from '@mysten/sui/transactions';
+import type { SuiClient } from '@mysten/sui/client';
+import type { Signer } from '@mysten/sui/cryptography';
+export interface CrossContextPermissionConfig {
+    packageId: string;
+    accessRegistryId: string;
+}
+export interface RegisterContextWalletOptions {
+    contextWallet: string;
+    derivationIndex: number;
+    appHint?: string;
+}
+export interface GrantWalletAllowlistOptions {
+    requestingWallet: string;
+    targetWallet: string;
+    scope?: string;
+    accessLevel: 'read' | 'write';
+    expiresAt: number;
+}
+export interface RevokeWalletAllowlistOptions {
+    requestingWallet: string;
+    targetWallet: string;
+    scope?: string;
+}
+export interface WalletAllowlistPermission {
+    requestingWallet: string;
+    targetWallet: string;
+    scope: string;
+    accessLevel: string;
+    grantedAt: number;
+    expiresAt: number;
+    grantedBy: string;
+}
+export interface WalletAllowlistHistoryEvent {
+    timestamp: number;
+    action: 'grant' | 'revoke';
+    requestingWallet: string;
+    targetWallet: string;
+    scope: string;
+    accessLevel: string;
+    expiresAt: number;
+    grantedBy: string;
+}
+export interface WalletAllowlistHistoryFilter {
+    requestingWallet?: string;
+    targetWallet?: string;
+}
+export interface CheckWalletAccessOptions {
+    requestingWallet: string;
+    targetWallet?: string;
+    scope?: string;
+}
+/**
+ * Service for managing cross-context permissions
+ */
+export declare class CrossContextPermissionService {
+    private packageId;
+    private accessRegistryId;
+    private client;
+    constructor(config: CrossContextPermissionConfig, client: SuiClient);
+    /**
+     * Register a new context wallet for an app
+     *
+     * @param options - Context registration options
+     * @param signer - Transaction signer
+     * @returns Transaction digest
+     */
+    registerContextWallet(options: RegisterContextWalletOptions, signer: Signer): Promise<string>;
+    /**
+     * Build transaction to register a context wallet
+     *
+     * @param options - Context registration options
+     * @returns Transaction object
+     */
+    buildRegisterContextWalletTransaction(options: RegisterContextWalletOptions): Transaction;
+    /**
+     * Grant cross-context access permission
+     *
+     * @param options - Permission grant options
+     * @param signer - Transaction signer
+     * @returns Transaction digest
+     */
+    grantWalletAllowlistAccess(options: GrantWalletAllowlistOptions, signer: Signer): Promise<string>;
+    /**
+     * Build transaction to grant cross-context access
+     *
+     * @param options - Permission grant options
+     * @returns Transaction object
+     */
+    buildGrantWalletAllowlistTransaction(options: GrantWalletAllowlistOptions): Transaction;
+    /**
+     * Revoke cross-context access permission
+     *
+     * @param options - Permission revocation options
+     * @param signer - Transaction signer
+     * @returns Transaction digest
+     */
+    revokeWalletAllowlistAccess(options: RevokeWalletAllowlistOptions, signer: Signer): Promise<string>;
+    /**
+     * Build transaction to revoke cross-context access
+     *
+     * @param options - Permission revocation options
+     * @returns Transaction object
+     */
+    buildRevokeWalletAllowlistTransaction(options: RevokeWalletAllowlistOptions): Transaction;
+    /**
+     * Build seal_approve transaction using capability module
+     *
+     * Uses pdw::capability::seal_approve which requires:
+     * - id: vector<u8> - SEAL key identifier (MUST be first parameter!)
+     * - cap: &MemoryCap - Reference to the capability object
+     *
+     * IMPORTANT: SEAL key server extracts 'id' from the FIRST PTB argument
+     *
+     * @param keyId - SEAL key ID bytes (computed from owner + nonce)
+     * @param memoryCapId - MemoryCap object ID on Sui
+     * @returns Transaction object
+     */
+    buildSealApproveTransaction(keyId: Uint8Array, memoryCapId: string): Transaction;
+    /**
+     * Build seal_approve transaction (legacy - for backward compatibility)
+     * @deprecated Use buildSealApproveTransaction with memoryCapId instead
+     */
+    buildSealApproveTransactionLegacy(contentId: Uint8Array, requestingWallet: string): Transaction;
+    /**
+     * Query wallet allowlist permissions filtered by requester, target, or scope
+     */
+    queryWalletPermissions(options: Partial<CheckWalletAccessOptions>): Promise<WalletAllowlistPermission[]>;
+    listGrantsByTarget(targetWallet: string, scope?: string): Promise<WalletAllowlistPermission[]>;
+    listGrantsByRequester(requestingWallet: string, scope?: string): Promise<WalletAllowlistPermission[]>;
+    /**
+     * Determine whether a wallet currently has allowlist permission
+     */
+    hasWalletPermission(options: CheckWalletAccessOptions): Promise<boolean>;
+    /**
+     * List target wallets this requester can access for an optional scope
+     */
+    getAccessibleWallets(requestingWallet: string, scope?: string): Promise<string[]>;
+    getWalletAllowlistHistory(filter?: WalletAllowlistHistoryFilter): Promise<WalletAllowlistHistoryEvent[]>;
+    private fetchWalletAllowlistEvents;
+    private reduceWalletAllowlistEvents;
+}
+//# sourceMappingURL=CrossContextPermissionService.d.ts.map

package/dist/services/CrossContextPermissionService.d.ts.map

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