@cmdoss/memwal-sdk 0.6.0

package/dist/client/namespaces/ChatNamespace.js

@@ -0,0 +1,123 @@
+/**
+ * Chat Namespace - AI Chat with Memory Context
+ *
+ * Pure delegation to ChatService for memory-aware conversations.
+ * Automatically retrieves relevant memories as context for AI responses.
+ *
+ * @module client/namespaces
+ */
+/**
+ * Chat Namespace
+ *
+ * Handles AI chat operations with memory context
+ */
+export class ChatNamespace {
+    constructor(services) {
+        this.services = services;
+    }
+    /**
+     * Create a new chat session
+     *
+     * Delegates to: ChatService.createSession()
+     *
+     * @param options - Session options
+     * @returns Created session
+     */
+    async createSession(options) {
+        const result = await this.services.chat.createSession({
+            userAddress: this.services.config.userAddress,
+            modelName: options?.model || process.env.AI_CHAT_MODEL || 'google/gemini-2.5-flash',
+            title: options?.title || 'New Chat'
+        });
+        // ChatService returns ChatSessionResponse, adapt to ChatSession
+        return result.session;
+    }
+    /**
+     * Get chat session
+     *
+     * Delegates to: ChatService.getSession()
+     *
+     * @param sessionId - Session ID
+     * @returns Session with messages
+     */
+    async getSession(sessionId) {
+        const result = await this.services.chat.getSession(sessionId, this.services.config.userAddress);
+        return result.session;
+    }
+    /**
+     * Get all user sessions
+     *
+     * Delegates to: ChatService.getSessions()
+     *
+     * @returns Array of sessions
+     */
+    async getSessions() {
+        const result = await this.services.chat.getSessions(this.services.config.userAddress);
+        return result.sessions;
+    }
+    /**
+     * Send message (non-streaming)
+     *
+     * Delegates to: ChatService.sendMessage()
+     *
+     * @param sessionId - Session ID
+     * @param message - Message text
+     * @returns AI response
+     */
+    async send(sessionId, message) {
+        const result = await this.services.chat.sendMessage({
+            text: message,
+            userId: this.services.config.userAddress,
+            userAddress: this.services.config.userAddress,
+            sessionId
+        });
+        return {
+            role: 'assistant', // ChatService returns response message
+            content: result.content || '',
+            timestamp: Date.now()
+        };
+    }
+    /**
+     * Stream chat response
+     *
+     * Delegates to: ChatService.streamChat()
+     *
+     * @param sessionId - Session ID
+     * @param message - Message text
+     * @param callbacks - Streaming callbacks
+     */
+    async stream(sessionId, message, callbacks) {
+        await this.services.chat.streamChat({
+            text: message,
+            userId: this.services.config.userAddress,
+            userAddress: this.services.config.userAddress,
+            sessionId
+        }, {
+            onMessage: callbacks.onMessage || (() => { }),
+            onDone: callbacks.onDone || (() => { }),
+            onError: callbacks.onError ? (event) => callbacks.onError(new Error(event.data)) : undefined
+        });
+    }
+    /**
+     * Update session title
+     *
+     * Delegates to: ChatService.updateSessionTitle()
+     *
+     * @param sessionId - Session ID
+     * @param title - New title
+     */
+    async updateTitle(sessionId, title) {
+        await this.services.chat.updateSessionTitle(sessionId, this.services.config.userAddress, title);
+    }
+    /**
+     * Delete chat session
+     *
+     * Delegates to: ChatService.deleteSession()
+     *
+     * @param sessionId - Session ID
+     */
+    async delete(sessionId) {
+        await this.services.chat.deleteSession(sessionId, this.services.config.userAddress);
+    }
+}
+//# sourceMappingURL=ChatNamespace.js.map

package/dist/client/namespaces/ChatNamespace.js.map

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

