@lanonasis/memory-client 2.0.0 → 2.2.0

package/dist/index.esm.js

@@ -1,4 +1,265 @@
 import { z } from 'zod';
+import { execSync, exec } from 'child_process';
+import { promisify } from 'util';
+
+/**
+ * Memory types supported by the service
+ */
+const MEMORY_TYPES = ['context', 'project', 'knowledge', 'reference', 'personal', 'workflow'];
+/**
+ * Memory status values
+ */
+const MEMORY_STATUSES = ['active', 'archived', 'draft', 'deleted'];
+/**
+ * Validation schemas using Zod
+ */
+const createMemorySchema = z.object({
+    title: z.string().min(1).max(500),
+    content: z.string().min(1).max(50000),
+    summary: z.string().max(1000).optional(),
+    memory_type: z.enum(MEMORY_TYPES).default('context'),
+    topic_id: z.string().uuid().optional(),
+    project_ref: z.string().max(100).optional(),
+    tags: z.array(z.string().min(1).max(50)).max(20).default([]),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+const updateMemorySchema = z.object({
+    title: z.string().min(1).max(500).optional(),
+    content: z.string().min(1).max(50000).optional(),
+    summary: z.string().max(1000).optional(),
+    memory_type: z.enum(MEMORY_TYPES).optional(),
+    status: z.enum(MEMORY_STATUSES).optional(),
+    topic_id: z.string().uuid().nullable().optional(),
+    project_ref: z.string().max(100).nullable().optional(),
+    tags: z.array(z.string().min(1).max(50)).max(20).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+const searchMemorySchema = z.object({
+    query: z.string().min(1).max(1000),
+    memory_types: z.array(z.enum(MEMORY_TYPES)).optional(),
+    tags: z.array(z.string()).optional(),
+    topic_id: z.string().uuid().optional(),
+    project_ref: z.string().optional(),
+    status: z.enum(MEMORY_STATUSES).default('active'),
+    limit: z.number().int().min(1).max(100).default(20),
+    threshold: z.number().min(0).max(1).default(0.7)
+});
+const createTopicSchema = z.object({
+    name: z.string().min(1).max(100),
+    description: z.string().max(500).optional(),
+    color: z.string().regex(/^#[0-9A-Fa-f]{6}$/).optional(),
+    icon: z.string().max(50).optional(),
+    parent_topic_id: z.string().uuid().optional()
+});
+z
+    .object({
+    memory_id: z.string().uuid().optional(),
+    content: z.string().min(1).optional(),
+    title: z.string().optional(),
+    existing_tags: z.array(z.string()).optional(),
+    max_suggestions: z.number().int().min(1).max(10).optional()
+})
+    .refine((data) => data.memory_id || data.content, {
+    message: 'Either memory_id or content is required'
+});
+z.object({
+    time_range_days: z.number().int().min(1).max(365).optional(),
+    include_insights: z.boolean().optional(),
+    response_format: z.enum(['json', 'markdown']).optional()
+});
+z.object({
+    include_recommendations: z.boolean().optional(),
+    detailed_breakdown: z.boolean().optional()
+});
+z
+    .object({
+    memory_id: z.string().uuid().optional(),
+    query: z.string().min(1).optional(),
+    limit: z.number().int().min(1).max(20).optional(),
+    similarity_threshold: z.number().min(0).max(1).optional(),
+    exclude_ids: z.array(z.string().uuid()).optional()
+})
+    .refine((data) => data.memory_id || data.query, {
+    message: 'Either memory_id or query is required'
+});
+z.object({
+    similarity_threshold: z.number().min(0).max(1).optional(),
+    include_archived: z.boolean().optional(),
+    limit: z.number().int().min(1).max(50).optional()
+});
+z.object({
+    memory_ids: z.array(z.string().uuid()).optional(),
+    topic: z.string().min(1).optional(),
+    time_range_days: z.number().int().min(1).max(365).optional(),
+    insight_types: z.array(z.enum(['themes', 'connections', 'gaps', 'actions', 'summary'])).optional(),
+    detail_level: z.enum(['brief', 'detailed', 'comprehensive']).optional()
+});
+// ========================================
+// Intelligence Feature Types (v2.0)
+// ========================================
+/**
+ * Chunking strategies for content preprocessing
+ */
+const CHUNKING_STRATEGIES = ['semantic', 'fixed-size', 'paragraph', 'sentence', 'code-block'];
+/**
+ * Content types detected or specified
+ */
+const CONTENT_TYPES = ['text', 'code', 'markdown', 'json', 'yaml'];
+// ========================================
+// Enhanced Search Types
+// ========================================
+/**
+ * Search modes for memory queries
+ */
+const SEARCH_MODES = ['vector', 'text', 'hybrid'];
+// ========================================
+// Validation Schemas for Intelligence
+// ========================================
+const preprocessingOptionsSchema = z.object({
+    chunking: z.object({
+        strategy: z.enum(CHUNKING_STRATEGIES).optional(),
+        maxChunkSize: z.number().int().min(100).max(10000).optional(),
+        overlap: z.number().int().min(0).max(500).optional()
+    }).optional(),
+    cleanContent: z.boolean().optional(),
+    extractMetadata: z.boolean().optional()
+}).optional();
+const enhancedSearchSchema = z.object({
+    query: z.string().min(1).max(1000),
+    type: z.enum(MEMORY_TYPES).optional(),
+    threshold: z.number().min(0).max(1).default(0.7),
+    limit: z.number().int().min(1).max(100).default(20),
+    search_mode: z.enum(SEARCH_MODES).default('hybrid'),
+    filters: z.object({
+        tags: z.array(z.string()).optional(),
+        project_id: z.string().uuid().optional(),
+        topic_id: z.string().uuid().optional(),
+        date_range: z.object({
+            from: z.string().optional(),
+            to: z.string().optional()
+        }).optional()
+    }).optional(),
+    include_chunks: z.boolean().default(false)
+});
+const analyticsDateRangeSchema = z.object({
+    from: z.string().optional(),
+    to: z.string().optional(),
+    group_by: z.enum(['day', 'week', 'month']).default('day')
+});
+
+/**
+ * Core Utilities for Memory Client
+ * Browser-safe, no Node.js dependencies
+ */
+/**
+ * Safely parse JSON with detailed error reporting
+ * Prevents scattered try/catch blocks throughout the codebase
+ */
+function safeJsonParse(input) {
+    try {
+        const data = JSON.parse(input);
+        return { success: true, data };
+    }
+    catch (error) {
+        const message = error instanceof Error
+            ? error.message
+            : 'Unknown JSON parse error';
+        return { success: false, error: `Invalid JSON: ${message}` };
+    }
+}
+/**
+ * HTTP status code to error code mapping
+ */
+function httpStatusToErrorCode(status) {
+    switch (status) {
+        case 400:
+            return 'VALIDATION_ERROR';
+        case 401:
+            return 'AUTH_ERROR';
+        case 403:
+            return 'FORBIDDEN';
+        case 404:
+            return 'NOT_FOUND';
+        case 408:
+            return 'TIMEOUT_ERROR';
+        case 409:
+            return 'CONFLICT';
+        case 429:
+            return 'RATE_LIMIT_ERROR';
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            return 'SERVER_ERROR';
+        default:
+            return 'API_ERROR';
+    }
+}
+/**
+ * Create a standardized error response from various error sources
+ */
+function createErrorResponse(message, code = 'API_ERROR', statusCode, details) {
+    return {
+        code,
+        message,
+        statusCode,
+        details,
+        timestamp: new Date().toISOString()
+    };
+}
+/**
+ * Create an error response from an HTTP response
+ */
+function createErrorFromResponse(status, statusText, body) {
+    const code = httpStatusToErrorCode(status);
+    // Try to extract message from response body
+    let message = `HTTP ${status}: ${statusText}`;
+    let details = undefined;
+    if (body && typeof body === 'object') {
+        const bodyObj = body;
+        if (typeof bodyObj.error === 'string') {
+            message = bodyObj.error;
+        }
+        else if (typeof bodyObj.message === 'string') {
+            message = bodyObj.message;
+        }
+        if (bodyObj.details) {
+            details = bodyObj.details;
+        }
+    }
+    return createErrorResponse(message, code, status, details);
+}
+/**
+ * Sleep utility for retry logic
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Calculate retry delay with exponential backoff and jitter
+ */
+function calculateRetryDelay(attempt, baseDelay = 1000, backoff = 'exponential', maxDelay = 30000) {
+    let delay;
+    if (backoff === 'exponential') {
+        delay = baseDelay * Math.pow(2, attempt);
+    }
+    else {
+        delay = baseDelay * (attempt + 1);
+    }
+    // Add jitter (±20%) to prevent thundering herd
+    const jitter = delay * 0.2 * (Math.random() * 2 - 1);
+    delay = Math.min(delay + jitter, maxDelay);
+    return Math.round(delay);
+}
+/**
+ * Check if an error is retryable based on status code
+ */
+function isRetryableError(statusCode) {
+    if (!statusCode)
+        return true; // Network errors are retryable
+    // Retry on server errors and rate limits
+    return statusCode >= 500 || statusCode === 429 || statusCode === 408;
+}
 
 /**
  * Core Memory Client - Pure Browser-Safe Implementation
@@ -8,6 +269,18 @@ import { z } from 'zod';
  *
  * Bundle size: ~15KB gzipped
  */
+/**
+ * Helper to check if response has error
+ */
+function hasError(response) {
+    return response.error !== undefined;
+}
+/**
+ * Helper to check if response has data
+ */
+function hasData(response) {
+    return response.data !== undefined;
+}
 /**
  * Core Memory Client class for interacting with the Memory as a Service API
  *
@@ -23,6 +296,7 @@ class CoreMemoryClient {
         this.baseHeaders = {
             'Content-Type': 'application/json',
             'User-Agent': '@lanonasis/memory-client/2.0.0',
+            'X-Project-Scope': 'lanonasis-maas', // Required by backend auth middleware
             ...config.headers
         };
         // Set authentication headers
@@ -59,10 +333,13 @@ class CoreMemoryClient {
         return body;
     }
     /**
-     * Make an HTTP request to the API
+     * Make an HTTP request to the API with retry support
      */
     async request(endpoint, options = {}) {
         const startTime = Date.now();
+        const maxRetries = this.config.retry?.maxRetries ?? 3;
+        const baseDelay = this.config.retry?.retryDelay ?? 1000;
+        const backoff = this.config.retry?.backoff ?? 'exponential';
         // Call onRequest hook if provided
         if (this.config.onRequest) {
             try {
@@ -77,85 +354,123 @@ class CoreMemoryClient {
             ? this.config.apiUrl.replace('/api', '')
             : this.config.apiUrl;
         const url = `${baseUrl}/api/v1${endpoint}`;
-        try {
-            const controller = new AbortController();
-            const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-            const response = await fetch(url, {
-                headers: { ...this.baseHeaders, ...options.headers },
-                signal: controller.signal,
-                ...options,
-            });
-            clearTimeout(timeoutId);
-            let data;
-            const contentType = response.headers.get('content-type');
-            if (contentType && contentType.includes('application/json')) {
-                data = await response.json();
-            }
-            else {
-                data = await response.text();
-            }
-            if (!response.ok) {
-                const error = {
-                    message: data?.error || `HTTP ${response.status}: ${response.statusText}`,
-                    statusCode: response.status,
-                    code: 'API_ERROR'
-                };
-                // Call onError hook if provided
-                if (this.config.onError) {
+        let lastError;
+        let attempt = 0;
+        while (attempt <= maxRetries) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+                const response = await fetch(url, {
+                    headers: { ...this.baseHeaders, ...options.headers },
+                    signal: controller.signal,
+                    ...options,
+                });
+                clearTimeout(timeoutId);
+                let data;
+                const contentType = response.headers.get('content-type');
+                if (contentType && contentType.includes('application/json')) {
+                    data = await response.json();
+                }
+                else {
+                    data = await response.text();
+                }
+                if (!response.ok) {
+                    const error = createErrorFromResponse(response.status, response.statusText, data);
+                    // Only retry on retryable errors (5xx, 429, 408)
+                    if (isRetryableError(response.status) && attempt < maxRetries) {
+                        lastError = error;
+                        const delay = calculateRetryDelay(attempt, baseDelay, backoff);
+                        await sleep(delay);
+                        attempt++;
+                        continue;
+                    }
+                    // Call onError hook if provided
+                    if (this.config.onError) {
+                        try {
+                            this.config.onError(error);
+                        }
+                        catch (hookError) {
+                            console.warn('onError hook error:', hookError);
+                        }
+                    }
+                    return { error, meta: { duration: Date.now() - startTime, retries: attempt } };
+                }
+                // Call onResponse hook if provided
+                if (this.config.onResponse) {
                     try {
-                        this.config.onError(error);
+                        const duration = Date.now() - startTime;
+                        this.config.onResponse(endpoint, duration);
                     }
-                    catch (hookError) {
-                        console.warn('onError hook error:', hookError);
+                    catch (error) {
+                        console.warn('onResponse hook error:', error);
                     }
                 }
-                return { error: error.message };
+                return { data, meta: { duration: Date.now() - startTime, retries: attempt } };
             }
-            // Call onResponse hook if provided
-            if (this.config.onResponse) {
-                try {
-                    const duration = Date.now() - startTime;
-                    this.config.onResponse(endpoint, duration);
+            catch (error) {
+                if (error instanceof Error && error.name === 'AbortError') {
+                    const timeoutError = createErrorResponse('Request timeout', 'TIMEOUT_ERROR', 408);
+                    // Retry on timeout
+                    if (attempt < maxRetries) {
+                        lastError = timeoutError;
+                        const delay = calculateRetryDelay(attempt, baseDelay, backoff);
+                        await sleep(delay);
+                        attempt++;
+                        continue;
+                    }
+                    if (this.config.onError) {
+                        try {
+                            this.config.onError(timeoutError);
+                        }
+                        catch (hookError) {
+                            console.warn('onError hook error:', hookError);
+                        }
+                    }
+                    return { error: timeoutError, meta: { duration: Date.now() - startTime, retries: attempt } };
                 }
-                catch (error) {
-                    console.warn('onResponse hook error:', error);
+                const networkError = createErrorResponse(error instanceof Error ? error.message : 'Network error', 'NETWORK_ERROR');
+                // Retry on network errors
+                if (attempt < maxRetries) {
+                    lastError = networkError;
+                    const delay = calculateRetryDelay(attempt, baseDelay, backoff);
+                    await sleep(delay);
+                    attempt++;
+                    continue;
                 }
-            }
-            return { data };
-        }
-        catch (error) {
-            if (error instanceof Error && error.name === 'AbortError') {
-                const timeoutError = {
-                    message: 'Request timeout',
-                    code: 'TIMEOUT_ERROR',
-                    statusCode: 408
-                };
                 if (this.config.onError) {
                     try {
-                        this.config.onError(timeoutError);
+                        this.config.onError(networkError);
                     }
                     catch (hookError) {
                         console.warn('onError hook error:', hookError);
                     }
                 }
-                return { error: 'Request timeout' };
-            }
-            const networkError = {
-                message: error instanceof Error ? error.message : 'Network error',
-                code: 'NETWORK_ERROR'
-            };
-            if (this.config.onError) {
-                try {
-                    this.config.onError(networkError);
-                }
-                catch (hookError) {
-                    console.warn('onError hook error:', hookError);
-                }
+                return { error: networkError, meta: { duration: Date.now() - startTime, retries: attempt } };
             }
+        }
+        // Should never reach here, but handle it gracefully
+        return {
+            error: lastError ?? createErrorResponse('Max retries exceeded', 'API_ERROR'),
+            meta: { duration: Date.now() - startTime, retries: attempt }
+        };
+    }
+    /**
+     * Validate input using Zod schema and return validation error if invalid
+     */
+    validateInput(schema, data) {
+        const result = schema.safeParse(data);
+        if (!result.success) {
+            // Extract error details from Zod error
+            const zodError = result.error;
+            const details = zodError?.issues?.map(issue => ({
+                field: issue.path.map(String).join('.'),
+                message: issue.message
+            })) ?? [];
             return {
-                error: error instanceof Error ? error.message : 'Network error'
+                error: createErrorResponse('Validation failed', 'VALIDATION_ERROR', 400, details)
             };
         }
+        return null;
     }
     /**
      * Test the API connection and authentication
@@ -165,9 +480,14 @@ class CoreMemoryClient {
     }
     // Memory Operations
     /**
-     * Create a new memory
+     * Create a new memory with validation
      */
     async createMemory(memory) {
+        // Validate input before making request
+        const validationError = this.validateInput(createMemorySchema, memory);
+        if (validationError) {
+            return { error: validationError.error };
+        }
         const enrichedMemory = this.enrichWithOrgContext(memory);
         return this.request('/memory', {
             method: 'POST',
@@ -181,9 +501,14 @@ class CoreMemoryClient {
         return this.request(`/memory/${encodeURIComponent(id)}`);
     }
     /**
-     * Update an existing memory
+     * Update an existing memory with validation
      */
     async updateMemory(id, updates) {
+        // Validate input before making request
+        const validationError = this.validateInput(updateMemorySchema, updates);
+        if (validationError) {
+            return { error: validationError.error };
+        }
         return this.request(`/memory/${encodeURIComponent(id)}`, {
             method: 'PUT',
             body: JSON.stringify(updates)
@@ -217,9 +542,15 @@ class CoreMemoryClient {
         return this.request(endpoint);
     }
     /**
-     * Search memories using semantic search
+     * Search memories using semantic search with validation
      */
     async searchMemories(request) {
+        // Validate input before making request
+        const validationError = this.validateInput(searchMemorySchema, request);
+        if (validationError) {
+            // Return error response (data will be undefined, only error is set)
+            return { error: validationError.error };
+        }
         const enrichedRequest = this.enrichWithOrgContext(request);
         return this.request('/memory/search', {
             method: 'POST',
@@ -238,9 +569,14 @@ class CoreMemoryClient {
     }
     // Topic Operations
     /**
-     * Create a new topic
+     * Create a new topic with validation
      */
     async createTopic(topic) {
+        // Validate input before making request
+        const validationError = this.validateInput(createTopicSchema, topic);
+        if (validationError) {
+            return { error: validationError.error };
+        }
         const enrichedTopic = this.enrichWithOrgContext(topic);
         return this.request('/topics', {
             method: 'POST',
@@ -282,6 +618,182 @@ class CoreMemoryClient {
     async getMemoryStats() {
         return this.request('/memory/stats');
     }
+    // ========================================
+    // Intelligence Features (v2.0)
+    // ========================================
+    /**
+     * Create a memory with preprocessing options (chunking, intelligence extraction)
+     *
+     * @example
+     * ```typescript
+     * const result = await client.createMemoryWithPreprocessing({
+     *   title: 'Auth System Docs',
+     *   content: 'Long content...',
+     *   memory_type: 'knowledge',
+     *   preprocessing: {
+     *     chunking: { strategy: 'semantic', maxChunkSize: 1000 },
+     *     extractMetadata: true
+     *   }
+     * });
+     * ```
+     */
+    async createMemoryWithPreprocessing(memory) {
+        // Validate base memory fields
+        const validationError = this.validateInput(createMemorySchema, memory);
+        if (validationError) {
+            return { error: validationError.error };
+        }
+        const enrichedMemory = this.enrichWithOrgContext(memory);
+        return this.request('/memory', {
+            method: 'POST',
+            body: JSON.stringify(enrichedMemory)
+        });
+    }
+    /**
+     * Update a memory with re-chunking and embedding regeneration
+     *
+     * @example
+     * ```typescript
+     * const result = await client.updateMemoryWithPreprocessing('mem_123', {
+     *   content: 'Updated content...',
+     *   rechunk: true,
+     *   regenerate_embedding: true
+     * });
+     * ```
+     */
+    async updateMemoryWithPreprocessing(id, updates) {
+        const validationError = this.validateInput(updateMemorySchema, updates);
+        if (validationError) {
+            return { error: validationError.error };
+        }
+        return this.request(`/memory/${encodeURIComponent(id)}`, {
+            method: 'PUT',
+            body: JSON.stringify(updates)
+        });
+    }
+    /**
+     * Enhanced semantic search with hybrid mode (vector + text)
+     *
+     * @example
+     * ```typescript
+     * const result = await client.enhancedSearch({
+     *   query: 'authentication flow',
+     *   search_mode: 'hybrid',
+     *   filters: { tags: ['auth'], project_id: 'proj_123' },
+     *   include_chunks: true
+     * });
+     * ```
+     */
+    async enhancedSearch(request) {
+        const validationError = this.validateInput(enhancedSearchSchema, request);
+        if (validationError) {
+            return { error: validationError.error };
+        }
+        const enrichedRequest = this.enrichWithOrgContext(request);
+        return this.request('/memory/search', {
+            method: 'POST',
+            body: JSON.stringify(enrichedRequest)
+        });
+    }
+    // ========================================
+    // Analytics Operations
+    // ========================================
+    /**
+     * Get search analytics data
+     *
+     * @example
+     * ```typescript
+     * const analytics = await client.getSearchAnalytics({
+     *   from: '2025-01-01',
+     *   to: '2025-12-31',
+     *   group_by: 'day'
+     * });
+     * ```
+     */
+    async getSearchAnalytics(options = {}) {
+        const validationError = this.validateInput(analyticsDateRangeSchema, options);
+        if (validationError) {
+            return { error: validationError.error };
+        }
+        const params = new URLSearchParams();
+        if (options.from)
+            params.append('from', options.from);
+        if (options.to)
+            params.append('to', options.to);
+        if (options.group_by)
+            params.append('group_by', options.group_by);
+        const queryString = params.toString();
+        const endpoint = queryString ? `/analytics/search?${queryString}` : '/analytics/search';
+        return this.request(endpoint);
+    }
+    /**
+     * Get memory access patterns
+     *
+     * @example
+     * ```typescript
+     * const patterns = await client.getAccessPatterns({
+     *   from: '2025-01-01',
+     *   to: '2025-12-31'
+     * });
+     * console.log(patterns.data?.most_accessed);
+     * ```
+     */
+    async getAccessPatterns(options = {}) {
+        const params = new URLSearchParams();
+        if (options.from)
+            params.append('from', options.from);
+        if (options.to)
+            params.append('to', options.to);
+        const queryString = params.toString();
+        const endpoint = queryString ? `/analytics/access?${queryString}` : '/analytics/access';
+        return this.request(endpoint);
+    }
+    /**
+     * Get extended memory statistics with storage and activity metrics
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.getExtendedStats();
+     * console.log(`Total chunks: ${stats.data?.storage.total_chunks}`);
+     * console.log(`Created today: ${stats.data?.activity.created_today}`);
+     * ```
+     */
+    async getExtendedStats() {
+        return this.request('/analytics/stats');
+    }
+    /**
+     * Get topic with its memories
+     *
+     * @example
+     * ```typescript
+     * const topic = await client.getTopicWithMemories('topic_123');
+     * console.log(topic.data?.memories);
+     * ```
+     */
+    async getTopicWithMemories(topicId, options = {}) {
+        const params = new URLSearchParams();
+        if (options.limit)
+            params.append('limit', String(options.limit));
+        if (options.offset)
+            params.append('offset', String(options.offset));
+        const queryString = params.toString();
+        const endpoint = queryString
+            ? `/topics/${encodeURIComponent(topicId)}/memories?${queryString}`
+            : `/topics/${encodeURIComponent(topicId)}/memories`;
+        return this.request(endpoint);
+    }
+    /**
+     * Get topics in hierarchical structure
+     *
+     * @example
+     * ```typescript
+     * const topics = await client.getTopicsHierarchy();
+     * // Returns nested topic tree with children
+     * ```
+     */
+    async getTopicsHierarchy() {
+        return this.request('/topics?include_hierarchy=true');
+    }
     // Utility Methods
     /**
      * Update authentication token
@@ -330,64 +842,40 @@ function createMemoryClient(config) {
 }
 
 /**
- * Memory types supported by the service
- */
-const MEMORY_TYPES = ['context', 'project', 'knowledge', 'reference', 'personal', 'workflow'];
-/**
- * Memory status values
+ * Error handling for Memory Client
+ * Browser-safe, no Node.js dependencies
  */
-const MEMORY_STATUSES = ['active', 'archived', 'draft', 'deleted'];
 /**
- * Validation schemas using Zod
+ * Standardized error codes for programmatic error handling
  */
-const createMemorySchema = z.object({
-    title: z.string().min(1).max(500),
-    content: z.string().min(1).max(50000),
-    summary: z.string().max(1000).optional(),
-    memory_type: z.enum(MEMORY_TYPES).default('context'),
-    topic_id: z.string().uuid().optional(),
-    project_ref: z.string().max(100).optional(),
-    tags: z.array(z.string().min(1).max(50)).max(20).default([]),
-    metadata: z.record(z.string(), z.unknown()).optional()
-});
-const updateMemorySchema = z.object({
-    title: z.string().min(1).max(500).optional(),
-    content: z.string().min(1).max(50000).optional(),
-    summary: z.string().max(1000).optional(),
-    memory_type: z.enum(MEMORY_TYPES).optional(),
-    status: z.enum(MEMORY_STATUSES).optional(),
-    topic_id: z.string().uuid().nullable().optional(),
-    project_ref: z.string().max(100).nullable().optional(),
-    tags: z.array(z.string().min(1).max(50)).max(20).optional(),
-    metadata: z.record(z.string(), z.unknown()).optional()
-});
-const searchMemorySchema = z.object({
-    query: z.string().min(1).max(1000),
-    memory_types: z.array(z.enum(MEMORY_TYPES)).optional(),
-    tags: z.array(z.string()).optional(),
-    topic_id: z.string().uuid().optional(),
-    project_ref: z.string().optional(),
-    status: z.enum(MEMORY_STATUSES).default('active'),
-    limit: z.number().int().min(1).max(100).default(20),
-    threshold: z.number().min(0).max(1).default(0.7)
-});
-const createTopicSchema = z.object({
-    name: z.string().min(1).max(100),
-    description: z.string().max(500).optional(),
-    color: z.string().regex(/^#[0-9A-Fa-f]{6}$/).optional(),
-    icon: z.string().max(50).optional(),
-    parent_topic_id: z.string().uuid().optional()
-});
-
+const ERROR_CODES = [
+    'API_ERROR',
+    'AUTH_ERROR',
+    'VALIDATION_ERROR',
+    'TIMEOUT_ERROR',
+    'RATE_LIMIT_ERROR',
+    'NOT_FOUND',
+    'NETWORK_ERROR',
+    'FORBIDDEN',
+    'CONFLICT',
+    'SERVER_ERROR'
+];
 /**
- * Error handling for Memory Client
- * Browser-safe, no Node.js dependencies
+ * Type guard to check if an object is an ApiErrorResponse
  */
+function isApiErrorResponse(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'code' in value &&
+        'message' in value &&
+        typeof value.code === 'string' &&
+        typeof value.message === 'string');
+}
 /**
  * Base error class for Memory Client errors
  */
 class MemoryClientError extends Error {
-    constructor(message, code, statusCode, details) {
+    constructor(message, code = 'API_ERROR', statusCode, details) {
         super(message);
         this.code = code;
         this.statusCode = statusCode;
@@ -398,6 +886,18 @@ class MemoryClientError extends Error {
             Error.captureStackTrace(this, MemoryClientError);
         }
     }
+    /**
+     * Convert to ApiErrorResponse for consistent API responses
+     */
+    toResponse() {
+        return {
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details,
+            timestamp: new Date().toISOString()
+        };
+    }
 }
 /**
  * Network/API error
@@ -407,8 +907,28 @@ class ApiError extends MemoryClientError {
         super(message, 'API_ERROR', statusCode, details);
         this.name = 'ApiError';
     }
-}
-/**
+    /**
+     * Create from an HTTP response
+     */
+    static fromResponse(status, statusText, body) {
+        let message = `HTTP ${status}: ${statusText}`;
+        let details = undefined;
+        if (body && typeof body === 'object') {
+            const bodyObj = body;
+            if (typeof bodyObj.error === 'string') {
+                message = bodyObj.error;
+            }
+            else if (typeof bodyObj.message === 'string') {
+                message = bodyObj.message;
+            }
+            if (bodyObj.details) {
+                details = bodyObj.details;
+            }
+        }
+        return new ApiError(message, status, details);
+    }
+}
+/**
  * Authentication error
  */
 class AuthenticationError extends MemoryClientError {
@@ -418,12 +938,30 @@ class AuthenticationError extends MemoryClientError {
     }
 }
 /**
- * Validation error
+ * Validation error with field-level details
  */
 class ValidationError extends MemoryClientError {
     constructor(message, details) {
         super(message, 'VALIDATION_ERROR', 400, details);
         this.name = 'ValidationError';
+        // Parse validation details into field errors
+        this.validationErrors = [];
+        if (Array.isArray(details)) {
+            this.validationErrors = details.filter((item) => typeof item === 'object' &&
+                item !== null &&
+                typeof item.field === 'string' &&
+                typeof item.message === 'string');
+        }
+    }
+    /**
+     * Create from Zod error
+     */
+    static fromZodError(error) {
+        const details = error.issues.map(issue => ({
+            field: issue.path.join('.'),
+            message: issue.message
+        }));
+        return new ValidationError('Validation failed', details);
     }
 }
 /**
@@ -436,12 +974,13 @@ class TimeoutError extends MemoryClientError {
     }
 }
 /**
- * Rate limit error
+ * Rate limit error with retry-after info
  */
 class RateLimitError extends MemoryClientError {
-    constructor(message = 'Rate limit exceeded') {
-        super(message, 'RATE_LIMIT_ERROR', 429);
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(message, 'RATE_LIMIT_ERROR', 429, { retryAfter });
         this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
     }
 }
 /**
@@ -451,6 +990,49 @@ class NotFoundError extends MemoryClientError {
     constructor(resource) {
         super(`${resource} not found`, 'NOT_FOUND', 404);
         this.name = 'NotFoundError';
+        this.resource = resource;
+    }
+}
+/**
+ * Network error (no response received)
+ */
+class NetworkError extends MemoryClientError {
+    constructor(message = 'Network error') {
+        super(message, 'NETWORK_ERROR');
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Server error (5xx responses)
+ */
+class ServerError extends MemoryClientError {
+    constructor(message, statusCode = 500) {
+        super(message, 'SERVER_ERROR', statusCode);
+        this.name = 'ServerError';
+    }
+}
+/**
+ * Create appropriate error class from status code
+ */
+function createErrorFromStatus(status, message, details) {
+    switch (status) {
+        case 400:
+            return new ValidationError(message, details);
+        case 401:
+            return new AuthenticationError(message);
+        case 404:
+            return new NotFoundError(message);
+        case 408:
+            return new TimeoutError(message);
+        case 429:
+            return new RateLimitError(message);
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            return new ServerError(message, status);
+        default:
+            return new ApiError(message, status, details);
     }
 }
 
@@ -486,7 +1068,7 @@ class NotFoundError extends MemoryClientError {
  * ```
  */
 // ========================================
-// Core Exports (Browser-Safe)
+// Internal Imports (for use in this file)
 // ========================================
 // ========================================
 // Constants
@@ -498,6 +1080,66 @@ const CLIENT_NAME = '@lanonasis/memory-client';
 // ========================================
 const isBrowser = typeof window !== 'undefined';
 const isNode = typeof globalThis !== 'undefined' && 'process' in globalThis && globalThis.process?.versions?.node;
+const isEdge = !isBrowser && !isNode;
+/**
+ * Get the current runtime environment
+ */
+function getEnvironment() {
+    if (isBrowser)
+        return 'browser';
+    if (isNode)
+        return 'node';
+    return 'edge';
+}
+/**
+ * Auto-detecting client factory - "Drop In and Sleep" architecture
+ *
+ * Automatically detects the runtime environment and returns the appropriate client:
+ * - Browser/Edge: Returns CoreMemoryClient (lightweight, browser-safe)
+ * - Node.js: Returns EnhancedMemoryClient (with CLI/MCP support)
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@lanonasis/memory-client';
+ *
+ * // Works in any environment!
+ * const client = await createClient({
+ *   apiUrl: 'https://api.lanonasis.com',
+ *   apiKey: 'your-key'
+ * });
+ *
+ * const memories = await client.listMemories();
+ * ```
+ */
+async function createClient(config) {
+    const environment = getEnvironment();
+    if (environment === 'node') {
+        try {
+            // Dynamic import for Node.js client to avoid bundling in browser
+            const { createNodeMemoryClient } = await Promise.resolve().then(function () { return index; });
+            return await createNodeMemoryClient({
+                ...config,
+                preferCLI: config.preferCLI ?? true,
+                enableMCP: config.enableMCP ?? true
+            });
+        }
+        catch {
+            // Fallback to core client if Node module fails to load
+            console.warn('Failed to load Node.js client, falling back to core client');
+        }
+    }
+    // Browser, Edge, or fallback
+    const clientConfig = {
+        apiUrl: config.apiUrl,
+        apiKey: config.apiKey,
+        authToken: config.authToken,
+        organizationId: config.organizationId,
+        timeout: config.timeout ?? (environment === 'edge' ? 5000 : 30000),
+        headers: config.headers,
+        retry: config.retry
+    };
+    return createMemoryClient(clientConfig);
+}
 // ========================================
 // Default Configurations
 // ========================================
@@ -611,5 +1253,623 @@ const defaultConfigs = {
  * - Examples: https://github.com/lanonasis/examples
  */
 
-export { ApiError as ApiErrorClass, AuthenticationError, CLIENT_NAME, CoreMemoryClient, MEMORY_STATUSES, MEMORY_TYPES, CoreMemoryClient as MemoryClient, MemoryClientError, NotFoundError, RateLimitError, TimeoutError, VERSION, ValidationError, createMemoryClient, createMemorySchema, createTopicSchema, defaultConfigs, isBrowser, isNode, searchMemorySchema, updateMemorySchema };
+/**
+ * CLI Integration Module for Memory Client SDK
+ *
+ * Provides intelligent CLI detection and MCP channel utilization
+ * when @lanonasis/cli v1.5.2+ is available in the environment
+ *
+ * IMPORTANT: This file imports Node.js modules and should only be used in Node.js environments
+ */
+const execAsync = promisify(exec);
+/**
+ * CLI Detection and Integration Service
+ */
+class CLIIntegration {
+    constructor() {
+        this.cliInfo = null;
+        this.detectionPromise = null;
+    }
+    /**
+     * Detect if CLI is available and get its capabilities
+     */
+    async detectCLI() {
+        // Return cached result if already detected
+        if (this.cliInfo) {
+            return this.cliInfo;
+        }
+        // Return existing promise if detection is in progress
+        if (this.detectionPromise) {
+            return this.detectionPromise;
+        }
+        // Start new detection
+        this.detectionPromise = this.performDetection();
+        this.cliInfo = await this.detectionPromise;
+        return this.cliInfo;
+    }
+    async performDetection() {
+        try {
+            // Check if onasis/lanonasis CLI is available
+            let versionOutput = '';
+            try {
+                const { stdout } = await execAsync('onasis --version 2>/dev/null', { timeout: 5000 });
+                versionOutput = stdout;
+            }
+            catch {
+                // Try lanonasis if onasis fails
+                const { stdout } = await execAsync('lanonasis --version 2>/dev/null', { timeout: 5000 });
+                versionOutput = stdout;
+            }
+            const version = versionOutput.trim();
+            // Verify it's v1.5.2 or higher for Golden Contract support
+            const versionMatch = version.match(/(\d+)\.(\d+)\.(\d+)/);
+            if (!versionMatch) {
+                return { available: false };
+            }
+            const [, major, minor, patch] = versionMatch.map(Number);
+            const isCompatible = major > 1 || (major === 1 && minor > 5) || (major === 1 && minor === 5 && patch >= 2);
+            if (!isCompatible) {
+                return {
+                    available: true,
+                    version,
+                    mcpAvailable: false,
+                    authenticated: false
+                };
+            }
+            // Check MCP availability
+            let mcpAvailable = false;
+            try {
+                await execAsync('onasis mcp status --output json 2>/dev/null || lanonasis mcp status --output json 2>/dev/null', {
+                    timeout: 3000
+                });
+                mcpAvailable = true;
+            }
+            catch {
+                // MCP not available or not configured
+            }
+            // Check authentication status
+            let authenticated = false;
+            try {
+                const { stdout: authOutput } = await execAsync('onasis auth status --output json 2>/dev/null || lanonasis auth status --output json 2>/dev/null', {
+                    timeout: 3000
+                });
+                const parseResult = safeJsonParse(authOutput);
+                if (parseResult.success) {
+                    authenticated = parseResult.data.authenticated === true;
+                }
+            }
+            catch {
+                // Authentication check failed
+            }
+            return {
+                available: true,
+                version,
+                mcpAvailable,
+                authenticated
+            };
+        }
+        catch {
+            return { available: false };
+        }
+    }
+    /**
+     * Execute CLI command and return parsed JSON result
+     */
+    async executeCLICommand(command, options = {}) {
+        const cliInfo = await this.detectCLI();
+        if (!cliInfo.available) {
+            return { error: createErrorResponse('CLI not available', 'API_ERROR') };
+        }
+        if (!cliInfo.authenticated) {
+            return { error: createErrorResponse('CLI not authenticated. Run: onasis login', 'AUTH_ERROR', 401) };
+        }
+        try {
+            const timeout = options.timeout || 30000;
+            const outputFormat = options.outputFormat || 'json';
+            const verbose = options.verbose ? '--verbose' : '';
+            // Determine which CLI command to use (prefer onasis for Golden Contract)
+            const cliCmd = await this.getPreferredCLICommand();
+            const fullCommand = `${cliCmd} ${command} --output ${outputFormat} ${verbose}`.trim();
+            const { stdout, stderr } = await execAsync(fullCommand, {
+                timeout,
+                maxBuffer: 1024 * 1024 // 1MB buffer
+            });
+            if (stderr && stderr.trim()) {
+                console.warn('CLI warning:', stderr);
+            }
+            if (outputFormat === 'json') {
+                const parseResult = safeJsonParse(stdout);
+                if (parseResult.success) {
+                    return { data: parseResult.data };
+                }
+                return { error: createErrorResponse(parseResult.error, 'VALIDATION_ERROR', 400) };
+            }
+            return { data: stdout };
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('timeout')) {
+                return { error: createErrorResponse('CLI command timeout', 'TIMEOUT_ERROR', 408) };
+            }
+            return {
+                error: createErrorResponse(error instanceof Error ? error.message : 'CLI command failed', 'API_ERROR')
+            };
+        }
+    }
+    /**
+     * Get preferred CLI command (onasis for Golden Contract, fallback to lanonasis)
+     */
+    async getPreferredCLICommand() {
+        try {
+            execSync('which onasis', { stdio: 'ignore', timeout: 1000 });
+            return 'onasis';
+        }
+        catch {
+            return 'lanonasis';
+        }
+    }
+    /**
+     * Memory operations via CLI
+     */
+    async createMemoryViaCLI(title, content, options = {}) {
+        const { memoryType = 'context', tags = [], topicId } = options;
+        let command = `memory create --title "${title}" --content "${content}" --memory-type ${memoryType}`;
+        if (tags.length > 0) {
+            command += ` --tags "${tags.join(',')}"`;
+        }
+        if (topicId) {
+            command += ` --topic-id "${topicId}"`;
+        }
+        return this.executeCLICommand(command);
+    }
+    async listMemoriesViaCLI(options = {}) {
+        let command = 'memory list';
+        if (options.limit) {
+            command += ` --limit ${options.limit}`;
+        }
+        if (options.memoryType) {
+            command += ` --memory-type ${options.memoryType}`;
+        }
+        if (options.tags && options.tags.length > 0) {
+            command += ` --tags "${options.tags.join(',')}"`;
+        }
+        if (options.sortBy) {
+            command += ` --sort-by ${options.sortBy}`;
+        }
+        return this.executeCLICommand(command);
+    }
+    async searchMemoriesViaCLI(query, options = {}) {
+        let command = `memory search "${query}"`;
+        if (options.limit) {
+            command += ` --limit ${options.limit}`;
+        }
+        if (options.memoryTypes && options.memoryTypes.length > 0) {
+            command += ` --memory-types "${options.memoryTypes.join(',')}"`;
+        }
+        return this.executeCLICommand(command);
+    }
+    /**
+     * Health check via CLI
+     */
+    async healthCheckViaCLI() {
+        return this.executeCLICommand('health');
+    }
+    /**
+     * MCP-specific operations
+     */
+    async getMCPStatus() {
+        const cliInfo = await this.detectCLI();
+        if (!cliInfo.mcpAvailable) {
+            return { error: createErrorResponse('MCP not available via CLI', 'API_ERROR') };
+        }
+        return this.executeCLICommand('mcp status');
+    }
+    async listMCPTools() {
+        const cliInfo = await this.detectCLI();
+        if (!cliInfo.mcpAvailable) {
+            return { error: createErrorResponse('MCP not available via CLI', 'API_ERROR') };
+        }
+        return this.executeCLICommand('mcp tools');
+    }
+    /**
+     * Authentication operations
+     */
+    async getAuthStatus() {
+        return this.executeCLICommand('auth status');
+    }
+    /**
+     * Check if specific CLI features are available
+     */
+    async getCapabilities() {
+        const cliInfo = await this.detectCLI();
+        return {
+            cliAvailable: cliInfo.available,
+            version: cliInfo.version,
+            mcpSupport: cliInfo.mcpAvailable || false,
+            authenticated: cliInfo.authenticated || false,
+            goldenContract: cliInfo.available && this.isGoldenContractCompliant(cliInfo.version)
+        };
+    }
+    isGoldenContractCompliant(version) {
+        if (!version)
+            return false;
+        const versionMatch = version.match(/(\d+)\.(\d+)\.(\d+)/);
+        if (!versionMatch)
+            return false;
+        const [, major, minor, patch] = versionMatch.map(Number);
+        return major > 1 || (major === 1 && minor > 5) || (major === 1 && minor === 5 && patch >= 2);
+    }
+    /**
+     * Force refresh CLI detection
+     */
+    async refresh() {
+        this.cliInfo = null;
+        this.detectionPromise = null;
+        return this.detectCLI();
+    }
+    /**
+     * Get cached CLI info without re-detection
+     */
+    getCachedInfo() {
+        return this.cliInfo;
+    }
+}
+
+/**
+ * Enhanced Memory Client with CLI Integration
+ *
+ * Intelligently routes requests through CLI v1.5.2+ when available,
+ * with fallback to direct API for maximum compatibility and performance
+ *
+ * IMPORTANT: This file uses Node.js-specific features (process.env) and should only be used in Node.js environments
+ */
+/**
+ * Enhanced Memory Client with intelligent CLI/API routing
+ */
+class EnhancedMemoryClient {
+    createDefaultCapabilities() {
+        return {
+            cliAvailable: false,
+            mcpSupport: false,
+            authenticated: false,
+            goldenContract: false
+        };
+    }
+    constructor(config) {
+        this.capabilities = null;
+        // Merge config with defaults, ensuring all required fields are present
+        // Spread config first, then apply defaults only for undefined values
+        const mergedConfig = {
+            ...config,
+            preferCLI: config.preferCLI ?? true,
+            enableMCP: config.enableMCP ?? true,
+            cliDetectionTimeout: config.cliDetectionTimeout ?? 5000,
+            fallbackToAPI: config.fallbackToAPI ?? true,
+            minCLIVersion: config.minCLIVersion ?? '1.5.2',
+            verbose: config.verbose ?? false,
+            timeout: config.timeout ?? 30000,
+            apiUrl: config.apiUrl || 'https://api.lanonasis.com',
+            apiKey: config.apiKey || process.env.LANONASIS_API_KEY || '',
+            authToken: config.authToken || '',
+            headers: config.headers || {}
+        };
+        this.config = mergedConfig;
+        this.directClient = new CoreMemoryClient(config);
+        this.cliIntegration = new CLIIntegration();
+    }
+    /**
+     * Initialize the client and detect capabilities
+     */
+    async initialize() {
+        try {
+            const detectionPromise = this.cliIntegration.getCapabilities();
+            const capabilities = this.config.cliDetectionTimeout > 0
+                ? await Promise.race([
+                    detectionPromise,
+                    new Promise((resolve) => {
+                        setTimeout(() => resolve(null), this.config.cliDetectionTimeout);
+                    })
+                ])
+                : await detectionPromise;
+            if (capabilities) {
+                this.capabilities = capabilities;
+                if (this.config.verbose && capabilities.cliAvailable && !capabilities.authenticated) {
+                    const suggestedCommand = capabilities.goldenContract ? 'onasis login' : 'lanonasis login';
+                    console.warn(`CLI detected but not authenticated. Run '${suggestedCommand}' to enable enhanced SDK features.`);
+                }
+            }
+            else {
+                this.capabilities = this.createDefaultCapabilities();
+                if (this.config.verbose) {
+                    console.warn(`CLI detection timed out after ${this.config.cliDetectionTimeout}ms. Falling back to API mode.`);
+                }
+            }
+        }
+        catch (error) {
+            if (this.config.verbose) {
+                console.warn('CLI detection failed:', error);
+            }
+            this.capabilities = this.createDefaultCapabilities();
+        }
+    }
+    /**
+     * Get current capabilities
+     */
+    async getCapabilities() {
+        if (!this.capabilities) {
+            await this.initialize();
+        }
+        if (!this.capabilities) {
+            this.capabilities = this.createDefaultCapabilities();
+        }
+        return this.capabilities;
+    }
+    /**
+     * Determine if operation should use CLI
+     */
+    async shouldUseCLI() {
+        const capabilities = await this.getCapabilities();
+        return (this.config.preferCLI &&
+            capabilities.cliAvailable &&
+            capabilities.authenticated &&
+            capabilities.goldenContract);
+    }
+    /**
+     * Execute operation with intelligent routing
+     */
+    async executeOperation(operation, cliOperation, apiOperation) {
+        const useCLI = await this.shouldUseCLI();
+        const capabilities = await this.getCapabilities();
+        if (useCLI) {
+            try {
+                const result = await cliOperation();
+                if (result.error && this.config.fallbackToAPI) {
+                    console.warn(`CLI ${operation} failed, falling back to API:`, result.error);
+                    const apiResult = await apiOperation();
+                    return {
+                        ...apiResult,
+                        source: 'api',
+                        mcpUsed: false
+                    };
+                }
+                return {
+                    ...result,
+                    source: 'cli',
+                    mcpUsed: capabilities.mcpSupport
+                };
+            }
+            catch (error) {
+                if (this.config.fallbackToAPI) {
+                    console.warn(`CLI ${operation} error, falling back to API:`, error);
+                    const apiResult = await apiOperation();
+                    return {
+                        ...apiResult,
+                        source: 'api',
+                        mcpUsed: false
+                    };
+                }
+                return {
+                    error: createErrorResponse(error instanceof Error ? error.message : `CLI ${operation} failed`, 'API_ERROR'),
+                    source: 'cli',
+                    mcpUsed: false
+                };
+            }
+        }
+        else {
+            const result = await apiOperation();
+            return {
+                ...result,
+                source: 'api',
+                mcpUsed: false
+            };
+        }
+    }
+    // Enhanced API Methods
+    /**
+     * Health check with intelligent routing
+     */
+    async healthCheck() {
+        return this.executeOperation('health check', () => this.cliIntegration.healthCheckViaCLI(), () => this.directClient.healthCheck());
+    }
+    /**
+     * Create memory with CLI/API routing
+     */
+    async createMemory(memory) {
+        return this.executeOperation('create memory', () => this.cliIntegration.createMemoryViaCLI(memory.title, memory.content, {
+            memoryType: memory.memory_type,
+            tags: memory.tags,
+            topicId: memory.topic_id
+        }), () => this.directClient.createMemory(memory));
+    }
+    /**
+     * List memories with intelligent routing
+     */
+    async listMemories(options = {}) {
+        return this.executeOperation('list memories', () => this.cliIntegration.listMemoriesViaCLI({
+            limit: options.limit,
+            memoryType: options.memory_type,
+            tags: options.tags,
+            sortBy: options.sort
+        }), () => this.directClient.listMemories(options));
+    }
+    /**
+     * Search memories with MCP enhancement when available
+     */
+    async searchMemories(request) {
+        return this.executeOperation('search memories', () => this.cliIntegration.searchMemoriesViaCLI(request.query, {
+            limit: request.limit,
+            memoryTypes: request.memory_types
+        }), () => this.directClient.searchMemories(request));
+    }
+    /**
+     * Get memory by ID (API only for now)
+     */
+    async getMemory(id) {
+        // CLI doesn't have get by ID yet, use API
+        const result = await this.directClient.getMemory(id);
+        return {
+            ...result,
+            source: 'api',
+            mcpUsed: false
+        };
+    }
+    /**
+     * Update memory (API only for now)
+     */
+    async updateMemory(id, updates) {
+        // CLI doesn't have update yet, use API
+        const result = await this.directClient.updateMemory(id, updates);
+        return {
+            ...result,
+            source: 'api',
+            mcpUsed: false
+        };
+    }
+    /**
+     * Delete memory (API only for now)
+     */
+    async deleteMemory(id) {
+        // CLI doesn't have delete yet, use API
+        const result = await this.directClient.deleteMemory(id);
+        return {
+            ...result,
+            source: 'api',
+            mcpUsed: false
+        };
+    }
+    // Topic Operations (API only for now)
+    async createTopic(topic) {
+        const result = await this.directClient.createTopic(topic);
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    async getTopics() {
+        const result = await this.directClient.getTopics();
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    async getTopic(id) {
+        const result = await this.directClient.getTopic(id);
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    async updateTopic(id, updates) {
+        const result = await this.directClient.updateTopic(id, updates);
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    async deleteTopic(id) {
+        const result = await this.directClient.deleteTopic(id);
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    /**
+     * Get memory statistics
+     */
+    async getMemoryStats() {
+        const result = await this.directClient.getMemoryStats();
+        return { ...result, source: 'api', mcpUsed: false };
+    }
+    // Utility Methods
+    /**
+     * Force CLI re-detection
+     */
+    async refreshCLIDetection() {
+        this.capabilities = null;
+        await this.cliIntegration.refresh();
+        await this.initialize();
+    }
+    /**
+     * Get authentication status from CLI
+     */
+    async getAuthStatus() {
+        try {
+            const result = await this.cliIntegration.getAuthStatus();
+            return { ...result, source: 'cli', mcpUsed: false };
+        }
+        catch (error) {
+            return {
+                error: createErrorResponse(error instanceof Error ? error.message : 'Auth status check failed', 'API_ERROR'),
+                source: 'cli',
+                mcpUsed: false
+            };
+        }
+    }
+    /**
+     * Get MCP status when available
+     */
+    async getMCPStatus() {
+        const capabilities = await this.getCapabilities();
+        if (!capabilities.mcpSupport) {
+            return {
+                error: createErrorResponse('MCP not available', 'API_ERROR'),
+                source: 'cli',
+                mcpUsed: false
+            };
+        }
+        try {
+            const result = await this.cliIntegration.getMCPStatus();
+            return { ...result, source: 'cli', mcpUsed: true };
+        }
+        catch (error) {
+            return {
+                error: createErrorResponse(error instanceof Error ? error.message : 'MCP status check failed', 'API_ERROR'),
+                source: 'cli',
+                mcpUsed: false
+            };
+        }
+    }
+    /**
+     * Update authentication for both CLI and API client
+     */
+    setAuthToken(token) {
+        this.directClient.setAuthToken(token);
+    }
+    setApiKey(apiKey) {
+        this.directClient.setApiKey(apiKey);
+    }
+    clearAuth() {
+        this.directClient.clearAuth();
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+        this.directClient.updateConfig(updates);
+    }
+    /**
+     * Get configuration summary
+     */
+    getConfigSummary() {
+        return {
+            apiUrl: this.config.apiUrl,
+            preferCLI: this.config.preferCLI,
+            enableMCP: this.config.enableMCP,
+            capabilities: this.capabilities || undefined
+        };
+    }
+}
+/**
+ * Factory function to create an enhanced memory client
+ */
+async function createNodeMemoryClient(config) {
+    const client = new EnhancedMemoryClient(config);
+    await client.initialize();
+    return client;
+}
+
+/**
+ * @lanonasis/memory-client/node
+ *
+ * Node.js-enhanced client with CLI integration
+ * ONLY import this in Node.js environments
+ *
+ * Provides intelligent CLI detection and MCP channel utilization
+ * when @lanonasis/cli v1.5.2+ is available
+ */
+// Enhanced client with CLI support
+
+var index = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CLIIntegration: CLIIntegration,
+    EnhancedMemoryClient: EnhancedMemoryClient,
+    createNodeMemoryClient: createNodeMemoryClient
+});
+
+export { ApiError, AuthenticationError, CHUNKING_STRATEGIES, CLIENT_NAME, CONTENT_TYPES, CoreMemoryClient, ERROR_CODES, MEMORY_STATUSES, MEMORY_TYPES, CoreMemoryClient as MemoryClient, MemoryClientError, NetworkError, NotFoundError, RateLimitError, SEARCH_MODES, ServerError, TimeoutError, VERSION, ValidationError, analyticsDateRangeSchema, calculateRetryDelay, createClient, createErrorFromStatus, createErrorResponse, createMemoryClient, createMemorySchema, createTopicSchema, defaultConfigs, enhancedSearchSchema, getEnvironment, hasData, hasError, httpStatusToErrorCode, isApiErrorResponse, isBrowser, isEdge, isNode, isRetryableError, preprocessingOptionsSchema, safeJsonParse, searchMemorySchema, updateMemorySchema };
 //# sourceMappingURL=index.esm.js.map