@cmdoss/memwal-sdk 0.6.0

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

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

package/dist/client/namespaces/consolidated/AINamespace.d.ts

@@ -0,0 +1,265 @@
+/**
+ * AI Namespace - Consolidated AI Features
+ *
+ * Merges functionality from:
+ * - EmbeddingsNamespace: Vector embedding generation
+ * - ClassifyNamespace: Content classification & analysis
+ *
+ * Provides a unified interface for all AI-powered operations.
+ *
+ * @module client/namespaces/consolidated
+ */
+import type { ServiceContainer } from '../../SimplePDWClient';
+/**
+ * Pattern analysis result
+ */
+export interface PatternAnalysis {
+    patterns: Array<{
+        type: string;
+        confidence: number;
+        examples: string[];
+    }>;
+    categories: string[];
+    suggestedCategory: string;
+}
+/**
+ * Classification result with full details
+ */
+export interface ClassificationResult {
+    shouldSave: boolean;
+    confidence: number;
+    category: string;
+    reasoning: string;
+}
+/**
+ * Embedding options
+ */
+export interface EmbedOptions {
+    type?: 'query' | 'document';
+}
+/**
+ * AI Namespace - Unified AI Operations
+ *
+ * Consolidates embeddings and classification into one namespace.
+ *
+ * @example
+ * ```typescript
+ * // Generate embeddings
+ * const vector = await pdw.ai.embed('Hello world');
+ *
+ * // Classify content
+ * const category = await pdw.ai.classify('I love TypeScript');
+ * ```
+ */
+export declare class AINamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Generate embedding for single text
+     *
+     * @param text - Text to embed
+     * @param options - Embedding options
+     * @returns Embedding vector (768 dimensions for Gemini)
+     *
+     * @example
+     * ```typescript
+     * const vector = await pdw.ai.embed('My favorite color is blue');
+     * console.log(vector.length); // 768
+     * ```
+     */
+    embed(text: string, options?: EmbedOptions): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts (batch)
+     *
+     * @param texts - Array of texts
+     * @returns Array of embedding vectors
+     *
+     * @example
+     * ```typescript
+     * const vectors = await pdw.ai.embedBatch(['Hello', 'World', 'TypeScript']);
+     * console.log(vectors.length); // 3
+     * ```
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /**
+     * Calculate cosine similarity between two vectors
+     *
+     * @param vector1 - First vector
+     * @param vector2 - Second vector
+     * @returns Similarity score (0-1, higher is more similar)
+     *
+     * @example
+     * ```typescript
+     * const v1 = await pdw.ai.embed('cat');
+     * const v2 = await pdw.ai.embed('dog');
+     * const similarity = pdw.ai.similarity(v1, v2);
+     * console.log(similarity); // ~0.85 (similar concepts)
+     * ```
+     */
+    similarity(vector1: number[], vector2: number[]): number;
+    /**
+     * Find most similar vectors from candidates
+     *
+     * @param queryVector - Query vector
+     * @param candidateVectors - Candidate vectors to compare
+     * @param k - Number of results (default: 5)
+     * @returns Top k similar vectors with scores
+     *
+     * @example
+     * ```typescript
+     * const query = await pdw.ai.embed('programming');
+     * const candidates = await pdw.ai.embedBatch(['TypeScript', 'cooking', 'Java']);
+     * const similar = pdw.ai.findSimilar(query, candidates, 2);
+     * // Returns indices 0 (TypeScript) and 2 (Java) as most similar
+     * ```
+     */
+    findSimilar(queryVector: number[], candidateVectors: number[][], k?: number): Array<{
+        index: number;
+        score: number;
+    }>;
+    /**
+     * 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.ai.classify('I prefer dark mode');
+     * // Returns: 'preference'
+     * ```
+     */
+    classify(content: string): Promise<string>;
+    /**
+     * Determine if content should be saved as a memory
+     *
+     * Uses AI and pattern matching to decide if content is worth saving.
+     * By default, only explicit commands like "remember that" trigger saves.
+     *
+     * @param content - Text content to analyze
+     * @param options - Options for classification
+     * @param options.explicitOnly - If true (default), only explicit memory commands trigger save
+     * @returns true if should save, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Default: only explicit commands
+     * const shouldSave = await pdw.ai.shouldSave('Remember that I love TypeScript');
+     * // Returns: true
+     *
+     * // With explicitOnly=false, pattern matching is more aggressive
+     * const shouldSave2 = await pdw.ai.shouldSave('I love TypeScript', { explicitOnly: false });
+     * // Returns: true (matches "I love..." pattern)
+     * ```
+     */
+    shouldSave(content: string, options?: {
+        explicitOnly?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Extract memory content from explicit command
+     *
+     * Parses commands like "remember that X" and extracts X.
+     *
+     * @param message - User message to parse
+     * @returns Extracted content or null if no command found
+     *
+     * @example
+     * ```typescript
+     * const content = pdw.ai.extractMemoryContent('Remember that my name is John');
+     * // Returns: 'my name is John'
+     *
+     * const content2 = pdw.ai.extractMemoryContent('Hello there');
+     * // Returns: null
+     * ```
+     */
+    extractMemoryContent(message: string): string | null;
+    /**
+     * Extract multiple memories from a single message
+     *
+     * Splits a message containing multiple facts/memories into individual items.
+     * Supports comma-separated, semicolon-separated, "and"-separated, and numbered lists.
+     *
+     * @param message - User message potentially containing multiple memories
+     * @returns Array of extracted memory contents, or empty array if no pattern matched
+     *
+     * @example
+     * ```typescript
+     * // Comma-separated
+     * pdw.ai.extractMultipleMemories('Remember that my name is John, I work at Google, and my birthday is Dec 25');
+     * // Returns: ['my name is John', 'I work at Google', 'my birthday is Dec 25']
+     *
+     * // Semicolon-separated
+     * pdw.ai.extractMultipleMemories('Note that: API key is abc123; server port is 3000; database is PostgreSQL');
+     * // Returns: ['API key is abc123', 'server port is 3000', 'database is PostgreSQL']
+     *
+     * // Numbered list
+     * pdw.ai.extractMultipleMemories('Remember: 1. My email is test@example 2. My phone is 123-456 3. I prefer dark mode');
+     * // Returns: ['My email is test@example', 'My phone is 123-456', 'I prefer dark mode']
+     *
+     * // Single memory (fallback to extractMemoryContent)
+     * pdw.ai.extractMultipleMemories('Remember that I like pizza');
+     * // Returns: ['I like pizza']
+     * ```
+     */
+    extractMultipleMemories(message: string): string[];
+    /**
+     * Check if message is a memory query (asking about stored memories)
+     *
+     * @param message - User message to check
+     * @returns true if user is asking about their memories
+     *
+     * @example
+     * ```typescript
+     * pdw.ai.isMemoryQuery('What do you remember about me?'); // true
+     * pdw.ai.isMemoryQuery('What is my name?'); // true
+     * pdw.ai.isMemoryQuery('Hello'); // false
+     * ```
+     */
+    isMemoryQuery(message: string): boolean;
+    /**
+     * Get full classification result with details
+     *
+     * @param content - Text content to classify
+     * @returns Full classification result with confidence and reasoning
+     *
+     * @example
+     * ```typescript
+     * const result = await pdw.ai.classifyFull('My birthday is January 15');
+     * // Returns: { shouldSave: true, confidence: 0.95, category: 'personal_info', reasoning: '...' }
+     * ```
+     */
+    classifyFull(content: string): Promise<ClassificationResult>;
+    /**
+     * 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.ai.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.ai.importance('Emergency contact: 911');
+     * // Returns: 10
+     * ```
+     */
+    importance(content: string): Promise<number>;
+}
+//# sourceMappingURL=AINamespace.d.ts.map

package/dist/client/namespaces/consolidated/AINamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AINamespace.d.ts","sourceRoot":"","sources":["../../../../src/client/namespaces/consolidated/AINamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D;;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;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CAC7B;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAM9C;;;;;;;;;;;;OAYG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpE;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAQtD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAOxD;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACT,WAAW,EAAE,MAAM,EAAE,EACrB,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAC5B,CAAC,GAAE,MAAU,GACZ,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAe1C;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOhD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzF;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAmDlD;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYvC;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOlE;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBzD;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBnD"}

package/dist/client/namespaces/consolidated/AINamespace.js

@@ -0,0 +1,390 @@
+/**
+ * AI Namespace - Consolidated AI Features
+ *
+ * Merges functionality from:
+ * - EmbeddingsNamespace: Vector embedding generation
+ * - ClassifyNamespace: Content classification & analysis
+ *
+ * Provides a unified interface for all AI-powered operations.
+ *
+ * @module client/namespaces/consolidated
+ */
+// ============================================================================
+// AI Namespace
+// ============================================================================
+/**
+ * AI Namespace - Unified AI Operations
+ *
+ * Consolidates embeddings and classification into one namespace.
+ *
+ * @example
+ * ```typescript
+ * // Generate embeddings
+ * const vector = await pdw.ai.embed('Hello world');
+ *
+ * // Classify content
+ * const category = await pdw.ai.classify('I love TypeScript');
+ * ```
+ */
+export class AINamespace {
+    constructor(services) {
+        this.services = services;
+    }
+    // ==========================================================================
+    // Embedding Operations (from EmbeddingsNamespace)
+    // ==========================================================================
+    /**
+     * Generate embedding for single text
+     *
+     * @param text - Text to embed
+     * @param options - Embedding options
+     * @returns Embedding vector (768 dimensions for Gemini)
+     *
+     * @example
+     * ```typescript
+     * const vector = await pdw.ai.embed('My favorite color is blue');
+     * console.log(vector.length); // 768
+     * ```
+     */
+    async embed(text, options) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured. Please provide geminiApiKey.');
+        }
+        const result = await this.services.embedding.embedText({ text });
+        return result.vector;
+    }
+    /**
+     * Generate embeddings for multiple texts (batch)
+     *
+     * @param texts - Array of texts
+     * @returns Array of embedding vectors
+     *
+     * @example
+     * ```typescript
+     * const vectors = await pdw.ai.embedBatch(['Hello', 'World', 'TypeScript']);
+     * console.log(vectors.length); // 3
+     * ```
+     */
+    async embedBatch(texts) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        const result = await this.services.embedding.embedBatch(texts);
+        return result.vectors;
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     *
+     * @param vector1 - First vector
+     * @param vector2 - Second vector
+     * @returns Similarity score (0-1, higher is more similar)
+     *
+     * @example
+     * ```typescript
+     * const v1 = await pdw.ai.embed('cat');
+     * const v2 = await pdw.ai.embed('dog');
+     * const similarity = pdw.ai.similarity(v1, v2);
+     * console.log(similarity); // ~0.85 (similar concepts)
+     * ```
+     */
+    similarity(vector1, vector2) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        return this.services.embedding.calculateCosineSimilarity(vector1, vector2);
+    }
+    /**
+     * Find most similar vectors from candidates
+     *
+     * @param queryVector - Query vector
+     * @param candidateVectors - Candidate vectors to compare
+     * @param k - Number of results (default: 5)
+     * @returns Top k similar vectors with scores
+     *
+     * @example
+     * ```typescript
+     * const query = await pdw.ai.embed('programming');
+     * const candidates = await pdw.ai.embedBatch(['TypeScript', 'cooking', 'Java']);
+     * const similar = pdw.ai.findSimilar(query, candidates, 2);
+     * // Returns indices 0 (TypeScript) and 2 (Java) as most similar
+     * ```
+     */
+    findSimilar(queryVector, candidateVectors, k = 5) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        const results = this.services.embedding.findMostSimilar(queryVector, candidateVectors, k);
+        return results.map(r => ({
+            index: r.index,
+            score: r.similarity
+        }));
+    }
+    // ==========================================================================
+    // Classification Operations (from ClassifyNamespace)
+    // ==========================================================================
+    /**
+     * 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.ai.classify('I prefer dark mode');
+     * // Returns: 'preference'
+     * ```
+     */
+    async classify(content) {
+        if (!this.services.classifier) {
+            throw new Error('Classifier service not configured. Please provide geminiApiKey.');
+        }
+        return await this.services.classifier.classifyContent(content);
+    }
+    /**
+     * Determine if content should be saved as a memory
+     *
+     * Uses AI and pattern matching to decide if content is worth saving.
+     * By default, only explicit commands like "remember that" trigger saves.
+     *
+     * @param content - Text content to analyze
+     * @param options - Options for classification
+     * @param options.explicitOnly - If true (default), only explicit memory commands trigger save
+     * @returns true if should save, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Default: only explicit commands
+     * const shouldSave = await pdw.ai.shouldSave('Remember that I love TypeScript');
+     * // Returns: true
+     *
+     * // With explicitOnly=false, pattern matching is more aggressive
+     * const shouldSave2 = await pdw.ai.shouldSave('I love TypeScript', { explicitOnly: false });
+     * // Returns: true (matches "I love..." pattern)
+     * ```
+     */
+    async shouldSave(content, options) {
+        if (!this.services.classifier) {
+            throw new Error('Classifier service not configured. Please provide geminiApiKey.');
+        }
+        const result = await this.services.classifier.shouldSaveMemory(content, {
+            explicitOnly: options?.explicitOnly ?? true // Default to explicit-only
+        });
+        return result.shouldSave;
+    }
+    /**
+     * Extract memory content from explicit command
+     *
+     * Parses commands like "remember that X" and extracts X.
+     *
+     * @param message - User message to parse
+     * @returns Extracted content or null if no command found
+     *
+     * @example
+     * ```typescript
+     * const content = pdw.ai.extractMemoryContent('Remember that my name is John');
+     * // Returns: 'my name is John'
+     *
+     * const content2 = pdw.ai.extractMemoryContent('Hello there');
+     * // Returns: null
+     * ```
+     */
+    extractMemoryContent(message) {
+        const patterns = [
+            /remember that\s+(.+)/i,
+            /remember:?\s+(.+)/i,
+            /don't forget that\s+(.+)/i,
+            /don't forget:?\s+(.+)/i,
+            /please remember\s+(.+)/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\s+(.+)/i,
+        ];
+        for (const pattern of patterns) {
+            const match = message.match(pattern);
+            if (match && match[1]) {
+                return match[1].trim();
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract multiple memories from a single message
+     *
+     * Splits a message containing multiple facts/memories into individual items.
+     * Supports comma-separated, semicolon-separated, "and"-separated, and numbered lists.
+     *
+     * @param message - User message potentially containing multiple memories
+     * @returns Array of extracted memory contents, or empty array if no pattern matched
+     *
+     * @example
+     * ```typescript
+     * // Comma-separated
+     * pdw.ai.extractMultipleMemories('Remember that my name is John, I work at Google, and my birthday is Dec 25');
+     * // Returns: ['my name is John', 'I work at Google', 'my birthday is Dec 25']
+     *
+     * // Semicolon-separated
+     * pdw.ai.extractMultipleMemories('Note that: API key is abc123; server port is 3000; database is PostgreSQL');
+     * // Returns: ['API key is abc123', 'server port is 3000', 'database is PostgreSQL']
+     *
+     * // Numbered list
+     * pdw.ai.extractMultipleMemories('Remember: 1. My email is test@example 2. My phone is 123-456 3. I prefer dark mode');
+     * // Returns: ['My email is test@example', 'My phone is 123-456', 'I prefer dark mode']
+     *
+     * // Single memory (fallback to extractMemoryContent)
+     * pdw.ai.extractMultipleMemories('Remember that I like pizza');
+     * // Returns: ['I like pizza']
+     * ```
+     */
+    extractMultipleMemories(message) {
+        // First, extract the content after the memory keyword
+        const content = this.extractMemoryContent(message);
+        if (!content) {
+            return [];
+        }
+        // Try numbered list pattern: "1. xxx 2. yyy 3. zzz"
+        const numberedPattern = /\d+\.\s*([^0-9]+?)(?=\d+\.|$)/g;
+        const numberedMatches = [...content.matchAll(numberedPattern)];
+        if (numberedMatches.length > 1) {
+            return numberedMatches
+                .map(m => m[1].trim())
+                .filter(s => s.length > 0);
+        }
+        // Try bullet list pattern: "- xxx - yyy" or "• xxx • yyy"
+        const bulletPattern = /[-•]\s*([^-•]+)/g;
+        const bulletMatches = [...content.matchAll(bulletPattern)];
+        if (bulletMatches.length > 1) {
+            return bulletMatches
+                .map(m => m[1].trim())
+                .filter(s => s.length > 0);
+        }
+        // Try semicolon-separated
+        if (content.includes(';')) {
+            const parts = content.split(';')
+                .map(s => s.trim())
+                .filter(s => s.length > 0);
+            if (parts.length > 1) {
+                return parts;
+            }
+        }
+        // Try comma + "and" pattern: "xxx, yyy, and zzz" or "xxx, yyy and zzz"
+        // Also handles simple comma-separated: "xxx, yyy, zzz"
+        const commaAndPattern = /,\s*(?:and\s+)?|\s+and\s+/i;
+        if (commaAndPattern.test(content)) {
+            const parts = content.split(commaAndPattern)
+                .map(s => s.trim())
+                .filter(s => s.length > 0);
+            if (parts.length > 1) {
+                return parts;
+            }
+        }
+        // Single memory - return as array with one item
+        return [content];
+    }
+    /**
+     * Check if message is a memory query (asking about stored memories)
+     *
+     * @param message - User message to check
+     * @returns true if user is asking about their memories
+     *
+     * @example
+     * ```typescript
+     * pdw.ai.isMemoryQuery('What do you remember about me?'); // true
+     * pdw.ai.isMemoryQuery('What is my name?'); // true
+     * pdw.ai.isMemoryQuery('Hello'); // false
+     * ```
+     */
+    isMemoryQuery(message) {
+        const queryPatterns = [
+            /what do you (remember|know) about me/i,
+            /what('s| is) my (name|email|birthday|job|work|address)/i,
+            /do you (remember|know) my/i,
+            /tell me what you (remember|know)/i,
+            /what have i told you/i,
+            /what memories do you have/i,
+        ];
+        return queryPatterns.some(pattern => pattern.test(message));
+    }
+    /**
+     * Get full classification result with details
+     *
+     * @param content - Text content to classify
+     * @returns Full classification result with confidence and reasoning
+     *
+     * @example
+     * ```typescript
+     * const result = await pdw.ai.classifyFull('My birthday is January 15');
+     * // Returns: { shouldSave: true, confidence: 0.95, category: 'personal_info', reasoning: '...' }
+     * ```
+     */
+    async classifyFull(content) {
+        if (!this.services.classifier) {
+            throw new Error('Classifier service not configured. Please provide geminiApiKey.');
+        }
+        return await this.services.classifier.shouldSaveMemory(content);
+    }
+    /**
+     * 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.ai.patterns('My email is user@example.com');
+     * // Returns: { patterns: [{ type: 'contact', ... }], suggestedCategory: 'contact' }
+     * ```
+     */
+    async patterns(content) {
+        if (!this.services.classifier) {
+            throw new Error('Classifier service not configured. Please provide geminiApiKey.');
+        }
+        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'
+        };
+    }
+    /**
+     * 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.ai.importance('Emergency contact: 911');
+     * // Returns: 10
+     * ```
+     */
+    async importance(content) {
+        if (!this.services.classifier) {
+            throw new Error('Classifier service not configured. Please provide geminiApiKey.');
+        }
+        const category = await this.services.classifier.classifyContent(content);
+        const categoryImportance = {
+            'emergency': 10,
+            'contact': 9,
+            'personal_info': 8,
+            'career': 7,
+            'preference': 6,
+            'fact': 5,
+            'note': 4,
+            'general': 3
+        };
+        return categoryImportance[category] || 5;
+    }
+}
+//# sourceMappingURL=AINamespace.js.map

package/dist/client/namespaces/consolidated/AINamespace.js.map

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