package/dist/client/namespaces/ClassifyNamespace.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Classification Namespace - Content Classification & Analysis
+ *
+ * Provides AI-powered classification for:
+ * - Determining if content should be saved as memory
+ * - Auto-categorizing content
+ * - Pattern analysis
+ * - Importance scoring
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+/**
+ * Pattern analysis result
+ */
+export interface PatternAnalysis {
+    patterns: Array<{
+        type: string;
+        confidence: number;
+        examples: string[];
+    }>;
+    categories: string[];
+    suggestedCategory: string;
+}
+/**
+ * Classification Namespace
+ *
+ * Handles AI-powered content classification
+ */
+export declare class ClassifyNamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Determine if content should be saved as a memory
+     *
+     * Uses AI and pattern matching to decide if content is worth saving.
+     *
+     * @param content - Text content to analyze
+     * @returns true if should save, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const shouldSave = await pdw.classify.shouldSave('I love TypeScript');
+     * if (shouldSave) {
+     *   await pdw.memory.create('I love TypeScript');
+     * }
+     * ```
+     */
+    shouldSave(content: string): Promise<boolean>;
+    /**
+     * Classify content into category
+     *
+     * Uses AI to determine the most appropriate category.
+     *
+     * @param content - Text content to classify
+     * @returns Category name (fact, preference, todo, note, general, etc.)
+     *
+     * @example
+     * ```typescript
+     * const category = await pdw.classify.category('I prefer dark mode');
+     * // Returns: 'preference'
+     * ```
+     */
+    category(content: string): Promise<string>;
+    /**
+     * Analyze patterns in content
+     *
+     * Detects patterns like personal info, contact details, preferences, etc.
+     *
+     * @param content - Text content to analyze
+     * @returns Pattern analysis with detected patterns and suggested category
+     *
+     * @example
+     * ```typescript
+     * const analysis = await pdw.classify.patterns('My email is user@example.com');
+     * // Returns: { patterns: [{ type: 'contact', ... }], suggestedCategory: 'contact' }
+     * ```
+     */
+    patterns(content: string): Promise<PatternAnalysis>;
+    /**
+     * Calculate importance score for content
+     *
+     * Uses AI to determine how important the content is (1-10 scale).
+     *
+     * @param content - Text content to score
+     * @returns Importance score (1-10)
+     *
+     * @example
+     * ```typescript
+     * const importance = await pdw.classify.importance('Emergency contact: 911');
+     * // Returns: 10
+     * ```
+     */
+    importance(content: string): Promise<number>;
+}
+//# sourceMappingURL=ClassifyNamespace.d.ts.map

package/dist/client/namespaces/ClassifyNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassifyNamespace.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/ClassifyNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAanD;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAchD;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBzD;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0BnD"}

package/dist/client/namespaces/ClassifyNamespace.js

@@ -0,0 +1,149 @@
+/**
+ * Classification Namespace - Content Classification & Analysis
+ *
+ * Provides AI-powered classification for:
+ * - Determining if content should be saved as memory
+ * - Auto-categorizing content
+ * - Pattern analysis
+ * - Importance scoring
+ *
+ * @module client/namespaces
+ */
+/**
+ * Classification Namespace
+ *
+ * Handles AI-powered content classification
+ */
+export class ClassifyNamespace {
+    constructor(services) {
+        this.services = services;
+    }
+    /**
+     * Determine if content should be saved as a memory
+     *
+     * Uses AI and pattern matching to decide if content is worth saving.
+     *
+     * @param content - Text content to analyze
+     * @returns true if should save, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const shouldSave = await pdw.classify.shouldSave('I love TypeScript');
+     * if (shouldSave) {
+     *   await pdw.memory.create('I love TypeScript');
+     * }
+     * ```
+     */
+    async shouldSave(content) {
+        try {
+            if (!this.services.classifier) {
+                throw new Error('Classifier service not configured. Please provide geminiApiKey in config.');
+            }
+            const result = await this.services.classifier.shouldSaveMemory(content);
+            return result.shouldSave;
+        }
+        catch (error) {
+            throw new Error(`Classification failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Classify content into category
+     *
+     * Uses AI to determine the most appropriate category.
+     *
+     * @param content - Text content to classify
+     * @returns Category name (fact, preference, todo, note, general, etc.)
+     *
+     * @example
+     * ```typescript
+     * const category = await pdw.classify.category('I prefer dark mode');
+     * // Returns: 'preference'
+     * ```
+     */
+    async category(content) {
+        try {
+            if (!this.services.classifier) {
+                throw new Error('Classifier service not configured. Please provide geminiApiKey in config.');
+            }
+            // classifyContent returns string directly, not object
+            const category = await this.services.classifier.classifyContent(content);
+            return category;
+        }
+        catch (error) {
+            throw new Error(`Category classification failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Analyze patterns in content
+     *
+     * Detects patterns like personal info, contact details, preferences, etc.
+     *
+     * @param content - Text content to analyze
+     * @returns Pattern analysis with detected patterns and suggested category
+     *
+     * @example
+     * ```typescript
+     * const analysis = await pdw.classify.patterns('My email is user@example.com');
+     * // Returns: { patterns: [{ type: 'contact', ... }], suggestedCategory: 'contact' }
+     * ```
+     */
+    async patterns(content) {
+        try {
+            if (!this.services.classifier) {
+                throw new Error('Classifier service not configured. Please provide geminiApiKey in config.');
+            }
+            const result = await this.services.classifier.analyzePatterns(content);
+            return {
+                patterns: result.patterns.map((p) => ({
+                    type: p,
+                    confidence: 1.0,
+                    examples: []
+                })),
+                categories: result.categories || [],
+                suggestedCategory: result.categories[0] || 'general' // Take first category
+            };
+        }
+        catch (error) {
+            throw new Error(`Pattern analysis failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Calculate importance score for content
+     *
+     * Uses AI to determine how important the content is (1-10 scale).
+     *
+     * @param content - Text content to score
+     * @returns Importance score (1-10)
+     *
+     * @example
+     * ```typescript
+     * const importance = await pdw.classify.importance('Emergency contact: 911');
+     * // Returns: 10
+     * ```
+     */
+    async importance(content) {
+        try {
+            if (!this.services.classifier) {
+                throw new Error('Classifier service not configured. Please provide geminiApiKey in config.');
+            }
+            // classifyContent returns category string
+            const category = await this.services.classifier.classifyContent(content);
+            // Determine importance based on category
+            const categoryImportance = {
+                'emergency': 10,
+                'contact': 9,
+                'personal_info': 8,
+                'career': 7,
+                'preference': 6,
+                'fact': 5,
+                'note': 4,
+                'general': 3
+            };
+            return categoryImportance[category] || 5;
+        }
+        catch (error) {
+            throw new Error(`Importance scoring failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=ClassifyNamespace.js.map

package/dist/client/namespaces/ClassifyNamespace.js.map

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

package/dist/client/namespaces/ContextNamespace.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Context Namespace - App Context Management & Cross-Context Data Transfer
+ *
+ * Higher-level abstraction over MemoryCap capabilities.
+ * Provides user-friendly API for managing app contexts and
+ * exporting/importing data between different dApp contexts.
+ *
+ * A "context" is simply a MemoryCap for a specific app ID.
+ * This namespace makes it easier to work with app-scoped data.
+ *
+ * Key features:
+ * - Create/manage app contexts (MemoryCaps)
+ * - Export private data from one context
+ * - Import data into another context (re-encrypted)
+ * - User must sign to authorize decryption
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+import type { MemoryCap } from '../../core/types/capability';
+/**
+ * Context info with additional metadata
+ */
+export interface ContextInfo extends MemoryCap {
+    /** Number of memories in this context */
+    memoryCount?: number;
+    /** Last activity timestamp */
+    lastActivity?: number;
+}
+/**
+ * Context Namespace
+ *
+ * Higher-level API for managing app contexts
+ */
+export declare class ContextNamespace {
+    private services;
+    private capService;
+    constructor(services: ServiceContainer);
+    /**
+     * Ensure CapabilityService is initialized
+     */
+    private ensureService;
+    /**
+     * Create a new context for an app
+     *
+     * @param appId - Application identifier (e.g., "MEMO", "HEALTH", "FINANCE")
+     * @returns Created context (MemoryCap)
+     *
+     * @example
+     * ```typescript
+     * const memoContext = await pdw.context.create('MEMO');
+     * const healthContext = await pdw.context.create('HEALTH');
+     * ```
+     */
+    create(appId: string): Promise<MemoryCap>;
+    /**
+     * Get context by app ID
+     *
+     * @param appId - Application identifier
+     * @returns Context or null if not found
+     */
+    get(appId: string): Promise<MemoryCap | null>;
+    /**
+     * Get or create context for an app
+     *
+     * Convenience method - returns existing context if found,
+     * otherwise creates a new one.
+     *
+     * @param appId - Application identifier
+     * @returns Existing or newly created context
+     *
+     * @example
+     * ```typescript
+     * // Always get a context, create if needed
+     * const ctx = await pdw.context.getOrCreate('MEMO');
+     * ```
+     */
+    getOrCreate(appId: string): Promise<MemoryCap>;
+    /**
+     * List all contexts owned by the user
+     *
+     * @returns Array of contexts (MemoryCaps)
+     *
+     * @example
+     * ```typescript
+     * const contexts = await pdw.context.list();
+     * contexts.forEach(ctx => console.log(ctx.appId));
+     * ```
+     */
+    list(): Promise<MemoryCap[]>;
+    /**
+     * Delete a context (burns the capability)
+     *
+     * Warning: This permanently revokes access to all memories
+     * encrypted with this context's key.
+     *
+     * @param appId - Application identifier
+     *
+     * @example
+     * ```typescript
+     * await pdw.context.delete('OLD_APP');
+     * ```
+     */
+    delete(appId: string): Promise<void>;
+    /**
+     * Transfer context to another user
+     *
+     * After transfer:
+     * - New owner can decrypt memories for this context
+     * - Original owner loses access
+     *
+     * @param appId - Application identifier
+     * @param recipient - Recipient's Sui address
+     */
+    transfer(appId: string, recipient: string): Promise<void>;
+    /**
+     * Check if context exists for an app
+     *
+     * @param appId - Application identifier
+     * @returns True if context exists
+     */
+    exists(appId: string): Promise<boolean>;
+    /**
+     * Get context with extended info (memory count, last activity)
+     *
+     * Queries actual memory count and last activity from:
+     * 1. ViewService (on-chain query) if available
+     * 2. MemoryIndexService (local index) as fallback
+     *
+     * @param appId - Application identifier
+     * @returns Context info or null
+     */
+    getInfo(appId: string): Promise<ContextInfo | null>;
+    /**
+     * Get SEAL key ID for a context
+     *
+     * Used for encryption/decryption operations.
+     *
+     * @param appId - Application identifier
+     * @returns Key ID as hex string
+     */
+    getKeyId(appId: string): Promise<string | null>;
+    /**
+     * Get all app IDs for user's contexts
+     *
+     * @returns Array of app IDs
+     */
+    getAppIds(): Promise<string[]>;
+}
+//# sourceMappingURL=ContextNamespace.d.ts.map

package/dist/client/namespaces/ContextNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextNamespace.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/ContextNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,UAAU,CAAkC;gBAEhC,QAAQ,EAAE,gBAAgB;IAa9C;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAO/C;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKnD;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAUpD;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAQlC;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C;;;;;;;;;OASG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7C;;;;;;;;;OASG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA0DzD;;;;;;;OAOG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWrD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAIrC"}